docs(release): align the docs with marfa v0.0.28

content/docs/(reference)/changelog.mdx

@@ -7,6 +7,16 @@ Each release of Marfa ships the server and its container image, the CLI for macO
 
 **Marfa doesn't upgrade a database in place.** A build refuses a database whose schema differs from its own, or that holds retired tables or settings, and leaves the file unchanged; a version change alone doesn't cause a refusal. [Upgrade](/guides/upgrade) shows how to test an export and restore on fresh storage before switching builds.
 
+## v0.0.28
+
+Released October 23, 2026. [v0.0.28 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.28)
+
+**This release fixes the folder watch, which runs in the CLI, so upgrade the CLI to get the fix.** The server's database, the API and the working copy keep the shapes they had in v0.0.27, so an instance needs no export to upgrade.
+
+For folders:
+
+- **A sync no longer writes back a file you moved or deleted while it ran.** A pass scans the folder, sends what it found, then pulls. A file the scan read that is gone when the pull reaches its item was written back to its old path, so a moved file returned as a copy that became a second item, and a deleted file returned. The pull now leaves the file unwritten, counts it as unwritten and names it in the report, and the next scan decides: a moved file keeps its item, and a deleted file's item goes to the bin after the five-second grace. A file you delete before the folder first writes its `marfa_id` line into it keeps its delete the same way. A file gone from a path a scan no longer reaches, such as one the folder's `ignore` list now leaves out, is still written where its item wants it, because no scan can tell a move from a delete there. See [What removes a file or an item](/guides/folder-safeguards#what-removes-a-file-or-an-item).
+
 ## v0.0.27
 
 Released October 23, 2026. [v0.0.27 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.27)

src/generated/cli-download.md

@@ -1,5 +1,5 @@
 ```bash
-curl -fsSL https://github.com/withmarfa/marfa/releases/download/v0.0.27/marfa-0.0.27-darwin-arm64.tar.gz | tar -xz
+curl -fsSL https://github.com/withmarfa/marfa/releases/download/v0.0.28/marfa-0.0.28-darwin-arm64.tar.gz | tar -xz
 sudo mkdir -p /usr/local/bin
 sudo mv marfa /usr/local/bin/
 marfa --version

src/generated/contract-index.json

@@ -2208,6 +2208,10 @@
       "folders/delete-revived-cancels": "e6541a9f3c3b1f7e",
       "folders/delete-revived-count": "444d2573dc949c88",
       "folders/delete-unshown-change": "4447a7ff8d48eaa3",
+      "folders/delete-before-first-write": "c0d8f9f19c8dbd90",
+      "folders/pull-missing-file-not-written": "2515b8c825ff8d6d",
+      "folders/pull-missing-file-unwritten-count": "cf6c8380bf09dbc2",
+      "folders/pull-missing-file-moved-keeps-item": "59828aec3d896a39",
       "folders/delete-path-reused": "1662a3ba2cc77550",
       "folders/delete-left-by-state": "5e37a50988d822fe",
       "folders/delete-already-trashed": "ee44316aeb581067",

src/generated/marfa-release.json

@@ -1 +1 @@
-{"version":"v0.0.27"}
+{"version":"v0.0.28"}

src/generated/server-image.md

@@ -1,5 +1,5 @@
 ```bash
-docker pull ghcr.io/withmarfa/marfa-server:0.0.27
+docker pull ghcr.io/withmarfa/marfa-server:0.0.28
 docker run --name marfa -d --restart unless-stopped -p 127.0.0.1:8600:8600 \
-  -v marfa-data:/data --env-file marfa.env ghcr.io/withmarfa/marfa-server:0.0.27
+  -v marfa-data:/data --env-file marfa.env ghcr.io/withmarfa/marfa-server:0.0.28
 ```