ecosystem-equivalence-reconcile

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.

Jump to install

Repository: vamseeachanta/workspace-hub
Last source activity: June 25, 2026 at 09:06
Detected SKILL.md language: English
Stars: 16
Forks: 7

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/vamseeachanta/workspace-hub --skill ecosystem-equivalence-reconcile

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

communication-voice

Write outbound email and external messages in Vamsee Achanta's voice — a subtle offer to help, never bold or rash claims. Load before drafting ANY email, LinkedIn/Collide reply, proposal note, or outreach sent under his name.

2026-07-30

hf-dataset-publishing

Save/publish analysis or computation results from ANY ecosystem repo to Hugging Face as a queryable, viewer-renderable dataset. Use when the user wants to "save results to hugging face", "publish dataset to HF", "hugging face data saving", "save analysis results", "hf dataset", "make results queryable", or "render via datasets-server API". Reshapes nested results into flat parquet tables, writes a dataset card with a viewer `configs:` block and provenance, applies license/public-vs-private routing, enforces a domain data-quality gate (faithful-to-source != correct), publishes to `aceengineer/<repo>-<projection>`, and verifies via the datasets-server API.

2026-07-28

github-repo-management

Clone, create, fork, configure, and manage GitHub repositories. Manage remotes, secrets, releases, and workflows. Works with gh CLI or falls back to git + GitHub REST API via curl.

2026-07-23

View all from this repository

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

# 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

Machine (role)	Hygiene cleanup	Notes
`dev-primary` (ace-linux-1, control-plane)	report-only for branch/worktree	runs the intentional worktree-per-feature automation + owns the `daily-cleanup` cron; the driver auto-sets `DESTRUCTIVE_OK=0` here so it never trampls live worktrees
`dev-secondary` (ace-linux-2)	full auto-safe eligible	scratch/execution box
`ace-win-1`, `ace-win-2` (Windows)	scout-only; bug-fixes OK	licensed hosts; do max work on Linux, keep these thin

Verdict	Cause	Corrective action
`STALE-CHECKOUT`	dirty / behind / ahead / origin-ref > 12h	clean the tree (commit-push or `--stash-dirty`), `git fetch origin main`, re-run `collect-equality.sh`
`MISSING-EVIDENCE` (machine dim)	no fresh report on this box	run `collect-equality.sh` here
`MISSING-EVIDENCE` (`harness:<provider>:*`)	provider/ capability absent — or no Claude baseline on this host (Hermes-only box grades these by design)	install/auth the provider; on a Hermes-only host, expected
`BELOW-BASELINE` `solvers`	licence probe emits `present` ≠ `licensed`	operator/Windows licence-probe follow-up (PR #2850 note)
`BELOW-BASELINE` `data_access`	a required tier-1 sibling isn't cloned	clone the missing repo under the sibling root
`BELOW-BASELINE` `compute`	under cores/ram/gpu floor	operator — hardware, or reconcile `harness-config.yaml` `compute_floor`
`DIVERGES` / `NO-MAJORITY` `skills`	tracked symlink materialized as a text file (`core.symlinks=false`)	`git config core.symlinks true`; `rm` + `git checkout --` the symlink paths
`DIVERGES` / `NO-MAJORITY` `harness` / `behavior`	runtime/config drift	`build-soul-runtime.sh` + `install-soul-runtime.sh`, then re-collect
`DIVERGES` / `NO-MAJORITY` `scheduler`	cron drift	`setup-cron.sh --check`, then re-collect
`DIVERGES` / `NO-MAJORITY` (other)	often a stale peer report inflating divergence	re-collect on this box first; if it persists, reconcile the config
`UNREACHABLE` / `EXPECTED-DIFF` / `EXPECTED-DIVERGENCE`	by design	no action

ecosystem-equivalence-reconcile

Install options

Review the source files

Ecosystem + Equality Reconcile

Safety boundary (load-bearing)

Procedure

Ecosystem + Equality Reconcile

Safety boundary (load-bearing)

Procedure

Machine policy (who may do destructive cleanup)

Equality verdict → corrective action (the playbook)

After reconciling

Related

ecosystem-equivalence-reconcile

Source facts

Install options

Review the source files

More from this repository

Ecosystem + Equality Reconcile

Safety boundary (load-bearing)

Procedure

More from this repository

Ecosystem + Equality Reconcile

Safety boundary (load-bearing)

Procedure

Machine policy (who may do destructive cleanup)

Equality verdict → corrective action (the playbook)

After reconciling

Related