datanotes 3.0.0 → 3.2.0

package/dist/docs/guides/database-objects/views.md

@@ -41,7 +41,7 @@ Answer:
   "ok": true,
   "op": "create_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-create_view-create-view-main-public-vw_rec"
+  "migration_id": "20261019T040648-create_view-create-view-main-public-vw_rec"
 }
 ```
 
@@ -65,16 +65,16 @@ Answer:
   "total": 2,
   "rows": [
     {
-      "path": "datanotes/main/public/watch/2026-10-10T2030.md",
+      "path": "datanotes/main/public/watch/2026-10-17T2030.md",
       "film": "[[The Gold Rush]]",
-      "occurred_at": "2026-10-10T20:30",
+      "occurred_at": "2026-10-17T20:30",
       "where": "home",
       "place": "my living room"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-07T2115.md",
+      "path": "datanotes/main/public/watch/2026-10-14T2115.md",
       "film": "[[Charade]]",
-      "occurred_at": "2026-10-07T21:15",
+      "occurred_at": "2026-10-14T21:15",
       "where": "home",
       "place": "my living room"
     }
@@ -156,7 +156,7 @@ Answer:
   "ok": true,
   "op": "create_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-create_view-create-view-main-public-vw_rec-2"
+  "migration_id": "20261019T040648-create_view-create-view-main-public-vw_rec-2"
 }
 ```
 
@@ -194,7 +194,7 @@ Answer:
   "ok": true,
   "op": "create_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-create_view-create-view-main-public-vw_las"
+  "migration_id": "20261019T040648-create_view-create-view-main-public-vw_las"
 }
 ```
 
@@ -214,59 +214,59 @@ Answer (65 lines)
     {
       "path": "datanotes/main/public/film/Night of the Living Dead.md",
       "title": "Night of the Living Dead",
-      "watched_on": "2026-10-11",
+      "watched_on": "2026-10-18",
       "cast": [
         {
           "path": "datanotes/main/public/actor/Duane Jones.md",
           "table": "main.public.actor",
-          "id": "01a12efb-7fd1-74b0-ad94-c0ee904521ad",
+          "id": "01a15257-301f-7673-a539-232f5503e508",
           "name": "Duane Jones",
           "born": "1937-04-02"
         }
       ],
       "viewing": [
-        { "path": "datanotes/main/public/watch/2026-10-11T2200.md", "where": "cinema" }
+        { "path": "datanotes/main/public/watch/2026-10-18T2200.md", "where": "cinema" }
       ]
     },
     {
       "path": "datanotes/main/public/film/The Gold Rush.md",
       "title": "The Gold Rush",
-      "watched_on": "2026-10-10",
+      "watched_on": "2026-10-17",
       "cast": [
         {
           "path": "datanotes/main/public/actor/Charlie Chaplin.md",
           "table": "main.public.actor",
-          "id": "01a12efb-7fb2-7ee5-99d8-282dff2a79e5",
+          "id": "01a15257-2ffd-7cc9-a75d-33f2521017c5",
           "name": "Charlie Chaplin",
           "born": "1889-04-16"
         }
       ],
       "viewing": [
-        { "path": "datanotes/main/public/watch/2026-10-10T2030.md", "where": "home" }
+        { "path": "datanotes/main/public/watch/2026-10-17T2030.md", "where": "home" }
       ]
     },
     {
       "path": "datanotes/main/public/film/Charade.md",
       "title": "Charade",
-      "watched_on": "2026-10-07",
+      "watched_on": "2026-10-14",
       "cast": [
         {
           "path": "datanotes/main/public/actor/Cary Grant.md",
           "table": "main.public.actor",
-          "id": "01a12efb-7fbf-77c3-888b-698d82923a6f",
+          "id": "01a15257-300c-734a-9890-e6fa77c91bc8",
           "name": "Cary Grant",
           "born": "1904-01-18"
         },
         {
           "path": "datanotes/main/public/actor/Audrey Hepburn.md",
           "table": "main.public.actor",
-          "id": "01a12efb-7fca-74dd-b41c-fed458b65dc9",
+          "id": "01a15257-3019-7cfd-932d-a771c31e1661",
           "name": "Audrey Hepburn",
           "born": "1929-05-04"
         }
       ],
       "viewing": [
-        { "path": "datanotes/main/public/watch/2026-10-07T2115.md", "where": "home" }
+        { "path": "datanotes/main/public/watch/2026-10-14T2115.md", "where": "home" }
       ]
     }
   ],
@@ -313,7 +313,7 @@ Answer:
   "ok": true,
   "op": "create_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-create_view-create-view-main-public-vw_mos"
+  "migration_id": "20261019T040648-create_view-create-view-main-public-vw_mos"
 }
 ```
 
