@ngxtm/devkit 3.2.0 → 3.4.0

package/cli/index.js

@@ -17,6 +17,7 @@ const { initProject, uninstallProject } = require('./init');
 const { updateProject, showStatus } = require('./update');
 const { detectProjectType, getRulesForTypes, printDetectionResults } = require('./detect');
 const { validatePath } = require('./utils');
+const { listRules, addRules, removeRules } = require('./rules');
 
 // Legacy imports for backwards compatibility (will be deprecated)
 let legacyInstall = null;
@@ -38,6 +39,8 @@ function parseArgs(args) {
     update: false,
     clean: false,
     help: false,
+    installed: false,
+    ruleArgs: [],
     // Legacy options (deprecated)
     tool: null,
     minimal: false,
@@ -57,6 +60,8 @@ function parseArgs(args) {
       options.update = true;
     } else if (arg === '--clean' || arg === '-c') {
       options.clean = true;
+    } else if (arg === '--installed' || arg === '-i') {
+      options.installed = true;
     } else if (arg === '--status' || arg === '-s') {
       options.command = 'status';
     } else if (arg.startsWith('--path=')) {
@@ -65,21 +70,15 @@ function parseArgs(args) {
       // Handle legacy options for backwards compatibility
       if (arg === '--minimal' || arg === '-m') options.minimal = true;
       if (arg === '--lite' || arg === '-l') options.lite = true;
-      if (arg === '--interactive' || arg === '-i') options.interactive = true;
-      if (arg === '--full') options.fullSkills = true;
       if (arg.startsWith('--category=')) {
         const cats = arg.split('=')[1].split(',').map(c => c.trim());
         options.categories.push(...cats);
       }
     } else if (!options.command) {
       options.command = arg;
-    } else if (!options.path && !options.tool) {
-      // Could be a path or a tool name (legacy)
-      if (['claude', 'cursor', 'copilot', 'gemini'].includes(arg)) {
-        options.tool = arg;
-      } else {
-        options.path = arg;
-      }
+    } else {
+      // Additional args (for add/remove commands)
+      options.ruleArgs.push(arg);
     }
   }
 
@@ -104,6 +103,15 @@ COMMANDS:
   detect        Show detected technologies for current project
                 Useful to see what devkit will install.
 
+  rules         List all available rules
+                Use --installed to show only installed rules.
+
+  add <rule>    Add rules manually (space-separated)
+                Example: devkit add golang docker
+
+  remove <rule> Remove rules from project
+                Example: devkit remove flutter
+
   status        Show installation status
 
   uninstall     Remove devkit from current project
@@ -115,10 +123,11 @@ COMMANDS:
   version       Show version
 
 OPTIONS:
-  --force, -f   Force overwrite existing installation
-  --clean, -c   Remove rules for technologies no longer detected (with update)
-  --path=DIR    Specify project directory (default: current directory)
-  --help, -h    Show this help
+  --force, -f     Force overwrite existing installation
+  --clean, -c     Remove rules for technologies no longer detected (with update)
+  --installed, -i Show only installed rules (with rules command)
+  --path=DIR      Specify project directory (default: current directory)
+  --help, -h      Show this help
 
 EXAMPLES:
   devkit init                 # Initialize in current project
@@ -126,6 +135,10 @@ EXAMPLES:
   devkit update               # Update and re-detect technologies
   devkit update --clean       # Update and remove old rules
   devkit detect               # Show what would be detected
+  devkit rules                # List all available rules
+  devkit rules --installed    # Show installed rules
+  devkit add golang docker    # Add golang and docker rules
+  devkit remove flutter       # Remove flutter rule
   devkit status               # Show current installation
   devkit uninstall            # Remove from current project
 
@@ -211,6 +224,39 @@ const commands = {
     });
   },
 
