@nolrm/contextkit 0.12.22 → 0.13.1

package/README.md

@@ -128,11 +128,6 @@ codex "create checkout flow for customer"
 opencode "create checkout flow for customer"
 ```
 
-**CLI** (Chat with AI)
-```bash
-ck ai "create a button"
-```
-
 ---
 
 ## Slash Commands
@@ -148,7 +143,7 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/test` | Generate comprehensive tests |
 | `/doc` | Add documentation |
 | `/spec` | Write a component spec (MD-first) before any code is created |
-| `/squad` | Kick off a squad task — one task or many (auto-detects batch mode) |
+| `/squad` | Kick off a squad task — one task or many (auto-detects batch mode). Pushes back with clarifying questions if the task is vague. |
 | `/squad-architect` | Design the technical plan from the PO spec |
 | `/squad-dev` | Implement code following the architect plan |
 | `/squad-test` | Write and run tests against acceptance criteria |
@@ -173,7 +168,7 @@ The squad workflow turns a single AI session into a structured multi-role pipeli
 
 | Step | Role | Command | What it does |
 |------|------|---------|-------------|
-| 1 | Product Owner | `/squad` | Writes a user story, acceptance criteria, edge cases, and scope. Optionally captures screenshots/images as visual assets. |
+| 1 | Product Owner | `/squad` | Writes a user story, acceptance criteria, edge cases, and scope. If the task is ambiguous, asks up to 5 clarifying questions before writing the spec. Optionally captures screenshots/images as visual assets. |
 | 2 | Architect | `/squad-architect` | Designs the technical approach, files to change, and implementation steps |
 | 3 | Developer | `/squad-dev` | Implements the code following the architect's plan |
 | 4 | Tester | `/squad-test` | Writes and runs tests against the PO's acceptance criteria |
@@ -275,7 +270,7 @@ When the `commit-msg` hook is enabled, all commits must follow this format:
 <type>(<scope>): <description>
 ```
 
-**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+**Types:** `feat`, `fix`, `improve`, `docs`, `style`, `refactor`, `test`, `chore`
 
 **Examples:**
 ```bash
@@ -299,7 +294,6 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 - ⚡ **Zero Config** - Auto-detects project type and package manager
 - ✅ **Policy Enforcement** - Configurable validation with `ck check`
 - 📝 **Corrections Tracking** - Track AI performance issues with corrections log
-- 📊 **Observability Dashboard** - Visual metrics and compliance tracking
 
 ## Commands
 
@@ -337,9 +331,6 @@ ck note "AI issue" --category "AI Behavior" --priority HIGH
 /squad-auto              # runs architect → dev → test → review → doc hands-free
 /squad-reset             # clear stuck or mixed squad state
 
