@nolrm/contextkit 0.9.6 → 0.10.0

package/README.md

@@ -37,7 +37,8 @@ npm i -g @nolrm/contextkit
 
 # Step 2: Navigate to your project and install
 cd your-project
-contextkit install
+contextkit install          # interactive — prompts "Which AI tool?"
+contextkit install claude   # or specify your platform directly
 ```
 
 This creates `.contextkit/` with skeleton context files (blank templates to be filled by AI):
@@ -67,10 +68,10 @@ ck analyze
 Perfect for teams where members use different AI tools:
 
 ```bash
-# First team member (any tool) - sets up the project
-contextkit install
+# First team member - sets up the project with their tool
+contextkit install claude   # or: contextkit install (interactive picker)
 
-# Each team member adds their platform
+# Each additional team member adds their platform
 ck claude      # creates CLAUDE.md + .claude/rules/
 ck cursor      # creates .cursor/rules/ (scoped .mdc files)
 ck copilot     # creates .github/copilot-instructions.md
@@ -161,6 +162,7 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/squad-review` | Review the full pipeline and give a verdict |
 | `/squad-batch` | Kick off multiple tasks at once (batch PO specs) |
 | `/squad-run` | Auto-run the remaining pipeline for batch tasks |
+| `/ck` | Health check — verify setup, standards, and integrations |
 
 **Claude Code** — available as `/analyze`, `/review`, etc. in `.claude/commands/`
 **Cursor** — available as slash commands in Chat via `.cursor/prompts/`
@@ -273,7 +275,7 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 - 🌍 **Project Agnostic** - Works with React, Vue, Node.js, PHP, Python, Rust, monorepos—any project type
 - 🤖 **Multi-Platform** - Works with Cursor, Claude Code, Copilot, Codex, Gemini, Aider, Continue, Windsurf
 - 🛡️ **Safe Install** - Backs up existing files with rollback support
-- ⚡ **Zero Config** - Auto-detects package managers and AI tools
+- ⚡ **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
 - 🔄 **Workflow Orchestration** - Structured workflows with `ck run`
@@ -284,7 +286,8 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 
 ```bash
 # Installation & Setup
-ck install     # set up .contextkit in this repo
+ck install            # set up .contextkit + pick AI tool interactively
+ck install claude     # set up .contextkit + Claude (no prompt)
 ck claude      # add Claude Code integration (CLAUDE.md + rules)
 ck cursor      # add Cursor integration (scoped .mdc rules)
 ck copilot     # add GitHub Copilot integration

package/bin/contextkit.js

@@ -21,13 +21,13 @@ program
 
 // Install command
 program
-  .command('install')
+  .command('install [platform]')
   .description('Install ContextKit in current project')
   .option('--no-hooks', 'Skip Git hooks installation')
   .option('--non-interactive', 'Skip interactive prompts')
