@cleocode/core 2026.3.42 → 2026.3.44

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAsC,MAAM,qBAAqB,CAAC;AACnF,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,yBAAyB,CAAC;AAG5E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAqDD;;;;;GAKG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAGjE,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;IASH;;;;OAIG;IACH,WAAW,IAAI,SAAS;IAgBxB;;;;OAIG;IACH,gBAAgB,IAAI,cAAc;IAmBlC,4EAA4E;IAC5E,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAajC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAetB"}

package/dist/hooks/handlers/error-hooks.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Error Hook Handlers - Wave 2 of T5237
+ *
+ * Captures operation errors to BRAIN via memory.observe.
+ * Includes infinite-loop guard to prevent onError triggering onError.
+ * Auto-registers on module load.
+ */
+import type { OnErrorPayload } from '../types.js';
+/**
+ * Handle onError - capture operation errors to BRAIN
+ *
+ * Includes infinite-loop guard: if the payload has _fromHook marker,
+ * the handler skips to prevent onError -> observeBrain -> onError loops.
+ * Additionally, ALL observeBrain errors are silently suppressed to prevent
+ * re-entrant hook firing.
+ */
+export declare function handleError(projectRoot: string, payload: OnErrorPayload): Promise<void>;
+//# sourceMappingURL=error-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/error-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7F"}

package/dist/hooks/handlers/file-hooks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * File Change Hook Handlers - Wave 2 of T5237
+ *
+ * Captures file change events to BRAIN via memory.observe.
+ * Includes 5-second dedup and path-based filtering to avoid noisy writes.
+ * Auto-registers on module load.
+ *
+ * Disabled by default. Set CLEO_BRAIN_CAPTURE_FILES=true to enable.
+ */
+import type { OnFileChangePayload } from '../types.js';
+/**
+ * Handle onFileChange - capture file changes to BRAIN
+ *
+ * Gated behind CLEO_BRAIN_CAPTURE_FILES=true env var.
+ * Deduplicates rapid writes to the same file within a 5-second window.
+ * Filters out .cleo/ internal files and test temp directories.
+ * Converts absolute paths to project-relative paths.
+ */
+export declare function handleFileChange(projectRoot: string, payload: OnFileChangePayload): Promise<void>;
+//# sourceMappingURL=file-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/file-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA6BvD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/hooks/handlers/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Hook Handlers Index - Phase 2D of T5237
+ *
+ * Barrel export for all hook handlers. Importing this module will
+ * auto-register all handlers with the hook registry.
+ */
+import './session-hooks.js';
+import './task-hooks.js';
+import './error-hooks.js';
+import './file-hooks.js';
+import './mcp-hooks.js';
+export { handleError } from './error-hooks.js';
+export { handleFileChange } from './file-hooks.js';
+export { handlePromptSubmit, handleResponseComplete } from './mcp-hooks.js';
+export { handleSessionEnd, handleSessionStart } from './session-hooks.js';
+export { handleToolComplete, handleToolStart } from './task-hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,iBAAiB,CAAC;AACzB,OAAO,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ * Auto-registers on module load.
+ */
+import type { OnPromptSubmitPayload, OnResponseCompletePayload } from '../types.js';
+/**
+ * Handle onPromptSubmit - optionally capture prompt events to BRAIN
+ *
+ * No-op by default. Set CLEO_BRAIN_CAPTURE_MCP=true to enable.
+ */
+export declare function handlePromptSubmit(projectRoot: string, payload: OnPromptSubmitPayload): Promise<void>;
+/**
+ * Handle onResponseComplete - optionally capture response events to BRAIN
+ *
+ * No-op by default. Set CLEO_BRAIN_CAPTURE_MCP=true to enable.
+ */
+export declare function handleResponseComplete(projectRoot: string, payload: OnResponseCompletePayload): Promise<void>;
+//# sourceMappingURL=mcp-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAgBpF;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAef"}

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

