datanotes 3.4.0 → 3.4.2

package/dist/docs/administration/extensions.md

@@ -89,7 +89,7 @@ Five options carry your choices. They apply to `install` and, except the last tw
 | `--catalog` | Sets the catalog of created tables and views.           | `--catalog work`                                        |
 | `--schema`  | Sets the schema of created owned tables and views.      | `--schema reading`                                      |
 
-Each option takes a comma-separated list. `--map role=catalog.schema.table` binds a table. `--map role.column=column` maps a column. A column of the extension’s own table keeps the extension’s name: you cannot map it.
+Each option takes a comma-separated list. `--map role=catalog.schema.table` binds a table. `--map role.column=column` maps a column of a table the extension depends on. The views, CHECKs and link filters of the extension then read your column, through links too. A column of the extension’s own table keeps the extension’s name: you cannot map it.
 
 The plan ends with a message for the AI agent that runs the install:
 
@@ -101,6 +101,7 @@ An agent never guesses. It shows the plan, asks the user, and runs the command a
 * `ambiguous_dependency`: several tables could be the role. Pass `--map` or `--create`.
 * `missing_column`: the matched table lacks a column. Map another column, or add it with `--add`.
 * `column_differs`: a column exists with another type or rule. Map another column or table.
+* `column_map_unsupported`: the extension names a mapped column where the installer cannot rewrite it, such as the outer clauses of a `union` view. Rename your column to the extension’s name and leave the mapping out.
 * `table_exists`: a table the extension would create exists already. Use it with `--map`, or pick another catalog.
 * `tool_name_taken`: a tool name is already an operation or a tool of another extension.
 * `token_exists`: a token named `ext-<name>` exists already.

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

@@ -19,6 +19,7 @@
 | 200 | Done. | `object` (application/json) |
 | 400 | Bad input: the body is not a JSON object, or an argument is unknown, missing or of the wrong type. | `Error` (application/json) |
 | 401 | Missing or wrong bearer token. | `Error` (application/json) |
+| 403 | The `session` belongs to another named token: the first token to report a session owns it (compared on its first 16 characters), and only that token and the owner may report it again. Nothing is stored. | `Error` (application/json) |
 | 500 | Unexpected error. | `Error` (application/json) |
 
 The schemas named here are in [openapi.json](https://datanotes.dev/openapi.json) (`components.schemas`).

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

@@ -32,6 +32,7 @@
 | 200 | Done. | `object` (application/json) |
 | 400 | Bad input: the body is not a JSON object, or an argument is unknown, missing or of the wrong type. | `Error` (application/json) |
 | 401 | Missing or wrong bearer token. | `Error` (application/json) |
+| 403 | The `session` belongs to another named token: the first token to report a session owns it (compared on its first 16 characters), and only that token and the owner may report it again. Nothing is stored. | `Error` (application/json) |
 | 500 | Unexpected error. | `Error` (application/json) |
 
 The schemas named here are in [openapi.json](https://datanotes.dev/openapi.json) (`components.schemas`).

package/dist/docs/api.md

@@ -1,6 +1,6 @@
 # Datanotes HTTP API
 
-> OpenAPI 3.1.0 description of the Datanotes 3.4.0 HTTP API: https://datanotes.dev/openapi.json
+> OpenAPI 3.1.0 description of the Datanotes 3.4.2 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/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": "20261024T063921-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": "20261024T063921-insert_row-insert-into-film"
+  "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": "20261024T063921-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": "20261024T063906-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": "20261024T063906-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": "20261024T063906-insert_row-insert-into-genre",
+      "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": "20261024T063906-insert_row-insert-into-genre"
+        "migration_id": "20261024T202953-insert_row-insert-into-genre-4"
       }
     },
     {
       "index": 1,
       "op": "insert_row",
       "ok": true,
-      "migration_id": "20261024T063906-insert_row-insert-into-genre-2",
+      "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": "20261024T063906-insert_row-insert-into-genre-2"
+        "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": "20261024T063906-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: 01a16ca2-6b55-78e6-a355-a9890248c59d
+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": "20261024T063907-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: 01a16ca2-6327-778b-85f9-d586c0c733a8
+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": "20261024T063905-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: 01a16ca2-ca05-74ee-97ba-2dcfcbb41703
+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: 01a16ca2-8b18-71f0-92e4-4e2492953fa5
+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: 01a16ca2-719a-7e26-8d8b-e4471d2b154f
+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: 01a16ca2-719a-7e26-8d8b-e4471d2b154f
+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": "20261024T063920-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": "20261024T063920-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": "01a16ca2-a55f-7ea9-a62e-541b9f025578",
+      "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": "01a16ca2-a508-7d01-9bb0-9773a3a6a511",
+      "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": "20261024T063920-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": "20261024T063920-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": "20261024T063920-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": "20261024T063920-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": "20261024T063921-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": "20261024T063921-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": "20261024T063921-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": "20261024T063920-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": "20261024T063920-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": "20261024T063920-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": "20261024T063920-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": "20261024T063920-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: 01a16ca2-a4fb-7845-9268-3bc0a21e629e
+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": "20261024T063920-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": "20261024T063920-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": "20261024T063920-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: 01a16ca2-a4fb-7845-9268-3bc0a21e629e
+id: 01a16f9b-3cc4-71df-bae2-5ff053a1ba0d
 config:
   history: true
   default_catalog: diary