@quickchatai/pi-quickreview 1.2.0 → 1.3.2

package/dist/src/scan/scanreport.d.ts

@@ -0,0 +1,126 @@
+import type { FindingsFile, MatchQuestion, ResemblesDismissed, ScanFinding } from "./findings.js";
+import type { RunFile, ScanRun, ScanRunSummary } from "./scanrun.js";
+export type { FindingState, ScanFinding } from "./findings.js";
+export type { ScanCaseState, ScanRun, ScanRunSummary } from "./scanrun.js";
+export type { ScanSeverity } from "./scan.js";
+export declare const FINDING_STATES: readonly ["new", "promoted", "dismissed", "fixed"];
+export declare const RUN_FILE = "scan/run.json";
+export declare const RUN_VERSION = 1;
+export declare const FINDINGS_FILE = "scan/findings.json";
+export declare const FINDINGS_VERSION = 1;
+export declare const SCAN_STOP_FILE = "scan/stop.json";
+export declare const SCAN_STOP_RESULT_FILE = "scan/stop-result.json";
+/** The skeptic's tier for a stored scan finding: `confirmed` (it traced a
+ * concrete scenario), `likely` (a real mechanism, reachability not fully
+ * traced), `doubtful` (refuted, class-matched, or anything it would have
+ * killed — kept, never dropped). */
+export type Validity = "confirmed" | "likely" | "doubtful";
+export declare const VALIDITIES: readonly Validity[];
+/** A tier, or `unknown`: no skeptic judged it (the validator was off or
+ * failed) or it was stored before tiers existed — never guessed. */
+export type ValidityView = Validity | "unknown";
+/** Display order: confirmed first, unknown last. */
+export declare const VALIDITY_ORDER: readonly ValidityView[];
+/** The longest dismissal reason triage takes. The TUI checks it before
+ * asking, so an over-long reason is refused where it is typed. */
+export declare const DISMISS_REASON_MAX = 500;
+/** A dismissed finding a re-scan settled as no longer reported (findings.ts
+ * `unreported`): out of play, as a fixed one is, until a scan reports it again. */
+export declare const goneDismissal: (f: Pick<ScanFinding, "state" | "unreported">) => boolean;
+/** A finding's tier as stored — `unknown` when it carries none. */
+export declare function validityOf(f: {
+    validity?: Validity | null;
+}): ValidityView;
+/** Is a finding still standing — new, or promoted and not yet fixed? The
+ * portrait's counts and the scan tab's weights read open the same way. */
+export declare const isOpenFinding: (f: Pick<ScanFinding, "state">) => boolean;
+/** A finding's resemblance to a DISMISSED one (findings.ts sets it when it
+ * stores the finding), as a reader shows it: only on a finding still
+ * untriaged (`new`) — once the operator promotes or dismisses it, the
+ * resemblance is answered. */
+export declare function dismissedLookalike(f: Pick<ScanFinding, "state" | "resembles_dismissed">): ResemblesDismissed | null;
+/** 1 for a finding flagged as resembling a dismissed one, else 0 — the sort
+ * key that puts it below the unflagged findings of its tier. */
+export declare const lookalikeRank: (f: Pick<ScanFinding, "state" | "resembles_dismissed">) => number;
+/** Parse the run record; throws on anything this version does not read. */
+export declare function parseRunFile(text: string): RunFile;
+/** Parse the findings store; throws on anything this version does not read. */
+export declare function parseFindingsFile(text: string): FindingsFile;
+/** One record file: absent, read, or why it could not be. */
+export type RecordRead<T> = {
+    kind: "absent";
+} | {
+    kind: "read";
+    value: T;
+} | {
+    kind: "unreadable";
+    why: string;
+};
+/** The scan run record in the state home at `home`. */
+export declare function readScanRuns(home: string): RecordRead<{
+    current: ScanRun | null;
+    history: ScanRunSummary[];
+}>;
+/** The findings store in the state home at `home`. */
+export declare function readScanFindings(home: string): RecordRead<{
+    findings: ScanFinding[];
+    question: MatchQuestion | null;
+}>;
+export interface ScanStopRequest {
+    /** Unique per click; the result names it. */
+    id: string;
+    /** The run the TUI showed running — only that run is stopped. */
+    run: string;
+    at: string;
+    /** Who asked: the TUI's stop, `qcr scan stop`, or the companion's
+     * scan_stop for a run another process drives. */
+    by: "tui" | "cli" | "companion";
+}
+export interface ScanStopResult {
+    request: string;
+    run: string;
+    at: string;
+    ok: boolean;
+    errors: string[];
+    /** The run the answering companion was driving when it answered — `null`
+     * when it drove none. Absent from an answer that does not say. A run the
+     * record still calls running that the companion says it is not driving was
+     * interrupted (a companion restart loses the run in flight). */
+    in_flight?: string | null;
+}
+/** Parse a stop request, or null when it is not one. */
+export declare function parseStopRequest(text: string): ScanStopRequest | null;
+/** Parse a stop result, or null when it is not one. */
+export declare function parseStopResult(text: string): ScanStopResult | null;
+/**
+ * The TUI's stop: ask the companion to stop the run `run`, which the TUI
+ * showed running. Refused when the record cannot be read or no longer shows
+ * that run running — a stop is never aimed at a run the operator did not see.
+ * The notice line says what was asked, or why nothing was.
+ */
+export declare function clickStopScan(home: string, run: string, now?: Date, by?: ScanStopRequest["by"]): {
+    ok: true;
+    request: string;
+    line: string;
+} | {
+    ok: false;
+    line: string;
+};
+/** The companion's latest stop answer: none yet (`absent`, or a file this
+ * version does not read as one), the answer, or `unreadable` with the reason
+ * — never a throw, and an unreadable answer is never mistaken for none. */
+export type StopResultRead = {
+    kind: "absent";
+} | {
+    kind: "read";
+    result: ScanStopResult;
+} | {
+    kind: "unreadable";
+    why: string;
+};
+export declare function readStopResult(home: string): StopResultRead;
+/** What became of the stop `request`: the companion's answer, or null while
+ * it has not answered (a companion that is down stops nothing — and runs
+ * nothing either). */
+export declare function scanStopOutcome(home: string, request: string): string | null;
+//# sourceMappingURL=scanreport.d.ts.map

