@devrouter/cli 0.6.5 → 0.6.7

package/dist/devrouter-lifecycle-worker.js

@@ -5592,7 +5592,7 @@ function loadRepoConfig(repoPath, read2 = (file) => import_node_fs16.default.rea
   const config = parseRepoConfigSource(raw, configPath);
   const requiredVersion = config.devrouter?.version;
   if (requiredVersion && !hasWarnedVersionMismatch) {
-    const cliVersion = true ? "0.6.5" : "0.0.0-dev";
+    const cliVersion = true ? "0.6.7" : "0.0.0-dev";
     if (cliVersion !== "0.0.0-dev" && compareSemver2(requiredVersion, cliVersion) > 0) {
       hasWarnedVersionMismatch = true;
       process.stderr.write(
@@ -7979,7 +7979,7 @@ function advanceAppReplacementAttempt(identity2, authority, stage, newPrimaryId)
   });
 }
 function installedCliVersion() {
-  return true ? "0.6.5" : "0.0.0-dev";
+  return true ? "0.6.7" : "0.0.0-dev";
 }
 function compareCliVersions(left, right) {
   const parts = (value) => value.split(".").map((part) => Number.parseInt(part, 10) || 0);

package/dist/devrouter.js

@@ -4944,7 +4944,7 @@ function loadRepoConfig(repoPath, read2 = (file) => import_node_fs8.default.read
   const config = parseRepoConfigSource(raw, configPath);
   const requiredVersion = config.devrouter?.version;
   if (requiredVersion && !hasWarnedVersionMismatch) {
-    const cliVersion = true ? "0.6.5" : "0.0.0-dev";
+    const cliVersion = true ? "0.6.7" : "0.0.0-dev";
     if (cliVersion !== "0.0.0-dev" && compareSemver(requiredVersion, cliVersion) > 0) {
       hasWarnedVersionMismatch = true;
       process.stderr.write(
@@ -7266,7 +7266,7 @@ function validateAppReplacementAttempt(value, identity2) {
   return attempt;
 }
 function installedCliVersion() {
-  return true ? "0.6.5" : "0.0.0-dev";
+  return true ? "0.6.7" : "0.0.0-dev";
 }
 function compareCliVersions(left, right) {
   const parts = (value) => value.split(".").map((part) => Number.parseInt(part, 10) || 0);
@@ -25491,17 +25491,20 @@ async function collectRouterStatus(repoPath) {
       `Run: dev app add --name <name> --host <name>.localhost --protocol http --runtime host --repo ${repo.path}`
     );
   } else if (repo?.valid) {
+    const repoArgument = `'${repo.path.replaceAll("'", `'\\''`)}'`;
+    const failedTransition = repo.managedRuntime?.status === "failed-transition";
     if (repo.managedRuntime?.mode === "managed") {
-      const repoArgument = `'${repo.path.replaceAll("'", `'\\''`)}'`;
-      nextSteps.push(`Run: devrouter ensure ${repoArgument}`);
+      nextSteps.push(
+        failedTransition ? `Inspect: devrouter status --repo ${repoArgument}; resolve the reported drift before retrying ensure.` : `Run: devrouter ensure ${repoArgument}`
+      );
     } else {
       nextSteps.push(`Run: dev app ls --repo ${repo.path}`);
       nextSteps.push("Run: dev app run <name> --repo <path> --yes");
     }
     nextSteps.push("Run: dev ls");
-    if (repo.managedRuntime?.mountNesting?.status === "unwound") {
+    if (!failedTransition && repo.managedRuntime?.mountNesting?.status === "unwound") {
       nextSteps.push(
-        `Run: devrouter stop ${repo.path} and then devrouter ensure ${repo.path} to re-apply the unwound nested mount`
+        `Run: devrouter stop ${repoArgument} and then devrouter ensure ${repoArgument} to re-apply the unwound nested mount`
       );
     }
   }
@@ -25943,7 +25946,7 @@ function probeInstalledCliVersion(executable) {
 }
 function buildCliPathCheck(options = {}) {
   const id5 = "global.cli-path";
-  const runningVersion = options.runningVersion ?? (true ? "0.6.5" : "0.0.0-dev");
+  const runningVersion = options.runningVersion ?? (true ? "0.6.7" : "0.0.0-dev");
   if (runningVersion === "0.0.0-dev") {
     return {
       id: id5,
@@ -26765,6 +26768,7 @@ async function buildDoctorReport(options = {}) {
       });
       if (repo.managedRuntime) {
         const managedRuntime = repo.managedRuntime;
+        const repoArgument = `'${repo.path.replaceAll("'", `'\\''`)}'`;
         const variantOption = managedRuntime.activeVariant && managedRuntime.activeVariant !== "default" ? ` --variant ${managedRuntime.activeVariant}` : "";
         const level = managedRuntime.mode === "legacy" || managedRuntime.status === "ready" ? "ok" : managedRuntime.status === "starting" || managedRuntime.status === "stopped" ? "warn" : "error";
         const summary2 = managedRuntime.mode === "legacy" ? "Legacy runtime contract is active." : managedRuntime.status === "ready" ? `Managed runtime profile '${managedRuntime.profile}' is ready.` : managedRuntime.status === "starting" ? `Managed runtime profile '${managedRuntime.profile}' is starting.` : managedRuntime.status === "stopped" ? `Managed runtime profile '${managedRuntime.profile}' is stopped.` : managedRuntime.status === "failed-transition" ? `Managed runtime profile '${managedRuntime.profile}' has a failed transition.` : `Managed runtime profile '${managedRuntime.profile}' has runtime drift.`;
@@ -26778,7 +26782,7 @@ async function buildDoctorReport(options = {}) {
           level,
           summary: summary2,
           ...details ? { details } : {},
-          suggestion: managedRuntime.mode === "legacy" ? void 0 : managedRuntime.status === "failed-transition" ? `Inspect: dev status --repo ${repo.path}; resolve the reported drift before retrying ensure.` : managedRuntime.status === "ready" ? void 0 : `Run: dev ensure ${repo.path}${variantOption}`
+          suggestion: managedRuntime.mode === "legacy" ? void 0 : managedRuntime.status === "failed-transition" ? `Inspect: devrouter status --repo ${repoArgument}; resolve the reported drift before retrying ensure.` : managedRuntime.status === "ready" ? void 0 : `Run: devrouter ensure ${repoArgument}${variantOption}`
         });
         const mountNesting = managedRuntime.mountNesting;
         if (mountNesting && mountNesting.status !== "not-applicable") {
@@ -26796,7 +26800,7 @@ async function buildDoctorReport(options = {}) {
                   (entry) => `unwound=${entry.destination} (source ${entry.source} inside ${entry.nestedWithin})`
                 )
               ].join("; "),
-              suggestion: `Run: devrouter stop ${repo.path} and then devrouter ensure ${repo.path}${variantOption} to restart the exact container, which re-applies the nested mount.`
+              suggestion: managedRuntime.status === "failed-transition" ? void 0 : `Run: devrouter stop ${repoArgument} and then devrouter ensure ${repoArgument}${variantOption} to restart the exact container, which re-applies the nested mount.`
             });
           } else if (mountNesting.status === "unverified") {
             addCheck(checks, {
@@ -26807,7 +26811,7 @@ async function buildDoctorReport(options = {}) {
                 `container=${container}`,
                 `reason=${mountNesting.reason ?? "unknown"}`
               ].join("; "),
-              suggestion: `Run: devrouter exec ${repo.path} -- cat /proc/self/mountinfo to read the container's own mount table.`
+              suggestion: `Run: devrouter exec ${repoArgument} -- cat /proc/self/mountinfo to read the container's own mount table.`
             });
           } else {
             addCheck(checks, {
@@ -26841,7 +26845,7 @@ async function buildDoctorReport(options = {}) {
           suggestion: `Remedy ${expansionNotice.remedy.code}: set a named default profile other than '${expansionNotice.profile}'${remedyCandidates}.`
         });
       }
-      const cliVersion = true ? "0.6.5" : "0.0.0-dev";
+      const cliVersion = true ? "0.6.7" : "0.0.0-dev";
       const configVersion = config.devrouter?.version;
       const installedKnown = cliVersion !== "0.0.0-dev";
       const versionComparison = installedKnown && configVersion ? compareSemver(configVersion, cliVersion) : void 0;
@@ -42520,7 +42524,7 @@ var init_version = __esm({
 
 // src/cli.ts
 var import_commander = require("commander");
-var CLI_VERSION = true ? "0.6.5" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.6.7" : "0.0.0-dev";
 var VERSION_FLAGS = /* @__PURE__ */ new Set(["-V", "--version"]);
 function withErrorHandling(action2) {
   return async (...args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devrouter/cli",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Local dev routing CLI with shared Traefik reverse proxy",
   "author": "Roland Schlaefli",
   "homepage": "https://github.com/rschlaefli/devrouter#readme",

package/upgrade-prompts/0.6.6.md

@@ -0,0 +1,46 @@
+# Upgrade to devrouter 0.6.6
+
+Managed status/doctor recovery commands preserve the exact checkout argument when
+paths contain spaces, apostrophes or shell expansion characters. Startup,
+failed-transition inspection and nested-mount restart/inspection guidance use
+canonical `devrouter` names. Existing variant flags, diagnostic levels and
+execution eligibility remain. No configuration schema or lifecycle contract changes.
+
+## Task
+
+Within approved installation/adaptation scope, select the verified exact package,
+update `devrouter.version` in `.devrouter.yml` and refresh existing agent guidance
+with `devrouter repo agents`. Check every PATH-visible executable and known
+wrapper, package/source invocation and harness/controller pin. Obtain participating
+owners' actual executable/package identities; PATH inventory is not fleet proof.
+Do not start a consumer to validate metadata or installation.
+
+Before the first 0.6.6 lifecycle write, coordinate compatible qualified clients
+sharing those journals, including readers and controllers. Older 0.6.5 refuses
+newer-writer state through direct reads, updates and global enumeration. Unknown
+or competing client identities hold activation. Each receiving host and consumer
+retains its runtime/data authority and consumed attempt limits. Installation and
+release notices do not authorize activation.
+
+Preserve journal bytes, writer stamps and durable initialization/replacement
+receipts. An older reader is not a downgrade recovery route after newer writes.
+Use a compatible qualified CLI with fresh ownership proof for authorized recovery;
+never edit or erase state or version/hash fences to bypass refusal or rearm attempts.
+
+## Validation
+
+1. Verify selected package integrity, executable bytes/version and existing local
+   guidance. Run native checks for actual consumer edits.
+2. Treat diagnostic commands as advice subject to existing startup/repair
+   preconditions and the receiving owner's runtime authority. Preserve known
+   refusals and unknown completion; quoting is not additional eligibility proof.
+3. Separately authorized runtime work ends with canonical stop and exact provider,
+   container, route and worker proof unless the user explicitly retains it.
+
+## Report
+
+Report exact selected package/executable identities, participating-client adoption,
+remaining unknowns, relevant checks and any actual runtime terminal. Keep release
+and package proof distinct from consumer recovery. This patch adds no provider
+combination, maintenance/reset qualification, consumer-data acceptance or permission
+for another runtime attempt.

package/upgrade-prompts/0.6.7.md

@@ -0,0 +1,48 @@
+# Upgrade to devrouter 0.6.7
+
+Status and doctor keep failed-transition recovery advice consistent, including
+combined status insights and unwound-mount diagnostics. Inspect the exact checkout
+and resolve the reported transition before retrying ensure; the warning is not
+permission to stop/restart an unproved population. Existing readiness, startup,
+repair, ownership, levels and literal checkout argument rules remain.
+No configuration schema or lifecycle contract changes are introduced.
+
+## Task
+
+Within approved installation/adaptation scope, select the integrity-verified exact
+package, update `devrouter.version` in `.devrouter.yml` and refresh existing agent
+guidance through `devrouter repo agents`. Verify the actual selected executable,
+PATH copies and participating package/source/harness/controller pins. Ask each
+participating owner which executable can access this host's Devrouter state;
+PATH inventory alone does not prove coordinated adoption.
+
+Before the first 0.6.7 lifecycle write, active participating clients must use a
+compatible qualified reader/writer. Older 0.6.6 refuses its newer-writer journals
+through direct read, update and global enumeration even without a schema change.
+Inactive older pins stay unused until compatible adoption is verified. Unknown
+participation holds activation. Do not use an older reader as a downgrade recovery
+route after new writes. Preserve all journal bytes, writer stamps and durable
+initialization/replacement receipts; never erase state or loosen version/hash
+fences to bypass refusal or rearm a consumed attempt.
+
+Installation and release notices supply no consumer startup, repair, replacement,
+initialization, reset or extra-attempt authority. Each owner retains exact runtime,
+data and neighbour limits. Failed-transition inspection is a diagnostic action;
+it does not prove application readiness or prescribe an automatic retry.
+
+## Validation
+
+1. Verify registry integrity, selected package/member bytes, executable version
+   and the existing local guidance. Run native checks for actual consumer edits.
+2. Use `devrouter status --repo <checkout> --json` and existing diagnostic results
+   for authorized inspection. Compare the actual obstruction and next-action
+   preconditions before any separately authorized lifecycle command.
+3. Any separately authorized runtime work ends with canonical stop and exact
+   provider/container/route/worker proof unless the user keeps it running.
+
+## Report
+
+Report exact selected package/executable identities, participating-client adoption,
+remaining unknowns and relevant checks. Record any actual runtime terminal with
+its producing evidence. Package proof does not establish receiving-host adoption,
+consumer recovery, broader guidance parity or retained-maintenance acceptance.