@pratik7368patil/anchor-core 0.1.7 → 0.1.9

package/dist/index.js

@@ -252,8 +252,8 @@ function redactedHistoricalText(text) {
 }
 
 // src/db/database.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path4 from "path";
 import Database from "better-sqlite3";
 
 // src/db/migrations.ts
@@ -376,10 +376,70 @@ CREATE TABLE IF NOT EXISTS code_index_state (
   skipped_files INTEGER NOT NULL
 );
 
+CREATE TABLE IF NOT EXISTS test_files (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  repo_id INTEGER NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,
+  path TEXT NOT NULL,
+  language TEXT,
+  size_bytes INTEGER NOT NULL,
+  content_hash TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(repo_id, path)
+);
+
+CREATE TABLE IF NOT EXISTS test_links (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  repo_id INTEGER NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,
+  source_path TEXT NOT NULL,
+  test_path TEXT NOT NULL,
+  reason TEXT NOT NULL,
+  strength REAL NOT NULL,
+  UNIQUE(repo_id, source_path, test_path, reason)
+);
+
+CREATE TABLE IF NOT EXISTS regression_events (
+  id TEXT PRIMARY KEY,
+  repo_id INTEGER NOT NULL REFERENCES repositories(id) ON DELETE CASCADE,
+  pr_id INTEGER REFERENCES pull_requests(id) ON DELETE CASCADE,
+  repo TEXT NOT NULL,
+  pr_number INTEGER NOT NULL,
+  pr_url TEXT NOT NULL,
+  summary_sanitized TEXT NOT NULL,
+  file_paths_json TEXT NOT NULL,
+  symbols_json TEXT NOT NULL,
+  test_paths_json TEXT NOT NULL,
+  authors_json TEXT NOT NULL,
+  labels_json TEXT NOT NULL,
+  signals_json TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  merged_at TEXT,
+  confidence REAL NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS index_runs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  command TEXT NOT NULL,
+  repo TEXT,
+  started_at TEXT NOT NULL,
+  finished_at TEXT,
+  history_coverage TEXT,
+  history_limit INTEGER,
+  prs_fetched INTEGER,
+  prs_skipped INTEGER,
+  comments_indexed INTEGER,
+  code_files_indexed INTEGER,
+  test_files_indexed INTEGER,
+  failures_json TEXT NOT NULL DEFAULT '[]',
+  status TEXT NOT NULL
+);
+
 CREATE TABLE IF NOT EXISTS sync_state (
   repo TEXT PRIMARY KEY,
   last_sync_at TEXT,
   last_indexed_pr INTEGER,
+  history_coverage TEXT,
+  history_limit INTEGER,
+  history_since TEXT,
   updated_at TEXT NOT NULL
 );
 
@@ -390,14 +450,566 @@ CREATE INDEX IF NOT EXISTS idx_wisdom_units_category ON wisdom_units(category);
 CREATE INDEX IF NOT EXISTS idx_wisdom_units_pr ON wisdom_units(pr_id);
 CREATE INDEX IF NOT EXISTS idx_code_files_path ON code_files(path);
 CREATE INDEX IF NOT EXISTS idx_code_chunks_file_path ON code_chunks(file_path);
