codeninja 2.0.0 → 3.2.0

package/cli.js

@@ -3,320 +3,330 @@
 /**
  * codeninja CLI
  * Installs the codeninja agent system into any project.
+ * Detects the active IDE and writes the appropriate structure.
  *
  * Usage:
- *   codeninja init        Install into current directory
- *   codeninja help        Show available commands
- *   codeninja version     Show installed version
+ *   codeninja init              Auto-detect IDE and install
+ *   codeninja init --ide=<ide>  Force a specific IDE
+ *   codeninja help              Show available commands
+ *   codeninja version           Show installed version
+ *
+ * Supported IDEs:
+ *   antigravity   Google Antigravity IDE (.agents/ structure + slash commands)
+ *   cursor        Cursor IDE (.cursor/rules/ + .cursor/mcp.json)
+ *   vscode        VS Code / GitHub Copilot (.github/ + .vscode/mcp.json)
+ *   all           Install files for all three IDEs
  */
 
-const fs = require('fs');
+const fs   = require('fs');
 const path = require('path');
-const os = require('os');
+const os   = require('os');
 const { execSync } = require('child_process');
 
-const command = process.argv[2];
+const args      = process.argv.slice(2);
+const command   = args[0];
+const ideFlag   = (args.find(a => a.startsWith('--ide=')) || '').replace('--ide=', '');
+
 const projectRoot = process.cwd();
-const destDir = path.join(projectRoot, '.codeninja');
-const srcDir = path.dirname(__filename);
+const destDir     = path.join(projectRoot, '.codeninja');
+const srcDir      = path.dirname(__filename);
 
 // ─── Command Router ───────────────────────────────────────────────────────────
 
-if (!command || command === 'help') {
-    printHelp();
-    process.exit(0);
-}
-
+if (!command || command === 'help') { printHelp(); process.exit(0); }
 if (command === 'version') {
     const pkg = JSON.parse(fs.readFileSync(path.join(srcDir, 'package.json'), 'utf8'));
     console.log('codeninja v' + pkg.version);
     process.exit(0);
 }
-
-if (command === 'init') {
-    runInit();
-    process.exit(0);
-}
+if (command === 'init') { runInit(); process.exit(0); }
 
 console.error('Unknown command: ' + command + '\n');
 printHelp();
 process.exit(1);
 
