ecosystem-equivalence-reconcile

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:

1. Repo-ecosystem hygiene — dirty working trees, behind/ahead upstream, merged-but- undeleted branches, stale worktrees, stale stashes, across this machine's sibling repos.
2. 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

# 1. SEE the plan (read-only — safe anywhere, anytime)
bash scripts/readiness/reconcile-ecosystem.sh
bash scripts/readiness/reconcile-ecosystem.sh --json   # machine-readable, for CI/dispatch

# 2. APPLY only the auto-safe subset (ff-pulls clean repos, etc.)
bash scripts/readiness/reconcile-ecosystem.sh --apply

# 3. Resolve dirty trees deliberately (recoverable stash), then re-pull
bash scripts/readiness/reconcile-ecosystem.sh --apply --stash-dirty


bash scripts/readiness/reconcile-ecosystem.sh --apply --equality