@phantom-pm/cli 1.0.0 → 1.1.0-beta.1

package/dist/index.js

@@ -1,10 +1,21 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { jsx as _jsx } from "react/jsx-runtime";
+// ╔══════════════════════════════════════════════════════════════════╗
+// ║  PHANTOM CLI — "Follow the white rabbit."                        ║
+// ║                                                                  ║
+// ║  The command-line gateway to the Phantom PM Operating System.    ║
+// ║  Every `phantom` command starts here — chat, swarm, prd,        ║
+// ║  simulate, agents, mcp, and 17 module superpowers.               ║
+// ╚══════════════════════════════════════════════════════════════════╝
+import { existsSync, readdirSync, statSync } from 'fs';
 import { basename, join, resolve } from 'path';
 import { Command } from 'commander';
 import { PHANTOM_ASCII, PHANTOM_VERSION, TAGLINE, FRAMEWORKS, getConfig, getContextEngine, getModuleManager, getSwarm, KNOWN_INTEGRATION_TARGETS, isKnownIntegrationTarget, scanIntegrations as scanIntegrationTargets, connectIntegration as connectIntegrationTarget, doctorIntegrations, analyzeScreenPath, auditScreensPath, generateRealDocumentation, getRealProducts, getRuntimeHealth, runDeterministicSimulation, } from '@phantom-pm/core';
+import { registerWithAllDetected, registerWithSpecificAgent, listRegistrationTargets, } from '@phantom-pm/core';
 import { registerConfigCommands } from './commands/config.js';
 import { registerStoriesCommands } from './commands/stories.js';
+import { startChat } from './commands/chat.js';
+import { TaskAnalyze } from './commands/task.js';
 import { PhantomMCPServer, runStdioServer, PhantomDiscovery } from '@phantom-pm/mcp-server';
 import { theme, box, runBootSequence, showFirstRunSetup, renderModuleInstall, renderModuleStore, renderSwarmResult, renderHealthDashboard, } from '@phantom-pm/tui';
 const program = new Command();
@@ -27,6 +38,31 @@ function failNotImplemented(command) {
     console.error('');
     process.exitCode = 1;
 }
