claude-nomad 0.65.0 → 0.67.0

package/CHANGELOG.md

@@ -1,5 +1,115 @@
 # Changelog
 
+## [0.67.0](https://github.com/funkadelic/claude-nomad/compare/v0.66.0...v0.67.0) (2026-08-18)
+
+### What's new
+
+**On all supported platforms, i.e. \*nix, Mac, WSL2, and native Windows.**
+
+- **Your backup cache no longer collects empty folders.** Every sync saves a copy of anything it is
+  about to overwrite into a dated folder under `~/.cache/claude-nomad/backup/`, and it creates that
+  folder before it touches your files so a full disk or a permissions problem stops the sync before
+  it has changed anything. A sync that turns out to have nothing to save now clears its own folder
+  instead of leaving an empty one behind, and so does one that stops early.
+- **`nomad clean --backups` removes empty backup folders whatever their age.** They hold nothing to
+  recover, so neither the 14-day default nor `--keep <N>` keeps one alive, and they no longer use up
+  the slots `--keep <N>` reserves: ask for the five newest and you get the five newest that actually
+  hold something. Backups holding anything at all, a file or even a link, are left exactly as
+  before. `nomad clean --backups --dry-run` always prints its preview, since it changes nothing and
+  never waits on another command.
+- **`nomad adopt` no longer runs at the same time as a pull, push, or sync.** It waits its turn the
+  way those commands already wait for each other, so a cleanup or a sync running in another terminal
+  cannot remove or overwrite a backup that adopt is still writing. If another one is already
+  running, adopt says so and does nothing rather than starting a move it cannot finish safely.
+  Previewing with `nomad adopt <name> --dry-run` never waits, since it only reads and prints.
+
+
+### Added
+
+* clean up the empty folders in your backup cache ([#525](https://github.com/funkadelic/claude-nomad/issues/525)) ([3f5ae92](https://github.com/funkadelic/claude-nomad/commit/3f5ae92e46173364f5e9c66e4963bcc716c813e6))
+
+
+### Fixed
+
+* **ci:** base the drift branch on main on a dispatch run ([#524](https://github.com/funkadelic/claude-nomad/issues/524)) ([3e94c1e](https://github.com/funkadelic/claude-nomad/commit/3e94c1e2df9296a539c71eac873058cb69225d78))
+
+## [0.66.0](https://github.com/funkadelic/claude-nomad/compare/v0.65.0...v0.66.0) (2026-08-17)
+
+### What's new
+
+**On all supported platforms, i.e. \*nix, Mac, WSL2, and native Windows.**
+
+- **A folder you share now carries everything inside it.** If you share a folder through
+  `sharedDirs`, its subfolders travel with it, including ones with everyday names like `sessions`,
+  `plans`, `tasks`, and `cache`. Those names used to be refused wherever they appeared, so a push
+  could fail, or `nomad adopt` could turn you away, over a folder holding nothing sensitive. Your
+  Claude login, your credential files, your per-host settings, and your local history still never
+  leave the machine, in either direction.
+- **`nomad adopt` checks the whole folder before it moves anything.** It used to copy everything,
+  so a file that never syncs between machines could land in your repo and fail your next push, on
+  content you never chose to add. Adopt now stops before touching anything and names every path it
+  objected to and why: a name that collides with the never-sync list, which renaming clears, or a
+  name that looks like a credential file, where renaming only helps if the new name looks different
+  too. `--dry-run` gives exactly the same answer as the real run, so you can check a folder before
+  committing to it.
+- **An interrupted `nomad adopt` now explains itself instead of writing a crash report.** If
+  another program has the directory open, or its permissions block the move partway through, the
+  command says what happened, where your content ended up, and what to run next. Your content is
+  safe in every one of these cases: either it was never touched on this machine, or it is already
+  in the repo.
+
+**On native Windows (PowerShell or cmd).** Note: WSL2 behaves like Linux and none of these apply to
+it.
+
+- **A push no longer publishes a folder you never asked to share.** Windows keeps your shared
+  config as real file copies rather than symlinks, and a push used to pick up any folder sitting in
+  your Claude directory and publish it to your other machines. Sharing is now the same deliberate
+  step it has always been on macOS and Linux: run `nomad adopt <name>` once, then push. Your
+  existing shared folders keep syncing exactly as before.
+- **`nomad doctor --verbose` names a folder your repo does not carry yet.** It lists the local
+  copies that are still private to this machine, and the command that shares one.
+- **One unreadable file no longer ends your pull.** A single config file that another program has
+  open, or that your account cannot read, used to stop the whole pull with a crash report. Nomad
+  now names the file and the reason, then carries on: your settings, your skills, and your session
+  history all still sync, and the command finishes normally. The warning also says whether the file
+  is still there or has been removed, and points at the backup copy when there is one.
+- **`nomad adopt` recovers cleanly when it cannot restore your local copy.** Adopt finishes by
+  copying the folder back out of the sync repo so this machine keeps a usable copy. If that copy
+  was blocked, the command used to end in a crash report, with the folder gone from your Claude
+  directory and nothing staged for publishing. It now stops with a plain message naming the folder
+  and the reason, stages the adopted content either way, and tells you to run `nomad pull` before
+  your next push and why that order matters. A half written folder left behind by the interrupted
+  copy is removed, so a later push cannot replace your adopted folder with the partial one.
+- **A refused `nomad pull --force-remote` now tells you what actually clears it.** The old advice
+  did not work, and would land you back on the same refusal. The message now gives the steps that
+  finish the job and names the one that clears the check, and it says that the stuck rebase has
+  already been undone by that point, so retrying is now just an ordinary pull. It no longer calls
+  every listed file at risk, since the list can include files where the shared repo is simply ahead
+  of yours. The quickstart says the same thing and links to the matching recovery steps in the FAQ.
+
+
+### Added
+
+* carry your own subfolders inside a shared directory ([#522](https://github.com/funkadelic/claude-nomad/issues/522)) ([791eef9](https://github.com/funkadelic/claude-nomad/commit/791eef9685672eb16113f79b7160c3988fae8ebc))
+
+
+### Fixed
+
+* **adopt:** say what happened when a move cannot finish ([#516](https://github.com/funkadelic/claude-nomad/issues/516)) ([d5e8add](https://github.com/funkadelic/claude-nomad/commit/d5e8addac0ba769f340b776ffeb5e96a95877eea))
+* **adopt:** stop a native Windows adopt from ending in a crash report ([#514](https://github.com/funkadelic/claude-nomad/issues/514)) ([0e9bee9](https://github.com/funkadelic/claude-nomad/commit/0e9bee9cc6d32ce71db2f290897de9a256b3a10c))
+* **adopt:** stop adopt from copying host-only files into your synced config ([#517](https://github.com/funkadelic/claude-nomad/issues/517)) ([9f92706](https://github.com/funkadelic/claude-nomad/commit/9f92706fa6ce06635b8c3fef0e76d34484a40696))
+* **ci:** keep the drift PR updatable on a second push ([#523](https://github.com/funkadelic/claude-nomad/issues/523)) ([ff6cdc6](https://github.com/funkadelic/claude-nomad/commit/ff6cdc631002bdbabb5948b7d5c41634adc5a771))
+* **pull:** keep a native Windows pull going when one shared file cannot be read ([#512](https://github.com/funkadelic/claude-nomad/issues/512)) ([32ea631](https://github.com/funkadelic/claude-nomad/commit/32ea63195f260556ebd246ca03d63f7ee1758753))
+* **pull:** say what actually clears a refused recovery ([#515](https://github.com/funkadelic/claude-nomad/issues/515)) ([a97fed2](https://github.com/funkadelic/claude-nomad/commit/a97fed27a0c0439631594fe6c7213e6e6df45062))
+
+
+### Dependencies
+
+* bump astro from 7.2.0 to 7.2.2 in /docs-site in the prod-dependencies group across 1 directory ([#521](https://github.com/funkadelic/claude-nomad/issues/521)) ([4e5e4ca](https://github.com/funkadelic/claude-nomad/commit/4e5e4ca0d0a8d551f3fa743818bb3a196325254d))
+* bump starlight-links-validator from 0.25.2 to 0.25.3 in /docs-site in the dev-dependencies group across 1 directory ([#520](https://github.com/funkadelic/claude-nomad/issues/520)) ([77d1a24](https://github.com/funkadelic/claude-nomad/commit/77d1a24303a14c8d8556d9d69ece4990572797f4))
+* bump the codeql-action group with 2 updates ([#519](https://github.com/funkadelic/claude-nomad/issues/519)) ([9e45462](https://github.com/funkadelic/claude-nomad/commit/9e45462797059f52efbfbaec8d2a65d52455b3a9))
+* bump the dev-dependencies group across 1 directory with 5 updates ([#518](https://github.com/funkadelic/claude-nomad/issues/518)) ([2feb689](https://github.com/funkadelic/claude-nomad/commit/2feb6893c61e815940fd182995b01c3be93be728))
+
 ## [0.65.0](https://github.com/funkadelic/claude-nomad/compare/v0.64.1...v0.65.0) (2026-08-13)
 
 ### What's new

package/README.md

@@ -146,8 +146,9 @@ the same either way; the difference is under the hood.
 Native Windows cannot use symlinks, so claude-nomad keeps a real copy of your shared config in
 `~/.claude/` instead of a symlink. `nomad pull` and `nomad sync` both mirror your local copies into
 the repo before they fetch, so an edit you have not published yet is captured rather than
-overwritten. If a file cannot be read, the pull leaves it out and warns naming the file: fix that
-and run again before you rely on the result.
+overwritten. If a file cannot be read, because another program is holding it open or its permissions
+changed, the pull warns naming the file and the reason, skips that one file, and finishes everything
+else normally. Close whatever is holding it, or fix its permissions, and run again to pick it up.
 
 ```powershell
 # 1. Install prerequisites and the CLI. (Using Scoop instead? scoop install gh gitleaks.)