agent-method 1.5.3 → 1.5.5

package/lib/init.js

@@ -1,296 +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, 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, 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;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-method",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "description": "CLI tools for the wwa methodology — registry-driven routing, validation, and project setup for AI-agent-assisted development",
   "keywords": [
     "ai-agents",
@@ -14,7 +14,8 @@
   "license": "MIT",
   "author": "wwa contributors",
   "bin": {
-    "wwa": "bin/wwa.js"
+    "wwa": "bin/wwa.js",
+    "agent-method": "bin/wwa.js"
   },
   "files": [
     "bin/",

package/templates/README.md

@@ -229,7 +229,7 @@ See `docs/architecture/context-pairing.md` for the full context maintenance life
 ### Recommended: npx
 
 ```bash
-npx wwa init code ~/my-project
+npx agent-method init code ~/my-project
 ```
 
 Replace `code` with: `context`, `data`, `mix`, or `general`.
@@ -249,8 +249,8 @@ See `docs/guides/quick-start.md` for a detailed walkthrough.
 The methodology works without any tooling. For teams that want additional validation and automation:
 
 ```bash
-npx wwa                        # zero-install (Node.js 18+)
-npm install -g wwa             # permanent install
+npx agent-method                        # zero-install (Node.js 18+)
+npm install -g agent-method             # permanent install
 pip install wwa-tools          # Python alternative
 ```
 
@@ -258,13 +258,13 @@ pip install wwa-tools          # Python alternative
 
 | Command | Use case |
 |---------|----------|
-| `npx wwa check` | Validate entry point (auto-finds CLAUDE.md/.cursorrules/AGENT.md) |
-| `npx wwa scan` | Detect project type from directory contents |
-| `npx wwa route "<query>"` | Test how a query routes through the pipeline |
-| `npx wwa refine` | Extract refinement report (auto-finds SESSION-LOG.md) |
-| `npx wwa status` | Check if methodology version is current |
-| `npx wwa upgrade` | Brownfield-safe update (adds missing files, updates version) |
-| `npx wwa init <type>` | Describe entry point contents for a project type |
+| `npx agent-method check` | Validate entry point (auto-finds CLAUDE.md/.cursorrules/AGENT.md) |
+| `npx agent-method scan` | Detect project type from directory contents |
+| `npx agent-method route "<query>"` | Test how a query routes through the pipeline |
+| `npx agent-method refine` | Extract refinement report (auto-finds SESSION-LOG.md) |
+| `npx agent-method status` | Check if methodology version is current |
+| `npx agent-method upgrade` | Brownfield-safe update (adds missing files, updates version) |
+| `npx agent-method init <type>` | Describe entry point contents for a project type |
 
 ### Project types
 
@@ -279,7 +279,7 @@ wwa init mix       # multi-type project
 
 ### Advanced: pipeline subcommands
 
-For debugging routing logic: `npx wwa pipeline classify|select|resolve|cascade|test`.
+For debugging routing logic: `npx agent-method pipeline classify|select|resolve|cascade|test`.
 
 ### Dependencies