| name | ecosystem-equivalence-reconcile |
| description | Bring THE CURRENT computer back to ecosystem + machine-equality equivalence — clean repo-hygiene drift (dirty trees, stale branches/worktrees/stashes) and remediate every non-OK equality-matrix verdict. Report-first; destructive actions are guard-gated and opt-in. |
| type | workflow |
| version | 1.0.0 |
| category | workspace-hub |
| last_updated | "2026-06-24T00:00:00.000Z" |
| source | internal |
| tags | ["equality","hygiene","reconcile","corrective-action","worktree","branches","multi-machine"] |
| related_skills | ["repo-ecosystem-hygiene","worktree-branch-sync-hygiene","repo-sync"] |
| freedom | low |
Ecosystem + Equality Reconcile
Run this on any computer to drive it back into equivalence with the rest of the
ecosystem. It reconciles two surfaces at once:
- Repo-ecosystem hygiene — dirty working trees, behind/ahead upstream, merged-but-
undeleted branches, stale worktrees, stale stashes, across this machine's sibling repos.
- Machine-equality — every cell in this machine's column of the
equality matrix (
docs/reports/machine-equality-matrix.html) that is not
OK / CONFORMS / EQUAL / PARITY.
Driver: scripts/readiness/reconcile-ecosystem.sh (repo-root relative).
It is report-first — the default run mutates nothing.
Safety boundary (load-bearing)
The driver inherits the deny-by-default guard (scripts/lib/worktree_guard.py, #3143). It
never:
- discards dirty work (it stashes — recoverable — only with
--apply --stash-dirty),
- deletes a branch that is unmerged, current, or checked out in any live worktree,
- removes a worktree it cannot prove it owns (foreign / active-session worktrees are surfaced, not pruned),
- does anything but fast-forward on remotes (no reset/force/rebase).
Every action is classified before anything runs:
| Class | Meaning | --apply behaviour |
|---|
AUTO-SAFE | reversible / guard-approved | executed |
NEEDS-APPROVAL | destructive or judgement-dependent | printed only — you run it after review |
OPERATOR-ONLY | off-box (Windows licence probe, hardware, remote host) | printed only |
Procedure
bash scripts/readiness/reconcile-ecosystem.sh
bash scripts/readiness/reconcile-ecosystem.sh --json
bash scripts/readiness/reconcile-ecosystem.sh --apply
bash scripts/readiness/reconcile-ecosystem.sh --apply --stash-dirty
bash scripts/readiness/reconcile-ecosystem.sh --apply --equality
