datanotes 3.3.0 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/SECURITY.md +5 -3
  2. package/dist/api/extensions.cjs +1345 -21
  3. package/dist/api/extensions.js +1345 -21
  4. package/dist/api/index.cjs +1345 -21
  5. package/dist/api/index.js +1345 -21
  6. package/dist/api/mcp.cjs +1345 -21
  7. package/dist/api/mcp.js +1345 -21
  8. package/dist/datanotes.cjs +2927 -609
  9. package/dist/docs/administration/extensions.md +2 -2
  10. package/dist/docs/api/operations/add_column.md +1 -0
  11. package/dist/docs/api/operations/alter_table.md +4 -3
  12. package/dist/docs/api/operations/check_table.md +1 -0
  13. package/dist/docs/api/operations/create_table.md +1 -0
  14. package/dist/docs/api/operations/describe_database.md +2 -0
  15. package/dist/docs/api/operations/describe_history.md +1 -0
  16. package/dist/docs/api/operations/describe_semantic_index.md +1 -0
  17. package/dist/docs/api/operations/describe_table.md +1 -0
  18. package/dist/docs/api/operations/graph_neighbors.md +1 -0
  19. package/dist/docs/api/operations/graph_path.md +1 -0
  20. package/dist/docs/api/operations/graph_traverse.md +1 -0
  21. package/dist/docs/api/operations/infer_table.md +1 -0
  22. package/dist/docs/api/operations/list_changes.md +1 -0
  23. package/dist/docs/api/operations/list_folder.md +1 -0
  24. package/dist/docs/api/operations/list_link_targets.md +1 -0
  25. package/dist/docs/api/operations/list_migrations.md +1 -0
  26. package/dist/docs/api/operations/list_tables.md +2 -0
  27. package/dist/docs/api/operations/list_webhooks.md +1 -0
  28. package/dist/docs/api/operations/read_note.md +1 -0
  29. package/dist/docs/api/operations/search.md +39 -0
  30. package/dist/docs/api/operations/search_notes.md +1 -0
  31. package/dist/docs/api/operations/select_rows.md +1 -0
  32. package/dist/docs/api/operations/semantic_search.md +1 -0
  33. package/dist/docs/api/operations/table_changes.md +1 -0
  34. package/dist/docs/api/operations/tags/queries.md +1 -0
  35. package/dist/docs/api/operations/tags/tokens.md +1 -1
  36. package/dist/docs/api/operations/tokens_create.md +1 -0
  37. package/dist/docs/api/operations/tokens_update.md +2 -1
  38. package/dist/docs/api.md +5 -4
  39. package/dist/docs/develop/build-an-app.md +2 -1
  40. package/dist/docs/develop/change-feed-and-webhooks.md +1 -1
  41. package/dist/docs/develop/http-api.md +1 -1
  42. package/dist/docs/guides/data-quality/check-constraints.md +10 -10
  43. package/dist/docs/guides/data-quality/hand-edits.md +8 -8
  44. package/dist/docs/guides/database-objects/bases.md +11 -11
  45. package/dist/docs/guides/database-objects/catalogs-and-schemas.md +30 -10
  46. package/dist/docs/guides/database-objects/columns.md +243 -40
  47. package/dist/docs/guides/database-objects/relations.md +28 -28
  48. package/dist/docs/guides/database-objects/tables.md +167 -43
  49. package/dist/docs/guides/database-objects/views.md +44 -44
  50. package/dist/docs/guides/history/change-data-feed.md +34 -34
  51. package/dist/docs/guides/history/journal-and-undo.md +12 -12
  52. package/dist/docs/guides/history/restore.md +20 -20
  53. package/dist/docs/guides/history/table-history.md +31 -31
  54. package/dist/docs/guides/read-and-write/automatic-links.md +15 -15
  55. package/dist/docs/guides/read-and-write/import-notes.md +20 -20
  56. package/dist/docs/guides/read-and-write/joins-and-aggregates.md +7 -7
  57. package/dist/docs/guides/read-and-write/read-and-filter.md +10 -10
  58. package/dist/docs/guides/read-and-write/write-rows.md +10 -10
  59. package/dist/docs/guides/search/hybrid.md +162 -0
  60. package/dist/docs/guides/search/text.md +1 -1
  61. package/dist/docs/guides/security/security-model.md +5 -3
  62. package/dist/docs/guides/security/tokens.md +121 -8
  63. package/dist/docs/reference/cli.md +1 -1
  64. package/dist/docs/reference/glossary.md +1 -1
  65. package/dist/docs/reference/operations/auxiliary.md +3 -3
  66. package/dist/docs/reference/operations/queries.md +16 -0
  67. package/dist/docs/reference/operations/rows.md +1 -1
  68. package/dist/docs/reference/operations/schema.md +5 -5
  69. package/dist/docs/reference/operations.md +6 -5
  70. package/dist/docs/release-notes.md +59 -0
  71. package/dist/docs/start/connect-agents.md +10 -3
  72. package/package.json +1 -1
