repo-manager/workplans/RMGR-WP-0001-foundation.md

2.7 KiB

id type title domain repo status owner topic_slug created updated state_hub_workstream_id
RMGR-WP-0001 workplan Repo Manager architecture and foundation infotech repo-manager proposed codex repo-manager 2026-08-09 2026-08-09 e32a9d49-a38f-4117-8e37-1c66afe1dad1

Repo Manager architecture and foundation

Goal

Turn the repository genesis and scope into an implementable contract and first vertical slice, coordinated by the State Hub retirement project.

Define the repository representation

id: RMGR-WP-0001-T01
status: todo
priority: high
state_hub_task_id: "43468b5c-f49f-43c3-bf30-922fadc1f8c0"

Specify stable repository identity, locations, revisions, classifications, declared records, relationships, health, lifecycle, and coach/lead/director agent assignments. Identify which fields are authoritative in the repository and which are replaceable projections.

Define observation and command contracts

id: RMGR-WP-0001-T02
status: todo
priority: high
state_hub_task_id: "2453316f-33f4-41d0-bcb5-c7552db88d68"

Define normalized repository facts, governed commands, authorization context, idempotency, correlation, evidence, failure behavior, and hub-core integration without exposing persistence models.

Inventory extraction candidates

id: RMGR-WP-0001-T03
status: todo
priority: high
state_hub_task_id: "deee10be-25e1-4ee7-b47e-93dc816916c9"

Map relevant State Hub repository registration, host-path, workplan parsing, consistency, reconciliation, dependency, file-mutation, and outbox behavior to keep/adapt/replace/retire dispositions with compatibility tests.

Select the implementation foundation

id: RMGR-WP-0001-T04
status: todo
priority: medium
state_hub_task_id: "0a041f4e-09fc-4f69-8a48-ac396186bc8f"

Choose the runtime, persistence, package, migration, test, and deployment shape consistent with the ordinary HelixForge platform. Record the decision before substantial implementation.

Prove one repository end to end

id: RMGR-WP-0001-T05
status: todo
priority: high
state_hub_task_id: "5036a248-1c47-423f-be8d-4fd232896c31"

Register and represent one independently valid repository, index its declared work, emit a normalized change through hub-core contracts, apply one authorized file-backed transition, and prove the resulting Git evidence and rebuilt projection.

Acceptance

  • The authority and data model are explicit.
  • Observation and command contracts are versioned and testable.
  • State Hub extraction candidates have dispositions.
  • The implementation foundation has a recorded decision.
  • One repository completes the end-to-end vertical slice.