hivemind-pipeline 0.1.0

package/dist/src/commands/onboard.js

@@ -0,0 +1,263 @@
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+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 ONBOARD_STEPS = [
+    'project-overview',
+    'dev-workflow',
+    'key-areas',
+    'conventions',
+    'common-pitfalls',
+];
+const STEP_LABELS = {
+    'project-overview': 'Project Overview',
+    'dev-workflow': 'Development Workflow',
+    'key-areas': 'Key Areas Tour',
+    'conventions': 'Conventions & Patterns',
+    'common-pitfalls': 'Common Pitfalls',
+};
+export function registerOnboard(program) {
+    program
+        .command('onboard')
+        .description('Start guided onboarding tour of the codebase')
+        .option('-s, --stack <stack>', 'Tech stack override')
+        .option('-m, --model <model>', 'Model override (e.g., sonnet, openai/gpt-4o, ollama/llama3)')
+        .option('-r, --role <role>', 'Role-specific onboarding: frontend, backend, fullstack')
+        .option('-a, --area <name>', 'Area-specific deep dive (e.g. api, auth, database)')
+        .option('--reset', 'Reset onboarding progress and start fresh')
+        .option('-b, --budget <amount>', 'Max budget in USD', '5')
+        .option('--step <number>', 'Jump to a specific step (1-5)')
+        .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();
+        config.model = opts.model || config.model;
+        config.maxBudgetUsd = opts.budget === 'none' ? null : (parseFloat(opts.budget) || 5);
+        const cwd = process.cwd();
+        const stack = opts.stack || config.stack;
+        const role = opts.role;
+        const area = opts.area;
+        const progressPath = join(swarmDir, 'onboard-progress.json');
+        // Load or initialize progress
+        let progress = loadProgress(progressPath);
+        if (opts.reset) {
+            progress = createFreshProgress();
+            saveProgress(progressPath, progress);
+            console.log(chalk.yellow('Onboarding progress reset.'));
+        }
+        // If area-specific deep dive, skip the normal flow
+        if (area) {
+            await runAreaDeepDive(swarmDir, config, cwd, stack, area, role);
+            return;
+        }
+        // Determine starting step
+        let startStep = 0;
+        if (opts.step) {
+            startStep = Math.max(0, Math.min(ONBOARD_STEPS.length - 1, parseInt(opts.step, 10) - 1));
+        }
+        else {
+            // Resume from where we left off
+            startStep = progress.completed.length;
+            if (startStep >= ONBOARD_STEPS.length) {
+                console.log(chalk.green('\nOnboarding already complete! Use --reset to start over.\n'));
+                printProgress(progress);
+                return;
+            }
+        }
+        console.log(chalk.bold('\nSwarm Onboarding Tour'));
+        console.log(chalk.dim(`Model: ${config.model} | Stack: ${stack} | Role: ${role || 'general'}`));
+        if (progress.completed.length > 0) {
+            console.log(chalk.dim(`Resuming from step ${startStep + 1}/${ONBOARD_STEPS.length}`));
+        }
+        console.log('');
+        const { agentManager, cleanup } = createContext(swarmDir, config);
+        try {
+            for (let i = startStep; i < ONBOARD_STEPS.length; i++) {
+                const stepName = ONBOARD_STEPS[i];
+                const stepLabel = STEP_LABELS[stepName];
+                console.log(chalk.bold.cyan(`\n--- Step ${i + 1}/${ONBOARD_STEPS.length}: ${stepLabel} ---\n`));
+                const prompt = buildStepPrompt(cwd, swarmDir, stepName, stack, role, config.packages);
+                const agent = await agentManager.spawn({
+                    name: `onboard-${stepName}`,
+                    persona: 'engineer',
+                    stack,
+                    prompt,
+                    model: config.model,
+                    cwd,
+                    interactive: true,
+                    disallowedTools: ['Edit', 'Write', 'NotebookEdit'],
+                });
+                await agentManager.waitForAgent(agent.id);
+                // Update progress
+                if (!progress.completed.includes(stepName)) {
+                    progress.completed.push(stepName);
+                }
+                progress.remaining = ONBOARD_STEPS.filter(s => !progress.completed.includes(s));
+                progress.step = i + 1;
+                progress.totalSteps = ONBOARD_STEPS.length;
+                progress.currentTopic = stepLabel;
+                progress.content = agent.output.slice(0, 2000);
+                saveProgress(progressPath, progress);
+                if (i < ONBOARD_STEPS.length - 1) {
+                    console.log(chalk.dim(`\nProgress saved. ${ONBOARD_STEPS.length - i - 1} steps remaining.`));
+                }
+            }
+            console.log(chalk.bold.green('\n\nOnboarding complete!'));
+            console.log(chalk.dim(`Progress saved to ${progressPath}`));
+            printProgress(progress);
+        }
+        catch (err) {
+            console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+            saveProgress(progressPath, progress);
+            console.log(chalk.yellow('Progress saved. Run `hivemind onboard` to resume.'));
+            process.exit(1);
+        }
+        finally {
+            cleanup();
+        }
+    });
+}
+function buildStepPrompt(cwd, swarmDir, step, stack, role, packages) {
+    const parts = [];
+    // Base context
+    const codebaseCtx = scanCodebase(cwd, packages);
+    if (codebaseCtx)
+        parts.push(codebaseCtx);
+    const conventions = loadConventions(swarmDir);
+    if (conventions)
+        parts.push(conventions);
+    // Role context
+    const roleCtx = role
+        ? `The developer being onboarded is a ${role} engineer. Focus your explanations on areas most relevant to their role.`
+        : 'The developer being onboarded is a general contributor.';
+    parts.push(roleCtx);
+    parts.push('');
+    parts.push('You are an onboarding guide helping a new developer understand this codebase.');
+    parts.push('Be welcoming, thorough, and practical. Use concrete examples from the actual code.');
+    parts.push('Read the relevant files to give accurate information. Do NOT guess.');
+    parts.push('');
+    switch (step) {
+        case 'project-overview':
+            parts.push('TASK: Project Overview — The first step of onboarding.', '', 'Cover:', '1. What the project does and who uses it', '2. High-level architecture (read package.json, README.md, and entry points)', '3. Repository structure — key directories and what lives where', '4. Tech stack — languages, frameworks, major dependencies', '5. How to set up the project locally (install, build, run)', '', 'Read package.json, README.md, and any architecture docs. Explore the top-level directory structure.', 'Present as a friendly onboarding guide, not a dry documentation dump.');
+            break;
+        case 'dev-workflow':
+            parts.push('TASK: Development Workflow — How to work in this codebase day-to-day.', '', 'Cover:', '1. Build process (read build scripts in package.json or Makefile)', '2. Test workflow (how to run tests, test structure)', '3. CI/CD pipeline (read .github/workflows/ or CI config if exists)', '4. Git workflow (branching strategy, PR process)', '5. Local development tips (dev servers, hot reload, debugging)', '', 'Read the actual build scripts, CI configs, and any contributing guides.');
+            break;
+        case 'key-areas':
+            parts.push('TASK: Key Areas Tour — The most important modules and how they connect.', '', 'Cover:', '1. Find the most-imported/referenced modules (core abstractions)', '2. Explain each key module: what it does, its public API, how it connects to others', '3. Data flow — how data moves through the system', '4. Entry points — where requests/commands/events enter the system', '5. Extension points — where new features are typically added', '', 'Read the actual source files. Focus on the 5-8 most important modules.');
+            break;
+        case 'conventions':
+            parts.push('TASK: Conventions & Patterns — The unwritten (and written) rules of this codebase.', '', 'Cover:', '1. Coding conventions (naming, file structure, import patterns)', '2. Architectural patterns (how new features should be structured)', '3. Error handling patterns', '4. Configuration patterns', '5. Read .swarm/conventions.md if it exists for explicit conventions', '', 'Read actual source files to identify patterns. Give concrete examples.');
+            // Include conventions file if it exists
+            const convPath = join(swarmDir, 'conventions.md');
+            if (existsSync(convPath)) {
+                try {
+                    const convContent = readFileSync(convPath, 'utf-8').slice(0, 5000);
+                    parts.push('', 'EXISTING CONVENTIONS FILE (.swarm/conventions.md):', convContent);
+                }
+                catch { /* skip */ }
+            }
+            break;
+        case 'common-pitfalls':
+            parts.push('TASK: Common Pitfalls — Things that catch new developers off guard.', '', 'Cover:', '1. Known gotchas (read CLAUDE.md or similar docs for documented gotchas)', '2. Tricky configurations or environment requirements', '3. Common mistakes new contributors make (infer from code patterns)', '4. Performance traps or anti-patterns to avoid', '5. If .swarm/journal/ exists, read decision entries for context on past decisions', '', 'Be specific and actionable. For each pitfall, explain what goes wrong and how to avoid it.');
+            // Include journal entries if they exist
+            const journalDir = join(swarmDir, 'journal');
+            if (existsSync(journalDir)) {
+                try {
+                    const entries = execSync(`ls -t "${journalDir}" | head -5`, { encoding: 'utf-8', cwd }).trim();
+                    if (entries) {
+                        parts.push('', 'RECENT DECISION JOURNAL ENTRIES:', entries);
+                    }
+                }
+                catch { /* skip */ }
+            }
+            break;
+    }
+    return parts.filter(Boolean).join('\n');
+}
+async function runAreaDeepDive(swarmDir, config, cwd, stack, area, role) {
+    console.log(chalk.bold(`\nSwarm Onboard — Deep Dive: ${area}`));
+    console.log(chalk.dim(`Model: ${config.model} | Stack: ${stack}\n`));
+    const { agentManager, cleanup } = createContext(swarmDir, config);
+    try {
+        const parts = [];
+        const codebaseCtx = scanCodebase(cwd, config.packages);
+        if (codebaseCtx)
+            parts.push(codebaseCtx);
+        const conventions = loadConventions(swarmDir);
+        if (conventions)
+            parts.push(conventions);
+        if (role) {
+            parts.push(`The developer is a ${role} engineer. Tailor explanations accordingly.`);
+        }
+        parts.push('', 'You are an onboarding guide doing a deep dive into a specific area of the codebase.', '', `TASK: Deep dive into the "${area}" area of this project.`, '', 'Cover:', `1. Find all files/modules related to "${area}"`, '2. Explain the architecture of this area in detail', '3. Key abstractions and their relationships', '4. How this area connects to the rest of the codebase', '5. How to make changes in this area (patterns to follow)', '6. Tests related to this area and how to run them', '7. Common pitfalls specific to this area', '', 'Read the actual source files. Be thorough and specific.');
+        const agent = await agentManager.spawn({
+            name: `onboard-deepdive-${area}`,
+            persona: 'engineer',
+            stack,
+            prompt: parts.filter(Boolean).join('\n'),
+            model: config.model,
+            cwd,
+            interactive: true,
+            disallowedTools: ['Edit', 'Write', 'NotebookEdit'],
+        });
+        await agentManager.waitForAgent(agent.id);
+    }
+    catch (err) {
+        console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+        process.exit(1);
+    }
+    finally {
+        cleanup();
+    }
+}
+function loadProgress(path) {
+    if (existsSync(path)) {
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch { /* corrupted, start fresh */ }
+    }
+    return createFreshProgress();
+}
+function createFreshProgress() {
+    return {
+        step: 0,
+        totalSteps: ONBOARD_STEPS.length,
+        currentTopic: '',
+        content: '',
+        completed: [],
+        remaining: [...ONBOARD_STEPS],
+        mentorHistory: [],
+    };
+}
+function saveProgress(path, data) {
+    const dir = join(path, '..');
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8');
+}
+function printProgress(progress) {
+    console.log('');
+    for (const step of ONBOARD_STEPS) {
+        const done = progress.completed.includes(step);
+        const icon = done ? chalk.green('[x]') : chalk.dim('[ ]');
+        console.log(`  ${icon} ${STEP_LABELS[step]}`);
+    }
+    console.log('');
+}
+//# sourceMappingURL=onboard.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../../src/commands/optimize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0GzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2QvD"}

