kylon-cli 0.7.9-next.1258 → 0.7.9-next.1261

package/README.md

@@ -866,6 +866,30 @@ scoped error bundle). Missing logs do not prevent collecting other evidence.
 Full bundles keep three startup files per stream; scoped bundles keep two.
 Linux and Windows retain their existing log paths.
 
+## Session storage recovery
+
+The computer's Session storage controls apply its configured inactivity limits
+(defaults: repositories after 7 days, sessions after 30 days). Live assignments
+protect their working directories. A linked worktree with an existing parent
+repository is removed through Git, which refuses uncommitted work in external
+repositories.
+
+When a worktree's Git metadata has disappeared, the daemon moves its checkout
+into `~/.kylon/workdir-recovery/<id>/checkout` before reclaiming space. The sibling
+`recovery.json` records its original local path and recovery time. This location
+uses the configured Kylon root when `XDG_CONFIG_HOME` is set. Source files,
+untracked notes, ignored files such as `.env`, and arbitrary ignored directories
+remain there; recovery is never swept as trash or included in automatic cleanup.
+Only Git-ignored directories with conventional dependency/cache names
+(`node_modules`, `.next`, `.nuxt`, `.turbo`, `.parcel-cache`, `.svelte-kit`,
+`__pycache__`, `.venv`) are removed from the recovered checkout. Retained recovery
+files do not count as reclaimed disk space.
+
+To retrieve work, inspect `recovery.json`, then copy the needed files from its
+`checkout` directory into a valid clone. The saved `.git` marker still refers to
+the missing parent; recovery does not recreate Git objects or repository history.
+Malformed markers, permission failures, and incomplete scans still block cleanup.
+
 ## Remote diagnostics
 
 The CLI reports to the server through one channel (`src/lib/telemetry.ts`):

package/dist/kylon-bundle.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.7.9-next.1258",
-  "fingerprint": "0209c0c9c17ea32d3b72bc0d882854ca84783b7b720648f63dadfa9110beb19d",
-  "source_commit": "e917c0f78508b10c6cfec05e8431185f7030a02c"
+  "version": "0.7.9-next.1261",
+  "fingerprint": "a9358b8bc98ec62acc8c0edb60a5fde44fc51422617f401deea0dd8e68efa67a",
+  "source_commit": "cf023a6c327cd61b4db791f51f912a5ec4f8dada"
 }