revu-ai 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+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 { ReviewAgent, ReviewAgentFactory, ReviewInput, ReviewResult } from "./providers/types.js";
+export { startSidecar } from "./mcp/server.js";
+export type { SidecarHandle } from "./mcp/server.js";
+export { FindingsAggregator } from "./mcp/aggregator.js";
+export { loadConfig, DEFAULT_CONFIG } from "./config.js";
+export type { Finding, Severity, RuleFile, ReviewTarget, ResolvedTarget, RuleResult, RunReport, RevuConfig, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { run, listRules, RevuExit } from "./runner.js";
+export { registerProvider, unregisterProvider, getProviderFactory, listProviders } from "./providers/registry.js";
+export { startSidecar } from "./mcp/server.js";
+export { FindingsAggregator } from "./mcp/aggregator.js";
+export { loadConfig, DEFAULT_CONFIG } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/init.d.ts

@@ -0,0 +1,26 @@
+import type { ReviewActivity } from "./providers/types.js";
+export interface InitOptions {
+    cwd: string;
+    /** Overwrite existing rule files. */
+    force: boolean;
+    provider: string;
+    model?: string;
+    timeoutMs: number;
+    onActivity?: (activity: ReviewActivity) => void;
+    onFileWritten?: (relPath: string) => void;
+    onStart?: (info: {
+        repoRoot: string;
+    }) => void;
+}
+export interface InitResult {
+    ok: boolean;
+    repoRoot: string;
+    filesWritten: string[];
+    durationMs: number;
+    errorMessage?: string;
+    timedOut?: boolean;
+}
+export declare class InitRefusedError extends Error {
+    constructor(message: string);
+}
+export declare function runInit(opts: InitOptions): Promise<InitResult>;

package/dist/init.js

@@ -0,0 +1,50 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { findRepoRoot } from "./refs.js";
+import { getScaffoldFactory } from "./providers/registry.js";
+export class InitRefusedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InitRefusedError";
+    }
+}
+export async function runInit(opts) {
+    const repoRoot = findRepoRoot(opts.cwd);
+    if (!opts.force) {
+        const existing = listExistingGlobalRules(repoRoot);
+        if (existing.length > 0) {
+            throw new InitRefusedError(`revu init: \`.revu/\` already contains rule files (${existing.join(", ")}). Pass --force to overwrite.`);
+        }
+    }
+    opts.onStart?.({ repoRoot });
+    const factory = getScaffoldFactory(opts.provider);
+    const agent = factory({ ...(opts.model ? { model: opts.model } : {}) });
+    const result = await agent.run({
+        repoRoot,
+        force: opts.force,
+        timeoutMs: opts.timeoutMs,
+        ...(opts.onActivity ? { onActivity: opts.onActivity } : {}),
+        ...(opts.onFileWritten ? { onFileWritten: opts.onFileWritten } : {}),
+    });
+    return {
+        ok: result.ok,
+        repoRoot,
+        filesWritten: result.filesWritten,
+        durationMs: result.durationMs,
+        ...(result.errorMessage ? { errorMessage: result.errorMessage } : {}),
+        ...(result.timedOut ? { timedOut: true } : {}),
+    };
+}
+/** Returns the *.revu.md filenames already present in `<repoRoot>/.revu/`, or []. */
+function listExistingGlobalRules(repoRoot) {
+    const dir = resolve(repoRoot, ".revu");
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir).filter((n) => n.endsWith(".revu.md")).map((n) => join(".revu", n));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/mcp/aggregator.d.ts

@@ -0,0 +1,11 @@
+import type { Finding, Severity } from "../types.js";
+export declare class FindingsAggregator {
+    private byRule;
+    private dedupKeys;
+    private listeners;
+    onAdd(listener: (f: Finding) => void): () => void;
+    add(finding: Finding): boolean;
+    countFor(ruleId: string): number;
+    all(): Finding[];
+    maxSeverity(): Severity | undefined;
+}