+CREATE INDEX IF NOT EXISTS idx_test_files_path ON test_files(path);
+CREATE INDEX IF NOT EXISTS idx_test_links_source ON test_links(source_path);
+CREATE INDEX IF NOT EXISTS idx_test_links_test ON test_links(test_path);
+CREATE INDEX IF NOT EXISTS idx_regression_events_pr ON regression_events(pr_id);
+CREATE INDEX IF NOT EXISTS idx_index_runs_started ON index_runs(started_at);
 `;
 
+// src/rules/team-rules.ts
+import fs2 from "fs";
+import path2 from "path";
+import { z } from "zod";
+
+// src/retrieval/evidence.ts
+function claimKeyFor(category, sanitizedText) {
+  return `${category}:${canonicalizeText(sanitizedText).slice(0, 180)}`;
+}
+function confidenceLevelFor(confidence) {
+  if (confidence >= 0.75) return "strong";
+  if (confidence >= 0.55) return "moderate";
+  return "weak";
+}
+function confidenceRank(level) {
+  const ranks = {
+    weak: 1,
+    moderate: 2,
+    strong: 3
+  };
+  return ranks[level];
+}
+function confidenceAtLeast(level, minimum) {
+  return confidenceRank(level) >= confidenceRank(minimum);
+}
+function evidenceForWisdom(unit) {
+  return {
+    prNumber: unit.prNumber,
+    prUrl: unit.prUrl,
+    sourceType: unit.sourceType,
+    author: unit.authors[0],
+    filePath: unit.filePaths[0]
+  };
+}
+function confidenceReasonsFor(unit, repeatedEvidenceCount) {
+  const reasons = [];
+  if (unit.sourceType === "review_comment" || unit.sourceType === "review_summary") {
+    reasons.push("reviewer evidence");
+  } else if (unit.sourceType === "pr_body") {
+    reasons.push("PR description evidence");
+  } else if (unit.sourceType === "commit_message") {
+    reasons.push("commit message evidence");
+  } else {
+    reasons.push(sourceTypeLabel(unit.sourceType));
+  }
+  if (unit.filePaths.length > 0) reasons.push("file-associated");
+  if (unit.symbols.length > 0) reasons.push("symbol-associated");
+  if (/\b(regression|this broke|broke|root cause)\b/i.test(unit.sanitizedText)) {
+    reasons.push("regression language");
+  }
+  if (/\b(do not|don't|must|should not|avoid|invariant|contract)\b/i.test(unit.sanitizedText)) {
+    reasons.push("constraint language");
+  }
+  if (repeatedEvidenceCount > 1) {
+    reasons.push(`repeated across ${repeatedEvidenceCount} PRs`);
+  }
+  return reasons;
+}
+function sourceTypeLabel(sourceType) {
+  return sourceType.replace(/_/g, " ");
+}
+function parseJsonArray(value) {
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function loadCurrentCodeSnapshot(db) {
+  const fileRows = db.prepare("SELECT path FROM code_files").all();
+  const chunkRows = db.prepare("SELECT file_path, symbols_json FROM code_chunks").all();
+  const filePaths = new Set(fileRows.map((row) => row.path));
+  const symbolsByFile = /* @__PURE__ */ new Map();
+  const allSymbols = /* @__PURE__ */ new Set();
+  for (const row of chunkRows) {
+    const symbols = parseJsonArray(row.symbols_json).map((symbol) => symbol.toLowerCase());
+    const fileSymbols = symbolsByFile.get(row.file_path) ?? /* @__PURE__ */ new Set();
+    for (const symbol of symbols) {
+      fileSymbols.add(symbol);
+      allSymbols.add(symbol);
+    }
+    symbolsByFile.set(row.file_path, fileSymbols);
+  }
+  return {
+    hasCodeIndex: fileRows.length > 0 || chunkRows.length > 0,
+    filePaths,
+    symbolsByFile,
+    allSymbols
+  };
+}
+function evaluateFreshness(subject, snapshot) {
+  if (!snapshot.hasCodeIndex) {
+    return {
+      status: "possibly_stale",
+      reason: "No current code index is available to verify this evidence."
+    };
+  }
+  const filePaths = subject.filePaths.filter(Boolean);
+  const symbols = subject.symbols.map((symbol) => symbol.toLowerCase()).filter(Boolean);
+  if (filePaths.length > 0) {
+    const existingFiles = filePaths.filter((filePath) => snapshot.filePaths.has(filePath));
+    if (existingFiles.length === 0) {
+      return {
+        status: "stale",
+        reason: "None of the historical file paths exist in the current code index."
+      };
+    }
+    if (symbols.length === 0) {
+      return {
+        status: "current",
+        reason: "At least one historical file path exists in the current code index."
+      };
+    }
+    for (const filePath of existingFiles) {
+      const fileSymbols = snapshot.symbolsByFile.get(filePath) ?? /* @__PURE__ */ new Set();
+      if (symbols.some((symbol) => fileSymbols.has(symbol))) {
+        return {
+          status: "current",
+          reason: "Historical file and symbol are present in the current code index."
+        };
+      }
+    }
+    if (symbols.some((symbol) => snapshot.allSymbols.has(symbol))) {
+      return {
+        status: "possibly_stale",
+        reason: "The historical file exists, but the referenced symbol appears elsewhere or moved."
+      };
+    }
+    return {
+      status: "possibly_stale",
+      reason: "The historical file exists, but referenced symbols were not found there."
+    };
+  }
+  if (symbols.length > 0 && symbols.some((symbol) => snapshot.allSymbols.has(symbol))) {
+    return {
+      status: "current",
+      reason: "Referenced symbol exists in the current code index."
+    };
+  }
+  return {
+    status: "possibly_stale",
+    reason: "Evidence has no exact current file path to verify."
+  };
+}
+
+// src/rules/team-rules.ts
+var TEAM_RULES_FILE = "anchor.rules.json";
+var SourceTypeSchema = z.enum([
+  "pr_body",
+  "review_comment",
+  "issue_comment",
+  "review_summary",
+  "commit_message",
+  "diff_context"
+]);
+var WisdomCategorySchema = z.enum([
+  "architecture_decision",
+  "constraint",
+  "rejected_approach",
+  "bug_regression",
+  "testing_rule",
+  "api_contract",
+  "performance_note",
+  "security_note",
+  "style_convention",
+  "unknown"
+]);
+var ConfidenceLevelSchema = z.enum(["strong", "moderate", "weak"]);
+var EvidenceRefSchema = z.object({
+  prNumber: z.number().int().positive(),
+  prUrl: z.string().url(),
+  sourceType: SourceTypeSchema,
+  author: z.string().min(1).optional(),
+  filePath: z.string().min(1).optional(),
+  note: z.string().min(1).max(500).optional()
+});
+var TeamRuleSchema = z.object({
+  id: z.string().min(1).max(120).regex(/^[a-z0-9][a-z0-9._-]*$/i),
+  category: WisdomCategorySchema,
+  text: z.string().min(1).max(1e3),
+  filePaths: z.array(z.string().min(1)).max(50).default([]),
+  symbols: z.array(z.string().min(1)).max(100).default([]),
+  evidence: z.array(EvidenceRefSchema).min(1),
+  confidenceLevel: ConfidenceLevelSchema.default("strong")
+});
+var TeamRulesFileSchema = z.object({
+  version: z.literal(1),
+  rules: z.array(TeamRuleSchema).default([])
+});
+function rulesPath(cwd) {
+  return path2.join(detectGitRoot(cwd) ?? cwd, TEAM_RULES_FILE);
+}
+function defaultRulesFile() {
+  return `${JSON.stringify({ version: 1, rules: [] }, null, 2)}
+`;
+}
+function ensureTeamRulesFile(cwd) {
+  const filePath = rulesPath(cwd);
+  if (fs2.existsSync(filePath)) return { path: filePath, created: false };
+  fs2.writeFileSync(filePath, defaultRulesFile());
+  return { path: filePath, created: true };
+}
+function sanitizeEvidence(evidence) {
+  return evidence.map((item) => ({
+    ...item,
+    note: item.note ? sanitizeHistoricalText(item.note) : void 0
+  }));
+}
+function loadTeamRulesFile(cwd) {
+  const filePath = rulesPath(cwd);
+  if (!fs2.existsSync(filePath)) {
+    return { ok: true, exists: false, path: filePath, errors: [], rules: [] };
+  }
+  let parsedJson;
+  try {
+    parsedJson = JSON.parse(fs2.readFileSync(filePath, "utf8"));
+  } catch (error) {
+    return {
+      ok: false,
+      exists: true,
+      path: filePath,
+      errors: [`Invalid JSON: ${error instanceof Error ? error.message : String(error)}`],
+      rules: []
+    };
+  }
+  const parsed = TeamRulesFileSchema.safeParse(parsedJson);
+  if (!parsed.success) {
+    return {
+      ok: false,
+      exists: true,
+      path: filePath,
+      errors: parsed.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`),
+      rules: []
+    };
+  }
+  const seenIds = /* @__PURE__ */ new Set();
+  const duplicateIds = parsed.data.rules.map((rule) => rule.id).filter((id) => {
+    if (seenIds.has(id)) return true;
+    seenIds.add(id);
+    return false;
+  });
+  if (duplicateIds.length > 0) {
+    return {
+      ok: false,
+      exists: true,
+      path: filePath,
+      errors: [`Duplicate rule ids: ${uniqueStrings(duplicateIds).join(", ")}`],
+      rules: []
+    };
+  }
+  const rules = parsed.data.rules.map((rule) => {
+    const sanitizedText = sanitizeHistoricalText(rule.text);
+    return {
+      id: rule.id,
+      category: rule.category,
+      text: sanitizedText,
+      sanitizedText,
+      filePaths: uniqueStrings(rule.filePaths),
+      symbols: uniqueStrings(rule.symbols),
+      evidence: sanitizeEvidence(rule.evidence),
+      confidenceLevel: rule.confidenceLevel
+    };
+  });
+  return { ok: true, exists: true, path: filePath, errors: [], rules };
+}
+function validateTeamRulesFile(cwd) {
+  const loaded = loadTeamRulesFile(cwd);
+  if (!loaded.exists) {
+    return {
+      ok: false,
+      path: loaded.path,
+      errors: [`${TEAM_RULES_FILE} does not exist. Run anchor rules init.`],
+      rules: []
+    };
+  }
+  return {
+    ok: loaded.ok,
+    path: loaded.path,
+    errors: loaded.errors,
+    rules: loaded.rules
+  };
+}
+function addTeamRule(cwd, input) {
+  ensureTeamRulesFile(cwd);
+  const filePath = rulesPath(cwd);
+  const raw = JSON.parse(fs2.readFileSync(filePath, "utf8"));
+  const nextRule = {
+    id: input.id,
+    category: input.category,
+    text: input.text,
+    filePaths: input.filePaths ?? [],
+    symbols: input.symbols ?? [],
+    evidence: [
+      {
+        prNumber: input.prNumber,
+        prUrl: input.prUrl,
+        sourceType: input.sourceType ?? "pr_body"
+      }
+    ],
+    confidenceLevel: "strong"
+  };
+  const next = { version: 1, rules: [...raw.rules ?? [], nextRule] };
+  fs2.writeFileSync(filePath, `${JSON.stringify(next, null, 2)}
+`);
+  const validation = validateTeamRulesFile(cwd);
+  if (!validation.ok) {
+    throw new Error(`Invalid Anchor rule: ${validation.errors.join("; ")}`);
+  }
+  const rule = validation.rules.find((item) => item.id === input.id);
+  if (!rule) throw new Error(`Failed to add Anchor rule ${input.id}`);
+  return { path: filePath, rule };
+}
+function checkTeamRuleEvidence(cwd) {
+  const validation = validateTeamRulesFile(cwd);
+  if (!validation.ok) {
+    return {
+      ok: false,
+      path: validation.path,
+      checked: 0,
+      missing: [],
+      errors: validation.errors
+    };
+  }
+  const databasePath = defaultDatabasePath(detectGitRoot(cwd) ?? cwd);
+  if (!fs2.existsSync(databasePath)) {
+    return {
+      ok: false,
+      path: validation.path,
+      checked: 0,
+      missing: [],
+      errors: [`Anchor database not found at ${databasePath}. Run anchor index first.`]
+    };
+  }
+  const db = openAnchorDatabase(detectGitRoot(cwd) ?? cwd, databasePath);
+  try {
+    initializeSchema(db);
+    const missing = [];
+    let checked = 0;
+    for (const rule of validation.rules) {
+      for (const evidence of rule.evidence) {
+        checked += 1;
+        const row = db.prepare("SELECT 1 FROM pull_requests WHERE number = ? LIMIT 1").get(evidence.prNumber);
+        if (!row) missing.push({ ruleId: rule.id, prNumber: evidence.prNumber });
+      }
+    }
+    return {
+      ok: missing.length === 0,
+      path: validation.path,
+      checked,
+      missing,
+      errors: []
+    };
+  } finally {
+    db.close();
+  }
+}
+function pathMatch(rulePaths, queryFiles) {
+  if (rulePaths.length === 0 || queryFiles.length === 0) return 0;
+  let best = 0;
+  for (const rulePath of rulePaths) {
+    const ruleBase = path2.basename(rulePath).toLowerCase();
+    const ruleDir = path2.dirname(rulePath).toLowerCase();
+    for (const queryFile of queryFiles) {
+      const queryBase = path2.basename(queryFile).toLowerCase();
+      const queryDir = path2.dirname(queryFile).toLowerCase();
+      if (rulePath.toLowerCase() === queryFile.toLowerCase()) best = Math.max(best, 1);
+      else if (ruleBase === queryBase) best = Math.max(best, 0.72);
+      else if (ruleDir === queryDir) best = Math.max(best, 0.6);
+      else if (ruleDir.startsWith(queryDir) || queryDir.startsWith(ruleDir)) {
+        best = Math.max(best, 0.35);
+      }
+    }
+  }
+  return best;
+}
+function symbolMatch(rule, querySymbols) {
+  if (rule.symbols.length === 0 || querySymbols.length === 0) return 0;
+  const ruleSymbols = rule.symbols.map((symbol) => symbol.toLowerCase());
+  let best = 0;
+  for (const symbol of querySymbols) {
+    const lower = symbol.toLowerCase();
+    if (ruleSymbols.includes(lower)) best = Math.max(best, 1);
+    else if (ruleSymbols.some((candidate) => candidate.includes(lower) || lower.includes(candidate))) {
+      best = Math.max(best, 0.45);
+    }
+  }
+  return best;
+}
+function textMatch(rule, input) {
+  const tokens = tokenizeSearchText(
+    `${input.task} ${input.diff ?? ""} ${input.currentCode ?? ""}`,
+    32
+  );
+  if (tokens.length === 0) return 0;
+  const haystack = `${rule.sanitizedText} ${rule.filePaths.join(" ")} ${rule.symbols.join(" ")}`.toLowerCase();
+  return tokens.filter((token) => haystack.includes(token.toLowerCase())).length / tokens.length;
+}
+function confidenceScore(level) {
+  if (level === "strong") return 1;
+  if (level === "moderate") return 0.7;
+  return 0.4;
+}
+function confidenceReasons(rule) {
+  const firstEvidence = rule.evidence[0];
+  return [
+    "team-approved rule",
+    firstEvidence ? `${sourceTypeLabel(firstEvidence.sourceType)} evidence` : "source evidence",
+    ...rule.filePaths.length > 0 ? ["file-associated"] : [],
+    ...rule.symbols.length > 0 ? ["symbol-associated"] : []
+  ];
+}
+function matchReasons(parts) {
+  const reasons = ["team-approved rule"];
+  if (parts.filePathMatch >= 0.9) reasons.push("exact file path match");
+  else if (parts.filePathMatch >= 0.45) reasons.push("related file path match");
+  if (parts.symbolMatch >= 0.9) reasons.push("exact symbol match");
+  else if (parts.symbolMatch >= 0.45) reasons.push("symbol-associated rule");
+  if (parts.textMatch >= 0.35) reasons.push("text matched task or diff terms");
+  return reasons.slice(0, 5);
+}
+function passesStrictMode(rule, input) {
+  if (!input.strict) return true;
+  if (rule.freshnessStatus === "stale") return false;
+  return confidenceAtLeast(rule.confidenceLevel, input.minConfidence ?? "strong");
+}
+function rankTeamRules(db, cwd, input) {
+  const loaded = loadTeamRulesFile(cwd);
+  if (!loaded.ok || loaded.rules.length === 0) return [];
+  const codeSnapshot = loadCurrentCodeSnapshot(db);
+  return loaded.rules.map((rule) => {
+    const freshness = evaluateFreshness(rule, codeSnapshot);
+    const parts = {
+      filePathMatch: pathMatch(rule.filePaths, input.files ?? []),
+      symbolMatch: symbolMatch(rule, input.symbols ?? []),
+      textMatch: textMatch(rule, input),
+      confidence: confidenceScore(rule.confidenceLevel)
+    };
+    const score = 1 + 0.35 * parts.filePathMatch + 0.25 * parts.symbolMatch + 0.25 * parts.textMatch + 0.15 * parts.confidence;
+    return {
+      ...rule,
+      score: Number(score.toFixed(4)),
+      freshnessStatus: freshness.status,
+      freshnessReason: freshness.reason,
+      confidenceReasons: confidenceReasons(rule),
+      matchReasons: matchReasons(parts),
+      rankSignals: parts
+    };
+  }).filter((rule) => passesStrictMode(rule, input)).sort((a, b) => b.score - a.score).slice(0, 4);
+}
+function countValidTeamRules(cwd) {
+  const loaded = loadTeamRulesFile(cwd);
+  if (!loaded.exists || !loaded.ok) return { count: 0 };
+  const stat = fs2.statSync(loaded.path);
+  return { count: loaded.rules.length, lastRuleIndexTime: stat.mtime.toISOString() };
+}
+
+// src/indexer/test-awareness.ts
+import path3 from "path";
+function normalizePath(filePath) {
+  return filePath.replace(/\\/g, "/").replace(/^\.\/+/, "");
+}
+function pathSegments(filePath) {
+  return normalizePath(filePath).split("/").filter(Boolean);
+}
+function basenameWithoutExtensions(filePath) {
+  const base = path3.posix.basename(normalizePath(filePath));
+  return base.replace(/\.(test|spec)\.[^.]+$/i, "").replace(/\.[^.]+$/i, "");
+}
+function sourceLikeDir(filePath) {
+  const segments = pathSegments(path3.posix.dirname(normalizePath(filePath)));
+  return segments.filter((segment) => !["__tests__", "test", "tests", "spec"].includes(segment));
+}
+function isTestFilePath(filePath) {
+  const normalized = normalizePath(filePath);
+  const segments = pathSegments(normalized).map((segment) => segment.toLowerCase());
+  const base = path3.posix.basename(normalized).toLowerCase();
+  return /\.(test|spec)\.[^.]+$/i.test(base) || segments.includes("__tests__") || segments.includes("test") || segments.includes("tests") || segments.includes("spec");
+}
+function testRecord(file) {
+  return {
+    repo: file.repo,
+    path: file.path,
+    language: file.language,
+    sizeBytes: file.sizeBytes,
+    contentHash: file.contentHash,
+    updatedAt: file.updatedAt
+  };
+}
+function strengthFor(reason) {
+  if (reason === "same basename") return 1;
+  if (reason === "imported source path") return 0.9;
+  if (reason === "same directory") return 0.7;
+  return 0.5;
+}
+function pathMentionedInTest(testPath, sourcePath, chunksByFile) {
+  const text = (chunksByFile.get(testPath) ?? []).map((chunk) => chunk.sanitizedText).join("\n");
+  if (!text) return false;
+  const sourceNoExt = sourcePath.replace(/\.[^.]+$/i, "");
+  const sourceBase = basenameWithoutExtensions(sourcePath);
+  return text.includes(sourcePath) || text.includes(sourceNoExt) || new RegExp(`from\\s+["'][^"']*${escapeRegExp(sourceBase)}["']`, "i").test(text) || new RegExp(`require\\(["'][^"']*${escapeRegExp(sourceBase)}["']\\)`, "i").test(text);
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function inferTestAwareness(repo, codeFiles, codeChunks) {
+  const testFiles = codeFiles.filter((file) => isTestFilePath(file.path));
+  const sourceFiles = codeFiles.filter((file) => !isTestFilePath(file.path));
+  const chunksByFile = /* @__PURE__ */ new Map();
+  for (const chunk of codeChunks) {
+    const chunks = chunksByFile.get(chunk.filePath) ?? [];
+    chunks.push(chunk);
+    chunksByFile.set(chunk.filePath, chunks);
+  }
+  const linkMap = /* @__PURE__ */ new Map();
+  const addLink = (sourcePath, testPath, reason) => {
+    const key = `${sourcePath}\0${testPath}\0${reason}`;
+    linkMap.set(key, {
+      repo,
+      sourcePath,
+      testPath,
+      reason,
+      strength: strengthFor(reason)
+    });
+  };
+  for (const test of testFiles) {
+    const testBase = basenameWithoutExtensions(test.path).toLowerCase();
+    const testDir = sourceLikeDir(test.path).join("/");
+    for (const source of sourceFiles) {
+      const sourceBase = basenameWithoutExtensions(source.path).toLowerCase();
+      const sourceDir = sourceLikeDir(source.path).join("/");
+      if (testBase === sourceBase) addLink(source.path, test.path, "same basename");
+      else if (testDir && sourceDir && testDir === sourceDir) {
+        addLink(source.path, test.path, "same directory");
+      }
+      if (pathMentionedInTest(test.path, source.path, chunksByFile)) {
+        addLink(source.path, test.path, "imported source path");
+      }
+    }
+  }
+  const dedupedTests = testFiles.map(testRecord);
+  return {
+    testFiles: dedupedTests,
+    testLinks: uniqueStrings([...linkMap.keys()]).map((key) => linkMap.get(key))
+  };
+}
+
 // src/db/database.ts
 function defaultDatabasePath(cwd) {
-  return path2.join(cwd, ".anchor", "index.sqlite");
+  return path4.join(cwd, ".anchor", "index.sqlite");
 }
 function openAnchorDatabase(cwd, databasePath = defaultDatabasePath(cwd)) {
-  fs2.mkdirSync(path2.dirname(databasePath), { recursive: true });
+  fs3.mkdirSync(path4.dirname(databasePath), { recursive: true });
   const db = new Database(databasePath);
   db.pragma("journal_mode = WAL");
   db.pragma("foreign_keys = ON");
@@ -405,6 +1017,15 @@ function openAnchorDatabase(cwd, databasePath = defaultDatabasePath(cwd)) {
 }
 function initializeSchema(db) {
   db.exec(SCHEMA_SQL);
+  ensureColumn(db, "sync_state", "history_coverage", "TEXT");
+  ensureColumn(db, "sync_state", "history_limit", "INTEGER");
+  ensureColumn(db, "sync_state", "history_since", "TEXT");
+}
+function ensureColumn(db, tableName, columnName, definition) {
+  const columns = db.prepare(`PRAGMA table_info(${tableName})`).all();
+  if (!columns.some((column) => column.name === columnName)) {
+    db.exec(`ALTER TABLE ${tableName} ADD COLUMN ${columnName} ${definition}`);
+  }
 }
 function checkSchema(db) {
   try {
@@ -412,7 +1033,9 @@ function checkSchema(db) {
     const codeTables = db.prepare("SELECT name FROM sqlite_master WHERE type IN ('table', 'virtual') AND name = ?").all("code_chunks_fts");
     const wisdom = db.prepare("SELECT name FROM sqlite_master WHERE name = ?").all("wisdom_units");
     const code = db.prepare("SELECT name FROM sqlite_master WHERE name = ?").all("code_chunks");
-    return tables.length > 0 && wisdom.length > 0 && codeTables.length > 0 && code.length > 0;
+    const tests = db.prepare("SELECT name FROM sqlite_master WHERE name = ?").all("test_files");
+    const regressions = db.prepare("SELECT name FROM sqlite_master WHERE name = ?").all("regression_events");
+    return tables.length > 0 && wisdom.length > 0 && codeTables.length > 0 && code.length > 0 && tests.length > 0 && regressions.length > 0;
   } catch {
     return false;
   }
@@ -432,29 +1055,42 @@ function getLastSyncTime(db, repo) {
   const row = db.prepare("SELECT last_sync_at FROM sync_state WHERE repo = ?").get(repo);
   return row?.last_sync_at ?? void 0;
 }
-function updateSyncState(db, repo, lastIndexedPr) {
+function updateSyncState(db, repo, lastIndexedPr, metadata = {}) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   db.prepare(
-    `INSERT INTO sync_state (repo, last_sync_at, last_indexed_pr, updated_at)
-     VALUES (?, ?, ?, ?)
+    `INSERT INTO sync_state
+     (repo, last_sync_at, last_indexed_pr, history_coverage, history_limit, history_since, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)
      ON CONFLICT(repo) DO UPDATE SET
        last_sync_at = excluded.last_sync_at,
        last_indexed_pr = excluded.last_indexed_pr,
+       history_coverage = excluded.history_coverage,
+       history_limit = excluded.history_limit,
+       history_since = excluded.history_since,
        updated_at = excluded.updated_at`
-  ).run(repo, now, lastIndexedPr ?? null, now);
+  ).run(
+    repo,
+    now,
+    lastIndexedPr ?? null,
+    metadata.historyCoverage ?? "unknown",
+    metadata.historyLimit ?? null,
+    metadata.historySince ?? null,
+    now
+  );
 }
 function deleteExistingPrData(db, prId) {
   const unitRows = db.prepare("SELECT id FROM wisdom_units WHERE pr_id = ?").all(prId);
   const deleteFts = db.prepare("DELETE FROM wisdom_units_fts WHERE unitId = ?");
   for (const row of unitRows) deleteFts.run(row.id);
+  db.prepare("DELETE FROM regression_events WHERE pr_id = ?").run(prId);
   db.prepare("DELETE FROM wisdom_units WHERE pr_id = ?").run(prId);
   db.prepare("DELETE FROM pr_comments WHERE pr_id = ?").run(prId);
   db.prepare("DELETE FROM pr_files WHERE pr_id = ?").run(prId);
 }
-function upsertPullRequest(db, pr, wisdomUnits) {
+function upsertPullRequest(db, pr, wisdomUnits, regressionEvents = []) {
   const repoId = ensureRepository(db, pr.repo);
   const author = pr.user?.login ?? "unknown";
-  const labels = (pr.labels ?? []).map((label) => typeof label === "string" ? label : label.name).filter(Boolean);
+  const labels2 = (pr.labels ?? []).map((label) => typeof label === "string" ? label : label.name).filter(Boolean);
   const titleText = redactedHistoricalText(pr.title);
   const bodyText = redactedHistoricalText(pr.body ?? "");
   const bodySanitized = sanitizeHistoricalText(pr.body ?? "");
@@ -481,7 +1117,7 @@ function upsertPullRequest(db, pr, wisdomUnits) {
       bodyText,
       bodySanitized,
       author,
-      JSON.stringify(labels),
+      JSON.stringify(labels2),
       pr.created_at,
       pr.merged_at ?? null,
       pr.updated_at ?? null
@@ -501,6 +1137,7 @@ function upsertPullRequest(db, pr, wisdomUnits) {
         file.patch ? sanitizeHistoricalText(file.patch) : null
       );
     }
+    insertPrCochangeTestLinks(db, repoId, pr.files.map((file) => file.filename));
     const insertComment = db.prepare(
       `INSERT INTO pr_comments
        (pr_id, source_type, author, body_text, sanitized_text, file_path, created_at, is_reviewer)
@@ -584,21 +1221,56 @@ function upsertPullRequest(db, pr, wisdomUnits) {
         unit.category
       );
     }
+    const insertRegression = db.prepare(
+      `INSERT INTO regression_events
+       (id, repo_id, pr_id, repo, pr_number, pr_url, summary_sanitized, file_paths_json,
+        symbols_json, test_paths_json, authors_json, labels_json, signals_json, created_at,
+        merged_at, confidence)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+    );
+    for (const event of regressionEvents) {
+      insertRegression.run(
+        event.id,
+        repoId,
+        prRow.id,
+        event.repo,
+        event.prNumber,
+        event.prUrl,
+        event.summary,
+        JSON.stringify(event.filePaths),
+        JSON.stringify(event.symbols),
+        JSON.stringify(event.testPaths),
+        JSON.stringify(event.authors),
+        JSON.stringify(event.labels),
+        JSON.stringify(event.signals),
+        event.createdAt,
+        event.mergedAt ?? null,
+        event.confidence
+      );
+    }
   });
   transaction();
   const comments = (pr.reviews?.length ?? 0) + (pr.reviewComments?.length ?? 0) + (pr.issueComments?.length ?? 0);
-  return { files: pr.files.length, comments, wisdom: wisdomUnits.length };
+  return {
+    files: pr.files.length,
+    comments,
+    wisdom: wisdomUnits.length,
+    regressions: regressionEvents.length
+  };
 }
 function replaceCodeIndex(db, repo, codeFiles, codeChunks, skippedFiles, cwd) {
   initializeSchema(db);
   const repoId = ensureRepository(db, repo);
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  const testAwareness = inferTestAwareness(repo, codeFiles, codeChunks);
   const transaction = db.transaction(() => {
     const existingChunks = db.prepare("SELECT id FROM code_chunks WHERE repo_id = ?").all(repoId);
     const deleteFts = db.prepare("DELETE FROM code_chunks_fts WHERE chunkId = ?");
     for (const row of existingChunks) deleteFts.run(row.id);
     db.prepare("DELETE FROM code_chunks WHERE repo_id = ?").run(repoId);
     db.prepare("DELETE FROM code_files WHERE repo_id = ?").run(repoId);
+    db.prepare("DELETE FROM test_links WHERE repo_id = ? AND reason != 'PR co-change'").run(repoId);
+    db.prepare("DELETE FROM test_files WHERE repo_id = ?").run(repoId);
     const insertFile = db.prepare(
       `INSERT INTO code_files
        (repo_id, path, language, size_bytes, content_hash, updated_at)
@@ -652,6 +1324,7 @@ function replaceCodeIndex(db, repo, codeFiles, codeChunks, skippedFiles, cwd) {
         chunk.language ?? ""
       );
     }
+    insertTestAwareness(db, repoId, testAwareness.testFiles, testAwareness.testLinks);
     db.prepare(
       `INSERT INTO code_index_state (repo, last_indexed_at, indexed_files, code_chunks, skipped_files)
        VALUES (?, ?, ?, ?, ?)
@@ -666,12 +1339,75 @@ function replaceCodeIndex(db, repo, codeFiles, codeChunks, skippedFiles, cwd) {
   return {
     indexedFiles: codeFiles.length,
     codeChunksCreated: codeChunks.length,
+    testFilesIndexed: testAwareness.testFiles.length,
+    testLinksCreated: testAwareness.testLinks.length,
     skippedFiles,
     databasePath: defaultDatabasePath(cwd)
   };
 }
+function insertPrCochangeTestLinks(db, repoId, filePaths) {
+  const testPaths = filePaths.filter(isTestFilePath);
+  const sourcePaths = filePaths.filter((filePath) => !isTestFilePath(filePath));
+  if (testPaths.length === 0 || sourcePaths.length === 0) return;
+  const insert = db.prepare(
+    `INSERT INTO test_links (repo_id, source_path, test_path, reason, strength)
+     VALUES (?, ?, ?, 'PR co-change', 0.75)
+     ON CONFLICT(repo_id, source_path, test_path, reason) DO UPDATE SET strength = excluded.strength`
+  );
+  for (const sourcePath of sourcePaths) {
+    for (const testPath of testPaths) insert.run(repoId, sourcePath, testPath);
+  }
+}
+function insertTestAwareness(db, repoId, testFiles, testLinks) {
+  const insertTestFile = db.prepare(
+    `INSERT INTO test_files
+     (repo_id, path, language, size_bytes, content_hash, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?)`
+  );
+  for (const file of testFiles) {
+    insertTestFile.run(
+      repoId,
+      file.path,
+      file.language ?? null,
+      file.sizeBytes,
+      file.contentHash,
+      file.updatedAt
+    );
+  }
+  const insertTestLink = db.prepare(
+    `INSERT INTO test_links (repo_id, source_path, test_path, reason, strength)
+     VALUES (?, ?, ?, ?, ?)`
+  );
+  for (const link of testLinks) {
+    insertTestLink.run(repoId, link.sourcePath, link.testPath, link.reason, link.strength);
+  }
+}
+function recordIndexRun(db, run) {
+  initializeSchema(db);
+  db.prepare(
+    `INSERT INTO index_runs
+     (command, repo, started_at, finished_at, history_coverage, history_limit, prs_fetched,
+      prs_skipped, comments_indexed, code_files_indexed, test_files_indexed, failures_json, status)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    run.command,
+    run.repo ?? null,
+    run.startedAt,
+    run.finishedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    run.historyCoverage ?? null,
+    run.historyLimit ?? null,
+    run.prsFetched ?? null,
+    run.prsSkipped ?? null,
+    run.commentsIndexed ?? null,
+    run.codeFilesIndexed ?? null,
+    run.testFilesIndexed ?? null,
+    JSON.stringify(run.failures ?? []),
+    run.status
+  );
+}
 function getIndexStatus(cwd, githubTokenConfigured = Boolean(resolveGitHubToken({ cwd }).token), databasePath = defaultDatabasePath(cwd)) {
-  if (!fs2.existsSync(databasePath)) {
+  if (!fs3.existsSync(databasePath)) {
+    const rules = countValidTeamRules(cwd);
     return {
       databasePath,
       prCount: 0,
@@ -680,6 +1416,13 @@ function getIndexStatus(cwd, githubTokenConfigured = Boolean(resolveGitHubToken(
       wisdomUnitCount: 0,
       codeFileCount: 0,
       codeChunkCount: 0,
+      testFileCount: 0,
+      testLinkCount: 0,
+      regressionEventCount: 0,
+      historyCoverage: "unknown",
+      staleEvidenceCount: 0,
+      teamRuleCount: rules.count,
+      lastRuleIndexTime: rules.lastRuleIndexTime,
       githubTokenConfigured,
       health: "missing_database"
     };
@@ -688,6 +1431,7 @@ function getIndexStatus(cwd, githubTokenConfigured = Boolean(resolveGitHubToken(
   try {
     initializeSchema(db);
     if (!checkSchema(db)) {
+      const rules2 = countValidTeamRules(cwd);
       return {
         databasePath,
         prCount: 0,
@@ -696,16 +1440,33 @@ function getIndexStatus(cwd, githubTokenConfigured = Boolean(resolveGitHubToken(
         wisdomUnitCount: 0,
         codeFileCount: 0,
         codeChunkCount: 0,
+        testFileCount: 0,
+        testLinkCount: 0,
+        regressionEventCount: 0,
+        historyCoverage: "unknown",
+        staleEvidenceCount: 0,
+        teamRuleCount: rules2.count,
+        lastRuleIndexTime: rules2.lastRuleIndexTime,
         githubTokenConfigured,
         health: "schema_invalid"
       };
     }
     const count = (table) => db.prepare(`SELECT COUNT(*) AS count FROM ${table}`).get().count;
     const repoRow = db.prepare("SELECT full_name FROM repositories ORDER BY id LIMIT 1").get();
-    const syncRow = db.prepare("SELECT last_sync_at FROM sync_state ORDER BY updated_at DESC LIMIT 1").get();
+    const syncRow = db.prepare(
+      "SELECT last_sync_at, history_coverage, history_limit FROM sync_state ORDER BY updated_at DESC LIMIT 1"
+    ).get();
     const codeIndexRow = db.prepare("SELECT last_indexed_at FROM code_index_state ORDER BY last_indexed_at DESC LIMIT 1").get();
     const wisdomUnitCount = count("wisdom_units");
     const codeChunkCount = count("code_chunks");
+    const lastSuccessfulRun = db.prepare(
+      "SELECT finished_at, failures_json FROM index_runs WHERE status = 'success' ORDER BY finished_at DESC LIMIT 1"
+    ).get();
+    const lastFailedRun = db.prepare(
+      "SELECT finished_at, failures_json FROM index_runs WHERE status = 'failed' ORDER BY finished_at DESC LIMIT 1"
+    ).get();
+    const staleCodeIndex = isCodeIndexStale(codeIndexRow?.last_indexed_at ?? void 0);
+    const rules = countValidTeamRules(cwd);
     return {
       repo: repoRow?.full_name,
       databasePath,
@@ -715,8 +1476,26 @@ function getIndexStatus(cwd, githubTokenConfigured = Boolean(resolveGitHubToken(
       wisdomUnitCount,
       codeFileCount: count("code_files"),
       codeChunkCount,
+      testFileCount: count("test_files"),
+      testLinkCount: count("test_links"),
+      regressionEventCount: count("regression_events"),
+      historyCoverage: syncRow?.history_coverage ?? "unknown",
+      historyLimit: syncRow?.history_limit ?? void 0,
+      staleEvidenceCount: countStaleEvidence(db),
+      teamRuleCount: rules.count,
       lastSyncTime: syncRow?.last_sync_at ?? void 0,
       lastCodeIndexTime: codeIndexRow?.last_indexed_at ?? void 0,
+      lastRuleIndexTime: rules.lastRuleIndexTime,
+      lastSuccessfulRun: lastSuccessfulRun?.finished_at ?? void 0,
+      lastFailedRun: lastFailedRun?.finished_at ?? void 0,
+      staleCodeIndex,
+      suggestedNextCommand: suggestedNextCommand({
+        prCount: count("pull_requests"),
+        wisdomUnitCount,
+        codeChunkCount,
+        staleCodeIndex,
+        historyCoverage: syncRow?.history_coverage ?? "unknown"
+      }),
       githubTokenConfigured,
       health: wisdomUnitCount > 0 || codeChunkCount > 0 ? "ok" : "empty_index"
     };
@@ -724,6 +1503,39 @@ function getIndexStatus(cwd, githubTokenConfigured = Boolean(resolveGitHubToken(
     db.close();
   }
 }
+function isCodeIndexStale(lastIndexedAt) {
+  if (!lastIndexedAt) return true;
+  const timestamp = Date.parse(lastIndexedAt);
+  if (Number.isNaN(timestamp)) return true;
+  return Date.now() - timestamp > 1e3 * 60 * 60 * 24 * 7;
+}
+function suggestedNextCommand(input) {
+  if (input.prCount === 0 && input.wisdomUnitCount === 0) return "anchor index";
+  if (input.codeChunkCount === 0 || input.staleCodeIndex) return "anchor index-code";
+  if (input.historyCoverage !== "all") return "anchor index-all";
+  return void 0;
+}
+function countStaleEvidence(db) {
+  const codeFiles = new Set(
+    db.prepare("SELECT path FROM code_files").all().map(
+      (row) => row.path
+    )
+  );
+  if (codeFiles.size === 0) return 0;
+  const rows = db.prepare("SELECT file_paths_json FROM wisdom_units").all();
+  let stale = 0;
+  for (const row of rows) {
+    let paths = [];
+    try {
+      const parsed = JSON.parse(row.file_paths_json);
+      paths = Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
+    } catch {
+      paths = [];
+    }
+    if (paths.length > 0 && !paths.some((filePath) => codeFiles.has(filePath))) stale += 1;
+  }
+  return stale;
+}
 
 // src/indexer/chunker.ts
 var HIGH_SIGNAL_PATTERN = /\b(because|we intentionally|do not|don't|must|should not|avoid|rejected|regression|breaking|contract|invariant|performance|security|secret|token|migration|compatibility|lazy|eager|thread-safe|race|deadlock|deprecated|backward compatible|do not change|this broke|root cause|architecture decision)\b/i;
@@ -757,7 +1569,7 @@ function chunkHistoricalText(text, maxChunkLength = 700) {
 
 // src/indexer/code-chunker.ts
 import crypto from "crypto";
-import path3 from "path";
+import path5 from "path";
 var DEFAULT_CHUNK_LINES = 80;
 var DEFAULT_OVERLAP_LINES = 8;
 var FUNCTION_CALL_STOP_WORDS = /* @__PURE__ */ new Set([
@@ -790,7 +1602,7 @@ function extractCodeSymbols(text, filePath) {
     const candidate = match[1] ?? "";
     if (!FUNCTION_CALL_STOP_WORDS.has(candidate)) symbols.push(candidate);
   }
-  const basename = path3.basename(filePath).replace(/\.[^.]+$/, "");
+  const basename = path5.basename(filePath).replace(/\.[^.]+$/, "");
   if (/^[A-Za-z_$][\w$-]*$/.test(basename)) symbols.push(basename);
   return uniqueStrings(symbols).slice(0, 40);
 }
@@ -829,8 +1641,8 @@ function chunkCodeFile(file, options = {}) {
 // src/indexer/code-file-discovery.ts
 import { execFileSync as execFileSync3 } from "child_process";
 import crypto2 from "crypto";
-import fs3 from "fs";
-import path4 from "path";
+import fs4 from "fs";
+import path6 from "path";
 var DEFAULT_MAX_CODE_FILE_BYTES = 512 * 1024;
 var HARD_EXCLUDED_SEGMENTS = /* @__PURE__ */ new Set([
   ".git",
@@ -878,7 +1690,7 @@ function isHardExcludedCodePath(filePath) {
   const normalized = normalizeGitPath(filePath);
   const segments = normalized.split("/");
   if (segments.some((segment) => HARD_EXCLUDED_SEGMENTS.has(segment))) return true;
-  const basename = path4.posix.basename(normalized).toLowerCase();
+  const basename = path6.posix.basename(normalized).toLowerCase();
   if ([".netrc", ".npmrc", ".pypirc", ".yarnrc"].includes(basename)) return true;
   if (basename === ".env" || basename.startsWith(".env.")) return true;
   if (basename === "id_rsa" || basename === "id_rsa.pub" || basename === "id_dsa" || basename === "id_ecdsa" || basename === "id_ed25519") {
@@ -888,7 +1700,7 @@ function isHardExcludedCodePath(filePath) {
   return false;
 }
 function languageForPath(filePath) {
-  const extension = path4.extname(filePath).toLowerCase();
+  const extension = path6.extname(filePath).toLowerCase();
   return LANGUAGE_BY_EXTENSION[extension];
 }
 function isProbablyBinary(buffer) {
@@ -911,7 +1723,7 @@ function discoverGitFiles(cwd) {
 }
 function discoverCodeFiles(cwd, repo, options = {}) {
   const maxFileBytes = options.maxFileBytes ?? DEFAULT_MAX_CODE_FILE_BYTES;
-  const rootPath = path4.resolve(cwd);
+  const rootPath = path6.resolve(cwd);
   const files = [];
   let skippedFiles = 0;
   for (const filePath of discoverGitFiles(cwd)) {
@@ -919,15 +1731,15 @@ function discoverCodeFiles(cwd, repo, options = {}) {
       skippedFiles += 1;
       continue;
     }
-    const absolutePath = path4.resolve(cwd, filePath);
-    const relativeToRoot = path4.relative(rootPath, absolutePath);
-    if (relativeToRoot.startsWith("..") || path4.isAbsolute(relativeToRoot)) {
+    const absolutePath = path6.resolve(cwd, filePath);
+    const relativeToRoot = path6.relative(rootPath, absolutePath);
+    if (relativeToRoot.startsWith("..") || path6.isAbsolute(relativeToRoot)) {
       skippedFiles += 1;
       continue;
     }
     let stat;
     try {
-      stat = fs3.statSync(absolutePath);
+      stat = fs4.statSync(absolutePath);
     } catch {
       skippedFiles += 1;
       continue;
@@ -936,7 +1748,7 @@ function discoverCodeFiles(cwd, repo, options = {}) {
       skippedFiles += 1;
       continue;
     }
-    const buffer = fs3.readFileSync(absolutePath);
+    const buffer = fs4.readFileSync(absolutePath);
     if (isProbablyBinary(buffer)) {
       skippedFiles += 1;
       continue;
@@ -1001,14 +1813,19 @@ function emptyCodeIndexSummary(cwd) {
   return {
     indexedFiles: 0,
     codeChunksCreated: 0,
+    testFilesIndexed: 0,
+    testLinksCreated: 0,
     skippedFiles: 0,
     databasePath: defaultDatabasePath(cwd)
   };
 }
 
+// src/indexer/regression-extractor.ts
+import crypto4 from "crypto";
+
 // src/indexer/wisdom-extractor.ts
 import crypto3 from "crypto";
-import path5 from "path";
+import path7 from "path";
 var CATEGORY_KEYWORDS = [
   ["security_note", /\b(security|secret|token|bearer|oauth|credential|xss|csrf|injection|sanitize|redact)\b/i],
   ["architecture_decision", /\b(architecture decision|architectural|we intentionally|design decision)\b/i],
@@ -1040,7 +1857,7 @@ function extractSymbols(text, filePaths) {
     }
   }
   for (const filePath of filePaths) {
-    const basename = path5.basename(filePath).replace(/\.[^.]+$/, "");
+    const basename = path7.basename(filePath).replace(/\.[^.]+$/, "");
     if (/^[A-Za-z_$][\w$]*$/.test(basename)) symbols.push(basename);
   }
   return uniqueStrings(symbols).slice(0, 30);
@@ -1189,6 +2006,76 @@ ${filePaths.join("\n")}`, filePaths);
   return units;
 }
 
+// src/indexer/regression-extractor.ts
+var REGRESSION_SIGNALS = [
+  ["regression", /\bregression\b/i],
+  ["revert", /\b(revert|reverted)\b/i],
+  ["rollback", /\brollback\b/i],
+  ["hotfix", /\bhotfix\b/i],
+  ["incident", /\bincident\b/i],
+  ["root cause", /\broot cause\b/i],
+  ["this broke", /\b(this broke|broke)\b/i],
+  ["fixed by", /\bfixed by\b/i]
+];
+function labels(pr) {
+  return (pr.labels ?? []).map((label) => typeof label === "string" ? label : label.name).filter((label) => Boolean(label));
+}
+function sourceTexts(pr) {
+  return [
+    pr.title,
+    pr.body ?? "",
+    ...labels(pr),
+    ...(pr.reviews ?? []).map((item) => item.body ?? ""),
+    ...(pr.reviewComments ?? []).map((item) => item.body ?? ""),
+    ...(pr.issueComments ?? []).map((item) => item.body ?? ""),
+    ...(pr.commits ?? []).map((item) => item.commit?.message ?? "")
+  ].filter((text) => text.trim());
+}
+function stableRegressionId(pr, summary, signals) {
+  const hash = crypto4.createHash("sha256").update([pr.repo, pr.number, canonicalizeText(summary), signals.join("|")].join("\0")).digest("hex").slice(0, 24);
+  return `re_${hash}`;
+}
+function extractRegressionEvents(pr) {
+  const allText = sourceTexts(pr).join("\n");
+  const signals = REGRESSION_SIGNALS.filter(([, pattern]) => pattern.test(allText)).map(
+    ([signal]) => signal
+  );
+  if (signals.length === 0) return [];
+  const files = uniqueStrings(pr.files.map((file) => file.filename));
+  const testPaths = files.filter(isTestFilePath);
+  const sanitizedSummary = sanitizeHistoricalText(
+    clipSentence(`${pr.title}. ${pr.body ?? ""}`, 420)
+  );
+  if (!sanitizedSummary) return [];
+  const reviewerCount = (pr.reviews ?? []).length + (pr.reviewComments ?? []).length;
+  const confidence = Math.min(
+    1,
+    Number((0.58 + signals.length * 0.06 + (reviewerCount > 0 ? 0.08 : 0)).toFixed(2))
+  );
+  const authors = uniqueStrings([
+    pr.user?.login ?? "unknown",
+    ...(pr.reviewComments ?? []).map((comment) => comment.user?.login ?? "unknown")
+  ]);
+  const event = {
+    id: stableRegressionId(pr, sanitizedSummary, signals),
+    repo: pr.repo,
+    prNumber: pr.number,
+    prUrl: pr.html_url,
+    summary: sanitizedSummary,
+    filePaths: files,
+    symbols: extractSymbols(`${sanitizedSummary}
+${files.join("\n")}`, files),
+    testPaths,
+    authors,
+    labels: labels(pr),
+    signals: uniqueStrings(signals),
+    createdAt: pr.created_at,
+    mergedAt: pr.merged_at ?? void 0,
+    confidence
+  };
+  return [event];
+}
+
 // src/indexer/normalize-pr.ts
 function normalizePullRequest(input) {
   return {
@@ -1211,6 +2098,7 @@ function indexPullRequests(db, pullRequests, options) {
   let indexedFiles = 0;
   let indexedComments = 0;
   let wisdomUnitsCreated = 0;
+  let regressionEventsCreated = 0;
   let skippedItems = 0;
   let lastPr;
   for (const [index, rawPr] of pullRequests.entries()) {
@@ -1227,10 +2115,12 @@ function indexPullRequests(db, pullRequests, options) {
       continue;
     }
     const wisdomUnits = extractWisdomUnits(pr);
-    const result = upsertPullRequest(db, pr, wisdomUnits);
+    const regressionEvents = extractRegressionEvents(pr);
+    const result = upsertPullRequest(db, pr, wisdomUnits, regressionEvents);
     indexedFiles += result.files;
     indexedComments += result.comments;
     wisdomUnitsCreated += result.wisdom;
+    regressionEventsCreated += result.regressions;
     lastPr = pr.number;
     options.onProgress?.({
       stage: "indexed_pull_request",
@@ -1242,13 +2132,18 @@ function indexPullRequests(db, pullRequests, options) {
     });
   }
   if (options.updateSyncStateAfter !== false) {
-    updateSyncState(db, options.repo, lastPr);
+    updateSyncState(db, options.repo, lastPr, {
+      historyCoverage: options.historyCoverage,
+      historyLimit: options.historyLimit,
+      historySince: options.historySince
+    });
   }
   return {
     indexedPrs: pullRequests.length - skippedItems,
     indexedFiles,
     indexedComments,
     wisdomUnitsCreated,
+    regressionEventsCreated,
     skippedItems,
     databasePath: defaultDatabasePath(options.cwd)
   };
@@ -1260,7 +2155,7 @@ function shouldSyncSince(db, repo, fallbackSince) {
 }
 
 // src/retrieval/query-builder.ts
-import path6 from "path";
+import path8 from "path";
 var CATEGORY_HINTS = [
   "security",
   "regression",
@@ -1276,7 +2171,29 @@ function ftsToken(token) {
   if (clean.length < 3) return void 0;
   return `${clean}*`;
 }
-function buildFtsQuery(input) {
+function testFilenameHints(filePath) {
+  const parsed = path8.parse(filePath);
+  const base = parsed.name.replace(/\.(test|spec)$/i, "");
+  return [`${base}.test${parsed.ext}`, `${base}.spec${parsed.ext}`];
+}
+function diffHunkTerms(diff) {
+  if (!diff) return [];
+  const terms = [];
+  const truncated = truncateText(diff, 5e3) ?? "";
+  for (const line of truncated.split("\n")) {
+    if (line.startsWith("diff --git")) {
+      terms.push(...line.split(/[\\/]/).slice(-4));
+    }
+    if (line.startsWith("@@")) {
+      terms.push(line.replace(/^@@[^@]*@@/, ""));
+    }
+    if (/^[+-]\s*(?:export\s+)?(?:class|function|const|let|var|type|interface)\s+/.test(line)) {
+      terms.push(line);
+    }
+  }
+  return terms;
+}
+function buildQueryTerms(input) {
   const files = input.files ?? [];
   const symbols = "symbols" in input ? input.symbols ?? [] : [];
   const categories = "categories" in input ? input.categories ?? [] : [];
@@ -1285,18 +2202,24 @@ function buildFtsQuery(input) {
   const baseText = "task" in input ? input.task : input.query;
   const fileTerms = files.flatMap((file) => [
     file,
-    path6.basename(file),
-    ...path6.dirname(file).split(/[\\/]/).filter(Boolean)
+    path8.basename(file),
+    ...testFilenameHints(file),
+    ...path8.dirname(file).split(/[\\/]/).filter(Boolean)
   ]);
-  const tokens = uniqueStrings([
+  return uniqueStrings([
     ...tokenizeSearchText(baseText, 24),
     ...tokenizeSearchText(fileTerms.join(" "), 24),
     ...tokenizeSearchText(symbols.join(" "), 24),
     ...tokenizeSearchText(categories.join(" "), 12),
     ...tokenizeSearchText(diff ?? "", 18),
     ...tokenizeSearchText(currentCode ?? "", 18),
+    ...tokenizeSearchText(diffHunkTerms(diff).join(" "), 18),
+    ...CATEGORY_HINTS,
     ...CATEGORY_HINTS.filter((hint) => baseText.toLowerCase().includes(hint))
-  ]).map(ftsToken).filter((token) => Boolean(token)).slice(0, 48);
+  ]).slice(0, 80);
+}
+function buildFtsQuery(input) {
+  const tokens = buildQueryTerms(input).map(ftsToken).filter((token) => Boolean(token)).slice(0, 48);
   return tokens.join(" OR ");
 }
 function clampMaxResults(value, defaultValue) {
@@ -1305,8 +2228,8 @@ function clampMaxResults(value, defaultValue) {
 }
 
 // src/retrieval/ranker.ts
-import path7 from "path";
-function parseJsonArray(value) {
+import path9 from "path";
+function parseJsonArray2(value) {
   try {
     const parsed = JSON.parse(value);
     return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
@@ -1324,9 +2247,9 @@ function rowToWisdomUnit(row) {
     category: row.category,
     text: row.text,
     sanitizedText: row.sanitized_text,
-    filePaths: parseJsonArray(row.file_paths_json),
-    symbols: parseJsonArray(row.symbols_json),
-    authors: parseJsonArray(row.authors_json),
+    filePaths: parseJsonArray2(row.file_paths_json),
+    symbols: parseJsonArray2(row.symbols_json),
+    authors: parseJsonArray2(row.authors_json),
     createdAt: row.created_at,
     mergedAt: row.merged_at ?? void 0,
     confidence: row.confidence,
@@ -1352,17 +2275,18 @@ function filePathMatch(unitPaths, queryFiles) {
   if (queryFiles.length === 0 || unitPaths.length === 0) return 0;
   let best = 0;
   for (const queryFile of queryFiles) {
-    const queryBase = path7.basename(queryFile).toLowerCase();
-    const queryDir = path7.dirname(queryFile).toLowerCase();
+    const queryBase = path9.basename(queryFile).toLowerCase();
+    const queryDir = path9.dirname(queryFile).toLowerCase();
     for (const unitPath of unitPaths) {
-      const unitBase = path7.basename(unitPath).toLowerCase();
-      const unitDir = path7.dirname(unitPath).toLowerCase();
+      const unitBase = path9.basename(unitPath).toLowerCase();
+      const unitDir = path9.dirname(unitPath).toLowerCase();
       const q = queryFile.toLowerCase();
       const u = unitPath.toLowerCase();
       if (q === u) best = Math.max(best, 1);
       else if (queryBase === unitBase) best = Math.max(best, 0.68);
       else if (queryDir === unitDir) best = Math.max(best, 0.62);
-      else if (unitDir.startsWith(queryDir) || queryDir.startsWith(unitDir)) best = Math.max(best, 0.38);
+      else if (unitDir.startsWith(queryDir) || queryDir.startsWith(unitDir))
+        best = Math.max(best, 0.38);
       else if (queryBase && unitBase && queryBase.split(".")[0] === unitBase.split(".")[0]) {
         best = Math.max(best, 0.48);
       }
@@ -1370,7 +2294,7 @@ function filePathMatch(unitPaths, queryFiles) {
   }
   return best;
 }
-function symbolMatch(unit, querySymbols) {
+function symbolMatch2(unit, querySymbols) {
   if (querySymbols.length === 0) return 0;
   const unitSymbols = unit.symbols.map((symbol) => symbol.toLowerCase());
   const text = unit.sanitizedText.toLowerCase();
@@ -1379,14 +2303,15 @@ function symbolMatch(unit, querySymbols) {
     const lower = symbol.toLowerCase();
     if (unitSymbols.includes(lower)) best = Math.max(best, 1);
     else if (text.includes(`\`${lower}\``)) best = Math.max(best, 1);
-    else if (new RegExp(`\\b${escapeRegExp(lower)}\\b`, "i").test(text)) best = Math.max(best, 0.66);
+    else if (new RegExp(`\\b${escapeRegExp2(lower)}\\b`, "i").test(text))
+      best = Math.max(best, 0.66);
     else if (unitSymbols.some((candidate) => candidate.includes(lower) || lower.includes(candidate))) {
       best = Math.max(best, 0.35);
     }
   }
   return best;
 }
-function textMatch(unit, inputText) {
+function textMatch2(unit, inputText) {
   const queryTokens = tokenizeSearchText(inputText, 32);
   if (queryTokens.length === 0) return unit.bm25 === void 0 ? 0 : 0.45;
   const haystack = `${unit.sanitizedText} ${unit.filePaths.join(" ")} ${unit.symbols.join(" ")}`.toLowerCase();
@@ -1410,28 +2335,56 @@ function recencyScore(unit) {
   if (ageDays < 1460) return 0.45;
   return 0.25;
 }
-function scoreUnit(unit, input, duplicateCount) {
+function freshnessMultiplier(status) {
+  if (status === "current") return 1;
+  if (status === "possibly_stale") return 0.85;
+  return 0.55;
+}
+function matchReasons2(parts, unit) {
+  const reasons = [];
+  if (parts.filePathMatch >= 0.9) reasons.push("exact file path match");
+  else if (parts.filePathMatch >= 0.45) reasons.push("related file path match");
+  if (parts.symbolMatch >= 0.9) reasons.push("exact symbol match");
+  else if (parts.symbolMatch >= 0.45) reasons.push("symbol mentioned in evidence");
+  if (parts.textMatch >= 0.45) reasons.push("text matched task or diff terms");
+  if (parts.reviewerOrAuthorSignal >= 0.85) reasons.push("reviewer evidence");
+  if (unit.category === "security_note" || unit.category === "bug_regression") {
+    reasons.push(`${unit.category.replace(/_/g, " ")} priority`);
+  }
+  return reasons.slice(0, 5);
+}
+function scoreUnit(unit, input, duplicateCount, repeatedEvidenceCount, freshness) {
   const queryFiles = input.files ?? [];
   const querySymbols = "symbols" in input ? input.symbols ?? [] : [];
   const inputText = "task" in input ? `${input.task} ${input.diff ?? ""} ${input.currentCode ?? ""}` : input.query;
-  const repetition = Math.min(1, duplicateCount / 3);
+  const repetition = Math.min(1, Math.max(duplicateCount, repeatedEvidenceCount) / 3);
+  const claimKey = claimKeyFor(unit.category, unit.sanitizedText);
   const parts = {
     filePathMatch: filePathMatch(unit.filePaths, queryFiles),
-    symbolMatch: symbolMatch(unit, querySymbols),
-    textMatch: textMatch(unit, inputText),
+    symbolMatch: symbolMatch2(unit, querySymbols),
+    textMatch: textMatch2(unit, inputText),
     reviewerOrAuthorSignal: reviewerOrAuthorSignal(unit),
     recencyOrRepetition: Math.max(recencyScore(unit), repetition),
     categoryPriority: categoryPriority(unit.category)
   };
-  const score = 0.35 * parts.filePathMatch + 0.2 * parts.symbolMatch + 0.2 * parts.textMatch + 0.1 * parts.reviewerOrAuthorSignal + 0.1 * parts.recencyOrRepetition + 0.05 * parts.categoryPriority;
+  const score = (0.35 * parts.filePathMatch + 0.2 * parts.symbolMatch + 0.2 * parts.textMatch + 0.1 * parts.reviewerOrAuthorSignal + 0.1 * parts.recencyOrRepetition + 0.05 * parts.categoryPriority) * freshnessMultiplier(freshness.status);
   return {
     ...unit,
     score: Number(score.toFixed(4)),
     scoreParts: parts,
-    duplicateCount
+    duplicateCount,
+    claimKey,
+    repeatedEvidenceCount,
+    confidenceLevel: confidenceLevelFor(unit.confidence),
+    confidenceReasons: confidenceReasonsFor(unit, repeatedEvidenceCount),
+    freshnessStatus: freshness.status,
+    freshnessReason: freshness.reason,
+    evidence: evidenceForWisdom(unit),
+    matchReasons: matchReasons2(parts, unit),
+    rankSignals: parts
   };
 }
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function loadCandidates(db, input) {
@@ -1458,20 +2411,48 @@ function loadCandidates(db, input) {
   ).all(...categories);
   return rows.map(rowToWisdomUnit);
 }
+function loadClaimRepetitionCounts(db) {
+  const rows = db.prepare("SELECT category, sanitized_text, pr_number FROM wisdom_units").all();
+  const grouped = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const key = claimKeyFor(row.category, row.sanitized_text);
+    const prs = grouped.get(key) ?? /* @__PURE__ */ new Set();
+    prs.add(row.pr_number);
+    grouped.set(key, prs);
+  }
+  return new Map([...grouped.entries()].map(([key, prs]) => [key, prs.size]));
+}
+function minConfidence(input) {
+  if ("minConfidence" in input && input.minConfidence) return input.minConfidence;
+  return "strong";
+}
+function passesStrictMode2(unit, input) {
+  if (!("strict" in input) || !input.strict) return true;
+  if (unit.freshnessStatus === "stale") return false;
+  return confidenceAtLeast(unit.confidenceLevel, minConfidence(input));
+}
 function rankWisdomUnits(db, input) {
   const candidates = loadCandidates(db, input);
+  const codeSnapshot = loadCurrentCodeSnapshot(db);
+  const repetitionCounts = loadClaimRepetitionCounts(db);
   const duplicates = /* @__PURE__ */ new Map();
   for (const unit of candidates) {
-    const key = `${unit.category}:${canonicalizeText(unit.sanitizedText).slice(0, 180)}`;
+    const key = claimKeyFor(unit.category, unit.sanitizedText);
     duplicates.set(key, (duplicates.get(key) ?? 0) + 1);
   }
   const ranked = candidates.map((unit) => {
-    const key = `${unit.category}:${canonicalizeText(unit.sanitizedText).slice(0, 180)}`;
-    return scoreUnit(unit, input, duplicates.get(key) ?? 1);
-  }).sort((a, b) => b.score - a.score || b.confidence - a.confidence);
+    const key = claimKeyFor(unit.category, unit.sanitizedText);
+    return scoreUnit(
+      unit,
+      input,
+      duplicates.get(key) ?? 1,
+      repetitionCounts.get(key) ?? 1,
+      evaluateFreshness(unit, codeSnapshot)
+    );
+  }).filter((unit) => passesStrictMode2(unit, input)).sort((a, b) => b.score - a.score || b.confidence - a.confidence);
   const grouped = /* @__PURE__ */ new Map();
   for (const unit of ranked) {
-    const key = `${unit.category}:${canonicalizeText(unit.sanitizedText).slice(0, 180)}`;
+    const key = unit.claimKey;
     const existing = grouped.get(key);
     if (!existing || unit.score > existing.score) {
       grouped.set(key, {
@@ -1479,7 +2460,11 @@ function rankWisdomUnits(db, input) {
         filePaths: uniqueStrings([...existing?.filePaths ?? [], ...unit.filePaths]),
         symbols: uniqueStrings([...existing?.symbols ?? [], ...unit.symbols]),
         authors: uniqueStrings([...existing?.authors ?? [], ...unit.authors]),
-        duplicateCount: Math.max(unit.duplicateCount, existing?.duplicateCount ?? 1)
+        duplicateCount: Math.max(unit.duplicateCount, existing?.duplicateCount ?? 1),
+        repeatedEvidenceCount: Math.max(
+          unit.repeatedEvidenceCount,
+          existing?.repeatedEvidenceCount ?? 1
+        )
       });
     }
   }
@@ -1488,8 +2473,8 @@ function rankWisdomUnits(db, input) {
 }
 
 // src/retrieval/code-ranker.ts
-import path8 from "path";
-function parseJsonArray2(value) {
+import path10 from "path";
+function parseJsonArray3(value) {
   try {
     const parsed = JSON.parse(value);
     return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
@@ -1506,7 +2491,7 @@ function rowToCodeChunk(row) {
     startLine: row.start_line,
     endLine: row.end_line,
     sanitizedText: row.sanitized_text,
-    symbols: parseJsonArray2(row.symbols_json),
+    symbols: parseJsonArray3(row.symbols_json),
     contentHash: row.content_hash,
     updatedAt: row.updated_at,
     bm25: row.bm25 ?? void 0
@@ -1515,13 +2500,13 @@ function rowToCodeChunk(row) {
 function filePathMatch2(filePath, queryFiles) {
   if (queryFiles.length === 0) return 0;
   let best = 0;
-  const unitBase = path8.basename(filePath).toLowerCase();
-  const unitDir = path8.dirname(filePath).toLowerCase();
+  const unitBase = path10.basename(filePath).toLowerCase();
+  const unitDir = path10.dirname(filePath).toLowerCase();
   const unit = filePath.toLowerCase();
   for (const queryFile of queryFiles) {
     const query = queryFile.toLowerCase();
-    const queryBase = path8.basename(queryFile).toLowerCase();
-    const queryDir = path8.dirname(queryFile).toLowerCase();
+    const queryBase = path10.basename(queryFile).toLowerCase();
+    const queryDir = path10.dirname(queryFile).toLowerCase();
     if (query === unit) best = Math.max(best, 1);
     else if (queryBase === unitBase) best = Math.max(best, 0.72);
     else if (queryDir === unitDir) best = Math.max(best, 0.62);
@@ -1533,7 +2518,7 @@ function filePathMatch2(filePath, queryFiles) {
   }
   return best;
 }
-function symbolMatch2(chunk, querySymbols) {
+function symbolMatch3(chunk, querySymbols) {
   if (querySymbols.length === 0) return 0;
   const chunkSymbols = chunk.symbols.map((symbol) => symbol.toLowerCase());
   const text = chunk.sanitizedText.toLowerCase();
@@ -1541,14 +2526,14 @@ function symbolMatch2(chunk, querySymbols) {
   for (const symbol of querySymbols) {
     const lower = symbol.toLowerCase();
     if (chunkSymbols.includes(lower)) best = Math.max(best, 1);
-    else if (new RegExp(`\\b${escapeRegExp2(lower)}\\b`, "i").test(text)) best = Math.max(best, 0.7);
+    else if (new RegExp(`\\b${escapeRegExp3(lower)}\\b`, "i").test(text)) best = Math.max(best, 0.7);
     else if (chunkSymbols.some((candidate) => candidate.includes(lower) || lower.includes(candidate))) {
       best = Math.max(best, 0.42);
     }
   }
   return best;
 }
-function textMatch2(chunk, input) {
+function textMatch3(chunk, input) {
   const tokens = tokenizeSearchText(
     `${input.task} ${input.diff ?? ""} ${input.currentCode ?? ""}`,
     40
@@ -1567,7 +2552,17 @@ function recencyScore2(chunk) {
   if (ageDays < 730) return 0.45;
   return 0.25;
 }
-function escapeRegExp2(value) {
+function matchReasons3(parts) {
+  const reasons = [];
+  if (parts.filePathMatch >= 0.9) reasons.push("exact file path match");
+  else if (parts.filePathMatch >= 0.45) reasons.push("related file path match");
+  if (parts.symbolMatch >= 0.9) reasons.push("exact symbol match");
+  else if (parts.symbolMatch >= 0.45) reasons.push("symbol mentioned in current code");
+  if (parts.textMatch >= 0.45) reasons.push("text matched task or diff terms");
+  if (parts.recency >= 0.75) reasons.push("recent code file");
+  return reasons.slice(0, 5);
+}
+function escapeRegExp3(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function escapeLike(value) {
@@ -1591,7 +2586,7 @@ function loadCodeCandidates(db, input) {
     }
   }
   for (const file of input.files ?? []) {
-    const basename = path8.basename(file);
+    const basename = path10.basename(file);
     const rows = db.prepare(
       `SELECT cc.*, NULL AS bm25
          FROM code_chunks cc
@@ -1624,8 +2619,8 @@ function rankCodeChunks(db, input) {
   const ranked = loadCodeCandidates(db, input).map((chunk) => {
     const parts = {
       filePathMatch: filePathMatch2(chunk.filePath, queryFiles),
-      symbolMatch: symbolMatch2(chunk, querySymbols),
-      textMatch: textMatch2(chunk, input),
+      symbolMatch: symbolMatch3(chunk, querySymbols),
+      textMatch: textMatch3(chunk, input),
       recency: recencyScore2(chunk)
     };
     const score = 0.4 * parts.filePathMatch + 0.25 * parts.symbolMatch + 0.25 * parts.textMatch + 0.1 * parts.recency;
@@ -1633,21 +2628,221 @@ function rankCodeChunks(db, input) {
       ...chunk,
       symbols: uniqueStrings(chunk.symbols),
       score: Number(score.toFixed(4)),
-      scoreParts: parts
+      scoreParts: parts,
+      matchReasons: matchReasons3(parts),
+      rankSignals: parts
     };
   }).sort((a, b) => b.score - a.score || b.startLine - a.startLine);
   const limit = Math.min(5, clampMaxResults(input.maxResults, 5));
   return ranked.slice(0, limit);
 }
 
+// src/retrieval/test-ranker.ts
+import path11 from "path";
+function parseJsonArray4(value) {
+  if (!value) return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function baseStem(filePath) {
+  return path11.posix.basename(filePath).replace(/\.(test|spec)\.[^.]+$/i, "").replace(/\.[^.]+$/i, "").toLowerCase();
+}
+function rowToRanked(row, input) {
+  const symbols = parseJsonArray4(row.symbols_json);
+  const text = row.sanitized_text ?? "";
+  const matchedSymbols = (input.symbols ?? []).filter((symbol) => {
+    const lower = symbol.toLowerCase();
+    return symbols.some((candidate) => candidate.toLowerCase() === lower) || new RegExp(`\\b${escapeRegExp4(symbol)}\\b`, "i").test(text);
+  });
+  const exactFile = (input.files ?? []).some((file) => row.source_path === file);
+  const basenameMatch = (input.files ?? []).some((file) => baseStem(file) === baseStem(row.path));
+  const symbolScore = matchedSymbols.length > 0 ? 0.25 : 0;
+  const score = (exactFile ? 0.55 : 0) + (basenameMatch ? 0.25 : 0) + (row.strength ?? 0.35) * 0.3 + symbolScore;
+  return {
+    repo: "",
+    path: row.path,
+    language: row.language ?? void 0,
+    sizeBytes: row.size_bytes,
+    contentHash: row.content_hash,
+    updatedAt: row.updated_at,
+    sourcePath: row.source_path ?? void 0,
+    reason: row.reason ?? (basenameMatch ? "same basename" : "test file match"),
+    strength: row.strength ?? 0.35,
+    score: Number(score.toFixed(4)),
+    matchedSymbols
+  };
+}
+function escapeRegExp4(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function rankRelevantTests(db, input) {
+  const candidates = /* @__PURE__ */ new Map();
+  for (const file of input.files ?? []) {
+    const linkedRows = db.prepare(
+      `SELECT tf.path, tf.language, tf.size_bytes, tf.content_hash, tf.updated_at,
+                tl.source_path, tl.reason, tl.strength, cc.symbols_json, cc.sanitized_text
+         FROM test_links tl
+         JOIN test_files tf ON tf.repo_id = tl.repo_id AND tf.path = tl.test_path
+         LEFT JOIN code_chunks cc ON cc.repo_id = tl.repo_id AND cc.file_path = tf.path
+         WHERE tl.source_path = ?
+         ORDER BY tl.strength DESC
+         LIMIT 40`
+    ).all(file);
+    for (const row of linkedRows) candidates.set(row.path, row);
+    const basename = baseStem(file);
+    const basenameRows = db.prepare(
+      `SELECT tf.path, tf.language, tf.size_bytes, tf.content_hash, tf.updated_at,
+                NULL AS source_path, 'same basename' AS reason, 0.7 AS strength,
+                cc.symbols_json, cc.sanitized_text
+         FROM test_files tf
+         LEFT JOIN code_chunks cc ON cc.file_path = tf.path
+         WHERE lower(tf.path) LIKE ?
+         LIMIT 25`
+    ).all(`%${basename}%`);
+    for (const row of basenameRows) candidates.set(row.path, row);
+  }
+  if (candidates.size === 0) {
+    const rows = db.prepare(
+      `SELECT tf.path, tf.language, tf.size_bytes, tf.content_hash, tf.updated_at,
+                NULL AS source_path, 'recent test file' AS reason, 0.25 AS strength,
+                cc.symbols_json, cc.sanitized_text
+         FROM test_files tf
+         LEFT JOIN code_chunks cc ON cc.file_path = tf.path
+         ORDER BY tf.updated_at DESC
+         LIMIT 20`
+    ).all();
+    for (const row of rows) candidates.set(row.path, row);
+  }
+  return [...candidates.values()].map((row) => rowToRanked(row, input)).sort((a, b) => b.score - a.score || a.path.localeCompare(b.path)).slice(0, Math.min(5, clampMaxResults(input.maxResults, 5)));
+}
+
+// src/retrieval/regression-ranker.ts
+import path12 from "path";
+function parseJsonArray5(value) {
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function rowToEvent(row) {
+  return {
+    id: row.id,
+    repo: row.repo,
+    prNumber: row.pr_number,
+    prUrl: row.pr_url,
+    summary: row.summary_sanitized,
+    filePaths: parseJsonArray5(row.file_paths_json),
+    symbols: parseJsonArray5(row.symbols_json),
+    testPaths: parseJsonArray5(row.test_paths_json),
+    authors: parseJsonArray5(row.authors_json),
+    labels: parseJsonArray5(row.labels_json),
+    signals: parseJsonArray5(row.signals_json),
+    createdAt: row.created_at,
+    mergedAt: row.merged_at ?? void 0,
+    confidence: row.confidence
+  };
+}
+function filePathMatch3(eventPaths, queryFiles) {
+  let best = 0;
+  for (const queryFile of queryFiles) {
+    const queryBase = path12.posix.basename(queryFile).toLowerCase();
+    const queryDir = path12.posix.dirname(queryFile).toLowerCase();
+    for (const eventPath of eventPaths) {
+      const eventBase = path12.posix.basename(eventPath).toLowerCase();
+      const eventDir = path12.posix.dirname(eventPath).toLowerCase();
+      if (queryFile.toLowerCase() === eventPath.toLowerCase()) best = Math.max(best, 1);
+      else if (queryBase === eventBase) best = Math.max(best, 0.7);
+      else if (queryDir === eventDir) best = Math.max(best, 0.55);
+    }
+  }
+  return best;
+}
+function symbolMatch4(event, querySymbols) {
+  const eventSymbols = event.symbols.map((symbol) => symbol.toLowerCase());
+  let best = 0;
+  for (const symbol of querySymbols) {
+    const lower = symbol.toLowerCase();
+    if (eventSymbols.includes(lower)) best = Math.max(best, 1);
+    else if (event.summary.toLowerCase().includes(lower)) best = Math.max(best, 0.65);
+  }
+  return best;
+}
+function textMatch4(event, inputText) {
+  const tokens = tokenizeSearchText(inputText, 32);
+  if (tokens.length === 0) return 0;
+  const haystack = `${event.summary} ${event.filePaths.join(" ")} ${event.symbols.join(" ")} ${event.signals.join(" ")}`.toLowerCase();
+  return tokens.filter((token) => haystack.includes(token.toLowerCase())).length / tokens.length;
+}
+function recencyScore3(event) {
+  const timestamp = Date.parse(event.mergedAt ?? event.createdAt);
+  if (Number.isNaN(timestamp)) return 0.25;
+  const ageDays = Math.max(0, (Date.now() - timestamp) / (1e3 * 60 * 60 * 24));
+  if (ageDays < 180) return 1;
+  if (ageDays < 730) return 0.7;
+  return 0.35;
+}
+function matchReasons4(parts, event) {
+  const reasons = [];
+  if ((parts.filePathMatch ?? 0) >= 0.9) reasons.push("exact file path match");
+  else if ((parts.filePathMatch ?? 0) >= 0.45) reasons.push("related file path match");
+  if ((parts.symbolMatch ?? 0) >= 0.9) reasons.push("exact symbol match");
+  if ((parts.textMatch ?? 0) >= 0.35) reasons.push("text matched task or diff terms");
+  if (event.signals.length > 0)
+    reasons.push(`regression signals: ${event.signals.slice(0, 3).join(", ")}`);
+  return reasons.slice(0, 5);
+}
+function loadRegressionEvents(db) {
+  const rows = db.prepare(
+    "SELECT * FROM regression_events ORDER BY COALESCE(merged_at, created_at) DESC LIMIT 200"
+  ).all();
+  return rows.map(rowToEvent);
+}
+function rankRegressionEvents(db, input) {
+  const queryFiles = input.files ?? [];
+  const querySymbols = "symbols" in input ? input.symbols ?? [] : [];
+  const inputText = "task" in input ? `${input.task} ${input.diff ?? ""} ${input.currentCode ?? ""}` : input.query;
+  const ranked = loadRegressionEvents(db).map((event) => {
+    const parts = {
+      filePathMatch: filePathMatch3(event.filePaths, queryFiles),
+      symbolMatch: symbolMatch4(event, querySymbols),
+      textMatch: textMatch4(event, inputText),
+      recency: recencyScore3(event),
+      confidence: event.confidence
+    };
+    const score = 0.35 * parts.filePathMatch + 0.2 * parts.symbolMatch + 0.2 * parts.textMatch + 0.15 * parts.recency + 0.1 * parts.confidence;
+    return {
+      ...event,
+      filePaths: uniqueStrings(event.filePaths),
+      symbols: uniqueStrings(event.symbols),
+      score: Number(score.toFixed(4)),
+      matchReasons: matchReasons4(parts, event),
+      rankSignals: parts
+    };
+  }).filter((event) => event.score > 0 || "regressionsOnly" in input && input.regressionsOnly).sort((a, b) => b.score - a.score || b.confidence - a.confidence);
+  return ranked.slice(0, Math.min(5, clampMaxResults(input.maxResults, 5)));
+}
+
 // src/retrieval/formatter.ts
 function evidenceLine(unit) {
   const author = unit.authors[0] ? ` by @${unit.authors[0]}` : "";
   const file = unit.filePaths[0] ? `, ${unit.filePaths[0]}` : "";
   return `PR #${unit.prNumber}${author}, ${unit.sourceType}${file}`;
 }
+function confidenceLine(unit) {
+  const reasons = unit.confidenceReasons.length ? ` (${unit.confidenceReasons.join(", ")})` : "";
+  return `${unit.confidenceLevel}${reasons}`;
+}
+function currentCodeCheckLine(unit) {
+  return `${unit.freshnessStatus.replace(/_/g, " ")} - ${unit.freshnessReason}`;
+}
 function whyItMatters(unit, input) {
-  const prefix = unit.confidence < 0.7 ? "Historical evidence suggests " : "";
+  const prefix = unit.confidenceLevel === "weak" ? "Historical evidence suggests " : "";
   const target = input.files?.[0] ? ` when editing ${input.files[0]}` : " for this change";
   const categoryReasons = {
     security_note: `${prefix}there is a security-sensitive constraint to preserve${target}.`,
@@ -1679,15 +2874,39 @@ function riskLines(units) {
   }
   return [...risks].slice(0, 4);
 }
-function formatAnchorContext(units, input, codeChunks = []) {
-  const lines = ["# Anchor Context", "", "## Must know", ""];
+function formatAnchorContext(units, input, codeChunks = [], teamRules = [], warnings = [], relevantTests = [], regressionEvents = [], extraMetadata = {}) {
+  const lines = ["# Anchor Context", ""];
+  if (warnings.length > 0) {
+    lines.push("## Warnings", "");
+    for (const warning of warnings) lines.push(`- ${warning}`);
+    lines.push("");
+  }
+  if (teamRules.length > 0) {
+    lines.push("## Team-approved rules", "");
+    teamRules.forEach((rule, index) => {
+      const evidence = rule.evidence[0];
+      const evidenceText = evidence ? `PR #${evidence.prNumber}, ${evidence.sourceType}${evidence.filePath ? `, ${evidence.filePath}` : ""}` : "No evidence";
+      lines.push(`${index + 1}. [${rule.category}] ${clipSentence(rule.sanitizedText)}`);
+      lines.push(`   Evidence: ${evidenceText}`);
+      lines.push(`   Confidence: ${confidenceLine(rule)}`);
+      lines.push(`   Current code check: ${currentCodeCheckLine(rule)}`);
+      if (evidence?.prUrl) lines.push(`   Link: ${evidence.prUrl}`);
+      lines.push("");
+    });
+  }
+  lines.push("## Must know", "");
   if (units.length === 0) {
-    lines.push("No directly relevant indexed PR history found.", "");
+    lines.push(
+      input.strict ? "No reliable historical evidence found." : "No directly relevant indexed PR history found.",
+      ""
+    );
   } else {
     units.forEach((unit, index) => {
-      const statement = unit.confidence < 0.7 ? `Historical evidence suggests ${clipSentence(unit.sanitizedText)}` : clipSentence(unit.sanitizedText);
+      const statement = unit.confidenceLevel === "weak" ? `Historical evidence suggests ${clipSentence(unit.sanitizedText)}` : clipSentence(unit.sanitizedText);
       lines.push(`${index + 1}. [${unit.category}] ${statement}`);
       lines.push(`   Evidence: ${evidenceLine(unit)}`);
+      lines.push(`   Confidence: ${confidenceLine(unit)}`);
+      lines.push(`   Current code check: ${currentCodeCheckLine(unit)}`);
       lines.push(`   Why it matters: ${whyItMatters(unit, input)}`);
       lines.push(`   Link: ${unit.prUrl}`);
       lines.push("");
@@ -1705,6 +2924,33 @@ function formatAnchorContext(units, input, codeChunks = []) {
       lines.push("");
     });
   }
+  lines.push("## Relevant tests", "");
+  if (relevantTests.length === 0) {
+    lines.push("No directly related tests found in the local index.", "");
+  } else {
+    relevantTests.forEach((test, index) => {
+      const symbolText = test.matchedSymbols.length ? `; symbols: ${test.matchedSymbols.slice(0, 6).join(", ")}` : "";
+      lines.push(`${index + 1}. ${test.path}${symbolText}`);
+      lines.push(`   Why it matters: ${test.reason} (${test.strength.toFixed(2)} link strength).`);
+      if (test.sourcePath) lines.push(`   Source: ${test.sourcePath}`);
+      lines.push("");
+    });
+  }
+  lines.push("## Regression memory", "");
+  if (regressionEvents.length === 0) {
+    lines.push("No related regression events found in the local index.", "");
+  } else {
+    regressionEvents.forEach((event, index) => {
+      lines.push(`${index + 1}. ${clipSentence(event.summary, 220)}`);
+      lines.push(`   Evidence: PR #${event.prNumber}, signals: ${event.signals.join(", ")}`);
+      lines.push(`   Files: ${event.filePaths.slice(0, 5).join(", ") || "n/a"}`);
+      if (event.testPaths.length > 0) {
+        lines.push(`   Tests: ${event.testPaths.slice(0, 5).join(", ")}`);
+      }
+      lines.push(`   Link: ${event.prUrl}`);
+      lines.push("");
+    });
+  }
   lines.push("## Risks", "");
   const risks = riskLines(units);
   if (risks.length === 0) {
@@ -1724,13 +2970,36 @@ function formatAnchorContext(units, input, codeChunks = []) {
         id: unit.id,
         score: unit.score,
         confidence: unit.confidence,
+        confidenceLevel: unit.confidenceLevel,
+        confidenceReasons: unit.confidenceReasons,
+        freshnessStatus: unit.freshnessStatus,
+        freshnessReason: unit.freshnessReason,
+        evidence: unit.evidence,
+        claimKey: unit.claimKey,
+        repeatedEvidenceCount: unit.repeatedEvidenceCount,
         category: unit.category,
         prNumber: unit.prNumber,
         prUrl: unit.prUrl,
         sourceType: unit.sourceType,
         filePaths: unit.filePaths,
         symbols: unit.symbols,
-        duplicateCount: unit.duplicateCount
+        duplicateCount: unit.duplicateCount,
+        matchReasons: unit.matchReasons,
+        rankSignals: unit.rankSignals
+      })),
+      teamRules: teamRules.map((rule) => ({
+        id: rule.id,
+        score: rule.score,
+        confidenceLevel: rule.confidenceLevel,
+        confidenceReasons: rule.confidenceReasons,
+        freshnessStatus: rule.freshnessStatus,
+        freshnessReason: rule.freshnessReason,
+        category: rule.category,
+        filePaths: rule.filePaths,
+        symbols: rule.symbols,
+        evidence: rule.evidence,
+        matchReasons: rule.matchReasons,
+        rankSignals: rule.rankSignals
       })),
       codeEvidence: codeChunks.map((chunk) => ({
         id: chunk.id,
@@ -1739,8 +3008,32 @@ function formatAnchorContext(units, input, codeChunks = []) {
         language: chunk.language,
         startLine: chunk.startLine,
         endLine: chunk.endLine,
-        symbols: chunk.symbols
-      }))
+        symbols: chunk.symbols,
+        matchReasons: chunk.matchReasons,
+        rankSignals: chunk.rankSignals
+      })),
+      relevantTests: relevantTests.map((test) => ({
+        path: test.path,
+        sourcePath: test.sourcePath,
+        reason: test.reason,
+        strength: test.strength,
+        score: test.score,
+        matchedSymbols: test.matchedSymbols
+      })),
+      regressionEvents: regressionEvents.map((event) => ({
+        id: event.id,
+        score: event.score,
+        prNumber: event.prNumber,
+        prUrl: event.prUrl,
+        filePaths: event.filePaths,
+        symbols: event.symbols,
+        testPaths: event.testPaths,
+        summary: clipSentence(event.summary, 260),
+        matchReasons: event.matchReasons,
+        rankSignals: event.rankSignals
+      })),
+      queryTerms: buildQueryTerms(input),
+      ...extraMetadata
     }
   };
 }
@@ -1773,7 +3066,9 @@ function formatSearchHistory(units) {
         sourceType: unit.sourceType,
         sanitizedSnippet: clipSentence(unit.sanitizedText, 260),
         matchedFiles: unit.filePaths,
-        matchedSymbols: unit.symbols
+        matchedSymbols: unit.symbols,
+        matchReasons: unit.matchReasons,
+        rankSignals: unit.rankSignals
       }))
     }
   };
@@ -1790,14 +3085,202 @@ function formatIndexStatus(status) {
     `- Wisdom units: ${status.wisdomUnitCount}`,
     `- Code files: ${status.codeFileCount}`,
     `- Code chunks: ${status.codeChunkCount}`,
+    `- Test files: ${status.testFileCount}`,
+    `- Test links: ${status.testLinkCount}`,
+    `- Regression events: ${status.regressionEventCount}`,
+    `- History coverage: ${status.historyCoverage ?? "unknown"}`,
+    `- History limit: ${status.historyLimit ?? "n/a"}`,
+    `- Stale evidence: ${status.staleEvidenceCount}`,
+    `- Team rules: ${status.teamRuleCount}`,
     `- Last sync: ${status.lastSyncTime ?? "never"}`,
     `- Last code index: ${status.lastCodeIndexTime ?? "never"}`,
+    `- Last rule index: ${status.lastRuleIndexTime ?? "never"}`,
+    `- Last successful index run: ${status.lastSuccessfulRun ?? "never"}`,
+    `- Last failed index run: ${status.lastFailedRun ?? "never"}`,
+    `- Stale code index: ${status.staleCodeIndex ? "yes" : "no"}`,
+    `- Suggested next command: ${status.suggestedNextCommand ?? "n/a"}`,
     `- GitHub token configured: ${status.githubTokenConfigured ? "yes" : "no"}`,
     `- Health: ${status.health}`
   ];
   return { markdown: lines.join("\n"), metadata: status };
 }
 
+// src/retrieval/semantic.ts
+function getSemanticStatus(env = process.env, provider) {
+  if (env.ANCHOR_SEMANTIC !== "local") {
+    return {
+      enabled: false,
+      mode: "disabled",
+      available: false,
+      reason: "Semantic search is disabled; SQLite FTS is active."
+    };
+  }
+  if (!provider || !provider.isAvailable()) {
+    return {
+      enabled: true,
+      mode: "local",
+      available: false,
+      reason: "Local semantic search requested, but no local embedding provider is available; falling back to SQLite FTS."
+    };
+  }
+  return {
+    enabled: true,
+    mode: "local",
+    available: true,
+    reason: `Using local embedding provider: ${provider.name}.`
+  };
+}
+
+// src/retrieval/context.ts
+function buildAnchorContextResult(db, cwd, input, warnings = []) {
+  const history = rankWisdomUnits(db, input);
+  const code = rankCodeChunks(db, input);
+  const rules = rankTeamRules(db, cwd, input);
+  const tests = rankRelevantTests(db, input);
+  const regressions = rankRegressionEvents(db, input);
+  const indexStatus = getIndexStatus(cwd);
+  const semanticStatus = getSemanticStatus();
+  const strictWarnings = input.strict && indexStatus.historyCoverage !== "all" ? [
+    `Strict mode is using ${indexStatus.historyCoverage ?? "unknown"} PR history coverage; run anchor index-all for broader evidence.`
+  ] : [];
+  return formatAnchorContext(
+    history,
+    input,
+    code,
+    rules,
+    [...warnings, ...strictWarnings],
+    tests,
+    regressions,
+    {
+      indexHealth: {
+        historyCoverage: indexStatus.historyCoverage ?? "unknown",
+        staleCodeIndex: Boolean(indexStatus.staleCodeIndex),
+        lastSuccessfulRun: indexStatus.lastSuccessfulRun,
+        lastFailedRun: indexStatus.lastFailedRun
+      },
+      semanticStatus
+    }
+  );
+}
+
+// src/retrieval/explain-file.ts
+function explainFile(db, cwd, input) {
+  const contextInput = {
+    task: `Explain ${input.file}: ownership, constraints, regressions, tests, and important symbols.`,
+    files: [input.file],
+    symbols: input.symbols,
+    strict: input.strict,
+    maxResults: input.maxResults
+  };
+  const code = rankCodeChunks(db, contextInput);
+  const importantSymbols = [...new Set(code.flatMap((chunk) => chunk.symbols))].slice(0, 10);
+  const ownership = code[0]?.sanitizedText ? clipSentence(code[0].sanitizedText, 220) : "No indexed code chunk found for this file.";
+  const context = buildAnchorContextResult(db, cwd, contextInput);
+  const markdown = [
+    "# Anchor File Explain",
+    "",
+    `File: ${input.file}`,
+    `Appears to own: ${ownership}`,
+    `Important symbols: ${importantSymbols.join(", ") || "n/a"}`,
+    "",
+    context.markdown.replace(/^# Anchor Context\n\n/, "")
+  ].join("\n");
+  return {
+    markdown,
+    metadata: {
+      ...context.metadata,
+      mode: "explain_file",
+      file: input.file,
+      importantSymbols
+    }
+  };
+}
+
+// src/retrieval/review-diff.ts
+function filesFromDiff(diff) {
+  const files = [];
+  for (const line of diff.split("\n")) {
+    const match = line.match(/^diff --git a\/(.+?) b\/(.+)$/);
+    if (match?.[2] && match[2] !== "/dev/null") files.push(match[2]);
+    const plus = line.match(/^\+\+\+ b\/(.+)$/);
+    if (plus?.[1] && plus[1] !== "/dev/null") files.push(plus[1]);
+  }
+  return uniqueStrings(files);
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function reviewDiff(db, cwd, input) {
+  const files = input.files?.length ? input.files : filesFromDiff(input.diff);
+  const contextInput = {
+    task: "Review this diff against Anchor history, team rules, regressions, and tests.",
+    files,
+    diff: input.diff,
+    strict: input.strict,
+    maxResults: input.maxResults
+  };
+  const context = buildAnchorContextResult(db, cwd, contextInput);
+  const items = asArray(context.metadata.items);
+  const regressions = asArray(context.metadata.regressionEvents);
+  const tests = asArray(context.metadata.relevantTests);
+  const ruleItems = asArray(context.metadata.teamRules);
+  const blockerRules = ruleItems.filter(
+    (item) => item.freshnessStatus !== "stale" && item.confidenceLevel !== "weak"
+  );
+  const historicalConstraints = items.filter(
+    (item) => ["constraint", "api_contract", "security_note", "architecture_decision"].includes(
+      item.category ?? ""
+    )
+  );
+  const lines = ["# Anchor Diff Review", "", `Changed files: ${files.join(", ") || "n/a"}`, ""];
+  lines.push("## Blockers", "");
+  if (blockerRules.length === 0) lines.push("- No evidence-backed blockers found.");
+  else {
+    for (const rule of blockerRules.slice(0, 4)) {
+      lines.push(`- Team rule evidence may block this change: ${rule.category ?? "rule"}.`);
+    }
+  }
+  lines.push("", "## Risks", "");
+  const riskItems = items.filter(
+    (item) => ["security_note", "bug_regression", "api_contract"].includes(item.category ?? "")
+  );
+  if (riskItems.length === 0) lines.push("- No specific historical risks found.");
+  else {
+    for (const item of riskItems.slice(0, 5)) {
+      lines.push(`- [${item.category}] PR #${item.prNumber}: preserve cited behavior.`);
+    }
+  }
+  lines.push("", "## Historical constraints", "");
+  if (historicalConstraints.length === 0) lines.push("- No matching constraints found.");
+  else {
+    for (const item of historicalConstraints.slice(0, 5)) {
+      lines.push(`- PR #${item.prNumber}: ${item.category} (${item.confidenceLevel}).`);
+    }
+  }
+  lines.push("", "## Regression checks", "");
+  if (regressions.length === 0) lines.push("- No related regression memory found.");
+  else {
+    for (const event of regressions.slice(0, 5)) {
+      lines.push(`- PR #${event.prNumber}: ${clipSentence(event.summary ?? "", 180)}`);
+    }
+  }
+  lines.push("", "## Recommended tests", "");
+  if (tests.length === 0) lines.push("- No related tests found in the local index.");
+  else {
+    for (const test of tests.slice(0, 6)) {
+      lines.push(`- ${test.path ?? "unknown test"} (${test.reason ?? "related"})`);
+    }
+  }
+  return {
+    markdown: lines.join("\n"),
+    metadata: {
+      ...context.metadata,
+      mode: "review_diff",
+      changedFiles: files
+    }
+  };
+}
+
 // src/github/client.ts
 import { Octokit } from "@octokit/rest";
 function createGitHubClient(token) {
@@ -1987,8 +3470,8 @@ async function fetchMergedPullRequests(options) {
 }
 
 // src/doctor.ts
-import fs4 from "fs";
-import path9 from "path";
+import fs5 from "fs";
+import path13 from "path";
 function check(name, ok, message, fix) {
   return { name, ok, message, fix: ok ? void 0 : fix };
 }
@@ -2049,12 +3532,12 @@ async function runDoctor(options) {
       )
     );
   }
-  const cursorConfigPath = path9.join(gitRoot ?? cwd, ".cursor", "mcp.json");
+  const cursorConfigPath = path13.join(gitRoot ?? cwd, ".cursor", "mcp.json");
   let cursorConfig;
   let cursorConfigValid = false;
-  if (fs4.existsSync(cursorConfigPath)) {
+  if (fs5.existsSync(cursorConfigPath)) {
     try {
-      cursorConfig = JSON.parse(fs4.readFileSync(cursorConfigPath, "utf8"));
+      cursorConfig = JSON.parse(fs5.readFileSync(cursorConfigPath, "utf8"));
       cursorConfigValid = true;
     } catch {
       cursorConfigValid = false;
@@ -2063,7 +3546,7 @@ async function runDoctor(options) {
   checks.push(
     check(
       ".cursor/mcp.json valid",
-      fs4.existsSync(cursorConfigPath) && cursorConfigValid,
+      fs5.existsSync(cursorConfigPath) && cursorConfigValid,
       cursorConfigValid ? ".cursor/mcp.json exists and is valid JSON." : ".cursor/mcp.json is missing or invalid.",
       "Run anchor init. If the file is malformed, fix the JSON and rerun anchor init."
     )
@@ -2080,7 +3563,7 @@ async function runDoctor(options) {
     )
   );
   const dbPath = defaultDatabasePath(gitRoot ?? cwd);
-  const dbExists = fs4.existsSync(dbPath);
+  const dbExists = fs5.existsSync(dbPath);
   checks.push(
     check(
       ".anchor/index.sqlite exists",
@@ -2124,30 +3607,72 @@ async function runDoctor(options) {
       "Run pnpm build, then try anchor serve from the repository."
     )
   );
-  const rulePath = path9.join(gitRoot ?? cwd, ".cursor", "rules", "anchor.mdc");
+  const rulePath = path13.join(gitRoot ?? cwd, ".cursor", "rules", "anchor.mdc");
   checks.push(
     check(
       "Cursor rule file exists",
-      fs4.existsSync(rulePath),
-      fs4.existsSync(rulePath) ? "Cursor rule file exists." : "Cursor rule file is missing.",
+      fs5.existsSync(rulePath),
+      fs5.existsSync(rulePath) ? "Cursor rule file exists." : "Cursor rule file is missing.",
       "Run anchor init to create .cursor/rules/anchor.mdc."
     )
   );
   return { ok: checks.every((item) => item.ok), checks };
 }
+
+// src/health.ts
+function evaluateIndexHealth(status, rulesOk) {
+  const warnings = [];
+  if (status.health === "missing_database") warnings.push("Anchor database is missing.");
+  if (status.health === "schema_invalid") warnings.push("Anchor SQLite schema is invalid.");
+  if (status.health === "empty_index") warnings.push("Anchor index is empty.");
+  if (status.historyCoverage !== "all") warnings.push("PR history coverage is partial.");
+  if (status.staleCodeIndex) warnings.push("Code index is older than 7 days or has never run.");
+  if (!rulesOk) warnings.push("Team rules file is missing or invalid.");
+  if (status.lastFailedRun) warnings.push(`Last failed index run: ${status.lastFailedRun}.`);
+  const hasError = status.health === "missing_database" || status.health === "schema_invalid";
+  const healthStatus = hasError ? "error" : warnings.length > 0 ? "warning" : "ok";
+  return {
+    status: healthStatus,
+    warnings,
+    suggestedNextCommand: status.suggestedNextCommand,
+    historyCoverage: status.historyCoverage ?? "unknown",
+    staleCodeIndex: Boolean(status.staleCodeIndex),
+    lastSuccessfulRun: status.lastSuccessfulRun,
+    lastFailedRun: status.lastFailedRun
+  };
+}
+function getAnchorIndexHealth(cwd) {
+  const indexStatus = getIndexStatus(cwd);
+  const rulesValidation = validateTeamRulesFile(cwd);
+  return {
+    ...evaluateIndexHealth(indexStatus, rulesValidation.ok),
+    indexStatus
+  };
+}
 export {
   ANCHOR_CURSOR_RULE,
   DEFAULT_MAX_CODE_FILE_BYTES,
   SCHEMA_SQL,
+  TEAM_RULES_FILE,
+  addTeamRule,
   anchorMcpEntry,
+  buildAnchorContextResult,
   buildFtsQuery,
+  buildQueryTerms,
   canonicalizeText,
   categorizeWisdom,
   checkSchema,
+  checkTeamRuleEvidence,
   chunkCodeFile,
   chunkHistoricalText,
+  claimKeyFor,
   clampMaxResults,
   clipSentence,
+  confidenceAtLeast,
+  confidenceLevelFor,
+  confidenceRank,
+  confidenceReasonsFor,
+  countValidTeamRules,
   createGitHubClient,
   defaultDatabasePath,
   detectGitHubRepo,
@@ -2158,42 +3683,62 @@ export {
   ensureCursorConfig,
   ensureCursorRule,
   ensureRepository,
+  ensureTeamRulesFile,
+  evaluateFreshness,
+  evaluateIndexHealth,
+  evidenceForWisdom,
+  explainFile,
   extractCodeSymbols,
+  extractRegressionEvents,
   extractSymbols,
   extractWisdomUnits,
   fetchMergedPullRequests,
   fetchPullRequestDetails,
+  filesFromDiff,
   formatAnchorContext,
   formatIndexStatus,
   formatSearchHistory,
+  getAnchorIndexHealth,
   getIndexStatus,
   getLastSyncTime,
+  getSemanticStatus,
   githubAuthFixMessage,
   hasHighSignalLanguage,
   indexCodebase,
   indexPullRequests,
+  inferTestAwareness,
   initializeSchema,
   isHardExcludedCodePath,
+  isTestFilePath,
+  loadCurrentCodeSnapshot,
+  loadTeamRulesFile,
   mergeAnchorMcpConfig,
   normalizePullRequest,
   openAnchorDatabase,
   parseGitHubRemote,
   rankCodeChunks,
+  rankRegressionEvents,
+  rankRelevantTests,
+  rankTeamRules,
   rankWisdomUnits,
+  recordIndexRun,
   redactSecrets,
   redactedHistoricalText,
   replaceCodeIndex,
   resolveGitHubToken,
   resolvePullRequestDetailConcurrency,
   resolvePullRequestFetchLimit,
+  reviewDiff,
   runDoctor,
   sanitizeHistoricalText,
   shouldSyncSince,
+  sourceTypeLabel,
   stripPromptInjection,
   tokenizeSearchText,
   truncateText,
   uniqueStrings,
   updateSyncState,
-  upsertPullRequest
+  upsertPullRequest,
+  validateTeamRulesFile
 };
 //# sourceMappingURL=index.js.map