feat: migrate CLEO hooks to CAAMP 1.9.1 canonical 16-event taxonomy (T160)

Hook system migrated from 8 internal `on`-prefix events to CAAMP's
16-event canonical taxonomy (SessionStart, PreToolUse, PostToolUse,
SubagentStart, PreCompact, Notification, ConfigChange, etc.).

Types (hooks/types.ts):
- ProviderHookEvent now aliases CAAMP CanonicalHookEvent
- New payload types: SubagentStartPayload, SubagentStopPayload,
  PreCompactPayload, PostCompactPayload, NotificationPayload,
  ConfigChangePayload, PermissionRequestPayload
- CAAMP normalizer APIs re-exported: toNative, toCanonical,
  supportsHook, buildHookMatrix, HOOK_CATEGORIES
- CLEO_TO_CAAMP_HOOK_MAP updated to canonical names

Registry (hooks/registry.ts):
- LEGACY_EVENT_MAP for backward compat (onSessionStart → SessionStart)
- Deprecation warnings on legacy event names
- DEFAULT_HOOK_CONFIG covers all 21 events (16 canonical + 5 internal)

Handlers: all 6 handler files register on canonical names
Dispatch sites: sessions, task-work, store/json, cli.ts, mcp/index.ts
Adapters: claude-code + opencode use CAAMP toNative/toCanonical
Schemas: payload-schemas.ts keyed on canonical names with new schemas

4912 tests pass, 0 failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: kryptobaseddev

.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"103a7009-066d-4634-8d38-3543bdfe7e18","pid":1027949,"acquiredAt":1774333332431}

.cleo/brain.db

@@ -1,7 +1,5 @@
 <!-- CAAMP:START -->
-@~/.agents/AGENTS.md
-@.cleo/project-context.json
-@.cleo/memory-bridge.md
+@AGENTS.md
 <!-- CAAMP:END -->
 
 # CLEO Agent Code Quality Rules (MANDATORY)

.cleo/logs/cleo.2026-03-18.1.log

