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

44 lines
1.6 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)
```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
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
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