@ctxo/cli 0.9.3 → 0.11.0

package/README.md

@@ -58,6 +58,63 @@ Full-stack analytics UI with eight views: File Tree, Heatmap, Co-Changes, Timeli
 
 [Open Dependency Graph](https://alperhankendi.github.io/Ctxo/visualize.html)
 
+## Safe-Edit Guard
+
+AI agents don't fail because they can't code. They fail because they code blind. Ctxo gives them the full picture before they write a single line.
+
+The problem: an agent opens a file, makes a targeted edit, and walks away. It never checked what else depends on that symbol. Downstream callers silently break. Tests pass because the agent only ran the ones in the same file.
+
+The safe-edit guard closes this loop deterministically. When you run `ctxo init`, it:
+
+1. Registers a **PreToolUse hook** in `.claude/settings.json` (Claude Code) that intercepts every Edit call.
+2. Installs three **model-invoked skills** (`ctxo-understand`, `ctxo-safe-edit`, `ctxo-review-pr`) so the agent knows when to check blast radius, history, and PR risk.
+
+If an agent tries to edit a high-impact symbol without first calling `get_blast_radius`, the hook blocks the edit and tells the agent what to check. Once the agent runs the tool, the edit goes through normally. Fires once per symbol per session, fail-open on any uncertainty.
+
+**Tune it:**
+
+```shell
+# Preview which symbols the guard would flag at current sensitivity
+ctxo gate --preview
+
+# Check blast radius for a specific symbol (pipe to jq, CI scripts, etc.)
+ctxo blast-radius "src/core/graph.ts::buildGraph::function" --json
+```
+
+Configure sensitivity in `.ctxo/config.yaml`:
+
+```yaml
+gate:
+  enabled: true
+  sensitivity: balanced   # strict | balanced (DEFAULT) | lenient
+```
+
+**Platform matrix:**
+
+| Platform | Hook enforcement | Skills | Rules |
+|---|---|---|---|
+| Claude Code | yes (PreToolUse blocks) | yes | yes |
+| Cursor | no (no blocking pre-edit hook) | yes | yes |
+| Other | no | where supported | yes |
+
+## Supported Languages
+
+| Language | Plugin | Tier | Notes |
+|---|---|---|---|
+| TypeScript / JavaScript | `@ctxo/lang-typescript` | full | ts-morph; type-aware cross-file resolution |
+| Go | `@ctxo/lang-go` | syntax | tree-sitter; exported-symbol analysis |
+| C# | `@ctxo/lang-csharp` | full | Roslyn; .NET SDK 8+ for full tier, tree-sitter fallback |
+| Java | `@ctxo/lang-java` | syntax / full | tree-sitter syntax tier built-in; full tier via `@ctxo/lang-java-analyzer` companion (requires JRE 17+) |
+
+Install via the CLI shortcut:
+
+```bash
+ctxo install typescript go csharp   # syntax or full tier auto-detected
+ctxo install java                   # installs syntax tier; adds full-tier analyzer when JRE 17+ detected
+ctxo install java --full-tier       # force full-tier analyzer install
+ctxo install java --syntax-only     # skip analyzer, syntax tier only
+```
+
 ## Links
 
 * [Docs](https://alperhankendi.github.io/Ctxo/docs/)  quick start, MCP tools, CLI reference, integrations

package/dist/{atomic-write-AQNYJFAG.js → atomic-write-BAFH464Q.js}

@@ -2,9 +2,10 @@
 import {
   atomicWrite,
   sweepStaleTmpFiles
-} from "./chunk-6EKERTJ7.js";
+} from "./chunk-RFEXMBTG.js";
+import "./chunk-5DSKZJNN.js";
 export {
   atomicWrite,
   sweepStaleTmpFiles
 };
-//# sourceMappingURL=atomic-write-AQNYJFAG.js.map
+//# sourceMappingURL=atomic-write-BAFH464Q.js.map

package/dist/chunk-5DSKZJNN.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+// src/core/logger.ts
+function isDebugEnabled(namespace) {
+  const debugEnv = process.env["DEBUG"] ?? "";
+  if (!debugEnv) return false;
+  const patterns = debugEnv.split(",").map((p) => p.trim());
+  return patterns.some((p) => {
+    if (p === "*" || p === "ctxo:*") return true;
+    if (p === namespace) return true;
+    if (p.endsWith(":*") && namespace.startsWith(p.slice(0, -1))) return true;
+    return false;
+  });
+}
+function createLogger(namespace) {
+  const prefix = `[${namespace}]`;
+  return {
+    debug(message, ...args) {
+      if (isDebugEnabled(namespace)) {
+        console.error(`${prefix} DEBUG ${message}`, ...args);
+      }
+    },
+    info(message, ...args) {
+      console.error(`${prefix} ${message}`, ...args);
+    },
+    warn(message, ...args) {
+      console.error(`${prefix} WARN ${message}`, ...args);
+    },
+    error(message, ...args) {
+      console.error(`${prefix} ERROR ${message}`, ...args);
+    }
+  };
+}
+
+export {
+  createLogger
+};
+//# sourceMappingURL=chunk-5DSKZJNN.js.map

package/dist/chunk-5DSKZJNN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/logger.ts"],"sourcesContent":["/**\n * Structured logger for Ctxo — all output goes to stderr (stdout reserved for MCP JSON-RPC).\n *\n * Supports debug mode via DEBUG environment variable:\n *   DEBUG=ctxo:*          — all debug output\n *   DEBUG=ctxo:git        — only git adapter debug\n *   DEBUG=ctxo:index      — only indexing debug\n *   DEBUG=ctxo:mcp        — only MCP handler debug\n *   DEBUG=ctxo:storage    — only storage adapter debug\n *   DEBUG=ctxo:masking    — only masking pipeline debug\n *\n * Always outputs: info, warn, error (regardless of DEBUG).\n * Only outputs debug when matching namespace is enabled.\n */\n\nfunction isDebugEnabled(namespace: string): boolean {\n  const debugEnv = process.env['DEBUG'] ?? '';\n  if (!debugEnv) return false;\n  const patterns = debugEnv.split(',').map(p => p.trim());\n  return patterns.some(p => {\n    if (p === '*' || p === 'ctxo:*') return true;\n    if (p === namespace) return true;\n    if (p.endsWith(':*') && namespace.startsWith(p.slice(0, -1))) return true;\n    return false;\n  });\n}\n\nexport interface Logger {\n  debug(message: string, ...args: unknown[]): void;\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n}\n\nexport function createLogger(namespace: string): Logger {\n  const prefix = `[${namespace}]`;\n\n  return {\n    debug(message: string, ...args: unknown[]) {\n      if (isDebugEnabled(namespace)) {\n        console.error(`${prefix} DEBUG ${message}`, ...args);\n      }\n    },\n    info(message: string, ...args: unknown[]) {\n      console.error(`${prefix} ${message}`, ...args);\n    },\n    warn(message: string, ...args: unknown[]) {\n      console.error(`${prefix} WARN ${message}`, ...args);\n    },\n    error(message: string, ...args: unknown[]) {\n      console.error(`${prefix} ERROR ${message}`, ...args);\n    },\n  };\n}\n"],"mappings":";;;AAeA,SAAS,eAAe,WAA4B;AAClD,QAAM,WAAW,QAAQ,IAAI,OAAO,KAAK;AACzC,MAAI,CAAC,SAAU,QAAO;AACtB,QAAM,WAAW,SAAS,MAAM,GAAG,EAAE,IAAI,OAAK,EAAE,KAAK,CAAC;AACtD,SAAO,SAAS,KAAK,OAAK;AACxB,QAAI,MAAM,OAAO,MAAM,SAAU,QAAO;AACxC,QAAI,MAAM,UAAW,QAAO;AAC5B,QAAI,EAAE,SAAS,IAAI,KAAK,UAAU,WAAW,EAAE,MAAM,GAAG,EAAE,CAAC,EAAG,QAAO;AACrE,WAAO;AAAA,EACT,CAAC;AACH;AASO,SAAS,aAAa,WAA2B;AACtD,QAAM,SAAS,IAAI,SAAS;AAE5B,SAAO;AAAA,IACL,MAAM,YAAoB,MAAiB;AACzC,UAAI,eAAe,SAAS,GAAG;AAC7B,gBAAQ,MAAM,GAAG,MAAM,UAAU,OAAO,IAAI,GAAG,IAAI;AAAA,MACrD;AAAA,IACF;AAAA,IACA,KAAK,YAAoB,MAAiB;AACxC,cAAQ,MAAM,GAAG,MAAM,IAAI,OAAO,IAAI,GAAG,IAAI;AAAA,IAC/C;AAAA,IACA,KAAK,YAAoB,MAAiB;AACxC,cAAQ,MAAM,GAAG,MAAM,SAAS,OAAO,IAAI,GAAG,IAAI;AAAA,IACpD;AAAA,IACA,MAAM,YAAoB,MAAiB;AACzC,cAAQ,MAAM,GAAG,MAAM,UAAU,OAAO,IAAI,GAAG,IAAI;AAAA,IACrD;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-2TVHKCCU.js → chunk-CDGQGCVN.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  createLogger
+} from "./chunk-5DSKZJNN.js";
 
 // src/adapters/storage/json-index-reader.ts
 import { readFileSync, readdirSync, existsSync, realpathSync } from "fs";
