datanotes 3.4.2 → 3.5.0

package/dist/docs/guides/history/restore.md

@@ -21,7 +21,7 @@ The dry run names the version by its time, with a `timestamp` from the history r
 **`restore_table`**
 
 ```json
-{ "table": "film", "timestamp": "2026-10-24T20:30:07.980Z", "dry_run": true }
+{ "table": "film", "timestamp": "2026-10-26T08:00:29.883Z", "dry_run": true }
 ```
 
 Answer:
@@ -50,7 +50,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Metropolis.md"],
   "commits": [{ "table": "main.public.film", "version": 7, "operation": "RESTORE" }],
-  "migration_id": "20261024T203008-restore_table-restore-main-public-film-to-ve"
+  "migration_id": "20261026T080029-restore_table-restore-main-public-film-to-ve"
 }
 ```
 
@@ -113,7 +113,7 @@ An agent can change several tables in one call: here one batch adds an actor and
 Answer:
 
 ```json
-{ "ok": true, "migration_id": "20261024T203016-batch-add-cary-grant-rate-his-girl-f" }
+{ "ok": true, "migration_id": "20261026T080038-batch-add-cary-grant-rate-his-girl-f" }
 ```
 
 **`describe_history`**
@@ -136,10 +136,10 @@ Answer (62 lines)
     {
       "table": "main.public.film",
       "version": 11,
-      "timestamp": "2026-10-24T20:30:16.626Z",
+      "timestamp": "2026-10-26T08:00:38.521Z",
       "operation": "UPDATE",
       "operation_parameters": { "summary": "update film" },
-      "migration_id": "20261024T203016-update_row-update-film",
+      "migration_id": "20261026T080038-update_row-update-film",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 1,
@@ -148,16 +148,16 @@ Answer (62 lines)
       "engine_info": "datanotes",
       "user_name": "docs-example",
       "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-      "batch": "20261024T203016-batch-add-cary-grant-rate-his-girl-f",
+      "batch": "20261026T080038-batch-add-cary-grant-rate-his-girl-f",
       "tables": ["main.public.actor", "main.public.film"]
     },
     {
       "table": "main.public.actor",
       "version": 2,
-      "timestamp": "2026-10-24T20:30:16.620Z",
+      "timestamp": "2026-10-26T08:00:38.516Z",
       "operation": "WRITE",
       "operation_parameters": { "summary": "insert into actor" },
-      "migration_id": "20261024T203016-insert_row-insert-into-actor-2",
+      "migration_id": "20261026T080038-insert_row-insert-into-actor-2",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 0,
@@ -166,16 +166,16 @@ Answer (62 lines)
       "engine_info": "datanotes",
       "user_name": "docs-example",
       "actor": { "session": "history", "harness": "docs-example", "auth": "owner" },
-      "batch": "20261024T203016-batch-add-cary-grant-rate-his-girl-f",
+      "batch": "20261026T080038-batch-add-cary-grant-rate-his-girl-f",
       "tables": ["main.public.actor", "main.public.film"]
     },
     {
       "table": "main.public.film_at",
       "version": 1,
-      "timestamp": "2026-10-24T20:30:16.613Z",
+      "timestamp": "2026-10-26T08:00:38.510Z",
       "operation": "ALTER TABLE",
       "operation_parameters": { "summary": "alter table main.public.film_at" },
-      "migration_id": "20261024T203016-alter_table-alter-table-main-public-film_a",
+      "migration_id": "20261026T080038-alter_table-alter-table-main-public-film_a",
       "operation_metrics": {
         "num_added_files": 0,
         "num_removed_files": 0,
@@ -195,7 +195,7 @@ Answer (62 lines)
 
 ```json
 {
-  "before_migration": "20261024T203016-batch-add-cary-grant-rate-his-girl-f",
+  "before_migration": "20261026T080038-batch-add-cary-grant-rate-his-girl-f",
   "dry_run": true
 }
 ```
@@ -209,7 +209,7 @@ Answer:
   "dry_run": true,
   "planned_deletes": ["datanotes/main/public/actor/Cary Grant.md"],
   "planned_texts": ["datanotes/main/public/film/His Girl Friday.md"],
-  "restored_to": "2026-10-24T20:30:16.619Z",
+  "restored_to": "2026-10-26T08:00:38.515Z",
   "tables": [
     {
       "table": "main.public.actor",
@@ -245,7 +245,7 @@ Answer:
 **`restore_database`**
 
 ```json