package/dist/mcp/aggregator.js

@@ -0,0 +1,47 @@
+export class FindingsAggregator {
+    byRule = new Map();
+    dedupKeys = new Set();
+    listeners = new Set();
+    onAdd(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    add(finding) {
+        const key = `${finding.ruleId}\0${finding.severity}\0${finding.path}\0${finding.line ?? ""}\0${finding.lineEnd ?? ""}\0${finding.message}`;
+        if (this.dedupKeys.has(key))
+            return false;
+        this.dedupKeys.add(key);
+        const list = this.byRule.get(finding.ruleId);
+        if (list)
+            list.push(finding);
+        else
+            this.byRule.set(finding.ruleId, [finding]);
+        for (const l of this.listeners) {
+            try {
+                l(finding);
+            }
+            catch { /* listener errors must not affect aggregation */ }
+        }
+        return true;
+    }
+    countFor(ruleId) {
+        return this.byRule.get(ruleId)?.length ?? 0;
+    }
+    all() {
+        const out = [];
+        for (const list of this.byRule.values())
+            out.push(...list);
+        return out;
+    }
+    maxSeverity() {
+        const order = ["aesthetic", "low", "medium", "high", "critical"];
+        let max = -1;
+        for (const f of this.all()) {
+            const idx = order.indexOf(f.severity);
+            if (idx > max)
+                max = idx;
+        }
+        return max < 0 ? undefined : order[max];
+    }
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/mcp/aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.js","sourceRoot":"","sources":["../../src/mcp/aggregator.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IACtC,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEpD,KAAK,CAAC,QAA8B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,OAAgB;QAClB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO,IAAI,EAAE,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3I,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAExB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;;YACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC;gBAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,iDAAiD,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,GAAG;QACD,MAAM,GAAG,GAAc,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,WAAW;QACT,MAAM,KAAK,GAAe,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC7E,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,GAAG,GAAG,GAAG;gBAAE,GAAG,GAAG,GAAG,CAAC;QAC3B,CAAC;QACD,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,14 @@
+import { FindingsAggregator } from "./aggregator.js";
+export interface SidecarHandle {
+    url: string;
+    authToken: string;
+    aggregator: FindingsAggregator;
+    shutdown: () => Promise<void>;
+}
+export interface StartSidecarOptions {
+    repoRoot: string;
+    host?: string;
+    /** If omitted, an ephemeral free port is chosen. */
+    port?: number;
+}
+export declare function startSidecar(opts: StartSidecarOptions): Promise<SidecarHandle>;

package/dist/mcp/server.js

@@ -0,0 +1,105 @@
+import { createServer } from "node:http";
+import { randomBytes } from "node:crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isAbsolute, relative } from "node:path";
+import { FindingsAggregator } from "./aggregator.js";
+import { ReportFindingShape, REPORT_FINDING_DESCRIPTION } from "./tools.js";
+export async function startSidecar(opts) {
+    const aggregator = new FindingsAggregator();
+    const authToken = randomBytes(24).toString("base64url");
+    const host = opts.host ?? "127.0.0.1";
+    const httpServer = createServer((req, res) => {
+        handle(req, res, { authToken, aggregator, repoRoot: opts.repoRoot }).catch((e) => {
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.end(`internal error: ${e.message}`);
+            }
+        });
+    });
+    await new Promise((resolve, reject) => {
+        httpServer.once("error", reject);
+        httpServer.listen(opts.port ?? 0, host, () => {
+            httpServer.off("error", reject);
+            resolve();
+        });
+    });
+    const addr = httpServer.address();
+    const url = `http://${host}:${addr.port}/mcp`;
+    const shutdown = () => new Promise((resolve, reject) => {
+        httpServer.close((err) => (err ? reject(err) : resolve()));
+    });
+    return { url, authToken, aggregator, shutdown };
+}
+async function handle(req, res, ctx) {
+    if (!req.url?.startsWith("/mcp")) {
+        res.statusCode = 404;
+        res.end("not found");
+        return;
+    }
+    const auth = req.headers["authorization"];
+    if (typeof auth !== "string" || auth !== `Bearer ${ctx.authToken}`) {
+        res.statusCode = 401;
+        res.end("unauthorized");
+        return;
+    }
+    const ruleIdHeader = req.headers["x-revu-rule-id"];
+    const ruleId = typeof ruleIdHeader === "string" && ruleIdHeader.length > 0 ? ruleIdHeader : "unknown";
+    const mcp = buildMcpServer(ruleId, ctx);
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+    res.on("close", () => {
+        void transport.close().catch(() => { });
+        void mcp.close().catch(() => { });
+    });
+    await mcp.connect(transport);
+    await transport.handleRequest(req, res);
+}
+function buildMcpServer(ruleId, ctx) {
+    const server = new McpServer({ name: "revu-sidecar", version: "0.0.1" });
+    server.registerTool("report_finding", {
+        description: REPORT_FINDING_DESCRIPTION,
+        inputSchema: ReportFindingShape,
+    }, async (args) => {
+        if (args.lineEnd !== undefined && args.line === undefined) {
+            return errorResult("`line` is required when `lineEnd` is set.");
+        }
+        if (args.lineEnd !== undefined && args.line !== undefined && args.lineEnd < args.line) {
+            return errorResult("`lineEnd` must be >= `line`.");
+        }
+        const finding = {
+            ruleId,
+            severity: args.severity,
+            path: normalizePath(args.path, ctx.repoRoot),
+            message: args.message,
+            ...(args.line !== undefined ? { line: args.line } : {}),
+            ...(args.lineEnd !== undefined ? { lineEnd: args.lineEnd } : {}),
+            ...(args.category !== undefined ? { category: args.category } : {}),
+        };
+        const accepted = ctx.aggregator.add(finding);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: accepted
+                        ? `Recorded ${finding.severity} finding for ${finding.path}.`
+                        : `Duplicate finding for ${finding.path}; ignored.`,
+                },
+            ],
+        };
+    });
+    return server;
+}
+function normalizePath(input, repoRoot) {
+    if (isAbsolute(input)) {
+        const rel = relative(repoRoot, input);
+        return rel.split("\\").join("/");
+    }
+    return input.split("\\").join("/");
+}
+function errorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwE,MAAM,WAAW,CAAC;AAC/G,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAA2B,MAAM,YAAY,CAAC;AAgBrG,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,MAAM,UAAU,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IAEtC,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YAC/E,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;gBACrB,GAAG,CAAC,GAAG,CAAC,mBAAoB,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;YAC3C,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAiB,CAAC;IACjD,MAAM,GAAG,GAAG,UAAU,IAAI,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC;IAE9C,MAAM,QAAQ,GAAG,GAAG,EAAE,CACpB,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAQD,KAAK,UAAU,MAAM,CAAC,GAAoB,EAAE,GAAmB,EAAE,GAAe;IAC9E,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,UAAU,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;QACnE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAEtG,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC,CAAC;IAEvF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACnB,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,GAAe;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzE,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,kBAAkB;KAChC,EACD,KAAK,EAAE,IAAwB,EAAE,EAAE;QACjC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1D,OAAO,WAAW,CAAC,2CAA2C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACtF,OAAO,WAAW,CAAC,8BAA8B,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAY;YACvB,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC;YAC5C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC;QACF,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ;wBACZ,CAAC,CAAC,YAAY,OAAO,CAAC,QAAQ,gBAAgB,OAAO,CAAC,IAAI,GAAG;wBAC7D,CAAC,CAAC,yBAAyB,OAAO,CAAC,IAAI,YAAY;iBACtD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,QAAgB;IACpD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const ReportFindingShape: {
+    readonly severity: z.ZodEnum<["aesthetic", "low", "medium", "high", "critical"]>;
+    readonly path: z.ZodString;
+    readonly line: z.ZodOptional<z.ZodNumber>;
+    readonly lineEnd: z.ZodOptional<z.ZodNumber>;
+    readonly message: z.ZodString;
+    readonly category: z.ZodOptional<z.ZodString>;
+};
+export declare const ReportFindingObject: z.ZodObject<{
+    readonly severity: z.ZodEnum<["aesthetic", "low", "medium", "high", "critical"]>;
+    readonly path: z.ZodString;
+    readonly line: z.ZodOptional<z.ZodNumber>;
+    readonly lineEnd: z.ZodOptional<z.ZodNumber>;
+    readonly message: z.ZodString;
+    readonly category: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    message: string;
+    severity: "aesthetic" | "low" | "medium" | "high" | "critical";
+    line?: number | undefined;
+    lineEnd?: number | undefined;
+    category?: string | undefined;
+}, {
+    path: string;
+    message: string;
+    severity: "aesthetic" | "low" | "medium" | "high" | "critical";
+    line?: number | undefined;
+    lineEnd?: number | undefined;
+    category?: string | undefined;
+}>;
+export type ReportFindingInput = z.infer<typeof ReportFindingObject>;
+export declare const REPORT_FINDING_DESCRIPTION = "Report a code-review finding to the revu runner.\nCall this tool once for each issue you find. The runner aggregates findings across all reviewers.\nSeverity guidance:\n  aesthetic = nit / style preference\n  low       = minor smell, easy to live with\n  medium    = should fix; not a bug yet but degrades the codebase\n  high      = clearly wrong; will cause bugs or regressions\n  critical  = will break production, security issue, or data loss\nDo NOT report findings outside the scope of your assigned rules.";

