Muse Tools

Demo

demo.py runs a 5-act VCS stress test against a real (temporary) Muse repository and renders a shareable, self-contained HTML visualization.

Run

# From the repo root, with the venv active:
python tools/demo.py

Output lands in artifacts/ (gitignored):

File	Description
`artifacts/demo.json`	Structured event log + full commit DAG
`artifacts/demo.html`	Self-contained shareable visualization

Open the HTML in any browser:

open artifacts/demo.html        # macOS
xdg-open artifacts/demo.html   # Linux

Options

--output-dir PATH   Write output here (default: artifacts/)
--json-only         Skip HTML rendering, emit JSON only

What the 5 acts cover

Act	Operations
1 · Foundation	`init`, 3 commits on `main`
2 · Divergence	3 branches (`alpha`, `beta`, `gamma`), 5 branch commits
3 · Clean Merges	`merge alpha`, `merge beta` — auto-resolved two-parent commits
4 · Conflict & Resolution	`conflict/left` + `conflict/right` → CONFLICT → manual resolve + commit
5 · Advanced Ops	`cherry-pick`, `show`, `diff`, `shelf save`, `shelf pop`, `revert`, `tag`, `log`

Typing Audit

typing_audit.py scans the codebase for banned typing patterns (enforcing the "ratchet of zero" policy from AGENTS.md).

python tools/typing_audit.py --dirs muse/ tests/ --max-any 0

File History 10 commits

sha256:c287f599c5429903a139eadf3c5db5d930520e57cb0c3c575d9570e953c3b2d6 chore: bump version to 0.2.0.dev2 — nightly.2 Sonnet 4.6 patch 11 days ago

sha256:8de4334a98c945aace420969d389ad678aa926d4ab4e886b2ac4c4241cb3bf2b revert: keep pyproject.toml in canonical PEP 440 form Sonnet 4.6 patch 14 days ago

sha256:50bb615c573aa4b928fca75b60f82ba2a659910066507cec6a95c412ae22ccb9 docs: add issue docs for push have-negotiation bug (#55) an… Sonnet 4.6 18 days ago

sha256:d90d175cded68aae1d4ffcf4858917854195d0cd8ce1fe73cee4dbc02541cb74 chore: trigger push to surface null-OID paths Sonnet 4.6 23 days ago

sha256:e452ad9a6ace6ccc6d875a35e06caf9da5576a970c1c36133b69a891ce5fefa8 chore: prebuild timing test Sonnet 4.6 33 days ago

sha256:0008ab6695e3e064b3e236b24fd19e538fef6a588eb0d211622f4466d919c0b1 merge: pull staging/dev — advance to 0.2.0rc12 Sonnet 4.6 patch 35 days ago

sha256:9c33d61749fff814c5226d5386aa2af7064c2c02788594a25fdd709358132eea fix: _PROPOSAL_PREFIX_RESOLVE_LIMIT 200 → 100 to match hub … Sonnet 4.6 47 days ago

sha256:36c3cb3e76619d4c30a6d9bf81b5ec4ff148e30dcfed913e3114ca7b43b81c7e fix: rename objects→blobs in push client and all stale test… Sonnet 4.6 patch 49 days ago

sha256:c06a9b9b9fee26c68ea725b44d54b2c0a171301ce9de746d5b656617b4463a9a fix: repair four test failures from post-migration audit Sonnet 4.6 patch 56 days ago

sha256:1900655993c83c4107067375548a7be823e471d2515830842f1a12cba4bd3cdf fix: unified object store migration — idempotent writes, JS… Sonnet 4.6 minor ⚠ 56 days ago