@vibe-commit/capture 0.1.0

package/dist/commands/report.d.ts

@@ -0,0 +1,105 @@
+/**
+ * `vibecommit report --since` — coverage and grade mix. `CR-108`, W10.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ## ⚠ THE STRONGEST CLAIM IN THE PRODUCT, ON ITS WEAKEST FOOTING
+ *
+ * §PS6 blocked this surface outright, and **D67 cleared it on stated terms**.
+ * The terms are the build, not advice — shipping the number without them does
+ * not lift the block:
+ *
+ *   1. **Definition, coverage % and grade mix render TOGETHER or NOT AT ALL.**
+ *   2. **Per grade, never blended**, and the **ref is named inline** — a bare
+ *      percentage is meaningless because the number is ref-relative.
+ *   3. **Only exact `commit_sha_successors` rows count toward the numerator**;
+ *      patch-id matches render as a **separate labelled line**, never folded in.
+ *   4. **On a shallow clone it REFUSES**, and that refusal is load-bearing.
+ *   5. **The denominator is "commits we hold an edge for", NEVER "commits the
+ *      agent made"** — that number does not exist in the schema, and inventing
+ *      it turns a coverage report into a cooperation-rate claim.
+ *
+ * ## ⚠ THE RATE IS COMPUTED HERE, AND THAT IS AN AUTHORISED DEVIATION
+ *
+ * D60 §D1a says the client may render and may not analyze. **D67 puts the
+ * reachability computation on the client ON PURPOSE**, because the server has
+ * no repository: `commit_coverage` returns the shas we hold an edge for and
+ * **deliberately no rate**, since *"a null rate invites a renderer to print
+ * something."* So this module runs `git` and divides. Cited so a later reader
+ * does not read it as a D1a violation.
+ *
+ * ## ⚠⚠ WHAT `--since` CAN AND CANNOT BOUND — READ THIS BEFORE CHANGING IT
+ *
+ * **`commit_coverage` ACCEPTS NO WINDOW.** Its input schema is `{repo |
+ * repository_id, ref}` and `ref` is the only required field; there is no
+ * `since`. So the server's `edges_held` and `captured_shas` are
+ * **repository-wide**, and the rate computed from them is repository-wide too.
+ *
+ * `--since` therefore bounds **the local half only** — the commit list this
+ * module reads out of the user's own clone, which is what selects the two empty
+ * states (both of which name the window, because both are local facts). **The
+ * rate's sentence claims no window, deliberately**, because claiming one would
+ * be the plausible-wrong-answer class (D98) on the product's most load-bearing
+ * number.
+ *
+ * That split is a real gap, it is reported rather than smoothed, and closing it
+ * needs a `since` on the server tool — a row in a repo this task may not write.
+ *
+ * @provenance vibecommit-mcp src/read/coverage.ts — the payload shape, retyped
+ */
+import { readWithSession } from "../oauth/signin.js";
+import { type CommandContext } from "./context.js";
+/**
+ * What `report` requires of `commit_coverage`.
+ *
+ * ⚠ **TWO FIELDS ON THIS PAYLOAD ARE USER-FACING PROSE MINTED IN
+ * `vibecommit-mcp`, AND NEITHER IS READ HERE.** `probable_line.label` carries
+ * *"probable (patch-id match) — reported separately, not counted in the rate"*
+ * and `reachability.reason` carries a sentence explaining the split. **D112 §3
+ * ruled on exactly this shape** for `TOOL_UNKNOWN`: a user-facing string minted
+ * in another repository bypasses every copy gate this one has —
+ * `test/copy-claims.test.ts` maps exports of `strings.ts`, and a wire string is
+ * in no export. **THE WIRE CARRIES THE FACT, THE CLIENT OWNS THE WORDS.** That
+ * ruling was measured in `src/read/blame.ts`; finding the same shape in
+ * `src/read/coverage.ts` means the class is NOT closed, and it is reported.
+ *
+ * So this type deliberately does not carry `label` or `reason`: a field that is
+ * not parsed cannot be printed by accident.
+ */
+export interface CoveragePayload {
+    /** ⚠ REQUIRED and it goes in the sentence. The number is ref-relative. */
+    readonly ref: string;
+    /** THE DENOMINATOR: distinct commit shas we hold an edge for. */
+    readonly edgesHeld: number;
+    /** Every legal grade, including any with a permanent zero. */
+    readonly byGrade: Readonly<Record<string, number>>;
+    /** The shas whose reachability this module tests against the local clone. */
+    readonly capturedShas: readonly string[];
+    /** ⚠ ONLY THESE count toward the numerator (D67). */
+    readonly exactSuccessors: number;
+    /** ⚠ NEVER folded into the rate. Rendered on its own line, in OUR words. */
+    readonly probableCount: number;
+}
+/** The whole document. `null` means malformed, and malformed renders as malformed. */
+export declare function parseCoveragePayload(document: unknown): CoveragePayload | null;
+export interface ReportArgs {
+    readonly since: string;
+    readonly ref: string | null;
+}
+/**
+ * `--since <YYYY-MM-DD> [--ref <ref>]`.
+ *
+ * There is no argument parser in this package and `why` deliberately did not
+ * add one; this matches that restraint — two flags, read positionally after
+ * their names, and anything else is a usage error.
+ *
+ * ⚠ **THE DATE SHAPE IS ENFORCED RATHER THAN PASSED THROUGH.** `git log
+ * --since` accepts almost anything and silently widens the window on input it
+ * cannot read — *"yesterdya"* is not an error, it is a different answer. That is
+ * D98's class on the field that bounds the whole report.
+ */
+export declare function parseArgs(argv: readonly string[]): ReportArgs | "usage" | "bad-date";
+export interface ReportDeps {
+    /** Injected so the suite can drive every arm without a server — there is none. */
+    readonly read?: typeof readWithSession;
+}
+export declare function report(ctx: CommandContext, argv: readonly string[], deps?: ReportDeps): Promise<number>;