package/dist/mcp/tools.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export const ReportFindingShape = {
+    severity: z
+        .enum(["aesthetic", "low", "medium", "high", "critical"])
+        .describe("Severity of the finding."),
+    path: z.string().min(1).describe("Repo-relative file path, forward-slash separated."),
+    line: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("1-indexed line number where the issue starts."),
+    lineEnd: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("1-indexed line number where the issue ends. If set, line must also be set."),
+    message: z.string().min(1).describe("Human-readable description of the issue."),
+    category: z.string().optional().describe("Optional free-form category tag."),
+};
+export const ReportFindingObject = z.object(ReportFindingShape);
+export const REPORT_FINDING_DESCRIPTION = `Report a code-review finding to the revu runner.
+Call this tool once for each issue you find. The runner aggregates findings across all reviewers.
+Severity guidance:
+  aesthetic = nit / style preference
+  low       = minor smell, easy to live with
+  medium    = should fix; not a bug yet but degrades the codebase
+  high      = clearly wrong; will cause bugs or regressions
+  critical  = will break production, security issue, or data loss
+Do NOT report findings outside the scope of your assigned rules.`;
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;SACxD,QAAQ,CAAC,0BAA0B,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACrF,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IACzF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC/E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACpE,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAGhE,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;iEAQuB,CAAC"}

