revu-ai 0.1.0

package/dist/refs.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedTarget, ReviewTarget } from "./types.js";
+export declare function findRepoRoot(cwd: string): string;
+export interface ResolveOptions {
+    base?: string;
+    workingTree: boolean;
+    staged: boolean;
+}
+export declare function resolveTarget(repoRoot: string, opts: ResolveOptions): ResolvedTarget;
+export declare function isReviewEmpty(target: ReviewTarget, repoRoot: string): boolean;

package/dist/refs.js

@@ -0,0 +1,81 @@
+import { execFileSync } from "node:child_process";
+export function findRepoRoot(cwd) {
+    return git(["rev-parse", "--show-toplevel"], cwd).trim();
+}
+export function resolveTarget(repoRoot, opts) {
+    if (opts.workingTree) {
+        return {
+            target: { mode: "working-tree" },
+            changedFiles: changedFilesFor({ mode: "working-tree" }, repoRoot),
+        };
+    }
+    if (opts.staged) {
+        return {
+            target: { mode: "staged" },
+            changedFiles: changedFilesFor({ mode: "staged" }, repoRoot),
+        };
+    }
+    const base = opts.base ?? autoDetectBase(repoRoot);
+    const target = { mode: "ref-range", base, head: "HEAD" };
+    return {
+        target,
+        baseSha: tryGit(["rev-parse", base], repoRoot),
+        headSha: tryGit(["rev-parse", "HEAD"], repoRoot),
+        changedFiles: changedFilesFor(target, repoRoot),
+    };
+}
+function autoDetectBase(repoRoot) {
+    for (const candidate of ["origin/main", "origin/master"]) {
+        if (tryGit(["rev-parse", "--verify", candidate], repoRoot)) {
+            return candidate;
+        }
+    }
+    const symref = tryGit(["symbolic-ref", "refs/remotes/origin/HEAD"], repoRoot);
+    if (symref) {
+        return symref.replace(/^refs\/remotes\//, "");
+    }
+    return "HEAD~1";
+}
+export function isReviewEmpty(target, repoRoot) {
+    try {
+        if (target.mode === "ref-range") {
+            git(["diff", "--quiet", `${target.base}...${target.head}`], repoRoot);
+        }
+        else if (target.mode === "working-tree") {
+            git(["diff", "--quiet", "HEAD"], repoRoot);
+        }
+        else {
+            git(["diff", "--quiet", "--staged"], repoRoot);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function changedFilesFor(target, repoRoot) {
+    let args;
+    if (target.mode === "ref-range") {
+        args = ["diff", "--name-only", `${target.base}...${target.head}`];
+    }
+    else if (target.mode === "working-tree") {
+        args = ["diff", "--name-only", "HEAD"];
+    }
+    else {
+        args = ["diff", "--name-only", "--staged"];
+    }
+    const out = tryGit(args, repoRoot) ?? "";
+    return out.split("\n").map((s) => s.trim()).filter(Boolean);
+}
+function git(args, cwd) {
+    return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+}
+function tryGit(args, cwd) {
+    try {
+        return git(args, cwd).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=refs.js.map

package/dist/refs.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,23 @@
+import type { Finding, RevuConfig, RunReport, RuleResult } from "./types.js";
+import type { ReviewActivity } from "./providers/types.js";
+export interface RunnerResult {
+    report: RunReport;
+    exitCode: number;
+}
+export declare class RevuExit extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode: number);
+}
+export interface RunHooks {
+    onRuleStart?: (ruleId: string, relPath: string) => void;
+    onRuleEnd?: (result: RuleResult) => void;
+    /** Fires whenever a rule agent uses a tool or emits text. */
+    onActivity?: (ruleId: string, activity: ReviewActivity) => void;
+    /** Fires for each finding the moment it's reported through the MCP sidecar. */
+    onFinding?: (finding: Finding) => void;
+}
+export declare function run(cwd: string, config: RevuConfig, hooks?: RunHooks): Promise<RunnerResult>;
+export declare function listRules(cwd: string, pattern: string): Promise<{
+    relPath: string;
+    ruleId: string;
+}[]>;

package/dist/runner.js

@@ -0,0 +1,106 @@
+import { randomUUID } from "node:crypto";
+import { findRepoRoot, resolveTarget, isReviewEmpty } from "./refs.js";
+import { discoverRules } from "./discovery.js";
+import { startSidecar } from "./mcp/server.js";
+import { getProviderFactory } from "./providers/registry.js";
+import { createLimiter } from "./concurrency.js";
+import { SEVERITY_ORDER } from "./types.js";
+export class RevuExit extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "RevuExit";
+    }
+}
+export async function run(cwd, config, hooks = {}) {
+    const startedAt = new Date().toISOString();
+    const runId = randomUUID();
+    const repoRoot = findRepoRoot(cwd);
+    const rules = await discoverRules(repoRoot, config.pattern);
+    if (rules.length === 0) {
+        throw new RevuExit(`No rule files found matching ${config.pattern}`, 0);
+    }
+    const resolved = resolveTarget(repoRoot, {
+        base: config.base,
+        workingTree: config.workingTree,
+        staged: config.staged,
+    });
+    if (!config.force && isReviewEmpty(resolved.target, repoRoot)) {
+        throw new RevuExit("No changes to review.", 0);
+    }
+    const sidecar = await startSidecar({ repoRoot });
+    const unsubscribeFindings = hooks.onFinding
+        ? sidecar.aggregator.onAdd(hooks.onFinding)
+        : () => { };
+    const factory = getProviderFactory(config.provider);
+    const provider = factory({ ...(config.model ? { model: config.model } : {}) });
+    const concurrency = config.concurrency ?? Math.min(8, rules.length);
+    const limit = createLimiter(concurrency);
+    const ruleResults = [];
+    try {
+        await Promise.all(rules.map((rule) => limit(async () => {
+            hooks.onRuleStart?.(rule.ruleId, rule.relPath);
+            const result = await provider.run({
+                ruleId: rule.ruleId,
+                rulesFilePath: rule.absPath,
+                rulesContent: rule.content,
+                reviewTarget: resolved.target,
+                repoRoot,
+                mcp: { url: sidecar.url, authToken: sidecar.authToken },
+                timeoutMs: config.timeoutMs,
+                ...(hooks.onActivity
+                    ? { onActivity: (a) => hooks.onActivity?.(rule.ruleId, a) }
+                    : {}),
+            });
+            const ruleResult = {
+                id: result.ruleId,
+                path: rule.relPath,
+                ok: result.ok,
+                durationMs: result.durationMs,
+                findingCount: sidecar.aggregator.countFor(result.ruleId),
+                ...(result.errorMessage ? { errorMessage: result.errorMessage } : {}),
+                ...(result.timedOut ? { timedOut: true } : {}),
+            };
+            ruleResults.push(ruleResult);
+            hooks.onRuleEnd?.(ruleResult);
+        })));
+    }
+    finally {
+        unsubscribeFindings();
+        await sidecar.shutdown();
+    }
+    const findings = sidecar.aggregator.all();
+    const report = {
+        schemaVersion: 1,
+        runId,
+        startedAt,
+        completedAt: new Date().toISOString(),
+        reviewTarget: { ...resolved, mode: resolved.target.mode },
+        rules: ruleResults.sort((a, b) => a.id.localeCompare(b.id)),
+        findings: findings.sort(findingSort),
+    };
+    const exitCode = computeExitCode(findings, ruleResults, config.failOn);
+    return { report, exitCode };
+}
+function computeExitCode(findings, rules, failOn) {
+    if (rules.some((r) => !r.ok))
+        return 2;
+    const threshold = SEVERITY_ORDER[failOn];
+    const triggered = findings.some((f) => SEVERITY_ORDER[f.severity] >= threshold);
+    return triggered ? 1 : 0;
+}
+function findingSort(a, b) {
+    const sevDiff = SEVERITY_ORDER[b.severity] - SEVERITY_ORDER[a.severity];
+    if (sevDiff !== 0)
+        return sevDiff;
+    if (a.path !== b.path)
+        return a.path.localeCompare(b.path);
+    return (a.line ?? 0) - (b.line ?? 0);
+}
+export async function listRules(cwd, pattern) {
+    const repoRoot = findRepoRoot(cwd);
+    const rules = await discoverRules(repoRoot, pattern);
+    return rules.map((r) => ({ relPath: r.relPath, ruleId: r.ruleId }));
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+export type Severity = "aesthetic" | "low" | "medium" | "high" | "critical";
+export declare const SEVERITY_ORDER: Record<Severity, number>;
+export interface RuleFile {
+    ruleId: string;
+    absPath: string;
+    relPath: string;
+    content: string;
+}
+export type ReviewTarget = {
+    mode: "ref-range";
+    base: string;
+    head: string;
+} | {
+    mode: "working-tree";
+} | {
+    mode: "staged";
+};
+export interface ResolvedTarget {
+    target: ReviewTarget;
+    baseSha?: string;
+    headSha?: string;
+    changedFiles: string[];
+}
+export interface Finding {
+    ruleId: string;
+    severity: Severity;
+    path: string;
+    line?: number;
+    lineEnd?: number;
+    message: string;
+    category?: string;
+}
+export interface RuleResult {
+    id: string;
+    path: string;
+    ok: boolean;
+    durationMs: number;
+    findingCount: number;
+    errorMessage?: string;
+    /** True if this rule was stopped by the per-rule timeout. */
+    timedOut?: boolean;
+}
+export interface RunReport {
+    schemaVersion: 1;
+    runId: string;
+    startedAt: string;
+    completedAt: string;
+    reviewTarget: ResolvedTarget & {
+        mode: ReviewTarget["mode"];
+    };
+    rules: RuleResult[];
+    findings: Finding[];
+}
+export interface RevuConfig {
+    pattern: string;
+    base?: string;
+    workingTree: boolean;
+    staged: boolean;
+    provider: string;
+    model?: string;
+    concurrency?: number;
+    output: "pretty" | "json" | "github" | "auto";
+    outputFile?: string;
+    failOn: Severity;
+    force: boolean;
+    /** Per-agent wall-clock timeout in ms. Default 300_000 (5 minutes). */
+    timeoutMs: number;
+}

package/dist/types.js

@@ -0,0 +1,8 @@
+export const SEVERITY_ORDER = {
+    aesthetic: 0,
+    low: 1,
+    medium: 2,
+    high: 3,
+    critical: 4,
+};
+//# 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,cAAc,GAA6B;IACtD,SAAS,EAAE,CAAC;IACZ,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;CACZ,CAAC"}

package/examples/github-workflow.yml

@@ -0,0 +1,38 @@
+# Drop this into `.github/workflows/revu.yml` in any repo where you want
+# revu to run on PRs. Findings render as PR annotations because the `github`
+# formatter emits workflow commands.
+#
+# You'll need to set ANTHROPIC_API_KEY (or your provider's equivalent) as
+# a repository secret. The workflow uses --base origin/$BASE_REF so revu
+# reviews the full PR.
+name: revu
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: write   # so annotations land on the PR
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # Need full history so origin/<base> is available for the diff.
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - run: npm install -g revu-ai
+
+      - name: Run revu
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          BASE_REF: ${{ github.event.pull_request.base.ref }}
+        run: |
+          git fetch origin "$BASE_REF":"refs/remotes/origin/$BASE_REF"
+          revu-ai --base "origin/$BASE_REF" --output github --fail-on high

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "revu-ai",
+  "version": "0.1.0",
+  "description": "Parallel AI code review with per-rule Claude agents",
+  "type": "module",
+  "bin": {
+    "revu-ai": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "pnpm run build",
+    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "code-review",
+    "ai",
+    "claude",
+    "anthropic",
+    "cli",
+    "git",
+    "diff",
+    "review",
+    "static-analysis",
+    "mcp",
+    "agent"
+  ],
+  "author": "PKWadsworth",
+  "license": "MIT",
+  "homepage": "https://github.com/PKWadsworth/revu#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PKWadsworth/revu.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PKWadsworth/revu/issues"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^12.1.0",
+    "fast-glob": "^3.3.2",
+    "ignore": "^5.3.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319"
+}