-# Observability
-ck dashboard   # start web dashboard
-ck dashboard --no-server  # CLI metrics only
 ```
 
 ## Links

package/bin/contextkit.js

@@ -4,13 +4,10 @@ const { program } = require('commander');
 const chalk = require('chalk');
 const { install, update, status } = require('../lib');
 const analyze = require('../lib/commands/analyze');
-const ai = require('../lib/commands/ai');
 const check = require('../lib/commands/check');
 const note = require('../lib/commands/note');
 const run = require('../lib/commands/run');
-const publish = require('../lib/commands/publish');
-const pull = require('../lib/commands/pull');
-const dashboard = require('../lib/commands/dashboard');
+
 const packageJson = require('../package.json');
 const { checkForUpdates } = require('../lib/utils/notifier');
 
@@ -81,20 +78,6 @@ program
     }
   });
 
-// AI command with "ai" keyword
-program
-  .command('ai <prompt>')
-  .description('Chat with AI using ContextKit context')
-  .option('--ai <tool>', 'AI tool to use (aider, claude, gemini)')
-  .action(async (prompt, options) => {
-    try {
-      await ai(prompt, options);
-    } catch (error) {
-      console.error(chalk.red('AI chat failed:'), error.message);
-      process.exit(1);
-    }
-  });
-
 // Check command
 program
   .command('check')
@@ -141,51 +124,6 @@ program
     }
   });
 
-// Publish command
-program
-  .command('publish')
-  .description('Publish current ContextKit configuration to registry')
-  .option('--name <name>', 'Package name (e.g., @company/react-standards)')
-  .option('--version <version>', 'Version (e.g., 1.0.0)')
-  .action(async (options) => {
-    try {
-      await publish(options);
-    } catch (error) {
-      console.error(chalk.red('Publish failed:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Pull command
-program
-  .command('pull <package>')
-  .description('Pull ContextKit configuration from registry')
-  .option('--force', 'Force overwrite existing .contextkit')
-  .option('--backup', 'Backup existing .contextkit before pulling')
-  .action(async (packageSpec, options) => {
-    try {
-      await pull(packageSpec, options);
-    } catch (error) {
-      console.error(chalk.red('Pull failed:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Dashboard command
-program
-  .command('dashboard')
-  .description('Start observability dashboard')
-  .option('--port <port>', 'Port number', '3001')
-  .option('--no-server', 'Display metrics only (no web server)')
-  .action(async (options) => {
-    try {
-      await dashboard(options);
-    } catch (error) {
-      console.error(chalk.red('Dashboard failed:'), error.message);
-      process.exit(1);
-    }
-  });
-
 // Platform-specific install commands
 program
   .command('cursor')
@@ -317,23 +255,11 @@ program
     }
   });
 
-// Catch-all for unknown commands (treats them as prompts)
-// This MUST be registered AFTER all commands but BEFORE parse()
+// Catch-all for unknown commands
 program.on('command:*', function(args) {
-  // The command wasn't found, treat it as a prompt
-  const prompt = args.join(' ');
-
-  if (prompt) {
-    try {
-      ai(prompt, {}).catch(error => {
-        console.error(chalk.red('AI chat failed:'), error.message);
-        process.exit(1);
-      });
-    } catch (error) {
-      console.error(chalk.red('AI chat failed:'), error.message);
-      process.exit(1);
-    }
-  }
+  console.error(chalk.red(`Unknown command: ${args[0]}`));
+  console.log(chalk.yellow('Run `ck --help` to see available commands.'));
+  process.exit(1);
 });
 
 // Parse command line arguments

package/lib/commands/install.js

@@ -995,6 +995,7 @@ _source:
   version: "${require('../../package.json').version}"
   npm: "https://www.npmjs.com/package/@nolrm/contextkit"
 ck: 1
+format_version: 1
 version: "${config.version}"
 updated: "${now.split('T')[0]}"
 project_name: "${config.project_name}"
@@ -1621,7 +1622,6 @@ enforcement:
     console.log(chalk.bold('📖 Quick Reference'));
     console.log(''.padEnd(48, '─'));
     console.log(`ck status    → Check installation & integrations`);
-    console.log(`ck ai <cmd>  → Use AI with project context`);
     console.log(`ck <platform> → Add platform (claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf)`);
     console.log('');
     console.log(`Docs → ${chalk.blue('https://contextkit-docs.vercel.app')}`);
@@ -1667,7 +1667,7 @@ enforcement:
     }
 
     console.log(chalk.bold('In CLI'));
-    console.log(`ck ai "create a Button component for customer checkout"`);
+    console.log(chalk.dim('Use your AI tool\'s slash command, e.g. /analyze or @.contextkit/commands/create-component.md'));
     console.log('');
 
     if (platform === 'claude' || platform === 'gemini') {

package/lib/commands/update.js

@@ -6,6 +6,7 @@ const path = require('path');
 const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
 const GitHooksManager = require('../utils/git-hooks');
+const MigrationRunner = require('../utils/migrations');
 const { printBanner } = require('../utils/banner');
 
 class UpdateCommand {
@@ -44,6 +45,14 @@ class UpdateCommand {
     try {
       // Detect current configuration
       const config = await this.parseConfig();
+
+      // Run any pending format migrations before touching files
+      const migrations = new MigrationRunner();
+      await migrations.run(config.format_version, '.contextkit/config.yml');
+      // Re-read so format_version is current after migration
+      const migratedConfig = await this.parseConfig();
+      Object.assign(config, migratedConfig);
+
       const projectType = this.projectDetector.detectProjectType();
       const packageManager = this.projectDetector.detectPackageManager();
 
@@ -163,7 +172,9 @@ class UpdateCommand {
     const lines = configContent.split('\n');
     for (const line of lines) {
       const trimmed = line.trim();
-      if (trimmed.startsWith('version:')) {
+      if (trimmed.startsWith('format_version:')) {
+        config.format_version = parseInt(trimmed.split('format_version:')[1].trim(), 10);
+      } else if (trimmed.startsWith('version:')) {
         config.version = trimmed.split('version:')[1].trim().replace(/"/g, '');
       } else if (trimmed.startsWith('project_name:')) {
         config.project_name = trimmed.split('project_name:')[1].trim().replace(/"/g, '');
@@ -357,6 +368,7 @@ class UpdateCommand {
   async restoreUserConfig(config) {
     // Restore user's project-specific configuration
     const configContent = `# ContextKit Configuration