package/dist/output/github.d.ts

@@ -0,0 +1,2 @@
+import type { RunReport } from "../types.js";
+export declare function emitGithub(report: RunReport, outputFile?: string): void;

package/dist/output/github.js

@@ -0,0 +1,36 @@
+import { writeFileSync } from "node:fs";
+const SEV_COMMAND = {
+    aesthetic: "notice",
+    low: "notice",
+    medium: "warning",
+    high: "error",
+    critical: "error",
+};
+export function emitGithub(report, outputFile) {
+    const lines = [];
+    for (const f of report.findings) {
+        lines.push(formatLine(f));
+    }
+    const text = lines.length ? lines.join("\n") + "\n" : "";
+    process.stdout.write(text);
+    if (outputFile) {
+        writeFileSync(outputFile, text, "utf8");
+    }
+}
+function formatLine(f) {
+    const command = SEV_COMMAND[f.severity];
+    const params = [`file=${escape(f.path)}`];
+    if (f.line !== undefined)
+        params.push(`line=${f.line}`);
+    if (f.lineEnd !== undefined)
+        params.push(`endLine=${f.lineEnd}`);
+    params.push(`title=${escape(`revu / ${f.ruleId} (${f.severity})`)}`);
+    return `::${command} ${params.join(",")}::${escapeMessage(f.message)}`;
+}
+function escape(value) {
+    return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A").replace(/:/g, "%3A").replace(/,/g, "%2C");
+}
+function escapeMessage(value) {
+    return value.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
+}
+//# sourceMappingURL=github.js.map

