From a5721bab92f10782cd521538284072214363e20c Mon Sep 17 00:00:00 2001 From: August Cayzer Date: Fri, 23 Oct 2026 04:03:40 +0100 Subject: [PATCH] docs(release): align the docs with marfa v0.0.28 --- content/docs/(reference)/changelog.mdx | 10 ++++++++++ src/generated/cli-download.md | 2 +- src/generated/contract-index.json | 4 ++++ src/generated/marfa-release.json | 2 +- src/generated/server-image.md | 4 ++-- 5 files changed, 18 insertions(+), 4 deletions(-) diff --git a/content/docs/(reference)/changelog.mdx b/content/docs/(reference)/changelog.mdx index d2952b1e..742107bb 100644 --- a/content/docs/(reference)/changelog.mdx +++ b/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) diff --git a/src/generated/cli-download.md b/src/generated/cli-download.md index b3dd29b1..86e49ffe 100644 --- a/src/generated/cli-download.md +++ b/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 diff --git a/src/generated/contract-index.json b/src/generated/contract-index.json index 32089624..4ce3d161 100644 --- a/src/generated/contract-index.json +++ b/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", diff --git a/src/generated/marfa-release.json b/src/generated/marfa-release.json index 12a47014..9e47133c 100644 --- a/src/generated/marfa-release.json +++ b/src/generated/marfa-release.json @@ -1 +1 @@ -{"version":"v0.0.27"} +{"version":"v0.0.28"} diff --git a/src/generated/server-image.md b/src/generated/server-image.md index ed9dd899..a857845d 100644 --- a/src/generated/server-image.md +++ b/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 ```