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:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user