anantham-v2 2.0.0-alpha.1

package/dist/domain/hook.d.ts

@@ -0,0 +1,504 @@
+/**
+ * Anantham V2 — Hook Domain Contracts
+ *
+ * Defines authoritative domain models, types, and runtime Zod schemas for
+ * Hook manifests, lifecycle triggers, action definitions, error policies,
+ * records, and execution outcomes.
+ */
+import { z } from "zod";
+export declare const HookTriggerTypeSchema: z.ZodEnum<["SessionStart", "SessionResume", "SessionEnd", "PromptSubmit", "BeforeModel", "AfterModel", "ModelError", "BeforeTool", "AfterTool", "ToolError", "BeforeEdit", "AfterEdit", "BeforeCommand", "AfterCommand", "BeforeMCP", "AfterMCP", "BeforeAgent", "AfterAgent", "BeforeSubagent", "AfterSubagent", "BeforeCompaction", "AfterCompaction", "BeforeVerification", "AfterVerification", "BeforeCommit", "BeforePush", "BeforeDeploy"]>;
+export type HookTriggerType = z.infer<typeof HookTriggerTypeSchema>;
+export declare const HookActionTypeSchema: z.ZodEnum<["allow", "deny", "modify", "add_context", "create_artifact", "command", "notify", "tool"]>;
+export type HookActionType = z.infer<typeof HookActionTypeSchema>;
+export declare const HookErrorPolicySchema: z.ZodEnum<["fail-open", "fail-closed", "warn"]>;
+export type HookErrorPolicy = z.infer<typeof HookErrorPolicySchema>;
+export declare const HookScopeSchema: z.ZodEnum<["global", "project"]>;
+export type HookScope = z.infer<typeof HookScopeSchema>;
+export declare const HookLifecycleStateSchema: z.ZodEnum<["registered", "enabled", "disabled"]>;
+export type HookLifecycleState = z.infer<typeof HookLifecycleStateSchema>;
+export declare const HookActionSchema: z.ZodObject<{
+    type: z.ZodEnum<["allow", "deny", "modify", "add_context", "create_artifact", "command", "notify", "tool"]>;
+    command: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    message: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+    artifact: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        title: string;
+    }, {
+        content: string;
+        title: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+    parameters: Record<string, unknown>;
+    message?: string | undefined;
+    artifact?: {
+        content: string;
+        title: string;
+    } | undefined;
+    tool?: string | undefined;
+    command?: string | undefined;
+    context?: string | undefined;
+}, {
+    type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+    message?: string | undefined;
+    artifact?: {
+        content: string;
+        title: string;
+    } | undefined;
+    tool?: string | undefined;
+    parameters?: Record<string, unknown> | undefined;
+    command?: string | undefined;
+    context?: string | undefined;
+}>;
+export type HookAction = z.infer<typeof HookActionSchema>;
+export declare const HookPolicySchema: z.ZodObject<{
+    onFailure: z.ZodDefault<z.ZodEnum<["fail-open", "fail-closed", "warn"]>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeoutMs: number;
+    onFailure: "fail-open" | "fail-closed" | "warn";
+    maxRetries: number;
+}, {
+    timeoutMs?: number | undefined;
+    onFailure?: "fail-open" | "fail-closed" | "warn" | undefined;
+    maxRetries?: number | undefined;
+}>;
+export type HookPolicy = z.infer<typeof HookPolicySchema>;
+export declare const HookFilterSchema: z.ZodObject<{
+    toolName: z.ZodOptional<z.ZodString>;
+    pathPattern: z.ZodOptional<z.ZodString>;
+    modelProvider: z.ZodOptional<z.ZodString>;
+    matchPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    toolName?: string | undefined;
+    pathPattern?: string | undefined;
+    modelProvider?: string | undefined;
+    matchPayload?: Record<string, unknown> | undefined;
+}, {
+    toolName?: string | undefined;
+    pathPattern?: string | undefined;
+    modelProvider?: string | undefined;
+    matchPayload?: Record<string, unknown> | undefined;
+}>;
+export type HookFilter = z.infer<typeof HookFilterSchema>;
+export declare const HookManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    event: z.ZodEnum<["SessionStart", "SessionResume", "SessionEnd", "PromptSubmit", "BeforeModel", "AfterModel", "ModelError", "BeforeTool", "AfterTool", "ToolError", "BeforeEdit", "AfterEdit", "BeforeCommand", "AfterCommand", "BeforeMCP", "AfterMCP", "BeforeAgent", "AfterAgent", "BeforeSubagent", "AfterSubagent", "BeforeCompaction", "AfterCompaction", "BeforeVerification", "AfterVerification", "BeforeCommit", "BeforePush", "BeforeDeploy"]>;
+    action: z.ZodObject<{
+        type: z.ZodEnum<["allow", "deny", "modify", "add_context", "create_artifact", "command", "notify", "tool"]>;
+        command: z.ZodOptional<z.ZodString>;
+        tool: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        message: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+        artifact: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            title: string;
+        }, {
+            content: string;
+            title: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+        parameters: Record<string, unknown>;
+        message?: string | undefined;
+        artifact?: {
+            content: string;
+            title: string;
+        } | undefined;
+        tool?: string | undefined;
+        command?: string | undefined;
+        context?: string | undefined;
+    }, {
+        type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+        message?: string | undefined;
+        artifact?: {
+            content: string;
+            title: string;
+        } | undefined;
+        tool?: string | undefined;
+        parameters?: Record<string, unknown> | undefined;
+        command?: string | undefined;
+        context?: string | undefined;
+    }>;
+    policy: z.ZodDefault<z.ZodObject<{
+        onFailure: z.ZodDefault<z.ZodEnum<["fail-open", "fail-closed", "warn"]>>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        timeoutMs: number;
+        onFailure: "fail-open" | "fail-closed" | "warn";
+        maxRetries: number;
+    }, {
+        timeoutMs?: number | undefined;
+        onFailure?: "fail-open" | "fail-closed" | "warn" | undefined;
+        maxRetries?: number | undefined;
+    }>>;
+    filter: z.ZodOptional<z.ZodObject<{
+        toolName: z.ZodOptional<z.ZodString>;
+        pathPattern: z.ZodOptional<z.ZodString>;
+        modelProvider: z.ZodOptional<z.ZodString>;
+        matchPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        toolName?: string | undefined;
+        pathPattern?: string | undefined;
+        modelProvider?: string | undefined;
+        matchPayload?: Record<string, unknown> | undefined;
+    }, {
+        toolName?: string | undefined;
+        pathPattern?: string | undefined;
+        modelProvider?: string | undefined;
+        matchPayload?: Record<string, unknown> | undefined;
+    }>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    scope: z.ZodDefault<z.ZodEnum<["global", "project"]>>;
+    projectId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: string;
+    id: string;
+    scope: "project" | "global";
+    priority: number;
+    action: {
+        type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+        parameters: Record<string, unknown>;
+        message?: string | undefined;
+        artifact?: {
+            content: string;
+            title: string;
+        } | undefined;
+        tool?: string | undefined;
+        command?: string | undefined;
+        context?: string | undefined;
+    };
+    enabled: boolean;
+    event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+    policy: {
+        timeoutMs: number;
+        onFailure: "fail-open" | "fail-closed" | "warn";
+        maxRetries: number;
+    };
+    filter?: {
+        toolName?: string | undefined;
+        pathPattern?: string | undefined;
+        modelProvider?: string | undefined;
+        matchPayload?: Record<string, unknown> | undefined;
+    } | undefined;
+    projectId?: string | undefined;
+    description?: string | undefined;
+}, {
+    name: string;
+    version: string;
+    id: string;
+    action: {
+        type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+        message?: string | undefined;
+        artifact?: {
+            content: string;
+            title: string;
+        } | undefined;
+        tool?: string | undefined;
+        parameters?: Record<string, unknown> | undefined;
+        command?: string | undefined;
+        context?: string | undefined;
+    };
+    event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+    filter?: {
+        toolName?: string | undefined;
+        pathPattern?: string | undefined;
+        modelProvider?: string | undefined;
+        matchPayload?: Record<string, unknown> | undefined;
+    } | undefined;
+    projectId?: string | undefined;
+    scope?: "project" | "global" | undefined;
+    priority?: number | undefined;
+    description?: string | undefined;
+    enabled?: boolean | undefined;
+    policy?: {
+        timeoutMs?: number | undefined;
+        onFailure?: "fail-open" | "fail-closed" | "warn" | undefined;
+        maxRetries?: number | undefined;
+    } | undefined;
+}>;
+export type HookManifest = z.infer<typeof HookManifestSchema>;
+export declare const HookRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    manifest: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        event: z.ZodEnum<["SessionStart", "SessionResume", "SessionEnd", "PromptSubmit", "BeforeModel", "AfterModel", "ModelError", "BeforeTool", "AfterTool", "ToolError", "BeforeEdit", "AfterEdit", "BeforeCommand", "AfterCommand", "BeforeMCP", "AfterMCP", "BeforeAgent", "AfterAgent", "BeforeSubagent", "AfterSubagent", "BeforeCompaction", "AfterCompaction", "BeforeVerification", "AfterVerification", "BeforeCommit", "BeforePush", "BeforeDeploy"]>;
+        action: z.ZodObject<{
+            type: z.ZodEnum<["allow", "deny", "modify", "add_context", "create_artifact", "command", "notify", "tool"]>;
+            command: z.ZodOptional<z.ZodString>;
+            tool: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            message: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+            artifact: z.ZodOptional<z.ZodObject<{
+                title: z.ZodString;
+                content: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                content: string;
+                title: string;
+            }, {
+                content: string;
+                title: string;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+            parameters: Record<string, unknown>;
+            message?: string | undefined;
+            artifact?: {
+                content: string;
+                title: string;
+            } | undefined;
+            tool?: string | undefined;
+            command?: string | undefined;
+            context?: string | undefined;
+        }, {
+            type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+            message?: string | undefined;
+            artifact?: {
+                content: string;
+                title: string;
+            } | undefined;
+            tool?: string | undefined;
+            parameters?: Record<string, unknown> | undefined;
+            command?: string | undefined;
+            context?: string | undefined;
+        }>;
+        policy: z.ZodDefault<z.ZodObject<{
+            onFailure: z.ZodDefault<z.ZodEnum<["fail-open", "fail-closed", "warn"]>>;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+            maxRetries: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            timeoutMs: number;
+            onFailure: "fail-open" | "fail-closed" | "warn";
+            maxRetries: number;
+        }, {
+            timeoutMs?: number | undefined;
+            onFailure?: "fail-open" | "fail-closed" | "warn" | undefined;
+            maxRetries?: number | undefined;
+        }>>;
+        filter: z.ZodOptional<z.ZodObject<{
+            toolName: z.ZodOptional<z.ZodString>;
+            pathPattern: z.ZodOptional<z.ZodString>;
+            modelProvider: z.ZodOptional<z.ZodString>;
+            matchPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            toolName?: string | undefined;
+            pathPattern?: string | undefined;
+            modelProvider?: string | undefined;
+            matchPayload?: Record<string, unknown> | undefined;
+        }, {
+            toolName?: string | undefined;
+            pathPattern?: string | undefined;
+            modelProvider?: string | undefined;
+            matchPayload?: Record<string, unknown> | undefined;
+        }>>;
+        priority: z.ZodDefault<z.ZodNumber>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        scope: z.ZodDefault<z.ZodEnum<["global", "project"]>>;
+        projectId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        id: string;
+        scope: "project" | "global";
+        priority: number;
+        action: {
+            type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+            parameters: Record<string, unknown>;
+            message?: string | undefined;
+            artifact?: {
+                content: string;
+                title: string;
+            } | undefined;
+            tool?: string | undefined;
+            command?: string | undefined;
+            context?: string | undefined;
+        };
+        enabled: boolean;
+        event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+        policy: {
+            timeoutMs: number;
+            onFailure: "fail-open" | "fail-closed" | "warn";
+            maxRetries: number;
+        };
+        filter?: {
+            toolName?: string | undefined;
+            pathPattern?: string | undefined;
+            modelProvider?: string | undefined;
+            matchPayload?: Record<string, unknown> | undefined;
+        } | undefined;
+        projectId?: string | undefined;
+        description?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        id: string;
+        action: {
+            type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+            message?: string | undefined;
+            artifact?: {
+                content: string;
+                title: string;
+            } | undefined;
+            tool?: string | undefined;
+            parameters?: Record<string, unknown> | undefined;
+            command?: string | undefined;
+            context?: string | undefined;
+        };
+        event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+        filter?: {
+            toolName?: string | undefined;
+            pathPattern?: string | undefined;
+            modelProvider?: string | undefined;
+            matchPayload?: Record<string, unknown> | undefined;
+        } | undefined;
+        projectId?: string | undefined;
+        scope?: "project" | "global" | undefined;
+        priority?: number | undefined;
+        description?: string | undefined;
+        enabled?: boolean | undefined;
+        policy?: {
+            timeoutMs?: number | undefined;
+            onFailure?: "fail-open" | "fail-closed" | "warn" | undefined;
+            maxRetries?: number | undefined;
+        } | undefined;
+    }>;
+    lifecycleState: z.ZodDefault<z.ZodEnum<["registered", "enabled", "disabled"]>>;
+    source: z.ZodDefault<z.ZodEnum<["system", "project", "plugin"]>>;
+    registeredAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    source: "system" | "project" | "plugin";
+    manifest: {
+        name: string;
+        version: string;
+        id: string;
+        scope: "project" | "global";
+        priority: number;
+        action: {
+            type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+            parameters: Record<string, unknown>;
+            message?: string | undefined;
+            artifact?: {
+                content: string;
+                title: string;
+            } | undefined;
+            tool?: string | undefined;
+            command?: string | undefined;
+            context?: string | undefined;
+        };
+        enabled: boolean;
+        event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+        policy: {
+            timeoutMs: number;
+            onFailure: "fail-open" | "fail-closed" | "warn";
+            maxRetries: number;
+        };
+        filter?: {
+            toolName?: string | undefined;
+            pathPattern?: string | undefined;
+            modelProvider?: string | undefined;
+            matchPayload?: Record<string, unknown> | undefined;
+        } | undefined;
+        projectId?: string | undefined;
+        description?: string | undefined;
+    };
+    lifecycleState: "disabled" | "enabled" | "registered";
+    registeredAt: string;
+}, {
+    id: string;
+    manifest: {
+        name: string;
+        version: string;
+        id: string;
+        action: {
+            type: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+            message?: string | undefined;
+            artifact?: {
+                content: string;
+                title: string;
+            } | undefined;
+            tool?: string | undefined;
+            parameters?: Record<string, unknown> | undefined;
+            command?: string | undefined;
+            context?: string | undefined;
+        };
+        event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+        filter?: {
+            toolName?: string | undefined;
+            pathPattern?: string | undefined;
+            modelProvider?: string | undefined;
+            matchPayload?: Record<string, unknown> | undefined;
+        } | undefined;
+        projectId?: string | undefined;
+        scope?: "project" | "global" | undefined;
+        priority?: number | undefined;
+        description?: string | undefined;
+        enabled?: boolean | undefined;
+        policy?: {
+            timeoutMs?: number | undefined;
+            onFailure?: "fail-open" | "fail-closed" | "warn" | undefined;
+            maxRetries?: number | undefined;
+        } | undefined;
+    };
+    registeredAt: string;
+    source?: "system" | "project" | "plugin" | undefined;
+    lifecycleState?: "disabled" | "enabled" | "registered" | undefined;
+}>;
+export type HookRecord = z.infer<typeof HookRecordSchema>;
+export declare const HookExecutionResultSchema: z.ZodObject<{
+    hookId: z.ZodString;
+    event: z.ZodEnum<["SessionStart", "SessionResume", "SessionEnd", "PromptSubmit", "BeforeModel", "AfterModel", "ModelError", "BeforeTool", "AfterTool", "ToolError", "BeforeEdit", "AfterEdit", "BeforeCommand", "AfterCommand", "BeforeMCP", "AfterMCP", "BeforeAgent", "AfterAgent", "BeforeSubagent", "AfterSubagent", "BeforeCompaction", "AfterCompaction", "BeforeVerification", "AfterVerification", "BeforeCommit", "BeforePush", "BeforeDeploy"]>;
+    actionType: z.ZodEnum<["allow", "deny", "modify", "add_context", "create_artifact", "command", "notify", "tool"]>;
+    success: z.ZodBoolean;
+    decision: z.ZodEnum<["allow", "deny", "modify", "executed", "skipped"]>;
+    durationMs: z.ZodNumber;
+    output: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+    isFailClosedBlocked: z.ZodDefault<z.ZodBoolean>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    success: boolean;
+    durationMs: number;
+    decision: "allow" | "deny" | "modify" | "executed" | "skipped";
+    event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+    hookId: string;
+    actionType: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+    isFailClosedBlocked: boolean;
+    error?: string | undefined;
+    output?: unknown;
+}, {
+    timestamp: string;
+    success: boolean;
+    durationMs: number;
+    decision: "allow" | "deny" | "modify" | "executed" | "skipped";
+    event: "SessionStart" | "SessionResume" | "SessionEnd" | "PromptSubmit" | "BeforeModel" | "AfterModel" | "ModelError" | "BeforeTool" | "AfterTool" | "ToolError" | "BeforeEdit" | "AfterEdit" | "BeforeCommand" | "AfterCommand" | "BeforeMCP" | "AfterMCP" | "BeforeAgent" | "AfterAgent" | "BeforeSubagent" | "AfterSubagent" | "BeforeCompaction" | "AfterCompaction" | "BeforeVerification" | "AfterVerification" | "BeforeCommit" | "BeforePush" | "BeforeDeploy";
+    hookId: string;
+    actionType: "tool" | "allow" | "deny" | "command" | "modify" | "add_context" | "create_artifact" | "notify";
+    error?: string | undefined;
+    output?: unknown;
+    isFailClosedBlocked?: boolean | undefined;
+}>;
+export type HookExecutionResult = z.infer<typeof HookExecutionResultSchema>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/domain/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/domain/hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB,obA4BhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB,uGAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB,iDAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,kCAAgC,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,wBAAwB,kDAInC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/domain/hook.js

