@vibe-commit/capture 0.1.0

package/dist/copy/claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims.js","sourceRoot":"","sources":["../../src/copy/claims.ts"],"names":[],"mappings":"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"}

package/dist/copy/grades.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Edge grades and the ONE function that renders a commit header.
+ *
+ * D61 §PS6 (claims audit of `why` / `report`) requires that the qualifier a grade
+ * carries is adjacent to the sentence that introduces turns. Adjacency is beyond
+ * grep, so it is enforced STRUCTURALLY instead: exactly one function renders a
+ * commit header, it takes the grade, and no other code path renders one. A
+ * table-driven test with one row per grade (and a failing blank cell) holds the
+ * line — see `test/copy-grades.test.ts`.
+ *
+ * Do not add a second header renderer. Do not inline a header string in a
+ * command body. Both defeat the mechanism.
+ *
+ * ⚠ `renderCommitIdentity` is NOT a second one — see its own note. It renders
+ * §R3's identity line and CANNOT render an evidence sentence, because it takes
+ * no grade. That is the point: the absence screens must be able to say which
+ * commit they hold no record for, without acquiring a way to claim evidence.
+ */
+/**
+ * How we came to hold an edge between a capture and a commit (D56 plan §D9).
+ *
+ * - `derived`  — a `Bash(git commit …)` tool_use appears inside the hash-chained
+ *                transcript bytes. The strongest grade we can hold.
+ * - `observed` — a `post-commit` hook recorded the commit alongside the session.
+ *                Evidence beside the chain, not inside it. ALSO covers a human
+ *                committing in a second terminal, which is why it carries a
+ *                mandatory second clause.
+ * - `declared` — agent narration. Testimony, never fact.
+ *
+ * ⛔ **THIS LINE SAID "a client-side git PROBE" UNTIL W20, AND NO PROBE HAS EVER
+ * EXISTED.** The polling design was rejected at `D154` and `D183` records that it
+ * STAYS rejected; what shipped is `CR-170`'s `post-commit` hook, which fires once
+ * per commit rather than sampling. Corrected as a mechanism word, and named here
+ * because the retired word had already been copied into the claims register.
+ *
+ * ⛔ **`GRADE_COPY.observed`'s qualifier below is NOT part of this correction and
+ * must not be "fixed" to match.** Dead-or-stale copy behind a corrected mechanism
+ * is a different defect from FALSE copy, and only the second is a copy edit: that
+ * sentence is still true of every rung the hook can produce — the commit command
+ * genuinely is not in the transcript, and the working tree genuinely may hold
+ * work from outside the session. The claims register says so in terms.
+ */
+export type EdgeGrade = "derived" | "observed" | "declared";
+/**
+ * The floor of a mixed-grade commit: the weakest grade present.
+ * Throws on an empty set — a commit with no edges has no header to render, and
+ * silently defaulting to the strongest grade is exactly the failure this guards.
+ */
+export declare function gradeFloor(grades: readonly EdgeGrade[]): EdgeGrade;
+/**
+ * Per-grade header clauses — `claims-audit-why.md` §R3's decision table.
+ *
+ * ## ⚠ `lead` IS NOW §R3's ROW 1 AND IT IS DATA, NOT A SENTENCE — `CR-086`
+ *
+ * It used to be a fixed sentence, identical at all three grades:
+ * *"Conversation turns recorded against the commit that last changed this
+ * FILE."* §R3 has no such row, and the sentence was not merely a paraphrase —
+ * **it identified a different commit from the one `why` selects.** `why` is
+ * LINE-addressed (the verbatim-approved `--help` line, D61 §PS6; §R3's row 1 is
+ * `Line 47 → a8f2c91`), and the commit that last changed a FILE is not the
+ * commit that last changed a LINE whenever the file was touched again
+ * afterwards. A scope caveat had been moved onto the sentence that names the
+ * commit, where it reads as a fact about WHICH commit, and is false.
+ *
+ * D61 §PS6's file-scope rule is satisfied where §R3 puts it: on the sentence
+ * that INTRODUCES TURNS (`WHY.turnsIntro` — *"Turns that touched X in this
+ * commit"*), which renders on the same screen as the line number. It does not
+ * belong on the sentence that IDENTIFIES the commit.
+ *
+ * `qualifier` is §R3's row 2 — the per-grade evidence sentence, which must sit
+ * adjacent to the identity line and above the turn list. A blank qualifier is
+ * legal only where a grade genuinely carries no caveat; the table-driven test
+ * asserts each one explicitly so a blank cell fails rather than passes silently.
+ */
+interface GradeCopy {
+    readonly qualifier: string;
+}
+/**
+ * The facts §R3's row 1 renders. All three are LOCAL — `git blame` answers them
+ * on this machine — so the identity line is constructible with the read lane
+ * entirely absent, which is what lets every failure branch still say WHICH
+ * commit it was talking about.
+ */
+export interface BlamedCommit {
+    /** The line the user asked about. Renders ONCE, here (§10.4). */
+    readonly line: number;
+    /** Abbreviated SHA, as `git blame` prints it. */
+    readonly sha: string;
+    /** Author date, `YYYY-MM-DD`. */
+    readonly date: string;
+}
+/**
+ * THE header renderer. One function, takes the grade, no other path renders a
+ * commit header — and it now returns §R3's TWO LINES rather than one, because
+ * the identity line and the evidence sentence are one unit: rendering either
+ * without the other is what the structural rule exists to prevent.
+ *
+ * @param grades every edge grade held for the commit. The floor governs.
+ */
+export declare function renderCommitHeader(grades: readonly EdgeGrade[], commit: BlamedCommit): string[];
+/**
+ * The identity line ALONE — for the screens that hold no edge and therefore
+ * have no grade to render beside it (cold start, no-edge, squash-resolved,
+ * and every read-lane failure).
+ *
+ * ⚠ This is NOT a second header renderer and must not become one: it takes no
+ * grade and it cannot produce an evidence sentence. The rule it protects is the
+ * inverse of the one `renderCommitHeader` protects — a screen may not claim
+ * evidence without a grade, and `gradeFloor` throws on an empty set, so without
+ * this the absence screens would have no way to say WHICH commit they are
+ * silent about. §10.6 draws the identity line on states A and E.
+ */
+export declare function renderCommitIdentity(commit: BlamedCommit): string;
+/** Exposed for the table-driven test; not for command bodies. */
+export declare function gradeCopyFor(grade: EdgeGrade): GradeCopy;
+export declare const ALL_GRADES: ReadonlyArray<EdgeGrade>;
+export {};