package/dist/commands/report.js

@@ -0,0 +1,430 @@
+/**
+ * `vibecommit report --since` — coverage and grade mix. `CR-108`, W10.
+ *
+ * ─────────────────────────────────────────────────────────────────────────────
+ * ## ⚠ THE STRONGEST CLAIM IN THE PRODUCT, ON ITS WEAKEST FOOTING
+ *
+ * §PS6 blocked this surface outright, and **D67 cleared it on stated terms**.
+ * The terms are the build, not advice — shipping the number without them does
+ * not lift the block:
+ *
+ *   1. **Definition, coverage % and grade mix render TOGETHER or NOT AT ALL.**
+ *   2. **Per grade, never blended**, and the **ref is named inline** — a bare
+ *      percentage is meaningless because the number is ref-relative.
+ *   3. **Only exact `commit_sha_successors` rows count toward the numerator**;
+ *      patch-id matches render as a **separate labelled line**, never folded in.
+ *   4. **On a shallow clone it REFUSES**, and that refusal is load-bearing.
+ *   5. **The denominator is "commits we hold an edge for", NEVER "commits the
+ *      agent made"** — that number does not exist in the schema, and inventing
+ *      it turns a coverage report into a cooperation-rate claim.
+ *
+ * ## ⚠ THE RATE IS COMPUTED HERE, AND THAT IS AN AUTHORISED DEVIATION
+ *
+ * D60 §D1a says the client may render and may not analyze. **D67 puts the
+ * reachability computation on the client ON PURPOSE**, because the server has
+ * no repository: `commit_coverage` returns the shas we hold an edge for and
+ * **deliberately no rate**, since *"a null rate invites a renderer to print
+ * something."* So this module runs `git` and divides. Cited so a later reader
+ * does not read it as a D1a violation.
+ *
+ * ## ⚠⚠ WHAT `--since` CAN AND CANNOT BOUND — READ THIS BEFORE CHANGING IT
+ *
+ * **`commit_coverage` ACCEPTS NO WINDOW.** Its input schema is `{repo |
+ * repository_id, ref}` and `ref` is the only required field; there is no
+ * `since`. So the server's `edges_held` and `captured_shas` are
+ * **repository-wide**, and the rate computed from them is repository-wide too.
+ *
+ * `--since` therefore bounds **the local half only** — the commit list this
+ * module reads out of the user's own clone, which is what selects the two empty
+ * states (both of which name the window, because both are local facts). **The
+ * rate's sentence claims no window, deliberately**, because claiming one would
+ * be the plausible-wrong-answer class (D98) on the product's most load-bearing
+ * number.
+ *
+ * That split is a real gap, it is reported rather than smoothed, and closing it
+ * needs a `since` on the server tool — a row in a repo this task may not write.
+ *
+ * @provenance vibecommit-mcp src/read/coverage.ts — the payload shape, retyped
+ */
+import { ABSENCE, COMMANDS, ERRORS, REPORT, SIGNIN, WHY, } from "../copy/index.js";
+import { EXIT } from "../exit.js";
+import { currentBranch, gitProbe, isReachable, isShallowClone, resolveRepoSlug } from "../git.js";
+import { emitJson } from "../json.js";
+import { mcpUrl } from "../oauth/discovery.js";
+import { readWithSession } from "../oauth/signin.js";
+import { resolveProjectKey } from "../project.js";
+import { renderErrorBlock, wrap } from "../term.js";
+import { writeLines } from "./context.js";
+/** §10.3 indents the body two columns, the same as `why`'s screens. */
+const BODY_INDENT = 2;
+/** One read, one POST. Generous because it contains a server-side join. */
+const READ_TIMEOUT_MS = 15_000;
+/** `--since` is a calendar date and nothing else — see `parseArgs`. */
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function asCount(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : null;
+}
+/** The whole document. `null` means malformed, and malformed renders as malformed. */
+export function parseCoveragePayload(document) {
+    if (!isRecord(document))
+        return null;
+    const ref = document.ref;
+    if (typeof ref !== "string" || ref.trim() === "")
+        return null;
+    const edgesHeld = asCount(document.edges_held);
+    const exactSuccessors = asCount(document.exact_successors);
+    if (edgesHeld === null || exactSuccessors === null)
+        return null;
+    if (!Array.isArray(document.captured_shas))
+        return null;
+    const capturedShas = document.captured_shas;
+    if (!capturedShas.every((s) => typeof s === "string" && s.trim() !== ""))
+        return null;
+    // ⚠ EVERY GRADE IS A NON-NEGATIVE INTEGER, and an unrecognised grade name is
+    // MALFORMED rather than skipped. A fourth grade appearing on the wire means
+    // the two repos disagree about an enum that lives in three of them with
+    // nothing verifying they agree — dropping it silently would render a mix that
+    // does not add up and looks fine.
+    if (!isRecord(document.by_grade))
+        return null;
+    const byGrade = {};
+    for (const [name, raw] of Object.entries(document.by_grade)) {
+        const count = asCount(raw);
+        if (count === null || !GRADE_ORDER.includes(name))
+            return null;
+        byGrade[name] = count;
+    }
+    // ⚠ `probable_line` is read for its COUNT ONLY. `label` is deliberately not
+    // parsed — see the docblock above.
+    if (!isRecord(document.probable_line))
+        return null;
+    const probableCount = asCount(document.probable_line.count);
+    if (probableCount === null)
+        return null;
+    return { ref, edgesHeld, byGrade, capturedShas, exactSuccessors, probableCount };
+}
+/**
+ * The order the grade mix renders in, and the ONLY place a grade name appears.
+ *
+ * ⚠ Strongest first, which is also `ALL_GRADES`' order. The NAMES are used to
+ * look up copy and are never printed — DESIGN.md §13.3 puts grade words in
+ * `--json` only, D65 §DR4 keeps them off the screen, and `test/why.test.ts`
+ * already enforces that for the other read verb.
+ */
+const GRADE_ORDER = ["derived", "observed", "declared"];
+const GRADE_LABEL = {
+    derived: REPORT.gradeDerivedLabel,
+    observed: REPORT.gradeObservedLabel,
+    declared: REPORT.gradeDeclaredLabel,
+};
+/**
+ * `--since <YYYY-MM-DD> [--ref <ref>]`.
+ *
+ * There is no argument parser in this package and `why` deliberately did not
+ * add one; this matches that restraint — two flags, read positionally after
+ * their names, and anything else is a usage error.
+ *
+ * ⚠ **THE DATE SHAPE IS ENFORCED RATHER THAN PASSED THROUGH.** `git log
+ * --since` accepts almost anything and silently widens the window on input it
+ * cannot read — *"yesterdya"* is not an error, it is a different answer. That is
+ * D98's class on the field that bounds the whole report.
+ */
+export function parseArgs(argv) {
+    let since = null;
+    let ref = null;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--since") {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith("-"))
+                return "usage";
+            since = value;
+            i += 1;
+        }
+        else if (arg === "--ref") {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith("-"))
+                return "usage";
+            ref = value;
+            i += 1;
+        }
+        else if (!arg.startsWith("-")) {
+            // A bare positional is not part of this verb's grammar, and accepting one
+            // would let `report 2026-07-08` look like it worked.
+            return "usage";
+        }
+    }
+    if (since === null)
+        return "usage";
+    return ISO_DATE.test(since) ? { since, ref } : "bad-date";
+}
+// ---------------------------------------------------------------------------
+// Rendering.
+// ---------------------------------------------------------------------------
+function errorCopy(what, why, fixLabel, fix) {
+    return { what, why: [why], fixLabel, fixes: [fix] };
+}
+function fail(ctx, copy, code) {
+    writeLines(ctx.stderr, renderErrorBlock({ kind: "bad", ...copy }, ctx.colour));
+    return code;
+}
+/**
+ * An ABSENCE state — `CR-112`'s grammar, exit code riding with the copy.
+ *
+ * Rendered to STDOUT: absence is an ANSWER. ⚠ And the `fix` sentence renders
+ * even with no command beside it — `renderErrorBlock` drops `fixLabel` when
+ * `fixes` is empty, which is how state 5's remedy silently vanished for a whole
+ * wave (`CR-109d`). Both `report` states DO have a command, so they take the
+ * ordinary path; the shape is written this way so they cannot lose it later.
+ */
+function absence(ctx, what, why, fixLabel, fixes) {
+    const block = fixes.length > 0
+        ? { kind: "warn", what, why: [why], fixLabel, fixes }
+        : { kind: "warn", what, why: [why] };
+    const lines = [...renderErrorBlock(block, ctx.colour)];
+    if (fixes.length === 0)
+        lines.push("", ...wrap(fixLabel, 4));
+    writeLines(ctx.stdout, lines);
+    return EXIT.empty;
+}
+/** `notAuthorized`'s six outcomes, the same six `why` renders. */
+function notAuthorized(ctx, authorized) {
+    switch (authorized.kind) {
+        case "no-session":
+            return fail(ctx, errorCopy(WHY.signedOutWhat, WHY.signedOutWhy, WHY.signedOutFix, COMMANDS.signIn), EXIT.notConnected);
+        case "expired":
+            return fail(ctx, errorCopy(SIGNIN.expiredWhat, SIGNIN.expiredWhy, SIGNIN.expiredFix, COMMANDS.signIn), EXIT.notConnected);
+        case "busy":
+            return fail(ctx, errorCopy(SIGNIN.busyWhat, SIGNIN.busyWhy, SIGNIN.busyFix, COMMANDS.report), EXIT.failure);
+        case "unreachable":
+            return fail(ctx, errorCopy(WHY.unreachableWhat, WHY.unreachableWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+        case "malformed":
+        case "ok":
+            // `ok` is unreachable by construction — `readWithSession` only wraps a
+            // NON-ok outcome. Rendered rather than thrown: a crash here would be a
+            // worse answer than an honest failure.
+            return fail(ctx, errorCopy(WHY.malformedWhat, WHY.malformedWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+    }
+}
+/**
+ * D67's three-part unit. **Together or not at all.**
+ *
+ * ⚠ The grade mix omits a grade whose count is ZERO, and the total still
+ * reconciles against `edgesHeld`. A `0` beside a grade is a measurement claim,
+ * not an absence — and `observed` has no producer in any repo (D104 §2a), so
+ * rendering `observed: 0` would illustrate a screen the data can never fill.
+ */
+function coverageScreen(payload, reachable, percent) {
+    const lines = [
+        ...wrap(REPORT.definition(payload.ref), BODY_INDENT),
+        "",
+        ...wrap(REPORT.rate(String(reachable), String(payload.edgesHeld), payload.ref, String(percent)), BODY_INDENT),
+    ];
+    const parts = GRADE_ORDER.filter((g) => (payload.byGrade[g] ?? 0) > 0).map((g) => REPORT.gradeCount(String(payload.byGrade[g]), GRADE_LABEL[g]));
+    if (parts.length > 0) {
+        lines.push(...wrap(`${REPORT.gradeMixIntro} ${parts.join(", ")}.`, BODY_INDENT));
+    }
+    // ⚠ ITS OWN LINE, IN OUR WORDS, NEVER ADDED TO THE RATE ABOVE (D67).
+    if (payload.probableCount > 0) {
+        const text = payload.probableCount === 1 ? REPORT.probableOne : REPORT.probable(String(payload.probableCount));
+        lines.push("", ...wrap(text, BODY_INDENT));
+    }
+    return lines;
+}
+export async function report(ctx, argv, deps = {}) {
+    // §13.3 — `--json` emits nothing but the JSON document on stdout, and D122 §2
+    // rules that §13.3 REQUIRES it here. Every FAILURE below is unchanged (§13.6
+    // to stderr, nothing on stdout); the three ANSWER states branch.
+    const json = argv.includes("--json");
+    const args = parseArgs(argv);
+    if (args === "usage") {
+        return fail(ctx, errorCopy(REPORT.usageWhat, REPORT.usageWhy, REPORT.usageFix, COMMANDS.report), EXIT.usage);
+    }
+    if (args === "bad-date") {
+        return fail(ctx, errorCopy(REPORT.sinceWhat, REPORT.sinceWhy, REPORT.sinceFix, COMMANDS.report), EXIT.usage);
+    }
+    const projectKey = resolveProjectKey(ctx.cwd);
+    if (projectKey === null) {
+        writeLines(ctx.stderr, renderErrorBlock({ kind: "bad", what: ERRORS.notAGitRepo, why: [] }, ctx.colour));
+        return EXIT.failure;
+    }
+    // ⚠⚠ THE SHALLOW REFUSAL FIRES FIRST, BEFORE THE REF, BEFORE THE LOCAL LOG
+    // AND BEFORE ANY NETWORK CALL. D67 makes it load-bearing rather than
+    // defensive, and `strings.ts` addresses a contract to this verb BY NAME: *"the
+    // caller MUST establish that the clone is complete before selecting either
+    // `report` empty state"* — because on a shallow clone *"no commits in this
+    // window"* is a claim the clone cannot support. State 3's sentence is written
+    // unqualified precisely because this refusal guarantees it.
+    if (isShallowClone(projectKey)) {
+        return fail(ctx, errorCopy(REPORT.shallowWhat, REPORT.shallowWhy, WHY.shallowFix, WHY.shallowFixCommand), EXIT.failure);
+    }
+    const ref = args.ref ?? currentBranch(projectKey);
+    if (ref === null) {
+        return fail(ctx, errorCopy(REPORT.refWhat, REPORT.refWhy, REPORT.refFix, COMMANDS.reportRef), EXIT.usage);
+    }
+    // ⚠ THE WINDOW IS A LOCAL FACT, and so are both empty states. `git log`
+    // answers "what commits are on this ref in this window" without a server,
+    // which is what lets state 3 render before anything is read.
+    const log = gitProbe(projectKey, ["log", "--format=%H", `--since=${args.since}`, ref, "--"]);
+    if (log === null) {
+        return fail(ctx, errorCopy(REPORT.refWhat, REPORT.refWhy, REPORT.refFix, COMMANDS.reportRef), EXIT.usage);
+    }
+    const windowShas = log.split("\n").filter((line) => line.trim() !== "");
+    const window = REPORT.window(args.since);
+    if (windowShas.length === 0) {
+        // STATE 3 — no commits at all. Different fact from state 4, and collapsing
+        // them would read as a coverage claim we cannot make.
+        //
+        // ⛔ THE SERVER WAS NEVER ASKED ON THIS PATH, so every counted field is
+        // `null` — NOT KNOWN — and not `0`. A zero here would be a measurement claim
+        // about a measurement that was never taken (`CR-129a`), and it is exactly
+        // what makes this state distinguishable from state 4 below, where the server
+        // DID answer and DID say zero. That distinction is the whole of "not known"
+        // vs "none" on this verb.
+        if (json) {
+            emitJson(ctx.stdout, "report", "no_commits", {
+                since: args.since,
+                ref,
+                window_commits: 0,
+                edges_held: null,
+                by_grade: null,
+                reachable: null,
+                exact_successors: null,
+                counted: null,
+                percent: null,
+                probable_count: null,
+            });
+            return EXIT.empty;
+        }
+        return absence(ctx, ABSENCE.reportNoCommits.what(ref, window), ABSENCE.reportNoCommits.why(ref), ABSENCE.reportNoCommits.fix, [COMMANDS.report]);
+    }
+    const endpoint = mcpUrl(ctx.env);
+    if (endpoint === null) {
+        return fail(ctx, errorCopy(SIGNIN.noServerWhat, SIGNIN.noServerRefusedWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+    }
+    const read = deps.read ?? readWithSession;
+    const outcome = await read(endpoint, "commit_coverage", 
+    // ⚠ `repo` (the slug) — NOT `repository_id`. `CR-142` gave the tool a slug
+    // form because this client holds a slug and nothing else, and the two are
+    // EXACTLY-ONE: supplying both is refused rather than resolved by precedence.
+    { repo: resolveRepoSlug(projectKey), ref }, {
+        home: ctx.home,
+        fetch,
+        nowMs: () => ctx.now().getTime(),
+        read: { fetch, timeoutMs: READ_TIMEOUT_MS },
+    });
+    return render(ctx, outcome, projectKey, ref, window, windowShas.length, {
+        json,
+        since: args.since,
+    });
+}
+/** Every arm of `Read`, and every arm of `Authorized` inside one of them. */
+function render(ctx, outcome, projectKey, ref, window, windowCommits, opts) {
+    switch (outcome.kind) {
+        case "not-authorized":
+            return notAuthorized(ctx, outcome.authorized);
+        case "unauthorized":
+            return fail(ctx, errorCopy(WHY.signedOutWhat, WHY.signedOutWhy, WHY.signedOutFix, COMMANDS.signIn), EXIT.notConnected);
+        case "unreachable":
+            return fail(ctx, errorCopy(WHY.unreachableWhat, WHY.unreachableWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+        case "rpc-error":
+            // ⚠ Never a bare HTTP status or a raw JSON-RPC code on screen (§13.6).
+            return fail(ctx, errorCopy(WHY.serverErrorWhat, WHY.serverErrorWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+        case "malformed":
+            return fail(ctx, errorCopy(WHY.malformedWhat, WHY.malformedWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+        case "ok": {
+            // ⚠ `isError` rides the SAME envelope as a success. A caller that only
+            // branched on the transport would read a tool failure as a record.
+            if (outcome.isError) {
+                return fail(ctx, errorCopy(WHY.serverErrorWhat, WHY.serverErrorWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+            }
+            const payload = parseCoveragePayload(outcome.document);
+            if (payload === null) {
+                return fail(ctx, errorCopy(WHY.malformedWhat, WHY.malformedWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+            }
+            return renderPayload(ctx, payload, projectKey, ref, window, windowCommits, opts);
+        }
+    }
+}
+function renderPayload(ctx, payload, projectKey, ref, window, windowCommits, opts) {
+    // STATE 4 — commits exist and we hold no session for any of them. The counted
+    // commits are the whole difference from state 3.
+    if (payload.edgesHeld === 0) {
+        // ⚠ `edges_held` IS `0` HERE AND `null` IN STATE 3, and the difference is
+        // the point: the server answered and said none, where state 3 never asked.
+        // `percent` stays `null` because the denominator is zero — 0/0 is not 0%,
+        // and printing `0` would be a coverage claim from no data.
+        //
+        // ⛔ `by_grade` IS ECHOED, NEVER WIDENED TO THE ENUM. `observed` has no
+        // producer in any repo (D104 §2a), so a key the payload did not carry stays
+        // absent rather than becoming a zero we never counted.
+        if (opts.json) {
+            emitJson(ctx.stdout, "report", "no_sessions", {
+                since: opts.since,
+                ref: payload.ref,
+                window_commits: windowCommits,
+                edges_held: 0,
+                by_grade: payload.byGrade,
+                reachable: null,
+                exact_successors: payload.exactSuccessors,
+                counted: null,
+                percent: null,
+                probable_count: payload.probableCount,
+            });
+            return EXIT.empty;
+        }
+        return absence(ctx, ABSENCE.reportNoSessions.what(String(windowCommits), window), ABSENCE.reportNoSessions.why, ABSENCE.reportNoSessions.fix, [COMMANDS.report]);
+    }
+    // ⚠ THE CLIENT HALF OF D67's SPLIT. Reachability is a question about the
+    // user's clone and the server has no repository, so it is asked here.
+    let reachable = 0;
+    for (const sha of payload.capturedShas) {
+        const answer = isReachable(projectKey, sha, ref);
+        // ⚠ FAILS CLOSED. An unanswerable probe is not a "no": counting it as
+        // unreachable would DEFLATE the rate and present a smaller number as a
+        // complete one, which is D98's class on the number that matters most.
+        if (answer === null) {
+            return fail(ctx, errorCopy(REPORT.unknownReachabilityWhat, REPORT.unknownReachabilityWhy, REPORT.unknownReachabilityFix, WHY.shallowFixCommand), EXIT.failure);
+        }
+        if (answer)
+            reachable += 1;
+    }
+    // ⚠ ONLY EXACT SUCCESSORS JOIN THE NUMERATOR (D67). A commit that was
+    // rewritten is still reachable through the successor we hold a recorded row
+    // for; a patch-id guess is NOT, and it renders on its own line instead.
+    const numerator = reachable + payload.exactSuccessors;
+    if (numerator > payload.edgesHeld) {
+        // The payload disagrees with the clone about its own totals. A rate over
+        // 100% is not a number to print, and clamping it would hide the disagreement
+        // behind a plausible figure.
+        return fail(ctx, errorCopy(WHY.malformedWhat, WHY.malformedWhy, WHY.readFix, COMMANDS.report), EXIT.failure);
+    }
+    const percent = Math.round((numerator / payload.edgesHeld) * 100);
+    // §13.3 — the machine surface, and THE ONE PLACE THE GRADE MIX IS READABLE AS
+    // GRADES. `coverageScreen` renders D67's three-part unit through the copy
+    // labels and prints no grade word at all; here the wire's own map is echoed.
+    //
+    // ⚠ `reachable` and `exact_successors` are reported SEPARATELY as well as in
+    // `counted`, because D67 forbids folding a patch-id guess into the rate and a
+    // consumer that only saw the total could not tell the halves apart.
+    // `probable_count` rides alongside for the same reason and is never added in.
+    if (opts.json) {
+        emitJson(ctx.stdout, "report", "coverage", {
+            since: opts.since,
+            ref: payload.ref,
+            window_commits: windowCommits,
+            edges_held: payload.edgesHeld,
+            by_grade: payload.byGrade,
+            reachable,
+            exact_successors: payload.exactSuccessors,
+            counted: numerator,
+            percent,
+            probable_count: payload.probableCount,
+        });
+        return EXIT.ok;
+    }
+    writeLines(ctx.stdout, coverageScreen(payload, numerator, percent));
+    return EXIT.ok;
+}
+//# sourceMappingURL=report.js.map

package/dist/commands/report.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `vibecommit status` and `vibecommit off` — the screen, `CR-021`.
+ *
+ * Style guide §10.3 draws it and D65 makes that drawing the ruling, so this
+ * module renders it rather than designing it: four questions in fixed order
+ * (on for *this* repo? last successful send? where do I look? what do I type to
+ * fix it?), then the revoke link, on §13.5's `LABEL_GUTTER`.
+ *
+ * ## What is deliberately NOT on the screen
+ *
+ * §10.3's `last sent` row reads `4 minutes ago · 3 turns · seq 41`. **The turn
+ * count is not rendered and must not be.** Counting turns means parsing the
+ * transcript's NDJSON and deciding what a turn is, and that is the analysis the
+ * client is barred from holding — D60 §D6: *the client may render; it may not
+ * analyze, hash, or canonicalize*. The one recorded deviation is `CR-024d`'s
+ * redaction parse, authorised by name; there is no such authorisation here, and
+ * the server is the only thing holding sealed turns to count. The age and the
+ * `seq` are both facts this client already wrote down, so both render.
+ *
+ * ## Absence is not a blank
+ *
+ * When nothing has been delivered for this repo the row is OMITTED and
+ * `STATUS.neverSent` says so in a sentence. No sixth absence phrasing is
+ * invented here: `CR-112` (W8) owns the five-absence grammar as one set, and
+ * adding a variant now is what that task exists to prevent.
+ */
+import { type CommandContext } from "./context.js";
+export declare function status(ctx: CommandContext, argv?: readonly string[]): number;
+export declare function off(ctx: CommandContext): number;