@@ -39,6 +42,16 @@ var SymbolIdSchema = z.string().min(1).refine(
   },
   { message: 'Symbol ID must match format "<file>::<name>::<kind>"' }
 );
+var EdgeTargetSchema = z.string().refine(
+  (s) => {
+    const parts = s.split("::");
+    if (parts.length !== 3 && parts.length !== 2) return false;
+    if (parts.some((p) => p.length === 0)) return false;
+    const kind = parts[parts.length - 1];
+    return SYMBOL_KINDS.includes(kind);
+  },
+  { message: "edge target must be <file>::<name>::<kind> or <name>::<kind>" }
+);
 var SymbolNodeSchema = z.object({
   symbolId: SymbolIdSchema,
   name: z.string().min(1),
@@ -52,7 +65,9 @@ var SymbolNodeSchema = z.object({
 });
 var GraphEdgeSchema = z.object({
   from: SymbolIdSchema,
-  to: SymbolIdSchema,
+  // strict 3-part: from is always a local, resolved symbol
+  to: EdgeTargetSchema,
+  // 3-part OR 2-part name-ref for cross-file/unresolved targets
   kind: EdgeKindSchema,
   typeOnly: z.boolean().optional()
 });
@@ -83,6 +98,7 @@ var FileIndexSchema = z.object({
 });
 
 // src/adapters/storage/json-index-reader.ts
+var log = createLogger("ctxo:json-reader");
 var JsonIndexReader = class {
   indexDir;
   constructor(ctxoRoot) {
@@ -107,14 +123,48 @@ var JsonIndexReader = class {
       const raw = readFileSync(absolutePath, "utf-8");
       const data = JSON.parse(raw);
       const result = FileIndexSchema.safeParse(data);
-      if (!result.success) {
-        const rel = relative(this.indexDir, absolutePath);
+      if (result.success) {
+        return result.data;
+      }
+      const rel = relative(this.indexDir, absolutePath);
+      const raw_data = data;
+      if (typeof raw_data["file"] !== "string" || !raw_data["file"] || typeof raw_data["lastModified"] !== "number") {
+        console.error(
+          `[ctxo:json-reader] Invalid schema in ${rel}: ${result.error.message}`
+        );
+        return void 0;
+      }
+      const rawSymbols = Array.isArray(raw_data["symbols"]) ? raw_data["symbols"] : [];
+      const rawEdges = Array.isArray(raw_data["edges"]) ? raw_data["edges"] : [];
+      const rawIntent = Array.isArray(raw_data["intent"]) ? raw_data["intent"] : [];
+      const rawAntiPatterns = Array.isArray(raw_data["antiPatterns"]) ? raw_data["antiPatterns"] : [];
+      const validSymbols = rawSymbols.filter((s) => SymbolNodeSchema.safeParse(s).success);
+      const validEdges = rawEdges.filter((e) => GraphEdgeSchema.safeParse(e).success);
+      const validIntent = rawIntent.filter((i) => CommitIntentSchema.safeParse(i).success);
+      const validAntiPatterns = rawAntiPatterns.filter((a) => AntiPatternSchema.safeParse(a).success);
+      const droppedSymbols = rawSymbols.length - validSymbols.length;
+      const droppedEdges = rawEdges.length - validEdges.length;
+      const droppedIntent = rawIntent.length - validIntent.length;
+      const droppedAntiPatterns = rawAntiPatterns.length - validAntiPatterns.length;
+      if (droppedSymbols > 0 || droppedEdges > 0 || droppedIntent > 0 || droppedAntiPatterns > 0) {
+        log.warn(
+          `${rel}: dropped ${droppedSymbols} invalid symbol(s), ${droppedEdges} invalid edge(s), ${droppedIntent} invalid intent(s), ${droppedAntiPatterns} invalid antiPattern(s) \u2014 kept ${validSymbols.length} symbol(s), ${validEdges.length} edge(s), ${validIntent.length} intent(s), ${validAntiPatterns.length} antiPattern(s)`
+        );
+      }
+      const recovered = FileIndexSchema.safeParse({
+        ...raw_data,
+        symbols: validSymbols,
+        edges: validEdges,
+        intent: validIntent,
+        antiPatterns: validAntiPatterns
+      });
+      if (!recovered.success) {
         console.error(
           `[ctxo:json-reader] Invalid schema in ${rel}: ${result.error.message}`
         );
         return void 0;
       }
-      return result.data;
+      return recovered.data;
     } catch (err) {
       const rel = relative(this.indexDir, absolutePath);
       console.error(
@@ -146,4 +196,4 @@ export {
   DetailLevelSchema,
   JsonIndexReader
 };
-//# sourceMappingURL=chunk-2TVHKCCU.js.map
+//# sourceMappingURL=chunk-CDGQGCVN.js.map

package/dist/chunk-CDGQGCVN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/storage/json-index-reader.ts","../src/core/types.ts"],"sourcesContent":["import { readFileSync, readdirSync, existsSync, realpathSync } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport {\n  FileIndexSchema,\n  SymbolNodeSchema,\n  GraphEdgeSchema,\n  CommitIntentSchema,\n  AntiPatternSchema,\n  type FileIndex,\n} from '../../core/types.js';\nimport { createLogger } from '../../core/logger.js';\n\nconst log = createLogger('ctxo:json-reader');\n\nexport class JsonIndexReader {\n  private readonly indexDir: string;\n\n  constructor(ctxoRoot: string) {\n    this.indexDir = join(ctxoRoot, 'index');\n  }\n\n  readAll(): FileIndex[] {\n    if (!existsSync(this.indexDir)) {\n      return [];\n    }\n\n    const jsonFiles = this.collectJsonFiles(this.indexDir);\n    const results: FileIndex[] = [];\n\n    for (const filePath of jsonFiles) {\n      const parsed = this.readSingle(filePath);\n      if (parsed) {\n        results.push(parsed);\n      }\n    }\n\n    return results;\n  }\n\n  readSingle(absolutePath: string): FileIndex | undefined {\n    try {\n      const raw = readFileSync(absolutePath, 'utf-8');\n      const data: unknown = JSON.parse(raw);\n      const result = FileIndexSchema.safeParse(data);\n\n      if (result.success) {\n        return result.data;\n      }\n\n      // Strict parse failed — attempt resilient recovery: keep valid items, drop invalid ones.\n      const rel = relative(this.indexDir, absolutePath);\n      const raw_data = data as Record<string, unknown>;\n\n      // Must have at least a valid file name and lastModified to be recoverable.\n      if (typeof raw_data['file'] !== 'string' || !raw_data['file'] ||\n          typeof raw_data['lastModified'] !== 'number') {\n        console.error(\n          `[ctxo:json-reader] Invalid schema in ${rel}: ${result.error.message}`,\n        );\n        return undefined;\n      }\n\n      const rawSymbols = Array.isArray(raw_data['symbols']) ? raw_data['symbols'] : [];\n      const rawEdges = Array.isArray(raw_data['edges']) ? raw_data['edges'] : [];\n      const rawIntent = Array.isArray(raw_data['intent']) ? raw_data['intent'] : [];\n      const rawAntiPatterns = Array.isArray(raw_data['antiPatterns']) ? raw_data['antiPatterns'] : [];\n\n      const validSymbols = rawSymbols.filter((s) => SymbolNodeSchema.safeParse(s).success);\n      const validEdges = rawEdges.filter((e) => GraphEdgeSchema.safeParse(e).success);\n      const validIntent = rawIntent.filter((i) => CommitIntentSchema.safeParse(i).success);\n      const validAntiPatterns = rawAntiPatterns.filter((a) => AntiPatternSchema.safeParse(a).success);\n\n      const droppedSymbols = rawSymbols.length - validSymbols.length;\n      const droppedEdges = rawEdges.length - validEdges.length;\n      const droppedIntent = rawIntent.length - validIntent.length;\n      const droppedAntiPatterns = rawAntiPatterns.length - validAntiPatterns.length;\n\n      if (droppedSymbols > 0 || droppedEdges > 0 || droppedIntent > 0 || droppedAntiPatterns > 0) {\n        log.warn(\n          `${rel}: dropped ${droppedSymbols} invalid symbol(s), ${droppedEdges} invalid edge(s), ${droppedIntent} invalid intent(s), ${droppedAntiPatterns} invalid antiPattern(s) — kept ${validSymbols.length} symbol(s), ${validEdges.length} edge(s), ${validIntent.length} intent(s), ${validAntiPatterns.length} antiPattern(s)`,\n        );\n      }\n\n      // Re-parse with the filtered arrays to get a fully-typed FileIndex.\n      const recovered = FileIndexSchema.safeParse({\n        ...raw_data,\n        symbols: validSymbols,\n        edges: validEdges,\n        intent: validIntent,\n        antiPatterns: validAntiPatterns,\n      });\n\n      if (!recovered.success) {\n        console.error(\n          `[ctxo:json-reader] Invalid schema in ${rel}: ${result.error.message}`,\n        );\n        return undefined;\n      }\n\n      return recovered.data;\n    } catch (err) {\n      const rel = relative(this.indexDir, absolutePath);\n      console.error(\n        `[ctxo:json-reader] Failed to read ${rel}: ${(err as Error).message}`,\n      );\n      return undefined;\n    }\n  }\n\n  private collectJsonFiles(dir: string, visited: Set<string> = new Set()): string[] {\n    const realDir = realpathSync(dir);\n    if (visited.has(realDir)) return []; // Guard against symlink loops\n    visited.add(realDir);\n\n    const files: string[] = [];\n\n    for (const entry of readdirSync(dir, { withFileTypes: true })) {\n      if (entry.isSymbolicLink()) continue; // Skip symlinks entirely\n\n      const fullPath = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        // Skip non-FileIndex directories under .ctxo/index/\n        if (entry.name === 'communities.history') continue;\n        files.push(...this.collectJsonFiles(fullPath, visited));\n      } else if (\n        entry.name.endsWith('.json') &&\n        entry.name !== 'co-changes.json' &&\n        entry.name !== 'communities.json' &&\n        entry.name !== 'drift-events.json' &&\n        entry.name !== 'boundary-violations.json'\n      ) {\n        files.push(fullPath);\n      }\n    }\n\n    return files;\n  }\n}\n","import { z } from 'zod';\n\n// ── Symbol Kinds ────────────────────────────────────────────────\n\nexport const SYMBOL_KINDS = [\n  'function',\n  'class',\n  'interface',\n  'method',\n  'variable',\n  'type',\n] as const;\n\nexport const SymbolKindSchema = z.enum(SYMBOL_KINDS);\nexport type SymbolKind = z.infer<typeof SymbolKindSchema>;\n\n// ── Edge Kinds ──────────────────────────────────────────────────\n\nexport const EDGE_KINDS = [\n  'imports',\n  'calls',\n  'extends',\n  'implements',\n  'uses',\n] as const;\n\nexport const EdgeKindSchema = z.enum(EDGE_KINDS);\nexport type EdgeKind = z.infer<typeof EdgeKindSchema>;\n\n// ── Detail Levels ───────────────────────────────────────────────\n\nexport const DETAIL_LEVELS = [1, 2, 3, 4] as const;\n\nexport const DetailLevelSchema = z.union([\n  z.literal(1),\n  z.literal(2),\n  z.literal(3),\n  z.literal(4),\n]);\nexport type DetailLevel = z.infer<typeof DetailLevelSchema>;\n\n// ── Symbol ID ───────────────────────────────────────────────────\n\n/**\n * Format: \"<relativeFile>::<name>::<kind>\"\n * Example: \"src/foo.ts::myFn::function\"\n */\nexport const SymbolIdSchema = z\n  .string()\n  .min(1)\n  .refine(\n    (value) => {\n      const parts = value.split('::');\n      if (parts.length !== 3) return false;\n      const [file, name, kind] = parts;\n      if (!file || !name || !kind) return false;\n      return SymbolKindSchema.safeParse(kind).success;\n    },\n    { message: 'Symbol ID must match format \"<file>::<name>::<kind>\"' },\n  );\nexport type SymbolId = z.infer<typeof SymbolIdSchema>;\n\n// ── Edge Target ─────────────────────────────────────────────────\n\n/**\n * An edge target: either a full 3-part symbol ID (\"<file>::<name>::<kind>\")\n * or a 2-part name-reference (\"<name>::<kind>\") for cross-file / unresolved\n * targets. The graph builder resolves name-references by name at query time.\n */\nexport const EdgeTargetSchema = z.string().refine(\n  (s) => {\n    const parts = s.split('::');\n    if (parts.length !== 3 && parts.length !== 2) return false;\n    if (parts.some((p) => p.length === 0)) return false;\n    const kind = parts[parts.length - 1];\n    return (SYMBOL_KINDS as readonly string[]).includes(kind as string);\n  },\n  { message: 'edge target must be <file>::<name>::<kind> or <name>::<kind>' },\n);\nexport type EdgeTarget = z.infer<typeof EdgeTargetSchema>;\n\n// ── Symbol Node ─────────────────────────────────────────────────\n\nexport const SymbolNodeSchema = z\n  .object({\n    symbolId: SymbolIdSchema,\n    name: z.string().min(1),\n    kind: SymbolKindSchema,\n    startLine: z.number().int().nonnegative(),\n    endLine: z.number().int().nonnegative(),\n    startOffset: z.number().int().nonnegative().optional(),\n    endOffset: z.number().int().nonnegative().optional(),\n  })\n  .refine((node) => node.endLine >= node.startLine, {\n    message: 'endLine must be >= startLine',\n  });\nexport type SymbolNode = z.infer<typeof SymbolNodeSchema>;\n\n// ── Graph Edge ──────────────────────────────────────────────────\n\nexport const GraphEdgeSchema = z.object({\n  from: SymbolIdSchema,    // strict 3-part: from is always a local, resolved symbol\n  to: EdgeTargetSchema,    // 3-part OR 2-part name-ref for cross-file/unresolved targets\n  kind: EdgeKindSchema,\n  typeOnly: z.boolean().optional(),\n});\nexport type GraphEdge = z.infer<typeof GraphEdgeSchema>;\n\n// ── Commit Intent ───────────────────────────────────────────────\n\nexport const CommitIntentSchema = z.object({\n  hash: z.string().min(1),\n  message: z.string(),\n  date: z.string().min(1),\n  kind: z.literal('commit'),\n});\nexport type CommitIntent = z.infer<typeof CommitIntentSchema>;\n\n// ── Anti-Pattern ────────────────────────────────────────────────\n\nexport const AntiPatternSchema = z.object({\n  hash: z.string().min(1),\n  message: z.string(),\n  date: z.string().min(1),\n});\nexport type AntiPattern = z.infer<typeof AntiPatternSchema>;\n\n// ── File Index ──────────────────────────────────────────────────\n\nexport const ComplexityMetricsSchema = z.object({\n  symbolId: z.string().min(1),\n  cyclomatic: z.number().nonnegative(),\n});\n\nexport const FileIndexSchema = z.object({\n  file: z.string().min(1),\n  lastModified: z.number().nonnegative(),\n  contentHash: z.string().optional(),\n  symbols: z.array(SymbolNodeSchema),\n  edges: z.array(GraphEdgeSchema),\n  complexity: z.array(ComplexityMetricsSchema).optional(),\n  intent: z.array(CommitIntentSchema),\n  antiPatterns: z.array(AntiPatternSchema),\n});\nexport type FileIndex = z.infer<typeof FileIndexSchema>;\n\n// ── Logic-Slice Result ──────────────────────────────────────────\n\nexport interface LogicSliceResult {\n  readonly root: SymbolNode;\n  readonly dependencies: readonly SymbolNode[];\n  readonly edges: readonly GraphEdge[];\n}\n\n// ── Formatted Slice ─────────────────────────────────────────────\n\nexport interface TruncationInfo {\n  readonly truncated: true;\n  readonly reason: 'token_budget_exceeded';\n}\n\nexport interface FormattedSlice {\n  readonly root: SymbolNode;\n  readonly dependencies: readonly SymbolNode[];\n  readonly edges: readonly GraphEdge[];\n  readonly level: DetailLevel;\n  readonly levelDescription?: string;\n  readonly truncation?: TruncationInfo;\n}\n\n// ── Complexity & Churn ──────────────────────────────────────────\n\nexport interface ComplexityMetrics {\n  readonly symbolId: string;\n  readonly cyclomatic: number;\n}\n\nexport interface ChurnData {\n  readonly filePath: string;\n  readonly commitCount: number;\n}\n\nexport const SCORE_BANDS = ['low', 'medium', 'high'] as const;\nexport type ScoreBand = (typeof SCORE_BANDS)[number];\n\nexport interface ChangeIntelligenceScore {\n  readonly symbolId: string;\n  readonly complexity: number;\n  readonly churn: number;\n  readonly composite: number;\n  readonly band: ScoreBand;\n}\n\n// ── Why-Context Result ──────────────────────────────────────────\n\nexport interface WhyContextResult {\n  readonly commitHistory: readonly CommitIntent[];\n  readonly antiPatternWarnings: readonly AntiPattern[];\n  readonly changeIntelligence?: ChangeIntelligenceScore;\n}\n\n// ── Co-Change Analysis ─────────────────────────────────────────\n\nexport interface CoChangeEntry {\n  readonly file1: string;\n  readonly file2: string;\n  readonly sharedCommits: number;\n  readonly frequency: number;\n}\n\nexport interface CoChangeMatrix {\n  readonly version: 1;\n  readonly timestamp: number;\n  readonly entries: readonly CoChangeEntry[];\n}\n\n// ── Commit Record (from git adapter) ────────────────────────────\n\nexport interface CommitRecord {\n  readonly hash: string;\n  readonly message: string;\n  readonly date: string;\n  readonly author: string;\n}\n\n// ── Blame Line (from git adapter) ───────────────────────────────\n\nexport interface BlameLine {\n  readonly hash: string;\n  readonly lineNumber: number;\n  readonly author: string;\n  readonly date: string;\n}\n\n// ── Search Types ───────────────────────────────────────────────\n\nexport interface SearchResult {\n  symbolId: string;\n  name: string;\n  kind: string;\n  filePath: string;\n  /** BM25 relevance score (higher = more relevant) */\n  relevanceScore: number;\n  /** PageRank importance score (0-1) */\n  importanceScore: number;\n  /** Final combined score after all boosts */\n  combinedScore: number;\n}\n\nexport interface SearchMetrics {\n  porterHits: number;\n  trigramHits: number;\n  phase2Activated: boolean;\n  fuzzyApplied: boolean;\n  latencyMs: number;\n}\n\nexport interface FuzzyCorrection {\n  originalQuery: string;\n  correctedQuery: string;\n  corrections: Array<{\n    original: string;\n    corrected: string;\n    distance: number;\n  }>;\n}\n\nexport interface SearchResponse {\n  query: string;\n  results: SearchResult[];\n  metrics: SearchMetrics;\n  fuzzyCorrection?: FuzzyCorrection;\n}\n\n// ── Community Detection ────────────────────────────────────────\n\nexport interface CommunityEntry {\n  readonly symbolId: string;\n  readonly communityId: number;\n  readonly communityLabel: string;\n}\n\nexport interface GodNode {\n  readonly symbolId: string;\n  readonly bridgedCommunities: readonly number[];\n  readonly centralityScore: number;\n}\n\nexport const EDGE_QUALITY = ['full', 'syntax-only', 'mixed'] as const;\nexport type EdgeQuality = (typeof EDGE_QUALITY)[number];\n\nexport interface CommunitySnapshot {\n  readonly version: 1;\n  readonly computedAt: string;\n  readonly commitSha: string;\n  readonly modularity: number;\n  readonly communities: readonly CommunityEntry[];\n  readonly godNodes: readonly GodNode[];\n  readonly edgeQuality: EdgeQuality;\n  readonly crossClusterEdges: number;\n}\n\nexport interface DriftEvent {\n  readonly symbolId: string;\n  readonly movedFrom: { readonly id: number; readonly label: string };\n  readonly movedTo: { readonly id: number; readonly label: string };\n  readonly firstSeenInNewCluster: string;\n}\n\nexport interface BoundaryViolation {\n  readonly from: {\n    readonly symbolId: string;\n    readonly communityId: number;\n    readonly label: string;\n  };\n  readonly to: {\n    readonly symbolId: string;\n    readonly communityId: number;\n    readonly label: string;\n  };\n  readonly edgeKind: EdgeKind;\n  readonly historicalEdgesBetweenClusters: number;\n  readonly severity: 'high' | 'medium';\n}\n\n// ── Persisted architectural artifacts ──────────────────────────\n// Written by `ctxo index` next to communities.json so the static\n// HTML visualizer can render Architecture views without re-running\n// detectors in the browser.\n\nexport type ConfidenceLevel = 'high' | 'medium' | 'low';\n\nexport interface DriftEventsArtifact {\n  readonly version: 1;\n  readonly computedAt: string;\n  readonly commitSha: string;\n  readonly confidence: ConfidenceLevel;\n  readonly snapshotsAvailable: number;\n  readonly hint?: string;\n  readonly events: readonly DriftEvent[];\n}\n\nexport interface BoundaryViolationsArtifact {\n  readonly version: 1;\n  readonly computedAt: string;\n  readonly commitSha: string;\n  readonly confidence: ConfidenceLevel;\n  readonly snapshotsAvailable: number;\n  readonly hint?: string;\n  readonly violations: readonly BoundaryViolation[];\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-HXEPS2XY.js → chunk-HZ4UGA6J.js}

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 import {
-  atomicWrite,
-  createLogger
-} from "./chunk-6EKERTJ7.js";
+  atomicWrite
+} from "./chunk-RFEXMBTG.js";
 import {
   JsonIndexReader
-} from "./chunk-2TVHKCCU.js";
+} from "./chunk-CDGQGCVN.js";
+import {
+  createLogger
+} from "./chunk-5DSKZJNN.js";
 
 // src/adapters/storage/sqlite-storage-adapter.ts
 import initSqlJs from "sql.js";
@@ -776,12 +778,21 @@ var WatchConfigSchema = z.object({
    */
   snapshotMinFileChanges: z.number().int().min(1).optional()
 }).strict();
+var GateConfigSchema = z.object({
+  enabled: z.boolean().optional(),
+  sensitivity: z.enum(["strict", "balanced", "lenient"]).optional(),
+  /** Absolute floor: minimum confirmed+likely dependents before the gate can fire. */
+  minDependents: z.number().int().min(0).optional(),
+  /** Repo-relative significance: symbol must be in the top `percentile`% by PageRank. */
+  percentile: z.number().int().min(1).max(100).optional()
+}).strict();
 var CtxoConfigSchema = z.object({
   version: z.union([z.string(), z.number()]).optional(),
   stats: StatsConfigSchema.optional(),
   index: IndexConfigSchema.optional(),
   masking: MaskingConfigSchema.optional(),
-  watch: WatchConfigSchema.optional()
+  watch: WatchConfigSchema.optional(),
+  gate: GateConfigSchema.optional()
 }).passthrough();
 var DEFAULT_WATCH_SNAPSHOT_MIN_FILE_CHANGES = 5;
 var DEFAULT_CONFIG = {
@@ -789,7 +800,8 @@ var DEFAULT_CONFIG = {
   stats: { enabled: true },
   index: { ignore: [], ignoreProjects: [] },
   masking: { clusterLabels: [] },
-  watch: { snapshotMinFileChanges: DEFAULT_WATCH_SNAPSHOT_MIN_FILE_CHANGES }
+  watch: { snapshotMinFileChanges: DEFAULT_WATCH_SNAPSHOT_MIN_FILE_CHANGES },
+  gate: { enabled: true, sensitivity: "balanced" }
 };
 
 // src/core/config/load-config.ts
@@ -878,15 +890,23 @@ function makeGlobMatcher(patterns) {
 var SymbolGraph = class {
   nodes = /* @__PURE__ */ new Map();
   nodesByFileAndName = /* @__PURE__ */ new Map();
+  nodesByNameAndKind = /* @__PURE__ */ new Map();
   forwardEdges = /* @__PURE__ */ new Map();
   reverseEdges = /* @__PURE__ */ new Map();
   edgeSet = /* @__PURE__ */ new Set();
   addNode(node) {
     this.nodes.set(node.symbolId, node);
-    const [p0, p1] = node.symbolId.split("::");
+    const parts = node.symbolId.split("::");
+    const [p0, p1] = parts;
     if (p0 !== void 0 && p1 !== void 0) {
       this.nodesByFileAndName.set(`${p0}::${p1}`, node);
     }
+    if (parts.length === 3) {
+      const nk = `${parts[1]}::${parts[2]}`;
+      const list = this.nodesByNameAndKind.get(nk);
+      if (list) list.push(node);
+      else this.nodesByNameAndKind.set(nk, [node]);
+    }
   }
   addEdge(edge) {
     const resolvedFrom = this.resolveNodeId(edge.from);
@@ -907,7 +927,8 @@ var SymbolGraph = class {
   }
   resolveNodeId(id) {
     if (this.nodes.has(id)) return id;
-    const [p0, p1] = id.split("::");
+    const segs = id.split("::");
+    const [p0, p1] = segs;
     if (p0 !== void 0 && p1 !== void 0) {
       const fuzzyKey = `${p0}::${p1}`;
       const match = this.nodesByFileAndName.get(fuzzyKey);
@@ -919,18 +940,41 @@ var SymbolGraph = class {
         if (altMatch) return altMatch.symbolId;
       }
     }
+    const nameKind = this.extractNameKind(segs);
+    if (nameKind) {
+      const candidates = this.nodesByNameAndKind.get(nameKind);
+      if (candidates && candidates.length === 1) return candidates[0].symbolId;
+    }
     return id;
   }
   resolveNodeFuzzy(id) {
-    const [p0, p1] = id.split("::");
+    const segs = id.split("::");
+    const [p0, p1] = segs;
     if (p0 !== void 0 && p1 !== void 0) {
       const match = this.nodesByFileAndName.get(`${p0}::${p1}`);
       if (match) return match;
       const jsToTs = p0.replace(/\.js$/, ".ts");
       if (jsToTs !== p0) {
-        return this.nodesByFileAndName.get(`${jsToTs}::${p1}`);
+        const tsMatch = this.nodesByFileAndName.get(`${jsToTs}::${p1}`);
+        if (tsMatch) return tsMatch;
       }
     }
+    const nameKind = this.extractNameKind(segs);
+    if (nameKind) {
+      const candidates = this.nodesByNameAndKind.get(nameKind);
+      if (candidates && candidates.length === 1) return candidates[0];
+    }
+    return void 0;
+  }
+  /**
+   * Extracts a `name::kind` key from the segments of a reference ID, supporting:
+   *   - 2-part: `Bar::class`                  → `Bar::class`
+   *   - 3-part: `pkg.Bar::helper::method`      → `helper::method`
+   * Returns undefined for 1-part IDs (no kind information available).
+   */
+  extractNameKind(segs) {
+    if (segs.length === 3) return `${segs[1]}::${segs[2]}`;
+    if (segs.length === 2) return `${segs[0]}::${segs[1]}`;
     return void 0;
   }
   getForwardEdges(symbolId) {
@@ -1141,6 +1185,92 @@ function hintFor(snapshots) {
   return "Install post-commit hook or run `ctxo index` more often to build a richer drift history.";
 }
 
+// src/core/blast-radius/blast-radius-calculator.ts
+var CONFIRMED_KINDS = /* @__PURE__ */ new Set(["calls", "extends", "implements"]);
+var LIKELY_KINDS = /* @__PURE__ */ new Set(["uses"]);
+var CONFIDENCE_RANK = {
+  confirmed: 2,
+  likely: 1,
+  potential: 0
+};
+function edgeKindToConfidence(kind) {
+  if (CONFIRMED_KINDS.has(kind)) return "confirmed";
+  if (LIKELY_KINDS.has(kind)) return "likely";
+  return "potential";
+}
+var BlastRadiusCalculator = class {
+  calculate(graph, symbolId, coChangeMap) {
+    if (!graph.hasNode(symbolId)) {
+      return { impactedSymbols: [], directDependentsCount: 0, confirmedCount: 0, likelyCount: 0, potentialCount: 0, overallRiskScore: 0 };
+    }
+    const sourceFile = symbolId.split("::")[0];
+    const visited = /* @__PURE__ */ new Set([symbolId]);
+    const rawEntries = [];
+    const queue = [{ id: symbolId, depth: 0 }];
+    while (queue.length > 0) {
+      const current = queue.shift();
+      const reverseEdges = graph.getReverseEdges(current.id);
+      const bestByNode = /* @__PURE__ */ new Map();
+      for (const edge of reverseEdges) {
+        if (visited.has(edge.from)) continue;
+        const conf = edgeKindToConfidence(edge.kind);
+        const existing = bestByNode.get(edge.from);
+        if (!existing) {
+          bestByNode.set(edge.from, { confidence: conf, kinds: /* @__PURE__ */ new Set([edge.kind]) });
+        } else {
+          existing.kinds.add(edge.kind);
+          if (CONFIDENCE_RANK[conf] > CONFIDENCE_RANK[existing.confidence]) {
+            existing.confidence = conf;
+          }
+        }
+      }
+      for (const [nodeId, info] of bestByNode) {
+        visited.add(nodeId);
+        const depth = current.depth + 1;
+        const riskScore = 1 / Math.pow(depth, 0.7);
+        let confidence = info.confidence;
+        let coChangeFrequency;
+        if (coChangeMap) {
+          const nodeFile = nodeId.split("::")[0];
+          const coEntries = coChangeMap.get(sourceFile);
+          if (coEntries) {
+            const match = coEntries.find((e) => e.file1 === nodeFile || e.file2 === nodeFile);
+            if (match) {
+              coChangeFrequency = match.frequency;
+              if (confidence === "potential" && match.frequency > 0.5) {
+                confidence = "likely";
+              }
+            }
+          }
+        }
+        rawEntries.push({
+          symbolId: nodeId,
+          depth,
+          riskScore: Math.round(riskScore * 1e3) / 1e3,
+          confidence,
+          edgeKinds: [...info.kinds],
+          coChangeFrequency
+        });
+        queue.push({ id: nodeId, depth });
+      }
+    }
+    const blastSet = new Set(rawEntries.map((e) => e.symbolId));
+    blastSet.add(symbolId);
+    const entries = rawEntries.map((e) => ({
+      ...e,
+      dependentCount: graph.getReverseEdges(e.symbolId).filter((re) => blastSet.has(re.from)).length
+    }));
+    entries.sort((a, b) => a.depth - b.depth);
+    const directDependentsCount = entries.filter((e) => e.depth === 1).length;
+    const totalRisk = entries.reduce((sum, e) => sum + e.riskScore, 0);
+    const overallRiskScore = Math.round(Math.min(totalRisk / Math.max(directDependentsCount, 1), 1) * 1e3) / 1e3;
+    const confirmedCount = entries.filter((e) => e.confidence === "confirmed").length;
+    const likelyCount = entries.filter((e) => e.confidence === "likely").length;
+    const potentialCount = entries.filter((e) => e.confidence === "potential").length;
+    return { impactedSymbols: entries, directDependentsCount, confirmedCount, likelyCount, potentialCount, overallRiskScore };
+  }
+};
+
 // src/core/overlay/architectural-overlay.ts
 var DEFAULT_RULES = [
   // Test layer (matched first — __tests__, .test.ts, tests/, fixtures)
@@ -1649,6 +1779,7 @@ export {
   RevertDetector,
   DriftDetector,
   SimpleGitAdapter,
+  BlastRadiusCalculator,
   ArchitecturalOverlay,
   DeadCodeDetector,
   PageRankCalculator,
@@ -1665,4 +1796,4 @@ export {
   watchSnapshotMinFileChanges,
   makeGlobMatcher
 };
-//# sourceMappingURL=chunk-HXEPS2XY.js.map
+//# sourceMappingURL=chunk-HZ4UGA6J.js.map