package/dist/copy/grades.js

@@ -0,0 +1,96 @@
+/**
+ * Edge grades and the ONE function that renders a commit header.
+ *
+ * D61 §PS6 (claims audit of `why` / `report`) requires that the qualifier a grade
+ * carries is adjacent to the sentence that introduces turns. Adjacency is beyond
+ * grep, so it is enforced STRUCTURALLY instead: exactly one function renders a
+ * commit header, it takes the grade, and no other code path renders one. A
+ * table-driven test with one row per grade (and a failing blank cell) holds the
+ * line — see `test/copy-grades.test.ts`.
+ *
+ * Do not add a second header renderer. Do not inline a header string in a
+ * command body. Both defeat the mechanism.
+ *
+ * ⚠ `renderCommitIdentity` is NOT a second one — see its own note. It renders
+ * §R3's identity line and CANNOT render an evidence sentence, because it takes
+ * no grade. That is the point: the absence screens must be able to say which
+ * commit they hold no record for, without acquiring a way to claim evidence.
+ */
+/**
+ * Confidence ordering, weakest first. Used to compute the floor on a
+ * mixed-grade commit — D61 §PS6: "On a mixed-grade commit the header takes the
+ * floor." The weakest grade present governs the whole header, because a header
+ * that reported the strongest grade would describe evidence we do not hold for
+ * every edge on that commit.
+ */
+const GRADE_RANK = ["declared", "observed", "derived"];
+/**
+ * The floor of a mixed-grade commit: the weakest grade present.
+ * Throws on an empty set — a commit with no edges has no header to render, and
+ * silently defaulting to the strongest grade is exactly the failure this guards.
+ */
+export function gradeFloor(grades) {
+    if (grades.length === 0) {
+        throw new Error("gradeFloor: no edges — a commit with no edge has no header");
+    }
+    let floor = "derived";
+    for (const g of grades) {
+        if (GRADE_RANK.indexOf(g) < GRADE_RANK.indexOf(floor))
+            floor = g;
+    }
+    return floor;
+}
+const GRADE_COPY = {
+    derived: {
+        qualifier: "The commit command is recorded in this session's transcript.",
+    },
+    observed: {
+        // ⚠ TWO SENTENCES, AND THE FIRST ONE WAS MISSING. D61 §PS6 makes the second
+        // mandatory — `observed` also covers a human committing in a second
+        // terminal — but the first is the one that says what `observed` MEANS, and
+        // §R3 approves both.
+        qualifier: "This commit appeared while the session was running. The commit command was not in the transcript, so it may include work from outside this session.",
+    },
+    declared: {
+        qualifier: "The agent reported this commit. It is not in the transcript record.",
+    },
+};
+/**
+ * §R3 row 1. The `→` and `·` are U+2192 and U+00B7 — one column, several bytes
+ * each, which is why every width check in this package counts COLUMNS.
+ */
+function identityLine(commit) {
+    return `Line ${commit.line} → ${commit.sha} · ${commit.date} (git blame)`;
+}
+/**
+ * THE header renderer. One function, takes the grade, no other path renders a
+ * commit header — and it now returns §R3's TWO LINES rather than one, because
+ * the identity line and the evidence sentence are one unit: rendering either
+ * without the other is what the structural rule exists to prevent.
+ *
+ * @param grades every edge grade held for the commit. The floor governs.
+ */
+export function renderCommitHeader(grades, commit) {
+    return [identityLine(commit), GRADE_COPY[gradeFloor(grades)].qualifier];
+}
+/**
+ * The identity line ALONE — for the screens that hold no edge and therefore
+ * have no grade to render beside it (cold start, no-edge, squash-resolved,
+ * and every read-lane failure).
+ *
+ * ⚠ This is NOT a second header renderer and must not become one: it takes no
+ * grade and it cannot produce an evidence sentence. The rule it protects is the
+ * inverse of the one `renderCommitHeader` protects — a screen may not claim
+ * evidence without a grade, and `gradeFloor` throws on an empty set, so without
+ * this the absence screens would have no way to say WHICH commit they are
+ * silent about. §10.6 draws the identity line on states A and E.
+ */
+export function renderCommitIdentity(commit) {
+    return identityLine(commit);
+}
+/** Exposed for the table-driven test; not for command bodies. */
+export function gradeCopyFor(grade) {
+    return GRADE_COPY[grade];
+}
+export const ALL_GRADES = ["derived", "observed", "declared"];
+//# sourceMappingURL=grades.js.map