@@ -30,7 +30,7 @@ Answer:
30
30
  "ok": true,
31
31
  "op": "define_base",
32
32
  "planned_texts": ["datanotes/metastore.yaml"],
33
- "migration_id": "20261020T173845-define_base-create-base-entry"
33
+ "migration_id": "20261024T063920-define_base-create-base-entry"
34
34
  }
35
35
  ```
36
36
 
@@ -50,7 +50,7 @@ Answer:
50
50
  "commits": [
51
51
  { "table": "diary.classics.film", "version": 6, "operation": "SET TABLE BASES" }
52
52
  ],
53
- "migration_id": "20261020T173845-set_table_bases-diary-classics-film-extends-en"
53
+ "migration_id": "20261024T063920-set_table_bases-diary-classics-film-extends-en"
54
54
  }
55
55
  ```
56
56
 
@@ -118,14 +118,14 @@ Answer:
118
118
  "rows": [
119
119
  {
120
120
  "path": "datanotes/diary/classics/actors/Max Schreck.md",
121
- "id": "01a15a64-e8e3-73eb-9164-1fc8de45795b",
121
+ "id": "01a16ca2-a55f-7ea9-a62e-541b9f025578",
122
122
  "added_on": "2026-10-05",
123
123
  "note": "The face of Nosferatu",
124
124
  "_source": "diary.classics.actors"
125
125
  },
126
126
  {
127
127
  "path": "datanotes/diary/classics/film/Nosferatu.md",
128
- "id": "01a15a64-e863-705a-96ae-42d6c22c878b",
128
+ "id": "01a16ca2-a508-7d01-9bb0-9773a3a6a511",
129
129
  "added_on": "2026-10-05",
130
130
  "note": null,
131
131
  "_source": "diary.classics.film"
@@ -169,7 +169,7 @@ Answer:
169
169
  "commits": [
170
170
  { "table": "diary.classics.actors", "version": 3, "operation": "DEFINE BASE" }
171
171
  ],
172
- "migration_id": "20261020T173845-define_base-alter-base-entry"
172
+ "migration_id": "20261024T063920-define_base-alter-base-entry"
173
173
  }
174
174
  ```
175
175
 
@@ -246,7 +246,7 @@ Answer:
246
246
  "commits": [
247
247
  { "table": "diary.classics.actors", "version": 4, "operation": "DEFINE BASE" }
248
248
  ],
249
- "migration_id": "20261020T173845-define_base-alter-base-entry-2"
249
+ "migration_id": "20261024T063920-define_base-alter-base-entry-2"
250
250
  }
251
251
  ```
252
252
 
@@ -280,7 +280,7 @@ Answer:
280
280
  "ok": true,
281
281
  "op": "define_base",
282
282
  "planned_texts": ["datanotes/metastore.yaml"],
283
- "migration_id": "20261020T173845-define_base-create-base-credited"
283
+ "migration_id": "20261024T063920-define_base-create-base-credited"
284
284
  }
