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 4 commits

sha256:81ae324db5ad375fbfe4834c6fcb378312cafad3cc92dec5d3e5c427306621a2 fix: remove commit_exists filter from have anchors — server… Sonnet 4.6 patch 21 days ago

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

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

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