datanotes 3.2.0 → 3.3.1

package/dist/docs/guides/read-and-write/import-notes.md

@@ -314,7 +314,7 @@ Answer:
   "op": "create_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 0, "operation": "CREATE TABLE" }],
-  "migration_id": "20261019T040648-create_table-create-table-main-public-film"
+  "migration_id": "20261024T053830-create_table-create-table-main-public-film"
 }
 ```
 
@@ -359,7 +359,7 @@ Answer (70 lines)
       "path": "Films/Charade.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31b6-75a9-bb7e-06ebf5b385a4",
+        "id": "01a16c6a-f3d8-7a71-935b-e3cdd49c2cec",
         "director": "Stanley Donen",
         "title": "Charade"
       },
@@ -369,7 +369,7 @@ Answer (70 lines)
       "path": "Films/His Girl Friday.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31b6-7aac-9ba1-16fb7e23aa0a",
+        "id": "01a16c6a-f3d8-7b3a-a052-76112f5037b7",
         "director": "Howard Hawks",
         "title": "His Girl Friday"
       },
@@ -379,7 +379,7 @@ Answer (70 lines)
       "path": "Films/Metropolis.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31b6-7d6a-998e-fd8f06c27786",
+        "id": "01a16c6a-f3d8-7dda-93e2-1ad75dd46ee2",
         "director": "Fritz Lang",
         "title": "Metropolis"
       },
@@ -389,7 +389,7 @@ Answer (70 lines)
       "path": "Films/Nosferatu.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31b6-7a33-a502-afc11c66b564",
+        "id": "01a16c6a-f3d8-7b11-bdee-5230b4678352",
         "director": "F. W. Murnau",
         "title": "Nosferatu"
       },
@@ -399,7 +399,7 @@ Answer (70 lines)
       "path": "Films/The Gold Rush.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31b6-7124-9bc9-40a032066bd3",
+        "id": "01a16c6a-f3d8-71bc-a2b9-70a1be84f56f",
         "director": "Charlie Chaplin",
         "title": "The Gold Rush"
       },
@@ -458,7 +458,7 @@ Answer (73 lines)
       "path": "Films/Charade.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31bb-7a46-8ac7-181fa5bacea7",
+        "id": "01a16c6a-f3db-705d-a092-d386d6b8d680",
         "director": "Stanley Donen",
         "title": "Charade"
       },
@@ -468,7 +468,7 @@ Answer (73 lines)
       "path": "Films/His Girl Friday.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31bb-7754-a84c-ada8c44c4f96",
+        "id": "01a16c6a-f3db-7ce9-9b15-ffdf1d9e94f9",
         "director": "Howard Hawks",
         "title": "His Girl Friday"
       },
@@ -478,7 +478,7 @@ Answer (73 lines)
       "path": "Films/Metropolis.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31bb-7113-b86a-5d6fdca79420",
+        "id": "01a16c6a-f3db-73dd-9ca7-c1c2c0456765",
         "director": "Fritz Lang",
         "title": "Metropolis"
       },
@@ -488,7 +488,7 @@ Answer (73 lines)
       "path": "Films/Nosferatu.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31bc-7f8b-b4a7-376f074e01cb",
+        "id": "01a16c6a-f3db-7a47-8726-24e829d99493",
         "director": "F. W. Murnau",
         "title": "Nosferatu"
       },
@@ -498,7 +498,7 @@ Answer (73 lines)
       "path": "Films/The Gold Rush.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a15257-31bc-7554-a326-0e8b427aa5c6",
+        "id": "01a16c6a-f3db-77f9-a8b3-30bb65a6cc26",
         "director": "Charlie Chaplin",
         "title": "The Gold Rush"
       },
@@ -519,7 +519,7 @@ Answer (73 lines)
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 1, "operation": "ADOPT ROWS" }],
-  "migration_id": "20261019T040648-adopt_rows-adopt-5-notes-into-film"
+  "migration_id": "20261024T053831-adopt_rows-adopt-5-notes-into-film"
 }
 ```
 
