agentwheel 0.20.9 → 0.20.11

package/README.md

@@ -427,6 +427,22 @@ apply journal that embeds and exactly correlates the missing manifest and graph
 discoverable for recovery. Legacy SSH state is also preserved and refused because the old records do
 not prove which endpoint owned it.
 
+After reviewing `agentwheel ownership recovery-plan`, use `--recover-legacy-state` only for an
+invalid local candidate whose historical files must remain preserved. The recovery plan ignores
+that candidate when constructing the new stable state; it does not authorize runtime replacement.
+Adopting matching unmanaged files still requires `--force-conflict`, while replacing differing files
+still requires `--replace-conflict`. Review the resulting plan before applying the same flags:
+
+```bash
+agentwheel plan --fleet example-fleet --agent lab-claude \
+  --recover-legacy-state --force-conflict --replace-conflict
+agentwheel install --fleet example-fleet --agent lab-claude \
+  --recover-legacy-state --force-conflict --replace-conflict
+```
+
+Once the stable manifest exists, normal status and planning use it while retaining the invalid
+historical candidate for explicit later cleanup.
+
 ## Core Ideas
 
 **Three places, one direction:**

package/dist/{apply-JBULQGW5.js → apply-ZGCJLZMZ.js}

@@ -5,9 +5,9 @@ import {
   commitManifestMetadataJournal,
   recoverPendingApply,
   uninstall
-} from "./chunk-E7Z2YB2C.js";
-import "./chunk-SHPNLNBR.js";
-import "./chunk-7VPI5J5Y.js";
+} from "./chunk-A44XYLUT.js";
+import "./chunk-FP26KSBM.js";
+import "./chunk-GE7F76AC.js";
 export {
   applyCombinedInstallPlan,
   applyInstallPlan,

package/dist/{chunk-E7Z2YB2C.js → chunk-A44XYLUT.js}

@@ -24,11 +24,11 @@ import {
   rollbackCompletedOperations,
   sourceLockPath,
   writeApplyJournal
-} from "./chunk-SHPNLNBR.js";
+} from "./chunk-FP26KSBM.js";
 import {
   pathExists,
   writeJsonAtomic
-} from "./chunk-7VPI5J5Y.js";
+} from "./chunk-GE7F76AC.js";
 
 // src/install/apply.ts
 import { execFile } from "child_process";
@@ -2407,6 +2407,7 @@ export {
   assertOperationContained,
   MergeAdoptionMismatchError,
   assertExactMergeContribution,
+  assertMergedSourceContribution,
   combineMergeRemovals,
   hasMergeRemovalContent,
   mergeRemovalForInstall,

package/dist/{chunk-SHPNLNBR.js → chunk-FP26KSBM.js}

@@ -4,7 +4,7 @@ import {
   hashPath,
   pathExists,
   writeJsonAtomic
-} from "./chunk-7VPI5J5Y.js";
+} from "./chunk-GE7F76AC.js";
 
 // src/install/transaction.ts
 import { createHash as createHash6 } from "crypto";
@@ -2865,8 +2865,8 @@ async function recoverMutationRuntime(operationId, options = {}) {
     }
     mutation = GovernedMutation.activateExisting(receipt, baseline, lock);
     const [{ recoverPendingApply }, { readLinkedLocalApplyJournal: readLinkedLocalApplyJournal2, removeApplyJournal: removeApplyJournal2, localPathExists: localPathExists2 }] = await Promise.all([
-      import("./apply-JBULQGW5.js"),
-      import("./transaction-EPP7GHXD.js")
+      import("./apply-ZGCJLZMZ.js"),
+      import("./transaction-4KBNHDQX.js")
     ]);
     let missingReservation = false;
     for (const entry of pending) {

package/dist/{chunk-7VPI5J5Y.js → chunk-GE7F76AC.js}

@@ -90,6 +90,7 @@ async function withFilesystemLock(lockPath, timeoutMs, fn, description = "cache"
       break;
     } catch (error) {
       if (!isAlreadyExists(error)) throw error;
+      if (await removeStaleFilesystemLock(lockPath)) continue;
       if (Date.now() - started > timeoutMs) {
         throw new Error(`Timed out waiting for ${description} lock at ${lockPath}`);
       }
@@ -102,6 +103,26 @@ async function withFilesystemLock(lockPath, timeoutMs, fn, description = "cache"
     await rm(lockPath, { recursive: true, force: true });
   }
 }
+async function removeStaleFilesystemLock(lockPath) {
+  try {
+    const owner = JSON.parse(await readFile(join(lockPath, "owner.json"), "utf8"));
+    if (typeof owner.pid !== "number" || !Number.isSafeInteger(owner.pid) || owner.pid <= 0 || isProcessAlive(owner.pid)) return false;
+    const stalePath = `${lockPath}.stale-${process.pid}-${Date.now()}`;
+    await rename(lockPath, stalePath);
+    await rm(stalePath, { recursive: true, force: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code !== "ESRCH";
+  }
+}
 function isAlreadyExists(error) {
   return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
 }

package/dist/{chunk-EMDIG24I.js → chunk-U2GRG4UI.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   pathExists
-} from "./chunk-7VPI5J5Y.js";
+} from "./chunk-GE7F76AC.js";
 
 // src/source/identify.ts
 import { homedir } from "os";

package/dist/{identify-D64HZTUT.js → identify-O54QXPQR.js}

@@ -2,8 +2,8 @@
 import {
   inferSourceDriverName,
   isExplicitSource
-} from "./chunk-EMDIG24I.js";
-import "./chunk-7VPI5J5Y.js";
+} from "./chunk-U2GRG4UI.js";
+import "./chunk-GE7F76AC.js";
 export {
   inferSourceDriverName,
   isExplicitSource