@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/workflow-graph.js

@@ -0,0 +1,200 @@
+// @ts-nocheck
+import { isDynamicParallelStep, isParallelStep } from "../../shared/settings.js";
+function normalizeStatus(status) {
+    switch (status) {
+        case "complete":
+        case "completed":
+            return "completed";
+        case "running":
+            return "running";
+        case "failed":
+            return "failed";
+        case "paused":
+            return "paused";
+        case "detached":
+            return "detached";
+        case "pending":
+            return "pending";
+        default:
+            return undefined;
+    }
+}
+function resultStatus(result) {
+    if (!result)
+        return undefined;
+    if (result.detached)
+        return "detached";
+    if (result.interrupted)
+        return "paused";
+    return result.exitCode === 0 ? "completed" : "failed";
+}
+function nodeStatus(input, flatIndex) {
+    return normalizeStatus(input.stepStatuses?.[flatIndex]?.status)
+        ?? resultStatus(input.results?.[flatIndex])
+        ?? (input.currentFlatIndex === flatIndex ? "running" : "pending");
+}
+function pushPhase(phases, phase, nodeId) {
+    if (!phase)
+        return;
+    let group = phases.find((candidate) => candidate.title === phase);
+    if (!group) {
+        group = { title: phase, nodeIds: [] };
+        phases.push(group);
+    }
+    group.nodeIds.push(nodeId);
+}
+function seqLabel(step, stepIndex) {
+    return step.label?.trim() || step.agent || `Step ${stepIndex + 1}`;
+}
+function summarizeParallelStatuses(statuses) {
+    if (statuses.some((status) => status === "running"))
+        return "running";
+    if (statuses.some((status) => status === "failed"))
+        return "failed";
+    if (statuses.some((status) => status === "paused"))
+        return "paused";
+    if (statuses.some((status) => status === "detached"))
+        return "detached";
+    if (statuses.length > 0 && statuses.every((status) => status === "completed"))
+        return "completed";
+    if (statuses.some((status) => status === "completed"))
+        return "running";
+    return "pending";
+}
+export function buildWorkflowGraphSnapshot(input) {
+    const nodes = [];
+    const phases = [];
+    let flatIndex = 0;
+    let currentNodeId;
+    for (let stepIndex = 0; stepIndex < input.steps.length; stepIndex++) {
+        const step = input.steps[stepIndex];
+        if (isParallelStep(step)) {
+            const groupId = `step-${stepIndex}`;
+            const children = [];
+            const childStatuses = [];
+            for (let taskIndex = 0; taskIndex < step.parallel.length; taskIndex++) {
+                const task = step.parallel[taskIndex];
+                const status = nodeStatus(input, flatIndex);
+                childStatuses.push(status);
+                const childId = `step-${stepIndex}-agent-${taskIndex}`;
+                const child = {
+                    id: childId,
+                    kind: "agent",
+                    agent: task.agent,
+                    phase: task.phase,
+                    label: task.label?.trim() || task.agent || `Agent ${taskIndex + 1}`,
+                    status,
+                    flatIndex,
+                    stepIndex,
+                    outputName: task.as,
+                    structured: Boolean(task.outputSchema),
+                    acceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,
+                    error: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,
+                };
+                children.push(child);
+                pushPhase(phases, task.phase, childId);
+                if (status === "running" || input.currentFlatIndex === flatIndex)
+                    currentNodeId = childId;
+                flatIndex++;
+            }
+            const groupStatus = summarizeParallelStatuses(childStatuses);
+            if (input.currentStepIndex === stepIndex && !currentNodeId)
+                currentNodeId = groupId;
+            nodes.push({
+                id: groupId,
+                kind: "parallel-group",
+                label: step.parallel.length === 1 ? "Parallel task" : `Parallel group (${step.parallel.length})`,
+                status: groupStatus,
+                stepIndex,
+                children,
+            });
+            continue;
+        }
+        if (isDynamicParallelStep(step)) {
+            const groupId = `step-${stepIndex}`;
+            const materialized = input.dynamicChildren?.[stepIndex] ?? [];
+            const groupOverride = input.dynamicGroupStatuses?.[stepIndex];
+            const children = [];
+            const childStatuses = [];
+            for (let taskIndex = 0; taskIndex < materialized.length; taskIndex++) {
+                const task = materialized[taskIndex];
+                const status = nodeStatus(input, task.flatIndex);
+                childStatuses.push(status);
+                const childId = `step-${stepIndex}-item-${task.itemKey.replace(/[^a-zA-Z0-9_-]/g, "-")}`;
+                const child = {
+                    id: childId,
+                    kind: "agent",
+                    agent: task.agent,
+                    phase: step.parallel.phase ?? step.phase,
+                    label: task.label?.trim() || step.parallel.label?.trim() || `${task.agent} ${task.itemKey}`,
+                    status,
+                    flatIndex: task.flatIndex,
+                    stepIndex,
+                    itemKey: task.itemKey,
+                    outputName: task.outputName,
+                    structured: task.structured,
+                    acceptanceStatus: input.results?.[task.flatIndex]?.acceptance?.status,
+                    error: input.stepStatuses?.[task.flatIndex]?.error ?? input.results?.[task.flatIndex]?.error ?? task.error,
+                };
+                children.push(child);
+                pushPhase(phases, child.phase, childId);
+                if (status === "running" || input.currentFlatIndex === task.flatIndex)
+                    currentNodeId = childId;
+            }
+            const groupStatus = groupOverride?.status ?? (children.length > 0 ? summarizeParallelStatuses(childStatuses) : (input.currentStepIndex === stepIndex ? "running" : "pending"));
+            if (input.currentStepIndex === stepIndex && !currentNodeId)
+                currentNodeId = groupId;
+            nodes.push({
+                id: groupId,
+                kind: "dynamic-parallel-group",
+                label: step.label?.trim() || step.parallel.label?.trim() || `Dynamic fanout (${step.collect.as})`,
+                status: groupStatus,
+                stepIndex,
+                outputName: step.collect.as,
+                structured: Boolean(step.collect.outputSchema),
+                acceptanceStatus: groupOverride?.acceptance?.status,
+                error: groupOverride?.error,
+                dynamic: {
+                    sourceOutput: step.expand.from.output,
+                    sourcePath: step.expand.from.path,
+                    itemName: step.expand.item ?? "item",
+                    maxItems: step.expand.maxItems,
+                    collectAs: step.collect.as,
+                },
+                children,
+            });
+            if (materialized.length > 0)
+                flatIndex = Math.max(flatIndex, ...materialized.map((child) => child.flatIndex + 1));
+            continue;
+        }
+        const seq = step;
+        const status = nodeStatus(input, flatIndex);
+        const id = `step-${stepIndex}`;
+        nodes.push({
+            id,
+            kind: "step",
+            agent: seq.agent,
+            phase: seq.phase,
+            label: seqLabel(seq, stepIndex),
+            status,
+            flatIndex,
+            stepIndex,
+            outputName: seq.as,
+            structured: Boolean(seq.outputSchema),
+            acceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,
+            error: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,
+        });
+        pushPhase(phases, seq.phase, id);
+        if (status === "running" || input.currentFlatIndex === flatIndex || input.currentStepIndex === stepIndex)
+            currentNodeId = id;
+        flatIndex++;
+    }
+    return {
+        runId: input.runId,
+        mode: input.mode ?? "chain",
+        phases,
+        nodes,
+        currentNodeId,
+    };
+}
+//# sourceMappingURL=workflow-graph.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/workflow-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-graph.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/workflow-graph.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { isDynamicParallelStep, isParallelStep, type ChainStep, type SequentialStep } from \"../../shared/settings.ts\";\nimport type { SingleResult, SubagentRunMode, WorkflowGraphNode, WorkflowGraphSnapshot, WorkflowNodeStatus } from \"../../shared/types.ts\";\n\nexport interface WorkflowGraphBuildInput {\n\trunId: string;\n\tmode?: SubagentRunMode;\n\tsteps: ChainStep[];\n\tresults?: Array<Pick<SingleResult, \"exitCode\" | \"detached\" | \"interrupted\" | \"error\" | \"acceptance\">>;\n\tcurrentFlatIndex?: number;\n\tcurrentStepIndex?: number;\n\tstepStatuses?: Array<{ status?: string; error?: string }>;\n\tdynamicChildren?: Record<number, Array<{ agent: string; label?: string; flatIndex: number; itemKey: string; outputName?: string; structured?: boolean; error?: string }>>;\n\tdynamicGroupStatuses?: Record<number, { status: WorkflowNodeStatus; error?: string; acceptance?: SingleResult[\"acceptance\"] }>;\n}\n\nfunction normalizeStatus(status: string | undefined): WorkflowNodeStatus | undefined {\n\tswitch (status) {\n\t\tcase \"complete\":\n\t\tcase \"completed\":\n\t\t\treturn \"completed\";\n\t\tcase \"running\":\n\t\t\treturn \"running\";\n\t\tcase \"failed\":\n\t\t\treturn \"failed\";\n\t\tcase \"paused\":\n\t\t\treturn \"paused\";\n\t\tcase \"detached\":\n\t\t\treturn \"detached\";\n\t\tcase \"pending\":\n\t\t\treturn \"pending\";\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n}\n\nfunction resultStatus(result: Pick<SingleResult, \"exitCode\" | \"detached\" | \"interrupted\"> | undefined): WorkflowNodeStatus | undefined {\n\tif (!result) return undefined;\n\tif (result.detached) return \"detached\";\n\tif (result.interrupted) return \"paused\";\n\treturn result.exitCode === 0 ? \"completed\" : \"failed\";\n}\n\nfunction nodeStatus(input: WorkflowGraphBuildInput, flatIndex: number): WorkflowNodeStatus {\n\treturn normalizeStatus(input.stepStatuses?.[flatIndex]?.status)\n\t\t?? resultStatus(input.results?.[flatIndex])\n\t\t?? (input.currentFlatIndex === flatIndex ? \"running\" : \"pending\");\n}\n\nfunction pushPhase(phases: WorkflowGraphSnapshot[\"phases\"], phase: string | undefined, nodeId: string): void {\n\tif (!phase) return;\n\tlet group = phases.find((candidate) => candidate.title === phase);\n\tif (!group) {\n\t\tgroup = { title: phase, nodeIds: [] };\n\t\tphases.push(group);\n\t}\n\tgroup.nodeIds.push(nodeId);\n}\n\nfunction seqLabel(step: SequentialStep, stepIndex: number): string {\n\treturn step.label?.trim() || step.agent || `Step ${stepIndex + 1}`;\n}\n\nfunction summarizeParallelStatuses(statuses: WorkflowNodeStatus[]): WorkflowNodeStatus {\n\tif (statuses.some((status) => status === \"running\")) return \"running\";\n\tif (statuses.some((status) => status === \"failed\")) return \"failed\";\n\tif (statuses.some((status) => status === \"paused\")) return \"paused\";\n\tif (statuses.some((status) => status === \"detached\")) return \"detached\";\n\tif (statuses.length > 0 && statuses.every((status) => status === \"completed\")) return \"completed\";\n\tif (statuses.some((status) => status === \"completed\")) return \"running\";\n\treturn \"pending\";\n}\n\nexport function buildWorkflowGraphSnapshot(input: WorkflowGraphBuildInput): WorkflowGraphSnapshot {\n\tconst nodes: WorkflowGraphNode[] = [];\n\tconst phases: WorkflowGraphSnapshot[\"phases\"] = [];\n\tlet flatIndex = 0;\n\tlet currentNodeId: string | undefined;\n\n\tfor (let stepIndex = 0; stepIndex < input.steps.length; stepIndex++) {\n\t\tconst step = input.steps[stepIndex]!;\n\t\tif (isParallelStep(step)) {\n\t\t\tconst groupId = `step-${stepIndex}`;\n\t\t\tconst children: WorkflowGraphNode[] = [];\n\t\t\tconst childStatuses: WorkflowNodeStatus[] = [];\n\t\t\tfor (let taskIndex = 0; taskIndex < step.parallel.length; taskIndex++) {\n\t\t\t\tconst task = step.parallel[taskIndex]!;\n\t\t\t\tconst status = nodeStatus(input, flatIndex);\n\t\t\t\tchildStatuses.push(status);\n\t\t\t\tconst childId = `step-${stepIndex}-agent-${taskIndex}`;\n\t\t\t\tconst child: WorkflowGraphNode = {\n\t\t\t\t\tid: childId,\n\t\t\t\t\tkind: \"agent\",\n\t\t\t\t\tagent: task.agent,\n\t\t\t\t\tphase: task.phase,\n\t\t\t\t\tlabel: task.label?.trim() || task.agent || `Agent ${taskIndex + 1}`,\n\t\t\t\t\tstatus,\n\t\t\t\t\tflatIndex,\n\t\t\t\t\tstepIndex,\n\t\t\t\t\toutputName: task.as,\n\t\t\t\t\tstructured: Boolean(task.outputSchema),\n\t\t\t\t\tacceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,\n\t\t\t\t\terror: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,\n\t\t\t\t};\n\t\t\t\tchildren.push(child);\n\t\t\t\tpushPhase(phases, task.phase, childId);\n\t\t\t\tif (status === \"running\" || input.currentFlatIndex === flatIndex) currentNodeId = childId;\n\t\t\t\tflatIndex++;\n\t\t\t}\n\t\t\tconst groupStatus = summarizeParallelStatuses(childStatuses);\n\t\t\tif (input.currentStepIndex === stepIndex && !currentNodeId) currentNodeId = groupId;\n\t\t\tnodes.push({\n\t\t\t\tid: groupId,\n\t\t\t\tkind: \"parallel-group\",\n\t\t\t\tlabel: step.parallel.length === 1 ? \"Parallel task\" : `Parallel group (${step.parallel.length})`,\n\t\t\t\tstatus: groupStatus,\n\t\t\t\tstepIndex,\n\t\t\t\tchildren,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (isDynamicParallelStep(step)) {\n\t\t\tconst groupId = `step-${stepIndex}`;\n\t\t\tconst materialized = input.dynamicChildren?.[stepIndex] ?? [];\n\t\t\tconst groupOverride = input.dynamicGroupStatuses?.[stepIndex];\n\t\t\tconst children: WorkflowGraphNode[] = [];\n\t\t\tconst childStatuses: WorkflowNodeStatus[] = [];\n\t\t\tfor (let taskIndex = 0; taskIndex < materialized.length; taskIndex++) {\n\t\t\t\tconst task = materialized[taskIndex]!;\n\t\t\t\tconst status = nodeStatus(input, task.flatIndex);\n\t\t\t\tchildStatuses.push(status);\n\t\t\t\tconst childId = `step-${stepIndex}-item-${task.itemKey.replace(/[^a-zA-Z0-9_-]/g, \"-\")}`;\n\t\t\t\tconst child: WorkflowGraphNode = {\n\t\t\t\t\tid: childId,\n\t\t\t\t\tkind: \"agent\",\n\t\t\t\t\tagent: task.agent,\n\t\t\t\t\tphase: step.parallel.phase ?? step.phase,\n\t\t\t\t\tlabel: task.label?.trim() || step.parallel.label?.trim() || `${task.agent} ${task.itemKey}`,\n\t\t\t\t\tstatus,\n\t\t\t\t\tflatIndex: task.flatIndex,\n\t\t\t\t\tstepIndex,\n\t\t\t\t\titemKey: task.itemKey,\n\t\t\t\t\toutputName: task.outputName,\n\t\t\t\t\tstructured: task.structured,\n\t\t\t\t\tacceptanceStatus: input.results?.[task.flatIndex]?.acceptance?.status,\n\t\t\t\t\terror: input.stepStatuses?.[task.flatIndex]?.error ?? input.results?.[task.flatIndex]?.error ?? task.error,\n\t\t\t\t};\n\t\t\t\tchildren.push(child);\n\t\t\t\tpushPhase(phases, child.phase, childId);\n\t\t\t\tif (status === \"running\" || input.currentFlatIndex === task.flatIndex) currentNodeId = childId;\n\t\t\t}\n\t\t\tconst groupStatus = groupOverride?.status ?? (children.length > 0 ? summarizeParallelStatuses(childStatuses) : (input.currentStepIndex === stepIndex ? \"running\" : \"pending\"));\n\t\t\tif (input.currentStepIndex === stepIndex && !currentNodeId) currentNodeId = groupId;\n\t\t\tnodes.push({\n\t\t\t\tid: groupId,\n\t\t\t\tkind: \"dynamic-parallel-group\",\n\t\t\t\tlabel: step.label?.trim() || step.parallel.label?.trim() || `Dynamic fanout (${step.collect.as})`,\n\t\t\t\tstatus: groupStatus,\n\t\t\t\tstepIndex,\n\t\t\t\toutputName: step.collect.as,\n\t\t\t\tstructured: Boolean(step.collect.outputSchema),\n\t\t\t\tacceptanceStatus: groupOverride?.acceptance?.status,\n\t\t\t\terror: groupOverride?.error,\n\t\t\t\tdynamic: {\n\t\t\t\t\tsourceOutput: step.expand.from.output,\n\t\t\t\t\tsourcePath: step.expand.from.path,\n\t\t\t\t\titemName: step.expand.item ?? \"item\",\n\t\t\t\t\tmaxItems: step.expand.maxItems,\n\t\t\t\t\tcollectAs: step.collect.as,\n\t\t\t\t},\n\t\t\t\tchildren,\n\t\t\t});\n\t\t\tif (materialized.length > 0) flatIndex = Math.max(flatIndex, ...materialized.map((child) => child.flatIndex + 1));\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst seq = step as SequentialStep;\n\t\tconst status = nodeStatus(input, flatIndex);\n\t\tconst id = `step-${stepIndex}`;\n\t\tnodes.push({\n\t\t\tid,\n\t\t\tkind: \"step\",\n\t\t\tagent: seq.agent,\n\t\t\tphase: seq.phase,\n\t\t\tlabel: seqLabel(seq, stepIndex),\n\t\t\tstatus,\n\t\t\tflatIndex,\n\t\t\tstepIndex,\n\t\t\toutputName: seq.as,\n\t\t\tstructured: Boolean(seq.outputSchema),\n\t\t\tacceptanceStatus: input.results?.[flatIndex]?.acceptance?.status,\n\t\t\terror: input.stepStatuses?.[flatIndex]?.error ?? input.results?.[flatIndex]?.error,\n\t\t});\n\t\tpushPhase(phases, seq.phase, id);\n\t\tif (status === \"running\" || input.currentFlatIndex === flatIndex || input.currentStepIndex === stepIndex) currentNodeId = id;\n\t\tflatIndex++;\n\t}\n\n\treturn {\n\t\trunId: input.runId,\n\t\tmode: input.mode ?? \"chain\",\n\t\tphases,\n\t\tnodes,\n\t\tcurrentNodeId,\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/worktree.d.ts

