@cleocode/adapters 2026.10.8 → 2026.10.9

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

@@ -20,6 +20,7 @@ import { existsSync } from 'node:fs';
 import { readdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { updateJsonConfigFile } from '@cleocode/caamp';
+import { PROVIDER_NATIVE_EVENT_MAPS } from '@cleocode/caamp/hooks';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 import { excludeLocalSettingsFromGit } from '../shared/heavy-command-hook-install.js';
 import { appendHookEntry, hookMap, isPlainObject, projectClaudeSettingsPath } from './paths.js';
@@ -114,36 +115,7 @@ const PROVIDER_ID = 'claude-code' as const;
  * Used as fallback when CAAMP runtime is unavailable, and as the synchronous
  * implementation of `mapProviderEvent()`.
  */
-const CLAUDE_CODE_EVENT_MAP: Record<string, string> = {
-  // CAAMP: toNative('SessionStart',      'claude-code') = 'SessionStart'
-  SessionStart: 'SessionStart',
-  // CAAMP: toNative('SessionEnd',        'claude-code') = 'SessionEnd'
-  SessionEnd: 'SessionEnd',
-  // CAAMP: toNative('PromptSubmit',      'claude-code') = 'UserPromptSubmit'
-  UserPromptSubmit: 'PromptSubmit',
-  // CAAMP: toNative('ResponseComplete',  'claude-code') = 'Stop'
-  Stop: 'ResponseComplete',
-  // CAAMP: toNative('PreToolUse',        'claude-code') = 'PreToolUse'
-  PreToolUse: 'PreToolUse',
-  // CAAMP: toNative('PostToolUse',       'claude-code') = 'PostToolUse'
-  PostToolUse: 'PostToolUse',
-  // CAAMP: toNative('PostToolUseFailure','claude-code') = 'PostToolUseFailure'
-  PostToolUseFailure: 'PostToolUseFailure',
-  // CAAMP: toNative('PermissionRequest', 'claude-code') = 'PermissionRequest'
-  PermissionRequest: 'PermissionRequest',
-  // CAAMP: toNative('SubagentStart',     'claude-code') = 'SubagentStart'
-  SubagentStart: 'SubagentStart',
-  // CAAMP: toNative('SubagentStop',      'claude-code') = 'SubagentStop'
-  SubagentStop: 'SubagentStop',
-  // CAAMP: toNative('PreCompact',        'claude-code') = 'PreCompact'
-  PreCompact: 'PreCompact',
-  // CAAMP: toNative('PostCompact',       'claude-code') = 'PostCompact'
-  PostCompact: 'PostCompact',
-  // CAAMP: toNative('Notification',      'claude-code') = 'Notification'
-  Notification: 'Notification',
-  // CAAMP: toNative('ConfigChange',      'claude-code') = 'ConfigChange'
-  ConfigChange: 'ConfigChange',
-};
+const CLAUDE_CODE_EVENT_MAP = PROVIDER_NATIVE_EVENT_MAPS['claude-code'] ?? {};
 
 /**
  * Hook provider for Claude Code.

package/src/providers/codex/hooks.ts

@@ -2,12 +2,13 @@
  * Codex CLI Hook Provider
  *
  * Maps Codex CLI's native hook events to CAAMP canonical hook events.
- * Codex CLI supports 3 canonical events through its hook system.
+ * Capabilities and fallback maps are generated from the CAAMP registry.
  *
  * Codex CLI event mapping:
  * - SessionStart      -> SessionStart
  * - PromptSubmit      -> UserPromptSubmit
  * - ResponseComplete  -> Stop
+ * - PreToolUse        -> PreToolUse
  *
  * @task T162
  * @epic T134
@@ -15,23 +16,20 @@
 
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { PROVIDER_NATIVE_EVENT_MAPS } from '@cleocode/caamp/hooks';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 import { readLatestTranscript } from '../shared/transcript-reader.js';
 
 /**
  * Mapping from Codex CLI native event names to CAAMP canonical event names.
  */
-const CODEX_EVENT_MAP: Record<string, string> = {
-  SessionStart: 'SessionStart',
-  PromptSubmit: 'UserPromptSubmit',
-  ResponseComplete: 'Stop',
-};
+const CODEX_EVENT_MAP = PROVIDER_NATIVE_EVENT_MAPS['codex'] ?? {};
 
 /**
  * Hook provider for Codex CLI.
  *
  * Codex CLI registers hooks via its configuration system at
- * ~/.codex/. Hook handlers are shell commands or script paths that
+ * the project-local .codex/hooks.json. Hook handlers are shell commands or script paths that
  * execute when the corresponding event fires.
  *
  * Since hooks are registered through the config system (managed by
@@ -39,9 +37,9 @@ const CODEX_EVENT_MAP: Record<string, string> = {
  * track registration state without performing filesystem operations.
  *
  * @remarks
- * Codex CLI has a minimal hook surface with only 3 canonical events.
+ * Codex supports PreToolUse; version certification remains separate from installation.
  * Registration state is tracked in-memory because Codex CLI manages
- * hooks through its own configuration system at `~/.codex/`.
+ * hooks through its own configuration system. Native project and hook trust are separate.
  *
  * @task T162
  * @epic T134

package/src/providers/cursor/hooks.ts

@@ -20,6 +20,7 @@
  * @epic T134
  */
 
+import { PROVIDER_NATIVE_EVENT_MAPS } from '@cleocode/caamp/hooks';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
 /** CAAMP provider identifier for Cursor. */
@@ -34,28 +35,7 @@ const PROVIDER_ID = 'cursor' as const;
  *
  * Cursor uses camelCase names while CAAMP canonical names are PascalCase.
  */
-const CURSOR_EVENT_MAP: Record<string, string> = {
-  // CAAMP: toNative('SessionStart',       'cursor') = 'sessionStart'
-  sessionStart: 'SessionStart',
-  // CAAMP: toNative('SessionEnd',         'cursor') = 'sessionEnd'
-  sessionEnd: 'SessionEnd',
-  // CAAMP: toNative('PromptSubmit',       'cursor') = 'beforeSubmitPrompt'
-  beforeSubmitPrompt: 'PromptSubmit',
-  // CAAMP: toNative('ResponseComplete',   'cursor') = 'stop'
-  stop: 'ResponseComplete',
-  // CAAMP: toNative('PreToolUse',         'cursor') = 'preToolUse'
-  preToolUse: 'PreToolUse',
-  // CAAMP: toNative('PostToolUse',        'cursor') = 'postToolUse'
-  postToolUse: 'PostToolUse',
-  // CAAMP: toNative('PostToolUseFailure', 'cursor') = 'postToolUseFailure'
-  postToolUseFailure: 'PostToolUseFailure',
-  // CAAMP: toNative('SubagentStart',      'cursor') = 'subagentStart'
-  subagentStart: 'SubagentStart',
-  // CAAMP: toNative('SubagentStop',       'cursor') = 'subagentStop'
-  subagentStop: 'SubagentStop',
-  // CAAMP: toNative('PreCompact',         'cursor') = 'preCompact'
-  preCompact: 'PreCompact',
-};
+const CURSOR_EVENT_MAP = PROVIDER_NATIVE_EVENT_MAPS['cursor'] ?? {};
 
 /**
  * Hook provider for Cursor.

package/src/providers/gemini-cli/hooks.ts

@@ -22,24 +22,14 @@
 
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { PROVIDER_NATIVE_EVENT_MAPS } from '@cleocode/caamp/hooks';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 import { readLatestTranscript } from '../shared/transcript-reader.js';
 
 /**
  * Mapping from Gemini CLI native event names to CAAMP canonical event names.
  */
-const GEMINI_CLI_EVENT_MAP: Record<string, string> = {
-  SessionStart: 'SessionStart',
-  SessionEnd: 'SessionEnd',
-  PromptSubmit: 'BeforeAgent',
-  ResponseComplete: 'AfterAgent',
-  PreToolUse: 'BeforeTool',
-  PostToolUse: 'AfterTool',
-  PreModel: 'BeforeModel',
-  PostModel: 'AfterModel',
-  PreCompact: 'PreCompress',
-  Notification: 'Notification',
-};
+const GEMINI_CLI_EVENT_MAP = PROVIDER_NATIVE_EVENT_MAPS['gemini-cli'] ?? {};
 
 /**
  * Hook provider for Gemini CLI.

package/src/providers/opencode/hooks.ts

@@ -19,6 +19,7 @@
  * @epic T134
  */
 
+import { PROVIDER_NATIVE_EVENT_MAPS } from '@cleocode/caamp/hooks';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
 /** CAAMP provider identifier for OpenCode. */
@@ -35,28 +36,7 @@ const PROVIDER_ID = 'opencode' as const;
  * OpenCode uses dot-delimited and event-prefixed names (e.g. "event:session.created")
  * while CAAMP canonical names are PascalCase (e.g. "SessionStart").
  */
-const OPENCODE_EVENT_MAP: Record<string, string> = {
-  // CAAMP: toNative('SessionStart',       'opencode') = 'event:session.created'
-  'event:session.created': 'SessionStart',
-  // CAAMP: toNative('SessionEnd',         'opencode') = 'event:session.deleted'
-  'event:session.deleted': 'SessionEnd',
-  // CAAMP: toNative('PromptSubmit',       'opencode') = 'chat.message'
-  'chat.message': 'PromptSubmit',
-  // CAAMP: toNative('ResponseComplete',   'opencode') = 'event:session.idle'
-  'event:session.idle': 'ResponseComplete',
-  // CAAMP: toNative('PreToolUse',         'opencode') = 'tool.execute.before'
-  'tool.execute.before': 'PreToolUse',
-  // CAAMP: toNative('PostToolUse',        'opencode') = 'tool.execute.after'
-  'tool.execute.after': 'PostToolUse',
-  // CAAMP: toNative('PermissionRequest',  'opencode') = 'permission.ask'
-  'permission.ask': 'PermissionRequest',
-  // CAAMP: toNative('PreModel',           'opencode') = 'chat.params'
-  'chat.params': 'PreModel',
-  // CAAMP: toNative('PreCompact',         'opencode') = 'experimental.session.compacting'
-  'experimental.session.compacting': 'PreCompact',
-  // CAAMP: toNative('PostCompact',        'opencode') = 'event:session.compacted'
-  'event:session.compacted': 'PostCompact',
-};
+const OPENCODE_EVENT_MAP = PROVIDER_NATIVE_EVENT_MAPS['opencode'] ?? {};
 
 /**
  * Hook provider for OpenCode.

package/src/providers/pi/hooks.ts

@@ -32,6 +32,7 @@
  * @task T553
  */
 
+import { PROVIDER_NATIVE_EVENT_MAPS } from '@cleocode/caamp/hooks';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
 /** CAAMP provider identifier for Pi. */
@@ -48,32 +49,7 @@ const PROVIDER_ID = 'pi' as const;
  * Used as fallback when CAAMP runtime is unavailable, and as the
  * synchronous implementation of `mapProviderEvent()`.
  */
-const PI_EVENT_MAP: Record<string, string> = {
-  // piEventCatalog: session_start → SessionStart
-  session_start: 'SessionStart',
-  // piEventCatalog: session_shutdown → SessionEnd
-  session_shutdown: 'SessionEnd',
-  // piEventCatalog: input → PromptSubmit
-  input: 'PromptSubmit',
-  // piEventCatalog: turn_end → Notification (assistant turn complete)
-  turn_end: 'Notification',
-  // piEventCatalog: tool_call → PreToolUse
-  tool_call: 'PreToolUse',
-  // piEventCatalog: tool_execution_start → PreToolUse (duplicate path)
-  tool_execution_start: 'PreToolUse',
-  // piEventCatalog: tool_result → PostToolUse
-  tool_result: 'PostToolUse',
-  // piEventCatalog: tool_execution_end → PostToolUse (duplicate path)
-  tool_execution_end: 'PostToolUse',
-  // piEventCatalog: before_agent_start → SubagentStart
-  before_agent_start: 'SubagentStart',
-  // piEventCatalog: agent_end → SubagentStop
-  agent_end: 'SubagentStop',
-  // piEventCatalog: before_provider_request → PreModel
-  before_provider_request: 'PreModel',
-  // piEventCatalog: context → PreCompact (context assembly is the pre-compaction proxy for Pi)
-  context: 'PreCompact',
-};
+const PI_EVENT_MAP = PROVIDER_NATIVE_EVENT_MAPS['pi'] ?? {};
 
 /**
  * Hook provider for Pi coding agent.

package/src/providers/shared/heavy-command-hook-install.ts

@@ -526,12 +526,17 @@ export const CODEX_HOOKS_FILE = '.codex/hooks.json';
 export const OPENCODE_PLUGIN_FILE = `.opencode/plugins/${OPENCODE_HEAVY_COMMAND_PLUGIN}`;
 
 /** Run git in `projectDir`; its trimmed stdout, or `null` on any failure. */
-function gitOutput(projectDir: string, args: readonly string[]): string | null {
+function gitOutput(
+  projectDir: string,
+  args: readonly string[],
+  env: NodeJS.ProcessEnv = process.env,
+): string | null {
   try {
     return execFileSync('git', ['-C', projectDir, ...args], {
       encoding: 'utf-8',
       stdio: ['ignore', 'pipe', 'ignore'],
       timeout: 5000,
+      env,
     }).trim();
   } catch {
     return null;
@@ -539,16 +544,20 @@ function gitOutput(projectDir: string, args: readonly string[]): string | null {
 }
 
 /** The repository's `info/exclude` path for `projectDir`, or `null` outside a work tree. */
-function excludeFile(projectDir: string): string | null {
-  if (gitOutput(projectDir, ['rev-parse', '--is-inside-work-tree']) !== 'true') return null;
-  const path = gitOutput(projectDir, ['rev-parse', '--git-path', 'info/exclude']);
+function excludeFile(projectDir: string, env: NodeJS.ProcessEnv = process.env): string | null {
+  if (gitOutput(projectDir, ['rev-parse', '--is-inside-work-tree'], env) !== 'true') return null;
+  const path = gitOutput(projectDir, ['rev-parse', '--git-path', 'info/exclude'], env);
   if (path === null || path === '') return null;
   return isAbsolute(path) ? path : join(projectDir, path);
 }
 
 /** The `info/exclude` line for a project file (relative to the repo root). */
-function excludeLine(projectDir: string, relPath: string): string {
-  const prefix = gitOutput(projectDir, ['rev-parse', '--show-prefix']) ?? '';
+function excludeLine(
+  projectDir: string,
+  relPath: string,
+  env: NodeJS.ProcessEnv = process.env,
+): string {
+  const prefix = gitOutput(projectDir, ['rev-parse', '--show-prefix'], env) ?? '';
   return `/${prefix}${relPath}`;
 }
 
@@ -563,18 +572,20 @@ function excludeLine(projectDir: string, relPath: string): string {
  * @param projectDir - the project root.
  * @param relPath - the file, relative to the project (forward slashes).
  * @param marker - the block's first line.
+ * @param env - Git discovery environment; existing callers retain the process environment.
  * @returns whether a block was added.
  */
 export function excludeHookFileFromGit(
   projectDir: string,
   relPath: string,
   marker: string = HOOK_FILE_EXCLUDE_MARKER,
+  env: NodeJS.ProcessEnv = process.env,
 ): boolean {
-  const exclude = excludeFile(projectDir);
+  const exclude = excludeFile(projectDir, env);
   if (exclude === null) return false;
-  if (gitOutput(projectDir, ['check-ignore', relPath]) !== null) return false;
-  if (gitOutput(projectDir, ['ls-files', '--error-unmatch', relPath]) !== null) return false;
-  const line = excludeLine(projectDir, relPath);
+  if (gitOutput(projectDir, ['check-ignore', relPath], env) !== null) return false;
+  if (gitOutput(projectDir, ['ls-files', '--error-unmatch', relPath], env) !== null) return false;
+  const line = excludeLine(projectDir, relPath, env);
   const text = existsSync(exclude) ? readFileSync(exclude, 'utf-8') : '';
   if (text.split('\n').includes(line)) return false;
   const block = `${marker}\n${line}\n`;