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

sha256:18b983389ee1b55900fcd799bfbb496552d2e3ecded9d18cefbfef188947a12e chore: remove blob-debug test marker file Sonnet 4.6 20 hours ago

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

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

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

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

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

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