@cleocode/adapters 2026.4.38 → 2026.4.40

package/dist/providers/claude-code/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA6B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B,wEAAwE;IACxE,KAAK,EAAE,uBAAuB,CAAC;IAC/B,+EAA+E;IAC/E,OAAO,EAAE,yBAAyB,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,EAAE,gCAAgC,CAAC;IACjD,wDAAwD;IACxD,SAAS,EAAE,2BAA2B,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,EAAE,0BAA0B,CAAC;IAErC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA6B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B,wEAAwE;IACxE,KAAK,EAAE,uBAAuB,CAAC;IAC/B,+EAA+E;IAC/E,OAAO,EAAE,yBAAyB,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,EAAE,gCAAgC,CAAC;IACjD,wDAAwD;IACxD,SAAS,EAAE,2BAA2B,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,EAAE,0BAA0B,CAAC;IAErC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/claude-code/hooks.d.ts

@@ -55,33 +55,45 @@ export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
      * @task T164
      */
     mapProviderEvent(providerEvent: string): string | null;
+    /** Project directory this hook provider was registered for. */
+    private projectDir;
     /**
      * Register native hooks for a project.
      *
-     * For Claude Code, hooks are registered via the config system
-     * (`~/.claude/settings.json`), managed by the install provider.
-     * This method marks hooks as registered without performing filesystem operations.
+     * Writes CLEO hook entries to `~/.claude/settings.json` so that Claude Code's
+     * native event system calls cleo CLI commands when events fire. This bridges
+     * Claude Code's event loop to CLEO's internal hook dispatch.
      *
-     * Iterating supported events is handled at install time using
-     * `getSupportedCanonicalEvents()` to enumerate all 14 supported hooks.
+     * Idempotent: skips writing if CLEO hooks already exist in settings.json.
      *
-     * @param _projectDir - Project directory (unused; Claude Code uses global config)
-     * @task T164
+     * Hook entries registered:
+     * - `Stop` → `cleo session end --quiet` (triggers LLM extraction, reflector, consolidation)
+     * - `PostToolUse` (Write|Edit) → brain observation for file modifications
+     * - `SubagentStop` → brain observation for agent completion
+     *
+     * @param projectDir - Project directory for context-scoped hook commands
+     * @task T164 @task T555
      */
-    registerNativeHooks(_projectDir: string): Promise<void>;
+    registerNativeHooks(projectDir: string): Promise<void>;
     /**
      * Unregister native hooks.
      *
-     * For Claude Code, this is a no-op since hooks are managed through the config
-     * system. Unregistration happens via the install provider's uninstall method.
+     * Removes CLEO hook entries from `~/.claude/settings.json` by filtering out
+     * entries containing the `# cleo-hook` marker.
      *
-     * @task T164
+     * @task T164 @task T555
      */
     unregisterNativeHooks(): Promise<void>;
     /**
      * Check whether hooks have been registered via `registerNativeHooks`.
      */
     isRegistered(): boolean;
