copilot-flow 1.4.0 → 2.0.0

package/README.md

@@ -86,6 +86,13 @@ copilot-flow agent spawn --type coder --task "..." \
 # Disable retries entirely
 copilot-flow agent spawn --type coder --task "..." --no-retry
 
+# Override session timeout (default: 120 s — increase for large/complex tasks)
+copilot-flow agent spawn --task "..." --timeout 300000   # 5 minutes
+copilot-flow swarm start --spec big-task.md --timeout 600000  # 10 minutes
+
+# Verbose mode: see session lifecycle, model, prompt size, and retry events
+copilot-flow agent spawn --task "..." --verbose
+
 # List agent states
 copilot-flow agent list
 copilot-flow agent types
@@ -120,6 +127,75 @@ copilot-flow swarm init --topology hierarchical --max-agents 8
 copilot-flow swarm status
 ```
 
+### `plan` / `exec` — phased pipelines
+
+For multi-phase projects where one swarm feeds into the next, use `plan` to generate
+a structured YAML plan from a spec, then `exec` to run it.
+
+```bash
+# 1. Generate a phases.yaml from a spec file
+copilot-flow plan spec.md                  # writes phases.yaml
+copilot-flow plan spec.md -f my-plan.yaml  # custom output file
+
+# 2. Execute all phases in order
+copilot-flow exec phases.yaml
+
+# 3. Execute a single phase (deps must already have output files on disk)
+copilot-flow exec phases.yaml --phase implement
+
+# 4. Re-run a phase even if its output file exists
+copilot-flow exec phases.yaml --phase implement --force
+
+# 5. Stream output as it arrives
+copilot-flow exec phases.yaml --stream
+```
+
+**How it works:**
+
+1. `plan` runs an `analyst` agent against your spec and produces a `phases.yaml` file.
+2. `exec` reads the plan, resolves execution order, and runs each phase:
+   - **`type: agent`** — single specialist agent
+   - **`type: swarm`** — multi-agent pipeline with a configurable topology
+3. Each phase writes its output to `phase-{id}.md` (or a custom filename set in the YAML).
+4. Each phase's prompt automatically includes the original spec **and** the output files of all its dependencies — so context flows through the pipeline automatically.
+5. If a phase output file already exists, `exec` skips it and moves on. Use `--force` to re-run.
+
+**`phases.yaml` format:**
+
+```yaml
+version: "1"
+spec: spec.md          # injected into every phase prompt
+phases:
+  - id: research
+    description: Investigate the problem domain and gather context.
+    type: agent
+    agentType: researcher
+    dependsOn: []
+
+  - id: design
+    description: Design the solution architecture based on the research.
+    type: swarm
+    topology: hierarchical
+    agents: [architect, analyst]
+    dependsOn: [research]
+
+  - id: implement
+    description: Implement the designed solution.
+    type: swarm
+    topology: hierarchical
+    agents: [coder, coder, tester]
+    dependsOn: [design]
+
+  - id: review
+    description: Review the implementation for quality and correctness.
+    type: agent
+    agentType: reviewer
+    output: final-review.md   # optional: override the default phase-{id}.md name
+    dependsOn: [implement]
+```
+
+---
+
 ### `memory`
 
 ```bash