@@ -0,0 +1,16 @@
+/**
+ * Session Hook Handlers - Phase 2D of T5237
+ *
+ * Handlers that capture session lifecycle events to BRAIN via memory.observe.
+ * Auto-registers on module load.
+ */
+import type { OnSessionEndPayload, OnSessionStartPayload } from '../types.js';
+/**
+ * Handle onSessionStart - capture initial session context
+ */
+export declare function handleSessionStart(projectRoot: string, payload: OnSessionStartPayload): Promise<void>;
+/**
+ * Handle onSessionEnd - capture session summary
+ */
+export declare function handleSessionEnd(projectRoot: string, payload: OnSessionEndPayload): Promise<void>;
+//# sourceMappingURL=session-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQ9E;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsBf"}

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

@@ -0,0 +1,16 @@
+/**
+ * Task Hook Handlers - Phase 2D of T5237
+ *
+ * Handlers that capture task lifecycle events to BRAIN via memory.observe.
+ * Auto-registers on module load.
+ */
+import type { OnToolCompletePayload, OnToolStartPayload } from '../types.js';
+/**
+ * Handle onToolStart (maps to task.start in CLEO)
+ */
+export declare function handleToolStart(projectRoot: string, payload: OnToolStartPayload): Promise<void>;
+/**
+ * Handle onToolComplete (maps to task.complete in CLEO)
+ */
+export declare function handleToolComplete(projectRoot: string, payload: OnToolCompletePayload): Promise<void>;
+//# sourceMappingURL=task-hooks.d.ts.map

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

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Hooks System - Barrel Export
+ *
+ * Central export point for the CLEO hooks system.
+ * Import from here to access the hook registry, types, handlers, and
+ * Zod payload validation schemas.
+ *
+ * @module @cleocode/cleo/hooks
+ */
+export * from './handlers/index.js';
+export type { PayloadValidationResult } from './payload-schemas.js';
+export { HookPayloadSchema, OnAgentCompletePayloadSchema, OnAgentSpawnPayloadSchema, OnCascadeStartPayloadSchema, OnErrorPayloadSchema, OnFileChangePayloadSchema, OnPatrolPayloadSchema, OnPromptSubmitPayloadSchema, OnResponseCompletePayloadSchema, OnSessionEndPayloadSchema, OnSessionStartPayloadSchema, OnToolCompletePayloadSchema, OnToolStartPayloadSchema, OnWorkAvailablePayloadSchema, validatePayload, } from './payload-schemas.js';
+export { HookRegistry, hooks } from './registry.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACpD,mBAAmB,YAAY,CAAC"}

