@bradtaylorsf/alpha-loop 1.0.0

package/dist/commands/vision.js

@@ -0,0 +1,194 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { exec } from '../lib/shell.js';
+import { assertSafeShellArg, loadConfig } from '../lib/config.js';
+import { log } from '../lib/logger.js';
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+const USER_TYPES = {
+    '1': 'Technical users (developers, engineers)',
+    '2': 'Semi-technical (power users, admins)',
+    '3': 'Non-technical (general consumers, elderly, caregivers) \u2014 UI must be simple, accessible, and forgiving',
+    '4': 'Mixed audience \u2014 needs both simple and advanced interfaces',
+};
+const STAGES = {
+    '1': 'Brand new / greenfield \u2014 focus on getting core architecture right',
+    '2': 'MVP / early development \u2014 focus on core flows working end-to-end',
+    '3': 'Working product \u2014 adding features without breaking existing functionality',
+    '4': 'Mature product \u2014 maintenance, optimization, and careful changes',
+};
+const PRIORITIES = {
+    '1': 'Core functionality \u2014 make it work reliably before making it pretty',
+    '2': 'User experience \u2014 the product works, now make it delightful',
+    '3': 'Scale and performance \u2014 handle more load, optimize bottlenecks',
+    '4': 'Security and compliance \u2014 harden, audit, meet regulatory requirements',
+};
+export async function visionCommand() {
+    if (!process.stdin.isTTY) {
+        log.info('Not running in an interactive terminal. Skipping vision setup.');
+        return;
+    }
+    const projectDir = process.cwd();
+    const contextDir = path.join(projectDir, '.alpha-loop');
+    const visionFile = path.join(contextDir, 'vision.md');
+    const config = loadConfig();
+    fs.mkdirSync(contextDir, { recursive: true });
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        // Check if vision exists
+        if (fs.existsSync(visionFile)) {
+            console.log('');
+            console.log('\x1b[1mCurrent project vision:\x1b[0m');
+            console.log('');
+            console.log(fs.readFileSync(visionFile, 'utf-8'));
+            console.log('');
+            const updateChoice = await ask(rl, 'Update this vision? [y/N]: ');
+            if (updateChoice.toLowerCase() !== 'y') {
+                return;
+            }
+        }
+        else {
+            console.log('');
+            console.log('\x1b[1m\x1b[36mNo project vision found. Let\'s set one up.\x1b[0m');
+            console.log('This helps the agent understand what it\'s building and make better decisions.');
+            console.log('');
+        }
+        // Question 1: What is this project?
+        console.log('\x1b[1mWhat is this project?\x1b[0m (1-2 sentences)');
+        const projectDescription = await ask(rl, '> ');
+        console.log('');
+        // Question 2: Target users
+        console.log('\x1b[1mWho are the target users?\x1b[0m');
+        console.log('  [1] Technical users (developers, engineers)');
+        console.log('  [2] Semi-technical (power users, admins)');
+        console.log('  [3] Non-technical (general consumers, elderly, caregivers)');
+        console.log('  [4] Mixed audience');
+        const userTypeChoice = await ask(rl, '> ');
+        const userType = USER_TYPES[userTypeChoice] ?? userTypeChoice;
+        console.log('');
+        // Question 3: Project stage
+        console.log('\x1b[1mWhat stage is the project in?\x1b[0m');
+        console.log('  [1] Brand new / greenfield');
+        console.log('  [2] MVP / early development');
+        console.log('  [3] Working product, adding features');
+        console.log('  [4] Mature product, maintenance mode');
+        const stageChoice = await ask(rl, '> ');
+        const projectStage = STAGES[stageChoice] ?? stageChoice;
+        console.log('');
+        // Question 4: Current priority
+        console.log('\x1b[1mWhat matters most right now?\x1b[0m');
+        console.log('  [1] Core functionality works reliably');
+        console.log('  [2] User experience and polish');
+        console.log('  [3] Scale and performance');
+        console.log('  [4] Security and compliance');
+        console.log('  [5] Something else (type it)');
+        const priorityChoice = await ask(rl, '> ');
+        const priority = PRIORITIES[priorityChoice] ?? priorityChoice;
+        console.log('');
+        // Question 5: UX/design guidelines
+        console.log('\x1b[1mAny UX or design guidelines?\x1b[0m (press Enter to skip)');
+        console.log("  Examples: 'mobile-first', 'dark mode', 'WCAG AA accessible', 'minimal UI'");
+        const uxGuidelines = await ask(rl, '> ');
+        console.log('');
+        // Question 6: North star issue
+        console.log('\x1b[1mLink a north star issue or paste additional context?\x1b[0m');
+        console.log('  Paste a GitHub issue URL, issue number, or freeform text (Enter to skip)');
+        const northStarInput = await ask(rl, '> ');
+        console.log('');
+        let northStarContent = '';
+        if (northStarInput) {
+            const issueMatch = northStarInput.match(/^(\d+)$/) ?? northStarInput.match(/issues\/(\d+)/);
+            if (issueMatch) {
+                const issueNum = issueMatch[1];
+                log.info(`Fetching issue #${issueNum}...`);
+                const repo = assertSafeShellArg(config.repo, 'repo');
+                const result = exec(`gh issue view ${issueNum} --repo ${repo} --json title,body`);
+                if (result.exitCode === 0 && result.stdout) {
+                    const issueData = JSON.parse(result.stdout);
+                    northStarContent = `### North Star: #${issueNum} \u2014 ${issueData.title}\n\n${issueData.body}`;
+                    log.success(`Fetched issue #${issueNum}: ${issueData.title}`);
+                }
+                else {
+                    log.warn(`Could not fetch issue #${issueNum}`);
+                    northStarContent = northStarInput;
+                }
+            }
+            else {
+                northStarContent = northStarInput;
+            }
+        }
+        // Question 7: Anything else?
+        console.log('\x1b[1mAnything else the agent should always keep in mind?\x1b[0m (Enter to skip)');
+        const additionalContext = await ask(rl, '> ');
+        console.log('');
+        // Synthesize with Claude
+        log.step('Generating project vision...');
+        const visionPrompt = `Synthesize the following inputs into a concise project vision document. This will be read by AI agents before every task to guide their decisions.
+
+Project description: ${projectDescription}
+Target users: ${userType}
+Project stage: ${projectStage}
+Current priority: ${priority}
+UX guidelines: ${uxGuidelines || 'None specified'}
+Additional context: ${additionalContext || 'None'}
+${northStarContent ? `\nNorth star context:\n${northStarContent}` : ''}
+
+Output ONLY this markdown structure. Be specific and actionable. Under 500 words total.
+
+## What We're Building
+(2-3 sentences synthesizing the project description and north star)
+
+## Who It's For
+(Target users and what that means for UX/design decisions)
+
+## Current Stage & Priority
+(Where the project is and what matters most right now)
+
+## Decision Guidelines
+(5-7 bullet points the agent should follow when making choices about implementation, UX, what to build vs defer, etc. Derived from all inputs above.)
+
+## What Good Looks Like
+(3-4 bullet points describing the quality bar — what a successful implementation looks like for this project)`;
+        const model = assertSafeShellArg(config.model ?? 'opus', 'model');
+        const visionResult = exec(`echo ${JSON.stringify(visionPrompt)} | claude -p --model ${model} --dangerously-skip-permissions --output-format text 2>/dev/null`, { cwd: projectDir });
+        if (visionResult.exitCode === 0 && visionResult.stdout) {
+            fs.writeFileSync(visionFile, visionResult.stdout + '\n');
+        }
+        else {
+            // Fallback: write raw inputs
+            log.warn('Claude synthesis failed, saving raw inputs');
+            const raw = [
+                '## What We\'re Building',
+                projectDescription,
+                '',
+                '## Who It\'s For',
+                userType,
+                '',
+                '## Current Stage & Priority',
+                projectStage,
+                `Priority: ${priority}`,
+                '',
+                '## UX Guidelines',
+                uxGuidelines || 'None specified',
+                '',
+                ...(northStarContent ? ['## North Star', northStarContent, ''] : []),
+                ...(additionalContext ? ['## Additional Context', additionalContext, ''] : []),
+            ].join('\n');
+            fs.writeFileSync(visionFile, raw + '\n');
+        }
+        log.success(`Project vision saved to ${visionFile}`);
+        console.log('');
+        console.log(fs.readFileSync(visionFile, 'utf-8'));
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=vision.js.map

package/dist/commands/vision.js.map

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

package/dist/engine/agents.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Agent Spawn Module
+ * ==================
+ *
+ * Handles spawning different AI CLI agents (Claude, Codex, OpenCode)
+ * with the correct CLI flags per agent type.
+ *
+ * Adding a new agent: add a case to AGENT_CLI_MAP and buildAgentArgs().
+ */
+import { type ChildProcess } from 'node:child_process';
+import type { AgentConfig } from './config.js';
+/**
+ * CLI reference for each supported agent.
+ * Extend this map to add new agent types.
+ */
+export declare const AGENT_CLI_MAP: Record<string, {
+    command: string;
+    promptFlag: string;
+    modelFlag: string;
+    permissionFlag?: string;
+    supportsMaxTurns: boolean;
+    maxTurnsFlag?: string;
+}>;
+export interface AgentArgs {
+    command: string;
+    args: string[];
+}
+/**
+ * Constructs the CLI command and arguments for spawning an agent.
+ * Throws if the agent type is not recognized.
+ */
+export declare function buildAgentArgs(config: AgentConfig & {
+    model: string;
+}, prompt: string): AgentArgs;
+/**
+ * Spawns an agent subprocess with the correct CLI flags.
+ * Returns the ChildProcess for the caller to manage (listen to events, pipe stdio, etc.).
+ */
+export declare function spawnAgent(config: AgentConfig & {
+    model: string;
+}, prompt: string, cwd: string): ChildProcess;

package/dist/engine/agents.js

@@ -0,0 +1,90 @@
+/**
+ * Agent Spawn Module
+ * ==================
+ *
+ * Handles spawning different AI CLI agents (Claude, Codex, OpenCode)
+ * with the correct CLI flags per agent type.
+ *
+ * Adding a new agent: add a case to AGENT_CLI_MAP and buildAgentArgs().
+ */
+import { spawn } from 'node:child_process';
+// ============================================================================
+// Agent CLI Mapping
+// ============================================================================
+/**
+ * CLI reference for each supported agent.
+ * Extend this map to add new agent types.
+ */
+export const AGENT_CLI_MAP = {
+    claude: {
+        command: 'claude',
+        promptFlag: '-p',
+        modelFlag: '--model',
+        permissionFlag: '--dangerously-skip-permissions',
+        supportsMaxTurns: true,
+        maxTurnsFlag: '--max-turns',
+    },
+    codex: {
+        command: 'codex',
+        promptFlag: '-q',
+        modelFlag: '--model',
+        permissionFlag: '--auto-edit',
+        supportsMaxTurns: false,
+    },
+    opencode: {
+        command: 'opencode',
+        promptFlag: 'run',
+        modelFlag: '--model',
+        supportsMaxTurns: false,
+    },
+};
+/**
+ * Constructs the CLI command and arguments for spawning an agent.
+ * Throws if the agent type is not recognized.
+ */
+export function buildAgentArgs(config, prompt) {
+    const agentDef = AGENT_CLI_MAP[config.agent];
+    if (!agentDef) {
+        throw new Error(`Unknown agent type: "${config.agent}". Supported agents: ${Object.keys(AGENT_CLI_MAP).join(', ')}`);
+    }
+    const args = [];
+    // For opencode, "run" is a subcommand, not a flag
+    if (config.agent === 'opencode') {
+        args.push(agentDef.promptFlag); // 'run'
+    }
+    // Model flag
+    args.push(agentDef.modelFlag, config.model);
+    // Permission flag (if agent supports it)
+    if (agentDef.permissionFlag) {
+        args.push(agentDef.permissionFlag);
+    }
+    // Max turns (only if agent supports it and value is provided)
+    if (config.maxTurns != null && agentDef.supportsMaxTurns && agentDef.maxTurnsFlag) {
+        args.push(agentDef.maxTurnsFlag, String(config.maxTurns));
+    }
+    // Prompt flag — for claude/codex it's a flag before the prompt text
+    if (config.agent !== 'opencode') {
+        args.push(agentDef.promptFlag, prompt);
+    }
+    else {
+        // opencode takes prompt as a positional arg after 'run'
+        args.push(prompt);
+    }
+    return { command: agentDef.command, args };
+}
+// ============================================================================
+// Spawn Agent
+// ============================================================================
+/**
+ * Spawns an agent subprocess with the correct CLI flags.
+ * Returns the ChildProcess for the caller to manage (listen to events, pipe stdio, etc.).
+ */
+export function spawnAgent(config, prompt, cwd) {
+    const { command, args } = buildAgentArgs(config, prompt);
+    return spawn(command, args, {
+        cwd,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: { ...process.env },
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/engine/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/engine/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAG9D,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAOrB;IACH,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ;QACjB,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,gCAAgC;QAChD,gBAAgB,EAAE,IAAI;QACtB,YAAY,EAAE,aAAa;KAC5B;IACD,KAAK,EAAE;QACL,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,SAAS;QACpB,cAAc,EAAE,aAAa;QAC7B,gBAAgB,EAAE,KAAK;KACxB;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,SAAS;QACpB,gBAAgB,EAAE,KAAK;KACxB;CACF,CAAC;AAWF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuC,EAAE,MAAc;IACpF,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,KAAK,wBAAwB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpG,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,kDAAkD;IAClD,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;IAC1C,CAAC;IAED,aAAa;IACb,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5C,yCAAyC;IACzC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC;IAED,8DAA8D;IAC9D,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,IAAI,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAClF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,oEAAoE;IACpE,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,wDAAwD;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAuC,EAAE,MAAc,EAAE,GAAW;IAC7F,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QAC1B,GAAG;QACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC,CAAC;AACL,CAAC"}

package/dist/engine/config.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Configuration Module
+ * ====================
+ *
+ * Loads and validates .alpha-loop.yaml with per-stage agent/model configuration.
+ * Uses Zod for schema validation with sensible defaults.
+ */
+import { z } from 'zod';
+export declare const STAGE_NAMES: readonly ["implement", "fix", "review", "verify", "learn", "aggregate"];
+export type StageName = (typeof STAGE_NAMES)[number];
+export declare const DEFAULT_AGENT = "claude";
+export declare const DEFAULT_MODEL = "opus";
+export declare const AgentConfigSchema: z.ZodObject<{
+    agent: z.ZodDefault<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AgentConfig = z.infer<typeof AgentConfigSchema>;
+export declare const ConfigSchema: z.ZodObject<{
+    repo: z.ZodString;
+    project: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodDefault<z.ZodString>;
+    review_model: z.ZodOptional<z.ZodString>;
+    max_turns: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodDefault<z.ZodString>;
+    base_branch: z.ZodDefault<z.ZodString>;
+    test_command: z.ZodDefault<z.ZodString>;
+    poll_interval: z.ZodDefault<z.ZodNumber>;
+    stages: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        implement: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        fix: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        review: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        verify: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        learn: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        aggregate: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodDefault<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+            maxTurns: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare function loadConfig(cwd: string): Config;
+/**
+ * Resolves the agent configuration for a given pipeline stage.
+ * Merges stage-specific config with global defaults:
+ *   - agent: stage.agent → 'claude'
+ *   - model: stage.model → config.model → 'opus'
+ *   - maxTurns: stage.maxTurns → config.max_turns → undefined
+ */
+export declare function resolveStageConfig(config: Config, stage: StageName): Required<Pick<AgentConfig, 'agent' | 'model'>> & Pick<AgentConfig, 'maxTurns'>;

package/dist/engine/config.js

@@ -0,0 +1,73 @@
+/**
+ * Configuration Module
+ * ====================
+ *
+ * Loads and validates .alpha-loop.yaml with per-stage agent/model configuration.
+ * Uses Zod for schema validation with sensible defaults.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+import { parse as parseYaml } from 'yaml';
+// ============================================================================
+// Constants
+// ============================================================================
+export const STAGE_NAMES = ['implement', 'fix', 'review', 'verify', 'learn', 'aggregate'];
+export const DEFAULT_AGENT = 'claude';
+export const DEFAULT_MODEL = 'opus';
+// ============================================================================
+// Schemas
+// ============================================================================
+export const AgentConfigSchema = z.object({
+    agent: z.string().default(DEFAULT_AGENT),
+    model: z.string().optional(),
+    maxTurns: z.number().optional(),
+});
+const StagesSchema = z.object({
+    implement: AgentConfigSchema.optional(),
+    fix: AgentConfigSchema.optional(),
+    review: AgentConfigSchema.optional(),
+    verify: AgentConfigSchema.optional(),
+    learn: AgentConfigSchema.optional(),
+    aggregate: AgentConfigSchema.optional(),
+}).strict().optional().default({});
+export const ConfigSchema = z.object({
+    repo: z.string(),
+    project: z.number().optional(),
+    model: z.string().default(DEFAULT_MODEL),
+    review_model: z.string().optional(),
+    max_turns: z.number().optional(),
+    label: z.string().default('ready'),
+    base_branch: z.string().default('master'),
+    test_command: z.string().default('pnpm test'),
+    poll_interval: z.number().default(60),
+    stages: StagesSchema,
+});
+// ============================================================================
+// Config Loading
+// ============================================================================
+export function loadConfig(cwd) {
+    const configPath = resolve(cwd, '.alpha-loop.yaml');
+    const raw = readFileSync(configPath, 'utf-8');
+    const parsed = parseYaml(raw);
+    return ConfigSchema.parse(parsed);
+}
+// ============================================================================
+// Stage Config Resolution
+// ============================================================================
+/**
+ * Resolves the agent configuration for a given pipeline stage.
+ * Merges stage-specific config with global defaults:
+ *   - agent: stage.agent → 'claude'
+ *   - model: stage.model → config.model → 'opus'
+ *   - maxTurns: stage.maxTurns → config.max_turns → undefined
+ */
+export function resolveStageConfig(config, stage) {
+    const stageConfig = config.stages[stage];
+    return {
+        agent: stageConfig?.agent ?? DEFAULT_AGENT,
+        model: stageConfig?.model ?? config.model ?? DEFAULT_MODEL,
+        maxTurns: stageConfig?.maxTurns ?? config.max_turns,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/engine/config.js.map

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

package/dist/engine/prerequisites.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Prerequisites Module
+ * ====================
+ *
+ * Verifies that all configured AI CLI agents are installed before starting the pipeline.
+ * Groups stages by agent for clear diagnostic output.
+ */
+import { type Config, type StageName } from './config.js';
+export interface AgentCheckResult {
+    agent: string;
+    installed: boolean;
+    stages: StageName[];
+}
+export interface PrerequisiteResult {
+    ok: boolean;
+    results: AgentCheckResult[];
+}
+/**
+ * Checks whether a CLI command is available on the system PATH.
+ */
+export declare function isCommandAvailable(command: string): boolean;
+/**
+ * Checks all agents configured across pipeline stages.
+ * Returns structured results showing which agents are installed and which stages they serve.
+ */
+export declare function checkAgents(config: Config): PrerequisiteResult;
+/**
+ * Formats the prerequisite check results for console output.
+ */
+export declare function formatCheckResults(result: PrerequisiteResult): string;
+/**
+ * Formats the pipeline startup summary showing per-stage configuration.
+ */
+export declare function formatPipelineSummary(config: Config): string;

package/dist/engine/prerequisites.js

@@ -0,0 +1,90 @@
+/**
+ * Prerequisites Module
+ * ====================
+ *
+ * Verifies that all configured AI CLI agents are installed before starting the pipeline.
+ * Groups stages by agent for clear diagnostic output.
+ */
+import { execSync } from 'node:child_process';
+import { STAGE_NAMES, resolveStageConfig } from './config.js';
+// ============================================================================
+// Agent Check
+// ============================================================================
+/**
+ * Checks whether a CLI command is available on the system PATH.
+ */
+export function isCommandAvailable(command) {
+    // Validate command name to prevent shell injection from user-controlled config
+    if (!/^[a-zA-Z0-9_-]+$/.test(command)) {
+        return false;
+    }
+    try {
+        execSync(`which ${command}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks all agents configured across pipeline stages.
+ * Returns structured results showing which agents are installed and which stages they serve.
+ */
+export function checkAgents(config) {
+    // Collect stages grouped by agent
+    const agentStages = new Map();
+    for (const stage of STAGE_NAMES) {
+        const { agent } = resolveStageConfig(config, stage);
+        const stages = agentStages.get(agent) ?? [];
+        stages.push(stage);
+        agentStages.set(agent, stages);
+    }
+    // Check each unique agent
+    const results = [];
+    for (const [agent, stages] of agentStages) {
+        results.push({
+            agent,
+            installed: isCommandAvailable(agent),
+            stages,
+        });
+    }
+    return {
+        ok: results.every(r => r.installed),
+        results,
+    };
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+/**
+ * Formats the prerequisite check results for console output.
+ */
+export function formatCheckResults(result) {
+    const lines = ['Checking agents...'];
+    for (const r of result.results) {
+        const icon = r.installed ? '\u2713' : '\u2717';
+        const stageList = r.stages.join(', ');
+        lines.push(`  ${icon} ${r.agent} (${stageList})`);
+    }
+    if (!result.ok) {
+        const missing = result.results.filter(r => !r.installed);
+        for (const m of missing) {
+            lines.push(`\nError: "${m.agent}" is not installed. Affected stages: ${m.stages.join(', ')}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Formats the pipeline startup summary showing per-stage configuration.
+ */
+export function formatPipelineSummary(config) {
+    const lines = ['Pipeline:'];
+    for (const stage of STAGE_NAMES) {
+        const sc = resolveStageConfig(config, stage);
+        const turns = sc.maxTurns ? ` (${sc.maxTurns} turns)` : '';
+        const padded = `${stage}:`.padEnd(14);
+        lines.push(`  ${padded}${sc.agent}/${sc.model}${turns}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/engine/prerequisites.js.map

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

package/dist/lib/agent.d.ts

@@ -0,0 +1,25 @@
+export type AgentResult = {
+    exitCode: number;
+    output: string;
+    duration: number;
+};
+export type AgentOptions = {
+    agent: 'claude' | 'codex' | 'opencode';
+    model: string;
+    prompt: string;
+    cwd: string;
+    logFile?: string;
+    verbose?: boolean;
+};
+/**
+ * Build CLI command and args for a given agent type.
+ */
+export declare function buildAgentArgs(options: AgentOptions): {
+    command: string;
+    args: string[];
+};
+/**
+ * Spawn an AI agent with a prompt.
+ * Streams output to terminal in real-time while capturing it.
+ */
+export declare function spawnAgent(options: AgentOptions): Promise<AgentResult>;