From 378e1b290c8d7e7c270f6f4917af23e120207bad Mon Sep 17 00:00:00 2001 From: August Cayzer Date: Sun, 25 Oct 2026 00:53:53 +0100 Subject: [PATCH] docs(changelog): cover v0.0.34 and v0.0.35 --- content/docs/(reference)/changelog.mdx | 27 ++++++++++++++++++++++++++ src/lib/command-check-allowlist.json | 10 ++++++++++ 2 files changed, 37 insertions(+) diff --git a/content/docs/(reference)/changelog.mdx b/content/docs/(reference)/changelog.mdx index ce99ca2d..5757965c 100644 --- a/content/docs/(reference)/changelog.mdx +++ b/content/docs/(reference)/changelog.mdx @@ -7,6 +7,33 @@ 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.35 + +Released October 24, 2026. [v0.0.35 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.35) + +**Change anything that sends view layouts before you upgrade.** A view is a `title`, a `query`, an optional `sort` and an optional `group`. A request that sends `layouts` is refused `400 validation_error`, and a view saved with `layouts` drops them the next time it is changed. In the CLI, `marfa views create` and `marfa views change` take `--sort` and `--group` in place of `--layouts`, `marfa device items list --layout` and `marfa device views groups --layout` are gone, and so is a group's `sum`. The server's database and the working copy keep the shapes they had in v0.0.34, so an instance needs no export to upgrade. See [Save a list as a view](/guides/list-filter-search#save-a-list-as-a-view). + +For apps and the API: + +- **A view clears its grouping with `group: null`.** Send it on `PATCH /views/{id}`, or run `marfa views change --version --group null`. A view's `filter` takes an `edge` term, a `backref` term and a `source` term, and a working copy answers a `backref` condition where it holds that edge type whole. See [Read a view offline](/guides/read-a-view). +- **Notes, articles and messages no longer require a `body`.** A note can be only a title, and a message only a file. An existing instance stops requiring it the next time it starts, with no migration. See [Items and types](/items-and-types). +- **Every edge type names both of its ends.** `label` names the source end and the optional `reverse_label` names the target end. Without a `reverse_label`, the label names both ends; without a `label`, Marfa makes one from the ID. See [Edges](/catalog/edges). +- **Move every item of a type to another type in one step.** `POST /types/{id}/move`, or `marfa types move `, queues a bulk-action job that moves the items, the trash included. Once none is left, it changes the folders, views and webhooks that name the old type. `DELETE /types/{id}` now refuses while a folder, view or webhook names the type, and lists them in `details.settings`. See [Move items to another type](/guides/move-items-to-another-type). + +For folders: + +- **A folder writes every attached file beside its document**, whether or not the body embeds it, and lists the files no embed places under the document's `has-attachment` line. A file follows its document to another directory, and leaves with it. A second folder on the same Mac that holds the file keeps its own copy, and a folder pull no longer deletes and rewrites it on every pass. See [Files attached to a note](/guides/sync-a-folder#files-attached-to-a-note). + +## v0.0.34 + +Released October 24, 2026. [v0.0.34 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.34) + +**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.33, so an instance needs no export to upgrade. + +For folders: + +- **An idle folder watch no longer runs a pass every second.** A pass starts only while a change is waiting, and no later than five seconds after the last pass ended, even while changes keep arriving. + ## v0.0.33 Released October 24, 2026. [v0.0.33 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.33) diff --git a/src/lib/command-check-allowlist.json b/src/lib/command-check-allowlist.json index 0fe69442..0fc59b09 100644 --- a/src/lib/command-check-allowlist.json +++ b/src/lib/command-check-allowlist.json @@ -29,6 +29,16 @@ "text": "marfa blobs delete-location", "reason": "The changelog names the old name of a command that a release renamed." }, + { + "page": "(reference)/changelog.mdx", + "text": "--layouts", + "reason": "The changelog names an option that a release removed." + }, + { + "page": "(reference)/changelog.mdx", + "text": "--layout", + "reason": "The changelog names an option that a release removed." + }, { "page": "guides/deploy.mdx", "text": "--import",