+// ─── IDE Detection ────────────────────────────────────────────────────────────
+
+/**
+ * Detects which IDE is likely active by checking for known config files and env vars.
+ * @returns {'antigravity'|'cursor'|'vscode'|'unknown'}
+ */
+function detectIDE() {
+    // Antigravity: ~/.gemini/antigravity/ directory exists
+    if (process.env.ANTIGRAVITY_IDE ||
+        fs.existsSync(path.join(os.homedir(), '.gemini', 'antigravity'))) {
+        return 'antigravity';
+    }
+    // Cursor: ~/.cursor/ directory or Cursor-specific env vars
+    if (process.env.CURSOR_TRACE || process.env.CURSOR_SESSION_ID ||
+        fs.existsSync(path.join(os.homedir(), '.cursor'))) {
+        return 'cursor';
+    }
+    // VS Code: VSCODE_PID, terminal integration, or ~/.vscode/ exists
+    if (process.env.VSCODE_PID || process.env.TERM_PROGRAM === 'vscode' ||
+        fs.existsSync(path.join(os.homedir(), '.vscode'))) {
+        return 'vscode';
+    }
+    return 'unknown';
+}
+
 // ─── Init ─────────────────────────────────────────────────────────────────────
 
 function runInit() {
-    console.log('\ncodeninja — installing into ' + projectRoot + '\n');
+    let targetIDE  = ideFlag || detectIDE();
+    const installAll = targetIDE === 'all';
+
+    if (!ideFlag && targetIDE === 'unknown') {
+        console.log('\ncodeninja could not auto-detect your IDE.');
+        console.log('Installing for all supported IDEs instead.');
+        console.log('(Use --ide=antigravity | --ide=cursor | --ide=vscode to be specific)\n');
+        targetIDE = 'all';
+    }
+
+    const detectedLabel = ideFlag ? 'forced via --ide' : 'auto-detected';
+    console.log('\ncodeninja — installing into ' + projectRoot);
+    console.log('IDE: ' + (installAll ? 'all (antigravity + cursor + vscode)' : targetIDE)
+        + '  (' + detectedLabel + ')\n');
 
     if (fs.existsSync(destDir)) {
-        console.log('codeninja is already installed in this project.');
-        console.log('If you want to reinstall, delete the .codeninja folder first.\n');
+        console.log('codeninja is already installed. Delete .codeninja/ first to reinstall.\n');
         return;
     }
 
-    // Absolute path to mcp-server.js — used for Antigravity and Claude Desktop
-    // because they do not support relative or workspace-variable paths.
     const mcpServerAbsPath = path.join(destDir, 'mcp-server.js');
-
-    // Ensure .codeninja root exists
     fs.mkdirSync(destDir, { recursive: true });
 
-    // ── Step 1: Copy agent system files into .codeninja/ ────────────────────
-    console.log('[ 1/7 ]  Copying agent files...');
-    copyDir(path.join(srcDir, 'agent'), path.join(destDir, 'agent'));
+    // ── 1: Core agent files ────────────────────────────────────────────────
+    console.log('[ 1/6 ]  Copying core agent files...');
+    copyDir(path.join(srcDir, 'agent'),    path.join(destDir, 'agent'));
     copyDir(path.join(srcDir, 'commands'), path.join(destDir, 'commands'));
-    copyDir(path.join(srcDir, 'tasks'), path.join(destDir, 'tasks'));
-
-    fs.copyFileSync(
-        path.join(srcDir, 'mcp-server.js'),
-        path.join(destDir, 'mcp-server.js')
-    );
-
-    const innerPkg = {
-        name: 'codeninja-mcp',
-        private: true,
-        dependencies: { '@modelcontextprotocol/sdk': '^1.0.0' }
-    };
+    copyDir(path.join(srcDir, 'tasks'),    path.join(destDir, 'tasks'));
+    fs.copyFileSync(path.join(srcDir, 'mcp-server.js'), path.join(destDir, 'mcp-server.js'));
     fs.writeFileSync(
         path.join(destDir, 'package.json'),
-        JSON.stringify(innerPkg, null, 2),
+        JSON.stringify({ name: 'codeninja-mcp', private: true,
+            dependencies: { '@modelcontextprotocol/sdk': '^1.0.0' } }, null, 2),
         'utf8'
     );
 
-    // ── Step 2: Create context directory ──────────────────────────────────────
-    console.log('[ 2/7 ]  Creating context directory...');
+    // ── 2: Context directory ───────────────────────────────────────────────
+    console.log('[ 2/6 ]  Creating context directory...');
     fs.mkdirSync(path.join(destDir, 'context'), { recursive: true });
 
-    // ── Step 3: Install MCP SDK inside .codeninja/ ──────────────────────────
-    console.log('[ 3/7 ]  Installing MCP SDK...');
+    // ── 3: Install MCP SDK ─────────────────────────────────────────────────
+    console.log('[ 3/6 ]  Installing MCP SDK...');
     try {
         execSync('npm install', { cwd: destDir, stdio: 'inherit' });
     } catch (e) {
-        console.error('\nERROR: npm install failed inside .codeninja/');
-        console.error('Make sure npm is installed and you have internet access.');
-        console.error(e.message);
+        console.error('\nERROR: npm install failed inside .codeninja/\n' + e.message);
         process.exit(1);
     }
 
-    // ── Step 4: Write VS Code config ──────────────────────────────────────────
-    // VS Code global MCP config lives at ~/.vscode/mcp.json (user-level).
-    // We use absolute path since global config has no workspaceFolder context.
-    // We deep-merge — never overwrite other entries.
-    console.log('[ 4/7 ]  Writing VS Code global config (~/.vscode/mcp.json)...');
-    const vscodePath = path.join(os.homedir(), '.vscode', 'mcp.json');
-    writeGlobalMcpConfig(vscodePath, 'servers', {
-        type: 'stdio',
-        command: 'node',
-        args: [mcpServerAbsPath]
-    }, 'VS Code');
-
-    // ── Step 5: Write Cursor config ───────────────────────────────────────────
-    // Cursor global MCP config lives at ~/.cursor/mcp.json (user-level).
-    // We use absolute path since global config has no workspace context.
-    // We deep-merge — never overwrite other entries.
-    console.log('[ 5/7 ]  Writing Cursor global config (~/.cursor/mcp.json)...');
-    const cursorPath = path.join(os.homedir(), '.cursor', 'mcp.json');
-    writeGlobalMcpConfig(cursorPath, 'mcpServers', {
-        command: 'node',
-        args: [mcpServerAbsPath]
-    }, 'Cursor');
-
-    // ── Step 6: Write Antigravity config ──────────────────────────────────────
-    // Antigravity (Google's IDE) stores MCP config globally at:
-    //   ~/.gemini/antigravity/mcp_config.json  (Mac/Linux)
-    //   %USERPROFILE%\.gemini\antigravity\mcp_config.json  (Windows)
-    //
-    // IMPORTANT: Antigravity does NOT support ${workspaceFolder} or relative paths.
-    // The absolute path to mcp-server.js must be written here.
-    //
-    // Unlike VS Code and Cursor, this is a GLOBAL file shared across all projects.
-    // We deep-merge our entry into it — never overwrite the whole file.
-    console.log('[ 6/7 ]  Writing Antigravity config (~/.gemini/antigravity/mcp_config.json)...');
-    const antigravityConfigPath = path.join(
-        os.homedir(), '.gemini', 'antigravity', 'mcp_config.json'
-    );
-    writeAntigravityConfig(antigravityConfigPath, mcpServerAbsPath);
-
-    // ── Step 7: Update .gitignore if it already exists ────────────────────────
-    // We never create a .gitignore — that is the project's responsibility.
-    // The agent's generate-gitignore task already includes .codeninja/node_modules/
-    // in the .gitignore it writes during @initialize-project.
-    // This step handles the case where codeninja init runs on a project that
-    // already has a .gitignore but has NOT yet run @initialize-project.
-    console.log('[ 7/7 ]  Checking .gitignore...');
+    // ── 4: IDE-specific project files ─────────────────────────────────────
+    console.log('\n[ 4/6 ]  Writing IDE-specific files...');
+    const ides = installAll ? ['antigravity', 'cursor', 'vscode'] : [targetIDE];
+    for (const ide of ides) {
+        console.log('\n         ── ' + ide.toUpperCase() + ' ──');
+        if (ide === 'antigravity') installAntigravityFiles();
+        else if (ide === 'cursor') installCursorFiles();
+        else if (ide === 'vscode') installVSCodeFiles();
+        else console.log('         Unknown IDE: ' + ide + ' — skipped');
+    }
+
+    // ── 5: Global MCP configs ──────────────────────────────────────────────
+    console.log('\n[ 5/6 ]  Writing global MCP configs...');
+    if (installAll || targetIDE === 'vscode') {
+        writeGlobalMcpConfig(
+            path.join(os.homedir(), '.vscode', 'mcp.json'),
+            'servers', { type: 'stdio', command: 'node', args: [mcpServerAbsPath] }, 'VS Code'
+        );
+    }
+    if (installAll || targetIDE === 'cursor') {
+        writeGlobalMcpConfig(
+            path.join(os.homedir(), '.cursor', 'mcp.json'),
+            'mcpServers', { command: 'node', args: [mcpServerAbsPath] }, 'Cursor'
+        );
+    }
+    if (installAll || targetIDE === 'antigravity') {
+        writeAntigravityConfig(
+            path.join(os.homedir(), '.gemini', 'antigravity', 'mcp_config.json'),
+            mcpServerAbsPath
+        );
+    }
+
+    // ── 6: .gitignore ──────────────────────────────────────────────────────
+    console.log('\n[ 6/6 ]  Checking .gitignore...');
     const gitignorePath = path.join(projectRoot, '.gitignore');
-    const entry = '\n# codeninja — MCP server dependencies (do not commit)\n.codeninja/node_modules/\n';
+    const giEntry = '\n# codeninja — MCP server dependencies (do not commit)\n.codeninja/node_modules/\n';
     if (fs.existsSync(gitignorePath)) {
         const content = fs.readFileSync(gitignorePath, 'utf8');
         if (!content.includes('.codeninja/node_modules')) {
-            fs.appendFileSync(gitignorePath, entry, 'utf8');
+            fs.appendFileSync(gitignorePath, giEntry, 'utf8');
             console.log('         .gitignore updated ✓');
         } else {
-            console.log('         .gitignore already has entry — skipped');
+            console.log('         .gitignore already up to date — skipped');
         }
     } else {
-        console.log('         .gitignore not found — skipped');
-        console.log('         (The @initialize-project command will add this automatically)');
+        console.log('         No .gitignore found — skipped');
+        console.log('         (/codeninja:init will add this automatically)');
+    }
+
+    printInstallSummary(mcpServerAbsPath, ides);
+}
+
+// ─── IDE file installers ──────────────────────────────────────────────────────
+
+function installAntigravityFiles() {
+    const src  = path.join(srcDir, 'ide', 'antigravity', '.agents');
+    const dest = path.join(projectRoot, '.agents');
+    if (!fs.existsSync(src)) { console.log('         [SKIP] ide/antigravity source not found'); return; }
+    copyDir(src, dest);
+    const personaCount = countFiles(path.join(dest, 'personas'));
+    const skillCount   = countDirs(path.join(dest, 'skills'));
+    const wfCount      = countFiles(path.join(dest, 'workflows'));
+    console.log('         .agents/personas/ (' + personaCount + ' personas) ✓');
+    console.log('           global-orchestrator · nodejs-backend · database-architect · reactjs-frontend');
+    console.log('         .agents/skills/ (' + skillCount + ' skill domains) ✓');
+    console.log('           mcp-and-context · api-builder · database · reactjs · code-intelligence');
+    console.log('         .agents/workflows/ (' + wfCount + ' slash commands) ✓');
+}
+
+function installCursorFiles() {
+    const src  = path.join(srcDir, 'ide', 'cursor', '.cursor');
+    const dest = path.join(projectRoot, '.cursor');
+    if (!fs.existsSync(src)) { console.log('         [SKIP] ide/cursor source not found'); return; }
+    copyDir(src, dest);
+    const ruleCount = countFiles(path.join(dest, 'rules'));
+    console.log('         .cursor/rules/ (' + ruleCount + ' scoped rule files) ✓');
+    console.log('           01-global-orchestrator · 02-mcp-and-context · 03-api-builder');
+    console.log('           04-database · 05-reactjs · 06-code-intelligence');
+    console.log('         .cursor/mcp.json ✓');
+}
+
+function installVSCodeFiles() {
+    const ideSrc = path.join(srcDir, 'ide', 'vscode');
+
+    const githubSrc  = path.join(ideSrc, '.github');
+    const githubDest = path.join(projectRoot, '.github');
+    if (fs.existsSync(githubSrc)) {
+        copyDir(githubSrc, githubDest);
+        console.log('         .github/copilot-instructions.md ✓');
     }
 
-    // ── Done ──────────────────────────────────────────────────────────────────
-    printInstallSummary(mcpServerAbsPath);
+    const vscodeSrc  = path.join(ideSrc, '.vscode');
+    const vscodeDest = path.join(projectRoot, '.vscode');
+    if (fs.existsSync(vscodeSrc)) {
+        fs.mkdirSync(vscodeDest, { recursive: true });
+        const mcpDest = path.join(vscodeDest, 'mcp.json');
+        if (!fs.existsSync(mcpDest)) {
+            fs.copyFileSync(path.join(vscodeSrc, 'mcp.json'), mcpDest);
+            console.log('         .vscode/mcp.json ✓');
+        } else {
+            console.log('         .vscode/mcp.json already exists — skipped');
+        }
+    }
 }
 
