scrumrun 2.6.0 → 2.6.2

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.0` · **Method target:** `2.0.0` · **Runtime:** Node.js `>=22.13.0` · **License:** MIT
+**Package:** `2.6.2` · **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).
 
@@ -33,11 +33,23 @@ See [`docs/SCHEMA.md`](docs/SCHEMA.md) for the generated executable contract and
 
 ## Install
 
+Install the CLI globally (recommended — avoids `npx` cache quirks):
+
+```bash
+npm i -g scrumrun@latest
+scrumrun install
+scrumrun init
+```
+
+To upgrade later:
+
 ```bash
-npx scrumrun@latest install
-npx scrumrun@latest init
+npm i -g scrumrun@latest
+scrumrun update
 ```
 
+`npx scrumrun@latest <command>` also works if you prefer not to install globally, but pin the version explicitly (`@latest` or `@2.6.1`) — `npx scrumrun` alone will happily reuse a stale cached version.
+
 `install` adds the client integration; `init` creates the project tree. Initialization is local by default: `.scrumrun/` and the generated agent hint are added to `.git/info/exclude`. Use `--shared` when the team wants to commit the project memory.
 
 ScrumRun installs one canonical agent command:

package/bin/scrumrun.js

@@ -52,7 +52,7 @@ Usage:
   scrumrun sc
   scrumrun sc <noun> <subject> <action> [args]
   scrumrun install [all|codex|opencode|claude] [--force]
-  scrumrun update  [all|codex|opencode|claude] [--migrate]
+  scrumrun update  [all|codex|opencode|claude] [--no-migrate]
   scrumrun init [--local|--shared] [--lean] [--no-agent-hint] [--force]
   scrumrun status
   scrumrun core [--path|--prompt]
@@ -63,12 +63,16 @@ Usage:
   scrumrun doctor [all|codex|opencode|claude] [--strict] [--recover]
   scrumrun uninstall [--force]
 
+Install:
+  npm i -g scrumrun@latest          # recommended
+  npx scrumrun@latest <command>     # also works; pin @latest to avoid stale npx cache
+
 Examples:
-  npx scrumrun@latest install
-  npx scrumrun@latest sc knowledge decision --list
-  npx scrumrun@latest init
-  npx scrumrun@latest status
-  npx scrumrun@latest migrate --to 2 --dry-run
+  scrumrun install
+  scrumrun init
+  scrumrun status
+  scrumrun sc knowledge decision --list
+  scrumrun migrate --to 2 --dry-run
 `);
 }
 
@@ -299,7 +303,7 @@ function migrationPreflightOnUpdate({ apply = false } = {}) {
           return { status: "blocked" };
         }
         if (!apply) {
-          console.log("\nThe project remains unchanged. Apply the verified plan with: npx scrumrun@latest update --migrate");
+          console.log("\nThe project remains unchanged. Re-run update to apply the verified plan, or keep opt-out with: npx scrumrun@latest update --no-migrate");
           return { status: "ready" };
         }
         const result = applyRunLedgerMigration(process.cwd());
@@ -325,7 +329,7 @@ function migrationPreflightOnUpdate({ apply = false } = {}) {
       return { status: "blocked" };
     }
     if (!apply) {
-      console.log("\nThe project remains unchanged. Apply the verified plan with: npx scrumrun@latest update --migrate");
+      console.log("\nThe project remains unchanged. Re-run update to apply the verified plan, or keep opt-out with: npx scrumrun@latest update --no-migrate");
       return { status: "ready" };
     }
     const result = applyMigration(process.cwd(), { plan: preview.plan });
@@ -1570,7 +1574,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("--migrate") });
+    return updateInstallation(target, { migrate: !routeArgs.includes("--no-migrate") });
   }
   if (noun === "config" && subject === "init") {
     const localMode = routeArgs.includes("--local");
@@ -2495,7 +2499,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("--migrate") });
+  if (command === "update") updateInstallation(target, { migrate: !args.includes("--no-migrate") });
   else install(target, true, { compatibility: false });
 } else if (command === "sc") {
   runRoot(args.slice(1));

package/package.json

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