anantham-v2 2.0.0-alpha.1

package/dist/execution/git-worktree-manager.d.ts

@@ -0,0 +1,51 @@
+export interface GitWorkingTreeStatus {
+    branch: string;
+    headCommit: string;
+    isClean: boolean;
+    modifiedFiles: string[];
+    untrackedFiles: string[];
+}
+export interface GitWorktreeManagerOptions {
+    projectRoot?: string;
+}
+/**
+ * Git Worktree Manager for isolated parallel execution.
+ * Enforces path safety, base revision verification, dirty-tree detection,
+ * and user change preservation.
+ * PRD Part 2 Section 52, Playbook Section 138.
+ */
+export declare class GitWorktreeManager {
+    private readonly projectRoot;
+    constructor(options?: GitWorktreeManagerOptions);
+    /**
+     * Get the safe worktree directory for a workspace ID.
+     */
+    getWorktreePath(workspaceId: string, customRoot?: string): string;
+    /**
+     * Inspect current repository working tree status.
+     */
+    inspectWorkingTree(repoPath?: string): Promise<GitWorkingTreeStatus>;
+    /**
+     * Assert that target repository is clean before any destructive or integration operation.
+     * Playbook Section 138.
+     */
+    assertCleanWorkingTree(repoPath?: string, operationName?: string): Promise<void>;
+    static validateRef(ref: string, fieldName?: string): void;
+    /**
+     * Create an isolated Git worktree for an agent.
+     */
+    createWorktree(workspaceId: string, branchName: string, baseCommit: string, repoPath?: string): Promise<{
+        worktreePath: string;
+        branchName: string;
+        baseCommit: string;
+    }>;
+    /**
+     * Safely remove a Git worktree.
+     */
+    removeWorktree(worktreePath: string, repoPath?: string, force?: boolean): Promise<boolean>;
+    /**
+     * List active Git worktrees.
+     */
+    listWorktrees(repoPath?: string): Promise<string[]>;
+}
+//# sourceMappingURL=git-worktree-manager.d.ts.map

package/dist/execution/git-worktree-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree-manager.d.ts","sourceRoot":"","sources":["../../src/execution/git-worktree-manager.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,yBAA8B;IAInD;;OAEG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBxE;;OAEG;IACU,kBAAkB,CAAC,QAAQ,GAAE,MAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwCnG;;;OAGG;IACU,sBAAsB,CAAC,QAAQ,GAAE,MAAyB,EAAE,aAAa,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;WAShH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,IAAI;IAMvE;;OAEG;IACU,cAAc,CACzB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAyB,GAClC,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC5E;;OAEG;IACU,cAAc,CACzB,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAyB,EACnC,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC;IAkCnB;;OAEG;IACU,aAAa,CAAC,QAAQ,GAAE,MAAyB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAenF"}

package/dist/execution/git-worktree-manager.js