-// ─── Global MCP Config Writer (VS Code & Cursor) ──────────────────────────────
+// ─── Config Writers ───────────────────────────────────────────────────────────
 
 function writeGlobalMcpConfig(configPath, serversKey, entry, ideName) {
     try {
         fs.mkdirSync(path.dirname(configPath), { recursive: true });
-
         let existing = {};
-
         if (fs.existsSync(configPath)) {
-            try {
-                existing = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-            } catch {
-                console.log('         Warning: existing ' + path.basename(configPath) + ' could not be parsed — will overwrite.');
-            }
+            try { existing = JSON.parse(fs.readFileSync(configPath, 'utf8')); }
+            catch { console.log('         Warning: ' + path.basename(configPath) + ' could not be parsed — overwriting.'); }
         }
-
         if (!existing[serversKey]) existing[serversKey] = {};
-
-        const current = existing[serversKey].codeninja;
-        if (current && JSON.stringify(current.args) === JSON.stringify(entry.args)) {
-            console.log('         ' + ideName + ' global config already has codeninja entry — skipped');
+        const cur = existing[serversKey].codeninja;
+        if (cur && JSON.stringify(cur.args) === JSON.stringify(entry.args)) {
+            console.log('         ' + ideName + ' global config already current — skipped');
             return;
         }
-
         existing[serversKey].codeninja = entry;
         fs.writeFileSync(configPath, JSON.stringify(existing, null, 2), 'utf8');
-        console.log('         ' + configPath + ' written ✓');
+        console.log('         ' + configPath + ' ✓');
     } catch (e) {
-        console.log('         ' + ideName + ' global config skipped — could not write: ' + e.message);
+        console.log('         ' + ideName + ' global config skipped: ' + e.message);
     }
 }
 
-// ─── Antigravity Config Writer ────────────────────────────────────────────────
-
 function writeAntigravityConfig(configPath, mcpServerAbsPath) {
-    const newEntry = {
-        command: 'node',
-        args: [mcpServerAbsPath]
-    };
-
     try {
         fs.mkdirSync(path.dirname(configPath), { recursive: true });
-
         let existing = { mcpServers: {} };
-
-        // If the file already exists, read and parse it safely.
-        // We deep-merge — never overwrite other entries the developer has added.
         if (fs.existsSync(configPath)) {
-            try {
-                const raw = fs.readFileSync(configPath, 'utf8');
-                const parsed = JSON.parse(raw);
-                existing = parsed;
-            } catch {
-                // File is corrupt or empty — start fresh but preserve the file
-                console.log('         Warning: existing mcp_config.json could not be parsed — will overwrite.');
-            }
+            try { existing = JSON.parse(fs.readFileSync(configPath, 'utf8')); }
+            catch { console.log('         Warning: mcp_config.json parse failed — overwriting.'); }
         }
-
         if (!existing.mcpServers) existing.mcpServers = {};
-
-        // Check if our entry is already there with the same path — skip if so
-        const current = existing.mcpServers.codeninja;
-        if (current && current.args && current.args[0] === mcpServerAbsPath) {
-            console.log('         Antigravity config already has codeninja entry — skipped');
+        const cur = existing.mcpServers.codeninja;
+        if (cur && cur.args && cur.args[0] === mcpServerAbsPath) {
+            console.log('         Antigravity config already current — skipped');
             return;
         }
-
-        // Write our entry (adds or updates only the codeninja key)
-        existing.mcpServers.codeninja = newEntry;
-
+        existing.mcpServers.codeninja = { command: 'node', args: [mcpServerAbsPath] };
         fs.writeFileSync(configPath, JSON.stringify(existing, null, 2), 'utf8');
-        console.log('         ~/.gemini/antigravity/mcp_config.json written ✓');
-
+        console.log('         ~/.gemini/antigravity/mcp_config.json ✓');
     } catch (e) {
-        // Antigravity may not be installed — this is non-fatal
-        console.log('         Antigravity config skipped — could not write: ' + e.message);
-        console.log('         (This is fine if you are not using Antigravity IDE)');
+        console.log('         Antigravity config skipped: ' + e.message);
+        console.log('         (OK if Antigravity is not installed)');
     }
 }
 
 // ─── Summary ──────────────────────────────────────────────────────────────────
 
-function printInstallSummary(mcpServerAbsPath) {
+function printInstallSummary(mcpServerAbsPath, ides) {
     const platform = process.platform;
-
-    // Claude Desktop config path varies by OS
-    let claudeConfigPath;
-    if (platform === 'win32') {
-        claudeConfigPath = path.join(process.env.APPDATA || '%APPDATA%', 'Claude', 'claude_desktop_config.json');
-    } else if (platform === 'darwin') {
-        claudeConfigPath = path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
-    } else {
-        claudeConfigPath = path.join(os.homedir(), '.config', 'claude', 'claude_desktop_config.json');
-    }
+    const claudeConfigPath = platform === 'win32'
+        ? path.join(process.env.APPDATA || '%APPDATA%', 'Claude', 'claude_desktop_config.json')
+        : platform === 'darwin'
+            ? path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+            : path.join(os.homedir(), '.config', 'claude', 'claude_desktop_config.json');
+
+    let ideNotes = '';
+    if (ides.includes('antigravity')) ideNotes += `
+  Antigravity → ... → MCP Servers → Manage MCP Servers → Refresh
+  Structure installed:
+    .agents/personas/   4 personas (global-orchestrator, nodejs-backend, database-architect, reactjs-frontend)
+    .agents/skills/     5 skill domains (mcp-and-context, api-builder, database, reactjs, code-intelligence)
+    .agents/workflows/  20 slash commands
+  Slash commands: /codeninja:init  /codeninja:api  /codeninja:design  /codeninja:audit
+                  /codeninja:test  /codeninja:refactor  /codeninja:sync
+                  /codeninja:explain  /codeninja:review  /codeninja:debug  /codeninja:optimize
+                  /codeninja:db:create  /codeninja:db:modify  /codeninja:db:index
+                  /codeninja:db:drop  /codeninja:db:seed  /codeninja:db:sync
+                  @modularize  @validate-page  @integrate-api
+`;
+    if (ides.includes('cursor'))      ideNotes += `
+  Cursor → reopen project → use /codeninja:* in AI Chat
+  Rules installed: 6 scoped .mdc files (auto-loaded per file type)
+    01-global-orchestrator  02-mcp-and-context  03-api-builder
+    04-database  05-reactjs  06-code-intelligence
+`;
+    if (ides.includes('vscode'))      ideNotes += `
+  VS Code → reopen project → use @workspace /codeninja:* in Copilot Chat
+`;
 
     console.log(`
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   codeninja installed successfully
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  ✓  .codeninja/                  agent files installed
-  ✓  ~/.vscode/mcp.json            VS Code configured (global)
-  ✓  ~/.cursor/mcp.json            Cursor configured (global)
-  ✓  ~/.gemini/antigravity/        Antigravity configured (global)
-
+${ideNotes}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  CLAUDE DESKTOP  (manual step — one time only)
+  CLAUDE DESKTOP  (manual — one time only)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  Open this file:
-    ${claudeConfigPath}
-
-  Add this inside the "mcpServers" object:
+  File: ${claudeConfigPath}
 
+  Add inside "mcpServers":
     "codeninja": {
       "command": "node",
       "args": ["${mcpServerAbsPath}"]
     }
 
-  Save and restart Claude Desktop.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  IDE NOTES
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  VS Code   — reopen this project to activate the MCP server
-  Cursor    — reopen this project to activate the MCP server
-  Antigravity — go to ... → MCP Servers → Manage MCP Servers
-                and click Refresh to pick up the new entry
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  AVAILABLE COMMANDS  (type in your AI chat)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  @initialize-project    Bootstrap a new service or database
-  @create-api            Add a new API module to a service
-  @design                Plan a feature before coding
-  @audit                 Security and quality review
-  @test                  Generate Jest test files
-  @refactor              Rename with full context tracking
-  @sync                  Rebuild context from repo
-
-  Database commands:
-  @db:create-table       Design and generate a new table
-  @db:modify-table       Add / rename / drop a column
-  @db:add-index          Add a new index
-  @db:drop-table         Generate a DROP migration
-  @db:seed               Add seed data
-  @db:sync               Rebuild DB schema in context
-
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-  Next step: open this project in your IDE,
-  then type @initialize-project to get started.
-
+  Next: open project in your IDE → /codeninja:init
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 `);
 }
@@ -326,27 +336,42 @@ function printHelp() {
 codeninja — AI agent scaffolding system
 
 Usage:
-  codeninja init       Install into the current project directory
-  codeninja version    Show the installed version
-  codeninja help       Show this help message
-
-After running init, open your project in VS Code, Cursor, or Antigravity.
-The MCP server connects automatically.
+  codeninja init               Install (auto-detects IDE)
+  codeninja init --ide=<ide>   Force a specific IDE
+  codeninja version            Show version
+  codeninja help               Show this help
+
+IDE values for --ide:
+  antigravity  →  .agents/ structure (slash commands)
+  cursor       →  .cursor/rules/ + mcp.json
+  vscode       →  .github/copilot-instructions.md + .vscode/mcp.json
+  all          →  all three IDEs
+
+Examples:
+  codeninja init
+  codeninja init --ide=antigravity
+  codeninja init --ide=all
 `);
 }
 
-// ─── Helpers ─────────────────────────────────────────────────────────────────
+// ─── Helpers ──────────────────────────────────────────────────────────────────
 
 function copyDir(src, dest) {
     if (!fs.existsSync(src)) return;
     fs.mkdirSync(dest, { recursive: true });
     for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-        const srcPath = path.join(src, entry.name);
-        const destPath = path.join(dest, entry.name);
-        if (entry.isDirectory()) {
-            copyDir(srcPath, destPath);
-        } else {
-            fs.copyFileSync(srcPath, destPath);
-        }
+        const s = path.join(src, entry.name);
+        const d = path.join(dest, entry.name);
+        entry.isDirectory() ? copyDir(s, d) : fs.copyFileSync(s, d);
     }
-}
+}
+
+function countFiles(dir) {
+    if (!fs.existsSync(dir)) return 0;
+    return fs.readdirSync(dir).filter(f => fs.statSync(path.join(dir, f)).isFile()).length;
+}
+
+function countDirs(dir) {
+    if (!fs.existsSync(dir)) return 0;
+    return fs.readdirSync(dir).filter(f => fs.statSync(path.join(dir, f)).isDirectory()).length;
+}