@ngxtm/devkit 2.0.2 → 3.0.0

package/cli/init.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+
+/**
+ * Devkit Init - Per-Project Installation
+ *
+ * Installs devkit to the current project's .claude/ directory with:
+ * - Merged commands (from both agent-assistant and claudekit)
+ * - Tech-specific rules (based on project detection)
+ * - Skills index (for on-demand loading)
+ * - Essential hooks
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { detectProjectType, getRulesForTypes, printDetectionResults } = require('./detect');
+const { copyDir, getDirSize, validatePath } = require('./utils');
+
+const VERSION = require('../package.json').version;
+const PACKAGE_ROOT = path.join(__dirname, '..');
+
+/**
+ * Initialize devkit in a project directory
+ */
+function initProject(options = {}) {
+  const projectDir = options.path || process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+  const isUpdate = options.update || false;
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT v' + VERSION + (isUpdate ? ' - UPDATE' : ' - INIT'));
+  console.log('='.repeat(60));
+
+  // Check if .claude already exists
+  if (fs.existsSync(claudeDir) && !isUpdate && !options.force) {
+    console.log(`\n  .claude/ folder already exists.`);
+    console.log('  Use --force to overwrite or --update to update.\n');
+    return { success: false, reason: 'exists' };
+  }
+
+  // 1. Detect project type
+  console.log('\n  Detecting project type...');
+  const detectedTypes = detectProjectType(projectDir);
+  const rulesToInstall = getRulesForTypes(detectedTypes);
+
+  if (detectedTypes.length > 0) {
+    console.log(`  Detected: ${detectedTypes.join(', ')}`);
+    console.log(`  Rules: ${rulesToInstall.join(', ')}`);
+  } else {
+    console.log('  No specific technology detected.');
+    console.log('  Installing base commands only.');
+  }
+
+  // Create .claude directory
+  fs.mkdirSync(claudeDir, { recursive: true });
+
+  let totalFiles = 0;
+  const stats = {};
+
+  // 2. Install merged commands
+  console.log('\n  Installing components...');
+  const mergedCommandsDir = path.join(PACKAGE_ROOT, 'merged-commands');
+  const commandsDir = path.join(claudeDir, 'commands');
+
+  if (fs.existsSync(mergedCommandsDir)) {
+    const count = copyDir(mergedCommandsDir, commandsDir);
+    stats.commands = count;
+    totalFiles += count;
+    console.log(`    Commands: ${count} files`);
+  } else {
+    // Fallback to commands-claudekit if merged not available
+    const fallbackDir = path.join(PACKAGE_ROOT, 'commands-claudekit');
+    if (fs.existsSync(fallbackDir)) {
+      const count = copyDir(fallbackDir, commandsDir);
+      stats.commands = count;
+      totalFiles += count;
+      console.log(`    Commands (claudekit): ${count} files`);
+    }
+  }
+
+  // 3. Install tech-specific rules
+  const rulesDir = path.join(claudeDir, 'rules');
+  let rulesCount = 0;
+
+  for (const ruleType of rulesToInstall) {
+    const srcRulesDir = path.join(PACKAGE_ROOT, 'templates', ruleType, 'rules');
+    if (fs.existsSync(srcRulesDir)) {
+      const destRulesDir = path.join(rulesDir, ruleType);
+      const count = copyDir(srcRulesDir, destRulesDir);
+      rulesCount += count;
+    }
+  }
+
+  if (rulesCount > 0) {
+    stats.rules = rulesCount;
+    totalFiles += rulesCount;
+    console.log(`    Rules: ${rulesCount} files (${rulesToInstall.join(', ')})`);
+  }
+
+  // 4. Install essential hooks
+  const srcHooksDir = path.join(PACKAGE_ROOT, 'templates', 'base', 'hooks');
+  const hooksDir = path.join(claudeDir, 'hooks');
+
+  if (fs.existsSync(srcHooksDir)) {
+    const count = copyDir(srcHooksDir, hooksDir);
+    stats.hooks = count;
+    totalFiles += count;
+    console.log(`    Hooks: ${count} files`);
+  } else {
+    // Fallback to main hooks directory (essential only)
+    const fallbackHooks = path.join(PACKAGE_ROOT, 'hooks');
+    if (fs.existsSync(fallbackHooks)) {
+      const count = copyDir(fallbackHooks, hooksDir);
+      stats.hooks = count;
+      totalFiles += count;
+      console.log(`    Hooks: ${count} files`);
+    }
+  }
+
+  // 5. Install skills index
+  const skillsIndexSrc = path.join(PACKAGE_ROOT, 'skills-index.json');
+  const skillsIndexDest = path.join(claudeDir, 'skills-index.json');
+
+  if (fs.existsSync(skillsIndexSrc)) {
+    fs.copyFileSync(skillsIndexSrc, skillsIndexDest);
+    totalFiles++;
+    console.log(`    Skills Index: 1 file`);
+  }
+
+  // 6. Create devkit.json tracking file
+  const devkitConfig = {
+    version: VERSION,
+    detectedTypes: detectedTypes,
+    installedRules: rulesToInstall,
+    installedAt: new Date().toISOString(),
+    updatedAt: isUpdate ? new Date().toISOString() : null,
+    stats: {
+      totalFiles: totalFiles,
+      sizeKB: Math.round(getDirSize(claudeDir) / 1024)
+    }
+  };
+
+  fs.writeFileSync(
+    path.join(claudeDir, 'devkit.json'),
+    JSON.stringify(devkitConfig, null, 2)
+  );
+  totalFiles++;
+
+  // 7. Create settings.json if not exists
+  const settingsPath = path.join(claudeDir, 'settings.json');
+  if (!fs.existsSync(settingsPath)) {
+    const settings = {
+      includeCoAuthoredBy: false
+    };
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    totalFiles++;
+  }
+
+  // Calculate total size
+  const totalSizeKB = Math.round(getDirSize(claudeDir) / 1024);
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  INSTALLATION COMPLETE');
+  console.log('='.repeat(60));
+  console.log(`\n  Total: ${totalFiles} files (${totalSizeKB} KB)`);
+  console.log(`  Location: ${claudeDir}`);
+
+  console.log('\n  Available commands:');
+  console.log('    /plan        - Plan implementation');
+  console.log('    /cook        - Build a feature');
+  console.log('    /fix         - Fix issues');
+  console.log('    /code        - Start coding');
+  console.log('    /brainstorm  - Brainstorm ideas');
+
+  if (detectedTypes.length > 0) {
+    console.log(`\n  Tech-specific rules loaded for: ${detectedTypes.join(', ')}`);
+  }
+
+  console.log('\n  Restart Claude Code to use the new skills.\n');
+
+  return {
+    success: true,
+    detected: detectedTypes,
+    rules: rulesToInstall,
+    stats: {
+      files: totalFiles,
+      sizeKB: totalSizeKB
+    }
+  };
+}
+
+/**
+ * Uninstall devkit from project
+ */
+function uninstallProject(options = {}) {
+  const projectDir = options.path || process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT - UNINSTALL');
+  console.log('='.repeat(60));
+
+  if (!fs.existsSync(claudeDir)) {
+    console.log('\n  No .claude/ folder found.\n');
+    return { success: false, reason: 'not_found' };
+  }
+
+  // Check if it's a devkit installation
+  const devkitConfig = path.join(claudeDir, 'devkit.json');
+  if (!fs.existsSync(devkitConfig)) {
+    console.log('\n  .claude/ exists but is not a devkit installation.');
+    console.log('  Remove manually if needed.\n');
+    return { success: false, reason: 'not_devkit' };
+  }
+
+  // Remove the directory
+  fs.rmSync(claudeDir, { recursive: true, force: true });
+  console.log(`\n  Removed: ${claudeDir}`);
+  console.log('  Devkit uninstalled successfully.\n');
+
+  return { success: true };
+}
+
+module.exports = {
+  initProject,
+  uninstallProject,
+  copyDir,
+  getDirSize
+};
+
+// Run if called directly
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  const options = {
+    force: args.includes('--force') || args.includes('-f'),
+    update: args.includes('--update') || args.includes('-u'),
+    path: args.find(a => !a.startsWith('-')) || process.cwd()
+  };
+
+  if (args.includes('--uninstall')) {
+    uninstallProject(options);
+  } else {
+    initProject(options);
+  }
+}