+format_version: ${config.format_version || 1}
 version: "${config.version}"
 project_name: "${config.project_name}"
 project_type: "${config.project_type}"

package/lib/utils/migrations.js

@@ -0,0 +1,50 @@
+const chalk = require('chalk');
+const fs = require('fs-extra');
+
+// Increment this when a new migration step is added.
+const CURRENT_FORMAT_VERSION = 1;
+
+class MigrationRunner {
+  /**
+   * Run all pending migrations from currentVersion up to CURRENT_FORMAT_VERSION.
+   * @param {number|undefined} currentVersion - parsed from config.yml format_version field
+   * @param {string} configPath - path to config.yml
+   */
+  async run(currentVersion, configPath) {
+    const from = (currentVersion === undefined || currentVersion === null) ? 0 : currentVersion;
+
+    if (from > CURRENT_FORMAT_VERSION) {
+      console.log(chalk.yellow(
+        `⚠️  .contextkit/ format version (${from}) is newer than this version of ContextKit (${CURRENT_FORMAT_VERSION}). Skipping migration.`
+      ));
+      return;
+    }
+
+    if (from === CURRENT_FORMAT_VERSION) {
+      return; // Nothing to do
+    }
+
+    for (let v = from; v < CURRENT_FORMAT_VERSION; v++) {
+      const next = v + 1;
+      console.log(chalk.blue(`  Migrating .contextkit/ format from v${v} to v${next}...`));
+
+      if (v === 0) await this._migrate_0_to_1(configPath);
+
+      console.log(chalk.green(`  ✓ Format migrated to v${next}`));
+    }
+  }
+
+  // ── Migrations ──────────────────────────────────────────────────────────────
+
+  async _migrate_0_to_1(configPath) {
+    const content = await fs.readFile(configPath, 'utf8');
+    if (content.includes('format_version:')) {
+      // Update existing value to 1
+      await fs.writeFile(configPath, content.replace(/^format_version:.*$/m, 'format_version: 1'));
+    } else {
+      await fs.writeFile(configPath, content.trimEnd() + '\nformat_version: 1\n');
+    }
+  }
+}
+
+module.exports = MigrationRunner;

package/lib/utils/migrations.md

