gabriel / build-with-muse public
patch episode-02/script #1 / 1
AI Agent gabriel · 8 hours ago · Sep 12, 2026 · Diff

Add Episode 02 script: Inside a Muse Repository

A real, verified filesystem tour of the exact hello-muse repo built in Episode 01: the ten entries under .muse/, HEAD -> refs/heads/main -> commit indirection, repo.json/config.toml, the objects/sha256/xx/yyyy fanout layout, a real commit record (read-commit, including the merge commit's parent2_commit_id and the empty agent_id/model_id/signature fields), a real snapshot manifest (read-snapshot), the raw blob bytes (cat-object), and muse verify's integrity check.

Every artifact shown was pulled from an actual repo built by replaying Episode 01's exact command sequence, not invented -- including discovering along the way that the first merge (feature/friendlier) is actually a fast-forward, not a three-way merge, which is the fix below.

Also fixes Episode 01's MERGE section: it showed 'Merge made by the three-way strategy' for both merges, but replaying the sequence for real confirms the first merge (main hadn't moved since branching) is a fast-forward, and only the second is a genuine three-way merge. Corrected to show both real outcomes.

Updated README's status table: episode 02 script done.

Co-Authored-By: Claude Sonnet 5 <[email protected]>

sha256:7b2d5841a14b73ca1db04c9de84a5fc718981343619d8cfa28237d66ada06f32 sha
sha256:750edf337e5620138bfd19e5c75545801f47eb4c334031776a6bce5c5dead3ce parent
+18 ~4 symbols
3 changed · 31 in snapshot files
sha256:ac4b85c62a7cb7577cd46328e3090fd2c88f33d53580f303fce32225a170fcd1 snapshot
+18
symbols added
~4
symbols modified
3
files changed
31
files in snapshot
0
dead code introduced
Semantic Changes 22 symbols
+ episode-02/
~ episode-02/inside-a-muse-repository.md .md 18 symbols added
+ Episode 02 --- Inside a Muse Repository section Episode 02 --- Inside a Muse Repository L1–402
+ \[0:00--0:20\] COLD OPEN section \[0:00--0:20\] COLD OPEN L13–34
+ \[0:20--1:10\] THE SHAPE OF THE DIRECTORY section \[0:20--1:10\] THE SHAPE OF THE DIRECTORY L35–71
+ \[1:10--1:55\] HEAD AND REFS section \[1:10--1:55\] HEAD AND REFS L72–112
+ \[1:55--2:35\] REPO IDENTITY AND CONFIG section \[1:55--2:35\] REPO IDENTITY AND CONFIG L113–160
+ \[2:35--3:20\] INSIDE OBJECTS/ section \[2:35--3:20\] INSIDE OBJECTS/ L161–205
+ \[3:20--4:05\] READ A COMMIT section \[3:20--4:05\] READ A COMMIT L206–255
+ \[4:05--4:45\] READ A SNAPSHOT section \[4:05--4:45\] READ A SNAPSHOT L256–289
+ \[4:45--5:20\] READ THE ACTUAL BYTES section \[4:45--5:20\] READ THE ACTUAL BYTES L290–321
+ \[5:20--5:55\] VERIFY section \[5:20--5:55\] VERIFY L322–357
+ \[5:55--6:30\] THE POINT section \[5:55--6:30\] THE POINT L358–377
+ \[6:30--7:10\] OUT section \[6:30--7:10\] OUT L378–402
+ Production Notes section Production Notes L403–462
+ Everything Shown Must Be cat-able section Everything Shown Must Be cat-able L417–425
+ Opening section Opening L410–416
+ Plant Three Seeds, Pay Off None of Them section Plant Three Seeds, Pay Off None of Them L426–440
+ Production Style section Production Style L441–448
+ The Seed section The Seed L449–462
~ README.md .md 2 symbols modified
~ Build With Muse
~ Status
~ episode-01/muse-in-7-minutes.md .md 2 symbols modified
~ Episode 01 --- Muse in 7 Minutes
~ \[3:50--4:30\] MERGE
Files Changed
+1 ~2
31 in snapshot
+ episode-02/inside-a-muse-repository.md .md
~ README.md .md
~ episode-01/muse-in-7-minutes.md .md
← Older Oldest on episode-02/script
All commits
Newer → Latest on episode-02/script

0 comments

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

To add a comment, use the Muse CLI: muse hub commit comment sha256:7b2d5841a14b73ca1db04c9de84a5fc718981343619d8cfa28237d66ada06f32 --body "your comment"