package/dist/hooks/payload-schemas.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Zod validation schemas for hook event payloads.
+ *
+ * Provides runtime validation for all hook payload types defined in
+ * ./types.ts. Each schema mirrors its corresponding TypeScript interface
+ * and can be used to validate payloads at dispatch time.
+ *
+ * @module @cleocode/cleo/hooks/payload-schemas
+ */
+import { z } from 'zod/v4';
+import type { HookEvent } from './types.js';
+/** Zod schema for {@link HookPayload}. */
+export declare const HookPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnSessionStartPayload}. */
+export declare const OnSessionStartPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    sessionId: z.ZodString;
+    name: z.ZodString;
+    scope: z.ZodString;
+    agent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnSessionEndPayload}. */
+export declare const OnSessionEndPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    sessionId: z.ZodString;
+    duration: z.ZodNumber;
+    tasksCompleted: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnToolStartPayload}. */
+export declare const OnToolStartPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    taskId: z.ZodString;
+    taskTitle: z.ZodString;
+    previousTask: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnToolCompletePayload}. */
+export declare const OnToolCompletePayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    taskId: z.ZodString;
+    taskTitle: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        done: "done";
+        archived: "archived";
+    }>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnFileChangePayload}. */
+export declare const OnFileChangePayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    filePath: z.ZodString;
+    changeType: z.ZodEnum<{
+        write: "write";
+        create: "create";
+        delete: "delete";
+    }>;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnErrorPayload}. */
+export declare const OnErrorPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    errorCode: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    message: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    operation: z.ZodOptional<z.ZodString>;
+    gateway: z.ZodOptional<z.ZodString>;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnPromptSubmitPayload}. */
+export declare const OnPromptSubmitPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    gateway: z.ZodString;
+    domain: z.ZodString;
+    operation: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnResponseCompletePayload}. */
+export declare const OnResponseCompletePayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    gateway: z.ZodString;
+    domain: z.ZodString;
+    operation: z.ZodString;
+    success: z.ZodBoolean;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    errorCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnWorkAvailablePayload}. */
+export declare const OnWorkAvailablePayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    taskIds: z.ZodArray<z.ZodString>;
+    epicId: z.ZodOptional<z.ZodString>;
+    chainId: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        manual: "manual";
+        "dependency-cleared": "dependency-cleared";
+        "new-task": "new-task";
+        retry: "retry";
+        patrol: "patrol";
+    }>>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnAgentSpawnPayload}. */
+export declare const OnAgentSpawnPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    agentId: z.ZodString;
+    role: z.ZodString;
+    adapterId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnAgentCompletePayload}. */
+export declare const OnAgentCompletePayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    agentId: z.ZodString;
+    role: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        blocked: "blocked";
+        partial: "partial";
+        complete: "complete";
+    }>;
+    taskId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnCascadeStartPayload}. */
+export declare const OnCascadeStartPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cascadeId: z.ZodString;
+    chainId: z.ZodOptional<z.ZodString>;
+    tesseraId: z.ZodOptional<z.ZodString>;
+    taskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** Zod schema for {@link OnPatrolPayload}. */
+export declare const OnPatrolPayloadSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    sessionId: z.ZodOptional<z.ZodString>;
+    taskId: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    watcherId: z.ZodString;
+    patrolType: z.ZodEnum<{
+        custom: "custom";
+        health: "health";
+        sweep: "sweep";
+        refinery: "refinery";
+        watcher: "watcher";
+    }>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Result of payload validation. */
+export interface PayloadValidationResult {
+    /** Whether the payload passed validation. */
+    valid: boolean;
+    /** Validation errors (empty when valid). */
+    errors: string[];
+}
+/**
+ * Validate a hook payload against its event-specific Zod schema.
+ *
+ * Falls back to the base {@link HookPayloadSchema} for events without
+ * a dedicated schema. Returns a result object rather than throwing,
+ * so callers can decide how to handle validation failures.
+ *
+ * @param event - The hook event name
+ * @param payload - The payload to validate
+ * @returns Validation result with any error messages
+ */
+export declare function validatePayload(event: HookEvent, payload: unknown): PayloadValidationResult;
+//# sourceMappingURL=payload-schemas.d.ts.map

package/dist/hooks/payload-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-schemas.d.ts","sourceRoot":"","sources":["../../src/hooks/payload-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAMH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;iBAKtC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;iBAIpC,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;;;;;;iBAInC,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBAItC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAIpC,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAO/B,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAKtC,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;iBAO1C,CAAC;AAMH,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;iBAKvC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAKpC,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;iBAMvC,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAKtC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;iBAIhC,CAAC;AAgCH,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAW3F"}

package/dist/hooks/provider-hooks.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Provider Hook Capabilities - Phase 2C of T5237
+ *
+ * Helper functions for querying which providers support which hook events.
+ * Wraps CAAMP's provider discovery functions with CLEO-specific helpers.
+ *
+ * @module @cleocode/cleo/hooks/provider-hooks
+ */
+import { type HookEvent as CAAMPHookEvent, getCommonHookEvents, getProvidersByHookEvent } from '@cleocode/caamp';
+import { type HookEvent } from './types.js';
+/**
+ * Get all providers that support a specific hook event
+ *
+ * @param event - The hook event to query
+ * @returns Array of provider IDs that support this event
+ */
+export declare function getHookCapableProviders(event: HookEvent): string[];
+/**
+ * Get hook events supported by all specified providers
+ *
+ * @param providerIds - Optional array of provider IDs (uses all active providers if omitted)
+ * @returns Array of hook events supported by all specified providers
+ */
+export declare function getSharedHookEvents(providerIds?: string[]): CAAMPHookEvent[];
+export type { CAAMPHookEvent as ProviderHookEvent, HookEvent };
+export { getCommonHookEvents, getProvidersByHookEvent };
+//# sourceMappingURL=provider-hooks.d.ts.map

