datanotes 3.4.1 → 3.5.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 (52) hide show
  1. package/README.md +1 -1
  2. package/dist/api/extension-columns.d.cts +64 -0
  3. package/dist/api/extension-columns.d.ts +64 -0
  4. package/dist/api/extension-plan.d.cts +1 -1
  5. package/dist/api/extension-plan.d.ts +1 -1
  6. package/dist/api/extensions.cjs +1088 -5
  7. package/dist/api/extensions.js +1088 -5
  8. package/dist/api/index.cjs +1088 -5
  9. package/dist/api/index.js +1088 -5
  10. package/dist/api/mcp.cjs +1088 -5
  11. package/dist/api/mcp.js +1088 -5
  12. package/dist/datanotes.cjs +4701 -1665
  13. package/dist/docs/administration/extensions.md +2 -1
  14. package/dist/docs/administration/git-sync.md +17 -0
  15. package/dist/docs/administration/limits.md +29 -0
  16. package/dist/docs/administration/use-with-obsidian.md +12 -0
  17. package/dist/docs/api/operations/alter_table.md +6 -1
  18. package/dist/docs/api/operations/create_table.md +5 -0
  19. package/dist/docs/api/operations/describe_table.md +1 -1
  20. package/dist/docs/api/operations/pack_rows.md +45 -0
  21. package/dist/docs/api/operations/tags/auxiliary.md +2 -0
  22. package/dist/docs/api/operations/unpack_rows.md +40 -0
  23. package/dist/docs/api.md +3 -1
  24. package/dist/docs/develop/write-an-extension.md +8 -2
  25. package/dist/docs/guides/data-quality/check-constraints.md +10 -10
  26. package/dist/docs/guides/data-quality/hand-edits.md +8 -8
  27. package/dist/docs/guides/database-objects/bases.md +11 -11
  28. package/dist/docs/guides/database-objects/catalogs-and-schemas.md +10 -10
  29. package/dist/docs/guides/database-objects/columns.md +41 -41
  30. package/dist/docs/guides/database-objects/packs.md +563 -0
  31. package/dist/docs/guides/database-objects/relations.md +28 -28
  32. package/dist/docs/guides/database-objects/tables.md +28 -28
  33. package/dist/docs/guides/database-objects/views.md +44 -44
  34. package/dist/docs/guides/history/change-data-feed.md +34 -34
  35. package/dist/docs/guides/history/journal-and-undo.md +12 -12
  36. package/dist/docs/guides/history/restore.md +20 -20
  37. package/dist/docs/guides/history/table-history.md +31 -31
  38. package/dist/docs/guides/read-and-write/automatic-links.md +15 -15
  39. package/dist/docs/guides/read-and-write/import-notes.md +21 -21
  40. package/dist/docs/guides/read-and-write/joins-and-aggregates.md +7 -7
  41. package/dist/docs/guides/read-and-write/read-and-filter.md +10 -10
  42. package/dist/docs/guides/read-and-write/write-rows.md +10 -10
  43. package/dist/docs/guides/search/text.md +1 -1
  44. package/dist/docs/reference/cli.md +3 -1
  45. package/dist/docs/reference/operations/auxiliary.md +30 -1
  46. package/dist/docs/reference/operations/queries.md +1 -1
  47. package/dist/docs/reference/operations/rows.md +3 -3
  48. package/dist/docs/reference/operations/schema.md +8 -4
  49. package/dist/docs/reference/operations.md +55 -53
  50. package/dist/docs/reference/settings.md +1 -0
  51. package/dist/docs/release-notes.md +42 -0
  52. package/package.json +1 -1
@@ -35,7 +35,7 @@ Answer:
35
35
  "op": "add_column",
36
36
  "planned_texts": ["datanotes/metastore.yaml"],
37
37
  "commits": [{ "table": "main.public.film", "version": 3, "operation": "ADD COLUMNS" }],
38
- "migration_id": "20261024T081147-add_column-add-column-minutes-to-film"
38
+ "migration_id": "20261026T080013-add_column-add-column-minutes-to-film"
39
39
  }
