@cleocode/adapters 2026.4.38 → 2026.4.40

package/dist/cant-context.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Shared CANT context builder for all spawn providers.
+ *
+ * Extracts the Pi bridge's CANT discovery/compile/inject logic into a reusable
+ * module that any spawn provider (Claude Code, OpenCode, Cursor, etc.) can call
+ * to enrich agent prompts with:
+ *
+ * 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)
+ *
+ * All operations are best-effort: if any step fails (missing packages, empty
+ * directories, compilation errors), the base prompt is returned unchanged.
+ * This guarantees agents always spawn — CANT context is an enrichment, not a gate.
+ *
+ * Reference implementation: packages/cleo-os/extensions/cleo-cant-bridge.ts
+ * (Pi-only; this module generalizes the same logic for all providers)
+ *
+ * @task T555
+ */
+/** Per-tier file counts for diagnostic reporting. */
+export interface TierDiscoveryStats {
+    global: number;
+    user: number;
+    project: number;
+    overrides: number;
+    merged: number;
+}
+/** Minimal observation shape returned by memoryFind / searchBrainCompact. */
+export interface MentalModelObservation {
+    id: string;
+    type: string;
+    title: string;
+    date?: string;
+}
+/** Options for the main enrichment function. */
+export interface BuildCantEnrichedPromptOptions {
+    /** Project root directory for .cleo/cant/ discovery and brain.db access. */
+    projectDir: string;
+    /** The raw prompt to enrich. Returned unchanged if no CANT context is available. */
+    basePrompt: string;
+    /** Agent name for mental model injection. Omit to skip mental model fetch. */
+    agentName?: string;
+}
+/**
+ * Recursively discover `.cant` files in a directory.
+ *
+ * @param dir - The directory to scan recursively.
+ * @returns An array of absolute paths to `.cant` files found.
+ */
+export declare function discoverCantFiles(dir: string): string[];
+/**
+ * Resolve XDG-compliant paths for the 3-tier CANT hierarchy.
+ *
+ * Respects `XDG_DATA_HOME` and `XDG_CONFIG_HOME` environment variables.
+ * Falls back to XDG defaults (`~/.local/share/` and `~/.config/`).
+ *
+ * @param projectDir - The project root directory (for the project tier).
+ * @returns An object with `global`, `user`, and `project` CANT directory paths.
+ */
+export declare function resolveThreeTierPaths(projectDir: string): {
+    global: string;
+    user: string;
+    project: string;
+};
+/**
+ * Discover `.cant` files across all three tiers with override semantics.
+ *
+ * Scans global, user, and project tiers. Files in higher-precedence tiers
+ * override files in lower-precedence tiers that share the same basename.
+ * The precedence order is: project > user > global.
+ *
+ * @param projectDir - The project root directory.
+ * @returns An object containing the merged file list and per-tier statistics.
+ */
+export declare function discoverCantFilesMultiTier(projectDir: string): {
+    files: string[];
+    stats: TierDiscoveryStats;
+};
+/**
+ * Read the memory bridge file from a project's .cleo/ directory.
+ *
+ * @param projectDir - The project root directory.
+ * @returns The memory bridge content, or null if not found or empty.
+ */
+export declare function readMemoryBridge(projectDir: string): string | null;
+/**
+ * Build the memory-bridge system-prompt block appended to every agent.
+ *
+ * Wraps the raw memory-bridge.md content in a clearly labeled section
+ * so the agent knows this is the CLEO project memory context.
+ *
+ * @param content - The raw memory-bridge.md content.
+ * @returns The formatted memory-bridge block for system prompt injection.
+ */
+export declare function buildMemoryBridgeBlock(content: string): string;
+/**
+ * Build the validate-on-load mental-model injection string.
+ *
+ * Pure function — no I/O, safe to call in tests without a real DB.
+ *
+ * @param agentName - Name of the spawned agent (used in the header line).
+ * @param observations - Prior mental-model observations to list.
+ * @returns System-prompt block with preamble and numbered observations,
+ *          or empty string when `observations` is empty.
+ */
+export declare function buildMentalModelInjection(agentName: string, observations: MentalModelObservation[]): string;
+/**
+ * Build an enriched prompt with CANT context, memory bridge, and mental model.
+ *
+ * This is the universal entry point for all spawn providers. It performs the
+ * same operations as the Pi bridge (cleo-cant-bridge.ts) but returns a string
+ * rather than hooking into Pi events:
+ *
+ * 1. Discovers `.cant` files across 3 tiers (global → user → project)
+ * 2. Compiles the CANT bundle via `@cleocode/cant`'s `compileBundle()`
+ * 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
+ *
+ * All operations are best-effort. If any step fails, the base prompt is
+ * returned unchanged. CANT context is an enrichment, not a gate — agents
+ * always spawn regardless of CANT availability.
+ *
+ * @param options - Project dir, base prompt, and optional agent name.
+ * @returns The enriched prompt string, or basePrompt unchanged on failure.
+ */
+export declare function buildCantEnrichedPrompt(options: BuildCantEnrichedPromptOptions): Promise<string>;
+//# sourceMappingURL=cant-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cant-context.d.ts","sourceRoot":"","sources":["../src/cant-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,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;CACpB;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CAyDjB"}

package/dist/index.d.ts

@@ -12,6 +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 { ClaudeCodeAdapter, ClaudeCodeContextMonitorProvider, ClaudeCodeHookProvider, ClaudeCodeInstallProvider, ClaudeCodePathProvider, ClaudeCodeSpawnProvider, ClaudeCodeTransportProvider, checkStatuslineIntegration, createAdapter as createClaudeCodeAdapter, getSetupInstructions, getStatuslineConfig, } from './providers/claude-code/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';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,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,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"}