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
+9 -7
View File
@@ -84,9 +84,10 @@ public extension CardSessionFlushing {
/// call site and supplies the real ones.
///
/// The two flush seams that are `nil` today `editorFlush` and `committerFlush` are named rather
/// than left to be discovered: 02 fixes their relative order ("editor saves before the pending
/// auto-commit"), and the milestone that adds a debounced editor save should have nowhere to put it
/// except the slot that already sits in the right place.
/// than left to be discovered: 02 fixes their relative order (editor saves before any board-level
/// flush), and a future consumer should have nowhere to land except the slot that already sits in
/// the right place. `committerFlush`'s original consumer was the auto-committer, excised 2026-08-08
/// (strategy/01-git-excision.md); the slot outlives it for whatever durable-history flush comes next.
@MainActor
public struct CloseFlushCoordinator {
@@ -121,12 +122,13 @@ public struct CloseFlushCoordinator {
public var storeFlush: () async -> Void
/// The card windows' debounced body saves (05-card-window.md, m6). Runs **before**
/// `committerFlush`: 02 is explicit that editor saves land before the pending auto-commit, so a
/// session's last keystrokes are inside the commit that closes it rather than orphaned in the
/// next one.
/// `committerFlush`: 02 is explicit that editor saves land before any board-level flush, so a
/// session's last keystrokes ride whatever board-level flush follows rather than being orphaned
/// behind it.
public var editorFlush: (() async -> Void)?
/// The pending debounced auto-commit (06-history-undo.md, m7).
/// The board-level flush that ran last the excised auto-committer's slot, permanently `nil`
/// since 2026-08-08 (strategy/01-git-excision.md); see the header for why the slot survives.
public var committerFlush: (() async -> Void)?
// MARK: Step 3 the record