The paper agrees with the code — guide v11, README, DESIGN re-rulings, and the adjudicated sweep

Step 7 of strategy/01-git-excision.md, the companions. The agent guide bumps to v11: the Git section teaches repo-resident etiquette alone (stage only your own paths, commit your own changes, leave app-maintained files to the app) — existing boards heal to the new text on next open. README re-anchors: the four git feature bullets out, tiers say the complete Mac experience is free, and one bullet states the format's git-friendliness promise. The changelog drops the never-shipped git entries. DESIGN re-rules: 06 retired with Undo routing migrated to 13 (now the sole substrate's doc, seam kept open), 07 retired as written pending the ops-service workstream, 14 retired as superseded record, 12 carries the second pivot note, the index reflects all of it; the charter gets a pointer note (the anchors' full re-ruling stays with the user). InertGitTests renames to GitAgnosticStorageTests — the excision restores its original claim app-wide. And the sweep: ~70 comment sites across 36 files adjudicated against the keeper list, every present-tense description of the excised machinery made past tense or repointed, keepers untouched. 2,707 tests green.

Claude-Session: https://claude.ai/code/session_014PtZdPwqZuqEDLc6wZMtEy
This commit is contained in:
2026-08-08 12:31:27 -04:00
parent 8cf1457814
commit 445d035a83
50 changed files with 397 additions and 313 deletions
+12 -9
View File
@@ -1060,19 +1060,22 @@ public enum BoardLoader: Sendable {
// MARK: - The earlier-occurrence-wins history seam
/// **Where git path history plugs into the duplicate-id winner rule** (01-storage-format.md
/// **Where git path history once plugged into the duplicate-id winner rule** (01-storage-format.md
/// § Fractal layout Rules: "on git boards, the path history already tracks outranks the
/// newcomer (both tracked: the path that entered history first)").
/// newcomer (both tracked: the path that entered history first)") kept as a seam, unfilled,
/// since app-managed git was excised entirely (`strategy/01-git-excision.md`, 2026-08-08).
///
/// A seam rather than an implementation because the first rung of that ladder is unreachable
/// without git: the free tier runs no git machinery at all (12-editions.md The inert posture),
/// so the loader consults an injected ranker and falls through to birth date and traversal order
/// when there is none which is every free-tier board, and every Pro board without a repo.
/// A seam rather than an implementation because the first rung of that ladder was unreachable
/// without git even before the excision: the free tier ran no git machinery at all
/// (12-editions.md The inert posture), so the loader consults an injected ranker and falls
/// through to birth date and traversal order when there is none which is every board today, no
/// exceptions.
///
/// Deliberately one closure and no protocol: the loader asks one question "how early did this
/// path enter history" and pro-m1's implementation answers it from `git log --diff-filter=A
/// --follow`-shaped plumbing behind the provider seam. `nil` means "untracked, or no history
/// here", which the rule reads as *outranked by anything tracked*.
/// path enter history" and pro-m1's implementation once answered it from `git log
/// --diff-filter=A --follow`-shaped plumbing behind the provider seam, before that plumbing left
/// with the excision. `nil` means "untracked, or no history here", which the rule reads as
/// *outranked by anything tracked*; nothing installs a ranker today, so every path reads `nil`.
///
/// - Parameter rank: keyed by the occurrence's **board-root-relative path**, which is what a
/// repo's path history knows; lower is earlier.