@cleocode/adapters 2026.4.38 → 2026.4.39

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;IAsE5D;;;;;;;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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.4.38",
+  "version": "2026.4.39",
   "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.39",
+    "@cleocode/contracts": "2026.4.39"
   },
   "license": "MIT",
   "engines": {

package/src/providers/claude-code/adapter.ts

@@ -123,6 +123,10 @@ export class ClaudeCodeAdapter implements CLEOProviderAdapter {
   async initialize(projectDir: string): Promise<void> {
     this.projectDir = projectDir;
     this.initialized = true;
+
+    // Activate CLEO hook bridge for this project — connects Claude Code
+    // native events to CLEO's internal hook dispatch (T555).
+    await this.hooks.registerNativeHooks(projectDir);
   }
 
   /**

package/src/providers/claude-code/hooks.ts

@@ -16,7 +16,9 @@
  * @epic T134
  */
 
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { readdir, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
 import { join } from 'node:path';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
@@ -107,33 +109,145 @@ export class ClaudeCodeHookProvider implements AdapterHookProvider {
     return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
   }
 
+  /** Project directory this hook provider was registered for. */
+  private projectDir: string | null = null;
+
   /**
    * 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
    */
-  async registerNativeHooks(_projectDir: string): Promise<void> {
+  async registerNativeHooks(projectDir: string): Promise<void> {
+    this.projectDir = projectDir;
     this.registered = true;
+
+    // Write CLEO hook entries to ~/.claude/settings.json (idempotent)
+    try {
+      const home = homedir();
+      const settingsPath = join(home, '.claude', 'settings.json');
+
+      let settings: Record<string, unknown> = {};
+      if (existsSync(settingsPath)) {
+        try {
+          settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        } catch {
+          // Start fresh if settings.json is corrupt
+        }
+      }
+
+      const hooks = (settings.hooks ?? {}) as Record<string, unknown[]>;
+
+      // Check if CLEO hooks already registered (look for our marker comment in commands)
+      const alreadyRegistered = Object.values(hooks).some((entries) =>
+        Array.isArray(entries) &&
+        entries.some(
+          (e) =>
+            typeof e === 'object' &&
+            e !== null &&
+            Array.isArray((e as Record<string, unknown>).hooks) &&
+            ((e as Record<string, unknown>).hooks as Array<Record<string, string>>).some(
+              (h) => typeof h.command === 'string' && h.command.includes('# cleo-hook'),
+            ),
+        ),
+      );
+
+      if (alreadyRegistered) {
+        return; // Already wired — idempotent
+      }
+
+      // Register Stop hook → triggers cleo session end (LLM extraction, reflector, consolidation)
+      if (!hooks.Stop) hooks.Stop = [];
+      (hooks.Stop as unknown[]).push({
+        matcher: '',
+        hooks: [
+          {
+            type: 'command',
+            command: `cleo session end --quiet # cleo-hook`,
+          },
+        ],
+      });
+
+      // Register PostToolUse hook → brain observation for file writes
+      if (!hooks.PostToolUse) hooks.PostToolUse = [];
+      (hooks.PostToolUse as unknown[]).push({
+        matcher: 'Write|Edit',
+        hooks: [
+          {
+            type: 'command',
+            command: `cleo observe "File modified via $TOOL_NAME" --title "tool-use" --quiet # cleo-hook`,
+          },
+        ],
+      });
+
+      settings.hooks = hooks;
+      mkdirSync(join(home, '.claude'), { recursive: true });
+      writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+    } catch {
+      // Settings write failure is non-fatal — hooks can be registered manually
+    }
   }
 
   /**
    * 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
    */
   async unregisterNativeHooks(): Promise<void> {
     this.registered = false;
+    this.projectDir = null;
+
+    try {
+      const home = homedir();
+      const settingsPath = join(home, '.claude', 'settings.json');
+      if (!existsSync(settingsPath)) return;
+
+      const settings = JSON.parse(readFileSync(settingsPath, 'utf-8')) as Record<string, unknown>;
+      const hooks = settings.hooks as Record<string, unknown[]> | undefined;
+      if (!hooks) return;
+
+      // Filter out entries with the cleo-hook marker
+      let changed = false;
+      for (const [event, entries] of Object.entries(hooks)) {
+        if (!Array.isArray(entries)) continue;
+        const filtered = entries.filter(
+          (e) =>
+            !(
+              typeof e === 'object' &&
+              e !== null &&
+              Array.isArray((e as Record<string, unknown>).hooks) &&
+              ((e as Record<string, unknown>).hooks as Array<Record<string, string>>).some(
+                (h) => typeof h.command === 'string' && h.command.includes('# cleo-hook'),
+              )
+            ),
+        );
+        if (filtered.length !== entries.length) {
+          hooks[event] = filtered;
+          changed = true;
+        }
+      }
+
+      if (changed) {
+        settings.hooks = hooks;
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+      }
+    } catch {
+      // Cleanup failure is non-fatal
+    }
   }
 
   /**
@@ -143,6 +257,15 @@ export class ClaudeCodeHookProvider implements AdapterHookProvider {
     return this.registered;
   }
 
+  /**
+   * Get the project directory this hook provider was registered for.
+   *
+   * Returns null if hooks have not been registered yet.
+   */
+  getProjectDir(): string | null {
+    return this.projectDir;
+  }
+
   /**
    * Get the native→canonical event mapping for introspection and debugging.
    *