wdi-method 0.4.5 → 0.4.6

package/bin/wdi-method.js

@@ -1,1029 +1,1030 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import * as p from "@clack/prompts";
-import {
-  fillProductTitle,
-  upsertMethodBlock,
-} from "../lib/agents-block.mjs";
-import {
-  identityIsPlaceholder,
-  humaniseFolderName,
-  readLanguagePolicy,
-  writeLanguagePolicy,
-  DEFAULT_DOC_LANGUAGE,
-  readProductIdentity,
-  writeProductIdentity,
-} from "../lib/identity.mjs";
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const KIT = path.join(ROOT, "kit");
-const OVERLAY = path.join(ROOT, "kit-overlay");
-const SCAFFOLD = path.join(ROOT, "scaffold", ".control");
-const PKG = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf8"));
-
-const WDI_SKILLS = [
-  "wdi-init",
-  "wdi-problem",
-  "wdi-product",
-  "wdi-ux",
-  "wdi-blueprint",
-  "wdi-component",
-  "wdi-build",
-  "wdi-decision",
-  "wdi-question",
-  "wdi-log",
-  "wdi-help",
-  "wdi-reconcile",
-  "wdi-review",
-  "wdi-report",
-  "wdi-systematic-debugging",
-];
-
-const PRODUCT_CONSTITUTION = "constitution.md";
-const PRD_SLUG_PLACEHOLDER = "ISI-slug-inisiatif";
-const GENERIC_FOLDER_PATTERNS = new Set([
-  "_product-brief",
-  "ux",
-  "architecture",
-  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";
-const BMAD_REPO = "https://github.com/bmad-code-org/BMAD-METHOD";
-const WDI_REPO = "https://github.com/wiradigitalid/wdi-method";
-
-const RED = "\x1b[31m";
-const GREEN = "\x1b[32m";
-const DIM = "\x1b[2m";
-const RESET = "\x1b[0m";
-
-function die(msg) {
-  console.error(`${RED}error:${RESET} ${msg}`);
-  process.exit(1);
-}
-
-function ok(msg) {
-  console.log(`${GREEN}ok${RESET}  ${msg}`);
-}
-
-function note(msg) {
-  console.log(`${DIM}·${RESET}   ${msg}`);
-}
-
-function usage() {
-  console.log(`wdi-method ${PKG.version}
-
-  (no command)              interactive TUI — detects install vs update
-  install [dir]             first install (TUI unless --yes)
-  update  [dir]             update      (TUI unless --yes)
-  verify  [dir]
-  promote <live-dir>
-
-  --yes                     non-interactive
-  --agents a,b              claude,cursor,codex,antigravity
-  --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
-  --doc-filename-language <text>   slug part of document filenames; free text, default English
-  --skip-bmad-check
-
-BMad first, then this package. ${WDI_REPO}
-`);
-}
-
-function parseArgs(argv) {
-  const args = {
-    cmd: null,
-    dir: null,
-    agents: null,
-    skipBmad: false,
-    yes: false,
-    product: null,
-    client: null,
-    docLanguage: null,
-    docFilenameLanguage: null,
-  };
-  const rest = argv.slice(2);
-  if (rest[0] === "-h" || rest[0] === "--help") {
-    usage();
-    process.exit(0);
-  }
-  if (rest.length === 0) {
-    args.cmd = "wizard";
-    return args;
-  }
-  const first = rest[0];
-  if (["install", "update", "verify", "promote"].includes(first)) {
-    args.cmd = rest.shift();
-  } else if (first.startsWith("-")) {
-    args.cmd = "wizard";
-  } else {
-    args.cmd = "wizard";
-    args.dir = rest.shift();
-  }
-  while (rest.length) {
-    const t = rest.shift();
-    if (t === "--skip-bmad-check") args.skipBmad = true;
-    else if (t === "--yes" || t === "-y") args.yes = true;
-    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}`);
-      }
-    } 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") {
-      // Free text: "English", "Bahasa Indonesia", "id" — a model reads it, so no list to match.
-      const raw = (rest.shift() || "").trim();
-      if (!raw) die(`${t} needs a value, for example: English`);
-      if (t === "--doc-language") args.docLanguage = raw;
-      else args.docFilenameLanguage = raw;
-    }
-    else if (t.startsWith("-")) die(`unknown flag: ${t}`);
-    else if (!args.dir) args.dir = t;
-    else die(`unexpected argument: ${t}`);
-  }
-  return args;
-}
-
-// Build output and editor droppings MUST NOT reach the kit. This repository is public, and a
-// __pycache__/*.pyc carries the ABSOLUTE PATH of the source it was compiled from — which means a
-// product name and a client folder leak into a public package through a file nobody wrote.
-// Found 2026-08-18 on the first real promote: inventory.cpython-314.pyc embedded the live repo path.
-const SKIP_DIRS = new Set(["__pycache__", "node_modules", ".git", ".pytest_cache", ".ruff_cache",
-                           ".mypy_cache", ".venv", "venv", "dist", "build", ".idea", ".vscode"]);
-const SKIP_FILE = /(\.pyc|\.pyo|\.pyd|\.log|\.tmp|\.swp|\.orig|\.rej|\.bak)$|^\.DS_Store$|^Thumbs\.db$/i;
-
-function walkFiles(dir) {
-  const out = [];
-  if (!fs.existsSync(dir)) return out;
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const p = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (SKIP_DIRS.has(entry.name)) continue;
-      out.push(...walkFiles(p));
-    } else if (entry.isFile()) {
-      if (SKIP_FILE.test(entry.name)) continue;
-      out.push(p);
-    }
-  }
-  return out;
-}
-
-function copyFile(src, dest) {
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-}
-
-function copyTree(src, dest, skipRel) {
-  let n = 0;
-  for (const p of walkFiles(src)) {
-    const rel = posixRel(src, p);
-    if (skipRel && skipRel(rel)) continue;
-    copyFile(p, path.join(dest, path.relative(src, p)));
-    n += 1;
-  }
-  return n;
-}
-
-function posixRel(from, to) {
-  return path.relative(from, to).split(path.sep).join("/");
-}
-
-function acceptedCodebase(file) {
-  try {
-    const head = fs.readFileSync(file, "utf8").slice(0, 400);
-    return /status:\s*Accepted/i.test(head);
-  } catch {
-    return false;
-  }
-}
-
-function bmadPresent(target) {
-  const markers = [
-    path.join(target, ".claude", "skills", "bmad-help", "SKILL.md"),
-    path.join(target, "_bmad", "core", "config.yaml"),
-    path.join(target, "_bmad", "_config", "manifest.yaml"),
-  ];
-  return markers.some((p) => fs.existsSync(p));
-}
-
-function wdiPresent(target) {
-  return (
-    fs.existsSync(path.join(target, ".control", "wdi-method.yaml")) ||
-    fs.existsSync(path.join(target, ".constitution", "method", "README.md"))
-  );
-}
-
-function dirNonEmpty(target) {
-  if (!fs.existsSync(target)) return false;
-  return fs.readdirSync(target).some((n) => n !== ".git" && n !== ".gitignore");
-}
-
-function readBmadVersion(target) {
-  const manifest = path.join(target, "_bmad", "_config", "manifest.yaml");
-  if (!fs.existsSync(manifest)) return "";
-  const text = fs.readFileSync(manifest, "utf8");
-  const m = text.match(/installation:\s*\n\s*version:\s*(\S+)/);
-  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",
-  });
-  if (r.status !== 0) return "unknown";
-  return r.stdout.trim();
-}
-
-function today() {
-  return new Date().toISOString().slice(0, 10);
-}
-
-function requireKit() {
-  if (!fs.existsSync(path.join(KIT, ".constitution"))) {
-    die(`kit missing at ${KIT}`);
-  }
-}
-
-function requireTarget(dir) {
-  const target = path.resolve(dir || process.cwd());
-  if (!fs.existsSync(target) || !fs.statSync(target).isDirectory()) {
-    die(`target is not a directory: ${target}`);
-  }
-  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.",
-    "",
-    `  ${BMAD_INSTALL}`,
-    "",
-    `Source: ${BMAD_REPO}`,
-    "In the BMad installer, pick the same agents (Claude Code, Cursor, …).",
-  ].join("\n");
-}
-
-// Kamar custom milik produk. Tiga sifatnya, dan ketiganya harus dipegang bersama:
-//   install/update  menyemai isinya HANYA bila belum ada — sesudah itu ia tak pernah ditulis lagi
-//   promote         MELEWATINYA seluruhnya, jadi aturan khusus produk tidak mungkin terbit ke repo publik
-//   agent           memuatnya seperti guide lain, jadi ia MENGIKAT
-// Konsekuensi yang disengaja: README kamar ini diarang di paket dan tidak pernah pulang lewat promote.
-const PROJECT_ROOM = "project/";
-
-function syncConstitution(target) {
-  const kitConst = path.join(KIT, ".constitution");
-  const destConst = path.join(target, ".constitution");
-  fs.mkdirSync(destConst, { recursive: true });
-  let written = 0;
-  let skipped = 0;
-  for (const file of walkFiles(kitConst)) {
-    const rel = posixRel(kitConst, file);
-    const dest = path.join(destConst, rel);
-    if (rel === PRODUCT_CONSTITUTION && fs.existsSync(dest)) {
-      skipped += 1;
-      note(`keep ${rel} (product articles)`);
-      continue;
-    }
-    if (rel.startsWith("codebase/") && fs.existsSync(dest) && acceptedCodebase(dest)) {
-      skipped += 1;
-      note(`keep ${rel} (Accepted codebase guide)`);
-      continue;
-    }
-    if (rel.startsWith(PROJECT_ROOM) && fs.existsSync(dest)) {
-      skipped += 1;
-      note(`keep ${rel} (product custom room)`);
-      continue;
-    }
-    copyFile(file, dest);
-    written += 1;
-  }
-  return { written, skipped };
-}
-
-function syncSkills(target, agents) {
-  let n = 0;
-  const dests = skillDests(target, agents);
-  if (dests.length === 0) {
-    note("no skill destinations for selected agents — AGENTS.md still applies");
-    return 0;
-  }
-  for (const name of WDI_SKILLS) {
-    const src = path.join(KIT, "skills", name);
-    if (!fs.existsSync(src)) die(`kit missing skill ${name}`);
-    for (const root of dests) {
-      const dest = path.join(root, name);
-      fs.rmSync(dest, { recursive: true, force: true });
-      n += copyTree(src, dest);
-    }
-  }
-  const removed = pruneRetiredSkills(dests);
-  return { files: n, removed };
-}
-
-// A wrapper the method RETIRED is worse than a wrapper missing: the folder is still there, its
-// SKILL.md still reads like an instruction, and an agent will invoke it — while the guide it points
-// at is gone. Renaming five wrappers (wdi-apply, wdi-analysis, wdi-structure, …) left exactly that
-// in every repo installed before the rename, because update only ever touched the names it knows.
-//
-// `wdi-` is the method's namespace, so a `wdi-*` folder carrying a SKILL.md and not in WDI_SKILLS is
-// ours and retired. Each removal is PRINTED: silent deletion in someone else's repo is not a fix.
-function pruneRetiredSkills(dests) {
-  let removed = 0;
-  const keep = new Set(WDI_SKILLS);
-  for (const root of dests) {
-    if (!fs.existsSync(root)) continue;
-    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
-      if (!entry.isDirectory() || !entry.name.startsWith("wdi-") || keep.has(entry.name)) continue;
-      const dir = path.join(root, entry.name);
-      if (!fs.existsSync(path.join(dir, "SKILL.md"))) {
-        note(`kept ${entry.name} (no SKILL.md — not one of ours)`);
-        continue;
-      }
-      fs.rmSync(dir, { recursive: true, force: true });
-      note(`removed retired skill ${entry.name}`);
-      removed += 1;
-    }
-  }
-  return removed;
-}
-
-// `promote` scrubs a product's initiative slug out of bmad-prd.toml before publishing, which is right.
-// Writing the scrubbed PLACEHOLDER back into a product repo is not: the first real install replaced a
-// live `run_folder_pattern = "toko-tanpa-akun"` with `ISI-slug-inisiatif`, and nothing said so. A value
-// the product already chose is not the installer's to overwrite — same rule as the custom room and the
-// language policy.
-const PLACEHOLDER_SLUG = "ISI-slug-inisiatif";
-const RUN_FOLDER_LINE = /^(\s*run_folder_pattern\s*=\s*)(".*?"|'.*?')/m;
-
-// The slug appears MORE THAN ONCE — bmad-prd.toml carries it in `run_folder_pattern` and again inside a
-// memlog path, and the file itself says the two lines MUST change together. The first version of this
-// function restored only the first line and so produced exactly the inconsistency that file forbids.
-// So: read the product's slug once, then put it back everywhere the placeholder appears.
-function keepProductSlug(incoming, existing) {
-  const mineNow = existing.match(RUN_FOLDER_LINE);
-  if (!mineNow) return null;
-  const slug = mineNow[2].slice(1, -1);
-  if (!slug || slug === PLACEHOLDER_SLUG) return null;
-  if (!incoming.includes(PLACEHOLDER_SLUG)) return null;
-  // Only where the slug is a VALUE: the quoted setting, and the memlog path built from it. A bare
-  // mention inside a comment stays the placeholder — that sentence explains the pattern, and rewriting
-  // it would turn a generic explanation into a statement about one initiative.
-  return incoming
-    .replaceAll(`"${PLACEHOLDER_SLUG}"`, `"${slug}"`)
-    .replaceAll(`prd-${PLACEHOLDER_SLUG}`, `prd-${slug}`);
-}
-
-function syncTomls(target) {
-  const src = path.join(KIT, "assets", "bmad-custom");
-  const dest = path.join(target, "_bmad", "custom");
-  fs.mkdirSync(dest, { recursive: true });
-  let n = 0;
-  let slugsKept = 0;
-  for (const file of walkFiles(src)) {
-    if (!file.endsWith(".toml") || file.endsWith(".user.toml")) continue;
-    const to = path.join(dest, path.basename(file));
-    if (fs.existsSync(to)) {
-      const merged = keepProductSlug(fs.readFileSync(file, "utf8"), fs.readFileSync(to, "utf8"));
-      if (merged !== null) {
-        fs.writeFileSync(to, merged);
-        note(`kept run_folder_pattern in ${path.basename(file)}`);
-        slugsKept += 1;
-        n += 1;
-        continue;
-      }
-    }
-    copyFile(file, to);
-    n += 1;
-  }
-  return { files: n, slugsKept };
-}
-
-function seedControlIfMissing(target) {
-  const control = path.join(target, ".control");
-  if (fs.existsSync(control)) {
-    note(".control/ already present — left untouched");
-    return;
-  }
-  if (!fs.existsSync(SCAFFOLD)) die(`scaffold missing: ${SCAFFOLD}`);
-  const n = copyTree(SCAFFOLD, control);
-  ok(`seeded empty .control/ (${n} files)`);
-}
-
-// On a FIRST install these folders are the corpus taking shape. On an UPDATE their absence means
-// somebody removed them on purpose — `.work/` and `_bmad-output/prior-knowledge/` are exactly the two a
-// product retires once its migration is done, and one repo retired them through an applied decision.
-// Recreating them then is an installer overruling a decision it cannot read. Seed once, never resurrect.
-function seedEmptyLayers(target, { first }) {
-  const always = [".what", path.join(".how", "_platform")];
-  const firstOnly = [".work", path.join("_bmad-output", "prior-knowledge")];
-  for (const rel of first ? [...always, ...firstOnly] : always) {
-    const dest = path.join(target, rel);
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
-      note(`created ${rel.replaceAll(path.sep, "/")}/`);
-    }
-  }
-  if (!first) {
-    for (const rel of firstOnly) {
-      if (!fs.existsSync(path.join(target, rel))) {
-        note(`left ${rel.replaceAll(path.sep, "/")}/ absent — a product retires it, not the installer`);
-      }
-    }
-  }
-}
-
-function writeStamp(target) {
-  const control = path.join(target, ".control");
-  if (!fs.existsSync(control)) return;
-  const stamp = [
-    "# Written by wdi-method install/update. A trace, not a lockfile.",
-    `wdi_method: ${PKG.version}`,
-    `bmad_method: ${readBmadVersion(target) || '""'}`,
-    `installed_at: ${today()}`,
-    "",
-  ].join("\n");
-  fs.writeFileSync(path.join(control, "wdi-method.yaml"), stamp, "utf8");
-  note("stamped .control/wdi-method.yaml");
-}
-
-function setProductIdentity(target, { name, client }) {
-  if (!name || identityIsPlaceholder(name)) return;
-  const file = path.join(target, ".control", "registry", "index.yaml");
-  if (!fs.existsSync(file)) return;
-  const next = writeProductIdentity(fs.readFileSync(file, "utf8"), {
-    name,
-    client: client ?? "",
-  });
-  fs.writeFileSync(file, next.endsWith("\n") ? next : `${next}\n`);
-  note(`product.name = ${name}`);
-}
-
-// Bahasa dokumen milik PRODUK, jadi update MUST NOT menimpanya. Ia ditulis hanya ketika belum ada —
-// sama seperti kamar custom, dan dengan alasan yang sama: setelan yang pernah dipilih seseorang bukan
-// milik installer untuk diubah di belakangnya.
-function setLanguagePolicy(target, { docLanguage, docFilenameLanguage, chosen }) {
-  const file = path.join(target, ".control", "registry", "index.yaml");
-  if (!fs.existsSync(file)) return;
-  const text = fs.readFileSync(file, "utf8");
-  const existing = readLanguagePolicy(text);
-  // `chosen` berarti seseorang benar-benar menjawab — di TUI, atau lewat flag eksplisit. Maka
-  // jawabannya berlaku. Tanpa itu nilai yang masuk hanyalah default, dan default MUST NOT menimpa
-  // pilihan yang sudah pernah diambil seseorang.
-  if (!chosen && existing.docLanguage && existing.docFilenameLanguage) {
-    note(`kept policy.doc_language = ${existing.docLanguage}, ` +
-         `doc_filename_language = ${existing.docFilenameLanguage}`);
-    return;
-  }
-  const next = writeLanguagePolicy(text, {
-    docLanguage: docLanguage || existing.docLanguage || DEFAULT_DOC_LANGUAGE,
-    docFilenameLanguage:
-      docFilenameLanguage || existing.docFilenameLanguage || DEFAULT_DOC_LANGUAGE,
-  });
-  fs.writeFileSync(file, next.endsWith("\n") ? next : `${next}\n`);
-  const after = readLanguagePolicy(next);
-  note(`policy.doc_language = ${after.docLanguage}, ` +
-       `doc_filename_language = ${after.docFilenameLanguage}`);
-}
-
-// Dibaca SEBELUM writeStamp menimpanya. Tanpa ini tidak ada transisi versi yang bisa dicetak, dan
-// "updated" tanpa dari-ke tidak memberi tahu apa pun yang bisa dipakai.
-function readStampVersion(target) {
-  const file = path.join(target, ".control", "wdi-method.yaml");
-  if (!fs.existsSync(file)) return "";
-  const m = fs.readFileSync(file, "utf8").match(/^wdi_method:\s*"?([^"\s]+)"?/m);
-  return m ? m[1] : "";
-}
-
-function readIndexPolicy(target) {
-  const file = path.join(target, ".control", "registry", "index.yaml");
-  if (!fs.existsSync(file)) return { docLanguage: "", docFilenameLanguage: "" };
-  return readLanguagePolicy(fs.readFileSync(file, "utf8"));
-}
-
-function readIndexIdentity(target) {
-  const file = path.join(target, ".control", "registry", "index.yaml");
-  if (!fs.existsSync(file)) return { name: "", client: "" };
-  return readProductIdentity(fs.readFileSync(file, "utf8"));
-}
-
-function upsertAgentFiles(target, agents, productName) {
-  const template = fs.readFileSync(path.join(OVERLAY, "AGENTS.md"), "utf8");
-  const agentsFile = path.join(target, "AGENTS.md");
-  let next;
-  if (!fs.existsSync(agentsFile)) {
-    next = fillProductTitle(template, productName || "{product}");
-    ok("AGENTS.md created — rewrite ## Code for this product");
-  } else {
-    next = upsertMethodBlock(fs.readFileSync(agentsFile, "utf8"), template);
-    note("AGENTS.md method block refreshed; product sections kept");
-  }
-  if (!next.endsWith("\n")) next += "\n";
-  fs.writeFileSync(agentsFile, next);
-
-  const mirrors = [];
-  if (agents.includes("cursor")) mirrors.push(path.join(target, ".cursorrules"));
-  if (agents.includes("cursor") || agents.includes("antigravity")) {
-    mirrors.push(path.join(target, ".agents", "AGENTS.md"));
-  }
-  for (const mirror of mirrors) {
-    fs.mkdirSync(path.dirname(mirror), { recursive: true });
-    if (fs.existsSync(mirror)) {
-      const patched = upsertMethodBlock(fs.readFileSync(mirror, "utf8"), template);
-      fs.writeFileSync(mirror, patched.endsWith("\n") ? patched : `${patched}\n`);
-      note(`method block refreshed in ${posixRel(target, mirror)}`);
-    } else {
-      fs.writeFileSync(mirror, next);
-      note(`created ${posixRel(target, mirror)}`);
-    }
-  }
-
-  if (agents.includes("claude")) {
-    const claude = path.join(target, "CLAUDE.md");
-    if (!fs.existsSync(claude)) {
-      fs.writeFileSync(claude, "@AGENTS.md\n");
-      note("CLAUDE.md created as @AGENTS.md");
-    }
-  }
-}
-
-// What a run MUST leave a reader able to answer: which version replaced which, what was written, what
-// was KEPT, and what to do next. The third is the one usually missing, and it is the one that decides
-// whether somebody trusts running this over a repo they have already put work into.
-function summaryLine(label, value) {
-  console.log(`  ${DIM}${label.padEnd(11)}${RESET}${value}`);
-}
-
-function printSummary(target, agents, { first, was, written, skipped, skills, tomls }) {
-  const now = PKG.version;
-  const version = first
-    ? `${now} — first install`
-    : was && was !== now
-      ? `${was} ${DIM}→${RESET} ${now}`
-      : `${now} ${DIM}(unchanged)${RESET}`;
-  const bmad = readBmadVersion(target);
-
-  const kept = [];
-  if (skipped) kept.push(`${skipped} constitution file${skipped === 1 ? "" : "s"}`);
-  if (tomls.slugsKept) kept.push(`${tomls.slugsKept} initiative slug${tomls.slugsKept === 1 ? "" : "s"}`);
-  // On a first install the language was just CHOSEN, not kept — saying "kept" there reads as if the
-  // installer had found something it decided to leave alone, which is the opposite of what happened.
-  const policy = readIndexPolicy(target);
-  if (policy.docLanguage && !first) kept.push(`language (${policy.docLanguage})`);
-  if (fs.existsSync(path.join(target, ".constitution", "project"))) kept.push(".constitution/project/");
-
-  console.log("");
-  console.log(`${DIM}────${RESET} WDI Method ${DIM}${"─".repeat(46)}${RESET}`);
-  summaryLine("version", version);
-  if (bmad) summaryLine("bmad", bmad);
-  summaryLine("target", target);
-  console.log("");
-  summaryLine("written", `${written} constitution · ${skills.files} skill files · ${tomls.files} bmad overrides`);
-  if (kept.length) summaryLine("kept", kept.join(" · "));
-  if (skills.removed) {
-    summaryLine("removed", `${skills.removed} retired wrapper${skills.removed === 1 ? "" : "s"}`);
-  }
-  if (first && policy.docLanguage) {
-    summaryLine("language", `${policy.docLanguage} · filenames ${policy.docFilenameLanguage}`);
-  }
-  summaryLine("agents", agents.join(", ") || "none");
-  console.log("");
-  summaryLine("next", `invoke the ${HELP_SKILL} skill and ask what to do`);
-  summaryLine("", REPO_URL);
-  console.log(`${DIM}${"─".repeat(62)}${RESET}`);
-}
-
-function printNextSteps({ first, productSet }) {
-  console.log("");
-  console.log(first ? "After install:" : "After update:");
-  if (first) {
-    if (!productSet) {
-      console.log("  1. Fill product.name (and product.client if there is one) in .control/registry/index.yaml.");
-    } else {
-      console.log("  1. product.name is set. G1 confirms it in the brief.");
-    }
-    console.log("  2. Rewrite .constitution/constitution.md Articles 2 and 5 for this product.");
-    console.log("     Article 1 cites index.yaml — do not become a second source for the name.");
-    console.log("  3. Write ## Code in AGENTS.md (where the app lives). Leave the BEGIN:wdi-method block alone.");
-    console.log("  4. Run the wdi-init skill, intent setup.");
-    console.log("  5. Sort the documents you already have. Do not move any of them in this step.");
-    console.log("");
-    console.log("Next update:");
-    console.log("  npx wdi-method");
-    console.log("  (the TUI offers the update)  or:  npx wdi-method update --yes");
-  } else {
-    console.log("  1. The <!-- BEGIN:wdi-method --> block in AGENTS.md was replaced. Read the diff.");
-    console.log("  2. constitution.md Articles 1-2-5, ## Code, and *.user.toml were not overwritten.");
-    console.log("  3. If BMad has new skills, install those first, then run this update again.");
-  }
-}
-
-function apply(target, agents,
-               { first, product, client, docLanguage, docFilenameLanguage, languageChosen }) {
-  requireKit();
-  const was = readStampVersion(target);
-  const { written, skipped } = syncConstitution(target);
-  note(`constitution wrote ${written}, kept ${skipped}`);
-  const skills = syncSkills(target, agents);
-  note(`skills ${skills.files} files`);
-  const tomls = syncTomls(target);
-  note(`bmad custom ${tomls.files} toml → _bmad/custom/`);
-  if (first) seedControlIfMissing(target);
-  seedEmptyLayers(target, { first });
-  setProductIdentity(target, { name: product, client });
-  setLanguagePolicy(target, { docLanguage, docFilenameLanguage, chosen: languageChosen });
-  upsertAgentFiles(target, agents, product);
-  writeStamp(target);
-  printSummary(target, agents, { first, was, written, skipped, skills, tomls });
-  printNextSteps({
-    first,
-    productSet: Boolean(product) && !identityIsPlaceholder(product),
-  });
-}
-
-function verify(target, agents) {
-  requireKit();
-  const missing = [];
-  const kitConst = path.join(KIT, ".constitution");
-  for (const file of walkFiles(kitConst)) {
-    const rel = posixRel(kitConst, file);
-    const dest = path.join(target, ".constitution", rel);
-    if (!fs.existsSync(dest)) missing.push(`.constitution/${rel}`);
-  }
-  for (const name of WDI_SKILLS) {
-    for (const root of skillDests(target, agents)) {
-      const dest = path.join(root, name, "SKILL.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;
-    const dest = path.join(target, "_bmad", "custom", path.basename(file));
-    if (!fs.existsSync(dest)) missing.push(`_bmad/custom/${path.basename(file)}`);
-  }
-  if (fs.existsSync(path.join(target, ".control"))) {
-    for (const file of walkFiles(SCAFFOLD)) {
-      const rel = posixRel(SCAFFOLD, file);
-      const dest = path.join(target, ".control", rel);
-      if (!fs.existsSync(dest)) missing.push(`.control/${rel}`);
-    }
-  } else {
-    missing.push(".control/ (folder missing — first install should have seeded it)");
-  }
-  for (const required of ["AGENTS.md", path.join(".constitution", "constitution.md")]) {
-    if (!fs.existsSync(path.join(target, required))) missing.push(required.replaceAll(path.sep, "/"));
-  }
-  if (missing.length) {
-    console.error(`${RED}missing ${missing.length}${RESET}`);
-    for (const m of missing) console.error(`  ${m}`);
-    process.exit(1);
-  }
-  ok(`method files present in ${target}`);
-  note("extra product files are expected and were not checked");
-}
-
-function scrubPrdToml(file) {
-  const raw = fs.readFileSync(file, "utf8");
-  const m = raw.match(/run_folder_pattern\s*=\s*"([^"]+)"/);
-  if (!m) return;
-  const slug = m[1];
-  if (GENERIC_FOLDER_PATTERNS.has(slug)) return;
-  fs.writeFileSync(file, raw.split(slug).join(PRD_SLUG_PLACEHOLDER), "utf8");
-  note("bmad-prd.toml initiative slug scrubbed to placeholder");
-}
-
-function promote(live) {
-  live = path.resolve(live);
-  if (!fs.existsSync(path.join(live, ".constitution"))) {
-    die(`${live} has no .constitution/ — is this a method-carrying repo?`);
-  }
-  // README kamar custom dikarang di paket dan MUST bertahan melewati rmSync di bawah. Dibaca di
-  // sini, bukan sesudahnya — versi pertama patch ini membacanya sesudah kit dihapus, sehingga
-  // nilainya selalu null dan README-nya hilang tiap promote. Tes project-room yang menemukannya.
-  const roomKit = path.join(KIT, ".constitution", PROJECT_ROOM, "README.md");
-  const roomKept = fs.existsSync(roomKit) ? fs.readFileSync(roomKit, "utf8") : null;
-
-  fs.rmSync(KIT, { recursive: true, force: true });
-  fs.mkdirSync(KIT, { recursive: true });
-
-  const nConst = copyTree(path.join(live, ".constitution"), path.join(KIT, ".constitution"),
-                          (rel) => rel.startsWith(PROJECT_ROOM));
-  note(`constitution ${nConst} files (${PROJECT_ROOM} skipped — it is the product's)`);
-  if (roomKept !== null) {
-    fs.mkdirSync(path.dirname(roomKit), { recursive: true });
-    fs.writeFileSync(roomKit, roomKept, "utf8");
-    note(`${PROJECT_ROOM}README.md restored from the package — promote never carries it home`);
-  }
-
-  let copiedSkills = 0;
-  const skillsSrc = path.join(live, ".claude", "skills");
-  for (const name of WDI_SKILLS) {
-    const src = path.join(skillsSrc, name);
-    if (!fs.existsSync(src)) die(`skill missing in live repo: ${src}`);
-    copiedSkills += copyTree(src, path.join(KIT, "skills", name));
-  }
-  note(`skills ${copiedSkills} files (${WDI_SKILLS.length} wrappers)`);
-
-  const customSrc = path.join(live, "_bmad", "custom");
-  const customDst = path.join(KIT, "assets", "bmad-custom");
-  fs.mkdirSync(customDst, { recursive: true });
-  let tomls = 0;
-  if (fs.existsSync(customSrc)) {
-    for (const file of walkFiles(customSrc)) {
-      if (!file.endsWith(".toml") || file.endsWith(".user.toml")) continue;
-      copyFile(file, path.join(customDst, path.basename(file)));
-      tomls += 1;
-    }
-  }
-  const prd = path.join(customDst, "bmad-prd.toml");
-  if (fs.existsSync(prd)) scrubPrdToml(prd);
-  note(`bmad custom ${tomls} toml`);
-
-  const replacements = {
-    "constitution.md": path.join(KIT, ".constitution", "constitution.md"),
-    "portability.md": path.join(KIT, ".constitution", "method", "portability.md"),
-    "repo-guide.md": path.join(KIT, ".constitution", "repo-guide.md"),
-    "README.md": path.join(KIT, ".constitution", "README.md"),
-  };
-  for (const [name, dest] of Object.entries(replacements)) {
-    const src = path.join(OVERLAY, name);
-    if (fs.existsSync(src)) {
-      copyFile(src, dest);
-      note(`${name} replaced with kit overlay`);
-    }
-  }
-
-  const source = [
-    `date: ${today()}`,
-    `commit: ${gitHead(live)}`,
-    "kind: working copy that currently carries a newer method",
-    "note: the repo path and product name MUST NOT be recorded here",
-    "",
-  ].join("\n");
-  fs.writeFileSync(path.join(ROOT, "SOURCE"), source, "utf8");
-  ok(`SOURCE stamped ${today()} @ ${gitHead(live)}`);
-  ok(`promoted into ${KIT}`);
-}
-
-function cancelIf(value) {
-  if (p.isCancel(value)) {
-    p.cancel("Cancelled.");
-    process.exit(0);
-  }
-  return value;
-}
-
-async function runWizard(pre) {
-  p.intro(`WDI Method ${PKG.version}`);
-
-  const dirValue = cancelIf(
-    await p.text({
-      message: "Target repo (the product folder)",
-      placeholder: process.cwd(),
-      defaultValue: pre.dir || process.cwd(),
-    }),
-  );
-  const target = path.resolve(String(dirValue).trim() || process.cwd());
-
-  if (!fs.existsSync(target)) {
-    const create = cancelIf(
-      await p.confirm({ message: `${target} does not exist. Create it?`, initialValue: true }),
-    );
-    if (!create) {
-      p.cancel("No target folder.");
-      process.exit(1);
-    }
-    fs.mkdirSync(target, { recursive: true });
-  }
-
-  const hasBmad = bmadPresent(target);
-  const hasWdi = wdiPresent(target);
-  const nonempty = dirNonEmpty(target);
-
-  const facts = [
-    hasBmad
-      ? `BMad Method: terpasang${readBmadVersion(target) ? ` (${readBmadVersion(target)})` : ""}`
-      : "BMad Method: belum terpasang",
-    hasWdi ? "WDI Method: sudah ada — installer akan menawarkan update" : "WDI Method: belum ada",
-    nonempty ? "Folder tidak kosong (repo produk yang sudah jalan itu biasa)" : "Folder masih kosong",
-  ].join("\n");
-  p.note(facts, "Deteksi");
-
-  if (!hasBmad && !pre.skipBmad) {
-    p.note(bmadMissingMessage(), "BMad first");
-    p.outro("Install BMad, then run this again: npx wdi-method");
-    process.exit(1);
-  }
-
-  let first = !hasWdi;
-  if (hasWdi) {
-    const update = cancelIf(
-      await p.confirm({
-        message: "WDI Method is already installed. Update it now?",
-        initialValue: true,
-      }),
-    );
-    first = !update;
-    if (first) {
-      p.cancel("Update declined.");
-      process.exit(0);
-    }
-  } else {
-    const go = cancelIf(
-      await p.confirm({
-        message: `Install WDI Method into ${target}?`,
-        initialValue: true,
-      }),
-    );
-    if (!go) {
-      p.cancel("Install declined.");
-      process.exit(0);
-    }
-  }
-
-  // Every field arrives with an answer already in it, and Enter accepts it. On an update that answer is
-  // what the repo already says; on a first install it is the folder name made readable. Nothing here is
-  // validated as required: a prompt that refuses an empty submission when it already holds a sensible
-  // default is asking the owner to retype something the installer knows.
-  const existing = readIndexIdentity(target);
-  const suggestedName = identityIsPlaceholder(existing.name)
-    ? humaniseFolderName(path.basename(target))
-    : existing.name;
-  const product = cancelIf(
-    await p.text({
-      message: "Product name (one room: index.yaml product.name)",
-      placeholder: suggestedName,
-      defaultValue: suggestedName,
-    }),
-  ).trim() || suggestedName;
-  const client = cancelIf(
-    await p.text({
-      message: "Client name (Enter to leave it as it is)",
-      placeholder: existing.client || "(none)",
-      defaultValue: existing.client || "",
-    }),
-  ).trim();
-
-  // Dua pertanyaan, dan hanya dua. Istilah metodologi, kode di depan nama berkas, penanda
-  // machine-facing, dan identifier kode selalu English — MUST NOT ditanyakan.
-  const policy = readIndexPolicy(target);
-  // Teks bebas, bukan daftar. Tulis apa saja yang dimengerti sebuah model — "English",
-  // "Bahasa Indonesia", "id". Yang ditolak hanya kosong.
-  const askLanguage = async (message, current) =>
-    (cancelIf(
-      await p.text({
-        message,
-        placeholder: current || DEFAULT_DOC_LANGUAGE,
-        defaultValue: current || DEFAULT_DOC_LANGUAGE,
-      }),
-    ) || DEFAULT_DOC_LANGUAGE).trim();
-  const docLanguage = await askLanguage(
-    "Language of working-document prose (.what/ .how/ .control/) — free text",
-    policy.docLanguage || pre.docLanguage);
-  const docFilenameLanguage = await askLanguage(
-    "Language of document filename slugs — the `UC-` `DEC-` codes stay English",
-    policy.docFilenameLanguage || pre.docFilenameLanguage || docLanguage);
-
-  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),
-      required: true,
-    }),
-  );
-
-  p.note(
-    [
-      "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)"
-        : "",
-      selected.includes("antigravity") ? "  .agents/AGENTS.md" : "",
-    ]
-      .filter(Boolean)
-      .join("\n"),
-    "Write targets",
-  );
-
-  const okGo = cancelIf(await p.confirm({ message: first ? "Run the install?" : "Run the update?", initialValue: true }));
-  if (!okGo) {
-    p.cancel("Dibatalkan.");
-    process.exit(0);
-  }
-
-  const spinner = p.spinner();
-  spinner.start(first ? "Memasang…" : "Meng-update…");
-  apply(target, selected, {
-    docLanguage,
-    docFilenameLanguage,
-    languageChosen: true,
-    first,
-    product: String(product).trim(),
-    client: String(client).trim(),
-  });
-  spinner.stop(first ? "Terpasang" : "Ter-update");
-  p.outro(first ? "Done. Take the after-install steps above." : "Done. Read the method-block diff in AGENTS.md.");
-}
-
-function runNonInteractive(args) {
-  const target = requireTarget(args.dir);
-  const agents = args.agents || detectAgents(target) || ALL_AGENTS.slice();
-  if (args.cmd === "verify") {
-    verify(target, agents);
-    return;
-  }
-  if (!args.skipBmad && !bmadPresent(target)) {
-    die(bmadMissingMessage());
-  }
-  const existing = readIndexIdentity(target);
-  const product = args.product || existing.name;
-  const client = args.client ?? existing.client;
-  const first = args.cmd === "install" || (args.cmd === "wizard" && !wdiPresent(target));
-  apply(target, agents, {
-    first: args.cmd === "update" ? false : first,
-    product,
-    client,
-    docLanguage: args.docLanguage,
-    docFilenameLanguage: args.docFilenameLanguage,
-    languageChosen: Boolean(args.docLanguage || args.docFilenameLanguage),
-  });
-}
-
-async function main() {
-  const args = parseArgs(process.argv);
-  if (!["wizard", "install", "update", "verify", "promote"].includes(args.cmd)) {
-    usage();
-    process.exit(2);
-  }
-  if (args.cmd === "promote") {
-    if (!args.dir) die("promote needs a path to the working copy");
-    promote(args.dir);
-    return;
-  }
-  const wantTui = !args.yes && args.cmd !== "verify" && process.stdin.isTTY && process.stdout.isTTY;
-  if (wantTui) {
-    await runWizard(args);
-    return;
-  }
-  if (args.cmd === "wizard" && !args.yes) {
-    die("bukan TTY. Pakai `install --yes` / `update --yes`, atau jalankan di terminal.");
-  }
-  if (args.cmd === "wizard") args.cmd = wdiPresent(requireTarget(args.dir)) ? "update" : "install";
-  runNonInteractive(args);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import * as p from "@clack/prompts";
+import {
+  fillProductTitle,
+  upsertMethodBlock,
+} from "../lib/agents-block.mjs";
+import {
+  identityIsPlaceholder,
+  humaniseFolderName,
+  readLanguagePolicy,
+  writeLanguagePolicy,
+  DEFAULT_DOC_LANGUAGE,
+  readProductIdentity,
+  writeProductIdentity,
+} from "../lib/identity.mjs";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const KIT = path.join(ROOT, "kit");
+const OVERLAY = path.join(ROOT, "kit-overlay");
+const SCAFFOLD = path.join(ROOT, "scaffold", ".control");
+const PKG = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf8"));
+
+const WDI_SKILLS = [
+  "wdi-init",
+  "wdi-problem",
+  "wdi-product",
+  "wdi-ux",
+  "wdi-blueprint",
+  "wdi-component",
+  "wdi-build",
+  "wdi-decision",
+  "wdi-question",
+  "wdi-log",
+  "wdi-help",
+  "wdi-reconcile",
+  "wdi-review",
+  "wdi-report",
+  "wdi-systematic-debugging",
+];
+
+const PRODUCT_CONSTITUTION = "constitution.md";
+const PRD_SLUG_PLACEHOLDER = "FILL-initiative-slug";
+const GENERIC_FOLDER_PATTERNS = new Set([
+  "_product-brief",
+  "ux",
+  "architecture",
+  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";
+const BMAD_REPO = "https://github.com/bmad-code-org/BMAD-METHOD";
+const WDI_REPO = "https://github.com/wiradigitalid/wdi-method";
+
+const RED = "\x1b[31m";
+const GREEN = "\x1b[32m";
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+
+function die(msg) {
+  console.error(`${RED}error:${RESET} ${msg}`);
+  process.exit(1);
+}
+
+function ok(msg) {
+  console.log(`${GREEN}ok${RESET}  ${msg}`);
+}
+
+function note(msg) {
+  console.log(`${DIM}·${RESET}   ${msg}`);
+}
+
+function usage() {
+  console.log(`wdi-method ${PKG.version}
+
+  (no command)              interactive TUI — detects install vs update
+  install [dir]             first install (TUI unless --yes)
+  update  [dir]             update      (TUI unless --yes)
+  verify  [dir]
+  promote <live-dir>
+
+  --yes                     non-interactive
+  --agents a,b              claude,cursor,codex,antigravity
+  --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
+  --doc-filename-language <text>   slug part of document filenames; free text, default English
+  --skip-bmad-check
+
+BMad first, then this package. ${WDI_REPO}
+`);
+}
+
+function parseArgs(argv) {
+  const args = {
+    cmd: null,
+    dir: null,
+    agents: null,
+    skipBmad: false,
+    yes: false,
+    product: null,
+    client: null,
+    docLanguage: null,
+    docFilenameLanguage: null,
+  };
+  const rest = argv.slice(2);
+  if (rest[0] === "-h" || rest[0] === "--help") {
+    usage();
+    process.exit(0);
+  }
+  if (rest.length === 0) {
+    args.cmd = "wizard";
+    return args;
+  }
+  const first = rest[0];
+  if (["install", "update", "verify", "promote"].includes(first)) {
+    args.cmd = rest.shift();
+  } else if (first.startsWith("-")) {
+    args.cmd = "wizard";
+  } else {
+    args.cmd = "wizard";
+    args.dir = rest.shift();
+  }
+  while (rest.length) {
+    const t = rest.shift();
+    if (t === "--skip-bmad-check") args.skipBmad = true;
+    else if (t === "--yes" || t === "-y") args.yes = true;
+    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}`);
+      }
+    } 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") {
+      // Free text: "English", "Bahasa Indonesia", "id" — a model reads it, so no list to match.
+      const raw = (rest.shift() || "").trim();
+      if (!raw) die(`${t} needs a value, for example: English`);
+      if (t === "--doc-language") args.docLanguage = raw;
+      else args.docFilenameLanguage = raw;
+    }
+    else if (t.startsWith("-")) die(`unknown flag: ${t}`);
+    else if (!args.dir) args.dir = t;
+    else die(`unexpected argument: ${t}`);
+  }
+  return args;
+}
+
+// Build output and editor droppings MUST NOT reach the kit. This repository is public, and a
+// __pycache__/*.pyc carries the ABSOLUTE PATH of the source it was compiled from — which means a
+// product name and a client folder leak into a public package through a file nobody wrote.
+// Found 2026-08-18 on the first real promote: inventory.cpython-314.pyc embedded the live repo path.
+const SKIP_DIRS = new Set(["__pycache__", "node_modules", ".git", ".pytest_cache", ".ruff_cache",
+                           ".mypy_cache", ".venv", "venv", "dist", "build", ".idea", ".vscode"]);
+const SKIP_FILE = /(\.pyc|\.pyo|\.pyd|\.log|\.tmp|\.swp|\.orig|\.rej|\.bak)$|^\.DS_Store$|^Thumbs\.db$/i;
+
+function walkFiles(dir) {
+  const out = [];
+  if (!fs.existsSync(dir)) return out;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (SKIP_DIRS.has(entry.name)) continue;
+      out.push(...walkFiles(p));
+    } else if (entry.isFile()) {
+      if (SKIP_FILE.test(entry.name)) continue;
+      out.push(p);
+    }
+  }
+  return out;
+}
+
+function copyFile(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+function copyTree(src, dest, skipRel) {
+  let n = 0;
+  for (const p of walkFiles(src)) {
+    const rel = posixRel(src, p);
+    if (skipRel && skipRel(rel)) continue;
+    copyFile(p, path.join(dest, path.relative(src, p)));
+    n += 1;
+  }
+  return n;
+}
+
+function posixRel(from, to) {
+  return path.relative(from, to).split(path.sep).join("/");
+}
+
+function acceptedCodebase(file) {
+  try {
+    const head = fs.readFileSync(file, "utf8").slice(0, 400);
+    return /status:\s*Accepted/i.test(head);
+  } catch {
+    return false;
+  }
+}
+
+function bmadPresent(target) {
+  const markers = [
+    path.join(target, ".claude", "skills", "bmad-help", "SKILL.md"),
+    path.join(target, "_bmad", "core", "config.yaml"),
+    path.join(target, "_bmad", "_config", "manifest.yaml"),
+  ];
+  return markers.some((p) => fs.existsSync(p));
+}
+
+function wdiPresent(target) {
+  return (
+    fs.existsSync(path.join(target, ".control", "wdi-method.yaml")) ||
+    fs.existsSync(path.join(target, ".constitution", "method", "README.md"))
+  );
+}
+
+function dirNonEmpty(target) {
+  if (!fs.existsSync(target)) return false;
+  return fs.readdirSync(target).some((n) => n !== ".git" && n !== ".gitignore");
+}
+
+function readBmadVersion(target) {
+  const manifest = path.join(target, "_bmad", "_config", "manifest.yaml");
+  if (!fs.existsSync(manifest)) return "";
+  const text = fs.readFileSync(manifest, "utf8");
+  const m = text.match(/installation:\s*\n\s*version:\s*(\S+)/);
+  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",
+  });
+  if (r.status !== 0) return "unknown";
+  return r.stdout.trim();
+}
+
+function today() {
+  return new Date().toISOString().slice(0, 10);
+}
+
+function requireKit() {
+  if (!fs.existsSync(path.join(KIT, ".constitution"))) {
+    die(`kit missing at ${KIT}`);
+  }
+}
+
+function requireTarget(dir) {
+  const target = path.resolve(dir || process.cwd());
+  if (!fs.existsSync(target) || !fs.statSync(target).isDirectory()) {
+    die(`target is not a directory: ${target}`);
+  }
+  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.",
+    "",
+    `  ${BMAD_INSTALL}`,
+    "",
+    `Source: ${BMAD_REPO}`,
+    "In the BMad installer, pick the same agents (Claude Code, Cursor, …).",
+  ].join("\n");
+}
+
+// The product's custom room. Three properties, and all three MUST hold together:
+//   install/update  seeds its content ONLY when absent — never written again after that
+//   promote         SKIPS it entirely, so a product's own rules can never reach the public repo
+//   agent           loads it like any other guide, so it BINDS
+// The deliberate consequence: this room's README is authored in the package and never comes home
+// through promote.
+const PROJECT_ROOM = "project/";
+
+function syncConstitution(target) {
+  const kitConst = path.join(KIT, ".constitution");
+  const destConst = path.join(target, ".constitution");
+  fs.mkdirSync(destConst, { recursive: true });
+  let written = 0;
+  let skipped = 0;
+  for (const file of walkFiles(kitConst)) {
+    const rel = posixRel(kitConst, file);
+    const dest = path.join(destConst, rel);
+    if (rel === PRODUCT_CONSTITUTION && fs.existsSync(dest)) {
+      skipped += 1;
+      note(`keep ${rel} (product articles)`);
+      continue;
+    }
+    if (rel.startsWith("codebase/") && fs.existsSync(dest) && acceptedCodebase(dest)) {
+      skipped += 1;
+      note(`keep ${rel} (Accepted codebase guide)`);
+      continue;
+    }
+    if (rel.startsWith(PROJECT_ROOM) && fs.existsSync(dest)) {
+      skipped += 1;
+      note(`keep ${rel} (product custom room)`);
+      continue;
+    }
+    copyFile(file, dest);
+    written += 1;
+  }
+  return { written, skipped };
+}
+
+function syncSkills(target, agents) {
+  let n = 0;
+  const dests = skillDests(target, agents);
+  if (dests.length === 0) {
+    note("no skill destinations for selected agents — AGENTS.md still applies");
+    return 0;
+  }
+  for (const name of WDI_SKILLS) {
+    const src = path.join(KIT, "skills", name);
+    if (!fs.existsSync(src)) die(`kit missing skill ${name}`);
+    for (const root of dests) {
+      const dest = path.join(root, name);
+      fs.rmSync(dest, { recursive: true, force: true });
+      n += copyTree(src, dest);
+    }
+  }
+  const removed = pruneRetiredSkills(dests);
+  return { files: n, removed };
+}
+
+// A wrapper the method RETIRED is worse than a wrapper missing: the folder is still there, its
+// SKILL.md still reads like an instruction, and an agent will invoke it — while the guide it points
+// at is gone. Renaming five wrappers (wdi-apply, wdi-analysis, wdi-structure, …) left exactly that
+// in every repo installed before the rename, because update only ever touched the names it knows.
+//
+// `wdi-` is the method's namespace, so a `wdi-*` folder carrying a SKILL.md and not in WDI_SKILLS is
+// ours and retired. Each removal is PRINTED: silent deletion in someone else's repo is not a fix.
+function pruneRetiredSkills(dests) {
+  let removed = 0;
+  const keep = new Set(WDI_SKILLS);
+  for (const root of dests) {
+    if (!fs.existsSync(root)) continue;
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!entry.isDirectory() || !entry.name.startsWith("wdi-") || keep.has(entry.name)) continue;
+      const dir = path.join(root, entry.name);
+      if (!fs.existsSync(path.join(dir, "SKILL.md"))) {
+        note(`kept ${entry.name} (no SKILL.md — not one of ours)`);
+        continue;
+      }
+      fs.rmSync(dir, { recursive: true, force: true });
+      note(`removed retired skill ${entry.name}`);
+      removed += 1;
+    }
+  }
+  return removed;
+}
+
+// `promote` scrubs a product's initiative slug out of bmad-prd.toml before publishing, which is right.
+// Writing the scrubbed PLACEHOLDER back into a product repo is not: the first real install replaced a
+// live `run_folder_pattern = "some-real-slug"` with `FILL-initiative-slug`, and nothing said so. A value
+// the product already chose is not the installer's to overwrite — same rule as the custom room and the
+// language policy.
+const PLACEHOLDER_SLUG = "FILL-initiative-slug";
+const RUN_FOLDER_LINE = /^(\s*run_folder_pattern\s*=\s*)(".*?"|'.*?')/m;
+
+// The slug appears MORE THAN ONCE — bmad-prd.toml carries it in `run_folder_pattern` and again inside a
+// memlog path, and the file itself says the two lines MUST change together. The first version of this
+// function restored only the first line and so produced exactly the inconsistency that file forbids.
+// So: read the product's slug once, then put it back everywhere the placeholder appears.
+function keepProductSlug(incoming, existing) {
+  const mineNow = existing.match(RUN_FOLDER_LINE);
+  if (!mineNow) return null;
+  const slug = mineNow[2].slice(1, -1);
+  if (!slug || slug === PLACEHOLDER_SLUG) return null;
+  if (!incoming.includes(PLACEHOLDER_SLUG)) return null;
+  // Only where the slug is a VALUE: the quoted setting, and the memlog path built from it. A bare
+  // mention inside a comment stays the placeholder — that sentence explains the pattern, and rewriting
+  // it would turn a generic explanation into a statement about one initiative.
+  return incoming
+    .replaceAll(`"${PLACEHOLDER_SLUG}"`, `"${slug}"`)
+    .replaceAll(`prd-${PLACEHOLDER_SLUG}`, `prd-${slug}`);
+}
+
+function syncTomls(target) {
+  const src = path.join(KIT, "assets", "bmad-custom");
+  const dest = path.join(target, "_bmad", "custom");
+  fs.mkdirSync(dest, { recursive: true });
+  let n = 0;
+  let slugsKept = 0;
+  for (const file of walkFiles(src)) {
+    if (!file.endsWith(".toml") || file.endsWith(".user.toml")) continue;
+    const to = path.join(dest, path.basename(file));
+    if (fs.existsSync(to)) {
+      const merged = keepProductSlug(fs.readFileSync(file, "utf8"), fs.readFileSync(to, "utf8"));
+      if (merged !== null) {
+        fs.writeFileSync(to, merged);
+        note(`kept run_folder_pattern in ${path.basename(file)}`);
+        slugsKept += 1;
+        n += 1;
+        continue;
+      }
+    }
+    copyFile(file, to);
+    n += 1;
+  }
+  return { files: n, slugsKept };
+}
+
+function seedControlIfMissing(target) {
+  const control = path.join(target, ".control");
+  if (fs.existsSync(control)) {
+    note(".control/ already present — left untouched");
+    return;
+  }
+  if (!fs.existsSync(SCAFFOLD)) die(`scaffold missing: ${SCAFFOLD}`);
+  const n = copyTree(SCAFFOLD, control);
+  ok(`seeded empty .control/ (${n} files)`);
+}
+
+// On a FIRST install these folders are the corpus taking shape. On an UPDATE their absence means
+// somebody removed them on purpose — `.work/` and `_bmad-output/prior-knowledge/` are exactly the two a
+// product retires once its migration is done, and one repo retired them through an applied decision.
+// Recreating them then is an installer overruling a decision it cannot read. Seed once, never resurrect.
+function seedEmptyLayers(target, { first }) {
+  const always = [".what", path.join(".how", "_platform")];
+  const firstOnly = [".work", path.join("_bmad-output", "prior-knowledge")];
+  for (const rel of first ? [...always, ...firstOnly] : always) {
+    const dest = path.join(target, rel);
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+      note(`created ${rel.replaceAll(path.sep, "/")}/`);
+    }
+  }
+  if (!first) {
+    for (const rel of firstOnly) {
+      if (!fs.existsSync(path.join(target, rel))) {
+        note(`left ${rel.replaceAll(path.sep, "/")}/ absent — a product retires it, not the installer`);
+      }
+    }
+  }
+}
+
+function writeStamp(target) {
+  const control = path.join(target, ".control");
+  if (!fs.existsSync(control)) return;
+  const stamp = [
+    "# Written by wdi-method install/update. A trace, not a lockfile.",
+    `wdi_method: ${PKG.version}`,
+    `bmad_method: ${readBmadVersion(target) || '""'}`,
+    `installed_at: ${today()}`,
+    "",
+  ].join("\n");
+  fs.writeFileSync(path.join(control, "wdi-method.yaml"), stamp, "utf8");
+  note("stamped .control/wdi-method.yaml");
+}
+
+function setProductIdentity(target, { name, client }) {
+  if (!name || identityIsPlaceholder(name)) return;
+  const file = path.join(target, ".control", "registry", "index.yaml");
+  if (!fs.existsSync(file)) return;
+  const next = writeProductIdentity(fs.readFileSync(file, "utf8"), {
+    name,
+    client: client ?? "",
+  });
+  fs.writeFileSync(file, next.endsWith("\n") ? next : `${next}\n`);
+  note(`product.name = ${name}`);
+}
+
+// The document language belongs to the PRODUCT, so update MUST NOT overwrite it. It is written only
+// when absent — same as the custom room, and for the same reason: a setting somebody already chose
+// is not the installer's to change behind their back.
+function setLanguagePolicy(target, { docLanguage, docFilenameLanguage, chosen }) {
+  const file = path.join(target, ".control", "registry", "index.yaml");
+  if (!fs.existsSync(file)) return;
+  const text = fs.readFileSync(file, "utf8");
+  const existing = readLanguagePolicy(text);
+  // `chosen` means somebody actually answered — in the TUI, or through an explicit flag. Only then
+  // does the answer take effect. Without it the incoming value is just a default, and a default
+  // MUST NOT overwrite a choice somebody already made.
+  if (!chosen && existing.docLanguage && existing.docFilenameLanguage) {
+    note(`kept policy.doc_language = ${existing.docLanguage}, ` +
+         `doc_filename_language = ${existing.docFilenameLanguage}`);
+    return;
+  }
+  const next = writeLanguagePolicy(text, {
+    docLanguage: docLanguage || existing.docLanguage || DEFAULT_DOC_LANGUAGE,
+    docFilenameLanguage:
+      docFilenameLanguage || existing.docFilenameLanguage || DEFAULT_DOC_LANGUAGE,
+  });
+  fs.writeFileSync(file, next.endsWith("\n") ? next : `${next}\n`);
+  const after = readLanguagePolicy(next);
+  note(`policy.doc_language = ${after.docLanguage}, ` +
+       `doc_filename_language = ${after.docFilenameLanguage}`);
+}
+
+// Read BEFORE writeStamp overwrites it. Without this there is no version transition to print, and
+// an "updated" with no from-to tells the reader nothing they can use.
+function readStampVersion(target) {
+  const file = path.join(target, ".control", "wdi-method.yaml");
+  if (!fs.existsSync(file)) return "";
+  const m = fs.readFileSync(file, "utf8").match(/^wdi_method:\s*"?([^"\s]+)"?/m);
+  return m ? m[1] : "";
+}
+
+function readIndexPolicy(target) {
+  const file = path.join(target, ".control", "registry", "index.yaml");
+  if (!fs.existsSync(file)) return { docLanguage: "", docFilenameLanguage: "" };
+  return readLanguagePolicy(fs.readFileSync(file, "utf8"));
+}
+
+function readIndexIdentity(target) {
+  const file = path.join(target, ".control", "registry", "index.yaml");
+  if (!fs.existsSync(file)) return { name: "", client: "" };
+  return readProductIdentity(fs.readFileSync(file, "utf8"));
+}
+
+function upsertAgentFiles(target, agents, productName) {
+  const template = fs.readFileSync(path.join(OVERLAY, "AGENTS.md"), "utf8");
+  const agentsFile = path.join(target, "AGENTS.md");
+  let next;
+  if (!fs.existsSync(agentsFile)) {
+    next = fillProductTitle(template, productName || "{product}");
+    ok("AGENTS.md created — rewrite ## Code for this product");
+  } else {
+    next = upsertMethodBlock(fs.readFileSync(agentsFile, "utf8"), template);
+    note("AGENTS.md method block refreshed; product sections kept");
+  }
+  if (!next.endsWith("\n")) next += "\n";
+  fs.writeFileSync(agentsFile, next);
+
+  const mirrors = [];
+  if (agents.includes("cursor")) mirrors.push(path.join(target, ".cursorrules"));
+  if (agents.includes("cursor") || agents.includes("antigravity")) {
+    mirrors.push(path.join(target, ".agents", "AGENTS.md"));
+  }
+  for (const mirror of mirrors) {
+    fs.mkdirSync(path.dirname(mirror), { recursive: true });
+    if (fs.existsSync(mirror)) {
+      const patched = upsertMethodBlock(fs.readFileSync(mirror, "utf8"), template);
+      fs.writeFileSync(mirror, patched.endsWith("\n") ? patched : `${patched}\n`);
+      note(`method block refreshed in ${posixRel(target, mirror)}`);
+    } else {
+      fs.writeFileSync(mirror, next);
+      note(`created ${posixRel(target, mirror)}`);
+    }
+  }
+
+  if (agents.includes("claude")) {
+    const claude = path.join(target, "CLAUDE.md");
+    if (!fs.existsSync(claude)) {
+      fs.writeFileSync(claude, "@AGENTS.md\n");
+      note("CLAUDE.md created as @AGENTS.md");
+    }
+  }
+}
+
+// What a run MUST leave a reader able to answer: which version replaced which, what was written, what
+// was KEPT, and what to do next. The third is the one usually missing, and it is the one that decides
+// whether somebody trusts running this over a repo they have already put work into.
+function summaryLine(label, value) {
+  console.log(`  ${DIM}${label.padEnd(11)}${RESET}${value}`);
+}
+
+function printSummary(target, agents, { first, was, written, skipped, skills, tomls }) {
+  const now = PKG.version;
+  const version = first
+    ? `${now} — first install`
+    : was && was !== now
+      ? `${was} ${DIM}→${RESET} ${now}`
+      : `${now} ${DIM}(unchanged)${RESET}`;
+  const bmad = readBmadVersion(target);
+
+  const kept = [];
+  if (skipped) kept.push(`${skipped} constitution file${skipped === 1 ? "" : "s"}`);
+  if (tomls.slugsKept) kept.push(`${tomls.slugsKept} initiative slug${tomls.slugsKept === 1 ? "" : "s"}`);
+  // On a first install the language was just CHOSEN, not kept — saying "kept" there reads as if the
+  // installer had found something it decided to leave alone, which is the opposite of what happened.
+  const policy = readIndexPolicy(target);
+  if (policy.docLanguage && !first) kept.push(`language (${policy.docLanguage})`);
+  if (fs.existsSync(path.join(target, ".constitution", "project"))) kept.push(".constitution/project/");
+
+  console.log("");
+  console.log(`${DIM}────${RESET} WDI Method ${DIM}${"─".repeat(46)}${RESET}`);
+  summaryLine("version", version);
+  if (bmad) summaryLine("bmad", bmad);
+  summaryLine("target", target);
+  console.log("");
+  summaryLine("written", `${written} constitution · ${skills.files} skill files · ${tomls.files} bmad overrides`);
+  if (kept.length) summaryLine("kept", kept.join(" · "));
+  if (skills.removed) {
+    summaryLine("removed", `${skills.removed} retired wrapper${skills.removed === 1 ? "" : "s"}`);
+  }
+  if (first && policy.docLanguage) {
+    summaryLine("language", `${policy.docLanguage} · filenames ${policy.docFilenameLanguage}`);
+  }
+  summaryLine("agents", agents.join(", ") || "none");
+  console.log("");
+  summaryLine("next", `invoke the ${HELP_SKILL} skill and ask what to do`);
+  summaryLine("", REPO_URL);
+  console.log(`${DIM}${"─".repeat(62)}${RESET}`);
+}
+
+function printNextSteps({ first, productSet }) {
+  console.log("");
+  console.log(first ? "After install:" : "After update:");
+  if (first) {
+    if (!productSet) {
+      console.log("  1. Fill product.name (and product.client if there is one) in .control/registry/index.yaml.");
+    } else {
+      console.log("  1. product.name is set. G1 confirms it in the brief.");
+    }
+    console.log("  2. Rewrite .constitution/constitution.md Articles 2 and 5 for this product.");
+    console.log("     Article 1 cites index.yaml — do not become a second source for the name.");
+    console.log("  3. Write ## Code in AGENTS.md (where the app lives). Leave the BEGIN:wdi-method block alone.");
+    console.log("  4. Run the wdi-init skill, intent setup.");
+    console.log("  5. Sort the documents you already have. Do not move any of them in this step.");
+    console.log("");
+    console.log("Next update:");
+    console.log("  npx wdi-method");
+    console.log("  (the TUI offers the update)  or:  npx wdi-method update --yes");
+  } else {
+    console.log("  1. The <!-- BEGIN:wdi-method --> block in AGENTS.md was replaced. Read the diff.");
+    console.log("  2. constitution.md Articles 1-2-5, ## Code, and *.user.toml were not overwritten.");
+    console.log("  3. If BMad has new skills, install those first, then run this update again.");
+  }
+}
+
+function apply(target, agents,
+               { first, product, client, docLanguage, docFilenameLanguage, languageChosen }) {
+  requireKit();
+  const was = readStampVersion(target);
+  const { written, skipped } = syncConstitution(target);
+  note(`constitution wrote ${written}, kept ${skipped}`);
+  const skills = syncSkills(target, agents);
+  note(`skills ${skills.files} files`);
+  const tomls = syncTomls(target);
+  note(`bmad custom ${tomls.files} toml → _bmad/custom/`);
+  if (first) seedControlIfMissing(target);
+  seedEmptyLayers(target, { first });
+  setProductIdentity(target, { name: product, client });
+  setLanguagePolicy(target, { docLanguage, docFilenameLanguage, chosen: languageChosen });
+  upsertAgentFiles(target, agents, product);
+  writeStamp(target);
+  printSummary(target, agents, { first, was, written, skipped, skills, tomls });
+  printNextSteps({
+    first,
+    productSet: Boolean(product) && !identityIsPlaceholder(product),
+  });
+}
+
+function verify(target, agents) {
+  requireKit();
+  const missing = [];
+  const kitConst = path.join(KIT, ".constitution");
+  for (const file of walkFiles(kitConst)) {
+    const rel = posixRel(kitConst, file);
+    const dest = path.join(target, ".constitution", rel);
+    if (!fs.existsSync(dest)) missing.push(`.constitution/${rel}`);
+  }
+  for (const name of WDI_SKILLS) {
+    for (const root of skillDests(target, agents)) {
+      const dest = path.join(root, name, "SKILL.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;
+    const dest = path.join(target, "_bmad", "custom", path.basename(file));
+    if (!fs.existsSync(dest)) missing.push(`_bmad/custom/${path.basename(file)}`);
+  }
+  if (fs.existsSync(path.join(target, ".control"))) {
+    for (const file of walkFiles(SCAFFOLD)) {
+      const rel = posixRel(SCAFFOLD, file);
+      const dest = path.join(target, ".control", rel);
+      if (!fs.existsSync(dest)) missing.push(`.control/${rel}`);
+    }
+  } else {
+    missing.push(".control/ (folder missing — first install should have seeded it)");
+  }
+  for (const required of ["AGENTS.md", path.join(".constitution", "constitution.md")]) {
+    if (!fs.existsSync(path.join(target, required))) missing.push(required.replaceAll(path.sep, "/"));
+  }
+  if (missing.length) {
+    console.error(`${RED}missing ${missing.length}${RESET}`);
+    for (const m of missing) console.error(`  ${m}`);
+    process.exit(1);
+  }
+  ok(`method files present in ${target}`);
+  note("extra product files are expected and were not checked");
+}
+
+function scrubPrdToml(file) {
+  const raw = fs.readFileSync(file, "utf8");
+  const m = raw.match(/run_folder_pattern\s*=\s*"([^"]+)"/);
+  if (!m) return;
+  const slug = m[1];
+  if (GENERIC_FOLDER_PATTERNS.has(slug)) return;
+  fs.writeFileSync(file, raw.split(slug).join(PRD_SLUG_PLACEHOLDER), "utf8");
+  note("bmad-prd.toml initiative slug scrubbed to placeholder");
+}
+
+function promote(live) {
+  live = path.resolve(live);
+  if (!fs.existsSync(path.join(live, ".constitution"))) {
+    die(`${live} has no .constitution/ — is this a method-carrying repo?`);
+  }
+  // The custom room's README is authored in the package and MUST survive the rmSync below. Read
+  // here, not after — the first version of this fix read it after the kit was deleted, so it was
+  // always null and the README vanished on every promote. The project-room test caught it.
+  const roomKit = path.join(KIT, ".constitution", PROJECT_ROOM, "README.md");
+  const roomKept = fs.existsSync(roomKit) ? fs.readFileSync(roomKit, "utf8") : null;
+
+  fs.rmSync(KIT, { recursive: true, force: true });
+  fs.mkdirSync(KIT, { recursive: true });
+
+  const nConst = copyTree(path.join(live, ".constitution"), path.join(KIT, ".constitution"),
+                          (rel) => rel.startsWith(PROJECT_ROOM));
+  note(`constitution ${nConst} files (${PROJECT_ROOM} skipped — it is the product's)`);
+  if (roomKept !== null) {
+    fs.mkdirSync(path.dirname(roomKit), { recursive: true });
+    fs.writeFileSync(roomKit, roomKept, "utf8");
+    note(`${PROJECT_ROOM}README.md restored from the package — promote never carries it home`);
+  }
+
+  let copiedSkills = 0;
+  const skillsSrc = path.join(live, ".claude", "skills");
+  for (const name of WDI_SKILLS) {
+    const src = path.join(skillsSrc, name);
+    if (!fs.existsSync(src)) die(`skill missing in live repo: ${src}`);
+    copiedSkills += copyTree(src, path.join(KIT, "skills", name));
+  }
+  note(`skills ${copiedSkills} files (${WDI_SKILLS.length} wrappers)`);
+
+  const customSrc = path.join(live, "_bmad", "custom");
+  const customDst = path.join(KIT, "assets", "bmad-custom");
+  fs.mkdirSync(customDst, { recursive: true });
+  let tomls = 0;
+  if (fs.existsSync(customSrc)) {
+    for (const file of walkFiles(customSrc)) {
+      if (!file.endsWith(".toml") || file.endsWith(".user.toml")) continue;
+      copyFile(file, path.join(customDst, path.basename(file)));
+      tomls += 1;
+    }
+  }
+  const prd = path.join(customDst, "bmad-prd.toml");
+  if (fs.existsSync(prd)) scrubPrdToml(prd);
+  note(`bmad custom ${tomls} toml`);
+
+  const replacements = {
+    "constitution.md": path.join(KIT, ".constitution", "constitution.md"),
+    "portability.md": path.join(KIT, ".constitution", "method", "portability.md"),
+    "repo-guide.md": path.join(KIT, ".constitution", "repo-guide.md"),
+    "README.md": path.join(KIT, ".constitution", "README.md"),
+  };
+  for (const [name, dest] of Object.entries(replacements)) {
+    const src = path.join(OVERLAY, name);
+    if (fs.existsSync(src)) {
+      copyFile(src, dest);
+      note(`${name} replaced with kit overlay`);
+    }
+  }
+
+  const source = [
+    `date: ${today()}`,
+    `commit: ${gitHead(live)}`,
+    "kind: working copy that currently carries a newer method",
+    "note: the repo path and product name MUST NOT be recorded here",
+    "",
+  ].join("\n");
+  fs.writeFileSync(path.join(ROOT, "SOURCE"), source, "utf8");
+  ok(`SOURCE stamped ${today()} @ ${gitHead(live)}`);
+  ok(`promoted into ${KIT}`);
+}
+
+function cancelIf(value) {
+  if (p.isCancel(value)) {
+    p.cancel("Cancelled.");
+    process.exit(0);
+  }
+  return value;
+}
+
+async function runWizard(pre) {
+  p.intro(`WDI Method ${PKG.version}`);
+
+  const dirValue = cancelIf(
+    await p.text({
+      message: "Target repo (the product folder)",
+      placeholder: process.cwd(),
+      defaultValue: pre.dir || process.cwd(),
+    }),
+  );
+  const target = path.resolve(String(dirValue).trim() || process.cwd());
+
+  if (!fs.existsSync(target)) {
+    const create = cancelIf(
+      await p.confirm({ message: `${target} does not exist. Create it?`, initialValue: true }),
+    );
+    if (!create) {
+      p.cancel("No target folder.");
+      process.exit(1);
+    }
+    fs.mkdirSync(target, { recursive: true });
+  }
+
+  const hasBmad = bmadPresent(target);
+  const hasWdi = wdiPresent(target);
+  const nonempty = dirNonEmpty(target);
+
+  const facts = [
+    hasBmad
+      ? `BMad Method: installed${readBmadVersion(target) ? ` (${readBmadVersion(target)})` : ""}`
+      : "BMad Method: not installed",
+    hasWdi ? "WDI Method: already present — the installer will offer an update" : "WDI Method: not present",
+    nonempty ? "Folder is not empty (normal for a product repo already under way)" : "Folder is empty",
+  ].join("\n");
+  p.note(facts, "Detected");
+
+  if (!hasBmad && !pre.skipBmad) {
+    p.note(bmadMissingMessage(), "BMad first");
+    p.outro("Install BMad, then run this again: npx wdi-method");
+    process.exit(1);
+  }
+
+  let first = !hasWdi;
+  if (hasWdi) {
+    const update = cancelIf(
+      await p.confirm({
+        message: "WDI Method is already installed. Update it now?",
+        initialValue: true,
+      }),
+    );
+    first = !update;
+    if (first) {
+      p.cancel("Update declined.");
+      process.exit(0);
+    }
+  } else {
+    const go = cancelIf(
+      await p.confirm({
+        message: `Install WDI Method into ${target}?`,
+        initialValue: true,
+      }),
+    );
+    if (!go) {
+      p.cancel("Install declined.");
+      process.exit(0);
+    }
+  }
+
+  // Every field arrives with an answer already in it, and Enter accepts it. On an update that answer is
+  // what the repo already says; on a first install it is the folder name made readable. Nothing here is
+  // validated as required: a prompt that refuses an empty submission when it already holds a sensible
+  // default is asking the owner to retype something the installer knows.
+  const existing = readIndexIdentity(target);
+  const suggestedName = identityIsPlaceholder(existing.name)
+    ? humaniseFolderName(path.basename(target))
+    : existing.name;
+  const product = cancelIf(
+    await p.text({
+      message: "Product name (one room: index.yaml product.name)",
+      placeholder: suggestedName,
+      defaultValue: suggestedName,
+    }),
+  ).trim() || suggestedName;
+  const client = cancelIf(
+    await p.text({
+      message: "Client name (Enter to leave it as it is)",
+      placeholder: existing.client || "(none)",
+      defaultValue: existing.client || "",
+    }),
+  ).trim();
+
+  // Two questions, and only two. Method terminology, document code prefixes, machine-facing
+  // markers, and code identifiers are always English — MUST NOT be asked about.
+  const policy = readIndexPolicy(target);
+  // Free text, not a list. Write whatever a model understands — "English", "Bahasa Indonesia",
+  // "id". The only value refused is empty.
+  const askLanguage = async (message, current) =>
+    (cancelIf(
+      await p.text({
+        message,
+        placeholder: current || DEFAULT_DOC_LANGUAGE,
+        defaultValue: current || DEFAULT_DOC_LANGUAGE,
+      }),
+    ) || DEFAULT_DOC_LANGUAGE).trim();
+  const docLanguage = await askLanguage(
+    "Language of working-document prose (.what/ .how/ .control/) — free text",
+    policy.docLanguage || pre.docLanguage);
+  const docFilenameLanguage = await askLanguage(
+    "Language of document filename slugs — the `UC-` `DEC-` codes stay English",
+    policy.docFilenameLanguage || pre.docFilenameLanguage || docLanguage);
+
+  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),
+      required: true,
+    }),
+  );
+
+  p.note(
+    [
+      "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)"
+        : "",
+      selected.includes("antigravity") ? "  .agents/AGENTS.md" : "",
+    ]
+      .filter(Boolean)
+      .join("\n"),
+    "Write targets",
+  );
+
+  const okGo = cancelIf(await p.confirm({ message: first ? "Run the install?" : "Run the update?", initialValue: true }));
+  if (!okGo) {
+    p.cancel("Dibatalkan.");
+    process.exit(0);
+  }
+
+  const spinner = p.spinner();
+  spinner.start(first ? "Memasang…" : "Meng-update…");
+  apply(target, selected, {
+    docLanguage,
+    docFilenameLanguage,
+    languageChosen: true,
+    first,
+    product: String(product).trim(),
+    client: String(client).trim(),
+  });
+  spinner.stop(first ? "Terpasang" : "Ter-update");
+  p.outro(first ? "Done. Take the after-install steps above." : "Done. Read the method-block diff in AGENTS.md.");
+}
+
+function runNonInteractive(args) {
+  const target = requireTarget(args.dir);
+  const agents = args.agents || detectAgents(target) || ALL_AGENTS.slice();
+  if (args.cmd === "verify") {
+    verify(target, agents);
+    return;
+  }
+  if (!args.skipBmad && !bmadPresent(target)) {
+    die(bmadMissingMessage());
+  }
+  const existing = readIndexIdentity(target);
+  const product = args.product || existing.name;
+  const client = args.client ?? existing.client;
+  const first = args.cmd === "install" || (args.cmd === "wizard" && !wdiPresent(target));
+  apply(target, agents, {
+    first: args.cmd === "update" ? false : first,
+    product,
+    client,
+    docLanguage: args.docLanguage,
+    docFilenameLanguage: args.docFilenameLanguage,
+    languageChosen: Boolean(args.docLanguage || args.docFilenameLanguage),
+  });
+}
+
+async function main() {
+  const args = parseArgs(process.argv);
+  if (!["wizard", "install", "update", "verify", "promote"].includes(args.cmd)) {
+    usage();
+    process.exit(2);
+  }
+  if (args.cmd === "promote") {
+    if (!args.dir) die("promote needs a path to the working copy");
+    promote(args.dir);
+    return;
+  }
+  const wantTui = !args.yes && args.cmd !== "verify" && process.stdin.isTTY && process.stdout.isTTY;
+  if (wantTui) {
+    await runWizard(args);
+    return;
+  }
+  if (args.cmd === "wizard" && !args.yes) {
+    die("not a TTY. Use `install --yes` / `update --yes`, or run this in a terminal.");
+  }
+  if (args.cmd === "wizard") args.cmd = wdiPresent(requireTarget(args.dir)) ? "update" : "install";
+  runNonInteractive(args);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});