@devrouter/cli 0.2.0 → 0.3.1

package/README.md

@@ -116,6 +116,13 @@ Use devrouter lifecycle commands for managed environments. Raw DevPod or Devsy
 Devrouter auto-detects the installed workspace runtime CLI (DevPod or Devsy) and
 you can pin it with `DEVROUTER_WORKSPACE_RUNTIME=devpod|devsy`.
 
+## Cleaning up worktrees
+
+Agent sessions and devcontainers leave many worktrees, dependencies and Docker
+stacks behind. `devrouter workspace cleanup --all-worktrees --check-merged`
+reports which are safe to remove; removal applies only a list a person
+approved by its SHA-256. See [Cleaning up worktrees](./docs/WORKTREE_CLEANUP.md).
+
 ## Agent onboarding
 
 Generate the canonical, non-mutating onboarding prompt from a target repository:

package/dist/devrouter-lifecycle-worker.js

@@ -5373,7 +5373,7 @@ function retain(session, previous) {
 
 // src/core/reliability-operation-store.ts
 function installedCliVersion() {
-  return true ? "0.2.0" : "0.0.0-dev";
+  return true ? "0.3.1" : "0.0.0-dev";
 }
 function compareCliVersions(left, right) {
   const parts = (value) => value.split(".").map((part) => Number.parseInt(part, 10) || 0);
@@ -7371,7 +7371,7 @@ function loadRepoConfig(repoPath, read2 = (file) => import_node_fs19.default.rea
   const config = parseConfig(parsed ?? {}, configPath);
   const requiredVersion = config.devrouter?.version;
   if (requiredVersion && !hasWarnedVersionMismatch) {
-    const cliVersion = true ? "0.2.0" : "0.0.0-dev";
+    const cliVersion = true ? "0.3.1" : "0.0.0-dev";
     if (cliVersion !== "0.0.0-dev" && compareSemver2(requiredVersion, cliVersion) > 0) {
       hasWarnedVersionMismatch = true;
       process.stderr.write(
@@ -10237,6 +10237,25 @@ function inspectExactOwnership(devsyId, worktreePath) {
   if (ownership.status === "conflict") throw new Error(ownership.reason);
   return ownership;
 }
+function checkoutVanished(worktreePath) {
+  try {
+    import_node_fs26.default.lstatSync(worktreePath);
+    return false;
+  } catch (error) {
+    return error.code === "ENOENT";
+  }
+}
+function deleteVanishedCheckoutRegistration(devsyId, worktreePath, originalError) {
+  if (!checkoutVanished(worktreePath)) throw originalError;
+  const runtime = inspectDevsyRuntimeStatus(devsyId);
+  if (runtime !== "stopped" && runtime !== "not-found") throw originalError;
+  runDevsyAction("delete", devsyId, true, worktreePath);
+  if (inspectExactOwnership(devsyId, worktreePath).status !== "absent") {
+    throw new Error(
+      `Devsy workspace '${devsyId}' still owns vanished checkout '${worktreePath}' after forced provider delete.`
+    );
+  }
+}
 function mutateOwnedDevsyWorkspace(action, devsyId, worktreePath) {
   return withMutationLock(`Devsy ${action}`, worktreePath, () => {
     restoreRecordedManagedDevcontainerConfig(worktreePath);
@@ -10250,7 +10269,13 @@ function mutateOwnedDevsyWorkspace(action, devsyId, worktreePath) {
     }
     const before = inspectExactOwnership(devsyId, worktreePath);
     if (before.status === "absent") return { status: "absent" };
-    runDevsyAction(action, devsyId, false, worktreePath);
+    try {
+      runDevsyAction(action, devsyId, false, worktreePath);
+    } catch (error) {
+      if (action !== "delete") throw error;
+      deleteVanishedCheckoutRegistration(devsyId, worktreePath, error);
+      return { status: "changed" };
+    }
     let after = inspectExactOwnership(devsyId, worktreePath);
     if (action === "stop" && after.status !== "owned") {
       throw new Error(