secondpair 0.1.0

package/dist/review.js

@@ -0,0 +1,274 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { estimateTokens, getModel, loadIndex, selectContext, structuredCall } from "codengram";
+import { isIgnored } from "./config.js";
+import { parseDiff } from "./diff/parse.js";
+import { withFindingId } from "./finding-id.js";
+import { CRITIQUE_SYSTEM_PROMPT, REVIEW_SYSTEM_PROMPT, buildCritiqueUserPrompt, buildReviewUserPrompt, } from "./llm/prompt.js";
+import { reviewOutputSchema, validateFindings } from "./llm/schema.js";
+import { reconcileFindings } from "./reconcile.js";
+import { compileRedactPatterns, redactSecrets } from "./redact.js";
+import { SEVERITIES, severityRank } from "./types.js";
+/** Cap on the prompt tokens spent on diff text per LLM call; larger diffs are chunked by file. */
+const DIFF_TOKENS_PER_CALL = 60_000;
+/** Token cap per inlined source snippet (~4 chars/token). */
+const SNIPPET_TOKENS_PER_FILE = 2000;
+export async function runReview(opts) {
+    const log = opts.log ?? (() => { });
+    const stats = {
+        model: getModel(),
+        llmCalls: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        findingsBySeverity: Object.fromEntries(SEVERITIES.map((s) => [s, 0])),
+        droppedValidation: 0,
+        droppedCaps: 0,
+        droppedDuplicates: 0,
+        droppedCritique: 0,
+        suppressed: 0,
+        persistent: 0,
+    };
+    const onUsage = (u) => {
+        stats.inputTokens += u.inputTokens;
+        stats.outputTokens += u.outputTokens;
+    };
+    const temperature = opts.config.temperature ?? undefined;
+    const extraRedactPatterns = opts.config.redact_secrets && opts.config.redact_patterns.length > 0
+        ? compileRedactPatterns(opts.config.redact_patterns)
+        : [];
+    const maybeRedact = (text) => opts.config.redact_secrets ? redactSecrets(text, extraRedactPatterns) : text;
+    // Parse redacted text so raw secrets never enter prompts. PEM replacement may collapse lines.
+    const allFiles = parseDiff(maybeRedact(opts.diffText));
+    const files = allFiles.filter((f) => !isIgnored(f.path, opts.config) && f.status !== "deleted" && f.changedLines.length > 0);
+    if (files.length === 0) {
+        return {
+            findings: [],
+            summary: "No reviewable changes in the diff.",
+            dropped: [],
+            files: [],
+            usedContext: false,
+            reconciliation: emptyReconciliation(),
+            findingsToPost: [],
+            stats,
+        };
+    }
+    log(`Reviewing ${files.length} changed file(s).`);
+    let context = "";
+    let usedContext = false;
+    if (opts.useContext !== false) {
+        const index = await loadIndex(opts.cwd);
+        if (index) {
+            const selection = selectContext(index, files.map((f) => f.path), opts.config.context_token_budget);
+            const snippets = await renderSnippets(opts.cwd, selection.entries, opts.config.context_snippets);
+            context = [selection.rendered, snippets].filter(Boolean).join("\n\n");
+            usedContext = selection.entries.length > 0;
+            log(`Injecting context from ${selection.entries.length} codemap entries.`);
+        }
+        else {
+            log("No codengram index found (.codengram/index.json) — reviewing diff-only. Run `codengram init` (or `codengram index`) and commit the index for whole-repo context.");
+        }
+    }
+    context = maybeRedact(context);
+    const chunks = chunkFiles(files);
+    if (chunks.length > 1)
+        log(`Large diff — splitting into ${chunks.length} review calls.`);
+    const outputs = [];
+    for (const chunk of chunks) {
+        const user = buildReviewUserPrompt({
+            files: chunk,
+            context,
+            config: opts.config,
+            changeDescription: opts.changeDescription,
+        });
+        const output = await withRetry(() => structuredCall({
+            system: REVIEW_SYSTEM_PROMPT,
+            user,
+            schema: reviewOutputSchema,
+            schemaName: "review_output",
+            temperature,
+            onUsage,
+        }));
+        stats.llmCalls += 1;
+        outputs.push(output);
+    }
+    const merged = {
+        summary: outputs.map((o) => o.summary).join(" "),
+        findings: outputs.flatMap((o) => o.findings),
+    };
+    const validated = validateFindings(merged, files, opts.config);
+    stats.droppedValidation = validated.dropped.length;
+    if (validated.dropped.length > 0) {
+        log(`Dropped ${validated.dropped.length} finding(s) failing validation (outside diff, low confidence, or disabled category).`);
+    }
+    const { kept, capped } = capFindings(validated.findings, opts.config.limits);
+    stats.droppedCaps = capped.length;
+    if (capped.length > 0) {
+        log(`Capped ${capped.length} finding(s) (limits: ${opts.config.limits.max_findings_per_file}/file, ${opts.config.limits.max_total} total).`);
+    }
+    const { kept: deduped, duplicates } = dedupeById(kept.map((f) => withFindingId(f)));
+    stats.droppedDuplicates = duplicates.length;
+    if (duplicates.length > 0) {
+        log(`Dropped ${duplicates.length} duplicate finding(s) (same file/category/title reported more than once).`);
+    }
+    let identified = deduped;
+    let droppedCritique = [];
+    if (opts.config.self_critique && identified.length > 0) {
+        const keepSchema = z.object({
+            keep_ids: z.array(z.string()).describe("Ids of the findings to keep"),
+        });
+        const critique = await withRetry(() => structuredCall({
+            system: CRITIQUE_SYSTEM_PROMPT,
+            user: buildCritiqueUserPrompt({ findings: identified, changeDescription: opts.changeDescription }),
+            schema: keepSchema,
+            schemaName: "critique_output",
+            temperature,
+            onUsage,
+        }));
+        stats.llmCalls += 1;
+        const keep = new Set(critique.keep_ids);
+        const surviving = identified.filter((f) => keep.has(f.id));
+        // A keep-list that empties the review is a misfire, not a judgment — keep everything.
+        if (surviving.length > 0 || identified.length === 0) {
+            droppedCritique = identified.filter((f) => !keep.has(f.id));
+            identified = surviving;
+        }
+        stats.droppedCritique = droppedCritique.length;
+        if (droppedCritique.length > 0) {
+            log(`Self-critique dropped ${droppedCritique.length} finding(s) it would not defend.`);
+        }
+    }
+    const { active, toPost, reconciliation } = reconcileFindings(identified, {
+        previousIds: opts.previousIds,
+        previousFindings: opts.previousFindings,
+        suppressedIds: opts.suppressedIds,
+    });
+    log(`Reconciliation: ${reconciliation.new.length} new, ${reconciliation.persistent.length} persistent, ${reconciliation.resolved.length} resolved, ${reconciliation.suppressed.length} suppressed.`);
+    for (const f of active)
+        stats.findingsBySeverity[f.severity] += 1;
+    stats.suppressed = reconciliation.suppressed.length;
+    stats.persistent = reconciliation.persistent.length;
+    return {
+        findings: active,
+        summary: validated.summary,
+        dropped: [...validated.dropped, ...capped, ...duplicates, ...droppedCritique],
+        reconciliation,
+        findingsToPost: toPost,
+        files,
+        usedContext,
+        stats,
+    };
+}
+/**
+ * Collapse findings that share a fingerprint id — the same underlying issue
+ * reported more than once in a single LLM response (or across chunked calls
+ * for a file split isn't possible, but the model itself repeating a finding
+ * for the same file/category/title is common). Keeps the higher-confidence
+ * copy; first-seen position is preserved so downstream ordering is stable.
+ */
+export function dedupeById(findings) {
+    const byId = new Map();
+    const duplicates = [];
+    for (const f of findings) {
+        const id = f.id;
+        const prior = byId.get(id);
+        if (!prior) {
+            byId.set(id, f);
+        }
+        else if (f.confidence > prior.confidence) {
+            byId.set(id, f);
+            duplicates.push(prior);
+        }
+        else {
+            duplicates.push(f);
+        }
+    }
+    return { kept: [...byId.values()], duplicates };
+}
+/**
+ * Enforce per-file and total finding caps, dropping lowest-confidence first
+ * (severity breaks ties). Kept findings stay in validation order.
+ */
+export function capFindings(findings, limits) {
+    const value = (f) => f.confidence - severityRank(f.severity) / 100;
+    const capped = new Set();
+    const byFile = new Map();
+    for (const f of findings) {
+        if (!byFile.has(f.file))
+            byFile.set(f.file, []);
+        byFile.get(f.file).push(f);
+    }
+    for (const group of byFile.values()) {
+        if (group.length <= limits.max_findings_per_file)
+            continue;
+        [...group]
+            .sort((a, b) => value(a) - value(b))
+            .slice(0, group.length - limits.max_findings_per_file)
+            .forEach((f) => capped.add(f));
+    }
+    let kept = findings.filter((f) => !capped.has(f));
+    if (kept.length > limits.max_total) {
+        [...kept]
+            .sort((a, b) => value(a) - value(b))
+            .slice(0, kept.length - limits.max_total)
+            .forEach((f) => capped.add(f));
+        kept = findings.filter((f) => !capped.has(f));
+    }
+    return { kept, capped: findings.filter((f) => capped.has(f)) };
+}
+/** Inline exact source of the top-N related (non-changed) context files, truncated per file. */
+async function renderSnippets(cwd, entries, count) {
+    if (count <= 0)
+        return "";
+    const related = entries.filter((e) => e.relation !== "changed").slice(0, count);
+    const parts = [];
+    for (const e of related) {
+        try {
+            const src = await readFile(path.join(cwd, e.path), "utf8");
+            const maxChars = SNIPPET_TOKENS_PER_FILE * 4;
+            const body = src.length > maxChars ? `${src.slice(0, maxChars)}\n… (truncated)` : src;
+            parts.push(`## ${e.path} (full source, ${e.relation} of the change)\n\`\`\`\n${body}\n\`\`\``);
+        }
+        catch {
+            // file missing from the working tree (e.g. sparse checkout) — skip
+        }
+    }
+    return parts.join("\n\n");
+}
+function emptyReconciliation() {
+    return { new: [], persistent: [], resolved: [], suppressed: [] };
+}
+function chunkFiles(files) {
+    const chunks = [];
+    let current = [];
+    let tokens = 0;
+    for (const f of files) {
+        const cost = estimateTokens(JSON.stringify(f.hunks));
+        if (current.length > 0 && tokens + cost > DIFF_TOKENS_PER_CALL) {
+            chunks.push(current);
+            current = [];
+            tokens = 0;
+        }
+        current.push(f);
+        tokens += cost;
+    }
+    if (current.length)
+        chunks.push(current);
+    return chunks;
+}
+async function withRetry(fn, attempts = 3) {
+    let last;
+    for (let i = 0; i < attempts; i++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            last = err;
+            if (i < attempts - 1) {
+                await new Promise((r) => setTimeout(r, 500 * 2 ** i));
+            }
+        }
+    }
+    throw last;
+}
+//# sourceMappingURL=review.js.map