285
285
  ```
286
286
 
@@ -300,7 +300,7 @@ Answer:
300
300
  "commits": [
301
301
  { "table": "diary.classics.actors", "version": 5, "operation": "SET TABLE BASES" }
302
302
  ],
303
- "migration_id": "20261020T173845-set_table_bases-diary-classics-actors-extends--2"
303
+ "migration_id": "20261024T063920-set_table_bases-diary-classics-actors-extends--2"
304
304
  }
305
305
  ```
306
306
 
@@ -329,7 +329,7 @@ Answer:
329
329
  "ok": true,
330
330
  "op": "define_base",
331
331
  "planned_texts": ["datanotes/metastore.yaml"],
332
- "migration_id": "20261020T173845-define_base-create-base-tree"
332
+ "migration_id": "20261024T063921-define_base-create-base-tree"
333
333
  }
334
334
  ```
335
335
 
@@ -369,7 +369,7 @@ Answer:
369
369
  "commits": [
370
370
  { "table": "diary.classics.genre", "version": 1, "operation": "SET TABLE BASES" }
371
371
  ],
372
- "migration_id": "20261020T173845-set_table_bases-diary-classics-genre-extends-t"
372
+ "migration_id": "20261024T063921-set_table_bases-diary-classics-genre-extends-t"
373
373
  }
374
374
  ```
375
375
 
@@ -475,6 +475,6 @@ Answer:
475
475
  "operation": "SET TABLE BASES"
476
476
  }
477
477
  ],
478
- "migration_id": "20261020T173845-set_table_bases-diary-classics-genre_draft-ext"
478
+ "migration_id": "20261024T063921-set_table_bases-diary-classics-genre_draft-ext"
479
479
  }
480
480
  ```
@@ -63,7 +63,7 @@ Answer:
63
63
  "commits": [
64
64
  { "table": "diary.classics.film", "version": 0, "operation": "CREATE TABLE" }
65
65
  ],
66
- "migration_id": "20261020T173844-create_table-create-table-diary-classics-fi"
66
+ "migration_id": "20261024T063920-create_table-create-table-diary-classics-fi"
67
67
  }
68
68
  ```
69
69
 
@@ -91,7 +91,7 @@ Answer:
91
91
  "files_created": 1,
92
92
  "planned_creates": ["datanotes/diary/classics/film/Nosferatu.md"],
93
93
  "commits": [{ "table": "diary.classics.film", "version": 1, "operation": "WRITE" }],
94
- "migration_id": "20261020T173844-insert_row-insert-into-film"
94
+ "migration_id": "20261024T063920-insert_row-insert-into-film"
95
95
  }
96
96
  ```
97
97
 
@@ -127,7 +127,7 @@ Answer:
127
127
  "commits": [
128
128
  { "table": "diary.classics.film", "version": 3, "operation": "ALTER TABLE" }
129
129
  ],
130
- "migration_id": "20261020T173844-alter_table-alter-table-diary-classics-fil-2"
130
+ "migration_id": "20261024T063920-alter_table-alter-table-diary-classics-fil-2"
131
131
  }
132
132
  ```
133
133
 
@@ -144,7 +144,7 @@ Answer:
144
144
  "ok": true,
145
145
  "op": "comment_on",
146
146
  "planned_texts": ["datanotes/metastore.yaml"],
147
- "migration_id": "20261020T173844-comment_on-comment-on-catalog-diary"
147
+ "migration_id": "20261024T063920-comment_on-comment-on-catalog-diary"
148
148
  }
149
149
  ```
150
150
 
@@ -165,7 +165,7 @@ Answer:
165
165
  "ok": true,
166
166
  "op": "comment_on",
167
167
  "planned_texts": ["datanotes/metastore.yaml"],
168
- "migration_id": "20261020T173845-comment_on-comment-on-schema-diary-classi"
168
+ "migration_id": "20261024T063920-comment_on-comment-on-schema-diary-classi"
169
169
  }
170
170
  ```
