@nolrm/contextkit 0.7.3

package/lib/commands/check.js

@@ -0,0 +1,290 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+const yaml = require('js-yaml');
+
+class CheckCommand {
+  constructor() {
+    this.errors = [];
+    this.warnings = [];
+    this.info = [];
+  }
+
+  async run(options = {}) {
+    console.log(chalk.magenta('🔍 ContextKit Validation Check\n'));
+
+    if (!await fs.pathExists('.contextkit/config.yml')) {
+      console.log(chalk.red('❌ ContextKit not installed'));
+      console.log(chalk.yellow('   Run: contextkit install'));
+      return;
+    }
+
+    // Load config
+    const config = await this.loadConfig();
+    if (!config) {
+      return;
+    }
+
+    // Run checks
+    await this.checkManifest(config);
+    await this.checkRequiredFiles(config);
+    await this.checkOptionalFiles(config);
+    await this.checkStandardsFreshness(config);
+    await this.checkPolicyCompliance(config);
+    await this.checkPlatformIntegrations();
+
+    // Display results
+    this.displayResults(options);
+
+    // Exit with appropriate code
+    if (this.errors.length > 0) {
+      process.exit(1);
+    } else if (this.warnings.length > 0 && options.strict) {
+      process.exit(1);
+    }
+  }
+
+  async loadConfig() {
+    try {
+      const configContent = await fs.readFile('.contextkit/config.yml', 'utf-8');
+      return yaml.load(configContent);
+    } catch (error) {
+      this.errors.push('Failed to load config.yml: ' + error.message);
+      return null;
+    }
+  }
+
+  async checkManifest(config) {
+    // Check manifest schema
+    if (!config.vk) {
+      this.warnings.push('Manifest missing "vk" field (should be 1)');
+    }
+
+    if (!config.version) {
+      this.warnings.push('Manifest missing "version" field');
+    }
+
+    if (!config.updated) {
+      this.warnings.push('Manifest missing "updated" field');
+    }
+
+    if (!config.profile) {
+      this.warnings.push('Manifest missing "profile" field');
+    }
+
+    if (config.metadata) {
+      this.info.push(`Generated by: ${config.metadata.generated_by || 'unknown'}`);
+      if (config.metadata.generated_at) {
+        this.info.push(`Generated at: ${config.metadata.generated_at}`);
+      }
+    }
+  }
+
+  async checkRequiredFiles(config) {
+    if (!config.required || !Array.isArray(config.required)) {
+      this.warnings.push('No required files specified in config');
+      return;
+    }
+
+    for (const file of config.required) {
+      const filePath = `.contextkit/${file}`;
+      if (!await fs.pathExists(filePath)) {
+        this.errors.push(`Required file missing: ${file}`);
+      } else {
+        this.info.push(`✓ Required file exists: ${file}`);
+      }
+    }
+  }
+
+  async checkOptionalFiles(config) {
+    if (!config.optional || !Array.isArray(config.optional)) {
+      return;
+    }
+
+    for (const file of config.optional) {
+      const filePath = `.contextkit/${file}`;
+      if (!await fs.pathExists(filePath)) {
+        this.warnings.push(`Optional file missing: ${file}`);
+      }
+    }
+  }
+
+  async checkStandardsFreshness(config) {
+    // Load policy to get freshness threshold
+    let freshnessDays = 90; // default
+    try {
+      if (await fs.pathExists('.contextkit/policies/policy.yml')) {
+        const policyContent = await fs.readFile('.contextkit/policies/policy.yml', 'utf-8');
+        const policy = yaml.load(policyContent);
+        if (policy?.enforcement?.standards?.freshness_days) {
+          freshnessDays = policy.enforcement.standards.freshness_days;
+        }
+      }
+    } catch (error) {
+      // Policy file might not exist or be invalid, use default
+    }
+
+    // Check standards files
+    const standardsFiles = [
+      'standards/code-style.md',
+      'standards/testing.md',
+      'standards/architecture.md',
+      'standards/ai-guidelines.md',
+      'standards/workflows.md'
+    ];
+
+    for (const file of standardsFiles) {
+      const filePath = `.contextkit/${file}`;
+      if (await fs.pathExists(filePath)) {
+        const stats = await fs.stat(filePath);
+        const daysSinceUpdate = (Date.now() - stats.mtime.getTime()) / (1000 * 60 * 60 * 24);
+        
+        if (daysSinceUpdate > freshnessDays) {
+          this.warnings.push(
+            `Standards file outdated: ${file} (last updated ${Math.floor(daysSinceUpdate)} days ago, threshold: ${freshnessDays} days)`
+          );
+        }
+      }
+    }
+  }
+
+  async checkPolicyCompliance(config) {
+    try {
+      if (!await fs.pathExists('.contextkit/policies/policy.yml')) {
+        this.warnings.push('Policy file missing: policies/policy.yml');
+        return;
+      }
+
+      const policyContent = await fs.readFile('.contextkit/policies/policy.yml', 'utf-8');
+      const policy = yaml.load(policyContent);
+
+      if (!policy.enforcement) {
+        this.warnings.push('Policy file missing enforcement rules');
+        return;
+      }
+
+      // Check testing policy
+      if (policy.enforcement.testing) {
+        if (policy.enforcement.testing.numbered_cases === 'block') {
+          // Check if testing.md mentions numbered test cases
+          const testingPath = '.contextkit/standards/testing.md';
+          if (await fs.pathExists(testingPath)) {
+            const content = await fs.readFile(testingPath, 'utf-8');
+            if (!content.includes('numbered') && !content.includes('1., 2., 3.')) {
+              this.errors.push('Testing standards must require numbered test cases (policy: block)');
+            }
+          }
+        }
+      }
+
+      this.info.push('✓ Policy file exists and is valid');
+    } catch (error) {
+      this.warnings.push(`Policy check failed: ${error.message}`);
+    }
+  }
+
+  async checkPlatformIntegrations() {
+    const fs = require('fs-extra');
+
+    // Check for deprecated files and suggest modern alternatives
+    const deprecations = [
+      {
+        file: '.cursor/rules/contextkit.mdc',
+        message: 'Deprecated monolithic Cursor rule found. Run: ck cursor (creates scoped rules)',
+      },
+      {
+        file: '.codex/README.md',
+        bridge: 'AGENTS.md',
+        message: 'Legacy .codex/README.md found without AGENTS.md. Run: ck codex',
+      },
+      {
+        file: '.gemini/README.md',
+        bridge: 'GEMINI.md',
+        message: 'Legacy .gemini/README.md found without GEMINI.md. Run: ck gemini',
+      },
+      {
+        file: '.claude/README.md',
+        bridge: 'CLAUDE.md',
+        message: 'Legacy .claude/README.md found without CLAUDE.md. Run: ck claude',
+      },
+    ];
+
+    for (const dep of deprecations) {
+      if (await fs.pathExists(dep.file)) {
+        if (dep.bridge) {
+          if (!await fs.pathExists(dep.bridge)) {
+            this.warnings.push(dep.message);
+          }
+        } else {
+          this.warnings.push(dep.message);
+        }
+      }
+    }
+
+    // Check bridge file presence for common platforms
+    const bridgeChecks = [
+      { file: 'CLAUDE.md', platform: 'claude', label: 'Claude Code' },
+      { file: 'AGENTS.md', platform: 'codex', label: 'Codex CLI' },
+      { file: 'GEMINI.md', platform: 'gemini', label: 'Gemini CLI' },
+      { file: 'CONVENTIONS.md', platform: 'aider', label: 'Aider' },
+      { file: '.windsurfrules', platform: 'windsurf', label: 'Windsurf' },
+      { file: '.github/copilot-instructions.md', platform: 'copilot', label: 'GitHub Copilot' },
+    ];
+
+    let anyBridge = false;
+    for (const check of bridgeChecks) {
+      if (await fs.pathExists(check.file)) {
+        this.info.push(`✓ ${check.label} bridge file: ${check.file}`);
+        anyBridge = true;
+      }
+    }
+
+    if (!anyBridge) {
+      this.warnings.push('No platform bridge files found. Run: ck <platform> (e.g., ck claude, ck cursor)');
+    }
+  }
+
+  displayResults(options) {
+    console.log('─'.repeat(60));
+
+    if (this.errors.length > 0) {
+      console.log(chalk.red(`\n❌ Errors (${this.errors.length}):`));
+      this.errors.forEach(error => {
+        console.log(chalk.red(`  • ${error}`));
+      });
+    }
+
+    if (this.warnings.length > 0) {
+      console.log(chalk.yellow(`\n⚠️  Warnings (${this.warnings.length}):`));
+      this.warnings.forEach(warning => {
+        console.log(chalk.yellow(`  • ${warning}`));
+      });
+    }
+
+    if (this.info.length > 0 && options.verbose) {
+      console.log(chalk.blue(`\nℹ️  Info (${this.info.length}):`));
+      this.info.forEach(info => {
+        console.log(chalk.blue(`  • ${info}`));
+      });
+    }
+
+    console.log('\n' + '─'.repeat(60));
+
+    // Summary
+    if (this.errors.length === 0 && this.warnings.length === 0) {
+      console.log(chalk.green('\n✅ All checks passed!'));
+    } else if (this.errors.length === 0) {
+      console.log(chalk.yellow(`\n⚠️  ${this.warnings.length} warning(s) found (use --strict to fail on warnings)`));
+    } else {
+      console.log(chalk.red(`\n❌ ${this.errors.length} error(s) found`));
+    }
+  }
+}
+
+async function check(options) {
+  const cmd = new CheckCommand();
+  await cmd.run(options);
+}
+
+module.exports = check;
+

