@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/findingsrecord.d.ts

@@ -0,0 +1,175 @@
+import { DOUBT_WORDS } from "./doubtwords.js";
+import { normalizeDisposition, type FindingDisposition } from "./findingkey.js";
+/** The validator's validity vetoes (packages/pi-plugin/src/doubtwords.ts). */
+export { DOUBT_WORDS };
+/** The disposition vocabulary lives in the leaf `findingkey.ts`, so the
+ * renderer and the post-check read "posted" exactly as this parser does. */
+export { normalizeDisposition, type FindingDisposition };
+/** The axis a downgrade moved. `pass-validate`'s addendum requires a downgrade
+ * to name one; the record carries it so the move is auditable. */
+export type FindingAxis = "severity" | "confidence" | "reachability" | null;
+/**
+ * The closed kill/downgrade vocabulary (`agents/pass-validate.md` plus the
+ * `kill-vocabulary` addendum in `packages/pi-plugin/src/include.ts`). Recorded here for QUERIES
+ * and for a parse note — never as a validator: the vocabulary grows with the
+ * addenda, so an unknown word is noted, kept verbatim, and never a reason to
+ * refuse the record.
+ */
+export declare const KILL_WORDS: readonly string[];
+export declare const DOWNGRADE_WORDS: readonly string[];
+/** `settled:<thread-id>` is a kill word with a payload, so it is matched by
+ * prefix rather than listed. */
+export declare function isKnownVocabularyWord(word: string): boolean;
+/** One candidate finding and why it ended where it did. */
+export interface FindingsRecordEntry {
+    /** The session's own handle for the candidate (`f1`, …). Falls back to
+     * `<lens>@<path>:<line>#<index>` (`findingRecordKey`) so every entry has a
+     * stable per-round identity. */
+    key: string;
+    path: string | null;
+    line: number | null;
+    /** WHICH LENS RAISED IT. The one field with no tolerable default. */
+    lens: string;
+    tier: string | null;
+    severity: string | null;
+    confidence: number | null;
+    reachability: string | null;
+    kind: string | null;
+    disposition: FindingDisposition;
+    axis: FindingAxis;
+    /** The closed-vocabulary kill or downgrade word, verbatim. */
+    word: string | null;
+    /** The reason in the reviewer's OWN WORDS — the thing a bare `below-bar`
+     * never carried and the thing adjudication reads. */
+    reason: string | null;
+    /** The evidence chain behind the raise. */
+    evidence: string | null;
+    /** How it posted, when it posted: blocker / question / nit / check this. */
+    posted_as: string | null;
+    /** The round that first raised it, when this entry is about an older
+     * finding (a concession, an escalation). Null = raised this round. */
+    raised_in_round: number | null;
+    thread_id: number | null;
+    /** The posted comment's one-line title, as the session wrote it. Null when
+     * the entry has none — never derived from the reason. */
+    title: string | null;
+}
+export interface FindingsRecordFile {
+    pr: number;
+    round_no: number;
+    head_sha: string | null;
+    /** The per-round comment count — how many inline comments this round
+     * actually posted. `bot_comments.round_no` is the registry's own answer;
+     * this is the session's, and the two disagreeing is itself a signal. */
+    comments_posted: number | null;
+    findings: FindingsRecordEntry[];
+    /** The statuses this round reported for PRIOR findings (the
+     * daemon-rendered list's refs). Empty when the record carries none. */
+    prior: PriorStatusEntry[];
+}
+/** The status a follow-up round reports for one prior finding.
+ * Closed set; `unverifiable` is honest-unknown and counts as unresolved. */
+export declare const PRIOR_STATUSES: readonly ["fixed", "open", "conceded", "settled", "obsolete", "unverifiable"];
+export type PriorStatus = (typeof PRIOR_STATUSES)[number];
+/** The statuses that take a prior finding off the next round's list. */
+export declare const PRIOR_RESOLVED_STATUSES: readonly PriorStatus[];
+/** One entry of the record's top-level `prior` array, parsed. */
+export interface PriorStatusEntry {
+    /** The daemon-issued ref, `<round_no>:<finding_key>`, as given. */
+    ref: string;
+    round_no: number;
+    finding_key: string;
+    status: PriorStatus;
+    evidence: string | null;
+}
+/** Fold a session-written prior status onto the closed set; `fixed@<sha>`
+ * is `fixed` (the sha is returned so it can ride the evidence). Null = not
+ * a status this parser knows. */
+export declare function normalizePriorStatus(raw: unknown): {
+    status: PriorStatus;
+    sha: string | null;
+} | null;
+/** Split a ref `<round_no>:<finding_key>` on its FIRST colon (a key may hold
+ * colons — `recheck:<sha12>:<id>`). Null when it is not one. */
+export declare function parsePriorRef(raw: unknown): {
+    round_no: number;
+    finding_key: string;
+} | null;
+export type FindingsRecordStatus = "ok" | "missing" | "unparseable" | "wrong_round" | "no_findings_array";
+/**
+ * What the round's POSTED output looked like against the output rules — a tag
+ * inside the closed grammar, a nit that names a request, a doubted finding
+ * never posted — plus a count of findings restated from earlier rounds.
+ *
+ * This is measurement over the record already collected — there is no
+ * second table and no new mandate beyond one field (`request`) on nit entries.
+ * Each list holds the offending entries' keys, so a query can go straight back
+ * to the row.
+ *
+ * It is deliberately NOT a gate. The round is over by the time this runs, the
+ * verdict is applied, and a record is never allowed to hold a PR open. The
+ * enforcement lives where a finding is still preventable — the lens addendum
+ * and the validator — and this is how we find out whether it worked.
+ */
+export interface RecordConformance {
+    /** Posted with a `posted_as` outside the closed grammar (`[start here 3/5]`,
+     * `[verified]`, "blocker, now fixed"). Such a finding escapes every consumer
+     * keyed on the real tag — `resolveOwnReviewThread`'s refusals included. */
+    ungrammatical_tags: string[];
+    /** Posted as a nit while naming no request. A nit that asks for nothing is a
+     * remark, not a finding. */
+    nits_without_request: string[];
+    /** Doubted AND carrying a `posted_as` — a finding the validator could not
+     * stand behind that the session says it posted anyway (a doubt is never
+     * posted on the PR). */
+    doubted_posted: string[];
+    /**
+     * Posted this round while first raised in an earlier one. NOT automatically
+     * a defect: a severity escalation across rounds is legitimate (blocking
+     * late beats never). It is also where restated bookkeeping comes from, so
+     * it is counted rather than judged, and never killed on this signal alone.
+     */
+    restated: string[];
+}
+export declare function isConformant(c: RecordConformance): boolean;
+export interface ParsedFindingsRecord {
+    status: FindingsRecordStatus;
+    record?: FindingsRecordFile;
+    /** Shortfalls that did NOT reject the record (entries missing a lens, an
+     * unknown vocabulary word, …). A note, never a rejection. */
+    note?: string;
+    /** The output-rule audit over the posted entries. Present whenever `record`
+     * is. */
+    conformance?: RecordConformance;
+}
+/**
+ * Parse and normalize one record file's already-JSON-decoded content.
+ *
+ * Tolerant like the verdict parser: digit-string numbers coerce,
+ * `candidates` is accepted for `findings`, `name` for `lens`, and an entry the
+ * parser cannot fully understand is kept with nulls plus a note rather than
+ * dropped. The ONLY rejections are structural — not an object, the wrong
+ * round, or no findings array at all — because those are the shapes where
+ * there is nothing to record.
+ */
+export declare function parseFindingsRecord(raw: unknown, pr: number, roundNo: number): ParsedFindingsRecord;
+/** Read + parse the record file. A missing/unreadable file is `missing`, an
+ * undecodable one `unparseable` — enforcement is identical either way; the
+ * distinction is for the record. */
+export declare function readFindingsRecord(path: string, pr: number, roundNo: number): ParsedFindingsRecord;
+/** `<root>/state/findings/pr-<n>-round-<k>.json` — the pinned path, same
+ * discipline as the verdict file and the round's other scratch paths. */
+export declare function findingsRecordFile(pr: number, roundNo: number): string;
+export declare function findingsRecordPath(findingsDir: string, pr: number, roundNo: number): string;
+/**
+ * The re-nudge wake. Bookkeeping-only and explicitly so: it arrives OUTSIDE a
+ * round, after the verdict has already landed, and the session must not
+ * mistake it for review work — no passes, no posting, no verdict file.
+ *
+ * It names the pinned scratch paths on purpose: the conversation has been
+ * compacted by the time this arrives, but the pass outputs and the review body
+ * are still on disk, so the record can be reconstructed from artifacts rather
+ * than from memory.
+ */
+export declare function findingsRecordWake(pr: number, roundNo: number, relPath: string): string;
+//# sourceMappingURL=findingsrecord.d.ts.map

