@devrouter/cli 0.0.41 → 0.0.42

package/dist/devrouter.js

@@ -2504,7 +2504,7 @@ function loadRepoConfig(repoPath) {
   const config = parseConfig(parsed ?? {}, configPath);
   const requiredVersion = config.devrouter?.version;
   if (requiredVersion && !hasWarnedVersionMismatch) {
-    const cliVersion = true ? "0.0.41" : "0.0.0-dev";
+    const cliVersion = true ? "0.0.42" : "0.0.0-dev";
     if (cliVersion !== "0.0.0-dev" && compareSemver(requiredVersion, cliVersion) > 0) {
       hasWarnedVersionMismatch = true;
       process.stderr.write(
@@ -5195,7 +5195,7 @@ function hasExactComposeIdentity(container, options) {
   const actualFiles = (container.labels["com.docker.compose.project.config_files"] ?? "").split(",").map((file) => file.trim()).filter(Boolean);
   const providerGeneratedFiles = actualFiles.filter((file) => {
     const normalized = file.replaceAll("\\", "/");
-    return /\/.devpod\/agent\/contexts\/[^/]+\/workspaces\/[^/]+\/.docker-compose\/docker-compose\.devcontainer\.containerFeatures-[^/]+\.yml$/.test(
+    return /\/(?:\.devpod\/agent\/contexts\/[^/]+\/workspaces\/[^/]+|\.devsy\/contexts\/[^/]+\/workspaces\/[^/]+\/agent)\/\.docker-compose\/docker-compose\.devcontainer\.containerFeatures-[^/]+\.yml$/.test(
       normalized
     );
   });
@@ -6758,6 +6758,16 @@ var init_devpod_workspaces = __esm({
 });
 
 // src/core/devsy-mutation.ts
+function failedStartMayHaveAttached(devsyId, repoPath) {
+  try {
+    const attached = listDevsyWorkspaces();
+    const attachedId = devsyId ?? selectDevsyWorkspace(attached, repoPath)?.id;
+    if (!attachedId) return false;
+    return inspectDevsyWorkspaceOwnership(attached, attachedId, repoPath).status !== "absent";
+  } catch {
+    return true;
+  }
+}
 function withMutationLock(activity, target, operation) {
   import_node_fs18.default.mkdirSync(DEVROUTER_HOME, { recursive: true });
   return withFileLockSync(
@@ -6878,7 +6888,11 @@ function startDevsyWorkspace(options) {
       env
     });
     if (result.status !== 0) {
-      throw new Error(`devsy workspace up failed for '${devsyId ?? options.repoPath}'.`);
+      const message = `devsy workspace up failed for '${devsyId ?? options.repoPath}'.`;
+      if (failedStartMayHaveAttached(devsyId, options.repoPath)) {
+        throw new DevsyStartPostconditionError(message);
+      }
+      throw new Error(message);
     }
     try {
       const attached = listDevsyWorkspaces();
@@ -6999,17 +7013,25 @@ function deleteOwnedDevpodWorkspace(devpodId, worktreePath) {
 }
 function startDevpodWorkspace(options) {
   if (resolveWorkspaceRuntimeOrDefault(options.repoPath) === "devsy") {
-    const result = startDevsyWorkspace({
-      repoPath: options.repoPath,
-      devsyId: options.devpodId,
-      devcontainerPath: options.devcontainerPath,
-      recreate: options.recreate,
-      quiet: options.quiet,
-      workspace: options.workspace,
-      inactivityTimeout: readWorkspaceRuntimeConfig().devsyInactivityTimeout
-    });
-    resetWorkspaceRuntimeCaches();
-    return result;
+    try {
+      const result = startDevsyWorkspace({
+        repoPath: options.repoPath,
+        devsyId: options.devpodId,
+        devcontainerPath: options.devcontainerPath,
+        recreate: options.recreate,
+        quiet: options.quiet,
+        workspace: options.workspace,
+        inactivityTimeout: readWorkspaceRuntimeConfig().devsyInactivityTimeout
+      });
+      resetWorkspaceRuntimeCaches();
+      return result;
+    } catch (error) {
+      if (error instanceof DevsyStartPostconditionError) {
+        resetWorkspaceRuntimeCaches();
+        throw new DevpodStartPostconditionError(error.message);
+      }
+      throw error;
+    }
   }
   const activity = options.recreate ? "DevPod recreate" : "DevPod start";
   return withMutationLock2(activity, options.repoPath, () => {
@@ -8005,7 +8027,7 @@ async function buildDoctorReport(options = {}) {
       const config = runtimeConfig.config;
       loadedConfig = config;
       loadedWorkspace = runtimeConfig.workspace;
-      const cliVersion = true ? "0.0.41" : "0.0.0-dev";
+      const cliVersion = true ? "0.0.42" : "0.0.0-dev";
       const configVersion = config.devrouter?.version;
       if (configVersion && cliVersion !== "0.0.0-dev" && compareSemver(configVersion, cliVersion) > 0) {
         addCheck(checks, {
@@ -14210,7 +14232,7 @@ var init_version = __esm({
 
 // src/cli.ts
 var import_commander = require("commander");
-var CLI_VERSION = true ? "0.0.41" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.0.42" : "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.0.41",
+  "version": "0.0.42",
   "description": "Local dev routing CLI with shared Traefik reverse proxy",
   "author": "Roland Schlaefli",
   "homepage": "https://github.com/rschlaefli/devrouter#readme",

package/upgrade-prompts/0.0.42.md

@@ -0,0 +1,39 @@
+# Upgrade to devrouter 0.0.42
+
+Devrouter now keeps partially started Devsy workspaces recoverable through the
+canonical lifecycle when the provider returns an error after registering or
+starting the exact checkout.
+
+1. Install `@devrouter/cli@0.0.42` on the host and bump `.devrouter.yml` to
+   `devrouter.version: 0.0.42`.
+2. Keep using `devrouter ensure`, `devrouter exec`, and `devrouter stop` for
+   managed lifecycle operations. No repository schema, Dev Container, runtime,
+   route, data, or volume migration is required.
+3. If a cold Devsy start fails after provider mutation, do not remove the
+   ignored `.devcontainer/devcontainer.devrouter.json`. Run
+   `devrouter stop <checkout>`; devrouter now preserves the generated file when
+   exact Devsy absence cannot be proved.
+4. Resolve the reported provider failure, then retry `devrouter ensure` through
+   the same canonical lifecycle. Do not switch providers or delete the runtime
+   merely to repair a partial start.
+
+Verification:
+
+- Run `devrouter -V --repo <checkout>` and confirm both the installed CLI and
+  local repository report `0.0.42`.
+- Run `devrouter doctor --repo <checkout> --json` and confirm the effective
+  workspace runtime and selection source are expected.
+- Run `devrouter ensure <checkout> --json`, then
+  `devrouter exec <checkout> -- <representative-command>`.
+- Run `devrouter stop <checkout> --json`, confirm the same exact workspace is
+  stopped, and confirm `devrouter ls --json` contains no route for the exact
+  checkout.
+
+Report template:
+
+- CLI/config version: `0.0.42`
+- Effective runtime and source:
+  `<devsy/devpod and override/env/path-owner/machine-config/auto-detect/default>`
+- Ensure/exec/route proof: `<passed or details>`
+- Exact non-destructive stop: `<passed or details>`
+- Remaining blockers: `<none or details>`