refacil-sdd-ai 4.4.0 → 4.5.0

package/agents/validator.md

@@ -1,6 +1,6 @@
 ---
 name: refacil-validator
-description: Validates implementation against SDD specs (CA/CR) and tests. Delegated by /refacil:verify — do not invoke directly. Read-only: does not apply fixes.
+description: Validates implementation against SDD specs (CA/CR) and tests. Delegated by /refacil:verify — do not invoke directly. Never modifies files.
 tools: Read, Grep, Glob, Bash
 model: sonnet
 ---

package/bin/cli.js

@@ -12,7 +12,9 @@ const compactBash = require('../lib/compact/bash');
 const {
   installSkills,
   installAgents,
+  installOpenCodeJson,
   removeSkills,
+  removeOpenCodeArtifacts,
   removeOpenspecLegacyAssets,
   createClaudeMd,
   createCursorRules,
@@ -22,15 +24,15 @@ const {
   checkNodeVersion,
   checkClaudeCodeVersion,
 } = require('../lib/installer');
-const { installHooks, uninstallHooks, cleanLegacySettingsHooks } = require('../lib/hooks');
+const { installHooks, uninstallHooks, cleanLegacySettingsHooks, installOpenCodePlugin, uninstallOpenCodePlugin } = require('../lib/hooks');
 const { handleCompact } = require('../lib/commands/compact');
 const { handleBus } = require('../lib/commands/bus');
-const { handleSdd, autoMigrateOpenspec } = require('../lib/commands/sdd');
+const { handleSdd, autoMigrateOpenspec, findProjectRoot } = require('../lib/commands/sdd');
 const { syncIgnoreFiles } = require('../lib/ignore-files');
 const { methodologyMigrationPending } = require('../lib/methodology-migration-pending');
 
 const packageRoot = path.resolve(__dirname, '..');
-const projectRoot = process.cwd();
+const projectRoot = findProjectRoot();
 
 // --- check-update (SessionStart) + notify-update (UserPromptSubmit) ---
 
@@ -119,10 +121,108 @@ function notifyUpdate() {
 function repoIsInitialized() {
   return (
     fs.existsSync(path.join(projectRoot, '.claude', 'skills')) ||
-    fs.existsSync(path.join(projectRoot, '.cursor', 'skills'))
+    fs.existsSync(path.join(projectRoot, '.cursor', 'skills')) ||
+    fs.existsSync(path.join(projectRoot, '.opencode', 'skills'))
   );
 }
 
+/**
+ * Inline readline-based multi-select for IDE targets.
+ * Shows a checklist of available IDEs and returns the selected ones.
+ * Falls back to all IDEs if stdin is not a TTY.
+ * @param {Array<{label: string, value: string, selected: boolean}>} options
+ * @returns {Promise<string[]>} selected values
+ */
+function readlineMultiSelect(options) {
+  return new Promise((resolve) => {
+    const readline = require('readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+    const selected = options.map((o) => o.selected);
+    let renderCount = 0;
+
+    function render() {
+      if (renderCount > 0) {
+        process.stdout.write(`\x1B[${options.length + 7}A\x1B[J`);
+      }
+      renderCount++;
+      console.log('\n  Select IDEs to install refacil-sdd-ai into:');
+      console.log('  (space = toggle, enter = confirm, a = toggle all)\n');
+      for (let i = 0; i < options.length; i++) {
+        const check = selected[i] ? '[x]' : '[ ]';
+        console.log(`  ${check} ${options[i].label}`);
+      }
+      console.log('\n  Enter numbers to toggle (e.g. 1,2,3) or "a" for all, then Enter to confirm:');
+    }
+
+    render();
+
+    rl.on('line', (line) => {
+      const input = line.trim().toLowerCase();
+      if (input === '') {
+        rl.close();
+        resolve(options.filter((_, i) => selected[i]).map((o) => o.value));
+        return;
+      }
+      if (input === 'a') {
+        const anySelected = selected.some(Boolean);
+        for (let i = 0; i < selected.length; i++) selected[i] = !anySelected;
+      } else {
+        const nums = input.split(/[\s,]+/).map(Number).filter((n) => !isNaN(n) && n >= 1 && n <= options.length);
+        for (const n of nums) selected[n - 1] = !selected[n - 1];
+      }
+      render();
+    });
+
+    rl.on('close', () => {
+      resolve(options.filter((_, i) => selected[i]).map((o) => o.value));
+    });
+  });
+}
+
+/**
+ * Show interactive IDE selector if TTY and --all not in args.
+ * Pre-selects IDEs by folder presence.
+ * Returns selected IDE dirs (e.g. ['.claude', '.cursor', '.opencode']).
+ */
+async function selectIDEs() {
+  const allFlag = process.argv.includes('--all');
+  const allIDEs = ['.claude', '.cursor', '.opencode'];
+
+  // --all or non-TTY: install all three
+  if (allFlag || !process.stdout.isTTY) {
+    return allIDEs;
+  }
+
+  const options = [
+    { label: 'Claude Code (.claude/)', value: '.claude', selected: fs.existsSync(path.join(projectRoot, '.claude')) },
+    { label: 'Cursor (.cursor/)', value: '.cursor', selected: fs.existsSync(path.join(projectRoot, '.cursor')) },
+    { label: 'OpenCode (.opencode/)', value: '.opencode', selected: fs.existsSync(path.join(projectRoot, '.opencode')) },
+  ];
+
+  // Try @clack/prompts first, fall back to inline readline
+  let selected;
+  try {
+    // @clack/prompts is an optional peer dep — try to load it without crashing if absent
+    const clack = require('@clack/prompts');
+    const result = await clack.multiselect({
+      message: 'Select IDEs to install refacil-sdd-ai into:',
+      options: options.map((o) => ({ label: o.label, value: o.value, selected: o.selected })),
+      required: false,
+    });
+    if (clack.isCancel(result)) {
+      console.log('\n  Installation cancelled.\n');
+      process.exit(0);
+    }
+    selected = result;
+  } catch (_) {
+    // @clack/prompts not available — use inline readline fallback
+    selected = await readlineMultiSelect(options);
+  }
+
+  return selected;
+}
+
 function semverGt(a, b) {
   if (!a || !b) return false;
   const pa = a.split('.').map(Number);
@@ -297,7 +397,7 @@ function checkReview() {
 
 // --- High-level commands ---
 
-function init() {
+async function init() {
   console.log('\n  refacil-sdd-ai: Initializing SDD-AI methodology...\n');
 
   const nodeOk = checkNodeVersion();
@@ -313,35 +413,67 @@ function init() {
     console.log('  Update with: npm install -g @anthropic-ai/claude-code\n');
   }
 
-  const count = installSkills(packageRoot, projectRoot);
-  console.log(`  ${count} skills installed in .claude/skills/ and .cursor/skills/`);
+  // Select target IDEs (interactive selector or --all / non-TTY)
+  const selectedIDEs = await selectIDEs();
+
+  if (selectedIDEs.length === 0) {
+    console.log('\n  No IDEs selected. Nothing installed.\n');
+    console.log('  Re-run with: refacil-sdd-ai init --all   to install for all IDEs');
+    process.exit(0);
+    return;
+  }
+
+  const installClaude = selectedIDEs.includes('.claude');
+  const installCursor = selectedIDEs.includes('.cursor');
+  const installOpenCode = selectedIDEs.includes('.opencode');
 
-  const agentsCount = installAgents(packageRoot, projectRoot);
+  const count = installSkills(packageRoot, projectRoot, selectedIDEs);
+  const ideList = selectedIDEs.map((d) => `${d}/skills/`).join(', ');
+  console.log(`  ${count} skills installed in ${ideList}`);
+
+  const agentsCount = installAgents(packageRoot, projectRoot, selectedIDEs);
   if (agentsCount > 0) {
-    console.log(`  ${agentsCount} sub-agents installed in .claude/agents/ and .cursor/agents/`);
+    const agentList = selectedIDEs.map((d) => `${d}/agents/`).join(', ');
+    console.log(`  ${agentsCount} sub-agents installed in ${agentList}`);
   }
 
   writeRepoVersion(projectRoot, getPackageVersion(packageRoot));
 
-  if (createClaudeMd(packageRoot, projectRoot)) console.log('  CLAUDE.md OK');
-  if (createCursorRules(packageRoot, projectRoot)) console.log('  .cursorrules OK');
+  if (installClaude) {
+    if (createClaudeMd(packageRoot, projectRoot)) console.log('  CLAUDE.md OK');
+    if (installHooks('.claude', projectRoot)) {
+      console.log('  Hook check-update added to .claude/settings.json');
+    }
+  }
 
-  if (installHooks('.claude', projectRoot)) {
-    console.log('  Hook check-update added to .claude/settings.json');
+  if (installCursor) {
+    if (createCursorRules(packageRoot, projectRoot)) console.log('  .cursorrules OK');
+    if (installHooks('.cursor', projectRoot)) {
+      console.log('  Hook check-update added to .cursor/hooks.json');
+    }
   }
-  if (installHooks('.cursor', projectRoot)) {
-    console.log('  Hook check-update added to .cursor/settings.json');
+
+  if (installOpenCode) {
+    try {
+      installOpenCodeJson(projectRoot);
+      console.log('  .opencode/opencode.json created/updated');
+    } catch (err) {
+      console.error(`  Warning: could not create opencode.json: ${err.message}`);
+    }
+    if (installHooks('.opencode', projectRoot)) {
+      console.log('  OpenCode plugin installed to .opencode/plugins/refacil-hooks.js');
+    }
   }
 
   try {
     const ignoreResult = syncIgnoreFiles(projectRoot);
     const s = ignoreResult.claude;
     if (s.status === 'created') {
-      console.log('  .claudeignore and .cursorignore created');
+      console.log('  .claudeignore, .cursorignore and .opencodeignore created');
     } else if (s.status === 'updated') {
-      console.log(`  .claudeignore and .cursorignore updated (${s.added} entries added)`);
+      console.log(`  .claudeignore, .cursorignore and .opencodeignore updated (${s.added} entries added)`);
     } else {
-      console.log('  .claudeignore and .cursorignore are up to date');
+      console.log('  .claudeignore, .cursorignore and .opencodeignore are up to date');
     }
   } catch (err) {
     console.error(`  Warning: could not sync ignore files: ${err.message}`);
@@ -359,7 +491,7 @@ function init() {
   }
 
   console.log('\n  Next steps:\n');
-  console.log('  1. RESTART your Claude Code or Cursor session');
+  console.log('  1. RESTART your IDE session');
   console.log('     (new skills are not detected until the session is restarted)\n');
   console.log('  2. Run: /refacil:setup');
   console.log('     (generates AGENTS.md for your project)\n');
@@ -368,12 +500,29 @@ function init() {
 function update() {
   console.log('\n  refacil-sdd-ai: Updating skills...\n');
 
-  const count = installSkills(packageRoot, projectRoot);
-  console.log(`  ${count} skills updated in .claude/skills/ and .cursor/skills/`);
+  // Detect installed IDEs by folder presence
+  const hasClaudeDir = fs.existsSync(path.join(projectRoot, '.claude'));
+  const hasCursorDir = fs.existsSync(path.join(projectRoot, '.cursor'));
+  const hasOpenCodeDir = fs.existsSync(path.join(projectRoot, '.opencode'));
+
+  const detectedIDEs = [
+    hasClaudeDir && '.claude',
+    hasCursorDir && '.cursor',
+    hasOpenCodeDir && '.opencode',
+  ].filter(Boolean);
+
+  const count = installSkills(packageRoot, projectRoot, detectedIDEs);
+  const installedDirs = detectedIDEs.map((d) => `${d}/skills/`);
+  console.log(`  ${count} skills updated in ${installedDirs.join(', ') || '(none detected)'}`);
 
-  const agentsCount = installAgents(packageRoot, projectRoot);
+  const agentsCount = installAgents(packageRoot, projectRoot, detectedIDEs);
   if (agentsCount > 0) {
-    console.log(`  ${agentsCount} sub-agents updated in .claude/agents/ and .cursor/agents/`);
+    const agentDirs = [
+      hasClaudeDir && '.claude/agents/',
+      hasCursorDir && '.cursor/agents/',
+      hasOpenCodeDir && '.opencode/agents/',
+    ].filter(Boolean);
+    console.log(`  ${agentsCount} sub-agents updated in ${agentDirs.join(', ')}`);
   }
 
   try {
@@ -387,25 +536,40 @@ function update() {
 
   writeRepoVersion(projectRoot, getPackageVersion(packageRoot));
 
-  createClaudeMd(packageRoot, projectRoot);
-  createCursorRules(packageRoot, projectRoot);
+  if (hasClaudeDir) {
+    createClaudeMd(packageRoot, projectRoot);
+    if (installHooks('.claude', projectRoot)) {
+      console.log('  Hook check-update added to .claude/settings.json');
+    }
+  }
 
-  if (installHooks('.claude', projectRoot)) {
-    console.log('  Hook check-update added to .claude/settings.json');
+  if (hasCursorDir) {
+    createCursorRules(packageRoot, projectRoot);
+    if (installHooks('.cursor', projectRoot)) {
+      console.log('  Hook check-update added to .cursor/hooks.json');
+    }
   }
-  if (installHooks('.cursor', projectRoot)) {
-    console.log('  Hook check-update added to .cursor/settings.json');
+
+  if (hasOpenCodeDir) {
+    try {
+      installOpenCodeJson(projectRoot);
+    } catch (err) {
+      console.error(`  Warning: could not update opencode.json: ${err.message}`);
+    }
+    if (installHooks('.opencode', projectRoot)) {
+      console.log('  OpenCode plugin updated at .opencode/plugins/refacil-hooks.js');
+    }
   }
 
   try {
     const ignoreResult = syncIgnoreFiles(projectRoot);
     const s = ignoreResult.claude;
     if (s.status === 'created') {
-      console.log('  .claudeignore and .cursorignore created');
+      console.log('  .claudeignore, .cursorignore and .opencodeignore created');
     } else if (s.status === 'updated') {
-      console.log(`  .claudeignore and .cursorignore updated (${s.added} entries added)`);
+      console.log(`  .claudeignore, .cursorignore and .opencodeignore updated (${s.added} entries added)`);
     } else {
-      console.log('  .claudeignore and .cursorignore are up to date');
+      console.log('  .claudeignore, .cursorignore and .opencodeignore are up to date');
     }
   } catch (err) {
     console.error(`  Warning: could not sync ignore files: ${err.message}`);
@@ -422,7 +586,7 @@ function update() {
     console.error(`  Warning: could not sync compact-guidance: ${err.message}`);
   }
 
-  console.log('\n  RESTART your Claude Code or Cursor session to apply the changes.\n');
+  console.log('\n  RESTART your IDE session to apply the changes.\n');
 }
 
 function clean() {
@@ -440,6 +604,19 @@ function clean() {
     console.log('  SDD-AI hooks removed from .cursor/settings.json');
   }
 
+  // Clean OpenCode artifacts if .opencode/ directory is present
+  if (fs.existsSync(path.join(projectRoot, '.opencode'))) {
+    try {
+      removeOpenCodeArtifacts(projectRoot);
+      console.log('  OpenCode skills and agents removed from .opencode/');
+    } catch (err) {
+      console.error(`  Warning: could not remove OpenCode artifacts: ${err.message}`);
+    }
+    if (uninstallOpenCodePlugin(projectRoot)) {
+      console.log('  OpenCode plugin removed from .opencode/plugins/');
+    }
+  }
+
   try {
     const result = removeCompactGuidance(projectRoot);
     if (result.status === 'removed') {
@@ -460,8 +637,10 @@ function help() {
   refacil-sdd-ai — SDD-AI Methodology
 
   Commands:
-    init          Install skills in .claude/ and .cursor/, create CLAUDE.md and .cursorrules
-    update        Re-copy skills (to update to a new package version)
+    init          Install skills in .claude/, .cursor/ and/or .opencode/ (interactive IDE selector).
+                  Use --all to install for all three IDEs without prompting.
+                  Creates CLAUDE.md, .cursorrules and .opencode/opencode.json as appropriate.
+    update        Re-copy skills for all detected IDEs (.claude/, .cursor/, .opencode/)
     migration-pending  Same validation as hooks/notify-update: list migrations (exit 1 if any; --json)
     check-update   Sync skills and compact-guidance at session start (SessionStart hook)
     notify-update  Notify methodology migration only if applicable (UserPromptSubmit hook)
@@ -496,18 +675,24 @@ function help() {
                     sdd mark-reviewed <name>       Write .review-passed (requires --verdict and --summary)
                     sdd tasks-update <name>        Mark task N as completed (--task N --done)
                     sdd validate-name <name>       Validate change name format
-    clean         Remove skills and SDD-AI hooks from .claude/settings.json and .cursor/settings.json
+    clean         Remove skills and SDD-AI hooks from all detected IDEs
+                  (.claude/settings.json, .cursor/hooks.json, .opencode/plugins/)
     help          Show this help
 
   Full flow:
     1. npm install -g refacil-sdd-ai
     2. refacil-sdd-ai init
-    3. RESTART the Claude Code or Cursor session
+    3. RESTART your IDE session (Claude Code, Cursor, or OpenCode)
     4. Run: /refacil:setup (generates AGENTS.md for your project)
 
+  IDE support:
+    - Claude Code: .claude/skills/, .claude/agents/, .claude/settings.json hooks
+    - Cursor:      .cursor/skills/, .cursor/agents/, .cursor/hooks.json hooks
+    - OpenCode:    .opencode/skills/, .opencode/agents/, .opencode/plugins/refacil-hooks.js
+
   Requirements:
-    - Node.js >= 20.19.0
-    - Claude Code >= 2.1.89 (required by compact-bash for silent rewrite) or Cursor
+    - Node.js >= 20.0.0
+    - Claude Code >= 2.1.89 (required by compact-bash for silent rewrite), Cursor, or OpenCode
   `);
 }
 
@@ -522,7 +707,10 @@ if (command === '--version' || command === '-v') {
 
 switch (command) {
   case 'init':
-    init();
+    init().catch((err) => {
+      console.error(`  Error during init: ${err.message}`);
+      process.exit(1);
+    });
     break;
   case 'update':
     update();
@@ -549,7 +737,7 @@ switch (command) {
     handleBus(process.argv[3], process.argv.slice(4), packageRoot);
     break;
   case 'sdd':
-    handleSdd(process.argv[3], process.argv.slice(4));
+    handleSdd(process.argv[3], process.argv.slice(4), projectRoot);
     break;
   case 'clean':
     clean();