171
171
 
@@ -173,7 +173,7 @@ Answer:
173
173
 
174
174
  ```yaml
175
175
  # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
176
- id: 01a15a64-e851-7907-b148-bbd50adcd745
176
+ id: 01a16ca2-a4fb-7845-9268-3bc0a21e629e
177
177
  config:
178
178
  history: true
179
179
 
@@ -270,7 +270,7 @@ Answer:
270
270
  "commits": [
271
271
  { "table": "diary.classics.film", "version": 4, "operation": "ALTER TABLE" }
272
272
  ],
273
- "migration_id": "20261020T173845-alter_table-alter-table-diary-classics-fil"
273
+ "migration_id": "20261024T063920-alter_table-alter-table-diary-classics-fil-3"
274
274
  }
275
275
  ```
276
276
 
@@ -287,7 +287,7 @@ Answer:
287
287
  "ok": true,
288
288
  "op": "comment_on",
289
289
  "planned_texts": ["datanotes/metastore.yaml"],
290
- "migration_id": "20261020T173845-comment_on-remove-the-comment-on-schema-d"
290
+ "migration_id": "20261024T063920-comment_on-remove-the-comment-on-schema-d"
291
291
  }
292
292
  ```
293
293
 
@@ -309,7 +309,7 @@ Answer:
309
309
  "commits": [
310
310
  { "table": "diary.classics.film", "version": 5, "operation": "ALTER TABLE" }
311
311
  ],
312
- "migration_id": "20261020T173845-alter_table-alter-table-diary-classics-fil-2"
312
+ "migration_id": "20261024T063920-alter_table-alter-table-diary-classics-fil-4"
313
313
  }
314
314
  ```
315
315
 
@@ -593,7 +593,7 @@ This is the database of this page as the engine wrote it. `metastore.yaml` holds
593
593
 
594
594
  ```yaml
595
595
  # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
596
- id: 01a15a64-e851-7907-b148-bbd50adcd745
596
+ id: 01a16ca2-a4fb-7845-9268-3bc0a21e629e
597
597
  config:
598
598
  history: true
599
599
  default_catalog: diary
@@ -667,6 +667,10 @@ catalogs:
667
667
  min: 1
668
668
  max: 5
669
669
  description: My rating, from 1 (poor) to 5 (a masterpiece)
670
+ - name: lead
671
+ type: link
672
+ ref: diary.credits.actor
673
+ description: The actor in the leading role
670
674
  genre:
671
675
  description: Eras and genres of cinema, as a tree
672
676
  options:
@@ -703,6 +707,14 @@ catalogs:
703
707
  type: string
704
708
  required: true
705
709
  description: The name of the era or genre
710
+ views:
711
+ cast_list:
712
+ description: Every actor, by name
713
+ query:
714
+ table: diary.credits.actor
715
+ columns:
716
+ - name
717
+ order_by: name
706
718
  credits:
707
719
  tables:
708
720
  actor:
@@ -819,6 +831,10 @@ catalogs:
819
831
  min: 1
820
832
  max: 5
821
833
  description: My rating, from 1 (poor) to 5 (a masterpiece)
834
+ - name: lead
835
+ type: link
836
+ ref: diary.credits.actor
837
+ description: The actor in the leading role
822
838
  film_empty:
823
839
  description: "One note per classic film: what I watched and what I thought"
824
840
  aliases:
@@ -875,6 +891,10 @@ catalogs:
875
891
  min: 1
876
892
  max: 5
877
893
  description: My rating, from 1 (poor) to 5 (a masterpiece)
894
+ - name: lead
895
+ type: link
896
+ ref: diary.credits.actor
897
+ description: The actor in the leading role
878
898
  bases:
879
899
  entry:
880
900
  description: A note of the film diary