state-hub/workplans/STATE-WP-0078-ops-run-read-projection.md
tegwick f5f2fe98da
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
chore(consistency): sync workplan hub IDs [auto follow-up]
2026-08-03 19:16:53 +02:00

2.3 KiB

id type title domain repo status owner topic_slug priority created updated depends_on related state_hub_workstream_id state_hub_workstream_id
STATE-WP-0078 workplan Ops run read projection for fleet visibility infotech state-hub ready grok state-hub low 2026-08-03 2026-08-03
ACTIVITY-WP-0026
ACT-ADR-005
STATE-WP-0074
57b75246-ef6d-4d6e-93dc-7f47e7200d1d 57b75246-ef6d-4d6e-93dc-7f47e7200d1d

id: STATE-WP-0078 type: workplan title: "Ops run read projection for fleet visibility" domain: infotech repo: state-hub status: ready owner: grok topic_slug: state-hub priority: low created: "2026-08-03" updated: "2026-08-03" depends_on:

  • ACTIVITY-WP-0026 related:
  • ACT-ADR-005
  • STATE-WP-0074 state_hub_workstream_id: "57b75246-ef6d-4d6e-93dc-7f47e7200d1d" state_hub_workstream_id: "57b75246-ef6d-4d6e-93dc-7f47e7200d1d"

STATE-WP-0078 — Ops run read projection

Origin

ACT-ADR-005: State Hub remains the work-record read model on coulombcore. It may project activity-core ops_run state for fleet ops UI without becoming the claim authority.

Goal

Expose open/failed/recent ops runs to operators and agents via State Hub summary/API read paths, fed from activity-core (edge/NATS/pull) — so coulombcore-oriented agents see automation health without claiming work.

Tasks

T01 — Contract with activity-core

id: STATE-WP-0078-T01
status: todo
priority: medium
state_hub_task_id: "399b4985-3578-4fff-97dd-0f68e1e266b3"

Agree payload shape with ACTIVITY-WP-0026 (id, definition, target_repo, state, lease, updated_at, last_error). Document whether pull (hub polls actcore) or push (actcore posts progress summary) is v1.

Done when: short contract note in docs/ or linked from ACT-ADR-005.


T02 — Read API + summary field

id: STATE-WP-0078-T02
status: todo
priority: medium
state_hub_task_id: "192be2e0-0335-46da-ba22-17e3e8f0d28c"

Minimal:

  • GET /ops-runs/summary or extend /state/summary with ops_runs: { open, claimed, failed_24h }
  • No claim/complete endpoints on State Hub

Done when: MCP/summary consumers can show stuck automation.


T03 — Edge/federation notes

id: STATE-WP-0078-T03
status: todo
priority: low
state_hub_task_id: "09afc52e-e1c6-454f-ac1d-33d6e773f47f"

Document coulombcore vs railiance: claim on railiance actcore-api; visibility may lag if edge relay down — alert preference.

Done when: cluster-operating-model or ops doc updated.

Acceptance

  • Hub does not claim ops_runs
  • Operators see automation backlog on primary hub views
  • No Forgejo/Gitea dependency

Out of scope

  • Moving claim API to State Hub
  • Workplan file generation for daily ops