macro-agent 0.2.5 → 0.2.6

package/dist/lifecycle/handlers/generic.js

@@ -0,0 +1,56 @@
+/**
+ * Generic Done Handler
+ *
+ * Fallback handler for roles without specific done() handling.
+ * Provides basic cleanup and termination.
+ *
+ * @module lifecycle/handlers/generic
+ * @see s-32xs Self-Cleaning Workers spec
+ */
+// =============================================================================
+// Generic Handler
+// =============================================================================
+/**
+ * Handle done() for any role without a specific handler
+ *
+ * Processing steps:
+ * 1. Emit STATUS signal with done status
+ * 2. Return shouldTerminate=true
+ */
+export async function handleGenericDone(context, args, _cleanupStatus, deps) {
+    const signalsEmitted = [];
+    const cleanupActions = [];
+    const warnings = [];
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Emit completion status
+    // ─────────────────────────────────────────────────────────────────────────────
+    try {
+        deps.messageRouter.emitStatus({
+            from: { agent_id: context.agentId },
+            status_type: args.status === "completed" ? "completed" : "failed",
+            summary: args.summary ?? `Agent done with status: ${args.status}`,
+            details: {
+                signal: "STATUS",
+                agentId: context.agentId,
+                role: context.role,
+                status: args.status,
+                ...args.details,
+            },
+        });
+        signalsEmitted.push("STATUS");
+        cleanupActions.push(`Emitted done status for role: ${context.role}`);
+    }
+    catch (error) {
+        warnings.push(`Failed to emit status: ${error instanceof Error ? error.message : "unknown"}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Return result - shouldTerminate=true by default
+    // ─────────────────────────────────────────────────────────────────────────────
+    return {
+        shouldTerminate: true,
+        signalsEmitted,
+        cleanupActions,
+        warnings: warnings.length > 0 ? warnings : undefined,
+    };
+}
+//# sourceMappingURL=generic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../src/lifecycle/handlers/generic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;GAMG;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,yBAAyB;IACzB,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,2BAA2B,IAAI,CAAC,MAAM,EAAE;YACjE,OAAO,EAAE;gBACP,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,IAAI,CAAC,OAAO;aAChB;SACF,CAAC,CAAC;QACH,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,cAAc,CAAC,IAAI,CAAC,iCAAiC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,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,kDAAkD;IAClD,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/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Lifecycle Handlers Index
+ *
+ * Exports role-specific done() handlers and the handler registry.
+ *
+ * @module lifecycle/handlers
+ * @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 { MergeQueueInterface } from "../../workspace/merge-queue/types.js";
+import type { LifecycleContext, DoneArgs, CleanupStatus, DoneHandlerResult, DoneHandler, DoneHandlerRegistry } from "../types.js";
+export { handleWorkerDone, type WorkerHandlerDeps } from "./worker.js";
+export { handleIntegratorDone, handleResolverDone, type IntegratorHandlerDeps, type PendingResolver, type HandleResolverDoneResult, } from "./integrator.js";
+export { handleMonitorDone, type MonitorHandlerDeps } from "./monitor.js";
+export { handleGenericDone, type GenericHandlerDeps } from "./generic.js";
+/**
+ * Combined dependencies for all handlers
+ */
+export interface AllHandlerDeps {
+    messageRouter: MessageRouter;
+    agentManager: AgentManager;
+    /** Optional merge queue for integrator handlers */
+    mergeQueue?: MergeQueueInterface;
+    /** Optional workspace path resolver for integrators */
+    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";
+}
+/**
+ * Create the default handler registry with all built-in handlers
+ */
+export declare function createHandlerRegistry(deps: AllHandlerDeps): DoneHandlerRegistry;
+/**
+ * Get the handler for a given role.
+ *
+ * Resolution order:
+ * 1. Exact role name match (e.g., "worker", "integrator")
+ * 2. Dot-prefix match (e.g., "worker.resolver" → "worker")
+ * 3. Capability-based match (e.g., "developer" with workspace.worktree → worker handler)
+ * 4. Generic fallback handler
+ */
+export declare function getHandler(role: string, registry: DoneHandlerRegistry, deps: AllHandlerDeps, capabilities?: string[]): DoneHandler;
+/**
+ * Dispatch done() to the appropriate handler based on role
+ */
+export declare function dispatchDone(context: LifecycleContext, args: DoneArgs, cleanupStatus: CleanupStatus, deps: AllHandlerDeps, registry?: DoneHandlerRegistry): Promise<DoneHandlerResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAUrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,wBAAwB,GAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAM1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAE3B,mDAAmD;IACnD,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC,uDAAuD;IACvD,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;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,GACnB,mBAAmB,CAoCrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,cAAc,EACpB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,WAAW,CAgCb;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,cAAc,EACpB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}

package/dist/lifecycle/handlers/index.js

@@ -0,0 +1,110 @@
+/**
+ * Lifecycle Handlers Index
+ *
+ * Exports role-specific done() handlers and the handler registry.
+ *
+ * @module lifecycle/handlers
+ * @see s-32xs Self-Cleaning Workers spec
+ * @see s-bcqm Change Management spec
+ */
+import { handleWorkerDone } from "./worker.js";
+import { handleIntegratorDone } from "./integrator.js";
+import { handleMonitorDone } from "./monitor.js";
+import { handleGenericDone } from "./generic.js";
+// =============================================================================
+// Re-exports
+// =============================================================================
+export { handleWorkerDone } from "./worker.js";
+export { handleIntegratorDone, handleResolverDone, } from "./integrator.js";
+export { handleMonitorDone } from "./monitor.js";
+export { handleGenericDone } from "./generic.js";
+// =============================================================================
+// Handler Registry
+// =============================================================================
+/**
+ * Create the default handler registry with all built-in handlers
+ */
+export function createHandlerRegistry(deps) {
+    const registry = new Map();
+    // Worker handler - include merge queue for queue submission and getWorkspacePath for resolver inline merge
+    const workerDeps = {
+        messageRouter: deps.messageRouter,
+        agentManager: deps.agentManager,
+        mergeQueue: deps.mergeQueue,
+        getWorkspacePath: deps.getWorkspacePath,
+        integrationStrategy: deps.integrationStrategy,
+        taskMode: deps.taskMode,
+    };
+    registry.set("worker", (context, args, cleanupStatus) => handleWorkerDone(context, args, cleanupStatus, workerDeps));
+    // Integrator handler - include merge queue, workspace path resolver, and agent manager
+    registry.set("integrator", (context, args, cleanupStatus) => {
+        const integratorDeps = {
+            messageRouter: deps.messageRouter,
+            mergeQueue: deps.mergeQueue,
+            workspacePath: deps.getWorkspacePath?.(context.agentId),
+            agentManager: deps.agentManager,
+        };
+        return handleIntegratorDone(context, args, cleanupStatus, integratorDeps);
+    });
+    // Monitor handler
+    const monitorDeps = {
+        messageRouter: deps.messageRouter,
+    };
+    registry.set("monitor", (context, args, cleanupStatus) => handleMonitorDone(context, args, cleanupStatus, monitorDeps));
+    return registry;
+}
+/**
+ * Get the handler for a given role.
+ *
+ * Resolution order:
+ * 1. Exact role name match (e.g., "worker", "integrator")
+ * 2. Dot-prefix match (e.g., "worker.resolver" → "worker")
+ * 3. Capability-based match (e.g., "developer" with workspace.worktree → worker handler)
+ * 4. Generic fallback handler
+ */
+export function getHandler(role, registry, deps, capabilities) {
+    // 1. Exact match
+    const handler = registry.get(role);
+    if (handler) {
+        return handler;
+    }
+    // 2. Dot-prefix match (e.g., "worker.resolver" → "worker")
+    const baseRole = role.split(".")[0];
+    const baseHandler = registry.get(baseRole);
+    if (baseHandler) {
+        return baseHandler;
+    }
+    // 3. Capability-based match (for team-defined roles like "developer" extending "worker")
+    if (capabilities) {
+        if (capabilities.includes("workspace.worktree")) {
+            const workerHandler = registry.get("worker");
+            if (workerHandler)
+                return workerHandler;
+        }
+        if (capabilities.includes("workspace.integrate")) {
+            const integratorHandler = registry.get("integrator");
+            if (integratorHandler)
+                return integratorHandler;
+        }
+    }
+    // 4. Generic fallback
+    const genericDeps = {
+        messageRouter: deps.messageRouter,
+    };
+    return (context, args, cleanupStatus) => handleGenericDone(context, args, cleanupStatus, genericDeps);
+}
+// =============================================================================
+// Dispatch Function
+// =============================================================================
+/**
+ * Dispatch done() to the appropriate handler based on role
+ */
+export async function dispatchDone(context, args, cleanupStatus, deps, registry) {
+    // Use provided registry or create default
+    const handlers = registry ?? createHandlerRegistry(deps);
+    // Get the handler for this role (pass capabilities for team role resolution)
+    const handler = getHandler(context.role, handlers, deps, context.capabilities);
+    // Execute the handler
+    return handler(context, args, cleanupStatus);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * 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 type { MessageRouter } from "../../router/message-router.js";
+import type { MergeQueueInterface } from "../../workspace/merge-queue/types.js";
+import type { AgentManager } from "../../agent/agent-manager.js";
+import type { LifecycleContext, DoneArgs, CleanupStatus, DoneHandlerResult } from "../types.js";
+/**
+ * Dependencies for the integrator handler
+ */
+export interface IntegratorHandlerDeps {
+    /** Message router for emitting signals */
+    messageRouter: MessageRouter;
+    /** Merge queue for processing worker merges (optional - if not provided, queue checks return empty) */
+    mergeQueue?: MergeQueueInterface;
+    /** Workspace path for the integrator (needed for merge operations) */
+    workspacePath?: string;
+    /** Agent manager for spawning resolver workers (optional) */
+    agentManager?: AgentManager;
+}
+/**
+ * Information about a spawned resolver worker
+ */
+export interface PendingResolver {
+    /** Merge request ID being resolved */
+    mrId: string;
+    /** Agent ID of the resolver worker */
+    resolverId: string;
+    /** Branch the resolver is working on */
+    resolverBranch: string;
+    /** Files with conflicts */
+    conflictFiles: string[];
+    /** Timestamp when resolver was spawned */
+    spawnedAt: number;
+}
+/**
+ * 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 declare function handleIntegratorDone(context: LifecycleContext, args: DoneArgs, _cleanupStatus: CleanupStatus, deps: IntegratorHandlerDeps): Promise<DoneHandlerResult>;
+/**
+ * Result of handling a resolver completion
+ */
+export interface HandleResolverDoneResult {
+    success: boolean;
+    mergeCommit?: string;
+    /** True if the resolver's merge also conflicted (nested conflict) */
+    nestedConflict?: boolean;
+    conflictFiles?: string[];
+    error?: string;
+}
+/**
+ * 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 declare function handleResolverDone(mrId: string, resolverBranch: string, context: LifecycleContext, deps: IntegratorHandlerDeps): Promise<HandleResolverDoneResult>;
+//# sourceMappingURL=integrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integrator.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/handlers/integrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,sCAAsC,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAOrB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,aAAa,EAAE,aAAa,CAAC;IAE7B,uGAAuG;IACvG,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAsUD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,QAAQ,EACd,cAAc,EAAE,aAAa,EAC7B,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAyI5B;AAMD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CA6FnC"}