+  // List available rules
+  rules: (options) => {
+    const projectPath = validatePath(options.path) || process.cwd();
+    return listRules({
+      path: projectPath,
+      installed: options.installed
+    });
+  },
+
+  // Add rules manually
+  add: (options) => {
+    const projectPath = validatePath(options.path) || process.cwd();
+    if (options.ruleArgs.length === 0) {
+      console.log('\n  Usage: devkit add <rule> [rule2 ...]');
+      console.log('  Example: devkit add golang docker\n');
+      console.log('  Run "devkit rules" to see available rules.\n');
+      return { success: false, reason: 'no_rules' };
+    }
+    return addRules(options.ruleArgs, { path: projectPath });
+  },
+
+  // Remove rules
+  remove: (options) => {
+    const projectPath = validatePath(options.path) || process.cwd();
+    if (options.ruleArgs.length === 0) {
+      console.log('\n  Usage: devkit remove <rule> [rule2 ...]');
+      console.log('  Example: devkit remove flutter\n');
+      console.log('  Run "devkit rules --installed" to see installed rules.\n');
+      return { success: false, reason: 'no_rules' };
+    }
+    return removeRules(options.ruleArgs, { path: projectPath });
+  },
+
   // List skills (from skills-index.json)
   list: () => {
     const indexPath = path.join(__dirname, '..', 'skills-index.json');

package/cli/rules.js

@@ -0,0 +1,248 @@
+/**
+ * Rules Management
+ *
+ * Add/remove rules manually for projects where auto-detection
+ * doesn't cover all needs.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { copyDir } = require('./utils');
+
+const PACKAGE_ROOT = path.join(__dirname, '..');
+
+/**
+ * Get all available rules from the rules/ directory
+ */
+function getAvailableRules() {
+  const rulesDir = path.join(PACKAGE_ROOT, 'rules');
+
+  if (!fs.existsSync(rulesDir)) {
+    return [];
+  }
+
+  return fs.readdirSync(rulesDir).filter(item => {
+    const itemPath = path.join(rulesDir, item);
+    return fs.statSync(itemPath).isDirectory() && !item.startsWith('.');
+  });
+}
+
+/**
+ * Get installed rules from devkit.json
+ */
+function getInstalledRules(projectDir) {
+  const configPath = path.join(projectDir, '.claude', 'devkit.json');
+
+  if (!fs.existsSync(configPath)) {
+    return { rules: [], manualRules: [] };
+  }
+
+  try {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    return {
+      rules: config.installedRules || [],
+      manualRules: config.manualRules || [],
+      detectedTypes: config.detectedTypes || []
+    };
+  } catch (e) {
+    return { rules: [], manualRules: [] };
+  }
+}
+
+/**
+ * Update devkit.json with new rules
+ */
+function updateDevkitConfig(projectDir, updates) {
+  const configPath = path.join(projectDir, '.claude', 'devkit.json');
+
+  if (!fs.existsSync(configPath)) {
+    console.log('  No devkit.json found. Run "devkit init" first.');
+    return false;
+  }
+
+  const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  Object.assign(config, updates, { updatedAt: new Date().toISOString() });
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  return true;
+}
+
+/**
+ * List all available rules
+ */
+function listRules(options = {}) {
+  const projectDir = options.path || process.cwd();
+  const available = getAvailableRules();
+  const { rules: installed, manualRules } = getInstalledRules(projectDir);
+  const allInstalled = [...new Set([...installed, ...manualRules])];
+
+  console.log('\n' + '='.repeat(50));
+  console.log('  AVAILABLE RULES');
+  console.log('='.repeat(50));
+
+  if (options.installed) {
+    // Show only installed rules
+    console.log('\nInstalled in this project:');
+    if (allInstalled.length === 0) {
+      console.log('  (none)');
+    } else {
+      allInstalled.forEach(rule => {
+        const isManual = manualRules.includes(rule);
+        console.log(`  - ${rule}${isManual ? ' (manual)' : ' (auto-detected)'}`);
+      });
+    }
+  } else {
+    // Show all available rules
+    console.log(`\nTotal: ${available.length} rules\n`);
+    available.forEach(rule => {
+      const isInstalled = allInstalled.includes(rule);
+      const marker = isInstalled ? '[x]' : '[ ]';
+      console.log(`  ${marker} ${rule}`);
+    });
+
+    console.log('\n  [x] = installed in current project');
+  }
+
+  console.log('');
+  return { available, installed: allInstalled };
+}
+
+/**
+ * Add rules to project
+ */
+function addRules(ruleNames, options = {}) {
+  const projectDir = options.path || process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+
+  if (!fs.existsSync(claudeDir)) {
+    console.log('\n  No .claude/ folder found. Run "devkit init" first.\n');
+    return { success: false, reason: 'not_initialized' };
+  }
+
+  const available = getAvailableRules();
+  const { rules: autoRules, manualRules = [] } = getInstalledRules(projectDir);
+  const allInstalled = [...new Set([...autoRules, ...manualRules])];
+
+  console.log('\n' + '='.repeat(50));
+  console.log('  ADD RULES');
+  console.log('='.repeat(50));
+
+  const added = [];
+  const skipped = [];
+  const notFound = [];
+
+  for (const ruleName of ruleNames) {
+    const rule = ruleName.toLowerCase();
+
+    if (!available.includes(rule)) {
+      notFound.push(rule);
+      console.log(`  [!] ${rule} - not found`);
+      continue;
+    }
+
+    if (allInstalled.includes(rule)) {
+      skipped.push(rule);
+      console.log(`  [-] ${rule} - already installed`);
+      continue;
+    }
+
+    // Copy rule files
+    const srcDir = path.join(PACKAGE_ROOT, 'rules', rule);
+    const destDir = path.join(claudeDir, 'rules', rule);
+
+    if (fs.existsSync(srcDir)) {
+      const count = copyDir(srcDir, destDir);
+      added.push(rule);
+      console.log(`  [+] ${rule} - added (${count} files)`);
+    }
+  }
+
+  // Update devkit.json
+  if (added.length > 0) {
+    const newManualRules = [...new Set([...manualRules, ...added])];
+    updateDevkitConfig(projectDir, { manualRules: newManualRules });
+  }
+
+  // Summary
+  console.log('\n' + '-'.repeat(50));
+  if (added.length > 0) {
+    console.log(`  Added: ${added.join(', ')}`);
+  }
+  if (skipped.length > 0) {
+    console.log(`  Skipped (already installed): ${skipped.join(', ')}`);
+  }
+  if (notFound.length > 0) {
+    console.log(`  Not found: ${notFound.join(', ')}`);
+    console.log(`  Run "devkit rules" to see available rules.`);
+  }
+  console.log('');
+
+  return { success: true, added, skipped, notFound };
+}
+
+/**
+ * Remove rules from project
+ */
+function removeRules(ruleNames, options = {}) {
+  const projectDir = options.path || process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+
+  if (!fs.existsSync(claudeDir)) {
+    console.log('\n  No .claude/ folder found.\n');
+    return { success: false, reason: 'not_initialized' };
+  }
+
+  const { rules: autoRules, manualRules = [] } = getInstalledRules(projectDir);
+
+  console.log('\n' + '='.repeat(50));
+  console.log('  REMOVE RULES');
+  console.log('='.repeat(50));
+
+  const removed = [];
+  const notInstalled = [];
+
+  for (const ruleName of ruleNames) {
+    const rule = ruleName.toLowerCase();
+    const ruleDir = path.join(claudeDir, 'rules', rule);
+
+    if (!fs.existsSync(ruleDir)) {
+      notInstalled.push(rule);
+      console.log(`  [-] ${rule} - not installed`);
+      continue;
+    }
+
+    // Remove rule directory
+    fs.rmSync(ruleDir, { recursive: true, force: true });
+    removed.push(rule);
+    console.log(`  [x] ${rule} - removed`);
+  }
+
+  // Update devkit.json
+  if (removed.length > 0) {
+    const newAutoRules = autoRules.filter(r => !removed.includes(r));
+    const newManualRules = manualRules.filter(r => !removed.includes(r));
+    updateDevkitConfig(projectDir, {
+      installedRules: newAutoRules,
+      manualRules: newManualRules
+    });
+  }
+
+  // Summary
+  console.log('\n' + '-'.repeat(50));
+  if (removed.length > 0) {
+    console.log(`  Removed: ${removed.join(', ')}`);
+  }
+  if (notInstalled.length > 0) {
+    console.log(`  Not installed: ${notInstalled.join(', ')}`);
+  }
+  console.log('');
+
+  return { success: true, removed, notInstalled };
+}
+
+module.exports = {
+  getAvailableRules,
+  getInstalledRules,
+  listRules,
+  addRules,
+  removeRules
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngxtm/devkit",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Per-project AI skills with smart tech detection - lightweight and context-optimized",
   "main": "cli/index.js",
   "bin": {
@@ -12,8 +12,7 @@
     "organize-rules": "node scripts/organize-rules.js",
     "generate-index": "node scripts/generate-index.js",
     "test": "node cli/index.js detect",
-    "sync": "python scripts/sync_all.py",
-    "sync:rules": "git clone --depth 1 https://github.com/ngxtm/skill-rule.git /tmp/skill-rule && cp -r /tmp/skill-rule/rules/* ./rules/ && rm -rf /tmp/skill-rule",
+    "sync:upstream": "node scripts/manual-sync.js",
     "validate": "python scripts/validate_skills.py"
   },
   "files": [