agent-method 1.5.1 → 1.5.5

package/lib/cli/refine.js

@@ -1,202 +1,202 @@
-/** agent-method refine — extract refinement report from session history. */
-
-import { readFileSync, existsSync, writeFileSync } from "node:fs";
-import { findSessionLog } from "./helpers.js";
-
-export function register(program) {
-  program
-    .command("refine [session-log]")
-    .description("Extract a refinement report from session history")
-    .option("-o, --output <path>", "Output file (default: stdout)")
-    .option("--json", "Output as JSON")
-    .action(async (sessionLog, opts) => {
-      if (!sessionLog) {
-        sessionLog = findSessionLog(".");
-        if (!sessionLog) {
-          console.error(
-            "No SESSION-LOG.md found in current directory.\n" +
-              "Specify a path: npx agent-method refine path/to/SESSION-LOG.md"
-          );
-          process.exit(1);
-        }
-      }
-
-      if (!existsSync(sessionLog)) {
-        console.error(`File not found: ${sessionLog}`);
-        process.exit(1);
-      }
-
-      const content = readFileSync(sessionLog, "utf-8");
-      const parsed = parseSessionLog(content);
-
-      let result;
-      if (opts.json) {
-        result = JSON.stringify(parsed, null, 2);
-      } else {
-        result = generateRefinementReport(parsed);
-      }
-
-      if (opts.output) {
-        writeFileSync(opts.output, result, "utf-8");
-        console.log(
-          `Refinement report written to ${opts.output} (${parsed.entries.length} sessions)`
-        );
-      } else {
-        console.log(result);
-      }
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Session log parsing
-// ---------------------------------------------------------------------------
-
-function parseSessionLog(content) {
-  const context = {};
-  const ctxMatch = content.match(
-    /## Project context\s*\n\s*\|[^\n]+\n\s*\|[-| ]+\n((?:\|[^\n]+\n)*)/
-  );
-  if (ctxMatch) {
-    for (const row of ctxMatch[1].trim().split("\n")) {
-      const cols = row
-        .split("|")
-        .map((c) => c.trim())
-        .filter((c) => c);
-      if (cols.length >= 2) {
-        context[cols[0].toLowerCase()] = cols[1];
-      }
-    }
-  }
-
-  const entries = [];
-  const entryPattern =
-    /###\s+S(\d+)\s*(?:\u2014|--)\s*(\S+)\s*(?:\u2014|--)\s*(.+?)$(.*?)(?=###\s+S\d+|$)/gms;
-  let m;
-  while ((m = entryPattern.exec(content)) !== null) {
-    const [, num, date, title, body] = m;
-    const entry = { session: parseInt(num, 10), date, title: title.trim() };
-
-    for (const line of body.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const segments = trimmed.split("|").map((s) => s.trim());
-      for (const seg of segments) {
-        if (seg.includes(":")) {
-          const idx = seg.indexOf(":");
-          const key = seg.slice(0, idx).trim().toLowerCase();
-          const val = seg.slice(idx + 1).trim();
-          if (
-            [
-              "model", "profile", "workflow", "queries",
-              "features", "cascades", "decisions", "friction", "finding",
-            ].includes(key)
-          ) {
-            entry[key] = val;
-          }
-        }
-      }
-    }
-    entries.push(entry);
-  }
-
-  return { context, entries };
-}
-
-function generateRefinementReport(parsed) {
-  const ctx = parsed.context;
-  const entries = parsed.entries;
-
-  const project = ctx["project name"] || "Unknown";
-  const ptype = ctx["project type"] || "unknown";
-  const profile = ctx["integration profile"] || "unknown";
-  const extensions = ctx["extension(s)"] || "none";
-
-  const workflows = new Set();
-  let totalFriction = 0;
-  let totalFindings = 0;
-  const findingsList = [];
-  const frictionList = [];
-
-  for (const e of entries) {
-    if (e.workflow) workflows.add(e.workflow);
-    const friction = e.friction || "none";
-    if (friction.toLowerCase() !== "none" && friction) {
-      totalFriction++;
-      frictionList.push(`S${e.session} (${e.date}): ${friction}`);
-    }
-    const finding = e.finding || "none";
-    if (finding.toLowerCase() !== "none" && finding) {
-      totalFindings++;
-      findingsList.push(`S${e.session} (${e.date}): ${finding}`);
-    }
-  }
-
-  const wfSorted = [...workflows].sort().join(", ") || "none";
-  const lines = [
-    `# Refinement Report: ${project}`,
-    "",
-    "Auto-generated from SESSION-LOG.md by `agent-method refine`.",
-    "",
-    "## Source",
-    "",
-    "| Field | Value |",
-    "|-------|-------|",
-    `| Project type | ${ptype} |`,
-    `| Extension(s) | ${extensions} |`,
-    `| Workflow(s) exercised | ${wfSorted} |`,
-    `| Integration profile | ${profile} |`,
-    `| Sessions | ${entries.length} |`,
-    "",
-    "## Session summary",
-    "",
-    "| # | Date | Title | Workflow | Friction | Finding |",
-    "|---|------|-------|----------|----------|---------|",
-  ];
-
-  for (const e of entries) {
-    const friction = e.friction || "none";
-    const finding = e.finding || "none";
-    const wf = e.workflow || "\u2014";
-    lines.push(
-      `| S${e.session} | ${e.date} | ${e.title} | ${wf} | ${friction} | ${finding} |`
-    );
-  }
-
-  lines.push(
-    "", "## Statistics", "",
-    `- **Total sessions**: ${entries.length}`,
-    `- **Workflows used**: ${wfSorted}`,
-    `- **Sessions with friction**: ${totalFriction}`,
-    `- **Sessions with findings**: ${totalFindings}`,
-    ""
-  );
-
-  if (frictionList.length > 0) {
-    lines.push("## Friction points", "");
-    for (const f of frictionList) lines.push(`- ${f}`);
-    lines.push("");
-  }
-
-  if (findingsList.length > 0) {
-    lines.push("## Findings", "");
-    for (const f of findingsList) lines.push(`- ${f}`);
-    lines.push("");
-  }
-
-  lines.push(
-    "## Dimension scores", "",
-    "Fill in after reviewing the session data above:", "",
-    "| Dimension | Score | One-line summary |",
-    "|-----------|:-----:|-----------------|",
-    "| Context quality | \u2014 | |",
-    "| Decision preservation | \u2014 | |",
-    "| Scope discipline | \u2014 | |",
-    "| Cascade coverage | \u2014 | |",
-    "| Audit completeness | \u2014 | |",
-    "| Bootstrap speed | \u2014 | |",
-    "| Lifecycle fit | \u2014 | |",
-    "| Model adequacy | \u2014 | |"
-  );
-
-  return lines.join("\n") + "\n";
-}
+/** wwa refine — extract refinement report from session history. */
+
+import { readFileSync, existsSync, writeFileSync } from "node:fs";
+import { findSessionLog } from "./helpers.js";
+
+export function register(program) {
+  program
+    .command("refine [session-log]")
+    .description("Extract a refinement report from session history")
+    .option("-o, --output <path>", "Output file (default: stdout)")
+    .option("--json", "Output as JSON")
+    .action(async (sessionLog, opts) => {
+      if (!sessionLog) {
+        sessionLog = findSessionLog(".");
+        if (!sessionLog) {
+          console.error(
+            "No SESSION-LOG.md found in current directory.\n" +
+              "Specify a path: npx agent-method refine path/to/SESSION-LOG.md"
+          );
+          process.exit(1);
+        }
+      }
+
+      if (!existsSync(sessionLog)) {
+        console.error(`File not found: ${sessionLog}`);
+        process.exit(1);
+      }
+
+      const content = readFileSync(sessionLog, "utf-8");
+      const parsed = parseSessionLog(content);
+
+      let result;
+      if (opts.json) {
+        result = JSON.stringify(parsed, null, 2);
+      } else {
+        result = generateRefinementReport(parsed);
+      }
+
+      if (opts.output) {
+        writeFileSync(opts.output, result, "utf-8");
+        console.log(
+          `Refinement report written to ${opts.output} (${parsed.entries.length} sessions)`
+        );
+      } else {
+        console.log(result);
+      }
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Session log parsing
+// ---------------------------------------------------------------------------
+
+function parseSessionLog(content) {
+  const context = {};
+  const ctxMatch = content.match(
+    /## Project context\s*\n\s*\|[^\n]+\n\s*\|[-| ]+\n((?:\|[^\n]+\n)*)/
+  );
+  if (ctxMatch) {
+    for (const row of ctxMatch[1].trim().split("\n")) {
+      const cols = row
+        .split("|")
+        .map((c) => c.trim())
+        .filter((c) => c);
+      if (cols.length >= 2) {
+        context[cols[0].toLowerCase()] = cols[1];
+      }
+    }
+  }
+
+  const entries = [];
+  const entryPattern =
+    /###\s+S(\d+)\s*(?:\u2014|--)\s*(\S+)\s*(?:\u2014|--)\s*(.+?)$(.*?)(?=###\s+S\d+|$)/gms;
+  let m;
+  while ((m = entryPattern.exec(content)) !== null) {
+    const [, num, date, title, body] = m;
+    const entry = { session: parseInt(num, 10), date, title: title.trim() };
+
+    for (const line of body.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const segments = trimmed.split("|").map((s) => s.trim());
+      for (const seg of segments) {
+        if (seg.includes(":")) {
+          const idx = seg.indexOf(":");
+          const key = seg.slice(0, idx).trim().toLowerCase();
+          const val = seg.slice(idx + 1).trim();
+          if (
+            [
+              "model", "profile", "workflow", "queries",
+              "features", "cascades", "decisions", "friction", "finding",
+            ].includes(key)
+          ) {
+            entry[key] = val;
+          }
+        }
+      }
+    }
+    entries.push(entry);
+  }
+
+  return { context, entries };
+}
+
+function generateRefinementReport(parsed) {
+  const ctx = parsed.context;
+  const entries = parsed.entries;
+
+  const project = ctx["project name"] || "Unknown";
+  const ptype = ctx["project type"] || "unknown";
+  const profile = ctx["integration profile"] || "unknown";
+  const extensions = ctx["extension(s)"] || "none";
+
+  const workflows = new Set();
+  let totalFriction = 0;
+  let totalFindings = 0;
+  const findingsList = [];
+  const frictionList = [];
+
+  for (const e of entries) {
+    if (e.workflow) workflows.add(e.workflow);
+    const friction = e.friction || "none";
+    if (friction.toLowerCase() !== "none" && friction) {
+      totalFriction++;
+      frictionList.push(`S${e.session} (${e.date}): ${friction}`);
+    }
+    const finding = e.finding || "none";
+    if (finding.toLowerCase() !== "none" && finding) {
+      totalFindings++;
+      findingsList.push(`S${e.session} (${e.date}): ${finding}`);
+    }
+  }
+
+  const wfSorted = [...workflows].sort().join(", ") || "none";
+  const lines = [
+    `# Refinement Report: ${project}`,
+    "",
+    "Auto-generated from SESSION-LOG.md by `wwa refine`.",
+    "",
+    "## Source",
+    "",
+    "| Field | Value |",
+    "|-------|-------|",
+    `| Project type | ${ptype} |`,
+    `| Extension(s) | ${extensions} |`,
+    `| Workflow(s) exercised | ${wfSorted} |`,
+    `| Integration profile | ${profile} |`,
+    `| Sessions | ${entries.length} |`,
+    "",
+    "## Session summary",
+    "",
+    "| # | Date | Title | Workflow | Friction | Finding |",
+    "|---|------|-------|----------|----------|---------|",
+  ];
+
+  for (const e of entries) {
+    const friction = e.friction || "none";
+    const finding = e.finding || "none";
+    const wf = e.workflow || "\u2014";
+    lines.push(
+      `| S${e.session} | ${e.date} | ${e.title} | ${wf} | ${friction} | ${finding} |`
+    );
+  }
+
+  lines.push(
+    "", "## Statistics", "",
+    `- **Total sessions**: ${entries.length}`,
+    `- **Workflows used**: ${wfSorted}`,
+    `- **Sessions with friction**: ${totalFriction}`,
+    `- **Sessions with findings**: ${totalFindings}`,
+    ""
+  );
+
+  if (frictionList.length > 0) {
+    lines.push("## Friction points", "");
+    for (const f of frictionList) lines.push(`- ${f}`);
+    lines.push("");
+  }
+
+  if (findingsList.length > 0) {
+    lines.push("## Findings", "");
+    for (const f of findingsList) lines.push(`- ${f}`);
+    lines.push("");
+  }
+
+  lines.push(
+    "## Dimension scores", "",
+    "Fill in after reviewing the session data above:", "",
+    "| Dimension | Score | One-line summary |",
+    "|-----------|:-----:|-----------------|",
+    "| Context quality | \u2014 | |",
+    "| Decision preservation | \u2014 | |",
+    "| Scope discipline | \u2014 | |",
+    "| Cascade coverage | \u2014 | |",
+    "| Audit completeness | \u2014 | |",
+    "| Bootstrap speed | \u2014 | |",
+    "| Lifecycle fit | \u2014 | |",
+    "| Model adequacy | \u2014 | |"
+  );
+
+  return lines.join("\n") + "\n";
+}

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,28 +1,28 @@
-/** agent-method scan — detect project type from directory contents. */
-
-import { getPipeline, outputData } from "./helpers.js";
-
-export function register(program) {
-  program
-    .command("scan [directory]")
-    .description("Detect project type from directory contents")
-    .option("--registry <path>", "Path to feature-registry.yaml")
-    .option("--json", "Output as JSON")
-    .action(async (directory, opts) => {
-      directory = directory || ".";
-      const { detectProjectType } = await getPipeline();
-      const result = detectProjectType(directory);
-
-      const ptype = result.project_type || "general";
-      const friendlyMap = { analytical: "context", mixed: "mix" };
-      if (ptype in friendlyMap) {
-        result.friendly_name = friendlyMap[ptype];
-        result.init_command = `npx agent-method init ${friendlyMap[ptype]}`;
-      } else {
-        result.init_command = `npx agent-method init ${ptype}`;
-      }
-
-      console.log(`Scanning: ${directory}`);
-      outputData(result, opts.json);
-    });
-}
+/** wwa scan — detect project type from directory contents. */
+
+import { getPipeline, outputData } from "./helpers.js";
+
+export function register(program) {
+  program
+    .command("scan [directory]")
+    .description("Detect project type from directory contents")
+    .option("--registry <path>", "Path to feature-registry.yaml")
+    .option("--json", "Output as JSON")
+    .action(async (directory, opts) => {
+      directory = directory || ".";
+      const { detectProjectType } = await getPipeline();
+      const result = detectProjectType(directory);
+
+      const ptype = result.project_type || "general";
+      const friendlyMap = { analytical: "context", mixed: "mix" };
+      if (ptype in friendlyMap) {
+        result.friendly_name = friendlyMap[ptype];
+        result.init_command = `npx agent-method init ${friendlyMap[ptype]}`;
+      } else {
+        result.init_command = `npx agent-method init ${ptype}`;
+      }
+
+      console.log(`Scanning: ${directory}`);
+      outputData(result, opts.json);
+    });
+}

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,61 +1,61 @@
-/** agent-method status — check if methodology version is current. */
-
-import { findEntryPoint, readMethodVersion, basename_of, pkg } from "./helpers.js";
-
-export function register(program) {
-  program
-    .command("status [directory]")
-    .description("Check if your methodology version is current")
-    .option("--json", "Output as JSON")
-    .action(async (directory, opts) => {
-      directory = directory || ".";
-      const ep = findEntryPoint(directory);
-      if (!ep) {
-        console.error(
-          `No entry point found in ${directory} ` +
-            "(looked for CLAUDE.md, .cursorrules, AGENT.md)"
-        );
-        process.exit(1);
-      }
-
-      const epVersion = readMethodVersion(ep);
-      const installed = pkg.version;
-
-      let verStatus, message;
-      if (!epVersion) {
-        verStatus = "no_version";
-        message =
-          `Entry point ${basename_of(ep)} has no method_version setting. ` +
-          `Add 'method_version: ${installed.split(".").slice(0, 2).join(".")}' ` +
-          `to enable version tracking.`;
-      } else if (epVersion === installed.split(".").slice(0, 2).join(".")) {
-        verStatus = "current";
-        message =
-          `Entry point ${basename_of(ep)} is current ` +
-          `(method_version: ${epVersion}, installed: ${installed})`;
-      } else {
-        verStatus = "outdated";
-        message =
-          `Entry point ${basename_of(ep)} is outdated ` +
-          `(method_version: ${epVersion}, installed: ${installed}). ` +
-          `Run \`npx agent-method upgrade ${directory}\` to update.`;
-      }
-
-      if (opts.json) {
-        console.log(
-          JSON.stringify(
-            {
-              entry_point: ep,
-              entry_point_version: epVersion,
-              installed_version: installed,
-              status: verStatus,
-            },
-            null,
-            2
-          )
-        );
-      } else {
-        console.log(message);
-      }
-    });
-}
+/** wwa status — check if methodology version is current. */
+
+import { findEntryPoint, readMethodVersion, basename_of, pkg } from "./helpers.js";
+
+export function register(program) {
+  program
+    .command("status [directory]")
+    .description("Check if your methodology version is current")
+    .option("--json", "Output as JSON")
+    .action(async (directory, opts) => {
+      directory = directory || ".";
+      const ep = findEntryPoint(directory);
+      if (!ep) {
+        console.error(
+          `No entry point found in ${directory} ` +
+            "(looked for CLAUDE.md, .cursorrules, AGENT.md)"
+        );
+        process.exit(1);
+      }
+
+      const epVersion = readMethodVersion(ep);
+      const installed = pkg.version;
+
+      let verStatus, message;
+      if (!epVersion) {
+        verStatus = "no_version";
+        message =
+          `Entry point ${basename_of(ep)} has no method_version setting. ` +
+          `Add 'method_version: ${installed.split(".").slice(0, 2).join(".")}' ` +
+          `to enable version tracking.`;
+      } else if (epVersion === installed.split(".").slice(0, 2).join(".")) {
+        verStatus = "current";
+        message =
+          `Entry point ${basename_of(ep)} is current ` +
+          `(method_version: ${epVersion}, installed: ${installed})`;
+      } else {
+        verStatus = "outdated";
+        message =
+          `Entry point ${basename_of(ep)} is outdated ` +
+          `(method_version: ${epVersion}, installed: ${installed}). ` +
+          `Run \`npx agent-method upgrade ${directory}\` to update.`;
+      }
+
+      if (opts.json) {
+        console.log(
+          JSON.stringify(
+            {
+              entry_point: ep,
+              entry_point_version: epVersion,
+              installed_version: installed,
+              status: verStatus,
+            },
+            null,
+            2
+          )
+        );
+      } else {
+        console.log(message);
+      }
+    });
+}