@cleocode/adapters 2026.4.48 → 2026.4.50

package/dist/cant-context.d.ts

@@ -8,6 +8,7 @@
  * 1. Compiled CANT bundle (team topology, agent personas, tool ACLs)
  * 2. Memory bridge (recent decisions, handoff notes, key patterns)
  * 3. Mental model injection (validate-on-load agent-specific observations)
+ * 4. NEXUS code intelligence context (callers, callees, impact data) [T625]
  *
  * All operations are best-effort: if any step fails (missing packages, empty
  * directories, compilation errors), the base prompt is returned unchanged.
@@ -17,6 +18,7 @@
  * (Pi-only; this module generalizes the same logic for all providers)
  *
  * @task T555
+ * @task T625
  */
 /** Per-tier file counts for diagnostic reporting. */
 export interface TierDiscoveryStats {
@@ -52,6 +54,70 @@ export interface BuildCantEnrichedPromptOptions {
      * Use this to avoid double-compilation when the Pi bridge already compiled the bundle.
      */
     compiledBundle?: string;
+    /**
+     * Task ID to inject NEXUS code intelligence context for.
+     * When provided, step 6b fetches callers/callees/impact for symbols
+     * mentioned in the task description and injects them into the prompt.
+     *
+     * @task T625
+     */
+    taskId?: string;
+}
+/** A single symbol's NEXUS context entry (callers, callees, impact). */
+export interface NexusSymbolContext {
+    /** Symbol name as resolved in the code index. */
+    name: string;
+    /** Symbol kind (function, method, class, etc.). */
+    kind: string;
+    /** File path (relative to project root) where the symbol is defined. */
+    filePath: string | null;
+    /** Symbols that call this one (direct callers). */
+    callers: Array<{
+        name: string;
+        kind: string;
+        filePath: string | null;
+    }>;
+    /** Symbols that this one calls (direct callees). */
+    callees: Array<{
+        name: string;
+        kind: string;
+        filePath: string | null;
+    }>;
+    /** Risk level from impact analysis. */
+    riskLevel: string;
+    /** Total number of transitively impacted nodes. */
+    totalImpacted: number;
+}
+/** Options for {@link buildNexusContext}. */
+export interface BuildNexusContextOptions {
+    /** Symbols to query NEXUS for (extracted from task description). */
+    symbols: string[];
+    /** Project root directory (used to resolve project ID and run CLI commands). */
+    projectDir: string;
+    /** Maximum callers/callees to include per symbol (default: 10). */
+    limit?: number;
+    /**
+     * CLI timeout in milliseconds for each `cleo nexus context` call (default: 10000).
+     */
+    timeoutMs?: number;
+}
+/** Result of a post-modification NEXUS check (T625). */
+export interface NexusModificationCheckResult {
+    /**
+     * True if the incremental re-analysis completed successfully.
+     * False if the analysis failed (non-fatal — agents should still continue).
+     */
+    success: boolean;
+    /** Files that were re-indexed. */
+    reindexedFiles: string[];
+    /** Relations that exist in the post-check index but not in the snapshot. */
+    newRelations: number;
+    /** Relations that existed in the snapshot but are missing after re-analysis. */
+    removedRelations: number;
+    /** Human-readable summary of what changed. */
+    summary: string;
+    /** Any regressions detected (broken call chains, missing symbols). */
+    regressions: string[];
 }
 /**
  * Recursively discover `.cant` files in a directory.
@@ -140,6 +206,70 @@ export declare function readIdentityFile(projectDir: string): string | null;
  * @returns The fully assembled identity block, or "" if unavailable.
  */
 export declare function buildIdentityBootstrap(projectDir: string): Promise<string>;
+/**
+ * Extract candidate symbol names from a task description or title.
+ *
+ * Uses a simple heuristic: camelCase, PascalCase, and snake_case tokens
+ * longer than 3 characters that look like code identifiers.
+ *
+ * Pure function — no I/O.
+ *
+ * @param text - Raw text to scan for symbol names (task title + description).
+ * @returns Deduplicated array of candidate symbol names, longest first.
+ */
+export declare function extractSymbolsFromText(text: string): string[];
+/**
+ * Build a NEXUS code intelligence context block for a set of symbols.
+ *
+ * Queries `cleo nexus context <symbol> --json` for each symbol and
+ * returns a formatted prompt block with callers, callees, and impact data.
+ *
+ * All CLI calls are best-effort with a configurable timeout. Failures
+ * for individual symbols are silently skipped.
+ *
+ * @param options - Symbols, project dir, and optional limits.
+ * @returns Array of resolved NEXUS symbol contexts.
+ * @task T625
+ */
+export declare function buildNexusContext(options: BuildNexusContextOptions): Promise<NexusSymbolContext[]>;
+/**
+ * Format a NEXUS context array into a system-prompt block.
+ *
+ * Pure function — no I/O, safe to call in tests without a real DB.
+ *
+ * @param contexts - Resolved NEXUS symbol contexts.
+ * @returns Formatted prompt block, or empty string when contexts is empty.
+ * @task T625
+ */
+export declare function buildNexusContextBlock(contexts: NexusSymbolContext[]): string;
+/**
+ * Inject NEXUS context for a task into the agent prompt.
+ *
+ * Fetches the task details from CLEO, extracts symbol names from the
+ * task title and description, then queries NEXUS for each symbol.
+ * Returns a formatted prompt block or empty string on any failure.
+ *
+ * @param taskId - CLEO task ID (e.g. "T625").
+ * @param projectDir - Project root directory.
+ * @returns Formatted NEXUS context block, or "" if unavailable.
+ * @task T625
+ */
+export declare function buildNexusContextForTask(taskId: string, projectDir: string): Promise<string>;
+/**
+ * Run a post-modification NEXUS check on a set of changed files.
+ *
+ * Performs an incremental re-analysis of the changed files and compares
+ * relation counts before/after. Regressions (net loss of relations after
+ * modification) are flagged and returned for BRAIN storage.
+ *
+ * All operations are best-effort — never throws.
+ *
+ * @param changedFiles - Absolute paths to files that were modified.
+ * @param projectDir - Project root directory.
+ * @returns Check result with regression data.
+ * @task T625
+ */
+export declare function runNexusPostModificationCheck(changedFiles: string[], projectDir: string): Promise<NexusModificationCheckResult>;
 /**
  * Build an enriched prompt with CANT context, memory bridge, and mental model.
  *
@@ -152,7 +282,8 @@ export declare function buildIdentityBootstrap(projectDir: string): Promise<stri
  * 3. Renders the compiled system prompt
  * 4. Reads the memory bridge from `.cleo/memory-bridge.md`
  * 5. Fetches mental model observations for the named agent
- * 6. Concatenates: basePrompt + CANT bundle + memory bridge + mental model
+ * 6b. Injects NEXUS code intelligence context for the task (T625)
+ * 7. Concatenates: basePrompt + CANT bundle + memory bridge + mental model + NEXUS
  *
  * All operations are best-effort. If any step fails, the base prompt is
  * returned unchanged. CANT context is an enrichment, not a gate — agents

package/dist/cant-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cant-context.d.ts","sourceRoot":"","sources":["../src/cant-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,8BAA8B;IAC7C,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAmCA;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,sBAAsB,EAAE,GACrC,MAAM,CAaR;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqGhF;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CA6EjB"}
+{"version":3,"file":"cant-context.d.ts","sourceRoot":"","sources":["../src/cant-context.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -12,8 +12,8 @@
  * The {@link discoverProviders} function and {@link getProviderManifests}
  * registry enable dynamic adapter loading by AdapterManager.
  */
-export type { BuildCantEnrichedPromptOptions, TierDiscoveryStats } from './cant-context.js';
-export { buildCantEnrichedPrompt } from './cant-context.js';
+export type { BuildCantEnrichedPromptOptions, BuildNexusContextOptions, NexusModificationCheckResult, NexusSymbolContext, TierDiscoveryStats, } from './cant-context.js';
+export { buildCantEnrichedPrompt, buildNexusContext, buildNexusContextBlock, buildNexusContextForTask, extractSymbolsFromText, runNexusPostModificationCheck, } from './cant-context.js';
 export { ClaudeCodeAdapter, ClaudeCodeContextMonitorProvider, ClaudeCodeHookProvider, ClaudeCodeInstallProvider, ClaudeCodePathProvider, ClaudeCodeSpawnProvider, ClaudeCodeTransportProvider, checkStatuslineIntegration, createAdapter as createClaudeCodeAdapter, getSetupInstructions, getStatuslineConfig, } from './providers/claude-code/index.js';
 export type { McpServerMap, McpStdioConfig, SessionEntry } from './providers/claude-sdk/index.js';
 export { ClaudeSDKSpawnProvider, DEFAULT_TOOLS, getServers, resolveTools, SessionStore, } from './providers/claude-sdk/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,aAAa,IAAI,uBAAuB,EACxC,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,IAAI,kBAAkB,GACpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,IAAI,mBAAmB,GACrC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,IAAI,sBAAsB,EACvC,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,aAAa,IAAI,iBAAiB,EAClC,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,IAAI,qBAAqB,EACtC,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,uBAAuB,EAEvB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,aAAa,IAAI,uBAAuB,EACxC,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,IAAI,kBAAkB,GACpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,IAAI,mBAAmB,GACrC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,IAAI,sBAAsB,EACvC,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,aAAa,IAAI,iBAAiB,EAClC,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,IAAI,qBAAqB,EACtC,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -15,11 +15,16 @@ __export(cant_context_exports, {
   buildIdentityBootstrap: () => buildIdentityBootstrap,
   buildMemoryBridgeBlock: () => buildMemoryBridgeBlock,
   buildMentalModelInjection: () => buildMentalModelInjection,
+  buildNexusContext: () => buildNexusContext,
+  buildNexusContextBlock: () => buildNexusContextBlock,
+  buildNexusContextForTask: () => buildNexusContextForTask,
   discoverCantFiles: () => discoverCantFiles,
   discoverCantFilesMultiTier: () => discoverCantFilesMultiTier,
+  extractSymbolsFromText: () => extractSymbolsFromText,
   readIdentityFile: () => readIdentityFile,
   readMemoryBridge: () => readMemoryBridge,
-  resolveThreeTierPaths: () => resolveThreeTierPaths
+  resolveThreeTierPaths: () => resolveThreeTierPaths,
+  runNexusPostModificationCheck: () => runNexusPostModificationCheck
 });
 import { execFile } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
