coulomb/rein-aharness
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
rein-aharness/workplans/REIN-A-0002-ops-run-claim-loop.md

4.7 KiB
Raw Blame History

id type title domain repo status owner topic_slug priority created updated depends_on related state_hub_workstream_id
REIN-A-0002 workplan Ops run claim loop and approach selection agents rein-aharness ready grok rein-aharness high 2026-08-03 2026-08-03
ACTIVITY-WP-0026
ACT-ADR-005
HARNESS-WP-0001
ed679a3e-b4ea-4e69-bba6-5694d79ae7c8

REIN-A-0002 — Ops run claim loop and approach selection

Origin

ACT-ADR-005. Closes the dual-clock residual: host systemd timers currently execute Binky/FI while activity-core schedules separately. rein-aharness already polls issue-core (docs/task-intake.md); that path is wrong for internal ops under WP-0022 and issue-core INTENT.

Goal

  1. Claim ops_run from activity-core (not issue-core / not Forgejo).
  2. Select an efficient approach (adapter table) and execute.
  3. Complete/fail the ops_run + domain completion events.
  4. Cut over FI and Binky off dual wall-clock timers once proven.

Tasks

T01 — activity-core ops_run client

id: REIN-A-0002-T01
status: todo
priority: high
state_hub_task_id: "a5e32652-ba3f-4cc5-8d41-0d9f3022c50e"

Client module (env: ACTIVITY_CORE_URL, worker credential):

  • claim(worker_id, labels=…)
  • heartbeat / complete / fail

Map ops_run → existing TaskSpec (or thin OpsRunSpec). Tests with httpx mock.

Blocked on: ACTIVITY-WP-0026-T01 API shape (can stub against openapi draft).

Done when: unit tests green; CLI poll --source=ops-run prototype optional.

T02 — Approach registry (v1 static)

id: REIN-A-0002-T02
status: todo
priority: high
state_hub_task_id: "c307b119-1bff-4d5c-a911-5b5259de5c86"

Central table/config (code registry, not per-repo cron):

Match (labels / definition id contains) Approach command
research-brief or fi-daily fi-research-brief
rhythm + binky / binky-daily brief-daily
mail-intake mail-scan then optional mail-triage
agent-session run with persona/profile
unmatched fail ops_run with clear reason

Document how to add rows. Prefer cheapest correct path (deterministic before agent session; structured llm-connect before open-ended coding agent).

Done when: pure function tests for match → approach.

T03 — Continuous claim worker

id: REIN-A-0002-T03
status: todo
priority: high
state_hub_task_id: "31fb7df3-83a3-4f18-a7b9-9be49e226837"
  • rein-aharness claim-loop (or systemd/service unit): poll interval, lease heartbeat, concurrency 1 default.
  • On success: domain completion already done by approach; close ops_run.
  • On failure: fail ops_run; do not silent drop.
  • Metrics/log for SLA.

Done when: can run against railiance actcore-api with a test ops_run.

T04 — Map FI + Binky definitions

id: REIN-A-0002-T04
status: todo
priority: high
state_hub_task_id: "93190150-4df7-47f4-b52e-29b997f9aaf0"
  • Ensure definition labels include approach keys (research-brief, automated, …).
  • Wire AGENT_HARNESS_REPO_MAP / roots for freedom-intelligence, binky-control.
  • Document railiance install of claim-loop service.

Done when: end-to-end: trigger FI def → ops_run claimed → brief path + fi_daily_brief (or skip if not due).

T05 — Cutover: timers become break-glass

id: REIN-A-0002-T05
status: todo
priority: medium
state_hub_task_id: "a04a98e3-ca6a-4a18-b6fd-47a77047ca90"

After 5 clean weekday cycles (or 5 forced triggers):

  1. Disable FI + Binky host oneshot timers or set them to “poll once if queue backlog” only.
  2. Update domain OperatingRhythm.md / docs/recurrence-ops.md.
  3. Keep install scripts with break-glass section.

Done when: docs + railiance state match; dual-clock residual closed for FI/Binky.

T06 — Deprecate issue-core as ops intake for automation

id: REIN-A-0002-T06
status: todo
priority: medium
state_hub_task_id: "cca10835-d6fc-4ce1-a361-d2d1f2693872"
  • docs/task-intake.md: issue-core poll = legacy / external ticket path only.
  • ops_run = primary for activity-core automation labels.
  • No Gitea references; Forgejo only if mentioning self-hosted forge projection.

Done when: docs and CLI help text consistent with ACT-ADR-005.

Acceptance

  • Claim loop does not require Forgejo or issue-core for FI/Binky ops
  • Approach table selects fi-research-brief / brief-daily without host “schedule”
  • Timers demoted after proof window
  • ACT-ADR-005 / ACTIVITY-WP-0026 contracts implemented

Out of scope

  • Implementing ops_run schema (ACTIVITY-WP-0026)
  • issue-core Forgejo backend fixes
  • Full glas-harness multi-rein routing