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

sha256:ac29b8ba9021514a03ab2782d92bf67671f0efa5b3b70d46f7598c5d4e923378 docs: record muse#74 Phase 4 live verification (SCR_13, SCR_14) Sonnet 5 13 days ago

sha256:2562dffa0a0822ac1bdea854f9b267843c6ce95b497a9dc5c55837c80a3ebd0a feat: domain_command_registry — Phase 1 of muse#74 (SCR_01-03) Sonnet 4.6 patch 13 days ago