@@ -0,0 +1,58 @@
+# migrations.js
+
+Format migration runner for the `.contextkit/` directory.
+
+## Purpose
+
+Detects when an installed `.contextkit/` directory uses an older format version and runs the appropriate migration steps to bring it up to date. Called by `ck update` before any files are downloaded or rewritten.
+
+## Exports
+
+`MigrationRunner` — class
+
+## Public API
+
+### `new MigrationRunner()`
+
+No constructor arguments.
+
+### `async run(currentVersion, configPath)`
+
+Runs all pending migrations from `currentVersion` up to `CURRENT_FORMAT_VERSION`.
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `currentVersion` | `number \| undefined \| null` | Value of `format_version` from config.yml. `undefined`/`null` is treated as `0` (pre-1.0.0 install). |
+| `configPath` | `string` | Absolute or relative path to `.contextkit/config.yml`. |
+
+**Behaviour:**
+- If `currentVersion` is missing/null → treated as `0`, runs v0→v1
+- If `currentVersion === CURRENT_FORMAT_VERSION` → no-op
+- If `currentVersion > CURRENT_FORMAT_VERSION` → logs warning, returns without modifying config
+- Prints progress to console for each step
+
+## Constants
+
+`CURRENT_FORMAT_VERSION = 1` — increment when a new migration step is added.
+
+## Adding a Future Migration
+
+1. Increment `CURRENT_FORMAT_VERSION`
+2. Add `if (v === N) await this._migrate_N_to_N1(configPath);` inside the loop in `run()`
+3. Implement `_migrate_N_to_N1(configPath)` as a private method
+4. Add test cases in `__tests__/utils/migrations.test.js`
+
+## Usage Example
+
+```js
+const MigrationRunner = require('../utils/migrations');
+
+const migrations = new MigrationRunner();
+await migrations.run(config.format_version, '.contextkit/config.yml');
+```
+
+## Edge Cases & Notes
+
+- Migrations are idempotent — safe to run twice
+- The `ck update` backup is created before migrations run, so any failure can be rolled back
+- `format_version: 0` (explicit) and missing `format_version` are both treated as v0

package/lib/utils/tool-detector.js

@@ -29,6 +29,7 @@ class ToolDetector {
       claude_cli: await this.detectCLITool('claude'),
       gemini_cli: await this.detectCLITool('gemini'),
       codex_cli: await this.detectCLITool('codex'),
+      opencode_cli: await this.detectCLITool('opencode'),
     };
 
     return this.detectedTools;
