96 lines
2.3 KiB
Markdown
96 lines
2.3 KiB
Markdown
---
|
|
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
|
|
|
|
```task
|
|
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
|
|
|
|
```task
|
|
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
|
|
|
|
```task
|
|
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
|