wdi-method 0.5.11 → 0.5.13

package/bin/wdi-method.js

@@ -17,6 +17,17 @@ import {
   readProductIdentity,
   writeProductIdentity,
 } from "../lib/identity.mjs";
+import {
+  detectPlatforms,
+  formatPlatformList,
+  isKnownPlatform,
+  normalizePlatformIds,
+  platformSelectOptions,
+  platformUsesHook,
+  PREFERRED_PLATFORM_IDS,
+  skillDestinations,
+} from "../lib/platforms.mjs";
+import { opencodeCommandsDir, syncOpencodeCommands } from "../lib/opencode-commands.mjs";
 
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const KIT = path.join(ROOT, "kit");
@@ -50,14 +61,6 @@ const GENERIC_FOLDER_PATTERNS = new Set([
   PRD_SLUG_PLACEHOLDER,
 ]);
 
-const ALL_AGENTS = ["claude", "cursor", "codex", "antigravity"];
-const AGENT_LABELS = {
-  claude: "Claude Code  →  .claude/skills, CLAUDE.md",
-  cursor: "Cursor       →  .agents/skills, .cursorrules",
-  codex: "Codex        →  AGENTS.md",
-  antigravity: "Antigravity  →  .agents/skills, .agents/AGENTS.md",
-};
-
 const BMAD_INSTALL = `npx bmad-method install`;
 const REPO_URL = "https://github.com/wiradigitalid/wdi-method";
 const HELP_SKILL = "wdi-help";