package/dist/src/findingsrecord.d.ts.map

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

package/dist/src/findingsrecord.js

@@ -0,0 +1,410 @@
+// The durable reasoning record.
+//
+// WHAT THIS IS. `rounds.lenses` records the PLAN and `rounds.executed_passes`
+// records COUNTS — neither says which candidate findings were killed, nor why.
+// Adjudication, the "how often the review backs down" metric and per-round
+// volume all need that reasoning, so the session writes a schema'd file and
+// the daemon parses it into queryable rows.
+//
+// THE SHAPE IS THE LEDGER PATTERN, DELIBERATELY. A prompt mandate alone does
+// not stick. So the daemon parses the file after the round and, on
+// missing/unparseable, emits a queryable anomaly plus EXACTLY ONE re-nudge
+// through `wakeOrHold` telling the session to write only that record. The
+// once-mark is persisted BEFORE the inject, so even a crashed inject can never
+// become a nudge loop.
+//
+// A ROUND IS NEVER HELD OPEN FOR IT. This is a record, not a gate: the verdict
+// has already been applied, the round row is already finished and the PR has
+// already transitioned by the time any of this runs. A record that never
+// arrives costs one anomaly row and one nudge, and nothing else — least of all
+// a wedged PR (rule 9).
+//
+// This module is the record: its vocabulary, its parser and its pinned path,
+// which the review core reads. The daemon's enforcement — the anomaly, the
+// one nudge, storing the rows — is src/findingscheck.ts.
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { carriedToRef } from "./finding-chain.js";
+import { DOUBT_WORDS } from "./doubtwords.js";
+import { entryDisposition, findingRecordKey, normalizeDisposition, recordEntries, recordNumber, recordString, } from "./findingkey.js";
+import { WITHHOLD_WORDS } from "./postingpolicy.js";
+import { bareTag, isSanctionedTag } from "./severity.js";
+/** The validator's validity vetoes (packages/pi-plugin/src/doubtwords.ts). */
+export { DOUBT_WORDS };
+/** The disposition vocabulary lives in the leaf `findingkey.ts`, so the
+ * renderer and the post-check read "posted" exactly as this parser does. */
+export { normalizeDisposition };
+function normalizeAxis(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const v = raw.trim().toLowerCase();
+    return v === "severity" || v === "confidence" || v === "reachability" ? v : null;
+}
+/**
+ * The closed kill/downgrade vocabulary (`agents/pass-validate.md` plus the
+ * `kill-vocabulary` addendum in `packages/pi-plugin/src/include.ts`). Recorded here for QUERIES
+ * and for a parse note — never as a validator: the vocabulary grows with the
+ * addenda, so an unknown word is noted, kept verbatim, and never a reason to
+ * refuse the record.
+ */
+export const KILL_WORDS = [
+    // The validity vetoes are kill words too (folded onto `doubted` at parse).
+    ...DOUBT_WORDS,
+    "duplicate",
+    "out-of-scope",
+    "nit-out-of-delta",
+    "below-bar",
+    // Two of the three unreasoned shapes are kills.
+    "nit-no-request",
+    "self-narration",
+    // Style from any lens but pass-style (the repo's own guide).
+    "style-not-in-guide",
+];
+export const DOWNGRADE_WORDS = [
+    "security-demoted",
+    "intent-over-cap",
+    "design-over-cap",
+    "style-over-cap",
+    // A profile's `[lenses.<pass>] max_severity` ceiling
+    // (packages/pi-plugin/src/lenstuning.ts PROFILE_CAP_WORD).
+    "profile-over-cap",
+    "inflated",
+    "understated",
+    "overreachable",
+    "understated-reach",
+    "feedback-shape",
+    // A curated dont-raise lesson's demotion (packages/pi-plugin/src/include.ts
+    // LESSON_VALIDATE_ADDENDUM), composed only while lessons are delivered.
+    "lesson-shape",
+    // The third unreasoned shape is a correction, not a kill: the tag is put back
+    // inside the closed grammar and the finding survives.
+    "tag-outside-grammar",
+    // An ask-your-human candidate at P0–P2 that names no concrete failure,
+    // capped to P3 (the ask-human addendum in packages/pi-plugin/src/include.ts).
+    "ask-human-unnamed-defect",
+    // The mechanism is real, the claimed consequence was wrong — posted with
+    // the true consequence instead of killed.
+    "restated",
+    // (validate-external-semantics) A claim resting on an external
+    // tool's or library's behaviour that no read could settle — kept as a
+    // question naming the assumption, never doubted away.
+    "external-assumption",
+];
+/** `settled:<thread-id>` is a kill word with a payload, so it is matched by
+ * prefix rather than listed. */
+export function isKnownVocabularyWord(word) {
+    const w = word.trim().toLowerCase();
+    if (w.startsWith("settled:"))
+        return true;
+    return (KILL_WORDS.includes(w) ||
+        DOWNGRADE_WORDS.includes(w) ||
+        WITHHOLD_WORDS.includes(w));
+}
+/** Cap on a recorded title — a title is one line, never a body. */
+const TITLE_CAP = 300;
+/** The status a follow-up round reports for one prior finding.
+ * Closed set; `unverifiable` is honest-unknown and counts as unresolved. */
+export const PRIOR_STATUSES = [
+    "fixed",
+    "open",
+    "conceded",
+    "settled",
+    "obsolete",
+    "unverifiable",
+];
+/** The statuses that take a prior finding off the next round's list. */
+export const PRIOR_RESOLVED_STATUSES = [
+    "fixed",
+    "conceded",
+    "settled",
+    "obsolete",
+];
+const PRIOR_STATUS_ALIASES = {
+    "still-open": "open",
+    still_open: "open",
+    unresolved: "open",
+    "refuted-and-conceded": "conceded",
+    removed: "obsolete",
+    gone: "obsolete",
+    unknown: "unverifiable",
+};
+/** Fold a session-written prior status onto the closed set; `fixed@<sha>`
+ * is `fixed` (the sha is returned so it can ride the evidence). Null = not
+ * a status this parser knows. */
+export function normalizePriorStatus(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const v = raw.trim().toLowerCase().replace(/\s+/g, "-");
+    const at = /^fixed@([0-9a-f]{4,40})$/.exec(v);
+    if (at)
+        return { status: "fixed", sha: at[1] };
+    if (PRIOR_STATUSES.includes(v))
+        return { status: v, sha: null };
+    const alias = PRIOR_STATUS_ALIASES[v];
+    return alias ? { status: alias, sha: null } : null;
+}
+/** Split a ref `<round_no>:<finding_key>` on its FIRST colon (a key may hold
+ * colons — `recheck:<sha12>:<id>`). Null when it is not one. */
+export function parsePriorRef(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const t = raw.trim().replace(/^r(?=\d)/i, "");
+    const i = t.indexOf(":");
+    if (i <= 0)
+        return null;
+    const head = t.slice(0, i);
+    const key = t.slice(i + 1).trim();
+    if (!/^\d+$/.test(head) || !key)
+        return null;
+    return { round_no: Number(head), finding_key: key };
+}
+/**
+ * Parse the record's optional top-level `prior` array. Tolerant like the rest
+ * of the record: an entry it cannot use is COUNTED in a note, never a reason
+ * to reject the record. A ref naming this round or a later one is unusable
+ * (a prior finding is from an earlier round). A ref reported twice keeps the
+ * last report.
+ */
+function parsePriorArray(v, roundNo) {
+    const raw = v.prior ?? v.prior_findings;
+    if (raw === undefined || raw === null)
+        return { prior: [], notes: [] };
+    if (!Array.isArray(raw))
+        return { prior: [], notes: ["`prior` is not an array (ignored)"] };
+    const byRef = new Map();
+    let unusable = 0;
+    for (const entry of raw) {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            unusable++;
+            continue;
+        }
+        const e = entry;
+        const ref = parsePriorRef(e.ref ?? e.id);
+        const st = normalizePriorStatus(e.status);
+        if (!ref || !st || ref.round_no >= roundNo) {
+            unusable++;
+            continue;
+        }
+        const written = prose(e.evidence);
+        const evidence = st.sha !== null && (written === null || !written.includes(st.sha))
+            ? `fixed@${st.sha}${written ? ` — ${written}` : ""}`.slice(0, PROSE_CAP)
+            : written;
+        const canonical = carriedToRef(ref.round_no, ref.finding_key);
+        byRef.delete(canonical);
+        byRef.set(canonical, {
+            ref: canonical,
+            round_no: ref.round_no,
+            finding_key: ref.finding_key,
+            status: st.status,
+            evidence,
+        });
+    }
+    return {
+        prior: [...byRef.values()],
+        notes: unusable > 0
+            ? [
+                `${unusable} prior-finding status entr${unusable === 1 ? "y" : "ies"} unusable (ignored)`,
+            ]
+            : [],
+    };
+}
+export function isConformant(c) {
+    return (c.ungrammatical_tags.length === 0 &&
+        c.nits_without_request.length === 0 &&
+        c.doubted_posted.length === 0);
+}
+const num = recordNumber;
+const str = recordString;
+/** Cap on free prose the session writes, per field. The record is evidence,
+ * not a transcript — an unbounded `evidence` blob would put a whole pass
+ * output into every row. */
+const PROSE_CAP = 4000;
+function prose(val) {
+    const s = str(val);
+    return s === null ? null : s.slice(0, PROSE_CAP);
+}
+/**
+ * Parse and normalize one record file's already-JSON-decoded content.
+ *
+ * Tolerant like the verdict parser: digit-string numbers coerce,
+ * `candidates` is accepted for `findings`, `name` for `lens`, and an entry the
+ * parser cannot fully understand is kept with nulls plus a note rather than
+ * dropped. The ONLY rejections are structural — not an object, the wrong
+ * round, or no findings array at all — because those are the shapes where
+ * there is nothing to record.
+ */
+export function parseFindingsRecord(raw, pr, roundNo) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return { status: "unparseable" };
+    const v = raw;
+    const filePr = num(v.pr);
+    const fileRound = num(v.round_no);
+    // A record for another round is worse than none: it would attribute one
+    // round's reasoning to another. Rejected, and the nudge asks for this one.
+    if ((filePr !== null && filePr !== pr) || (fileRound !== null && fileRound !== roundNo))
+        return { status: "wrong_round" };
+    const rawFindings = recordEntries(v);
+    if (rawFindings === null)
+        return { status: "no_findings_array" };
+    const notes = [];
+    let noLens = 0;
+    let unknownDisposition = 0;
+    let unknownWord = 0;
+    const findings = [];
+    const conformance = {
+        ungrammatical_tags: [],
+        nits_without_request: [],
+        doubted_posted: [],
+        restated: [],
+    };
+    for (const [i, entry] of rawFindings.entries()) {
+        if (typeof entry !== "object" || entry === null) {
+            noLens++;
+            continue;
+        }
+        const e = entry;
+        const lens = str(e.lens) ?? str(e.name) ?? "";
+        if (!lens)
+            noLens++;
+        const path = str(e.path);
+        const line = num(e.line);
+        const word = str(e.word) ?? str(e.reason_word) ?? null;
+        const written = entryDisposition(e);
+        if (written === "unknown")
+            unknownDisposition++;
+        // A validity veto recorded as a kill is still a doubt.
+        const disposition = written === "killed" && word !== null && DOUBT_WORDS.includes(word.trim().toLowerCase())
+            ? "doubted"
+            : written;
+        if (word !== null && !isKnownVocabularyWord(word))
+            unknownWord++;
+        // The ONE key rule (packages/pi-plugin/src/findingkey.ts) — the live render route stamps the
+        // same key into the comment it posts, so the two always name one row.
+        const key = findingRecordKey(e, i);
+        const raisedIn = (() => {
+            const r = num(e.raised_in_round);
+            return r === null ? null : Math.trunc(r);
+        })();
+        // Output-rule audit — posted entries only: the three defects are about what
+        // reaches the author, and a killed candidate reached nobody.
+        if (disposition === "posted") {
+            const postedAs = str(e.posted_as);
+            if (postedAs !== null && !isSanctionedTag(postedAs))
+                conformance.ungrammatical_tags.push(key);
+            const bare = bareTag(postedAs);
+            // `request` is the field the nit rule asks a lens for: the concrete
+            // change the nit asks for. Its ABSENCE is the defect — a nit that names
+            // no change is a remark. Alternate spellings are accepted, as everywhere
+            // else in this parser.
+            const request = str(e.request) ?? str(e.ask) ?? str(e.remedy);
+            if (bare === "nit" && request === null)
+                conformance.nits_without_request.push(key);
+            if (raisedIn !== null && raisedIn < roundNo)
+                conformance.restated.push(key);
+        }
+        if (disposition === "doubted" && str(e.posted_as) !== null)
+            conformance.doubted_posted.push(key);
+        findings.push({
+            key,
+            path,
+            line: line === null ? null : Math.trunc(line),
+            lens,
+            tier: str(e.tier),
+            severity: str(e.severity),
+            confidence: num(e.confidence),
+            reachability: str(e.reachability),
+            kind: str(e.kind),
+            disposition,
+            axis: normalizeAxis(e.axis),
+            word,
+            reason: prose(e.reason),
+            evidence: prose(e.evidence),
+            posted_as: str(e.posted_as),
+            raised_in_round: raisedIn,
+            thread_id: (() => {
+                const t = num(e.thread_id);
+                return t === null ? null : Math.trunc(t);
+            })(),
+            title: (() => {
+                const t = str(e.title);
+                return t === null ? null : t.replace(/\s+/g, " ").slice(0, TITLE_CAP);
+            })(),
+        });
+    }
+    if (noLens > 0)
+        notes.push(`${noLens} entr${noLens === 1 ? "y" : "ies"} without a lens`);
+    if (unknownDisposition > 0)
+        notes.push(`${unknownDisposition} unrecognised disposition(s)`);
+    if (unknownWord > 0)
+        notes.push(`${unknownWord} word(s) outside the closed vocabulary`);
+    if (conformance.ungrammatical_tags.length > 0)
+        notes.push(`${conformance.ungrammatical_tags.length} posted finding(s) tagged outside the grammar`);
+    if (conformance.nits_without_request.length > 0)
+        notes.push(`${conformance.nits_without_request.length} posted nit(s) asking for nothing`);
+    if (conformance.doubted_posted.length > 0)
+        notes.push(`${conformance.doubted_posted.length} doubted finding(s) marked as posted`);
+    const priorParsed = parsePriorArray(v, roundNo);
+    notes.push(...priorParsed.notes);
+    const comments = num(v.comments_posted) ?? num(v.posted_comments);
+    return {
+        status: "ok",
+        conformance,
+        record: {
+            pr,
+            round_no: roundNo,
+            head_sha: str(v.head_sha),
+            comments_posted: comments === null ? null : Math.trunc(comments),
+            findings,
+            prior: priorParsed.prior,
+        },
+        ...(notes.length > 0 ? { note: notes.join("; ") } : {}),
+    };
+}
+/** Read + parse the record file. A missing/unreadable file is `missing`, an
+ * undecodable one `unparseable` — enforcement is identical either way; the
+ * distinction is for the record. */
+export function readFindingsRecord(path, pr, roundNo) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return { status: "missing" };
+    }
+    let decoded;
+    try {
+        decoded = JSON.parse(text);
+    }
+    catch {
+        return { status: "unparseable" };
+    }
+    return parseFindingsRecord(decoded, pr, roundNo);
+}
+/** `<root>/state/findings/pr-<n>-round-<k>.json` — the pinned path, same
+ * discipline as the verdict file and the round's other scratch paths. */
+export function findingsRecordFile(pr, roundNo) {
+    return `pr-${pr}-round-${roundNo}.json`;
+}
+export function findingsRecordPath(findingsDir, pr, roundNo) {
+    return join(findingsDir, findingsRecordFile(pr, roundNo));
+}
+/**
+ * The re-nudge wake. Bookkeeping-only and explicitly so: it arrives OUTSIDE a
+ * round, after the verdict has already landed, and the session must not
+ * mistake it for review work — no passes, no posting, no verdict file.
+ *
+ * It names the pinned scratch paths on purpose: the conversation has been
+ * compacted by the time this arrives, but the pass outputs and the review body
+ * are still on disk, so the record can be reconstructed from artifacts rather
+ * than from memory.
+ */
+export function findingsRecordWake(pr, roundNo, relPath) {
+    return [
+        `FINDINGS RECORD MISSING — PR #${pr} round ${roundNo}`,
+        `The round is over and its verdict has been applied, but ${relPath} is missing or unreadable.`,
+        "Write ONLY that file now, in this conversation: one entry per candidate finding this round produced — posted, killed, doubted, downgraded, merged, folded, withheld or conceded — each with its lens, severity, confidence, reachability, the closed-vocabulary kill/downgrade word, and the reason in your own words. On a POSTED entry, and on a DOWNGRADED entry the validator kept, also give `posted_as` (one of the sanctioned tags), and on a posted nit the `request` — the concrete change it asked for.",
+        `Reconstruct it from the artifacts still on disk: state/pr-${pr}-round-${roundNo}-passes/, state/pr-${pr}-round-${roundNo}-review.md and state/pr-${pr}-round-${roundNo}-comments.json. Record only what those artifacts support — an honest partial record beats an invented complete one.`,
+        "Do NOT do any review work, do NOT run passes, do NOT post anything to GitHub, and do NOT write a verdict file — this is a bookkeeping write only. You will not be asked again.",
+    ].join("\n");
+}
+//# sourceMappingURL=findingsrecord.js.map

package/dist/src/findingsrecord.js.map

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

package/dist/src/followup-mode.d.ts

@@ -0,0 +1,4 @@
+import { type CoreConfig } from "./reviewconfig.js";
+/** Production and replay admit delta follow-ups under the same knob/default. */
+export declare function deltaFollowUpEnabled(cfg: Pick<CoreConfig, "review">): boolean;
+//# sourceMappingURL=followup-mode.d.ts.map

package/dist/src/followup-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup-mode.d.ts","sourceRoot":"","sources":["../../src/followup-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErE,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,OAAO,CAE7E"}

package/dist/src/followup-mode.js

@@ -0,0 +1,6 @@
+import { REVIEW_DEFAULTS } from "./reviewconfig.js";
+/** Production and replay admit delta follow-ups under the same knob/default. */
+export function deltaFollowUpEnabled(cfg) {
+    return (cfg.review.follow_up ?? REVIEW_DEFAULTS.follow_up) === "delta";
+}
+//# sourceMappingURL=followup-mode.js.map

package/dist/src/followup-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup-mode.js","sourceRoot":"","sources":["../../src/followup-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAmB,MAAM,mBAAmB,CAAC;AAErE,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,GAA+B;IAClE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;AACzE,CAAC"}