@@ -225,8 +230,179 @@ async function buildIdentityBootstrap(projectDir) {
   sections.push("===== END IDENTITY BOOTSTRAP =====");
   return sections.join("\n");
 }
+function extractSymbolsFromText(text) {
+  const identifierPattern = /\b([A-Z][a-zA-Z0-9]{3,}|[a-z][a-zA-Z0-9]{3,}[A-Z][a-zA-Z0-9]*|[a-z]{2,}_[a-z][a-zA-Z0-9_]*)\b/g;
+  const seen = /* @__PURE__ */ new Set();
+  const matches = [];
+  for (const matchResult of text.matchAll(identifierPattern)) {
+    const symbol = matchResult[1];
+    if (symbol && !seen.has(symbol)) {
+      seen.add(symbol);
+      matches.push(symbol);
+    }
+  }
+  return matches.sort((a3, b4) => b4.length - a3.length).slice(0, 8);
+}
+async function buildNexusContext(options) {
+  const { symbols, projectDir, limit = 10, timeoutMs = 1e4 } = options;
+  if (symbols.length === 0) return [];
+  const results = [];
+  for (const symbol of symbols) {
+    try {
+      const { stdout } = await execFileAsync(
+        "cleo",
+        ["nexus", "context", symbol, "--json", "--limit", String(limit)],
+        { timeout: timeoutMs, cwd: projectDir || void 0 }
+      );
+      const parsed = JSON.parse(stdout);
+      if (!parsed.success || !parsed.data?.results?.length) continue;
+      let riskLevel = "UNKNOWN";
+      let totalImpacted = 0;
+      try {
+        const { stdout: impactStdout } = await execFileAsync(
+          "cleo",
+          ["nexus", "impact", symbol, "--json", "--depth", "2"],
+          { timeout: timeoutMs, cwd: projectDir || void 0 }
+        );
+        const impactParsed = JSON.parse(impactStdout);
+        if (impactParsed.success && impactParsed.data) {
+          riskLevel = String(impactParsed.data.riskLevel ?? "UNKNOWN");
+          totalImpacted = Number(impactParsed.data.totalImpactedNodes ?? 0);
+        }
+      } catch {
+      }
+      const primary = parsed.data.results[0];
+      if (!primary) continue;
+      results.push({
+        name: String(primary.name ?? symbol),
+        kind: String(primary.kind ?? "unknown"),
+        filePath: primary.filePath ? String(primary.filePath) : null,
+        callers: (primary.callers ?? []).slice(0, limit).map((c3) => ({
+          name: String(c3.name ?? ""),
+          kind: String(c3.kind ?? "unknown"),
+          filePath: c3.filePath ? String(c3.filePath) : null
+        })),
+        callees: (primary.callees ?? []).slice(0, limit).map((c3) => ({
+          name: String(c3.name ?? ""),
+          kind: String(c3.kind ?? "unknown"),
+          filePath: c3.filePath ? String(c3.filePath) : null
+        })),
+        riskLevel,
+        totalImpacted
+      });
+    } catch {
+    }
+  }
+  return results;
+}
+function buildNexusContextBlock(contexts) {
+  if (contexts.length === 0) return "";
+  const lines = [
+    "",
+    "===== NEXUS CODE INTELLIGENCE (pre-modification context) =====",
+    "Consult this before modifying any of these symbols.",
+    "High-risk symbols MUST be checked for callers before editing.",
+    ""
+  ];
+  for (const ctx of contexts) {
+    lines.push(`## ${ctx.name}  [${ctx.kind}]${ctx.filePath ? `  ${ctx.filePath}` : ""}`);
+    lines.push(`   Risk: ${ctx.riskLevel}  |  Impacted nodes: ${ctx.totalImpacted}`);
+    if (ctx.callers.length > 0) {
+      lines.push(
+        `   Callers (${ctx.callers.length}): ${ctx.callers.map((c3) => c3.name).join(", ")}`
+      );
+    } else {
+      lines.push("   Callers: none");
+    }
+    if (ctx.callees.length > 0) {
+      lines.push(
+        `   Callees (${ctx.callees.length}): ${ctx.callees.map((c3) => c3.name).join(", ")}`
+      );
+    } else {
+      lines.push("   Callees: none");
+    }
+    lines.push("");
+  }
+  lines.push("===== END NEXUS CONTEXT =====");
+  return lines.join("\n");
+}
+async function buildNexusContextForTask(taskId, projectDir) {
+  try {
+    const { stdout: taskStdout } = await execFileAsync("cleo", ["show", taskId, "--json"], {
+      timeout: 8e3,
+      cwd: projectDir || void 0
+    });
+    const taskData = JSON.parse(taskStdout);
+    const title = taskData?.data?.title ?? "";
+    const description = taskData?.data?.description ?? "";
+    const combinedText = `${title} ${description}`;
+    const symbols = extractSymbolsFromText(combinedText);
+    if (symbols.length === 0) return "";
+    const contexts = await buildNexusContext({ symbols, projectDir });
+    return buildNexusContextBlock(contexts);
+  } catch {
+    return "";
+  }
+}
+async function runNexusPostModificationCheck(changedFiles, projectDir) {
+  const empty = {
+    success: false,
+    reindexedFiles: [],
+    newRelations: 0,
+    removedRelations: 0,
+    summary: "NEXUS post-check unavailable",
+    regressions: []
+  };
+  if (changedFiles.length === 0) return empty;
+  try {
+    const { stdout: beforeStdout } = await execFileAsync("cleo", ["nexus", "status", "--json"], {
+      timeout: 8e3,
+      cwd: projectDir || void 0
+    });
+    let relationsBefore = 0;
+    try {
+      const beforeData = JSON.parse(beforeStdout);
+      relationsBefore = beforeData?.data?.relationCount ?? beforeData?.data?.relations ?? 0;
+    } catch {
+    }
+    await execFileAsync("cleo", ["nexus", "analyze", projectDir, "--incremental", "--json"], {
+      timeout: 6e4,
+      cwd: projectDir || void 0
+    });
+    const { stdout: afterStdout } = await execFileAsync("cleo", ["nexus", "status", "--json"], {
+      timeout: 8e3,
+      cwd: projectDir || void 0
+    });
+    let relationsAfter = 0;
+    try {
+      const afterData = JSON.parse(afterStdout);
+      relationsAfter = afterData?.data?.relationCount ?? afterData?.data?.relations ?? 0;
+    } catch {
+    }
+    const delta = relationsAfter - relationsBefore;
+    const newRelations = Math.max(0, delta);
+    const removedRelations = Math.max(0, -delta);
+    const regressions = [];
+    if (removedRelations > 5) {
+      regressions.push(
+        `Lost ${removedRelations} relations after modifying: ${changedFiles.map((f6) => f6.split("/").pop() ?? f6).join(", ")}`
+      );
+    }
+    const summary = delta === 0 ? `NEXUS stable \u2014 no relation changes after modifying ${changedFiles.length} file(s)` : delta > 0 ? `NEXUS: +${newRelations} new relations from ${changedFiles.length} file(s)` : `NEXUS: -${removedRelations} relations removed from ${changedFiles.length} file(s)${regressions.length > 0 ? " \u2014 REGRESSION DETECTED" : ""}`;
+    return {
+      success: true,
+      reindexedFiles: changedFiles,
+      newRelations,
+      removedRelations,
+      summary,
+      regressions
+    };
+  } catch {
+    return empty;
+  }
+}
 async function buildCantEnrichedPrompt(options) {
-  const { projectDir, basePrompt, agentName, isMainAgent, compiledBundle } = options;
+  const { projectDir, basePrompt, agentName, isMainAgent, compiledBundle, taskId } = options;
   let appendix = "";
   if (isMainAgent) {
     try {
@@ -282,6 +458,15 @@ ${mentalModel}`;
     } catch {
     }
   }
+  if (taskId) {
+    try {
+      const nexusBlock = await buildNexusContextForTask(taskId, projectDir);
+      if (nexusBlock) {
+        appendix += nexusBlock;
+      }
+    } catch {
+    }
+  }
   return appendix ? basePrompt + appendix : basePrompt;
 }
 var execFileAsync, VALIDATE_ON_LOAD_PREAMBLE;
@@ -19880,6 +20065,12 @@ var init_hooks = __esm({
               {
                 type: "command",
                 command: `cleo observe "File modified via $TOOL_NAME" --title "tool-use" --quiet # cleo-hook`
+              },
+              {
+                // NEXUS post-modification check: re-index changed files and flag regressions.
+                // $TOOL_INPUT_file_path is populated by Claude Code for Write/Edit events.
+                type: "command",
+                command: `cleo nexus analyze --incremental --json > /dev/null 2>&1 && cleo observe "NEXUS re-indexed after $TOOL_NAME on $TOOL_INPUT_file_path" --title "nexus-post-check" --quiet # cleo-hook`
               }
             ]
           });