@@ -0,0 +1,174 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import * as path from "node:path";
+import * as fs from "node:fs";
+const execAsync = promisify(exec);
+/**
+ * Git Worktree Manager for isolated parallel execution.
+ * Enforces path safety, base revision verification, dirty-tree detection,
+ * and user change preservation.
+ * PRD Part 2 Section 52, Playbook Section 138.
+ */
+export class GitWorktreeManager {
+    projectRoot;
+    constructor(options = {}) {
+        this.projectRoot = path.resolve(options.projectRoot || process.cwd());
+    }
+    /**
+     * Get the safe worktree directory for a workspace ID.
+     */
+    getWorktreePath(workspaceId, customRoot) {
+        if (workspaceId.includes("..") || workspaceId.includes("/") || workspaceId.includes("\\")) {
+            throw new Error(`SECURITY_PATH_TRAVERSAL: Workspace ID "${workspaceId}" contains invalid traversal characters.`);
+        }
+        const root = customRoot ? path.resolve(customRoot) : this.projectRoot;
+        const sanitizedId = workspaceId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const targetDir = path.join(root, ".anantham", "worktrees", sanitizedId);
+        // Path traversal defense
+        const rel = path.relative(root, targetDir);
+        if (rel.startsWith("..") || path.isAbsolute(rel)) {
+            throw new Error(`SECURITY_PATH_TRAVERSAL: Worktree path "${targetDir}" escapes project root "${root}"`);
+        }
+        return targetDir;
+    }
+    /**
+     * Inspect current repository working tree status.
+     */
+    async inspectWorkingTree(repoPath = this.projectRoot) {
+        try {
+            const { stdout: branchOut } = await execAsync("git rev-parse --abbrev-ref HEAD", { cwd: repoPath });
+            const branch = branchOut.trim();
+            const { stdout: commitOut } = await execAsync("git rev-parse HEAD", { cwd: repoPath });
+            const headCommit = commitOut.trim();
+            const { stdout: statusOut } = await execAsync("git status --porcelain", { cwd: repoPath });
+            const lines = statusOut.split("\n").map((l) => l.trim()).filter(Boolean);
+            const modifiedFiles = [];
+            const untrackedFiles = [];
+            for (const line of lines) {
+                const flag = line.slice(0, 2);
+                const file = line.slice(3).trim();
+                const normalized = file.replace(/\\/g, "/");
+                if (normalized.startsWith(".anantham/") || normalized === ".anantham") {
+                    continue;
+                }
+                if (flag === "??") {
+                    untrackedFiles.push(file);
+                }
+                else {
+                    modifiedFiles.push(file);
+                }
+            }
+            return {
+                branch,
+                headCommit,
+                isClean: modifiedFiles.length === 0 && untrackedFiles.length === 0,
+                modifiedFiles,
+                untrackedFiles,
+            };
+        }
+        catch (err) {
+            throw new Error(`GIT_INSPECTION_FAILED: Failed to inspect git status at "${repoPath}": ${err.message}`);
+        }
+    }
+    /**
+     * Assert that target repository is clean before any destructive or integration operation.
+     * Playbook Section 138.
+     */
+    async assertCleanWorkingTree(repoPath = this.projectRoot, operationName = "integration") {
+        const status = await this.inspectWorkingTree(repoPath);
+        if (!status.isClean) {
+            throw new Error(`USER_WORK_PROTECTION_VIOLATION: Repository at "${repoPath}" contains ${status.modifiedFiles.length} modified files and ${status.untrackedFiles.length} untracked files. Operation "${operationName}" is prohibited to prevent overwriting user modifications.`);
+        }
+    }
+    static validateRef(ref, fieldName = "ref") {
+        if (!ref || !/^[a-zA-Z0-9_\-\./]+$/.test(ref) || ref.startsWith("-") || ref.includes("..")) {
+            throw new Error(`SECURITY_INVALID_REF: ${fieldName} "${ref}" contains forbidden shell or traversal characters.`);
+        }
+    }
+    /**
+     * Create an isolated Git worktree for an agent.
+     */
+    async createWorktree(workspaceId, branchName, baseCommit, repoPath = this.projectRoot) {
+        // 1. Strict ref format validation (Zero shell injection defense)
+        GitWorktreeManager.validateRef(branchName, "Branch name");
+        GitWorktreeManager.validateRef(baseCommit, "Base commit");
+        const worktreePath = this.getWorktreePath(workspaceId, repoPath);
+        // Ensure parent dir exists
+        fs.mkdirSync(path.dirname(worktreePath), { recursive: true });
+        // Verify base commit exists
+        try {
+            await execAsync(`git rev-parse --verify "${baseCommit}"`, { cwd: repoPath });
+        }
+        catch {
+            throw new Error(`INVALID_BASE_COMMIT: Commit "${baseCommit}" does not exist in repository "${repoPath}"`);
+        }
+        // Create worktree on a new branch starting from baseCommit
+        try {
+            await execAsync(`git worktree add -b "${branchName}" "${worktreePath}" "${baseCommit}"`, {
+                cwd: repoPath,
+            });
+        }
+        catch (err) {
+            throw new Error(`WORKTREE_CREATION_FAILED: Failed to create worktree at "${worktreePath}": ${err.message}`);
+        }
+        return {
+            worktreePath,
+            branchName,
+            baseCommit,
+        };
+    }
+    /**
+     * Safely remove a Git worktree.
+     */
+    async removeWorktree(worktreePath, repoPath = this.projectRoot, force = false) {
+        try {
+            if (!fs.existsSync(worktreePath)) {
+                return true;
+            }
+            // Check if worktree contains uncommitted modifications unless force is explicitly set
+            if (!force) {
+                const status = await this.inspectWorkingTree(worktreePath);
+                if (!status.isClean) {
+                    throw new Error(`WORKTREE_HAS_UNCOMMITTED_CHANGES: Cannot remove worktree "${worktreePath}" containing uncommitted modifications.`);
+                }
+            }
+            await execAsync(`git worktree remove --force "${worktreePath}"`, { cwd: repoPath });
+            await execAsync("git worktree prune", { cwd: repoPath });
+            return true;
+        }
+        catch (err) {
+            if (err.message?.includes("WORKTREE_HAS_UNCOMMITTED_CHANGES")) {
+                throw err;
+            }
+            // Fallback manual cleanup if git worktree remove encounters detached state
+            try {
+                fs.rmSync(worktreePath, { recursive: true, force: true });
+                await execAsync("git worktree prune", { cwd: repoPath });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    /**
+     * List active Git worktrees.
+     */
+    async listWorktrees(repoPath = this.projectRoot) {
+        try {
+            const { stdout } = await execAsync("git worktree list --porcelain", { cwd: repoPath });
+            const worktrees = [];
+            const lines = stdout.split("\n");
+            for (const line of lines) {
+                if (line.startsWith("worktree ")) {
+                    worktrees.push(line.slice(9).trim());
+                }
+            }
+            return worktrees;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=git-worktree-manager.js.map

package/dist/execution/git-worktree-manager.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Anantham V2 — Execution Infrastructure Plane
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 41-48 / P4.4
+ */
+export * from "./process-tree-killer.js";
+export * from "./process-supervisor.js";
+export * from "./local-executor.js";
+export * from "./docker-sandbox-executor.js";
+export * from "./remote-executor.js";
+export * from "./executor-registry.js";
+export * from "./git-worktree-manager.js";
+export * from "./change-set-calculator.js";
+export * from "./conflict-detector.js";
+export * from "./workspace-manager.js";
+export * from "./workspace-integrator.js";
+export * from "./parallel-orchestrator.js";
+export * from "./workspace-recovery-engine.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,18 @@
+/**
+ * Anantham V2 — Execution Infrastructure Plane
+ * PRD Part 1 Section 83-90 & PRD Part 2 Section 41-48 / P4.4
+ */
+export * from "./process-tree-killer.js";
+export * from "./process-supervisor.js";
+export * from "./local-executor.js";
+export * from "./docker-sandbox-executor.js";
+export * from "./remote-executor.js";
+export * from "./executor-registry.js";
+export * from "./git-worktree-manager.js";
+export * from "./change-set-calculator.js";
+export * from "./conflict-detector.js";
+export * from "./workspace-manager.js";
+export * from "./workspace-integrator.js";
+export * from "./parallel-orchestrator.js";
+export * from "./workspace-recovery-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC"}

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

@@ -0,0 +1,19 @@
+import { type ExecutionRequest, type ExecutionResult } from "../domain/execution.js";
+import { ProcessSupervisor } from "./process-supervisor.js";
+export interface LocalExecutorOptions {
+    supervisor?: ProcessSupervisor;
+    defaultTimeoutMs?: number;
+    defaultMaxOutputBytes?: number;
+    defaultProjectRoot?: string;
+}
+export declare class LocalExecutor {
+    readonly type: "local";
+    private readonly supervisor;
+    private readonly defaultTimeoutMs;
+    private readonly defaultMaxOutputBytes;
+    private readonly defaultProjectRoot;
+    constructor(options?: LocalExecutorOptions);
+    execute(request: ExecutionRequest): Promise<ExecutionResult>;
+    private scrubSecrets;
+}
+//# sourceMappingURL=local-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-executor.d.ts","sourceRoot":"","sources":["../../src/execution/local-executor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,aAAa;IACxB,SAAgB,IAAI,EAAG,OAAO,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAEhC,OAAO,GAAE,oBAAyB;IAOjC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyJzE,OAAO,CAAC,YAAY;CAIrB"}

package/dist/execution/local-executor.js

@@ -0,0 +1,155 @@
+import { spawn } from "node:child_process";
+import { ExecutionRequestSchema, } from "../domain/execution.js";
+import { resolveSafePath } from "../tools/native/path-utils.js";
+import { ProcessSupervisor } from "./process-supervisor.js";
+import { killProcessTree } from "./process-tree-killer.js";
+export class LocalExecutor {
+    type = "local";
+    supervisor;
+    defaultTimeoutMs;
+    defaultMaxOutputBytes;
+    defaultProjectRoot;
+    constructor(options = {}) {
+        this.supervisor = options.supervisor || new ProcessSupervisor();
+        this.defaultTimeoutMs = options.defaultTimeoutMs || 30000;
+        this.defaultMaxOutputBytes = options.defaultMaxOutputBytes || 1024 * 1024; // 1MB
+        this.defaultProjectRoot = options.defaultProjectRoot || process.cwd();
+    }
+    async execute(request) {
+        const validated = ExecutionRequestSchema.parse(request);
+        const root = validated.projectRoot || this.defaultProjectRoot;
+        const workingDir = validated.cwd ? resolveSafePath(root, validated.cwd) : root;
+        const timeout = validated.timeoutMs || validated.limits?.timeoutMs || this.defaultTimeoutMs;
+        const maxOutput = validated.maxOutputBytes || validated.limits?.maxOutputBytes || this.defaultMaxOutputBytes;
+        this.supervisor.register(validated);
+        this.supervisor.transition(validated.executionId, "starting");
+        const startTime = Date.now();
+        // Sanitize Environment: drop raw secrets and sensitive tokens
+        const sanitizedEnv = {};
+        for (const [k, v] of Object.entries(process.env)) {
+            if (k.toUpperCase().includes("KEY") ||
+                k.toUpperCase().includes("SECRET") ||
+                k.toUpperCase().includes("TOKEN") ||
+                k.toUpperCase().includes("PASSWORD")) {
+                continue;
+            }
+            if (v !== undefined) {
+                sanitizedEnv[k] = v;
+            }
+        }
+        if (validated.env) {
+            for (const [k, v] of Object.entries(validated.env)) {
+                sanitizedEnv[k] = v;
+            }
+        }
+        return new Promise((resolve) => {
+            let isSettled = false;
+            let stdoutBuffer = "";
+            let stderrBuffer = "";
+            let truncated = false;
+            const child = spawn(validated.command, validated.args || [], {
+                cwd: workingDir,
+                env: sanitizedEnv,
+                shell: true,
+            });
+            if (child.pid) {
+                this.supervisor.setPid(validated.executionId, child.pid);
+            }
+            this.supervisor.transition(validated.executionId, "running");
+            const timeoutId = setTimeout(async () => {
+                if (isSettled)
+                    return;
+                isSettled = true;
+                if (child.pid) {
+                    await killProcessTree(child.pid);
+                }
+                this.supervisor.transition(validated.executionId, "timed_out", { timeoutMs: timeout });
+                this.supervisor.cleanup(validated.executionId);
+                resolve({
+                    executionId: validated.executionId,
+                    executorType: "local",
+                    status: "timed_out",
+                    exitCode: null,
+                    stdout: this.scrubSecrets(stdoutBuffer),
+                    stderr: `${this.scrubSecrets(stderrBuffer)}\n[Execution timed out after ${timeout}ms]`.trim(),
+                    truncated,
+                    durationMs: Date.now() - startTime,
+                    error: `Process timed out after ${timeout}ms`,
+                });
+            }, timeout);
+            this.supervisor.setTimeout(validated.executionId, timeoutId);
+            child.stdout.on("data", (chunk) => {
+                if (Buffer.byteLength(stdoutBuffer) < maxOutput) {
+                    stdoutBuffer += chunk.toString("utf8");
+                    if (Buffer.byteLength(stdoutBuffer) >= maxOutput) {
+                        truncated = true;
+                        stdoutBuffer = stdoutBuffer.slice(0, maxOutput) + "\n[STDOUT_TRUNCATED]";
+                    }
+                }
+            });
+            child.stderr.on("data", (chunk) => {
+                if (Buffer.byteLength(stderrBuffer) < maxOutput) {
+                    stderrBuffer += chunk.toString("utf8");
+                    if (Buffer.byteLength(stderrBuffer) >= maxOutput) {
+                        truncated = true;
+                        stderrBuffer = stderrBuffer.slice(0, maxOutput) + "\n[STDERR_TRUNCATED]";
+                    }
+                }
+            });
+            child.on("error", (err) => {
+                if (isSettled)
+                    return;
+                isSettled = true;
+                clearTimeout(timeoutId);
+                this.supervisor.transition(validated.executionId, "failed", { error: err.message });
+                this.supervisor.cleanup(validated.executionId);
+                resolve({
+                    executionId: validated.executionId,
+                    executorType: "local",
+                    status: "failed",
+                    exitCode: 1,
+                    stdout: this.scrubSecrets(stdoutBuffer),
+                    stderr: this.scrubSecrets(stderrBuffer || err.message),
+                    truncated,
+                    durationMs: Date.now() - startTime,
+                    error: err.message,
+                });
+            });
+            child.on("close", (code, signal) => {
+                if (isSettled)
+                    return;
+                isSettled = true;
+                clearTimeout(timeoutId);
+                const currentHandle = this.supervisor.getHandle(validated.executionId);
+                const terminalStates = ["completed", "failed", "timed_out", "cancelled", "killed", "lost"];
+                let status = code === 0 ? "completed" : signal ? "killed" : "failed";
+                if (currentHandle?.state === "cancelled") {
+                    status = "cancelled";
+                }
+                else if (currentHandle?.state === "timed_out") {
+                    status = "timed_out";
+                }
+                if (currentHandle && !terminalStates.includes(currentHandle.state)) {
+                    this.supervisor.transition(validated.executionId, status === "completed" ? "completed" : "failed", { code, signal });
+                }
+                this.supervisor.cleanup(validated.executionId);
+                resolve({
+                    executionId: validated.executionId,
+                    executorType: "local",
+                    status,
+                    exitCode: code,
+                    stdout: this.scrubSecrets(stdoutBuffer),
+                    stderr: this.scrubSecrets(stderrBuffer),
+                    truncated,
+                    durationMs: Date.now() - startTime,
+                });
+            });
+        });
+    }
+    scrubSecrets(text) {
+        if (!text)
+            return "";
+        return text.replace(/sk-[a-zA-Z0-9_-]{10,}/g, "[REDACTED_SECRET]");
+    }
+}
+//# sourceMappingURL=local-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-executor.js","sourceRoot":"","sources":["../../src/execution/local-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAGL,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAS3D,MAAM,OAAO,aAAa;IACR,IAAI,GAAG,OAAgB,CAAC;IACvB,UAAU,CAAoB;IAC9B,gBAAgB,CAAS;IACzB,qBAAqB,CAAS;IAC9B,kBAAkB,CAAS;IAE5C,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAChE,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC;QAC1D,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;QACjF,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxE,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAyB;QAC5C,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,IAAI,IAAI,CAAC,kBAAkB,CAAC;QAC9D,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC;QAC5F,MAAM,SAAS,GAAG,SAAS,CAAC,cAAc,IAAI,SAAS,CAAC,MAAM,EAAE,cAAc,IAAI,IAAI,CAAC,qBAAqB,CAAC;QAE7G,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,8DAA8D;QAC9D,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,IACE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC/B,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAClC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACjC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EACpC,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;gBACpB,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnD,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;YAC9C,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,YAAY,GAAG,EAAE,CAAC;YACtB,IAAI,YAAY,GAAG,EAAE,CAAC;YACtB,IAAI,SAAS,GAAG,KAAK,CAAC;YAEtB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,IAAI,EAAE,EAAE;gBAC3D,GAAG,EAAE,UAAU;gBACf,GAAG,EAAE,YAAY;gBACjB,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YAEH,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAE7D,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBACtC,IAAI,SAAS;oBAAE,OAAO;gBACtB,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;oBACd,MAAM,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnC,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;gBACvF,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBAE/C,OAAO,CAAC;oBACN,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,YAAY,EAAE,OAAO;oBACrB,MAAM,EAAE,WAAW;oBACnB,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;oBACvC,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,gCAAgC,OAAO,KAAK,CAAC,IAAI,EAAE;oBAC7F,SAAS;oBACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,KAAK,EAAE,2BAA2B,OAAO,IAAI;iBAC9C,CAAC,CAAC;YACL,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAE7D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,CAAC;oBAChD,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACvC,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;wBACjD,SAAS,GAAG,IAAI,CAAC;wBACjB,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,sBAAsB,CAAC;oBAC3E,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,CAAC;oBAChD,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACvC,IAAI,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;wBACjD,SAAS,GAAG,IAAI,CAAC;wBACjB,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,sBAAsB,CAAC;oBAC3E,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,SAAS;oBAAE,OAAO;gBACtB,SAAS,GAAG,IAAI,CAAC;gBACjB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpF,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBAE/C,OAAO,CAAC;oBACN,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,YAAY,EAAE,OAAO;oBACrB,MAAM,EAAE,QAAQ;oBAChB,QAAQ,EAAE,CAAC;oBACX,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;oBACvC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,IAAI,GAAG,CAAC,OAAO,CAAC;oBACtD,SAAS;oBACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,KAAK,EAAE,GAAG,CAAC,OAAO;iBACnB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;gBACjC,IAAI,SAAS;oBAAE,OAAO;gBACtB,SAAS,GAAG,IAAI,CAAC;gBACjB,YAAY,CAAC,SAAS,CAAC,CAAC;gBAExB,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBACvE,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAE3F,IAAI,MAAM,GAA8B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAChG,IAAI,aAAa,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;oBACzC,MAAM,GAAG,WAAW,CAAC;gBACvB,CAAC;qBAAM,IAAI,aAAa,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;oBAChD,MAAM,GAAG,WAAW,CAAC;gBACvB,CAAC;gBAED,IAAI,aAAa,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnE,IAAI,CAAC,UAAU,CAAC,UAAU,CACxB,SAAS,CAAC,WAAW,EACrB,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,CACjB,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBAE/C,OAAO,CAAC;oBACN,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,YAAY,EAAE,OAAO;oBACrB,MAAM;oBACN,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;oBACvC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;oBACvC,SAAS;oBACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACnC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/execution/parallel-orchestrator.d.ts

@@ -0,0 +1,34 @@
+import { type IntegrationRequest, type IntegrationResult } from "../domain/workspace.js";
+import { WorkspaceManager, type AllocateWorkspaceRequest, type AllocateWorkspaceResult } from "./workspace-manager.js";
+import { WorkspaceIntegrator } from "./workspace-integrator.js";
+import { WorkspaceRepository } from "../persistence/repositories/workspace-repository.js";
+export interface ParallelOrchestratorOptions {
+    workspaceManager: WorkspaceManager;
+    workspaceIntegrator: WorkspaceIntegrator;
+    workspaceRepo: WorkspaceRepository;
+}
+/**
+ * Parallel Execution Orchestrator.
+ * Coordinates multi-agent parallel workspaces and handles deterministic
+ * serialization fallback when conflicts are detected.
+ * PRD Part 2 Section 52, Section 55.
+ */
+export declare class ParallelOrchestrator {
+    private readonly workspaceManager;
+    private readonly workspaceIntegrator;
+    private readonly workspaceRepo;
+    constructor(options: ParallelOrchestratorOptions);
+    /**
+     * Spawn an isolated parallel workspace for a task claim.
+     */
+    spawnParallelWorkspace(request: AllocateWorkspaceRequest): Promise<AllocateWorkspaceResult>;
+    /**
+     * Attempt integration with automatic serialization fallback on conflict.
+     */
+    integrateWithSerializationFallback(request: IntegrationRequest, repoPath?: string): Promise<IntegrationResult>;
+    /**
+     * Safe cleanup of completed workspace.
+     */
+    cleanup(workspaceId: string, repoPath?: string): Promise<boolean>;
+}
+//# sourceMappingURL=parallel-orchestrator.d.ts.map

package/dist/execution/parallel-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-orchestrator.d.ts","sourceRoot":"","sources":["../../src/execution/parallel-orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAI1F,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;gBAExC,OAAO,EAAE,2BAA2B;IAMhD;;OAEG;IACU,sBAAsB,CACjC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAInC;;OAEG;IACU,kCAAkC,CAC7C,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAgC7B;;OAEG;IACU,OAAO,CAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC;CAGpB"}

package/dist/execution/parallel-orchestrator.js

@@ -0,0 +1,62 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+/**
+ * Parallel Execution Orchestrator.
+ * Coordinates multi-agent parallel workspaces and handles deterministic
+ * serialization fallback when conflicts are detected.
+ * PRD Part 2 Section 52, Section 55.
+ */
+export class ParallelOrchestrator {
+    workspaceManager;
+    workspaceIntegrator;
+    workspaceRepo;
+    constructor(options) {
+        this.workspaceManager = options.workspaceManager;
+        this.workspaceIntegrator = options.workspaceIntegrator;
+        this.workspaceRepo = options.workspaceRepo;
+    }
+    /**
+     * Spawn an isolated parallel workspace for a task claim.
+     */
+    async spawnParallelWorkspace(request) {
+        return this.workspaceManager.allocateWorkspace(request);
+    }
+    /**
+     * Attempt integration with automatic serialization fallback on conflict.
+     */
+    async integrateWithSerializationFallback(request, repoPath = process.cwd()) {
+        // 1. Initial Integration Attempt
+        const result = await this.workspaceIntegrator.integrate(request, repoPath);
+        // If clean or fatal non-conflict failure, return directly
+        if (result.success || result.status !== "CONFLICT_REJECTED") {
+            return result;
+        }
+        // 2. Serialization Fallback: Rebase workspace onto current target branch
+        const ws = this.workspaceRepo.findById(request.workspaceId);
+        if (!ws)
+            return result;
+        try {
+            // Rebase worktree branch on updated target commit
+            const { stdout: targetHeadOut } = await execAsync("git rev-parse HEAD", { cwd: repoPath });
+            const targetHead = targetHeadOut.trim();
+            await execAsync(`git rebase "${targetHead}"`, { cwd: ws.worktreePath });
+            // Update workspace base commit
+            ws.baseCommit = targetHead;
+            this.workspaceRepo.save(ws);
+            // 3. Retry integration after rebase
+            return await this.workspaceIntegrator.integrate(request, repoPath);
+        }
+        catch {
+            // If rebase fails or conflicts persist, fail closed
+            return result;
+        }
+    }
+    /**
+     * Safe cleanup of completed workspace.
+     */
+    async cleanup(workspaceId, repoPath = process.cwd()) {
+        return this.workspaceManager.cleanupWorkspace(workspaceId, repoPath);
+    }
+}
+//# sourceMappingURL=parallel-orchestrator.js.map

package/dist/execution/parallel-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-orchestrator.js","sourceRoot":"","sources":["../../src/execution/parallel-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAStC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAQlC;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACd,gBAAgB,CAAmB;IACnC,mBAAmB,CAAsB;IACzC,aAAa,CAAsB;IAEpD,YAAY,OAAoC;QAC9C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACvD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,sBAAsB,CACjC,OAAiC;QAEjC,OAAO,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,kCAAkC,CAC7C,OAA2B,EAC3B,WAAmB,OAAO,CAAC,GAAG,EAAE;QAEhC,iCAAiC;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE3E,0DAA0D;QAC1D,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;YAC5D,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,yEAAyE;QACzE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAEvB,IAAI,CAAC;YACH,kDAAkD;YAClD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3F,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;YAExC,MAAM,SAAS,CAAC,eAAe,UAAU,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;YAExE,+BAA+B;YAC/B,EAAE,CAAC,UAAU,GAAG,UAAU,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAE5B,oCAAoC;YACpC,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;YACpD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAClB,WAAmB,EACnB,WAAmB,OAAO,CAAC,GAAG,EAAE;QAEhC,OAAO,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/execution/process-supervisor.d.ts

@@ -0,0 +1,28 @@
+import { type ProcessLifecycleState, type ExecutionRequest } from "../domain/execution.js";
+import { type EventStore } from "../event-state/event-store.js";
+export interface ActiveExecutionHandle {
+    executionId: string;
+    state: ProcessLifecycleState;
+    request: ExecutionRequest;
+    startTime: number;
+    pid?: number;
+    abortController: AbortController;
+    timeoutId?: NodeJS.Timeout;
+}
+export declare class ProcessSupervisor {
+    private readonly activeHandles;
+    private readonly eventStore?;
+    constructor(options?: {
+        eventStore?: EventStore;
+    });
+    register(request: ExecutionRequest): ActiveExecutionHandle;
+    transition(executionId: string, nextState: ProcessLifecycleState, meta?: Record<string, unknown>): void;
+    setPid(executionId: string, pid: number): void;
+    setTimeout(executionId: string, timeoutId: NodeJS.Timeout): void;
+    getHandle(executionId: string): ActiveExecutionHandle | undefined;
+    cancel(executionId: string, reason?: string): Promise<boolean>;
+    cleanup(executionId: string): void;
+    listActive(): ActiveExecutionHandle[];
+    private validateTransition;
+}
+//# sourceMappingURL=process-supervisor.d.ts.map

package/dist/execution/process-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-supervisor.d.ts","sourceRoot":"","sources":["../../src/execution/process-supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIhE,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CAC5B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAA;KAAO;IAI9C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,qBAAqB;IAkB1D,UAAU,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,qBAAqB,EAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IA4BA,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAO9C,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IAOhE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI3D,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,SAAkC,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB7F,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQlC,UAAU,IAAI,qBAAqB,EAAE;IAI5C,OAAO,CAAC,kBAAkB;CAuB3B"}