package/dist/review.js.map

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

package/dist/suppress-signals.d.ts

@@ -0,0 +1,7 @@
+export declare function isWontFixText(body: string): boolean;
+export declare function collectWontFixIds(items: Array<{
+    body: string;
+    isAgent?: boolean;
+    parentAgentId?: string | null;
+    reactionWontFix?: boolean;
+}>): Set<string>;

package/dist/suppress-signals.js

@@ -0,0 +1,19 @@
+import { parseFindingId } from "./finding-id.js";
+const WONT_FIX_RE = /\b(won't\s*fix|wont\s*fix|false\s*positive|not\s*a\s*bug)\b/i;
+export function isWontFixText(body) {
+    return WONT_FIX_RE.test(body);
+}
+export function collectWontFixIds(items) {
+    const out = new Set();
+    for (const item of items) {
+        const hit = item.reactionWontFix || isWontFixText(item.body);
+        if (!hit)
+            continue;
+        const id = item.parentAgentId ??
+            (item.isAgent ? parseFindingId(item.body) ?? undefined : undefined);
+        if (id)
+            out.add(id.toLowerCase());
+    }
+    return out;
+}
+//# sourceMappingURL=suppress-signals.js.map

package/dist/suppress-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppress-signals.js","sourceRoot":"","sources":["../src/suppress-signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,GAAG,8DAA8D,CAAC;AAEnF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAKE;IAEF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,EAAE,GACN,IAAI,CAAC,aAAa;YAClB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/suppressions.d.ts

@@ -0,0 +1,6 @@
+export declare const SUPPRESSIONS_FILENAME = ".pr-review-suppressions.yml";
+export interface Suppressions {
+    ids: Set<string>;
+}
+export declare function loadSuppressions(cwd: string, configPath?: string): Promise<Suppressions>;
+export declare function appendSuppressionIds(cwd: string, ids: Iterable<string>, filePath?: string): Promise<number>;

package/dist/suppressions.js

@@ -0,0 +1,48 @@
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { z } from "zod";
+export const SUPPRESSIONS_FILENAME = ".pr-review-suppressions.yml";
+const schema = z
+    .object({
+    ids: z.array(z.string()).optional(),
+})
+    .strict();
+export async function loadSuppressions(cwd, configPath) {
+    const file = configPath ?? path.join(cwd, SUPPRESSIONS_FILENAME);
+    if (!existsSync(file)) {
+        if (configPath)
+            throw new Error(`Suppressions file not found: ${configPath}`);
+        return { ids: new Set() };
+    }
+    const raw = YAML.parse(await readFile(file, "utf8")) ?? {};
+    const parsed = schema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid ${path.basename(file)}:\n${issues}`);
+    }
+    return { ids: new Set((parsed.data.ids ?? []).map((id) => id.toLowerCase())) };
+}
+export async function appendSuppressionIds(cwd, ids, filePath) {
+    const file = filePath ?? path.join(cwd, SUPPRESSIONS_FILENAME);
+    const existing = existsSync(file)
+        ? await loadSuppressions(cwd, filePath)
+        : { ids: new Set() };
+    let added = 0;
+    for (const raw of ids) {
+        const id = raw.toLowerCase();
+        if (!existing.ids.has(id)) {
+            existing.ids.add(id);
+            added++;
+        }
+    }
+    if (added === 0)
+        return 0;
+    const sorted = [...existing.ids].sort();
+    await writeFile(file, YAML.stringify({ ids: sorted }), "utf8");
+    return added;
+}
+//# sourceMappingURL=suppressions.js.map

package/dist/suppressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressions.js","sourceRoot":"","sources":["../src/suppressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAEnE,MAAM,MAAM,GAAG,CAAC;KACb,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAMZ,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,UAAmB;IAEnB,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,UAAU,EAAE,CAAC,CAAC;QAC9E,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAW,EACX,GAAqB,EACrB,QAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC;QACvC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrB,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+export type Severity = "critical" | "high" | "medium" | "low" | "info";
+export declare const SEVERITIES: Severity[];
+/** Lower index = more severe. */
+export declare function severityRank(s: Severity): number;
+export type Category = "bug" | "security" | "missing-tests" | "naming" | "complexity" | "custom";
+export declare const CATEGORIES: Category[];
+export interface Finding {
+    file: string;
+    /** New-file line numbers (side RIGHT of the diff). */
+    start_line: number;
+    end_line: number;
+    severity: Severity;
+    category: Category;
+    /** Model self-rated confidence, 0..1. */
+    confidence: number;
+    title: string;
+    /** Markdown explanation. */
+    body: string;
+    /** Optional replacement code for exactly the start_line..end_line range. */
+    suggestion?: string | null;
+    /** Stable fingerprint (file|category|normalized title). Set after validation. */
+    id?: string;
+}
+export interface Reconciliation {
+    new: string[];
+    persistent: string[];
+    resolved: string[];
+    suppressed: string[];
+}
+export interface Hunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    /** Raw hunk lines including the leading ' ', '+', '-' or '\' character. */
+    lines: string[];
+}
+export type FileStatus = "added" | "modified" | "deleted" | "renamed";
+export interface FileDiff {
+    /** New path (or old path for deletions). */
+    path: string;
+    oldPath?: string;
+    status: FileStatus;
+    hunks: Hunk[];
+    /** New-file line numbers that were added or modified — the commentable lines. */
+    changedLines: number[];
+}
+export interface ReviewConfig {
+    fail_on: Severity;
+    min_confidence: number;
+    ignore: string[];
+    context_token_budget: number;
+    /** Number of related files whose exact source is inlined into the prompt (0 disables). */
+    context_snippets: number;
+    custom_instructions: string;
+    categories: Record<Category, boolean>;
+    /** Sampling temperature; null = provider default (openai-compat: 0; anthropic: adaptive thinking). */
+    temperature: number | null;
+    limits: {
+        max_findings_per_file: number;
+        max_total: number;
+    };
+    /** Second drop-only LLM pass that removes findings the model would walk back. */
+    self_critique: boolean;
+    redact_secrets: boolean;
+    redact_patterns: string[];
+    write_suppressions: boolean;
+}
+export interface RunStats {
+    model: string;
+    llmCalls: number;
+    inputTokens: number;
+    outputTokens: number;
+    findingsBySeverity: Record<Severity, number>;
+    droppedValidation: number;
+    droppedCaps: number;
+    droppedDuplicates: number;
+    droppedCritique: number;
+    suppressed: number;
+    persistent: number;
+}
+export interface ReviewResult {
+    findings: Finding[];
+    /** Model's overall summary of the change. */
+    summary: string;
+    /** Findings the model produced that were dropped by post-validation. */
+    dropped: Finding[];
+    /** Lifecycle vs previous run / PR comments / suppressions. */
+    reconciliation?: Reconciliation;
+    /** Subset of findings that should be newly posted to the PR. */
+    findingsToPost?: Finding[];
+}

package/dist/types.js

@@ -0,0 +1,14 @@
+export const SEVERITIES = ["critical", "high", "medium", "low", "info"];
+/** Lower index = more severe. */
+export function severityRank(s) {
+    return SEVERITIES.indexOf(s);
+}
+export const CATEGORIES = [
+    "bug",
+    "security",
+    "missing-tests",
+    "naming",
+    "complexity",
+    "custom",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAEpF,iCAAiC;AACjC,MAAM,UAAU,YAAY,CAAC,CAAW;IACtC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAUD,MAAM,CAAC,MAAM,UAAU,GAAe;IACpC,KAAK;IACL,UAAU;IACV,eAAe;IACf,QAAQ;IACR,YAAY;IACZ,QAAQ;CACT,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "secondpair",
+  "version": "0.1.0",
+  "description": "LLM-powered pull request reviewer with whole-repo context from a persistent codengram codemap",
+  "type": "module",
+  "bin": {
+    "secondpair": "./dist/cli.js",
+    "pr-review": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "author": "rv-ranbir",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rv-ranbir/ai-tools.git",
+    "directory": "packages/secondpair"
+  },
+  "homepage": "https://github.com/rv-ranbir/ai-tools/tree/main/packages/secondpair#readme",
+  "bugs": "https://github.com/rv-ranbir/ai-tools/issues",
+  "keywords": [
+    "ai",
+    "llm",
+    "pr-review",
+    "code-review",
+    "github-actions",
+    "gitlab-ci",
+    "bitbucket",
+    "claude"
+  ],
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsx src/cli.ts"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@octokit/rest": "^21.0.0",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.0",
+    "codengram": "^0.1.0",
+    "yaml": "^2.5.0",
+    "zod": "^4.4.3"
+  }
+}