@@ -20296,7 +20487,11 @@ var init_spawn2 = __esm({
             enrichedPrompt = await buildCantEnrichedPrompt2({
               projectDir: context.workingDirectory ?? process.cwd(),
               basePrompt: context.prompt,
-              agentName: context.options?.agentName ?? void 0
+              agentName: context.options?.agentName ?? void 0,
+              // Inject NEXUS code intelligence context for the task scope (T625).
+              // This injects callers/callees/impact data so the agent understands
+              // blast radius before modifying any symbol.
+              taskId: context.taskId ?? void 0
             });
           } catch {
           }
@@ -23501,6 +23696,9 @@ export {
   OpenCodeSpawnProvider,
   SessionStore,
   buildCantEnrichedPrompt,
+  buildNexusContext,
+  buildNexusContextBlock,
+  buildNexusContextForTask,
   checkStatuslineIntegration,
   createAdapter as createClaudeCodeAdapter,
   createAdapter2 as createCodexAdapter,
@@ -23509,10 +23707,12 @@ export {
   createAdapter5 as createKimiAdapter,
   createAdapter6 as createOpenCodeAdapter,
   discoverProviders,
+  extractSymbolsFromText,
   getProviderManifests,
   getServers,
   getSetupInstructions,
   getStatuslineConfig,
-  resolveTools
+  resolveTools,
+  runNexusPostModificationCheck
 };
 //# sourceMappingURL=index.js.map