@planu/cli 0.30.0 → 0.31.0

package/dist/engine/orchestrator/agent-spawner.js

@@ -0,0 +1,117 @@
+// orchestrator/agent-spawner.ts — Agent process spawning (SPEC-079 AC-03)
+// Launches agents as CLI subprocesses with configurable commands.
+/**
+ * Build a spawn descriptor for an agent based on spawn method.
+ * Language-agnostic: command is fully configurable per agent.
+ */
+export function buildSpawnDescriptor(agent, context, spawnMethod, timeoutMs) {
+    const baseArgs = [...agent.args];
+    if (spawnMethod === 'cli-subprocess') {
+        // For CLI subprocess, append the context as a prompt argument
+        if (agent.command.includes('claude')) {
+            baseArgs.push('-p', context);
+        }
+        else {
+            baseArgs.push('--context', context);
+        }
+    }
+    return {
+        command: agent.command,
+        args: baseArgs,
+        env: {
+            ORCHESTRATION_AGENT_ID: agent.id,
+            ORCHESTRATION_MODEL_TIER: agent.modelTier ?? 'sonnet',
+        },
+        cwd: agent.workDir ?? process.cwd(),
+        timeoutMs,
+    };
+}
+/**
+ * Create an initial AgentProcess record in pending state.
+ */
+export function createAgentProcess(agentId) {
+    return {
+        agentId,
+        pid: 0,
+        status: 'pending',
+        startedAt: new Date().toISOString(),
+        stdout: '',
+        stderr: '',
+        retryCount: 0,
+    };
+}
+/**
+ * Spawn an agent as a child process (real execution).
+ * Returns a new RuntimeAgentProcess with the result.
+ * In tests, this function should be mocked.
+ */
+export async function spawnAgent(descriptor, initial, onProgress) {
+    // Dynamic import to allow mocking in tests
+    const { spawn } = await import('node:child_process');
+    return new Promise((resolve) => {
+        const result = { ...initial, status: 'spawning' };
+        onProgress?.(result.agentId, 'spawning');
+        const child = spawn(descriptor.command, descriptor.args, {
+            cwd: descriptor.cwd,
+            env: { ...process.env, ...descriptor.env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        result.pid = child.pid ?? 0;
+        result.status = 'running';
+        onProgress?.(result.agentId, 'running');
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        const timer = setTimeout(() => {
+            child.kill('SIGTERM');
+            result.status = 'failed';
+            result.stderr = `${stderr}\n[TIMEOUT]`;
+            result.stdout = stdout;
+            result.completedAt = new Date().toISOString();
+            onProgress?.(result.agentId, 'failed');
+            resolve(result);
+        }, descriptor.timeoutMs);
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            result.stdout = stdout;
+            result.stderr = stderr;
+            result.exitCode = code ?? 1;
+            result.status = code === 0 ? 'completed' : 'failed';
+            result.completedAt = new Date().toISOString();
+            onProgress?.(result.agentId, result.status);
+            resolve(result);
+        });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            result.status = 'failed';
+            result.stderr = `${stderr}\n[SPAWN ERROR] ${err.message}`;
+            result.stdout = stdout;
+            result.completedAt = new Date().toISOString();
+            onProgress?.(result.agentId, 'failed');
+            resolve(result);
+        });
+    });
+}
+/**
+ * Parse token usage from agent stdout.
+ * Looks for patterns like "Tokens used: 1234" or JSON with token counts.
+ */
+export function parseTokenUsage(stdout) {
+    // Try structured JSON pattern
+    const jsonMatch = /\{[^}]*"tokens"\s*:\s*(\d+)[^}]*\}/u.exec(stdout);
+    if (jsonMatch?.[1]) {
+        return parseInt(jsonMatch[1], 10);
+    }
+    // Try plain text pattern
+    const textMatch = /tokens?\s*(?:used|consumed|count)\s*[:=]\s*(\d+)/iu.exec(stdout);
+    if (textMatch?.[1]) {
+        return parseInt(textMatch[1], 10);
+    }
+    return 0;
+}
+//# sourceMappingURL=agent-spawner.js.map

package/dist/engine/orchestrator/agent-spawner.js.map

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

