agent-method 1.5.1 → 1.5.5

package/lib/init.js

@@ -1,240 +1,296 @@
-/**
- * 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 } 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",
-};
-
-/**
- * Set up a new project with methodology templates.
- */
-export async function initProject(projectType, directory, opts = {}) {
-  const { tier = "starter", 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(`  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);
-
-  // Report
-  console.log(`  Files created: ${copied.length}`);
-  for (const f of copied) console.log(`    + ${f}`);
-  if (skipped.length > 0) {
-    console.log(`  Files skipped (already exist): ${skipped.length}`);
-    for (const f of skipped) console.log(`    ~ ${f}`);
-  }
-
-  console.log(`\nNext steps:`);
-  console.log(`  1. cd ${relative(process.cwd(), targetDir) || "."}`);
-  console.log(`  2. Fill in PROJECT.md with your project vision`);
-  console.log(`  3. Delete the two entry point files you don't use`);
-  console.log(`     (keep CLAUDE.md, .cursorrules, or AGENT.md)`);
-  console.log(`  4. Start a conversation — the agent reads the entry point`);
-  console.log(`\nRun \`npx agent-method check\` to validate your setup.`);
-}
-
-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");
-  }
-}
+/**
+ * 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 agent-method 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;
+}