datanotes 3.3.0 → 3.4.0

package/dist/api/index.cjs

@@ -284,7 +284,7 @@ var OPERATIONS = [
   },
   {
     "name": "list_tables",
-    "description": "List every table: `name`, `catalog`, `schema`, `qualified` (`personal.metrics.mood` \u2014 use it\nwherever a table is expected; `metrics.mood` or `mood` also work when unambiguous), `path` and,\nwhen declared, `description`, `aliases` (other words for what it records) and `tags`. Tables are\ndefined in `metastore.yaml` (catalog \u2192 schema \u2192 table): read it freely, but it is read-only for\nagents and changes only through the schema operations (create_table, add_column, \u2026). Returns `{tables, views}`: `views` lists the stored views (same fields, no\npath): select them like tables. `system.information_schema` is read with `select_rows`.\n\nCall this first to find the table for what the user reports (match their words against\nname, description and aliases), and before creating tables or columns so you reuse existing\nones instead of creating duplicates.",
+    "description": "List every table: `name`, `catalog`, `schema`, `qualified` (`personal.metrics.mood` \u2014 use it\nwherever a table is expected; `metrics.mood` or `mood` also work when unambiguous), `path` and,\nwhen declared, `description`, `aliases` (other words for what it records) and `tags`. Tables are\ndefined in `metastore.yaml` (catalog \u2192 schema \u2192 table): read it freely, but it is read-only for\nagents and changes only through the schema operations (create_table, add_column, \u2026). Returns `{tables, views}`: `views` lists the stored views (same fields, no\npath): select them like tables. `system.information_schema` is read with `select_rows`.\nA token with `read` patterns sees only the tables and views it may read.\n\nCall this first to find the table for what the user reports (match their words against\nname, description and aliases), and before creating tables or columns so you reuse existing\nones instead of creating duplicates.",
     "inputSchema": {
       "additionalProperties": false,
       "properties": {},
@@ -549,7 +549,7 @@ var OPERATIONS = [
               },
               "generated": {
                 "type": "string",
-                "description": "Expression of a generated column."
+                "description": 'Expression of a generated column: a column, `date(col)\xB1N`, a template like `{name} {surname}`, `link(<template>)`, or an aggregate of a json list of objects like `count(feeds, side = "left")` or `sum(feeds.min)`.'
               },
               "dense": {
                 "type": "boolean",
@@ -670,7 +670,7 @@ var OPERATIONS = [
   },
   {
     "name": "create_table",
-    "description": 'Create a table: `name`, in `catalog` and `schema` (default: the database\'s defaults); the definition\ngoes in metastore.yaml, the rows in `<root>/<catalog>/<schema>/<name>/`. Names: lowercase letters,\ndigits, `_` (no dots: pass the catalog and the schema as their own arguments).\n- `description` (required): what a row of the table records. Every column needs its own `description`\n  too, what it holds: the table is refused otherwise, with every missing one listed. Descriptions are how\n  agents and people understand the schema, so write them for a reader who never saw the notes. The\n  engine writes those of `id` and of `identity` "uuid" / "created" columns.\n- `columns`: specs like `{"name": "kind", "type": "enum", "values": ["a","b"], "required": true,\n  "description": "What kind of entry the row is"}`.\n  Types: string, integer, number, boolean, date, datetime, enum, link, list (+ `items`), json.\n  Attributes: required, default (`"{now}"`/`"{today}"`), min, max, step, values, `ordered` (enum in\n  order: filters/avg use the position), ref (link target, full `catalog.schema.table` or "self"),\n  unique, label, description, aliases, `generated` (e.g. `"date(occurred_at)"`, `"{name} {surname}"`),\n  `identity` ("filename" | "created"), `vocabulary` (allowed values = names of another table\'s rows),\n  `hierarchy: true` (one parent link to its own table), `acyclic: true` (links to rows of its own table that never loop back, such as tasks blocked by tasks; with `inverse`, the rule holds on both sides), `dense` (written on every row),\n  `inverse` on a link column: the column of the `ref` table that links back (`friends` \u2194\n  `friends`, `children` \u2194 `parents`, `partner` \u2194 `partner`); writes keep both sides in step.\n- `time_column`: rows named by that date/datetime; otherwise `filename` (e.g. `"{name}"`).\n- The table\'s options, as alter_table names them: `aliases` (how agents find it, with the\n  description), `partition`, `exclude`, `archive`, `history` (keep its versions; default: the\n  database\'s setting), `autolink_target` (true / false: may automatic links link its rows? default:\n  yes, unless its rows are named by a date or a time, as with `time_column`).\n- `row_template`: markdown body of new rows. Shared columns come from bases: `set_table_bases`.\n- `instructions`: how to fill a row, for agents (Markdown); describe_table returns them.\n- `tags`: key/value labels of the table, strings (`{"domain": "health"}`); list_tables and\n  describe_table return them, alter_table changes them.\nEnum columns: `values` and, for each, its meaning in `value_descriptions` (`{"stated": "the user said it", \u2026}`): describe_table shows them and a refused value lists them.\nGenerated link columns: `generated: "link({occurred_at:YYYY-MM-DD})"` with `ref` = the days table links each row to the row of `ref` named by the template (its folder read from the schema; the target may not exist yet).\nFiltered link targets (link columns): `ref_where` (a `where` every target must match) and `ref_by` (a column of the row picks the target level: `{"column": "kind", "levels": ["area", "project", "workstream"]}` or `{"column": "kind", "map": {"area": null, "project": ["area"]}}`; null = top level, no link; `target_column` when the target names it differently: an enum target column must have every value the map allows, a string one takes any value). A link to no row of the table, or to the row itself, is refused too. Existing rows that break them refuse the change; `list_link_targets` lists the valid targets of a row.\n\nThe schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).',
+    "description": 'Create a table: `name`, in `catalog` and `schema` (default: the database\'s defaults); the definition\ngoes in metastore.yaml, the rows in `<root>/<catalog>/<schema>/<name>/`. Names: lowercase letters,\ndigits, `_` (no dots: pass the catalog and the schema as their own arguments).\n- `description` (required): what a row of the table records. Every column needs its own `description`\n  too, what it holds: the table is refused otherwise, with every missing one listed. Descriptions are how\n  agents and people understand the schema, so write them for a reader who never saw the notes. The\n  engine writes those of `id` and of `identity` "uuid" / "created" columns.\n- `columns`: specs like `{"name": "kind", "type": "enum", "values": ["a","b"], "required": true,\n  "description": "What kind of entry the row is"}`.\n  Types: string, integer, number, boolean, date, datetime, enum, link, list (+ `items`), json.\n  Attributes: required, default (`"{now}"`/`"{today}"`), min, max, step, values, `ordered` (enum in\n  order: filters/avg use the position), ref (link target, full `catalog.schema.table` or "self"),\n  unique, label, description, aliases, `generated` (e.g. `"date(occurred_at)"`, `"{name} {surname}"`),\n  `identity` ("filename" | "created"), `vocabulary` (allowed values = names of another table\'s rows),\n  `hierarchy: true` (one parent link to its own table), `acyclic: true` (links to rows of its own table that never loop back, such as tasks blocked by tasks; with `inverse`, the rule holds on both sides), `dense` (written on every row),\n  `inverse` on a link column: the column of the `ref` table that links back (`friends` \u2194\n  `friends`, `children` \u2194 `parents`, `partner` \u2194 `partner`); writes keep both sides in step.\n- `time_column`: rows named by that date/datetime; otherwise `filename` (e.g. `"{name}"`).\n- The table\'s options, as alter_table names them: `aliases` (how agents find it, with the\n  description), `partition`, `exclude`, `archive`, `history` (keep its versions; default: the\n  database\'s setting), `autolink_target` (true / false: may automatic links link its rows? default:\n  yes, unless its rows are named by a date or a time, as with `time_column`).\n- `row_template`: markdown body of new rows. Shared columns come from bases: `set_table_bases`.\n- `instructions`: how to fill a row, for agents (Markdown); describe_table returns them.\n- `tags`: key/value labels of the table, strings (`{"domain": "health"}`); list_tables and\n  describe_table return them, alter_table changes them.\nEnum columns: `values` and, for each, its meaning in `value_descriptions` (`{"stated": "the user said it", \u2026}`): describe_table shows them and a refused value lists them.\nGenerated link columns: `generated: "link({occurred_at:YYYY-MM-DD})"` with `ref` = the days table links each row to the row of `ref` named by the template (its folder read from the schema; the target may not exist yet).\nGenerated aggregates of a json column holding a list of objects (integer or number columns; avg: number): `count(feeds)`, `count(feeds.min)` (the items with a min), `sum(feeds.min)`, `avg(\u2026)`, `min(\u2026)`, `max(\u2026)`, with an optional filter on one field: `count(feeds, side = "left")`, `sum(feeds.min, min > 0)` (=, !=, <, <=, >, >=; "text", a number, true or false). Recomputed on every write; no list: count and sum 0, avg/min/max empty; a field that is not a number: empty.\nFiltered link targets (link columns): `ref_where` (a `where` every target must match) and `ref_by` (a column of the row picks the target level: `{"column": "kind", "levels": ["area", "project", "workstream"]}` or `{"column": "kind", "map": {"area": null, "project": ["area"]}}`; null = top level, no link; `target_column` when the target names it differently: an enum target column must have every value the map allows, a string one takes any value). A link to no row of the table, or to the row itself, is refused too. Existing rows that break them refuse the change; `list_link_targets` lists the valid targets of a row.\n\nThe schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).',
     "inputSchema": {
       "additionalProperties": false,
       "properties": {
@@ -1239,6 +1239,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -1652,6 +1696,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -1676,7 +1764,7 @@ var OPERATIONS = [
   },
   {
     "name": "add_column",
-    "description": 'Add a typed column. Sparse by default (written only on rows that have a value \u2014 use for\nmetrics, e.g. `{"name": "metric_mood", "type": "integer", "min": 1, "max": 5, "label":\n"Mood", "aliases": ["mood"], "description": "Mood of the day, 1 = bad, 5 = great"}`).\n`description` is required: what the column holds, for the agents and people who read the schema\n(the engine writes it for `identity` "uuid" / "created" columns).\n`dense: true` in the spec adds it to every row with its `default`. Call `describe_table` first: never add\na column whose meaning an existing column (name/label/aliases/description) already covers.\nColumn names are permanent identifiers; only `rename_column` changes them.\nEnum columns: `values` and, for each, its meaning in `value_descriptions` (`{"stated": "the user said it", \u2026}`): describe_table shows them and a refused value lists them.\nGenerated link columns: `generated: "link({occurred_at:YYYY-MM-DD})"` with `ref` = the days table links each row to the row of `ref` named by the template (its folder read from the schema; the target may not exist yet).\nFiltered link targets (link columns): `ref_where` (a `where` every target must match) and `ref_by` (a column of the row picks the target level: `{"column": "kind", "levels": ["area", "project", "workstream"]}` or `{"column": "kind", "map": {"area": null, "project": ["area"]}}`; null = top level, no link; `target_column` when the target names it differently: an enum target column must have every value the map allows, a string one takes any value). A link to no row of the table, or to the row itself, is refused too. Existing rows that break them refuse the change; `list_link_targets` lists the valid targets of a row.\nAcyclic links: `acyclic: true` on a link (or list of links) to the table itself refuses every write that closes a cycle, on either side of an `inverse`; refused while existing rows form one (they are listed).\n\nThe schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).',
+    "description": 'Add a typed column. Sparse by default (written only on rows that have a value \u2014 use for\nmetrics, e.g. `{"name": "metric_mood", "type": "integer", "min": 1, "max": 5, "label":\n"Mood", "aliases": ["mood"], "description": "Mood of the day, 1 = bad, 5 = great"}`).\n`description` is required: what the column holds, for the agents and people who read the schema\n(the engine writes it for `identity` "uuid" / "created" columns).\n`dense: true` in the spec adds it to every row with its `default`. Call `describe_table` first: never add\na column whose meaning an existing column (name/label/aliases/description) already covers.\nColumn names are permanent identifiers; only `rename_column` changes them.\nEnum columns: `values` and, for each, its meaning in `value_descriptions` (`{"stated": "the user said it", \u2026}`): describe_table shows them and a refused value lists them.\nGenerated link columns: `generated: "link({occurred_at:YYYY-MM-DD})"` with `ref` = the days table links each row to the row of `ref` named by the template (its folder read from the schema; the target may not exist yet).\nGenerated aggregates of a json column holding a list of objects (integer or number columns; avg: number): `count(feeds)`, `count(feeds.min)` (the items with a min), `sum(feeds.min)`, `avg(\u2026)`, `min(\u2026)`, `max(\u2026)`, with an optional filter on one field: `count(feeds, side = "left")`, `sum(feeds.min, min > 0)` (=, !=, <, <=, >, >=; "text", a number, true or false). Recomputed on every write; no list: count and sum 0, avg/min/max empty; a field that is not a number: empty.\nFiltered link targets (link columns): `ref_where` (a `where` every target must match) and `ref_by` (a column of the row picks the target level: `{"column": "kind", "levels": ["area", "project", "workstream"]}` or `{"column": "kind", "map": {"area": null, "project": ["area"]}}`; null = top level, no link; `target_column` when the target names it differently: an enum target column must have every value the map allows, a string one takes any value). A link to no row of the table, or to the row itself, is refused too. Existing rows that break them refuse the change; `list_link_targets` lists the valid targets of a row.\nAcyclic links: `acyclic: true` on a link (or list of links) to the table itself refuses every write that closes a cycle, on either side of an `inverse`; refused while existing rows form one (they are listed).\n\nThe schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).',
     "inputSchema": {
       "additionalProperties": false,
       "properties": {
@@ -2056,6 +2144,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -2462,6 +2594,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -2865,6 +3041,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -3273,6 +3493,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -3297,7 +3561,7 @@ var OPERATIONS = [
   },
   {
     "name": "alter_table",
-    "description": 'Alter a table: move it (`catalog`, `schema`), rename it (`name`), change\n`partition` / `filename` patterns, `description` (changes, never goes: "" is refused), `aliases`,\n`exclude` folders, `row_template`\n("" removes it), `instructions` (how to fill a row, for agents; "" removes them), `history` (true | false | "default"), `autolink_target`\n(true | false | "default": may automatic links link its rows? default: yes, unless its rows are named by\na date or a time) or `tags` (key/value\nlabels merged into the table\'s, e.g. `{"domain": "health"}`; a `null` value removes that tag;\n`clear_tags: true` removes every tag first, so with `tags` the table keeps exactly those),\n`archive` (folder name inside the table folder) or `fields` (untyped fields, name \u2192 default; a\n`null` value removes one). Rows, archive and transaction log follow; links are updated; renamed\nrows keep their old name in `aliases`. A change of metadata only (tags, description, aliases,\nhistory, autolink_target, row_template, instructions, fields) rewrites the table entry alone: no row is moved or rewritten. Refused\nwhen a row cannot fill a pattern. Renaming or moving the table is refused while a CHECK that follows\nlinks, or a `ref_where` / `ref_by`, of another table reads it through a link (link targets are not\nrewritten): the conflicts name them. Use `dry_run` to see `planned_moves`; undo with undo_migration.\n\nThe schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).',
+    "description": 'Alter a table: move it (`catalog`, `schema`), rename it (`name`), change\n`partition` / `filename` patterns, `description` (changes, never goes: "" is refused), `aliases`,\n`exclude` folders, `row_template`\n("" removes it), `instructions` (how to fill a row, for agents; "" removes them), `history` (true | false | "default"), `autolink_target`\n(true | false | "default": may automatic links link its rows? default: yes, unless its rows are named by\na date or a time) or `tags` (key/value\nlabels merged into the table\'s, e.g. `{"domain": "health"}`; a `null` value removes that tag;\n`clear_tags: true` removes every tag first, so with `tags` the table keeps exactly those),\n`archive` (folder name inside the table folder) or `fields` (untyped fields, name \u2192 default; a\n`null` value removes one). Rows, archive and transaction log follow; links are updated; renamed\nrows keep their old name in `aliases`. A change of metadata only (tags, description, aliases,\nhistory, autolink_target, row_template, instructions, fields) rewrites the table entry alone: no row is moved or rewritten. Refused\nwhen a row cannot fill a pattern. Renaming or moving the table rewrites what names it in other\ndefinitions: the `ref` and `vocabulary` of the columns of other tables and bases (lists of links\nincluded) and the tables of views (`table`, `union[].table`, `join.table`); `schema_references`\nlists 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.\n\nThe schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).',
     "inputSchema": {
       "additionalProperties": false,
       "properties": {
@@ -3878,6 +4142,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -4338,6 +4646,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -4743,6 +5095,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -4767,7 +5163,7 @@ var OPERATIONS = [
   },
   {
     "name": "describe_database",
-    "description": "Describe the database: its folder (`root`), `metastore` (`metastore.yaml`: read it freely,\nbut it is read-only for agents and changes only through the schema operations), configuration\n(default catalog and schema, row partition and file-name formats, archive folder, time zone,\nhistory, automatic links),\njournal folder, `bases` (shared column sets and the tables using them), `catalogs` \u2192 `schemas` \u2192 `tables` (with `row_count`, `tags`, and `unreadable_count` when some rows' front matter cannot be read) and `views`;\ncatalogs and schemas show their `comment` (set with `comment_on`). A table or base defined before\ndescriptions were required has `missing_descriptions`: what lacks one, for alter_table / alter_column\n(define_base for a base) to fill, so every table and column says what it holds.",
+    "description": "Describe the database: its folder (`root`), `metastore` (`metastore.yaml`: read it freely,\nbut it is read-only for agents and changes only through the schema operations), configuration\n(default catalog and schema, row partition and file-name formats, archive folder, time zone,\nhistory, automatic links),\njournal folder, `bases` (shared column sets and the tables using them), `catalogs` \u2192 `schemas` \u2192 `tables` (with `row_count`, `tags`, and `unreadable_count` when some rows' front matter cannot be read) and `views`;\ncatalogs and schemas show their `comment` (set with `comment_on`). A table or base defined before\ndescriptions were required has `missing_descriptions`: what lacks one, for alter_table / alter_column\n(define_base for a base) to fill, so every table and column says what it holds.\nA token with `read` patterns sees only the tables, views and bases it may read.",
     "inputSchema": {
       "additionalProperties": false,
       "properties": {},
@@ -5809,10 +6205,54 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
-        }
-      },
-      "required": [
-        "ok",
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
+        }
+      },
+      "required": [
+        "ok",
         "op",
         "dry_run",
         "notes_changed",
@@ -6219,6 +6659,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -6657,6 +7141,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -7099,6 +7627,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -7616,6 +8188,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -8051,6 +8667,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -8503,6 +9163,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -8967,6 +9671,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -10049,6 +10797,50 @@ var OPERATIONS = [
                       ]
                     },
                     "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+                  },
+                  "schema_references": {
+                    "type": "array",
+                    "items": {
+                      "title": "SchemaReference",
+                      "type": "object",
+                      "description": "A name of the moved table in another definition, rewritten to the new name.",
+                      "properties": {
+                        "table": {
+                          "type": "string",
+                          "description": "The table whose column names it (full name)."
+                        },
+                        "base": {
+                          "type": "string",
+                          "description": "The base whose column names it."
+                        },
+                        "view": {
+                          "type": "string",
+                          "description": "The view whose query names it (full name)."
+                        },
+                        "column": {
+                          "type": "string",
+                          "description": "The column of the table or base."
+                        },
+                        "key": {
+                          "type": "string",
+                          "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+                        },
+                        "from": {
+                          "type": "string",
+                          "description": "The name as written before."
+                        },
+                        "to": {
+                          "type": "string",
+                          "description": "The name written in its place."
+                        }
+                      },
+                      "required": [
+                        "key",
+                        "from",
+                        "to"
+                      ]
+                    },
+                    "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
                   }
                 },
                 "required": [
@@ -10496,6 +11288,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -10784,8 +11620,116 @@ var OPERATIONS = [
     }
   },
   {
-    "name": "semantic_search",
-    "description": 'Find notes by meaning, not exact words: `{query, results: [{path, score, heading, snippet,\ntable?}]}`, one result per note (its best passage), best first. Use it for vague questions\n("the dinner where we talked about moving", "what did I decide about the car") and to find the\nrows to read or update; then read_note / select_rows for the details. Filters: `tables`\n(qualified or short names), `folder`, `min_score` (cosine 0\u20131; ~0.5+ is usually relevant).\n`limit`: default 10, max 100. Fails with a clear message when semantic search is not enabled in\nthe engine settings.',
+    "name": "semantic_search",
+    "description": 'Find notes by meaning, not exact words: `{query, results: [{path, score, heading, snippet,\ntable?}]}`, one result per note (its best passage), best first. Use it for vague questions\n("the dinner where we talked about moving", "what did I decide about the car") and to find the\nrows to read or update; then read_note / select_rows for the details. Filters: `tables`\n(qualified or short names), `folder`, `min_score` (cosine 0\u20131; ~0.5+ is usually relevant).\n`limit`: default 10, max 100. Fails with a clear message when semantic search is not enabled in\nthe engine settings.',
+    "inputSchema": {
+      "additionalProperties": false,
+      "properties": {
+        "query": {
+          "type": "string"
+        },
+        "limit": {
+          "default": 10,
+          "type": "integer"
+        },
+        "tables": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "folder": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "min_score": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        }
+      },
+      "required": [
+        "query"
+      ],
+      "type": "object"
+    },
+    "annotations": {
+      "title": "Semantic Search",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "responseSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string"
+        },
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "score": {
+                "type": "number",
+                "description": "Similarity, 0..1."
+              },
+              "heading": {
+                "type": "string",
+                "description": "Heading of the best passage."
+              },
+              "snippet": {
+                "type": "string"
+              },
+              "table": {
+                "type": "string",
+                "description": "Qualified table of a row note."
+              }
+            },
+            "required": [
+              "path",
+              "score",
+              "heading",
+              "snippet"
+            ]
+          },
+          "description": "One result per note, best first."
+        }
+      },
+      "required": [
+        "query",
+        "results"
+      ]
+    }
+  },
+  {
+    "name": "search",
+    "description": "Search the notes by their words and, when semantic search is on, by their meaning:\n`{query, results: [{path, table?, score, heading, snippet, matched_by}], meaning}`, one result per\nnote, best first. It always works: with semantic search off it ranks by words alone (BM25:\nrare words count more; a word in the note's name or properties counts more), with it on it fuses\nboth rankings (Reciprocal Rank Fusion), so a note found only by its words or only by its meaning\nis still there. `matched_by` says which (`words`, `meaning`); `meaning` is `on`, `off` or `failed`\n(the embedding provider failed: words only, `meaning_error` says why). Query syntax as search_docs:\n`\"a phrase\"` and `+word` must appear, `-word` must not (both rankings); words in any language,\ncase and accents ignored, no stemming. Filters: `tables` (qualified or short names), `folder`,\n`min_score` (the meaning ranking's cosine floor). `limit`: default 10, max 100. Then read_note /\nselect_rows for the details.",
     "inputSchema": {
       "additionalProperties": false,
       "properties": {
@@ -10839,7 +11783,7 @@ var OPERATIONS = [
       "type": "object"
     },
     "annotations": {
-      "title": "Semantic Search",
+      "title": "Search",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -10859,35 +11803,62 @@ var OPERATIONS = [
               "path": {
                 "type": "string"
               },
+              "table": {
+                "type": "string",
+                "description": "Qualified table of a row note."
+              },
               "score": {
                 "type": "number",
-                "description": "Similarity, 0..1."
+                "description": "BM25 when ranked by words alone; the Reciprocal Rank Fusion score when fused."
               },
               "heading": {
                 "type": "string",
-                "description": "Heading of the best passage."
+                "description": "Heading above the match (empty before the first heading)."
               },
               "snippet": {
-                "type": "string"
-              },
-              "table": {
                 "type": "string",
-                "description": "Qualified table of a row note."
+                "description": "About 200 characters around the first match, or the best passage by meaning."
+              },
+              "matched_by": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "words",
+                    "meaning"
+                  ]
+                },
+                "description": "The rankings the note is in."
               }
             },
             "required": [
               "path",
               "score",
               "heading",
-              "snippet"
+              "snippet",
+              "matched_by"
             ]
           },
           "description": "One result per note, best first."
+        },
+        "meaning": {
+          "type": "string",
+          "enum": [
+            "on",
+            "off",
+            "failed"
+          ],
+          "description": "on: words and meaning fused; off: semantic search is off, words only; failed: the embedding provider failed, words only."
+        },
+        "meaning_error": {
+          "type": "string",
+          "description": "Why the meaning ranking failed (with meaning: failed)."
         }
       },
       "required": [
         "query",
-        "results"
+        "results",
+        "meaning"
       ]
     }
   },
@@ -11583,6 +12554,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -13024,6 +14039,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -14044,6 +15103,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -14446,6 +15549,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -14915,6 +16062,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -15313,6 +16504,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -15742,6 +16977,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -16158,6 +17437,50 @@ var OPERATIONS = [
             ]
           },
           "description": "Mentions left as text because the engine is not sure which note they name. Present when there is one: read the candidates and the context, then link the right one with update_row and autolink: false, or leave the text."