@@ -350,6 +426,7 @@ const result2 = await withRetry(
 {
   "version": "1.0.0",
   "defaultModel": "gpt-4o",
+  "defaultTimeoutMs": 120000,
   "swarm": {
     "topology": "hierarchical",
     "maxAgents": 8
@@ -375,8 +452,10 @@ const result2 = await withRetry(
 
 Environment variable overrides:
 ```bash
-GITHUB_TOKEN=ghp_...          # GitHub token (uses logged-in user by default)
+GITHUB_TOKEN=ghp_...                 # GitHub token (bypasses keychain on managed Macs)
+GH_TOKEN=$(gh auth token)           # Alternative: reuse the GitHub CLI token
 COPILOT_FLOW_DEFAULT_MODEL=gpt-4o
+COPILOT_FLOW_TIMEOUT_MS=300000      # Default session timeout in ms (default: 120000)
 COPILOT_FLOW_MAX_RETRIES=3
 COPILOT_FLOW_RETRY_DELAY_MS=1000
 COPILOT_FLOW_LOG_LEVEL=info   # debug | info | warn | error | silent

package/dist/commands/exec.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerExec(program: Command): void;
+//# sourceMappingURL=exec.d.ts.map

package/dist/commands/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0EpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8HnD"}

package/dist/commands/exec.js

@@ -0,0 +1,173 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerExec = registerExec;
+const fs_1 = require("fs");
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const executor_js_1 = require("../agents/executor.js");
+const coordinator_js_1 = require("../swarm/coordinator.js");
+const output_js_1 = require("../output.js");
+const config_js_1 = require("../config.js");
+const client_manager_js_1 = require("../core/client-manager.js");
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function phaseOutputFile(phase) {
+    return phase.output ?? `phase-${phase.id}.md`;
+}
+/**
+ * Topological sort: returns phases in a valid execution order
+ * where every dependency appears before the phase that needs it.
+ */
+function topoSort(phases) {
+    const byId = new Map(phases.map(p => [p.id, p]));
+    const result = [];
+    const visited = new Set();
+    function visit(id) {
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        const phase = byId.get(id);
+        if (!phase)
+            throw new Error(`Unknown phase id in dependsOn: "${id}"`);
+        for (const dep of phase.dependsOn ?? [])
+            visit(dep);
+        result.push(phase);
+    }
+    for (const phase of phases)
+        visit(phase.id);
+    return result;
+}
+/**
+ * Build the prompt for a phase: original spec + outputs from all dependencies
+ * (read from the in-memory results map first, then fall back to disk).
+ */
+function buildPhasePrompt(phase, plan, phaseResults) {
+    const sections = [];
+    if (plan.spec && (0, fs_1.existsSync)(plan.spec)) {
+        sections.push(`## Original specification (${plan.spec})\n\n${(0, fs_1.readFileSync)(plan.spec, 'utf-8').trim()}`);
+    }
+    for (const depId of phase.dependsOn ?? []) {
+        const depPhase = plan.phases.find(p => p.id === depId);
+        if (!depPhase)
+            continue;
+        const content = phaseResults.get(depId) ??
+            ((0, fs_1.existsSync)(phaseOutputFile(depPhase))
+                ? (0, fs_1.readFileSync)(phaseOutputFile(depPhase), 'utf-8').trim()
+                : null);
+        if (content) {
+            sections.push(`## Output from phase "${depId}"\n\n${content}`);
+        }
+    }
+    sections.push(`## Your task — phase "${phase.id}"\n\n${phase.description}`);
+    return sections.join('\n\n---\n\n');
+}
+// ─── Command ──────────────────────────────────────────────────────────────────
+function registerExec(program) {
+    program
+        .command('exec <plan>')
+        .description('Execute a phased plan — all phases or a single one')
+        .option('--phase <id>', 'Run only this phase (dependency output files must exist on disk)')
+        .option('--force', 'Re-run phases even if their output file already exists')
+        .option('--timeout <ms>', 'Session timeout per agent in ms (overrides config)')
+        .option('--stream', 'Stream agent output as it arrives')
+        .action(async (planFile, opts) => {
+        if (!(0, fs_1.existsSync)(planFile)) {
+            output_js_1.output.error(`Plan file not found: ${planFile}`);
+            process.exit(1);
+        }
+        let plan;
+        try {
+            plan = js_yaml_1.default.load((0, fs_1.readFileSync)(planFile, 'utf-8'));
+            if (!Array.isArray(plan?.phases) || plan.phases.length === 0) {
+                throw new Error('No phases found');
+            }
+        }
+        catch (err) {
+            output_js_1.output.error(`Invalid plan file: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+        const config = (0, config_js_1.loadConfig)();
+        const timeoutMs = opts.timeout ? parseInt(opts.timeout, 10) : config.defaultTimeoutMs;
+        const phaseResults = new Map();
+        // Determine which phases to run
+        let phasesToRun;
+        if (opts.phase) {
+            const target = plan.phases.find(p => p.id === opts.phase);
+            if (!target) {
+                output_js_1.output.error(`Phase not found: "${opts.phase}". Available: ${plan.phases.map(p => p.id).join(', ')}`);
+                process.exit(1);
+            }
+            phasesToRun = [target];
+        }
+        else {
+            phasesToRun = topoSort(plan.phases);
+        }
+        output_js_1.output.header(`Executing plan: ${planFile}`);
+        output_js_1.output.dim(`Phases: ${phasesToRun.map(p => p.id).join(' → ')}`);
+        output_js_1.output.blank();
+        for (const phase of phasesToRun) {
+            const outFile = phaseOutputFile(phase);
+            output_js_1.output.header(`Phase: ${phase.id}`);
+            output_js_1.output.dim(phase.description);
+            // Skip already-complete phases unless --force
+            if (!opts.force && (0, fs_1.existsSync)(outFile)) {
+                const existing = (0, fs_1.readFileSync)(outFile, 'utf-8').trim();
+                phaseResults.set(phase.id, existing);
+                output_js_1.output.dim(`  Already complete — skipping (${outFile}). Use --force to re-run.`);
+                output_js_1.output.blank();
+                continue;
+            }
+            const prompt = buildPhasePrompt(phase, plan, phaseResults);
+            let phaseOutput;
+            if (phase.type === 'swarm') {
+                const topology = phase.topology ?? 'hierarchical';
+                const agentTypes = phase.agents ?? ['researcher', 'coder', 'reviewer'];
+                output_js_1.output.info(`Swarm (${topology}): ${agentTypes.map(a => (0, output_js_1.agentBadge)(a)).join(' → ')}`);
+                const tasks = agentTypes.map((agentType, i) => ({
+                    id: `${phase.id}-task-${i + 1}`,
+                    agentType,
+                    prompt,
+                    dependsOn: i > 0 ? [`${phase.id}-task-${i}`] : undefined,
+                    sessionOptions: { timeoutMs },
+                }));
+                const results = await (0, coordinator_js_1.runSwarm)(tasks, topology, {
+                    onProgress: opts.stream
+                        ? (_taskId, agentType, chunk) => process.stdout.write(`${(0, output_js_1.agentBadge)(agentType)} ${chunk}`)
+                        : undefined,
+                });
+                const last = results.get(tasks[tasks.length - 1].id);
+                if (!last?.success) {
+                    output_js_1.output.error(`Phase "${phase.id}" failed: ${last?.error ?? 'unknown error'}`);
+                    await client_manager_js_1.clientManager.shutdown();
+                    process.exit(1);
+                }
+                phaseOutput = last.output;
+            }
+            else {
+                const agentType = phase.agentType ?? 'analyst';
+                output_js_1.output.info(`Agent: ${(0, output_js_1.agentBadge)(agentType)}`);
+                const result = await (0, executor_js_1.runAgentTask)(agentType, prompt, {
+                    timeoutMs,
+                    onChunk: opts.stream ? chunk => process.stdout.write(chunk) : undefined,
+                });
+                if (!result.success) {
+                    output_js_1.output.error(`Phase "${phase.id}" failed: ${result.error}`);
+                    await client_manager_js_1.clientManager.shutdown();
+                    process.exit(1);
+                }
+                phaseOutput = result.output;
+            }
+            (0, fs_1.writeFileSync)(outFile, `# Phase: ${phase.id}\n\n${phaseOutput}\n`, 'utf-8');
+            phaseResults.set(phase.id, phaseOutput);
+            if (opts.stream)
+                output_js_1.output.blank();
+            output_js_1.output.success(`Phase "${phase.id}" complete → ${outFile}`);
+            output_js_1.output.blank();
+        }
+        output_js_1.output.success('All phases complete.');
+        await client_manager_js_1.clientManager.shutdown();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/commands/exec.js.map

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

package/dist/commands/index.js

@@ -12,6 +12,8 @@ const hooks_js_1 = require("./hooks.js");
 const route_js_1 = require("./route.js");
 const status_js_1 = require("./status.js");
 const doctor_js_1 = require("./doctor.js");
+const plan_js_1 = require("./plan.js");
+const exec_js_1 = require("./exec.js");
 const program = new commander_1.Command();
 program
     .name('copilot-flow')
@@ -27,5 +29,7 @@ program
 (0, route_js_1.registerRoute)(program);
 (0, status_js_1.registerStatus)(program);
 (0, doctor_js_1.registerDoctor)(program);
+(0, plan_js_1.registerPlan)(program);
+(0, exec_js_1.registerExec)(program);
 program.parse(process.argv);
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,yCAAoC;AACpC,uCAAyC;AACzC,yCAA2C;AAC3C,yCAA2C;AAC3C,2CAA6C;AAC7C,yCAA2C;AAC3C,yCAA2C;AAC3C,2CAA6C;AAC7C,2CAA6C;AAE7C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CACV,8DAA8D;IAC9D,yEAAyE,CAC1E;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,wBAAwB;AACxB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;AACtB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,0BAAc,EAAC,OAAO,CAAC,CAAC;AACxB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,0BAAc,EAAC,OAAO,CAAC,CAAC;AACxB,IAAA,0BAAc,EAAC,OAAO,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,yCAAoC;AACpC,uCAAyC;AACzC,yCAA2C;AAC3C,yCAA2C;AAC3C,2CAA6C;AAC7C,yCAA2C;AAC3C,yCAA2C;AAC3C,2CAA6C;AAC7C,2CAA6C;AAC7C,uCAAyC;AACzC,uCAAyC;AAEzC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CACV,8DAA8D;IAC9D,yEAAyE,CAC1E;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,wBAAwB;AACxB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;AACtB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,0BAAc,EAAC,OAAO,CAAC,CAAC;AACxB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,wBAAa,EAAC,OAAO,CAAC,CAAC;AACvB,IAAA,0BAAc,EAAC,OAAO,CAAC,CAAC;AACxB,IAAA,0BAAc,EAAC,OAAO,CAAC,CAAC;AACxB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;AACtB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;AAEtB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerPlan(program: Command): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6EnD"}

package/dist/commands/plan.js

@@ -0,0 +1,133 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPlan = registerPlan;
+const fs_1 = require("fs");
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const executor_js_1 = require("../agents/executor.js");
+const output_js_1 = require("../output.js");
+const config_js_1 = require("../config.js");
+const client_manager_js_1 = require("../core/client-manager.js");
+const AGENT_TYPES = [
+    'coder', 'researcher', 'tester', 'reviewer', 'architect',
+    'coordinator', 'analyst', 'debugger', 'documenter', 'optimizer',
+    'security-auditor', 'performance-engineer',
+].join(', ');
+function buildPlannerPrompt(specContent) {
+    return `You are a software project planner for an AI agent pipeline. \
+Analyse the following specification and produce a YAML execution plan \
+that breaks the work into sequential phases.
+
+Rules:
+- Each phase must have a unique kebab-case id.
+- type must be "agent" (single specialist) or "swarm" (multi-agent pipeline).
+- agentType (type: agent) must be one of: ${AGENT_TYPES}
+- topology (type: swarm) must be one of: hierarchical, sequential, mesh
+- agents (type: swarm) is a list of agentType values forming the pipeline.
+- dependsOn lists phase ids that must complete before this phase starts.
+- The first phase must have an empty dependsOn list.
+- output is optional — if omitted the file will be named phase-{id}.md.
+- Output ONLY valid YAML inside a single \`\`\`yaml code block. No other text.
+
+Example structure:
+\`\`\`yaml
+version: "1"
+phases:
+  - id: research
+    description: Investigate the problem domain and gather requirements.
+    type: agent
+    agentType: researcher
+    dependsOn: []
+  - id: design
+    description: Design the solution architecture based on research.
+    type: swarm
+    topology: hierarchical
+    agents: [architect, analyst]
+    dependsOn: [research]
+  - id: implement
+    description: Implement the designed solution.
+    type: swarm
+    topology: hierarchical
+    agents: [coder, coder, tester]
+    dependsOn: [design]
+  - id: review
+    description: Review the implementation for quality and correctness.
+    type: agent
+    agentType: reviewer
+    dependsOn: [implement]
+\`\`\`
+
+Specification to plan:
+${specContent}`;
+}
+function registerPlan(program) {
+    program
+        .command('plan <spec>')
+        .description('Analyse a spec file and generate a phased execution plan (YAML)')
+        .option('-f, --file <path>', 'Output path for the plan file', 'phases.yaml')
+        .option('--model <model>', 'Model override')
+        .action(async (spec, opts) => {
+        if (!(0, fs_1.existsSync)(spec)) {
+            output_js_1.output.error(`Spec file not found: ${spec}`);
+            process.exit(1);
+        }
+        const specContent = (0, fs_1.readFileSync)(spec, 'utf-8').trim();
+        const config = (0, config_js_1.loadConfig)();
+        output_js_1.output.info(`Analysing spec: ${spec}`);
+        output_js_1.output.info(`Generating plan → ${opts.file}`);
+        output_js_1.output.blank();
+        const result = await (0, executor_js_1.runAgentTask)('analyst', buildPlannerPrompt(specContent), {
+            model: opts.model ?? config.defaultModel,
+            timeoutMs: config.defaultTimeoutMs,
+        });
+        if (!result.success) {
+            output_js_1.output.error(`Planning failed: ${result.error}`);
+            await client_manager_js_1.clientManager.shutdown();
+            process.exit(1);
+        }
+        // Extract YAML from a ```yaml code block, or treat the whole response as YAML
+        const match = result.output.match(/```ya?ml\s*\n([\s\S]*?)```/);
+        const rawYaml = match ? match[1].trim() : result.output.trim();
+        let plan;
+        try {
+            plan = js_yaml_1.default.load(rawYaml);
+            if (!Array.isArray(plan?.phases) || plan.phases.length === 0) {
+                throw new Error('No phases found in the generated plan');
+            }
+        }
+        catch (err) {
+            output_js_1.output.error(`Generated YAML is invalid: ${err instanceof Error ? err.message : String(err)}`);
+            output_js_1.output.dim('Raw model output:');
+            output_js_1.output.dim(result.output.slice(0, 600));
+            await client_manager_js_1.clientManager.shutdown();
+            process.exit(1);
+        }
+        // Stamp in the spec path and version before saving
+        plan.spec = spec;
+        plan.version = plan.version ?? '1';
+        // Normalise optional fields
+        for (const phase of plan.phases) {
+            phase.dependsOn = phase.dependsOn ?? [];
+            if (phase.type === 'swarm') {
+                phase.topology = phase.topology ?? 'hierarchical';
+                phase.agents = phase.agents ?? ['researcher', 'coder', 'reviewer'];
+            }
+        }
+        (0, fs_1.writeFileSync)(opts.file, js_yaml_1.default.dump(plan, { lineWidth: 100 }), 'utf-8');
+        output_js_1.output.success(`Plan written to ${opts.file}`);
+        output_js_1.output.blank();
+        output_js_1.output.print(`  ${plan.phases.length} phase(s):`);
+        for (const phase of plan.phases) {
+            const typeLabel = phase.type === 'swarm'
+                ? `swarm/${phase.topology} [${(phase.agents ?? []).join(', ')}]`
+                : `agent/${phase.agentType}`;
+            const deps = phase.dependsOn?.length ? ` (after: ${phase.dependsOn.join(', ')})` : '';
+            output_js_1.output.print(`    ${phase.id.padEnd(22)} ${typeLabel}${deps}`);
+        }
+        await client_manager_js_1.clientManager.shutdown();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/types.d.ts

@@ -129,6 +129,30 @@ export interface CopilotFlowConfig {
         directories: string[];
     };
 }
+export interface PlanPhase {
+    /** Unique kebab-case identifier used for output filename and dependsOn references. */
+    id: string;
+    /** Human-readable description of what this phase should accomplish. */
+    description: string;
+    /** 'agent' runs a single specialist; 'swarm' runs a multi-agent pipeline. */
+    type: 'agent' | 'swarm';
+    /** Agent type (required when type is 'agent'). */
+    agentType?: AgentType;
+    /** Swarm topology (used when type is 'swarm'). Default: 'hierarchical'. */
+    topology?: SwarmTopology;
+    /** Agent types in the swarm pipeline (used when type is 'swarm'). */
+    agents?: AgentType[];
+    /** Output filename. Defaults to phase-{id}.md. */
+    output?: string;
+    /** IDs of phases that must complete before this one. */
+    dependsOn?: string[];
+}
+export interface Plan {
+    version: string;
+    /** Path to the original spec file — injected into every phase prompt. */
+    spec: string;
+    phases: PlanPhase[];
+}
 export interface CommandContext {
     args: string[];
     flags: Record<string, unknown>;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilot-flow",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "Multi-agent orchestration framework for GitHub Copilot CLI — inspired by Ruflo (claude-flow)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,9 +37,11 @@
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",
     "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.1",
     "ora": "^8.1.1"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.5.4",