+function asObject(value) {
+    if (!value || typeof value !== 'object')
+        return {};
+    return value;
+}
+async function runModuleCommand(moduleName, moduleLabel, commandName, args) {
+    const moduleManager = getModuleManager();
+    if (!moduleManager.isInstalled(moduleName)) {
+        console.log('');
+        console.log(theme.warning(`  ${moduleLabel} module not installed. Installing...`));
+        await moduleManager.install(moduleName);
+    }
+    const result = await moduleManager.executeCommand(moduleName, commandName, args);
+    return asObject(result);
+}
+function parseJsonOption(raw, optionName) {
+    if (!raw)
+        return undefined;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON for ${optionName}`);
+    }
+}
 program
     .name('phantom')
     .description(TAGLINE)
@@ -288,14 +324,80 @@ mcpCommand
 mcpCommand
     .command('serve')
     .description('Run MCP server over stdio')
-    .option('--mode <mode>', 'transport mode', 'stdio')
+    .option('--mode <mode>', 'Transport mode (stdio, legacy-jsonl)', 'stdio')
+    .option('--tools <mode>', 'Tool loading mode (core, standard, all)', 'standard')
+    .action(async (options) => {
+    const transportMode = options.mode === 'legacy-jsonl' ? 'legacy-jsonl' : 'stdio';
+    if (options.mode !== 'stdio' && options.mode !== 'legacy-jsonl') {
+        console.log('');
+        console.log(theme.warning(`  Unsupported transport mode '${options.mode}', using stdio.`));
+        console.log('');
+    }
+    // Validate tool mode
+    const validToolModes = ['core', 'standard', 'all'];
+    const toolMode = validToolModes.includes(options.tools) ? options.tools : 'standard';
+    if (!validToolModes.includes(options.tools)) {
+        console.log(theme.warning(`  Unsupported tool mode '${options.tools}', using standard.`));
+    }
+    await runStdioServer(transportMode, toolMode);
+});
+mcpCommand
+    .command('status')
+    .description('Check MCP integration status')
+    .option('--json', 'Output as JSON')
     .action(async (options) => {
-    if (options.mode !== 'stdio') {
+    const { PhantomDiscovery } = await import('@phantom-pm/mcp-server');
+    const report = await PhantomDiscovery.healthReport();
+    if (options.json) {
+        printJson(report);
+        return;
+    }
+    console.log('');
+    console.log(theme.title('  MCP INTEGRATION STATUS'));
+    console.log('');
+    // Check MCP server
+    const mcpRunning = report.mcp_server.status === 'running';
+    console.log(`  ${theme.secondary('MCP Server:')} ${mcpRunning ? theme.success('Running') : theme.error('Not responding')}`);
+    // Check agent registrations
+    const agents = report.agents;
+    const installedAgents = agents.filter(agent => agent.installed);
+    if (installedAgents.length === 0) {
         console.log('');
-        console.log(theme.warning(`  Unsupported mode '${options.mode}', using stdio.`));
+        console.log(theme.warning('  No AI agents detected on this system.'));
+        console.log(theme.dim('  Install Cursor, Codex, or other MCP-compatible editors to enable integration.'));
         console.log('');
+        return;
     }
-    await runStdioServer();
+    console.log('');
+    console.log(theme.secondary(`  Detected Agents (${installedAgents.length}):`));
+    for (const agent of installedAgents) {
+        const status = agent.registered ? theme.success('Registered') : theme.warning('Not registered');
+        console.log(`    ${agent.name}: ${status}`);
+    }
+    console.log('');
+    if (mcpRunning && installedAgents.some(agent => agent.registered)) {
+        console.log(theme.success('  ✅ MCP integration is ready!'));
+        console.log(theme.dim('  Restart your AI agents to enable PHANTOM integration.'));
+    }
+    else {
+        console.log(theme.warning('  ⚠️  MCP integration needs attention.'));
+        console.log(theme.dim('  Run "phantom mcp register" to register with agents.'));
+    }
+    console.log('');
+});
+mcpCommand
+    .command('register')
+    .description('Manually register with detected AI agents')
+    .action(async () => {
+    const { PhantomDiscovery } = await import('@phantom-pm/mcp-server');
+    console.log('');
+    console.log(theme.title('  MCP REGISTRATION'));
+    console.log('');
+    await PhantomDiscovery.autoRegisterAll();
+    console.log('');
+    console.log(theme.success('  Registration process completed!'));
+    console.log(theme.dim('  Restart your AI agents to enable PHANTOM integration.'));
+    console.log('');
 });
 program
     .command('status')
@@ -392,6 +494,92 @@ program
     }
     console.log('');
 });
+program
+    .command('register')
+    .description('Register Phantom MCP server with detected AI agents')
+    .option('--target <agent>', 'Register with a specific agent (e.g. cursor, claude-code)')
+    .option('--all', 'Register with ALL detected agents')
+    .option('--list', 'List all registration targets and their status')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const cwd = process.cwd();
+        if (options.list) {
+            const targets = listRegistrationTargets(cwd);
+            if (options.json) {
+                printJson({ targets });
+                return;
+            }
+            console.log('');
+            console.log(theme.title('  MCP REGISTRATION TARGETS'));
+            console.log('');
+            for (const t of targets) {
+                const statusIcon = t.registered ? theme.success('✓ Registered') :
+                    t.exists ? theme.warning('○ Not registered') :
+                        theme.dim('— Config not found');
+                console.log(`  ${theme.accent(t.agentName.padEnd(30))} ${statusIcon}`);
+                console.log(`  ${theme.dim(t.configPath)}`);
+                console.log('');
+            }
+            return;
+        }
+        if (options.target) {
+            const result = registerWithSpecificAgent(cwd, options.target);
+            if (options.json) {
+                printJson(result);
+                return;
+            }
+            console.log('');
+            if (result.success) {
+                console.log(theme.success(`  ✓ Phantom MCP registered with ${result.agentName}`));
+                console.log(`  ${theme.secondary('Config:')} ${result.configPath}`);
+                console.log(`  ${theme.secondary('Action:')} ${result.action}`);
+            }
+            else {
+                console.log(theme.error(`  ✗ Failed: ${result.message}`));
+            }
+            console.log('');
+            return;
+        }
+        // Default: register with all detected agents
+        const summary = await registerWithAllDetected(cwd);
+        if (options.json) {
+            printJson(summary);
+            return;
+        }
+        console.log('');
+        console.log(theme.title('  PHANTOM MCP AUTO-REGISTRATION'));
+        console.log('');
+        for (const result of summary.results) {
+            const icon = result.success
+                ? (result.action === 'skipped' ? '○' : '✓')
+                : '✗';
+            const color = result.success
+                ? (result.action === 'skipped' ? theme.dim : theme.success)
+                : theme.error;
+            console.log(`  ${color(`${icon} ${result.agentName}`)} — ${result.message}`);
+        }
+        console.log('');
+        console.log(theme.secondary(`  Total: ${summary.totalTargets} | Registered: ${summary.successful} | Skipped: ${summary.skipped} | Errors: ${summary.errors}`));
+        if (summary.successful > 0) {
+            console.log('');
+            console.log(theme.success('  Restart your AI agents to activate Phantom integration.'));
+        }
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Registration failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
 const prdCommand = program.command('prd').description('PRD operations');
 // Register config commands
 registerConfigCommands(program);
@@ -419,9 +607,9 @@ prdCommand
             technical: options.technical,
             ux: options.ux,
             metrics: options.metrics,
-            output: options.out || './phantom-output/prds',
+            output: options.out || './.phantom/output/prds',
         });
-        const outputPath = result.prd.filePath || './phantom-output/prds';
+        const outputPath = result.prd.filePath || './.phantom/output/prds';
         const payload = {
             status: 'ok',
             module: 'prd-forge',
@@ -456,10 +644,10 @@ prdCommand
 });
 prdCommand
     .command('list')
-    .description('List generated PRDs from phantom-output directory')
+    .description('List generated PRDs from .phantom/output/prds directory')
     .option('--json', 'Output as JSON')
     .action((options) => {
-    const outDir = join(process.cwd(), 'phantom-output');
+    const outDir = join(process.cwd(), '.phantom', 'output', 'prds');
     const items = existsSync(outDir)
         ? readdirSync(outDir)
             .filter(file => file.endsWith('.md'))
@@ -481,7 +669,7 @@ prdCommand
     console.log(theme.title('  PRD LIBRARY'));
     console.log('');
     if (items.length === 0) {
-        console.log(theme.warning('  No PRDs found in phantom-output/.'));
+        console.log(theme.warning('  No PRDs found in .phantom/output/prds/.'));
     }
     else {
         for (const item of items) {
@@ -515,9 +703,18 @@ program
             console.log(theme.error(`  ${message}`));
             console.log('');
         }
-        process.exitCode = 1;
     }
 });
+program
+    .command('task')
+    .description('Deep task analysis and decomposition')
+    .command('analyze <goal>')
+    .description('Recursively decompose a goal into subtasks')
+    .action(async (goal) => {
+    // We need to render the React component
+    const { render } = await import('ink');
+    render(_jsx(TaskAnalyze, { goal: goal }));
+});
 const screenCommand = program.command('screen').description('Screen analysis commands');
 screenCommand
     .command('analyze <path>')
@@ -627,7 +824,7 @@ program
     .option('--refresh', 'Generate new nudges based on current context')
     .action(async (options) => {
     try {
-        const { NudgeEngine, getConfig, getContextEngine, getModuleManager } = await import('@phantom/core');
+        const { NudgeEngine, getConfig, getContextEngine, getModuleManager } = await import('@phantom-pm/core');
         const engine = new NudgeEngine();
         // Handle dismiss/snooze actions
         if (options.dismiss) {
@@ -1178,27 +1375,32 @@ analyticsCommand
     console.log(`  ${theme.accent('phantom analytics dashboard --categories "user-engagement,revenue"')}`);
     console.log('');
 });
-docsCommand
-    .command('generate')
-    .description('Generate deterministic documentation artifacts')
-    .option('--out <path>', 'Output directory path')
+const oracleCommand = program.command('oracle').description('Predictive product intelligence');
+oracleCommand
+    .command('predict <feature>')
+    .description('Predict feature success')
+    .option('--description <text>', 'Feature description')
     .option('--json', 'Output as JSON')
-    .action((options) => {
+    .action(async (feature, options) => {
     try {
-        const files = generateRealDocumentation(process.cwd(), options.out);
+        const result = await runModuleCommand('oracle', 'Oracle', 'oracle predict', {
+            feature,
+            description: options.description,
+            _: ['predict', feature],
+        });
         if (options.json) {
-            printJson({ files });
+            printJson(result);
             return;
         }
         console.log('');
-        console.log(theme.success('  Documentation generated:'));
-        for (const file of files) {
-            console.log(`  ${theme.check} ${file}`);
-        }
+        console.log(theme.success('  Oracle prediction complete.'));
+        console.log(`  ${theme.secondary('Feature:')} ${feature}`);
+        console.log(`  ${theme.secondary('Probability:')} ${result.prediction?.successProbability ?? 'n/a'}%`);
+        console.log(`  ${theme.secondary('Generated:')} ${result.prediction?.generatedAt ?? 'n/a'}`);
         console.log('');
     }
     catch (err) {
-        const message = err instanceof Error ? err.message : 'Documentation generation failed';
+        const message = err instanceof Error ? err.message : 'Oracle prediction failed';
         if (options.json) {
             printJson({ status: 'error', error: message });
         }
@@ -1210,219 +1412,140 @@ docsCommand
         process.exitCode = 1;
     }
 });
-program
-    .command('frameworks [action] [framework]')
-    .description('List built-in PM frameworks')
+oracleCommand
+    .command('simulate [scenario]')
+    .description('Run Monte Carlo simulation')
+    .option('--iterations <count>', 'Iteration count', '10000')
     .option('--json', 'Output as JSON')
-    .action((action, framework, options) => {
-    if (!action || action === 'list') {
+    .action(async (scenario, options) => {
+    try {
+        const result = await runModuleCommand('oracle', 'Oracle', 'oracle simulate', {
+            scenario: scenario || 'default',
+            iterations: Number.parseInt(options.iterations || '10000', 10),
+            _: ['simulate', scenario || 'default'],
+        });
         if (options.json) {
-            printJson({ frameworks: FRAMEWORKS });
+            printJson(result);
             return;
         }
         console.log('');
-        console.log(theme.title('  PM FRAMEWORKS'));
-        console.log('');
-        for (const fw of FRAMEWORKS) {
-            console.log(`  ${theme.check} ${fw.name} ${theme.dim(`— ${fw.desc}`)}`);
-        }
+        console.log(theme.success('  Simulation complete.'));
+        console.log(`  ${theme.secondary('Scenario:')} ${result.simulation?.scenario ?? scenario ?? 'default'}`);
+        console.log(`  ${theme.secondary('Confidence:')} ${result.simulation?.confidence ?? 'n/a'}%`);
         console.log('');
-        return;
     }
-    if (action === 'apply') {
-        const payload = {
-            status: 'not_implemented',
-            message: 'Framework auto-apply is not implemented in real runtime mode.',
-            framework: framework || null,
-        };
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Oracle simulation failed';
         if (options.json) {
-            printJson(payload);
+            printJson({ status: 'error', error: message });
         }
         else {
             console.log('');
-            console.log(theme.warning(`  ${payload.message}`));
+            console.log(theme.error(`  ${message}`));
             console.log('');
         }
         process.exitCode = 1;
-        return;
-    }
-    process.exitCode = 1;
-});
-program
-    .command('dashboard')
-    .alias('dash')
-    .description('Show concise runtime summary')
-    .option('--json', 'Output as JSON')
-    .action((options) => {
-    const cfg = getConfig().get();
-    const stats = getContextEngine().getStats();
-    const health = getRuntimeHealth(process.cwd());
-    const payload = {
-        activeProject: cfg.activeProject || null,
-        contextFiles: stats.totalFiles,
-        contextHealth: stats.healthScore,
-        installedModules: cfg.installedModules.length,
-        connectedIntegrations: health.integrations.filter(i => i.connected).length,
-        primaryModel: health.primaryModel,
-    };
-    if (options.json) {
-        printJson(payload);
-        return;
     }
-    console.log('');
-    console.log(box([
-        '',
-        `  Active Project: ${payload.activeProject || 'none'}`,
-        `  Context Files: ${payload.contextFiles} (health ${payload.contextHealth}%)`,
-        `  Installed Modules: ${payload.installedModules}`,
-        `  Connected Integrations: ${payload.connectedIntegrations}`,
-        `  Primary Model: ${payload.primaryModel.provider}/${payload.primaryModel.model} (${payload.primaryModel.status})`,
-        '',
-    ].join('\n'), 'PHANTOM DASHBOARD', 78));
-    console.log('');
 });
-// Agent Matrix Commands
-const agentsCommand = program.command('agents').description('Agent Matrix - Connect and coordinate all AI agents');
-agentsCommand
-    .command('register')
-    .description('Register PHANTOM with all detected AI agents')
+oracleCommand
+    .command('forecast')
+    .description('Generate metric forecast')
+    .option('--metric <name>', 'Metric name', 'revenue')
+    .option('--period <months>', 'Period in months', '6')
+    .option('--data <json>', 'Historical data JSON array')
     .option('--json', 'Output as JSON')
     .action(async (options) => {
     try {
+        if (options.data) {
+            parseJsonOption(options.data, '--data');
+        }
+        const result = await runModuleCommand('oracle', 'Oracle', 'oracle forecast', {
+            metric: options.metric || 'revenue',
+            period: Number.parseInt(options.period || '6', 10),
+            data: options.data,
+            _: ['forecast'],
+        });
         if (options.json) {
-            // JSON output for programmatic use
-            const agents = PhantomDiscovery.detectInstalledAgents();
-            const installed = agents.filter((a) => a.installed);
-            const results = [];
-            for (const agent of installed) {
-                const success = await PhantomDiscovery.registerWithAgent(agent.type);
-                results.push({
-                    agent: agent.name,
-                    type: agent.type,
-                    success,
-                    status: success ? 'registered' : 'failed'
-                });
-            }
-            printJson({
-                timestamp: new Date().toISOString(),
-                total_agents: installed.length,
-                successful_registrations: results.filter(r => r.success).length,
-                results
-            });
+            printJson(result);
             return;
         }
-        // Interactive output
-        await PhantomDiscovery.autoRegisterAll();
+        console.log('');
+        console.log(theme.success('  Forecast generated.'));
+        console.log(`  ${theme.secondary('Metric:')} ${result.forecast?.metric ?? options.metric}`);
+        console.log(`  ${theme.secondary('Confidence:')} ${result.forecast?.confidence ?? 'n/a'}%`);
+        console.log('');
     }
-    catch (error) {
-        console.error(theme.error('  Failed to register agents:'), error);
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Oracle forecast failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
         process.exitCode = 1;
     }
 });
-agentsCommand
-    .command('health')
-    .description('Check PHANTOM and agent connection health')
+oracleCommand
+    .command('risk [project]')
+    .description('Assess project risk')
     .option('--json', 'Output as JSON')
-    .action(async (options) => {
+    .action(async (project, options) => {
     try {
+        const result = await runModuleCommand('oracle', 'Oracle', 'oracle risk', {
+            project: project || '',
+            _: ['risk', project || ''],
+        });
         if (options.json) {
-            // Implement JSON health check
-            const mcpRunning = await PhantomDiscovery.detectPhantom();
-            const agents = PhantomDiscovery.detectInstalledAgents();
-            const healthData = {
-                timestamp: new Date().toISOString(),
-                mcp_server: {
-                    status: mcpRunning ? 'running' : 'not_responding',
-                    version: '1.0.0'
-                },
-                agents: agents.map((agent) => {
-                    const configPath = PhantomDiscovery.AGENT_CONFIG_PATHS[agent.type];
-                    let registered = false;
-                    if (configPath && existsSync(configPath)) {
-                        try {
-                            const config = JSON.parse(readFileSync(configPath, 'utf8'));
-                            registered = config.mcpServers?.phantom !== undefined;
-                        }
-                        catch {
-                            registered = false;
-                        }
-                    }
-                    return {
-                        name: agent.name,
-                        type: agent.type,
-                        installed: agent.installed,
-                        registered,
-                        status: agent.installed ? (registered ? 'connected' : 'detected_not_registered') : 'not_installed'
-                    };
-                })
-            };
-            printJson(healthData);
+            printJson(result);
             return;
         }
-        // Interactive health check
-        await PhantomDiscovery.healthCheck();
+        console.log('');
+        console.log(theme.success('  Risk assessment generated.'));
+        console.log(`  ${theme.secondary('Overall Risk:')} ${result.risk?.overallRisk ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Score:')} ${result.risk?.score ?? 'n/a'}`);
+        console.log('');
     }
-    catch (error) {
-        console.error(theme.error('  Health check failed:'), error);
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Oracle risk assessment failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
         process.exitCode = 1;
     }
 });