40
40
  ```
41
41
 
@@ -118,7 +118,7 @@ Answer:
118
118
  ],
119
119
  "planned_texts": ["datanotes/metastore.yaml"],
120
120
  "commits": [{ "table": "main.public.film", "version": 5, "operation": "ADD COLUMNS" }],
121
- "migration_id": "20261024T081147-add_column-add-column-favourite-to-film"
121
+ "migration_id": "20261026T080013-add_column-add-column-favourite-to-film"
122
122
  }
123
123
  ```
124
124
 
@@ -176,7 +176,7 @@ Answer:
176
176
  "op": "add_column",
177
177
  "planned_texts": ["datanotes/metastore.yaml"],
178
178
  "commits": [{ "table": "main.public.film", "version": 6, "operation": "ADD COLUMNS" }],
179
- "migration_id": "20261024T081147-add_column-add-column-status-to-film"
179
+ "migration_id": "20261026T080013-add_column-add-column-status-to-film"
180
180
  }
181
181
  ```
182
182
 
@@ -283,7 +283,7 @@ Answer:
283
283
  ],
284
284
  "planned_texts": ["datanotes/metastore.yaml"],
285
285
  "commits": [{ "table": "main.public.film", "version": 9, "operation": "UPDATE" }],
286
- "migration_id": "20261024T081147-rename_value-rename-film-status-value-seen-"
286
+ "migration_id": "20261026T080013-rename_value-rename-film-status-value-seen-"
287
287
  }
288
288
  ```
289
289
 
@@ -338,7 +338,7 @@ Answer:
338
338
  "commits": [
339
339
  { "table": "main.public.film", "version": 10, "operation": "CHANGE COLUMN" }
340
340
  ],
341
- "migration_id": "20261024T081147-alter_column-alter-column-status-in-film"
341
+ "migration_id": "20261026T080013-alter_column-alter-column-status-in-film"
342
342
  }
343
343
  ```
344
344
 
@@ -402,7 +402,7 @@ Answer:
402
402
  "commits": [
403
403
  { "table": "main.public.film", "version": 11, "operation": "CHANGE COLUMN" }
404
404
  ],
405
- "migration_id": "20261024T081147-alter_column-alter-column-minutes-in-film"
405
+ "migration_id": "20261026T080013-alter_column-alter-column-minutes-in-film"
406
406
  }
407
407
  ```
408
408
 
@@ -424,7 +424,7 @@ Answer:
424
424
  "commits": [
425
425
  { "table": "main.public.film", "version": 12, "operation": "CHANGE COLUMN" }
426
426
  ],
427
- "migration_id": "20261024T081147-alter_column-alter-column-minutes-in-film-2"
427
+ "migration_id": "20261026T080013-alter_column-alter-column-minutes-in-film-2"
428
428
  }
429
429
  ```
430
430
 
@@ -454,7 +454,7 @@ Answer:
454
454
  "commits": [
455
455
  { "table": "main.public.film", "version": 13, "operation": "CHANGE COLUMN" }
456
456
  ],
457
- "migration_id": "20261024T081147-alter_column-alter-column-minutes-in-film-3"
457
+ "migration_id": "20261026T080013-alter_column-alter-column-minutes-in-film-3"
458
458
  }
459
459
  ```
460
460
 
@@ -463,7 +463,7 @@ Answer:
463
463
  ```markdown
464
464
  ---
465
465
  table: main.public.film
466
- id: 01a16cf7-4716-7ab8-ae7e-fda097800638
466
+ id: 01a17739-6737-79c4-a575-f6650343a02e
467
467
  title: Nosferatu
468
468
  year: 1922
469
469
  favourite: false
@@ -490,7 +490,7 @@ Answer:
490
490
  "commits": [
491
491
  { "table": "main.public.film", "version": 14, "operation": "CHANGE COLUMN" }
492
492
  ],
493
- "migration_id": "20261024T081147-alter_column-alter-column-minutes-in-film-4"
493
+ "migration_id": "20261026T080013-alter_column-alter-column-minutes-in-film-4"
494
494
  }
495
495
  ```
496
496
 