@@ -101,7 +104,8 @@ function usage() {
   promote <live-dir> --rescue   pull a method change back out of a consumer (not the normal flow)
 
   --yes                     non-interactive
-  --agents a,b              claude,cursor,codex,antigravity
+  --agents a,b              platform IDs (same as BMad --tools; legacy: claude = claude-code)
+  --list-agents             print supported platform IDs
   --product NAME            written to index.yaml product.name
   --client NAME             written to index.yaml product.client (optional)
   --doc-language <text>            prose of working documents; free text, default English
@@ -130,6 +134,10 @@ function parseArgs(argv) {
     usage();
     process.exit(0);
   }
+  if (rest[0] === "--list-agents") {
+    console.log(formatPlatformList());
+    process.exit(0);
+  }
   if (rest.length === 0) {
     args.cmd = "wizard";
     return args;
@@ -151,10 +159,11 @@ function parseArgs(argv) {
     else if (t === "--agents") {
       const raw = rest.shift();
       if (!raw) die("--agents needs a comma-separated list");
-      args.agents = raw.split(",").map((s) => s.trim()).filter(Boolean);
-      for (const a of args.agents) {
-        if (!ALL_AGENTS.includes(a)) die(`unknown agent: ${a}`);
-      }
+      args.agents = normalizePlatformIds(raw.split(",").map((s) => s.trim()).filter(Boolean));
+      const unknown = raw.split(",").map((s) => s.trim()).filter(Boolean)
+        .filter((a) => !isKnownPlatform(a));
+      if (unknown.length) die(`unknown platform: ${unknown.join(", ")} (run --list-agents)`);
+      if (!args.agents.length) die("--agents needs at least one known platform");
     } else if (t === "--product") args.product = rest.shift();
     else if (t === "--client") args.client = rest.shift();
     else if (t === "--doc-language" || t === "--doc-filename-language") {
@@ -244,25 +253,6 @@ function readBmadVersion(target) {
   return m ? m[1] : "";
 }
 
-function detectAgents(target) {
-  const found = [];
-  if (
-    fs.existsSync(path.join(target, ".claude", "skills", "wdi-init", "SKILL.md")) ||
-    fs.existsSync(path.join(target, ".claude", "skills", "bmad-help", "SKILL.md"))
-  ) {
-    found.push("claude");
-  }
-  if (
-    fs.existsSync(path.join(target, ".cursorrules")) ||
-    fs.existsSync(path.join(target, ".agents", "skills", "wdi-init", "SKILL.md"))
-  ) {
-    found.push("cursor");
-  }
-  if (fs.existsSync(path.join(target, "AGENTS.md"))) found.push("codex");
-  if (fs.existsSync(path.join(target, ".agents", "AGENTS.md"))) found.push("antigravity");
-  return found.length ? [...new Set(found)] : ALL_AGENTS.slice();
-}
-
 function gitHead(repo) {
   const r = spawnSync("git", ["-C", repo, "rev-parse", "--short", "HEAD"], {
     encoding: "utf8",
@@ -289,15 +279,6 @@ function requireTarget(dir) {
   return target;
 }
 
-function skillDests(target, agents) {
-  const dests = [];
-  if (agents.includes("claude")) dests.push(path.join(target, ".claude", "skills"));
-  if (agents.includes("cursor") || agents.includes("antigravity")) {
-    dests.push(path.join(target, ".agents", "skills"));
-  }
-  return dests;
-}
-
 function bmadMissingMessage() {
   return [
     "BMad Method is not installed in this repo. Install it first, then run this installer again.",
@@ -524,10 +505,10 @@ function syncConstitution(target) {
 
 function syncSkills(target, agents) {
   let n = 0;
-  const dests = skillDests(target, agents);
+  const dests = skillDestinations(target, agents);
   if (dests.length === 0) {
-    note("no skill destinations for selected agents — AGENTS.md still applies");
-    return 0;
+    note("no skill destinations for selected platforms — AGENTS.md still applies");
+    return { files: 0, removed: 0 };
   }
   for (const name of WDI_SKILLS) {
     const src = path.join(KIT, "skills", name);
@@ -728,7 +709,7 @@ function readIndexIdentity(target) {
   return readProductIdentity(fs.readFileSync(file, "utf8"));
 }
 
-function upsertAgentFiles(target, agents, productName) {
+function upsertAgentFiles(target, platforms, productName) {
   const template = fs.readFileSync(path.join(OVERLAY, "AGENTS.md"), "utf8");
   const agentsFile = path.join(target, "AGENTS.md");
   let next;
@@ -743,8 +724,10 @@ function upsertAgentFiles(target, agents, productName) {
   fs.writeFileSync(agentsFile, next);
 
   const mirrors = [];
-  if (agents.includes("cursor")) mirrors.push(path.join(target, ".cursorrules"));
-  if (agents.includes("cursor") || agents.includes("antigravity")) {
+  if (platformUsesHook(platforms, "cursorrules")) {
+    mirrors.push(path.join(target, ".cursorrules"));
+  }
+  if (platformUsesHook(platforms, "agents-mirror")) {
     mirrors.push(path.join(target, ".agents", "AGENTS.md"));
   }
   for (const mirror of mirrors) {
@@ -759,7 +742,7 @@ function upsertAgentFiles(target, agents, productName) {
     }
   }
 
-  if (agents.includes("claude")) {
+  if (platformUsesHook(platforms, "claude-md")) {
     const claude = path.join(target, "CLAUDE.md");
     if (!fs.existsSync(claude)) {
       fs.writeFileSync(claude, "@AGENTS.md\n");
@@ -775,7 +758,7 @@ function summaryLine(label, value) {
   console.log(`  ${DIM}${label.padEnd(11)}${RESET}${value}`);
 }
 
-function printSummary(target, agents, { first, was, written, skipped, skills, tomls }) {
+function printSummary(target, agents, { first, was, written, skipped, skills, tomls, opencodeCmds }) {
   const now = PKG.version;
   const version = first
     ? `${now} — first install`
@@ -799,7 +782,8 @@ function printSummary(target, agents, { first, was, written, skipped, skills, to
   if (bmad) summaryLine("bmad", bmad);
   summaryLine("target", target);
   console.log("");
-  summaryLine("written", `${written} constitution · ${skills.files} skill files · ${tomls.files} bmad overrides`);
+  summaryLine("written", `${written} constitution · ${skills.files} skill files · ${tomls.files} bmad overrides`
+    + (opencodeCmds?.written ? ` · ${opencodeCmds.written} opencode commands` : ""));
   if (kept.length) summaryLine("kept", kept.join(" · "));
   if (skills.removed) {
     summaryLine("removed", `${skills.removed} retired wrapper${skills.removed === 1 ? "" : "s"}`);
@@ -807,7 +791,7 @@ function printSummary(target, agents, { first, was, written, skipped, skills, to
   if (first && policy.docLanguage) {
     summaryLine("language", `${policy.docLanguage} · filenames ${policy.docFilenameLanguage}`);
   }
-  summaryLine("agents", agents.join(", ") || "none");
+  summaryLine("platforms", agents.join(", ") || "none");
   console.log("");
   // The readers are the one seeded file that does nothing until somebody writes it, and its
   // silence is expensive: inventory.py refuses to run and the reason is a folder deep. One line
@@ -880,6 +864,14 @@ function apply(target, agents,
   }
   const skills = syncSkills(target, agents);
   note(`skills ${skills.files} files`);
+  let opencodeCmds = { written: 0, removed: 0 };
+  if (platformUsesHook(agents, "opencode-commands")) {
+    opencodeCmds = syncOpencodeCommands(target, WDI_SKILLS, path.join(KIT, "skills"));
+    note(`opencode commands ${opencodeCmds.written} files → ${opencodeCommandsDir()}/`);
+    if (opencodeCmds.removed) {
+      note(`removed ${opencodeCmds.removed} retired opencode command${opencodeCmds.removed === 1 ? "" : "s"}`);
+    }
+  }
   const tomls = syncTomls(target);
   note(`bmad custom ${tomls.files} toml → _bmad/custom/`);
   if (first) seedControlIfMissing(target);
@@ -888,7 +880,7 @@ function apply(target, agents,
   setLanguagePolicy(target, { docLanguage, docFilenameLanguage, chosen: languageChosen });
   upsertAgentFiles(target, agents, product);
   writeStamp(target);
-  printSummary(target, agents, { first, was, written, skipped, skills, tomls });
+  printSummary(target, agents, { first, was, written, skipped, skills, tomls, opencodeCmds });
   printNextSteps({
     first,
     productSet: Boolean(product) && !identityIsPlaceholder(product),
@@ -905,11 +897,17 @@ function verify(target, agents) {
     if (!fs.existsSync(dest)) missing.push(`.constitution/${rel}`);
   }
   for (const name of WDI_SKILLS) {
-    for (const root of skillDests(target, agents)) {
+    for (const root of skillDestinations(target, agents)) {
       const dest = path.join(root, name, "SKILL.md");
       if (!fs.existsSync(dest)) missing.push(posixRel(target, dest));
     }
   }
+  if (platformUsesHook(agents, "opencode-commands")) {
+    for (const name of WDI_SKILLS) {
+      const dest = path.join(target, opencodeCommandsDir(), `${name}.md`);
+      if (!fs.existsSync(dest)) missing.push(posixRel(target, dest));
+    }
+  }
   const custom = path.join(KIT, "assets", "bmad-custom");
   for (const file of walkFiles(custom)) {
     if (!file.endsWith(".toml")) continue;
@@ -1179,12 +1177,17 @@ async function runWizard(pre) {
     "Language of document filename slugs — the `UC-` `DEC-` codes stay English",
     policy.docFilenameLanguage || pre.docFilenameLanguage || docLanguage);
 
+  const detected = pre.agents
+    ? normalizePlatformIds(pre.agents)
+    : detectPlatforms(target, fs);
   const selected = cancelIf(
-    await p.multiselect({
-      message: "Which agents get the skills? (space to select)",
-      options: ALL_AGENTS.map((id) => ({ value: id, label: AGENT_LABELS[id] })),
-      initialValues: pre.agents || detectAgents(target),
+    await p.autocompleteMultiselect({
+      message: "Which tools get the wdi-* skills? (⭐ = recommended)",
+      options: platformSelectOptions(detected),
+      initialValues: detected,
       required: true,
+      maxItems: 8,
+      placeholder: "Type to search…",
     }),
   );
 
@@ -1193,13 +1196,15 @@ async function runWizard(pre) {
       "The corpus folder names are fixed — they are not an install option:",
       "  .constitution  .control  .what  .how  .work  _bmad-output",
       "",
-      "What gets written for the agents you picked:",
-      selected.includes("claude") ? "  .claude/skills/wdi-*  CLAUDE.md" : "",
-      selected.includes("cursor") ? "  .agents/skills/wdi-*  .cursorrules" : "",
-      selected.includes("codex") || selected.includes("cursor") || selected.includes("antigravity")
-        ? "  AGENTS.md  (the BEGIN:wdi-method block)"
+      "What gets written for the platforms you picked:",
+      "  AGENTS.md  (the BEGIN:wdi-method block — always)",
+      platformUsesHook(selected, "claude-md") ? "  CLAUDE.md  →  @AGENTS.md" : "",
+      platformUsesHook(selected, "cursorrules") ? "  .cursorrules  (method block mirror)" : "",
+      platformUsesHook(selected, "agents-mirror") ? "  .agents/AGENTS.md  (method block mirror)" : "",
+      platformUsesHook(selected, "opencode-commands")
+        ? `  ${opencodeCommandsDir()}/wdi-*.md  (slash commands → skills)`
         : "",
-      selected.includes("antigravity") ? "  .agents/AGENTS.md" : "",
+      `  wdi-* skills  →  ${skillDestinations(target, selected).map((d) => posixRel(target, d)).join(", ") || "(none)"}`,
     ]
       .filter(Boolean)
       .join("\n"),
@@ -1228,7 +1233,7 @@ async function runWizard(pre) {
 
 function runNonInteractive(args) {
   const target = requireTarget(args.dir);
-  const agents = args.agents || detectAgents(target) || ALL_AGENTS.slice();
+  const agents = args.agents || detectPlatforms(target, fs) || PREFERRED_PLATFORM_IDS.slice();
   if (args.cmd === "verify") {
     verify(target, agents);
     return;

package/kit/.constitution/method/scripts/validate.py

@@ -1510,7 +1510,11 @@ def page_blueprint(c: Corpus) -> str:
     for pc in c.pcs:
         pid = str(pc.get("id"))
         block = _section(c.root / f".what/{pid}/SRS-{pid}.md", "Actor Register")
-        parts.append(f"\n### {pid} — {pc.get('name', '')}\n")
+        # A Product Component carries no `name` in `components.yaml` — only a container does — so
+        # this heading rendered as `### settings — `, with an orphaned separator, for every
+        # component of every product. The separator belongs to the name, not to the heading.
+        name = str(pc.get("name") or "").strip()
+        parts.append(f"\n### {pid} — {name}\n" if name else f"\n### {pid}\n")
         parts.append(_demote(block) if block
                      else "_no § Actor Register in this component's SRS yet._")
 

package/lib/opencode-commands.mjs

@@ -0,0 +1,110 @@
+import fs from "node:fs";
+import path from "node:path";
+
+const COMMANDS_DIR = ".opencode/commands";
+
+/** OpenCode built-in slash commands — a skill name must not shadow these. */
+export const RESERVED_OPENCODE_COMMANDS = new Set([
+  "review",
+  "commit",
+  "init",
+  "help",
+  "skills",
+  "fast",
+  "compact",
+  "clear",
+  "undo",
+  "redo",
+  "edit",
+  "editor",
+  "exit",
+  "quit",
+  "theme",
+  "config",
+  "model",
+  "session",
+]);
+
+/** @param {string} value */
+export function isSafeSkillId(value) {
+  return typeof value === "string" && /^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/.test(value) && !value.includes("..");
+}
+
+/** @param {string} value */
+function yamlSafeSingleLine(value) {
+  const collapsed = String(value).replaceAll(/[\r\n]+/g, " ").trim();
+  const needsQuoting = /[:#'"\\]/.test(collapsed) || /^[!&*?|>%@`[{]/.test(collapsed);
+  if (!needsQuoting) return collapsed;
+  const escaped = collapsed.replaceAll("\\", "\\\\").replaceAll('"', String.raw`\"`);
+  return `"${escaped}"`;
+}
+
+/**
+ * @param {string} skillDir
+ */
+export function readSkillDescription(skillDir) {
+  const file = path.join(skillDir, "SKILL.md");
+  if (!fs.existsSync(file)) return "";
+  const text = fs.readFileSync(file, "utf8");
+  const fm = text.match(/^---\n([\s\S]*?)\n---/);
+  if (!fm) return "";
+  const line = fm[1].match(/^description:\s*(.+)$/m);
+  if (!line) return "";
+  return line[1].trim().replace(/^["']|["']$/g, "");
+}
+
+/**
+ * @param {string} description
+ * @param {string} skillId
+ */
+export function buildOpencodeCommandBody(description, skillId) {
+  const desc = description.trim() || `Run the ${skillId} skill`;
+  return `---\ndescription: ${yamlSafeSingleLine(desc)}\n---\n\n@skills/${skillId}\n`;
+}
+
+/**
+ * Write `.opencode/commands/<skill>.md` pointer files for each wdi-* skill.
+ *
+ * @param {string} target
+ * @param {string[]} skillIds
+ * @param {string} kitSkillsDir
+ */
+export function syncOpencodeCommands(target, skillIds, kitSkillsDir) {
+  const commandsPath = path.join(target, COMMANDS_DIR);
+  fs.mkdirSync(commandsPath, { recursive: true });
+
+  let written = 0;
+  for (const skillId of skillIds) {
+    if (!skillId.startsWith("wdi-") || !isSafeSkillId(skillId)) continue;
+    if (RESERVED_OPENCODE_COMMANDS.has(skillId)) continue;
+    const src = path.join(kitSkillsDir, skillId);
+    if (!fs.existsSync(path.join(src, "SKILL.md"))) continue;
+    const body = buildOpencodeCommandBody(readSkillDescription(src), skillId);
+    fs.writeFileSync(path.join(commandsPath, `${skillId}.md`), body);
+    written += 1;
+  }
+
+  const removed = pruneRetiredOpencodeCommands(commandsPath, new Set(skillIds));
+  return { written, removed };
+}
+
+/**
+ * @param {string} commandsPath
+ * @param {Set<string>} keep
+ */
+function pruneRetiredOpencodeCommands(commandsPath, keep) {
+  if (!fs.existsSync(commandsPath)) return 0;
+  let removed = 0;
+  for (const entry of fs.readdirSync(commandsPath, { withFileTypes: true })) {
+    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
+    const skillId = entry.name.slice(0, -3);
+    if (!skillId.startsWith("wdi-") || keep.has(skillId)) continue;
+    fs.unlinkSync(path.join(commandsPath, entry.name));
+    removed += 1;
+  }
+  return removed;
+}
+
+export function opencodeCommandsDir() {
+  return COMMANDS_DIR;
+}

package/lib/platforms.mjs

@@ -0,0 +1,248 @@
+/**
+ * Agent / IDE targets for install and update.
+ *
+ * IDs and skill directories align with BMad Method `platform-codes.yaml` so a repo's
+ * `_bmad/_config/manifest.yaml` `ides:` list maps directly. Legacy WDI flags (`claude`,
+ * `cursor`, …) are accepted as aliases.
+ */
+
+import path from "node:path";
+
+/** @typedef {"claude-md" | "cursorrules" | "agents-mirror" | "opencode-commands"} PlatformHook */
+
+/**
+ * @typedef {object} Platform
+ * @property {string} id
+ * @property {string} name
+ * @property {boolean} preferred
+ * @property {string} skillDir
+ * @property {PlatformHook[]} [hooks]
+ */
+
+/** @type {Record<string, string>} */
+export const LEGACY_ALIASES = {
+  claude: "claude-code",
+  antigravity: "antigravity-cli",
+};
+
+/** @type {Platform[]} */
+export const PLATFORMS = [
+  { id: "adal", name: "AdaL", preferred: false, skillDir: ".adal/skills" },
+  { id: "amp", name: "Sourcegraph Amp", preferred: false, skillDir: ".agents/skills" },
+  { id: "antigravity", name: "Google Antigravity", preferred: false, skillDir: ".agent/skills", hooks: ["agents-mirror"] },
+  { id: "antigravity-cli", name: "Antigravity CLI (AGY)", preferred: false, skillDir: ".agents/skills", hooks: ["agents-mirror"] },
+  { id: "auggie", name: "Auggie", preferred: false, skillDir: ".agents/skills" },
+  { id: "bob", name: "IBM Bob", preferred: false, skillDir: ".bob/skills" },
+  { id: "claude-code", name: "Claude Code", preferred: true, skillDir: ".claude/skills", hooks: ["claude-md"] },
+  { id: "cline", name: "Cline", preferred: false, skillDir: ".cline/skills" },
+  { id: "codex", name: "Codex", preferred: true, skillDir: ".agents/skills" },
+  { id: "codewhale", name: "CodeWhale", preferred: false, skillDir: ".codewhale/skills" },
+  { id: "codebuddy", name: "CodeBuddy", preferred: false, skillDir: ".codebuddy/skills" },
+  { id: "command-code", name: "Command Code", preferred: false, skillDir: ".agents/skills" },
+  { id: "cortex", name: "Snowflake Cortex Code", preferred: false, skillDir: ".cortex/skills" },
+  { id: "crush", name: "Crush", preferred: false, skillDir: ".agents/skills" },
+  { id: "cursor", name: "Cursor", preferred: true, skillDir: ".agents/skills", hooks: ["cursorrules", "agents-mirror"] },
+  { id: "droid", name: "Factory Droid", preferred: false, skillDir: ".factory/skills" },
+  { id: "firebender", name: "Firebender", preferred: false, skillDir: ".firebender/skills" },
+  { id: "gemini", name: "Gemini CLI", preferred: false, skillDir: ".agents/skills" },
+  { id: "github-copilot", name: "GitHub Copilot", preferred: true, skillDir: ".agents/skills" },
+  { id: "goose", name: "Block Goose", preferred: false, skillDir: ".agents/skills" },
+  { id: "hermes", name: "Hermes Agent", preferred: false, skillDir: ".agents/skills" },
+  { id: "iflow", name: "iFlow", preferred: false, skillDir: ".iflow/skills" },
+  { id: "junie", name: "Junie", preferred: false, skillDir: ".junie/skills" },
+  { id: "kilo", name: "KiloCoder", preferred: false, skillDir: ".agents/skills" },
+  { id: "kimi-code", name: "Kimi Code", preferred: false, skillDir: ".agents/skills" },
+  { id: "kiro", name: "Kiro", preferred: false, skillDir: ".kiro/skills" },
+  { id: "kode", name: "Kode", preferred: false, skillDir: ".kode/skills" },
+  { id: "mistral-vibe", name: "Mistral Vibe", preferred: false, skillDir: ".vibe/skills" },
+  { id: "mux", name: "Mux", preferred: false, skillDir: ".agents/skills" },
+  { id: "neovate", name: "Neovate", preferred: false, skillDir: ".neovate/skills" },
+  { id: "ona", name: "Ona", preferred: false, skillDir: ".ona/skills" },
+  { id: "openclaw", name: "OpenClaw", preferred: false, skillDir: ".agents/skills" },
+  { id: "opencode", name: "OpenCode", preferred: false, skillDir: ".agents/skills", hooks: ["opencode-commands"] },
+  { id: "openhands", name: "OpenHands", preferred: false, skillDir: ".agents/skills" },
+  { id: "pi", name: "Pi", preferred: false, skillDir: ".agents/skills" },
+  { id: "pochi", name: "Pochi", preferred: false, skillDir: ".agents/skills" },
+  { id: "qoder", name: "Qoder", preferred: false, skillDir: ".qoder/skills" },
+  { id: "qwen", name: "QwenCoder", preferred: false, skillDir: ".qwen/skills" },
+  { id: "replit", name: "Replit Agent", preferred: false, skillDir: ".agents/skills" },
+  { id: "roo", name: "Roo Code", preferred: false, skillDir: ".agents/skills" },
+  { id: "rovo-dev", name: "Rovo Dev", preferred: false, skillDir: ".agents/skills" },
+  { id: "trae", name: "Trae", preferred: false, skillDir: ".trae/skills" },
+  { id: "warp", name: "Warp", preferred: false, skillDir: ".agents/skills" },
+  { id: "windsurf", name: "Windsurf", preferred: false, skillDir: ".agents/skills" },
+  { id: "zencoder", name: "Zencoder", preferred: false, skillDir: ".zencoder/skills" },
+];
+
+const BY_ID = new Map(PLATFORMS.map((p) => [p.id, p]));
+
+export const ALL_PLATFORM_IDS = PLATFORMS.map((p) => p.id);
+
+export const PREFERRED_PLATFORM_IDS = PLATFORMS.filter((p) => p.preferred).map((p) => p.id);
+
+/** @param {string} raw */
+export function normalizePlatformId(raw) {
+  const id = raw.trim();
+  return LEGACY_ALIASES[id] || id;
+}
+
+/** @param {string[]} rawIds */
+export function normalizePlatformIds(rawIds) {
+  const out = [];
+  const seen = new Set();
+  for (const raw of rawIds) {
+    const id = normalizePlatformId(raw);
+    if (!BY_ID.has(id)) continue;
+    if (seen.has(id)) continue;
+    seen.add(id);
+    out.push(id);
+  }
+  return out;
+}
+
+/** @param {string} id */
+export function getPlatform(id) {
+  return BY_ID.get(normalizePlatformId(id));
+}
+
+/** @param {string} id */
+export function isKnownPlatform(id) {
+  return BY_ID.has(normalizePlatformId(id));
+}
+
+/** Preferred first, then declaration order — mirrors BMad install ordering. */
+export function sortedPlatforms() {
+  const preferred = PLATFORMS.filter((p) => p.preferred);
+  const other = PLATFORMS.filter((p) => !p.preferred);
+  return [...preferred, ...other];
+}
+
+/** @param {Platform} platform */
+function hookNote(platform) {
+  const bits = [platform.skillDir];
+  if (platform.hooks?.includes("claude-md")) bits.push("CLAUDE.md");
+  if (platform.hooks?.includes("cursorrules")) bits.push(".cursorrules");
+  if (platform.hooks?.includes("agents-mirror")) bits.push(".agents/AGENTS.md");
+  if (platform.hooks?.includes("opencode-commands")) bits.push(".opencode/commands");
+  return bits.join(", ");
+}
+
+/** @param {string[]} selectedIds */
+export function platformSelectOptions(selectedIds = []) {
+  const configured = new Set(normalizePlatformIds(selectedIds));
+  const sorted = sortedPlatforms();
+  const head = sorted.filter((p) => configured.has(p.id));
+  const tail = sorted.filter((p) => !configured.has(p.id));
+  return [...head, ...tail].map((p) => {
+    const tags = [];
+    if (p.preferred) tags.push("⭐");
+    if (configured.has(p.id)) tags.push("✅");
+    const prefix = tags.length ? `${tags.join(" ")} ` : "";
+    return {
+      value: p.id,
+      label: `${prefix}${p.name}  →  ${hookNote(p)}`,
+    };
+  });
+}
+
+/**
+ * Minimal YAML list reader for `ides:` — no dependency on a YAML parser.
+ * @param {import("node:fs")} fs
+ * @param {string} filePath
+ */
+export function readYamlIdesList(fs, filePath) {
+  if (!fs.existsSync(filePath)) return [];
+  const text = fs.readFileSync(filePath, "utf8");
+  const out = [];
+  let inIdes = false;
+  for (const line of text.split("\n")) {
+    if (/^ides:\s*$/.test(line)) {
+      inIdes = true;
+      continue;
+    }
+    if (inIdes) {
+      const item = line.match(/^\s+-\s+(\S+)/);
+      if (item) {
+        out.push(item[1]);
+        continue;
+      }
+      if (line.trim() && !/^\s/.test(line)) inIdes = false;
+    }
+  }
+  return out;
+}
+
+/**
+ * @param {string} target
+ * @param {import("node:fs")} fs
+ */
+export function readBmadManifestIdes(target, fs) {
+  const file = path.join(target, "_bmad", "_config", "manifest.yaml");
+  return readYamlIdesList(fs, file);
+}
+
+/**
+ * @param {string} target
+ * @param {import("node:fs")} fs
+ */
+export function detectPlatforms(target, fs) {
+  const fromManifest = normalizePlatformIds(readBmadManifestIdes(target, fs));
+  if (fromManifest.length) return fromManifest;
+
+  const found = [];
+  if (
+    fs.existsSync(path.join(target, ".claude", "skills", "wdi-init", "SKILL.md")) ||
+    fs.existsSync(path.join(target, ".claude", "skills", "bmad-help", "SKILL.md"))
+  ) {
+    found.push("claude-code");
+  }
+  if (
+    fs.existsSync(path.join(target, ".cursorrules")) ||
+    fs.existsSync(path.join(target, ".agents", "skills", "wdi-init", "SKILL.md"))
+  ) {
+    found.push("cursor");
+  }
+  if (fs.existsSync(path.join(target, "AGENTS.md"))) found.push("codex");
+  if (fs.existsSync(path.join(target, ".agents", "AGENTS.md"))) found.push("antigravity-cli");
+  if (fs.existsSync(path.join(target, ".agent", "skills", "wdi-init", "SKILL.md"))) {
+    found.push("antigravity");
+  }
+  const unique = normalizePlatformIds(found);
+  return unique.length ? unique : PREFERRED_PLATFORM_IDS.slice();
+}
+
+/**
+ * @param {string} target
+ * @param {string[]} platformIds
+ */
+export function skillDestinations(target, platformIds) {
+  const dests = new Set();
+  for (const id of normalizePlatformIds(platformIds)) {
+    const platform = getPlatform(id);
+    if (platform?.skillDir) dests.add(path.join(target, platform.skillDir));
+  }
+  return [...dests];
+}
+
+/** @param {string[]} platformIds */
+export function platformUsesHook(platformIds, hook) {
+  return normalizePlatformIds(platformIds).some((id) => getPlatform(id)?.hooks?.includes(hook));
+}
+
+export function formatPlatformList() {
+  const idWidth = Math.max(...PLATFORMS.map((p) => p.id.length), 2);
+  const nameWidth = Math.max(...PLATFORMS.map((p) => p.name.length), 4);
+  const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+  const lines = [
+    "Supported platform IDs (pass via --agents <id>[,<id>...]):",
+    "",
+    `  ${pad("ID", idWidth)}  ${pad("Name", nameWidth)}  Skill directory`,
+    `  ${pad("-".repeat(idWidth), idWidth)}  ${pad("-".repeat(nameWidth), nameWidth)}  ${"-".repeat(14)}`,
+  ];
+  for (const p of sortedPlatforms()) {
+    const star = p.preferred ? "⭐" : "  ";
+    lines.push(`${star} ${pad(p.id, idWidth)}  ${pad(p.name, nameWidth)}  ${p.skillDir}`);
+  }
+  lines.push("", "⭐ = recommended (same as BMad Method)", "", "Example: npx wdi-method install --yes --agents claude-code,cursor");
+  return lines.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wdi-method",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "description": "WDI Method — software delivery method that wraps BMad",
   "type": "module",
   "bin": {
@@ -29,7 +29,7 @@
     "clean": "node scripts/clean-kit.mjs"
   },
   "dependencies": {
-    "@clack/prompts": "^0.11.0"
+    "@clack/prompts": "^1.7.0"
   },
   "license": "MIT",
   "repository": {