@@ -43,11 +43,11 @@ export class ClaudeCodeAdapter implements CLEOProviderAdapter {
   capabilities: AdapterCapabilities = {
     supportsHooks: true,
     supportedHookEvents: [
-      'onSessionStart',
-      'onSessionEnd',
-      'onToolStart',
-      'onToolComplete',
-      'onError',
+      'SessionStart',
+      'SessionEnd',
+      'PreToolUse',
+      'PostToolUse',
+      'PostToolUseFailure',
     ],
     supportsSpawn: true,
     supportsInstall: true,

.cleo/tasks.db

@@ -1,9 +1,9 @@
 /**
  * Claude Code Hook Provider
  *
- * Maps Claude Code's native hook events to CAAMP hook events.
+ * Maps Claude Code's native hook events to CAAMP canonical hook events.
  * Claude Code uses: SessionStart, PostToolUse, UserPromptSubmit, Stop
- * CAAMP defines: onSessionStart, onToolComplete, onPromptSubmit, onSessionEnd
+ * CAAMP canonical: SessionStart, PostToolUse, PromptSubmit, SessionEnd
  *
  * @task T5240
  * @task T144
@@ -15,13 +15,18 @@ import { join } from 'node:path';
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
 /**
- * Mapping from Claude Code native event names to CAAMP event names.
+ * Mapping from Claude Code native event names to CAAMP canonical event names.
  */
 const CLAUDE_CODE_EVENT_MAP: Record<string, string> = {
-  SessionStart: 'onSessionStart',
-  PostToolUse: 'onToolComplete',
-  UserPromptSubmit: 'onPromptSubmit',
-  Stop: 'onSessionEnd',
+  SessionStart: 'SessionStart',
+  PostToolUse: 'PostToolUse',
+  UserPromptSubmit: 'PromptSubmit',
+  Stop: 'SessionEnd',
+  PreToolUse: 'PreToolUse',
+  PostToolUseFailure: 'PostToolUseFailure',
+  Notification: 'Notification',
+  SubagentStart: 'SubagentStart',
+  SubagentStop: 'SubagentStop',
 };
 
 /**

AGENTS.md

@@ -38,12 +38,12 @@ export class OpenCodeAdapter implements CLEOProviderAdapter {
   capabilities: AdapterCapabilities = {
     supportsHooks: true,
     supportedHookEvents: [
-      'onSessionStart',
-      'onSessionEnd',
-      'onToolStart',
-      'onToolComplete',
-      'onError',
-      'onPromptSubmit',
+      'SessionStart',
+      'SessionEnd',
+      'PreToolUse',
+      'PostToolUse',
+      'PostToolUseFailure',
+      'PromptSubmit',
     ],
     supportsSpawn: true,
     supportsInstall: true,

packages/adapters/src/providers/claude-code/adapter.ts

@@ -1,35 +1,35 @@
 /**
  * OpenCode Hook Provider
  *
- * Maps OpenCode's native hook events to CAAMP hook events.
- * OpenCode supports 6 of 8 CAAMP events through its agent/hook system.
+ * Maps OpenCode's native hook events to CAAMP canonical hook events.
+ * OpenCode supports 6 of the canonical events through its agent/hook system.
  *
  * OpenCode event mapping:
- * - session.start     -> onSessionStart
- * - session.end       -> onSessionEnd
- * - tool.start        -> onToolStart
- * - tool.complete     -> onToolComplete
- * - error             -> onError
- * - prompt.submit     -> onPromptSubmit
+ * - session.start     -> SessionStart
+ * - session.end       -> SessionEnd
+ * - tool.start        -> PreToolUse
+ * - tool.complete     -> PostToolUse
+ * - error             -> PostToolUseFailure
+ * - prompt.submit     -> PromptSubmit
  *
  * @task T5240
  */
 
 import type { AdapterHookProvider } from '@cleocode/contracts';
 
 /**
- * Mapping from OpenCode native event names to CAAMP event names.
+ * Mapping from OpenCode native event names to CAAMP canonical event names.
  *
  * OpenCode uses dot-delimited event names (e.g. "session.start")
- * while CAAMP uses camelCase (e.g. "onSessionStart").
+ * while CAAMP canonical names are PascalCase (e.g. "SessionStart").
  */
 const OPENCODE_EVENT_MAP: Record<string, string> = {
-  'session.start': 'onSessionStart',
-  'session.end': 'onSessionEnd',
-  'tool.start': 'onToolStart',
-  'tool.complete': 'onToolComplete',
-  error: 'onError',
-  'prompt.submit': 'onPromptSubmit',
+  'session.start': 'SessionStart',
+  'session.end': 'SessionEnd',
+  'tool.start': 'PreToolUse',
+  'tool.complete': 'PostToolUse',
+  error: 'PostToolUseFailure',
+  'prompt.submit': 'PromptSubmit',
 };
 
 /**

packages/adapters/src/providers/claude-code/hooks.ts

@@ -144,9 +144,9 @@ export async function dispatchFromCli(
   const projectRoot = getProjectRoot();
   const dispatchStart = Date.now();
 
-  // Dispatch onPromptSubmit hook (best-effort, fire-and-forget)
+  // Dispatch PromptSubmit hook (best-effort, fire-and-forget)
   hooks
-    .dispatch('onPromptSubmit', projectRoot, {
+    .dispatch('PromptSubmit', projectRoot, {
       timestamp: new Date().toISOString(),
       gateway,
       domain,
@@ -166,9 +166,9 @@ export async function dispatchFromCli(
     requestId: randomUUID(),
   });
 
-  // Dispatch onResponseComplete hook (best-effort, fire-and-forget)
+  // Dispatch ResponseComplete hook (best-effort, fire-and-forget)
   hooks
-    .dispatch('onResponseComplete', projectRoot, {
+    .dispatch('ResponseComplete', projectRoot, {
       timestamp: new Date().toISOString(),
       gateway,
       domain,
@@ -253,9 +253,9 @@ export async function dispatchRaw(
   const projectRoot = getProjectRoot();
   const dispatchStart = Date.now();
 
-  // Dispatch onPromptSubmit hook (best-effort, fire-and-forget)
+  // Dispatch PromptSubmit hook (best-effort, fire-and-forget)
   hooks
-    .dispatch('onPromptSubmit', projectRoot, {
+    .dispatch('PromptSubmit', projectRoot, {
       timestamp: new Date().toISOString(),
       gateway,
       domain,
@@ -275,9 +275,9 @@ export async function dispatchRaw(
     requestId: randomUUID(),
   });
 
-  // Dispatch onResponseComplete hook (best-effort, fire-and-forget)
+  // Dispatch ResponseComplete hook (best-effort, fire-and-forget)
   hooks
-    .dispatch('onResponseComplete', projectRoot, {
+    .dispatch('ResponseComplete', projectRoot, {
       timestamp: new Date().toISOString(),
       gateway,
       domain,