repo-manager/workplans/RMGR-WP-0012-fast-work-record-mutation-and-projection.md

id	type	title	domain	repo	status	owner	topic_slug	created	updated	related	state_hub_workstream_id
RMGR-WP-0012	workplan	Fast work-record mutation and forge projection trigger	infotech	repo-manager	active	codex	infotech	2026-08-30	2026-08-30	RMGR-WP-0005 RMGR-WP-0008 STATE-WP-0083 STATE-WP-0086	c9690d0f-ed75-56a5-9738-39fe49856e2e

Fast work-record mutation and forge projection trigger

Goal

Make ad-hoc, workplan, and task creation and updates deterministic and quick, then ask the authoritative State Hub to derive one repository projection from the pushed Forgejo commit. Repository files and the forge remain authoritative; Repo Manager does not upload a workstation-built replacement projection.

Canonical identifiers and deterministic registration

id: RMGR-WP-0012-T01
status: done
priority: high
state_hub_task_id: "7d8ecdbd-4350-54e7-8f6c-4692e1e0f3ea"

Use the work-record kind registry as the only identifier grammar. Accept repository-qualified ad-hocs and assign missing deterministic UUIDv5 values locally without replacing legacy UUIDs or requiring a registrar host.

Governed ad-hoc and task mutations

id: RMGR-WP-0012-T02
status: done
priority: high
state_hub_task_id: "f6add501-4153-5df5-aacc-ebd444dca00c"

Add concurrency-safe, idempotent commands for daily ad-hoc task creation and general task creation/update while retaining optimistic Git HEAD checks and explicit push sealing.

Fast authoritative projection trigger

id: RMGR-WP-0012-T03
status: done
priority: high
state_hub_task_id: "02d155c6-0baa-573a-9055-4aee91dcb246"

Add one sync command that validates local records, writes only missing derived identifiers, verifies the branch is visible on its upstream, verifies the hub is the railiance01 primary, and requests reconciliation against that exact forge commit.

Regression, performance, and operator cutover

id: RMGR-WP-0012-T04
status: progress
priority: high
state_hub_task_id: "723c77ab-c2a3-545f-94d2-174b6f983a67"

Cover canonical/ad-hoc grammar, retries, Git preconditions, incorrect hub identity, exact-commit reconciliation, and concise receipts. Document the fast path and retain registrar reconciliation only as a legacy migration tool.

Implementation and local verification are complete: the Repo Manager suite is green, the focused fast-path tests enforce two HTTP requests, and current agent and repository-standard documentation points at rmgr sync. This task remains in progress until the matching State Hub endpoint is deployed and one live Forgejo-to-primary receipt establishes the production latency baseline.