@exchanet/enet 1.0.16 → 1.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exchanet/enet",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "enet — exchanet methods manager. Install, scaffold and manage AI coding methods.",
   "bin": {
     "enet": "src/index.js"

package/src/commands/install.js

@@ -2,7 +2,8 @@ import chalk from 'chalk'
 import ora from 'ora'
 import fs from 'fs-extra'
 import path from 'path'
-import readline from 'readline'
+import enquirer from 'enquirer'
+const { MultiSelect } = enquirer
 import { detectSystemAgents, getInstallPath, AGENTS } from '../utils/agent_detector.js'
 import { getMethod, fetchFromGitHub, readInstallRecord, writeInstallRecord } from '../utils/registry.js'
 
@@ -19,7 +20,12 @@ export async function installCommand(methodId, options) {
   }
 
   console.log(chalk.bold(`\n  ◆ ${method.name}`))
-  console.log(chalk.dim(`  ${method.description}\n`))
+  console.log(chalk.dim(`  ${method.description}`))
+  if (options.global) {
+    console.log(chalk.cyan('  Destination: global (home) — available for all agents/projects\n'))
+  } else {
+    console.log(chalk.dim(`  Destination: current project (use ${chalk.white('--global')} for all agents)\n`))
+  }
 
   // 2. Read existing install record — know what is already installed
   const record = await readInstallRecord(methodId)
@@ -55,7 +61,7 @@ export async function installCommand(methodId, options) {
       targetAgents = detected
     } else {
       // Always show checkbox — even with 1 agent, even on re-run
-      targetAgents = await checkboxSelect(detected, method, alreadyInstalled)
+      targetAgents = await checkboxSelect(detected, method, alreadyInstalled, options)
     }
 
     if (targetAgents.length === 0) {
@@ -84,14 +90,10 @@ export async function installCommand(methodId, options) {
 }
 
 // ─────────────────────────────────────────────────────────────────
-// Checkbox selection UI
-//
-// Shows all detected agents with tags:
-//   — installed   already present on disk for this method
-//   — new         detected but never installed for this method
+// Adapter selection via Enquirer (works on Windows/PowerShell)
 // ─────────────────────────────────────────────────────────────────
 
-async function checkboxSelect(detected, method, alreadyInstalled = new Set()) {
+async function checkboxSelect(detected, method, alreadyInstalled = new Set(), options = {}) {
   const available   = detected.filter(a =>  method.adapters[a.key] || method.adapters['generic'])
   const unavailable = detected.filter(a => !method.adapters[a.key] && !method.adapters['generic'])
 
@@ -101,76 +103,42 @@ async function checkboxSelect(detected, method, alreadyInstalled = new Set()) {
     process.exit(1)
   }
 
-  const items = available.map(a => ({
-    agent:       a,
-    checked:     true,
-    installed:   alreadyInstalled.has(a.key),
-    usesGeneric: !method.adapters[a.key]
-  }))
-
-  console.log(chalk.white('  Select adapters to install:\n'))
-
-  return new Promise((resolve) => {
-    let cursor = 0
-
-    const lineCount = () => items.length + (unavailable.length > 0 ? 3 : 2) + 2
+  if (unavailable.length > 0) {
+    console.log(chalk.dim(`  No adapter for: ${unavailable.map(a => a.name).join(', ')}\n`))
+  }
 
-    const render = () => {
-      if (render.drawn) process.stdout.write(`\x1B[${lineCount()}A`)
-      render.drawn = true
+  const installScope = options.global ? 'global (home)' : 'current project'
+  const prompt = new MultiSelect({
+    name: 'agents',
+    message: `Select adapters to install (destination: ${installScope})`,
+    choices: available.map(a => ({
+      name: a.key,
+      message: `${a.name}${alreadyInstalled.has(a.key) ? ' — installed' : ' — new'}${!method.adapters[a.key] ? ' (generic)' : ''}`,
+      value: a,
+      enabled: true
+    })),
+    result (names) {
+      return this.options.choices.filter(c => names.includes(c.name)).map(c => c.value)
+    }
+  })
 
-      items.forEach((item, i) => {
-        const isCursor = i === cursor
-        const box     = item.checked     ? chalk.green('[✓]')           : chalk.dim('[ ]')
-        const arrow   = isCursor         ? chalk.cyan(' ❯ ')            : '   '
-        const name    = isCursor         ? chalk.white(item.agent.name) : chalk.dim(item.agent.name)
-        const status  = item.installed   ? chalk.dim(' — installed')    : chalk.yellow(' — new')
-        const generic = item.usesGeneric ? chalk.dim(' (generic adapter)') : ''
-        process.stdout.write(`${arrow}${box} ${name}${status}${generic}\n`)
-      })
+  if (!process.stdin.isTTY) {
+    return available
+  }
 
-      if (unavailable.length > 0) {
-        process.stdout.write(chalk.dim(`\n  No adapter for: ${unavailable.map(a => a.name).join(', ')}\n`))
-      }
-      process.stdout.write('\n')
-      process.stdout.write(chalk.dim('  ↑↓ navigate · Space toggle · A all · Enter confirm · Ctrl+C cancel\n\n'))
+  try {
+    const selected = await prompt.run()
+    if (selected && selected.length > 0) {
+      console.log(chalk.dim(`\n  Installing for: ${selected.map(a => a.name).join(', ')}\n`))
     }
-
-    render()
-
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-    if (process.stdin.isTTY) process.stdin.setRawMode(true)
-    process.stdin.resume()
-
-    process.stdin.on('data', (key) => {
-      const k = key.toString()
-      if      (k === '\u001b[A') { cursor = (cursor - 1 + items.length) % items.length; render() }
-      else if (k === '\u001b[B') { cursor = (cursor + 1) % items.length; render() }
-      else if (k === ' ')        { items[cursor].checked = !items[cursor].checked; render() }
-      else if (k === 'a' || k === 'A') {
-        const all = items.every(i => i.checked)
-        items.forEach(i => { i.checked = !all })
-        render()
-      }
-      else if (k === '\r' || k === '\n') {
-        if (process.stdin.isTTY) process.stdin.setRawMode(false)
-        process.stdin.pause()
-        rl.close()
-        const selected = items.filter(i => i.checked).map(i => i.agent)
-        if (selected.length > 0) {
-          console.log(chalk.dim(`\n  Installing for: ${selected.map(a => a.name).join(', ')}\n`))
-        }
-        resolve(selected)
-      }
-      else if (k === '\u0003') {
-        if (process.stdin.isTTY) process.stdin.setRawMode(false)
-        process.stdin.pause()
-        rl.close()
-        console.log('\n')
-        process.exit(0)
-      }
-    })
-  })
+    return selected || []
+  } catch (err) {
+    if (err.name === 'ENOTTY' || err.message?.includes('cancel')) {
+      console.log(chalk.dim('\n  Cancelled.\n'))
+      process.exit(0)
+    }
+    throw err
+  }
 }
 
 // ─────────────────────────────────────────────────────────────────

package/src/commands/update.js

@@ -2,9 +2,10 @@ import chalk from 'chalk'
 import ora from 'ora'
 import fs from 'fs-extra'
 import path from 'path'
-import readline from 'readline'
+import enquirer from 'enquirer'
+const { MultiSelect } = enquirer
 import { getAllMethods, getMethod, fetchFromGitHub, readInstallRecord, writeInstallRecord } from '../utils/registry.js'
-import { detectSystemAgents, getInstallPath, AGENTS } from '../utils/agent_detector.js'
+import { detectSystemAgents, detectAgent, getInstallPath, AGENTS } from '../utils/agent_detector.js'
 import { installForAgent } from './install.js'
 
 export async function updateCommand(methodId, options) {
@@ -27,11 +28,20 @@ export async function updateCommand(methodId, options) {
   console.log(chalk.bold('\n  ◆ enet update\n'))
 
   let totalUpdated = 0, totalAdded = 0, totalSkipped = 0
+  const currentAgent = await detectAgent()
 
   for (const method of targets) {
-    const record = await readInstallRecord(method.id)
+    let record = await readInstallRecord(method.id)
+
+    // If no record but adapter file exists (e.g. list shows "installed"), treat as installed for current agent
+    if ((!record || record.agents.length === 0) && currentAgent) {
+      const pathForCurrent = getInstallPath(currentAgent, method.id)
+      if (await fs.pathExists(pathForCurrent)) {
+        record = { agents: [currentAgent.key], version: record?.version, updatedAt: record?.updatedAt }
+        await writeInstallRecord(method.id, { agents: record.agents, version: method.version })
+      }
+    }
 
-    // Skip methods not installed at all
     if (!record || record.agents.length === 0) {
       totalSkipped++
       console.log(chalk.dim(`  ${method.name} — not installed, skipping`))
@@ -149,66 +159,36 @@ async function updateOneAdapter(method, agent, options = {}) {
 }
 
 // ─────────────────────────────────────────────────────────────────
-// Checkbox for new agents only (shown during update)
+// New agents selection during update (Enquirer, Windows-safe)
 // ─────────────────────────────────────────────────────────────────
 
 async function checkboxSelectNew(newAgents, method) {
-  const items = newAgents.map(a => ({
-    agent:       a,
-    checked:     true,
-    usesGeneric: !method.adapters[a.key]
-  }))
-
-  return new Promise((resolve) => {
-    let cursor = 0
-    const lineCount = () => items.length + 4
-
-    const render = () => {
-      if (render.drawn) process.stdout.write(`\x1B[${lineCount()}A`)
-      render.drawn = true
-
-      items.forEach((item, i) => {
-        const isCursor = i === cursor
-        const box     = item.checked     ? chalk.green('[✓]')           : chalk.dim('[ ]')
-        const arrow   = isCursor         ? chalk.cyan(' ❯ ')            : '   '
-        const name    = isCursor         ? chalk.white(item.agent.name) : chalk.dim(item.agent.name)
-        const generic = item.usesGeneric ? chalk.dim(' (generic adapter)') : ''
-        process.stdout.write(`${arrow}${box} ${name}${generic}\n`)
-      })
-
-      process.stdout.write('\n')
-      process.stdout.write(chalk.dim('  ↑↓ navigate · Space toggle · A all · Enter confirm · Ctrl+C cancel\n\n'))
-    }
+  if (newAgents.length === 0) return []
 
-    render()
-
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-    if (process.stdin.isTTY) process.stdin.setRawMode(true)
-    process.stdin.resume()
-
-    process.stdin.on('data', (key) => {
-      const k = key.toString()
-      if      (k === '\u001b[A') { cursor = (cursor - 1 + items.length) % items.length; render() }
-      else if (k === '\u001b[B') { cursor = (cursor + 1) % items.length; render() }
-      else if (k === ' ')        { items[cursor].checked = !items[cursor].checked; render() }
-      else if (k === 'a' || k === 'A') {
-        const all = items.every(i => i.checked)
-        items.forEach(i => { i.checked = !all })
-        render()
-      }
-      else if (k === '\r' || k === '\n') {
-        if (process.stdin.isTTY) process.stdin.setRawMode(false)
-        process.stdin.pause()
-        rl.close()
-        resolve(items.filter(i => i.checked).map(i => i.agent))
-      }
-      else if (k === '\u0003') {
-        if (process.stdin.isTTY) process.stdin.setRawMode(false)
-        process.stdin.pause()
-        rl.close()
-        console.log('\n')
-        process.exit(0)
-      }
-    })
+  if (!process.stdin.isTTY) {
+    return newAgents
+  }
+
+  const prompt = new MultiSelect({
+    name: 'newAgents',
+    message: 'Add these agents for this method?',
+    choices: newAgents.map(a => ({
+      name: a.key,
+      message: `${a.name}${!method.adapters[a.key] ? ' (generic adapter)' : ''}`,
+      value: a,
+      enabled: true
+    })),
+    result (names) {
+      return this.options.choices.filter(c => names.includes(c.name)).map(c => c.value)
+    }
   })
+
+  try {
+    return await prompt.run() || []
+  } catch (err) {
+    if (err.name === 'ENOTTY' || err.message?.includes('cancel')) {
+      return []
+    }
+    throw err
+  }
 }

package/src/utils/agent_detector.js

@@ -1,189 +1,189 @@
-import fs from 'fs-extra'
-import path from 'path'
-import os from 'os'
-
-const HOME = os.homedir()
-
-export const AGENTS = {
-  cursor: {
-    name: 'Cursor',
-    systemSignals: [
-      path.join(HOME, '.cursor'),
-      path.join(HOME, 'Library', 'Application Support', 'Cursor'),   // macOS
-      path.join(HOME, 'AppData', 'Roaming', 'Cursor'),               // Windows
-      path.join(HOME, '.config', 'Cursor'),                          // Linux
-    ],
-    projectSignals: ['.cursor/rules', '.cursor'],
-    projectInstallDir: '.cursor/rules',
-    globalInstallDir: path.join(HOME, '.cursor', 'rules'),
-    filename: 'enet-{id}.md',
-    configNote: 'Rule auto-applies to all files (alwaysApply: true)'
-  },
-
-  windsurf: {
-    name: 'Windsurf',
-    systemSignals: [
-      path.join(HOME, '.codeium', 'windsurf'),
-      path.join(HOME, 'Library', 'Application Support', 'Windsurf'), // macOS
-      path.join(HOME, 'AppData', 'Roaming', 'Windsurf'),             // Windows
-    ],
-    projectSignals: ['.windsurfrules', '.windsurf'],
-    projectInstallDir: '.',
-    globalInstallDir: path.join(HOME, '.codeium', 'windsurf', 'memories'),
-    globalFilename: 'global_rules.md',
-    filename: '.windsurfrules',
-    configNote: 'Appended to .windsurfrules in project root'
-  },
-
-  antigravity: {
-    name: 'Antigravity (Google)',
-    systemSignals: [
-      path.join(HOME, '.gemini', 'antigravity'),
-      path.join(HOME, 'Library', 'Application Support', 'Google', 'Antigravity'), // macOS
-      path.join(HOME, 'AppData', 'Roaming', 'Google', 'Antigravity'),             // Windows
-    ],
-    projectSignals: ['.agent/rules', '.agent'],
-    projectInstallDir: '.agent/rules',
-    // globalInstallDir is a base — getInstallPath() resolves the full path dynamically:
-    // ~/.gemini/antigravity/skills/method-{id}/SKILL.md
-    globalInstallDir: path.join(HOME, '.gemini', 'antigravity', 'skills'),
-    globalFilename: 'SKILL.md',
-    filename: 'enet-{id}.md',
-    configNote: 'Rule placed in .agent/rules/ — activates automatically in Antigravity'
-  },
-
-  claudecode: {
-    name: 'Claude Code',
-    systemSignals: [
-      path.join(HOME, '.claude'),
-    ],
-    projectSignals: ['CLAUDE.md', '.claude'],
-    projectInstallDir: '.',
-    globalInstallDir: path.join(HOME, '.claude'),
-    globalFilename: 'CLAUDE.md',
-    filename: 'CLAUDE.md',
-    configNote: 'Written to CLAUDE.md — Claude Code reads this automatically'
-  },
-
-  copilot: {
-    name: 'GitHub Copilot',
-    // Copilot is a VS Code extension — detect by checking the extensions folder
-    // for a github.copilot-* subfolder, not just the presence of .vscode/
-    systemSignals: [
-      path.join(HOME, '.vscode', 'extensions'),                                         // Linux / Windows
-      path.join(HOME, 'Library', 'Application Support', 'Code', 'User', 'extensions'), // macOS
-      path.join(HOME, 'AppData', 'Roaming', 'Code', 'User', 'extensions'),             // Windows alt
-      path.join(HOME, '.vscode-server', 'extensions'),                                  // remote / SSH
-    ],
-    systemSignalFilter: (signalPath) => {
-      // Only return true if a github.copilot extension folder exists inside
-      try {
-        const entries = fs.readdirSync(signalPath)
-        return entries.some(e => e.toLowerCase().startsWith('github.copilot'))
-      } catch {
-        return false
-      }
-    },
-    projectSignals: ['.github/copilot-instructions.md'],
-    projectInstallDir: '.github',
-    globalInstallDir: null, // Copilot has no global rules path
-    filename: 'copilot-instructions.md',
-    configNote: 'Written to .github/copilot-instructions.md'
-  },
-
-  generic: {
-    name: 'Generic / Other agent',
-    systemSignals: [],
-    projectSignals: [],
-    projectInstallDir: '.enet',
-    globalInstallDir: null,
-    filename: '{id}.md',
-    configNote: 'Saved to .enet/ — paste contents into your agent\'s context'
-  }
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Detection
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Detects ALL agents installed on the system by checking known global paths.
- * Uses systemSignalFilter for agents that share directories with other software
- * (e.g. Copilot shares VS Code's extensions folder).
- */
-export async function detectSystemAgents() {
-  const found = []
-  for (const [key, agent] of Object.entries(AGENTS)) {
-    if (key === 'generic') continue
-    for (const signal of agent.systemSignals) {
-      const exists = await fs.pathExists(signal)
-      if (!exists) continue
-      if (agent.systemSignalFilter) {
-        if (agent.systemSignalFilter(signal)) {
-          found.push({ key, ...agent })
-          break
-        }
-        continue // signal dir exists but filter didn't match — try next signal path
-      }
-      found.push({ key, ...agent })
-      break
-    }
-  }
-  return found
-}
-
-/**
- * Detects ALL agents present in the current project folder.
- */
-export async function detectProjectAgents(cwd = process.cwd()) {
-  const found = []
-  for (const [key, agent] of Object.entries(AGENTS)) {
-    if (key === 'generic') continue
-    for (const signal of agent.projectSignals) {
-      if (await fs.pathExists(path.join(cwd, signal))) {
-        found.push({ key, ...agent })
-        break
-      }
-    }
-  }
-  return found
-}
-
-/**
- * Returns the first detected agent (legacy — used by status/doctor).
- */
-export async function detectAgent(cwd = process.cwd()) {
-  const agents = await detectProjectAgents(cwd)
-  return agents[0] ?? { key: 'generic', ...AGENTS.generic }
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Path resolution
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Returns the resolved install path for a given agent + method.
- *
- * Special cases:
- *  - antigravity global → ~/.gemini/antigravity/skills/method-{id}/SKILL.md
- *    Each method gets its own subfolder (not a shared file).
- *  - windsurf global    → ~/.codeium/windsurf/memories/global_rules.md
- *  - claudecode global  → ~/.claude/CLAUDE.md
- */
-export function getInstallPath(agent, methodId, { global = false, cwd = process.cwd() } = {}) {
-  if (global) {
-    if (!agent.globalInstallDir) return null // agent doesn't support global install
-
-    if (agent.key === 'antigravity') {
-      // Dynamic subfolder per method: skills/method-{id}/SKILL.md
-      return path.join(agent.globalInstallDir, `method-${methodId}`, 'SKILL.md')
-    }
-
-    const filename = agent.globalFilename ?? agent.filename.replace('{id}', methodId)
-    return path.join(agent.globalInstallDir, filename)
-  }
-
-  // Project-level install
-  const filename = agent.filename.replace('{id}', methodId)
-  return path.join(cwd, agent.projectInstallDir, filename)
-}
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'os'
+
+const HOME = os.homedir()
+
+export const AGENTS = {
+  cursor: {
+    name: 'Cursor',
+    systemSignals: [
+      path.join(HOME, '.cursor'),
+      path.join(HOME, 'Library', 'Application Support', 'Cursor'),   // macOS
+      path.join(HOME, 'AppData', 'Roaming', 'Cursor'),               // Windows
+      path.join(HOME, '.config', 'Cursor'),                          // Linux
+    ],
+    projectSignals: ['.cursor/rules', '.cursor'],
+    projectInstallDir: '.cursor/rules',
+    globalInstallDir: path.join(HOME, '.cursor', 'rules'),
+    filename: 'enet-{id}.md',
+    configNote: 'Rule auto-applies to all files (alwaysApply: true)'
+  },
+
+  windsurf: {
+    name: 'Windsurf',
+    systemSignals: [
+      path.join(HOME, '.codeium', 'windsurf'),
+      path.join(HOME, 'Library', 'Application Support', 'Windsurf'), // macOS
+      path.join(HOME, 'AppData', 'Roaming', 'Windsurf'),             // Windows
+    ],
+    projectSignals: ['.windsurfrules', '.windsurf'],
+    projectInstallDir: '.',
+    globalInstallDir: path.join(HOME, '.codeium', 'windsurf', 'memories'),
+    globalFilename: 'global_rules.md',
+    filename: '.windsurfrules',
+    configNote: 'Appended to .windsurfrules in project root'
+  },
+
+  antigravity: {
+    name: 'Antigravity (Google)',
+    systemSignals: [
+      path.join(HOME, '.gemini', 'antigravity'),
+      path.join(HOME, 'Library', 'Application Support', 'Google', 'Antigravity'), // macOS
+      path.join(HOME, 'AppData', 'Roaming', 'Google', 'Antigravity'),             // Windows
+    ],
+    projectSignals: ['.agent/rules', '.agent'],
+    projectInstallDir: '.agent/rules',
+    // globalInstallDir is a base — getInstallPath() resolves the full path dynamically:
+    // ~/.gemini/antigravity/skills/method-{id}/SKILL.md
+    globalInstallDir: path.join(HOME, '.gemini', 'antigravity', 'skills'),
+    globalFilename: 'SKILL.md',
+    filename: 'enet-{id}.md',
+    configNote: 'Rule placed in .agent/rules/ — activates automatically in Antigravity'
+  },
+
+  claudecode: {
+    name: 'Claude Code',
+    systemSignals: [
+      path.join(HOME, '.claude'),
+    ],
+    projectSignals: ['CLAUDE.md', '.claude'],
+    projectInstallDir: '.',
+    globalInstallDir: path.join(HOME, '.claude'),
+    globalFilename: 'CLAUDE.md',
+    filename: 'CLAUDE.md',
+    configNote: 'Written to CLAUDE.md — Claude Code reads this automatically'
+  },
+
+  copilot: {
+    name: 'GitHub Copilot',
+    // Copilot is a VS Code extension — detect by checking the extensions folder
+    // for a github.copilot-* subfolder, not just the presence of .vscode/
+    systemSignals: [
+      path.join(HOME, '.vscode', 'extensions'),                                         // Linux / Windows
+      path.join(HOME, 'Library', 'Application Support', 'Code', 'User', 'extensions'), // macOS
+      path.join(HOME, 'AppData', 'Roaming', 'Code', 'User', 'extensions'),             // Windows alt
+      path.join(HOME, '.vscode-server', 'extensions'),                                  // remote / SSH
+    ],
+    systemSignalFilter: (signalPath) => {
+      // Only return true if a github.copilot extension folder exists inside
+      try {
+        const entries = fs.readdirSync(signalPath)
+        return entries.some(e => e.toLowerCase().startsWith('github.copilot'))
+      } catch {
+        return false
+      }
+    },
+    projectSignals: ['.github/copilot-instructions.md'],
+    projectInstallDir: '.github',
+    globalInstallDir: null, // Copilot has no global rules path
+    filename: 'copilot-instructions.md',
+    configNote: 'Written to .github/copilot-instructions.md'
+  },
+
+  generic: {
+    name: 'Generic / Other agent',
+    systemSignals: [],
+    projectSignals: [],
+    projectInstallDir: '.enet',
+    globalInstallDir: null,
+    filename: '{id}.md',
+    configNote: 'Saved to .enet/ — paste contents into your agent\'s context'
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Detection
+// ─────────────────────────────────────────────────────────────────
+
+/**
+ * Detects ALL agents installed on the system by checking known global paths.
+ * Uses systemSignalFilter for agents that share directories with other software
+ * (e.g. Copilot shares VS Code's extensions folder).
+ */
+export async function detectSystemAgents() {
+  const found = []
+  for (const [key, agent] of Object.entries(AGENTS)) {
+    if (key === 'generic') continue
+    for (const signal of agent.systemSignals) {
+      const exists = await fs.pathExists(signal)
+      if (!exists) continue
+      if (agent.systemSignalFilter) {
+        if (agent.systemSignalFilter(signal)) {
+          found.push({ key, ...agent })
+          break
+        }
+        continue // signal dir exists but filter didn't match — try next signal path
+      }
+      found.push({ key, ...agent })
+      break
+    }
+  }
+  return found
+}
+
+/**
+ * Detects ALL agents present in the current project folder.
+ */
+export async function detectProjectAgents(cwd = process.cwd()) {
+  const found = []
+  for (const [key, agent] of Object.entries(AGENTS)) {
+    if (key === 'generic') continue
+    for (const signal of agent.projectSignals) {
+      if (await fs.pathExists(path.join(cwd, signal))) {
+        found.push({ key, ...agent })
+        break
+      }
+    }
+  }
+  return found
+}
+
+/**
+ * Returns the first detected agent (legacy — used by status/doctor).
+ */
+export async function detectAgent(cwd = process.cwd()) {
+  const agents = await detectProjectAgents(cwd)
+  return agents[0] ?? { key: 'generic', ...AGENTS.generic }
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Path resolution
+// ─────────────────────────────────────────────────────────────────
+
+/**
+ * Returns the resolved install path for a given agent + method.
+ *
+ * Special cases:
+ *  - antigravity global → ~/.gemini/antigravity/skills/method-{id}/SKILL.md
+ *    Each method gets its own subfolder (not a shared file).
+ *  - windsurf global    → ~/.codeium/windsurf/memories/global_rules.md
+ *  - claudecode global  → ~/.claude/CLAUDE.md
+ */
+export function getInstallPath(agent, methodId, { global = false, cwd = process.cwd() } = {}) {
+  if (global) {
+    if (!agent.globalInstallDir) return null // agent doesn't support global install
+
+    if (agent.key === 'antigravity') {
+      // Dynamic subfolder per method: skills/method-{id}/SKILL.md
+      return path.join(agent.globalInstallDir, `method-${methodId}`, 'SKILL.md')
+    }
+
+    const filename = agent.globalFilename ?? agent.filename.replace('{id}', methodId)
+    return path.join(agent.globalInstallDir, filename)
+  }
+
+  // Project-level install
+  const filename = agent.filename.replace('{id}', methodId)
+  return path.join(cwd, agent.projectInstallDir, filename)
+}