@@ -536,7 +536,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a15257-31bb-7a46-8ac7-181fa5bacea7
+id: 01a16c6a-f3db-705d-a092-d386d6b8d680
 year: 1963
 minutes: 113
 status: watched
@@ -623,7 +623,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Battleship Potemkin.md"],
   "commits": [{ "table": "main.public.film", "version": 2, "operation": "WRITE" }],
-  "migration_id": "20261019T040648-insert_row-insert-into-film"
+  "migration_id": "20261024T053831-insert_row-insert-into-film"
 }
 ```
 
@@ -655,7 +655,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 4, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261019T040650-add_column-add-column-added_by-to-film"
+  "migration_id": "20261024T053832-add_column-add-column-added_by-to-film"
 }
 ```
 
@@ -683,7 +683,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Night of the Living Dead.md"],
   "commits": [{ "table": "main.public.film", "version": 5, "operation": "WRITE" }],
-  "migration_id": "20261019T040650-insert_row-insert-into-film"
+  "migration_id": "20261024T053832-insert_row-insert-into-film"
 }
 ```
 
@@ -692,7 +692,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a15257-37bf-770c-a384-b360bb939197
+id: 01a16c6a-f9d0-7e20-8311-52386a251707
 director: George A. Romero
 minutes: 96
 status: to watch
@@ -734,7 +734,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a15257-3a49-7617-a437-430fcfdc292a
+id: 01a16c6a-fc6c-7872-89fb-d51beace835e
 year: 1924
 minutes: 45
 status: to watch
@@ -762,7 +762,7 @@ Answer:
   "op": "alter_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 7, "operation": "ALTER TABLE" }],
-  "migration_id": "20261019T040652-alter_table-alter-table-main-public-film"
+  "migration_id": "20261024T053835-alter_table-alter-table-main-public-film"
 }
 ```
 
@@ -825,7 +825,7 @@ This is the table as you inferred, corrected and extended it on this page. Its d
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a15257-319e-7663-863b-41ff43d87deb
+id: 01a16c6a-f3c8-7bd8-8ca7-e31ab9cbc5a7
 config:
   history: true
 

package/dist/docs/guides/read-and-write/joins-and-aggregates.md

