@zephyrdeng/pi-review 0.16.1 → 0.17.1

package/dist/screen-memory.js

@@ -0,0 +1,320 @@
+// pi-review screen memory: the screening catalog learns from use.
+//
+// Two mechanisms share the pi-review state dir (siblings of config.json):
+//
+// - screen-patterns.json — a user-declared pattern catalog merged over the
+//   builtin SCREEN_PATTERNS, plus a `disabled` list to retire entries that
+//   misfire on this codebase. PI_REVIEW_SCREEN_PATTERNS names one extra file
+//   (e.g. a project catalog committed to the repo) which loads last and wins
+//   id conflicts — that is how a team shares its own defect patterns.
+//
+// - screen-memory.jsonl — every flagged hunk appends one JSONL entry with a
+//   code hash and its verdict. `pi-review screen-memory` aggregates the log:
+//   recurring unmatched signals are the evidence for new patterns, and hit
+//   frequencies show which entries earn their place. Promotion is always a
+//   human/agent edit of screen-patterns.json — screen never rewrites its own
+//   catalog. PI_REVIEW_SCREEN_MEMORY=0 disables recording; the file path moves
+//   with PI_REVIEW_SCREEN_MEMORY_FILE.
+//
+// Both files are advisory: malformed lines and invalid JSON warn on stderr and
+// degrade to "nothing loaded" — memory must never break the gate.
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { configFilePath } from "./pi-config.js";
+import { expandMaybeHome } from "./utils.js";
+/** Hard cap keeps the log self-bounding; on overflow the newest entries stay. */
+export const MEMORY_ENTRY_LIMIT = 500;
+export const MEMORY_ENTRY_KEEP = 400;
+/** Stored code snippets never exceed this many characters. */
+export const SNIPPET_LIMIT = 1600;
+const VALID_SEVERITIES = new Set(["critical", "major", "minor"]);
+const VALID_CATEGORIES = new Set(["correctness", "security", "data-loss", "performance"]);
+const PATTERN_ID_RE = /^[a-z][a-z0-9_]{0,63}$/;
+/** pi-review state dir: the directory containing the effective config file. */
+function stateDir(env) {
+    return path.dirname(configFilePath(env));
+}
+/** Machine-level user catalog, sibling of config.json. */
+export function screenPatternsFilePath(env = process.env) {
+    return path.join(stateDir(env), "screen-patterns.json");
+}
+export function screenMemoryFilePath(env = process.env) {
+    const override = env.PI_REVIEW_SCREEN_MEMORY_FILE?.trim();
+    if (override)
+        return expandMaybeHome(override);
+    return path.join(stateDir(env), "screen-memory.jsonl");
+}
+export function screenMemoryEnabled(env = process.env) {
+    const raw = env.PI_REVIEW_SCREEN_MEMORY?.trim().toLowerCase();
+    return raw !== "0" && raw !== "false" && raw !== "off";
+}
+/**
+ * Parse one patterns file, lenient like pi-config: bad entries warn and are
+ * skipped, unknown keys are ignored, invalid JSON yields an empty file.
+ * Shape: { "patterns": {id: {title, severity, category, recommendation}},
+ *          "disabled": [id, ...] }
+ */
+export function parseScreenPatternsFile(text, source) {
+    const warnings = [];
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        return {
+            patterns: {},
+            disabled: [],
+            warnings: [`${source} is not valid JSON (${error.message}); treating it as empty`],
+        };
+    }
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        return { patterns: {}, disabled: [], warnings: [`${source} must contain a JSON object; treating it as empty`] };
+    }
+    const record = raw;
+    const patterns = {};
+    if (record.patterns !== undefined && record.patterns !== null) {
+        if (typeof record.patterns !== "object" || Array.isArray(record.patterns)) {
+            warnings.push(`${source}: "patterns" must be an object; ignoring it`);
+        }
+        else {
+            for (const [id, value] of Object.entries(record.patterns)) {
+                if (!PATTERN_ID_RE.test(id)) {
+                    warnings.push(`${source}: pattern id "${id}" must match ${PATTERN_ID_RE}; skipping it`);
+                    continue;
+                }
+                const entry = value;
+                const problems = [];
+                if (entry === null || typeof entry !== "object" || Array.isArray(entry))
+                    problems.push("entry must be an object");
+                else {
+                    if (typeof entry.title !== "string" || !entry.title.trim())
+                        problems.push("title must be a non-empty string");
+                    if (typeof entry.severity !== "string" || !VALID_SEVERITIES.has(entry.severity))
+                        problems.push(`severity must be one of ${[...VALID_SEVERITIES].join("/")}`);
+                    if (typeof entry.category !== "string" || !VALID_CATEGORIES.has(entry.category))
+                        problems.push(`category must be one of ${[...VALID_CATEGORIES].join("/")}`);
+                    if (typeof entry.recommendation !== "string" || !entry.recommendation.trim())
+                        problems.push("recommendation must be a non-empty string");
+                }
+                if (problems.length > 0) {
+                    warnings.push(`${source}: pattern "${id}" invalid (${problems.join("; ")}); skipping it`);
+                    continue;
+                }
+                patterns[id] = {
+                    title: entry.title.trim(),
+                    severity: entry.severity,
+                    category: entry.category,
+                    recommendation: entry.recommendation.trim(),
+                };
+            }
+        }
+    }
+    const disabled = [];
+    if (record.disabled !== undefined && record.disabled !== null) {
+        if (!Array.isArray(record.disabled)) {
+            warnings.push(`${source}: "disabled" must be an array of pattern ids; ignoring it`);
+        }
+        else {
+            for (const value of record.disabled) {
+                if (typeof value === "string" && value.trim())
+                    disabled.push(value.trim());
+                else
+                    warnings.push(`${source}: "disabled" entries must be pattern id strings; skipping one`);
+            }
+        }
+    }
+    return { patterns, disabled, warnings };
+}
+/**
+ * Load user-declared patterns: the machine file first, then the extra file
+ * named by PI_REVIEW_SCREEN_PATTERNS (typically a project catalog checked
+ * into the repo). Later files override earlier ones on id conflicts, so a
+ * project can re-tune or replace a builtin entry. Missing files are skipped
+ * silently; unreadable ones warn.
+ */
+export function loadUserPatterns(env = process.env) {
+    const files = [screenPatternsFilePath(env)];
+    const extra = env.PI_REVIEW_SCREEN_PATTERNS?.trim();
+    if (extra)
+        files.push(expandMaybeHome(extra));
+    const merged = { patterns: {}, disabled: [], warnings: [], files: [] };
+    for (const file of files) {
+        if (!fs.existsSync(file))
+            continue;
+        let load;
+        try {
+            load = parseScreenPatternsFile(fs.readFileSync(file, "utf8"), file);
+        }
+        catch (error) {
+            merged.warnings.push(`cannot read ${file}: ${error.message}`);
+            continue;
+        }
+        merged.files.push(file);
+        Object.assign(merged.patterns, load.patterns);
+        merged.disabled.push(...load.disabled);
+        merged.warnings.push(...load.warnings);
+    }
+    merged.disabled = [...new Set(merged.disabled)];
+    return merged;
+}
+/** Lenient JSONL read: malformed lines are skipped, a missing file is empty. */
+export function readScreenMemory(file) {
+    let text;
+    try {
+        text = fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const line of text.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            if (entry && typeof entry === "object" && typeof entry.path === "string" && typeof entry.hunk === "string") {
+                entries.push(entry);
+            }
+        }
+        catch {
+            // malformed line: drop it — the log is advisory telemetry
+        }
+    }
+    return entries;
+}
+/**
+ * Record flagged hunks in the memory log. No-ops when recording is disabled
+ * or nothing was flagged. A repeated (path, hunk, code hash) refreshes the
+ * stored verdict in place and bumps `seen` — so promoting a pattern visibly
+ * flips its entry from unmatched to a hit — while new hashes append. The file
+ * is rewritten capped at MEMORY_ENTRY_LIMIT entries (newest MEMORY_ENTRY_KEEP
+ * survive) via tmp+rename with 0600 permissions: hunk code can embed the very
+ * secrets the catalog flags. Best-effort: any failure warns on stderr and
+ * never fails the gate.
+ */
+export function recordScreenMemory(flagged, env = process.env) {
+    if (flagged.length === 0 || !screenMemoryEnabled(env))
+        return;
+    try {
+        const file = screenMemoryFilePath(env);
+        const existing = readScreenMemory(file);
+        const byKey = new Map(existing.map((e) => [`${e.path}\u0000${e.hunk}\u0000${e.hash}`, e]));
+        const ts = new Date().toISOString();
+        let touched = 0;
+        for (const item of flagged) {
+            const hash = crypto.createHash("sha256").update(item.code).digest("hex");
+            const key = `${item.path}\u0000${item.hunk}\u0000${hash}`;
+            const snippet = item.code.length <= SNIPPET_LIMIT ? item.code : `${item.code.slice(0, SNIPPET_LIMIT)}…`;
+            const prev = byKey.get(key);
+            if (prev) {
+                prev.ts = ts;
+                prev.lines = [item.startLine, item.endLine];
+                prev.patterns = item.patterns;
+                prev.unmatched = item.patterns.length === 0;
+                if (item.catchAll !== undefined)
+                    prev.catchAll = item.catchAll;
+                prev.seen = (prev.seen ?? 1) + 1;
+                touched += 1;
+                continue;
+            }
+            byKey.set(key, {
+                ts,
+                path: item.path,
+                hunk: item.hunk,
+                lines: [item.startLine, item.endLine],
+                ...(item.catchAll !== undefined ? { catchAll: item.catchAll } : {}),
+                patterns: item.patterns,
+                unmatched: item.patterns.length === 0,
+                hash,
+                code: snippet,
+                seen: 1,
+            });
+            touched += 1;
+        }
+        if (touched === 0)
+            return;
+        const all = [...byKey.values()];
+        const kept = all.length > MEMORY_ENTRY_LIMIT ? all.slice(all.length - MEMORY_ENTRY_KEEP) : all;
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        const tmp = `${file}.${process.pid}.tmp`;
+        fs.writeFileSync(tmp, `${kept.map((entry) => JSON.stringify(entry)).join("\n")}\n`, { encoding: "utf8", mode: 0o600 });
+        fs.renameSync(tmp, file);
+        try {
+            fs.chmodSync(file, 0o600); // a file created before this hardening keeps its old mode otherwise
+        }
+        catch {
+            // best-effort tightening; the tmp+rename above is the real guard
+        }
+    }
+    catch (error) {
+        process.stderr.write(`pi-review: screen memory write failed (${error.message}); continuing\n`);
+    }
+}
+export function aggregateScreenMemory(entries) {
+    const files = new Set();
+    const hits = new Map();
+    const groups = new Map();
+    let unmatchedEntries = 0;
+    for (const entry of entries) {
+        files.add(entry.path);
+        for (const id of entry.patterns ?? []) {
+            hits.set(id, (hits.get(id) ?? 0) + 1);
+        }
+        if (!entry.unmatched)
+            continue;
+        unmatchedEntries += entry.seen ?? 1;
+        const key = `${entry.path}\u0000${entry.hunk}`;
+        const group = groups.get(key) ?? {
+            path: entry.path,
+            hunk: entry.hunk,
+            count: 0,
+            lastLines: [0, 0],
+            sample: "",
+        };
+        group.count += entry.seen ?? 1;
+        group.lastLines = entry.lines ?? [0, 0];
+        group.lastCatchAll = entry.catchAll;
+        group.sample = (entry.code ?? "").split("\n").map((l) => l.trim()).find((l) => l.length > 0)?.slice(0, 100) ?? "";
+        groups.set(key, group);
+    }
+    return {
+        entries: entries.length,
+        files: files.size,
+        unmatchedEntries,
+        patternHits: [...hits.entries()].map(([id, count]) => ({ id, count })).sort((a, b) => b.count - a.count),
+        unmatched: [...groups.values()].sort((a, b) => b.count - a.count),
+    };
+}
+export function formatScreenMemoryAscii(stats, meta) {
+    const lines = ["── pi-review screen memory " + "─".repeat(14)];
+    lines.push(`  Log        ${meta.file} · ${stats.entries} entr${stats.entries === 1 ? "y" : "ies"} across ${stats.files} file${stats.files === 1 ? "" : "s"}` +
+        (meta.catalog.recording ? "" : " (recording off: PI_REVIEW_SCREEN_MEMORY=0)"));
+    lines.push(`  Catalog    ${meta.catalog.builtin} builtin · ${meta.catalog.custom} custom` +
+        (meta.catalog.overrides > 0 ? ` (${meta.catalog.overrides} override${meta.catalog.overrides === 1 ? "s" : ""} builtin)` : "") +
+        ` · ${meta.catalog.disabled} disabled`);
+    if (stats.patternHits.length > 0) {
+        lines.push(`  Hits       ${stats.patternHits.map((h) => `${h.id} ×${h.count}`).join("  ")}`);
+    }
+    if (stats.unmatched.length > 0) {
+        lines.push(`  Unmatched  ${stats.unmatchedEntries} signal${stats.unmatchedEntries === 1 ? "" : "s"} in ${stats.unmatched.length} hunk${stats.unmatched.length === 1 ? "" : "s"} — promotion candidates:`);
+        for (const group of stats.unmatched.slice(0, 10)) {
+            const p = group.lastCatchAll !== undefined ? `  p=${group.lastCatchAll.toFixed(2)}` : "";
+            lines.push(`    ${group.path}  ${group.hunk}  lines ${group.lastLines[0]}-${group.lastLines[1]}${p}  ×${group.count}`);
+            if (group.sample)
+                lines.push(`      ${group.sample}`);
+        }
+        if (stats.unmatched.length > 10)
+            lines.push(`    … ${stats.unmatched.length - 10} more`);
+    }
+    else if (stats.entries === 0) {
+        lines.push("  Unmatched  none yet — run `pi-review screen` to accumulate signals");
+    }
+    else {
+        lines.push("  Unmatched  none — every flagged hunk matched the catalog");
+    }
+    lines.push(`  Promote    ${meta.patternsFile} (or PI_REVIEW_SCREEN_PATTERNS)`);
+    lines.push("─".repeat(39));
+    return lines.join("\n");
+}
+//# sourceMappingURL=screen-memory.js.map

