@planu/cli 0.30.1 → 0.32.0

package/dist/engine/orchestrator/result-collector.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeAgentProcess, RuntimeTaskAssignment, RuntimeTaskResultEntry, RuntimeConflictRecord, RuntimeConflictStrategy, RuntimeOrchestrationResult, RuntimeOrchestrationCost } from '../../types/index.js';
+/**
+ * Collect results from all agents into task result entries.
+ */
+export declare function collectTaskResults(agents: RuntimeAgentProcess[], assignments: RuntimeTaskAssignment[]): RuntimeTaskResultEntry[];
+/**
+ * Parse structured output from an agent's stdout.
+ * Tries to extract JSON, falls back to raw text.
+ */
+export declare function parseAgentOutput(stdout: string): unknown;
+/**
+ * Detect file conflicts between agents and resolve them.
+ */
+export declare function detectAndResolveConflicts(assignments: RuntimeTaskAssignment[], agents: RuntimeAgentProcess[], strategy: RuntimeConflictStrategy): RuntimeConflictRecord[];
+/**
+ * Calculate total cost for the orchestration run.
+ */
+export declare function calculateCost(agents: RuntimeAgentProcess[], defaultTier: string): RuntimeOrchestrationCost;
+/**
+ * Build the final orchestration result.
+ */
+export declare function buildOrchestrationResult(sessionId: string, agents: RuntimeAgentProcess[], assignments: RuntimeTaskAssignment[], conflictStrategy: RuntimeConflictStrategy, startTime: number): RuntimeOrchestrationResult;
+//# sourceMappingURL=result-collector.d.ts.map

package/dist/engine/orchestrator/result-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-collector.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/result-collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAW9B;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,WAAW,EAAE,qBAAqB,EAAE,GACnC,sBAAsB,EAAE,CAe1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAsBxD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,qBAAqB,EAAE,EACpC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,QAAQ,EAAE,uBAAuB,GAChC,qBAAqB,EAAE,CAgCzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,EAAE,EAC7B,WAAW,EAAE,MAAM,GAClB,wBAAwB,CAgB1B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAAE,EAC7B,WAAW,EAAE,qBAAqB,EAAE,EACpC,gBAAgB,EAAE,uBAAuB,EACzC,SAAS,EAAE,MAAM,GAChB,0BAA0B,CAmB5B"}

package/dist/engine/orchestrator/result-collector.js