@@ -0,0 +1,123 @@
+/**
+ * Anantham V2 — Hook Domain Contracts
+ *
+ * Defines authoritative domain models, types, and runtime Zod schemas for
+ * Hook manifests, lifecycle triggers, action definitions, error policies,
+ * records, and execution outcomes.
+ */
+import { z } from "zod";
+export const HookTriggerTypeSchema = z.enum([
+    "SessionStart",
+    "SessionResume",
+    "SessionEnd",
+    "PromptSubmit",
+    "BeforeModel",
+    "AfterModel",
+    "ModelError",
+    "BeforeTool",
+    "AfterTool",
+    "ToolError",
+    "BeforeEdit",
+    "AfterEdit",
+    "BeforeCommand",
+    "AfterCommand",
+    "BeforeMCP",
+    "AfterMCP",
+    "BeforeAgent",
+    "AfterAgent",
+    "BeforeSubagent",
+    "AfterSubagent",
+    "BeforeCompaction",
+    "AfterCompaction",
+    "BeforeVerification",
+    "AfterVerification",
+    "BeforeCommit",
+    "BeforePush",
+    "BeforeDeploy",
+]);
+export const HookActionTypeSchema = z.enum([
+    "allow",
+    "deny",
+    "modify",
+    "add_context",
+    "create_artifact",
+    "command",
+    "notify",
+    "tool",
+]);
+export const HookErrorPolicySchema = z.enum([
+    "fail-open",
+    "fail-closed",
+    "warn",
+]);
+export const HookScopeSchema = z.enum(["global", "project"]);
+export const HookLifecycleStateSchema = z.enum([
+    "registered",
+    "enabled",
+    "disabled",
+]);
+export const HookActionSchema = z.object({
+    type: HookActionTypeSchema,
+    command: z.string().optional(),
+    tool: z.string().optional(),
+    parameters: z.record(z.string(), z.unknown()).optional().default({}),
+    message: z.string().optional(),
+    context: z.string().optional(),
+    artifact: z
+        .object({
+        title: z.string(),
+        content: z.string(),
+    })
+        .optional(),
+});
+export const HookPolicySchema = z.object({
+    onFailure: HookErrorPolicySchema.default("warn"),
+    timeoutMs: z.number().int().positive().default(5000),
+    maxRetries: z.number().int().nonnegative().default(0),
+});
+export const HookFilterSchema = z.object({
+    toolName: z.string().optional(),
+    pathPattern: z.string().optional(),
+    modelProvider: z.string().optional(),
+    matchPayload: z.record(z.string(), z.unknown()).optional(),
+});
+export const HookManifestSchema = z.object({
+    id: z
+        .string()
+        .min(1)
+        .regex(/^[a-zA-Z0-9_\-\.]+$/, "Hook ID must be alphanumeric with dashes, dots, or underscores"),
+    name: z.string().min(1),
+    version: z
+        .string()
+        .min(1)
+        .regex(/^\d+\.\d+\.\d+(-[a-zA-Z0-9\.]+)?$/, "Version must follow SemVer"),
+    description: z.string().optional(),
+    event: HookTriggerTypeSchema,
+    action: HookActionSchema,
+    policy: HookPolicySchema.default({ onFailure: "warn", timeoutMs: 5000, maxRetries: 0 }),
+    filter: HookFilterSchema.optional(),
+    priority: z.number().int().default(100),
+    enabled: z.boolean().default(true),
+    scope: HookScopeSchema.default("global"),
+    projectId: z.string().optional(),
+});
+export const HookRecordSchema = z.object({
+    id: z.string().min(1),
+    manifest: HookManifestSchema,
+    lifecycleState: HookLifecycleStateSchema.default("registered"),
+    source: z.enum(["system", "project", "plugin"]).default("project"),
+    registeredAt: z.string().datetime(),
+});
+export const HookExecutionResultSchema = z.object({
+    hookId: z.string().min(1),
+    event: HookTriggerTypeSchema,
+    actionType: HookActionTypeSchema,
+    success: z.boolean(),
+    decision: z.enum(["allow", "deny", "modify", "executed", "skipped"]),
+    durationMs: z.number().nonnegative(),
+    output: z.unknown().optional(),
+    error: z.string().optional(),
+    isFailClosedBlocked: z.boolean().default(false),
+    timestamp: z.string().datetime(),
+});
+//# sourceMappingURL=hook.js.map

package/dist/domain/hook.js.map

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