agent-method 1.5.1 → 1.5.3

package/lib/cli/route.js

@@ -1,4 +1,4 @@
-/** agent-method route — show how a query routes through the pipeline. */
+/** wwa route — show how a query routes through the pipeline. */
 
 import {
   resolveProjectType,

package/lib/cli/scan.js

@@ -1,4 +1,4 @@
-/** agent-method scan — detect project type from directory contents. */
+/** wwa scan — detect project type from directory contents. */
 
 import { getPipeline, outputData } from "./helpers.js";
 
@@ -17,9 +17,9 @@ export function register(program) {
       const friendlyMap = { analytical: "context", mixed: "mix" };
       if (ptype in friendlyMap) {
         result.friendly_name = friendlyMap[ptype];
-        result.init_command = `npx agent-method init ${friendlyMap[ptype]}`;
+        result.init_command = `npx wwa init ${friendlyMap[ptype]}`;
       } else {
-        result.init_command = `npx agent-method init ${ptype}`;
+        result.init_command = `npx wwa init ${ptype}`;
       }
 
       console.log(`Scanning: ${directory}`);

package/lib/cli/serve.js

@@ -0,0 +1,23 @@
+/** wwa serve — start MCP server on stdio transport. */
+
+export function register(program) {
+  program
+    .command("serve")
+    .description("Start MCP server exposing methodology tools via stdio transport")
+    .option("--registry <path>", "Path to feature-registry.yaml")
+    .action(async (opts) => {
+      // Redirect all non-MCP output to stderr so stdout stays clean for JSON-RPC
+      const info = (msg) => process.stderr.write(msg + "\n");
+
+      info("wwa MCP server starting...");
+
+      try {
+        const { startServer } = await import("../mcp-server.js");
+        await startServer(opts.registry || undefined);
+        info("wwa MCP server running on stdio. Press Ctrl+C to stop.");
+      } catch (err) {
+        info(`Error: ${err.message}`);
+        process.exit(1);
+      }
+    });
+}

package/lib/cli/status.js

@@ -1,4 +1,4 @@
-/** agent-method status — check if methodology version is current. */
+/** wwa status — check if methodology version is current. */
 
 import { findEntryPoint, readMethodVersion, basename_of, pkg } from "./helpers.js";
 
@@ -38,7 +38,7 @@ export function register(program) {
         message =
           `Entry point ${basename_of(ep)} is outdated ` +
           `(method_version: ${epVersion}, installed: ${installed}). ` +
-          `Run \`npx agent-method upgrade ${directory}\` to update.`;
+          `Run \`npx wwa upgrade ${directory}\` to update.`;
       }
 
       if (opts.json) {

package/lib/cli/upgrade.js

@@ -1,4 +1,4 @@
-/** agent-method upgrade — brownfield-safe methodology update. */
+/** wwa upgrade — brownfield-safe methodology update. */
 
 import {
   readFileSync, existsSync, copyFileSync, mkdirSync, writeFileSync,
@@ -39,7 +39,7 @@ export function register(program) {
       if (!existsSync(srcDir)) {
         console.error(
           `Template directory not found: ${srcDir}. ` +
-            "Run from the agent-method repo or install from source."
+            "Run from the wwa repo or install from source."
         );
         process.exit(1);
       }
@@ -65,7 +65,7 @@ export function register(program) {
                 `## Method version\n\n` +
                 `method_version: ${newVer}\n` +
                 `<!-- Tracks which methodology version generated this entry point -->\n` +
-                `<!-- Use \`npx agent-method status\` to compare against latest -->\n\n`;
+                `<!-- Use \`npx wwa status\` to compare against latest -->\n\n`;
               content = content.replace("## Conventions", insert + "## Conventions");
               writeFileSync(ep, content, "utf-8");
             }
@@ -100,8 +100,8 @@ export function register(program) {
             if (content.includes("<!-- INSTRUCTION: Add project-specific cascade")) {
               content = content.replace(
                 "<!-- INSTRUCTION: Add project-specific cascade",
-                "| Session close | SESSION-LOG.md (append micro-entry" +
-                  " \u2014 workflow, features, cascades, friction, findings) " +
+                "| Session close or high-effort task completion | SESSION-LOG.md (append metrics entry" +
+                  " \u2014 effort, ambiguity, context level, tokens, time, workflow, features, cascades, friction, findings) " +
                   "|\n\n<!-- INSTRUCTION: Add project-specific cascade"
               );
               writeFileSync(ep, content, "utf-8");
@@ -119,8 +119,9 @@ export function register(program) {
             if (content.includes("## Do not")) {
               content = content.replace(
                 "## Do not",
-                "- At session close, append a micro-entry to " +
-                  "SESSION-LOG.md \u2014 never skip, never read " +
+                "- At session close or after any high-effort task, append a metrics entry to " +
+                  "SESSION-LOG.md \u2014 include effort level, question ambiguity, context level, " +
+                  "estimated tokens, and time. Never skip, never read " +
                   "previous entries during normal work\n\n" +
                   "## Do not"
               );

package/lib/cli/watch.js

@@ -0,0 +1,32 @@
+/** wwa watch — file watcher for proactive validation. */
+
+export function register(program) {
+  program
+    .command("watch [directory]")
+    .description("Watch entry points and markdown files for changes, validate on save")
+    .option("--registry <path>", "Path to feature-registry.yaml")
+    .action(async (directory, opts) => {
+      const dir = directory || ".";
+
+      console.log(`Watching: ${dir}`);
+      console.log("Monitoring entry points, registry, and markdown files...");
+      console.log("Press Ctrl+C to stop.\n");
+
+      try {
+        const { createWatcher } = await import("../watcher.js");
+        const watcher = createWatcher(dir, {
+          registryPath: opts.registry || undefined,
+        });
+
+        // Keep process alive
+        process.on("SIGINT", () => {
+          watcher.close();
+          console.log("\nWatcher stopped.");
+          process.exit(0);
+        });
+      } catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+      }
+    });
+}

package/lib/init.js

@@ -5,7 +5,7 @@
  * prompts for project configuration.
  */
 
-import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
+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";
 
@@ -26,11 +26,17 @@ const FRIENDLY_NAMES = {
   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", registryPath } = opts;
+  const { tier = "starter", runtime = "all", profile = "standard", registryPath } = opts;
   const targetDir = resolve(directory);
   const methodRoot = resolve(__dirname, "..");
 
@@ -42,6 +48,8 @@ export async function initProject(projectType, directory, opts = {}) {
 
   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)
@@ -72,21 +80,38 @@ export async function initProject(projectType, directory, opts = {}) {
   // 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`);
-  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.`);
+  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) {
@@ -238,3 +263,34 @@ function replacePlaceholders(targetDir, projectType, 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;
+}