@@ -0,0 +1,124 @@
+// orchestrator/result-collector.ts — Result collection and merging (SPEC-079 AC-05)
+// Collects outputs from agents and merges them into a unified result.
+import { parseTokenUsage } from './agent-spawner.js';
+import { resolveConflict } from './conflict-resolver.js';
+/** Default cost per token (USD) by model tier. */
+const COST_PER_TOKEN = {
+    haiku: 0.00000025,
+    sonnet: 0.000003,
+    opus: 0.000015,
+};
+/**
+ * Collect results from all agents into task result entries.
+ */
+export function collectTaskResults(agents, assignments) {
+    return assignments.map((assignment) => {
+        const agent = agents.find((a) => a.agentId === assignment.agentId);
+        const duration = agent?.completedAt
+            ? new Date(agent.completedAt).getTime() - new Date(agent.startedAt).getTime()
+            : 0;
+        return {
+            taskId: assignment.taskId,
+            agentId: assignment.agentId,
+            status: agent?.status === 'completed' ? 'completed' : 'failed',
+            output: agent ? parseAgentOutput(agent.stdout) : null,
+            duration,
+        };
+    });
+}
+/**
+ * Parse structured output from an agent's stdout.
+ * Tries to extract JSON, falls back to raw text.
+ */
+export function parseAgentOutput(stdout) {
+    // Try to find a JSON block
+    const jsonMatch = /```json\s*([\s\S]*?)```/u.exec(stdout);
+    if (jsonMatch?.[1]) {
+        try {
+            return JSON.parse(jsonMatch[1]);
+        }
+        catch {
+            // Not valid JSON, fall through
+        }
+    }
+    // Try raw JSON
+    const trimmed = stdout.trim();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            // Not valid JSON
+        }
+    }
+    return trimmed || null;
+}
+/**
+ * Detect file conflicts between agents and resolve them.
+ */
+export function detectAndResolveConflicts(assignments, agents, strategy) {
+    // Build file-to-agents map
+    const fileAgents = new Map();
+    for (const assignment of assignments) {
+        for (const file of assignment.files) {
+            const existing = fileAgents.get(file) ?? [];
+            if (!existing.includes(assignment.agentId)) {
+                existing.push(assignment.agentId);
+                fileAgents.set(file, existing);
+            }
+        }
+    }
+    const conflicts = [];
+    for (const [file, agentIds] of fileAgents.entries()) {
+        if (agentIds.length <= 1) {
+            continue;
+        }
+        // Only consider it a conflict if multiple agents actually completed
+        const completedAgents = agentIds.filter((id) => agents.some((a) => a.agentId === id && a.status === 'completed'));
+        if (completedAgents.length <= 1) {
+            continue;
+        }
+        const record = resolveConflict(file, completedAgents, strategy);
+        conflicts.push(record);
+    }
+    return conflicts;
+}
+/**
+ * Calculate total cost for the orchestration run.
+ */
+export function calculateCost(agents, defaultTier) {
+    const breakdown = {};
+    let totalTokens = 0;
+    let totalUsd = 0;
+    for (const agent of agents) {
+        const tokens = agent.tokensUsed ?? parseTokenUsage(agent.stdout);
+        const rate = COST_PER_TOKEN[defaultTier] ?? COST_PER_TOKEN.sonnet ?? 0.000003;
+        const usd = tokens * rate;
+        breakdown[agent.agentId] = { tokens, usd };
+        totalTokens += tokens;
+        totalUsd += usd;
+    }
+    return { tokens: totalTokens, usd: totalUsd, breakdown };
+}
+/**
+ * Build the final orchestration result.
+ */
+export function buildOrchestrationResult(sessionId, agents, assignments, conflictStrategy, startTime) {
+    const taskResults = collectTaskResults(agents, assignments);
+    const conflicts = detectAndResolveConflicts(assignments, agents, conflictStrategy);
+    const cost = calculateCost(agents, 'sonnet');
+    const outputs = {};
+    for (const result of taskResults) {
+        outputs[result.taskId] = result.output;
+    }
+    return {
+        sessionId,
+        agents,
+        tasks: taskResults,
+        outputs,
+        conflicts,
+        duration: Date.now() - startTime,
+        totalCost: cost,
+    };
+}
+//# sourceMappingURL=result-collector.js.map

package/dist/engine/orchestrator/result-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-collector.js","sourceRoot":"","sources":["../../../src/engine/orchestrator/result-collector.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sEAAsE;AAWtE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,kDAAkD;AAClD,MAAM,cAAc,GAA2B;IAC7C,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA6B,EAC7B,WAAoC;IAEpC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,KAAK,EAAE,WAAW;YACjC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;YAC7E,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;YAC9D,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;YACrD,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,2BAA2B;IAC3B,MAAM,SAAS,GAAG,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAY,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,IAAI,IAAI,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAoC,EACpC,MAA6B,EAC7B,QAAiC;IAEjC,2BAA2B;IAC3B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,oEAAoE;QACpE,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAC7C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CACjE,CAAC;QACF,IAAI,eAAe,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;QAChE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA6B,EAC7B,WAAmB;IAEnB,MAAM,SAAS,GAAoD,EAAE,CAAC;IACtE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,IAAI,cAAc,CAAC,MAAM,IAAI,QAAQ,CAAC;QAC9E,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC;QAE1B,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC3C,WAAW,IAAI,MAAM,CAAC;QACtB,QAAQ,IAAI,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAiB,EACjB,MAA6B,EAC7B,WAAoC,EACpC,gBAAyC,EACzC,SAAiB;IAEjB,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE7C,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,CAAC;IAED,OAAO;QACL,SAAS;QACT,MAAM;QACN,KAAK,EAAE,WAAW;QAClB,OAAO;QACP,SAAS;QACT,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/engine/orchestrator/runtime.d.ts

