From 72c8f80b1f7302f4a20d79bf9281c2259fbaf117 Mon Sep 17 00:00:00 2001
From: tegwick <bernd.worsch@gmail.com>
Date: Mon, 3 Aug 2026 18:51:40 +0200
Subject: [PATCH] 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.
---
 .../STATE-WP-0078-ops-run-read-projection.md  | 91 +++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 workplans/STATE-WP-0078-ops-run-read-projection.md

diff --git a/workplans/STATE-WP-0078-ops-run-read-projection.md b/workplans/STATE-WP-0078-ops-run-read-projection.md
new file mode 100644
index 0000000..7f2ce27
--- /dev/null
+++ b/workplans/STATE-WP-0078-ops-run-read-projection.md
@@ -0,0 +1,91 @@
+---
+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-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
+```
+
+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
+```
+
+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
+```
+
+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