@@ -100,9 +100,9 @@ Answer:
   "table": "main.public.watch",
   "total": 3,
   "rows": [
-    { "date(occurred_at)": "2026-10-14", "viewings": 1 },
-    { "date(occurred_at)": "2026-10-17", "viewings": 1 },
-    { "date(occurred_at)": "2026-10-18", "viewings": 1 }
+    { "date(occurred_at)": "2026-10-19", "viewings": 1 },
+    { "date(occurred_at)": "2026-10-22", "viewings": 1 },
+    { "date(occurred_at)": "2026-10-23", "viewings": 1 }
   ]
 }
 ```
@@ -138,10 +138,10 @@ Answer:
     {
       "path": "datanotes/main/public/film/Night of the Living Dead.md",
       "title": "Night of the Living Dead",
-      "watched_on": "2026-10-18",
+      "watched_on": "2026-10-23",
       "viewing": [
         {
-          "path": "datanotes/main/public/watch/2026-10-18T2200.md",
+          "path": "datanotes/main/public/watch/2026-10-23T2200.md",
           "where": "cinema",
           "with": "Oscar"
         }
@@ -150,10 +150,10 @@ Answer:
     {
       "path": "datanotes/main/public/film/The Gold Rush.md",
       "title": "The Gold Rush",
-      "watched_on": "2026-10-17",
+      "watched_on": "2026-10-22",
       "viewing": [
         {
-          "path": "datanotes/main/public/watch/2026-10-17T2030.md",
+          "path": "datanotes/main/public/watch/2026-10-22T2030.md",
           "where": "home",
           "with": "my sister"
         }

package/dist/docs/guides/read-and-write/read-and-filter.md

@@ -332,23 +332,23 @@ Answer:
   "total": 3,
   "rows": [
     {
-      "path": "datanotes/main/public/watch/2026-10-14T2115.md",
+      "path": "datanotes/main/public/watch/2026-10-19T2115.md",
       "film": "[[Charade]]",
-      "occurred_at": "2026-10-14T21:15",
+      "occurred_at": "2026-10-19T21:15",
       "where": "home",
       "place": "my living room"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-17T2030.md",
+      "path": "datanotes/main/public/watch/2026-10-22T2030.md",
       "film": "[[The Gold Rush]]",
-      "occurred_at": "2026-10-17T20:30",
+      "occurred_at": "2026-10-22T20:30",
       "where": "home",
       "place": "my living room"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-18T2200.md",
+      "path": "datanotes/main/public/watch/2026-10-23T2200.md",
       "film": "[[Night of the Living Dead]]",
-      "occurred_at": "2026-10-18T22:00",
+      "occurred_at": "2026-10-23T22:00",
       "where": "cinema",
       "place": "the film club downtown"
     }
@@ -459,12 +459,12 @@ Answer:
   "total": 7,
   "rows": [
     {
-      "path": "datanotes/main/public/watch/2026-10-14T2115.md",
-      "occurred_at": "2026-10-14T21:15"
+      "path": "datanotes/main/public/watch/2026-10-19T2115.md",
+      "occurred_at": "2026-10-19T21:15"
     },
     {
-      "path": "datanotes/main/public/watch/2026-10-10T2130.md",
-      "occurred_at": "2026-10-10T21:30"
+      "path": "datanotes/main/public/watch/2026-10-15T2130.md",
+      "occurred_at": "2026-10-15T21:30"
     }
   ]
 }

package/dist/docs/guides/read-and-write/write-rows.md

@@ -31,7 +31,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Metropolis.md"],
   "commits": [{ "table": "main.public.film", "version": 1, "operation": "WRITE" }],
-  "migration_id": "20261019T040638-insert_row-insert-into-film"
+  "migration_id": "20261024T053819-insert_row-insert-into-film"
 }
 ```
 
@@ -40,7 +40,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a15257-0a57-7094-a53c-2ffddb1a5284
+id: 01a16c6a-c7b1-7337-8349-70046fead6ac
 title: Metropolis
 year: 1927
 minutes: 153
@@ -103,7 +103,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 6, "operation": "UPDATE" }],
-  "migration_id": "20261019T040643-update_row-update-film"
+  "migration_id": "20261024T053823-update_row-update-film"
 }
 ```
 
@@ -174,7 +174,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 8, "operation": "UPDATE" }],
-  "migration_id": "20261019T040643-update_row-update-film-3",
+  "migration_id": "20261024T053823-update_row-update-film-3",
   "ambiguous_mentions": [
     {
       "path": "datanotes/main/public/film/Nosferatu.md",
@@ -193,7 +193,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a15257-1ca9-7d11-a4d0-bc403634a138
+id: 01a16c6a-d656-749e-960a-7aa338a198ae
 title: Nosferatu
 year: 1922
 status: watched
@@ -246,7 +246,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 9, "operation": "UPDATE" }],
-  "migration_id": "20261019T040643-update_row-update-film-4"
+  "migration_id": "20261024T053823-update_row-update-film-4"
 }
 ```
 
@@ -332,7 +332,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 10, "operation": "UPDATE" }],
-  "migration_id": "20261019T040643-update_rows-update-film"
+  "migration_id": "20261024T053823-update_rows-update-film"
 }
 ```
 
@@ -370,7 +370,7 @@ Answer:
   ],
   "planned_creates": ["datanotes/main/public/film/Battleship Potemkin.md"],
   "commits": [{ "table": "main.public.film", "version": 11, "operation": "MERGE" }],
-  "migration_id": "20261019T040643-merge_rows-merge-2-rows-into-film"
+  "migration_id": "20261024T053823-merge_rows-merge-2-rows-into-film"
 }
 ```
 