@@ -0,0 +1,21 @@
+import type { RuntimeOrchestrationConfig, RuntimeOrchestrationSession, RuntimeOrchestrationResult, RuntimeSessionStatus } from '../../types/index.js';
+/**
+ * Start a new orchestration session.
+ * If dryRun is true, plans execution without spawning agents.
+ */
+export declare function startOrchestration(config: RuntimeOrchestrationConfig): Promise<RuntimeOrchestrationResult>;
+/**
+ * Get current status of an orchestration session.
+ */
+export declare function getStatus(sessionId: string): RuntimeOrchestrationSession | undefined;
+/**
+ * List all sessions, optionally filtered by status.
+ */
+export declare function listSessions(filter?: RuntimeSessionStatus): RuntimeOrchestrationSession[];
+/**
+ * Cancel an active orchestration session.
+ */
+export declare function cancelOrchestration(sessionId: string): boolean;
+/** Clear all sessions (for testing). */
+export declare function clearSessions(): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/engine/orchestrator/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAG1B,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAyB9B;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CAgErC;AA6ID;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAEpF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,2BAA2B,EAAE,CAMzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAc9D;AA4BD,wCAAwC;AACxC,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/dist/engine/orchestrator/runtime.js

@@ -0,0 +1,231 @@
+// orchestrator/runtime.ts — Orchestration lifecycle manager (SPEC-079 AC-01, AC-08, AC-13)
+// Manages init, spawn, monitor, collect, finalize for orchestration sessions.
+import { planExecution } from './topologies.js';
+import { distributeTasks } from './task-distributor.js';
+import { createAgentProcess, buildSpawnDescriptor, spawnAgent, parseTokenUsage, } from './agent-spawner.js';
+import { generateFileOwnershipMap } from './file-ownership.js';
+import { buildOrchestrationResult } from './result-collector.js';
+import { generateAllHandoffs, formatHandoffAsPrompt } from './handoff-generator.js';
+import { ProgressTracker } from './progress-tracker.js';
+/** In-memory store for active orchestration sessions. */
+const sessions = new Map();
+let sessionCounter = 0;
+/** Generate a unique session ID. */
+function generateSessionId() {
+    sessionCounter++;
+    return `orch-${Date.now()}-${String(sessionCounter)}`;
+}
+/**
+ * Start a new orchestration session.
+ * If dryRun is true, plans execution without spawning agents.
+ */
+export async function startOrchestration(config) {
+    const sessionId = generateSessionId();
+    const startTime = Date.now();
+    // Distribute tasks to agents
+    const agents = config.agents ?? buildDefaultAgents(config.tasks.length);
+    const assignments = distributeTasks(config.tasks, agents);
+    // Generate file ownership map
+    const { map: ownershipMap } = generateFileOwnershipMap(assignments);
+    // Create agent processes
+    const agentProcesses = agents.map((a) => createAgentProcess(a.id));
+    // Initialize session
+    const session = {
+        id: sessionId,
+        topology: config.topology,
+        config,
+        agents: agentProcesses,
+        tasks: assignments,
+        status: 'initializing',
+        startedAt: new Date(startTime).toISOString(),
+        fileOwnershipMap: ownershipMap,
+    };
+    sessions.set(sessionId, session);
+    // Plan execution graph
+    const executionGraph = planExecution(config.topology, assignments, agentProcesses);
+    // Initialize progress tracker
+    const tracker = new ProgressTracker(sessionId);
+    tracker.init(agentProcesses, assignments);
+    if (config.options.dryRun) {
+        return buildDryRunResult(sessionId, agentProcesses, assignments, executionGraph, startTime);
+    }
+    // Execute orchestration
+    sessions.set(sessionId, { ...session, status: 'running' });
+    const executionResult = await executeOrchestration(session, agents, tracker, config);
+    // Finalize — update session with results
+    const finalAgents = executionResult.agents.map((a) => ({
+        ...a,
+        tokensUsed: a.tokensUsed ?? parseTokenUsage(a.stdout),
+    }));
+    const finalStatus = executionResult.failFast
+        ? 'failed'
+        : determineSessionStatus(finalAgents);
+    sessions.set(sessionId, {
+        ...session,
+        agents: finalAgents,
+        status: finalStatus,
+        completedAt: new Date().toISOString(),
+    });
+    return buildOrchestrationResult(sessionId, finalAgents, assignments, config.options.conflictStrategy, startTime);
+}
+/**
+ * Execute the orchestration by spawning agents per the execution graph.
+ * Returns updated agents and whether failFast was triggered.
+ */
+async function executeOrchestration(session, agentConfigs, tracker, config) {
+    const handoffs = generateAllHandoffs(agentConfigs, session.tasks, session.fileOwnershipMap);
+    const updatedAgents = [...session.agents];
+    for (const assignment of session.tasks) {
+        const agentConfig = agentConfigs.find((a) => a.id === assignment.agentId);
+        if (!agentConfig) {
+            continue;
+        }
+        const agentIdx = updatedAgents.findIndex((a) => a.agentId === assignment.agentId);
+        if (agentIdx < 0) {
+            continue;
+        }
+        const handoff = handoffs.find((h) => h.agentId === assignment.agentId);
+        const prompt = handoff ? formatHandoffAsPrompt(handoff) : assignment.context;
+        tracker.updateTaskStatus(assignment.taskId, 'in_progress');
+        const currentAgent = updatedAgents[agentIdx];
+        /* v8 ignore next 3 */
+        if (!currentAgent) {
+            continue;
+        }
+        const updatedAgent = await spawnWithRetry(agentConfig, currentAgent, prompt, config, tracker);
+        updatedAgents[agentIdx] = updatedAgent;
+        const taskStatus = updatedAgent.status === 'completed' ? 'completed' : 'failed';
+        tracker.updateTaskStatus(assignment.taskId, taskStatus);
+        // Fail fast if configured — return early to signal failure
+        if (config.options.failFast && updatedAgent.status === 'failed') {
+            return { agents: updatedAgents, failFast: true };
+        }
+    }
+    return { agents: updatedAgents, failFast: false };
+}
+/**
+ * Spawn an agent with retry logic (AC-08).
+ */
+async function spawnWithRetry(agentConfig, initialProcess, prompt, config, tracker) {
+    const maxRetries = config.options.maxRetries;
+    let current = initialProcess;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const descriptor = buildSpawnDescriptor(agentConfig, prompt, config.options.spawnMethod, config.options.timeoutMs);
+        tracker.updateAgentStatus(current.agentId, 'spawning');
+        const result = await spawnAgent(descriptor, current, (id, status) => {
+            tracker.updateAgentStatus(id, status);
+        });
+        if (result.status === 'completed') {
+            return result;
+        }
+        current = {
+            ...result,
+            retryCount: attempt + 1,
+        };
+        if (attempt < maxRetries) {
+            // Reset for retry
+            current = {
+                ...current,
+                status: 'pending',
+                stdout: '',
+                stderr: '',
+                exitCode: undefined,
+                completedAt: undefined,
+            };
+        }
+    }
+    return current;
+}
+/**
+ * Build a dry-run result without spawning processes.
+ */
+function buildDryRunResult(sessionId, agents, assignments, executionGraph, startTime) {
+    const dryRunAgents = agents.map((a) => ({
+        ...a,
+        status: 'completed',
+        completedAt: new Date().toISOString(),
+    }));
+    return {
+        sessionId,
+        agents: dryRunAgents,
+        tasks: assignments.map((a) => ({
+            taskId: a.taskId,
+            agentId: a.agentId,
+            status: 'completed',
+            output: {
+                dryRun: true,
+                executionGraph,
+                assignment: a,
+            },
+            duration: 0,
+        })),
+        outputs: { dryRun: true, executionGraph },
+        conflicts: [],
+        duration: Date.now() - startTime,
+        totalCost: { tokens: 0, usd: 0, breakdown: {} },
+    };
+}
+/**
+ * Get current status of an orchestration session.
+ */
+export function getStatus(sessionId) {
+    return sessions.get(sessionId);
+}
+/**
+ * List all sessions, optionally filtered by status.
+ */
+export function listSessions(filter) {
+    const all = [...sessions.values()];
+    if (!filter) {
+        return all;
+    }
+    return all.filter((s) => s.status === filter);
+}
+/**
+ * Cancel an active orchestration session.
+ */
+export function cancelOrchestration(sessionId) {
+    const session = sessions.get(sessionId);
+    if (!session) {
+        return false;
+    }
+    if (session.status === 'completed' || session.status === 'cancelled') {
+        return false;
+    }
+    sessions.set(sessionId, {
+        ...session,
+        status: 'cancelled',
+        completedAt: new Date().toISOString(),
+    });
+    return true;
+}
+/**
+ * Determine overall session status from agent results.
+ */
+function determineSessionStatus(agents) {
+    if (agents.every((a) => a.status === 'completed')) {
+        return 'completed';
+    }
+    if (agents.every((a) => a.status === 'failed')) {
+        return 'failed';
+    }
+    return 'completed'; // partial success = completed
+}
+/**
+ * Build default agent configs when none are provided.
+ */
+function buildDefaultAgents(count) {
+    return Array.from({ length: count }, (_, i) => ({
+        id: `agent-${String(i + 1)}`,
+        command: 'claude',
+        args: [],
+        capabilities: ['general'],
+        modelTier: 'sonnet',
+    }));
+}
+/** Clear all sessions (for testing). */
+export function clearSessions() {
+    sessions.clear();
+    sessionCounter = 0;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/engine/orchestrator/runtime.js.map

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

package/dist/engine/orchestrator/task-distributor.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeTaskDescription, RuntimeAgentConfig, RuntimeTaskAssignment } from '../../types/index.js';
+/**
+ * Distribute tasks among available agents.
+ * Uses capability matching and ensures no file ownership conflicts.
+ * Tasks with dependencies are assigned but their dependency list is preserved.
+ */
+export declare function distributeTasks(tasks: RuntimeTaskDescription[], agents: RuntimeAgentConfig[]): RuntimeTaskAssignment[];
+//# sourceMappingURL=task-distributor.d.ts.map

