anantham-v2 2.0.0-alpha.1

package/dist/execution/process-supervisor.js

@@ -0,0 +1,113 @@
+import { EventTypes } from "../domain/event.js";
+import { killProcessTree } from "./process-tree-killer.js";
+export class ProcessSupervisor {
+    activeHandles = new Map();
+    eventStore;
+    constructor(options = {}) {
+        this.eventStore = options.eventStore;
+    }
+    register(request) {
+        if (this.activeHandles.has(request.executionId)) {
+            throw new Error(`Execution handle "${request.executionId}" already exists.`);
+        }
+        const abortController = new AbortController();
+        const handle = {
+            executionId: request.executionId,
+            state: "created",
+            request,
+            startTime: Date.now(),
+            abortController,
+        };
+        this.activeHandles.set(request.executionId, handle);
+        return handle;
+    }
+    transition(executionId, nextState, meta) {
+        const handle = this.activeHandles.get(executionId);
+        if (!handle) {
+            throw new Error(`Execution handle "${executionId}" not found for state transition.`);
+        }
+        this.validateTransition(handle.state, nextState);
+        handle.state = nextState;
+        if (this.eventStore && (nextState === "completed" || nextState === "failed" || nextState === "timed_out" || nextState === "cancelled")) {
+            const projectId = handle.request.metadata?.projectId || "system";
+            this.eventStore.append({
+                id: `evt_exec_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+                schemaVersion: 1,
+                projectId,
+                type: nextState === "completed" ? EventTypes.TOOL_COMPLETED : EventTypes.TOOL_FAILED,
+                actor: "system",
+                timestamp: new Date().toISOString(),
+                payload: {
+                    executionId,
+                    state: nextState,
+                    command: handle.request.command,
+                    ...meta,
+                },
+            });
+        }
+    }
+    setPid(executionId, pid) {
+        const handle = this.activeHandles.get(executionId);
+        if (handle) {
+            handle.pid = pid;
+        }
+    }
+    setTimeout(executionId, timeoutId) {
+        const handle = this.activeHandles.get(executionId);
+        if (handle) {
+            handle.timeoutId = timeoutId;
+        }
+    }
+    getHandle(executionId) {
+        return this.activeHandles.get(executionId);
+    }
+    async cancel(executionId, reason = "Execution cancelled by caller") {
+        const handle = this.activeHandles.get(executionId);
+        if (!handle)
+            return false;
+        if (handle.timeoutId) {
+            clearTimeout(handle.timeoutId);
+        }
+        handle.abortController.abort();
+        if (handle.pid) {
+            await killProcessTree(handle.pid);
+        }
+        const currentHandle = this.activeHandles.get(executionId);
+        if (currentHandle && currentHandle.state !== "cancelled" && currentHandle.state !== "completed") {
+            this.transition(executionId, "cancelled", { reason });
+        }
+        return true;
+    }
+    cleanup(executionId) {
+        const handle = this.activeHandles.get(executionId);
+        if (handle?.timeoutId) {
+            clearTimeout(handle.timeoutId);
+        }
+        this.activeHandles.delete(executionId);
+    }
+    listActive() {
+        return Array.from(this.activeHandles.values());
+    }
+    validateTransition(current, next) {
+        const terminalStates = ["completed", "failed", "timed_out", "cancelled", "killed", "lost"];
+        if (terminalStates.includes(current) && current !== next) {
+            throw new Error(`Invalid lifecycle transition from terminal state "${current}" to "${next}".`);
+        }
+        const validPaths = {
+            created: ["starting", "cancelled", "failed"],
+            starting: ["running", "failed", "timed_out", "cancelled", "killed"],
+            running: ["completing", "completed", "failed", "timed_out", "cancelled", "killed", "lost"],
+            completing: ["completed", "failed", "timed_out", "cancelled", "killed"],
+            completed: [],
+            failed: [],
+            timed_out: [],
+            cancelled: [],
+            killed: [],
+            lost: [],
+        };
+        if (!validPaths[current]?.includes(next)) {
+            throw new Error(`Invalid lifecycle transition from "${current}" to "${next}".`);
+        }
+    }
+}
+//# sourceMappingURL=process-supervisor.js.map

package/dist/execution/process-supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-supervisor.js","sourceRoot":"","sources":["../../src/execution/process-supervisor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAY3D,MAAM,OAAO,iBAAiB;IACX,aAAa,GAAG,IAAI,GAAG,EAAiC,CAAC;IACzD,UAAU,CAAc;IAEzC,YAAY,UAAuC,EAAE;QACnD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAEM,QAAQ,CAAC,OAAyB;QACvC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,WAAW,mBAAmB,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,MAAM,GAA0B;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE,SAAS;YAChB,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,eAAe;SAChB,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,UAAU,CACf,WAAmB,EACnB,SAAgC,EAChC,IAA8B;QAE9B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,WAAW,mCAAmC,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;QAEzB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,WAAW,CAAC,EAAE,CAAC;YACvI,MAAM,SAAS,GAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAoB,IAAI,QAAQ,CAAC;YAC7E,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBACrB,EAAE,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACtE,aAAa,EAAE,CAAC;gBAChB,SAAS;gBACT,IAAI,EAAE,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW;gBACpF,KAAK,EAAE,QAAQ;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE;oBACP,WAAW;oBACX,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;oBAC/B,GAAG,IAAI;iBACR;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,WAAmB,EAAE,GAAW;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;QACnB,CAAC;IACH,CAAC;IAEM,UAAU,CAAC,WAAmB,EAAE,SAAyB;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAEM,SAAS,CAAC,WAAmB;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,MAAM,GAAG,+BAA+B;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE1B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAE/B,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,aAAa,IAAI,aAAa,CAAC,KAAK,KAAK,WAAW,IAAI,aAAa,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAChG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,WAAmB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YACtB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAEM,UAAU;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAEO,kBAAkB,CAAC,OAA8B,EAAE,IAA2B;QACpF,MAAM,cAAc,GAA4B,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpH,IAAI,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,qDAAqD,OAAO,SAAS,IAAI,IAAI,CAAC,CAAC;QACjG,CAAC;QAED,MAAM,UAAU,GAA2D;YACzE,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC;YAC5C,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC;YACnE,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC;YAC1F,UAAU,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC;YACvE,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,EAAE;SACT,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,SAAS,IAAI,IAAI,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF"}

package/dist/execution/process-tree-killer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cross-platform process tree termination helper.
+ * Ensures parent process and all spawned child/grandchild processes are killed.
+ */
+export declare function killProcessTree(pid: number, signal?: NodeJS.Signals): Promise<boolean>;
+//# sourceMappingURL=process-tree-killer.d.ts.map

package/dist/execution/process-tree-killer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree-killer.d.ts","sourceRoot":"","sources":["../../src/execution/process-tree-killer.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BvG"}

package/dist/execution/process-tree-killer.js

@@ -0,0 +1,36 @@
+import { exec } from "node:child_process";
+import os from "node:os";
+/**
+ * Cross-platform process tree termination helper.
+ * Ensures parent process and all spawned child/grandchild processes are killed.
+ */
+export async function killProcessTree(pid, signal = "SIGKILL") {
+    if (!pid || pid <= 0)
+        return false;
+    const isWindows = os.platform() === "win32";
+    if (isWindows) {
+        return new Promise((resolve) => {
+            exec(`taskkill /pid ${pid} /t /f`, (_err) => {
+                // Even if error (e.g. process already exited), resolve gracefully
+                resolve(true);
+            });
+        });
+    }
+    return new Promise((resolve) => {
+        try {
+            // Negative PID kills the process group on POSIX systems
+            process.kill(-pid, signal);
+            resolve(true);
+        }
+        catch {
+            try {
+                process.kill(pid, signal);
+                resolve(true);
+            }
+            catch {
+                resolve(false);
+            }
+        }
+    });
+}
+//# sourceMappingURL=process-tree-killer.js.map

package/dist/execution/process-tree-killer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-tree-killer.js","sourceRoot":"","sources":["../../src/execution/process-tree-killer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,SAAyB,SAAS;IACnF,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,CAAC;IAE5C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;YACtC,IAAI,CAAC,iBAAiB,GAAG,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC1C,kEAAkE;gBAClE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,wDAAwD;YACxD,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/execution/remote-executor.d.ts

@@ -0,0 +1,13 @@
+import { type ExecutionRequest, type ExecutionResult } from "../domain/execution.js";
+export interface RemoteExecutorOptions {
+    remoteEndpoint?: string;
+    authToken?: string;
+}
+export declare class RemoteExecutor {
+    readonly type: "remote";
+    private readonly remoteEndpoint?;
+    constructor(options?: RemoteExecutorOptions);
+    isConfigured(): boolean;
+    execute(request: ExecutionRequest): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=remote-executor.d.ts.map

package/dist/execution/remote-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-executor.d.ts","sourceRoot":"","sources":["../../src/execution/remote-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,SAAgB,IAAI,EAAG,QAAQ,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,GAAE,qBAA0B;IAIxC,YAAY,IAAI,OAAO;IAIjB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CA8B1E"}

package/dist/execution/remote-executor.js

@@ -0,0 +1,40 @@
+import { ExecutionRequestSchema, } from "../domain/execution.js";
+export class RemoteExecutor {
+    type = "remote";
+    remoteEndpoint;
+    constructor(options = {}) {
+        this.remoteEndpoint = options.remoteEndpoint;
+    }
+    isConfigured() {
+        return Boolean(this.remoteEndpoint);
+    }
+    async execute(request) {
+        const validated = ExecutionRequestSchema.parse(request);
+        const startTime = Date.now();
+        if (!this.isConfigured()) {
+            return {
+                executionId: validated.executionId,
+                executorType: "remote",
+                status: "failed",
+                exitCode: 1,
+                stdout: "",
+                stderr: "Executor unavailable: Remote execution worker pool is not configured.",
+                truncated: false,
+                durationMs: Date.now() - startTime,
+                error: "Remote executor not configured",
+            };
+        }
+        // Remote HTTP execution dispatch (mock/stub boundary)
+        return {
+            executionId: validated.executionId,
+            executorType: "remote",
+            status: "completed",
+            exitCode: 0,
+            stdout: `[Remote: ${this.remoteEndpoint}] Command executed successfully.`,
+            stderr: "",
+            truncated: false,
+            durationMs: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=remote-executor.js.map

package/dist/execution/remote-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-executor.js","sourceRoot":"","sources":["../../src/execution/remote-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAOhC,MAAM,OAAO,cAAc;IACT,IAAI,GAAG,QAAiB,CAAC;IACxB,cAAc,CAAU;IAEzC,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAEM,YAAY;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAyB;QAC5C,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACzB,OAAO;gBACL,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,YAAY,EAAE,QAAQ;gBACtB,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,CAAC;gBACX,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,uEAAuE;gBAC/E,SAAS,EAAE,KAAK;gBAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,KAAK,EAAE,gCAAgC;aACxC,CAAC;QACJ,CAAC;QAED,sDAAsD;QACtD,OAAO;YACL,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,YAAY,EAAE,QAAQ;YACtB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,YAAY,IAAI,CAAC,cAAc,kCAAkC;YACzE,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/execution/workspace-integrator.d.ts

@@ -0,0 +1,37 @@
+import { type IntegrationRequest, type IntegrationResult } from "../domain/workspace.js";
+import { EventStore } from "../event-state/event-store.js";
+import { WorkspaceRepository } from "../persistence/repositories/workspace-repository.js";
+import { TaskClaimManager } from "../tasks/task-claim-manager.js";
+import { GitWorktreeManager } from "./git-worktree-manager.js";
+import { ChangeSetCalculator } from "./change-set-calculator.js";
+import { ConflictDetector } from "./conflict-detector.js";
+export interface WorkspaceIntegratorOptions {
+    workspaceRepo: WorkspaceRepository;
+    claimManager?: TaskClaimManager;
+    worktreeManager?: GitWorktreeManager;
+    changeSetCalculator?: ChangeSetCalculator;
+    conflictDetector?: ConflictDetector;
+    eventStore?: EventStore;
+    verificationFn?: (worktreePath: string) => Promise<boolean>;
+}
+/**
+ * Safe Workspace Integrator.
+ * Orchestrates pre-integration checks, ownership fencing verification,
+ * user-work protection, conflict detection, verification gates, and atomic merge.
+ * PRD Part 2 Section 55.
+ */
+export declare class WorkspaceIntegrator {
+    private readonly workspaceRepo;
+    private readonly claimManager?;
+    private readonly worktreeManager;
+    private readonly changeSetCalculator;
+    private readonly conflictDetector;
+    private readonly eventStore?;
+    private readonly verificationFn?;
+    constructor(options: WorkspaceIntegratorOptions);
+    /**
+     * Safely integrate a workspace's changes into the target repository branch.
+     */
+    integrate(request: IntegrationRequest, repoPath?: string): Promise<IntegrationResult>;
+}
+//# sourceMappingURL=workspace-integrator.d.ts.map

package/dist/execution/workspace-integrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-integrator.d.ts","sourceRoot":"","sources":["../../src/execution/workspace-integrator.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAGvB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,mBAAmB,CAAC;IACnC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA6C;gBAEjE,OAAO,EAAE,0BAA0B;IAU/C;;OAEG;IACU,SAAS,CACpB,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;CAoN9B"}

package/dist/execution/workspace-integrator.js

@@ -0,0 +1,223 @@
+import { randomUUID } from "node:crypto";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { IntegrationResultSchema, } from "../domain/workspace.js";
+import { EventTypes } from "../domain/event.js";
+import { GitWorktreeManager } from "./git-worktree-manager.js";
+import { ChangeSetCalculator } from "./change-set-calculator.js";
+import { ConflictDetector } from "./conflict-detector.js";
+const execAsync = promisify(exec);
+/**
+ * Safe Workspace Integrator.
+ * Orchestrates pre-integration checks, ownership fencing verification,
+ * user-work protection, conflict detection, verification gates, and atomic merge.
+ * PRD Part 2 Section 55.
+ */
+export class WorkspaceIntegrator {
+    workspaceRepo;
+    claimManager;
+    worktreeManager;
+    changeSetCalculator;
+    conflictDetector;
+    eventStore;
+    verificationFn;
+    constructor(options) {
+        this.workspaceRepo = options.workspaceRepo;
+        this.claimManager = options.claimManager;
+        this.worktreeManager = options.worktreeManager ?? new GitWorktreeManager();
+        this.changeSetCalculator = options.changeSetCalculator ?? new ChangeSetCalculator();
+        this.conflictDetector = options.conflictDetector ?? new ConflictDetector();
+        this.eventStore = options.eventStore;
+        this.verificationFn = options.verificationFn;
+    }
+    /**
+     * Safely integrate a workspace's changes into the target repository branch.
+     */
+    async integrate(request, repoPath = process.cwd()) {
+        const ws = this.workspaceRepo.findById(request.workspaceId);
+        if (!ws) {
+            return IntegrationResultSchema.parse({
+                success: false,
+                workspaceId: request.workspaceId,
+                status: "ERROR",
+                errorMessage: `Workspace "${request.workspaceId}" not found.`,
+            });
+        }
+        // 1. Fencing & Ownership Verification
+        if (this.claimManager) {
+            const isOwner = this.claimManager.verifyOwnership(request.taskId, request.leaseId, request.generation, request.agentId);
+            if (!isOwner) {
+                if (this.eventStore) {
+                    this.eventStore.append({
+                        id: randomUUID(),
+                        schemaVersion: 1,
+                        actor: "system",
+                        timestamp: new Date().toISOString(),
+                        type: EventTypes.WORKSPACE_INTEGRATION_REJECTED,
+                        projectId: ws.projectId,
+                        taskId: ws.taskId,
+                        agentId: ws.agentId,
+                        payload: {
+                            workspaceId: ws.id,
+                            reason: "FENCING_VIOLATION",
+                            attemptedGeneration: request.generation,
+                        },
+                    });
+                }
+                return IntegrationResultSchema.parse({
+                    success: false,
+                    workspaceId: request.workspaceId,
+                    status: "FENCING_VIOLATION",
+                    errorMessage: `Integration rejected: Stale ownership fencing token (generation ${request.generation}) for task "${request.taskId}".`,
+                });
+            }
+        }
+        // 2. User-Work Protection: Check Target Repository Working Tree
+        let targetStatus;
+        try {
+            targetStatus = await this.worktreeManager.inspectWorkingTree(repoPath);
+        }
+        catch (err) {
+            return IntegrationResultSchema.parse({
+                success: false,
+                workspaceId: request.workspaceId,
+                status: "ERROR",
+                errorMessage: `Failed to inspect target repository: ${err.message}`,
+            });
+        }
+        if (!targetStatus.isClean) {
+            return IntegrationResultSchema.parse({
+                success: false,
+                workspaceId: request.workspaceId,
+                status: "USER_CHANGE_BLOCKED",
+                errorMessage: `Target repository has uncommitted user modifications. Integration is blocked to prevent data loss.`,
+            });
+        }
+        // 3. Calculate ChangeSet for Current Workspace
+        let changeSet;
+        try {
+            changeSet = await this.changeSetCalculator.calculate(ws.id, ws.worktreePath, ws.baseCommit, targetStatus.headCommit);
+            this.workspaceRepo.saveChangeSet(changeSet);
+        }
+        catch (err) {
+            return IntegrationResultSchema.parse({
+                success: false,
+                workspaceId: request.workspaceId,
+                status: "ERROR",
+                errorMessage: `Failed to calculate changeset: ${err.message}`,
+            });
+        }
+        // 4. Fetch Active Peer ChangeSets for Conflict Analysis
+        const peerWorkspaces = this.workspaceRepo.findActiveByProjectId(ws.projectId);
+        const peerChangeSets = [];
+        for (const peer of peerWorkspaces) {
+            if (peer.id !== ws.id) {
+                const cs = this.workspaceRepo.getChangeSet(peer.id);
+                if (cs)
+                    peerChangeSets.push(cs);
+            }
+        }
+        // 5. Detect Conflicts
+        const conflict = this.conflictDetector.detectConflicts(changeSet, peerChangeSets, targetStatus);
+        if (conflict) {
+            this.workspaceRepo.saveConflictReport(conflict);
+            this.workspaceRepo.updateStatus(ws.id, "CONFLICT_DETECTED");
+            if (this.eventStore) {
+                this.eventStore.append({
+                    id: randomUUID(),
+                    schemaVersion: 1,
+                    actor: "system",
+                    timestamp: new Date().toISOString(),
+                    type: EventTypes.WORKSPACE_CONFLICT_DETECTED,
+                    projectId: ws.projectId,
+                    taskId: ws.taskId,
+                    agentId: ws.agentId,
+                    payload: {
+                        workspaceId: ws.id,
+                        conflictType: conflict.conflictType,
+                        conflictingFiles: conflict.conflictingFiles,
+                        details: conflict.details,
+                    },
+                });
+            }
+            return IntegrationResultSchema.parse({
+                success: false,
+                workspaceId: request.workspaceId,
+                conflictReport: conflict,
+                status: "CONFLICT_REJECTED",
+                errorMessage: `Integration rejected due to ${conflict.conflictType}: ${conflict.details}`,
+            });
+        }
+        // 6. Verification Gate
+        if (request.runVerification && this.verificationFn) {
+            this.workspaceRepo.updateStatus(ws.id, "VERIFYING");
+            const passed = await this.verificationFn(ws.worktreePath);
+            if (!passed) {
+                this.workspaceRepo.updateStatus(ws.id, "FAILED");
+                return IntegrationResultSchema.parse({
+                    success: false,
+                    workspaceId: request.workspaceId,
+                    status: "VERIFICATION_FAILED",
+                    errorMessage: `Verification gate failed prior to integration.`,
+                });
+            }
+        }
+        // 7. Atomic Integration (Merge worktree branch into target)
+        let integratedCommit;
+        try {
+            if (this.eventStore) {
+                this.eventStore.append({
+                    id: randomUUID(),
+                    schemaVersion: 1,
+                    actor: "system",
+                    timestamp: new Date().toISOString(),
+                    type: EventTypes.WORKSPACE_INTEGRATION_STARTED,
+                    projectId: ws.projectId,
+                    taskId: ws.taskId,
+                    agentId: ws.agentId,
+                    payload: { workspaceId: ws.id, branch: ws.branchName },
+                });
+            }
+            // Merge worktree branch into target repository branch
+            const commitMsg = request.commitMessage || `feat(task): integrate workspace ${ws.id} for task ${ws.taskId}`;
+            await execAsync(`git merge "${ws.branchName}" -m "${commitMsg}"`, { cwd: repoPath });
+            const { stdout: headOut } = await execAsync("git rev-parse HEAD", { cwd: repoPath });
+            integratedCommit = headOut.trim();
+        }
+        catch (err) {
+            return IntegrationResultSchema.parse({
+                success: false,
+                workspaceId: request.workspaceId,
+                status: "ERROR",
+                errorMessage: `Git merge failed: ${err.message}`,
+            });
+        }
+        // 8. Update Workspace Status & Emit Audit Events
+        this.workspaceRepo.updateStatus(ws.id, "INTEGRATED");
+        if (this.eventStore) {
+            this.eventStore.append({
+                id: randomUUID(),
+                schemaVersion: 1,
+                actor: "system",
+                timestamp: new Date().toISOString(),
+                type: EventTypes.WORKSPACE_INTEGRATED,
+                projectId: ws.projectId,
+                taskId: ws.taskId,
+                agentId: ws.agentId,
+                payload: {
+                    workspaceId: ws.id,
+                    integratedCommit,
+                    filesModified: changeSet.filesModified,
+                    filesAdded: changeSet.filesAdded,
+                },
+            });
+        }
+        return IntegrationResultSchema.parse({
+            success: true,
+            workspaceId: request.workspaceId,
+            integratedCommit,
+            status: "INTEGRATED",
+        });
+    }
+}
+//# sourceMappingURL=workspace-integrator.js.map

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

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

package/dist/execution/workspace-manager.d.ts

@@ -0,0 +1,62 @@
+import { type ExecutionWorkspace, type WorkspaceStatus } from "../domain/workspace.js";
+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 { TaskClaimManager } from "../tasks/task-claim-manager.js";
+import { GitWorktreeManager } from "./git-worktree-manager.js";
+export interface AllocateWorkspaceRequest {
+    projectId: string;
+    taskId: string;
+    agentId: string;
+    instanceId: string;
+    leaseId: string;
+    generation: number;
+    baseBranch?: string;
+    repoPath?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AllocateWorkspaceResult {
+    success: boolean;
+    workspace?: ExecutionWorkspace;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface WorkspaceManagerOptions {
+    workspaceRepo: WorkspaceRepository;
+    leaseRepo?: LeaseRepository;
+    claimManager?: TaskClaimManager;
+    worktreeManager?: GitWorktreeManager;
+    eventStore?: EventStore;
+    maxActiveWorktreesPerProject?: number;
+}
+/**
+ * Workspace Manager coordinating execution workspace allocation,
+ * task lease binding, base revision capture, and concurrency bounds.
+ * PRD Part 2 Section 52.
+ */
+export declare class WorkspaceManager {
+    private readonly workspaceRepo;
+    private readonly leaseRepo?;
+    private readonly claimManager?;
+    private readonly worktreeManager;
+    private readonly eventStore?;
+    private readonly maxActiveWorktreesPerProject;
+    constructor(options: WorkspaceManagerOptions);
+    /**
+     * Allocate an isolated execution workspace for a claimed task.
+     */
+    allocateWorkspace(request: AllocateWorkspaceRequest): Promise<AllocateWorkspaceResult>;
+    /**
+     * Get workspace by ID.
+     */
+    getWorkspace(workspaceId: string): ExecutionWorkspace | null;
+    /**
+     * Update workspace status.
+     */
+    updateStatus(workspaceId: string, status: WorkspaceStatus, quarantineReason?: string): void;
+    /**
+     * Release and safely clean up workspace.
+     */
+    cleanupWorkspace(workspaceId: string, repoPath?: string, force?: boolean): Promise<boolean>;
+}
+//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/execution/workspace-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../src/execution/workspace-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,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,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,mBAAmB,CAAC;IACnC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAS;gBAE1C,OAAO,EAAE,uBAAuB;IAS5C;;OAEG;IACU,iBAAiB,CAC5B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAoInC;;OAEG;IACI,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAInE;;OAEG;IACI,YAAY,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,gBAAgB,CAAC,EAAE,MAAM,GACxB,IAAI;IAIP;;OAEG;IACU,gBAAgB,CAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAsB,EAChC,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC;CAyBpB"}