scrumrun 2.6.3 → 2.6.5

package/README.md

@@ -4,7 +4,7 @@
 
 ScrumRun gives an agent a small command surface and a precise project memory: what should be done, how each attempt happened, which decisions constrain the code, and why the architecture exists in its current form.
 
-**Package:** `2.6.3` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
+**Package:** `2.6.5` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
 
 **New here?** Read the [Quickstart](docs/QUICKSTART.md) — first Run in under 10 minutes, no `SPEC.md` reading required. Full docs map in [`docs/INDEX.md`](docs/INDEX.md).
 

package/bin/scrumrun.js

@@ -44,6 +44,12 @@ const COMMANDS = ["sc"];
 const COMPATIBILITY_COMMANDS = Object.keys(COMMAND_ALIASES);
 const MANAGED_COMMANDS = [...new Set(["sc", "sc-plan", "sc-knowledge", "sc-rules", ...COMPATIBILITY_COMMANDS])];
 
+let installVerbose = false;
+const installSummary = { cleaned: 0, written: 0, skipped: 0, targets: [] };
+function installLog(msg) {
+  if (installVerbose) console.log(msg);
+}
+
 function usage() {
   console.log(`ScrumRun
 
@@ -52,7 +58,7 @@ Usage:
   scrumrun sc
   scrumrun sc <noun> <subject> <action> [args]
   scrumrun install [all|codex|opencode|claude] [--force]
-  scrumrun update  [all|codex|opencode|claude] [--no-migrate]
+  scrumrun update  [all|codex|opencode|claude] [--no-migrate] [--verbose]
   scrumrun init [--local|--shared] [--lean] [--no-agent-hint] [--force]
   scrumrun status
   scrumrun core [--path|--prompt]
@@ -184,8 +190,13 @@ function copyDir(srcDir, destDir, options = {}) {
   return results;
 }
 
-function printResults(title, results) {
+function printResults(title, results, { quietable = false } = {}) {
+  for (const result of results) {
+    if (result.status === "written") installSummary.written += 1;
+    else if (result.status === "skipped") installSummary.skipped += 1;
+  }
   console.log(`\n${title}`);
+  if (quietable && !installVerbose) return;
   for (const result of results) {
     const prefix = result.status === "skipped" ? "skip" : result.status;
     console.log(`  ${prefix} ${result.dest}`);
@@ -202,14 +213,16 @@ function cleanupLegacy(commandsDir, skillsDir) {
       const managed = MANAGED_COMMANDS.some((command) => name === `${command}.md`);
       if (legacyPrefix || oldConsolidated || managed) {
         fs.rmSync(path.join(commandsDir, name), { force: true });
-        console.log(`  rm legacy ${path.join(commandsDir, name)}`);
+        installSummary.cleaned += 1;
+        installLog(`  rm legacy ${path.join(commandsDir, name)}`);
       }
     }
   }
   const oldSkill = path.join(skillsDir, "ai-scrum");
   if (fs.existsSync(oldSkill)) {
     fs.rmSync(oldSkill, { recursive: true, force: true });
-    console.log(`  rm legacy ${oldSkill}`);
+    installSummary.cleaned += 1;
+    installLog(`  rm legacy ${oldSkill}`);
   }
 }
 
@@ -231,8 +244,9 @@ function installClient(label, commandsDir, skillsDir, skillTemplateDir, force, {
       results.push(writeCommandAsset(path.join(commandsDir, `${alias}.md`), renderCompatibilityPrompt(alias), force));
     }
   }
-  printResults(`Installed ${label}`, results);
-  console.log(compatibility
+  installSummary.targets.push(label);
+  printResults(`Installed ${label}`, results, { quietable: true });
+  installLog(compatibility
     ? "  compatibility adapters installed for this v1 upgrade cycle"
     : "  canonical surface: /sc only");
 }
@@ -345,7 +359,12 @@ function migrationPreflightOnUpdate({ apply = false } = {}) {
   }
 }
 
-function updateInstallation(target, { migrate = false } = {}) {
+function updateInstallation(target, { migrate = false, verbose = false } = {}) {
+  installVerbose = verbose;
+  installSummary.cleaned = 0;
+  installSummary.written = 0;
+  installSummary.skipped = 0;
+  installSummary.targets.length = 0;
   const migration = migrationPreflightOnUpdate({ apply: migrate });
   install(target, true, { compatibility: true });
   if (migrate && v2Project()) {
@@ -356,6 +375,10 @@ function updateInstallation(target, { migrate = false } = {}) {
       // Conformance reports stale or unsafe state separately.
     }
   }
+  if (!verbose) {
+    const targetSummary = installSummary.targets.join(", ") || "no clients";
+    console.log(`Updated ${targetSummary} — ${installSummary.written} files written, ${installSummary.cleaned} legacy removed. Run with --verbose to see file paths.`);
+  }
   return migration;
 }
 
@@ -1575,7 +1598,7 @@ function executeRootRoute(route) {
   }
   if (noun === "config" && subject === "update") {
     const target = ["all", "codex", "opencode", "claude"].includes(routeArgs[0]) ? routeArgs[0] : "all";
-    return updateInstallation(target, { migrate: !routeArgs.includes("--no-migrate") });
+    return updateInstallation(target, { migrate: !routeArgs.includes("--no-migrate"), verbose: routeArgs.includes("--verbose") });
   }
   if (noun === "config" && subject === "init") {
     const localMode = routeArgs.includes("--local");
@@ -2500,7 +2523,7 @@ if (!command || command === "--help" || command === "-h") {
   console.log(`ScrumRun ${version}`);
 } else if (command === "install" || command === "update") {
   const target = ["all", "codex", "opencode", "claude"].includes(args[1]) ? args[1] : "all";
-  if (command === "update") updateInstallation(target, { migrate: !args.includes("--no-migrate") });
+  if (command === "update") updateInstallation(target, { migrate: !args.includes("--no-migrate"), verbose: args.includes("--verbose") });
   else install(target, true, { compatibility: false });
 } else if (command === "sc") {
   runRoot(args.slice(1));

package/lib/commands/repair.js

@@ -29,16 +29,24 @@ const path = require("node:path");
 const TASK_FILE = /^TASK-\d{3,}\.md$/;
 const RUN_FILE = /^RUN-\d{3,}\.md$/;
 const FEAT_FILE = /^FEAT-\d{3,}\.md$/;
+const SPRINT_FILE = /^SPRINT-\d{3,}\.md$/;
+const MEMORY_FILE = /^(K|DEC|INS|DOS)-\d{3,}\.md$/;
 const FEAT_REF = /^FEAT-\d{3,}$/;
 const SLUG_REF = /^[a-z0-9][a-z0-9-]*$/;
 
-const STATUS_ALIAS = {
+const TASK_STATUS_ALIAS = {
   done: "completed",
   todo: "backlog",
   complete: "completed",
   in_progress: "executing"
 };
 
+const RUN_STATUS_ALIAS = {
+  complete: "completed",
+  in_progress: "executing",
+  done: "completed"
+};
+
 function readIf(file) {
   try {
     return fs.readFileSync(file, "utf8");
@@ -98,7 +106,15 @@ function planFile(file, kind, ctx) {
   const changes = [];
 
   const method = extractField(header, "method");
-  if (method !== undefined && method !== "2.0.0" && method !== "null") {
+  if (method === undefined) {
+    if (hasField(header, "id")) {
+      const next = insertFieldAfter(header, "id", "method", "2.0.0");
+      if (next !== header) {
+        changes.push({ field: "method", from: "(missing)", to: "2.0.0" });
+        header = next;
+      }
+    }
+  } else if (method !== "2.0.0" && method !== "null") {
     const next = replaceField(header, "method", "2.0.0");
     if (next !== header) {
       changes.push({ field: "method", from: method, to: "2.0.0" });
@@ -119,16 +135,24 @@ function planFile(file, kind, ctx) {
     }
 
     const status = extractField(header, "status");
-    if (status && STATUS_ALIAS[status]) {
-      const next = replaceField(header, "status", STATUS_ALIAS[status]);
+    if (status && TASK_STATUS_ALIAS[status]) {
+      const next = replaceField(header, "status", TASK_STATUS_ALIAS[status]);
       if (next !== header) {
-        changes.push({ field: "status", from: status, to: STATUS_ALIAS[status] });
+        changes.push({ field: "status", from: status, to: TASK_STATUS_ALIAS[status] });
         header = next;
       }
     }
   }
 
   if (kind === "run") {
+    const status = extractField(header, "status");
+    if (status && RUN_STATUS_ALIAS[status]) {
+      const next = replaceField(header, "status", RUN_STATUS_ALIAS[status]);
+      if (next !== header) {
+        changes.push({ field: "status", from: status, to: RUN_STATUS_ALIAS[status] });
+        header = next;
+      }
+    }
     if (!hasField(header, "attempt") && hasField(header, "task")) {
       const next = insertFieldAfter(header, "task", "attempt", "1");
       if (next !== header) {
@@ -161,6 +185,16 @@ function analyze(scrumDir) {
     const plan = planFile(file, "feature", ctx);
     if (plan && plan.changes.length) entries.push(plan);
   }
+  for (const file of listDir(path.join(scrumDir, "sprints"), SPRINT_FILE)) {
+    const plan = planFile(file, "sprint", ctx);
+    if (plan && plan.changes.length) entries.push(plan);
+  }
+  for (const subdir of ["memory", "memory/knowledge", "memory/decisions", "memory/insights", "memory/dossiers"]) {
+    for (const file of listDir(path.join(scrumDir, subdir), MEMORY_FILE)) {
+      const plan = planFile(file, "memory", ctx);
+      if (plan && plan.changes.length) entries.push(plan);
+    }
+  }
 
   const totals = { files: entries.length, byField: {} };
   for (const entry of entries) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrumrun",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "description": "Evidence-driven Agile runtime and semantic project memory for AI coding agents.",
   "bin": {
     "scrumrun": "bin/scrumrun.js",