activity-core/workplans/ACTIVITY-WP-0015-adopt-statehub-beachhead-endpoint.md
tegwick cdbe4de2bf
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Build and Publish Container Image / build-and-push (push) Successful in 1m12s
feat(railiance): adopt state-hub edge relay beachhead for WP-0015
Deploy actcore-statehub-edge-relay, point STATE_HUB_URL at it, retire the
bespoke state-hub bridge, and accept edge-relay queued write receipts in
report and ops evidence sinks.
2026-07-09 01:04:27 +02:00

2.3 KiB

id type title domain repo status owner topic_slug created updated state_hub_workstream_id
ACTIVITY-WP-0015 workplan Adopt State Hub Beachhead Endpoint infotech activity-core finished claude activity-core 2026-06-24 2026-07-09 bbc07f9e-9323-4b2b-b556-c33b37d0b228

Adopt State Hub Beachhead Endpoint

Carries the blocked remainder of ACTIVITY-WP-0014 T05. The in-repo half (idempotency-keyed State Hub writes) shipped in WP-0014; this workplan adopts the state-hub-owned edge relay (write outbox v1) for the railiance01 runtime.

Scope note (2026-07-09): Path B — beachhead v1 shipped with write outbox. 2026-07-09 update: state-hub edge relay read cache landed for allowlisted GET routes; activity-core consumes stale cache transparently. Operator deploy of a state-hub image containing the read-cache code is still required on railiance01.

Point STATE_HUB_URL at the beachhead

id: ACTIVITY-WP-0015-T01
status: done
priority: medium
state_hub_task_id: "76b6132d-394a-4a67-bef6-73bb9d1e277e"

actcore-runtime-config now sets STATE_HUB_URL to http://actcore-statehub-edge-relay:8000. The relay runs the state-hub edge relay image with upstream state-hub.state-hub.svc.cluster.local:8000 and a PVC for the SQLite outbox. activity-core sinks accept HTTP 202 queued receipts as successful delivery pending replay (parse_state_hub_write_response).

Operator verification still required on railiance01: apply the manifest with a state-hub image that includes edge read cache, confirm GET /edge/health shows upstream_reachable: true and read_cache.entry_count > 0 after warm-up, simulate upstream outage to confirm stale GET /state/summary and queued progress writes, then replay with statehub outbox replay.

Retire the bespoke actcore-state-hub-bridge proxy

id: ACTIVITY-WP-0015-T02
status: done
priority: medium
state_hub_task_id: "526c2129-cbf7-4531-a319-aebfc75cc6a3"

Removed actcore-state-hub-bridge Deployment/Service from k8s/railiance/20-runtime.yaml. Ops inventory and tests now reference actcore-statehub-edge-relay.

Operator verification still required: one overnight daily-statehub-wsjf-triage run after deploy (original failure condition). If upstream was briefly down, check the relay outbox and replay before closing the stabilization window.