+    /**
+     * Get the project directory this hook provider was registered for.
+     *
+     * Returns null if hooks have not been registered yet.
+     */
+    getProjectDir(): string | null;
     /**
      * Get the native→canonical event mapping for introspection and debugging.
      *

package/dist/providers/claude-code/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD,+DAA+D;IAC/D,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;;;;;;;;;;;;OAgBG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuE5D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA2DrF"}

package/dist/providers/claude-code/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAY3F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAuExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAY3F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAqFxD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

package/dist/providers/opencode/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiB3F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY5F;AA0CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAiExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiB3F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY5F;AA+CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA+ExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.4.38",
+  "version": "2026.4.40",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -12,8 +12,8 @@
     }
   },
   "dependencies": {
-    "@cleocode/caamp": "2026.4.38",
-    "@cleocode/contracts": "2026.4.38"
+    "@cleocode/caamp": "2026.4.40",
+    "@cleocode/contracts": "2026.4.40"
   },
   "license": "MIT",
   "engines": {

package/src/__tests__/cant-context.test.ts

@@ -0,0 +1,248 @@
+/**
+ * Unit tests for the shared CANT context builder.
+ *
+ * Tests cover:
+ * - discoverCantFiles: finds .cant files, handles missing dirs
+ * - resolveThreeTierPaths: XDG-compliant paths with env var overrides
+ * - discoverCantFilesMultiTier: 3-tier merge with override semantics
+ * - readMemoryBridge: reads file, handles missing/empty
+ * - buildMemoryBridgeBlock: wraps content in labeled section
+ * - buildMentalModelInjection: pure function, numbered list, empty input
+ * - buildCantEnrichedPrompt: full pipeline, fallback on failure
+ *
+ * @task T555
+ */
+
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+import {
+  buildCantEnrichedPrompt,
+  buildMemoryBridgeBlock,
+  buildMentalModelInjection,
+  discoverCantFiles,
+  discoverCantFilesMultiTier,
+  readMemoryBridge,
+  resolveThreeTierPaths,
+} from '../cant-context.js';
+
+let tempDir: string;
+
+beforeEach(() => {
+  tempDir = join(tmpdir(), `cleo-cant-ctx-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`);
+  mkdirSync(tempDir, { recursive: true });
+});
+
+afterEach(() => {
+  rmSync(tempDir, { recursive: true, force: true });
+});
+
+// ---------------------------------------------------------------------------
+// discoverCantFiles
+// ---------------------------------------------------------------------------
+
+describe('discoverCantFiles', () => {
+  it('finds .cant files recursively', () => {
+    const cantDir = join(tempDir, 'cant');
+    mkdirSync(join(cantDir, 'agents'), { recursive: true });
+    writeFileSync(join(cantDir, 'team.cant'), 'team: test');
+    writeFileSync(join(cantDir, 'agents', 'worker.cant'), 'agent: worker');
+    writeFileSync(join(cantDir, 'agents', 'README.md'), 'ignored');
+
+    const files = discoverCantFiles(cantDir);
+    expect(files).toHaveLength(2);
+    expect(files.some((f) => f.endsWith('team.cant'))).toBe(true);
+    expect(files.some((f) => f.endsWith('worker.cant'))).toBe(true);
+  });
+
+  it('returns empty array for non-existent directory', () => {
+    const files = discoverCantFiles(join(tempDir, 'does-not-exist'));
+    expect(files).toEqual([]);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// resolveThreeTierPaths
+// ---------------------------------------------------------------------------
+
+describe('resolveThreeTierPaths', () => {
+  it('returns project tier pointing to .cleo/cant/', () => {
+    const paths = resolveThreeTierPaths('/my/project');
+    expect(paths.project).toBe('/my/project/.cleo/cant');
+  });
+
+  it('respects XDG_DATA_HOME for global tier', () => {
+    const originalXdg = process.env['XDG_DATA_HOME'];
+    process.env['XDG_DATA_HOME'] = '/custom/data';
+    try {
+      const paths = resolveThreeTierPaths('/my/project');
+      expect(paths.global).toBe('/custom/data/cleo/cant');
+    } finally {
+      if (originalXdg) process.env['XDG_DATA_HOME'] = originalXdg;
+      else delete process.env['XDG_DATA_HOME'];
+    }
+  });
+
+  it('respects XDG_CONFIG_HOME for user tier', () => {
+    const originalXdg = process.env['XDG_CONFIG_HOME'];
+    process.env['XDG_CONFIG_HOME'] = '/custom/config';
+    try {
+      const paths = resolveThreeTierPaths('/my/project');
+      expect(paths.user).toBe('/custom/config/cleo/cant');
+    } finally {
+      if (originalXdg) process.env['XDG_CONFIG_HOME'] = originalXdg;
+      else delete process.env['XDG_CONFIG_HOME'];
+    }
+  });
+});
+
+// ---------------------------------------------------------------------------
+// discoverCantFilesMultiTier
+// ---------------------------------------------------------------------------
+
+describe('discoverCantFilesMultiTier', () => {
+  let origXdgData: string | undefined;
+  let origXdgConfig: string | undefined;
+
+  beforeEach(() => {
+    // Override XDG paths so global/user tiers point to empty temp subdirs
+    origXdgData = process.env['XDG_DATA_HOME'];
+    origXdgConfig = process.env['XDG_CONFIG_HOME'];
+    process.env['XDG_DATA_HOME'] = join(tempDir, 'xdg-data');
+    process.env['XDG_CONFIG_HOME'] = join(tempDir, 'xdg-config');
+  });
+
+  afterEach(() => {
+    if (origXdgData) process.env['XDG_DATA_HOME'] = origXdgData;
+    else delete process.env['XDG_DATA_HOME'];
+    if (origXdgConfig) process.env['XDG_CONFIG_HOME'] = origXdgConfig;
+    else delete process.env['XDG_CONFIG_HOME'];
+  });
+
+  it('discovers files from project tier', () => {
+    const cantDir = join(tempDir, '.cleo', 'cant');
+    mkdirSync(cantDir, { recursive: true });
+    writeFileSync(join(cantDir, 'team.cant'), 'team: test');
+
+    const result = discoverCantFilesMultiTier(tempDir);
+    expect(result.files).toHaveLength(1);
+    expect(result.stats.project).toBe(1);
+  });
+
+  it('returns empty when no tiers have .cant files', () => {
+    const result = discoverCantFilesMultiTier(tempDir);
+    expect(result.files).toHaveLength(0);
+    expect(result.stats.merged).toBe(0);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// readMemoryBridge
+// ---------------------------------------------------------------------------
+
+describe('readMemoryBridge', () => {
+  it('returns null when file does not exist', () => {
+    expect(readMemoryBridge(tempDir)).toBeNull();
+  });
+
+  it('returns content when file exists', () => {
+    const cleoDir = join(tempDir, '.cleo');
+    mkdirSync(cleoDir, { recursive: true });
+    writeFileSync(join(cleoDir, 'memory-bridge.md'), '# Memory Bridge\nTest content');
+
+    const result = readMemoryBridge(tempDir);
+    expect(result).toContain('Memory Bridge');
+    expect(result).toContain('Test content');
+  });
+
+  it('returns null for empty file', () => {
+    const cleoDir = join(tempDir, '.cleo');
+    mkdirSync(cleoDir, { recursive: true });
+    writeFileSync(join(cleoDir, 'memory-bridge.md'), '');
+
+    expect(readMemoryBridge(tempDir)).toBeNull();
+  });
+});
+
+// ---------------------------------------------------------------------------
+// buildMemoryBridgeBlock
+// ---------------------------------------------------------------------------
+
+describe('buildMemoryBridgeBlock', () => {
+  it('wraps content in labeled section markers', () => {
+    const result = buildMemoryBridgeBlock('Test content');
+    expect(result).toContain('===== CLEO MEMORY BRIDGE =====');
+    expect(result).toContain('Test content');
+    expect(result).toContain('===== END MEMORY BRIDGE =====');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// buildMentalModelInjection
+// ---------------------------------------------------------------------------
+
+describe('buildMentalModelInjection', () => {
+  it('returns empty string for empty observations', () => {
+    expect(buildMentalModelInjection('test-agent', [])).toBe('');
+  });
+
+  it('builds numbered list with preamble', () => {
+    const result = buildMentalModelInjection('code-worker', [
+      { id: 'O-001', type: 'observation', title: 'Tests pass', date: '2026-04-14' },
+      { id: 'O-002', type: 'pattern', title: 'Use vitest' },
+    ]);
+
+    expect(result).toContain('MENTAL MODEL (validate-on-load)');
+    expect(result).toContain('Agent: code-worker');
+    expect(result).toContain('1. [O-001] (observation) [2026-04-14]: Tests pass');
+    expect(result).toContain('2. [O-002] (pattern): Use vitest');
+    expect(result).toContain('END MENTAL MODEL');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// buildCantEnrichedPrompt
+// ---------------------------------------------------------------------------
+
+describe('buildCantEnrichedPrompt', () => {
+  it('returns basePrompt unchanged when no .cant files exist', async () => {
+    const result = await buildCantEnrichedPrompt({
+      projectDir: tempDir,
+      basePrompt: 'Execute the task.',
+    });
+    expect(result).toBe('Execute the task.');
+  });
+
+  it('appends memory bridge when .cleo/memory-bridge.md exists', async () => {
+    const cleoDir = join(tempDir, '.cleo');
+    mkdirSync(cleoDir, { recursive: true });
+    writeFileSync(join(cleoDir, 'memory-bridge.md'), '# Bridge\nRecent decisions here');
+
+    const result = await buildCantEnrichedPrompt({
+      projectDir: tempDir,
+      basePrompt: 'Execute the task.',
+    });
+
+    expect(result).toContain('Execute the task.');
+    expect(result).toContain('CLEO MEMORY BRIDGE');
+    expect(result).toContain('Recent decisions here');
+  });
+
+  it('includes both memory bridge and base prompt without duplication', async () => {
+    const cleoDir = join(tempDir, '.cleo');
+    mkdirSync(cleoDir, { recursive: true });
+    writeFileSync(join(cleoDir, 'memory-bridge.md'), 'Bridge content');
+
+    const result = await buildCantEnrichedPrompt({
+      projectDir: tempDir,
+      basePrompt: 'My prompt',
+    });
+
+    // Base prompt should appear exactly once at the start
+    expect(result.startsWith('My prompt')).toBe(true);
+    // Should not duplicate the prompt
+    expect(result.indexOf('My prompt')).toBe(result.lastIndexOf('My prompt'));
+  });
+});