datanotes 3.3.0 → 3.3.1

package/dist/docs/api/operations/alter_table.md

@@ -14,9 +14,10 @@ labels merged into the table's, e.g. `{"domain": "health"}`; a `null` value remo
 `null` value removes one). Rows, archive and transaction log follow; links are updated; renamed
 rows keep their old name in `aliases`. A change of metadata only (tags, description, aliases,
 history, autolink_target, row_template, instructions, fields) rewrites the table entry alone: no row is moved or rewritten. Refused
-when a row cannot fill a pattern. Renaming or moving the table is refused while a CHECK that follows
-links, or a `ref_where` / `ref_by`, of another table reads it through a link (link targets are not
-rewritten): the conflicts name them. Use `dry_run` to see `planned_moves`; undo with undo_migration.
+when a row cannot fill a pattern. Renaming or moving the table rewrites what names it in other
+definitions: the `ref` and `vocabulary` of the columns of other tables and bases (lists of links
+included) and the tables of views (`table`, `union[].table`, `join.table`); `schema_references`
+lists them. CHECKs and `ref_where` / `ref_by` that read it through a link follow the new `ref`. Use `dry_run` to see `planned_moves`; undo with undo_migration.
 
 The schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).
 

package/dist/docs/api.md

@@ -1,6 +1,6 @@
 # Datanotes HTTP API
 
-> OpenAPI 3.1.0 description of the Datanotes 3.3.0 HTTP API: https://datanotes.dev/openapi.json
+> OpenAPI 3.1.0 description of the Datanotes 3.3.1 HTTP API: https://datanotes.dev/openapi.json
 
 Database of Markdown notes: tables of notes, rows, queries, history, a change feed and the vault's notes.
 

package/dist/docs/guides/data-quality/check-constraints.md

@@ -29,7 +29,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 8, "operation": "ADD CONSTRAINT" }
   ],
-  "migration_id": "20261020T173845-add_constraint-add-constraint-rated_when_watc"
+  "migration_id": "20261024T053837-add_constraint-add-constraint-rated_when_watc"
 }
 ```
 
@@ -86,7 +86,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/diary/classics/film/His Girl Friday.md"],
   "commits": [{ "table": "diary.classics.film", "version": 10, "operation": "WRITE" }],
-  "migration_id": "20261020T173845-insert_row-insert-into-film"
+  "migration_id": "20261024T053837-insert_row-insert-into-film-2"
 }
 ```
 
@@ -108,7 +108,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 11, "operation": "DROP CONSTRAINT" }
   ],
-  "migration_id": "20261020T173845-drop_constraint-drop-constraint-at_most_three_"
+  "migration_id": "20261024T053837-drop_constraint-drop-constraint-at_most_three_"
 }
 ```
 
@@ -149,7 +149,7 @@ Answer:
   "commits": [
     { "table": "main.public.genre", "version": 4, "operation": "ADD CONSTRAINT" }
   ],
-  "migration_id": "20261020T173831-add_constraint-add-constraint-parent_by_level"
+  "migration_id": "20261024T053821-add_constraint-add-constraint-parent_by_level"
 }
 ```
 
@@ -228,34 +228,34 @@ Answer:
   "ok": true,
   "op": "batch",
   "dry_run": false,
-  "migration_id": "20261020T173831-batch-add-the-silent-era-and-slapsti",
+  "migration_id": "20261024T053821-batch-add-the-silent-era-and-slapsti",
   "steps": [
     {
       "index": 0,
       "op": "insert_row",
       "ok": true,
-      "migration_id": "20261020T173831-insert_row-insert-into-genre-4",
+      "migration_id": "20261024T053821-insert_row-insert-into-genre-4",
       "result": {
         "ok": true,
         "op": "insert_row",
         "files_created": 1,
         "planned_creates": ["datanotes/main/public/genre/Silent cinema.md"],
         "commits": [{ "table": "main.public.genre", "version": 5, "operation": "WRITE" }],
-        "migration_id": "20261020T173831-insert_row-insert-into-genre-4"
+        "migration_id": "20261024T053821-insert_row-insert-into-genre-4"
       }
     },
     {
       "index": 1,
       "op": "insert_row",
       "ok": true,
-      "migration_id": "20261020T173831-insert_row-insert-into-genre-5",
+      "migration_id": "20261024T053821-insert_row-insert-into-genre-5",
       "result": {
         "ok": true,
         "op": "insert_row",
         "files_created": 1,
         "planned_creates": ["datanotes/main/public/genre/Slapstick comedy.md"],
         "commits": [{ "table": "main.public.genre", "version": 6, "operation": "WRITE" }],
-        "migration_id": "20261020T173831-insert_row-insert-into-genre-5"
+        "migration_id": "20261024T053821-insert_row-insert-into-genre-5"
       }
     }
   ]
@@ -343,7 +343,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.genre", "version": 7, "operation": "UPDATE" }],
-  "migration_id": "20261020T173831-update_row-update-genre"
+  "migration_id": "20261024T053821-update_row-update-genre"
 }
 ```
 

package/dist/docs/guides/data-quality/hand-edits.md

@@ -35,7 +35,7 @@ You edit `datanotes/main/public/genre/Silent film.md` by hand, outside the engin
 ```markdown
 ---
 table: main.public.genre
