@cleocode/core 2026.3.74 → 2026.4.0

package/dist/hooks/handlers/mcp-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AA+BrB;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}
+{"version":3,"file":"mcp-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AA0BrB;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/hooks/handlers/mcp-hooks.js

@@ -1,32 +1,52 @@
 /**
  * MCP Prompt/Response Hook Handlers - Wave 2 of T5237
  *
- * Handlers for onPromptSubmit and onResponseComplete events.
- * By default, NO brain capture (too noisy). Brain observation is
- * opt-in via CLEO_BRAIN_CAPTURE_MCP=true environment variable.
+ * Handlers for onPromptSubmit, onResponseComplete, and system Notification
+ * events that capture ALL gateway operations (read and write) to BRAIN.
+ * By default, NO brain capture (too noisy). Enable via:
+ *   - Config: brain.captureMcp = true  (checked first)
+ *   - Env:    CLEO_BRAIN_CAPTURE_MCP=true  (overrides config)
  * Auto-registers on module load.
+ *
+ * Note: File-change Notification events (those with filePath + changeType) are
+ * handled by file-hooks.ts. This module handles message-bearing system
+ * notifications (Notification payloads with a message field).
+ *
+ * @task T166
  */
 import { hooks } from '../registry.js';
-function isMissingBrainSchemaError(err) {
-    if (!(err instanceof Error))
-        return false;
-    const message = String(err.message || '').toLowerCase();
-    return message.includes('no such table') && message.includes('brain_');
-}
+import { isAutoCaptureEnabled, isMissingBrainSchemaError } from './handler-helpers.js';
 /**
- * Check if brain capture is enabled for MCP events.
- * Defaults to false (too noisy for normal operation).
+ * Check whether MCP-level brain capture is enabled.
+ *
+ * Resolution order (first truthy wins):
+ *   1. CLEO_BRAIN_CAPTURE_MCP env var (explicit override)
+ *   2. brain.captureMcp project config value
+ *
+ * Defaults to false when neither is set (too noisy for normal operation).
  */
-function isBrainCaptureEnabled() {
-    return process.env['CLEO_BRAIN_CAPTURE_MCP'] === 'true';
+async function isBrainCaptureEnabled(projectRoot) {
+    const envOverride = process.env['CLEO_BRAIN_CAPTURE_MCP'];
+    if (envOverride !== undefined) {
+        return envOverride === 'true';
+    }
+    try {
+        const { loadConfig } = await import('../../config.js');
+        const config = await loadConfig(projectRoot);
+        return config.brain?.captureMcp ?? false;
+    }
+    catch {
+        return false;
+    }
 }
 /**
- * Handle onPromptSubmit - optionally capture prompt events to BRAIN
+ * Handle PromptSubmit - optionally capture ALL gateway prompt events to BRAIN.
  *
- * No-op by default. Set CLEO_BRAIN_CAPTURE_MCP=true to enable.
+ * No-op by default. Enable via brain.captureMcp config or CLEO_BRAIN_CAPTURE_MCP env.
+ * For selective mutation-only capture, use work-capture-hooks.ts instead.
  */
 export async function handlePromptSubmit(projectRoot, payload) {
-    if (!isBrainCaptureEnabled())
+    if (!(await isBrainCaptureEnabled(projectRoot)))
         return;
     const { observeBrain } = await import('../../memory/brain-retrieval.js');
     try {
@@ -43,12 +63,13 @@ export async function handlePromptSubmit(projectRoot, payload) {
     }
 }
 /**
- * Handle onResponseComplete - optionally capture response events to BRAIN
+ * Handle ResponseComplete - optionally capture ALL gateway response events to BRAIN.
  *
- * No-op by default. Set CLEO_BRAIN_CAPTURE_MCP=true to enable.
+ * No-op by default. Enable via brain.captureMcp config or CLEO_BRAIN_CAPTURE_MCP env.
+ * For selective mutation-only capture, use work-capture-hooks.ts instead.
  */
 export async function handleResponseComplete(projectRoot, payload) {
-    if (!isBrainCaptureEnabled())
+    if (!(await isBrainCaptureEnabled(projectRoot)))
         return;
     const { observeBrain } = await import('../../memory/brain-retrieval.js');
     try {
@@ -64,17 +85,63 @@ export async function handleResponseComplete(projectRoot, payload) {
             throw err;
     }
 }
+/**
+ * Handle Notification — capture system notifications as BRAIN observations.
+ *
+ * Only fires for Notification payloads that carry a message field (i.e. system
+ * notifications). File-change notifications (filePath + changeType) are
+ * handled exclusively by file-hooks.ts and are skipped here to avoid
+ * double-capture.
+ *
+ * Gated behind brain.autoCapture config. Never throws.
+ *
+ * @param projectRoot - Absolute path to the project root directory.
+ * @param payload     - Notification event payload.
+ *
+ * @task T166
+ */
+export async function handleSystemNotification(projectRoot, payload) {
+    // File-change notifications are handled by file-hooks.ts
+    if (payload.filePath || payload.changeType)
+        return;
+    // Only handle message-bearing system notifications
+    if (!payload.message)
+        return;
+    if (!(await isAutoCaptureEnabled(projectRoot)))
+        return;
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `System notification: ${payload.message}`,
+            title: `Notification: ${payload.message.slice(0, 60)}`,
+            type: 'discovery',
+            sourceSessionId: payload.sessionId,
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
 // Register handlers on module load
 hooks.register({
     id: 'brain-prompt-submit',
-    event: 'onPromptSubmit',
+    event: 'PromptSubmit',
     handler: handlePromptSubmit,
     priority: 100,
 });
 hooks.register({
     id: 'brain-response-complete',
-    event: 'onResponseComplete',
+    event: 'ResponseComplete',
     handler: handleResponseComplete,
     priority: 100,
 });
+// Lower priority (90) so file-hooks.ts (100) runs first for Notification events
+hooks.register({
+    id: 'brain-system-notification',
+    event: 'Notification',
+    handler: handleSystemNotification,
+    priority: 90,
+});
 //# sourceMappingURL=mcp-hooks.js.map

package/dist/hooks/handlers/mcp-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"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"}

package/dist/hooks/handlers/session-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAS1E;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Cf"}
+{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI1E;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Cf"}

package/dist/hooks/handlers/session-hooks.js

@@ -9,15 +9,10 @@
  * T144: Extracts transcript observations on session end.
  */
 import { hooks } from '../registry.js';
+import { isMissingBrainSchemaError } from './handler-helpers.js';
 import { maybeRefreshMemoryBridge } from './memory-bridge-refresh.js';
-function isMissingBrainSchemaError(err) {
-    if (!(err instanceof Error))
-        return false;
-    const message = String(err.message || '').toLowerCase();
-    return message.includes('no such table') && message.includes('brain_');
-}
 /**
- * Handle onSessionStart - capture initial session context
+ * Handle SessionStart - capture initial session context
  *
  * T138: Refresh memory bridge on session start.
  * T139: Regenerate bridge with session scope context.
@@ -41,7 +36,7 @@ export async function handleSessionStart(projectRoot, payload) {
     await maybeRefreshMemoryBridge(projectRoot);
 }
 /**
- * Handle onSessionEnd - capture session summary
+ * Handle SessionEnd - capture session summary
  *
  * T138: Refresh memory bridge after session ends.
  * T144: Extract transcript observations via cross-provider adapter.
@@ -96,13 +91,13 @@ export async function handleSessionEnd(projectRoot, payload) {
 // Register handlers on module load
 hooks.register({
     id: 'brain-session-start',
-    event: 'onSessionStart',
+    event: 'SessionStart',
     handler: handleSessionStart,
     priority: 100,
 });
 hooks.register({
     id: 'brain-session-end',
-    event: 'onSessionEnd',
+    event: 'SessionEnd',
     handler: handleSessionEnd,
     priority: 100,
 });

package/dist/hooks/handlers/session-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"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"}

package/dist/hooks/handlers/task-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASzE;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf"}
+{"version":3,"file":"task-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIzE;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/hooks/handlers/task-hooks.js

@@ -7,15 +7,10 @@
  * T138: Triggers memory bridge refresh after task completion.
  */
 import { hooks } from '../registry.js';
+import { isMissingBrainSchemaError } from './handler-helpers.js';
 import { maybeRefreshMemoryBridge } from './memory-bridge-refresh.js';
-function isMissingBrainSchemaError(err) {
-    if (!(err instanceof Error))
-        return false;
-    const message = String(err.message || '').toLowerCase();
-    return message.includes('no such table') && message.includes('brain_');
-}
 /**
- * Handle onToolStart (maps to task.start in CLEO)
+ * Handle PreToolUse (maps to task.start in CLEO, canonical: was onToolStart)
  */
 export async function handleToolStart(projectRoot, payload) {
     const { observeBrain } = await import('../../memory/brain-retrieval.js');
@@ -33,7 +28,7 @@ export async function handleToolStart(projectRoot, payload) {
     }
 }
 /**
- * Handle onToolComplete (maps to task.complete in CLEO)
+ * Handle PostToolUse (maps to task.complete in CLEO, canonical: was onToolComplete)
  *
  * T138: Refresh memory bridge after task completion.
  */
@@ -57,13 +52,13 @@ export async function handleToolComplete(projectRoot, payload) {
 // Register handlers
 hooks.register({
     id: 'brain-tool-start',
-    event: 'onToolStart',
+    event: 'PreToolUse',
     handler: handleToolStart,
     priority: 100,
 });
 hooks.register({
     id: 'brain-tool-complete',
-    event: 'onToolComplete',
+    event: 'PostToolUse',
     handler: handleToolComplete,
     priority: 100,
 });

package/dist/hooks/handlers/task-hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,SAAS,yBAAyB,CAAC,GAAY;IAC7C,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,OAAO,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,OAA2B;IAE3B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,mBAAmB,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE;YAC/D,KAAK,EAAE,eAAe,OAAO,CAAC,MAAM,EAAE;YACtC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAA8B;IAE9B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,QAAQ,OAAO,CAAC,MAAM,2BAA2B,OAAO,CAAC,MAAM,EAAE;YACvE,KAAK,EAAE,kBAAkB,OAAO,CAAC,MAAM,EAAE;YACzC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;IAED,iEAAiE;IACjE,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,oBAAoB;AACpB,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC"}
+{"version":3,"file":"task-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,OAA0B;IAE1B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,mBAAmB,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,SAAS,EAAE;YAC/D,KAAK,EAAE,eAAe,OAAO,CAAC,MAAM,EAAE;YACtC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAA2B;IAE3B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE;YAC9B,IAAI,EAAE,QAAQ,OAAO,CAAC,MAAM,2BAA2B,OAAO,CAAC,MAAM,EAAE;YACvE,KAAK,EAAE,kBAAkB,OAAO,CAAC,MAAM,EAAE;YACzC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YAAE,MAAM,GAAG,CAAC;IACjD,CAAC;IAED,iEAAiE;IACjE,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,oBAAoB;AACpB,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,KAAK,CAAC,QAAQ,CAAC;IACb,EAAE,EAAE,qBAAqB;IACzB,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC"}

package/dist/hooks/handlers/work-capture-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"work-capture-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/work-capture-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAkFhF;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"work-capture-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/work-capture-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAyEhF;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/hooks/handlers/work-capture-hooks.js

@@ -0,0 +1,165 @@
+/**
+ * Active-Work Capture Hook Handlers
+ *
+ * Captures dispatch mutation events to BRAIN during active work, closing
+ * the gap between lifecycle-only capture (session end, task complete) and
+ * continuous capture. Only WRITE operations that represent meaningful work
+ * are captured — reads and operations already handled by lifecycle hooks
+ * are skipped to avoid flooding brain.db.
+ *
+ * Disabled by default. Enable via:
+ *   - Config: brain.captureWork = true  (checked first)
+ *   - Env:    CLEO_BRAIN_CAPTURE_WORK=true  (overrides config)
+ *
+ * Auto-registers on module load.
+ *
+ * @task T142
+ */
+import { hooks } from '../registry.js';
+import { isMissingBrainSchemaError } from './handler-helpers.js';
+/**
+ * Check whether active-work capture is enabled.
+ *
+ * Resolution order (first truthy wins):
+ *   1. CLEO_BRAIN_CAPTURE_WORK env var (explicit override)
+ *   2. brain.captureWork project config value
+ *
+ * Defaults to false when neither is set.
+ */
+async function isWorkCaptureEnabled(projectRoot) {
+    const envOverride = process.env['CLEO_BRAIN_CAPTURE_WORK'];
+    if (envOverride !== undefined) {
+        return envOverride === 'true';
+    }
+    try {
+        const { loadConfig } = await import('../../config.js');
+        const config = await loadConfig(projectRoot);
+        return config.brain?.captureWork ?? false;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Smart-filter: which mutations to capture
+// ---------------------------------------------------------------------------
+/**
+ * Mutations that represent novel work not already captured by lifecycle hooks.
+ *
+ * Excluded (already captured elsewhere):
+ *   - tasks.complete  → task-hooks.ts (PostToolUse)
+ *   - session.start   → session-hooks.ts (SessionStart)
+ *   - session.end     → session-hooks.ts (SessionEnd)
+ *   - memory.brain.observe → observeBrain itself writes to brain; self-loop
+ *
+ * All query gateway operations are excluded by the gateway check before
+ * this set is consulted.
+ */
+const CAPTURE_OPERATIONS = new Set([
+    'tasks.add',
+    'tasks.update',
+    'tasks.move',
+    'tasks.link',
+    'tasks.unlink',
+    'tasks.label',
+    'tasks.unlabel',
+    'tasks.note',
+]);
+/**
+ * Determine whether a mutate operation should be captured.
+ *
+ * Only `mutate` gateway operations in CAPTURE_OPERATIONS are captured.
+ * All `query` gateway calls are skipped (reads produce no novel work).
+ *
+ * @param gateway - 'query' or 'mutate'
+ * @param domain  - e.g. 'tasks'
+ * @param operation - e.g. 'add'
+ */
+function shouldCapture(gateway, domain, operation) {
+    if (gateway !== 'mutate')
+        return false;
+    const key = `${domain}.${operation}`;
+    return CAPTURE_OPERATIONS.has(key);
+}
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+/**
+ * Handle PromptSubmit — log incoming mutation intents to BRAIN.
+ *
+ * Only fires for mutate operations in CAPTURE_OPERATIONS.
+ * Gated behind brain.captureWork config (or CLEO_BRAIN_CAPTURE_WORK env).
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param payload     - PromptSubmit event payload
+ */
+export async function handleWorkPromptSubmit(projectRoot, payload) {
+    if (!shouldCapture(payload.gateway, payload.domain, payload.operation))
+        return;
+    if (!(await isWorkCaptureEnabled(projectRoot)))
+        return;
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        await observeBrain(projectRoot, {
+            text: `Dispatch intent: ${payload.gateway}:${payload.domain}.${payload.operation}${payload.source ? ` (from ${payload.source})` : ''}`,
+            title: `Work intent: ${payload.domain}.${payload.operation}`,
+            type: 'discovery',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+/**
+ * Handle ResponseComplete — capture completed mutations to BRAIN.
+ *
+ * Only fires for successful mutate operations in CAPTURE_OPERATIONS.
+ * Failures are skipped — the intent was already captured by handleWorkPromptSubmit.
+ * Gated behind brain.captureWork config (or CLEO_BRAIN_CAPTURE_WORK env).
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param payload     - ResponseComplete event payload
+ */
+export async function handleWorkResponseComplete(projectRoot, payload) {
+    if (!shouldCapture(payload.gateway, payload.domain, payload.operation))
+        return;
+    // Only capture successful completions — failures are noise
+    if (!payload.success)
+        return;
+    if (!(await isWorkCaptureEnabled(projectRoot)))
+        return;
+    const { observeBrain } = await import('../../memory/brain-retrieval.js');
+    try {
+        const durationNote = payload.durationMs != null ? ` (${payload.durationMs}ms)` : '';
+        await observeBrain(projectRoot, {
+            text: `Dispatch complete: ${payload.gateway}:${payload.domain}.${payload.operation}${durationNote}`,
+            title: `Work done: ${payload.domain}.${payload.operation}`,
+            type: 'change',
+            sourceType: 'agent',
+        });
+    }
+    catch (err) {
+        if (!isMissingBrainSchemaError(err))
+            throw err;
+    }
+}
+// ---------------------------------------------------------------------------
+// Auto-registration
+// ---------------------------------------------------------------------------
+// Register at lower priority (90) than lifecycle hooks (100) so lifecycle
+// handlers always run first.
+hooks.register({
+    id: 'work-capture-prompt-submit',
+    event: 'PromptSubmit',
+    handler: handleWorkPromptSubmit,
+    priority: 90,
+});
+hooks.register({
+    id: 'work-capture-response-complete',
+    event: 'ResponseComplete',
+    handler: handleWorkResponseComplete,
+    priority: 90,
+});
+//# sourceMappingURL=work-capture-hooks.js.map

package/dist/hooks/handlers/work-capture-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-capture-hooks.js","sourceRoot":"","sources":["../../../src/hooks/handlers/work-capture-hooks.ts"],"names":[],"mappings":"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"}

package/dist/hooks/payload-schemas.js

@@ -22,39 +22,53 @@ export const HookPayloadSchema = z.object({
 // ============================================================================
 // CAAMP-mapped Event Payload Schemas
 // ============================================================================
-/** Zod schema for {@link OnSessionStartPayload}. */
-export const OnSessionStartPayloadSchema = HookPayloadSchema.extend({
+/** Zod schema for {@link SessionStartPayload}. */
+export const SessionStartPayloadSchema = HookPayloadSchema.extend({
     sessionId: z.string(),
     name: z.string(),
     scope: z.string(),
     agent: z.string().optional(),
 });
-/** Zod schema for {@link OnSessionEndPayload}. */
-export const OnSessionEndPayloadSchema = HookPayloadSchema.extend({
+/** @deprecated Use {@link SessionStartPayloadSchema}. Kept for backward compatibility. */
+export const OnSessionStartPayloadSchema = SessionStartPayloadSchema;
+/** Zod schema for {@link SessionEndPayload}. */
+export const SessionEndPayloadSchema = HookPayloadSchema.extend({
     sessionId: z.string(),
     duration: z.number(),
     tasksCompleted: z.array(z.string()),
 });
-/** Zod schema for {@link OnToolStartPayload}. */
-export const OnToolStartPayloadSchema = HookPayloadSchema.extend({
+/** @deprecated Use {@link SessionEndPayloadSchema}. Kept for backward compatibility. */
+export const OnSessionEndPayloadSchema = SessionEndPayloadSchema;
+/** Zod schema for {@link PreToolUsePayload}. */
+export const PreToolUsePayloadSchema = HookPayloadSchema.extend({
     taskId: z.string(),
     taskTitle: z.string(),
     previousTask: z.string().optional(),
+    toolName: z.string().optional(),
+    toolInput: z.record(z.string(), z.unknown()).optional(),
 });
-/** Zod schema for {@link OnToolCompletePayload}. */
-export const OnToolCompletePayloadSchema = HookPayloadSchema.extend({
+/** @deprecated Use {@link PreToolUsePayloadSchema}. Kept for backward compatibility. */
+export const OnToolStartPayloadSchema = PreToolUsePayloadSchema;
+/** Zod schema for {@link PostToolUsePayload}. */
+export const PostToolUsePayloadSchema = HookPayloadSchema.extend({
     taskId: z.string(),
     taskTitle: z.string(),
     status: z.enum(['done', 'archived', 'cancelled']),
+    toolResult: z.record(z.string(), z.unknown()).optional(),
 });
-/** Zod schema for {@link OnFileChangePayload}. */
-export const OnFileChangePayloadSchema = HookPayloadSchema.extend({
-    filePath: z.string(),
-    changeType: z.enum(['write', 'create', 'delete']),
+/** @deprecated Use {@link PostToolUsePayloadSchema}. Kept for backward compatibility. */
+export const OnToolCompletePayloadSchema = PostToolUsePayloadSchema;
+/** Zod schema for {@link NotificationPayload}. */
+export const NotificationPayloadSchema = HookPayloadSchema.extend({
+    filePath: z.string().optional(),
+    changeType: z.enum(['write', 'create', 'delete']).optional(),
     sizeBytes: z.number().optional(),
+    message: z.string().optional(),
 });
-/** Zod schema for {@link OnErrorPayload}. */
-export const OnErrorPayloadSchema = HookPayloadSchema.extend({
+/** @deprecated Use {@link NotificationPayloadSchema}. Kept for backward compatibility. */
+export const OnFileChangePayloadSchema = NotificationPayloadSchema;
+/** Zod schema for {@link PostToolUseFailurePayload}. */
+export const PostToolUseFailurePayloadSchema = HookPayloadSchema.extend({
     errorCode: z.union([z.number(), z.string()]),
     message: z.string(),
     domain: z.string().optional(),
@@ -62,15 +76,19 @@ export const OnErrorPayloadSchema = HookPayloadSchema.extend({
     gateway: z.string().optional(),
     stack: z.string().optional(),
 });
-/** Zod schema for {@link OnPromptSubmitPayload}. */
-export const OnPromptSubmitPayloadSchema = HookPayloadSchema.extend({
+/** @deprecated Use {@link PostToolUseFailurePayloadSchema}. Kept for backward compatibility. */
+export const OnErrorPayloadSchema = PostToolUseFailurePayloadSchema;
+/** Zod schema for {@link PromptSubmitPayload}. */
+export const PromptSubmitPayloadSchema = HookPayloadSchema.extend({
     gateway: z.string(),
     domain: z.string(),
     operation: z.string(),
     source: z.string().optional(),
 });
-/** Zod schema for {@link OnResponseCompletePayload}. */
-export const OnResponseCompletePayloadSchema = HookPayloadSchema.extend({
+/** @deprecated Use {@link PromptSubmitPayloadSchema}. Kept for backward compatibility. */
+export const OnPromptSubmitPayloadSchema = PromptSubmitPayloadSchema;
+/** Zod schema for {@link ResponseCompletePayload}. */
+export const ResponseCompletePayloadSchema = HookPayloadSchema.extend({
     gateway: z.string(),
     domain: z.string(),
     operation: z.string(),
@@ -78,6 +96,38 @@ export const OnResponseCompletePayloadSchema = HookPayloadSchema.extend({
     durationMs: z.number().optional(),
     errorCode: z.string().optional(),
 });
+/** @deprecated Use {@link ResponseCompletePayloadSchema}. Kept for backward compatibility. */
+export const OnResponseCompletePayloadSchema = ResponseCompletePayloadSchema;
+/** Zod schema for {@link SubagentStartPayload}. */
+export const SubagentStartPayloadSchema = HookPayloadSchema.extend({
+    agentId: z.string(),
+    role: z.string().optional(),
+    taskId: z.string().optional(),
+});
+/** Zod schema for {@link SubagentStopPayload}. */
+export const SubagentStopPayloadSchema = HookPayloadSchema.extend({
+    agentId: z.string(),
+    status: z.enum(['complete', 'partial', 'blocked', 'failed']).optional(),
+    taskId: z.string().optional(),
+    summary: z.string().optional(),
+});
+/** Zod schema for {@link PreCompactPayload}. */
+export const PreCompactPayloadSchema = HookPayloadSchema.extend({
+    tokensBefore: z.number().optional(),
+    reason: z.string().optional(),
+});
+/** Zod schema for {@link PostCompactPayload}. */
+export const PostCompactPayloadSchema = HookPayloadSchema.extend({
+    tokensBefore: z.number().optional(),
+    tokensAfter: z.number().optional(),
+    success: z.boolean(),
+});
+/** Zod schema for {@link ConfigChangePayload}. */
+export const ConfigChangePayloadSchema = HookPayloadSchema.extend({
+    key: z.string(),
+    previousValue: z.unknown().optional(),
+    newValue: z.unknown().optional(),
+});
 // ============================================================================
 // CLEO Internal Event Payload Schemas
 // ============================================================================
@@ -126,14 +176,21 @@ export const OnPatrolPayloadSchema = HookPayloadSchema.extend({
  * this map fall back to the base {@link HookPayloadSchema}.
  */
 const EVENT_SCHEMA_MAP = {
-    onSessionStart: OnSessionStartPayloadSchema,
-    onSessionEnd: OnSessionEndPayloadSchema,
-    onToolStart: OnToolStartPayloadSchema,
-    onToolComplete: OnToolCompletePayloadSchema,
-    onFileChange: OnFileChangePayloadSchema,
-    onError: OnErrorPayloadSchema,
-    onPromptSubmit: OnPromptSubmitPayloadSchema,
-    onResponseComplete: OnResponseCompletePayloadSchema,
+    // CAAMP canonical events (16)
+    SessionStart: SessionStartPayloadSchema,
+    SessionEnd: SessionEndPayloadSchema,
+    PreToolUse: PreToolUsePayloadSchema,
+    PostToolUse: PostToolUsePayloadSchema,
+    Notification: NotificationPayloadSchema,
+    PostToolUseFailure: PostToolUseFailurePayloadSchema,
+    PromptSubmit: PromptSubmitPayloadSchema,
+    ResponseComplete: ResponseCompletePayloadSchema,
+    SubagentStart: SubagentStartPayloadSchema,
+    SubagentStop: SubagentStopPayloadSchema,
+    PreCompact: PreCompactPayloadSchema,
+    PostCompact: PostCompactPayloadSchema,
+    ConfigChange: ConfigChangePayloadSchema,
+    // CLEO internal coordination events (5)
     onWorkAvailable: OnWorkAvailablePayloadSchema,
     onAgentSpawn: OnAgentSpawnPayloadSchema,
     onAgentComplete: OnAgentCompletePayloadSchema,