-agentsCommand
-    .command('scan')
-    .description('Scan system for installed AI agents and LLMs')
-    .option('--register', 'Automatically register detected agents')
+const experimentCommand = program.command('experiment').description('A/B test and experimentation workflow');
+experimentCommand
+    .command('design <hypothesis>')
+    .description('Design an experiment')
+    .option('--metric <name>', 'Primary metric', 'conversion_rate')
     .option('--json', 'Output as JSON')
-    .action(async (options) => {
+    .action(async (hypothesis, options) => {
     try {
-        const { AgentDiscovery, AgentRegistry } = await import('@phantom/core');
-        const discovery = new AgentDiscovery();
-        const agents = await discovery.scanSystem();
-        if (options.register) {
-            const registry = new AgentRegistry();
-            const registered = await registry.scanAndRegister();
-            if (options.json) {
-                printJson({ detected: agents, registered: registered.map(r => r.id) });
-                return;
-            }
-            console.log('');
-            console.log(theme.success(`  Registered ${registered.length} new agents:`));
-            for (const agent of registered) {
-                console.log(`    • ${agent.signature.name}`);
-            }
-            console.log('');
-        }
-        if (options.json && !options.register) {
-            printJson({ agents });
+        const result = await runModuleCommand('experiment-lab', 'Experiment Lab', 'experiment design', {
+            hypothesis,
+            metric: options.metric || 'conversion_rate',
+            _: ['design', hypothesis],
+        });
+        if (options.json) {
+            printJson(result);
             return;
         }
-        if (!options.register) {
-            console.log('');
-            console.log(theme.title('  DETECTED AGENTS'));
-            console.log('');
-            if (agents.length === 0) {
-                console.log(theme.warning('  No AI agents detected in your system.'));
-                console.log(theme.dim('  Supported: Claude Code, Cursor, Codex, Gemini, ChatGPT, VS Code, Zed'));
-                console.log('');
-                return;
-            }
-            for (const agent of agents) {
-                const statusIcon = agent.status === 'running' ? '🟢' : '🔵';
-                const confidenceColor = agent.confidence > 80 ? theme.success :
-                    agent.confidence > 60 ? theme.warning : theme.dim;
-                console.log(`  ${statusIcon} ${theme.accent(agent.signature.name)}`);
-                console.log(`     ${theme.secondary(agent.signature.description)}`);
-                console.log(`     ${confidenceColor(`Confidence: ${agent.confidence}%`)} | Status: ${agent.status}`);
-                if (agent.detectedPaths.length > 0) {
-                    console.log(`     ${theme.dim(`Paths: ${agent.detectedPaths.join(', ')}`)}`);
-                }
-                console.log('');
-            }
-            console.log(theme.dim('  Run with --register to automatically register detected agents'));
-            console.log('');
-        }
+        console.log('');
+        console.log(theme.success('  Experiment design created.'));
+        console.log(`  ${theme.secondary('Experiment:')} ${result.experiment?.name ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Sample Size:')} ${result.experiment?.sampleSize ?? 'n/a'}`);
+        console.log('');
     }
     catch (err) {
-        const message = err instanceof Error ? err.message : 'Agent scan failed';
+        const message = err instanceof Error ? err.message : 'Experiment design failed';
         if (options.json) {
             printJson({ status: 'error', error: message });
         }
@@ -1434,25 +1557,811 @@ agentsCommand
         process.exitCode = 1;
     }
 });
-agentsCommand
-    .command('list')
-    .description('List registered agents and their integration status')
+experimentCommand
+    .command('analyze <experimentId>')
+    .description('Analyze experiment results')
+    .option('--data <json>', 'Variant data JSON object')
     .option('--json', 'Output as JSON')
-    .action(async (options) => {
+    .action(async (experimentId, options) => {
     try {
-        const { AgentRegistry } = await import('@phantom/core');
-        const registry = new AgentRegistry();
-        const agents = registry.getAllAgents();
+        if (options.data) {
+            parseJsonOption(options.data, '--data');
+        }
+        const result = await runModuleCommand('experiment-lab', 'Experiment Lab', 'experiment analyze', {
+            experimentId,
+            data: options.data,
+            _: ['analyze', experimentId],
+        });
         if (options.json) {
-            printJson({ agents });
+            printJson(result);
             return;
         }
         console.log('');
-        console.log(theme.title('  REGISTERED AGENTS'));
+        console.log(theme.success('  Experiment analysis complete.'));
+        console.log(`  ${theme.secondary('Winner:')} ${result.analysis?.winner ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Significant:')} ${result.analysis?.statisticalSignificance ?? 'n/a'}`);
         console.log('');
-        if (agents.length === 0) {
-            console.log(theme.warning('  No agents registered yet.'));
-            console.log(theme.dim('  Run: phantom agents scan'));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Experiment analysis failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+experimentCommand
+    .command('sample-size')
+    .description('Calculate required sample size')
+    .option('--baseline <rate>', 'Baseline conversion rate', '0.2')
+    .option('--mde <rate>', 'Minimum detectable effect', '0.05')
+    .option('--confidence <rate>', 'Confidence level', '0.95')
+    .option('--power <rate>', 'Statistical power', '0.8')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const result = await runModuleCommand('experiment-lab', 'Experiment Lab', 'experiment sample-size', {
+            baseline: Number.parseFloat(options.baseline || '0.2'),
+            mde: Number.parseFloat(options.mde || '0.05'),
+            confidence: Number.parseFloat(options.confidence || '0.95'),
+            power: Number.parseFloat(options.power || '0.8'),
+            _: ['sample-size'],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Sample size calculation complete.'));
+        console.log(`  ${theme.secondary('Sample Size:')} ${result.calculation?.sampleSize ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Duration (days):')} ${result.calculation?.duration ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Sample size calculation failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+experimentCommand
+    .command('rollout <experimentId>')
+    .description('Create rollout strategy')
+    .option('--phases <count>', 'Rollout phases', '3')
+    .option('--json', 'Output as JSON')
+    .action(async (experimentId, options) => {
+    try {
+        const result = await runModuleCommand('experiment-lab', 'Experiment Lab', 'experiment rollout', {
+            experimentId,
+            phases: Number.parseInt(options.phases || '3', 10),
+            _: ['rollout', experimentId],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Rollout strategy created.'));
+        console.log(`  ${theme.secondary('Phases:')} ${result.strategy?.phases?.length ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Risk Level:')} ${result.strategy?.riskLevel ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Rollout strategy failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+const uxCommand = program.command('ux').description('UX auditing and WCAG checks');
+uxCommand
+    .command('audit <imagePath>')
+    .description('Audit a UI screenshot')
+    .option('--page-type <type>', 'Page type', 'generic')
+    .option('--no-wcag', 'Skip WCAG checks')
+    .option('--json', 'Output as JSON')
+    .action(async (imagePath, options) => {
+    try {
+        const result = await runModuleCommand('ux-auditor', 'UX Auditor', 'ux audit', {
+            imagePath,
+            pageType: options.pageType || 'generic',
+            wcag: options.wcag !== false,
+            _: ['audit', imagePath],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  UX audit complete.'));
+        console.log(`  ${theme.secondary('Score:')} ${result.audit?.overallScore ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Issues:')} ${result.audit?.issues?.length ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'UX audit failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+uxCommand
+    .command('score <imagePath>')
+    .description('Get quick UX score')
+    .option('--json', 'Output as JSON')
+    .action(async (imagePath, options) => {
+    try {
+        const result = await runModuleCommand('ux-auditor', 'UX Auditor', 'ux score', {
+            imagePath,
+            _: ['score', imagePath],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  UX score generated.'));
+        console.log(`  ${theme.secondary('Overall:')} ${result.scores?.overall ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'UX score failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+uxCommand
+    .command('compare <before> <after>')
+    .description('Compare UX between two screenshots')
+    .option('--json', 'Output as JSON')
+    .action(async (before, after, options) => {
+    try {
+        const result = await runModuleCommand('ux-auditor', 'UX Auditor', 'ux compare', {
+            before,
+            after,
+            _: ['compare', before, after],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  UX comparison complete.'));
+        console.log(`  ${theme.secondary('Delta:')} ${result.comparison?.scoreDifference ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'UX comparison failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+uxCommand
+    .command('wcag <imagePath>')
+    .description('Generate WCAG compliance report')
+    .option('--level <level>', 'WCAG level (A|AA|AAA)', 'AA')
+    .option('--json', 'Output as JSON')
+    .action(async (imagePath, options) => {
+    try {
+        const result = await runModuleCommand('ux-auditor', 'UX Auditor', 'ux wcag', {
+            imagePath,
+            level: options.level || 'AA',
+            _: ['wcag', imagePath],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  WCAG report generated.'));
+        console.log(`  ${theme.secondary('Level:')} ${result.wcag?.level ?? options.level}`);
+        console.log(`  ${theme.secondary('Score:')} ${result.wcag?.score ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'WCAG report failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+const timeMachineCommand = program.command('timemachine').description('Decision snapshots and what-if analysis');
+timeMachineCommand
+    .command('snapshot')
+    .description('Create a product snapshot')
+    .option('--name <name>', 'Snapshot name')
+    .option('--description <text>', 'Snapshot description')
+    .option('--tags <csv>', 'Comma-separated tags')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const result = await runModuleCommand('time-machine', 'Time Machine', 'timemachine snapshot', {
+            name: options.name,
+            description: options.description,
+            tags: options.tags,
+            _: ['snapshot'],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Snapshot created.'));
+        console.log(`  ${theme.secondary('Snapshot ID:')} ${result.snapshot?.id ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Name:')} ${result.snapshot?.name ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Snapshot creation failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+timeMachineCommand
+    .command('compare <id1> <id2>')
+    .description('Compare two snapshots')
+    .option('--json', 'Output as JSON')
+    .action(async (id1, id2, options) => {
+    try {
+        const result = await runModuleCommand('time-machine', 'Time Machine', 'timemachine compare', {
+            id1,
+            id2,
+            _: ['compare', id1, id2],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Snapshot comparison complete.'));
+        console.log(`  ${theme.secondary('Added Decisions:')} ${result.comparison?.addedDecisions?.length ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Changed Decisions:')} ${result.comparison?.changedDecisions?.length ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Snapshot comparison failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+timeMachineCommand
+    .command('list')
+    .description('List saved snapshots')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const result = await runModuleCommand('time-machine', 'Time Machine', 'timemachine list', {
+            _: ['list'],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Snapshots loaded.'));
+        console.log(`  ${theme.secondary('Count:')} ${result.count ?? 0}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Snapshot list failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+timeMachineCommand
+    .command('whatif <baseId>')
+    .description('Create a what-if scenario')
+    .option('--name <name>', 'Scenario name')
+    .option('--decision <json>', 'Decision JSON payload')
+    .option('--json', 'Output as JSON')
+    .action(async (baseId, options) => {
+    try {
+        const decision = parseJsonOption(options.decision, '--decision');
+        const result = await runModuleCommand('time-machine', 'Time Machine', 'timemachine whatif', {
+            baseId,
+            name: options.name,
+            decision,
+            _: ['whatif', baseId],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  What-if scenario created.'));
+        console.log(`  ${theme.secondary('Scenario ID:')} ${result.scenario?.id ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Risk:')} ${result.scenario?.riskAssessment?.overallRisk ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'What-if scenario failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+const figmaCommand = program.command('figma').description('Figma integration and design analysis');
+figmaCommand
+    .command('sync <fileKey>')
+    .description('Sync a Figma file')
+    .option('--json', 'Output as JSON')
+    .action(async (fileKey, options) => {
+    try {
+        const result = await runModuleCommand('figma-bridge', 'Figma Bridge', 'figma sync', {
+            fileKey,
+            _: ['sync', fileKey],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Figma sync complete.'));
+        console.log(`  ${theme.secondary('Pages Synced:')} ${result.sync?.pagesSynced ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Figma sync failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+figmaCommand
+    .command('analyze <fileKey>')
+    .description('Analyze a Figma design')
+    .option('--json', 'Output as JSON')
+    .action(async (fileKey, options) => {
+    try {
+        const result = await runModuleCommand('figma-bridge', 'Figma Bridge', 'figma analyze', {
+            fileKey,
+            _: ['analyze', fileKey],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Figma design analysis complete.'));
+        console.log(`  ${theme.secondary('Screens:')} ${result.analysis?.screens?.length ?? 'n/a'}`);
+        console.log(`  ${theme.secondary('Components:')} ${result.analysis?.components?.length ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Figma analysis failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+figmaCommand
+    .command('stories <fileKey>')
+    .description('Generate stories from Figma design')
+    .option('--json', 'Output as JSON')
+    .action(async (fileKey, options) => {
+    try {
+        const result = await runModuleCommand('figma-bridge', 'Figma Bridge', 'figma stories', {
+            fileKey,
+            _: ['stories', fileKey],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Stories generated from Figma.'));
+        console.log(`  ${theme.secondary('Count:')} ${result.count ?? 0}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Figma story generation failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+figmaCommand
+    .command('prd <fileKey>')
+    .description('Generate PRD from Figma design')
+    .option('--title <name>', 'PRD title')
+    .option('--json', 'Output as JSON')
+    .action(async (fileKey, options) => {
+    try {
+        const result = await runModuleCommand('figma-bridge', 'Figma Bridge', 'figma prd', {
+            fileKey,
+            title: options.title,
+            _: ['prd', fileKey],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  PRD generated from Figma.'));
+        console.log(`  ${theme.secondary('PRD ID:')} ${result.prd?.id ?? 'n/a'}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Figma PRD generation failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+figmaCommand
+    .command('list')
+    .description('List cached Figma files')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const result = await runModuleCommand('figma-bridge', 'Figma Bridge', 'figma list', {
+            _: ['list'],
+        });
+        if (options.json) {
+            printJson(result);
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Cached Figma files loaded.'));
+        console.log(`  ${theme.secondary('Count:')} ${result.count ?? 0}`);
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Figma file list failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+docsCommand
+    .command('generate')
+    .description('Generate deterministic documentation artifacts')
+    .option('--out <path>', 'Output directory path')
+    .option('--json', 'Output as JSON')
+    .action((options) => {
+    try {
+        const files = generateRealDocumentation(process.cwd(), options.out);
+        if (options.json) {
+            printJson({ files });
+            return;
+        }
+        console.log('');
+        console.log(theme.success('  Documentation generated:'));
+        for (const file of files) {
+            console.log(`  ${theme.check} ${file}`);
+        }
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Documentation generation failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+program
+    .command('frameworks [action] [framework]')
+    .description('List built-in PM frameworks')
+    .option('--json', 'Output as JSON')
+    .action((action, framework, options) => {
+    if (!action || action === 'list') {
+        if (options.json) {
+            printJson({ frameworks: FRAMEWORKS });
+            return;
+        }
+        console.log('');
+        console.log(theme.title('  PM FRAMEWORKS'));
+        console.log('');
+        for (const fw of FRAMEWORKS) {
+            console.log(`  ${theme.check} ${fw.name} ${theme.dim(`— ${fw.desc}`)}`);
+        }
+        console.log('');
+        return;
+    }
+    if (action === 'apply') {
+        const payload = {
+            status: 'not_implemented',
+            message: 'Framework auto-apply is not implemented in real runtime mode.',
+            framework: framework || null,
+        };
+        if (options.json) {
+            printJson(payload);
+        }
+        else {
+            console.log('');
+            console.log(theme.warning(`  ${payload.message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+        return;
+    }
+});
+// Agent Matrix Commands
+const agentsCommand = program.command('agents').description('Agent Matrix - Connect and coordinate all AI agents');
+agentsCommand
+    .command('register')
+    .description('Register PHANTOM with all detected AI agents')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        if (options.json) {
+            // JSON output for programmatic use
+            const agents = await PhantomDiscovery.detectInstalledAgents();
+            const installed = agents.filter((a) => a.installed);
+            const results = [];
+            for (const agent of installed) {
+                const success = await PhantomDiscovery.registerWithAgent(agent.type);
+                results.push({
+                    agent: agent.name,
+                    type: agent.type,
+                    success,
+                    status: success ? 'registered' : 'failed'
+                });
+            }
+            printJson({
+                timestamp: new Date().toISOString(),
+                total_agents: installed.length,
+                successful_registrations: results.filter(r => r.success).length,
+                results
+            });
+            return;
+        }
+        // Interactive output
+        await PhantomDiscovery.autoRegisterAll();
+    }
+    catch (error) {
+        console.error(theme.error('  Failed to register agents:'), error);
+        process.exitCode = 1;
+    }
+});
+agentsCommand
+    .command('health')
+    .description('Check PHANTOM and agent connection health')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        if (options.json) {
+            const report = await PhantomDiscovery.healthReport();
+            printJson(report);
+            return;
+        }
+        // Interactive health check
+        await PhantomDiscovery.healthCheck();
+    }
+    catch (error) {
+        console.error(theme.error('  Health check failed:'), error);
+        process.exitCode = 1;
+    }
+});
+agentsCommand
+    .command('scan')
+    .description('Scan system for installed AI agents and LLMs')
+    .option('--register', 'Automatically register detected agents')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        let report = await PhantomDiscovery.healthReport();
+        if (options.register) {
+            const installed = report.agents.filter(agent => agent.installed);
+            if (options.json) {
+                const registrationResults = [];
+                for (const agent of installed) {
+                    const result = await PhantomDiscovery.registerAgent(agent.type);
+                    registrationResults.push({
+                        type: agent.type,
+                        success: result.success,
+                        message: result.message,
+                    });
+                }
+                report = await PhantomDiscovery.healthReport();
+                const detected = report.agents.filter(agent => agent.installed);
+                const registered = report.agents.filter(agent => agent.registered).map(agent => agent.type);
+                printJson({
+                    detected,
+                    registered,
+                    health: {
+                        mcp_server: report.mcp_server,
+                        totals: {
+                            detected: detected.length,
+                            registered: registered.length,
+                        },
+                    },
+                    issues: report.issues,
+                    registration: registrationResults,
+                });
+                return;
+            }
+            const summary = await PhantomDiscovery.registerAll(installed.map(agent => agent.type));
+            report = await PhantomDiscovery.healthReport();
+            console.log('');
+            console.log(theme.success(`  Registration complete: ${summary.success}/${summary.total} agents.`));
+            console.log('');
+        }
+        const detected = report.agents.filter(agent => agent.installed);
+        const registered = report.agents.filter(agent => agent.registered).map(agent => agent.type);
+        if (options.json) {
+            printJson({
+                detected,
+                registered,
+                health: {
+                    mcp_server: report.mcp_server,
+                    totals: {
+                        detected: detected.length,
+                        registered: registered.length,
+                    },
+                },
+                issues: report.issues,
+            });
+            return;
+        }
+        console.log('');
+        console.log(theme.title('  DETECTED AGENTS'));
+        console.log('');
+        if (detected.length === 0) {
+            console.log(theme.warning('  No AI agents detected in your system.'));
+            console.log(theme.dim('  Supported: Claude Code, Cursor, Codex CLI, VS Code, Zed, Gemini CLI'));
+            console.log('');
+            return;
+        }
+        for (const agent of detected) {
+            const statusIcon = agent.running ? '🟢' : '🔵';
+            const confidenceColor = agent.confidence > 80 ? theme.success :
+                agent.confidence > 60 ? theme.warning : theme.dim;
+            const registration = agent.registered ? theme.success('Registered') : theme.warning('Not registered');
+            console.log(`  ${statusIcon} ${theme.accent(agent.name)}`);
+            console.log(`     ${confidenceColor(`Confidence: ${agent.confidence}%`)} | Status: ${agent.status}`);
+            console.log(`     ${theme.secondary('Registration:')} ${registration}`);
+            console.log(`     ${theme.dim(agent.configPath)}`);
+            console.log('');
+        }
+        if (report.issues.length > 0) {
+            console.log(theme.warning('  Discovery issues:'));
+            for (const issue of report.issues) {
+                console.log(`    • ${issue}`);
+            }
+            console.log('');
+        }
+        console.log(theme.dim('  Run with --register to automatically register detected agents'));
+        console.log('');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Agent scan failed';
+        if (options.json) {
+            printJson({ status: 'error', error: message });
+        }
+        else {
+            console.log('');
+            console.log(theme.error(`  ${message}`));
+            console.log('');
+        }
+        process.exitCode = 1;
+    }
+});
+agentsCommand
+    .command('list')
+    .description('List registered agents and their integration status')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    try {
+        const { AgentRegistry } = await import('@phantom-pm/core');
+        const registry = new AgentRegistry();
+        const agents = registry.getAllAgents();
+        if (options.json) {
+            printJson({ agents });
+            return;
+        }
+        console.log('');
+        console.log(theme.title('  REGISTERED AGENTS'));
+        console.log('');
+        if (agents.length === 0) {
+            console.log(theme.warning('  No agents registered yet.'));
+            console.log(theme.dim('  Run: phantom agents scan'));
             console.log('');
             return;
         }
@@ -1497,7 +2406,7 @@ agentsCommand
     .option('--json', 'Output as JSON')
     .action(async (agentId, options) => {
     try {
-        const { AgentRegistry } = await import('@phantom/core');
+        const { AgentRegistry } = await import('@phantom-pm/core');
         const registry = new AgentRegistry();
         const validLevels = ['integrated', 'enhanced', 'full'];
         if (!validLevels.includes(options.level)) {
@@ -1536,7 +2445,7 @@ agentsCommand
     .option('--json', 'Output as JSON')
     .action(async (options) => {
     try {
-        const { AgentRegistry } = await import('@phantom/core');
+        const { AgentRegistry } = await import('@phantom-pm/core');
         const registry = new AgentRegistry();
         const topology = registry.getNetworkTopology();
         if (options.json) {
@@ -1610,6 +2519,41 @@ program
     .action(() => {
     failNotImplemented('tools');
 });
+// ── Chat command ──
+program
+    .command('chat')
+    .description('Interactive AI chat — connect any model and talk to Phantom')
+    .option('--model <model>', 'Model to connect (e.g. gpt-4o, claude, gemini, ollama:llama3.1:8b)')
+    .option('--provider <provider>', 'Force a specific provider (openai, anthropic, ollama, gemini)')
+    .action(async (options) => {
+    await startChat(options);
+});
+// ── Model management ──
+program
+    .command('model')
+    .description('Manage AI model connections')
+    .argument('[action]', 'list | switch <model>', 'list')
+    .argument('[model]', 'Model name for switch')
+    .action(async (action, model) => {
+    if (action === 'switch' && model) {
+        console.log(`  Use: phantom chat --model ${model}`);
+        return;
+    }
+    // List available models
+    console.log('');
+    console.log(theme.title('  AVAILABLE MODELS'));
+    console.log('');
+    console.log(`  ${theme.accent('Provider')}          ${theme.accent('Models')}`);
+    console.log(`  ${theme.dim('─'.repeat(55))}`);
+    console.log(`  ${theme.success('ollama')}            llama3.1:8b, llama3.1:70b, codellama:7b, mistral:7b`);
+    console.log(`  ${theme.success('openai')}            gpt-4o, gpt-4o-mini, o3-mini`);
+    console.log(`  ${theme.success('anthropic')}         claude-sonnet-4, claude-3.5-haiku, claude-3-opus`);
+    console.log(`  ${theme.success('gemini')}            gemini-2.0-flash, gemini-2.5-pro, gemini-1.5-pro`);
+    console.log('');
+    console.log(theme.dim('  Usage: phantom chat --model <name>'));
+    console.log(theme.dim('  Config: phantom config setup'));
+    console.log('');
+});
 function dirnameSafe(pathValue) {
     const idx = Math.max(pathValue.lastIndexOf('/'), pathValue.lastIndexOf('\\'));
     if (idx <= 0)
@@ -1623,5 +2567,34 @@ if (argv[2] === 'integrate' &&
     !['scan', 'doctor', 'connect'].includes(argv[3])) {
     argv.splice(3, 0, 'connect');
 }
-program.parse(argv);
+// ── Default: no command → launch interactive chat ──
+import React from 'react';
+import { render } from 'ink';
+import { Dashboard } from './commands/dashboard.js';
+// Check if command already exists to prevent duplicate registration in case of re-execution
+if (!program.commands.find((c) => c.name() === 'dashboard')) {
+    const dashboardCommand = program.command('dashboard')
+        .description('Launch localhost configuration dashboard')
+        .option('-p, --port <number>', 'Port to run on', '3333')
+        .action(async (options) => {
+        const { waitUntilExit } = render(React.createElement(Dashboard, { port: parseInt(options.port) }));
+        await waitUntilExit();
+    });
+}
+const knownCommands = program.commands.map((c) => c.name());
+const userCommand = argv[2];
+if (!userCommand ||
+    (userCommand && !userCommand.startsWith('-') && !knownCommands.includes(userCommand))) {
+    // No command or unknown command → launch chat
+    if (!userCommand) {
+        startChat({});
+    }
+    else {
+        // Treat as a question to Phantom
+        program.parse(argv);
+    }
+}
+else {
+    program.parse(argv);
+}
 //# sourceMappingURL=index.js.map