+        },
+        "schema_references": {
+          "type": "array",
+          "items": {
+            "title": "SchemaReference",
+            "type": "object",
+            "description": "A name of the moved table in another definition, rewritten to the new name.",
+            "properties": {
+              "table": {
+                "type": "string",
+                "description": "The table whose column names it (full name)."
+              },
+              "base": {
+                "type": "string",
+                "description": "The base whose column names it."
+              },
+              "view": {
+                "type": "string",
+                "description": "The view whose query names it (full name)."
+              },
+              "column": {
+                "type": "string",
+                "description": "The column of the table or base."
+              },
+              "key": {
+                "type": "string",
+                "description": "Where the name is: ref or vocabulary of the column, or table, union[N].table or join.table of the view's query."
+              },
+              "from": {
+                "type": "string",
+                "description": "The name as written before."
+              },
+              "to": {
+                "type": "string",
+                "description": "The name written in its place."
+              }
+            },
+            "required": [
+              "key",
+              "from",
+              "to"
+            ]
+          },
+          "description": "alter_table that moves or renames a table: the references to it in other definitions that it rewrites (on a dry run, would rewrite): the ref and vocabulary of the columns of other tables and of bases, and the tables the views' queries read. Present when there is one."
         }
       },
       "required": [
@@ -16664,6 +17987,7 @@ var OPERATION_KIND = {
   list_folder: "queries",
   search_notes: "queries",
   semantic_search: "queries",
+  search: "queries",
   graph_neighbors: "queries",
   graph_traverse: "queries",
   graph_path: "queries",