package/dist/screen-memory.js.map

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

package/dist/screen-memory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=screen-memory.test.d.ts.map

package/dist/screen-memory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-memory.test.d.ts","sourceRoot":"","sources":["../src/screen-memory.test.ts"],"names":[],"mappings":""}

package/dist/screen-memory.test.js

@@ -0,0 +1,145 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { test } from "vitest";
+import { aggregateScreenMemory, formatScreenMemoryAscii, loadUserPatterns, parseScreenPatternsFile, readScreenMemory, recordScreenMemory, screenMemoryEnabled, screenMemoryFilePath, screenPatternsFilePath, MEMORY_ENTRY_KEEP, MEMORY_ENTRY_LIMIT, } from "./screen-memory.js";
+function tmpEnv() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-review-mem-"));
+    return { env: { PI_REVIEW_CONFIG: path.join(dir, "config.json") }, dir };
+}
+const FLAGGED = {
+    path: "src/order.ts",
+    hunk: "placeOrder",
+    startLine: 10,
+    endLine: 42,
+    catchAll: 0.82,
+    patterns: [],
+    code: "for (let i = 0; i <= items.length; i++) {",
+};
+test("parseScreenPatternsFile validates entries and skips bad ones with warnings", () => {
+    const load = parseScreenPatternsFile(JSON.stringify({
+        patterns: {
+            good_rule: { title: "T", severity: "major", category: "security", recommendation: "R" },
+            "Bad-Id": { title: "T", severity: "major", category: "security", recommendation: "R" },
+            bad_severity: { title: "T", severity: "fatal", category: "security", recommendation: "R" },
+            bad_shape: "not an object",
+        },
+        disabled: ["noisy_rule", 42],
+        unknown_key: "ignored",
+    }), "test.json");
+    assert.deepEqual(Object.keys(load.patterns), ["good_rule"]);
+    assert.deepEqual(load.disabled, ["noisy_rule"]);
+    assert.equal(load.warnings.length, 4); // Bad-Id + bad_severity + bad_shape + non-string disabled entry
+    assert.ok(load.warnings.some((w) => w.includes('"disabled"')));
+});
+test("parseScreenPatternsFile treats invalid JSON as empty with a warning", () => {
+    const load = parseScreenPatternsFile("{nope", "broken.json");
+    assert.deepEqual(load.patterns, {});
+    assert.equal(load.warnings.length, 1);
+});
+test("loadUserPatterns merges machine file then PI_REVIEW_SCREEN_PATTERNS, last wins", () => {
+    const { env, dir } = tmpEnv();
+    fs.writeFileSync(screenPatternsFilePath(env), JSON.stringify({
+        patterns: { a_rule: { title: "machine", severity: "minor", category: "correctness", recommendation: "r" } },
+        disabled: ["d1"],
+    }));
+    const extra = path.join(dir, "project.json");
+    fs.writeFileSync(extra, JSON.stringify({
+        patterns: {
+            a_rule: { title: "project override", severity: "critical", category: "security", recommendation: "r2" },
+            b_rule: { title: "project only", severity: "major", category: "data-loss", recommendation: "r" },
+        },
+        disabled: ["d2"],
+    }));
+    const load = loadUserPatterns({ ...env, PI_REVIEW_SCREEN_PATTERNS: extra });
+    assert.equal(load.patterns.a_rule.title, "project override");
+    assert.equal(load.patterns.b_rule.title, "project only");
+    assert.deepEqual(load.disabled.sort(), ["d1", "d2"]);
+    assert.equal(load.files.length, 2);
+});
+test("recordScreenMemory refreshes verdicts on re-flag, appends new hashes, and writes 0600", () => {
+    const { env } = tmpEnv();
+    const file = screenMemoryFilePath(env);
+    recordScreenMemory([FLAGGED], env);
+    recordScreenMemory([FLAGGED], env); // same hash: refreshes, seen++
+    let entries = readScreenMemory(file);
+    assert.equal(entries.length, 1);
+    assert.equal(entries[0].unmatched, true);
+    assert.equal(entries[0].seen, 2);
+    assert.deepEqual(entries[0].lines, [10, 42]);
+    assert.equal(fs.statSync(file).mode & 0o777, 0o600); // snippets can embed flagged secrets
+    // a promoted pattern flips the stored verdict in place
+    recordScreenMemory([{ ...FLAGGED, patterns: ["off_by_one_loop"] }], env);
+    entries = readScreenMemory(file);
+    assert.equal(entries.length, 1);
+    assert.equal(entries[0].unmatched, false);
+    assert.deepEqual(entries[0].patterns, ["off_by_one_loop"]);
+    assert.equal(entries[0].seen, 3);
+    // changed code → new hash → new entry
+    recordScreenMemory([{ ...FLAGGED, code: "different code body" }], env);
+    entries = readScreenMemory(file);
+    assert.equal(entries.length, 2);
+    // disabled env writes nothing
+    recordScreenMemory([{ ...FLAGGED, hunk: "other", code: "z" }], { ...env, PI_REVIEW_SCREEN_MEMORY: "0" });
+    assert.equal(readScreenMemory(file).length, 2);
+    assert.equal(screenMemoryEnabled({ PI_REVIEW_SCREEN_MEMORY: "off" }), false);
+});
+test("recordScreenMemory caps the log at MEMORY_ENTRY_LIMIT", () => {
+    const { env } = tmpEnv();
+    const file = screenMemoryFilePath(env);
+    const seed = Array.from({ length: MEMORY_ENTRY_LIMIT }, (_, i) => ({
+        ts: "t",
+        path: "f.ts",
+        hunk: `h${i}`,
+        lines: [1, 2],
+        patterns: [],
+        unmatched: true,
+        hash: `seed${i}`,
+    }));
+    fs.writeFileSync(file, `${seed.map((e) => JSON.stringify(e)).join("\n")}\n`);
+    recordScreenMemory([FLAGGED], env);
+    const entries = readScreenMemory(file);
+    assert.equal(entries.length, MEMORY_ENTRY_KEEP);
+    assert.equal(entries[entries.length - 1].hunk, "placeOrder"); // newest kept
+});
+test("aggregateScreenMemory groups unmatched signals and counts pattern hits", () => {
+    const entries = [
+        { ts: "1", path: "a.ts", hunk: "f", lines: [1, 5], catchAll: 0.8, patterns: [], unmatched: true, hash: "1", code: "  first line\n  second" },
+        { ts: "2", path: "a.ts", hunk: "f", lines: [1, 6], catchAll: 0.9, patterns: [], unmatched: true, hash: "2", code: "  changed first" },
+        { ts: "3", path: "b.ts", hunk: "g", lines: [1, 3], patterns: ["sql_injection"], unmatched: false, hash: "3" },
+        { ts: "4", path: "b.ts", hunk: "h", lines: [4, 9], patterns: ["sql_injection", "float_money"], unmatched: false, hash: "4" },
+    ];
+    const stats = aggregateScreenMemory(entries);
+    assert.equal(stats.entries, 4);
+    assert.equal(stats.files, 2);
+    assert.equal(stats.unmatchedEntries, 2);
+    assert.deepEqual(stats.patternHits, [
+        { id: "sql_injection", count: 2 },
+        { id: "float_money", count: 1 },
+    ]);
+    assert.equal(stats.unmatched.length, 1);
+    assert.equal(stats.unmatched[0].count, 2);
+    assert.equal(stats.unmatched[0].lastCatchAll, 0.9);
+    assert.equal(stats.unmatched[0].sample, "changed first");
+});
+test("formatScreenMemoryAscii renders catalog, hits, and promotion hint", () => {
+    const stats = aggregateScreenMemory([
+        { ts: "1", path: "a.ts", hunk: "f", lines: [1, 5], catchAll: 0.8, patterns: [], unmatched: true, hash: "1", code: "code" },
+    ]);
+    const text = formatScreenMemoryAscii(stats, {
+        file: "/tmp/mem.jsonl",
+        patternsFile: "/tmp/screen-patterns.json",
+        catalog: { builtin: 21, custom: 2, overrides: 1, disabled: 1, recording: true },
+    });
+    assert.ok(text.includes("21 builtin · 2 custom (1 overrides builtin) · 1 disabled"));
+    assert.ok(text.includes("a.ts"));
+    assert.ok(text.includes("screen-patterns.json"));
+    const empty = formatScreenMemoryAscii(aggregateScreenMemory([]), {
+        file: "/tmp/mem.jsonl",
+        patternsFile: "/tmp/screen-patterns.json",
+        catalog: { builtin: 21, custom: 0, overrides: 0, disabled: 0, recording: true },
+    });
+    assert.ok(empty.includes("none yet"));
+});
+//# sourceMappingURL=screen-memory.test.js.map

