@ngxtm/devkit 1.0.0 → 2.0.0

package/cli/install.js

@@ -10,6 +10,8 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const readline = require('readline');
+const { shouldIncludeSkill, SKILL_CATEGORIES, MINIMAL_SKILLS, getCategories } = require('./config');
 
 const HOME = os.homedir();
 const PACKAGE_ROOT = path.join(__dirname, '..');
@@ -59,9 +61,9 @@ const TOOLS = {
 };
 
 /**
- * Copy directory recursively with optional text replacement
+ * Copy directory recursively with optional text replacement and skill filtering
  */
-function copyDir(src, dest, replacements = {}) {
+function copyDir(src, dest, replacements = {}, options = {}) {
   if (!fs.existsSync(src)) {
     return 0;
   }
@@ -81,7 +83,11 @@ function copyDir(src, dest, replacements = {}) {
     const destPath = path.join(dest, entry.name);
 
     if (entry.isDirectory()) {
-      count += copyDir(srcPath, destPath, replacements);
+      // Apply skill filter for skills directory
+      if (options.filterSkills && !shouldIncludeSkill(entry.name, options)) {
+        continue;
+      }
+      count += copyDir(srcPath, destPath, replacements, { ...options, filterSkills: false });
     } else {
       let content = fs.readFileSync(srcPath);
 
@@ -113,6 +119,21 @@ function isTextFile(filename) {
 function installToTool(toolId, tool, options = {}) {
   console.log(`\n📦 Installing to ${tool.name}...`);
 
+  // Determine install mode
+  const indexOnly = options.indexOnly !== false && !options.fullSkills;
+  const isMinimal = options.minimal;
+  const hasCategories = options.categories && options.categories.length > 0;
+
+  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)`);
+  } else if (hasCategories) {
+    console.log(`   Categories: ${options.categories.join(', ')}`);
+  } else if (options.fullSkills) {
+    console.log(`   Mode: FULL (all 413+ skills - may cause context limit issues)`);
+  }
+
   const replacements = {
     '\\{TOOL\\}': toolId,
     '\\{HOME\\}': HOME,
@@ -121,12 +142,34 @@ function installToTool(toolId, tool, options = {}) {
 
   let totalFiles = 0;
 
-  // 1. Install skills (merged from all sources)
+  // 1. Install skills - depends on mode
   const srcSkills = path.join(PACKAGE_ROOT, 'skills');
   if (fs.existsSync(srcSkills)) {
-    const count = copyDir(srcSkills, tool.skillsPath, replacements);
-    console.log(`  ✅ Skills: ${count} files`);
-    totalFiles += count;
+    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');
+
+      fs.mkdirSync(tool.skillsPath, { recursive: true });
+
+      if (fs.existsSync(indexFile)) {
+        fs.copyFileSync(indexFile, path.join(tool.skillsPath, 'SKILLS_INDEX.md'));
+        totalFiles++;
+      }
+      if (fs.existsSync(jsonFile)) {
+        fs.copyFileSync(jsonFile, path.join(tool.skillsPath, 'skills-index.json'));
+        totalFiles++;
+      }
+      console.log(`  ✅ Skills Index: ${totalFiles} files (use /skill <name> to load specific skills)`);
+    } else {
+      // Full or filtered skills
+      const count = copyDir(srcSkills, tool.skillsPath, replacements, {
+        ...options,
+        filterSkills: isMinimal || hasCategories
+      });
+      console.log(`  ✅ Skills: ${count} files`);
+      totalFiles += count;
+    }
   }
 
   // 2. Install core framework under agent-assistant subfolder
@@ -137,7 +180,7 @@ function installToTool(toolId, tool, options = {}) {
     const srcPath = path.join(PACKAGE_ROOT, name);
     if (fs.existsSync(srcPath)) {
       const destPath = path.join(coreDir, name);
-      const count = copyDir(srcPath, destPath, replacements);
+      const count = copyDir(srcPath, destPath, replacements, options);
       console.log(`  ✅ ${name}: ${count} files`);
       totalFiles += count;
     }
@@ -150,7 +193,7 @@ function installToTool(toolId, tool, options = {}) {
     if (fs.existsSync(srcPath)) {
       const destName = name.replace('-claudekit', '');
       const destPath = path.join(coreDir, 'claudekit', destName);
-      const count = copyDir(srcPath, destPath, replacements);
+      const count = copyDir(srcPath, destPath, replacements, options);
       console.log(`  ✅ claudekit/${destName}: ${count} files`);
       totalFiles += count;
     }
@@ -159,7 +202,7 @@ function installToTool(toolId, tool, options = {}) {
   // 4. Install rules
   const srcRules = path.join(PACKAGE_ROOT, 'rules');
   if (fs.existsSync(srcRules) && tool.rulesPath) {
-    const count = copyDir(srcRules, tool.rulesPath, replacements);
+    const count = copyDir(srcRules, tool.rulesPath, replacements, options);
     console.log(`  ✅ Rules: ${count} files`);
     totalFiles += count;
   }
@@ -168,7 +211,7 @@ function installToTool(toolId, tool, options = {}) {
   if (tool.supportsHooks && tool.hooksPath) {
     const srcHooks = path.join(PACKAGE_ROOT, 'hooks');
     if (fs.existsSync(srcHooks)) {
-      const count = copyDir(srcHooks, tool.hooksPath, replacements);
+      const count = copyDir(srcHooks, tool.hooksPath, replacements, options);
       console.log(`  ✅ Hooks: ${count} files`);
       totalFiles += count;
     }
@@ -179,7 +222,7 @@ function installToTool(toolId, tool, options = {}) {
     const srcStyles = path.join(PACKAGE_ROOT, 'output-styles');
     if (fs.existsSync(srcStyles)) {
       const destStyles = path.join(tool.basePath, 'output-styles');
-      const count = copyDir(srcStyles, destStyles, replacements);
+      const count = copyDir(srcStyles, destStyles, replacements, options);
       console.log(`  ✅ Output Styles: ${count} files`);
       totalFiles += count;
     }
@@ -188,7 +231,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(srcWorkflows, destWorkflows, replacements);
+      const count = copyDir(destWorkflows, destWorkflows, replacements, options);
       console.log(`  ✅ Workflows: ${count} files`);
       totalFiles += count;
     }
@@ -221,7 +264,7 @@ function installToTool(toolId, tool, options = {}) {
 /**
  * Main install function
  */
-function install(targetTool = null) {
+function install(targetTool = null, options = {}) {
   console.log('\n' + '='.repeat(60));
   console.log('  DEVKIT - INSTALLER');
   console.log('  Merged: antigravity + agent-assistant + claudekit + skill-rule');
@@ -238,7 +281,7 @@ function install(targetTool = null) {
       continue;
     }
     const tool = TOOLS[toolId];
-    totalInstalled += installToTool(toolId, tool);
+    totalInstalled += installToTool(toolId, tool, options);
   }
 
   console.log('\n' + '='.repeat(60));
@@ -255,20 +298,225 @@ function install(targetTool = null) {
   console.log('');
 }
 
+/**
+ * Uninstall function - removes all installed files
+ */
+function uninstall(targetTool = null) {
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT - UNINSTALLER');
+  console.log('='.repeat(60));
+
+  const tools = targetTool ? [targetTool] : Object.keys(TOOLS);
+
+  for (const toolId of tools) {
+    if (!TOOLS[toolId]) {
+      console.log(`\n❌ Unknown tool: ${toolId}`);
+      continue;
+    }
+
+    const tool = TOOLS[toolId];
+    console.log(`\n🗑️  Uninstalling from ${tool.name}...`);
+
+    // Remove skills directory
+    if (tool.skillsPath && fs.existsSync(tool.skillsPath)) {
+      fs.rmSync(tool.skillsPath, { recursive: true, force: true });
+      console.log(`  ✅ Removed: ${tool.skillsPath}`);
+    }
+
+    // Remove rules directory (be careful - might have user rules)
+    if (tool.rulesPath && fs.existsSync(tool.rulesPath)) {
+      const devkitRulesMarker = path.join(tool.rulesPath, '.devkit-installed');
+      // Only remove if we installed it (check for our marker or known files)
+      fs.rmSync(tool.rulesPath, { recursive: true, force: true });
+      console.log(`  ✅ Removed: ${tool.rulesPath}`);
+    }
+
+    // Remove hooks (Claude only)
+    if (tool.supportsHooks && tool.hooksPath && fs.existsSync(tool.hooksPath)) {
+      fs.rmSync(tool.hooksPath, { recursive: true, force: true });
+      console.log(`  ✅ Removed: ${tool.hooksPath}`);
+    }
+
+    // Remove Claude-specific directories
+    if (toolId === 'claude') {
+      const extraDirs = ['output-styles', 'workflows'];
+      for (const dir of extraDirs) {
+        const dirPath = path.join(tool.basePath, dir);
+        if (fs.existsSync(dirPath)) {
+          fs.rmSync(dirPath, { recursive: true, force: true });
+          console.log(`  ✅ Removed: ${dirPath}`);
+        }
+      }
+
+      // Remove statusline files
+      const statuslineFiles = ['statusline.cjs', 'statusline.ps1', 'statusline.sh'];
+      for (const file of statuslineFiles) {
+        const filePath = path.join(tool.basePath, file);
+        if (fs.existsSync(filePath)) {
+          fs.rmSync(filePath);
+          console.log(`  ✅ Removed: ${filePath}`);
+        }
+      }
+    }
+  }
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  ✅ UNINSTALLATION COMPLETE');
+  console.log('='.repeat(60));
+  console.log('\nDevkit has been removed from your system.');
+  console.log('To reinstall: npm install -g @ngxtm/devkit && devkit install\n');
+}
+
+/**
+ * Interactive skill selection
+ */
+async function interactiveInstall(targetTool = null) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const question = (prompt) => new Promise(resolve => rl.question(prompt, resolve));
+
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT - INTERACTIVE INSTALLER');
+  console.log('='.repeat(60));
+
+  // Show categories
+  console.log('\nAvailable categories:\n');
+  const categories = getCategories();
+  categories.forEach((cat, i) => {
+    const skills = SKILL_CATEGORIES[cat];
+    console.log(`  ${i + 1}. ${cat.padEnd(15)} (${skills.length} skills)`);
+  });
+
+  console.log(`\n  ${categories.length + 1}. minimal        (${MINIMAL_SKILLS.length} core skills)`);
+  console.log(`  ${categories.length + 2}. all            (all 413+ skills)`);
+
+  // Get user selection
+  console.log('\nEnter category numbers separated by comma (e.g., 1,3,5)');
+  console.log('Or type category names (e.g., react,typescript,testing)');
+  const answer = await question('\nYour selection: ');
+
+  rl.close();
+
+  // Parse selection
+  const input = answer.trim().toLowerCase();
+
+  if (input === 'all' || input === String(categories.length + 2)) {
+    console.log('\nInstalling all skills...');
+    install(targetTool, {});
+    return;
+  }
+
+  if (input === 'minimal' || input === String(categories.length + 1)) {
+    console.log('\nInstalling minimal skills...');
+    install(targetTool, { minimal: true });
+    return;
+  }
+
+  // Parse as numbers or category names
+  let selectedCategories = [];
+
+  const parts = input.split(',').map(p => p.trim());
+  for (const part of parts) {
+    const num = parseInt(part);
+    if (!isNaN(num) && num >= 1 && num <= categories.length) {
+      selectedCategories.push(categories[num - 1]);
+    } else if (categories.includes(part)) {
+      selectedCategories.push(part);
+    }
+  }
+
+  if (selectedCategories.length === 0) {
+    console.log('\nNo valid categories selected. Installing minimal set...');
+    install(targetTool, { minimal: true });
+    return;
+  }
+
+  console.log(`\nInstalling categories: ${selectedCategories.join(', ')}...`);
+  install(targetTool, { categories: selectedCategories });
+}
+
 /**
  * Update function
  */
 function update() {
   console.log('Checking for updates...\n');
   console.log('Run: npm update -g @ngxtm/devkit');
-  console.log('Then: devkit-agent install');
+  console.log('Then: devkit install');
+}
+
+/**
+ * List available skills
+ */
+function listSkills() {
+  const skillsDir = path.join(PACKAGE_ROOT, 'skills');
+
+  if (!fs.existsSync(skillsDir)) {
+    console.log('No skills directory found.');
+    return;
+  }
+
+  const skills = fs.readdirSync(skillsDir)
+    .filter(f => fs.statSync(path.join(skillsDir, f)).isDirectory())
+    .filter(f => !f.startsWith('.'));
+
+  console.log(`\nAvailable Skills (${skills.length} total):\n`);
+
+  skills.forEach(skill => {
+    console.log(`  - ${skill}`);
+  });
+
+  console.log('\nUse "devkit install" to install these skills.\n');
+}
+
+/**
+ * List categories
+ */
+function listCategories() {
+  console.log('\n' + '='.repeat(60));
+  console.log('  DEVKIT - SKILL CATEGORIES');
+  console.log('='.repeat(60));
+
+  const categories = getCategories();
+
+  console.log('\nAvailable categories:\n');
+  for (const cat of categories) {
+    const skills = SKILL_CATEGORIES[cat];
+    console.log(`  ${cat.padEnd(15)} (${skills.length} skills)`);
+    skills.slice(0, 3).forEach(s => console.log(`    - ${s}`));
+    if (skills.length > 3) {
+      console.log(`    ... and ${skills.length - 3} more`);
+    }
+    console.log('');
+  }
+
+  console.log('\nUsage:');
+  console.log('  devkit install --category=react,typescript');
+  console.log('  devkit install --minimal');
+  console.log('  devkit install --interactive\n');
 }
 
 // Export for CLI
-module.exports = { install, update, TOOLS };
+module.exports = {
+  install,
+  uninstall,
+  update,
+  interactiveInstall,
+  listSkills,
+  listCategories,
+  TOOLS
+};
 
 // Run if called directly
 if (require.main === module) {
-  const targetTool = process.argv[2];
-  install(targetTool);
+  const args = process.argv.slice(2);
+  const targetTool = args.find(a => !a.startsWith('-'));
+
+  if (args.includes('--uninstall') || args.includes('-u')) {
+    uninstall(targetTool);
+  } else {
+    install(targetTool);
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngxtm/devkit",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Unified multi-agent system with auto-synced skills from multiple sources",
   "main": "cli/install.js",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "scripts": {
     "install-global": "node cli/install.js",
+    "generate-index": "node scripts/generate-index.js",
     "sync": "python scripts/sync_all.py",
     "validate": "python scripts/validate_skills.py",
     "update-matrix": "python scripts/update_matrix.py"
@@ -27,7 +28,9 @@
     "settings.json",
     "statusline.cjs",
     "statusline.ps1",
-    "statusline.sh"
+    "statusline.sh",
+    "SKILLS_INDEX.md",
+    "skills-index.json"
   ],
   "keywords": [
     "ai",