package/dist/output/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/output/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,GAAqD;IACpE,SAAS,EAAE,QAAQ;IACnB,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,OAAO;CAClB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,UAAmB;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,UAAU,EAAE,CAAC;QACf,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAa,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1H,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChF,CAAC"}

package/dist/output/json.d.ts

@@ -0,0 +1,2 @@
+import type { RunReport } from "../types.js";
+export declare function emitJson(report: RunReport, outputFile?: string): void;

package/dist/output/json.js

@@ -0,0 +1,9 @@
+import { writeFileSync } from "node:fs";
+export function emitJson(report, outputFile) {
+    const text = JSON.stringify(report, null, 2);
+    process.stdout.write(text + "\n");
+    if (outputFile) {
+        writeFileSync(outputFile, text + "\n", "utf8");
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,UAAmB;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAClC,IAAI,UAAU,EAAE,CAAC;QACf,aAAa,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/output/pretty.d.ts

@@ -0,0 +1,2 @@
+import type { RunReport } from "../types.js";
+export declare function emitPretty(report: RunReport, outputFile?: string): void;

package/dist/output/pretty.js

@@ -0,0 +1,142 @@
+import { writeFileSync } from "node:fs";
+const COLOR_ENABLED = process.stdout.isTTY && !process.env.NO_COLOR;
+const c = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    green: "\x1b[32m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    gray: "\x1b[90m",
+};
+function paint(color, s) {
+    return COLOR_ENABLED ? `${c[color]}${s}${c.reset}` : s;
+}
+const SEV_COLOR = {
+    aesthetic: "gray",
+    low: "blue",
+    medium: "yellow",
+    high: "red",
+    critical: "magenta",
+};
+const SEV_LABEL = {
+    aesthetic: "nit ",
+    low: "low ",
+    medium: "med ",
+    high: "high",
+    critical: "CRIT",
+};
+export function emitPretty(report, outputFile) {
+    const lines = [];
+    lines.push(paint("bold", `revu ${report.runId.slice(0, 8)}`));
+    lines.push(paint("dim", `target: ${formatTarget(report)}  rules: ${report.rules.length}  findings: ${report.findings.length}`));
+    lines.push("");
+    const timedOut = report.rules.filter((r) => r.timedOut);
+    if (timedOut.length > 0) {
+        lines.push(paint("yellow", `⏱ ${timedOut.length} rule(s) timed out — results below are partial:`));
+        for (const r of timedOut) {
+            lines.push(paint("yellow", `  ${r.id} (${r.findingCount} partial finding(s), ${r.durationMs}ms)`));
+        }
+        lines.push("");
+    }
+    const systemic = detectSystemicFailure(report);
+    if (systemic) {
+        lines.push(paint("bold", paint("red", `✗ ${systemic.scope} agent(s) failed: ${systemic.message}`)));
+        const hint = hintFor(systemic.message);
+        if (hint)
+            lines.push(paint("yellow", `  → ${hint}`));
+        lines.push("");
+    }
+    if (report.findings.length === 0) {
+        lines.push(paint("green", "  no findings"));
+    }
+    else {
+        const byPath = new Map();
+        for (const f of report.findings) {
+            const list = byPath.get(f.path) ?? [];
+            list.push(f);
+            byPath.set(f.path, list);
+        }
+        for (const [path, findings] of byPath) {
+            lines.push(paint("bold", path));
+            for (const f of findings) {
+                const sev = paint(SEV_COLOR[f.severity], SEV_LABEL[f.severity]);
+                const loc = f.line !== undefined
+                    ? `:${f.line}${f.lineEnd && f.lineEnd !== f.line ? `-${f.lineEnd}` : ""}`
+                    : "";
+                const cat = f.category ? paint("dim", ` [${f.category}]`) : "";
+                const ruleTag = paint("dim", `(${f.ruleId})`);
+                lines.push(`  ${sev}  ${path}${loc}  ${ruleTag}${cat}`);
+                for (const ml of f.message.split("\n")) {
+                    lines.push(`        ${ml}`);
+                }
+            }
+            lines.push("");
+        }
+    }
+    const failed = report.rules.filter((r) => !r.ok);
+    if (failed.length > 0) {
+        lines.push(paint("red", `${failed.length} rule(s) errored:`));
+        for (const r of failed) {
+            lines.push(`  ${r.id}: ${r.errorMessage ?? "(unknown error)"}`);
+        }
+        lines.push("");
+    }
+    const text = lines.join("\n") + "\n";
+    process.stdout.write(text);
+    if (outputFile) {
+        // Strip ANSI codes for file output.
+        writeFileSync(outputFile, text.replace(/\x1b\[[0-9;]*m/g, ""), "utf8");
+    }
+}
+function detectSystemicFailure(report) {
+    // Timeouts are reported in their own banner above; don't double-count.
+    const failed = report.rules.filter((r) => !r.ok && !r.timedOut);
+    if (failed.length === 0)
+        return undefined;
+    const messages = new Set(failed.map((r) => r.errorMessage ?? "unknown"));
+    if (messages.size === 1 && failed.length === report.rules.length) {
+        return { scope: `All ${failed.length}`, message: [...messages][0] ?? "unknown" };
+    }
+    if (messages.size === 1 && failed.length > 1) {
+        return { scope: `${failed.length}/${report.rules.length}`, message: [...messages][0] ?? "unknown" };
+    }
+    return undefined;
+}
+function hintFor(message) {
+    const m = message.toLowerCase();
+    if (m.includes("credit balance") || m.includes("credit_balance")) {
+        return "Anthropic API account has no credits — top up at https://console.anthropic.com/settings/billing";
+    }
+    if (m.includes("invalid api key") || m.includes("authentication") || m.includes("401")) {
+        return "Check ANTHROPIC_API_KEY in your environment.";
+    }
+    if (m.includes("rate limit") || m.includes("429")) {
+        return "Rate-limited by the Anthropic API — try a lower --concurrency or a different model.";
+    }
+    if (m.includes("overloaded") || m.includes("529")) {
+        return "Anthropic API is overloaded; retry in a moment.";
+    }
+    if (m.includes("model") && (m.includes("not found") || m.includes("does not exist"))) {
+        return "Model identifier was rejected — pass --model with a valid id.";
+    }
+    return undefined;
+}
+function formatTarget(report) {
+    const t = report.reviewTarget;
+    if (t.mode === "ref-range") {
+        const target = t.target;
+        if (target.mode === "ref-range") {
+            return `${target.base}...${target.head} (${t.changedFiles.length} files)`;
+        }
+    }
+    if (t.mode === "working-tree")
+        return `working tree (${t.changedFiles.length} files)`;
+    if (t.mode === "staged")
+        return `staged (${t.changedFiles.length} files)`;
+    return t.mode;
+}
+//# sourceMappingURL=pretty.js.map

package/dist/output/pretty.js.map

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

package/dist/prompts/init-system.d.ts

@@ -0,0 +1,4 @@
+export interface InitSystemPromptInput {
+    force: boolean;
+}
+export declare function buildInitSystemPrompt(_input: InitSystemPromptInput): string;