cmp-standards 2.8.1 → 2.9.1

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