@@ -120,6 +121,7 @@ class ToolDetector {
       'claude_cli',  // Good CLI
       'gemini_cli',  // Alternative CLI
       'codex_cli',   // OpenAI Codex CLI
+      'opencode_cli', // OpenCode CLI
     ];
 
     return priority.filter(tool => detected[tool]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.12.22",
+  "version": "0.13.1",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {
@@ -60,7 +60,7 @@
     "url": "https://github.com/nolrm/contextkit/issues"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "dependencies": {
     "axios": "^1.6.0",

package/lib/commands/ai.js

@@ -1,147 +0,0 @@
-const chalk = require('chalk');
-const ora = require('ora');
-const fs = require('fs-extra');
-const { execSync } = require('child_process');
-
-class AICommand {
-  async run(prompt, options = {}) {
-    if (!prompt) {
-      console.log(chalk.red('❌ Please provide a prompt'));
-      console.log(chalk.blue('   Usage: contextkit ai "your prompt here"'));
-      return;
-    }
-
-    // Check if contextkit is installed
-    if (!await fs.pathExists('.contextkit/context.md')) {
-      console.log(chalk.red('❌ ContextKit not initialized.'));
-      console.log(chalk.yellow('   Run: contextkit install'));
-      return;
-    }
-
-    // Get AI tool preference
-    const aiTool = options.ai || process.env.AI_TOOL || 'display';
-
-    const spinner = ora('Loading ContextKit context...').start();
-
-    try {
-      // Load context
-      const context = await fs.readFile('.contextkit/context.md', 'utf-8');
-      const standards = await this.loadStandards();
-
-      spinner.succeed('Context loaded\n');
-
-      // Prepare full prompt
-      const fullPrompt = `${context}\n\n## Project Standards\n\n${standards}\n\n## User Request\n\n${prompt}`;
-
-      // Execute with AI tool
-      await this.executeWithAI(fullPrompt, aiTool, prompt);
-
-    } catch (error) {
-      spinner.fail('Failed to load context');
-      console.log(chalk.red(error.message));
-    }
-  }
-
-  async loadStandards() {
-    const standards = {
-      codeStyle: '',
-      testing: '',
-      architecture: '',
-      guidelines: ''
-    };
-
-    try {
-      if (await fs.pathExists('.contextkit/standards/code-style.md')) {
-        standards.codeStyle = await fs.readFile('.contextkit/standards/code-style.md', 'utf-8');
-      }
-      if (await fs.pathExists('.contextkit/standards/testing.md')) {
-        standards.testing = await fs.readFile('.contextkit/standards/testing.md', 'utf-8');
-      }
-      if (await fs.pathExists('.contextkit/standards/architecture.md')) {
-        standards.architecture = await fs.readFile('.contextkit/standards/architecture.md', 'utf-8');
-      }
-      if (await fs.pathExists('.contextkit/standards/ai-guidelines.md')) {
-        standards.guidelines = await fs.readFile('.contextkit/standards/ai-guidelines.md', 'utf-8');
-      }
-    } catch (error) {
-      console.log(chalk.yellow('⚠️  Some standards files not found'));
-    }
-
-    return `Code Style: ${standards.codeStyle.substring(0, 500)}...\n\nTesting: ${standards.testing.substring(0, 500)}...\n\nArchitecture: ${standards.architecture.substring(0, 500)}...\n\nGuidelines: ${standards.guidelines.substring(0, 500)}...`;
-  }
-
-  async executeWithAI(fullPrompt, aiTool, userPrompt) {
-    console.log(chalk.blue(`🤖 Using AI tool: ${aiTool}\n`));
-
-    switch(aiTool) {
-      case 'aider':
-        await this.executeWithAider(userPrompt);
-        break;
-      case 'claude':
-        await this.executeWithClaude(userPrompt, fullPrompt);
-        break;
-      case 'gemini':
-        await this.executeWithGemini(userPrompt, fullPrompt);
-        break;
-      case 'display':
-      default:
-        this.displayPrompt(fullPrompt, aiTool);
-        break;
-    }
-  }
-
-  async executeWithAider(prompt) {
-    console.log(chalk.green('🚀 Starting Aider...\n'));
-    console.log(chalk.blue('💡 Aider will use .aider/rules.md for context\n'));
-    console.log(chalk.yellow(`Prompt: ${prompt}\n`));
-    console.log('─'.repeat(60));
-    try {
-      execSync(`echo "${prompt}" | aider`, { stdio: 'inherit' });
-    } catch (error) {
-      console.log(chalk.red(`Aider error: ${error.message}`));
-      console.log(chalk.yellow('💡 Make sure Aider is installed and in your PATH'));
-    }
-  }
-
-  async executeWithClaude(prompt, context) {
-    console.log(chalk.green('🚀 Starting Claude CLI...\n'));
-    console.log('─'.repeat(60));
-    try {
-      execSync(`echo "${context}\n\nUser: ${prompt}" | claude`, { stdio: 'inherit' });
-    } catch (error) {
-      console.log(chalk.red(`Claude error: ${error.message}`));
-      console.log(chalk.yellow('💡 Make sure Claude CLI is installed'));
-    }
-  }
-
-  async executeWithGemini(prompt, context) {
-    console.log(chalk.green('🚀 Starting Gemini CLI...\n'));
-    console.log('─'.repeat(60));
-    try {
-      execSync(`echo "${context}\n\nUser: ${prompt}" | gemini`, { stdio: 'inherit' });
-    } catch (error) {
-      console.log(chalk.red(`Gemini error: ${error.message}`));
-      console.log(chalk.yellow('💡 Make sure Gemini CLI is installed'));
-    }
-  }
-
-  displayPrompt(fullPrompt, aiTool) {
-    console.log(chalk.yellow('\n📝 Full Prompt (display mode):\n'));
-    console.log('─'.repeat(60));
-    console.log(fullPrompt);
-    console.log('─'.repeat(60));
-
-    console.log(chalk.blue('\n💡 To execute with AI:'));
-    console.log('   Set AI_TOOL environment variable:');
-    console.log('   export AI_TOOL=aider && contextkit ai "your prompt"');
-    console.log('   export AI_TOOL=claude && contextkit ai "your prompt"');
-    console.log('   export AI_TOOL=gemini && contextkit ai "your prompt"\n');
-  }
-}
-
-async function ai(prompt, options) {
-  const cmd = new AICommand();
-  await cmd.run(prompt, options);
-}
-
-module.exports = ai;

package/lib/commands/dashboard.js

@@ -1,383 +0,0 @@
-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;
-

package/lib/commands/publish.js

@@ -1,184 +0,0 @@
-const chalk = require('chalk');
-const fs = require('fs-extra');
-const path = require('path');
-const yaml = require('js-yaml');
-const { execSync } = require('child_process');
-
-class PublishCommand {
-  constructor() {
-    this.registryPath = path.join(process.env.HOME || process.env.USERPROFILE, '.contextkit-registry');
-  }
-
-  async run(options = {}) {
-    console.log(chalk.magenta('📦 Publishing ContextKit Configuration\n'));
-
-    // Check if .contextkit exists
-    if (!await fs.pathExists('.contextkit/config.yml')) {
-      console.log(chalk.red('❌ ContextKit not installed in this directory'));
-      console.log(chalk.yellow('   Run: contextkit install'));
-      return;
-    }
-
-    // Get package name and version
-    const name = options.name || await this.promptName();
-    const version = options.version || await this.promptVersion();
-    
-    if (!name || !version) {
-      console.log(chalk.red('❌ Package name and version are required'));
-      return;
-    }
-
-    // Validate version format
-    if (!/^\d+\.\d+\.\d+$/.test(version)) {
-      console.log(chalk.red('❌ Invalid version format. Use semantic versioning (e.g., 1.0.0)'));
-      return;
-    }
-
-    // Create registry structure
-    await this.ensureRegistry();
-
-    // Create package directory
-    const packageDir = path.join(this.registryPath, name.replace('@', '').replace('/', '-'), version);
-    await fs.ensureDir(packageDir);
-
-    // Copy .contextkit files (exclude some)
-    const excludePatterns = [
-      'corrections.md',
-      'status.json',
-      'node_modules',
-      '.git'
-    ];
-
-    await this.copyContextKitFiles('.contextkit', packageDir, excludePatterns);
-
-    // Create package.json for the published package
-    const config = await this.loadConfig();
-    const packageJson = {
-      name: name,
-      version: version,
-      description: `ContextKit configuration for ${config.project_name || 'project'}`,
-      contextKit: {
-        ck: config.ck || 1,
-        profile: config.profile,
-        generated_at: new Date().toISOString(),
-        published_at: new Date().toISOString()
-      },
-      files: [
-        '**/*.md',
-        '**/*.yml',
-        '**/*.yaml',
-        '**/*.ts',
-        '**/*.tsx',
-        '**/*.sh'
-      ]
-    };
-
-    await fs.writeJson(path.join(packageDir, 'package.json'), packageJson, { spaces: 2 });
-
-    // Create README
-    const readme = `# ${name} v${version}
-
-ContextKit configuration package.
-
-## Installation
-
-\`\`\`bash
-contextkit pull ${name}@${version}
-\`\`\`
-
-## Contents
-
-This package includes:
-- Standards files
-- Templates
-- Commands
-- Product context
-- Policies
-
-## Version
-
-${version} - Published ${new Date().toISOString().split('T')[0]}
-`;
-
-    await fs.writeFile(path.join(packageDir, 'README.md'), readme);
-
-    console.log(chalk.green(`\n✅ Published ${name}@${version}`));
-    console.log(chalk.dim(`   Location: ${packageDir}`));
-    console.log(chalk.blue(`\n💡 To use: contextkit pull ${name}@${version}`));
-  }
-
-  async promptName() {
-    const readline = require('readline').createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    return new Promise((resolve) => {
-      readline.question(chalk.yellow('Package name (e.g., @company/react-standards): '), (name) => {
-        readline.close();
-        resolve(name.trim() || null);
-      });
-    });
-  }
-
-  async promptVersion() {
-    const readline = require('readline').createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    return new Promise((resolve) => {
-      readline.question(chalk.yellow('Version (e.g., 1.0.0): '), (version) => {
-        readline.close();
-        resolve(version.trim() || null);
-      });
-    });
-  }
-
-  async ensureRegistry() {
-    await fs.ensureDir(this.registryPath);
-    console.log(chalk.dim(`Registry location: ${this.registryPath}`));
-  }
-
-  async copyContextKitFiles(sourceDir, targetDir, excludePatterns) {
-    const files = await fs.readdir(sourceDir, { withFileTypes: true });
-
-    for (const file of files) {
-      const sourcePath = path.join(sourceDir, file.name);
-      const targetPath = path.join(targetDir, file.name);
-
-      // Check if should exclude
-      const shouldExclude = excludePatterns.some(pattern => 
-        file.name.includes(pattern) || sourcePath.includes(pattern)
-      );
-
-      if (shouldExclude) {
-        continue;
-      }
-
-      if (file.isDirectory()) {
-        await fs.ensureDir(targetPath);
-        await this.copyContextKitFiles(sourcePath, targetPath, excludePatterns);
-      } else {
-        await fs.copy(sourcePath, targetPath);
-      }
-    }
-  }
-
-  async loadConfig() {
-    try {
-      const configContent = await fs.readFile('.contextkit/config.yml', 'utf-8');
-      return yaml.load(configContent);
-    } catch (error) {
-      return {};
-    }
-  }
-}
-
-async function publish(options) {
-  const cmd = new PublishCommand();
-  await cmd.run(options);
-}
-
-module.exports = publish;
-

package/lib/commands/pull.js

@@ -1,191 +0,0 @@
-const chalk = require('chalk');
-const fs = require('fs-extra');
-const path = require('path');
-const yaml = require('js-yaml');
-
-class PullCommand {
-  constructor() {
-    this.registryPath = path.join(process.env.HOME || process.env.USERPROFILE, '.contextkit-registry');
-  }
-
-  async run(packageSpec, options = {}) {
-    console.log(chalk.magenta(`📥 Pulling ContextKit Configuration: ${packageSpec}\n`));
-
-    // Parse package spec (name@version or just name)
-    const [packageName, version] = packageSpec.includes('@') 
-      ? packageSpec.split('@')
-      : [packageSpec, 'latest'];
-
-    // Find package
-    const packageDir = await this.findPackage(packageName, version);
-    
-    if (!packageDir) {
-      console.log(chalk.red(`❌ Package not found: ${packageSpec}`));
-      console.log(chalk.yellow('\n💡 Available packages:'));
-      await this.listPackages();
-      return;
-    }
-
-    // Check if .contextkit exists
-    const backupDir = options.backup ? `.contextkit.backup.${Date.now()}` : null;
-    
-    if (await fs.pathExists('.contextkit') && !options.force) {
-      if (backupDir) {
-        await fs.copy('.contextkit', backupDir);
-        console.log(chalk.green(`✅ Backed up existing .contextkit to ${backupDir}`));
-      } else {
-        const { confirm } = await this.promptOverwrite();
-        if (!confirm) {
-          console.log(chalk.yellow('⏭️  Cancelled'));
-          return;
-        }
-      }
-    }
-
-    // Copy package files
-    await this.copyPackageFiles(packageDir, '.contextkit', options);
-
-    // Update config.yml with package info
-    await this.updateConfig(packageName, version);
-
-    console.log(chalk.green(`\n✅ Pulled ${packageSpec} successfully!`));
-    
-    if (backupDir) {
-      console.log(chalk.dim(`   Backup: ${backupDir}`));
-    }
-  }
-
-  async findPackage(packageName, version) {
-    const packagePath = path.join(this.registryPath, packageName.replace('@', '').replace('/', '-'));
-    
-    if (!await fs.pathExists(packagePath)) {
-      return null;
-    }
-
-    if (version === 'latest') {
-      // Find latest version
-      const versions = await fs.readdir(packagePath);
-      const sortedVersions = versions
-        .filter(v => /^\d+\.\d+\.\d+$/.test(v))
-        .sort((a, b) => {
-          const aParts = a.split('.').map(Number);
-          const bParts = b.split('.').map(Number);
-          for (let i = 0; i < 3; i++) {
-            if (aParts[i] !== bParts[i]) {
-              return bParts[i] - aParts[i];
-            }
-          }
-          return 0;
-        });
-      
-      if (sortedVersions.length > 0) {
-        return path.join(packagePath, sortedVersions[0]);
-      }
-    } else {
-      const versionPath = path.join(packagePath, version);
-      if (await fs.pathExists(versionPath)) {
-        return versionPath;
-      }
-    }
-
-    return null;
-  }
-
-  async listPackages() {
-    if (!await fs.pathExists(this.registryPath)) {
-      console.log(chalk.dim('   (No packages in registry)'));
-      return;
-    }
-
-    const packages = await fs.readdir(this.registryPath, { withFileTypes: true });
-    
-    for (const pkg of packages.filter(p => p.isDirectory())) {
-      const packagePath = path.join(this.registryPath, pkg.name);
-      const versions = await fs.readdir(packagePath);
-      const validVersions = versions.filter(v => /^\d+\.\d+\.\d+$/.test(v));
-      
-      if (validVersions.length > 0) {
-        const latest = validVersions.sort().reverse()[0];
-        console.log(chalk.cyan(`   ${pkg.name.replace('-', '/')}@${latest}`));
-      }
-    }
-  }
-
-  async promptOverwrite() {
-    const readline = require('readline').createInterface({
-      input: process.stdin,
-      output: process.stdout
-    });
-
-    return new Promise((resolve) => {
-      readline.question(chalk.yellow('⚠️  .contextkit already exists. Overwrite? (y/N): '), (answer) => {
-        readline.close();
-        resolve({ confirm: answer.toLowerCase() === 'y' });
-      });
-    });
-  }
-
-  async copyPackageFiles(sourceDir, targetDir, options) {
-    // Read package.json if exists
-    const packageJsonPath = path.join(sourceDir, 'package.json');
-    let packageJson = {};
-    
-    if (await fs.pathExists(packageJsonPath)) {
-      packageJson = await fs.readJson(packageJsonPath);
-    }
-
-    // Copy all files from package
-    const files = await fs.readdir(sourceDir, { withFileTypes: true });
-
-    for (const file of files) {
-      const sourcePath = path.join(sourceDir, file.name);
-      const targetPath = path.join(targetDir, file.name);
-
-      // Skip package.json and README.md
-      if (file.name === 'package.json' || file.name === 'README.md') {
-        continue;
-      }
-
-      if (file.isDirectory()) {
-        await fs.ensureDir(targetPath);
-        await this.copyPackageFiles(sourcePath, targetPath, options);
-      } else {
-        await fs.copy(sourcePath, targetPath);
-      }
-    }
-  }
-
-  async updateConfig(packageName, version) {
-    const configPath = '.contextkit/config.yml';
-    
-    if (!await fs.pathExists(configPath)) {
-      return;
-    }
-
-    try {
-      const configContent = await fs.readFile(configPath, 'utf-8');
-      const config = yaml.load(configContent);
-      
-      // Add package info
-      if (!config.metadata) {
-        config.metadata = {};
-      }
-      
-      config.metadata.pulled_from = packageName;
-      config.metadata.pulled_version = version;
-      config.metadata.pulled_at = new Date().toISOString();
-
-      await fs.writeFile(configPath, yaml.dump(config, { lineWidth: 120 }));
-    } catch (error) {
-      console.log(chalk.yellow(`⚠️  Could not update config.yml: ${error.message}`));
-    }
-  }
-}
-
-async function pull(packageSpec, options) {
-  const cmd = new PullCommand();
-  await cmd.run(packageSpec, options);
-}
-
-module.exports = pull;
-