package/dist/engine/orchestrator/conflict-resolver.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeConflictStrategy, RuntimeConflictRecord } from '../../types/index.js';
+/**
+ * Resolve a file conflict between multiple agents using the configured strategy.
+ */
+export declare function resolveConflict(file: string, agents: string[], strategy: RuntimeConflictStrategy): RuntimeConflictRecord;
+/**
+ * Get the winning agent for a conflict given the strategy.
+ * Returns undefined for unresolved conflicts.
+ */
+export declare function getConflictWinner(record: RuntimeConflictRecord): string | undefined;
+//# sourceMappingURL=conflict-resolver.d.ts.map

package/dist/engine/orchestrator/conflict-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/conflict-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE3F;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,uBAAuB,GAChC,qBAAqB,CAgCvB;AA8BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAenF"}

package/dist/engine/orchestrator/conflict-resolver.js

@@ -0,0 +1,81 @@
+// orchestrator/conflict-resolver.ts — File conflict resolution (SPEC-079 AC-06)
+// Strategies: last-wins, first-wins, merge-auto, flag-for-review.
+/**
+ * Resolve a file conflict between multiple agents using the configured strategy.
+ */
+export function resolveConflict(file, agents, strategy) {
+    switch (strategy) {
+        case 'last-wins':
+            return {
+                file,
+                agents,
+                strategy,
+                resolved: true,
+                resolution: `Agent ${agents[agents.length - 1] ?? 'unknown'} wins (last writer)`,
+            };
+        case 'first-wins':
+            return {
+                file,
+                agents,
+                strategy,
+                resolved: true,
+                resolution: `Agent ${agents[0] ?? 'unknown'} wins (first writer)`,
+            };
+        case 'merge-auto':
+            return resolveMergeAuto(file, agents);
+        case 'flag-for-review':
+            return {
+                file,
+                agents,
+                strategy,
+                resolved: false,
+                resolution: `Conflict flagged for manual review. Agents: ${agents.join(', ')}`,
+            };
+    }
+}
+/**
+ * Attempt automatic merge of changes from multiple agents.
+ * If changes don't overlap in lines, merge succeeds.
+ * Otherwise, falls back to flag-for-review.
+ */
+function resolveMergeAuto(file, agents) {
+    // In a real implementation, this would use diff3 to attempt merge.
+    // For now, we flag non-trivial conflicts for review.
+    // Simple heuristic: if only 2 agents, attempt merge; 3+ always flag.
+    if (agents.length === 2) {
+        return {
+            file,
+            agents,
+            strategy: 'merge-auto',
+            resolved: true,
+            resolution: `Auto-merge attempted for ${file} between agents ${agents.join(' and ')}`,
+        };
+    }
+    return {
+        file,
+        agents,
+        strategy: 'merge-auto',
+        resolved: false,
+        resolution: `Auto-merge not possible for ${file} with ${String(agents.length)} agents. Flagged for review.`,
+    };
+}
+/**
+ * Get the winning agent for a conflict given the strategy.
+ * Returns undefined for unresolved conflicts.
+ */
+export function getConflictWinner(record) {
+    if (!record.resolved) {
+        return undefined;
+    }
+    switch (record.strategy) {
+        case 'last-wins':
+            return record.agents[record.agents.length - 1];
+        case 'first-wins':
+            return record.agents[0];
+        case 'merge-auto':
+            return undefined; // Merged, no single winner
+        case 'flag-for-review':
+            return undefined;
+    }
+}
+//# sourceMappingURL=conflict-resolver.js.map

package/dist/engine/orchestrator/conflict-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.js","sourceRoot":"","sources":["../../../src/engine/orchestrator/conflict-resolver.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kEAAkE;AAIlE;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,MAAgB,EAChB,QAAiC;IAEjC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ;gBACR,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,qBAAqB;aACjF,CAAC;QAEJ,KAAK,YAAY;YACf,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ;gBACR,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,sBAAsB;aAClE,CAAC;QAEJ,KAAK,YAAY;YACf,OAAO,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAExC,KAAK,iBAAiB;YACpB,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,QAAQ;gBACR,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,+CAA+C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC/E,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,IAAY,EAAE,MAAgB;IACtD,mEAAmE;IACnE,qDAAqD;IACrD,qEAAqE;IACrE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,IAAI;YACJ,MAAM;YACN,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,4BAA4B,IAAI,mBAAmB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;SACtF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,MAAM;QACN,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,KAAK;QACf,UAAU,EAAE,+BAA+B,IAAI,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,8BAA8B;KAC5G,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA6B;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,KAAK,YAAY;YACf,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,YAAY;YACf,OAAO,SAAS,CAAC,CAAC,2BAA2B;QAC/C,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/engine/orchestrator/file-ownership.d.ts

