@delegance/claude-autopilot 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [2.3.0] — 2026-04-22
+
+### Added
+- **Parallel chunk review** — file-level chunks are now reviewed concurrently (default parallelism: 3, configurable via `chunking.parallelism`); serial fallback preserved when `cost.budgetUSD` is set so budget enforcement remains accurate
+- **`.autopilot-ignore`** — project-level suppression file; format: `<rule-id> <glob>` or bare `<glob>` (matches any finding on that path); comments and blank lines ignored; suppressed count printed dim after run
+- **`--delta` mode** — only reports findings new since the previous run; pre-existing findings are hidden and the count is printed dim; findings always persisted to `.autopilot-cache/findings.json` after each run (gitignored)
+- `src/core/ignore/index.ts` — `loadIgnoreRules()`, `applyIgnoreRules()`
+- `src/core/persist/findings-cache.ts` — `loadCachedFindings()`, `saveCachedFindings()`, `filterNewFindings()`
+- 15 new tests — **248 total**
+
 ## [2.2.0] — 2026-04-22
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delegance/claude-autopilot",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "description": "Claude Code automation pipeline: spec → plan → implement → validate → PR",
   "keywords": [

package/src/cli/index.ts

@@ -67,6 +67,7 @@ Options (run):
   --files <a,b,c>      Explicit comma-separated file list (skips git detection)
   --dry-run            Show what would run without executing
   --diff               Send git diff hunks instead of full files (~70% fewer tokens)
+  --delta              Only report findings new since last run (suppress pre-existing)
   --post-comments      Post/update a summary comment on the open PR
   --format <text|sarif>  Output format (default: text)
   --output <path>        Output file path (required with --format sarif)
@@ -122,6 +123,7 @@ switch (subcommand) {
     const filesArg = flag('files');
     const dryRun = boolFlag('dry-run');
     const diff = boolFlag('diff');
+    const delta = boolFlag('delta');
     const postComments = boolFlag('post-comments');
     const formatArg = flag('format');
     const outputPath = flag('output');
@@ -141,6 +143,7 @@ switch (subcommand) {
       files: filesArg ? filesArg.split(',').map(f => f.trim()) : undefined,
       dryRun,
       diff,
+      delta,
       postComments,
       format: formatArg as 'text' | 'sarif' | undefined,
       outputPath,

package/src/cli/run.ts

@@ -38,6 +38,8 @@ import { detectProtectedPaths } from '../core/detect/protected-paths.ts';
 import { detectGitContext } from '../core/detect/git-context.ts';
 import { detectProject } from './detector.ts';
 import { detectPrNumber, formatComment, postPrComment } from './pr-comment.ts';
+import { loadIgnoreRules, applyIgnoreRules } from '../core/ignore/index.ts';
+import { loadCachedFindings, saveCachedFindings, filterNewFindings } from '../core/persist/findings-cache.ts';
 
 function readToolVersion(): string {
   const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), '../../package.json');
@@ -65,6 +67,7 @@ export interface RunCommandOptions {
   files?: string[];     // explicit file list (skips git detection)
   dryRun?: boolean;     // skip review, print what would run
   diff?: boolean;       // use diff strategy (send git hunks instead of full files)
+  delta?: boolean;      // only report findings not present in last run's baseline
   format?: 'text' | 'sarif';
   outputPath?: string;
   postComments?: boolean; // post/update summary comment on the open PR
@@ -187,6 +190,36 @@ export async function runCommand(options: RunCommandOptions = {}): Promise<numbe
   console.log('');
   const result = await runAutopilot(input);
 
+  // Apply .autopilot-ignore suppression rules
+  const ignoreRules = loadIgnoreRules(cwd);
+  if (ignoreRules.length > 0) {
+    const before = result.allFindings.length;
+    result.allFindings = applyIgnoreRules(result.allFindings, ignoreRules);
+    for (const phase of result.phases) {
+      phase.findings = applyIgnoreRules(phase.findings, ignoreRules);
+    }
+    const suppressed = before - result.allFindings.length;
+    if (suppressed > 0) {
+      console.log(fmt('dim', `  [run] ${suppressed} finding${suppressed !== 1 ? 's' : ''} suppressed by .autopilot-ignore`));
+    }
+  }
+
+  // Delta mode: filter to only new findings vs last run's baseline, then persist
+  if (options.delta) {
+    const cached = loadCachedFindings(cwd);
+    const before = result.allFindings.length;
+    result.allFindings = filterNewFindings(result.allFindings, cached);
+    for (const phase of result.phases) {
+      phase.findings = filterNewFindings(phase.findings, cached);
+    }
+    const existing = before - result.allFindings.length;
+    if (existing > 0) {
+      console.log(fmt('dim', `  [run] ${existing} pre-existing finding${existing !== 1 ? 's' : ''} hidden (--delta mode)`));
+    }
+  }
+  // Always persist the unfiltered findings as the new baseline
+  saveCachedFindings(cwd, result.allFindings);
+
   // emitAnnotations is a no-op unless GITHUB_ACTIONS=true
   emitAnnotations(result.allFindings);
 

package/src/core/ignore/index.ts

@@ -0,0 +1,42 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { minimatch } from 'minimatch';
+import type { Finding } from '../findings/types.ts';
+
+export interface IgnoreRule {
+  ruleId: string | '*';  // finding id prefix or '*' for any
+  pathGlob: string | null; // null = match all paths
+}
+
+export function loadIgnoreRules(cwd: string): IgnoreRule[] {
+  const filePath = path.join(cwd, '.autopilot-ignore');
+  if (!fs.existsSync(filePath)) return [];
+
+  const rules: IgnoreRule[] = [];
+  for (const raw of fs.readFileSync(filePath, 'utf8').split('\n')) {
+    const line = raw.trim();
+    if (!line || line.startsWith('#')) continue;
+
+    const parts = line.split(/\s+/);
+    if (parts.length === 1) {
+      // bare glob — suppress any finding whose file matches
+      rules.push({ ruleId: '*', pathGlob: parts[0]! });
+    } else {
+      // <rule-id-or-*> <path-glob>
+      rules.push({ ruleId: parts[0]!, pathGlob: parts[1]! });
+    }
+  }
+  return rules;
+}
+
+function matchesRule(finding: Finding, rule: IgnoreRule): boolean {
+  const ruleMatches = rule.ruleId === '*' || finding.id.startsWith(rule.ruleId);
+  if (!ruleMatches) return false;
+  if (rule.pathGlob === null) return true;
+  return minimatch(finding.file.replace(/\\/g, '/'), rule.pathGlob, { matchBase: true });
+}
+
+export function applyIgnoreRules(findings: Finding[], rules: IgnoreRule[]): Finding[] {
+  if (rules.length === 0) return findings;
+  return findings.filter(f => !rules.some(r => matchesRule(f, r)));
+}

package/src/core/persist/findings-cache.ts

@@ -0,0 +1,43 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import type { Finding } from '../findings/types.ts';
+
+const CACHE_DIR = '.autopilot-cache';
+const CACHE_FILE = 'findings.json';
+
+function cacheFilePath(cwd: string): string {
+  return path.join(cwd, CACHE_DIR, CACHE_FILE);
+}
+
+function findingKey(f: Finding): string {
+  return `${f.id}::${f.file}::${f.line ?? ''}`;
+}
+
+export function loadCachedFindings(cwd: string): Finding[] {
+  const p = cacheFilePath(cwd);
+  if (!fs.existsSync(p)) return [];
+  try {
+    return JSON.parse(fs.readFileSync(p, 'utf8')) as Finding[];
+  } catch {
+    return [];
+  }
+}
+
+export function saveCachedFindings(cwd: string, findings: Finding[]): void {
+  const dir = path.join(cwd, CACHE_DIR);
+  fs.mkdirSync(dir, { recursive: true });
+  // atomic write
+  const tmp = cacheFilePath(cwd) + '.tmp';
+  fs.writeFileSync(tmp, JSON.stringify(findings, null, 2), 'utf8');
+  fs.renameSync(tmp, cacheFilePath(cwd));
+}
+
+/**
+ * Returns only findings not present in the cached baseline.
+ * Two findings are considered the same when id + file + line all match.
+ */
+export function filterNewFindings(current: Finding[], cached: Finding[]): Finding[] {
+  if (cached.length === 0) return current;
+  const seen = new Set(cached.map(findingKey));
+  return current.filter(f => !seen.has(findingKey(f)));
+}

package/src/core/pipeline/review-phase.ts

@@ -1,7 +1,7 @@
 import type { ReviewEngine } from '../../adapters/review-engine/types.ts';
 import type { Finding } from '../findings/types.ts';
 import type { AutopilotConfig } from '../config/types.ts';
-import { buildReviewChunks } from '../chunking/index.ts';
+import { buildReviewChunks, type ReviewChunk } from '../chunking/index.ts';
 
 export interface ReviewPhaseResult {
   phase: 'review';
@@ -22,6 +22,48 @@ export interface ReviewPhaseInput {
   base?: string;
 }
 
+interface ChunkResult {
+  findings: Finding[];
+  inputTokens: number;
+  outputTokens: number;
+  costUSD: number;
+}
+
+async function reviewChunk(chunk: ReviewChunk, input: ReviewPhaseInput): Promise<ChunkResult> {
+  const output = await input.engine.review({
+    content: chunk.content,
+    kind: chunk.kind,
+    context: { stack: input.config.stack, cwd: input.cwd, gitSummary: input.gitSummary },
+  });
+  return {
+    findings: output.findings,
+    inputTokens: output.usage?.input ?? 0,
+    outputTokens: output.usage?.output ?? 0,
+    costUSD: output.usage?.costUSD ?? 0,
+  };
+}
+
+/** Run up to `limit` promises concurrently, preserving result order. */
+async function pMap<T, R>(
+  items: T[],
+  fn: (item: T, index: number) => Promise<R>,
+  limit: number,
+): Promise<R[]> {
+  const results: R[] = new Array(items.length);
+  let next = 0;
+
+  async function worker(): Promise<void> {
+    while (next < items.length) {
+      const i = next++;
+      results[i] = await fn(items[i]!, i);
+    }
+  }
+
+  const workers = Array.from({ length: Math.min(limit, items.length) }, () => worker());
+  await Promise.all(workers);
+  return results;
+}
+
 export async function runReviewPhase(input: ReviewPhaseInput): Promise<ReviewPhaseResult> {
   const start = Date.now();
 
@@ -39,41 +81,51 @@ export async function runReviewPhase(input: ReviewPhaseInput): Promise<ReviewPha
     base: input.base,
   });
 
-  const allFindings: Finding[] = [];
-  let totalInputTokens = 0;
-  let totalOutputTokens = 0;
-  let totalCostUSD = 0;
-  let budgetExceeded = false;
+  const parallelism = input.config.chunking?.parallelism ?? 3;
+  const budgetUSD = input.budgetRemainingUSD;
 
-  for (const chunk of chunks) {
-    if (input.budgetRemainingUSD !== undefined && totalCostUSD >= input.budgetRemainingUSD) {
-      budgetExceeded = true;
-      break;
+  // For budget tracking we still need to enforce it — run serially if budget set,
+  // parallel otherwise (budget check between serial chunks is the safe path).
+  let chunkResults: ChunkResult[];
+  if (budgetUSD !== undefined) {
+    chunkResults = [];
+    let spent = 0;
+    let budgetExceeded = false;
+    for (const chunk of chunks) {
+      if (spent >= budgetUSD) { budgetExceeded = true; break; }
+      const r = await reviewChunk(chunk, input);
+      spent += r.costUSD;
+      chunkResults.push(r);
     }
-    const output = await input.engine.review({
-      content: chunk.content,
-      kind: chunk.kind,
-      context: { stack: input.config.stack, cwd: input.cwd, gitSummary: input.gitSummary },
-    });
-    allFindings.push(...output.findings);
-    if (output.usage) {
-      totalInputTokens += output.usage.input;
-      totalOutputTokens += output.usage.output;
-      if (output.usage.costUSD !== undefined) totalCostUSD += output.usage.costUSD;
+    if (budgetExceeded) {
+      chunkResults.push({
+        findings: [{
+          id: 'budget-exceeded',
+          source: 'pipeline',
+          severity: 'warning',
+          category: 'budget',
+          file: '<pipeline>',
+          message: `Review budget of $${budgetUSD} USD exceeded — remaining chunks skipped`,
+          protectedPath: false,
+          createdAt: new Date().toISOString(),
+        }],
+        inputTokens: 0, outputTokens: 0, costUSD: 0,
+      });
     }
+  } else {
+    chunkResults = await pMap(chunks, chunk => reviewChunk(chunk, input), parallelism);
   }
 
-  if (budgetExceeded) {
-    allFindings.push({
-      id: 'budget-exceeded',
-      source: 'pipeline',
-      severity: 'warning',
-      category: 'budget',
-      file: '<pipeline>',
-      message: `Review budget of $${input.budgetRemainingUSD} USD exceeded — remaining chunks skipped`,
-      protectedPath: false,
-      createdAt: new Date().toISOString(),
-    });
+  let totalInputTokens = 0;
+  let totalOutputTokens = 0;
+  let totalCostUSD = 0;
+  const allFindings: Finding[] = [];
+
+  for (const r of chunkResults) {
+    allFindings.push(...r.findings);
+    totalInputTokens += r.inputTokens;
+    totalOutputTokens += r.outputTokens;
+    totalCostUSD += r.costUSD;
   }
 
   const hasCritical = allFindings.some(f => f.severity === 'critical');