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`, `stash`, `stash 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 5 commits

sha256:660fcac1df3ab28f61862e961890bd2ca8b754fa0242079d93ca1e25037ec8a6 chore(tests): add docstring to tests/__init__.py so rc14 tr… Human 26 days ago

sha256:d8316ffae901be06347e16ab55be11868eb519dd16ade3e8aa16a99e662f7e62 baseline: rc14 re-baseline after rc3 store corruption recovery Human patch 26 days ago

sha256:50d413a635f57761c3fce1f70251b957b6423821525bf330747ef4007339222e Merge branch 'dev' into main Human 29 days ago

sha256:fb67fed5a4d3e40de84bdd163de94ef1386570bef1dd1a020a732c8a038962ce Merge branch 'dev' into main Human 48 days ago

sha256:1c4b3e3a9a1f300774c3ee662b572a698d5fd405bf765a71e6011a2e9c3eaaaa feat: Muse — version control for the agent era Human 101 days ago