@@ -382,7 +382,7 @@ Answer:
   "ok": true,
   "op": "create_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-create_view-create-view-main-public-vw_lat"
+  "migration_id": "20261019T040648-create_view-create-view-main-public-vw_lat"
 }
 ```
 
@@ -400,59 +400,59 @@ Answer (64 lines)
   "total": 4,
   "rows": [
     {
-      "path": "datanotes/main/public/watch/2026-10-11T2200.md",
+      "path": "datanotes/main/public/watch/2026-10-18T2200.md",
       "film": {
         "path": "datanotes/main/public/film/Night of the Living Dead.md",
         "table": "main.public.film",
-        "id": "01a12efb-801a-78dc-83af-7ff7ecf09dd4",
+        "id": "01a15257-305f-798e-9a2a-b41b9c77960d",
         "title": "Night of the Living Dead",
         "year": 1968,
         "minutes": 96,
         "status": "watched",
         "rating": 4,
-        "watched_on": "2026-10-11",
+        "watched_on": "2026-10-18",
         "director": "George A. Romero",
         "cast": ["[[Duane Jones]]"]
       },
-      "occurred_at": "2026-10-11T22:00",
+      "occurred_at": "2026-10-18T22:00",
       "where": "cinema",
       "_source": "watch"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-10T2030.md",
+      "path": "datanotes/main/public/watch/2026-10-17T2030.md",
       "film": {
         "path": "datanotes/main/public/film/The Gold Rush.md",
         "table": "main.public.film",
-        "id": "01a12efb-7ffa-7aa8-988d-eba752b6277e",
+        "id": "01a15257-3043-7342-b25e-e2dabd4b1268",
         "title": "The Gold Rush",
         "year": 1925,
         "minutes": 95,
         "status": "watched",
         "rating": 5,
-        "watched_on": "2026-10-10",
+        "watched_on": "2026-10-17",
         "director": "Charlie Chaplin",
         "cast": ["[[Charlie Chaplin]]"]
       },
-      "occurred_at": "2026-10-10T20:30",
+      "occurred_at": "2026-10-17T20:30",
       "where": "home",
       "_source": "watch"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-07T2115.md",
+      "path": "datanotes/main/public/watch/2026-10-14T2115.md",
       "film": {
         "path": "datanotes/main/public/film/Charade.md",
         "table": "main.public.film",
-        "id": "01a12efb-8012-7876-bcf6-ea1a58b2cdec",
+        "id": "01a15257-3058-76e4-b51b-456bd3a7ea31",
         "title": "Charade",
         "year": 1963,
         "minutes": 113,
         "status": "watched",
         "rating": 4,
-        "watched_on": "2026-10-07",
+        "watched_on": "2026-10-14",
         "director": "Stanley Donen",
         "cast": ["[[Cary Grant]]", "[[Audrey Hepburn]]"]
       },
-      "occurred_at": "2026-10-07T21:15",
+      "occurred_at": "2026-10-14T21:15",
       "where": "home",
       "_source": "watch"
     }
@@ -476,14 +476,14 @@ Answer:
   "ok": true,
   "op": "drop_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-drop_view-drop-view-main-public-vw_most_"
+  "migration_id": "20261019T040648-drop_view-drop-view-main-public-vw_most_"
 }
 ```
 
 **`undo_migration`**
 
 ```json
-{ "migration_id": "20261012T071956-drop_view-drop-view-main-public-vw_most_" }
+{ "migration_id": "20261019T040648-drop_view-drop-view-main-public-vw_most_" }
 ```
 
 Answer:
