datanotes 3.4.1 → 3.4.2

package/dist/docs/develop/write-an-extension.md

@@ -197,11 +197,17 @@ The installer compares the manifest with a table it adopts or matches:
 * Instructions that differ are replaced, and the plan shows it.
 * Tags are added. Nothing is migrated again.
 
-Version 1 has three limits:
+Users may bind the columns of a dependency to theirs with `--map role.column=column`. Write the manifest and the tools so that a mapping works:
+
+* Read and write every dependency column through `ctx.column(role, column)`, never by its manifest name.
+* Name dependency columns in view queries, CHECKs, `ref_where` and `ref_by` freely. The installer rewrites them to the user’s columns, through links too, such as `author.name`.
+* Expect the rows of your views to carry the user’s names. A view with the column `author.name` returns `author.full_name` once `name` is mapped to `full_name`. Aggregate names, such as `n` in `{"n": "count"}`, stay as you wrote them.
+* Keep dependency columns out of the outer clauses of a `union` view and out of migrations. The installer does not rewrite them there: it refuses the mapping with `column_map_unsupported`, or the migration with `migration_conflict`.
+
+Version 1 has two limits:
 
 * A manifest cannot declare an `inverse` across two tables. Only `ref: "self"` takes `inverse`.
 * The columns of the extension’s own tables keep the manifest’s names. Users map only dependency columns.
-* A dotted key into a dependency, such as `project.kind`, is not mapped in CHECKs and view queries.
 
 ## Write the tools
 

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": "20261024T081203-add_constraint-add-constraint-rated_when_watc"
+  "migration_id": "20261024T203007-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": "20261024T081203-insert_row-insert-into-film-2"
+  "migration_id": "20261024T203007-insert_row-insert-into-film-2"
 }
 ```
 
@@ -108,7 +108,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 11, "operation": "DROP CONSTRAINT" }
   ],
-  "migration_id": "20261024T081203-drop_constraint-drop-constraint-at_most_three_"
+  "migration_id": "20261024T203007-drop_constraint-drop-constraint-at_most_three_"
 }
 ```
 
@@ -149,7 +149,7 @@ Answer:
   "commits": [
     { "table": "main.public.genre", "version": 4, "operation": "ADD CONSTRAINT" }
   ],
-  "migration_id": "20261024T081149-add_constraint-add-constraint-parent_by_level"
+  "migration_id": "20261024T202953-add_constraint-add-constraint-parent_by_level"
 }
 ```
 
@@ -228,34 +228,34 @@ Answer:
   "ok": true,
   "op": "batch",
   "dry_run": false,
-  "migration_id": "20261024T081149-batch-add-the-silent-era-and-slapsti",
+  "migration_id": "20261024T202953-batch-add-the-silent-era-and-slapsti",
   "steps": [
     {
       "index": 0,
       "op": "insert_row",
       "ok": true,
-      "migration_id": "20261024T081149-insert_row-insert-into-genre-4",
+      "migration_id": "20261024T202953-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": "20261024T081149-insert_row-insert-into-genre-4"
+        "migration_id": "20261024T202953-insert_row-insert-into-genre-4"
       }
     },
     {
       "index": 1,
       "op": "insert_row",
       "ok": true,
-      "migration_id": "20261024T081149-insert_row-insert-into-genre-5",
+      "migration_id": "20261024T202953-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": "20261024T081149-insert_row-insert-into-genre-5"
+        "migration_id": "20261024T202953-insert_row-insert-into-genre-5"
       }
     }
   ]
@@ -343,7 +343,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.genre", "version": 7, "operation": "UPDATE" }],
-  "migration_id": "20261024T081149-update_row-update-genre"
+  "migration_id": "20261024T202953-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: 01a16cf7-4fdb-728b-a68f-7e167b3b5a58
+id: 01a16f9b-0740-7fa5-ae2e-145d4c576f7e
 name: Silent film
 kind: cinema
 parent: "[[Cinema]]"
@@ -152,7 +152,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.genre", "version": 9, "operation": "UPDATE" }],
-  "migration_id": "20261024T081151-update_row-update-genre"
+  "migration_id": "20261024T202954-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: 01a16cf7-481b-7d97-bd70-f521486d2c67
+id: 01a16f9a-ff01-7b92-9acf-50a3143b1b45
 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": "20261024T081149-recompute_columns-recompute-id-day-label-of-watc"
+  "migration_id": "20261024T202952-recompute_columns-recompute-id-day-label-of-watc"
 }
 ```
 
