@devrouter/cli 0.6.4 → 0.6.6

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.4" : "0.0.0-dev";
+    const cliVersion = true ? "0.6.6" : "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.4" : "0.0.0-dev";
+  return true ? "0.6.6" : "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.4" : "0.0.0-dev";
+    const cliVersion = true ? "0.6.6" : "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.4" : "0.0.0-dev";
+  return true ? "0.6.6" : "0.0.0-dev";
 }
 function compareCliVersions(left, right) {
   const parts = (value) => value.split(".").map((part) => Number.parseInt(part, 10) || 0);
@@ -25486,17 +25486,22 @@ async function collectRouterStatus(repoPath) {
     nextSteps.push(`Run: dev repo init --repo ${repo.path}`);
   } else if (repo && !repo.valid) {
     nextSteps.push("Fix .devrouter.yml validation errors and re-run `dev doctor --repo <path>`");
-  } else if (repo?.valid && repo.appCount === 0) {
+  } else if (repo?.valid && repo.managedRuntime?.mode !== "managed" && repo.appCount === 0) {
     nextSteps.push(
       `Run: dev app add --name <name> --host <name>.localhost --protocol http --runtime host --repo ${repo.path}`
     );
   } else if (repo?.valid) {
-    nextSteps.push(`Run: dev app ls --repo ${repo.path}`);
-    nextSteps.push("Run: dev app run <name> --repo <path> --yes");
+    const repoArgument = `'${repo.path.replaceAll("'", `'\\''`)}'`;
+    if (repo.managedRuntime?.mode === "managed") {
+      nextSteps.push(`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") {
       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`
       );
     }
   }
@@ -25938,7 +25943,7 @@ function probeInstalledCliVersion(executable) {
 }
 function buildCliPathCheck(options = {}) {
   const id5 = "global.cli-path";
-  const runningVersion = options.runningVersion ?? (true ? "0.6.4" : "0.0.0-dev");
+  const runningVersion = options.runningVersion ?? (true ? "0.6.6" : "0.0.0-dev");
   if (runningVersion === "0.0.0-dev") {
     return {
       id: id5,
@@ -26760,6 +26765,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.`;
@@ -26773,7 +26779,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") {
@@ -26791,7 +26797,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: `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, {
@@ -26802,7 +26808,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, {
@@ -26836,7 +26842,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.4" : "0.0.0-dev";
+      const cliVersion = true ? "0.6.6" : "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;
@@ -42515,7 +42521,7 @@ var init_version = __esm({
 
 // src/cli.ts
 var import_commander = require("commander");
-var CLI_VERSION = true ? "0.6.4" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.6.6" : "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.4",
+  "version": "0.6.6",
   "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.5.md

@@ -0,0 +1,45 @@
+# Upgrade to devrouter 0.6.5
+
+Status and doctor now recommend `devrouter ensure <checkout>` for managed
+repositories, including profiles with no routed apps. The command quotes the
+exact checkout path. Legacy app guidance and existing unwound-mount diagnostics
+remain. No configuration schema or provider/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.5 lifecycle write, coordinate compatible qualified clients
+sharing those journals, including readers and controllers. Older 0.6.4 refuses
+newer-writer state, including direct reads, updates and global enumeration.
+Unknown or competing client identities hold activation. Each receiving host
+and consumer retains its own runtime/data authority and consumed attempt limits.
+Installation and a release notice do not authorize activation.
+
+Preserve journal bytes, writer stamps and durable initialization/replacement
+receipts. Downgrading an older reader is not a recovery route after newer writes.
+Use a compatible qualified CLI with fresh ownership proof for authorized recovery;
+never erase or edit state to bypass refusal or rearm an attempt.
+
+## Validation
+
+1. Verify selected package integrity, executable bytes/version and existing local
+   guidance. Run native checks for the actual consumer edits.
+2. Use canonical exact-checkout ensure only under the receiving owner's separate
+   runtime authority. Diagnostic startup guidance is advice, not approval or proof
+   that all startup preconditions hold. Retain known refusals and unknown outcomes.
+3. Any separately authorized runtime work ends with canonical stop and exact
+   provider/container/route/worker proof, unless explicitly retained by the user.
+
+## Report
+
+Report the exact selected package and executable identities, participating-client
+adoption and remaining unknowns, relevant checks and any actual runtime terminal.
+Keep release/package proof distinct from consumer recovery. This patch's
+qualification does not add provider combinations, maintenance/reset support,
+consumer data acceptance or permission for another runtime attempt.

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.