coulomb/repo-manager
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
repo-manager/README.md

72 lines
3.5 KiB
Markdown
Raw Normal View History

Initial commit
2026-08-09 14:02:19 +00:00
# repo-manager
Seed Repo Manager foundation
2026-08-09 16:36:09 +02:00
Repository integration boundary for the HelixForge agentic software development
and operations environment.
Repositories remain independently valid and usable. Repo Manager gives each
repository a stable representation inside HelixForge, observes its declared
state, performs governed repository changes, and hosts its coach/lead/director
agent representation.
docs: establish INTENT/SCOPE and activate RMGR-WP-0001 Strengthen Intent and Scope for State Hub registration and HelixForge boundaries; mark foundation workplan active. Classification synced via register-from-classification (do not re-run statehub register bootstrap — it collides with RMGR-WP-0001).
2026-08-09 21:55:59 +02:00
| | |
| --- | --- |
| **Flavor** | tooling (not a domain hub) |
| **Domain** | infotech |
| **Parent project** | [prj-state-hub-retirement](../prj-state-hub-retirement) |
| **Foundation WP** | [RMGR-WP-0001](workplans/RMGR-WP-0001-foundation.md) |
Seed Repo Manager foundation
2026-08-09 16:36:09 +02:00
Start with [INTENT.md](INTENT.md), [SCOPE.md](SCOPE.md), and the
[genesis record](history/2026-08-09-genesis.md).
docs(RMGR-WP-0001): complete T01 repository representation model Define ManagedRepository fields with authority vs projection, declared record classes, signals, agent roles, and State Hub managed_repos map.
2026-08-09 22:01:58 +02:00
Architecture:
- [Repository representation v0.1](docs/repository-representation_v0.1.md)
docs(RMGR-WP-0001): complete T02 observation and command contracts Define helixforge.repo-manager 0.1: observation ops, governed command catalog, authz scopes, idempotency, evidence, failures, and hub-core ports.
2026-08-09 22:06:46 +02:00
- [Observation and command contracts v0.1](docs/observation-command-contracts_v0.1.md)
docs(RMGR-WP-0001): complete T03 State Hub extraction inventory Map registration, host paths, parsing, consistency, writeback, deps, sweep, and outbox candidates to keep/adapt/replace/retire with compat suites and extraction phases P0–P5.
2026-08-09 22:35:22 +02:00
- [State Hub extraction inventory v0.1](docs/state-hub-extraction-inventory_v0.1.md)
docs(RMGR-WP-0001): complete T04 implementation foundation Accept ADR-001: Python 3.12, FastAPI, Postgres/SQLAlchemy async, src layout, uv/hatchling, pytest. Scaffold package, rmgr CLI stub, and version tests.
2026-08-09 22:41:26 +02:00
- [ADR-001 Implementation foundation](docs/adr-001-implementation-foundation.md)
docs: add Railiance app wrapper best-practice guide Record how rapp-* repos wrap first-party apps for Railiance, using user-engine as the pilot. Opens RMGR-WP-0006 (T01 done) and includes fix-consistency ID writeback for WP-0004/0005/0006.
2026-08-18 12:18:45 +02:00
- [Railiance app deployment guide](docs/RailianceAppDeploymentGuide.md) (`RMGR-WP-0006`)
feat: model repo standards and detect prefix collisions Implement RMGR-WP-0004 T01 (flavor, required files, anti-patterns from canon) and T08 (prefix ownership registry plus uniqueness scan). rmgr conform and rmgr prefix-uniqueness are detection only.
2026-08-18 13:28:40 +02:00
- [Repository standards v0.1](docs/repository-standards_v0.1.md) (`RMGR-WP-0004`)
feat(RMGR-WP-0008): add workplan and register receiving surfaces
2026-08-21 17:15:21 +02:00
- [Repository registers v0.1](docs/repository-registers_v0.1.md) (`RMGR-WP-0008`)
docs(RMGR-WP-0001): complete T04 implementation foundation Accept ADR-001: Python 3.12, FastAPI, Postgres/SQLAlchemy async, src layout, uv/hatchling, pytest. Scaffold package, rmgr CLI stub, and version tests.
2026-08-09 22:41:26 +02:00
```bash
make install # or: uv pip install -e ".[dev]"
make test
rmgr --version
feat(RMGR-WP-0001): complete T05 end-to-end vertical slice Implement observe/reconcile/update-task-status CLI path: workplan parse, JSON projection index, git-backed task status writeback with correlation events, and E2E pytest plus evidence artifacts. Finish foundation workplan.
2026-08-09 22:49:31 +02:00
rmgr observe --path .
rmgr reconcile --path .
rmgr update-task-status --path . --task-id <ID> --status progress
feat(RMGR-WP-0008): add workplan and register receiving surfaces
2026-08-21 17:15:21 +02:00
rmgr workplan create --path . --workplan-id EX-WP-0001 --title "Example" --goal "Deliver X."
rmgr workplan update --path . --workplan-id EX-WP-0001 --status active
rmgr workplan delete --path . --workplan-id EX-WP-0001 --confirm # archives; never erases
feat: add governed fast work-record sync Assistant: codex Assistant-Model: gpt-5.6-sol Assistant-Session: 01a053ff-1d6f-7fe2-ac1c-a6eb40a42a0c
2026-08-30 22:38:54 +02:00
rmgr task add --path . --workplan-id EX-WP-0001 --title "Implement" --description "Deliver it."
rmgr task update --path . --task-id EX-WP-0001-T01 --status progress
rmgr adhoc add --path . --title "Small fix" --description "Complete the bounded fix."
rmgr sync --path . --push # primary/railliance01 derives the exact pushed commit
feat(RMGR-WP-0008): add workplan and register receiving surfaces
2026-08-21 17:15:21 +02:00
rmgr register put --path . --kind technical-debt --entry-id TD-001 \
--title "Debt item" --data-json '{"severity":"high"}'
rmgr register list --path . --kind technical-debt
feat: greenfield rapp wrap path and rail-sequence rules Add the §0 playbook and kubernetes-then-knative gate to the guide. Implement rmgr rapp skeleton/wrap/place, draft postgres consumers, and copy the fleet image workflow when missing.
2026-08-18 13:03:16 +02:00
rmgr rapp wrap --path ../rapp-some-app --app some-app \
--ownership-repo some-app --from-app ../some-app
feat: add rmgr rapp init/validate/pin-image Prove the user-engine wrapper shape and give Repo Manager a secret-free scaffolder that refuses invented rails and live-contract overwrites.
2026-08-18 12:39:24 +02:00
rmgr rapp validate --path ../rapp-user-engine --family-root ..
feat: greenfield rapp wrap path and rail-sequence rules Add the §0 playbook and kubernetes-then-knative gate to the guide. Implement rmgr rapp skeleton/wrap/place, draft postgres consumers, and copy the fleet image workflow when missing.
2026-08-18 13:03:16 +02:00
rmgr rapp place --path ../rapp-some-app --reef reef-railiance
feat: model repo standards and detect prefix collisions Implement RMGR-WP-0004 T01 (flavor, required files, anti-patterns from canon) and T08 (prefix ownership registry plus uniqueness scan). rmgr conform and rmgr prefix-uniqueness are detection only.
2026-08-18 13:28:40 +02:00
rmgr conform --path .
rmgr prefix-uniqueness --root ..
feat: flavor-correct rmgr scaffold; record C-15/C-23 file-wins RMGR-WP-0004-T03: project repos get GOAL.md and a required prefix. RMGR-WP-0005-T06 implemented in state-hub consistency.
2026-08-18 13:36:26 +02:00
rmgr scaffold --path ../prj-example --flavor project --wp-prefix EX-WP --no-commit
fix registrar writebacks and own the State Hub access map Ignore generated WORK-RECORDS.md/.custodian-brief.md in the registrar git precondition, commit identifier writebacks even when registration is incomplete, and name the remaining records in the error. Add config/state-hub-access.yaml as the single source for the AGENTS.md port map, rendered by rmgr scaffold and refreshed with --refresh-hub-access. Assistant: grok Assistant-Session: 01a04996-76e8-7f53-b971-1885cfbed436
2026-08-28 20:48:21 +02:00
rmgr scaffold --path . --refresh-hub-access --no-commit # State Hub access table from config/state-hub-access.yaml
docs(RMGR-WP-0001): complete T04 implementation foundation Accept ADR-001: Python 3.12, FastAPI, Postgres/SQLAlchemy async, src layout, uv/hatchling, pytest. Scaffold package, rmgr CLI stub, and version tests.
2026-08-09 22:41:26 +02:00
```
feat(RMGR-WP-0001): complete T05 end-to-end vertical slice Implement observe/reconcile/update-task-status CLI path: workplan parse, JSON projection index, git-backed task status writeback with correlation events, and E2E pytest plus evidence artifacts. Finish foundation workplan.
2026-08-09 22:49:31 +02:00
feat: add governed fast work-record sync Assistant: codex Assistant-Model: gpt-5.6-sol Assistant-Session: 01a053ff-1d6f-7fe2-ac1c-a6eb40a42a0c
2026-08-30 22:38:54 +02:00
`rmgr sync` is the normal work-record closeout path. It uses the canonical kind
registry, fills only missing deterministic UUIDv5 identifiers, refuses dirty or
behind workplan sources, verifies that the API is `primary/railliance01`, and
requests one central forge-derived reconciliation. A local/cache State Hub is
never populated. `registrar-reconcile` remains only for sealed legacy UUID
migration and repair.
feat(RMGR-WP-0001): complete T05 end-to-end vertical slice Implement observe/reconcile/update-task-status CLI path: workplan parse, JSON projection index, git-backed task status writeback with correlation events, and E2E pytest plus evidence artifacts. Finish foundation workplan.
2026-08-09 22:49:31 +02:00
Vertical-slice proof: [docs/evidence/t05-vertical-slice.md](docs/evidence/t05-vertical-slice.md).
docs: research SH repo tooling, architecture blueprint, RMGR-WP-0002 Document how State Hub registers, resolves, reconciles, and mutates repos; blueprint Stage B dual-run toward retirement; open workplan for SH adapter writeback/reconcile without non-retirement refactors.
2026-08-09 23:04:49 +02:00
Direction:
- [State Hub repo tooling research](history/2026-08-09-state-hub-repo-tooling-research.md)
- [Architecture blueprint (retirement path)](specs/ArchitectureBlueprint.md)
feat(RMGR-WP-0002): dual-run writeback, flags, meter, SH facade Add dual-run flags/meter, harden task-status (idempotency, UUID, head, push), State Hub adapter for PATCH /tasks and C-15/reconcile proxy, pilot evidence, and finish RMGR-WP-0002.
2026-08-09 23:19:56 +02:00
- Dual-run: [docs/dual-run.md](docs/dual-run.md) · [RMGR-WP-0002](workplans/RMGR-WP-0002-retirement-dual-run-strangler.md)
Reference in a new issue Copy permalink