@@ -492,8 +492,8 @@ Answer:
 {
   "ok": true,
   "op": "undo_migration",
-  "undoes": "20261012T071956-drop_view-drop-view-main-public-vw_most_",
-  "migration_id": "20261012T071956-undo_migration-undo-20261012t071956-drop_view",
+  "undoes": "20261019T040648-drop_view-drop-view-main-public-vw_most_",
+  "migration_id": "20261019T040648-undo_migration-undo-20261019t040648-drop_view",
   "conflicts": [],
   "failed": []
 }
@@ -526,7 +526,7 @@ Answer:
   "ok": true,
   "op": "create_view",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T071956-create_view-create-view-main-reports-vw_wa"
+  "migration_id": "20261019T040648-create_view-create-view-main-reports-vw_wa"
 }
 ```
 
@@ -619,7 +619,7 @@ Answer:
 ```json
 {
   "ok": true,
-  "migration_id": "20261012T071957-batch-views-for-film-and-actor-notes",
+  "migration_id": "20261019T040648-batch-views-for-film-and-actor-notes",
   "steps": [
     { "op": "create_view", "ok": true },
     { "op": "create_view", "ok": true },
@@ -645,13 +645,13 @@ Answer:
   "total": 2,
   "rows": [
     {
-      "path": "datanotes/main/public/watch/2026-09-23T2100.md",
-      "occurred_at": "2026-09-23T21:00",
+      "path": "datanotes/main/public/watch/2026-09-30T2100.md",
+      "occurred_at": "2026-09-30T21:00",
       "where": "home"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-10T2030.md",
-      "occurred_at": "2026-10-10T20:30",
+      "path": "datanotes/main/public/watch/2026-10-17T2030.md",
+      "occurred_at": "2026-10-17T20:30",
       "where": "home"
     }
   ],
@@ -679,9 +679,9 @@ Answer:
   "total": 1,
   "rows": [
     {
-      "path": "datanotes/main/public/watch/2026-10-10T2030.md",
+      "path": "datanotes/main/public/watch/2026-10-17T2030.md",
       "film": "[[The Gold Rush]]",
-      "occurred_at": "2026-10-10T20:30",
+      "occurred_at": "2026-10-17T20:30",
       "where": "home"
     }
   ],
@@ -766,7 +766,7 @@ The engine wrote this page’s views under `views:` in their schema, next to the
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a12efb-7f9b-7cd3-a1ae-d70e8a8d4ef4
+id: 01a15257-2fe2-7692-8c87-67639c554380
 config:
   history: true
 

package/dist/docs/guides/history/back-up.md

@@ -33,6 +33,8 @@ npx -y datanotes store backup --vault your_vault_folder \
 
 The command saves the setting, makes the store a git repository and pushes it once. A wrong address or a missing credential shows at once: the command then exits with code 1, and the engine retries later.
 
+The command holds the store while it runs, so an engine you start meanwhile refuses to start.
+
 The first commit and push can take minutes on a large store, such as 3,400 files and 150 MB. The command prints each step and waits for it. The push may take up to 10 minutes, or `DATANOTES_GIT_NETWORK_TIMEOUT_S` seconds. A step that fails leaves no git lock behind, so you can run the command again.
 
 Run `datanotes store backup --vault your_vault_folder` to see the setting. Add `--off` to turn the backup off: the store’s repository stays as it is.
@@ -67,11 +69,13 @@ C:/Windows/System32/OpenSSH/ssh.exe -T git@github.com
 
 The backup looks at the store on a regular schedule, every 60 seconds by default. At each look:
 
-1. If nothing changed in the store, it does nothing.
+1. If nothing changed in the store, it does nothing. The engine tells the backup which files it wrote, so this look runs no git at all.
 2. If something changed, it waits until the engine is idle: no operation running, and none for 3 seconds.
 3. It commits between two operations, then pushes.
 
-An operation writes several files of the store: a journal line, new table versions, sometimes blobs. A commit in the middle of one would save half of it. So the commit holds the engine’s write lock, like a short read lock, for `git add` and `git commit` only. An operation that arrives meanwhile waits for the commit, usually a fraction of a second. The push runs after the lock is released.
+An operation writes several files of the store: a journal line, new table versions, sometimes blobs. A commit in the middle of one would save half of it. So the commit holds the engine’s write lock, like a short read lock, for `git add` and `git commit` only. A first `git add` runs before the lock, so the one under it stages only the folders written since. An operation that arrives meanwhile waits for the commit, usually a fraction of a second. The push runs after the lock is released.
+
+The store’s repository keeps git’s cache of its folders (`core.untrackedCache` and `feature.manyFiles`), so git doesn’t read every folder again at each commit.
 
 When the engine stays busy, the backup tries again at the next look. After 5 busy looks in a row, the next one commits at the first gap between two operations anyway.
 
@@ -155,7 +159,9 @@ npx -y datanotes store restore --vault your_vault_folder \
   --from git@github.com:you/vault-store.git
 ```
 
-The command reads the database’s id in the vault’s `metastore.yaml`. It clones the backup into `<data home>/<database id>/` and checks that the backup belongs to that database. It then writes new settings, with a new owner token and the backup turned on.
+The command reads the database’s id in the vault’s `metastore.yaml`. It clones the backup next to the store and checks that the backup belongs to that database. Only then does it put the clone in place, at `<data home>/<database id>/`. It then writes new settings, with a new owner token and the backup turned on.
+
+The command holds the store while it runs, so an engine you start meanwhile refuses to start.
 
 Undo, history and time travel then work as before. Two things don’t come back, and you set them again:
 
@@ -175,6 +181,8 @@ Run one engine per backup repository. Two engines that push to the same reposito
 
 Git keeps every version of every file, so the repository only grows. `vacuum_table` deletes old history from the store, and the next commit records the deletion, but earlier commits still hold the files.
 
+The transaction log is a few large files, called segments, instead of one file per version. Git then stores and compares far fewer files. [How the engine writes the log](https://datanotes.dev/start/how-it-works/#how-the-engine-writes-the-log) explains both formats.
+
 To start again with a small repository, keep the old one as an archive:
 
 1. Stop the engine.
@@ -187,7 +195,7 @@ The new repository starts from the store as it is now. Delete the old repository
 
 ## Keep each file under 95 MB
 
-GitHub refuses a push with a file over 100 MB, every time. So before each push, the backup looks for a file over 95 MB in the commits to push. When it finds one, it doesn’t push, and doesn’t try again until the file is gone. `datanotes status` shows the backup as failing, with the file and its size, and the fix in `hint`.
+GitHub refuses a push with a file over 100 MB, every time. The engine never writes such a file itself: it splits each checkpoint of the transaction log into files of at most 4 MB of text. So before each push, the backup looks for a file over 95 MB in the commits to push, such as one a person copied into the store. When it finds one, it doesn’t push, and doesn’t try again until the file is gone. `datanotes status` shows the backup as failing, with the file and its size, and the fix in `hint`.
 
 To fix it:
 

package/dist/docs/guides/history/change-data-feed.md

@@ -23,56 +23,56 @@ Answer (74 lines)
   "events": [
     {
       "seq": 3,
-      "at": "2026-10-12T07:20:04.624Z",
+      "at": "2026-10-19T04:06:55.908Z",
       "table": "main.public.film",
       "kind": "insert",
       "op": "insert_row",
       "path": "datanotes/main/public/film/Nosferatu.md",
-      "row_id": "01a12efb-9f0c-7795-aacb-6e9601757026",
+      "row_id": "01a15257-4ea0-749e-bc45-1d36404958ac",
       "changes": {
-        "id": { "after": "01a12efb-9f0c-7795-aacb-6e9601757026" },
+        "id": { "after": "01a15257-4ea0-749e-bc45-1d36404958ac" },
         "title": { "after": "Nosferatu" },
         "status": { "after": "to watch" }
       },
       "source": "engine",
       "row": {
-        "id": "01a12efb-9f0c-7795-aacb-6e9601757026",
+        "id": "01a15257-4ea0-749e-bc45-1d36404958ac",
         "title": "Nosferatu",
         "status": "to watch"
       },
       "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-      "migration_id": "20261012T072004-insert_row-insert-into-film"
+      "migration_id": "20261019T040655-insert_row-insert-into-film"
     },
     {
       "seq": 4,
-      "at": "2026-10-12T07:20:04.630Z",
+      "at": "2026-10-19T04:06:55.914Z",
       "table": "main.public.film",
       "kind": "insert",
       "op": "insert_row",
       "path": "datanotes/main/public/film/Metropolis.md",
-      "row_id": "01a12efb-9f12-7afd-8545-4fec074ff1fb",
+      "row_id": "01a15257-4ea6-7caa-8cee-e372c1fec68a",
       "changes": {
-        "id": { "after": "01a12efb-9f12-7afd-8545-4fec074ff1fb" },
+        "id": { "after": "01a15257-4ea6-7caa-8cee-e372c1fec68a" },
         "title": { "after": "Metropolis" },
         "status": { "after": "to watch" }
       },
       "source": "engine",
       "row": {
-        "id": "01a12efb-9f12-7afd-8545-4fec074ff1fb",
+        "id": "01a15257-4ea6-7caa-8cee-e372c1fec68a",
         "title": "Metropolis",
         "status": "to watch"
       },
       "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-      "migration_id": "20261012T072004-insert_row-insert-into-film-2"
+      "migration_id": "20261019T040655-insert_row-insert-into-film-2"
     },
     {
       "seq": 5,
-      "at": "2026-10-12T07:20:04.637Z",
+      "at": "2026-10-19T04:06:55.921Z",
       "table": "main.public.film",
       "kind": "update",
       "op": "update_row",
       "path": "datanotes/main/public/film/Nosferatu.md",
-      "row_id": "01a12efb-9f0c-7795-aacb-6e9601757026",
+      "row_id": "01a15257-4ea0-749e-bc45-1d36404958ac",
       "changes": {
         "status": { "before": "to watch", "after": "watched" },
         "rating": { "after": 4 },
@@ -80,14 +80,14 @@ Answer (74 lines)
       },
       "source": "engine",
       "row": {
-        "id": "01a12efb-9f0c-7795-aacb-6e9601757026",
+        "id": "01a15257-4ea0-749e-bc45-1d36404958ac",
         "title": "Nosferatu",
         "status": "watched",
         "rating": 4,
         "watched_on": "2026-10-03"
       },
       "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-      "migration_id": "20261012T072004-update_row-update-film"
+      "migration_id": "20261019T040655-update_row-update-film"
     }
   ],
   "last": 5,
@@ -116,25 +116,25 @@ Answer:
   "events": [
     {
       "seq": 14,
-      "at": "2026-10-12T07:20:09.225Z",
+      "at": "2026-10-19T04:07:00.489Z",
       "table": "main.public.film",
       "kind": "insert",
       "op": "insert_row",
       "path": "datanotes/main/public/film/His Girl Friday.md",
-      "row_id": "01a12efb-b104-7743-a725-fa938af1a57b",
+      "row_id": "01a15257-6086-7874-808c-ad022ba671e1",
       "changes": {
-        "id": { "after": "01a12efb-b104-7743-a725-fa938af1a57b" },
+        "id": { "after": "01a15257-6086-7874-808c-ad022ba671e1" },
         "title": { "after": "His Girl Friday" },
         "status": { "after": "to watch" }
       },
       "source": "engine",
       "row": {
-        "id": "01a12efb-b104-7743-a725-fa938af1a57b",
+        "id": "01a15257-6086-7874-808c-ad022ba671e1",
         "title": "His Girl Friday",
         "status": "to watch"
       },
       "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-      "migration_id": "20261012T072009-insert_row-insert-into-film"
+      "migration_id": "20261019T040700-insert_row-insert-into-film"
     }
   ],
   "last": 14,
@@ -149,19 +149,19 @@ Answer:
 **`create_webhook`**
 
 ```json
-{ "url": "http://127.0.0.1:42525/datanotes-hook", "tables": ["film"] }
+{ "url": "http://127.0.0.1:46035/datanotes-hook", "tables": ["film"] }
 ```
 
 Answer:
 
 ```json
 {
-  "id": "wh_c4b48fd54bb5",
-  "url": "http://127.0.0.1:42525/datanotes-hook",
+  "id": "wh_ec4e37b04323",
+  "url": "http://127.0.0.1:46035/datanotes-hook",
   "tables": ["film"],
   "enabled": true,
   "cursor": 14,
-  "created_at": "2026-10-12T07:20:09.229Z",
+  "created_at": "2026-10-19T04:07:00.494Z",
   "failures": 0,
   "status": "ok",
   "secret": "<shown once>"
@@ -183,28 +183,28 @@ The receiver got this request:
 ```json
 {
   "headers": {
-    "x-datanotes-signature": "sha256=399f785d39d4a9f7d6aead97b64aad81a936cfb1fdeaf69843407a2549d6829d"
+    "x-datanotes-signature": "sha256=42e2f1b279304e507dc504eead14b0848c55dea078fad8cb58078598c1263936"
   },
   "body": {
-    "webhook": "wh_c4b48fd54bb5",
+    "webhook": "wh_ec4e37b04323",
     "events": [
       {
         "seq": 15,
-        "at": "2026-10-12T07:20:09.237Z",
+        "at": "2026-10-19T04:07:00.499Z",
         "table": "main.public.film",
         "kind": "update",
         "op": "update_row",
         "path": "datanotes/main/public/film/His Girl Friday.md",
-        "row_id": "01a12efb-b104-7743-a725-fa938af1a57b",
+        "row_id": "01a15257-6086-7874-808c-ad022ba671e1",
         "changes": { "status": { "before": "to watch", "after": "watched" } },
         "source": "engine",
         "row": {
-          "id": "01a12efb-b104-7743-a725-fa938af1a57b",
+          "id": "01a15257-6086-7874-808c-ad022ba671e1",
           "title": "His Girl Friday",
           "status": "watched"
         },
         "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-        "migration_id": "20261012T072009-update_row-update-film"
+        "migration_id": "20261019T040700-update_row-update-film"
       }
     ],
     "last": 15
@@ -220,13 +220,13 @@ Answer:
 {
   "webhooks": [
     {
-      "id": "wh_c4b48fd54bb5",
-      "url": "http://127.0.0.1:42525/datanotes-hook",
+      "id": "wh_ec4e37b04323",
+      "url": "http://127.0.0.1:46035/datanotes-hook",
       "tables": ["film"],
       "enabled": true,
       "cursor": 15,
-      "created_at": "2026-10-12T07:20:09.229Z",
-      "last_delivery": "2026-10-12T07:20:09.241Z",
+      "created_at": "2026-10-19T04:07:00.494Z",
+      "last_delivery": "2026-10-19T04:07:00.504Z",
       "failures": 0,
       "status": "ok"
     }
@@ -237,7 +237,7 @@ Answer:
 **`delete_webhook`**
 
 ```json
-{ "id": "wh_c4b48fd54bb5" }
+{ "id": "wh_ec4e37b04323" }
 ```
 
 Answer:

package/dist/docs/guides/history/journal-and-undo.md

@@ -87,11 +87,11 @@ Answer:
   "total": 13,
   "migrations": [
     {
-      "migration_id": "20261012T071951-delete_rows-archive-1-rows-of-film",
+      "migration_id": "20261019T040643-delete_rows-archive-1-rows-of-film",
       "op": "delete_rows",
       "summary": "archive 1 rows of film",
       "table": "main.public.film",
-      "executed_at": "2026-10-12T07:19:51.705Z",
+      "executed_at": "2026-10-19T04:06:43.206Z",
       "notes_changed": 0,
       "files_changed": 1,
       "undone": false,
@@ -99,11 +99,11 @@ Answer:
       "by": "docs-example"
     },
     {
-      "migration_id": "20261012T071951-merge_rows-merge-2-rows-into-film",
+      "migration_id": "20261019T040643-merge_rows-merge-2-rows-into-film",
       "op": "merge_rows",
       "summary": "merge 2 rows into film",
       "table": "main.public.film",
-      "executed_at": "2026-10-12T07:19:51.690Z",
+      "executed_at": "2026-10-19T04:06:43.194Z",
       "notes_changed": 1,
       "files_changed": 1,
       "undone": false,
@@ -111,11 +111,11 @@ Answer:
       "by": "docs-example"
     },
     {
-      "migration_id": "20261012T071951-update_rows-update-film",
+      "migration_id": "20261019T040643-update_rows-update-film",
       "op": "update_rows",
       "summary": "update film",
       "table": "main.public.film",
-      "executed_at": "2026-10-12T07:19:51.674Z",
+      "executed_at": "2026-10-19T04:06:43.181Z",
       "notes_changed": 3,
       "files_changed": 0,
       "undone": false,
@@ -129,7 +129,7 @@ Answer:
 **`undo_migration`**
 
 ```json
-{ "migration_id": "20261012T071951-delete_rows-archive-1-rows-of-film" }
+{ "migration_id": "20261019T040643-delete_rows-archive-1-rows-of-film" }
 ```
 
 Answer:
@@ -138,8 +138,8 @@ Answer:
 {
   "ok": true,
   "op": "undo_migration",
-  "undoes": "20261012T071951-delete_rows-archive-1-rows-of-film",
-  "migration_id": "20261012T071951-undo_migration-undo-20261012t071951-delete_ro",
+  "undoes": "20261019T040643-delete_rows-archive-1-rows-of-film",
+  "migration_id": "20261019T040643-undo_migration-undo-20261019t040643-delete_ro",
   "conflicts": [],
   "failed": []
 }
@@ -197,7 +197,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 14, "operation": "UPDATE" }],
-  "migration_id": "20261012T071951-update_row-update-film-5"
+  "migration_id": "20261019T040643-update_row-update-film-5"
 }
 ```
 
@@ -216,7 +216,7 @@ Then someone changes the rating again:
 **`undo_migration`**
 
 ```json
-{ "migration_id": "20261012T071951-update_row-update-film-5" }
+{ "migration_id": "20261019T040643-update_row-update-film-5" }
 ```
 
 Refused:
@@ -249,7 +249,7 @@ The undo of an insert trashes the new note only while it’s as the insert left
 **`undo_migration`**
 
 ```json
-{ "migration_id": "20261012T071951-insert_row-insert-into-film-6" }
+{ "migration_id": "20261019T040643-insert_row-insert-into-film-6" }
 ```
 
 Refused: