datanotes 3.4.1 → 3.5.0

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/administration/git-sync.md

@@ -66,6 +66,23 @@ A pull can also succeed and still leave files in conflict. This happens when the
 
 The next sync commits and pushes again.
 
+## Merge packs row by row
+
+A [pack of rows](https://datanotes.dev/guides/database-objects/packs/) is one note that holds many rows. Two copies that add rows to the same pack would get a conflict from a plain text merge. So git sync registers a merge driver that merges a pack row by row, by `id`. A conflict then stays in the one row changed on both sides.
+
+At each start, git sync writes two things:
+
+* **In the repository’s config**: `merge.datanotes-pack.driver`, the engine’s own `datanotes pack-merge` command.
+* **In `.gitattributes`** at the vault’s root: the line `*.md merge=datanotes-pack`. Git sync commits it with the vault.
+
+The driver merges any note that isn’t a pack as text, as git does. Every copy that pulls should register the driver too. Start its engine with `--git-sync`, or set it by hand:
+
+```bash
+git config merge.datanotes-pack.name "Datanotes packs of rows"
+git config merge.datanotes-pack.driver \
+  "npx -y datanotes pack-merge %O %A %B %P"
+```
+
 ## Keep every copy on the same version
 
 Each copy of the vault that runs an engine reads the notes that git brings in as hand edits: the engine checks them against the tables’ rules and reports what they break on the change feed. Run the same version of Datanotes on every copy, and upgrade them together. The [release notes](https://datanotes.dev/release-notes/) list what each version changes.

package/dist/docs/administration/limits.md

@@ -47,6 +47,35 @@ The first `select_rows` waits until the engine has compared the vault with its i
 * From 10,000 to 50,000 notes, start it before your agents and keep it running
 * Above about 20,000 notes, run it as a service, and give it 2 GB of memory
 
+## Keep fewer files with packs of rows
+
+A table with many small rows, such as a log, can keep the rows of each closed month in one note. [Packs of rows](https://datanotes.dev/guides/database-objects/packs/) explains how. We measured 50,000 rows of one table, from 2014 to 2018, as notes of their own and then in 118 monthly packs. The machine:
+
+* Linux on an Intel Core i7-13700HX, with 32 GB of memory
+* the vault on a RAM disk (`tmpfs`)
+* Node.js 26.12
+
+| Measure                                       | 50,000 notes | 118 packs |
+| --------------------------------------------- | ------------ | --------- |
+| Files in the vault                            | 50,001       | 119       |
+| First start                                   | 2.9 s        | 4.1 s     |
+| Restart                                       | 0.9 s        | 1.3 s     |
+| First `select_rows` after a restart           | 0.72 s       | 0.24 s    |
+| `select_rows` of one month (419 rows)         | 1 ms         | 12 ms     |
+| Memory (resident set size) when idle          | 670 MB       | 671 MB    |
+| Vault index on disk                           | 48 MB        | 46 MB     |
+| `git add` and `git commit` of the whole vault | 684 ms       | 47 ms     |
+| `git status`                                  | 27 ms        | 2.7 ms    |
+
+`pack_rows` packed the 50,000 rows in 35 seconds. A restart reads every pack, but takes the values of a section it read before from the store’s `packs.json`. The first start parses every section, so it takes longer.
+
+To measure on your machine, build the engine and run the benchmark on a folder of its own:
+
+```bash
+npm run build:service
+node bench/scale/packs.mjs --rows 50000 --out /tmp/packs-bench
+```
+
 ## Start faster with the vault index
 
 The engine keeps a vault index in its store, in `index/vault.sqlite`. It records what the engine read from each note: its properties, tags, links and text. It also indexes the words of each note, so `search_notes` reads only the notes that can match. It keeps each text compressed. At the next start, the engine reads only the notes that changed since.

package/dist/docs/administration/use-with-obsidian.md

@@ -41,6 +41,18 @@ A note at the vault’s root is `intro.md`. Operations take and return paths in
 
 With `--database`, paths start from the database folder instead: the same row is `main/public/film/Metropolis.md`. When you open that folder in Obsidian, its root is the vault root, so links resolve there too.
 
+## Follow links into packs of rows
+
+A table with [packs of rows](https://datanotes.dev/guides/database-objects/packs/) keeps the rows of a closed period in one note, one `##` section per row. Obsidian shows each pack as one note. The engine still lists every row at its own path.
+
+A link to a packed row names the pack and the row’s heading:
+
+```markdown
+[[reading 2025-03#2025-03-02T2100]]
+```
+
+Obsidian follows it to the row’s section, and the engine to the row. Inside a row’s text, use headings from `###` down: a `#` or `##` heading would end the row’s section, so such a row stays a note of its own.
+
 ## Move between a vault and a database folder
 
 [`configure_database`](https://datanotes.dev/reference/operations/auxiliary/#configure_database) with `root` moves the database within the folder the engine serves. The move rewrites every link in one operation, as for any [move of the database folder](https://datanotes.dev/start/how-it-works/#move-the-vault-or-the-database-folder).

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

@@ -13,7 +13,10 @@ labels merged into the table's, e.g. `{"domain": "health"}`; a `null` value remo
 `archive` (folder name inside the table folder) or `fields` (untyped fields, name → default; a
 `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
+history, autolink_target, row_template, instructions, fields, pack_after_days) rewrites the table entry alone: no row is moved or rewritten.
+`pack` sets the period of the table's packs of rows (`"{occurred_at:YYYY-MM}"`; "" removes it), `pack_after_days` the days
+after a period's end before its rows go into a pack ("default": 7). While rows are in packs, changing `pack`,
+`partition`, `filename` or the table's name is refused: unpack_rows first. Refused
 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`
@@ -38,6 +41,8 @@ The schema changes only through operations like this one: never edit metastore.y
 | `schema` | `string \| null` | no | `null` |  |
 | `name` | `string \| null` | no | `null` |  |
 | `partition` | `string \| null` | no | `null` |  |
+| `pack` | `string \| null` | no | `null` | Packs of rows: a template of a date column, e.g. "{occurred_at:YYYY-MM}"; "" removes it (only while no row is in a pack). |
+| `pack_after_days` | `integer \| "default" \| null` | no | `null` | Days after the end of a period before its rows go into a pack, or "default" (7). |
 | `filename` | `string \| null` | no | `null` |  |
 | `description` | `string \| null` | no | `null` | The new description: what a row records (it changes, never goes: "" is refused). |
 | `aliases` | `string[] \| null` | no | `null` |  |

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

@@ -24,6 +24,9 @@ digits, `_` (no dots: pass the catalog and the schema as their own arguments).
   description), `partition`, `exclude`, `archive`, `history` (keep its versions; default: the
   database's setting), `autolink_target` (true / false: may automatic links link its rows? default:
   yes, unless its rows are named by a date or a time, as with `time_column`).
+  `pack` (a template of a date column, such as `"{occurred_at:YYYY-MM}"`: once a period is over, one note
+  holds its rows, `##` section by section; select_rows still gives one row each) and `pack_after_days` (default 7):
+  see pack_rows.
 - `row_template`: markdown body of new rows. Shared columns come from bases: `set_table_bases`.
 - `instructions`: how to fill a row, for agents (Markdown); describe_table returns them.
 - `tags`: key/value labels of the table, strings (`{"domain": "health"}`); list_tables and
@@ -55,6 +58,8 @@ The schema changes only through operations like this one: never edit metastore.y
 | `time_column` | `string \| null` | no | `null` |  |
 | `filename` | `string \| null` | no | `null` | File name pattern of the rows, e.g. "{name}" (instead of time_column). |
 | `partition` | `string \| null` | no | `null` | Sub-folder pattern of the rows, e.g. "{occurred_at:YYYY/MM}"; "" = flat. |
+| `pack` | `string \| null` | no | `null` | Packs of rows: a template of a date column, the period of each pack, e.g. "{occurred_at:YYYY-MM}": once a month is over, one note holds its rows (pack_rows, or the engine on its own). Needs the engine service. |
+| `pack_after_days` | `integer \| null` | no | `null` | Days after the end of a period before its rows go into a pack (default 7). |
 | `exclude` | `string[] \| null` | no | `null` | Folders whose notes are never rows of the table (e.g. templates that create them). |
 | `archive` | `string \| null` | no | `null` | Archive folder: a folder name inside the table folder (default: the database's archive_folder). |
 | `aliases` | `string[] \| null` | no | `null` | Other words for what the table records, for agents. |

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

@@ -4,7 +4,7 @@
 
 Describe a table (`catalog.schema.table` or a shorter unambiguous name): `qualified`, `name`,
 `catalog`, `schema`, `description`, `aliases`, `layout` (`folder`, `row_folder`: the folder pattern
-of new rows, `archive`), `options` (`partition`, `filename`, `archive`, `exclude`), typed `columns`
+of new rows, `archive`), `options` (`partition`, `filename`, `archive`, `exclude`, `pack`, `pack_after_days`), typed `columns`
 with label/aliases/description and the dense flag, `untyped_fields`, `row_count`, and when set:
 `tags`, `bases` (the bases it inherits from, in order), `constraints` (its CHECKs, name → where), `constraint_hints` (their own hints, name → hint), `instructions` (how to fill a row: follow them before you write one), `row_template`, `history`,
 `autolink_target`, `fields` (their values).

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

@@ -0,0 +1,45 @@
+# Put the rows of a table's closed periods into packs: one note per period (`<table> <key>.md` in the
+
+`POST /datanotes/operations/pack_rows/` (operation `pack_rows`)
+
+Put the rows of a table's closed periods into packs: one note per period (`<table> <key>.md` in the
+table's folder), a `##` section per row, `key:: value` lines for its values. The table needs a `pack`
+option (create_table / alter_table, e.g. `"{occurred_at:YYYY-MM}"`). A period is closed
+`pack_after_days` days after it ends (default 7); `key` packs only that period.
+Nothing changes for the engine and its readers: select_rows, links, the graph and the change feed
+still see each row at its path, with its values, text and file_modified (no change event, no new
+version). Links from other notes to a packed row become `[[pack#row]]`, which Obsidian follows too.
+A row stays a note of its own (`excluded`, with the reason) when it changed in the last 24 hours, has a
+`#` or `##` heading in its text, is not at the path its values give, or its note is not in the form
+the engine writes. The engine also packs on its own once a day (setting `autoPack`). Needs the engine
+service. Journaled: undo_migration takes the rows out again. Use `dry_run` to see `packs` first.
+
+## Parameters
+
+| Name | In | Type | Required | Description |
+| --- | --- | --- | --- | --- |
+| `X-Datanotes-Actor` | header | `string` | no | JSON: on whose behalf the write is made, recorded in the journal (`harness`, `model`, `session`). |
+
+## Request body
+
+`application/json`, required
+
+| Property | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| `table` | `string` | yes |  |  |
+| `key` | `string \| null` | no | `null` | Only the period of this key (e.g. "2026-10"); every closed period when absent. |
+| `dry_run` | `boolean` | no | `false` |  |
+
+## Responses
+
+| Status | Description | Body |
+| --- | --- | --- |
+| 200 | Done. | `PackRowsResult` (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 | A named token beyond its permissions (the engine's administration, tables outside its `write` patterns, schema changes without `ddl`). | `Error` (application/json) |
+| 404 | Unknown table, view, migration, note or folder. | `Error` (application/json) |
+| 409 | Ambiguous table name: it matches several tables (`paths` or `tables` lists them). | `AmbiguousName` (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/tags/auxiliary.md

@@ -12,3 +12,5 @@ Operations that describe and check the database, configure it and maintain its i
 - [Read-only schema inference from notes' front matter.](https://datanotes.dev/api/operations/infer_table/): `POST /datanotes/operations/infer_table/`
 - [The semantic search index: `enabled`, `provider`, `model`, `files`, `passages`, `pending`,](https://datanotes.dev/api/operations/describe_semantic_index/): `POST /datanotes/operations/describe_semantic_index/`
 - [Bring the semantic search index up to date: embed the notes changed since the last run (the](https://datanotes.dev/api/operations/sync_semantic_index/): `POST /datanotes/operations/sync_semantic_index/`
+- [Put the rows of a table's closed periods into packs: one note per period (`<table> <key>.md` in the](https://datanotes.dev/api/operations/pack_rows/): `POST /datanotes/operations/pack_rows/`
+- [Take rows out of their packs as notes of their own, at their paths, with the text and the modification](https://datanotes.dev/api/operations/unpack_rows/): `POST /datanotes/operations/unpack_rows/`

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

@@ -0,0 +1,40 @@
+# Take rows out of their packs as notes of their own, at their paths, with the text and the modification
+
+`POST /datanotes/operations/unpack_rows/` (operation `unpack_rows`)
+
+Take rows out of their packs as notes of their own, at their paths, with the text and the modification
+time they had (the opposite of pack_rows): every pack of the table, the pack of `key`, or only the
+rows `where` matches (as select_rows filters). A pack left without rows goes. Links `[[pack#row]]`
+from other notes become links to the notes. Needed before alter_table changes the table's `pack`,
+`partition`, `filename` or name. Silent for the rows, journaled (undo_migration packs them again).
+
+## Parameters
+
+| Name | In | Type | Required | Description |
+| --- | --- | --- | --- | --- |
+| `X-Datanotes-Actor` | header | `string` | no | JSON: on whose behalf the write is made, recorded in the journal (`harness`, `model`, `session`). |
+
+## Request body
+
+`application/json`, required
+
+| Property | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| `table` | `string` | yes |  |  |
+| `key` | `string \| null` | no | `null` | Only the pack of this key (e.g. "2026-10"). |
+| `where` | `object \| null` | no | `null` | Only the rows that match, as select_rows' where. |
+| `dry_run` | `boolean` | no | `false` |  |
+
+## Responses
+
+| Status | Description | Body |
+| --- | --- | --- |
+| 200 | Done. | `PackRowsResult` (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 | A named token beyond its permissions (the engine's administration, tables outside its `write` patterns, schema changes without `ddl`). | `Error` (application/json) |
+| 404 | Unknown table, view, migration, note or folder. | `Error` (application/json) |
+| 409 | Ambiguous table name: it matches several tables (`paths` or `tables` lists them). | `AmbiguousName` (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.1 HTTP API: https://datanotes.dev/openapi.json
+> OpenAPI 3.1.0 description of the Datanotes 3.5.0 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.
 
@@ -101,6 +101,8 @@ Operations that describe and check the database, configure it and maintain its i
 - [Read-only schema inference from notes' front matter.](https://datanotes.dev/api/operations/infer_table/): `POST /datanotes/operations/infer_table/`
 - [The semantic search index: `enabled`, `provider`, `model`, `files`, `passages`, `pending`,](https://datanotes.dev/api/operations/describe_semantic_index/): `POST /datanotes/operations/describe_semantic_index/`
 - [Bring the semantic search index up to date: embed the notes changed since the last run (the](https://datanotes.dev/api/operations/sync_semantic_index/): `POST /datanotes/operations/sync_semantic_index/`
+- [Put the rows of a table's closed periods into packs: one note per period (`<table> <key>.md` in the](https://datanotes.dev/api/operations/pack_rows/): `POST /datanotes/operations/pack_rows/`
+- [Take rows out of their packs as notes of their own, at their paths, with the text and the modification](https://datanotes.dev/api/operations/unpack_rows/): `POST /datanotes/operations/unpack_rows/`
 
 ### change feed
 

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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080015-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": "20261026T080015-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": "20261026T080015-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": "20261026T080015-insert_row-insert-into-genre-4"
       }
     },
     {
       "index": 1,
       "op": "insert_row",
       "ok": true,
-      "migration_id": "20261024T081149-insert_row-insert-into-genre-5",
+      "migration_id": "20261026T080015-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": "20261026T080015-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": "20261026T080015-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: 01a17739-7021-7335-bd91-607920af44cc
 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": "20261026T080016-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: 01a17739-6859-7d40-bcee-bed431f0b5fc
 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": "20261026T080014-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: 01a17739-cae3-7776-973c-b43948a4c694
 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: 01a17739-8ba4-7812-9a1d-e09d7a786e91
 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: 01a17739-7689-7c24-97b2-599276b0b1ba
 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: 01a17739-7689-7c24-97b2-599276b0b1ba
 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": "20261026T080029-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": "20261026T080029-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": "01a17739-a5cf-787a-bbd9-f7d256aec609",
       "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": "01a17739-a55e-750a-9874-527e3063d15a",
       "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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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: 01a17739-a54c-781c-897f-cbf429ce48f6
 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": "20261026T080029-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": "20261026T080029-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": "20261026T080029-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: 01a17739-a54c-781c-897f-cbf429ce48f6
 config:
   history: true
   default_catalog: diary