coulomb/repo-manager
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
repo-manager/docs/dual-run.md
tegwick 310b43079d 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

1.4 KiB
Raw Blame History

Dual-run flags (RMGR-WP-0002)

State Hub remains the MCP/REST entrypoint. When flags are on, checkout mutation is executed by Repo Manager.

Environment variables

Variable Meaning
RM_WRITEBACK=1 Task file writeback via rmgr update-task-status
RM_RECONCILE=1 fix-consistency also runs rmgr reconcile for pilots
RM_PILOT_REPOS=repo-manager Comma-separated slugs; unset = all repos when flags on
RM_METER_PATH JSONL meter path (default ~/.repo-manager/mutation-meter.jsonl)
REPO_MANAGER_SRC Optional path to repo-manager/src for SH adapter
RMGR_BIN Optional override command prefix for rmgr

Rollback

unset RM_WRITEBACK RM_RECONCILE RM_PILOT_REPOS
# or
export RM_WRITEBACK=0 RM_RECONCILE=0

State Hub immediately uses native C-15 writeback again.

Pilot (repo-manager)

export RM_WRITEBACK=1
export RM_RECONCILE=1
export RM_PILOT_REPOS=repo-manager
export REPO_MANAGER_SRC=$HOME/repo-manager/src

# From API host environment, PATCH a task or:
cd ~/repo-manager
rmgr update-task-status --path . --task-id <canonical-or-uuid> --status progress

cd ~/repo-manager && statehub fix-consistency
rmgr dual-run-status

Meter

rmgr dual-run-status
# or
wc -l ~/.repo-manager/mutation-meter.jsonl
grep repo-manager ~/.repo-manager/mutation-meter.jsonl | tail