@@ -499,7 +499,7 @@ Answer:
499
499
  ```markdown
500
500
  ---
501
501
  table: main.public.film
502
- id: 01a16cf7-4716-7ab8-ae7e-fda097800638
502
+ id: 01a17739-6737-79c4-a575-f6650343a02e
503
503
  title: Nosferatu
504
504
  year: 1922
505
505
  favourite: false
@@ -541,7 +541,7 @@ Answer:
541
541
  "commits": [
542
542
  { "table": "main.public.film", "version": 15, "operation": "RENAME COLUMN" }
543
543
  ],
544
- "migration_id": "20261024T081147-rename_column-rename-column-favourite-to-lov"
544
+ "migration_id": "20261026T080013-rename_column-rename-column-favourite-to-lov"
545
545
  }
546
546
  ```
547
547
 
@@ -603,14 +603,14 @@ Answer:
603
603
  ],
604
604
  "planned_texts": ["datanotes/metastore.yaml"],
605
605
  "commits": [{ "table": "main.public.film", "version": 16, "operation": "DROP COLUMNS" }],
606
- "migration_id": "20261024T081147-drop_column-drop-column-loved_it-from-film"
606
+ "migration_id": "20261026T080013-drop_column-drop-column-loved_it-from-film"
607
607
  }
608
608
  ```
609
609
 
610
610
  **`undo_migration`**
611
611
 
612
612
  ```json
613
- { "migration_id": "20261024T081147-drop_column-drop-column-loved_it-from-film" }
613
+ { "migration_id": "20261026T080013-drop_column-drop-column-loved_it-from-film" }
614
614
  ```
615
615
 
616
616
  Answer:
@@ -619,8 +619,8 @@ Answer:
619
619
  {
620
620
  "ok": true,
621
621
  "op": "undo_migration",
622
- "undoes": "20261024T081147-drop_column-drop-column-loved_it-from-film",
623
- "migration_id": "20261024T081147-undo_migration-undo-20261024t081147-drop_colu",
622
+ "undoes": "20261026T080013-drop_column-drop-column-loved_it-from-film",
623
+ "migration_id": "20261026T080013-undo_migration-undo-20261026t080013-drop_colu",
624
624
  "conflicts": [],
625
625
  "failed": []
626
626
  }
@@ -681,7 +681,7 @@ Answer:
681
681
  "op": "add_column",
682
682
  "planned_texts": ["datanotes/metastore.yaml"],
683
683
  "commits": [{ "table": "main.public.film", "version": 18, "operation": "ADD COLUMNS" }],
684
- "migration_id": "20261024T081147-add_column-add-column-added-to-film"
684
+ "migration_id": "20261026T080013-add_column-add-column-added-to-film"
685
685
  }
686
686
  ```
687
687
 
@@ -714,7 +714,7 @@ Answer:
714
714
  "files_created": 1,
715
715
  "planned_creates": ["datanotes/main/public/film/Sherlock Jr..md"],
716
716
  "commits": [{ "table": "main.public.film", "version": 20, "operation": "WRITE" }],
717
- "migration_id": "20261024T081147-insert_row-insert-into-film-3"
717
+ "migration_id": "20261026T080013-insert_row-insert-into-film-3"
718
718
  }
719
719
  ```
720
720
 
@@ -723,12 +723,12 @@ Answer:
723
723
  ```markdown
724
724
  ---
725
725
  table: main.public.film
726
- id: 01a16cf7-47ed-726f-94e4-86646ae007e5
726
+ id: 01a17739-6822-7faf-bb78-e4f51e57a7f3
727
727
  loved_it: false
728
728
  title: Sherlock Jr.
729
729
  year: 1924
730
- added: 2026-10-24
731
- added_at: 2026-10-24T08:11:47Z
730
+ added: 2026-10-26
731
+ added_at: 2026-10-26T08:00:13Z
732
732
  ---
733
733
  ```
734
734
 
@@ -759,7 +759,7 @@ Answer:
759
759
  "op": "add_column",
760
760
  "planned_texts": ["datanotes/metastore.yaml"],
761
761
  "commits": [{ "table": "main.public.film", "version": 21, "operation": "ADD COLUMNS" }],
762
- "migration_id": "20261024T081147-add_column-add-column-seen_at-to-film"
762
+ "migration_id": "20261026T080013-add_column-add-column-seen_at-to-film"
763
763
  }
764
764
  ```
