hivemind-pipeline 0.1.0

package/dist/src/commands/learn.js

@@ -0,0 +1,107 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { loadConfig, requireSwarmDir, autoDetectStack, autoInit } from '../core/config.js';
+import { extractConventions, buildConventionPrompt } from '../core/convention-extractor.js';
+export function registerLearn(program) {
+    program
+        .command('learn')
+        .description('Scan codebase and extract project conventions for all agents to follow')
+        .option('-s, --stack <stack>', 'Tech stack override')
+        .option('--refresh', 'Re-scan even if conventions file exists')
+        .option('--merge', 'Update existing conventions without overwriting manual edits')
+        .option('--show', 'Print conventions to stdout without saving')
+        .action(async (opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            const cwd = process.cwd();
+            const stack = opts.stack || autoDetectStack(cwd);
+            const projectName = cwd.split('/').pop() || 'my-project';
+            console.log(chalk.yellow(`No .swarm/ found — auto-initializing (stack: ${stack})...`));
+            swarmDir = autoInit(projectName, stack, cwd);
+        }
+        const config = loadConfig();
+        const cwd = process.cwd();
+        const conventionsPath = join(swarmDir, 'conventions.md');
+        // Check for existing conventions
+        if (existsSync(conventionsPath) && !opts.refresh && !opts.merge && !opts.show) {
+            console.log(chalk.yellow(`Conventions already exist at ${conventionsPath}`));
+            console.log(chalk.dim('Use --refresh to re-scan, --merge to update, or --show to view'));
+            console.log('');
+            const existing = readFileSync(conventionsPath, 'utf-8');
+            console.log(existing);
+            return;
+        }
+        const spinner = ora('Scanning codebase for conventions...').start();
+        try {
+            const conventions = extractConventions(cwd);
+            if (!conventions.trim()) {
+                spinner.warn('No conventions detected. Your project may be too small or use unfamiliar patterns.');
+                return;
+            }
+            const conventionDoc = buildConventionPrompt(conventions);
+            if (opts.show) {
+                spinner.stop();
+                console.log(conventionDoc);
+                return;
+            }
+            if (opts.merge && existsSync(conventionsPath)) {
+                // Merge: append new conventions after a separator, preserving manual edits
+                const existing = readFileSync(conventionsPath, 'utf-8');
+                const merged = [
+                    existing.trimEnd(),
+                    '',
+                    '---',
+                    '',
+                    '<!-- Auto-updated by hivemind learn --merge -->',
+                    conventions,
+                ].join('\n');
+                writeFileSync(conventionsPath, merged, 'utf-8');
+                spinner.succeed(`Conventions merged into ${conventionsPath}`);
+            }
+            else {
+                // Full write
+                const header = [
+                    '# Project Conventions',
+                    '',
+                    `<!-- Generated by \`hivemind learn\` on ${new Date().toISOString().split('T')[0]} -->`,
+                    '<!-- Edit freely — manual changes are preserved with --merge -->',
+                    '',
+                ].join('\n');
+                writeFileSync(conventionsPath, header + conventions + '\n', 'utf-8');
+                spinner.succeed(`Conventions saved to ${conventionsPath}`);
+            }
+            console.log('');
+            console.log(chalk.dim('Conventions will be injected into all pipeline agents automatically.'));
+            console.log(chalk.dim('Edit .swarm/conventions.md to customize. Re-run with --refresh to re-scan.'));
+        }
+        catch (err) {
+            spinner.fail(`Failed to extract conventions: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Load conventions from .swarm/conventions.md if it exists.
+ * Returns the convention text ready for injection into agent system prompts,
+ * or empty string if no conventions file.
+ */
+export function loadConventions(swarmDir) {
+    const conventionsPath = join(swarmDir, 'conventions.md');
+    if (!existsSync(conventionsPath))
+        return '';
+    try {
+        const raw = readFileSync(conventionsPath, 'utf-8');
+        if (!raw.trim())
+            return '';
+        return buildConventionPrompt(raw);
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=learn.js.map

package/dist/src/commands/learn.js.map

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

package/dist/src/commands/mayday.d.ts

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

package/dist/src/commands/mayday.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mayday.d.ts","sourceRoot":"","sources":["../../../src/commands/mayday.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoIrD"}

package/dist/src/commands/mayday.js

@@ -0,0 +1,145 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+import chalk from 'chalk';
+import { loadConfig, requireSwarmDir, autoDetectStack, autoInit } from '../core/config.js';
+import { createContext } from './shared.js';
+import { Pipeline } from '../core/pipeline.js';
+async function confirmCost(model, stageCount) {
+    const est = Pipeline.estimateCost(stageCount, model);
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(chalk.yellow(`Estimated cost: ~$${est.low.toFixed(2)}-$${est.high.toFixed(2)}. Proceed? [Y/n] `), (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() !== 'n');
+        });
+    });
+}
+export function registerMayday(program) {
+    program
+        .command('mayday')
+        .description('Autonomous end-to-end pipeline: analyze → build → test → fix loop until all tests pass')
+        .argument('[feature-request]', 'Feature request description (text or file path)')
+        .option('-s, --stack <stack>', 'Tech stack override (react, node, go)')
+        .option('-m, --model <model>', 'Model override (e.g., sonnet, openai/gpt-4o, ollama/llama3)')
+        .option('-p, --parallel <n>', 'Max parallel agents', '3')
+        .option('-n, --max-iterations <n>', 'Max fix-retest iterations', '5')
+        .option('--figma <url>', 'Figma design URL')
+        .option('-b, --budget <amount>', 'Max total budget in USD (default: from config, "none" for no limit)')
+        .option('--fix-budget <amount>', 'Max USD to spend on fix iterations (default: 15, "none" for no limit)', '15')
+        .option('-f, --file', 'Treat argument as a file path to read')
+        .option('--resume', 'Resume a previously interrupted MayDay session')
+        .option('-y, --yes', 'Skip cost confirmation prompt')
+        .option('--from <stage>', 'Skip stages before this one (analyze, architect, plan, build, test)')
+        .option('--approve', 'Require approval between pipeline stages')
+        .option('--no-git', 'Skip git branch creation and auto-commits')
+        .option('--lean', 'Lean mode: use haiku for docs stages (analyst/architect/lead/tester), keep engineer on default model')
+        .option('--smart', 'Smart model selection: sonnet for docs, opus for engineer')
+        .option('--headless', 'Skip all interactive pauses (for CI/automation)')
+        .action(async (featureRequest, opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            // Auto-init if .swarm/ doesn't exist
+            const cwd = process.cwd();
+            const stack = opts.stack || autoDetectStack(cwd);
+            const projectName = cwd.split('/').pop() || 'my-project';
+            console.log(chalk.yellow(`No .swarm/ found — auto-initializing (stack: ${stack})...`));
+            swarmDir = autoInit(projectName, stack, cwd);
+            console.log(chalk.green(`Initialized .swarm/ for "${projectName}"`));
+        }
+        const config = loadConfig();
+        if (opts.model)
+            config.model = opts.model;
+        if (opts.budget) {
+            config.maxBudgetUsd = opts.budget === 'none' ? null : (parseFloat(opts.budget) || null);
+        }
+        // Lean mode: haiku for docs stages, keep engineer on default model
+        // TODO: Use ModelCatalog.suggestForTier('lean') when available
+        if (opts.lean) {
+            const engineerModel = config.models?.engineer ?? config.model;
+            config.models = {
+                ...config.models,
+                analyst: 'haiku',
+                architect: 'haiku',
+                lead: 'haiku',
+                tester: 'haiku',
+                engineer: engineerModel,
+            };
+            console.log(chalk.dim(`[lean] Using haiku for docs stages, ${engineerModel} for engineer`));
+        }
+        // Smart mode: sonnet for docs stages, opus for engineer (best quality/cost balance)
+        // TODO: Use ModelCatalog.suggestForTier('smart') when available
+        if (opts.smart && !opts.lean) {
+            config.models = {
+                ...config.models,
+                analyst: 'sonnet',
+                architect: 'sonnet',
+                lead: 'sonnet',
+                tester: 'sonnet',
+                engineer: 'opus',
+            };
+            console.log(chalk.dim(`[smart] Using sonnet for docs stages, opus for engineer`));
+        }
+        const stack = opts.stack || config.stack;
+        const { pipeline, state, cleanup } = createContext(swarmDir, config);
+        pipeline.gitEnabled = opts.git !== false;
+        try {
+            // Resume mode
+            if (opts.resume) {
+                const mayday = state.getMayday();
+                if (!mayday?.active) {
+                    console.error(chalk.red('No active MayDay session to resume.'));
+                    console.error(chalk.dim(`Start a new one: ${chalk.bold('hivemind mayday "your feature request"')}`));
+                    process.exit(1);
+                }
+                await pipeline.resumeMayday({ parallel: parseInt(opts.parallel, 10) });
+                return;
+            }
+            // New run requires a feature request
+            if (!featureRequest) {
+                console.error(chalk.red('Feature request required. Usage: hivemind mayday "build a login page"'));
+                process.exit(1);
+            }
+            let prompt = featureRequest;
+            if (opts.file) {
+                if (!existsSync(featureRequest)) {
+                    console.error(chalk.red(`File not found: ${featureRequest}`));
+                    process.exit(1);
+                }
+                prompt = readFileSync(featureRequest, 'utf-8');
+            }
+            const fixBudget = opts.fixBudget === 'none' ? null : (parseFloat(opts.fixBudget) || 15);
+            // Cost confirmation (MayDay = 5 stages + fix iterations, estimate 6x)
+            // Lean mode uses haiku for 4 stages + engineer model for 2 stages
+            if (!opts.yes) {
+                const confirmed = opts.lean
+                    ? await confirmCost('haiku', 4).then(ok => ok ? confirmCost(config.model, 2) : false)
+                    : await confirmCost(config.model, 6);
+                if (!confirmed) {
+                    console.log(chalk.dim('Aborted.'));
+                    return;
+                }
+            }
+            await pipeline.runMayday(prompt, {
+                stack,
+                maxIterations: parseInt(opts.maxIterations, 10),
+                figmaUrl: opts.figma,
+                parallel: parseInt(opts.parallel, 10),
+                maxFixBudgetUsd: fixBudget,
+                fromStage: opts.from,
+                approvalRequired: opts.approve ?? false,
+                headless: opts.headless ?? false,
+            });
+        }
+        catch (err) {
+            console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+            process.exit(1);
+        }
+        finally {
+            cleanup();
+        }
+    });
+}
+//# sourceMappingURL=mayday.js.map

package/dist/src/commands/mayday.js.map

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

package/dist/src/commands/memory.d.ts

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

package/dist/src/commands/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/commands/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2GrD"}

package/dist/src/commands/memory.js

@@ -0,0 +1,113 @@
+import chalk from 'chalk';
+import { requireSwarmDir, autoDetectStack, autoInit } from '../core/config.js';
+import { MemoryStore } from '../core/memory-store.js';
+export function registerMemory(program) {
+    const mem = program
+        .command('memory')
+        .description('Manage cross-run pipeline memory — what worked, what failed, patterns learned');
+    mem
+        .command('list')
+        .description('List all active memories')
+        .option('-k, --kind <kind>', 'Filter by kind (fix-pattern, flaky-test, approach, performance, manual, success)')
+        .option('-t, --tag <tag>', 'Filter by tag')
+        .action((opts) => {
+        const swarmDir = getSwarmDir();
+        const store = new MemoryStore(swarmDir);
+        let entries = store.list();
+        if (opts.kind) {
+            entries = entries.filter(e => e.kind === opts.kind);
+        }
+        if (opts.tag) {
+            entries = entries.filter(e => e.tags.includes(opts.tag) || e.content.toLowerCase().includes(opts.tag.toLowerCase()));
+        }
+        if (entries.length === 0) {
+            console.log(chalk.dim('No memories stored. Memories are recorded automatically after pipeline runs.'));
+            console.log(chalk.dim('Add one manually: swarm memory add "note about your project"'));
+            return;
+        }
+        console.log(chalk.bold(`\nStored memories (${entries.length}):\n`));
+        for (const entry of entries) {
+            const kindColor = {
+                'fix-pattern': chalk.yellow,
+                'flaky-test': chalk.red,
+                'approach': chalk.blue,
+                'performance': chalk.magenta,
+                'manual': chalk.green,
+                'success': chalk.cyan,
+            }[entry.kind] ?? chalk.white;
+            const confidence = entry.confidence >= 80 ? chalk.green('HIGH') :
+                entry.confidence >= 50 ? chalk.yellow('MED') : chalk.red('LOW');
+            console.log(`  ${kindColor(`[${entry.kind}]`)} ${confidence} — ${entry.content}`);
+            console.log(chalk.dim(`    ID: ${entry.id} | Expires: ${entry.expiresAt.split('T')[0]} | Tags: ${entry.tags.join(', ') || 'none'}`));
+            console.log('');
+        }
+    });
+    mem
+        .command('add')
+        .description('Manually add a memory note')
+        .argument('<note>', 'Memory content')
+        .option('-k, --kind <kind>', 'Memory kind', 'manual')
+        .option('-c, --confidence <n>', 'Confidence score 0-100', '80')
+        .option('-t, --tags <tags>', 'Comma-separated tags')
+        .action((note, opts) => {
+        const swarmDir = getSwarmDir();
+        const store = new MemoryStore(swarmDir);
+        const entry = store.add({
+            kind: (opts.kind || 'manual'),
+            content: note,
+            confidence: parseInt(opts.confidence) || 80,
+            source: 'manual',
+            tags: opts.tags ? opts.tags.split(',').map((t) => t.trim()) : [],
+        });
+        console.log(chalk.green(`Memory added: ${entry.id}`));
+    });
+    mem
+        .command('clear')
+        .description('Clear all stored memories')
+        .action(() => {
+        const swarmDir = getSwarmDir();
+        const store = new MemoryStore(swarmDir);
+        store.clear();
+        console.log(chalk.yellow('All memories cleared.'));
+    });
+    mem
+        .command('remove')
+        .description('Remove a specific memory by ID')
+        .argument('<id>', 'Memory ID')
+        .action((id) => {
+        const swarmDir = getSwarmDir();
+        const store = new MemoryStore(swarmDir);
+        if (store.remove(id)) {
+            console.log(chalk.green(`Memory ${id} removed.`));
+        }
+        else {
+            console.log(chalk.red(`Memory ${id} not found.`));
+        }
+    });
+    mem
+        .command('show')
+        .description('Show memory context as it would be injected into agents')
+        .action(() => {
+        const swarmDir = getSwarmDir();
+        const store = new MemoryStore(swarmDir);
+        const context = store.buildMemoryContext();
+        if (!context) {
+            console.log(chalk.dim('No memories to show.'));
+            return;
+        }
+        console.log(context);
+    });
+}
+function getSwarmDir() {
+    try {
+        return requireSwarmDir();
+    }
+    catch {
+        const cwd = process.cwd();
+        const stack = autoDetectStack(cwd);
+        const projectName = cwd.split('/').pop() || 'my-project';
+        console.log(chalk.yellow(`No .swarm/ found — auto-initializing (stack: ${stack})...`));
+        return autoInit(projectName, stack, cwd);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/commands/memory.js.map

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

package/dist/src/commands/mentor.d.ts

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

package/dist/src/commands/mentor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentor.d.ts","sourceRoot":"","sources":["../../../src/commands/mentor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCpC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8CrD"}

package/dist/src/commands/mentor.js

@@ -0,0 +1,225 @@
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import ora from 'ora';
+import { loadConfig, requireSwarmDir, autoDetectStack, autoInit } from '../core/config.js';
+import { createContext } from './shared.js';
+import { scanCodebase } from '../core/codebase-scanner.js';
+import { loadConventions } from './learn.js';
+const MENTOR_SYSTEM_PROMPT = [
+    'You are a senior engineering mentor. Your goal is to TEACH and EXPLAIN, not just answer.',
+    '',
+    'When answering questions:',
+    '- Explain the "why" behind things, not just the "what"',
+    '- Use analogies and examples from the actual codebase',
+    '- Point to specific files and line numbers',
+    '- Suggest follow-up topics the developer should explore',
+    '- If the question reveals a misunderstanding, gently correct it',
+    '',
+    'When reviewing code:',
+    '- Focus on learning opportunities, not just errors',
+    '- Explain the reasoning behind best practices',
+    '- Suggest concrete improvements with examples',
+    '- Highlight what the developer did well (positive reinforcement)',
+    '',
+    'When explaining code:',
+    '- Start with the big picture, then zoom in',
+    '- Trace the flow of data through the system',
+    '- Explain design decisions and trade-offs',
+    '- Suggest related areas to explore next',
+    '',
+    'Always read the actual source files before answering. Do NOT guess.',
+].join('\n');
+export function registerMentor(program) {
+    const mentorCmd = program
+        .command('mentor')
+        .description('AI mentor — ask questions, get educational code reviews, or deep-dive into areas')
+        .argument('[question...]', 'Ask a contextual question about the codebase')
+        .option('-s, --stack <stack>', 'Tech stack override')
+        .option('-m, --model <model>', 'Model override (e.g., sonnet, openai/gpt-4o, ollama/llama3)')
+        .option('-b, --budget <amount>', 'Max budget in USD', '3')
+        .option('-i, --interactive', 'Interactive mode — follow-up Q&A in terminal')
+        .action(async (questionParts, opts) => {
+        const question = questionParts.join(' ');
+        if (!question) {
+            console.log(chalk.yellow('Usage: hivemind mentor <question>'));
+            console.log(chalk.dim('  hivemind mentor "How does authentication work?"'));
+            console.log(chalk.dim('  hivemind mentor review'));
+            console.log(chalk.dim('  hivemind mentor explain src/core/pipeline.ts'));
+            return;
+        }
+        await runMentor(question, opts, 'question');
+    });
+    // Subcommand: review
+    mentorCmd
+        .command('review')
+        .description('Educational code review of staged or recent changes')
+        .option('-s, --stack <stack>', 'Tech stack override')
+        .option('-m, --model <model>', 'Model override (e.g., sonnet, openai/gpt-4o, ollama/llama3)')
+        .option('-b, --budget <amount>', 'Max budget in USD', '3')
+        .option('--file <path>', 'Review a specific file instead of staged changes')
+        .option('--commit <sha>', 'Review a specific commit')
+        .action(async (opts) => {
+        await runMentor('', opts, 'review');
+    });
+    // Subcommand: explain
+    mentorCmd
+        .command('explain <path>')
+        .description('Deep educational dive into a file or directory')
+        .option('-s, --stack <stack>', 'Tech stack override')
+        .option('-m, --model <model>', 'Model override (e.g., sonnet, openai/gpt-4o, ollama/llama3)')
+        .option('-b, --budget <amount>', 'Max budget in USD', '3')
+        .option('-i, --interactive', 'Interactive mode — follow-up Q&A in terminal')
+        .action(async (path, opts) => {
+        await runMentor(path, opts, 'explain');
+    });
+}
+async function runMentor(input, opts, mode) {
+    let swarmDir;
+    try {
+        swarmDir = requireSwarmDir();
+    }
+    catch {
+        const cwd = process.cwd();
+        const stack = opts.stack || autoDetectStack(cwd);
+        const projectName = cwd.split('/').pop() || 'my-project';
+        console.log(chalk.yellow(`No .swarm/ found — auto-initializing (stack: ${stack})...`));
+        swarmDir = autoInit(projectName, stack, cwd);
+    }
+    const config = loadConfig();
+    config.model = opts.model || config.model;
+    const budgetStr = opts.budget || '3';
+    config.maxBudgetUsd = budgetStr === 'none' ? null : (parseFloat(budgetStr) || 3);
+    const cwd = process.cwd();
+    const stack = opts.stack || config.stack;
+    const interactive = opts.interactive ?? false;
+    const { agentManager, cleanup } = createContext(swarmDir, config);
+    try {
+        const prompt = buildMentorPrompt(cwd, swarmDir, input, mode, stack, opts, config.packages);
+        const modeLabel = {
+            question: `Answering: ${input.slice(0, 80)}`,
+            review: opts.file ? `Reviewing: ${opts.file}` : 'Educational code review',
+            explain: `Deep dive: ${input}`,
+        }[mode];
+        console.log(chalk.bold('\nSwarm Mentor'));
+        console.log(chalk.dim(`${modeLabel}`));
+        console.log(chalk.dim(`Model: ${config.model} | Stack: ${stack}\n`));
+        if (interactive) {
+            const agent = await agentManager.spawn({
+                name: `mentor-${mode}`,
+                persona: 'engineer',
+                stack,
+                prompt,
+                model: config.model,
+                cwd,
+                interactive: true,
+                disallowedTools: ['Edit', 'Write', 'NotebookEdit', 'Bash'],
+            });
+            await agentManager.waitForAgent(agent.id);
+            saveMentorHistory(swarmDir, mode, input, agent.output);
+        }
+        else {
+            const spinner = ora('Thinking...').start();
+            const agent = await agentManager.spawn({
+                name: `mentor-${mode}`,
+                persona: 'engineer',
+                stack,
+                prompt,
+                model: config.model,
+                cwd,
+                interactive: false,
+                permissionMode: 'auto',
+                disallowedTools: ['Edit', 'Write', 'NotebookEdit', 'Bash'],
+            });
+            await agentManager.waitForAgent(agent.id);
+            const cost = agent.cost.totalUsd;
+            if (agent.status === 'done') {
+                spinner.succeed(`Done. Cost: $${cost.toFixed(2)}`);
+                saveMentorHistory(swarmDir, mode, input, agent.output);
+            }
+            else {
+                spinner.fail(`Mentor failed: ${agent.error || 'Unknown error'}`);
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+        process.exit(1);
+    }
+    finally {
+        cleanup();
+    }
+}
+function buildMentorPrompt(cwd, swarmDir, input, mode, stack, opts, packages) {
+    const parts = [];
+    // Codebase context
+    const codebaseCtx = scanCodebase(cwd, packages);
+    if (codebaseCtx)
+        parts.push(codebaseCtx);
+    // Conventions
+    const conventions = loadConventions(swarmDir);
+    if (conventions)
+        parts.push(conventions);
+    // Mentor system prompt
+    parts.push('', MENTOR_SYSTEM_PROMPT, '');
+    switch (mode) {
+        case 'question':
+            parts.push('TASK: Answer the following question about this codebase in a teaching/mentoring style.', '', `QUESTION: "${input}"`, '', 'Instructions:', '1. Read relevant source files to give an accurate answer', '2. Explain the "why" behind the answer, not just the "what"', '3. Point to specific files and code locations', '4. Suggest 2-3 follow-up topics the developer should explore', '5. If the question touches on a design decision, explain the trade-offs');
+            break;
+        case 'review': {
+            parts.push('TASK: Educational code review — teach through reviewing code.', '');
+            if (opts.file) {
+                parts.push(`Review the file: ${opts.file}`, '', 'Instructions:', '1. Read the file and understand its purpose in the project', '2. Review for: correctness, patterns, readability, performance, security', '3. For each finding, EXPLAIN why it matters (teach, don\'t just critique)', '4. Highlight good practices the developer used', '5. Suggest concrete improvements with code examples', '6. Rate overall quality and suggest priority improvements');
+            }
+            else if (opts.commit) {
+                parts.push(`Review the changes in commit: ${opts.commit}`, '', `Run: git show ${opts.commit}`, '', 'Instructions:', '1. Understand the intent of the commit', '2. Review changes for: correctness, patterns, edge cases', '3. Explain any concerns in a teaching style', '4. Highlight good decisions in the commit');
+            }
+            else {
+                parts.push('Review the currently staged changes (git diff --staged) or recent uncommitted changes (git diff).', '', 'Run: git diff --staged (or git diff if nothing is staged)', '', 'Instructions:', '1. Understand what the changes are trying to accomplish', '2. Review for: correctness, consistency with project patterns, edge cases', '3. Teach about any patterns being broken or improved', '4. Highlight good practices in the changes', '5. Suggest improvements with explanations');
+            }
+            break;
+        }
+        case 'explain':
+            parts.push(`TASK: Educational deep-dive into: ${input}`, '', 'Instructions:', '1. Read the file/directory and understand its role in the project', '2. Start with the big picture — what problem does this solve?', '3. Walk through the code structure, explaining each key part', '4. Trace the data flow through this module', '5. Explain design decisions and trade-offs', '6. Show how this connects to the rest of the codebase', '7. Point out patterns a new developer should learn from this code', '8. Suggest related areas to explore next', '', 'Think of this as a pairing session where you\'re walking a junior developer through the code.');
+            break;
+    }
+    return parts.filter(Boolean).join('\n');
+}
+function saveMentorHistory(swarmDir, mode, input, output) {
+    try {
+        const progressPath = join(swarmDir, 'onboard-progress.json');
+        let progress;
+        if (existsSync(progressPath)) {
+            progress = JSON.parse(readFileSync(progressPath, 'utf-8'));
+        }
+        else {
+            progress = {
+                step: 0,
+                totalSteps: 5,
+                currentTopic: '',
+                content: '',
+                completed: [],
+                remaining: [],
+                mentorHistory: [],
+            };
+        }
+        progress.mentorHistory.push({
+            question: `[${mode}] ${input}`,
+            answer: output.slice(0, 1000),
+            timestamp: Date.now(),
+        });
+        // Keep last 50 entries
+        if (progress.mentorHistory.length > 50) {
+            progress.mentorHistory = progress.mentorHistory.slice(-50);
+        }
+        const dir = join(progressPath, '..');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(progressPath, JSON.stringify(progress, null, 2), 'utf-8');
+    }
+    catch {
+        // Non-critical — don't fail the command
+    }
+}
+//# sourceMappingURL=mentor.js.map