rzen/lanework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

The seams unbind — the provider is always native, and the git stack compiles dead

Browse Source 
Step 4 of strategy/01-git-excision.md, the entangled one: AppModel's makeHistoryProvider collapses to the native provider (the seam stays injectable per the reversibility posture), the session's git state and its wiring go (wireGitUndo, wireBranchSwitching, the card-session staging threading), BoardStore sheds commitSeam and the identity-history ranker (the loader's nil-safe rung now tops out at birth date — today's no-git behavior), SessionSettleGate keeps the gate and inherits the path utility it borrowed, BoardRegistry drops the persisted operation stamp (decode-safe), and the git banner family leaves BannerCenter with its announcer and accessibility phrases. One missed harvest tie severed (the narrator's root subject is its own now). Nothing outside Kanban/Git/ references the stack — proven by sweep. 2,855 tests green.

Claude-Session: https://claude.ai/code/session_014PtZdPwqZuqEDLc6wZMtEy
This commit is contained in:
rzen
2026-08-08 11:25:41 -04:00
parent f6a24132b6
commit cdba512512
24 changed files with 281 additions and 2567 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Kanban/Changes/ChangeNarration.swift
+10 -11
View File
@@ -64,15 +64,15 @@ public struct ChangeNarrationRequest: Sendable {
public let snapshot: BoardModel?
/// **The last-committed half** of the "last-committed vs. current" diff — supplied by the caller
/// by contract; the narrator itself never reads this from anywhere. The git stack supplied it from
/// HEAD's tree (`GitHeadSnapshot`), the former git-backed supplier; the journal will supply it from
/// memory/snapshots.
/// by contract; the narrator itself never reads this from anywhere. The retired git substrate
/// materialized it from HEAD's tree; the journal will supply it from memory/snapshots.
///
/// `nil` when the caller has nothing to diff against — the git stack's case was an unborn HEAD
/// (where `isRootCommit` already says everything) or a HEAD whose tree did not load as a board. The
/// git stack read it from the repository rather than carrying it forward from the last commit the
/// app made, because the app is not the only writer and because launch catch-up has no carried
/// value to offer: see `GitHeadSnapshot` for the whole of that argument.
/// `nil` when the caller has nothing to diff against — a first window (where `isRootCommit`
/// already says everything), or a stored state that did not load as a board.
///
/// **A supplier reads it rather than carrying it forward** from the last window it described, and
/// deliberately: the app is not the only writer, and catch-up after a period of not watching has
/// no carried value to offer.
public let previousSnapshot: BoardModel?
/// **The board-root `CLAUDE.md` as it now reads**, when this commit touches it — the one
@@ -92,8 +92,7 @@ public struct ChangeNarrationRequest: Sendable {
/// comments' own `created`, folder name on ties" (06 ▸ Rules ▸ Auto-commit, blessed 2026-07-31),
/// and `created` lives in a comment's own `index.md` because comments are window-scoped and the
/// board snapshot never carries them (01-storage-format.md § Enhanced schema). The flush resolves
/// it once (`GitAutoCommitter.commentTimestamps(for:boardRoot:)`) and the engine stays a pure
/// function of values.
/// it once, off disk, and the engine stays a pure function of values.
///
/// **Missing is normal, not a defect.** A comment whose folder left the tree in this very commit
/// (the close purge), one whose `index.md` does not parse, one written by hand with no `created`
@@ -141,7 +140,7 @@ public protocol ChangeNarrating: Sendable {
// MARK: - The wired composer
/// **The semantic composer**, and the committer's default (`GitAutoCommitter.composer`).
/// **The semantic composer**, and the seam's default.
///
/// A one-line conformance over `ChangeNarrator`, deliberately: the vocabulary is worth a file of
/// its own and nothing about it should have to know that a protocol exists. The type stays because
Kanban/Changes/ChangeNarrator.swift
+17 -9
View File
@@ -24,10 +24,10 @@ import Foundation
/// ### Purity, and where the impurity went
///
/// Nothing in here reads a file, opens a repository, or asks what time it is. Both snapshots and the
/// guide's text arrive as values on `ChangeNarrationRequest`; `GitAutoCommitter` resolves them once per
/// flush, the last-committed one through `GitHeadSnapshot`. That is what makes the whole vocabulary —
/// every subject form, every fold, every trash reading — testable with two snapshots and no
/// repository at all.
/// guide's text arrive as values on `ChangeNarrationRequest`, resolved once per window by whoever is
/// driving the narration — the previous snapshot included. That is what makes the whole vocabulary —
/// every subject form, every fold, every trash reading — testable with two snapshots and no store at
/// all.
///
/// ### The changed-path list is a filter, not a hint
///
@@ -93,6 +93,14 @@ enum ChangeNarrator {
/// says *added* without a second sentence shape for it.
static let absentValuePlaceholder = "(none)"
/// **The subject the one snapshot-less window gets** (06 ▸ Rules ▸ Abnormal repo states): a first
/// window with no previous snapshot to diff against describes the whole board as arriving, never a
/// folded diff-from-empty.
///
/// Defined here rather than borrowed from a substrate, so the narrator stays a pure function of
/// two snapshots (`strategy/01-git-excision.md` ▸ What is harvested).
static let rootSubject = "Initial board state"
// MARK: - Entry point
/// One request in, one whole message out — a subject, and a body when there is more to say.
@@ -100,7 +108,7 @@ enum ChangeNarrator {
// **The one commit with a subject of its own** (06 ▸ Rules ▸ Abnormal repo states): "it
// commits the whole tree as *Initial board state*, never a folded diff-from-empty: there is
// no last-committed snapshot to diff against."
guard !request.isRootCommit else { return GitRepository.initialCommitSubject }
guard !request.isRootCommit else { return rootSubject }
return assemble(events(for: request), request: request)
}
@@ -910,7 +918,7 @@ enum ChangeNarrator {
/// inside a thread at all.
///
/// Shared with the flush that reads each of those folders' `created`
/// (`GitAutoCommitter.commentTimestamps(for:boardRoot:)`), so the key a timestamp is *filed*
/// (`ChangeNarrationRequest.commentTimestamps`), so the key a timestamp is *filed*
/// under and the key it is *looked up* by have one definition. Everything about where a thread
/// lives is still `CommentPath.classify`'s; this only says how many of the path's components that
/// classification consumed.
@@ -1281,9 +1289,9 @@ enum ChangeNarrator {
/// Whether a path could make the *snapshot* differ at all — every path the model speaks for,
/// plus attachments, whose names it carries.
///
/// The flush asks it before it materializes HEAD's tree: a window of nothing but strays and
/// the agent guide composes path-shaped events, and reading two whole boards to describe a
/// changed `.gitignore` would be work with no reader (`GitAutoCommitter.composition`).
/// The flush asks it before it materializes the previous snapshot: a window of nothing but
/// strays and the agent guide composes path-shaped events, and reading two whole boards to
/// describe a changed `.gitignore` would be work with no reader.
static func mightAffectSnapshot(_ path: String) -> Bool {
isModelSilent(path) || path.split(separator: "/").contains(Substring(attachmentsFolder))
}