-{ "before_migration": "20261024T203016-batch-add-cary-grant-rate-his-girl-f" }
+{ "before_migration": "20261026T080038-batch-add-cary-grant-rate-his-girl-f" }
 ```
 
 Answer:
@@ -253,8 +253,8 @@ Answer:
 ```json
 {
   "ok": true,
-  "migration_id": "20261024T203016-restore_database-restore-database-to-before-202",
-  "restored_to": "2026-10-24T20:30:16.619Z",
+  "migration_id": "20261026T080038-restore_database-restore-database-to-before-202",
+  "restored_to": "2026-10-26T08:00:38.515Z",
   "tables": ["main.public.actor: restore", "main.public.film: restore"]
 }
 ```
@@ -287,13 +287,13 @@ A `timestamp` names the moment by its time, as it does for a table. `restored_to
 **`undo_migration`**
 
 ```json
-{ "migration_id": "20261024T203016-restore_database-restore-database-to-before-202" }
+{ "migration_id": "20261026T080038-restore_database-restore-database-to-before-202" }
 ```
 
 **`restore_database`**
 
 ```json
-{ "timestamp": "2026-10-24T20:30:16.619Z", "dry_run": true }
+{ "timestamp": "2026-10-26T08:00:38.515Z", "dry_run": true }
 ```
 
 Answer:
@@ -320,7 +320,7 @@ Time travel reads several tables the same way. `select_rows` with `timestamp` on
 **`select_rows`**
 
 ```json
-{ "table": "actor", "columns": ["name"], "timestamp": "2026-10-24T20:30:16.619Z" }
+{ "table": "actor", "columns": ["name"], "timestamp": "2026-10-26T08:00:38.515Z" }
 ```
 
 Answer:
@@ -336,6 +336,6 @@ Answer:
     }
   ],
   "version": 1,
-  "timestamp": "2026-10-24T20:30:16.587Z"
+  "timestamp": "2026-10-26T08:00:38.487Z"
 }
 ```

package/dist/docs/guides/history/table-history.md

@@ -26,7 +26,7 @@ Answer:
   "op": "alter_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 1, "operation": "ALTER TABLE" }],
-  "migration_id": "20261024T203007-alter_table-alter-table-main-public-film"
+  "migration_id": "20261026T080029-alter_table-alter-table-main-public-film"
 }
 ```
 