package/lib/commands/dashboard.js

@@ -0,0 +1,383 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+const yaml = require('js-yaml');
+const http = require('http');
+const { execSync } = require('child_process');
+
+class DashboardCommand {
+  constructor() {
+    this.port = 3001;
+    this.metrics = {};
+  }
+
+  async run(options = {}) {
+    console.log(chalk.magenta('📊 Starting ContextKit Dashboard\n'));
+
+    if (!await fs.pathExists('.contextkit/config.yml')) {
+      console.log(chalk.red('❌ ContextKit not installed'));
+      console.log(chalk.yellow('   Run: contextkit install'));
+      return;
+    }
+
+    // Collect metrics
+    await this.collectMetrics();
+
+    // Start server
+    if (options.server !== false) {
+      this.startServer(options.port || this.port);
+    } else {
+      // Just display metrics
+      this.displayMetrics();
+    }
+  }
+
+  async collectMetrics() {
+    this.metrics = {
+      standards: {},
+      corrections: {},
+      policy: {},
+      freshness: {},
+      files: {}
+    };
+
+    // Load config
+    const config = await this.loadConfig();
+    this.metrics.config = config;
+
+    // Check standards files
+    const standardsFiles = [
+      'standards/code-style.md',
+      'standards/testing.md',
+      'standards/architecture.md',
+      'standards/ai-guidelines.md',
+      'standards/workflows.md',
+      'standards/glossary.md'
+    ];
+
+    for (const file of standardsFiles) {
+      const filePath = `.contextkit/${file}`;
+      if (await fs.pathExists(filePath)) {
+        const stats = await fs.stat(filePath);
+        const daysSinceUpdate = (Date.now() - stats.mtime.getTime()) / (1000 * 60 * 60 * 24);
+        
+        this.metrics.standards[file] = {
+          exists: true,
+          lastModified: stats.mtime.toISOString(),
+          daysSinceUpdate: Math.floor(daysSinceUpdate),
+          size: stats.size
+        };
+      } else {
+        this.metrics.standards[file] = {
+          exists: false
+        };
+      }
+    }
+
+    // Parse corrections log
+    if (await fs.pathExists('.contextkit/corrections.md')) {
+      const correctionsContent = await fs.readFile('.contextkit/corrections.md', 'utf-8');
+      
+      // Count sessions
+      const sessionMatches = correctionsContent.matchAll(/### (\d{4}-\d{2}-\d{2})/g);
+      const sessions = Array.from(sessionMatches);
+      this.metrics.corrections.totalSessions = sessions.length;
+
+      // Count rule updates
+      const ruleUpdateMatches = correctionsContent.matchAll(/#### Rule Updates[\s\S]*?(?=####|###|##|$)/g);
+      let ruleUpdates = 0;
+      for (const match of ruleUpdateMatches) {
+        const updates = match[0].match(/^-/gm);
+        if (updates) ruleUpdates += updates.length;
+      }
+      this.metrics.corrections.ruleUpdates = ruleUpdates;
+
+      // Count AI behavior issues
+      const behaviorMatches = correctionsContent.matchAll(/\[HIGH\]/g);
+      const mediumMatches = correctionsContent.matchAll(/\[MEDIUM\]/g);
+      const lowMatches = correctionsContent.matchAll(/\[LOW\]/g);
+      
+      this.metrics.corrections.highPriority = Array.from(behaviorMatches).length;
+      this.metrics.corrections.mediumPriority = Array.from(mediumMatches).length;
+      this.metrics.corrections.lowPriority = Array.from(lowMatches).length;
+    }
+
+    // Load policy
+    if (await fs.pathExists('.contextkit/policies/policy.yml')) {
+      const policyContent = await fs.readFile('.contextkit/policies/policy.yml', 'utf-8');
+      this.metrics.policy = yaml.load(policyContent);
+    }
+
+    // Check product context
+    const productFiles = [
+      'product/mission.md',
+      'product/roadmap.md',
+      'product/decisions.md',
+      'product/context.md'
+    ];
+
+    for (const file of productFiles) {
+      const filePath = `.contextkit/${file}`;
+      this.metrics.files[file] = await fs.pathExists(filePath);
+    }
+  }
+
+  async loadConfig() {
+    try {
+      const configContent = await fs.readFile('.contextkit/config.yml', 'utf-8');
+      return yaml.load(configContent);
+    } catch (error) {
+      return {};
+    }
+  }
+
+  displayMetrics() {
+    console.log(chalk.blue('\n📊 ContextKit Metrics\n'));
+    console.log('─'.repeat(60));
+
+    // Standards freshness
+    console.log(chalk.bold('\n📚 Standards Freshness:'));
+    const standards = Object.entries(this.metrics.standards);
+    const existing = standards.filter(([_, data]) => data.exists);
+    const outdated = existing.filter(([_, data]) => data.daysSinceUpdate > 90);
+    
+    console.log(chalk.green(`   ${existing.length}/${standards.length} standards files exist`));
+    if (outdated.length > 0) {
+      console.log(chalk.yellow(`   ⚠️  ${outdated.length} files outdated (>90 days)`));
+      outdated.forEach(([file, data]) => {
+        console.log(chalk.dim(`      - ${file}: ${data.daysSinceUpdate} days old`));
+      });
+    }
+
+    // Corrections log
+    if (this.metrics.corrections.totalSessions > 0) {
+      console.log(chalk.bold('\n📝 Corrections Log:'));
+      console.log(chalk.cyan(`   Total Sessions: ${this.metrics.corrections.totalSessions}`));
+      console.log(chalk.cyan(`   Rule Updates: ${this.metrics.corrections.ruleUpdates || 0}`));
+      console.log(chalk.red(`   High Priority Issues: ${this.metrics.corrections.highPriority || 0}`));
+      console.log(chalk.yellow(`   Medium Priority Issues: ${this.metrics.corrections.mediumPriority || 0}`));
+      console.log(chalk.green(`   Low Priority Issues: ${this.metrics.corrections.lowPriority || 0}`));
+    }
+
+    // Product context
+    console.log(chalk.bold('\n📦 Product Context:'));
+    const productFiles = Object.entries(this.metrics.files);
+    const existingProduct = productFiles.filter(([_, exists]) => exists);
+    console.log(chalk.cyan(`   ${existingProduct.length}/${productFiles.length} product files exist`));
+
+    // Policy
+    if (this.metrics.policy.enforcement) {
+      console.log(chalk.bold('\n⚖️  Policy Enforcement:'));
+      const enforcement = this.metrics.policy.enforcement;
+      if (enforcement.testing) {
+        console.log(chalk.cyan(`   Testing: ${enforcement.testing.numbered_cases || 'not set'}`));
+      }
+    }
+
+    console.log('\n' + '─'.repeat(60));
+  }
+
+  startServer(port) {
+    const server = http.createServer((req, res) => {
+      if (req.url === '/' || req.url === '/index.html') {
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(this.generateDashboardHTML());
+      } else if (req.url === '/api/metrics') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(this.metrics, null, 2));
+      } else {
+        res.writeHead(404);
+        res.end('Not found');
+      }
+    });
+
+    server.listen(port, () => {
+      console.log(chalk.green(`\n✅ Dashboard running at http://localhost:${port}`));
+      console.log(chalk.blue('   Press Ctrl+C to stop\n'));
+      
+      // Try to open browser
+      try {
+        const platform = process.platform;
+        const command = platform === 'darwin' ? 'open' : platform === 'win32' ? 'start' : 'xdg-open';
+        execSync(`${command} http://localhost:${port}`);
+      } catch (error) {
+        // Ignore if can't open browser
+      }
+    });
+  }
+
+  generateDashboardHTML() {
+    const metrics = this.metrics;
+    const standardsCount = Object.values(metrics.standards).filter(s => s.exists).length;
+    const totalStandards = Object.keys(metrics.standards).length;
+    const freshnessPercent = Math.round((standardsCount / totalStandards) * 100);
+    
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>ContextKit Dashboard</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            padding: 20px;
+            min-height: 100vh;
+        }
+        .container {
+            max-width: 1200px;
+            margin: 0 auto;
+        }
+        h1 {
+            color: white;
+            margin-bottom: 30px;
+            text-align: center;
+            font-size: 2.5em;
+        }
+        .grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+            gap: 20px;
+            margin-bottom: 20px;
+        }
+        .card {
+            background: white;
+            border-radius: 10px;
+            padding: 20px;
+            box-shadow: 0 4px 6px rgba(0,0,0,0.1);
+        }
+        .card h2 {
+            color: #333;
+            margin-bottom: 15px;
+            font-size: 1.3em;
+        }
+        .stat {
+            font-size: 2.5em;
+            font-weight: bold;
+            color: #667eea;
+            margin: 10px 0;
+        }
+        .stat-label {
+            color: #666;
+            font-size: 0.9em;
+        }
+        .progress-bar {
+            width: 100%;
+            height: 30px;
+            background: #e0e0e0;
+            border-radius: 15px;
+            overflow: hidden;
+            margin: 10px 0;
+        }
+        .progress-fill {
+            height: 100%;
+            background: linear-gradient(90deg, #667eea, #764ba2);
+            transition: width 0.3s ease;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: white;
+            font-weight: bold;
+        }
+        .list {
+            list-style: none;
+        }
+        .list li {
+            padding: 8px 0;
+            border-bottom: 1px solid #eee;
+        }
+        .list li:last-child {
+            border-bottom: none;
+        }
+        .badge {
+            display: inline-block;
+            padding: 4px 8px;
+            border-radius: 4px;
+            font-size: 0.8em;
+            font-weight: bold;
+        }
+        .badge-success { background: #4caf50; color: white; }
+        .badge-warning { background: #ff9800; color: white; }
+        .badge-danger { background: #f44336; color: white; }
+        .badge-info { background: #2196f3; color: white; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>🎵 ContextKit Dashboard</h1>
+        
+        <div class="grid">
+            <div class="card">
+                <h2>📚 Standards Freshness</h2>
+                <div class="stat">${freshnessPercent}%</div>
+                <div class="stat-label">${standardsCount} of ${totalStandards} files exist</div>
+                <div class="progress-bar">
+                    <div class="progress-fill" style="width: ${freshnessPercent}%">${freshnessPercent}%</div>
+                </div>
+            </div>
+            
+            <div class="card">
+                <h2>📝 Corrections Log</h2>
+                <div class="stat">${metrics.corrections.totalSessions || 0}</div>
+                <div class="stat-label">Total Sessions</div>
+                <ul class="list">
+                    <li><span class="badge badge-danger">HIGH</span> ${metrics.corrections.highPriority || 0} issues</li>
+                    <li><span class="badge badge-warning">MEDIUM</span> ${metrics.corrections.mediumPriority || 0} issues</li>
+                    <li><span class="badge badge-success">LOW</span> ${metrics.corrections.lowPriority || 0} issues</li>
+                    <li><span class="badge badge-info">Updates</span> ${metrics.corrections.ruleUpdates || 0} rule updates</li>
+                </ul>
+            </div>
+            
+            <div class="card">
+                <h2>📦 Product Context</h2>
+                <ul class="list">
+                    ${Object.entries(metrics.files).map(([file, exists]) => 
+                        `<li>${exists ? '✅' : '❌'} ${file.split('/').pop()}</li>`
+                    ).join('')}
+                </ul>
+            </div>
+            
+            <div class="card">
+                <h2>⚖️ Policy</h2>
+                ${metrics.policy.enforcement ? `
+                    <ul class="list">
+                        ${metrics.policy.enforcement.testing ? 
+                            `<li>Testing: <span class="badge badge-info">${metrics.policy.enforcement.testing.numbered_cases || 'not set'}</span></li>` : ''}
+                        ${metrics.policy.enforcement.code_style ? 
+                            `<li>Code Style: <span class="badge badge-info">${metrics.policy.enforcement.code_style.typescript_strict || 'not set'}</span></li>` : ''}
+                    </ul>
+                ` : '<p>No policy configured</p>'}
+            </div>
+        </div>
+        
+        <div class="card">
+            <h2>📊 Standards Files</h2>
+            <ul class="list">
+                ${Object.entries(metrics.standards).map(([file, data]) => {
+                    if (!data.exists) return `<li>❌ ${file}</li>`;
+                    const days = data.daysSinceUpdate || 0;
+                    const badge = days > 90 ? 'badge-warning' : days > 30 ? 'badge-info' : 'badge-success';
+                    return `<li>✅ ${file} <span class="badge ${badge}">${days} days old</span></li>`;
+                }).join('')}
+            </ul>
+        </div>
+    </div>
+    
+    <script>
+        // Auto-refresh every 30 seconds
+        setTimeout(() => location.reload(), 30000);
+    </script>
+</body>
+</html>`;
+  }
+}
+
+async function dashboard(options) {
+  const cmd = new DashboardCommand();
+  await cmd.run(options);
+}
+
+module.exports = dashboard;
+