package/cli/install.js

@@ -122,9 +122,12 @@ function installToTool(toolId, tool, options = {}) {
   // Determine install mode
   const indexOnly = options.indexOnly !== false && !options.fullSkills;
   const isMinimal = options.minimal;
+  const isLite = options.lite;  // New lite mode - commands only
   const hasCategories = options.categories && options.categories.length > 0;
 
-  if (indexOnly && !isMinimal && !hasCategories) {
+  if (isLite) {
+    console.log(`   Mode: LITE (commands only - minimal context usage)`);
+  } else if (indexOnly && !isMinimal && !hasCategories) {
     console.log(`   Mode: INDEX-ONLY (recommended - minimal context usage)`);
   } else if (isMinimal) {
     console.log(`   Mode: MINIMAL (${MINIMAL_SKILLS.length} core skills)`);
@@ -142,10 +145,13 @@ function installToTool(toolId, tool, options = {}) {
 
   let totalFiles = 0;
 
-  // 1. Install skills - depends on mode
-  const srcSkills = path.join(PACKAGE_ROOT, 'skills');
-  if (fs.existsSync(srcSkills)) {
-    if (indexOnly && !isMinimal && !hasCategories) {
+  // 1. Install skills - depends on mode (skip in lite mode)
+  if (isLite) {
+    console.log(`  ⏭️  Skipping skills (lite mode)`);
+  } else {
+    const srcSkills = path.join(PACKAGE_ROOT, 'skills');
+    if (fs.existsSync(srcSkills)) {
+      if (indexOnly && !isMinimal && !hasCategories) {
       // Index-only mode: just copy the index files
       const indexFile = path.join(PACKAGE_ROOT, 'SKILLS_INDEX.md');
       const jsonFile = path.join(PACKAGE_ROOT, 'skills-index.json');
@@ -171,69 +177,96 @@ function installToTool(toolId, tool, options = {}) {
       totalFiles += count;
     }
   }
+  }
 
-  // 2. Install commands to the official commands directory (for slash commands)
-  if (tool.commandsPath) {
-    // Install commands from commands/ folder
-    const srcCommands = path.join(PACKAGE_ROOT, 'commands');
-    if (fs.existsSync(srcCommands)) {
-      const count = copyDir(srcCommands, tool.commandsPath, replacements, options);
-      console.log(`  ✅ Commands: ${count} files`);
-      totalFiles += count;
+  // 2. Install commands - in lite mode, install only core commands
+  if (isLite) {
+    // Lite mode: install only essential claudekit commands
+    if (tool.commandsPath) {
+      const srcCommandsClaudekit = path.join(PACKAGE_ROOT, 'commands-claudekit');
+      if (fs.existsSync(srcCommandsClaudekit)) {
+        const count = copyDir(srcCommandsClaudekit, tool.commandsPath, replacements, options);
+        console.log(`  ✅ Commands (claudekit): ${count} files`);
+        totalFiles += count;
+      }
     }
+  } else if (!indexOnly || isMinimal || hasCategories) {
+    if (tool.commandsPath) {
+      // Install commands from commands/ folder
+      const srcCommands = path.join(PACKAGE_ROOT, 'commands');
+      if (fs.existsSync(srcCommands)) {
+        const count = copyDir(srcCommands, tool.commandsPath, replacements, options);
+        console.log(`  ✅ Commands: ${count} files`);
+        totalFiles += count;
+      }
 
-    // Install commands from commands-claudekit/ folder (merged into same directory)
-    const srcCommandsClaudekit = path.join(PACKAGE_ROOT, 'commands-claudekit');
-    if (fs.existsSync(srcCommandsClaudekit)) {
-      const count = copyDir(srcCommandsClaudekit, tool.commandsPath, replacements, options);
-      console.log(`  ✅ Commands (claudekit): ${count} files`);
-      totalFiles += count;
+      // Install commands from commands-claudekit/ folder (merged into same directory)
+      const srcCommandsClaudekit = path.join(PACKAGE_ROOT, 'commands-claudekit');
+      if (fs.existsSync(srcCommandsClaudekit)) {
+        const count = copyDir(srcCommandsClaudekit, tool.commandsPath, replacements, options);
+        console.log(`  ✅ Commands (claudekit): ${count} files`);
+        totalFiles += count;
+      }
     }
+  } else {
+    console.log(`  ⏭️  Skipping commands (index-only mode - use --full to include)`);
   }
 
-  // 3. Install core framework under agent-assistant subfolder (agents, matrix-skills only)
-  const coreDir = path.join(tool.skillsPath, 'agent-assistant');
-  const coreComponents = ['agents', 'matrix-skills'];
+  // 3. Install core framework (agents, matrix-skills) - SKIP in index-only/lite mode
+  if (!isLite && (!indexOnly || isMinimal || hasCategories)) {
+    const coreDir = path.join(tool.skillsPath, 'agent-assistant');
+    const coreComponents = ['agents', 'matrix-skills'];
+
+    for (const name of coreComponents) {
+      const srcPath = path.join(PACKAGE_ROOT, name);
+      if (fs.existsSync(srcPath)) {
+        const destPath = path.join(coreDir, name);
+        const count = copyDir(srcPath, destPath, replacements, options);
+        console.log(`  ✅ ${name}: ${count} files`);
+        totalFiles += count;
+      }
+    }
 
-  for (const name of coreComponents) {
-    const srcPath = path.join(PACKAGE_ROOT, name);
-    if (fs.existsSync(srcPath)) {
-      const destPath = path.join(coreDir, name);
-      const count = copyDir(srcPath, destPath, replacements, options);
-      console.log(`  ✅ ${name}: ${count} files`);
+    // 4. Install claudekit agents if available
+    const srcAgentsClaudekit = path.join(PACKAGE_ROOT, 'agents-claudekit');
+    if (fs.existsSync(srcAgentsClaudekit)) {
+      const destPath = path.join(coreDir, 'claudekit', 'agents');
+      const count = copyDir(srcAgentsClaudekit, destPath, replacements, options);
+      console.log(`  ✅ claudekit/agents: ${count} files`);
       totalFiles += count;
     }
+  } else if (!isLite) {
+    console.log(`  ⏭️  Skipping agents/matrix-skills (index-only mode)`);
   }
 
-  // 4. Install claudekit agents if available
-  const srcAgentsClaudekit = path.join(PACKAGE_ROOT, 'agents-claudekit');
-  if (fs.existsSync(srcAgentsClaudekit)) {
-    const destPath = path.join(coreDir, 'claudekit', 'agents');
-    const count = copyDir(srcAgentsClaudekit, destPath, replacements, options);
-    console.log(`  ✅ claudekit/agents: ${count} files`);
-    totalFiles += count;
-  }
-
-  // 5. Install rules
-  const srcRules = path.join(PACKAGE_ROOT, 'rules');
-  if (fs.existsSync(srcRules) && tool.rulesPath) {
-    const count = copyDir(srcRules, tool.rulesPath, replacements, options);
-    console.log(`  ✅ Rules: ${count} files`);
-    totalFiles += count;
+  // 5. Install rules - SKIP in index-only/lite mode (327 files = ~1.5MB, causes context limit)
+  if (!isLite && (!indexOnly || isMinimal || hasCategories)) {
+    const srcRules = path.join(PACKAGE_ROOT, 'rules');
+    if (fs.existsSync(srcRules) && tool.rulesPath) {
+      const count = copyDir(srcRules, tool.rulesPath, replacements, options);
+      console.log(`  ✅ Rules: ${count} files`);
+      totalFiles += count;
+    }
+  } else if (!isLite) {
+    console.log(`  ⏭️  Skipping rules (index-only mode - use --full to include)`);
   }
 
-  // 6. Install hooks (Claude Code only)
-  if (tool.supportsHooks && tool.hooksPath) {
-    const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
-    if (fs.existsSync(srcHooks)) {
-      const count = copyDir(srcHooks, tool.hooksPath, replacements, options);
-      console.log(`  ✅ Hooks: ${count} files`);
-      totalFiles += count;
+  // 6. Install hooks (Claude Code only) - SKIP in index-only/lite mode
+  if (!isLite && (!indexOnly || isMinimal || hasCategories)) {
+    if (tool.supportsHooks && tool.hooksPath) {
+      const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
+      if (fs.existsSync(srcHooks)) {
+        const count = copyDir(srcHooks, tool.hooksPath, replacements, options);
+        console.log(`  ✅ Hooks: ${count} files`);
+        totalFiles += count;
+      }
     }
+  } else if (!isLite) {
+    console.log(`  ⏭️  Skipping hooks (index-only mode)`);
   }
 
-  // 7. Install output-styles (Claude Code only)
-  if (toolId === 'claude') {
+  // 7. Install output-styles (Claude Code only) - SKIP in index-only/lite mode
+  if (!isLite && toolId === 'claude' && (!indexOnly || isMinimal || hasCategories)) {
     const srcStyles = path.join(PACKAGE_ROOT, 'output-styles');
     if (fs.existsSync(srcStyles)) {
       const destStyles = path.join(tool.basePath, 'output-styles');
@@ -246,7 +279,7 @@ function installToTool(toolId, tool, options = {}) {
     const srcWorkflows = path.join(PACKAGE_ROOT, 'workflows');
     if (fs.existsSync(srcWorkflows)) {
       const destWorkflows = path.join(tool.basePath, 'workflows');
-      const count = copyDir(destWorkflows, destWorkflows, replacements, options);
+      const count = copyDir(srcWorkflows, destWorkflows, replacements, options);
       console.log(`  ✅ Workflows: ${count} files`);
       totalFiles += count;
     }
@@ -513,12 +546,157 @@ function listCategories() {
   console.log('  devkit install --interactive\n');
 }
 
+/**
+ * Initialize devkit in current project directory
+ * Creates .claude/ folder with commands, hooks, and lightweight rules
+ */
+function initProject(options = {}) {
+  const projectDir = process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT - PROJECT INIT');
+  console.log('='.repeat(60));
+  console.log(`\nInitializing devkit in: ${projectDir}`);
+
+  // Check if .claude already exists
+  if (fs.existsSync(claudeDir)) {
+    console.log(`\n⚠️  .claude/ folder already exists.`);
+    if (!options.force) {
+      console.log('Use --force to overwrite existing files.');
+      return;
+    }
+    console.log('--force specified, overwriting...');
+  }
+
+  fs.mkdirSync(claudeDir, { recursive: true });
+
+  let totalFiles = 0;
+
+  // 1. Copy commands (claudekit only - lightweight)
+  const srcCommands = path.join(PACKAGE_ROOT, 'commands-claudekit');
+  if (fs.existsSync(srcCommands)) {
+    const destCommands = path.join(claudeDir, 'commands');
+    const count = copyDir(srcCommands, destCommands, {}, {});
+    console.log(`  ✅ Commands: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 2. Copy hooks
+  const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
+  if (fs.existsSync(srcHooks)) {
+    const destHooks = path.join(claudeDir, 'hooks');
+    const count = copyDir(srcHooks, destHooks, {}, {});
+    console.log(`  ✅ Hooks: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 3. Copy agents (claudekit only)
+  const srcAgents = path.join(PACKAGE_ROOT, 'agents-claudekit');
+  if (fs.existsSync(srcAgents)) {
+    const destAgents = path.join(claudeDir, 'agents');
+    const count = copyDir(srcAgents, destAgents, {}, {});
+    console.log(`  ✅ Agents: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 4. Copy output-styles
+  const srcStyles = path.join(PACKAGE_ROOT, 'output-styles');
+  if (fs.existsSync(srcStyles)) {
+    const destStyles = path.join(claudeDir, 'output-styles');
+    const count = copyDir(srcStyles, destStyles, {}, {});
+    console.log(`  ✅ Output Styles: ${count} files`);
+    totalFiles += count;
+  }
+
+  // 5. Copy lightweight rules (create minimal rules, not the full 327 files)
+  const rulesDir = path.join(claudeDir, 'rules');
+  fs.mkdirSync(rulesDir, { recursive: true });
+
+  // Create minimal rule files similar to claudekit_engineer
+  const minimalRules = {
+    'development-rules.md': `# Development Rules
+
+## Code Quality
+- Write clean, readable code with meaningful names
+- Follow project conventions and patterns
+- Keep functions small and focused
+- Add comments only where logic isn't self-evident
+
+## Testing
+- Write tests for new features
+- Ensure tests pass before committing
+- Use descriptive test names
+
+## Git
+- Write clear commit messages
+- Keep commits focused and atomic
+- Review changes before pushing
+`,
+    'orchestration-protocol.md': `# Orchestration Protocol
+
+## Workflow
+1. Understand the task completely before starting
+2. Break complex tasks into smaller steps
+3. Validate assumptions with the user
+4. Test changes incrementally
+
+## Communication
+- Be concise and clear
+- Ask clarifying questions when needed
+- Report progress on long tasks
+`
+  };
+
+  for (const [filename, content] of Object.entries(minimalRules)) {
+    fs.writeFileSync(path.join(rulesDir, filename), content);
+    totalFiles++;
+  }
+  console.log(`  ✅ Rules: ${Object.keys(minimalRules).length} files (lightweight)`);
+
+  // 6. Copy statusline scripts
+  const statuslineFiles = ['statusline.cjs', 'statusline.ps1', 'statusline.sh'];
+  for (const file of statuslineFiles) {
+    const srcFile = path.join(PACKAGE_ROOT, file);
+    if (fs.existsSync(srcFile)) {
+      fs.copyFileSync(srcFile, path.join(claudeDir, file));
+      totalFiles++;
+    }
+  }
+
+  // 7. Create settings.json
+  const settings = {
+    includeCoAuthoredBy: false
+  };
+  fs.writeFileSync(
+    path.join(claudeDir, 'settings.json'),
+    JSON.stringify(settings, null, 2)
+  );
+  totalFiles++;
+  console.log(`  ✅ Settings: created`);
+
+  console.log(`\n  📊 Total: ${totalFiles} files`);
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  ✅ PROJECT INITIALIZED');
+  console.log('='.repeat(60));
+  console.log(`\nDevkit initialized in ${claudeDir}`);
+  console.log('\nAvailable commands:');
+  console.log('  /plan        - Plan implementation');
+  console.log('  /brainstorm  - Brainstorm ideas');
+  console.log('  /fix         - Fix issues');
+  console.log('  /code        - Start coding');
+  console.log('  /cook        - Build a feature');
+  console.log('');
+}
+
 // Export for CLI
 module.exports = {
   install,
   uninstall,
   update,
   interactiveInstall,
+  initProject,
   listSkills,
   listCategories,
   TOOLS