@@ -88,10 +88,10 @@ Answer (110 lines)
   "history": [
     {
       "version": 6,
-      "timestamp": "2026-10-24T20:30:07.985Z",
+      "timestamp": "2026-10-26T08:00:29.887Z",
       "operation": "DELETE",
       "operation_parameters": { "summary": "archive 1 rows of film" },
-      "migration_id": "20261024T203007-delete_rows-archive-1-rows-of-film",
+      "migration_id": "20261026T080029-delete_rows-archive-1-rows-of-film",
       "operation_metrics": {
         "num_added_files": 0,
         "num_removed_files": 1,
@@ -103,10 +103,10 @@ Answer (110 lines)
     },
     {
       "version": 5,
-      "timestamp": "2026-10-24T20:30:07.980Z",
+      "timestamp": "2026-10-26T08:00:29.883Z",
       "operation": "UPDATE",
       "operation_parameters": { "summary": "update film" },
-      "migration_id": "20261024T203007-update_row-update-film-2",
+      "migration_id": "20261026T080029-update_row-update-film-2",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 1,
@@ -118,10 +118,10 @@ Answer (110 lines)
     },
     {
       "version": 4,
-      "timestamp": "2026-10-24T20:30:07.974Z",
+      "timestamp": "2026-10-26T08:00:29.877Z",
       "operation": "UPDATE",
       "operation_parameters": { "summary": "update film" },
-      "migration_id": "20261024T203007-update_row-update-film",
+      "migration_id": "20261026T080029-update_row-update-film",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 1,
@@ -133,10 +133,10 @@ Answer (110 lines)
     },
     {
       "version": 3,
-      "timestamp": "2026-10-24T20:30:07.968Z",
+      "timestamp": "2026-10-26T08:00:29.872Z",
       "operation": "WRITE",
       "operation_parameters": { "summary": "insert into film" },
-      "migration_id": "20261024T203007-insert_row-insert-into-film-2",
+      "migration_id": "20261026T080029-insert_row-insert-into-film-2",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 0,
@@ -148,10 +148,10 @@ Answer (110 lines)
     },
     {
       "version": 2,
-      "timestamp": "2026-10-24T20:30:07.963Z",
+      "timestamp": "2026-10-26T08:00:29.867Z",
       "operation": "WRITE",
       "operation_parameters": { "summary": "insert into film" },
-      "migration_id": "20261024T203007-insert_row-insert-into-film",
+      "migration_id": "20261026T080029-insert_row-insert-into-film",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 0,
@@ -163,10 +163,10 @@ Answer (110 lines)
     },
     {
       "version": 1,
-      "timestamp": "2026-10-24T20:30:07.957Z",
+      "timestamp": "2026-10-26T08:00:29.861Z",
       "operation": "ALTER TABLE",
       "operation_parameters": { "summary": "alter table main.public.film" },
-      "migration_id": "20261024T203007-alter_table-alter-table-main-public-film",
+      "migration_id": "20261026T080029-alter_table-alter-table-main-public-film",
       "operation_metrics": {
         "num_added_files": 0,
         "num_removed_files": 0,
@@ -178,10 +178,10 @@ Answer (110 lines)
     },
     {
       "version": 0,
-      "timestamp": "2026-10-24T20:30:07.949Z",
+      "timestamp": "2026-10-26T08:00:29.854Z",
       "operation": "CREATE TABLE",
       "operation_parameters": { "summary": "create table main.public.film" },
-      "migration_id": "20261024T203007-create_table-create-table-main-public-film",
+      "migration_id": "20261026T080029-create_table-create-table-main-public-film",
       "operation_metrics": {
         "num_added_files": 0,
         "num_removed_files": 0,
@@ -226,7 +226,7 @@ Answer:
     }
   ],
   "version": 5,
-  "timestamp": "2026-10-24T20:30:07.980Z"
+  "timestamp": "2026-10-26T08:00:29.883Z"
 }
 ```
 
@@ -253,7 +253,7 @@ Answer:
   ],
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film_before", "version": 0, "operation": "CLONE" }],
-  "migration_id": "20261024T203007-clone_table-clone-main-public-film-to-main"
+  "migration_id": "20261026T080029-clone_table-clone-main-public-film-to-main"
 }
 ```
 
@@ -294,7 +294,7 @@ This call names the same moment by its time, taken from the history read above:
 {
   "source": "film",
   "target": "film_at",
-  "timestamp": "2026-10-24T20:30:07.980Z",
+  "timestamp": "2026-10-26T08:00:29.883Z",
   "copy_rows": false
 }
 ```
@@ -316,33 +316,33 @@ Answer:
   "table": "main.public.film",
   "changes": [
     {
-      "id": "01a16f9b-405d-7aaf-ab22-456fd2aac4a3",
+      "id": "01a17739-a8ae-7191-9e89-6fa2849760d6",
       "title": "Metropolis",
       "status": "to watch",
       "path": "datanotes/main/public/film/Metropolis.md",
       "_change_type": "update_preimage",
       "_commit_version": 5,
-      "_commit_timestamp": "2026-10-24T20:30:07.980Z",
+      "_commit_timestamp": "2026-10-26T08:00:29.883Z",
       "_operation": "UPDATE"
     },
     {
-      "id": "01a16f9b-405d-7aaf-ab22-456fd2aac4a3",
+      "id": "01a17739-a8ae-7191-9e89-6fa2849760d6",
       "title": "Metropolis",
       "status": "watched",
       "path": "datanotes/main/public/film/Metropolis.md",
       "_change_type": "update_postimage",
       "_commit_version": 5,
-      "_commit_timestamp": "2026-10-24T20:30:07.980Z",
+      "_commit_timestamp": "2026-10-26T08:00:29.883Z",
       "_operation": "UPDATE"
     },
     {
-      "id": "01a16f9b-405d-7aaf-ab22-456fd2aac4a3",
+      "id": "01a17739-a8ae-7191-9e89-6fa2849760d6",
       "title": "Metropolis",
       "status": "watched",
       "path": "datanotes/main/public/film/Metropolis.md",
       "_change_type": "delete",
       "_commit_version": 6,
-      "_commit_timestamp": "2026-10-24T20:30:07.985Z",
+      "_commit_timestamp": "2026-10-26T08:00:29.887Z",
       "_operation": "DELETE"
     }
   ]
@@ -358,7 +358,7 @@ You edit `datanotes/main/public/film/Nosferatu.md` by hand, outside the engine.
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-4058-770d-b680-c42d54aa70b5
+id: 01a17739-a8a8-7c04-b68f-ef9cfd870c1c
 title: Nosferatu
 status: watched
 rating: 5
@@ -380,7 +380,7 @@ Answer:
   "history": [
     {
       "version": 8,
-      "timestamp": "2026-10-24T20:30:11.042Z",
+      "timestamp": "2026-10-26T08:00:32.947Z",
       "operation": "EXTERNAL_EDIT",
       "operation_metrics": {
         "num_added_files": 1,
@@ -392,10 +392,10 @@ Answer:
     },
     {
       "version": 7,
-      "timestamp": "2026-10-24T20:30:08.030Z",
+      "timestamp": "2026-10-26T08:00:29.930Z",
       "operation": "RESTORE",
       "operation_parameters": { "summary": "restore main.public.film to version 5" },
-      "migration_id": "20261024T203008-restore_table-restore-main-public-film-to-ve",
+      "migration_id": "20261026T080029-restore_table-restore-main-public-film-to-ve",
       "operation_metrics": {
         "num_added_files": 1,
         "num_removed_files": 0,
@@ -488,7 +488,7 @@ Answer:
   "ok": true,
   "op": "alter_table",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261024T203016-alter_table-alter-table-main-public-film_b"
+  "migration_id": "20261026T080038-alter_table-alter-table-main-public-film_b"
 }
 ```
 
@@ -508,7 +508,7 @@ Answer:
   "commits": [
     { "table": "main.public.film_at", "version": 1, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261024T203016-alter_table-alter-table-main-public-film_a"
+  "migration_id": "20261026T080038-alter_table-alter-table-main-public-film_a"
 }
 ```
 
@@ -520,7 +520,7 @@ History is a setting of the definition. `alter_table` writes `history: true` und
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a16f9b-4040-771c-b045-98bd6e029afc
+id: 01a17739-a891-7abe-913f-b581e7bbc13d
 config:
   history: true
 

package/dist/docs/guides/read-and-write/automatic-links.md

@@ -98,7 +98,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Charade.md"],
   "commits": [{ "table": "main.public.film", "version": 2, "operation": "WRITE" }],
-  "migration_id": "20261024T202959-insert_row-insert-into-film-2",
+  "migration_id": "20261026T080021-insert_row-insert-into-film-2",
   "links_added": [
     {
       "path": "datanotes/main/public/film/Charade.md",
@@ -127,7 +127,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-2099-7cc4-bfeb-adfcde120524
+id: 01a17739-8913-7b8a-b0e6-f32c508db62d
 title: Charade
 year: 1963
 ---
@@ -169,7 +169,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 3, "operation": "UPDATE" }],
-  "migration_id": "20261024T202959-update_row-update-film",
+  "migration_id": "20261026T080021-update_row-update-film",
   "links_added": [
     {
       "path": "datanotes/main/public/film/Charade.md",
@@ -186,7 +186,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-2099-7cc4-bfeb-adfcde120524
+id: 01a17739-8913-7b8a-b0e6-f32c508db62d
 title: Charade
 year: 1963
 ---
@@ -229,7 +229,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 4, "operation": "UPDATE" }],
-  "migration_id": "20261024T202959-update_row-update-film-2",
+  "migration_id": "20261026T080021-update_row-update-film-2",
   "links_added": [
     {
       "path": "datanotes/main/public/film/Notorious.md",
@@ -287,7 +287,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 5, "operation": "UPDATE" }],
-  "migration_id": "20261024T202959-update_row-update-film-3",
+  "migration_id": "20261026T080021-update_row-update-film-3",
   "links_added": [
     {
       "path": "datanotes/main/public/film/Notorious.md",
@@ -310,7 +310,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-2091-7abd-9f22-09214d647b3f
+id: 01a17739-890d-7feb-bfda-9245be4562ec
 title: Notorious
 year: 1946
 ---
@@ -373,7 +373,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Persona.md"],
   "commits": [{ "table": "main.public.film", "version": 6, "operation": "WRITE" }],
-  "migration_id": "20261024T202959-insert_row-insert-into-film-3",
+  "migration_id": "20261026T080021-insert_row-insert-into-film-3",
   "links_added": [
     {
       "path": "datanotes/main/public/film/Persona.md",
@@ -390,7 +390,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-20d0-750f-bf77-31658c94caa8
+id: 01a17739-8941-7383-bc96-3f3943794958
 title: Persona
 year: 1966
 ---
@@ -472,7 +472,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 7, "operation": "UPDATE" }],
-  "migration_id": "20261024T202959-update_row-update-film-4",
+  "migration_id": "20261026T080021-update_row-update-film-4",
   "links_added": [
     {
       "path": "datanotes/main/public/film/Persona.md",
@@ -489,7 +489,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-20d0-750f-bf77-31658c94caa8
+id: 01a17739-8941-7383-bc96-3f3943794958
 title: Persona
 year: 1966
 ---
@@ -505,7 +505,7 @@ We watched it at [[2026-10-09T2100|Swedish night]].
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a16f9b-2053-7df2-98ef-798c89e9b934
+id: 01a17739-88e8-77a8-8139-03d80daa0f49
 config:
   history: true
 
@@ -620,7 +620,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/His Girl Friday.md"],
   "commits": [{ "table": "main.public.film", "version": 8, "operation": "WRITE" }],
-  "migration_id": "20261024T202959-insert_row-insert-into-film-4"
+  "migration_id": "20261026T080021-insert_row-insert-into-film-4"
 }
 ```
 
@@ -629,7 +629,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-20fc-7732-8ba2-92c1f840915a
+id: 01a17739-8968-782c-82f2-07473c45926d
 title: His Girl Friday
 year: 1940
 ---
@@ -663,7 +663,7 @@ Answer:
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a16f9b-2053-7df2-98ef-798c89e9b934
+id: 01a17739-88e8-77a8-8139-03d80daa0f49
 config:
   history: true
   autolink: false