package/dist/src/commands/optimize.js

@@ -0,0 +1,340 @@
+import chalk from 'chalk';
+import { requireSwarmDir, loadConfig } from '../core/config.js';
+import { PerfAnalyzer } from '../core/perf-analyzer.js';
+// ─── Display helpers ────────────────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+function printHotPaths(hotPaths) {
+    if (hotPaths.length === 0)
+        return;
+    console.log(chalk.bold('\n  Hot Paths'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+    console.log(chalk.dim('  Function                          File                CPU%   Calls'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+    for (const hp of hotPaths.slice(0, 15)) {
+        const fn = hp.function.slice(0, 32).padEnd(34);
+        const file = `${hp.file}:${hp.line}`.slice(0, 18).padEnd(20);
+        const cpu = `${hp.cpuPercent.toFixed(1)}%`.padStart(5);
+        const calls = String(hp.callCount).padStart(7);
+        const color = hp.cpuPercent > 20 ? chalk.red : hp.cpuPercent > 10 ? chalk.yellow : chalk.white;
+        console.log(`  ${color(fn)}${chalk.dim(file)}${color(cpu)}${chalk.dim(calls)}`);
+    }
+    console.log('');
+}
+function printQueryIssues(issues) {
+    if (issues.length === 0)
+        return;
+    console.log(chalk.bold('\n  Query Issues'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+    for (const iss of issues.slice(0, 20)) {
+        const typeColor = iss.type === 'n-plus-one' ? chalk.red
+            : iss.type === 'full-scan' ? chalk.yellow
+                : chalk.cyan;
+        console.log(`  ${typeColor(`[${iss.type}]`.padEnd(16))} ${chalk.dim(`${iss.file}:${iss.line}`)}`);
+        console.log(`    ${chalk.dim(iss.query.slice(0, 100))}`);
+        console.log(`    ${chalk.green('Fix:')} ${iss.suggestion}`);
+        console.log(`    ${chalk.dim(`Est. impact: ~${iss.estimatedImpactMs}ms`)}`);
+        console.log('');
+    }
+}
+function printMemoryLeaks(leaks) {
+    if (!leaks || leaks.length === 0)
+        return;
+    console.log(chalk.bold('\n  Memory Leak Patterns'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+    for (const leak of leaks.slice(0, 20)) {
+        console.log(`  ${chalk.yellow('!')} ${chalk.dim(leak.location)}`);
+        console.log(`    ${leak.description}`);
+        console.log('');
+    }
+}
+function printBundleSize(bundleSize) {
+    if (!bundleSize)
+        return;
+    console.log(chalk.bold('\n  Bundle Analysis'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+    console.log(`  Total dist size: ${chalk.bold(formatBytes(bundleSize.totalBytes))}`);
+    if (bundleSize.largestModules.length > 0) {
+        console.log(chalk.bold('\n  Largest Dependencies'));
+        for (const mod of bundleSize.largestModules.slice(0, 10)) {
+            const bar = chalk.cyan('#'.repeat(Math.min(40, Math.round(mod.bytes / (1024 * 100)))));
+            console.log(`    ${mod.name.padEnd(30)} ${formatBytes(mod.bytes).padStart(10)} ${bar}`);
+        }
+    }
+    console.log('');
+}
+function printRecommendations(recs) {
+    if (recs.length === 0)
+        return;
+    console.log(chalk.bold('\n  Recommendations'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+    for (const rec of recs) {
+        console.log(`  ${chalk.green('>')} ${rec}`);
+    }
+    console.log('');
+}
+function printReport(report) {
+    const typeLabel = report.type.charAt(0).toUpperCase() + report.type.slice(1);
+    console.log(chalk.bold(`\n  Optimization Report — ${typeLabel}`));
+    console.log(chalk.dim(`  Generated: ${new Date(report.timestamp).toLocaleString()}`));
+    printHotPaths(report.hotPaths);
+    printQueryIssues(report.queryIssues);
+    printBundleSize(report.bundleSize);
+    printMemoryLeaks(report.memoryLeaks);
+    printRecommendations(report.recommendations);
+    if (report.improvements.length > 0) {
+        console.log(chalk.bold('\n  Measured Improvements'));
+        console.log(chalk.dim('  ─────────────────────────────────────────────────────────────'));
+        for (const imp of report.improvements) {
+            console.log(`  ${chalk.green('+')} ${imp.description}`);
+            console.log(`    ${chalk.dim(imp.beforeMetric)} ${chalk.green('->')} ${chalk.bold(imp.afterMetric)} ${chalk.green(`(${imp.improvementPercent.toFixed(1)}% better)`)}`);
+        }
+        console.log('');
+    }
+}
+// ─── Command registration ────────────────────────────────────────────────────
+export function registerOptimize(program) {
+    const opt = program
+        .command('optimize')
+        .alias('perf')
+        .description('AI-driven performance optimization — profile, bundle, query, and memory analysis');
+    // Default: show last report
+    opt.action(() => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const analyzer = new PerfAnalyzer(swarmDir, config.stack);
+        const report = analyzer.getReport();
+        if (!report) {
+            console.log(chalk.dim('\n  No optimization reports yet. Run one of:'));
+            console.log(chalk.dim('    swarm optimize profile   — Run profiler and analyze hot paths'));
+            console.log(chalk.dim('    swarm optimize bundle    — Analyze bundle size'));
+            console.log(chalk.dim('    swarm optimize queries   — Find slow database queries'));
+            console.log(chalk.dim('    swarm optimize memory    — Detect memory leak patterns'));
+            console.log(chalk.dim('    swarm optimize "<goal>"  — Goal-directed optimization\n'));
+            return;
+        }
+        printReport(report);
+    });
+    // ── profile ───────────────────────────────────────────────────────────
+    opt
+        .command('profile')
+        .description('Run profiler and analyze hot paths')
+        .option('--stack <stack>', 'Override detected stack (node, go, python)')
+        .option('--scope <path>', 'Limit analysis to specific directory')
+        .option('--dry-run', 'Show what would be profiled without running')
+        .option('--json', 'Output as JSON')
+        .action((opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const stack = (opts.stack ?? config.stack);
+        const analyzer = new PerfAnalyzer(swarmDir, stack);
+        if (opts.dryRun) {
+            console.log(chalk.dim(`\n  Would profile project with stack: ${stack ?? 'auto-detect'}`));
+            console.log(chalk.dim(`  Scope: ${opts.scope ?? 'entire project'}\n`));
+            return;
+        }
+        console.log(chalk.bold('\n  Running profiler...\n'));
+        const report = analyzer.profile(opts.scope);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+        }
+    });
+    // ── bundle ────────────────────────────────────────────────────────────
+    opt
+        .command('bundle')
+        .description('Analyze and optimize bundle size (JS/TS projects)')
+        .option('--scope <path>', 'Limit analysis to specific directory')
+        .option('--dry-run', 'Show what would be analyzed without running')
+        .option('--json', 'Output as JSON')
+        .action((opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const analyzer = new PerfAnalyzer(swarmDir, config.stack);
+        if (opts.dryRun) {
+            console.log(chalk.dim('\n  Would analyze bundle size and dependencies'));
+            console.log(chalk.dim(`  Scope: ${opts.scope ?? 'entire project'}\n`));
+            return;
+        }
+        console.log(chalk.bold('\n  Analyzing bundle...\n'));
+        const report = analyzer.analyzeBundle(opts.scope);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+        }
+    });
+    // ── queries ───────────────────────────────────────────────────────────
+    opt
+        .command('queries')
+        .description('Find slow database queries and N+1 patterns')
+        .option('--scope <path>', 'Limit analysis to specific directory')
+        .option('--dry-run', 'Show what would be analyzed without running')
+        .option('--json', 'Output as JSON')
+        .action((opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const analyzer = new PerfAnalyzer(swarmDir, config.stack);
+        if (opts.dryRun) {
+            console.log(chalk.dim('\n  Would scan source files for slow query patterns'));
+            console.log(chalk.dim(`  Scope: ${opts.scope ?? 'entire project'}\n`));
+            return;
+        }
+        console.log(chalk.bold('\n  Analyzing queries...\n'));
+        const report = analyzer.analyzeQueries(opts.scope);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+        }
+    });
+    // ── memory ────────────────────────────────────────────────────────────
+    opt
+        .command('memory')
+        .description('Detect memory leak patterns')
+        .option('--stack <stack>', 'Override detected stack (node, go, python)')
+        .option('--scope <path>', 'Limit analysis to specific directory')
+        .option('--dry-run', 'Show what would be analyzed without running')
+        .option('--json', 'Output as JSON')
+        .action((opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const stack = (opts.stack ?? config.stack);
+        const analyzer = new PerfAnalyzer(swarmDir, stack);
+        if (opts.dryRun) {
+            console.log(chalk.dim('\n  Would scan source files for memory leak patterns'));
+            console.log(chalk.dim(`  Scope: ${opts.scope ?? 'entire project'}\n`));
+            return;
+        }
+        console.log(chalk.bold('\n  Analyzing memory patterns...\n'));
+        const report = analyzer.analyzeMemory(opts.scope);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+        }
+    });
+    // ── goal-directed (positional argument) ───────────────────────────────
+    opt
+        .command('goal <description>')
+        .description('Goal-directed optimization (e.g., "reduce API latency")')
+        .option('--stack <stack>', 'Override detected stack (node, go, python)')
+        .option('--scope <path>', 'Limit analysis to specific directory')
+        .option('--dry-run', 'Show what would be analyzed without running')
+        .option('--json', 'Output as JSON')
+        .action((description, opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const stack = (opts.stack ?? config.stack);
+        const analyzer = new PerfAnalyzer(swarmDir, stack);
+        if (opts.dryRun) {
+            console.log(chalk.dim(`\n  Would optimize for goal: "${description}"`));
+            console.log(chalk.dim(`  Stack: ${stack ?? 'auto-detect'}`));
+            console.log(chalk.dim(`  Scope: ${opts.scope ?? 'entire project'}\n`));
+            return;
+        }
+        console.log(chalk.bold(`\n  Optimizing for: "${description}"...\n`));
+        const report = analyzer.optimizeForGoal(description, opts.scope);
+        if (opts.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            printReport(report);
+        }
+    });
+    // ── history ───────────────────────────────────────────────────────────
+    opt
+        .command('history')
+        .description('Show optimization report history')
+        .option('--json', 'Output as JSON')
+        .option('--limit <n>', 'Number of reports to show', '10')
+        .action((opts) => {
+        let swarmDir;
+        try {
+            swarmDir = requireSwarmDir();
+        }
+        catch {
+            console.error(chalk.red('No .swarm/ directory found. Run `hivemind init` first.'));
+            process.exit(1);
+        }
+        const config = loadConfig();
+        const analyzer = new PerfAnalyzer(swarmDir, config.stack);
+        const reports = analyzer.getReports();
+        const limit = parseInt(opts.limit) || 10;
+        const recent = reports.slice(-limit);
+        if (opts.json) {
+            console.log(JSON.stringify(recent, null, 2));
+            return;
+        }
+        if (recent.length === 0) {
+            console.log(chalk.dim('\n  No optimization reports yet.\n'));
+            return;
+        }
+        console.log(chalk.bold(`\n  Optimization History (${recent.length} of ${reports.length} reports)\n`));
+        console.log(chalk.dim('  Type        Date                     Hot Paths  Queries  Leaks  Recs'));
+        console.log(chalk.dim('  ─────────────────────────────────────────────────────────────────────'));
+        for (const r of recent) {
+            const type = r.type.padEnd(10);
+            const date = new Date(r.timestamp).toLocaleString().padEnd(24);
+            const hp = String(r.hotPaths.length).padStart(9);
+            const qi = String(r.queryIssues.length).padStart(8);
+            const ml = String(r.memoryLeaks?.length ?? 0).padStart(6);
+            const recs = String(r.recommendations.length).padStart(5);
+            console.log(`  ${type} ${chalk.dim(date)} ${hp} ${qi} ${ml} ${recs}`);
+        }
+        console.log('');
+    });
+}
+//# sourceMappingURL=optimize.js.map