macro-agent 0.2.4 → 0.2.6

package/dist/lifecycle/handlers/integrator.js

@@ -0,0 +1,451 @@
+/**
+ * Integrator Done Handler
+ *
+ * Handles done() for integrator agents:
+ * - Checks merge queue status for the stream
+ * - Processes any pending merge requests before termination
+ * - Emits INTEGRATOR_DONE signal to coordinator
+ *
+ * @module lifecycle/handlers/integrator
+ * @see s-32xs Self-Cleaning Workers spec
+ * @see s-bcqm Change Management spec
+ */
+import { execSync } from "child_process";
+import { attemptMerge, abortMerge, getCurrentBranch } from "../cleanup.js";
+// =============================================================================
+// Merge Queue Helpers
+// =============================================================================
+/**
+ * Check if merge queue is empty for a stream
+ */
+function isMergeQueueEmpty(streamId, mergeQueue) {
+    if (!mergeQueue || !streamId) {
+        // No queue or no stream - treat as empty
+        return true;
+    }
+    return mergeQueue.getQueueDepth(streamId) === 0;
+}
+/**
+ * Get the number of pending merge requests for a stream
+ */
+function getPendingCount(streamId, mergeQueue) {
+    if (!mergeQueue || !streamId) {
+        return 0;
+    }
+    return mergeQueue.getQueueDepth(streamId);
+}
+/**
+ * Spawn a resolver worker to handle merge conflicts.
+ *
+ * @param mr - The merge request with conflicts
+ * @param conflictFiles - List of files with conflicts
+ * @param context - Lifecycle context
+ * @param deps - Handler dependencies
+ * @returns PendingResolver info or null if spawn failed
+ */
+async function spawnResolverWorker(mr, conflictFiles, context, deps) {
+    if (!deps.agentManager) {
+        console.warn("[Integrator] Cannot spawn resolver: no agentManager available");
+        return null;
+    }
+    const timestamp = Date.now();
+    const resolverBranch = `resolver/${mr.id}@${timestamp}`;
+    // Build task description with conflict context
+    const taskDescription = `
+Resolve merge conflict for MR ${mr.id}.
+
+**Original worker branch**: ${mr.workerBranch}
+**Worker agent**: ${mr.workerAgentId}
+**Task ID**: ${mr.taskId}
+
+**Conflicting files**:
+${conflictFiles.map((f) => `- ${f}`).join("\n")}
+
+**Your task**:
+1. The baseline has been updated since the original work was done
+2. Apply the changes from the original work to the updated baseline
+3. Resolve any conflicts that arise in the listed files
+4. Ensure tests pass after resolution
+5. Call done() when complete - do NOT submit to merge queue
+
+**Important**: You are a resolver worker. When you call done(), a RESOLVER_DONE signal
+will be emitted instead of MERGE_REQUEST, and your changes will be merged inline by
+the integrator.
+`.trim();
+    try {
+        const spawned = await deps.agentManager.spawn({
+            task: taskDescription,
+            parent: context.agentId,
+            role: "worker.resolver",
+            streamId: context.streamId,
+            // Store mrId in agent config for the resolver to access
+            config: {
+                env: {
+                    MACRO_RESOLVER_MR_ID: mr.id,
+                },
+            },
+        });
+        return {
+            mrId: mr.id,
+            resolverId: spawned.id,
+            resolverBranch,
+            conflictFiles,
+            spawnedAt: timestamp,
+        };
+    }
+    catch (error) {
+        console.error(`[Integrator] Failed to spawn resolver for MR ${mr.id}: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+/**
+ * Process a single merge request from the queue
+ */
+async function processSingleMerge(mergeQueue, mr, workspacePath, context, deps, expectedBranch) {
+    const { id: mrId, workerBranch } = mr;
+    // Verify workspace is on expected branch before merge
+    if (expectedBranch) {
+        const currentBranch = getCurrentBranch(workspacePath);
+        if (currentBranch !== expectedBranch) {
+            // Don't mark as processing if branch is wrong - this is a system error
+            return {
+                mrId,
+                success: false,
+                error: `Workspace is on branch '${currentBranch}', expected '${expectedBranch}'`,
+            };
+        }
+    }
+    // Mark as processing
+    mergeQueue.markProcessing(mrId);
+    // Attempt the merge
+    const mergeResult = attemptMerge(workerBranch, workspacePath);
+    if (mergeResult.success) {
+        if (mergeResult.alreadyMerged) {
+            // Branch was already merged - mark as merged with current HEAD
+            // This is a no-op merge but we track it for completeness
+            const currentHead = execSync("git rev-parse HEAD", {
+                cwd: workspacePath,
+                encoding: "utf-8",
+            }).trim();
+            mergeQueue.markMerged(mrId, currentHead);
+            return {
+                mrId,
+                success: true,
+                alreadyMerged: true,
+            };
+        }
+        if (mergeResult.mergeCommit) {
+            mergeQueue.markMerged(mrId, mergeResult.mergeCommit);
+            return {
+                mrId,
+                success: true,
+                mergeCommit: mergeResult.mergeCommit,
+            };
+        }
+    }
+    // Merge failed - check for conflicts
+    if (mergeResult.conflicts && mergeResult.conflicts.length > 0) {
+        // Abort the merge
+        abortMerge(workspacePath);
+        // Attempt to spawn a resolver worker
+        const resolver = await spawnResolverWorker(mr, mergeResult.conflicts, context, deps);
+        if (resolver) {
+            // Resolver spawned - mark conflict with resolver task ID
+            mergeQueue.markConflict(mrId, mergeResult.conflicts, resolver.resolverId);
+            // Emit CONFLICT_DETECTED signal for notification
+            deps.messageRouter.emitStatus({
+                from: { agent_id: context.agentId },
+                status_type: "checkpoint",
+                summary: `Merge conflict detected for MR ${mrId} - resolver spawned`,
+                details: {
+                    signal: "CONFLICT_DETECTED",
+                    mrId,
+                    conflictFiles: mergeResult.conflicts,
+                    resolverSpawned: true,
+                    resolverId: resolver.resolverId,
+                    resolverBranch: resolver.resolverBranch,
+                },
+            });
+            return {
+                mrId,
+                success: false,
+                conflicts: mergeResult.conflicts,
+                resolverSpawned: true,
+                resolver,
+            };
+        }
+        else {
+            // Couldn't spawn resolver - mark conflict without resolver
+            mergeQueue.markConflict(mrId, mergeResult.conflicts);
+            // Emit CONFLICT_DETECTED signal without resolver
+            deps.messageRouter.emitStatus({
+                from: { agent_id: context.agentId },
+                status_type: "checkpoint",
+                summary: `Merge conflict detected for MR ${mrId} - manual resolution required`,
+                details: {
+                    signal: "CONFLICT_DETECTED",
+                    mrId,
+                    conflictFiles: mergeResult.conflicts,
+                    resolverSpawned: false,
+                },
+            });
+            return {
+                mrId,
+                success: false,
+                conflicts: mergeResult.conflicts,
+            };
+        }
+    }
+    // Non-conflict error - abort and mark as conflict with error
+    abortMerge(workspacePath);
+    mergeQueue.markConflict(mrId, [], undefined);
+    return {
+        mrId,
+        success: false,
+        error: mergeResult.error ?? "Unknown merge error",
+    };
+}
+/**
+ * Process all pending merge requests for a stream
+ */
+async function processAllPendingMerges(streamId, mergeQueue, workspacePath, context, deps, expectedBranch) {
+    let processed = 0;
+    let merged = 0;
+    let conflicts = 0;
+    let branchErrors = 0;
+    const pendingResolvers = [];
+    // Process queue until empty
+    while (true) {
+        const next = mergeQueue.getNext(streamId);
+        if (!next)
+            break;
+        const result = await processSingleMerge(mergeQueue, next, workspacePath, context, deps, expectedBranch);
+        // Check for branch verification error - if we're on the wrong branch,
+        // no merges will succeed, so break out of the loop to avoid infinite loop
+        // (the MR was never marked as processing, so it would be returned again)
+        if (!result.success && result.error?.includes("expected")) {
+            branchErrors++;
+            break;
+        }
+        processed++;
+        if (result.success) {
+            merged++;
+        }
+        else {
+            conflicts++;
+            // Track spawned resolver
+            if (result.resolverSpawned && result.resolver) {
+                pendingResolvers.push(result.resolver);
+            }
+        }
+    }
+    return { processed, merged, conflicts, branchErrors, pendingResolvers };
+}
+// =============================================================================
+// Integrator Handler
+// =============================================================================
+/**
+ * Handle done() for integrator agents
+ *
+ * Processing steps:
+ * 1. Process any pending merge requests in the queue
+ * 2. Check final queue status
+ * 3. Emit INTEGRATOR_DONE signal to coordinator
+ * 4. Return shouldTerminate based on queue status
+ */
+export async function handleIntegratorDone(context, args, _cleanupStatus, deps) {
+    const signalsEmitted = [];
+    const cleanupActions = [];
+    const warnings = [];
+    const streamId = context.streamId;
+    const mergeQueue = deps.mergeQueue;
+    const workspacePath = deps.workspacePath ?? context.workspacePath;
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 1: Process any pending merge requests before termination
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Track pending resolvers for the termination decision
+    let activePendingResolvers = [];
+    if (mergeQueue && streamId && workspacePath) {
+        const pendingBefore = getPendingCount(streamId, mergeQueue);
+        if (pendingBefore > 0) {
+            cleanupActions.push(`Found ${pendingBefore} pending merge request(s) - processing before termination`);
+            try {
+                // Pass the expected integration branch for verification
+                const expectedBranch = context.branch ?? "integration";
+                const result = await processAllPendingMerges(streamId, mergeQueue, workspacePath, context, deps, expectedBranch);
+                cleanupActions.push(`Processed ${result.processed} merge request(s): ${result.merged} merged, ${result.conflicts} conflicts`);
+                if (result.conflicts > 0) {
+                    if (result.pendingResolvers.length > 0) {
+                        cleanupActions.push(`Spawned ${result.pendingResolvers.length} resolver(s) for conflicts`);
+                        activePendingResolvers = result.pendingResolvers;
+                    }
+                    else {
+                        warnings.push(`${result.conflicts} merge request(s) had conflicts - manual resolution required`);
+                    }
+                }
+                if (result.branchErrors > 0) {
+                    warnings.push(`${result.branchErrors} merge request(s) skipped due to workspace not being on expected branch '${expectedBranch}'`);
+                }
+            }
+            catch (error) {
+                warnings.push(`Error processing merge queue: ${error instanceof Error ? error.message : "unknown"}`);
+            }
+        }
+    }
+    else if (!mergeQueue) {
+        cleanupActions.push("Merge queue not configured - skipping queue processing");
+    }
+    else if (!streamId) {
+        cleanupActions.push("No stream ID in context - skipping queue processing");
+    }
+    else if (!workspacePath) {
+        cleanupActions.push("No workspace path available - skipping queue processing");
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 2: Check final merge queue status
+    // ─────────────────────────────────────────────────────────────────────────────
+    const queueEmpty = isMergeQueueEmpty(streamId, mergeQueue);
+    const finalPending = getPendingCount(streamId, mergeQueue);
+    if (!queueEmpty) {
+        warnings.push(`Merge queue still has ${finalPending} pending request(s) - termination may be premature`);
+    }
+    cleanupActions.push(`Merge queue final status: ${queueEmpty ? "empty" : `${finalPending} pending`}`);
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 3: Emit INTEGRATOR_DONE signal
+    // ─────────────────────────────────────────────────────────────────────────────
+    try {
+        deps.messageRouter.emitStatus({
+            from: { agent_id: context.agentId },
+            status_type: args.status === "completed" ? "completed" : "failed",
+            summary: args.summary ?? `Integrator done with status: ${args.status}`,
+            details: {
+                signal: "INTEGRATOR_DONE",
+                integratorId: context.agentId,
+                streamId,
+                status: args.status,
+                baseBranch: context.branch ?? "integration",
+                queueEmpty,
+                pendingCount: finalPending,
+                ...args.details,
+            },
+        });
+        signalsEmitted.push("INTEGRATOR_DONE");
+    }
+    catch (error) {
+        warnings.push(`Failed to emit INTEGRATOR_DONE: ${error instanceof Error ? error.message : "unknown"}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Return result - shouldTerminate depends on pending resolvers
+    // ─────────────────────────────────────────────────────────────────────────────
+    // If resolvers are active, integrator should stay alive to handle their completion
+    const hasActiveResolvers = activePendingResolvers.length > 0;
+    if (hasActiveResolvers) {
+        cleanupActions.push(`Staying alive to await ${activePendingResolvers.length} pending resolver(s)`);
+        // Include resolver info in the result for the agent to track
+        return {
+            shouldTerminate: false,
+            signalsEmitted,
+            cleanupActions,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            // Include pending resolver info for the agent to handle RESOLVER_DONE
+            pendingResolvers: activePendingResolvers,
+        };
+    }
+    return {
+        shouldTerminate: true,
+        signalsEmitted,
+        cleanupActions,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+/**
+ * Handle RESOLVER_DONE signal by performing inline merge of resolver branch.
+ *
+ * This is called when a resolver worker completes. The integrator should:
+ * 1. Merge the resolver branch into the integration branch
+ * 2. Mark the original MR as resolved via markResolverComplete()
+ * 3. If the merge also conflicts (nested conflict), escalate to coordinator
+ *
+ * @param mrId - The original merge request ID
+ * @param resolverBranch - Branch the resolver worked on
+ * @param context - Lifecycle context
+ * @param deps - Handler dependencies
+ * @returns Result of the inline merge
+ */
+export async function handleResolverDone(mrId, resolverBranch, context, deps) {
+    const { mergeQueue, workspacePath, messageRouter } = deps;
+    if (!mergeQueue || !workspacePath) {
+        return {
+            success: false,
+            error: "Missing mergeQueue or workspacePath",
+        };
+    }
+    // Verify the MR exists and is in conflict state
+    const mr = mergeQueue.get(mrId);
+    if (!mr) {
+        return {
+            success: false,
+            error: `MR ${mrId} not found`,
+        };
+    }
+    if (mr.status !== "conflict") {
+        return {
+            success: false,
+            error: `MR ${mrId} is not in conflict state (status: ${mr.status})`,
+        };
+    }
+    // Attempt inline merge of resolver branch
+    const mergeResult = attemptMerge(resolverBranch, workspacePath, `Merge resolved changes for MR ${mrId}`);
+    if (mergeResult.success && mergeResult.mergeCommit) {
+        // Success! Mark the original MR as resolved
+        mergeQueue.markResolverComplete(mrId, mergeResult.mergeCommit, resolverBranch);
+        // Emit MERGE_COMPLETE signal
+        messageRouter.emitStatus({
+            from: { agent_id: context.agentId },
+            status_type: "completed",
+            summary: `MR ${mrId} resolved and merged`,
+            details: {
+                signal: "MERGE_COMPLETE",
+                mrId,
+                mergeCommit: mergeResult.mergeCommit,
+                resolvedVia: "resolver",
+                resolverBranch,
+            },
+        });
+        return {
+            success: true,
+            mergeCommit: mergeResult.mergeCommit,
+        };
+    }
+    // Resolver's merge also conflicted - this is a nested conflict!
+    if (mergeResult.conflicts && mergeResult.conflicts.length > 0) {
+        // Abort the failed merge
+        abortMerge(workspacePath);
+        // Emit CONFLICT_UNRESOLVED signal for escalation to coordinator
+        messageRouter.emitStatus({
+            from: { agent_id: context.agentId },
+            status_type: "failed",
+            summary: `Nested conflict: resolver for MR ${mrId} also conflicted - escalating`,
+            details: {
+                signal: "CONFLICT_UNRESOLVED",
+                mrId,
+                resolverBranch,
+                conflictFiles: mergeResult.conflicts,
+                reason: "resolver_conflict",
+            },
+        });
+        console.warn(`[Integrator] Nested conflict on MR ${mrId}: resolver branch ${resolverBranch} also conflicts`);
+        return {
+            success: false,
+            nestedConflict: true,
+            conflictFiles: mergeResult.conflicts,
+        };
+    }
+    // Other error
+    abortMerge(workspacePath);
+    return {
+        success: false,
+        error: mergeResult.error ?? "Unknown merge error",
+    };
+}
+//# sourceMappingURL=integrator.js.map

package/dist/lifecycle/handlers/integrator.js.map

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

package/dist/lifecycle/handlers/monitor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Monitor Done Handler
+ *
+ * Handles done() for monitor agents:
+ * - Unsubscribes from events
+ * - Cleans up monitoring state
+ *
+ * @module lifecycle/handlers/monitor
+ * @see s-32xs Self-Cleaning Workers spec
+ */
+import type { MessageRouter } from "../../router/message-router.js";
+import type { LifecycleContext, DoneArgs, CleanupStatus, DoneHandlerResult } from "../types.js";
+/**
+ * Dependencies for the monitor handler
+ */
+export interface MonitorHandlerDeps {
+    /** Message router for managing subscriptions */
+    messageRouter: MessageRouter;
+}
+/**
+ * Handle done() for monitor agents
+ *
+ * Processing steps:
+ * 1. Unsubscribe from all event channels
+ * 2. Clean up any monitoring state
+ * 3. Return shouldTerminate=true
+ */
+export declare function handleMonitorDone(context: LifecycleContext, args: DoneArgs, _cleanupStatus: CleanupStatus, deps: MonitorHandlerDeps): Promise<DoneHandlerResult>;
+//# sourceMappingURL=monitor.d.ts.map

package/dist/lifecycle/handlers/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,aAAa,EAAE,aAAa,CAAC;CAC9B;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,QAAQ,EACd,cAAc,EAAE,aAAa,EAC7B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAiE5B"}

package/dist/lifecycle/handlers/monitor.js

@@ -0,0 +1,79 @@
+/**
+ * Monitor Done Handler
+ *
+ * Handles done() for monitor agents:
+ * - Unsubscribes from events
+ * - Cleans up monitoring state
+ *
+ * @module lifecycle/handlers/monitor
+ * @see s-32xs Self-Cleaning Workers spec
+ */
+// =============================================================================
+// Monitor Handler
+// =============================================================================
+/**
+ * Handle done() for monitor agents
+ *
+ * Processing steps:
+ * 1. Unsubscribe from all event channels
+ * 2. Clean up any monitoring state
+ * 3. Return shouldTerminate=true
+ */
+export async function handleMonitorDone(context, args, _cleanupStatus, deps) {
+    const signalsEmitted = [];
+    const cleanupActions = [];
+    const warnings = [];
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 1: Unsubscribe from all event channels
+    // ─────────────────────────────────────────────────────────────────────────────
+    try {
+        // Get current subscriptions
+        const subscriptions = deps.messageRouter.getSubscriptions(context.agentId);
+        // Unsubscribe from each
+        for (const sub of subscriptions) {
+            try {
+                deps.messageRouter.unsubscribe(context.agentId, sub);
+                cleanupActions.push(`Unsubscribed from ${sub.type}:${sub.target}`);
+            }
+            catch {
+                warnings.push(`Failed to unsubscribe from ${sub.type}:${sub.target}`);
+            }
+        }
+        if (subscriptions.length === 0) {
+            cleanupActions.push("No subscriptions to clean up");
+        }
+    }
+    catch (error) {
+        warnings.push(`Failed to get subscriptions: ${error instanceof Error ? error.message : "unknown"}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 2: Emit completion status
+    // ─────────────────────────────────────────────────────────────────────────────
+    try {
+        deps.messageRouter.emitStatus({
+            from: { agent_id: context.agentId },
+            status_type: args.status === "completed" ? "completed" : "failed",
+            summary: args.summary ?? `Monitor done with status: ${args.status}`,
+            details: {
+                signal: "STATUS",
+                monitorId: context.agentId,
+                status: args.status,
+                ...args.details,
+            },
+        });
+        signalsEmitted.push("STATUS");
+    }
+    catch (error) {
+        warnings.push(`Failed to emit status: ${error instanceof Error ? error.message : "unknown"}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Return result - shouldTerminate=true for monitors
+    // ─────────────────────────────────────────────────────────────────────────────
+    return {
+        shouldTerminate: true,
+        signalsEmitted,
+        cleanupActions,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+//# sourceMappingURL=monitor.js.map

package/dist/lifecycle/handlers/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAyB,EACzB,IAAc,EACd,cAA6B,EAC7B,IAAwB;IAExB,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,gFAAgF;IAChF,8CAA8C;IAC9C,gFAAgF;IAEhF,IAAI,CAAC;QACH,4BAA4B;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE3E,wBAAwB;QACxB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBACrD,cAAc,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,CAAC,IAAI,CAAC,8BAA8B,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,cAAc,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CACX,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,iCAAiC;IACjC,gFAAgF;IAEhF,IAAI,CAAC;QACH,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;YAC5B,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE;YACnC,WAAW,EAAE,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;YACjE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,6BAA6B,IAAI,CAAC,MAAM,EAAE;YACnE,OAAO,EAAE;gBACP,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,OAAO,CAAC,OAAO;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,IAAI,CAAC,OAAO;aAChB;SACF,CAAC,CAAC;QACH,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CACX,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,oDAAoD;IACpD,gFAAgF;IAEhF,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,cAAc;QACd,cAAc;QACd,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;AACJ,CAAC"}

package/dist/lifecycle/handlers/worker.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Worker Done Handler
+ *
+ * Handles done() for worker agents:
+ * - Commits workspace changes (no push - bare repo shared)
+ * - Creates checkpoints for task commits
+ * - Emits WORKER_DONE signal
+ * - Emits MERGE_REQUEST signal and submits to merge queue
+ * - Signals descendants to prepare for termination
+ *
+ * Note: Actual termination is handled by AgentManager after done() returns.
+ * The AgentManager.terminate() method cascades depth-first to all children.
+ * This handler emits signals for notification only.
+ *
+ * @module lifecycle/handlers/worker
+ * @see s-32xs Self-Cleaning Workers spec
+ * @see s-bcqm Change Management spec
+ */
+import type { MessageRouter } from "../../router/message-router.js";
+import type { AgentManager } from "../../agent/agent-manager.js";
+import type { DataplaneAdapter } from "../../workspace/dataplane-adapter.js";
+import type { MergeQueueInterface } from "../../workspace/merge-queue/types.js";
+import type { LifecycleContext, DoneArgs, CleanupStatus, DoneHandlerResult } from "../types.js";
+/**
+ * Dependencies for the worker handler
+ */
+export interface WorkerHandlerDeps {
+    /** Message router for emitting signals */
+    messageRouter: MessageRouter;
+    /** Agent manager for cascade termination */
+    agentManager: AgentManager;
+    /** Dataplane adapter for checkpoint creation (optional) */
+    dataplane?: DataplaneAdapter;
+    /** Merge queue for submitting merge requests (optional) */
+    mergeQueue?: MergeQueueInterface;
+    /** Get workspace path for an agent (for resolver → integrator inline merge) */
+    getWorkspacePath?: (agentId: string) => string | undefined;
+    /** Optional integration strategy (from team config) */
+    integrationStrategy?: import("../../workspace/strategies/types.js").IntegrationStrategy;
+    /** Optional task mode from team config */
+    taskMode?: "push" | "pull";
+}
+/**
+ * Handle done() for worker agents
+ *
+ * Processing steps:
+ * 1. Commit any uncommitted changes
+ * 1.5. Create checkpoints for task commits (Phase 6)
+ * 2. Handle blocked/deferred status (emit HELP_NEEDED, return shouldTerminate=false)
+ * 3. Emit WORKER_DONE signal (for completed/failed)
+ * 4. Emit MERGE_REQUEST signal and submit to queue
+ * 5. Signal children to terminate (basic cascade)
+ * 6. Return shouldTerminate=true (for completed/failed only)
+ */
+export declare function handleWorkerDone(context: LifecycleContext, args: DoneArgs, cleanupStatus: CleanupStatus, deps: WorkerHandlerDeps): Promise<DoneHandlerResult>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/lifecycle/handlers/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAgBrB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,aAAa,EAAE,aAAa,CAAC;IAE7B,4CAA4C;IAC5C,YAAY,EAAE,YAAY,CAAC;IAE3B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAE3D,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,qCAAqC,EAAE,mBAAmB,CAAC;IAExF,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA8Z5B"}