state-hub/workplans/STATE-WP-0078-ops-run-read-projection.md
tegwick 72c8f80b1f
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Add STATE-WP-0078 for ops_run read projection on the hub.
State Hub remains non-claim authority; surface open/failed ops runs for fleet
visibility after ACTIVITY-WP-0026.
2026-08-03 18:51:40 +02:00

2 KiB

id type title domain repo status owner topic_slug priority created updated depends_on related
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

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

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

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

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