package/dist/copy/grades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grades.js","sourceRoot":"","sources":["../../src/copy/grades.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH;;;;;;GAMG;AACH,MAAM,UAAU,GAA6B,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAEjF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAA4B;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,KAAK,GAAc,SAAS,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,KAAK,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AA8CD,MAAM,UAAU,GAA2C;IACzD,OAAO,EAAE;QACP,SAAS,EAAE,8DAA8D;KAC1E;IACD,QAAQ,EAAE;QACR,4EAA4E;QAC5E,oEAAoE;QACpE,2EAA2E;QAC3E,qBAAqB;QACrB,SAAS,EACP,qJAAqJ;KACxJ;IACD,QAAQ,EAAE;QACR,SAAS,EAAE,qEAAqE;KACjF;CACF,CAAC;AAEF;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAoB;IACxC,OAAO,QAAQ,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,cAAc,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA4B,EAC5B,MAAoB;IAEpB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAA6B,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC"}

package/dist/copy/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Single entry point for all user-facing copy.
+ *
+ * Command bodies import from HERE and nowhere else. If you find yourself typing
+ * a quoted user-facing string inside a command, it belongs in `strings.ts`; if
+ * it describes a commit's evidence, it belongs in `grades.ts` behind the one
+ * header renderer.
+ */
+export { HELP, USAGE, STATUS, CONNECT, SIGNIN, OFF, WHY, REPORT, ABSENCE, type AbsenceStateName, type AbsenceState, type AbsenceField, ERRORS, INTERNAL, CREDENTIAL, RUNTIME, SYSTEM_MESSAGE, REDACTION, COMMANDS, URLS, COMMIT_HOOK, PATH_CLASH, } from "./strings.js";
+export { relativeAge } from "./time.js";
+export { renderCommitHeader, renderCommitIdentity, gradeFloor, gradeCopyFor, ALL_GRADES, type BlamedCommit, type EdgeGrade, } from "./grades.js";
+export { BLOCKED_PHRASES, findClaimViolations, type Surface, type BlockedPhrase, type ClaimViolation, } from "./claims.js";

package/dist/copy/index.js

@@ -0,0 +1,13 @@
+/**
+ * Single entry point for all user-facing copy.
+ *
+ * Command bodies import from HERE and nowhere else. If you find yourself typing
+ * a quoted user-facing string inside a command, it belongs in `strings.ts`; if
+ * it describes a commit's evidence, it belongs in `grades.ts` behind the one
+ * header renderer.
+ */
+export { HELP, USAGE, STATUS, CONNECT, SIGNIN, OFF, WHY, REPORT, ABSENCE, ERRORS, INTERNAL, CREDENTIAL, RUNTIME, SYSTEM_MESSAGE, REDACTION, COMMANDS, URLS, COMMIT_HOOK, PATH_CLASH, } from "./strings.js";
+export { relativeAge } from "./time.js";
+export { renderCommitHeader, renderCommitIdentity, gradeFloor, gradeCopyFor, ALL_GRADES, } from "./grades.js";
+export { BLOCKED_PHRASES, findClaimViolations, } from "./claims.js";
+//# sourceMappingURL=index.js.map

package/dist/copy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/copy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,GAAG,EACH,GAAG,EACH,MAAM,EACN,OAAO,EAIP,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,UAAU,GAGX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,mBAAmB,GAIpB,MAAM,aAAa,CAAC"}