765
765
 
@@ -784,7 +784,7 @@ Answer:
784
784
  "op": "add_column",
785
785
  "planned_texts": ["datanotes/metastore.yaml"],
786
786
  "commits": [{ "table": "main.public.film", "version": 22, "operation": "ADD COLUMNS" }],
787
- "migration_id": "20261024T081147-add_column-add-column-viewings-to-film"
787
+ "migration_id": "20261026T080013-add_column-add-column-viewings-to-film"
788
788
  }
789
789
  ```
790
790
 
@@ -833,7 +833,7 @@ Answer:
833
833
  }
834
834
  ],
835
835
  "commits": [{ "table": "main.public.film", "version": 23, "operation": "UPDATE" }],
836
- "migration_id": "20261024T081147-update_row-update-film-4"
836
+ "migration_id": "20261026T080013-update_row-update-film-4"
837
837
  }
838
838
  ```
839
839
 
@@ -842,7 +842,7 @@ Answer:
842
842
  ```markdown
843
843
  ---
844
844
  table: main.public.film
845
- id: 01a16cf7-4716-7ab8-ae7e-fda097800638
845
+ id: 01a17739-6737-79c4-a575-f6650343a02e
846
846
  title: Nosferatu
847
847
  year: 1922
848
848
  loved_it: false
@@ -943,7 +943,7 @@ Answer:
943
943
  "op": "create_table",
944
944
  "planned_texts": ["datanotes/metastore.yaml"],
945
945
  "commits": [{ "table": "main.public.watch", "version": 0, "operation": "CREATE TABLE" }],
946
- "migration_id": "20261024T081147-create_table-create-table-main-public-watch"
946
+ "migration_id": "20261026T080013-create_table-create-table-main-public-watch"
947
947
  }
948
948
  ```
949
949
 
@@ -969,7 +969,7 @@ Answer:
969
969
  "files_created": 1,
970
970
  "planned_creates": ["datanotes/main/public/watch/2026-10-03T2130.md"],
971
971
  "commits": [{ "table": "main.public.watch", "version": 1, "operation": "WRITE" }],
972
- "migration_id": "20261024T081147-insert_row-insert-into-watch"
972
+ "migration_id": "20261026T080013-insert_row-insert-into-watch"
973
973
  }
974
974
  ```
975
975
 
@@ -978,7 +978,7 @@ Answer:
978
978
  ```markdown
979
979
  ---
980
980
  table: main.public.watch
981
- id: 01a16cf7-481b-7d97-bd70-f521486d2c67
981
+ id: 01a17739-6859-7d40-bcee-bed431f0b5fc
982
982
  film: His Girl Friday
983
983
  occurred_at: 2026-10-03T21:30
984
984
  where: home
@@ -1086,7 +1086,7 @@ Answer:
1086
1086
  "commits": [
1087
1087
  { "table": "main.public.marathon", "version": 0, "operation": "CREATE TABLE" }
1088
1088
  ],
1089
- "migration_id": "20261024T081147-create_table-create-table-main-public-marat"
1089
+ "migration_id": "20261026T080013-create_table-create-table-main-public-marat"
1090
1090
  }
1091
1091
  ```
1092
1092
 
@@ -1115,7 +1115,7 @@ Answer:
1115
1115
  "files_created": 1,
1116
1116
  "planned_creates": ["datanotes/main/public/marathon/2026-10-31.md"],
1117
1117
  "commits": [{ "table": "main.public.marathon", "version": 1, "operation": "WRITE" }],
1118
- "migration_id": "20261024T081147-insert_row-insert-into-marathon"
1118
+ "migration_id": "20261026T080013-insert_row-insert-into-marathon"
1119
1119
  }
1120
1120
  ```
1121
1121
 
