coulomb/repo-manager
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Repository integration layer to the helic-forge agentic software factory and operations facility.
190 commits 1 branch 0 tags 2.6 MiB
Find a file
tegwick d63f8b27e7 docs: close stale repo manager work 
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a053ff-1d6f-7fe2-ac1c-a6eb40a42a0c
2026-08-31 12:14:33 +02:00
.githooks feat: advance repository records and provenance 2026-08-21 22:07:48 +02:00
config fix registrar writebacks and own the State Hub access map 2026-08-28 20:48:21 +02:00
decisions docs: prepare reef identifier batch 2026-08-31 06:36:02 +02:00
docs docs: close stale repo manager work 2026-08-31 12:14:33 +02:00
history docs: research SH repo tooling, architecture blueprint, RMGR-WP-0002 2026-08-09 23:04:49 +02:00
intakes chore(registrar): assign State Hub identifiers 2026-08-21 22:44:54 +02:00
interfaces feat(identifiers): verify batch projections 2026-08-22 23:50:34 +02:00
schemas feat(handoffs): publish owner task interfaces 2026-08-22 14:15:48 +02:00
specs docs: research SH repo tooling, architecture blueprint, RMGR-WP-0002 2026-08-09 23:04:49 +02:00
src/repo_manager docs: close stale repo manager work 2026-08-31 12:14:33 +02:00
tests docs: close stale repo manager work 2026-08-31 12:14:33 +02:00
workplans docs: close stale repo manager work 2026-08-31 12:14:33 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-08-31 11:56:09 +02:00
.gitignore feat(RMGR-WP-0001): complete T05 end-to-end vertical slice 2026-08-09 22:49:31 +02:00
.repo-classification.yaml Seed Repo Manager foundation 2026-08-09 16:36:09 +02:00
AGENTS.md feat: add governed fast work-record sync 2026-08-30 22:38:54 +02:00
INTENT.md docs: establish INTENT/SCOPE and activate RMGR-WP-0001 2026-08-09 21:55:59 +02:00
Makefile docs(RMGR-WP-0001): complete T04 implementation foundation 2026-08-09 22:41:26 +02:00
pyproject.toml feat: finish register receiving and authority routing 2026-08-21 23:15:48 +02:00
README.md feat: add governed fast work-record sync 2026-08-30 22:38:54 +02:00
SCOPE.md docs: establish INTENT/SCOPE and activate RMGR-WP-0001 2026-08-09 21:55:59 +02:00
WORK-RECORDS.md docs: close stale repo manager work 2026-08-31 12:14:33 +02:00

README.md

repo-manager

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.
Flavor tooling (not a domain hub)
Domain infotech
Parent project prj-state-hub-retirement
Foundation WP RMGR-WP-0001

Start with INTENT.md, SCOPE.md, and the genesis record.

Architecture:

make install   # or: uv pip install -e ".[dev]"
make test
rmgr --version
rmgr observe --path .
rmgr reconcile --path .
rmgr update-task-status --path . --task-id <ID> --status progress
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
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
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
rmgr rapp wrap --path ../rapp-some-app --app some-app \
  --ownership-repo some-app --from-app ../some-app
rmgr rapp validate --path ../rapp-user-engine --family-root ..
rmgr rapp place --path ../rapp-some-app --reef reef-railiance
rmgr conform --path .
rmgr prefix-uniqueness --root ..
rmgr scaffold --path ../prj-example --flavor project --wp-prefix EX-WP --no-commit
rmgr scaffold --path . --refresh-hub-access --no-commit  # State Hub access table from config/state-hub-access.yaml

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.

Vertical-slice proof: docs/evidence/t05-vertical-slice.md.

Direction: