revu-ai 0.1.2 → 0.2.0

package/dist/forges/github/index.js

@@ -0,0 +1,292 @@
+import { readFileSync } from "node:fs";
+import { SEVERITY_ORDER } from "../../types.js";
+import { buildActionPlan } from "../../cache/cross-reference.js";
+import { extractMarkers } from "../dedup.js";
+import { isInlineable, parseUnifiedDiff } from "../diff-lines.js";
+import { renderCommentBody, renderTopLevelBody } from "../render.js";
+import { GitHubClient } from "./api.js";
+export const githubForgeFactory = () => new GitHubForgeAdapter();
+export class GitHubForgeAdapter {
+    fetchImpl;
+    name = "github";
+    /** Allow tests to inject a custom `fetch`. */
+    constructor(fetchImpl) {
+        this.fetchImpl = fetchImpl;
+    }
+    async resolveContext(env, flags) {
+        const tokenEnv = flags.tokenEnv ?? "GITHUB_TOKEN";
+        const token = env[tokenEnv];
+        if (!token) {
+            throw new Error(`GitHub: no token in $${tokenEnv}. Set it (\`permissions: pull-requests: write\` exposes \$GITHUB_TOKEN in Actions).`);
+        }
+        const repoStr = flags.repo ?? env["GITHUB_REPOSITORY"];
+        if (!repoStr || !repoStr.includes("/")) {
+            throw new Error("GitHub: repo not found. Set $GITHUB_REPOSITORY (owner/name) or pass --repo owner/name.");
+        }
+        const [owner, name] = repoStr.split("/", 2);
+        const pr = resolvePrNumber(flags.pr, env);
+        if (pr === undefined) {
+            throw new Error("GitHub: PR number not found. Set $GITHUB_REF (refs/pull/<n>/...) or pass --pr <n>.");
+        }
+        let headSha = flags.commitSha ?? env["GITHUB_SHA"];
+        let baseSha;
+        if (!headSha) {
+            // Fall back to the PR's head SHA from the API.
+            const client = new GitHubClient(token, this.fetchImpl);
+            const pull = await client.getPullRequest(owner, name, pr);
+            headSha = pull.head.sha;
+            baseSha = pull.base.sha;
+        }
+        return {
+            repo: { owner, name },
+            pr,
+            headSha,
+            ...(baseSha ? { baseSha } : {}),
+            token,
+        };
+    }
+    async post(options) {
+        const { context, report, priorReport } = options;
+        const client = new GitHubClient(context.token, this.fetchImpl);
+        // Build the (priorReport, currentReport) → action plan.
+        const plan = buildActionPlan(priorReport, report);
+        // Compute event from the *new* posts (PR check stickiness story is documented in the README).
+        const ghEvent = computeEvent(plan.posts, options.requestChangesAtOrAbove);
+        const event = ghEventToAgnostic(ghEvent);
+        const totalFindings = plan.outputFindings.length;
+        // Short-circuit: nothing to do.
+        if (plan.posts.length === 0 && plan.patchesResolved.length === 0 && plan.patchesMoved.length === 0) {
+            const augmented = augmentReport(report, plan.outputFindings, plan.outputResolutions);
+            if (options.dryRun) {
+                process.stdout.write(`[dry-run] no PATCH or POST work to do (no plan changes)\n`);
+            }
+            return {
+                inline: { posted: 0, skipped: 0 },
+                body: { posted: 0, skipped: 1 },
+                patchesResolved: 0,
+                patchesMoved: 0,
+                totalFindings,
+                event,
+                augmentedReport: augmented,
+            };
+        }
+        // Fetch the PR diff so we know which lines are inline-postable.
+        const diff = !options.dryRun
+            ? await client.getPullRequestDiff(context.repo.owner, context.repo.name, context.pr)
+            : "";
+        const diffMap = parseUnifiedDiff(diff);
+        // Partition fresh posts into inline-eligible vs out-of-diff.
+        const inline = [];
+        const outOfDiff = [];
+        for (const f of plan.posts) {
+            if (f.line !== undefined && isInlineable(diffMap, f.path, f.line))
+                inline.push(f);
+            else
+                outOfDiff.push(f);
+        }
+        // Build the inline comments[] payload (single bundled review).
+        const comments = inline.map((f) => {
+            const line = f.line;
+            const lineEnd = f.lineEnd && f.lineEnd > line && isInlineable(diffMap, f.path, f.lineEnd) ? f.lineEnd : undefined;
+            return lineEnd
+                ? {
+                    path: f.path,
+                    line: lineEnd,
+                    side: "RIGHT",
+                    body: renderCommentBody(f),
+                    start_line: line,
+                    start_side: "RIGHT",
+                }
+                : {
+                    path: f.path,
+                    line,
+                    side: "RIGHT",
+                    body: renderCommentBody(f),
+                };
+        });
+        const totalNew = plan.posts.length;
+        const bodyText = renderTopLevelBody({
+            total: totalNew + plan.patchesResolved.length + plan.patchesMoved.length,
+            newCount: totalNew,
+            alreadyPosted: plan.patchesMoved.length,
+            outOfDiff: outOfDiff.length,
+        }, outOfDiff);
+        const reviewBody = {
+            commit_id: context.headSha,
+            event: ghEvent,
+            body: bodyText,
+            comments,
+        };
+        if (options.dryRun) {
+            printDryRun({
+                url: `https://api.github.com/repos/${context.repo.owner}/${context.repo.name}/pulls/${context.pr}/reviews`,
+                reviewBody,
+                plan: {
+                    patchesResolved: plan.patchesResolved.length,
+                    patchesMoved: plan.patchesMoved.length,
+                    posts: plan.posts.length,
+                    outOfDiff: outOfDiff.length,
+                },
+            });
+            const augmented = augmentReport(report, plan.outputFindings, plan.outputResolutions);
+            return {
+                inline: { posted: comments.length, skipped: 0 },
+                body: { posted: comments.length + outOfDiff.length > 0 ? 1 : 0, skipped: 0 },
+                patchesResolved: plan.patchesResolved.length,
+                patchesMoved: plan.patchesMoved.length,
+                totalFindings,
+                event,
+                augmentedReport: augmented,
+            };
+        }
+        // ---- Execute PATCHes (sequential; one failure does not abort the rest) ----
+        const shortSha = context.headSha.slice(0, 7);
+        const today = new Date().toISOString().slice(0, 10);
+        const patchFailures = [];
+        for (const p of plan.patchesResolved) {
+            const original = renderCommentBody(p.finding);
+            const wrappedBody = wrapResolved(original, shortSha, today, p.reason);
+            try {
+                await client.patchReviewComment(context.repo.owner, context.repo.name, Number(p.commentId), { body: wrappedBody });
+            }
+            catch (e) {
+                patchFailures.push({ commentId: p.commentId, kind: "resolved", error: e.message ?? String(e) });
+            }
+        }
+        for (const p of plan.patchesMoved) {
+            const newBody = renderCommentBody(p.finding);
+            try {
+                await client.patchReviewComment(context.repo.owner, context.repo.name, Number(p.commentId), { body: newBody });
+            }
+            catch (e) {
+                patchFailures.push({ commentId: p.commentId, kind: "moved", error: e.message ?? String(e) });
+            }
+        }
+        // ---- POST a bundled review for new findings (if any) ----
+        let reviewUrl;
+        const bodyPosted = inline.length > 0 || outOfDiff.length > 0;
+        if (bodyPosted) {
+            const created = await client.createReview(context.repo.owner, context.repo.name, context.pr, reviewBody);
+            reviewUrl = created.html_url;
+            // Match new comments to their freshly-allocated GitHub ids by fingerprint marker.
+            // If listing fails (network blip etc.), continue with un-populated commentIds —
+            // the augmentedReport must still be returned so the next run's --prior-report
+            // can dedup; missing commentIds will resolve themselves on the next post.
+            if (inline.length > 0) {
+                try {
+                    const created_comments = await client.listReviewCommentsForReview(context.repo.owner, context.repo.name, context.pr, created.id);
+                    const fpToId = new Map();
+                    for (const c of created_comments) {
+                        for (const fp of extractMarkers(c.body))
+                            fpToId.set(fp, c.id);
+                    }
+                    for (const f of plan.outputFindings) {
+                        if (f.commentId !== undefined)
+                            continue;
+                        const id = fpToId.get(f.fingerprint);
+                        if (id !== undefined)
+                            f.commentId = id;
+                    }
+                }
+                catch (e) {
+                    process.stderr.write(`revu-ai github post: warning — failed to backfill commentIds (${e.message ?? String(e)}). ` +
+                        `The augmented report will be written without ids; the next run will rediscover them.\n`);
+                }
+            }
+        }
+        if (patchFailures.length > 0) {
+            const summary = patchFailures
+                .slice(0, 5)
+                .map((f) => `  - ${f.kind} #${f.commentId}: ${f.error}`)
+                .join("\n");
+            const more = patchFailures.length > 5 ? `\n  …and ${patchFailures.length - 5} more` : "";
+            process.stderr.write(`revu-ai github post: warning — ${patchFailures.length} of ` +
+                `${plan.patchesResolved.length + plan.patchesMoved.length} PATCH call(s) failed:\n${summary}${more}\n` +
+                `The next run will retry via the prior-report dedup logic.\n`);
+        }
+        const augmented = augmentReport(report, plan.outputFindings, plan.outputResolutions);
+        return {
+            ...(reviewUrl ? { reviewUrl } : {}),
+            inline: { posted: inline.length, skipped: 0 },
+            body: { posted: bodyPosted ? 1 : 0, skipped: 0 },
+            patchesResolved: plan.patchesResolved.length - patchFailures.filter((f) => f.kind === "resolved").length,
+            patchesMoved: plan.patchesMoved.length - patchFailures.filter((f) => f.kind === "moved").length,
+            totalFindings,
+            event,
+            augmentedReport: augmented,
+        };
+    }
+}
+function augmentReport(report, outputFindings, outputResolutions) {
+    return {
+        ...report,
+        findings: outputFindings,
+        resolutions: outputResolutions,
+    };
+}
+/** Wrap a comment body with strikethrough + a footer noting the resolution. */
+function wrapResolved(originalBody, shortSha, isoDate, reason) {
+    const stripped = originalBody.replace(/<!--[\s\S]*?-->/g, "").trim();
+    const struck = stripped
+        .split("\n")
+        .map((line) => (line.length === 0 ? "" : `~~${line}~~`))
+        .join("\n");
+    const reasonText = reason === "stale" ? "no longer applicable" : "addressed by the new commits";
+    return `${struck}\n\n✅ **Marked resolved by revu-ai** at \`${shortSha}\` on ${isoDate} — ${reasonText}.`;
+}
+/** Compute the GitHub-native review event. */
+function computeEvent(findings, threshold) {
+    if (!threshold)
+        return "COMMENT";
+    const t = SEVERITY_ORDER[threshold];
+    return findings.some((f) => SEVERITY_ORDER[f.severity] >= t) ? "REQUEST_CHANGES" : "COMMENT";
+}
+function ghEventToAgnostic(e) {
+    switch (e) {
+        case "COMMENT":
+            return "comment";
+        case "REQUEST_CHANGES":
+            return "request-changes";
+        case "APPROVE":
+            return "approve";
+    }
+}
+/** Resolve the PR number from --pr / $GITHUB_REF / $GITHUB_EVENT_PATH (in that order). */
+function resolvePrNumber(prFlag, env) {
+    if (prFlag) {
+        const n = Number.parseInt(prFlag, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    const ref = env["GITHUB_REF"];
+    if (ref) {
+        const m = ref.match(/^refs\/pull\/(\d+)\//);
+        if (m && m[1])
+            return Number.parseInt(m[1], 10);
+    }
+    const eventPath = env["GITHUB_EVENT_PATH"];
+    if (eventPath) {
+        try {
+            const event = JSON.parse(readFileSync(eventPath, "utf8"));
+            if (typeof event.pull_request?.number === "number")
+                return event.pull_request.number;
+            if (typeof event.number === "number")
+                return event.number;
+        }
+        catch (e) {
+            // Corrupted/missing event file shouldn't kill the post step — caller
+            // can still pass `--pr` explicitly. But surface the cause so a bad CI
+            // env isn't silent.
+            process.stderr.write(`revu-ai github post: warning — failed to parse $GITHUB_EVENT_PATH (${eventPath}): ${e.message ?? String(e)}\n`);
+        }
+    }
+    return undefined;
+}
+function printDryRun(info) {
+    process.stdout.write(`[dry-run] plan: PATCHes-resolved=${info.plan.patchesResolved}, PATCHes-moved=${info.plan.patchesMoved}, POSTs=${info.plan.posts}, out-of-diff=${info.plan.outOfDiff}\n`);
+    if (info.plan.posts > 0 || info.plan.outOfDiff > 0) {
+        process.stdout.write(`[dry-run] POST ${info.url}\n`);
+        process.stdout.write(JSON.stringify(info.reviewBody, null, 2) + "\n");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/forges/github/index.js.map

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

package/dist/forges/gitlab/index.d.ts

@@ -0,0 +1,7 @@
+import type { ForgeAdapter, ForgeAdapterFactory, ForgeContext, PostOptions, PostResult, ResolveContextFlags } from "../types.js";
+export declare const gitlabForgeFactory: ForgeAdapterFactory;
+export declare class GitLabForgeAdapter implements ForgeAdapter {
+    readonly name = "gitlab";
+    resolveContext(_env: NodeJS.ProcessEnv, _flags: ResolveContextFlags): Promise<ForgeContext>;
+    post(_options: PostOptions): Promise<PostResult>;
+}

package/dist/forges/gitlab/index.js

@@ -0,0 +1,13 @@
+export const gitlabForgeFactory = () => new GitLabForgeAdapter();
+export class GitLabForgeAdapter {
+    name = "gitlab";
+    async resolveContext(_env, _flags) {
+        throw new Error("GitLab adapter is not yet implemented. The CLI grammar is reserved; the adapter is planned. " +
+            "Track progress in the project README under \"Forge integrations\".");
+    }
+    async post(_options) {
+        throw new Error("GitLab adapter is not yet implemented. The CLI grammar is reserved; the adapter is planned. " +
+            "Track progress in the project README under \"Forge integrations\".");
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/forges/gitlab/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/forges/gitlab/index.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kBAAkB,GAAwB,GAAG,EAAE,CAAC,IAAI,kBAAkB,EAAE,CAAC;AAEtF,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,QAAQ,CAAC;IAEzB,KAAK,CAAC,cAAc,CAClB,IAAuB,EACvB,MAA2B;QAE3B,MAAM,IAAI,KAAK,CACb,8FAA8F;YAC5F,oEAAoE,CACvE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAqB;QAC9B,MAAM,IAAI,KAAK,CACb,8FAA8F;YAC5F,oEAAoE,CACvE,CAAC;IACJ,CAAC;CACF"}

package/dist/forges/post-cmd.d.ts

@@ -0,0 +1,20 @@
+import type { PostResult, ResolveContextFlags } from "./types.js";
+import type { Severity } from "../types.js";
+export interface ForgePostOptions {
+    forge: string;
+    reportPath: string;
+    /** Optional path to a prior --output-file report. When present, the post step PATCHes
+     *  existing comments instead of always creating fresh ones. */
+    priorReportPath?: string;
+    /** Optional path to write the augmented report to (with commentIds populated, etc.).
+     *  This file is what next run feeds back as --prior-report. */
+    outputFile?: string;
+    flags: ResolveContextFlags;
+    requestChangesAtOrAbove?: Severity;
+    dryRun: boolean;
+    /** Optional injected env. Defaults to process.env. Useful in tests. */
+    env?: NodeJS.ProcessEnv;
+    /** Optional injected stdin reader for `--report -`. Useful in tests. */
+    readStdin?: () => Promise<string>;
+}
+export declare function runForgePost(options: ForgePostOptions): Promise<PostResult>;

package/dist/forges/post-cmd.js

@@ -0,0 +1,54 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { getForge } from "./registry.js";
+export async function runForgePost(options) {
+    const reportText = options.reportPath === "-"
+        ? await (options.readStdin ?? defaultReadStdin)()
+        : readFileSync(options.reportPath, "utf8");
+    const report = JSON.parse(reportText);
+    if (report.schemaVersion !== 2 && report.schemaVersion !== 1) {
+        throw new Error(`Unsupported report schemaVersion ${String(report.schemaVersion)}; expected 1 or 2.`);
+    }
+    let priorReport;
+    if (options.priorReportPath) {
+        try {
+            const priorText = readFileSync(options.priorReportPath, "utf8");
+            priorReport = JSON.parse(priorText);
+            if (priorReport.schemaVersion !== 2 && priorReport.schemaVersion !== 1) {
+                throw new Error(`Unsupported prior report schemaVersion ${String(priorReport.schemaVersion)}; expected 1 or 2.`);
+            }
+        }
+        catch (e) {
+            const code = e.code;
+            if (code !== "ENOENT")
+                throw e;
+            // Missing prior file is normal on the first run; just proceed without one.
+            priorReport = undefined;
+        }
+    }
+    const adapter = getForge(options.forge);
+    const env = options.env ?? process.env;
+    const context = await adapter.resolveContext(env, options.flags);
+    const result = await adapter.post({
+        report,
+        ...(priorReport ? { priorReport } : {}),
+        context,
+        ...(options.requestChangesAtOrAbove ? { requestChangesAtOrAbove: options.requestChangesAtOrAbove } : {}),
+        dryRun: options.dryRun,
+    });
+    if (options.outputFile) {
+        writeFileSync(options.outputFile, JSON.stringify(result.augmentedReport, null, 2) + "\n", "utf8");
+    }
+    return result;
+}
+function defaultReadStdin() {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", reject);
+    });
+}
+//# sourceMappingURL=post-cmd.js.map

package/dist/forges/post-cmd.js.map

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

package/dist/forges/registry.d.ts

@@ -0,0 +1,5 @@
+import type { ForgeAdapter, ForgeAdapterFactory } from "./types.js";
+export declare function registerForge(name: string, factory: ForgeAdapterFactory): void;
+export declare function unregisterForge(name: string): void;
+export declare function getForge(name: string): ForgeAdapter;
+export declare function listForges(): string[];

package/dist/forges/registry.js

@@ -0,0 +1,24 @@
+import { githubForgeFactory } from "./github/index.js";
+import { gitlabForgeFactory } from "./gitlab/index.js";
+const REGISTRY = new Map([
+    ["github", githubForgeFactory],
+    ["gitlab", gitlabForgeFactory],
+]);
+export function registerForge(name, factory) {
+    REGISTRY.set(name, factory);
+}
+export function unregisterForge(name) {
+    REGISTRY.delete(name);
+}
+export function getForge(name) {
+    const factory = REGISTRY.get(name);
+    if (!factory) {
+        const known = [...REGISTRY.keys()].join(", ");
+        throw new Error(`Unknown forge "${name}". Known: ${known}`);
+    }
+    return factory();
+}
+export function listForges() {
+    return [...REGISTRY.keys()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/forges/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/forges/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,QAAQ,GAAqC,IAAI,GAAG,CAAC;IACzD,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IAC9B,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAA4B;IACtE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/forges/render.d.ts

@@ -0,0 +1,18 @@
+import type { Finding } from "../types.js";
+/**
+ * Render a single finding as a Markdown comment body, with a hidden HTML
+ * marker appended for dedup on subsequent runs.
+ */
+export declare function renderCommentBody(finding: Finding): string;
+export interface SummaryStats {
+    total: number;
+    newCount: number;
+    alreadyPosted: number;
+    outOfDiff: number;
+}
+/**
+ * Render the top-level review body. Includes a one-line summary and, if any,
+ * a section listing findings that couldn't be posted inline because the line
+ * isn't in the PR diff.
+ */
+export declare function renderTopLevelBody(stats: SummaryStats, outOfDiff: Finding[]): string;

package/dist/forges/render.js

@@ -0,0 +1,59 @@
+import { fingerprint, withMarker } from "./dedup.js";
+// `Record<Severity, …>` makes `SEVERITIES` (in src/types.ts) the single source of
+// truth — adding a new severity there fails typecheck here until this map is
+// extended. Same pattern is reused for the cli's SEV_COLOR / SEV_LABEL maps.
+const SEV_BADGE = {
+    aesthetic: "⚪ aesthetic",
+    low: "🔵 low",
+    medium: "🟡 medium",
+    high: "🔴 high",
+    critical: "⛔ critical",
+};
+/**
+ * Render a single finding as a Markdown comment body, with a hidden HTML
+ * marker appended for dedup on subsequent runs.
+ */
+export function renderCommentBody(finding) {
+    const fp = fingerprint(finding);
+    const header = `**${SEV_BADGE[finding.severity]}** \`${finding.ruleId}\``;
+    const category = finding.category ? `  _${finding.category}_` : "";
+    const body = `${header}${category}\n\n${finding.message.trim()}`;
+    return withMarker(body, fp);
+}
+/**
+ * Render the top-level review body. Includes a one-line summary and, if any,
+ * a section listing findings that couldn't be posted inline because the line
+ * isn't in the PR diff.
+ */
+export function renderTopLevelBody(stats, outOfDiff) {
+    const sections = [];
+    sections.push(`**revu-ai** found ${stats.total} finding${stats.total === 1 ? "" : "s"} — ` +
+        `${stats.newCount} new, ${stats.alreadyPosted} already posted, ${stats.outOfDiff} outside the diff.`);
+    if (outOfDiff.length > 0) {
+        sections.push("### Findings outside the PR diff");
+        const byPath = groupByPath(outOfDiff);
+        for (const [path, findings] of byPath) {
+            sections.push(`- \`${path}\``);
+            for (const f of findings) {
+                const loc = f.line !== undefined ? `:${f.line}${f.lineEnd && f.lineEnd !== f.line ? `-${f.lineEnd}` : ""}` : "";
+                sections.push(`  - ${SEV_BADGE[f.severity]} \`${f.ruleId}\`${loc} — ${oneLine(f.message)}`);
+            }
+        }
+    }
+    return sections.join("\n\n");
+}
+function groupByPath(findings) {
+    const out = new Map();
+    for (const f of findings) {
+        const list = out.get(f.path);
+        if (list)
+            list.push(f);
+        else
+            out.set(f.path, [f]);
+    }
+    return out;
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=render.js.map

package/dist/forges/render.js.map

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

package/dist/forges/types.d.ts

@@ -0,0 +1,65 @@
+import type { RunReport, Severity } from "../types.js";
+export interface ForgeContext {
+    repo: {
+        owner: string;
+        name: string;
+    };
+    pr: number;
+    headSha: string;
+    baseSha?: string;
+    token: string;
+}
+export interface PostOptions {
+    report: RunReport;
+    /** Prior run's report (the one previously written to --output-file). When present,
+     *  the post step PATCHes existing comments instead of always creating fresh ones. */
+    priorReport?: RunReport;
+    context: ForgeContext;
+    /** If any finding's severity is at or above this threshold, the review is submitted as the forge's "request changes" event. */
+    requestChangesAtOrAbove?: Severity;
+    dryRun: boolean;
+}
+export interface PostResult {
+    /** URL of the review/MR comment created, when applicable. */
+    reviewUrl?: string;
+    inline: {
+        posted: number;
+        skipped: number;
+    };
+    /** Top-level body / summary comment. */
+    body: {
+        posted: number;
+        skipped: number;
+    };
+    /** PATCH counts split out so the CLI can show "n resolved, m moved". */
+    patchesResolved: number;
+    patchesMoved: number;
+    totalFindings: number;
+    /** Forge-agnostic event label. The forge adapter maps this to its native enum. */
+    event: "comment" | "request-changes" | "approve";
+    /** The current report augmented with newly-populated commentIds and the next-run cache
+     *  shape (outputFindings + outputResolutions baked into report.findings/resolutions).
+     *  The CLI writes this to --output-file. */
+    augmentedReport: RunReport;
+}
+export interface ExistingComment {
+    /** The fingerprint extracted from the hidden HTML marker, if present. */
+    fingerprint?: string;
+    /** Forge-native comment id, opaque to callers. */
+    externalId: string | number;
+}
+export interface ResolveContextFlags {
+    pr?: string;
+    repo?: string;
+    commitSha?: string;
+    tokenEnv?: string;
+}
+export interface ForgeAdapter {
+    readonly name: string;
+    /** Resolve `{ repo, pr, headSha, baseSha, token }` from environment + CLI flags. */
+    resolveContext(env: NodeJS.ProcessEnv, flags: ResolveContextFlags): Promise<ForgeContext>;
+    post(options: PostOptions): Promise<PostResult>;
+}
+export interface ForgeAdapterFactory {
+    (): ForgeAdapter;
+}

package/dist/forges/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/forges/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/forges/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { run, listRules, RevuExit } from "./runner.js";
-export type { RunnerResult, RunHooks } from "./runner.js";
-export { registerProvider, unregisterProvider, getProviderFactory, listProviders } from "./providers/registry.js";
+export type { RunnerResult, RunHooks, RunInputs } from "./runner.js";
+export { registerHarness, unregisterHarness, registerScaffoldHarness, unregisterScaffoldHarness, getHarnessFactory, getScaffoldHarness, listHarnesses, } from "./providers/registry.js";
 export type { ReviewAgent, ReviewAgentFactory, ReviewInput, ReviewResult } from "./providers/types.js";
 export { startSidecar } from "./mcp/server.js";
 export type { SidecarHandle } from "./mcp/server.js";

package/dist/index.js

@@ -1,5 +1,5 @@
 export { run, listRules, RevuExit } from "./runner.js";
-export { registerProvider, unregisterProvider, getProviderFactory, listProviders } from "./providers/registry.js";
+export { registerHarness, unregisterHarness, registerScaffoldHarness, unregisterScaffoldHarness, getHarnessFactory, getScaffoldHarness, listHarnesses, } from "./providers/registry.js";
 export { startSidecar } from "./mcp/server.js";
 export { FindingsAggregator } from "./mcp/aggregator.js";
 export { loadConfig, DEFAULT_CONFIG } from "./config.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAElH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}