-id: 01a15a64-b310-70dd-a3f1-8f7d07ed2729
+id: 01a16c6a-d02a-78b2-b025-40ae0348957b
 name: Silent film
 kind: cinema
 parent: "[[Cinema]]"
@@ -152,7 +152,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.genre", "version": 9, "operation": "UPDATE" }],
-  "migration_id": "20261020T173832-update_row-update-genre"
+  "migration_id": "20261024T053823-update_row-update-genre"
 }
 ```
 
@@ -167,7 +167,7 @@ You edit `datanotes/main/public/watch/2026-10-03T2130.md` by hand, outside the e
 ```markdown
 ---
 table: main.public.watch
-id: 01a15a64-ab35-73d2-a276-9c24d3c889dd
+id: 01a16c6a-c91c-75d4-af58-f40270afa72e
 film: His Girl Friday
 occurred_at: 2026-10-03T21:30
 where: cinema
@@ -226,7 +226,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.watch", "version": 3, "operation": "RECOMPUTE" }],
-  "migration_id": "20261020T173830-recompute_columns-recompute-id-day-label-of-watc"
+  "migration_id": "20261024T053821-recompute_columns-recompute-id-day-label-of-watc"
 }
 ```
 
@@ -292,7 +292,7 @@ Answer:
 ```markdown
 ---
 table: main.public.watch
-id: 01a15a65-0df1-7af6-9ccd-c58c8b5346c0
+id: 01a16c6b-31f3-71ea-805b-9a972bd80279
 occurred_at: 2026-09-25T21:00
 film: "[[Charade]]"
 where: home
@@ -311,7 +311,7 @@ You edit `datanotes/main/public/film/Metropolis.md` by hand, outside the engine.
 ```markdown
 ---
 table: main.public.film
-id: 01a15a64-cea3-776e-b81b-389706767aa1
+id: 01a16c6a-f3db-73dd-9ca7-c1c2c0456765
 year: 1927
 minutes: 153
 status: to watch
@@ -384,7 +384,7 @@ You edit `datanotes/main/public/film/Sherlock Jr..md` by hand, outside the engin
 ```markdown
 ---
 table: main.public.film
-id: 01a15a64-b991-7728-99e2-bf13797d5532
+id: 01a16c6a-d660-7ca7-ab67-0e0e1c2d096a
 title: Sherlock Jr.: the projectionist
 year: 1924
 status: watched
@@ -471,7 +471,7 @@ You edit `datanotes/main/public/film/Sherlock Jr..md` by hand, outside the engin
 ```markdown
 ---
 table: main.public.film
-id: 01a15a64-b991-7728-99e2-bf13797d5532
+id: 01a16c6a-d660-7ca7-ab67-0e0e1c2d096a
 title: "Sherlock Jr.: the projectionist"
 year: 1924
 status: watched

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

@@ -30,7 +30,7 @@ Answer:
   "ok": true,
   "op": "define_base",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261020T173845-define_base-create-base-entry"
+  "migration_id": "20261024T053837-define_base-create-base-entry"
 }
 ```
 
@@ -50,7 +50,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 6, "operation": "SET TABLE BASES" }
   ],
-  "migration_id": "20261020T173845-set_table_bases-diary-classics-film-extends-en"
+  "migration_id": "20261024T053837-set_table_bases-diary-classics-film-extends-en"
 }
 ```
 
@@ -118,14 +118,14 @@ Answer:
   "rows": [
     {
       "path": "datanotes/diary/classics/actors/Max Schreck.md",
-      "id": "01a15a64-e8e3-73eb-9164-1fc8de45795b",
+      "id": "01a16c6b-0dc8-714f-bb09-fc483851af7c",
       "added_on": "2026-10-05",
       "note": "The face of Nosferatu",
       "_source": "diary.classics.actors"
     },
     {
       "path": "datanotes/diary/classics/film/Nosferatu.md",
-      "id": "01a15a64-e863-705a-96ae-42d6c22c878b",
+      "id": "01a16c6b-0d7b-7381-9d5e-8f90a0dcab88",
       "added_on": "2026-10-05",
       "note": null,
       "_source": "diary.classics.film"
@@ -169,7 +169,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.actors", "version": 3, "operation": "DEFINE BASE" }
   ],
-  "migration_id": "20261020T173845-define_base-alter-base-entry"
+  "migration_id": "20261024T053837-define_base-alter-base-entry"
 }
 ```
 
@@ -246,7 +246,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.actors", "version": 4, "operation": "DEFINE BASE" }
   ],
-  "migration_id": "20261020T173845-define_base-alter-base-entry-2"
+  "migration_id": "20261024T053837-define_base-alter-base-entry-2"
 }
 ```
 
@@ -280,7 +280,7 @@ Answer:
   "ok": true,
   "op": "define_base",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261020T173845-define_base-create-base-credited"
+  "migration_id": "20261024T053837-define_base-create-base-credited"
 }
 ```
 