package/dist/engine/orchestrator/task-distributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-distributor.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/task-distributor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAsC9B;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,sBAAsB,EAAE,EAC/B,MAAM,EAAE,kBAAkB,EAAE,GAC3B,qBAAqB,EAAE,CAwCzB"}

package/dist/engine/orchestrator/task-distributor.js

@@ -0,0 +1,106 @@
+// orchestrator/task-distributor.ts — Task distribution engine (SPEC-079 AC-04)
+// Matches tasks to agents based on capabilities and file ownership.
+/**
+ * Score how well an agent matches a task's requirements.
+ * Higher score = better match.
+ */
+function scoreAgentForTask(agent, task) {
+    let score = 0;
+    // Capability matching: +2 per matching requirement
+    for (const req of task.requirements) {
+        const reqLower = req.toLowerCase();
+        for (const cap of agent.capabilities) {
+            if (cap.toLowerCase().includes(reqLower) || reqLower.includes(cap.toLowerCase())) {
+                score += 2;
+                break;
+            }
+        }
+    }
+    // File pattern matching: +1 per overlapping file
+    for (const file of task.files) {
+        for (const cap of agent.capabilities) {
+            if (file.includes(cap) || cap.includes(file)) {
+                score += 1;
+                break;
+            }
+        }
+    }
+    // Base score if agent has any capabilities matching
+    if (score === 0 && agent.capabilities.length > 0) {
+        score = 1; // fallback: at least give a base score
+    }
+    return score;
+}
+/**
+ * Distribute tasks among available agents.
+ * Uses capability matching and ensures no file ownership conflicts.
+ * Tasks with dependencies are assigned but their dependency list is preserved.
+ */
+export function distributeTasks(tasks, agents) {
+    if (agents.length === 0 || tasks.length === 0) {
+        return [];
+    }
+    // Sort tasks by priority (higher first) then by criticality
+    const sorted = [...tasks].sort((a, b) => {
+        if (a.critical !== b.critical) {
+            return a.critical ? -1 : 1;
+        }
+        return b.priority - a.priority;
+    });
+    const assignments = [];
+    const fileOwnership = new Map();
+    for (const task of sorted) {
+        const bestAgent = findBestAgent(task, agents, fileOwnership);
+        if (!bestAgent) {
+            continue;
+        }
+        // Assign files to this agent
+        for (const file of task.files) {
+            if (!fileOwnership.has(file)) {
+                fileOwnership.set(file, bestAgent.id);
+            }
+        }
+        assignments.push({
+            taskId: task.id,
+            agentId: bestAgent.id,
+            files: task.files,
+            context: `Task: ${task.description}`,
+            priority: task.priority,
+            dependencies: task.dependencies,
+        });
+    }
+    return assignments;
+}
+/**
+ * Find the best agent for a task, avoiding file ownership conflicts.
+ */
+function findBestAgent(task, agents, fileOwnership) {
+    const scored = agents
+        .map((agent) => ({
+        agent,
+        score: scoreAgentForTask(agent, task),
+        conflicts: countFileConflicts(task, agent, fileOwnership),
+    }))
+        .sort((a, b) => {
+        // Prefer fewer conflicts, then higher score
+        if (a.conflicts !== b.conflicts) {
+            return a.conflicts - b.conflicts;
+        }
+        return b.score - a.score;
+    });
+    return scored[0]?.agent;
+}
+/**
+ * Count how many files in a task are already owned by a different agent.
+ */
+function countFileConflicts(task, agent, fileOwnership) {
+    let conflicts = 0;
+    for (const file of task.files) {
+        const owner = fileOwnership.get(file);
+        if (owner !== undefined && owner !== agent.id) {
+            conflicts++;
+        }
+    }
+    return conflicts;
+}
+//# sourceMappingURL=task-distributor.js.map

