feat: muse reflog, gc, archive, bisect, blame, worktree, workspace

* feat: implement muse reflog, gc, archive, bisect, blame, worktree, workspace

Seven production-quality VCS commands that complete Muse's core feature set:

reflog — append-only per-ref journal of every HEAD movement; hooked into commit, checkout, reset, and merge so every operation is captured. Safety net for undoing accidental resets.

gc — reachability walk from all live refs; prunes unreachable blobs from the object store. --dry-run shows impact before any deletion. Handles 200 orphans in a single pass.

archive — exports any historical snapshot as tar.gz or zip. No .muse/ metadata included — distribution-only format. Supports --prefix, --ref, --output.

bisect — binary search engine (muse/core/bisect.py) with start/bad/good/skip/ run/reset/log CLI subcommands. Converges in log₂(N) steps. Agent-safe: muse bisect run <cmd> automates the hunt using exit-code protocol (0=good, 125=skip, else=bad).

blame — line-level attribution for any text file (muse/core/blame.py). Walks the commit graph, uses difflib SequenceMatcher to push each unchanged line back to the oldest commit that introduced it. --porcelain emits JSON per line for pipeline use.

worktree — multiple simultaneous branch checkouts sharing one .muse/ store. Each worktree is a sibling directory (<repo>-<name>/state/). Metadata, HEAD files, and state/ population all handled atomically. Includes add/list/remove/prune subcommands.

workspace — multi-repository composition manifest (.muse/workspace.toml). add/remove/list/status/sync subcommands. sync clones missing members and pulls existing ones. Designed for coordinator + worker agent swarms.

Testing: 133 new tests (90 unit + 43 CLI integration) across 7 new test files. All 2293 tests pass. mypy: 0 errors. typing_audit: 0 violations.

Documentation: 7 new reference pages + docs/README.md navigation updated.

* chore: remove stray test archive from repo root

* chore: ignore *.tar.gz and *.zip artifacts from muse archive

---------

Co-authored-by: Gabriel Cardona <gabriel@tellurstori.com>

G Gabriel Cardona <cgcardona@gmail.com> · 5h ago Mar 20, 2026 · e0353dfe · parent dfaf1b77

oldest

newest 94%

Snapshot Diff

307 files in tree

+27 ~6

docs/reference/archive.md .md

docs/reference/bisect.md .md

docs/reference/blame.md .md

docs/reference/gc.md .md

docs/reference/reflog.md .md

docs/reference/workspace.md .md

docs/reference/worktree.md .md

muse/cli/commands/archive.py .py

muse/cli/commands/bisect.py .py

muse/cli/commands/core_blame.py .py

muse/cli/commands/gc.py .py

muse/cli/commands/reflog.py .py

muse/cli/commands/workspace.py .py

muse/cli/commands/worktree.py .py

muse/core/bisect.py .py

muse/core/blame.py .py

muse/core/gc.py .py

muse/core/reflog.py .py

muse/core/workspace.py .py

muse/core/worktree.py .py

tests/test_cli_new_commands.py .py

tests/test_core_bisect.py .py

tests/test_core_blame.py .py

tests/test_core_gc.py .py

tests/test_core_reflog.py .py

tests/test_core_workspace.py .py

tests/test_core_worktree.py .py

docs/README.md .md

muse/cli/app.py .py

muse/cli/commands/checkout.py .py

muse/cli/commands/commit.py .py

muse/cli/commands/merge.py .py

muse/cli/commands/reset.py .py

Older refactor: rename muse-work/ → state/ dfaf1b77 All commits Newer fix: resolve commit refs by short SHA prefix in muse diff 26cae2ce

Comments

No comments yet. Be the first to start the discussion.