@@ -300,7 +300,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.actors", "version": 5, "operation": "SET TABLE BASES" }
   ],
-  "migration_id": "20261020T173845-set_table_bases-diary-classics-actors-extends--2"
+  "migration_id": "20261024T053837-set_table_bases-diary-classics-actors-extends--2"
 }
 ```
 
@@ -329,7 +329,7 @@ Answer:
   "ok": true,
   "op": "define_base",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261020T173845-define_base-create-base-tree"
+  "migration_id": "20261024T053837-define_base-create-base-tree"
 }
 ```
 
@@ -369,7 +369,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.genre", "version": 1, "operation": "SET TABLE BASES" }
   ],
-  "migration_id": "20261020T173845-set_table_bases-diary-classics-genre-extends-t"
+  "migration_id": "20261024T053837-set_table_bases-diary-classics-genre-extends-t"
 }
 ```
 
@@ -475,6 +475,6 @@ Answer:
       "operation": "SET TABLE BASES"
     }
   ],
-  "migration_id": "20261020T173845-set_table_bases-diary-classics-genre_draft-ext"
+  "migration_id": "20261024T053837-set_table_bases-diary-classics-genre_draft-ext"
 }
 ```

package/dist/docs/guides/database-objects/catalogs-and-schemas.md

@@ -63,7 +63,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 0, "operation": "CREATE TABLE" }
   ],
-  "migration_id": "20261020T173844-create_table-create-table-diary-classics-fi"
+  "migration_id": "20261024T053837-create_table-create-table-diary-classics-fi"
 }
 ```
 
@@ -91,7 +91,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/diary/classics/film/Nosferatu.md"],
   "commits": [{ "table": "diary.classics.film", "version": 1, "operation": "WRITE" }],
-  "migration_id": "20261020T173844-insert_row-insert-into-film"
+  "migration_id": "20261024T053837-insert_row-insert-into-film"
 }
 ```
 
@@ -127,7 +127,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 3, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261020T173844-alter_table-alter-table-diary-classics-fil-2"
+  "migration_id": "20261024T053837-alter_table-alter-table-diary-classics-fil-2"
 }
 ```
 
@@ -144,7 +144,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261020T173844-comment_on-comment-on-catalog-diary"
+  "migration_id": "20261024T053837-comment_on-comment-on-catalog-diary"
 }
 ```
 
@@ -165,7 +165,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261020T173845-comment_on-comment-on-schema-diary-classi"
+  "migration_id": "20261024T053837-comment_on-comment-on-schema-diary-classi"
 }
 ```
 
@@ -173,7 +173,7 @@ Answer:
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a15a64-e851-7907-b148-bbd50adcd745
+id: 01a16c6b-0d6f-702d-bc09-cd959a95f3fe
 config:
   history: true
 
@@ -270,7 +270,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 4, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261020T173845-alter_table-alter-table-diary-classics-fil"
+  "migration_id": "20261024T053837-alter_table-alter-table-diary-classics-fil-3"
 }
 ```
 
@@ -287,7 +287,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261020T173845-comment_on-remove-the-comment-on-schema-d"
+  "migration_id": "20261024T053837-comment_on-remove-the-comment-on-schema-d"
 }
 ```
 
@@ -309,7 +309,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 5, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261020T173845-alter_table-alter-table-diary-classics-fil-2"
+  "migration_id": "20261024T053837-alter_table-alter-table-diary-classics-fil-4"
 }
 ```
 
@@ -593,7 +593,7 @@ This is the database of this page as the engine wrote it. `metastore.yaml` holds
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a15a64-e851-7907-b148-bbd50adcd745
+id: 01a16c6b-0d6f-702d-bc09-cd959a95f3fe
 config:
   history: true
   default_catalog: diary
@@ -667,6 +667,10 @@ catalogs:
                 min: 1
                 max: 5
                 description: My rating, from 1 (poor) to 5 (a masterpiece)
+              - name: lead
+                type: link
+                ref: diary.credits.actor
+                description: The actor in the leading role
           genre:
             description: Eras and genres of cinema, as a tree
             options:
@@ -703,6 +707,14 @@ catalogs:
                 type: string
                 required: true
                 description: The name of the era or genre
+        views:
+          cast_list:
+            description: Every actor, by name
+            query:
+              table: diary.credits.actor
+              columns:
+                - name
+              order_by: name
       credits:
         tables:
           actor:
@@ -819,6 +831,10 @@ catalogs:
                 min: 1
                 max: 5
                 description: My rating, from 1 (poor) to 5 (a masterpiece)
+              - name: lead
+                type: link
+                ref: diary.credits.actor
+                description: The actor in the leading role
           film_empty:
             description: "One note per classic film: what I watched and what I thought"
             aliases:
@@ -875,6 +891,10 @@ catalogs:
                 min: 1
                 max: 5
                 description: My rating, from 1 (poor) to 5 (a masterpiece)
+              - name: lead
+                type: link
+                ref: diary.credits.actor
+                description: The actor in the leading role
 bases:
   entry:
     description: A note of the film diary