@@ -431,7 +431,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 12, "operation": "DELETE" }],
-  "migration_id": "20261019T040643-delete_rows-archive-1-rows-of-film"
+  "migration_id": "20261024T053823-delete_rows-archive-1-rows-of-film"
 }
 ```
 
@@ -568,6 +568,6 @@ Answer (51 lines)
     { "table": "main.public.film", "version": 22, "operation": "MOVE ROWS" },
     { "table": "main.public.watchlist", "version": 1, "operation": "MOVE ROWS" }
   ],
-  "migration_id": "20261019T040643-move_rows-move-4-rows-from-film-to-watch"
+  "migration_id": "20261024T053823-move_rows-move-4-rows-from-film-to-watch"
 }
 ```

package/dist/docs/guides/search/text.md

@@ -87,7 +87,7 @@ Answer (62 lines)
         {
           "start": 81,
           "end": 86,
-          "context": "-a8aa-d00b2c25ad08\nname: Cary Grant\n---\n\n"
+          "context": "-9421-e41365b64268\nname: Cary Grant\n---\n\n"
         }
       ]
     },

package/dist/docs/guides/security/security-model.md

@@ -67,6 +67,18 @@ The owner creates a named token with `POST /datanotes/tokens/create/`, and the e
 
 A named token can’t create webhooks, manage tokens or read the engine’s status, and without `maintain` it can’t undo.
 
