agent-method 1.5.3 → 1.5.6

package/lib/init.js

@@ -1,296 +1,478 @@
-/**
- * Interactive project setup — Node.js port of setup.sh.
- *
- * Creates a new methodology instance from templates with interactive
- * prompts for project configuration.
- */
-
-import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, readdirSync, unlinkSync } from "node:fs";
-import { resolve, join, dirname, basename, relative } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const EXTENSION_MAP = {
-  code: "code-project.md",
-  data: "data-exploration.md",
-  analytical: "analytical-system.md",
-};
-
-const FRIENDLY_NAMES = {
-  code: "Code project",
-  data: "Data exploration",
-  analytical: "Analytical/prompt system",
-  mixed: "Multi-type project",
-  general: "General project",
-};
-
-const RUNTIME_ENTRY_POINTS = {
-  claude: "CLAUDE.md",
-  cursor: ".cursorrules",
-  all: null, // keep all
-};
-
-/**
- * Set up a new project with methodology templates.
- */
-export async function initProject(projectType, directory, opts = {}) {
-  const { tier = "starter", runtime = "all", profile = "standard", registryPath } = opts;
-  const targetDir = resolve(directory);
-  const methodRoot = resolve(__dirname, "..");
-
-  const templateDir = join(methodRoot, "templates", tier);
-  if (!existsSync(templateDir)) {
-    console.error(`Template directory not found: ${templateDir}`);
-    process.exit(1);
-  }
-
-  console.log(`\nSetting up ${FRIENDLY_NAMES[projectType] || projectType} project`);
-  console.log(`  Template: ${tier}`);
-  console.log(`  Profile:  ${profile}`);
-  console.log(`  Runtime:  ${runtime}`);
-  console.log(`  Target:   ${targetDir}\n`);
-
-  // Detect brownfield (existing project with methodology files)
-  const isBrownfield = detectBrownfield(targetDir);
-  if (isBrownfield) {
-    console.log("  Detected existing methodology files (brownfield mode)");
-    console.log("  Will append to existing entry points, not overwrite.\n");
-  }
-
-  // Create target directory
-  mkdirSync(targetDir, { recursive: true });
-
-  // Copy template files
-  const copied = [];
-  const skipped = [];
-  copyTemplateDir(templateDir, targetDir, copied, skipped, isBrownfield);
-
-  // Apply extensions based on project type
-  const extensions = getExtensions(projectType);
-  for (const ext of extensions) {
-    const extFile = join(methodRoot, "templates", "extensions", ext);
-    if (existsSync(extFile)) {
-      mergeExtension(extFile, targetDir, isBrownfield);
-      copied.push(`extension: ${ext}`);
-    }
-  }
-
-  // Replace placeholders in entry points
-  replacePlaceholders(targetDir, projectType, tier);
-
-  // Set integration profile in entry points
-  setProfile(targetDir, profile);
-
-  // Remove unused entry points based on runtime choice
-  const removed = removeUnusedEntryPoints(targetDir, runtime, isBrownfield);
-
-  // Report
-  console.log(`  Files created: ${copied.length}`);
-  for (const f of copied) console.log(`    + ${f}`);
-  if (removed.length > 0) {
-    console.log(`  Entry points removed: ${removed.length}`);
-    for (const f of removed) console.log(`    - ${f}`);
-  }
-  if (skipped.length > 0) {
-    console.log(`  Files skipped (already exist): ${skipped.length}`);
-    for (const f of skipped) console.log(`    ~ ${f}`);
-  }
-
-  // Determine which entry point the user kept
-  const keptEntry = runtime === "claude" ? "CLAUDE.md"
-    : runtime === "cursor" ? ".cursorrules"
-    : "CLAUDE.md / .cursorrules / AGENT.md";
-
-  console.log(`\nNext steps:`);
-  console.log(`  1. cd ${relative(process.cwd(), targetDir) || "."}`);
-  console.log(`  2. Fill in PROJECT.md with your project vision`);
-  if (runtime === "all") {
-    console.log(`  3. Delete the two entry point files you don't use`);
-    console.log(`     (keep CLAUDE.md, .cursorrules, or AGENT.md)`);
-  }
-  console.log(`  ${runtime === "all" ? "4" : "3"}. Start a conversation — the agent reads ${keptEntry} automatically`);
-  console.log(`\nVerify: npx wwa check`);
-}
-
-function detectBrownfield(dir) {
-  if (!existsSync(dir)) return false;
-  const indicators = ["CLAUDE.md", ".cursorrules", "AGENT.md", "STATE.md", ".context"];
-  let count = 0;
-  for (const ind of indicators) {
-    if (existsSync(join(dir, ind))) count++;
-  }
-  return count >= 2;
-}
-
-function copyTemplateDir(src, dst, copied, skipped, isBrownfield) {
-  if (!existsSync(src)) return;
-  mkdirSync(dst, { recursive: true });
-
-  for (const entry of readdirSync(src, { withFileTypes: true })) {
-    const srcPath = join(src, entry.name);
-    const dstPath = join(dst, entry.name);
-
-    if (entry.isDirectory()) {
-      copyTemplateDir(srcPath, dstPath, copied, skipped, isBrownfield);
-    } else {
-      // Entry points: special handling in brownfield
-      const isEntryPoint = ["CLAUDE.md", ".cursorrules", "AGENT.md"].includes(entry.name);
-
-      if (existsSync(dstPath)) {
-        if (isEntryPoint && isBrownfield) {
-          // Append methodology sections to existing entry point
-          appendToEntryPoint(srcPath, dstPath);
-          copied.push(`${relative(dst, dstPath)} (merged)`);
-        } else {
-          skipped.push(relative(dst, dstPath));
-        }
-      } else {
-        copyFileSync(srcPath, dstPath);
-        copied.push(relative(dst, dstPath));
-      }
-    }
-  }
-}
-
-function appendToEntryPoint(srcPath, dstPath) {
-  const srcContent = readFileSync(srcPath, "utf-8");
-  let dstContent = readFileSync(dstPath, "utf-8");
-
-  // Extract sections from template that don't exist in target
-  const sections = ["## Scoping rules", "## Dependency cascade", "## Conventions", "## Do not"];
-  for (const section of sections) {
-    if (!dstContent.includes(section) && srcContent.includes(section)) {
-      const idx = srcContent.indexOf(section);
-      // Find the next section or end
-      let endIdx = srcContent.length;
-      for (const nextSection of sections) {
-        const nextIdx = srcContent.indexOf(nextSection, idx + section.length);
-        if (nextIdx > idx && nextIdx < endIdx) {
-          endIdx = nextIdx;
-        }
-      }
-      const sectionContent = srcContent.slice(idx, endIdx).trim();
-      dstContent += "\n\n" + sectionContent;
-    }
-  }
-
-  writeFileSync(dstPath, dstContent, "utf-8");
-}
-
-function getExtensions(projectType) {
-  if (projectType === "mixed") {
-    return Object.values(EXTENSION_MAP);
-  }
-  const ext = EXTENSION_MAP[projectType];
-  return ext ? [ext] : [];
-}
-
-function mergeExtension(extFile, targetDir, isBrownfield) {
-  const content = readFileSync(extFile, "utf-8");
-
-  // Extract scoping rows and cascade rows from extension file
-  const scopingRows = [];
-  const cascadeRows = [];
-  let inScoping = false;
-  let inCascade = false;
-
-  for (const line of content.split("\n")) {
-    if (line.includes("## Scoping")) inScoping = true;
-    if (line.includes("## Cascade") || line.includes("## Dependency cascade"))
-      inCascade = true;
-    if (line.startsWith("## ") && !line.includes("Scoping") && !line.includes("Cascade")) {
-      inScoping = false;
-      inCascade = false;
-    }
-
-    if (inScoping && line.startsWith("|") && !line.startsWith("| Query") && !line.startsWith("|--")) {
-      scopingRows.push(line);
-    }
-    if (inCascade && line.startsWith("|") && !line.startsWith("| When") && !line.startsWith("|--")) {
-      cascadeRows.push(line);
-    }
-  }
-
-  // Inject rows into entry points
-  for (const epName of ["CLAUDE.md", ".cursorrules", "AGENT.md"]) {
-    const epPath = join(targetDir, epName);
-    if (!existsSync(epPath)) continue;
-
-    let epContent = readFileSync(epPath, "utf-8");
-
-    // Inject scoping rows before the instruction comment or at end of table
-    if (scopingRows.length > 0) {
-      const placeholder = "<!-- INSTRUCTION: Add project-specific scoping";
-      if (epContent.includes(placeholder)) {
-        epContent = epContent.replace(
-          placeholder,
-          scopingRows.join("\n") + "\n" + placeholder
-        );
-      }
-    }
-
-    // Inject cascade rows
-    if (cascadeRows.length > 0) {
-      const placeholder = "<!-- INSTRUCTION: Add project-specific cascade";
-      if (epContent.includes(placeholder)) {
-        epContent = epContent.replace(
-          placeholder,
-          cascadeRows.join("\n") + "\n" + placeholder
-        );
-      }
-    }
-
-    writeFileSync(epPath, epContent, "utf-8");
-  }
-}
-
-function replacePlaceholders(targetDir, projectType, tier) {
-  for (const epName of ["CLAUDE.md", ".cursorrules", "AGENT.md"]) {
-    const epPath = join(targetDir, epName);
-    if (!existsSync(epPath)) continue;
-
-    let content = readFileSync(epPath, "utf-8");
-
-    // Replace project type placeholder
-    content = content.replace(/\{your-project-type\}/g, projectType);
-    content = content.replace(/\{your-domain-type\}/g, projectType);
-
-    // Set template tier
-    content = content.replace(/template_tier:\s*\S+/, `template_tier: ${tier}`);
-
-    writeFileSync(epPath, content, "utf-8");
-  }
-}
-
-function setProfile(targetDir, profile) {
-  for (const epName of ["CLAUDE.md", ".cursorrules", "AGENT.md"]) {
-    const epPath = join(targetDir, epName);
-    if (!existsSync(epPath)) continue;
-
-    let content = readFileSync(epPath, "utf-8");
-    content = content.replace(/tier:\s*(lite|standard|full)/, `tier: ${profile}`);
-    writeFileSync(epPath, content, "utf-8");
-  }
-}
-
-function removeUnusedEntryPoints(targetDir, runtime, isBrownfield) {
-  if (runtime === "all" || isBrownfield) return [];
-
-  const allEntryPoints = ["CLAUDE.md", ".cursorrules", "AGENT.md"];
-  const keep = RUNTIME_ENTRY_POINTS[runtime];
-  if (!keep) return [];
-
-  const removed = [];
-  for (const ep of allEntryPoints) {
-    if (ep !== keep) {
-      const epPath = join(targetDir, ep);
-      if (existsSync(epPath)) {
-        unlinkSync(epPath);
-        removed.push(ep);
-      }
-    }
-  }
-  return removed;
-}
+/**
+ * Interactive project setup — Node.js port of setup.sh.
+ *
+ * Creates a new methodology instance from templates with interactive
+ * prompts for project configuration.
+ */
+
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, copyFileSync, writeFileSync } from "node:fs";
+import { resolve, join, dirname, basename, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { safeCopyFile, safeWriteFile } from "./cli/helpers.js";
+
+/** Entry point filenames that bypass the extension-based safety check. */
+const ENTRY_POINT_NAMES = new Set(["CLAUDE.md", ".cursorrules", "AGENT.md"]);
+
+/** Write file — allows entry points (e.g. .cursorrules) plus safe extensions. */
+function writeInitFile(filePath, content, encoding = "utf-8") {
+  const name = basename(filePath);
+  if (ENTRY_POINT_NAMES.has(name)) {
+    writeFileSync(filePath, content, encoding);
+  } else {
+    safeWriteFile(filePath, content, encoding);
+  }
+}
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const EXTENSION_MAP = {
+  code: "code-project.md",
+  data: "data-exploration.md",
+  analytical: "analytical-system.md",
+};
+
+const FRIENDLY_NAMES = {
+  code: "Code project",
+  data: "Data exploration",
+  analytical: "Analytical/prompt system",
+  mixed: "Multi-type project",
+  general: "General project",
+};
+
+const RUNTIME_ENTRY_POINTS = {
+  claude: "CLAUDE.md",
+  cursor: ".cursorrules",
+  all: null, // keep all
+};
+
+/**
+ * Set up a new project with methodology templates.
+ */
+export async function initProject(projectType, directory, opts = {}) {
+  const { tier = "starter", runtime = "all", profile = "standard", onboarding = "auto", registryPath } = opts;
+  const targetDir = resolve(directory);
+  const methodRoot = resolve(__dirname, "..");
+
+  const templateDir = join(methodRoot, "templates", tier);
+  if (!existsSync(templateDir)) {
+    console.error(`Template directory not found: ${templateDir}`);
+    process.exit(1);
+  }
+
+  console.log(`\nSetting up ${FRIENDLY_NAMES[projectType] || projectType} project`);
+  console.log(`  Template:   ${tier}`);
+  console.log(`  Profile:    ${profile}`);
+  console.log(`  Runtime:    ${runtime}`);
+  console.log(`  Onboarding: ${onboarding}`);
+  console.log(`  Target:     ${targetDir}\n`);
+
+  // Determine brownfield mode from user selection or auto-detection
+  let isBrownfield;
+  if (onboarding === "brownfield") {
+    isBrownfield = true;
+  } else if (onboarding === "greenfield") {
+    isBrownfield = false;
+  } else {
+    // auto — detect from existing files
+    isBrownfield = detectBrownfield(targetDir);
+  }
+
+  if (isBrownfield) {
+    console.log("  Brownfield mode — will append to existing entry points, not overwrite.\n");
+  }
+
+  // Create target directory
+  mkdirSync(targetDir, { recursive: true });
+
+  // Copy template files
+  const copied = [];
+  const skipped = [];
+  copyTemplateDir(templateDir, targetDir, copied, skipped, isBrownfield, runtime);
+
+  // Apply extensions based on project type
+  const extensions = getExtensions(projectType);
+  for (const ext of extensions) {
+    const extFile = join(methodRoot, "templates", "extensions", ext);
+    if (existsSync(extFile)) {
+      mergeExtension(extFile, targetDir, isBrownfield);
+      copied.push(`extension: ${ext}`);
+    }
+  }
+
+  // Copy feature-registry.yaml to user project (populated, from package)
+  copyFeatureRegistry(methodRoot, targetDir, copied);
+
+  // Create project-specific doc-tokens.yaml with initial values
+  createProjectTokens(targetDir, projectType, tier, profile, onboarding, copied);
+
+  // Replace placeholders in entry points
+  replacePlaceholders(targetDir, projectType, tier);
+
+  // Set integration profile in entry points
+  setProfile(targetDir, profile);
+
+  // Set onboarding scenario in PROJECT-PROFILE.md
+  setOnboardingScenario(targetDir, onboarding, isBrownfield, projectType);
+
+  // Remove unused entry points based on runtime choice
+  const removed = removeUnusedEntryPoints(targetDir, runtime, isBrownfield);
+
+  // Report
+  console.log(`  Files created: ${copied.length}`);
+  for (const f of copied) console.log(`    + ${f}`);
+  if (removed.length > 0) {
+    console.log(`  Entry points removed: ${removed.length}`);
+    for (const f of removed) console.log(`    - ${f}`);
+  }
+  if (skipped.length > 0) {
+    console.log(`  Files skipped (already exist): ${skipped.length}`);
+    for (const f of skipped) console.log(`    ~ ${f}`);
+  }
+
+  // Determine which entry point the user kept
+  const keptEntry = runtime === "claude" ? "CLAUDE.md"
+    : runtime === "cursor" ? ".cursorrules"
+    : "CLAUDE.md / .cursorrules / AGENT.md";
+
+  console.log(`\nNext steps:`);
+  let step = 1;
+  console.log(`  ${step++}. cd ${relative(process.cwd(), targetDir) || "."}`);
+  if (runtime === "all") {
+    console.log(`  ${step++}. Delete the two entry point files you don't use`);
+    console.log(`     (keep CLAUDE.md, .cursorrules, or AGENT.md)`);
+  }
+  console.log(`  ${step++}. Start a conversation with your agent — it reads ${keptEntry} automatically`);
+  if (isBrownfield) {
+    console.log(`     The agent will scan your codebase and walk you through 5 onboarding stages`);
+    console.log(`     (scan → clarify → map → organize → starting state)`);
+  } else {
+    console.log(`     The agent will walk you through 4 onboarding stages`);
+    console.log(`     (vision → architecture → goals → starting state)`);
+  }
+  console.log(`\nVerify: wwa check`);
+}
+
+function detectBrownfield(dir) {
+  if (!existsSync(dir)) return false;
+  const indicators = ["CLAUDE.md", ".cursorrules", "AGENT.md", "STATE.md", ".context"];
+  let count = 0;
+  for (const ind of indicators) {
+    if (existsSync(join(dir, ind))) count++;
+  }
+  return count >= 2;
+}
+
+function copyTemplateDir(src, dst, copied, skipped, isBrownfield, runtime) {
+  if (!existsSync(src)) return;
+  mkdirSync(dst, { recursive: true });
+
+  for (const entry of readdirSync(src, { withFileTypes: true })) {
+    const srcPath = join(src, entry.name);
+    const dstPath = join(dst, entry.name);
+
+    if (entry.isDirectory()) {
+      copyTemplateDir(srcPath, dstPath, copied, skipped, isBrownfield, runtime);
+    } else {
+      // Entry points: special handling in brownfield
+      const isEntryPoint = ["CLAUDE.md", ".cursorrules", "AGENT.md"].includes(entry.name);
+
+      // Skip entry points that won't be kept (avoids safety invariant issue with .cursorrules)
+      if (isEntryPoint && runtime !== "all" && !isBrownfield) {
+        const keep = RUNTIME_ENTRY_POINTS[runtime];
+        if (keep && entry.name !== keep) continue;
+      }
+
+      // Defer heavy infrastructure files in brownfield to reduce first-session load
+      const isDeferredInBrownfield = isBrownfield && entry.name === "REGISTRY.md";
+      if (isDeferredInBrownfield) {
+        skipped.push(`${relative(dst, dstPath)} (deferred — created on first file split)`);
+        continue;
+      }
+
+      if (existsSync(dstPath)) {
+        if (isEntryPoint && isBrownfield) {
+          // Append methodology sections to existing entry point
+          appendToEntryPoint(srcPath, dstPath);
+          copied.push(`${relative(dst, dstPath)} (merged)`);
+        } else {
+          skipped.push(relative(dst, dstPath));
+        }
+      } else if (isEntryPoint) {
+        // Entry points bypass safeCopyFile (e.g. .cursorrules has no .md extension)
+        copyFileSync(srcPath, dstPath);
+        copied.push(relative(dst, dstPath));
+      } else {
+        safeCopyFile(srcPath, dstPath);
+        copied.push(relative(dst, dstPath));
+      }
+    }
+  }
+}
+
+function appendToEntryPoint(srcPath, dstPath) {
+  const srcContent = readFileSync(srcPath, "utf-8");
+  let dstContent = readFileSync(dstPath, "utf-8");
+
+  // Extract sections from template that don't exist in target
+  const sections = ["## Scoping rules", "## Dependency cascade", "## Conventions", "## Do not"];
+  for (const section of sections) {
+    if (!dstContent.includes(section) && srcContent.includes(section)) {
+      const idx = srcContent.indexOf(section);
+      // Find the next section or end
+      let endIdx = srcContent.length;
+      for (const nextSection of sections) {
+        const nextIdx = srcContent.indexOf(nextSection, idx + section.length);
+        if (nextIdx > idx && nextIdx < endIdx) {
+          endIdx = nextIdx;
+        }
+      }
+      const sectionContent = srcContent.slice(idx, endIdx).trim();
+      dstContent += "\n\n" + sectionContent;
+    }
+  }
+
+  writeInitFile(dstPath, dstContent, "utf-8");
+}
+
+function getExtensions(projectType) {
+  if (projectType === "mixed") {
+    return Object.values(EXTENSION_MAP);
+  }
+  const ext = EXTENSION_MAP[projectType];
+  return ext ? [ext] : [];
+}
+
+function mergeExtension(extFile, targetDir, isBrownfield) {
+  const content = readFileSync(extFile, "utf-8");
+
+  // Extract scoping rows and cascade rows from extension file
+  const scopingRows = [];
+  const cascadeRows = [];
+  let inScoping = false;
+  let inCascade = false;
+
+  for (const line of content.split("\n")) {
+    if (line.includes("## Scoping")) inScoping = true;
+    if (line.includes("## Cascade") || line.includes("## Dependency cascade"))
+      inCascade = true;
+    if (line.startsWith("## ") && !line.includes("Scoping") && !line.includes("Cascade")) {
+      inScoping = false;
+      inCascade = false;
+    }
+
+    if (inScoping && line.startsWith("|") && !line.startsWith("| Query") && !line.startsWith("|--")) {
+      scopingRows.push(line);
+    }
+    if (inCascade && line.startsWith("|") && !line.startsWith("| When") && !line.startsWith("|--")) {
+      cascadeRows.push(line);
+    }
+  }
+
+  // Inject rows into entry points
+  for (const epName of ["CLAUDE.md", ".cursorrules", "AGENT.md"]) {
+    const epPath = join(targetDir, epName);
+    if (!existsSync(epPath)) continue;
+
+    let epContent = readFileSync(epPath, "utf-8");
+
+    // Inject scoping rows before the instruction comment or at end of table
+    if (scopingRows.length > 0) {
+      const placeholder = "<!-- INSTRUCTION: Add project-specific scoping";
+      if (epContent.includes(placeholder)) {
+        epContent = epContent.replace(
+          placeholder,
+          scopingRows.join("\n") + "\n" + placeholder
+        );
+      }
+    }
+
+    // Inject cascade rows
+    if (cascadeRows.length > 0) {
+      const placeholder = "<!-- INSTRUCTION: Add project-specific cascade";
+      if (epContent.includes(placeholder)) {
+        epContent = epContent.replace(
+          placeholder,
+          cascadeRows.join("\n") + "\n" + placeholder
+        );
+      }
+    }
+
+    writeInitFile(epPath, epContent, "utf-8");
+  }
+}
+
+function replacePlaceholders(targetDir, projectType, tier) {
+  for (const epName of ["CLAUDE.md", ".cursorrules", "AGENT.md"]) {
+    const epPath = join(targetDir, epName);
+    if (!existsSync(epPath)) continue;
+
+    let content = readFileSync(epPath, "utf-8");
+
+    // Replace project type placeholder
+    content = content.replace(/\{your-project-type\}/g, projectType);
+    content = content.replace(/\{your-domain-type\}/g, projectType);
+
+    // Set template tier
+    content = content.replace(/template_tier:\s*\S+/, `template_tier: ${tier}`);
+
+    writeInitFile(epPath, content, "utf-8");
+  }
+}
+
+function setProfile(targetDir, profile) {
+  for (const epName of ["CLAUDE.md", ".cursorrules", "AGENT.md"]) {
+    const epPath = join(targetDir, epName);
+    if (!existsSync(epPath)) continue;
+
+    let content = readFileSync(epPath, "utf-8");
+    content = content.replace(/tier:\s*(lite|standard|full)/, `tier: ${profile}`);
+    writeInitFile(epPath, content, "utf-8");
+  }
+}
+
+function setOnboardingScenario(targetDir, onboarding, isBrownfield, projectType) {
+  const profilePath = join(targetDir, "PROJECT-PROFILE.md");
+  if (!existsSync(profilePath)) return;
+
+  let content = readFileSync(profilePath, "utf-8");
+
+  // Set lifecycle stage based on scenario
+  const stage = isBrownfield ? "discovery" : "design";
+  content = content.replace(/\*\*Stage\*\*:\s*\{stage\}/, `**Stage**: ${stage}`);
+  content = content.replace(/\*\*Maturity\*\*:\s*\{maturity\}/, `**Maturity**: new`);
+
+  const today = new Date().toISOString().slice(0, 10);
+  content = content.replace(
+    /\*\*Last transition\*\*:\s*\{date\}.*$/m,
+    `**Last transition**: ${today} (setup -> ${stage})`
+  );
+
+  // Set project type
+  content = content.replace(/\[{project-type}\]/, `[${projectType}]`);
+
+  // Set onboarding hint so the agent knows which first-session flow
+  const scenario = onboarding === "auto"
+    ? (isBrownfield ? "brownfield (auto-detected)" : "greenfield (auto-detected)")
+    : onboarding;
+
+  // Add onboarding scenario after lifecycle section
+  if (!content.includes("**Onboarding**")) {
+    content = content.replace(
+      /(\*\*Last transition\*\*:.*$)/m,
+      `$1\n- **Onboarding**: ${scenario}`
+    );
+  }
+
+  // Set extension stack
+  const extensions = getExtensions(projectType);
+  const extNames = extensions.map(e => e.replace(".md", ""));
+  content = content.replace(/\[{extensions-applied}\]/, `[${extNames.join(", ") || "none"}]`);
+
+  for (const ext of ["code-project", "data-exploration", "analytical-system"]) {
+    const isActive = extNames.includes(ext) ? "yes" : "no";
+    const source = extNames.includes(ext) ? "wwa init" : "—";
+    content = content.replace(
+      new RegExp(`\\| ${ext} \\| \\{yes/no\\} \\| \\{setup\\.sh / manual\\} \\|`),
+      `| ${ext} | ${isActive} | ${source} |`
+    );
+  }
+
+  safeWriteFile(profilePath, content, "utf-8");
+}
+
+function createProjectTokens(targetDir, projectType, tier, profile, onboarding, copied) {
+  const ctxDir = join(targetDir, ".context");
+  mkdirSync(ctxDir, { recursive: true });
+  const dst = join(ctxDir, "doc-tokens.yaml");
+  if (existsSync(dst)) return; // don't overwrite
+
+  const today = new Date().toISOString().slice(0, 10);
+
+  // Count files that were actually created
+  const mdFiles = [];
+  const countMdFiles = (dir) => {
+    if (!existsSync(dir)) return;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const p = join(dir, entry.name);
+      if (entry.isDirectory()) countMdFiles(p);
+      else if (entry.name.endsWith(".md") || entry.name.endsWith(".yaml") || entry.name.endsWith(".yml")) {
+        mdFiles.push(relative(targetDir, p).replace(/\\/g, "/"));
+      }
+    }
+  };
+  countMdFiles(targetDir);
+
+  const content = [
+    "# Project Token Registry",
+    "# Computed by wwa init. Updated by wwa close.",
+    "# Used by wwa casestudy for methodology reference data.",
+    "#",
+    "# Agent: read this before writing docs. Check values are current.",
+    "",
+    "tokens:",
+    "",
+    "  # --- Project identity ---",
+    `  project_type: ${projectType}`,
+    `  template_tier: ${tier}`,
+    `  integration_profile: ${profile}`,
+    `  onboarding: ${onboarding}`,
+    `  created: "${today}"`,
+    `  last_close: "${today}"`,
+    "",
+    "  # --- File counts (updated at close) ---",
+    `  methodology_file_count: ${mdFiles.length}`,
+    "  docs_file_count: 0",
+    "  context_file_count: 0",
+    "",
+    "  # --- Session metrics (updated at close) ---",
+    "  session_count: 0",
+    "  decision_count: 0",
+    "  total_features_referenced: 0",
+    "",
+    "  # --- Scale indicators (updated at close) ---",
+    "  files_near_threshold: 0           # files with 250+ lines",
+    "  files_over_threshold: 0           # files with 300+ lines (need splitting)",
+    "",
+    "  # --- Docs coverage (updated at close) ---",
+    "  docs_inventory_count: 0",
+    "  docs_on_disk: 0",
+    "  docs_missing: 0",
+    "  component_mappings: 0",
+    "",
+  ].join("\n");
+
+  safeWriteFile(dst, content, "utf-8");
+  copied.push(".context/doc-tokens.yaml");
+}
+
+function copyFeatureRegistry(methodRoot, targetDir, copied) {
+  const src = join(methodRoot, "docs", "internal", "feature-registry.yaml");
+  if (!existsSync(src)) return;
+  const ctxDir = join(targetDir, ".context");
+  mkdirSync(ctxDir, { recursive: true });
+  const dst = join(ctxDir, "feature-registry.yaml");
+  if (existsSync(dst)) return; // don't overwrite existing
+  safeCopyFile(src, dst);
+  copied.push(".context/feature-registry.yaml");
+}
+
+function removeUnusedEntryPoints(targetDir, runtime, isBrownfield) {
+  if (runtime === "all" || isBrownfield) return [];
+
+  const allEntryPoints = ["CLAUDE.md", ".cursorrules", "AGENT.md"];
+  const keep = RUNTIME_ENTRY_POINTS[runtime];
+  if (!keep) return [];
+
+  const removed = [];
+  for (const ep of allEntryPoints) {
+    if (ep !== keep) {
+      const epPath = join(targetDir, ep);
+      if (existsSync(epPath)) {
+        unlinkSync(epPath);
+        removed.push(ep);
+      }
+    }
+  }
+  return removed;
+}