README.md
markdown
sha256:88ac91129873e6a496e9189515aa690eb893ae25d69c8f72af141a2be5068eb3
docs: docstring sprint contract→find-symbol — idiomatic run…
Sonnet 4.6
patch
138 days ago
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:88ac91129873e6a496e9189515aa690eb893ae25d69c8f72af141a2be5068eb3
docs: docstring sprint contract→find-symbol — idiomatic run…
Sonnet 4.6
patch
138 days ago
sha256:a09b1b4f6838754495547f200aa0ce88e2f56ffc5b20b900f6f0cff2c3cdede9
fix(cursorignore): remove git-ism (.git/worktrees)
Human
minor
⚠
141 days ago