package/dist/engine/orchestrator/task-distributor.js.map

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

package/dist/engine/orchestrator/topologies.d.ts

@@ -0,0 +1,30 @@
+import type { RuntimeTopologyType, RuntimeTaskAssignment, RuntimeAgentProcess, RuntimeExecutionGraph } from '../../types/index.js';
+/**
+ * Plan execution graph for mesh topology.
+ * All agents work in parallel — no dependencies between tasks.
+ * Results are reconciled at the end.
+ */
+export declare function planMeshExecution(tasks: RuntimeTaskAssignment[], agents: RuntimeAgentProcess[]): RuntimeExecutionGraph;
+/**
+ * Plan execution graph for hierarchical topology.
+ * First agent is coordinator (phase 0), remaining are workers (phase 1).
+ * Workers depend on the coordinator task completing first.
+ */
+export declare function planHierarchicalExecution(tasks: RuntimeTaskAssignment[], agents: RuntimeAgentProcess[]): RuntimeExecutionGraph;
+/**
+ * Plan execution graph for pipeline topology.
+ * Tasks execute sequentially — each depends on the previous one.
+ */
+export declare function planPipelineExecution(tasks: RuntimeTaskAssignment[], _agents: RuntimeAgentProcess[]): RuntimeExecutionGraph;
+/**
+ * Plan execution graph for star topology.
+ * First agent is the hub (phase 0), all others are spokes (phase 1).
+ * Spokes run in parallel but each depends on the hub.
+ */
+export declare function planStarExecution(tasks: RuntimeTaskAssignment[], agents: RuntimeAgentProcess[]): RuntimeExecutionGraph;
+/**
+ * Plan execution for the given topology type.
+ * Delegates to the appropriate topology strategy.
+ */
+export declare function planExecution(topology: RuntimeTopologyType, tasks: RuntimeTaskAssignment[], agents: RuntimeAgentProcess[]): RuntimeExecutionGraph;
+//# sourceMappingURL=topologies.d.ts.map

package/dist/engine/orchestrator/topologies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologies.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/topologies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,qBAAqB,EAAE,EAC9B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,qBAAqB,CAYvB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,EAAE,EAC9B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,qBAAqB,CA8BvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,EAAE,EAC9B,OAAO,EAAE,mBAAmB,EAAE,GAC7B,qBAAqB,CASvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,qBAAqB,EAAE,EAC9B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,qBAAqB,CAIvB;AAaD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,qBAAqB,EAAE,EAC9B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,qBAAqB,CAGvB"}