cmp-standards 2.8.1 → 3.1.0

package/dist/cli/index.js

@@ -27,6 +27,7 @@ import { getProjectRoot, getHooksDir } from '../utils/paths.js';
 import { RegistryGenerator } from '../registry/generator.js';
 import { PatternDetector } from '../auto-improve/pattern-detector.js';
 import { ESLintGenerator } from '../auto-improve/eslint-generator.js';
+import { ui, withSpinner, runTasks } from './ui.js';
 const program = new Command();
 program
     .name('cmp-memory')
@@ -106,10 +107,8 @@ program
     .command('validate')
     .description('Validate project structure against standards')
     .action(async () => {
-    console.log(chalk.blue('🔍 Validating Project Structure\n'));
+    ui.header('Validating Project Structure');
     const projectRoot = await getProjectRoot();
-    const issues = [];
-    const passed = [];
     // Check required files
     const requiredFiles = [
         'CLAUDE.md',
@@ -118,64 +117,79 @@ program
         '.claude/project.config.json',
         '.ai-skills/registry.json',
     ];
-    for (const file of requiredFiles) {
-        const filePath = path.join(projectRoot, file);
-        try {
-            await fs.access(filePath);
-            passed.push(file);
-        }
-        catch {
-            issues.push(`MISSING: ${file}`);
-        }
-    }
     // Check directories
     const requiredDirs = [
         '.claude/agents',
         '.claude/commands',
         '.claude/hooks',
     ];
-    for (const dir of requiredDirs) {
-        const dirPath = path.join(projectRoot, dir);
-        try {
+    const fileTasks = requiredFiles.map(file => ({
+        name: `Check ${file}`,
+        task: async () => {
+            const filePath = path.join(projectRoot, file);
+            await fs.access(filePath);
+        },
+    }));
+    const dirTasks = requiredDirs.map(dir => ({
+        name: `Check ${dir}/`,
+        task: async () => {
+            const dirPath = path.join(projectRoot, dir);
             const stat = await fs.stat(dirPath);
-            if (stat.isDirectory()) {
-                const files = await fs.readdir(dirPath);
-                if (files.length > 0) {
-                    passed.push(`${dir}/ (${files.length} files)`);
-                }
-                else {
-                    issues.push(`EMPTY: ${dir}/`);
-                }
+            if (!stat.isDirectory())
+                throw new Error('Not a directory');
+            const files = await fs.readdir(dirPath);
+            if (files.length === 0)
+                throw new Error('Directory is empty');
+        },
+    }));
+    const expertTask = {
+        name: 'Check experts command',
+        task: async () => {
+            const expertsPath = path.join(projectRoot, '.claude/commands/experts.md');
+            await fs.access(expertsPath);
+        },
+    };
+    const hookVerifyTask = {
+        name: 'Verify hook configurations',
+        task: async () => {
+            const { HookVerifierService } = await import('../services/HookVerifier.js');
+            const verifier = new HookVerifierService(projectRoot);
+            const report = await verifier.verify(false);
+            if (!report.allValid) {
+                const issues = report.results.filter(r => r.status !== 'valid');
+                throw new Error(`${issues.length} hook(s) misconfigured. Run: cmp-standards verify-hooks --fix`);
             }
-        }
-        catch {
-            issues.push(`MISSING: ${dir}/`);
-        }
-    }
-    // Check experts command exists
-    const expertsPath = path.join(projectRoot, '.claude/commands/experts.md');
-    try {
-        await fs.access(expertsPath);
-        passed.push('.claude/commands/experts.md');
-    }
-    catch {
-        issues.push('MISSING: .claude/commands/experts.md (run: cmp-memory sync --commands)');
-    }
-    // Summary
-    console.log(chalk.green('✓ Passed:'));
-    for (const p of passed) {
-        console.log(chalk.green(`   ${p}`));
+        },
+    };
+    const results = await runTasks([...fileTasks, ...dirTasks, expertTask, hookVerifyTask], { stopOnError: false });
+    const failed = results.filter(r => r.status === 'error');
+    if (failed.length > 0) {
+        ui.warning('Run: cmp-standards init --system YOUR_SYSTEM --force');
     }
-    if (issues.length > 0) {
-        console.log(chalk.red('\n✗ Issues:'));
-        for (const issue of issues) {
-            console.log(chalk.red(`   ${issue}`));
-        }
-        console.log(chalk.yellow('\nRun: cmp-memory init --system YOUR_SYSTEM --force'));
+});
+// =============================================================================
+// VERIFY-HOOKS COMMAND
+// =============================================================================
+program
+    .command('verify-hooks')
+    .description('Verify and fix hook configurations')
+    .option('--fix', 'Auto-fix hook issues where possible')
+    .option('-p, --project <path>', 'Project path (defaults to current directory)')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const { HookVerifierService, formatVerificationReport } = await import('../services/HookVerifier.js');
+    const projectPath = options.project ?? process.cwd();
+    const verifier = new HookVerifierService(projectPath);
+    const report = await verifier.verify(options.fix);
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
     }
-    else {
-        console.log(chalk.green('\n✅ All validations passed!'));
+    console.log(formatVerificationReport(report));
+    if (!report.allValid && !options.fix) {
+        ui.warning('Run with --fix to auto-fix issues');
     }
+    process.exit(report.allValid ? 0 : 1);
 });
 // =============================================================================
 // SESSION-CONTEXT COMMAND (for hooks)
@@ -229,17 +243,21 @@ program
     .option('-i, --incremental', 'Only update changed files')
     .option('--files <files>', 'Specific files to process (comma-separated)')
     .action(async (options) => {
-    console.log(chalk.blue('📚 Generating Knowledge Registry\n'));
+    ui.header('Generating Knowledge Registry');
     const generator = new RegistryGenerator();
     if (options.files) {
         const files = options.files.split(',').map((f) => f.trim());
-        console.log(`Processing ${files.length} specific files...`);
-        await generator.update(files);
+        await withSpinner(`Processing ${files.length} files`, async () => {
+            await generator.update(files);
+        }, { successText: `Processed ${files.length} files` });
     }
     else {
-        await generator.generate();
+        await withSpinner('Generating registry', async (spinner) => {
+            spinner.text = 'Scanning documentation...';
+            await generator.generate();
+        }, { successText: 'Registry generated' });
     }
-    console.log(chalk.green('\n✅ Registry generation complete!'));
+    ui.success('Registry generation complete!');
 });
 // =============================================================================
 // SCAN COMMAND
@@ -250,28 +268,36 @@ program
     .option('-d, --dir <directory>', 'Directory to scan', 'src')
     .option('-t, --threshold <number>', 'Pattern threshold', '3')
     .action(async (options) => {
-    console.log(chalk.blue('🔍 Scanning for Patterns\n'));
+    ui.header('Scanning for Patterns');
     const projectRoot = await getProjectRoot();
     const config = await loadConfig(projectRoot);
     const detector = new PatternDetector(config);
-    // Find TypeScript files
-    const { glob } = await import('glob');
-    const files = await glob(`${options.dir}/**/*.{ts,tsx}`, {
-        cwd: projectRoot,
-        absolute: true,
-        ignore: ['**/node_modules/**', '**/*.d.ts', '**/*.test.ts'],
-    });
-    console.log(`Scanning ${files.length} files...`);
-    for (const file of files) {
-        const content = await fs.readFile(file, 'utf-8');
-        detector.scan(content, file);
-    }
+    // Find TypeScript files with spinner
+    const files = await withSpinner('Finding TypeScript files', async () => {
+        const { glob } = await import('glob');
+        return glob(`${options.dir}/**/*.{ts,tsx}`, {
+            cwd: projectRoot,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/*.d.ts', '**/*.test.ts'],
+        });
+    }, { successText: `Found files to scan` });
+    // Scan files with spinner
+    await withSpinner(`Scanning ${files.length} files`, async (spinner) => {
+        for (let i = 0; i < files.length; i++) {
+            const file = files[i];
+            const content = await fs.readFile(file, 'utf-8');
+            detector.scan(content, file);
+            spinner.text = `Scanning files (${i + 1}/${files.length})`;
+        }
+    }, { successText: `Scanned ${files.length} files` });
     const results = detector.getResults();
-    console.log(chalk.blue('\n📊 Results:'));
-    console.log(`   Total patterns: ${results.total}`);
-    console.log(`   Triggered (≥${options.threshold}): ${results.triggered.length}`);
+    ui.subheader('Results');
+    ui.keyValue({
+        'Total patterns': results.total,
+        [`Triggered (≥${options.threshold})`]: results.triggered.length,
+    });
     if (results.patterns.length > 0) {
-        console.log(chalk.blue('\n📋 Detected Patterns:'));
+        ui.subheader('Detected Patterns');
         for (const pattern of results.patterns) {
             const icon = pattern.needsAutoImprove ? '🔴' : '⚪';
             const severity = chalk.gray(`[${pattern.severity}]`);
@@ -280,11 +306,11 @@ program
         }
     }
     if (results.triggered.length > 0) {
-        console.log(chalk.yellow('\n⚠️  Patterns ready for auto-improvement:'));
+        ui.warning('Patterns ready for auto-improvement:');
         for (const pattern of results.triggered) {
             console.log(`   - ${pattern.patternId} (${pattern.count} occurrences)`);
         }
-        console.log(chalk.gray('\n   Run: claude-memory improve'));
+        ui.dim('\n   Run: cmp-standards improve');
     }
 });
 // =============================================================================
@@ -296,21 +322,27 @@ program
     .option('--dry-run', 'Show what would be done without making changes')
     .option('-p, --pattern <pattern>', 'Specific pattern to improve')
     .action(async (options) => {
-    console.log(chalk.blue('🔧 Running Auto-Improvement\n'));
+    ui.header('Running Auto-Improvement');
     const projectRoot = await getProjectRoot();
     const config = await loadConfig(projectRoot);
-    // First scan for patterns
+    // First scan for patterns with spinner
     const detector = new PatternDetector(config);
-    const { glob } = await import('glob');
-    const files = await glob('src/**/*.{ts,tsx}', {
-        cwd: projectRoot,
-        absolute: true,
-        ignore: ['**/node_modules/**', '**/*.d.ts'],
+    const files = await withSpinner('Finding files to analyze', async () => {
+        const { glob } = await import('glob');
+        return glob('src/**/*.{ts,tsx}', {
+            cwd: projectRoot,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/*.d.ts'],
+        });
+    });
+    await withSpinner('Scanning for patterns', async (spinner) => {
+        for (let i = 0; i < files.length; i++) {
+            const file = files[i];
+            const content = await fs.readFile(file, 'utf-8');
+            detector.scan(content, file);
+            spinner.text = `Scanning patterns (${i + 1}/${files.length})`;
+        }
     });
-    for (const file of files) {
-        const content = await fs.readFile(file, 'utf-8');
-        detector.scan(content, file);
-    }
     const results = detector.getResults();
     // Filter patterns to improve
     let patternsToImprove = results.triggered;
@@ -318,31 +350,24 @@ program
         patternsToImprove = patternsToImprove.filter(p => p.patternId === options.pattern);
     }
     if (patternsToImprove.length === 0) {
-        console.log(chalk.green('✅ No patterns need improvement'));
+        ui.success('No patterns need improvement');
         return;
     }
-    console.log(`Found ${patternsToImprove.length} patterns to improve:`);
+    ui.info(`Found ${patternsToImprove.length} patterns to improve:`);
     for (const pattern of patternsToImprove) {
-        console.log(`   - ${pattern.patternId}`);
+        ui.dim(`   - ${pattern.patternId}`);
     }
     if (options.dryRun) {
-        console.log(chalk.yellow('\n[DRY RUN] Would generate ESLint rules for above patterns'));
+        ui.warning('[DRY RUN] Would generate ESLint rules for above patterns');
         return;
     }
-    // Generate ESLint rules
+    // Generate ESLint rules using runTasks
     const generator = new ESLintGenerator();
-    const improvementResults = await generator.generateAllRules(patternsToImprove);
-    console.log(chalk.blue('\n📋 Improvement Results:'));
-    for (const result of improvementResults) {
-        if (result.success) {
-            console.log(chalk.green(`   ✓ ${result.action}: ${result.filePath}`));
-        }
-        else {
-            console.log(chalk.red(`   ✗ ${result.action}: ${result.error}`));
-        }
-    }
-    const successCount = improvementResults.filter(r => r.success).length;
-    console.log(chalk.green(`\n✅ Completed: ${successCount}/${improvementResults.length} improvements`));
+    const tasks = patternsToImprove.map(pattern => ({
+        name: `Generate rule for ${pattern.patternId}`,
+        task: async () => generator.generateRule(pattern),
+    }));
+    await runTasks(tasks, { stopOnError: false });
 });
 // =============================================================================
 // STATUS COMMAND
@@ -351,20 +376,22 @@ program
     .command('status')
     .description('Show memory system status')
     .action(async () => {
-    console.log(chalk.blue('📊 Memory System Status\n'));
+    ui.header('Memory System Status');
     const projectRoot = await getProjectRoot();
     // Check config
     let config;
     try {
         config = await loadConfig(projectRoot);
-        console.log(chalk.green('✓ Configuration found'));
-        console.log(`   System: ${config.system}`);
-        console.log(`   Project: ${config.projectName}`);
-        console.log(`   Domains: ${config.domains.length}`);
+        ui.success('Configuration found');
+        ui.keyValue({
+            'System': config.system,
+            'Project': config.projectName,
+            'Domains': config.domains.length,
+        });
     }
     catch {
-        console.log(chalk.red('✗ No configuration found'));
-        console.log(chalk.gray('   Run: claude-memory init'));
+        ui.error('No configuration found');
+        ui.dim('Run: cmp-standards init');
         return;
     }
     // Check registry
@@ -372,23 +399,25 @@ program
     try {
         const registryContent = await fs.readFile(registryPath, 'utf-8');
         const registry = JSON.parse(registryContent);
-        console.log(chalk.green('✓ Registry found'));
-        console.log(`   Sections: ${registry.sections.length}`);
-        console.log(`   Generated: ${registry.generatedAt || 'pending'}`);
+        ui.success('Registry found');
+        ui.keyValue({
+            'Sections': registry.sections.length,
+            'Generated': registry.generatedAt || 'pending',
+        });
     }
     catch {
-        console.log(chalk.yellow('⚠ No registry found'));
-        console.log(chalk.gray('   Run: claude-memory generate'));
+        ui.warning('No registry found');
+        ui.dim('Run: cmp-standards generate');
     }
     // Check hooks
     const hooksDir = getHooksDir(projectRoot);
     try {
         const hooks = await fs.readdir(hooksDir);
         const hookFiles = hooks.filter(h => h.endsWith('.ts') || h.endsWith('.md'));
-        console.log(chalk.green(`✓ Hooks directory (${hookFiles.length} files)`));
+        ui.success(`Hooks directory (${hookFiles.length} files)`);
     }
     catch {
-        console.log(chalk.yellow('⚠ No hooks directory'));
+        ui.warning('No hooks directory');
     }
     // Check settings.json
     const settingsPath = path.join(projectRoot, '.claude/settings.json');
@@ -397,21 +426,23 @@ program
         const settings = JSON.parse(settingsContent);
         const hasMemoryPlugin = settings.plugins?.['metanautical-memory'];
         if (hasMemoryPlugin) {
-            console.log(chalk.green('✓ Memory plugin configured in settings.json'));
+            ui.success('Memory plugin configured in settings.json');
         }
         else {
-            console.log(chalk.yellow('⚠ Memory plugin not in settings.json'));
+            ui.warning('Memory plugin not in settings.json');
         }
     }
     catch {
-        console.log(chalk.yellow('⚠ No settings.json found'));
+        ui.warning('No settings.json found');
     }
     // Features status
-    console.log(chalk.blue('\n🔧 Features:'));
-    console.log(`   Guards: ${config.guards.enabled ? 'Enabled' : 'Disabled'} (${config.guards.rules.length} rules)`);
-    console.log(`   Embedding: ${config.embedding.enabled ? 'Enabled' : 'Disabled'}`);
-    console.log(`   Checkpoint: ${config.checkpoint.enabled ? 'Enabled' : 'Disabled'}`);
-    console.log(`   Auto-improve: ${config.autoImprovement.enabled ? 'Enabled' : 'Disabled'} (threshold: ${config.autoImprovement.violationThreshold})`);
+    ui.subheader('Features');
+    ui.keyValue({
+        'Guards': `${config.guards.enabled ? 'Enabled' : 'Disabled'} (${config.guards.rules.length} rules)`,
+        'Embedding': config.embedding.enabled ? 'Enabled' : 'Disabled',
+        'Checkpoint': config.checkpoint.enabled ? 'Enabled' : 'Disabled',
+        'Auto-improve': `${config.autoImprovement.enabled ? 'Enabled' : 'Disabled'} (threshold: ${config.autoImprovement.violationThreshold})`,
+    });
 });
 // =============================================================================
 // DASHBOARD COMMAND
@@ -518,6 +549,81 @@ program
     console.log(chalk.gray(`\nGenerated at: ${report.generatedAt}`));
 });
 // =============================================================================
+// CROSS-PROJECT ANALYTICS COMMAND
+// =============================================================================
+program
+    .command('cross-analytics')
+    .description('Show cross-project analytics and insights')
+    .option('--json', 'Output as JSON')
+    .option('-d, --days <days>', 'Number of days to analyze', '30')
+    .action(async (options) => {
+    ui.header('Cross-Project Analytics');
+    const { getCrossProjectAnalytics } = await import('../analytics/CrossProjectAnalytics.js');
+    const analytics = getCrossProjectAnalytics();
+    const report = await withSpinner('Generating cross-project report', async () => {
+        return analytics.generateReport({
+            startDate: new Date(Date.now() - parseInt(options.days) * 24 * 60 * 60 * 1000),
+        });
+    });
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    // Total Metrics
+    ui.subheader('Ecosystem Overview');
+    ui.keyValue({
+        'Total Projects': report.totalMetrics.totalProjects,
+        'Total Memories': report.totalMetrics.totalMemories,
+        'Total Tasks': report.totalMetrics.totalTasks,
+        'Total Sessions': report.totalMetrics.totalSessions,
+        'Avg Health Score': `${report.totalMetrics.avgHealthScore.toFixed(0)}%`,
+    });
+    // Project Metrics
+    if (report.projectMetrics.length > 0) {
+        ui.subheader('Project Health');
+        for (const project of report.projectMetrics) {
+            const healthIcon = project.healthScore >= 70 ? '🟢' : project.healthScore >= 40 ? '🟡' : '🔴';
+            console.log(`  ${healthIcon} ${project.system}: ${project.healthScore}% (${project.memories} memories, ${project.sessions} sessions)`);
+        }
+    }
+    // Insights
+    if (report.insights.length > 0) {
+        ui.subheader('Insights');
+        for (const insight of report.insights.slice(0, 5)) {
+            const icon = insight.type === 'warning' ? '⚠️' : insight.type === 'best_practice' ? '✨' : '💡';
+            const priority = insight.priority === 'high' ? chalk.red(`[${insight.priority}]`) : chalk.gray(`[${insight.priority}]`);
+            console.log(`  ${icon} ${priority} ${insight.title}`);
+            if (insight.suggestedAction) {
+                ui.dim(`     → ${insight.suggestedAction}`);
+            }
+        }
+    }
+    // Pattern Comparisons
+    if (report.patternComparisons.length > 0) {
+        ui.subheader('Shared Patterns');
+        for (const pattern of report.patternComparisons.slice(0, 5)) {
+            const systems = Object.keys(pattern.occurrences).length;
+            console.log(`  📊 ${pattern.patternId}: ${pattern.totalOccurrences}x across ${systems} projects`);
+        }
+    }
+    // Learning Opportunities
+    if (report.learningOpportunities.length > 0) {
+        ui.subheader('Learning Transfer Opportunities');
+        for (const opp of report.learningOpportunities.slice(0, 5)) {
+            console.log(`  🔄 "${opp.memoryTitle}" (${opp.fromSystem} → ${opp.toSystem})`);
+            ui.dim(`     Relevance: ${(opp.relevanceScore * 100).toFixed(0)}%`);
+        }
+    }
+    // Recommendations
+    if (report.recommendations.length > 0) {
+        ui.subheader('Recommendations');
+        for (const rec of report.recommendations) {
+            console.log(`  ➤ ${rec}`);
+        }
+    }
+    ui.dim(`\nReport generated: ${report.generatedAt}`);
+});
+// =============================================================================
 // FEEDBACK COMMAND
 // =============================================================================
 program
@@ -769,24 +875,24 @@ cloudCmd
     .command('status')
     .description('Check cloud services status')
     .action(async () => {
-    console.log(chalk.blue('☁️  Cloud Services Status\n'));
-    const { initCloud, healthCheck } = await import('../db/cloud.js');
-    try {
-        const status = await initCloud();
-        console.log(`Turso:  ${status.turso.ok ? chalk.green('✅') : chalk.red('❌')} ${status.turso.message}`);
-        console.log(`Redis:  ${status.redis.ok ? chalk.green('✅') : chalk.red('❌')} ${status.redis.message}`);
-        console.log(`Vector: ${status.vector.ok ? chalk.green('✅') : chalk.red('❌')} ${status.vector.message}`);
-        const allOk = status.turso.ok && status.redis.ok;
-        if (allOk) {
-            console.log(chalk.green('\n✅ All core services connected!'));
-        }
-        else {
-            console.log(chalk.yellow('\n⚠️  Some services unavailable'));
-            console.log(chalk.gray('Check your .env file for credentials'));
-        }
+    ui.header('Cloud Services Status');
+    const { initCloud } = await import('../db/cloud.js');
+    const status = await withSpinner('Connecting to cloud services', async () => {
+        return initCloud();
+    });
+    ui.subheader('Service Status');
+    ui.keyValue({
+        'Turso': `${status.turso.ok ? '✅' : '❌'} ${status.turso.message}`,
+        'Redis': `${status.redis.ok ? '✅' : '❌'} ${status.redis.message}`,
+        'Vector': `${status.vector.ok ? '✅' : '❌'} ${status.vector.message}`,
+    });
+    const allOk = status.turso.ok && status.redis.ok;
+    if (allOk) {
+        ui.success('All core services connected!');
     }
-    catch (error) {
-        console.log(chalk.red(`❌ Error: ${error}`));
+    else {
+        ui.warning('Some services unavailable');
+        ui.dim('Check your .env file for credentials');
     }
 });
 cloudCmd
@@ -995,6 +1101,417 @@ cloudCmd
     }
 });
 // =============================================================================
+// QUICKSTART WIZARD
+// =============================================================================
+program
+    .command('quickstart')
+    .description('Interactive setup wizard for new projects')
+    .action(async () => {
+    console.log(chalk.blue(`
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║   🚀 CMP-Standards Quickstart Wizard                         ║
+║                                                               ║
+║   Set up your project in minutes with guided configuration   ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+`));
+    const inquirer = (await import('inquirer')).default;
+    const projectRoot = await getProjectRoot();
+    // Step 1: Check existing setup
+    ui.header('Step 1: Checking Existing Setup');
+    const existingConfig = await loadConfig(projectRoot).catch(() => null);
+    if (existingConfig) {
+        console.log(chalk.green(`  ✓ Existing configuration found: ${existingConfig.system}`));
+        const { continueSetup } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'continueSetup',
+                message: 'Do you want to reconfigure?',
+                default: false
+            }]);
+        if (!continueSetup) {
+            console.log(chalk.gray('\n  Run `cmp-standards status` to view current setup'));
+            return;
+        }
+    }
+    // Step 2: Project Configuration
+    ui.header('Step 2: Project Configuration');
+    const { system, projectName } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'system',
+            message: 'System identifier (e.g., MYAPP, PANEL):',
+            default: path.basename(projectRoot).toUpperCase().replace(/[^A-Z0-9]/g, '_'),
+            validate: (input) => /^[A-Z][A-Z0-9_]*$/.test(input) || 'Must start with letter, use A-Z, 0-9, _'
+        },
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'Project name:',
+            default: path.basename(projectRoot)
+        }
+    ]);
+    // Step 3: Cloud Services
+    ui.header('Step 3: Cloud Services');
+    const { hasCloudCredentials } = await import('../utils/env-loader.js');
+    const creds = hasCloudCredentials();
+    console.log('  Current status:');
+    console.log(`    Turso:  ${creds.turso ? chalk.green('✓ Configured') : chalk.yellow('✗ Not configured')}`);
+    console.log(`    Redis:  ${creds.redis ? chalk.green('✓ Configured') : chalk.yellow('✗ Not configured')}`);
+    console.log(`    Vector: ${creds.vector ? chalk.green('✓ Configured') : chalk.gray('○ Optional')}`);
+    if (!creds.turso || !creds.redis) {
+        const { setupCloud } = await inquirer.prompt([{
+                type: 'confirm',
+                name: 'setupCloud',
+                message: 'Would you like guidance for setting up cloud services?',
+                default: true
+            }]);
+        if (setupCloud) {
+            console.log(chalk.cyan('\n  📚 Cloud Setup Guide:'));
+            console.log(chalk.gray('  ─'.repeat(30)));
+            if (!creds.turso) {
+                console.log(chalk.yellow('\n  Turso (SQLite Edge Database):'));
+                console.log('    1. Visit: https://turso.tech');
+                console.log('    2. Create free account');
+                console.log('    3. Create database named "memory"');
+                console.log('    4. Get URL: turso db show memory --url');
+                console.log('    5. Get token: turso db tokens create memory');
+                console.log(chalk.gray('    Add to .env: TURSO_DATABASE_URL and TURSO_AUTH_TOKEN'));
+            }
+            if (!creds.redis) {
+                console.log(chalk.yellow('\n  Upstash Redis:'));
+                console.log('    1. Visit: https://console.upstash.com');
+                console.log('    2. Create Redis database');
+                console.log('    3. Copy REST credentials');
+                console.log(chalk.gray('    Add to .env: UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN'));
+            }
+            const { hasCredentials } = await inquirer.prompt([{
+                    type: 'confirm',
+                    name: 'hasCredentials',
+                    message: 'Have you added the credentials to your .env file?',
+                    default: false
+                }]);
+            if (!hasCredentials) {
+                console.log(chalk.gray('\n  You can continue without cloud services (local mode)'));
+                console.log(chalk.gray('  Run `cmp-standards cloud init` later to complete setup'));
+            }
+        }
+    }
+    // Step 4: Initialize Project
+    ui.header('Step 4: Initializing Project');
+    const { createProjectScaffold } = await import('../services/ProjectScaffold.js');
+    const scaffold = createProjectScaffold(projectRoot);
+    await scaffold.scaffold({
+        system,
+        projectName,
+        force: true,
+        skipAgents: false,
+        skipHooks: false,
+        skipCommands: false,
+    });
+    // Step 5: Verify Setup
+    ui.header('Step 5: Verifying Setup');
+    const { HookVerifierService } = await import('../services/HookVerifier.js');
+    const verifier = new HookVerifierService(projectRoot);
+    const report = await verifier.verify(true); // Auto-fix
+    console.log(`  Hooks verified: ${report.results.filter(r => r.status === 'valid').length}/${report.results.length}`);
+    // Summary
+    console.log(chalk.green(`
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║   ✅ Setup Complete!                                          ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+`));
+    console.log(`  System:  ${chalk.cyan(system)}`);
+    console.log(`  Project: ${projectName}`);
+    console.log('');
+    console.log('  Next steps:');
+    console.log(`    ${chalk.yellow('cmp-standards status')}    - Check system status`);
+    console.log(`    ${chalk.yellow('cmp-standards validate')} - Validate project structure`);
+    console.log(`    ${chalk.yellow('/experts src/')}          - Run code review`);
+    console.log('');
+});
+// =============================================================================
+// DOCTOR COMMAND
+// =============================================================================
+program
+    .command('doctor')
+    .description('Diagnose and fix common issues')
+    .option('--fix', 'Attempt to fix issues automatically')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    ui.header('CMP-Standards Doctor');
+    const projectRoot = await getProjectRoot();
+    const issues = [];
+    // Check 1: Configuration
+    console.log(chalk.gray('  Checking configuration...'));
+    let config = null;
+    try {
+        config = await loadConfig(projectRoot);
+    }
+    catch {
+        issues.push({
+            category: 'config',
+            severity: 'error',
+            message: 'No memory-config.json found',
+            fix: 'Run: cmp-standards init --system YOUR_SYSTEM',
+            fixable: false
+        });
+    }
+    // Check 2: Required directories
+    console.log(chalk.gray('  Checking directory structure...'));
+    const requiredDirs = ['.claude', '.claude/agents', '.claude/commands', '.claude/hooks'];
+    for (const dir of requiredDirs) {
+        const dirPath = path.join(projectRoot, dir);
+        try {
+            await fs.access(dirPath);
+        }
+        catch {
+            issues.push({
+                category: 'structure',
+                severity: 'error',
+                message: `Missing directory: ${dir}`,
+                fix: `mkdir -p ${dir}`,
+                fixable: true
+            });
+            if (options.fix) {
+                await fs.mkdir(dirPath, { recursive: true });
+            }
+        }
+    }
+    // Check 3: Required files
+    console.log(chalk.gray('  Checking required files...'));
+    const requiredFiles = ['CLAUDE.md', '.claude/settings.json'];
+    for (const file of requiredFiles) {
+        const filePath = path.join(projectRoot, file);
+        try {
+            await fs.access(filePath);
+        }
+        catch {
+            issues.push({
+                category: 'structure',
+                severity: 'error',
+                message: `Missing file: ${file}`,
+                fix: 'Run: cmp-standards init --system YOUR_SYSTEM',
+                fixable: false
+            });
+        }
+    }
+    // Check 4: Cloud credentials
+    console.log(chalk.gray('  Checking cloud credentials...'));
+    const { hasCloudCredentials } = await import('../utils/env-loader.js');
+    const creds = hasCloudCredentials();
+    if (!creds.turso) {
+        issues.push({
+            category: 'cloud',
+            severity: 'warning',
+            message: 'Turso credentials not configured',
+            fix: 'Run: cmp-standards cloud init',
+            fixable: false
+        });
+    }
+    if (!creds.redis) {
+        issues.push({
+            category: 'cloud',
+            severity: 'warning',
+            message: 'Upstash Redis credentials not configured',
+            fix: 'Run: cmp-standards cloud init',
+            fixable: false
+        });
+    }
+    // Check 5: Hook configurations
+    console.log(chalk.gray('  Checking hooks...'));
+    try {
+        const { HookVerifierService } = await import('../services/HookVerifier.js');
+        const verifier = new HookVerifierService(projectRoot);
+        const report = await verifier.verify(options.fix);
+        for (const result of report.results) {
+            if (result.status !== 'valid') {
+                const isError = result.status === 'missing_file' || result.status === 'invalid_syntax';
+                issues.push({
+                    category: 'hooks',
+                    severity: isError ? 'error' : 'warning',
+                    message: `Hook ${result.hookPath}: ${result.message}`,
+                    fix: result.autoFixable ? (options.fix && result.fixed ? 'Fixed automatically' : 'Run with --fix') : undefined,
+                    fixable: result.autoFixable
+                });
+            }
+        }
+    }
+    catch {
+        // No hooks to check
+    }
+    // Check 6: Node version
+    console.log(chalk.gray('  Checking Node.js version...'));
+    const nodeVersion = process.version.match(/^v(\d+)/)?.[1];
+    if (nodeVersion && parseInt(nodeVersion) < 18) {
+        issues.push({
+            category: 'environment',
+            severity: 'error',
+            message: `Node.js ${process.version} is not supported (requires >=18)`,
+            fixable: false
+        });
+    }
+    // Output results
+    if (options.json) {
+        console.log(JSON.stringify({ issues, summary: {
+                total: issues.length,
+                errors: issues.filter(i => i.severity === 'error').length,
+                warnings: issues.filter(i => i.severity === 'warning').length,
+                info: issues.filter(i => i.severity === 'info').length
+            } }, null, 2));
+        return;
+    }
+    console.log('');
+    if (issues.length === 0) {
+        console.log(chalk.green('  ✅ No issues found! Your setup looks healthy.'));
+    }
+    else {
+        const errors = issues.filter(i => i.severity === 'error');
+        const warnings = issues.filter(i => i.severity === 'warning');
+        if (errors.length > 0) {
+            ui.subheader(`Errors (${errors.length})`);
+            for (const issue of errors) {
+                console.log(`  ❌ [${issue.category}] ${issue.message}`);
+                if (issue.fix) {
+                    console.log(chalk.gray(`     Fix: ${issue.fix}`));
+                }
+            }
+        }
+        if (warnings.length > 0) {
+            ui.subheader(`Warnings (${warnings.length})`);
+            for (const issue of warnings) {
+                console.log(`  ⚠️  [${issue.category}] ${issue.message}`);
+                if (issue.fix) {
+                    console.log(chalk.gray(`     Fix: ${issue.fix}`));
+                }
+            }
+        }
+        const fixable = issues.filter(i => i.fixable && i.severity === 'error');
+        if (fixable.length > 0 && !options.fix) {
+            console.log(chalk.yellow(`\n  💡 ${fixable.length} issues can be fixed automatically.`));
+            console.log(chalk.yellow('     Run: cmp-standards doctor --fix'));
+        }
+    }
+});
+// =============================================================================
+// COMPLETION COMMAND
+// =============================================================================
+program
+    .command('completion')
+    .description('Generate shell completion scripts')
+    .argument('<shell>', 'Shell type: bash, zsh, fish, powershell')
+    .action(async (shell) => {
+    const commands = [
+        'init', 'sync', 'validate', 'verify-hooks', 'generate', 'scan', 'improve',
+        'status', 'dashboard', 'mcp', 'analytics', 'cross-analytics', 'feedback',
+        'tasks', 'ideas', 'improvements', 'plan', 'capture', 'export',
+        'cloud', 'quickstart', 'doctor', 'completion'
+    ];
+    const subcommands = {
+        cloud: ['status', 'init', 'improvements', 'tasks', 'session']
+    };
+    switch (shell.toLowerCase()) {
+        case 'bash':
+            console.log(`# CMP-Standards Bash Completion
+# Add to ~/.bashrc or ~/.bash_profile:
+# source <(cmp-standards completion bash)
+
+_cmp_standards_completions() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  case "\${prev}" in
+    cmp-standards)
+      COMPREPLY=( $(compgen -W "${commands.join(' ')}" -- "\${cur}") )
+      return 0
+      ;;
+    cloud)
+      COMPREPLY=( $(compgen -W "${subcommands.cloud.join(' ')}" -- "\${cur}") )
+      return 0
+      ;;
+  esac
+}
+
+complete -F _cmp_standards_completions cmp-standards
+`);
+            break;
+        case 'zsh':
+            console.log(`# CMP-Standards Zsh Completion
+# Add to ~/.zshrc:
+# source <(cmp-standards completion zsh)
+
+_cmp_standards() {
+  local -a commands
+  commands=(
+    ${commands.map(c => `'${c}:${c} command'`).join('\n    ')}
+  )
+
+  local -a cloud_subcommands
+  cloud_subcommands=(
+    ${subcommands.cloud.map(c => `'${c}:cloud ${c}'`).join('\n    ')}
+  )
+
+  _arguments -C \\
+    '1: :->command' \\
+    '*:: :->args'
+
+  case $state in
+    command)
+      _describe -t commands 'cmp-standards commands' commands
+      ;;
+    args)
+      case $words[1] in
+        cloud)
+          _describe -t commands 'cloud subcommands' cloud_subcommands
+          ;;
+      esac
+      ;;
+  esac
+}
+
+compdef _cmp_standards cmp-standards
+`);
+            break;
+        case 'fish':
+            console.log(`# CMP-Standards Fish Completion
+# Add to ~/.config/fish/completions/cmp-standards.fish
+
+${commands.map(c => `complete -c cmp-standards -f -n "__fish_use_subcommand" -a ${c} -d "${c}"`).join('\n')}
+${subcommands.cloud.map(c => `complete -c cmp-standards -f -n "__fish_seen_subcommand_from cloud" -a ${c} -d "cloud ${c}"`).join('\n')}
+`);
+            break;
+        case 'powershell':
+            console.log(`# CMP-Standards PowerShell Completion
+# Add to $PROFILE:
+
+Register-ArgumentCompleter -CommandName cmp-standards -ScriptBlock {
+  param($wordToComplete, $commandAst, $cursorPosition)
+
+  $commands = @(${commands.map(c => `'${c}'`).join(', ')})
+
+  if ($commandAst.CommandElements.Count -eq 2) {
+    $commands | Where-Object { $_ -like "$wordToComplete*" } |
+      ForEach-Object {
+        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+      }
+  } elseif ($commandAst.CommandElements[1].Extent.Text -eq 'cloud') {
+    @(${subcommands.cloud.map(c => `'${c}'`).join(', ')}) | Where-Object { $_ -like "$wordToComplete*" } |
+      ForEach-Object {
+        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+      }
+  }
+}
+`);
+            break;
+        default:
+            console.error(chalk.red(`Unknown shell: ${shell}`));
+            console.log('Supported shells: bash, zsh, fish, powershell');
+            process.exit(1);
+    }
+});
+// =============================================================================
 // MAIN
 // =============================================================================
 program.parse();