anantham-v2 2.0.0-alpha.1

package/dist/execution/workspace-manager.js

@@ -0,0 +1,180 @@
+import { randomUUID } from "node:crypto";
+import { ExecutionWorkspaceSchema, } from "../domain/workspace.js";
+import { EventTypes } from "../domain/event.js";
+import { GitWorktreeManager } from "./git-worktree-manager.js";
+/**
+ * Workspace Manager coordinating execution workspace allocation,
+ * task lease binding, base revision capture, and concurrency bounds.
+ * PRD Part 2 Section 52.
+ */
+export class WorkspaceManager {
+    workspaceRepo;
+    leaseRepo;
+    claimManager;
+    worktreeManager;
+    eventStore;
+    maxActiveWorktreesPerProject;
+    constructor(options) {
+        this.workspaceRepo = options.workspaceRepo;
+        this.leaseRepo = options.leaseRepo;
+        this.claimManager = options.claimManager;
+        this.worktreeManager = options.worktreeManager ?? new GitWorktreeManager();
+        this.eventStore = options.eventStore;
+        this.maxActiveWorktreesPerProject = options.maxActiveWorktreesPerProject ?? 8;
+    }
+    /**
+     * Allocate an isolated execution workspace for a claimed task.
+     */
+    async allocateWorkspace(request) {
+        const now = new Date().toISOString();
+        // 1. Task Ownership & Lease Validation
+        if (this.claimManager) {
+            const isValid = this.claimManager.verifyOwnership(request.taskId, request.leaseId, request.generation, request.agentId);
+            if (!isValid) {
+                return {
+                    success: false,
+                    errorCode: "FENCING_OR_OWNERSHIP_INVALID",
+                    errorMessage: `Task "${request.taskId}" ownership verification failed for agent "${request.agentId}" (lease: "${request.leaseId}", gen: ${request.generation}).`,
+                };
+            }
+        }
+        else if (this.leaseRepo) {
+            const activeLease = this.leaseRepo.findActiveByTaskId(request.taskId);
+            if (!activeLease ||
+                activeLease.id !== request.leaseId ||
+                activeLease.generation !== request.generation ||
+                activeLease.agentId !== request.agentId) {
+                return {
+                    success: false,
+                    errorCode: "FENCING_OR_OWNERSHIP_INVALID",
+                    errorMessage: `Active lease not found or generation mismatch for task "${request.taskId}".`,
+                };
+            }
+        }
+        // 2. Concurrency Limit Check per Project
+        const activeWorkspaces = this.workspaceRepo.findActiveByProjectId(request.projectId);
+        if (activeWorkspaces.length >= this.maxActiveWorktreesPerProject) {
+            return {
+                success: false,
+                errorCode: "PROJECT_CONCURRENCY_LIMIT_EXCEEDED",
+                errorMessage: `Project "${request.projectId}" reached maximum active worktree capacity (${this.maxActiveWorktreesPerProject}).`,
+            };
+        }
+        // 3. Inspect Base Repository State & Capture Base Commit
+        const repoPath = request.repoPath || process.cwd();
+        let baseCommit;
+        let baseBranch;
+        try {
+            const status = await this.worktreeManager.inspectWorkingTree(repoPath);
+            baseCommit = status.headCommit;
+            baseBranch = request.baseBranch || status.branch;
+        }
+        catch (err) {
+            return {
+                success: false,
+                errorCode: "REPO_INSPECTION_FAILED",
+                errorMessage: `Failed to inspect base repository at "${repoPath}": ${err.message}`,
+            };
+        }
+        // 4. Create Worktree on isolated branch
+        const workspaceId = `ws_${randomUUID().slice(0, 12)}`;
+        const branchName = `anantham/${workspaceId}`;
+        let worktreePath;
+        try {
+            const worktreeRes = await this.worktreeManager.createWorktree(workspaceId, branchName, baseCommit, repoPath);
+            worktreePath = worktreeRes.worktreePath;
+        }
+        catch (err) {
+            return {
+                success: false,
+                errorCode: "WORKTREE_ALLOCATION_FAILED",
+                errorMessage: `Failed to create Git worktree: ${err.message}`,
+            };
+        }
+        // 5. Persist Workspace Entity
+        const workspace = ExecutionWorkspaceSchema.parse({
+            id: workspaceId,
+            projectId: request.projectId,
+            taskId: request.taskId,
+            agentId: request.agentId,
+            instanceId: request.instanceId,
+            leaseId: request.leaseId,
+            generation: request.generation,
+            baseCommit,
+            baseBranch,
+            worktreePath,
+            branchName,
+            status: "READY",
+            cleanupState: "NONE",
+            metadata: request.metadata,
+            createdAt: now,
+            lastVerifiedAt: now,
+        });
+        this.workspaceRepo.save(workspace);
+        // 6. Emit Audit Event
+        if (this.eventStore) {
+            this.eventStore.append({
+                id: randomUUID(),
+                schemaVersion: 1,
+                actor: "system",
+                timestamp: now,
+                type: EventTypes.WORKSPACE_CREATED,
+                projectId: request.projectId,
+                taskId: request.taskId,
+                agentId: request.agentId,
+                payload: {
+                    workspaceId,
+                    leaseId: request.leaseId,
+                    generation: request.generation,
+                    baseCommit,
+                    worktreePath,
+                    branchName,
+                },
+            });
+        }
+        return {
+            success: true,
+            workspace,
+        };
+    }
+    /**
+     * Get workspace by ID.
+     */
+    getWorkspace(workspaceId) {
+        return this.workspaceRepo.findById(workspaceId);
+    }
+    /**
+     * Update workspace status.
+     */
+    updateStatus(workspaceId, status, quarantineReason) {
+        this.workspaceRepo.updateStatus(workspaceId, status, quarantineReason);
+    }
+    /**
+     * Release and safely clean up workspace.
+     */
+    async cleanupWorkspace(workspaceId, repoPath = process.cwd(), force = false) {
+        const ws = this.workspaceRepo.findById(workspaceId);
+        if (!ws)
+            return false;
+        const removed = await this.worktreeManager.removeWorktree(ws.worktreePath, repoPath, force);
+        if (removed) {
+            this.workspaceRepo.updateStatus(workspaceId, "CLEANED");
+            this.workspaceRepo.updateCleanupState(workspaceId, "CLEANED");
+            if (this.eventStore) {
+                this.eventStore.append({
+                    id: randomUUID(),
+                    schemaVersion: 1,
+                    actor: "system",
+                    timestamp: new Date().toISOString(),
+                    type: EventTypes.WORKSPACE_CLEANED,
+                    projectId: ws.projectId,
+                    taskId: ws.taskId,
+                    agentId: ws.agentId,
+                    payload: { workspaceId },
+                });
+            }
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=workspace-manager.js.map

package/dist/execution/workspace-manager.js.map

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

package/dist/execution/workspace-recovery-engine.d.ts

@@ -0,0 +1,39 @@
+import { EventStore } from "../event-state/event-store.js";
+import { WorkspaceRepository } from "../persistence/repositories/workspace-repository.js";
+import { LeaseRepository } from "../persistence/repositories/lease-repository.js";
+import { GitWorktreeManager } from "./git-worktree-manager.js";
+export interface WorkspaceRecoverySummary {
+    inspectedCount: number;
+    activeCount: number;
+    quarantinedCount: number;
+    cleanedCount: number;
+    quarantinedWorkspaces: string[];
+}
+export interface WorkspaceRecoveryEngineOptions {
+    workspaceRepo: WorkspaceRepository;
+    leaseRepo?: LeaseRepository;
+    worktreeManager?: GitWorktreeManager;
+    eventStore?: EventStore;
+}
+/**
+ * Workspace Recovery Engine.
+ * Scans for abandoned/stale workspaces after process crashes, reconciles task leases,
+ * preserves dirty worktrees into quarantine patch artifacts, and cleans up empty worktrees.
+ * PRD Part 1 Section 56, PRD Part 2 Section 56.
+ */
+export declare class WorkspaceRecoveryEngine {
+    private readonly workspaceRepo;
+    private readonly leaseRepo?;
+    private readonly worktreeManager;
+    private readonly eventStore?;
+    constructor(options: WorkspaceRecoveryEngineOptions);
+    /**
+     * Scan and recover workspaces for a project.
+     */
+    recoverWorkspaces(projectId: string, repoPath?: string): Promise<WorkspaceRecoverySummary>;
+    /**
+     * Determine if a workspace's lease has expired or its generation token is stale.
+     */
+    private checkIfWorkspaceStale;
+}
+//# sourceMappingURL=workspace-recovery-engine.d.ts.map

package/dist/execution/workspace-recovery-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-recovery-engine.d.ts","sourceRoot":"","sources":["../../src/execution/workspace-recovery-engine.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAI/D,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,mBAAmB,CAAC;IACnC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,EAAE,8BAA8B;IAOnD;;OAEG;IACU,iBAAiB,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;IA4GpC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAY9B"}

package/dist/execution/workspace-recovery-engine.js

@@ -0,0 +1,146 @@
+import { randomUUID } from "node:crypto";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { EventTypes } from "../domain/event.js";
+import { GitWorktreeManager } from "./git-worktree-manager.js";
+const execAsync = promisify(exec);
+/**
+ * Workspace Recovery Engine.
+ * Scans for abandoned/stale workspaces after process crashes, reconciles task leases,
+ * preserves dirty worktrees into quarantine patch artifacts, and cleans up empty worktrees.
+ * PRD Part 1 Section 56, PRD Part 2 Section 56.
+ */
+export class WorkspaceRecoveryEngine {
+    workspaceRepo;
+    leaseRepo;
+    worktreeManager;
+    eventStore;
+    constructor(options) {
+        this.workspaceRepo = options.workspaceRepo;
+        this.leaseRepo = options.leaseRepo;
+        this.worktreeManager = options.worktreeManager ?? new GitWorktreeManager();
+        this.eventStore = options.eventStore;
+    }
+    /**
+     * Scan and recover workspaces for a project.
+     */
+    async recoverWorkspaces(projectId, repoPath = process.cwd()) {
+        const workspaces = this.workspaceRepo.findActiveByProjectId(projectId);
+        let activeCount = 0;
+        let quarantinedCount = 0;
+        let cleanedCount = 0;
+        const quarantinedWorkspaces = [];
+        for (const ws of workspaces) {
+            const isStale = this.checkIfWorkspaceStale(ws);
+            if (!isStale) {
+                activeCount++;
+                continue;
+            }
+            // Handle Stale / Abandoned Workspace
+            try {
+                const treeStatus = await this.worktreeManager.inspectWorkingTree(ws.worktreePath);
+                // Check if there are committed or uncommitted changes against baseCommit
+                let hasChanges = !treeStatus.isClean;
+                let patch = "";
+                try {
+                    const { stdout: patchOut } = await execAsync(`git diff "${ws.baseCommit}"`, {
+                        cwd: ws.worktreePath,
+                    });
+                    patch = patchOut.trim();
+                    if (patch.length > 0)
+                        hasChanges = true;
+                }
+                catch {
+                    // ignore diff error
+                }
+                if (hasChanges) {
+                    // Quarantine: Preserve changes into patch artifact
+                    const quarantineId = `quar_${randomUUID().slice(0, 12)}`;
+                    this.workspaceRepo.saveQuarantineRecord({
+                        id: quarantineId,
+                        workspaceId: ws.id,
+                        reason: `Abandoned workspace with uncommitted work (task: ${ws.taskId}, lease: ${ws.leaseId})`,
+                        patch,
+                        createdAt: new Date().toISOString(),
+                    });
+                    this.workspaceRepo.updateStatus(ws.id, "QUARANTINED", "LEASE_STALE_OR_EXPIRED");
+                    this.workspaceRepo.updateCleanupState(ws.id, "QUARANTINED");
+                    quarantinedCount++;
+                    quarantinedWorkspaces.push(ws.id);
+                    if (this.eventStore) {
+                        this.eventStore.append({
+                            id: randomUUID(),
+                            schemaVersion: 1,
+                            actor: "system",
+                            timestamp: new Date().toISOString(),
+                            type: EventTypes.WORKSPACE_QUARANTINED,
+                            projectId: ws.projectId,
+                            taskId: ws.taskId,
+                            agentId: ws.agentId,
+                            payload: {
+                                workspaceId: ws.id,
+                                quarantineId,
+                                reason: "LEASE_STALE_OR_EXPIRED",
+                                patchLength: patch.length,
+                            },
+                        });
+                    }
+                }
+                else {
+                    // Clean: Safely remove empty worktree
+                    await this.worktreeManager.removeWorktree(ws.worktreePath, repoPath, true);
+                    this.workspaceRepo.updateStatus(ws.id, "CLEANED");
+                    this.workspaceRepo.updateCleanupState(ws.id, "CLEANED");
+                    cleanedCount++;
+                    if (this.eventStore) {
+                        this.eventStore.append({
+                            id: randomUUID(),
+                            schemaVersion: 1,
+                            actor: "system",
+                            timestamp: new Date().toISOString(),
+                            type: EventTypes.WORKSPACE_CLEANED,
+                            projectId: ws.projectId,
+                            taskId: ws.taskId,
+                            agentId: ws.agentId,
+                            payload: {
+                                workspaceId: ws.id,
+                                reason: "STALE_CLEANUP",
+                            },
+                        });
+                    }
+                }
+            }
+            catch {
+                // In case worktree folder was manually deleted
+                this.workspaceRepo.updateStatus(ws.id, "CLEANED");
+                this.workspaceRepo.updateCleanupState(ws.id, "CLEANED");
+                cleanedCount++;
+            }
+        }
+        return {
+            inspectedCount: workspaces.length,
+            activeCount,
+            quarantinedCount,
+            cleanedCount,
+            quarantinedWorkspaces,
+        };
+    }
+    /**
+     * Determine if a workspace's lease has expired or its generation token is stale.
+     */
+    checkIfWorkspaceStale(ws) {
+        if (!this.leaseRepo)
+            return false;
+        const lease = this.leaseRepo.findById(ws.leaseId);
+        if (!lease)
+            return true;
+        if (lease.status !== "ACTIVE")
+            return true;
+        if (lease.generation !== ws.generation)
+            return true;
+        if (Date.now() > new Date(lease.expiresAt).getTime())
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=workspace-recovery-engine.js.map

package/dist/execution/workspace-recovery-engine.js.map

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

package/dist/hooks/hook-executor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Anantham V2 — Hook Executor
+ *
+ * Executes bounded hook actions via ToolGateway, enforcing timeouts, retries,
+ * and error policies (fail-closed, fail-open, warn).
+ */
+import { type HookRecord, type HookExecutionResult, type HookTriggerType } from "../domain/hook.js";
+import { type ToolGateway } from "../tools/tool-gateway.js";
+export interface HookExecutionContext {
+    event: HookTriggerType;
+    projectId?: string;
+    sessionId?: string;
+    taskId?: string;
+    payload?: Record<string, unknown>;
+    depth?: number;
+}
+export declare class HookExecutor {
+    private readonly toolGateway?;
+    constructor(options?: {
+        toolGateway?: ToolGateway;
+    });
+    /**
+     * Executes a single hook action within a bounded timeout and retry context.
+     */
+    execute(hook: HookRecord, context: HookExecutionContext): Promise<HookExecutionResult>;
+    private runAction;
+    private executeWithTimeout;
+}
+//# sourceMappingURL=hook-executor.d.ts.map

package/dist/hooks/hook-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-executor.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE;IAInD;;OAEG;IACU,OAAO,CAClB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC;YAwDjB,SAAS;YA0DT,kBAAkB;CAoBjC"}

package/dist/hooks/hook-executor.js

@@ -0,0 +1,126 @@
+/**
+ * Anantham V2 — Hook Executor
+ *
+ * Executes bounded hook actions via ToolGateway, enforcing timeouts, retries,
+ * and error policies (fail-closed, fail-open, warn).
+ */
+import { HookExecutionResultSchema, } from "../domain/hook.js";
+export class HookExecutor {
+    toolGateway;
+    constructor(options) {
+        this.toolGateway = options?.toolGateway;
+    }
+    /**
+     * Executes a single hook action within a bounded timeout and retry context.
+     */
+    async execute(hook, context) {
+        const startTime = Date.now();
+        const manifest = hook.manifest;
+        const action = manifest.action;
+        const policy = manifest.policy;
+        let attempts = 0;
+        const maxRetries = policy.maxRetries || 0;
+        let lastError;
+        while (attempts <= maxRetries) {
+            attempts++;
+            try {
+                const timeoutMs = policy.timeoutMs || 5000;
+                const resultOutput = await this.executeWithTimeout(async () => this.runAction(action, context), timeoutMs);
+                const durationMs = Date.now() - startTime;
+                return HookExecutionResultSchema.parse({
+                    hookId: hook.id,
+                    event: context.event,
+                    actionType: action.type,
+                    success: true,
+                    decision: action.type === "deny" ? "deny" : action.type === "modify" ? "modify" : "executed",
+                    durationMs,
+                    output: resultOutput,
+                    isFailClosedBlocked: action.type === "deny",
+                    timestamp: new Date().toISOString(),
+                });
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (attempts <= maxRetries) {
+                    // Bounded retry backoff
+                    await new Promise((resolve) => setTimeout(resolve, 20 * attempts));
+                }
+            }
+        }
+        const durationMs = Date.now() - startTime;
+        const isFailClosed = policy.onFailure === "fail-closed";
+        return HookExecutionResultSchema.parse({
+            hookId: hook.id,
+            event: context.event,
+            actionType: action.type,
+            success: false,
+            decision: "skipped",
+            durationMs,
+            error: lastError?.message || "Unknown hook execution error",
+            isFailClosedBlocked: isFailClosed,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    async runAction(action, context) {
+        switch (action.type) {
+            case "allow":
+                return { allowed: true };
+            case "deny":
+                return { allowed: false, reason: action.message || "Denied by hook policy." };
+            case "modify":
+                return { modified: true, payload: { ...context.payload, ...action.parameters } };
+            case "add_context":
+                return { addedContext: action.context || action.message || "" };
+            case "create_artifact":
+                return { artifactCreated: action.artifact };
+            case "notify":
+                return { notified: true, message: action.message };
+            case "command":
+            case "tool": {
+                const toolName = action.tool || (action.type === "command" ? "shell.execute" : "unknown.tool");
+                const toolParams = action.type === "command" ? { command: action.command } : action.parameters;
+                if (this.toolGateway) {
+                    const obs = await this.toolGateway.invoke({
+                        callId: `call_hk_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+                        toolName,
+                        arguments: toolParams || {},
+                        actor: {
+                            id: "system:hook",
+                            type: "system",
+                        },
+                        project: {
+                            id: context.projectId || "global",
+                        },
+                        session: context.sessionId ? { id: context.sessionId } : undefined,
+                        task: context.taskId ? { id: context.taskId } : undefined,
+                    });
+                    if (obs.status !== "success") {
+                        throw new Error(obs.error?.message || `Tool execution status: ${obs.status}`);
+                    }
+                    return obs.result;
+                }
+                // Mock deterministic command execution if ToolGateway is omitted
+                return { executedTool: toolName, parameters: toolParams };
+            }
+            default:
+                return { executed: true };
+        }
+    }
+    async executeWithTimeout(fn, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Hook execution timed out after ${timeoutMs}ms.`));
+            }, timeoutMs);
+            fn()
+                .then((res) => {
+                clearTimeout(timer);
+                resolve(res);
+            })
+                .catch((err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=hook-executor.js.map

package/dist/hooks/hook-executor.js.map

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

package/dist/hooks/hook-manager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Anantham V2 — Hook Manager & Lifecycle Engine
+ *
+ * Coordinates hook registration, trigger evaluation, deterministic execution,
+ * recursion protection, and SQLite WAL EventStore audit emission.
+ */
+import { type HookRecord, type HookManifest, type HookExecutionResult, type HookTriggerType } from "../domain/hook.js";
+import { HookRegistry } from "./hook-registry.js";
+import { HookMatcher } from "./hook-matcher.js";
+import { HookRecursionGuard } from "./hook-recursion-guard.js";
+import { HookExecutor } from "./hook-executor.js";
+import { HookSecurityGuard } from "./hook-security.js";
+import { HookTestRunner, type HookTestFixture, type HookTestReport } from "./hook-test-runner.js";
+import { type EventStore } from "../event-state/event-store.js";
+export interface HookManagerOptions {
+    registry?: HookRegistry;
+    matcher?: HookMatcher;
+    recursionGuard?: HookRecursionGuard;
+    executor?: HookExecutor;
+    securityGuard?: HookSecurityGuard;
+    testRunner?: HookTestRunner;
+    eventStore?: EventStore;
+    projectId?: string;
+}
+export declare class HookManager {
+    private readonly registry;
+    private readonly matcher;
+    private readonly recursionGuard;
+    private readonly executor;
+    private readonly securityGuard;
+    private readonly testRunner;
+    private readonly eventStore?;
+    private readonly projectId;
+    constructor(options?: HookManagerOptions);
+    getRegistry(): HookRegistry;
+    register(manifest: HookManifest, source?: "system" | "project" | "plugin"): HookRecord;
+    unregister(hookId: string): boolean;
+    enable(hookId: string): HookRecord;
+    disable(hookId: string): HookRecord;
+    get(hookId: string): HookRecord | undefined;
+    list(projectId?: string): HookRecord[];
+    /**
+     * Evaluates and executes all matching hooks for a lifecycle trigger event.
+     * Returns whether execution is blocked (due to fail-closed error).
+     */
+    handleEvent(context: {
+        event: HookTriggerType;
+        projectId?: string;
+        sessionId?: string;
+        taskId?: string;
+        payload?: Record<string, unknown>;
+        causationId?: string;
+        depth?: number;
+    }): Promise<{
+        matchedCount: number;
+        results: HookExecutionResult[];
+        isBlocked: boolean;
+    }>;
+    /**
+     * Deterministically tests a hook with a fixture (/hooks test <id>).
+     */
+    test(hookId: string, fixture: HookTestFixture): Promise<HookTestReport>;
+    private emitEvent;
+}
+//# sourceMappingURL=hook-manager.d.ts.map

package/dist/hooks/hook-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-manager.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAA6B,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,GAAE,kBAAuB;IAWrC,WAAW,IAAI,YAAY;IAI3B,QAAQ,CACb,QAAQ,EAAE,YAAY,EACtB,MAAM,GAAE,QAAQ,GAAG,SAAS,GAAG,QAAoB,GAClD,UAAU;IAiBN,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAMlC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAMnC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAI7C;;;OAGG;IACU,WAAW,CAAC,OAAO,EAAE;QAChC,KAAK,EAAE,eAAe,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,mBAAmB,EAAE,CAAC;QAC/B,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAoFF;;OAEG;IACU,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAQpF,OAAO,CAAC,SAAS;CAalB"}