+### Extensions
+
+An extension adds tables and Model Context Protocol (MCP) tools from a git repository. Its code is trusted code that runs inside the MCP server’s process, not in a sandbox. Install only extensions you trust, and read the plan first.
+
+* **Pinned code**: the installer takes a version tag or a full commit id, and refuses a branch. It fetches the tag itself, even when a branch has the same name. It records the commit and the SHA-256 hashes of the manifest and the entry file. The server refuses cached code that differs.
+* **No install scripts**: the installer runs no script, no build and no `npm install`. The entry file may import only Node built-ins. The installer reads the imports in the file. Code that builds a module name at run time escapes this check.
+* **One token for each extension**: `ext-<name>` writes only the tables the manifest lists. It cannot change the schema or undo. The installer changes the schema with the owner’s token, after you confirm the plan.
+* **An invoker check**: before a tool that writes runs, the server checks the calling agent’s token. That token must be able to write the tool’s tables. A read-only client cannot write through an extension.
+* **The secret stays on one machine**: the token file sits under the data home with mode 0600. The registry in the engine’s store holds no secret.
+
+Known limits: extension code is not isolated from the MCP server’s process. Its token reads every table until read patterns ship. Migrations are declarative and run no code. [Install extensions](https://datanotes.dev/administration/extensions/) has the details.
+
 ### Who made each write
 
 The engine journals every write with its actor. The client sends the agent’s name, model and session, so they’re self-reported. The server sets the credential, `auth` (`owner`, or the named token’s name), and no client can claim another one.

package/dist/docs/reference/cli.md

@@ -3,7 +3,7 @@
 > The datanotes command and its options.
 
 ```text
-datanotes 3.2.0: Markdown notes as database tables, for you and your agents.
+datanotes 3.3.1: Markdown notes as database tables, for you and your agents.
 
 
 Usage:
@@ -15,6 +15,11 @@ Usage:
   datanotes store backup --database <folder>      show or set the store's git backup (--remote <url>, --off)
   datanotes store restore --from <url> --database <folder>   restore the store from its git backup
   datanotes store convert-log --to <files|segments> --database <folder>   rewrite the transaction log in that format
+  datanotes extension install <source> --database <folder>   install an extension: plan, confirm, write
+                                               (a git URL with #<tag>, owner/repo@<tag>, or a folder)
+  datanotes extension update | rollback | remove <name> --database <folder>   change an installed one
+  datanotes extension list --database <folder>    the installed extensions
+  datanotes extension check <folder>             check an extension's repository (for its authors)
   Every command takes --vault <folder> instead of --database for a vault holding the database.
   datanotes mcp --database <folder>            MCP server over stdio, on the engine running on the folder
                                                (or one it starts for the session)
@@ -103,6 +108,27 @@ Options of store:
   ~/.local/share/datanotes (Linux); DATANOTES_DATA_HOME moves it.
 
 
+Options of extension (every command but check works through the engine running on the database):
+  --database <folder>         the database folder (or DATANOTES_DATABASE; --vault <folder> for a vault)
+  --store <folder>            the engine's store, when serve was given one (or DATANOTES_STORE)
+  --settings <file>           settings file with the owner's token (or DATANOTES_SETTINGS;
+                              default settings.json in the store)
+  --url <url>                 an engine at an address (or DATANOTES_URL), with
+  --token-file <file>         a file holding the owner's token (or DATANOTES_TOKEN_FILE)
+  --map <list>                install, update: role=catalog.schema.table or role.column=column
+  --create <roles>            install, update: create these tables the extension depends on
+  --add <list>                install, update: add these role.column columns to matched tables
+  --catalog <name>            install: the catalog of the tables and views it creates
+  --schema <name>             install: the schema of the tables and views it creates
+  --to <ref>                  update: the version tag or commit to move to (default: the newest tag)
+  --from <source>             update: another source, such as the folder you develop in
+  --dry-run                   install, update: print the plan and write nothing
+  --yes                       write without asking (only once the user approved the plan)
+  --json                      print one JSON object (the plan or the result) and never ask
+  Lists (--map, --create, --add) are comma-separated. Exit codes: 0 done; 1 error; 2 the plan has
+  problems (nothing written); 3 confirmation needed (run again with --yes once the user approved)
+
+
 Options of mcp (stdio):
   --database <folder>         the database folder (or DATANOTES_DATABASE); acts with the owner's token,
                               and stops the engine it started when the client closes
@@ -128,6 +154,11 @@ Tools of mcp (both modes; default: every tool except create_webhook and delete_w
                               (or DATANOTES_MCP_OWNER_TOOLS=1)
 
 
+Extensions of mcp (both modes): the tools of the extensions installed in the database (datanotes
+extension install) come after the engine's tools; --profile read keeps only their read-only tools
+  --no-extensions             offer no extension tools (or DATANOTES_MCP_EXTENSIONS=0)
+
+
 Logs of mcp (both modes):
   --otlp-endpoint <url>       export logs over OTLP/HTTP, e.g. http://127.0.0.1:4318 (or the standard
                               OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS, OTEL_SERVICE_NAME)

package/dist/docs/reference/glossary.md

@@ -64,6 +64,10 @@ A UUID at the top of `metastore.yaml`, as `id`, that names the database. The eng
 
 The process that runs a vault as a database, `datanotes serve`. It checks and journals every write and serves the HTTP API. See [Run the engine as a service](https://datanotes.dev/administration/run-the-service/).
 
+## Extension
+
+A git repository that adds tables, views, bases, MCP tools and docs to a database. `datanotes extension install` pins and installs it. See [Install extensions](https://datanotes.dev/administration/extensions/).
+
 ## Front matter
 
 The YAML block at the top of a note, between two `---` lines. Each key of a row’s front matter holds the value of one column. See [How it works](https://datanotes.dev/start/how-it-works/).
@@ -112,6 +116,10 @@ A call the engine runs, such as `create_table`, `insert_row` or `select_rows`. E
 
 The token that can do everything, generated at the engine’s first start and kept in its settings file. See [Tokens and permissions](https://datanotes.dev/guides/security/tokens/).
 
+## Role (extension)
+
+The short name an extension’s manifest gives a table, such as `book`. The installer binds each role to a table of your database. See [Declare the tables](https://datanotes.dev/develop/write-an-extension/#declare-the-tables).
+
 ## Row
 
 A note whose front matter key `table` names a table, wherever it lives in the vault. Its front matter keys are the row’s columns. Each row has an `id` that never changes. See [Tables](https://datanotes.dev/guides/database-objects/tables/).

package/dist/docs/reference/operations/auxiliary.md

@@ -68,7 +68,7 @@ Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/data
 
 Validate every row against the table (required, types, ranges, enums, links, unknown columns, CHECK constraints, those that follow links included, filtered link targets (ref_where / ref_by), stale generated/identity values, missing inverse links, cycles of hierarchy and acyclic columns, front matter that cannot be read: code `unreadable`, with no column, for a note whose `table` line names the table but whose YAML is broken, which every other read leaves out). A CHECK violation has code `check` and the CHECK’s name as `constraint` (every other code names its `column`), as in the `violations` of list_changes. Use it to find rows edited by hand that break the schema. Without `table`, every table is checked: each row then names its `table`, `tables_checked` counts the tables checked, and a table that cannot be checked is listed in `errors` ({table, error}) while the others are. The rows with violations are paged: `limit` (default 500, at most 5000) from `offset`; `total` counts them all. (Hand edits are also checked as they happen: see `violations` in list_changes.)
 
-Examples: [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Find rows that break the schema](https://datanotes.dev/guides/data-quality/check-table/).
+Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Find rows that break the schema](https://datanotes.dev/guides/data-quality/check-table/).
 
 | Parameter | Type      | Required | Default | Description                                  |
 | --------- | --------- | -------- | ------- | -------------------------------------------- |

package/dist/docs/reference/operations/rows.md

@@ -34,7 +34,7 @@ Update exactly ONE row, addressed by its `id` (the system UUID) or its `path`; r
 * `expect`: compare-and-set — `{"status": "open"}` writes only if the row still has those values (a person may have changed it since you read it); otherwise refused, nothing written.
 * `autolink`: the text written links the notes it mentions by name, at their first mention (off with `autolink: false` or the database’s setting). `links_added` lists the links made; `ambiguous_mentions` the mentions left as text with the notes they may name: read those, then link the right one with update_row and `autolink: false`, or leave the text.
 
-Examples: [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Change data feed](https://datanotes.dev/guides/history/change-data-feed/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
+Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Change data feed](https://datanotes.dev/guides/history/change-data-feed/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
 
 | Parameter       | Type         | Required | Default | Description |
 | --------------- | ------------ | -------- | ------- | ----------- |

package/dist/docs/reference/operations/schema.md

@@ -65,7 +65,7 @@ Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/).
 
 **Alter Table** · destructive write
 
-Alter a table: move it (`catalog`, `schema`), rename it (`name`), change `partition` / `filename` patterns, `description` (changes, never goes: “” is refused), `aliases`, `exclude` folders, `row_template` (“” removes it), `instructions` (how to fill a row, for agents; “” removes them), `history` (true | false | “default”), `autolink_target` (true | false | “default”: may automatic links link its rows? default: yes, unless its rows are named by a date or a time) or `tags` (key/value labels merged into the table’s, e.g. `{"domain": "health"}`; a `null` value removes that tag; `clear_tags: true` removes every tag first, so with `tags` the table keeps exactly those), `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 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.
+Alter a table: move it (`catalog`, `schema`), rename it (`name`), change `partition` / `filename` patterns, `description` (changes, never goes: “” is refused), `aliases`, `exclude` folders, `row_template` (“” removes it), `instructions` (how to fill a row, for agents; “” removes them), `history` (true | false | “default”), `autolink_target` (true | false | “default”: may automatic links link its rows? default: yes, unless its rows are named by a date or a time) or `tags` (key/value labels merged into the table’s, e.g. `{"domain": "health"}`; a `null` value removes that tag; `clear_tags: true` removes every tag first, so with `tags` the table keeps exactly those), `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 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).
 
@@ -119,7 +119,7 @@ Add a typed column. Sparse by default (written only on rows that have a value
 
 The schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).
 
-Examples: [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/).
+Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/).
 
 | Parameter | Type    | Required | Default | Description                                                                                                |
 | --------- | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------- |
@@ -290,7 +290,7 @@ Create (or `replace`) a view: a named select stored in metastore.yaml. Name it w
 
 The schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).
 
-Examples: [Views](https://datanotes.dev/guides/database-objects/views/).
+Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [Views](https://datanotes.dev/guides/database-objects/views/).
 
 | Parameter     | Type         | Required | Default | Description |
 | ------------- | ------------ | -------- | ------- | ----------- |