@@ -0,0 +1,25 @@
+import type { RuntimeTaskAssignment } from '../../types/index.js';
+/**
+ * Generate a FileOwnershipMap from task assignments.
+ * Maps each file path to the agent that owns it.
+ * If multiple agents claim the same file, the first assignment wins
+ * and conflicts are returned separately.
+ */
+export declare function generateFileOwnershipMap(assignments: RuntimeTaskAssignment[]): {
+    map: Record<string, string>;
+    conflicts: string[];
+};
+/**
+ * Get the list of files owned by a specific agent.
+ */
+export declare function getAgentFiles(ownershipMap: Record<string, string>, agentId: string): string[];
+/**
+ * Check if an agent owns a specific file.
+ */
+export declare function agentOwnsFile(ownershipMap: Record<string, string>, agentId: string, file: string): boolean;
+/**
+ * Format ownership map as markdown for agent handoff context.
+ * Uses relative paths (not absolute) for language-agnostic portability.
+ */
+export declare function formatOwnershipContext(ownershipMap: Record<string, string>, agentId: string): string;
+//# sourceMappingURL=file-ownership.d.ts.map

package/dist/engine/orchestrator/file-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ownership.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/file-ownership.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG;IAC9E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAkBA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,OAAO,EAAE,MAAM,GACd,MAAM,CAmBR"}

package/dist/engine/orchestrator/file-ownership.js