package/dist/hooks/provider-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/provider-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,SAAS,IAAI,cAAc,EAChC,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAE5E;AAED,YAAY,EAAE,cAAc,IAAI,iBAAiB,EAAE,SAAS,EAAE,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/hooks/registry.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Hook Registry System - Phase 2C of T5237
+ *
+ * Central registry for managing hook handlers with priority-based execution,
+ * async dispatch, and best-effort error handling. Integrates with CAAMP 1.6.0
+ * event definitions while providing CLEO's execution engine.
+ *
+ * @module @cleocode/cleo/hooks/registry
+ */
+import type { HookConfig, HookEvent, HookPayload, HookRegistration } from './types.js';
+/**
+ * Central registry for hook handlers.
+ *
+ * Manages registration, priority-based ordering, and async dispatch
+ * of hook handlers. Provides best-effort execution where errors in
+ * one handler do not block others.
+ */
+export declare class HookRegistry {
+    private handlers;
+    private config;
+    /**
+     * Register a hook handler for a specific event.
+     *
+     * Handlers are sorted by priority (highest first) and executed
+     * in parallel when the event is dispatched.
+     *
+     * @param registration - The hook registration containing event, handler, priority, and ID
+     * @returns A function to unregister the handler
+     *
+     * @example
+     * ```typescript
+     * const unregister = hooks.register({
+     *   id: 'my-handler',
+     *   event: 'onSessionStart',
+     *   handler: async (root, payload) => { console.log('Session started'); },
+     *   priority: 100
+     * });
+     *
+     * // Later: unregister()
+     * ```
+     */
+    register<T extends HookPayload>(registration: HookRegistration<T>): () => void;
+    /**
+     * Dispatch an event to all registered handlers.
+     *
+     * Executes handlers in parallel using Promise.allSettled for best-effort
+     * execution. Errors in individual handlers are logged but do not block
+     * other handlers or propagate to the caller.
+     *
+     * @param event - The CAAMP hook event to dispatch
+     * @param projectRoot - The project root directory path
+     * @param payload - The event payload (typed by event)
+     * @returns Promise that resolves when all handlers have completed
+     *
+     * @example
+     * ```typescript
+     * await hooks.dispatch('onSessionStart', '/project', {
+     *   timestamp: new Date().toISOString(),
+     *   sessionId: 'sess-123',
+     *   name: 'My Session',
+     *   scope: 'feature'
+     * });
+     * ```
+     */
+    dispatch<T extends HookPayload>(event: HookEvent, projectRoot: string, payload: T): Promise<void>;
+    /**
+     * Check if a specific event is currently enabled.
+     *
+     * Both the global enabled flag and the per-event flag must be true.
+     *
+     * @param event - The CAAMP hook event to check
+     * @returns True if the event is enabled
+     */
+    isEnabled(event: HookEvent): boolean;
+    /**
+     * Update the hook system configuration.
+     *
+     * Merges the provided config with the existing config.
+     *
+     * @param config - Partial configuration to apply
+     *
+     * @example
+     * ```typescript
+     * hooks.setConfig({ enabled: false }); // Disable all hooks
+     * hooks.setConfig({ events: { onError: false } }); // Disable specific event
+     * ```
+     */
+    setConfig(config: Partial<HookConfig>): void;
+    /**
+     * Get the current hook configuration.
+     *
+     * @returns A copy of the current configuration
+     */
+    getConfig(): HookConfig;
+    /**
+     * List all registered handlers for a specific event.
+     *
+     * Returns handlers in priority order (highest first).
+     *
+     * @param event - The CAAMP hook event
+     * @returns Array of hook registrations
+     */
+    listHandlers(event: HookEvent): HookRegistration[];
+}
+/**
+ * Singleton instance of the HookRegistry.
+ *
+ * Use this instance for all hook operations throughout the application.
+ */
+export declare const hooks: HookRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/hooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyBvF;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,MAAM,CAAmC;IAEjD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,CAAC,SAAS,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAiB9E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,QAAQ,CAAC,CAAC,SAAS,WAAW,EAClC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIpC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAI5C;;;;OAIG;IACH,SAAS,IAAI,UAAU;IAIvB;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,EAAE;CAGnD;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,cAAqB,CAAC"}