scrumrun 2.6.4 → 2.6.6

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.4` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
+**Package:** `2.6.6` · **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

@@ -31,6 +31,8 @@ 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 TASK_REF = /^TASK-\d{3,}$/;
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 const FEAT_REF = /^FEAT-\d{3,}$/;
 const SLUG_REF = /^[a-z0-9][a-z0-9-]*$/;
 
@@ -105,6 +107,19 @@ function planFile(file, kind, ctx) {
   let header = split.header;
   const changes = [];
 
+  const updated = extractField(header, "updated");
+  if (updated !== undefined && updated !== "null" && !ISO_DATE.test(updated)) {
+    const parsed = new Date(updated);
+    if (!isNaN(parsed.getTime())) {
+      const iso = parsed.toISOString().slice(0, 10);
+      const next = replaceField(header, "updated", iso);
+      if (next !== header) {
+        changes.push({ field: "updated", from: updated, to: iso });
+        header = next;
+      }
+    }
+  }
+
   const method = extractField(header, "method");
   if (method === undefined) {
     if (hasField(header, "id")) {
@@ -145,6 +160,14 @@ function planFile(file, kind, ctx) {
   }
 
   if (kind === "run") {
+    const taskRef = extractField(header, "task");
+    if (taskRef !== undefined && taskRef !== "null" && taskRef !== null && taskRef !== "" && !TASK_REF.test(taskRef)) {
+      const next = replaceField(header, "task", "null");
+      if (next !== header) {
+        changes.push({ field: "task", from: taskRef, to: "null" });
+        header = next;
+      }
+    }
     const status = extractField(header, "status");
     if (status && RUN_STATUS_ALIAS[status]) {
       const next = replaceField(header, "status", RUN_STATUS_ALIAS[status]);

package/package.json

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