@@ -1124,7 +1124,7 @@ Answer:
1124
1124
  ```markdown
1125
1125
  ---
1126
1126
  table: main.public.marathon
1127
- id: 01a16cf7-4833-71ed-9481-6b58b5c60508
1127
+ id: 01a17739-6874-76b4-8aeb-850776103744
1128
1128
  night: 2026-10-31
1129
1129
  films:
1130
1130
  - title: Nosferatu
@@ -1200,7 +1200,7 @@ Answer:
1200
1200
  "op": "add_column",
1201
1201
  "planned_texts": ["datanotes/metastore.yaml"],
1202
1202
  "commits": [{ "table": "main.public.film", "version": 24, "operation": "ADD COLUMNS" }],
1203
- "migration_id": "20261024T081147-add_column-add-column-note_name-to-film"
1203
+ "migration_id": "20261026T080013-add_column-add-column-note_name-to-film"
1204
1204
  }
1205
1205
  ```
1206
1206
 
@@ -1221,7 +1221,7 @@ Answer:
1221
1221
  "op": "add_column",
1222
1222
  "planned_texts": ["datanotes/metastore.yaml"],
1223
1223
  "commits": [{ "table": "main.public.film", "version": 25, "operation": "ADD COLUMNS" }],
1224
- "migration_id": "20261024T081147-add_column-add-column-created-to-film"
1224
+ "migration_id": "20261026T080013-add_column-add-column-created-to-film"
1225
1225
  }
1226
1226
  ```
1227
1227
 
@@ -1240,7 +1240,7 @@ Answer:
1240
1240
  "files_created": 1,
1241
1241
  "planned_creates": ["datanotes/main/public/film/Charade.md"],
1242
1242
  "commits": [{ "table": "main.public.film", "version": 26, "operation": "WRITE" }],
1243
- "migration_id": "20261024T081147-insert_row-insert-into-film-4"
1243
+ "migration_id": "20261026T080013-insert_row-insert-into-film-4"
1244
1244
  }
1245
1245
  ```
1246
1246
 
@@ -1249,14 +1249,14 @@ Answer:
1249
1249
  ```markdown
1250
1250
  ---
1251
1251
  table: main.public.film
1252
- id: 01a16cf7-4852-73be-8b83-c6afe0488571
1252
+ id: 01a17739-6898-7623-b72b-ca5a459fb2d1
1253
1253
  loved_it: false
1254
1254
  title: Charade
1255
1255
  year: 1963
1256
- added: 2026-10-24
1257
- added_at: 2026-10-24T08:11:47Z
1256
+ added: 2026-10-26
1257
+ added_at: 2026-10-26T08:00:13Z
1258
1258
  note_name: Charade
1259
- created: 2026-10-24T08:11:47Z
1259
+ created: 2026-10-26T08:00:13Z
1260
1260
  ---
1261
1261
  ```
1262
1262
 
@@ -1297,7 +1297,7 @@ Answer:
1297
1297
  "op": "create_table",
1298
1298
  "planned_texts": ["datanotes/metastore.yaml"],
1299
1299
  "commits": [{ "table": "main.public.actor", "version": 0, "operation": "CREATE TABLE" }],
1300
- "migration_id": "20261024T081149-create_table-create-table-main-public-actor"
1300
+ "migration_id": "20261026T080014-create_table-create-table-main-public-actor"
1301
1301
  }
1302
1302
  ```
1303
1303
 
@@ -1316,7 +1316,7 @@ Answer:
1316
1316
  "files_created": 1,
1317
1317
  "planned_creates": ["datanotes/main/public/actor/1904/Cary Grant.md"],
1318
1318
  "commits": [{ "table": "main.public.actor", "version": 1, "operation": "WRITE" }],
1319
- "migration_id": "20261024T081149-insert_row-insert-into-actor"
1319
+ "migration_id": "20261026T080015-insert_row-insert-into-actor"
1320
1320
  }
1321
1321
  ```
1322
1322
 
@@ -1353,7 +1353,7 @@ The engine wrote this file with the columns from this page, in the operations’
1353
1353
 
1354
1354
  ```yaml
1355
1355
  # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
1356
- id: 01a16cf7-4706-755e-a731-abd9e34b69f2
1356
+ id: 01a17739-6726-7642-9874-f56d67a177a2
1357
1357
  config:
1358
1358
  history: true
1359
1359