-  .action(async (options) => {
+  .action(async (platform, options) => {
     try {
-      await install(options);
+      await install({ ...options, ...(platform ? { platform, fullInstall: true } : { fullInstall: true }) });
     } catch (error) {
       console.error(chalk.red('Installation failed:'), error.message);
       process.exit(1);

package/lib/commands/install.js

@@ -9,7 +9,6 @@ const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
 const GitHooksManager = require('../utils/git-hooks');
 const StatusManager = require('../utils/status-manager');
-const ToolDetector = require('../utils/tool-detector');
 
 class InstallCommand {
   constructor() {
@@ -17,7 +16,6 @@ class InstallCommand {
     this.projectDetector = new ProjectDetector();
     this.gitHooksManager = new GitHooksManager();
     this.statusManager = new StatusManager();
-    this.toolDetector = new ToolDetector();
     this.repoUrl = 'https://raw.githubusercontent.com/nolrm/contextkit/main';
   }
 
@@ -39,12 +37,12 @@ class InstallCommand {
     }
 
     const requestedPlatform = options.platform;
-    const isPlatformSpecific = !!requestedPlatform;
+    const isFullInstall = !!options.fullInstall;
 
-    // Handle platform-specific installation
-    if (isPlatformSpecific) {
+    // Handle platform-specific installation (e.g., `ck claude`)
+    if (requestedPlatform && !isFullInstall) {
       const isInstalled = await this.isAlreadyInstalled();
-      
+
       if (!isInstalled) {
         console.log(chalk.red('❌ .contextkit is not installed'));
         console.log(chalk.yellow('💡 Run: contextkit install'));
@@ -52,7 +50,7 @@ class InstallCommand {
         console.log(chalk.dim('   Then you can run: contextkit ' + requestedPlatform));
         return;
       }
-      
+
       // .contextkit exists, just add the platform integration
       console.log(chalk.green('✓ .contextkit already exists'));
       console.log(chalk.blue(`🔧 Adding ${requestedPlatform} integration...`));
@@ -60,29 +58,17 @@ class InstallCommand {
       await this.installPlatformIntegration(requestedPlatform);
       return;
     }
-    
+
     // Full installation
     console.log(chalk.magenta('🎵 Installing ContextKit...'));
     console.log('');
-    
+
     // Detect project type
     const projectType = this.projectDetector.detectProjectType();
     const packageManager = this.projectDetector.detectPackageManager();
-    
+
     console.log(chalk.green(`🧩 Detected project: ${projectType}`));
     console.log(chalk.green(`📦 Package manager: ${packageManager}`));
-
-    // Detect AI tools
-    const detectedTools = await this.toolDetector.detectAll();
-    const summary = this.toolDetector.getSummary();
-    
-    if (summary && summary.count > 0) {
-      const tools = [...summary.editors, ...summary.cli].join(', ');
-      console.log(chalk.green(`🧠 AI tools detected: ${tools}`));
-    } else {
-      console.log(chalk.yellow('⚠️  No AI tools detected'));
-      console.log(chalk.blue('💡 Universal context files will still be installed'));
-    }
     console.log('');
 
     // Check if already installed
@@ -98,7 +84,7 @@ class InstallCommand {
     await this.createDirectoryStructure();
 
     // Download files
-    await this.downloadFiles(projectType, options, detectedTools);
+    await this.downloadFiles(projectType, options);
 
     // Ask about Git hooks
     let hookChoices = { prePush: true, commitMsg: true };
@@ -119,8 +105,19 @@ class InstallCommand {
     // Create status tracking
     await this.createStatusFile(projectType, packageManager, hookChoices);
 
+    // Determine which platform to install
+    let chosenPlatform = requestedPlatform || null;
+    if (!chosenPlatform && !options.nonInteractive) {
+      chosenPlatform = await this.promptPlatformChoice();
+    }
+
+    // Install chosen platform integration
+    if (chosenPlatform) {
+      await this.installPlatformIntegration(chosenPlatform);
+    }
+
     // Success message
-    this.showSuccessMessage(hookChoices, detectedTools, projectType, packageManager);
+    this.showSuccessMessage(hookChoices, chosenPlatform, projectType, packageManager);
   }
 
   async installPlatformIntegration(platform) {
@@ -171,6 +168,26 @@ class InstallCommand {
     return { shouldContinue };
   }
 
+  async promptPlatformChoice() {
+    const { platform } = await inquirer.prompt([{
+      type: 'list',
+      name: 'platform',
+      message: 'Which AI tool are you using?',
+      choices: [
+        { name: 'Claude Code', value: 'claude' },
+        { name: 'Cursor', value: 'cursor' },
+        { name: 'Copilot (GitHub)', value: 'copilot' },
+        { name: 'Codex (OpenAI)', value: 'codex' },
+        { name: 'Gemini', value: 'gemini' },
+        { name: 'Windsurf', value: 'windsurf' },
+        { name: 'Aider', value: 'aider' },
+        { name: 'Continue', value: 'continue' },
+        { name: 'Skip (base only)', value: null },
+      ]
+    }]);
+    return platform;
+  }
+
   async promptGitHooks() {
     // Check for non-interactive mode
     if (process.env.CI === 'true' || process.env.NON_INTERACTIVE === 'true') {
@@ -491,7 +508,7 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
     }
   }
 
-  async downloadFiles(projectType, options = {}, detectedTools = {}) {
+  async downloadFiles(projectType, options = {}) {
     try {
       // Create skeleton standards files (will be customized by analyze)
       console.log(chalk.blue('📝 Creating skeleton standards files...'));
@@ -638,54 +655,12 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
     await this.createCorrectionsLog();
     await this.createMetaInstructions();
     await this.createPolicyFile();
+    await this.createHealthCheckCommand();
 
-    // Install platform integrations
-    await this.installPlatformIntegrations(detectedTools);
-  }
-
-  async installPlatformIntegrations(detectedTools = {}) {
-    console.log(chalk.blue('🔧 Installing integrations...'));
-
-    try {
-      const { getIntegration } = require('../integrations');
-
-      // Map detected tools to integration names
-      const toolToIntegration = {
-        cursor: 'cursor',
-        continue: 'continue',
-        aider: 'aider',
-        aider_cli: 'aider',
-        vscode: 'copilot',
-        claude_cli: 'claude',
-        gemini_cli: 'gemini',
-        windsurf: 'windsurf',
-      };
-
-      const installed = new Set();
-      for (const [tool, integrationName] of Object.entries(toolToIntegration)) {
-        if (detectedTools[tool] && !installed.has(integrationName)) {
-          const integration = getIntegration(integrationName);
-          if (integration) {
-            await integration.install();
-            installed.add(integrationName);
-            console.log(chalk.green(`  ✅ ${integration.displayName}`));
-          }
-        }
-      }
-
-      // Always install CLI helpers
-      await this.installCLIHelpers();
-
-      console.log(chalk.green('✅ Platform integrations complete'));
-      console.log('');
-    } catch (error) {
-      console.log(chalk.red('❌ Failed to install platform integrations'));
-      console.log(chalk.yellow(error.message));
-    }
+    // Install CLI helpers
+    await this.installCLIHelpers();
   }
 
-  // Platform integration methods have been moved to lib/integrations/
-
   async installCLIHelpers() {
     // Create universal context.md file that references ALL standards
     // CLI tools can read this single file to understand what context is available
@@ -1461,37 +1436,73 @@ enforcement:
     console.log(chalk.green('✅ Policy file created'));
   }
 
-  showSuccessMessage(hookChoices, detectedTools = {}, projectType = '', packageManager = '') {
+  async createHealthCheckCommand() {
+    const healthCheckContent = `# ContextKit Health Check
+
+Check this project's ContextKit setup and report status.
+
+## Steps
+
+1. Check if \`.contextkit/\` directory exists. If not → STOP and tell user: "Run \`ck install\` to set up ContextKit."
+
+2. Read \`.contextkit/config.yml\` and check the \`last_analyzed\` field.
+
+3. Check each standards file for skeleton markers. Read these files and check if they contain \`<!-- Content will be generated by running: ck analyze -->\`:
+   - \`.contextkit/standards/code-style.md\`
+   - \`.contextkit/standards/testing.md\`
+   - \`.contextkit/standards/architecture.md\`
+   - \`.contextkit/standards/ai-guidelines.md\`
+   - \`.contextkit/standards/workflows.md\`
+   - \`.contextkit/standards/glossary.md\`
+
+4. Check product files for placeholder content (e.g., \`[ELEVATOR_PITCH_FROM_MISSION_MD]\`):
+   - \`.contextkit/product/mission-lite.md\`
+   - \`.contextkit/product/decisions.md\`
+   - \`.contextkit/product/roadmap.md\`
+
+5. Check which platform integrations exist:
+   - \`CLAUDE.md\` → Claude Code
+   - \`.cursor/rules/\` → Cursor
+   - \`AGENTS.md\` → Codex
+   - \`GEMINI.md\` → Gemini
+   - \`CONVENTIONS.md\` → Aider
+   - \`.windsurfrules\` → Windsurf
+   - \`.github/copilot-instructions.md\` → Copilot
+
+6. Report findings as a status summary table and list recommended next steps.
+
+## Output Format
+
+| Area | Status | Action |
+|------|--------|--------|
+| Installation | OK/Missing | \`ck install\` |
+| Standards | Populated/Skeleton | \`ck analyze\` or \`/analyze\` |
+| Product context | Populated/Placeholder | Edit \`.contextkit/product/\` files |
+| Integrations | List active | \`ck <platform>\` to add more |
+
+## Token Note
+
+If standards are still skeletons, warn that @imports in CLAUDE.md are loading empty files — wasting context tokens. Run \`/analyze\` to populate them.
+`;
+
+    await fs.writeFile('.contextkit/commands/health-check.md', healthCheckContent);
+  }
+
+  showSuccessMessage(hookChoices, platform = null, projectType = '', packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));
     console.log('');
 
-    // Show which platform integrations were configured
-    const { getIntegration } = require('../integrations');
-    const toolToIntegration = {
-      cursor: 'cursor',
-      continue: 'continue',
-      aider: 'aider',
-      aider_cli: 'aider',
-      vscode: 'copilot',
-      claude_cli: 'claude',
-      gemini_cli: 'gemini',
-      windsurf: 'windsurf',
-    };
-    const installedPlatforms = new Set();
-    for (const [tool, name] of Object.entries(toolToIntegration)) {
-      if (detectedTools[tool]) installedPlatforms.add(name);
-    }
-    if (installedPlatforms.size > 0) {
-      console.log(chalk.blue('🔌 Platform integrations:'));
-      for (const name of installedPlatforms) {
-        const integration = getIntegration(name);
-        if (integration) {
-          const files = [...integration.bridgeFiles, ...integration.generatedFiles];
-          console.log(`   ${integration.displayName}: ${files.join(', ')}`);
-        }
+    // Show which platform was installed
+    if (platform) {
+      const { getIntegration } = require('../integrations');
+      const integration = getIntegration(platform);
+      if (integration) {
+        const files = [...integration.bridgeFiles, ...integration.generatedFiles];
+        console.log(chalk.blue('🔌 Platform integration:'));
+        console.log(`   ${integration.displayName}: ${files.join(', ')}`);
+        console.log('');
       }
-      console.log('');
     }
 
     // Quick Reference
@@ -1511,7 +1522,7 @@ enforcement:
     console.log(chalk.bold('🚀 NEXT STEP — GENERATE STANDARDS'));
     console.log(''.padEnd(48, '─'));
 
-    if (detectedTools.cursor) {
+    if (platform === 'cursor') {
       console.log(chalk.bold('In Cursor Chat:'));
       console.log(`   @.contextkit/commands/analyze.md`);
       console.log('');
@@ -1537,8 +1548,7 @@ enforcement:
     console.log(chalk.bold('💡 After Analyze — Try This'));
     console.log(''.padEnd(48, '─'));
 
-    // Platform-specific examples
-    if (detectedTools.cursor) {
+    if (platform === 'cursor') {
       console.log(chalk.bold('In Cursor Chat'));
       console.log(`@.contextkit/commands/create-component.md`);
       console.log(chalk.dim('"Create a Button component for customer checkout"'));
@@ -1549,8 +1559,8 @@ enforcement:
     console.log(`ck ai "create a Button component for customer checkout"`);
     console.log('');
 
-    if (detectedTools.claude_cli || detectedTools.gemini_cli) {
-      const toolName = detectedTools.claude_cli ? 'Claude' : 'Gemini';
+    if (platform === 'claude' || platform === 'gemini') {
+      const toolName = platform === 'claude' ? 'Claude' : 'Gemini';
       console.log(chalk.bold(`In ${toolName} CLI`));
       console.log(`read .contextkit/commands/analyze.md and execute`);
       console.log('');

package/lib/integrations/claude-integration.js

@@ -24,6 +24,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-review.md',
       '.claude/commands/squad-batch.md',
       '.claude/commands/squad-run.md',
+      '.claude/commands/ck.md',
     ];
     this.platformDir = '.claude/rules';
   }
@@ -240,6 +241,13 @@ Create handoff files for multiple tasks and write PO specs for each one. Pass al
 Read \`.contextkit/commands/squad-run.md\` and execute the pipeline runner workflow.
 
 Process all batch tasks through the remaining pipeline steps (Architect, Dev, Test, Review) sequentially.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/ck.md', `# ContextKit Health Check
+
+Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
+
+Check project setup, standards status, and integrations. Report what needs attention.
 `);
   }
 
@@ -265,6 +273,9 @@ Process all batch tasks through the remaining pipeline steps (Architect, Dev, Te
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
     console.log(chalk.dim('    /squad-batch       — Batch kickoff: PO specs for multiple tasks'));
     console.log(chalk.dim('    /squad-run         — Auto-run pipeline for batch tasks'));
+    console.log(chalk.dim(''));
+    console.log(chalk.dim('  Health check:'));
+    console.log(chalk.dim('    /ck           — Check project setup and standards status'));
   }
 }
 

package/lib/integrations/cursor-integration.js

@@ -25,6 +25,7 @@ class CursorIntegration extends BaseIntegration {
       '.cursor/prompts/squad-review.md',
       '.cursor/prompts/squad-batch.md',
       '.cursor/prompts/squad-run.md',
+      '.cursor/prompts/ck.md',
     ];
     this.bridgeFiles = [];
     this.platformDir = '.cursor/rules';
@@ -248,6 +249,13 @@ Create handoff files for multiple tasks and write PO specs for each one. Pass al
 Read \`.contextkit/commands/squad-run.md\` and execute the pipeline runner workflow.
 
 Process all batch tasks through the remaining pipeline steps (Architect, Dev, Test, Review) sequentially.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/ck.md', `# ContextKit Health Check
+
+Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
+
+Check project setup, standards status, and integrations. Report what needs attention.
 `);
   }
 
@@ -272,6 +280,9 @@ Process all batch tasks through the remaining pipeline steps (Architect, Dev, Te
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
     console.log(chalk.dim('    /squad-batch       — Batch kickoff: PO specs for multiple tasks'));
     console.log(chalk.dim('    /squad-run         — Auto-run pipeline for batch tasks'));
+    console.log(chalk.dim(''));
+    console.log(chalk.dim('  Health check:'));
+    console.log(chalk.dim('    /ck           — Check project setup and standards status'));
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.9.6",
+  "version": "0.10.0",
   "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": {