chore: ledgers merge by union; land the 2026-08-13 Muse Glimmer journal - #65
Merged
Merged
Conversation
DECISIONS.md gets merge=union; CHECKPOINT.md and PLAN.md are marked -merge deliberately, so a divergence stays a human decision rather than a silent concatenation. Verified on this repo's own 3-ahead/20-behind divergence: DECISIONS.md auto-merged to 437 lines (395 upstream + 42 local) with zero lines lost from either side; CHECKPOINT.md and PLAN.md conflicted as intended and were hand-resolved chronologically.
mazze93
marked this pull request as draft
September 9, 2026 14:40
mazze93
marked this pull request as ready for review
September 9, 2026 14:40
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Lands the three journal commits that had been stranded at 3-ahead / 20-behind since 2026-08-13, plus the
.gitattributesunion rule that made the rebase tractable.Why this was stuck
Two independent blockers, both now diagnosed:
docs/journal/; both sides created it independently. Nothing could fast-forward.mainrequires verified signatures, and this machine has none. The account has zero SSH signing keys registered (GET /user/ssh_signing_keysreturns empty). The local key exists and signs correctly —git log --format=%G?reportsGon all four commits — but GitHub cannot verify it, so every commit reads Unverified and the ruleset rejects a direct push. A directgit pushfrom this clone could never have succeeded, which is most of why these commits sat for three weeks. Squash-merging this PR sidesteps it, because the resulting commit is signed by GitHub.Follow-up for the account owner, outside this PR: register
~/.ssh/id_ed25519.pub(titled "commit signing 2026-08-30",SHA256:u/YX5OMJo+IAT4nTNgydwknMkcuBwV0hf0buJNVvN7g) under Settings → SSH and GPG keys → Signing keys. Until that happens, every commit authored on this machine since 2026-08-30 is unverified across the whole fleet, not just here.The union rule
.gitattributesmarksdocs/journal/DECISIONS.mdasmerge=unionand deliberately marksCHECKPOINT.mdandPLAN.mdas-merge. The discrimination is the point: union is only safe for a ledger appended at the bottom and never edited above the last entry.CHECKPOINT.mdis a projection that gets rewritten (union would duplicate checklist items and resurrect ticked boxes) andPLAN.mdis edited in place.Verified on this repo's own real divergence rather than a synthetic case:
DECISIONS.mdmerge=unionCHECKPOINT.md-mergePLAN.md-mergeHow the two conflicts were resolved
Chronologically, with both sides preserved verbatim. Upstream's content (the 2026-08-04 session) stays as the document body; the divergent branch's content (the 2026-08-13 Muse Glimmer session) is appended below an HTML-comment seam recording its provenance, with its
H1demoted toH2so each file keeps exactly one top-level heading.Line accounting:
CHECKPOINT.md68 + 25 + 9 seam = 102.PLAN.md63 + 93 + 6 seam = 162. Nothing dropped.One incidental change
.claude/settings.local.jsonwas deleted upstream in #44 and is no longer tracked. A local modification to it existed in the working tree; this PR accepts the upstream untracking (git rm --cached) and leaves the file on disk. Note it is not in.gitignore, so it will keep reappearing as untracked — worth adding, separately.Verification
%G?=G).docs/journal/.main— pre-existing and unrelated to this change.