package/dist/screen-memory.test.js.map

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

package/dist/screen.d.ts

@@ -1,4 +1,5 @@
 import { type JevConnection, type JevFetch, type JevUsage } from "./jev.js";
+import { type FlaggedScreenHunk } from "./screen-memory.js";
 import type { ParsedArgs, ReviewFinding } from "./types.js";
 /** Probability floor for both the catch-all and per-pattern questions. */
 export declare const SCREEN_THRESHOLD = 0.6;
@@ -49,7 +50,23 @@ export interface ScreenResult {
 /** Screen pre-sliced hunks; pure of filesystem and process exit so tests drive it with a mocked fetch. */
 export declare function screenHunks(connection: JevConnection, hunks: ScreenHunk[], options?: {
     fetchImpl?: JevFetch;
+    patterns?: Record<string, ScreenPattern>;
 }): Promise<ScreenResult>;
+/**
+ * Flagged hunks paired back with their code, in the shape the memory log
+ * stores. hunkReports and hunks share order and length by construction.
+ */
+export declare function collectFlaggedHunks(result: ScreenResult, hunks: ScreenHunk[]): FlaggedScreenHunk[];
+/**
+ * Builtin catalog + user pattern files − disabled ids. The effective catalog
+ * is rebuilt per run so edits to screen-patterns.json take effect immediately.
+ */
+export declare function effectiveScreenPatterns(env: NodeJS.ProcessEnv): {
+    patterns: Record<string, ScreenPattern>;
+    warnings: string[];
+};
 export declare function formatScreenAscii(result: ScreenResult): string;
 export declare function runScreen(parsed: ParsedArgs): Promise<never>;
+/** `pi-review screen-memory`: report the accumulated signal log and catalog state. */
+export declare function runScreenMemory(env?: NodeJS.ProcessEnv): never;
 //# sourceMappingURL=screen.d.ts.map

package/dist/screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,mHAAmH;AACnH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;IACnE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAiDzD,CAAC;AAIF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAYD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA2B,GAAG,UAAU,EAAE,CA6C1G;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,GAAG,cAAc,CAAC;IACjC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAiCD,0GAA0G;AAC1G,wBAAsB,WAAW,CAC/B,UAAU,EAAE,aAAa,EACzB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,QAAQ,CAAA;CAAO,GACrC,OAAO,CAAC,YAAY,CAAC,CAgFvB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmB9D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAuClE"}
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAkBA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,mHAAmH;AACnH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;IACnE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAkIzD,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAqBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA2B,GAAG,UAAU,EAAE,CA6C1G;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,GAAG,cAAc,CAAC;IACjC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAiCD,0GAA0G;AAC1G,wBAAsB,WAAW,CAC/B,UAAU,EAAE,aAAa,EACzB,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAAO,GAC/E,OAAO,CAAC,YAAY,CAAC,CAkFvB;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,iBAAiB,EAAE,CAgBlG;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG;IAC/D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAiBA;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmB9D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CA8ClE;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,KAAK,CAuB3E"}