@@ -0,0 +1,62 @@
+// orchestrator/file-ownership.ts — File ownership map generation (SPEC-079 AC-09)
+// Generates ownership maps from task assignments, ensuring no conflicts.
+/**
+ * Generate a FileOwnershipMap from task assignments.
+ * Maps each file path to the agent that owns it.
+ * If multiple agents claim the same file, the first assignment wins
+ * and conflicts are returned separately.
+ */
+export function generateFileOwnershipMap(assignments) {
+    const map = {};
+    const conflicts = [];
+    for (const assignment of assignments) {
+        for (const file of assignment.files) {
+            const existing = map[file];
+            if (existing !== undefined && existing !== assignment.agentId) {
+                if (!conflicts.includes(file)) {
+                    conflicts.push(file);
+                }
+            }
+            else if (existing === undefined) {
+                map[file] = assignment.agentId;
+            }
+        }
+    }
+    return { map, conflicts };
+}
+/**
+ * Get the list of files owned by a specific agent.
+ */
+export function getAgentFiles(ownershipMap, agentId) {
+    return Object.entries(ownershipMap)
+        .filter(([, owner]) => owner === agentId)
+        .map(([file]) => file);
+}
+/**
+ * Check if an agent owns a specific file.
+ */
+export function agentOwnsFile(ownershipMap, agentId, file) {
+    return ownershipMap[file] === agentId;
+}
+/**
+ * Format ownership map as markdown for agent handoff context.
+ * Uses relative paths (not absolute) for language-agnostic portability.
+ */
+export function formatOwnershipContext(ownershipMap, agentId) {
+    const ownedFiles = getAgentFiles(ownershipMap, agentId);
+    const otherFiles = Object.entries(ownershipMap)
+        .filter(([, owner]) => owner !== agentId)
+        .map(([file, owner]) => `  - ${file} (owned by ${owner})`);
+    const lines = [
+        '## File Ownership',
+        '',
+        '### Your files (read + write):',
+        ...ownedFiles.map((f) => `  - ${f}`),
+        '',
+    ];
+    if (otherFiles.length > 0) {
+        lines.push('### Other files (read only):', ...otherFiles, '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=file-ownership.js.map

package/dist/engine/orchestrator/file-ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ownership.js","sourceRoot":"","sources":["../../../src/engine/orchestrator/file-ownership.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,yEAAyE;AAIzE;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAoC;IAI3E,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC9D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoC,EAAE,OAAe;IACjF,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAoC,EACpC,OAAe,EACf,IAAY;IAEZ,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAAoC,EACpC,OAAe;IAEf,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,cAAc,KAAK,GAAG,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG;QACZ,mBAAmB;QACnB,EAAE;QACF,gCAAgC;QAChC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,EAAE;KACH,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/orchestrator/handoff-generator.d.ts

@@ -0,0 +1,20 @@
+import type { RuntimeTaskAssignment, RuntimeHandoffPackage, RuntimeAgentConfig } from '../../types/index.js';
+/**
+ * Generate a handoff package for a specific agent.
+ * Includes context, files, restrictions, and success criteria.
+ */
+export declare function generateHandoffPackage(agent: RuntimeAgentConfig, assignment: RuntimeTaskAssignment, ownershipMap: Record<string, string>, previousOutput?: string): RuntimeHandoffPackage;
+/**
+ * Generate handoff packages for all agents in the session.
+ */
+export declare function generateAllHandoffs(agents: RuntimeAgentConfig[], assignments: RuntimeTaskAssignment[], ownershipMap: Record<string, string>): RuntimeHandoffPackage[];
+/**
+ * Generate a pipeline handoff: output of previous agent becomes context for next.
+ */
+export declare function generatePipelineHandoff(agents: RuntimeAgentConfig[], assignments: RuntimeTaskAssignment[], ownershipMap: Record<string, string>, previousOutputs: Map<string, string>): RuntimeHandoffPackage[];
+/**
+ * Format a handoff package as a markdown prompt string.
+ * Language-agnostic format: works for any agent type.
+ */
+export declare function formatHandoffAsPrompt(handoff: RuntimeHandoffPackage): string;
+//# sourceMappingURL=handoff-generator.d.ts.map

package/dist/engine/orchestrator/handoff-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/handoff-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAG9B;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,qBAAqB,EACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,cAAc,CAAC,EAAE,MAAM,GACtB,qBAAqB,CAoCvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,WAAW,EAAE,qBAAqB,EAAE,EACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,qBAAqB,EAAE,CAWzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAAE,EAC5B,WAAW,EAAE,qBAAqB,EAAE,EACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,qBAAqB,EAAE,CAqBzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAe5E"}

package/dist/engine/orchestrator/handoff-generator.js

@@ -0,0 +1,95 @@
+// orchestrator/handoff-generator.ts — Handoff package generation (SPEC-079 AC-12)
+// Generates complete context packages for each agent.
+import { getAgentFiles, formatOwnershipContext } from './file-ownership.js';
+/**
+ * Generate a handoff package for a specific agent.
+ * Includes context, files, restrictions, and success criteria.
+ */
+export function generateHandoffPackage(agent, assignment, ownershipMap, previousOutput) {
+    const ownedFiles = getAgentFiles(ownershipMap, agent.id);
+    const otherAgentFiles = Object.entries(ownershipMap)
+        .filter(([, owner]) => owner !== agent.id)
+        .map(([file]) => file);
+    const restrictions = otherAgentFiles.map((f) => `DO NOT modify ${f} (owned by another agent)`);
+    const ownershipContext = formatOwnershipContext(ownershipMap, agent.id);
+    const contextParts = [ownershipContext, `\n## Task\n${assignment.context}`];
+    if (previousOutput) {
+        contextParts.push(`\n## Previous Agent Output\n${previousOutput}`);
+    }
+    if (assignment.dependencies.length > 0) {
+        contextParts.push(`\n## Dependencies\nThis task depends on: ${assignment.dependencies.join(', ')}`);
+    }
+    return {
+        agentId: agent.id,
+        role: agent.capabilities[0] ?? 'general',
+        filesToRead: [...ownedFiles, ...otherAgentFiles],
+        filesToModify: ownedFiles,
+        restrictions,
+        instructions: assignment.context,
+        context: contextParts.join('\n'),
+        successCriteria: [
+            `Complete task: ${assignment.context}`,
+            `Only modify assigned files: ${ownedFiles.join(', ')}`,
+            'Report any issues or blockers encountered',
+        ],
+        dependencies: assignment.dependencies,
+    };
+}
+/**
+ * Generate handoff packages for all agents in the session.
+ */
+export function generateAllHandoffs(agents, assignments, ownershipMap) {
+    return assignments.map((assignment) => {
+        const agent = agents.find((a) => a.id === assignment.agentId);
+        const defaultAgent = {
+            id: assignment.agentId,
+            command: '',
+            args: [],
+            capabilities: [],
+        };
+        return generateHandoffPackage(agent ?? defaultAgent, assignment, ownershipMap);
+    });
+}
+/**
+ * Generate a pipeline handoff: output of previous agent becomes context for next.
+ */
+export function generatePipelineHandoff(agents, assignments, ownershipMap, previousOutputs) {
+    return assignments.map((assignment, index) => {
+        const agent = agents.find((a) => a.id === assignment.agentId);
+        const defaultAgent = {
+            id: assignment.agentId,
+            command: '',
+            args: [],
+            capabilities: [],
+        };
+        // Get previous agent's output for pipeline chain
+        let previousOutput;
+        if (index > 0) {
+            const prevAssignment = assignments[index - 1];
+            if (prevAssignment) {
+                previousOutput = previousOutputs.get(prevAssignment.agentId);
+            }
+        }
+        return generateHandoffPackage(agent ?? defaultAgent, assignment, ownershipMap, previousOutput);
+    });
+}
+/**
+ * Format a handoff package as a markdown prompt string.
+ * Language-agnostic format: works for any agent type.
+ */
+export function formatHandoffAsPrompt(handoff) {
+    const lines = [
+        `# Agent Handoff: ${handoff.agentId}`,
+        `**Role**: ${handoff.role}`,
+        '',
+        handoff.context,
+        '',
+        '## Success Criteria',
+        ...handoff.successCriteria.map((c) => `- ${c}`),
+        '',
+        '## Restrictions',
+        ...(handoff.restrictions.length > 0 ? handoff.restrictions.map((r) => `- ${r}`) : ['- None']),
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=handoff-generator.js.map

package/dist/engine/orchestrator/handoff-generator.js.map

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

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

@@ -0,0 +1,10 @@
+export { startOrchestration, getStatus, listSessions, cancelOrchestration, clearSessions, } from './runtime.js';
+export { planExecution } from './topologies.js';
+export { distributeTasks } from './task-distributor.js';
+export { buildSpawnDescriptor, createAgentProcess, spawnAgent, parseTokenUsage, } from './agent-spawner.js';
+export { generateFileOwnershipMap, getAgentFiles, agentOwnsFile, formatOwnershipContext, } from './file-ownership.js';
+export { collectTaskResults, parseAgentOutput, detectAndResolveConflicts, calculateCost, buildOrchestrationResult, } from './result-collector.js';
+export { resolveConflict, getConflictWinner } from './conflict-resolver.js';
+export { ProgressTracker } from './progress-tracker.js';
+export { generateHandoffPackage, generateAllHandoffs, generatePipelineHandoff, formatHandoffAsPrompt, } from './handoff-generator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,aAAa,EACb,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/engine/orchestrator/index.js

@@ -0,0 +1,11 @@
+// orchestrator/index.ts — Barrel re-export for SPEC-079 orchestration runtime
+export { startOrchestration, getStatus, listSessions, cancelOrchestration, clearSessions, } from './runtime.js';
+export { planExecution } from './topologies.js';
+export { distributeTasks } from './task-distributor.js';
+export { buildSpawnDescriptor, createAgentProcess, spawnAgent, parseTokenUsage, } from './agent-spawner.js';
+export { generateFileOwnershipMap, getAgentFiles, agentOwnsFile, formatOwnershipContext, } from './file-ownership.js';
+export { collectTaskResults, parseAgentOutput, detectAndResolveConflicts, calculateCost, buildOrchestrationResult, } from './result-collector.js';
+export { resolveConflict, getConflictWinner } from './conflict-resolver.js';
+export { ProgressTracker } from './progress-tracker.js';
+export { generateHandoffPackage, generateAllHandoffs, generatePipelineHandoff, formatHandoffAsPrompt, } from './handoff-generator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/orchestrator/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,aAAa,EACb,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/engine/orchestrator/progress-tracker.d.ts

@@ -0,0 +1,32 @@
+import type { RuntimeAgentProcess, RuntimeAgentStatus, RuntimeTaskAssignment, RuntimeTaskStatus, RuntimeProgressEvent, RuntimeProgressCallback } from '../../types/index.js';
+/**
+ * Progress tracker for an orchestration session.
+ * Uses callback pattern (not EventEmitter) to avoid extra dependencies.
+ */
+export declare class ProgressTracker {
+    private readonly sessionId;
+    private readonly agents;
+    private readonly tasks;
+    private readonly callbacks;
+    private readonly timeline;
+    constructor(sessionId: string);
+    /** Register a progress callback. */
+    onProgress(callback: RuntimeProgressCallback): void;
+    /** Initialize tracking for agents and tasks. */
+    init(agentProcesses: RuntimeAgentProcess[], assignments: RuntimeTaskAssignment[]): void;
+    /** Update agent status and emit event. */
+    updateAgentStatus(agentId: string, status: RuntimeAgentStatus): void;
+    /** Update task status and emit event. */
+    updateTaskStatus(taskId: string, status: RuntimeTaskStatus): void;
+    /** Calculate completion percentage. */
+    getCompletionPercent(): number;
+    /** Get timeline of all events. */
+    getTimeline(): RuntimeProgressEvent[];
+    /** Get current agent statuses. */
+    getAgentStatuses(): Record<string, RuntimeAgentStatus>;
+    /** Get current task statuses. */
+    getTaskStatuses(): Record<string, RuntimeTaskStatus>;
+    /** Emit a progress event to all callbacks. */
+    private emit;
+}
+//# sourceMappingURL=progress-tracker.d.ts.map

package/dist/engine/orchestrator/progress-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/progress-tracker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CASlB;IACJ,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;gBAE3C,SAAS,EAAE,MAAM;IAI7B,oCAAoC;IACpC,UAAU,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAInD,gDAAgD;IAChD,IAAI,CAAC,cAAc,EAAE,mBAAmB,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI;IAavF,0CAA0C;IAC1C,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAWpE,yCAAyC;IACzC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAoBjE,uCAAuC;IACvC,oBAAoB,IAAI,MAAM;IAgB9B,kCAAkC;IAClC,WAAW,IAAI,oBAAoB,EAAE;IAIrC,kCAAkC;IAClC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAItD,iCAAiC;IACjC,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAQpD,8CAA8C;IAC9C,OAAO,CAAC,IAAI;CAMb"}

package/dist/engine/orchestrator/progress-tracker.js

@@ -0,0 +1,102 @@
+// orchestrator/progress-tracker.ts — Progress tracking (SPEC-079 AC-07)
+// Tracks agent and task status, emits progress events via callbacks.
+/**
+ * Progress tracker for an orchestration session.
+ * Uses callback pattern (not EventEmitter) to avoid extra dependencies.
+ */
+export class ProgressTracker {
+    sessionId;
+    agents = new Map();
+    tasks = new Map();
+    callbacks = [];
+    timeline = [];
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+    }
+    /** Register a progress callback. */
+    onProgress(callback) {
+        this.callbacks.push(callback);
+    }
+    /** Initialize tracking for agents and tasks. */
+    init(agentProcesses, assignments) {
+        for (const agent of agentProcesses) {
+            this.agents.set(agent.agentId, agent.status);
+        }
+        for (const task of assignments) {
+            this.tasks.set(task.taskId, {
+                taskId: task.taskId,
+                agentId: task.agentId,
+                status: 'queued',
+            });
+        }
+    }
+    /** Update agent status and emit event. */
+    updateAgentStatus(agentId, status) {
+        this.agents.set(agentId, status);
+        this.emit({
+            sessionId: this.sessionId,
+            agentId,
+            type: 'agent-status',
+            data: { status },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /** Update task status and emit event. */
+    updateTaskStatus(taskId, status) {
+        const tracked = this.tasks.get(taskId);
+        if (tracked) {
+            tracked.status = status;
+            if (status === 'in_progress' && !tracked.startedAt) {
+                tracked.startedAt = new Date().toISOString();
+            }
+            if (status === 'completed' || status === 'failed') {
+                tracked.completedAt = new Date().toISOString();
+            }
+        }
+        this.emit({
+            sessionId: this.sessionId,
+            taskId,
+            type: 'task-status',
+            data: { status },
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /** Calculate completion percentage. */
+    getCompletionPercent() {
+        const total = this.tasks.size;
+        if (total === 0) {
+            return 100;
+        }
+        let completed = 0;
+        for (const task of this.tasks.values()) {
+            if (task.status === 'completed') {
+                completed++;
+            }
+        }
+        return Math.round((completed / total) * 100);
+    }
+    /** Get timeline of all events. */
+    getTimeline() {
+        return [...this.timeline];
+    }
+    /** Get current agent statuses. */
+    getAgentStatuses() {
+        return Object.fromEntries(this.agents);
+    }
+    /** Get current task statuses. */
+    getTaskStatuses() {
+        const result = {};
+        for (const [id, tracked] of this.tasks) {
+            result[id] = tracked.status;
+        }
+        return result;
+    }
+    /** Emit a progress event to all callbacks. */
+    emit(event) {
+        this.timeline.push(event);
+        for (const cb of this.callbacks) {
+            cb(event);
+        }
+    }
+}
+//# sourceMappingURL=progress-tracker.js.map

package/dist/engine/orchestrator/progress-tracker.js.map

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