@@ -0,0 +1,49 @@
+export interface WorktreeSetup {
+    cwd: string;
+    worktrees: WorktreeInfo[];
+    baseCommit: string;
+}
+interface WorktreeInfo {
+    path: string;
+    agentCwd: string;
+    branch: string;
+    index: number;
+    nodeModulesLinked: boolean;
+    syntheticPaths: string[];
+}
+interface WorktreeDiff {
+    index: number;
+    agent: string;
+    branch: string;
+    diffStat: string;
+    filesChanged: number;
+    insertions: number;
+    deletions: number;
+    patchPath: string;
+}
+interface WorktreeTaskCwdConflict {
+    index: number;
+    agent: string;
+    cwd: string;
+}
+interface WorktreeSetupHookConfig {
+    hookPath: string;
+    timeoutMs?: number;
+}
+interface CreateWorktreesOptions {
+    agents?: string[];
+    setupHook?: WorktreeSetupHookConfig;
+    baseDir?: string;
+}
+export declare function findWorktreeTaskCwdConflict(tasks: ReadonlyArray<{
+    agent: string;
+    cwd?: string;
+}>, sharedCwd: string): WorktreeTaskCwdConflict | undefined;
+export declare function formatWorktreeTaskCwdConflict(conflict: WorktreeTaskCwdConflict, sharedCwd: string): string;
+export declare function resolveExpectedWorktreeAgentCwd(cwd: string, runId: string, index: number, baseDir?: string): string;
+export declare function createWorktrees(cwd: string, runId: string, count: number, options?: CreateWorktreesOptions): WorktreeSetup;
+export declare function diffWorktrees(setup: WorktreeSetup, agents: string[], diffsDir: string): WorktreeDiff[];
+export declare function cleanupWorktrees(setup: WorktreeSetup): void;
+export declare function formatWorktreeDiffSummary(diffs: WorktreeDiff[]): string;
+export {};
+//# sourceMappingURL=worktree.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/worktree.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,YAAY;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,uBAAuB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,uBAAuB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AA+ED,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,SAAS,EAAE,MAAM,GACf,uBAAuB,GAAG,SAAS,CAUrC;AAED,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,uBAAuB,EACjC,SAAS,EAAE,MAAM,GACf,MAAM,CAER;AA4CD,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAKnH;AA8TD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAiC1H;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAuBtG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAO3D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAkBvE","sourcesContent":["// @ts-nocheck\nimport { spawnSync } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\n\nexport interface WorktreeSetup {\n\tcwd: string;\n\tworktrees: WorktreeInfo[];\n\tbaseCommit: string;\n}\n\ninterface WorktreeInfo {\n\tpath: string;\n\tagentCwd: string;\n\tbranch: string;\n\tindex: number;\n\tnodeModulesLinked: boolean;\n\tsyntheticPaths: string[];\n}\n\ninterface WorktreeDiff {\n\tindex: number;\n\tagent: string;\n\tbranch: string;\n\tdiffStat: string;\n\tfilesChanged: number;\n\tinsertions: number;\n\tdeletions: number;\n\tpatchPath: string;\n}\n\ninterface WorktreeTaskCwdConflict {\n\tindex: number;\n\tagent: string;\n\tcwd: string;\n}\n\ninterface WorktreeSetupHookConfig {\n\thookPath: string;\n\ttimeoutMs?: number;\n}\n\ninterface CreateWorktreesOptions {\n\tagents?: string[];\n\tsetupHook?: WorktreeSetupHookConfig;\n\tbaseDir?: string;\n}\n\ninterface ResolvedWorktreeSetupHook {\n\thookPath: string;\n\ttimeoutMs: number;\n}\n\ninterface WorktreeSetupHookInput {\n\tversion: 1;\n\trepoRoot: string;\n\tworktreePath: string;\n\tagentCwd: string;\n\tbranch: string;\n\tindex: number;\n\trunId: string;\n\tbaseCommit: string;\n\tagent?: string;\n}\n\ninterface WorktreeSetupHookOutput {\n\tsyntheticPaths?: string[];\n}\n\ninterface GitResult {\n\tstdout: string;\n\tstderr: string;\n\tstatus: number | null;\n}\n\ninterface RepoState {\n\ttoplevel: string;\n\tcwdRelative: string;\n\tbaseCommit: string;\n}\n\nconst DEFAULT_WORKTREE_SETUP_HOOK_TIMEOUT_MS = 30000;\n\nfunction runGit(cwd: string, args: string[]): GitResult {\n\tconst result = spawnSync(\"git\", [\"-C\", cwd, ...args], { encoding: \"utf-8\" });\n\treturn {\n\t\tstdout: result.stdout ?? \"\",\n\t\tstderr: result.stderr ?? \"\",\n\t\tstatus: result.status,\n\t};\n}\n\nfunction runGitChecked(cwd: string, args: string[]): string {\n\tconst result = runGit(cwd, args);\n\tif (result.status !== 0) {\n\t\tconst command = `git -C ${cwd} ${args.join(\" \")}`;\n\t\tconst message = result.stderr.trim() || result.stdout.trim() || `${command} failed`;\n\t\tthrow new Error(message);\n\t}\n\treturn result.stdout;\n}\n\nfunction resolveRepoState(cwd: string): RepoState {\n\tconst cwdRelative = resolveRepoCwdRelative(cwd);\n\tconst toplevel = runGitChecked(cwd, [\"rev-parse\", \"--show-toplevel\"]).trim();\n\n\tconst status = runGitChecked(toplevel, [\"status\", \"--porcelain\"]);\n\tif (status.trim().length > 0) {\n\t\tthrow new Error(\"worktree isolation requires a clean git working tree. Commit or stash changes first.\");\n\t}\n\n\tconst baseCommit = runGitChecked(toplevel, [\"rev-parse\", \"HEAD\"]).trim();\n\treturn { toplevel, cwdRelative, baseCommit };\n}\n\nfunction normalizeComparableCwd(cwd: string): string {\n\tconst resolved = path.resolve(cwd);\n\ttry {\n\t\treturn fs.realpathSync(resolved);\n\t} catch {\n\t\t// Use the unresolved absolute path when realpath resolution is unavailable.\n\t\treturn resolved;\n\t}\n}\n\nexport function findWorktreeTaskCwdConflict(\n\ttasks: ReadonlyArray<{ agent: string; cwd?: string }>,\n\tsharedCwd: string,\n): WorktreeTaskCwdConflict | undefined {\n\tconst normalizedSharedCwd = normalizeComparableCwd(sharedCwd);\n\tfor (let index = 0; index < tasks.length; index++) {\n\t\tconst task = tasks[index]!;\n\t\tif (!task.cwd) continue;\n\t\tconst taskCwd = path.isAbsolute(task.cwd) ? task.cwd : path.resolve(sharedCwd, task.cwd);\n\t\tif (normalizeComparableCwd(taskCwd) === normalizedSharedCwd) continue;\n\t\treturn { index, agent: task.agent, cwd: task.cwd };\n\t}\n\treturn undefined;\n}\n\nexport function formatWorktreeTaskCwdConflict(\n\tconflict: WorktreeTaskCwdConflict,\n\tsharedCwd: string,\n): string {\n\treturn `worktree isolation uses the shared cwd (${sharedCwd}); task ${conflict.index + 1} (${conflict.agent}) sets cwd to ${conflict.cwd}. Remove task-level cwd overrides or disable worktree.`;\n}\n\nfunction safePatchAgentName(agent: string): string {\n\treturn agent.replace(/[^\\w.-]/g, \"_\");\n}\n\nfunction buildWorktreeBranch(runId: string, index: number): string {\n\treturn `pi-parallel-${runId}-${index}`;\n}\n\nfunction resolveWorktreeBaseDir(configuredBaseDir: string | undefined, repoRoot: string): string {\n\tconst rawBaseDir = configuredBaseDir ?? process.env.PI_SUBAGENTS_WORKTREE_DIR;\n\tif (rawBaseDir === undefined) return os.tmpdir();\n\n\tconst trimmed = rawBaseDir.trim();\n\tif (!trimmed) throw new Error(\"worktree base directory cannot be empty\");\n\n\tconst expanded = trimmed.startsWith(\"~/\") ? path.join(os.homedir(), trimmed.slice(2)) : trimmed;\n\tconst resolved = path.isAbsolute(expanded) ? expanded : path.resolve(repoRoot, expanded);\n\ttry {\n\t\tfs.mkdirSync(resolved, { recursive: true });\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`failed to create worktree base directory ${resolved}: ${message}`);\n\t}\n\treturn resolved;\n}\n\nfunction buildWorktreePath(baseDir: string, runId: string, index: number): string {\n\treturn path.join(baseDir, `pi-worktree-${runId}-${index}`);\n}\n\nfunction resolveRepoCwdRelative(cwd: string): string {\n\tconst repoCheck = runGit(cwd, [\"rev-parse\", \"--is-inside-work-tree\"]);\n\tif (repoCheck.status !== 0 || repoCheck.stdout.trim() !== \"true\") {\n\t\tthrow new Error(\"worktree isolation requires a git repository\");\n\t}\n\tconst rawPrefix = runGitChecked(cwd, [\"rev-parse\", \"--show-prefix\"]).trim();\n\tconst normalizedPrefix = rawPrefix\n\t\t? path.normalize(rawPrefix.replace(/[\\\\/]+$/, \"\"))\n\t\t: \"\";\n\treturn normalizedPrefix === \".\" ? \"\" : normalizedPrefix;\n}\n\nexport function resolveExpectedWorktreeAgentCwd(cwd: string, runId: string, index: number, baseDir?: string): string {\n\tconst cwdRelative = resolveRepoCwdRelative(cwd);\n\tconst repoRoot = runGitChecked(cwd, [\"rev-parse\", \"--show-toplevel\"]).trim();\n\tconst worktreePath = buildWorktreePath(resolveWorktreeBaseDir(baseDir, repoRoot), runId, index);\n\treturn cwdRelative ? path.join(worktreePath, cwdRelative) : worktreePath;\n}\n\nfunction linkNodeModulesIfPresent(toplevel: string, worktreePath: string): boolean {\n\tconst nodeModulesPath = path.join(toplevel, \"node_modules\");\n\tconst nodeModulesLinkPath = path.join(worktreePath, \"node_modules\");\n\tif (!fs.existsSync(nodeModulesPath) || fs.existsSync(nodeModulesLinkPath)) return false;\n\ttry {\n\t\tfs.symlinkSync(nodeModulesPath, nodeModulesLinkPath);\n\t\treturn true;\n\t} catch {\n\t\t// Symlink creation is optional (e.g., unsupported filesystems on CI runners).\n\t\treturn false;\n\t}\n}\n\nfunction parseHookTimeout(timeoutMs: number | undefined): number {\n\tif (timeoutMs === undefined) return DEFAULT_WORKTREE_SETUP_HOOK_TIMEOUT_MS;\n\tif (!Number.isInteger(timeoutMs) || timeoutMs <= 0) {\n\t\tthrow new Error(\"worktree setup hook timeout must be an integer greater than 0\");\n\t}\n\treturn timeoutMs;\n}\n\nfunction resolveWorktreeSetupHook(\n\trepoRoot: string,\n\tconfig: WorktreeSetupHookConfig | undefined,\n): ResolvedWorktreeSetupHook | undefined {\n\tif (!config) return undefined;\n\tconst hookPath = config.hookPath.trim();\n\tif (!hookPath) {\n\t\tthrow new Error(\"worktree setup hook path cannot be empty\");\n\t}\n\n\tconst expandedHookPath = hookPath.startsWith(\"~/\") ? path.join(os.homedir(), hookPath.slice(2)) : hookPath;\n\tlet resolvedPath: string;\n\tif (path.isAbsolute(expandedHookPath)) {\n\t\tresolvedPath = expandedHookPath;\n\t} else if (expandedHookPath.includes(\"/\") || expandedHookPath.includes(\"\\\\\")) {\n\t\tresolvedPath = path.resolve(repoRoot, expandedHookPath);\n\t} else {\n\t\tthrow new Error(\"worktree setup hook must be an absolute path or a repo-relative path\");\n\t}\n\n\tif (!fs.existsSync(resolvedPath)) {\n\t\tthrow new Error(`worktree setup hook not found: ${resolvedPath}`);\n\t}\n\tif (fs.statSync(resolvedPath).isDirectory()) {\n\t\tthrow new Error(`worktree setup hook must be a file, got directory: ${resolvedPath}`);\n\t}\n\n\treturn {\n\t\thookPath: resolvedPath,\n\t\ttimeoutMs: parseHookTimeout(config.timeoutMs),\n\t};\n}\n\nfunction normalizeSyntheticPath(worktreePath: string, rawPath: string): string {\n\tconst trimmed = rawPath.trim();\n\tif (!trimmed) throw new Error(\"synthetic path cannot be empty\");\n\tif (path.isAbsolute(trimmed)) throw new Error(`synthetic path must be relative: ${rawPath}`);\n\n\tconst resolved = path.resolve(worktreePath, trimmed);\n\tconst relative = path.relative(worktreePath, resolved);\n\tif (!relative || relative === \".\") {\n\t\tthrow new Error(`synthetic path cannot target the worktree root: ${rawPath}`);\n\t}\n\tif (relative === \"..\" || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {\n\t\tthrow new Error(`synthetic path escapes the worktree root: ${rawPath}`);\n\t}\n\treturn path.normalize(relative);\n}\n\nfunction hasTrackedEntries(worktreePath: string, relativePath: string): boolean {\n\tconst result = runGit(worktreePath, [\"ls-files\", \"--\", relativePath]);\n\treturn result.status === 0 && result.stdout.trim().length > 0;\n}\n\nfunction parseWorktreeSetupHookOutput(rawStdout: string): WorktreeSetupHookOutput {\n\tconst trimmed = rawStdout.trim();\n\tif (!trimmed) {\n\t\tthrow new Error(\"worktree setup hook returned empty stdout; expected JSON object\");\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(trimmed);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`worktree setup hook returned invalid JSON: ${message}`);\n\t}\n\tif (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n\t\tthrow new Error(\"worktree setup hook stdout must be a JSON object\");\n\t}\n\treturn parsed as WorktreeSetupHookOutput;\n}\n\nfunction runWorktreeSetupHook(\n\thook: ResolvedWorktreeSetupHook,\n\tinput: WorktreeSetupHookInput,\n): string[] {\n\tconst result = spawnSync(hook.hookPath, [], {\n\t\tcwd: input.worktreePath,\n\t\tencoding: \"utf-8\",\n\t\tinput: JSON.stringify(input),\n\t\ttimeout: hook.timeoutMs,\n\t\tshell: false,\n\t});\n\n\tif (result.error) {\n\t\tconst code = \"code\" in result.error ? result.error.code : undefined;\n\t\tif (code === \"ETIMEDOUT\") {\n\t\t\tthrow new Error(`worktree setup hook timed out after ${hook.timeoutMs}ms`);\n\t\t}\n\t\tthrow new Error(`worktree setup hook failed: ${result.error.message}`);\n\t}\n\n\tif (result.status !== 0) {\n\t\tconst details = result.stderr.trim() || result.stdout.trim() || \"no output\";\n\t\tthrow new Error(`worktree setup hook failed with exit code ${result.status}: ${details}`);\n\t}\n\n\tconst output = parseWorktreeSetupHookOutput(result.stdout);\n\tif (output.syntheticPaths === undefined) return [];\n\tif (!Array.isArray(output.syntheticPaths)) {\n\t\tthrow new Error(\"worktree setup hook output field 'syntheticPaths' must be an array of relative paths\");\n\t}\n\n\tconst uniquePaths = new Set<string>();\n\tfor (const candidate of output.syntheticPaths) {\n\t\tif (typeof candidate !== \"string\") {\n\t\t\tthrow new Error(\"worktree setup hook output field 'syntheticPaths' must contain only strings\");\n\t\t}\n\t\tconst normalizedPath = normalizeSyntheticPath(input.worktreePath, candidate);\n\t\tif (hasTrackedEntries(input.worktreePath, normalizedPath)) {\n\t\t\tthrow new Error(`worktree setup hook cannot mark tracked paths as synthetic: ${normalizedPath}`);\n\t\t}\n\t\tuniquePaths.add(normalizedPath);\n\t}\n\treturn [...uniquePaths];\n}\n\nfunction createSingleWorktree(\n\ttoplevel: string,\n\tcwdRelative: string,\n\trunId: string,\n\tindex: number,\n\tbaseCommit: string,\n\tsetupHook: ResolvedWorktreeSetupHook | undefined,\n\tagent: string | undefined,\n\tbaseDir: string,\n): WorktreeInfo {\n\tconst branch = buildWorktreeBranch(runId, index);\n\tconst worktreePath = buildWorktreePath(baseDir, runId, index);\n\tconst add = runGit(toplevel, [\"worktree\", \"add\", worktreePath, \"-b\", branch, \"HEAD\"]);\n\tif (add.status !== 0) {\n\t\tconst message = add.stderr.trim() || add.stdout.trim() || `failed to create worktree ${worktreePath}`;\n\t\tthrow new Error(message);\n\t}\n\n\tconst agentCwd = cwdRelative ? path.join(worktreePath, cwdRelative) : worktreePath;\n\ttry {\n\t\tconst nodeModulesLinked = linkNodeModulesIfPresent(toplevel, worktreePath);\n\t\tconst syntheticPaths = nodeModulesLinked ? [\"node_modules\"] : [];\n\n\t\tif (setupHook) {\n\t\t\tconst hookSyntheticPaths = runWorktreeSetupHook(setupHook, {\n\t\t\t\tversion: 1,\n\t\t\t\trepoRoot: toplevel,\n\t\t\t\tworktreePath,\n\t\t\t\tagentCwd,\n\t\t\t\tbranch,\n\t\t\t\tindex,\n\t\t\t\trunId,\n\t\t\t\tbaseCommit,\n\t\t\t\tagent,\n\t\t\t});\n\t\t\tsyntheticPaths.push(...hookSyntheticPaths);\n\t\t}\n\n\t\treturn {\n\t\t\tpath: worktreePath,\n\t\t\tagentCwd,\n\t\t\tbranch,\n\t\t\tindex,\n\t\t\tnodeModulesLinked,\n\t\t\tsyntheticPaths,\n\t\t};\n\t} catch (error) {\n\t\ttry { runGitChecked(toplevel, [\"worktree\", \"remove\", \"--force\", worktreePath]); } catch {\n\t\t\t// Best-effort rollback; preserve the original setup failure.\n\t\t}\n\t\ttry { runGitChecked(toplevel, [\"branch\", \"-D\", branch]); } catch {\n\t\t\t// Best-effort rollback; preserve the original setup failure.\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction removeSyntheticPath(worktree: WorktreeInfo, syntheticPath: string): void {\n\tconst resolved = path.resolve(worktree.path, syntheticPath);\n\tconst relative = path.relative(worktree.path, resolved);\n\tif (!relative || relative === \".\" || relative === \"..\" || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {\n\t\treturn;\n\t}\n\n\tlet stat: fs.Stats;\n\ttry {\n\t\tstat = fs.lstatSync(resolved);\n\t} catch (error) {\n\t\tconst code = error && typeof error === \"object\" && \"code\" in error ? (error as { code?: unknown }).code : undefined;\n\t\tif (code === \"ENOENT\") return;\n\t\tthrow error;\n\t}\n\n\tif (stat.isSymbolicLink()) {\n\t\tfs.unlinkSync(resolved);\n\t\treturn;\n\t}\n\tif (stat.isDirectory()) {\n\t\tfs.rmSync(resolved, { recursive: true, force: true });\n\t\treturn;\n\t}\n\tfs.rmSync(resolved, { force: true });\n}\n\nfunction removeSyntheticPathsBeforeDiff(worktree: WorktreeInfo): void {\n\tif (worktree.syntheticPaths.length === 0) return;\n\tconst seen = new Set<string>();\n\tfor (const syntheticPath of worktree.syntheticPaths) {\n\t\tif (seen.has(syntheticPath)) continue;\n\t\tseen.add(syntheticPath);\n\t\tremoveSyntheticPath(worktree, syntheticPath);\n\t}\n}\n\nfunction emptyDiff(index: number, agent: string, branch: string, patchPath: string): WorktreeDiff {\n\treturn {\n\t\tindex,\n\t\tagent,\n\t\tbranch,\n\t\tdiffStat: \"\",\n\t\tfilesChanged: 0,\n\t\tinsertions: 0,\n\t\tdeletions: 0,\n\t\tpatchPath,\n\t};\n}\n\nfunction parseNumstat(numstat: string): { filesChanged: number; insertions: number; deletions: number } {\n\tconst lines = numstat\n\t\t.split(\"\\n\")\n\t\t.map((line) => line.trim())\n\t\t.filter(Boolean);\n\tlet filesChanged = 0;\n\tlet insertions = 0;\n\tlet deletions = 0;\n\n\tfor (const line of lines) {\n\t\tconst [rawInsertions, rawDeletions] = line.split(\"\\t\");\n\t\tif (rawInsertions === undefined || rawDeletions === undefined) continue;\n\t\tfilesChanged++;\n\t\tif (/^\\d+$/.test(rawInsertions)) insertions += parseInt(rawInsertions, 10);\n\t\tif (/^\\d+$/.test(rawDeletions)) deletions += parseInt(rawDeletions, 10);\n\t}\n\n\treturn { filesChanged, insertions, deletions };\n}\n\nfunction captureWorktreeDiff(\n\tsetup: WorktreeSetup,\n\tworktree: WorktreeInfo,\n\tagent: string,\n\tpatchPath: string,\n): WorktreeDiff {\n\tremoveSyntheticPathsBeforeDiff(worktree);\n\trunGitChecked(worktree.path, [\"add\", \"-A\"]);\n\tconst diffStat = runGitChecked(worktree.path, [\"diff\", \"--cached\", \"--stat\", setup.baseCommit]).trim();\n\tconst patch = runGitChecked(worktree.path, [\"diff\", \"--cached\", setup.baseCommit]);\n\tconst numstat = runGitChecked(worktree.path, [\"diff\", \"--cached\", \"--numstat\", setup.baseCommit]);\n\tfs.writeFileSync(patchPath, patch, \"utf-8\");\n\n\tif (!patch.trim()) {\n\t\treturn emptyDiff(worktree.index, agent, worktree.branch, patchPath);\n\t}\n\n\tconst parsed = parseNumstat(numstat);\n\treturn {\n\t\tindex: worktree.index,\n\t\tagent,\n\t\tbranch: worktree.branch,\n\t\tdiffStat,\n\t\tfilesChanged: parsed.filesChanged,\n\t\tinsertions: parsed.insertions,\n\t\tdeletions: parsed.deletions,\n\t\tpatchPath,\n\t};\n}\n\nfunction writeEmptyPatch(patchPath: string): void {\n\ttry {\n\t\tfs.writeFileSync(patchPath, \"\", \"utf-8\");\n\t} catch {\n\t\t// Diff artifact writing is best-effort in error paths.\n\t}\n}\n\nfunction cleanupSingleWorktree(repoCwd: string, worktree: WorktreeInfo): void {\n\ttry { runGitChecked(repoCwd, [\"worktree\", \"remove\", \"--force\", worktree.path]); } catch {\n\t\t// Cleanup is best-effort to avoid masking caller errors.\n\t}\n\ttry { runGitChecked(repoCwd, [\"branch\", \"-D\", worktree.branch]); } catch {\n\t\t// Cleanup is best-effort to avoid masking caller errors.\n\t}\n}\n\nfunction hasWorktreeChanges(diff: WorktreeDiff): boolean {\n\treturn diff.filesChanged > 0 || diff.insertions > 0 || diff.deletions > 0 || diff.diffStat.trim().length > 0;\n}\n\nexport function createWorktrees(cwd: string, runId: string, count: number, options?: CreateWorktreesOptions): WorktreeSetup {\n\tconst repo = resolveRepoState(cwd);\n\tconst setupHook = resolveWorktreeSetupHook(repo.toplevel, options?.setupHook);\n\tconst baseDir = resolveWorktreeBaseDir(options?.baseDir, repo.toplevel);\n\tconst worktrees: WorktreeInfo[] = [];\n\n\ttry {\n\t\tfor (let index = 0; index < count; index++) {\n\t\t\tworktrees.push(createSingleWorktree(\n\t\t\t\trepo.toplevel,\n\t\t\t\trepo.cwdRelative,\n\t\t\t\trunId,\n\t\t\t\tindex,\n\t\t\t\trepo.baseCommit,\n\t\t\t\tsetupHook,\n\t\t\t\toptions?.agents?.[index],\n\t\t\t\tbaseDir,\n\t\t\t));\n\t\t}\n\t} catch (error) {\n\t\tcleanupWorktrees({\n\t\t\tcwd: repo.toplevel,\n\t\t\tworktrees,\n\t\t\tbaseCommit: repo.baseCommit,\n\t\t});\n\t\tthrow error;\n\t}\n\n\treturn {\n\t\tcwd: repo.toplevel,\n\t\tworktrees,\n\t\tbaseCommit: repo.baseCommit,\n\t};\n}\n\nexport function diffWorktrees(setup: WorktreeSetup, agents: string[], diffsDir: string): WorktreeDiff[] {\n\ttry {\n\t\tfs.mkdirSync(diffsDir, { recursive: true });\n\t} catch {\n\t\t// Returning no diffs is safer than failing the whole command on artifact-dir issues.\n\t\treturn [];\n\t}\n\n\tconst diffs: WorktreeDiff[] = [];\n\tfor (let index = 0; index < setup.worktrees.length; index++) {\n\t\tconst worktree = setup.worktrees[index]!;\n\t\tconst agent = agents[index] ?? `task-${index + 1}`;\n\t\tconst patchPath = path.join(diffsDir, `task-${index}-${safePatchAgentName(agent)}.patch`);\n\t\ttry {\n\t\t\tdiffs.push(captureWorktreeDiff(setup, worktree, agent, patchPath));\n\t\t} catch {\n\t\t\t// Preserve execution flow; failed diff capture maps to an empty per-task patch.\n\t\t\twriteEmptyPatch(patchPath);\n\t\t\tdiffs.push(emptyDiff(index, agent, worktree.branch, patchPath));\n\t\t}\n\t}\n\n\treturn diffs;\n}\n\nexport function cleanupWorktrees(setup: WorktreeSetup): void {\n\tfor (let index = setup.worktrees.length - 1; index >= 0; index--) {\n\t\tcleanupSingleWorktree(setup.cwd, setup.worktrees[index]!);\n\t}\n\ttry { runGitChecked(setup.cwd, [\"worktree\", \"prune\"]); } catch {\n\t\t// Pruning is best-effort cleanup.\n\t}\n}\n\nexport function formatWorktreeDiffSummary(diffs: WorktreeDiff[]): string {\n\tconst changed = diffs.filter(hasWorktreeChanges);\n\tif (changed.length === 0) return \"\";\n\n\tconst lines: string[] = [\"=== Worktree Changes ===\", \"\"];\n\tfor (const diff of changed) {\n\t\tlines.push(\n\t\t\t`--- Task ${diff.index + 1} (${diff.agent}): ${diff.filesChanged} files changed, +${diff.insertions} -${diff.deletions} ---`,\n\t\t);\n\t\tif (diff.diffStat.trim().length > 0) {\n\t\t\tlines.push(diff.diffStat);\n\t\t}\n\t\tlines.push(\"\");\n\t}\n\n\tconst patchesDir = path.dirname(changed[0]!.patchPath);\n\tlines.push(`Full patches: ${patchesDir}`);\n\treturn lines.join(\"\\n\").trimEnd();\n}\n"]}