agent-method 1.5.1 → 1.5.5

package/lib/cli/upgrade.js

@@ -1,146 +1,149 @@
-/** agent-method upgrade — brownfield-safe methodology update. */
-
-import {
-  readFileSync, existsSync, copyFileSync, mkdirSync, writeFileSync,
-} from "node:fs";
-import { resolve, join, dirname } from "node:path";
-import {
-  findEntryPoint, readMethodVersion, basename_of, pkg, packageRoot,
-} from "./helpers.js";
-
-export function register(program) {
-  program
-    .command("upgrade [directory]")
-    .description("Update your project to the latest methodology version")
-    .option("--dry-run", "Show what would change without modifying files")
-    .action(async (directory, opts) => {
-      directory = directory || ".";
-      const d = resolve(directory);
-      const ep = findEntryPoint(directory);
-      const actions = [];
-
-      const templateDirs = {
-        starter: join(packageRoot, "templates", "starter"),
-        full: join(packageRoot, "templates", "full"),
-      };
-
-      // Determine which template tier this project uses
-      let tier = "starter";
-      if (existsSync(join(d, ".context", "REGISTRY.md"))) {
-        tier = "full";
-      } else if (
-        existsSync(join(d, "REQUIREMENTS.md")) &&
-        existsSync(join(d, "SUMMARY.md"))
-      ) {
-        tier = "full";
-      }
-      const srcDir = templateDirs[tier] || templateDirs.starter;
-
-      if (!existsSync(srcDir)) {
-        console.error(
-          `Template directory not found: ${srcDir}. ` +
-            "Run from the agent-method repo or install from source."
-        );
-        process.exit(1);
-      }
-
-      // 1. Update method_version in entry point
-      if (ep) {
-        let content = readFileSync(ep, "utf-8");
-        const currentVer = readMethodVersion(ep);
-        const newVer = pkg.version.split(".").slice(0, 2).join(".");
-        if (currentVer && currentVer !== newVer) {
-          actions.push(
-            `Update ${basename_of(ep)}: method_version ${currentVer} -> ${newVer}`
-          );
-          if (!opts.dryRun) {
-            content = content.replace(/(method_version:\s*)\S+/, `$1${newVer}`);
-            writeFileSync(ep, content, "utf-8");
-          }
-        } else if (!currentVer) {
-          actions.push(`Add method_version: ${newVer} to ${basename_of(ep)}`);
-          if (!opts.dryRun) {
-            if (content.includes("## Conventions")) {
-              const insert =
-                `## 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`;
-              content = content.replace("## Conventions", insert + "## Conventions");
-              writeFileSync(ep, content, "utf-8");
-            }
-          }
-        }
-      }
-
-      // 2. Add missing methodology files (brownfield-safe: skip existing)
-      const methodologyFiles = ["SESSION-LOG.md", "PROJECT-PROFILE.md"];
-      if (tier === "full") {
-        methodologyFiles.push(join(".context", "METHODOLOGY.md"));
-      }
-
-      for (const fname of methodologyFiles) {
-        const src = join(srcDir, fname);
-        const dst = join(d, fname);
-        if (existsSync(src) && !existsSync(dst)) {
-          actions.push(`Create ${fname} (new)`);
-          if (!opts.dryRun) {
-            mkdirSync(dirname(dst), { recursive: true });
-            copyFileSync(src, dst);
-          }
-        }
-      }
-
-      // 3. Check for session close cascade (add if missing)
-      if (ep) {
-        let content = readFileSync(ep, "utf-8");
-        if (!content.toLowerCase().includes("session close")) {
-          actions.push(`Add session close cascade rule to ${basename_of(ep)}`);
-          if (!opts.dryRun) {
-            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) " +
-                  "|\n\n<!-- INSTRUCTION: Add project-specific cascade"
-              );
-              writeFileSync(ep, content, "utf-8");
-            }
-          }
-        }
-
-        // 4. Check for session observation convention
-        content = readFileSync(ep, "utf-8");
-        if (!content.toLowerCase().includes("session-log")) {
-          actions.push(
-            `Add session observation convention to ${basename_of(ep)}`
-          );
-          if (!opts.dryRun) {
-            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 " +
-                  "previous entries during normal work\n\n" +
-                  "## Do not"
-              );
-              writeFileSync(ep, content, "utf-8");
-            }
-          }
-        }
-      }
-
-      // Report
-      if (actions.length === 0) {
-        console.log(`Project at ${directory} is up to date (v${pkg.version}).`);
-      } else if (opts.dryRun) {
-        console.log(`Dry run \u2014 ${actions.length} changes needed:`);
-        for (const a of actions) console.log(`  - ${a}`);
-      } else {
-        console.log(
-          `Upgraded ${directory} to methodology v${pkg.version} (${actions.length} changes):`
-        );
-        for (const a of actions) console.log(`  - ${a}`);
-      }
-    });
-}
+/** wwa upgrade — brownfield-safe methodology update. */
+
+import {
+  readFileSync, existsSync, copyFileSync, mkdirSync, writeFileSync,
+} from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import {
+  findEntryPoint, readMethodVersion, basename_of, pkg, packageRoot,
+} from "./helpers.js";
+
+export function register(program) {
+  program
+    .command("upgrade [directory]")
+    .description("Update your project to the latest methodology version")
+    .option("--dry-run", "Show what would change without modifying files")
+    .action(async (directory, opts) => {
+      directory = directory || ".";
+      const d = resolve(directory);
+      const ep = findEntryPoint(directory);
+      const actions = [];
+
+      const templateDirs = {
+        starter: join(packageRoot, "templates", "starter"),
+        full: join(packageRoot, "templates", "full"),
+      };
+
+      // Determine which template tier this project uses
+      let tier = "starter";
+      if (existsSync(join(d, ".context", "REGISTRY.md"))) {
+        tier = "full";
+      } else if (
+        existsSync(join(d, "REQUIREMENTS.md")) &&
+        existsSync(join(d, "SUMMARY.md"))
+      ) {
+        tier = "full";
+      }
+      const srcDir = templateDirs[tier] || templateDirs.starter;
+
+      if (!existsSync(srcDir)) {
+        console.error(
+          `Template directory not found: ${srcDir}. ` +
+            "Run from the wwa repo or install from source."
+        );
+        process.exit(1);
+      }
+
+      // 1. Update method_version in entry point
+      if (ep) {
+        let content = readFileSync(ep, "utf-8");
+        const currentVer = readMethodVersion(ep);
+        const newVer = pkg.version.split(".").slice(0, 2).join(".");
+        if (currentVer && currentVer !== newVer) {
+          actions.push(
+            `Update ${basename_of(ep)}: method_version ${currentVer} -> ${newVer}`
+          );
+          if (!opts.dryRun) {
+            content = content.replace(/(method_version:\s*)\S+/, `$1${newVer}`);
+            writeFileSync(ep, content, "utf-8");
+          }
+        } else if (!currentVer) {
+          actions.push(`Add method_version: ${newVer} to ${basename_of(ep)}`);
+          if (!opts.dryRun) {
+            if (content.includes("## Conventions")) {
+              const insert =
+                `## 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`;
+              content = content.replace("## Conventions", insert + "## Conventions");
+              writeFileSync(ep, content, "utf-8");
+            }
+          }
+        }
+      }
+
+      // 2. Add missing methodology files (brownfield-safe: skip existing)
+      const methodologyFiles = ["SESSION-LOG.md", "PROJECT-PROFILE.md"];
+      if (tier === "full") {
+        methodologyFiles.push(join(".context", "METHODOLOGY.md"));
+      }
+
+      for (const fname of methodologyFiles) {
+        const src = join(srcDir, fname);
+        const dst = join(d, fname);
+        if (existsSync(src) && !existsSync(dst)) {
+          actions.push(`Create ${fname} (new)`);
+          if (!opts.dryRun) {
+            mkdirSync(dirname(dst), { recursive: true });
+            copyFileSync(src, dst);
+          }
+        }
+      }
+
+      // 3. Check for session close cascade (add if missing)
+      if (ep) {
+        let content = readFileSync(ep, "utf-8");
+        if (!content.toLowerCase().includes("session close")) {
+          actions.push(`Add session close cascade rule to ${basename_of(ep)}`);
+          if (!opts.dryRun) {
+            if (content.includes("<!-- INSTRUCTION: Add project-specific cascade")) {
+              content = content.replace(
+                "<!-- INSTRUCTION: Add project-specific cascade",
+                "| Session close or high-effort task completion | SESSION-LOG.md (append metrics entry" +
+                  " \u2014 effort, ambiguity, context level, tokens, time, user response, refinement delta, workflow, features, cascades, friction, findings) " +
+                  "|\n\n<!-- INSTRUCTION: Add project-specific cascade"
+              );
+              writeFileSync(ep, content, "utf-8");
+            }
+          }
+        }
+
+        // 4. Check for session observation convention
+        content = readFileSync(ep, "utf-8");
+        if (!content.toLowerCase().includes("session-log")) {
+          actions.push(
+            `Add session observation convention to ${basename_of(ep)}`
+          );
+          if (!opts.dryRun) {
+            if (content.includes("## Do not")) {
+              content = content.replace(
+                "## Do not",
+                "- 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, time, user response (accepted/edited/revised/rejected/redirected), " +
+                  "and for medium/high effort tasks: revision count, refinement magnitude " +
+                  "(none/minor/moderate/major/rework), delta categories, and survival rate. Never skip, never read " +
+                  "previous entries during normal work\n\n" +
+                  "## Do not"
+              );
+              writeFileSync(ep, content, "utf-8");
+            }
+          }
+        }
+      }
+
+      // Report
+      if (actions.length === 0) {
+        console.log(`Project at ${directory} is up to date (v${pkg.version}).`);
+      } else if (opts.dryRun) {
+        console.log(`Dry run \u2014 ${actions.length} changes needed:`);
+        for (const a of actions) console.log(`  - ${a}`);
+      } else {
+        console.log(
+          `Upgraded ${directory} to methodology v${pkg.version} (${actions.length} changes):`
+        );
+        for (const a of actions) console.log(`  - ${a}`);
+      }
+    });
+}

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);
+      }
+    });
+}