@cleocode/adapters 2026.4.47 → 2026.4.49

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,9 +12,11 @@
  * 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';
 export { CodexAdapter, CodexHookProvider, CodexInstallProvider, createAdapter as createCodexAdapter, } from './providers/codex/index.js';
 export { CursorAdapter, CursorHookProvider, CursorInstallProvider, createAdapter as createCursorAdapter, } from './providers/cursor/index.js';
 export { createAdapter as createGeminiCliAdapter, GeminiCliAdapter, GeminiCliHookProvider, GeminiCliInstallProvider, } from './providers/gemini-cli/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,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"}