state-hub/workplans/STATE-WP-0086-fast-forge-projection-reconcile.md
tegwick 34f5cb3fc3
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
Build and Publish Multi-Context Image / build-and-push (push) Successful in 24s
feat: add fast forge work-record reconciliation
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a053ff-1d6f-7fe2-ac1c-a6eb40a42a0c
2026-08-30 22:38:54 +02:00

2 KiB

id type title domain repo status owner topic_slug created updated related state_hub_workstream_id
STATE-WP-0086 workplan Fast single-repository forge projection reconciliation infotech state-hub active codex infotech 2026-08-30 2026-08-30
STATE-WP-0083
RMGR-WP-0005
RMGR-WP-0012
c43b1b2c-2f84-540a-9b93-03a13ed148f1

Fast single-repository forge projection reconciliation

Goal

Expose the existing forge-derived repository reset as a guarded, idempotent, single-request compatibility API. The central hub reads the exact pushed forge commit itself and applies workplan/task changes in one database transaction.

Guarded exact-commit API

id: STATE-WP-0086-T01
status: done
priority: high
state_hub_task_id: "1b72b4e2-419a-5b55-91a7-3f56afba7480"

Add a primary-only endpoint that derives one repository from Forgejo, compares the derived commit with the caller's expected commit, and commits or rolls back the complete repository reconciliation atomically.

Complete task and workplan field projection

id: STATE-WP-0086-T02
status: done
priority: high
state_hub_task_id: "25e1a146-47b2-5704-af45-b314c5a5a353"

Carry owner, priority, description, blocking, and human-intervention fields through the existing forge derivation and update path without weakening its collision, unreadable-source, or retirement safeguards.

Idempotency, regression, and performance proof

id: STATE-WP-0086-T03
status: progress
priority: high
state_hub_task_id: "88723069-59d4-5b7e-85a4-36c3575382af"

Test wrong-instance rejection, commit mismatch, replay, transactional rollback, ad-hoc creation, task updates, and bounded request count. Document the endpoint as the fast path while retaining the full consistency checker for deep audits.

Focused projection tests are green, including idempotent replay and exact-commit refusal, and the complete State Hub suite is the implementation gate. This task remains in progress until the endpoint is deployed and a live primary receipt records the production latency and counts.