package/dist/src/scan/scanreport.d.ts.map

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

package/dist/src/scan/scanreport.js

@@ -0,0 +1,289 @@
+// The scan report's read side and its stop channel: what the TUI's `[8] scan`
+// tab reads out of the state home, and the one file through which it asks
+// the companion to stop a running scan. A leaf like stage2request.ts:
+// it reaches its siblings by type only, so the TUI (which never imports the
+// setup engine — tests/single-shepherd.test.ts) can read the run record and
+// the findings store without carrying the case runner along.
+//
+// Two record files, both the engine's (this module owns their names and
+// their parsers, so the engine and the TUI can never read them differently):
+// `scan/run.json` (scanrun.ts — the current run and a short history) and
+// `scan/findings.json` (findings.ts — every finding with its state). Each is
+// read totally and is one of three facts: absent (no scan has written it),
+// read, or unreadable with the reason — never an empty list standing in for
+// a file that could not be read (the honest-unknown rule).
+//
+// The stop channel mirrors the stage-2 start channel: the TUI writes
+// `SCAN_STOP_FILE` naming the run it showed running; the companion's scan
+// belt picks it up within seconds, stops exactly that run (in-flight cases
+// aborted, the ledger resumes the rest) and answers in
+// `SCAN_STOP_RESULT_FILE`, naming the request it answered — so a stop is
+// answered once and never replayed onto a later run.
+import { join } from "node:path";
+import { readTextIfPresent, writeAtomic } from "./channelfs.js";
+export const FINDING_STATES = ["new", "promoted", "dismissed", "fixed"];
+export const RUN_FILE = "scan/run.json";
+export const RUN_VERSION = 1;
+export const FINDINGS_FILE = "scan/findings.json";
+export const FINDINGS_VERSION = 1;
+export const SCAN_STOP_FILE = "scan/stop.json";
+export const SCAN_STOP_RESULT_FILE = "scan/stop-result.json";
+export const VALIDITIES = ["confirmed", "likely", "doubtful"];
+/** Display order: confirmed first, unknown last. */
+export const VALIDITY_ORDER = [...VALIDITIES, "unknown"];
+/** The longest dismissal reason triage takes. The TUI checks it before
+ * asking, so an over-long reason is refused where it is typed. */
+export const DISMISS_REASON_MAX = 500;
+/** A dismissed finding a re-scan settled as no longer reported (findings.ts
+ * `unreported`): out of play, as a fixed one is, until a scan reports it again. */
+export const goneDismissal = (f) => f.state === "dismissed" && f.unreported != null;
+/** A finding's tier as stored — `unknown` when it carries none. */
+export function validityOf(f) {
+    return f.validity !== undefined &&
+        f.validity !== null &&
+        VALIDITIES.includes(f.validity)
+        ? f.validity
+        : "unknown";
+}
+const clean = (err) => (err instanceof Error ? err.message : String(err));
+// ---- the two records ---------------------------------------------------------------
+/** Is a finding still standing — new, or promoted and not yet fixed? The
+ * portrait's counts and the scan tab's weights read open the same way. */
+export const isOpenFinding = (f) => f.state === "new" || f.state === "promoted";
+/** A finding's resemblance to a DISMISSED one (findings.ts sets it when it
+ * stores the finding), as a reader shows it: only on a finding still
+ * untriaged (`new`) — once the operator promotes or dismisses it, the
+ * resemblance is answered. */
+export function dismissedLookalike(f) {
+    return f.state === "new" ? (f.resembles_dismissed ?? null) : null;
+}
+/** 1 for a finding flagged as resembling a dismissed one, else 0 — the sort
+ * key that puts it below the unflagged findings of its tier. */
+export const lookalikeRank = (f) => dismissedLookalike(f) ? 1 : 0;
+/** Parse the run record; throws on anything this version does not read. */
+export function parseRunFile(text) {
+    const raw = JSON.parse(text);
+    if (typeof raw !== "object" || raw === null || raw.version !== RUN_VERSION)
+        throw new Error("unknown version");
+    const current = raw.current ?? null;
+    if (current !== null && (typeof current !== "object" || !Array.isArray(current.cases))) {
+        throw new Error("`current` is not a scan run");
+    }
+    return { version: RUN_VERSION, current, history: Array.isArray(raw.history) ? raw.history : [] };
+}
+/** Parse the findings store; throws on anything this version does not read. */
+export function parseFindingsFile(text) {
+    const raw = JSON.parse(text);
+    if (typeof raw !== "object" ||
+        raw === null ||
+        raw.version !== FINDINGS_VERSION ||
+        !Array.isArray(raw.findings)) {
+        throw new Error("not a version-1 findings store");
+    }
+    for (const f of raw.findings) {
+        if (typeof f?.fingerprint !== "string" ||
+            typeof f.path !== "string" ||
+            typeof f.state !== "string") {
+            throw new Error("a finding has no fingerprint, path or state");
+        }
+    }
+    const q = raw.question ?? null;
+    if (q !== null &&
+        (typeof q.key !== "string" || !Array.isArray(q.unreported) || !Array.isArray(q.fresh))) {
+        throw new Error("the pending match question is malformed");
+    }
+    return {
+        version: FINDINGS_VERSION,
+        findings: currentLookalikes(raw.findings.map(stickyDismissal)),
+        question: q,
+    };
+}
+/** A `resembles_dismissed` flag is written when a finding is stored; the
+ * dismissal it names can change after that — re-dismissed with another
+ * reason, promoted (the operator changed their mind), or folded into a fresh
+ * finding by a match answer. Every reader goes through this parse, so the
+ * flag is re-read against the store here: it names the finding that now
+ * carries that fingerprint (itself, or the one it became an alias of) and
+ * that finding's current reason while it is still dismissed, and it is
+ * dropped otherwise — a stale "looks like a finding you dismissed" never
+ * reaches the operator. */
+function currentLookalikes(findings) {
+    if (!findings.some((f) => f.resembles_dismissed))
+        return findings;
+    const owner = new Map();
+    for (const f of findings)
+        for (const a of f.aliases ?? [])
+            owner.set(a, f);
+    for (const f of findings)
+        owner.set(f.fingerprint, f);
+    return findings.map((f) => {
+        if (!f.resembles_dismissed)
+            return f;
+        const { resembles_dismissed: flag, ...rest } = f;
+        const d = owner.get(flag.fingerprint);
+        if (!d || d.state !== "dismissed" || d.fingerprint === f.fingerprint)
+            return rest;
+        return {
+            ...rest,
+            resembles_dismissed: {
+                fingerprint: d.fingerprint,
+                reason: d.dismissal?.reason ?? flag.reason,
+            },
+        };
+    });
+}
+/** A legacy store may hold a dismissed finding recorded as `fixed` with
+ * `fixed.from = "dismissed"`: it reads back as the dismissal it is, its fix
+ * kept as the `unreported` audit stamp (findings.ts). Every other finding is
+ * returned as it is. */
+function stickyDismissal(f) {
+    if (f.state !== "fixed" || f.fixed?.from !== "dismissed")
+        return f;
+    const { run, sha, at } = f.fixed;
+    return { ...f, state: "dismissed", fixed: null, unreported: { run, sha, at } };
+}
+function readRecord(home, rel, parse) {
+    let text;
+    try {
+        text = readTextIfPresent(join(home, rel));
+    }
+    catch (err) {
+        return { kind: "unreadable", why: `${rel} cannot be read: ${clean(err)}` };
+    }
+    if (text === null)
+        return { kind: "absent" };
+    try {
+        return { kind: "read", value: parse(text) };
+    }
+    catch (err) {
+        return { kind: "unreadable", why: `${rel} is not a record this version reads (${clean(err)})` };
+    }
+}
+/** The scan run record in the state home at `home`. */
+export function readScanRuns(home) {
+    return readRecord(home, RUN_FILE, (t) => {
+        const f = parseRunFile(t);
+        return { current: f.current, history: f.history };
+    });
+}
+/** The findings store in the state home at `home`. */
+export function readScanFindings(home) {
+    return readRecord(home, FINDINGS_FILE, (t) => {
+        const f = parseFindingsFile(t);
+        return { findings: f.findings, question: f.question ?? null };
+    });
+}
+/** Parse a stop request, or null when it is not one. */
+export function parseStopRequest(text) {
+    try {
+        const r = JSON.parse(text);
+        if (typeof r !== "object" ||
+            r === null ||
+            typeof r.id !== "string" ||
+            r.id === "" ||
+            typeof r.run !== "string" ||
+            r.run === "")
+            return null;
+        return {
+            id: r.id,
+            run: r.run,
+            at: typeof r.at === "string" ? r.at : "",
+            by: r.by === "cli" || r.by === "companion" ? r.by : "tui",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse a stop result, or null when it is not one. */
+export function parseStopResult(text) {
+    try {
+        const r = JSON.parse(text);
+        if (typeof r !== "object" ||
+            r === null ||
+            typeof r.request !== "string" ||
+            typeof r.ok !== "boolean")
+            return null;
+        return {
+            request: r.request,
+            run: typeof r.run === "string" ? r.run : "",
+            at: typeof r.at === "string" ? r.at : "",
+            ok: r.ok,
+            errors: Array.isArray(r.errors)
+                ? r.errors.filter((e) => typeof e === "string")
+                : [],
+            ...(typeof r.in_flight === "string" || r.in_flight === null
+                ? { in_flight: r.in_flight }
+                : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The TUI's stop: ask the companion to stop the run `run`, which the TUI
+ * showed running. Refused when the record cannot be read or no longer shows
+ * that run running — a stop is never aimed at a run the operator did not see.
+ * The notice line says what was asked, or why nothing was.
+ */
+export function clickStopScan(home, run, now = new Date(), by = "tui") {
+    const read = readScanRuns(home);
+    if (read.kind === "unreadable")
+        return { ok: false, line: `scan not stopped: ${read.why}` };
+    const cur = read.kind === "read" ? read.value.current : null;
+    if (cur === null || cur.id !== run || cur.state !== "running") {
+        return {
+            ok: false,
+            line: `scan not stopped: ${run} is no longer running — look at the report again`,
+        };
+    }
+    const request = {
+        id: `${now.toISOString()}-${Math.random().toString(36).slice(2, 8)}`,
+        run,
+        at: now.toISOString(),
+        by,
+    };
+    try {
+        writeAtomic(join(home, SCAN_STOP_FILE), `${JSON.stringify(request)}\n`);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            line: `scan not stopped: the stop request could not be written: ${clean(err)}`,
+        };
+    }
+    return {
+        ok: true,
+        request: request.id,
+        line: `stop asked for ${run} — the companion stops it within seconds; the ledger resumes the rest`,
+    };
+}
+export function readStopResult(home) {
+    let text;
+    try {
+        text = readTextIfPresent(join(home, SCAN_STOP_RESULT_FILE));
+    }
+    catch (err) {
+        return { kind: "unreadable", why: `${SCAN_STOP_RESULT_FILE}: ${clean(err)}` };
+    }
+    const r = text === null ? null : parseStopResult(text);
+    return r === null ? { kind: "absent" } : { kind: "read", result: r };
+}
+/** What became of the stop `request`: the companion's answer, or null while
+ * it has not answered (a companion that is down stops nothing — and runs
+ * nothing either). */
+export function scanStopOutcome(home, request) {
+    const read = readStopResult(home);
+    // Not "no answer yet": the answer may be there, unreadable — said once,
+    // never polled for silently.
+    if (read.kind === "unreadable")
+        return `the scan stop's answer cannot be read (${read.why}) — check scan_status`;
+    if (read.kind === "absent" || read.result.request !== request)
+        return null;
+    const r = read.result;
+    return r.ok
+        ? `scan ${r.run} stopped — what finished is in the ledger`
+        : `scan stop refused: ${r.errors.join("; ")}`;
+}
+//# sourceMappingURL=scanreport.js.map

package/dist/src/scan/scanreport.js.map

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