cmp-standards 3.5.1 → 3.7.1

package/dist/analytics/CrossProjectAnalytics.js

@@ -28,8 +28,8 @@ export class CrossProjectAnalyticsService {
         const db = turso.getClient();
         const metrics = [];
         // Get all systems
-        const systemsResult = await db.execute(`
-      SELECT DISTINCT system FROM items WHERE status = 'active'
+        const systemsResult = await db.execute(`
+      SELECT DISTINCT system FROM items WHERE status = 'active'
     `);
         const systems = systemsResult.rows
             .map(r => r.system)
@@ -37,14 +37,14 @@ export class CrossProjectAnalyticsService {
         for (const system of systems) {
             const [itemsResult, sessionsResult, lastActivityResult] = await Promise.all([
                 db.execute({
-                    sql: `SELECT type, COUNT(*) as count FROM items
-                WHERE system = ? AND status = 'active'
+                    sql: `SELECT type, COUNT(*) as count FROM items
+                WHERE system = ? AND status = 'active'
                 GROUP BY type`,
                     args: [system],
                 }),
                 db.execute({
-                    sql: `SELECT COUNT(*) as count FROM items
-                WHERE system = ? AND type = 'agent_session'
+                    sql: `SELECT COUNT(*) as count FROM items
+                WHERE system = ? AND type = 'agent_session'
                 AND created_at > datetime('now', '-7 days')`,
                     args: [system],
                 }),
@@ -117,18 +117,18 @@ export class CrossProjectAnalyticsService {
         const insights = [];
         const db = turso.getClient();
         // Find shared patterns across projects
-        const sharedPatternsResult = await db.execute(`
-      SELECT
-        json_extract(content, '$.patternId') as patternId,
-        COUNT(DISTINCT system) as systemCount,
-        GROUP_CONCAT(DISTINCT system) as systems,
-        SUM(json_extract(content, '$.count')) as totalCount
-      FROM items
-      WHERE type = 'pattern' AND status = 'active'
-      GROUP BY patternId
-      HAVING systemCount > 1
-      ORDER BY totalCount DESC
-      LIMIT 10
+        const sharedPatternsResult = await db.execute(`
+      SELECT
+        json_extract(content, '$.patternId') as patternId,
+        COUNT(DISTINCT system) as systemCount,
+        GROUP_CONCAT(DISTINCT system) as systems,
+        SUM(json_extract(content, '$.count')) as totalCount
+      FROM items
+      WHERE type = 'pattern' AND status = 'active'
+      GROUP BY patternId
+      HAVING systemCount > 1
+      ORDER BY totalCount DESC
+      LIMIT 10
     `);
         for (const row of sharedPatternsResult.rows) {
             // Skip rows with missing or invalid systems data
@@ -187,15 +187,15 @@ export class CrossProjectAnalyticsService {
     async comparePatterns(options) {
         const db = turso.getClient();
         const comparisons = [];
-        const result = await db.execute(`
-      SELECT
-        json_extract(content, '$.patternId') as patternId,
-        json_extract(content, '$.description') as description,
-        system,
-        json_extract(content, '$.count') as count
-      FROM items
-      WHERE type = 'pattern' AND status = 'active'
-      ORDER BY patternId
+        const result = await db.execute(`
+      SELECT
+        json_extract(content, '$.patternId') as patternId,
+        json_extract(content, '$.description') as description,
+        system,
+        json_extract(content, '$.count') as count
+      FROM items
+      WHERE type = 'pattern' AND status = 'active'
+      ORDER BY patternId
     `);
         // Group by pattern
         const patternGroups = new Map();
@@ -236,25 +236,25 @@ export class CrossProjectAnalyticsService {
         const db = turso.getClient();
         const opportunities = [];
         // Find high-value memories that could benefit other projects
-        const memoriesResult = await db.execute(`
-      SELECT
-        id,
-        system,
-        json_extract(content, '$.title') as title,
-        json_extract(content, '$.domain') as domain,
-        json_extract(content, '$.feedbackScore') as feedbackScore,
-        json_extract(content, '$.accessCount') as accessCount
-      FROM items
-      WHERE type = 'memory'
-        AND status = 'active'
-        AND COALESCE(json_extract(content, '$.feedbackScore'), 0.5) >= 0.7
-        AND COALESCE(json_extract(content, '$.accessCount'), 0) >= 3
-      ORDER BY feedbackScore DESC, accessCount DESC
-      LIMIT 50
+        const memoriesResult = await db.execute(`
+      SELECT
+        id,
+        system,
+        json_extract(content, '$.title') as title,
+        json_extract(content, '$.domain') as domain,
+        json_extract(content, '$.feedbackScore') as feedbackScore,
+        json_extract(content, '$.accessCount') as accessCount
+      FROM items
+      WHERE type = 'memory'
+        AND status = 'active'
+        AND COALESCE(json_extract(content, '$.feedbackScore'), 0.5) >= 0.7
+        AND COALESCE(json_extract(content, '$.accessCount'), 0) >= 3
+      ORDER BY feedbackScore DESC, accessCount DESC
+      LIMIT 50
     `);
         // Get all active systems
-        const systemsResult = await db.execute(`
-      SELECT DISTINCT system FROM items WHERE status = 'active'
+        const systemsResult = await db.execute(`
+      SELECT DISTINCT system FROM items WHERE status = 'active'
     `);
         const allSystems = systemsResult.rows.map(r => r.system);
         for (const row of memoriesResult.rows) {
@@ -288,16 +288,16 @@ export class CrossProjectAnalyticsService {
     async getActivityTimeline(days = 30) {
         const db = turso.getClient();
         const result = await db.execute({
-            sql: `
-        SELECT
-          DATE(created_at) as date,
-          system,
-          COUNT(*) as itemsCreated,
-          SUM(CASE WHEN type = 'agent_session' THEN 1 ELSE 0 END) as sessionsStarted
-        FROM items
-        WHERE created_at > datetime('now', '-' || ? || ' days')
-        GROUP BY DATE(created_at), system
-        ORDER BY date DESC
+            sql: `
+        SELECT
+          DATE(created_at) as date,
+          system,
+          COUNT(*) as itemsCreated,
+          SUM(CASE WHEN type = 'agent_session' THEN 1 ELSE 0 END) as sessionsStarted
+        FROM items
+        WHERE created_at > datetime('now', '-' || ? || ' days')
+        GROUP BY DATE(created_at), system
+        ORDER BY date DESC
       `,
             args: [days],
         });
@@ -314,17 +314,17 @@ export class CrossProjectAnalyticsService {
     async getTopContributors(limit = 5) {
         const db = turso.getClient();
         const result = await db.execute({
-            sql: `
-        SELECT
-          system,
-          SUM(CASE WHEN type = 'memory' THEN 1 ELSE 0 END) as memoriesCreated,
-          SUM(CASE WHEN type = 'task' AND json_extract(content, '$.status') = 'completed' THEN 1 ELSE 0 END) as tasksCompleted,
-          SUM(CASE WHEN type = 'pattern' THEN 1 ELSE 0 END) as patternsDetected
-        FROM items
-        WHERE status = 'active' AND created_at > datetime('now', '-30 days')
-        GROUP BY system
-        ORDER BY memoriesCreated DESC
-        LIMIT ?
+            sql: `
+        SELECT
+          system,
+          SUM(CASE WHEN type = 'memory' THEN 1 ELSE 0 END) as memoriesCreated,
+          SUM(CASE WHEN type = 'task' AND json_extract(content, '$.status') = 'completed' THEN 1 ELSE 0 END) as tasksCompleted,
+          SUM(CASE WHEN type = 'pattern' THEN 1 ELSE 0 END) as patternsDetected
+        FROM items
+        WHERE status = 'active' AND created_at > datetime('now', '-30 days')
+        GROUP BY system
+        ORDER BY memoriesCreated DESC
+        LIMIT ?
       `,
             args: [limit],
         });

package/dist/cli/index.js

@@ -394,21 +394,44 @@ program
         ui.dim('Run: cmp-standards init');
         return;
     }
-    // Check registry
-    const registryPath = path.join(projectRoot, '.claude/knowledge/registry.json');
-    try {
-        const registryContent = await fs.readFile(registryPath, 'utf-8');
-        const registry = JSON.parse(registryContent);
-        ui.success('Registry found');
-        ui.keyValue({
-            'Sections': registry.sections.length,
-            'Generated': registry.generatedAt || 'pending',
-        });
+    // Check registry - now in .claude/cache (not knowledge)
+    const registryPath = path.join(projectRoot, '.claude/cache/registry.json');
+    const legacyRegistryPath = path.join(projectRoot, '.claude/knowledge/registry.json');
+    let foundRegistry = false;
+    for (const regPath of [registryPath, legacyRegistryPath]) {
+        try {
+            const registryContent = await fs.readFile(regPath, 'utf-8');
+            const registry = JSON.parse(registryContent);
+            ui.success('Registry found');
+            ui.keyValue({
+                'Sections': registry.sections.length,
+                'Generated': registry.generatedAt || 'pending',
+            });
+            foundRegistry = true;
+            break;
+        }
+        catch {
+            // Continue to next path
+        }
     }
-    catch {
+    if (!foundRegistry) {
         ui.warning('No registry found');
         ui.dim('Run: cmp-standards generate');
     }
+    // Check for LOCAL knowledge files (VIOLATION of Cloud > Local philosophy)
+    const knowledgeDir = path.join(projectRoot, '.claude/knowledge');
+    try {
+        const knowledgeFiles = await fs.readdir(knowledgeDir);
+        const mdFiles = knowledgeFiles.filter(f => f.endsWith('.md'));
+        if (mdFiles.length > 0) {
+            console.log(chalk.red(`\n  ⚠️  PHILOSOPHY VIOLATION: ${mdFiles.length} local knowledge files found`));
+            console.log(chalk.gray('     Cloud > Local - knowledge should be in Turso, not local files'));
+            console.log(chalk.yellow('     Run: cmp-standards cloud push-knowledge --delete-local'));
+        }
+    }
+    catch {
+        // No knowledge directory = good (cloud-first)
+    }
     // Check hooks
     const hooksDir = getHooksDir(projectRoot);
     try {
@@ -1100,6 +1123,127 @@ cloudCmd
         }
     }
 });
+cloudCmd
+    .command('push-knowledge')
+    .description('Push local knowledge files to Turso cloud (Cloud > Local philosophy)')
+    .option('-s, --system <system>', 'System identifier')
+    .option('--delete-local', 'Delete local files after successful push')
+    .option('--dry-run', 'Show what would be pushed without pushing')
+    .action(async (options) => {
+    const projectRoot = await getProjectRoot();
+    let system = options.system;
+    if (!system) {
+        try {
+            const config = await loadConfig(projectRoot);
+            system = config.system;
+        }
+        catch {
+            console.log(chalk.red('Error: No system specified and no config found'));
+            process.exit(1);
+        }
+    }
+    const knowledgeDir = path.join(projectRoot, '.claude/knowledge');
+    const domainsDir = path.join(knowledgeDir, 'domains');
+    // Check for local knowledge files
+    const fsSync = await import('fs');
+    const files = [];
+    if (fsSync.existsSync(knowledgeDir)) {
+        for (const file of fsSync.readdirSync(knowledgeDir)) {
+            if (file.endsWith('.md') && !file.startsWith('.')) {
+                files.push({ file: path.join(knowledgeDir, file), domain: 'general' });
+            }
+        }
+    }
+    if (fsSync.existsSync(domainsDir)) {
+        for (const file of fsSync.readdirSync(domainsDir)) {
+            if (file.endsWith('.md')) {
+                const domain = file.replace('.md', '');
+                files.push({ file: path.join(domainsDir, file), domain });
+            }
+        }
+    }
+    if (files.length === 0) {
+        console.log(chalk.green('☁️  No local knowledge files found - already cloud-first!'));
+        return;
+    }
+    console.log(chalk.yellow(`\n⚠️  Found ${files.length} local knowledge files`));
+    console.log(chalk.gray('   Philosophy: Cloud > Local - knowledge should be in Turso\n'));
+    if (options.dryRun) {
+        console.log(chalk.blue('📋 Dry run - would push:\n'));
+        for (const { file, domain } of files) {
+            const content = fsSync.readFileSync(file, 'utf-8');
+            const titleMatch = content.match(/^#\s+(.+)$/m);
+            const title = titleMatch ? titleMatch[1] : path.basename(file, '.md');
+            console.log(`   → ${title} (${domain})`);
+        }
+        return;
+    }
+    // Initialize cloud
+    const { cloud } = await import('../db/cloud.js');
+    await cloud.init();
+    let migrated = 0;
+    let skipped = 0;
+    for (const { file, domain } of files) {
+        const content = fsSync.readFileSync(file, 'utf-8');
+        const filename = path.basename(file, '.md');
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const title = titleMatch ? titleMatch[1] : filename;
+        const sections = content.match(/^##\s+(.+)$/gm) || [];
+        const tags = sections.map(s => s.replace('## ', '').toLowerCase().replace(/\s+/g, '-'));
+        let importance = 'normal';
+        if (filename.includes('critical') || content.toLowerCase().includes('critical')) {
+            importance = 'critical';
+        }
+        const knowledgeContent = {
+            title,
+            domain,
+            body: content,
+            tags: [...new Set([domain, ...tags])],
+            importance,
+            source: 'migration',
+            createdAt: new Date().toISOString()
+        };
+        // Check if exists using raw client
+        const client = cloud.turso.getClient();
+        const existing = await client.execute({
+            sql: `SELECT id FROM items WHERE system = ? AND type = 'knowledge' AND json_extract(content, '$.title') = ?`,
+            args: [system, title]
+        });
+        if (existing.rows.length > 0) {
+            console.log(chalk.gray(`   ⏭️  Skipped: ${title} (already in cloud)`));
+            skipped++;
+            continue;
+        }
+        await cloud.turso.create('knowledge', system, knowledgeContent, 'active');
+        console.log(chalk.green(`   ✅ Pushed: ${title} (${domain})`));
+        migrated++;
+    }
+    console.log(chalk.blue(`\n📊 Push complete:`));
+    console.log(`   Pushed: ${migrated}`);
+    console.log(`   Skipped: ${skipped}`);
+    if (options.deleteLocal && migrated > 0) {
+        console.log(chalk.yellow('\n🗑️  Deleting local files (Cloud > Local)...'));
+        for (const { file } of files) {
+            fsSync.unlinkSync(file);
+            console.log(chalk.gray(`   Deleted: ${path.basename(file)}`));
+        }
+        // Clean up empty directories
+        if (fsSync.existsSync(domainsDir) && fsSync.readdirSync(domainsDir).length === 0) {
+            fsSync.rmdirSync(domainsDir);
+        }
+        const remaining = fsSync.readdirSync(knowledgeDir).filter(f => f.endsWith('.md'));
+        if (remaining.length === 0 && fsSync.existsSync(domainsDir) === false) {
+            // Only remove if truly empty (no registry.json, etc.)
+            const allFiles = fsSync.readdirSync(knowledgeDir);
+            if (allFiles.every(f => f === 'registry.json' || f.startsWith('.'))) {
+                console.log(chalk.green('\n✓ Local knowledge directory cleaned'));
+            }
+        }
+    }
+    else if (migrated > 0 && !options.deleteLocal) {
+        console.log(chalk.yellow('\n💡 Tip: Run with --delete-local to remove local files after push'));
+    }
+});
 // =============================================================================
 // QUICKSTART WIZARD
 // =============================================================================
@@ -1966,6 +2110,104 @@ wikiCmd
     }
 });
 // =============================================================================
+// BOOTSTRAP COMMAND
+// =============================================================================
+program
+    .command('bootstrap')
+    .description('Full project bootstrap: scaffold → index → docs → sync → gaps')
+    .requiredOption('-s, --system <system>', 'System identifier (PANEL, SWARMSCALE, etc.)')
+    .option('-n, --name <name>', 'Project name')
+    .option('-f, --force', 'Overwrite existing files')
+    .option('--phases <phases>', 'Phases to run (comma-separated: scan,scaffold,index,docs,sync,gaps)', 'scan,scaffold,index,docs,sync,gaps')
+    .option('--depth <depth>', 'Index depth: quick, standard, thorough', 'standard')
+    .option('--skip-agents', 'Skip installing standard agents')
+    .option('--skip-hooks', 'Skip installing hooks')
+    .option('--skip-commands', 'Skip installing commands')
+    .option('-v, --verbose', 'Show detailed progress')
+    .action(async (options) => {
+    const { BootstrapService } = await import('../services/BootstrapService.js');
+    const projectRoot = await getProjectRoot();
+    const bootstrap = new BootstrapService(projectRoot);
+    const phases = options.phases.split(',').map((p) => p.trim());
+    await bootstrap.run({
+        system: options.system.toUpperCase(),
+        projectName: options.name,
+        phases,
+        force: options.force,
+        skipAgents: options.skipAgents,
+        skipHooks: options.skipHooks,
+        skipCommands: options.skipCommands,
+        indexDepth: options.depth,
+        verbose: options.verbose,
+    });
+});
+// =============================================================================
+// GAPS COMMAND
+// =============================================================================
+program
+    .command('gaps')
+    .description('Analyze knowledge gaps in the project')
+    .requiredOption('-s, --system <system>', 'System identifier (PANEL, SWARMSCALE, etc.)')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const { KnowledgeGapDetector } = await import('../services/KnowledgeGapDetector.js');
+    const projectRoot = await getProjectRoot();
+    console.log(chalk.cyan('\n🔎 Analyzing Knowledge Gaps\n'));
+    const detector = new KnowledgeGapDetector(options.system.toUpperCase(), projectRoot);
+    const analysis = await detector.analyze();
+    if (options.json) {
+        console.log(JSON.stringify(analysis, null, 2));
+        return;
+    }
+    // Summary
+    console.log(chalk.white('  Coverage Scores:'));
+    console.log(`    Structure: ${analysis.coverage.structureCoverage}%`);
+    console.log(`    Patterns: ${analysis.coverage.patternCoverage}%`);
+    console.log(`    Integrations: ${analysis.coverage.integrationCoverage}%`);
+    console.log(chalk.cyan(`    Overall: ${analysis.coverage.overallScore}%`));
+    console.log();
+    // Gaps by severity
+    const bySeverity = {
+        critical: analysis.gaps.filter(g => g.severity === 'critical'),
+        high: analysis.gaps.filter(g => g.severity === 'high'),
+        medium: analysis.gaps.filter(g => g.severity === 'medium'),
+        low: analysis.gaps.filter(g => g.severity === 'low'),
+    };
+    if (bySeverity.critical.length > 0) {
+        console.log(chalk.red(`  🔴 Critical (${bySeverity.critical.length}):`));
+        for (const gap of bySeverity.critical) {
+            console.log(chalk.red(`    • ${gap.title}`));
+            console.log(chalk.gray(`      ${gap.suggestedAction}`));
+        }
+        console.log();
+    }
+    if (bySeverity.high.length > 0) {
+        console.log(chalk.yellow(`  🟠 High (${bySeverity.high.length}):`));
+        for (const gap of bySeverity.high) {
+            console.log(chalk.yellow(`    • ${gap.title}`));
+        }
+        console.log();
+    }
+    if (bySeverity.medium.length > 0) {
+        console.log(chalk.blue(`  🔵 Medium (${bySeverity.medium.length}):`));
+        for (const gap of bySeverity.medium.slice(0, 5)) {
+            console.log(chalk.blue(`    • ${gap.title}`));
+        }
+        if (bySeverity.medium.length > 5) {
+            console.log(chalk.dim(`    ... and ${bySeverity.medium.length - 5} more`));
+        }
+        console.log();
+    }
+    // Recommendations
+    if (analysis.recommendations.length > 0) {
+        console.log(chalk.white('  Recommendations:'));
+        for (const rec of analysis.recommendations) {
+            console.log(chalk.dim(`    ${rec}`));
+        }
+    }
+    console.log();
+});
+// =============================================================================
 // COMPLETION COMMAND
 // =============================================================================
 program
@@ -1977,7 +2219,8 @@ program
         'init', 'sync', 'validate', 'verify-hooks', 'generate', 'scan', 'improve',
         'status', 'dashboard', 'mcp', 'analytics', 'cross-analytics', 'feedback',
         'tasks', 'ideas', 'improvements', 'plan', 'capture', 'export',
-        'cloud', 'quickstart', 'doctor', 'opportunities', 'completion'
+        'cloud', 'quickstart', 'doctor', 'opportunities', 'wiki',
+        'bootstrap', 'gaps', 'completion'
     ];
     const subcommands = {
         cloud: ['status', 'init', 'improvements', 'tasks', 'session']