@@ -292,7 +292,7 @@ Answer:
 ```markdown
 ---
 table: main.public.watch
-id: 01a16cf7-adee-720a-ad18-7e59d48b411b
+id: 01a16f9b-62b9-764f-b98d-1308d3c47a9a
 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: 01a16cf7-6b1e-7e74-9fb2-5f094a71a39f
+id: 01a16f9b-2314-790b-b772-e40f5d94e4b1
 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: 01a16cf7-5643-7af3-888a-fbbab87f32ae
+id: 01a16f9b-0dcd-7c7b-8fad-290e6d566045
 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: 01a16cf7-5643-7af3-888a-fbbab87f32ae
+id: 01a16f9b-0dcd-7c7b-8fad-290e6d566045
 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": "20261024T081203-define_base-create-base-entry"
+  "migration_id": "20261024T203007-define_base-create-base-entry"
 }
 ```
 
@@ -50,7 +50,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 6, "operation": "SET TABLE BASES" }
   ],
-  "migration_id": "20261024T081203-set_table_bases-diary-classics-film-extends-en"
+  "migration_id": "20261024T203007-set_table_bases-diary-classics-film-extends-en"
 }
 ```
 
@@ -118,14 +118,14 @@ Answer:
   "rows": [
     {
       "path": "datanotes/diary/classics/actors/Max Schreck.md",
-      "id": "01a16cf7-863f-7e8b-a6ba-88298d804353",
+      "id": "01a16f9b-3d4b-78f5-93b7-bda800e0af7a",
       "added_on": "2026-10-05",
       "note": "The face of Nosferatu",
       "_source": "diary.classics.actors"
     },
     {
       "path": "datanotes/diary/classics/film/Nosferatu.md",
-      "id": "01a16cf7-85ca-7d5a-8952-a21fee1584a0",
+      "id": "01a16f9b-3cd4-7c7c-8afd-8b443206a372",
       "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": "20261024T081203-define_base-alter-base-entry"
+  "migration_id": "20261024T203007-define_base-alter-base-entry"
 }
 ```
 
@@ -246,7 +246,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.actors", "version": 4, "operation": "DEFINE BASE" }
   ],
-  "migration_id": "20261024T081203-define_base-alter-base-entry-2"
+  "migration_id": "20261024T203007-define_base-alter-base-entry-2"
 }
 ```
 
@@ -280,7 +280,7 @@ Answer:
   "ok": true,
   "op": "define_base",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261024T081203-define_base-create-base-credited"
+  "migration_id": "20261024T203007-define_base-create-base-credited"
 }
 ```
 
@@ -300,7 +300,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.actors", "version": 5, "operation": "SET TABLE BASES" }
   ],
-  "migration_id": "20261024T081203-set_table_bases-diary-classics-actors-extends--2"
+  "migration_id": "20261024T203007-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": "20261024T081203-define_base-create-base-tree"
+  "migration_id": "20261024T203007-define_base-create-base-tree"
 }
 ```
 
@@ -369,7 +369,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.genre", "version": 1, "operation": "SET TABLE BASES" }
   ],
-  "migration_id": "20261024T081203-set_table_bases-diary-classics-genre-extends-t"
+  "migration_id": "20261024T203007-set_table_bases-diary-classics-genre-extends-t"
 }
 ```
 
@@ -475,6 +475,6 @@ Answer:
       "operation": "SET TABLE BASES"
     }
   ],
-  "migration_id": "20261024T081203-set_table_bases-diary-classics-genre_draft-ext"
+  "migration_id": "20261024T203007-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": "20261024T081203-create_table-create-table-diary-classics-fi"
+  "migration_id": "20261024T203007-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": "20261024T081203-insert_row-insert-into-film"
+  "migration_id": "20261024T203007-insert_row-insert-into-film"
 }
 ```
 
@@ -127,7 +127,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 3, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261024T081203-alter_table-alter-table-diary-classics-fil-2"
+  "migration_id": "20261024T203007-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": "20261024T081203-comment_on-comment-on-catalog-diary"
+  "migration_id": "20261024T203007-comment_on-comment-on-catalog-diary"
 }
 ```
 
@@ -165,7 +165,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261024T081203-comment_on-comment-on-schema-diary-classi"
+  "migration_id": "20261024T203007-comment_on-comment-on-schema-diary-classi"
 }
 ```
 
@@ -173,7 +173,7 @@ Answer:
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a16cf7-85ba-7448-adb2-79a7636a1226
+id: 01a16f9b-3cc4-71df-bae2-5ff053a1ba0d
 config:
   history: true
 
@@ -270,7 +270,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 4, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261024T081203-alter_table-alter-table-diary-classics-fil-3"
+  "migration_id": "20261024T203007-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": "20261024T081203-comment_on-remove-the-comment-on-schema-d"
+  "migration_id": "20261024T203007-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": "20261024T081203-alter_table-alter-table-diary-classics-fil-4"
+  "migration_id": "20261024T203007-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: 01a16cf7-85ba-7448-adb2-79a7636a1226
+id: 01a16f9b-3cc4-71df-bae2-5ff053a1ba0d
 config:
   history: true
   default_catalog: diary