datanotes 3.0.0 → 3.2.0

package/dist/docs/guides/database-objects/catalogs-and-schemas.md

@@ -63,7 +63,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 0, "operation": "CREATE TABLE" }
   ],
-  "migration_id": "20261012T072003-create_table-create-table-diary-classics-fi"
+  "migration_id": "20261019T040655-create_table-create-table-diary-classics-fi"
 }
 ```
 
@@ -91,7 +91,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/diary/classics/film/Nosferatu.md"],
   "commits": [{ "table": "diary.classics.film", "version": 1, "operation": "WRITE" }],
-  "migration_id": "20261012T072003-insert_row-insert-into-film"
+  "migration_id": "20261019T040655-insert_row-insert-into-film"
 }
 ```
 
@@ -127,7 +127,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 3, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261012T072003-alter_table-alter-table-diary-classics-fil-2"
+  "migration_id": "20261019T040655-alter_table-alter-table-diary-classics-fil-2"
 }
 ```
 
@@ -144,7 +144,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T072003-comment_on-comment-on-catalog-diary"
+  "migration_id": "20261019T040655-comment_on-comment-on-catalog-diary"
 }
 ```
 
@@ -165,7 +165,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T072003-comment_on-comment-on-schema-diary-classi"
+  "migration_id": "20261019T040655-comment_on-comment-on-schema-diary-classi"
 }
 ```
 
@@ -173,7 +173,7 @@ Answer:
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a12efb-9b58-7bc6-9f52-b4394f27c37d
+id: 01a15257-4b68-7b8b-bf1b-44c297b63995
 config:
   history: true
 
@@ -270,7 +270,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 4, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261012T072003-alter_table-alter-table-diary-classics-fil-3"
+  "migration_id": "20261019T040655-alter_table-alter-table-diary-classics-fil-3"
 }
 ```
 
@@ -287,7 +287,7 @@ Answer:
   "ok": true,
   "op": "comment_on",
   "planned_texts": ["datanotes/metastore.yaml"],
-  "migration_id": "20261012T072003-comment_on-remove-the-comment-on-schema-d"
+  "migration_id": "20261019T040655-comment_on-remove-the-comment-on-schema-d"
 }
 ```
 
@@ -309,7 +309,7 @@ Answer:
   "commits": [
     { "table": "diary.classics.film", "version": 5, "operation": "ALTER TABLE" }
   ],
-  "migration_id": "20261012T072003-alter_table-alter-table-diary-classics-fil-4"
+  "migration_id": "20261019T040655-alter_table-alter-table-diary-classics-fil-4"
 }
 ```
 
@@ -593,7 +593,7 @@ This is the database of this page as the engine wrote it. `metastore.yaml` holds
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a12efb-9b58-7bc6-9f52-b4394f27c37d
+id: 01a15257-4b68-7b8b-bf1b-44c297b63995
 config:
   history: true
   default_catalog: diary
@@ -626,6 +626,8 @@ catalogs:
                       ne: watched
                   - rating:
                       exists: true
+            constraint_hints:
+              rated_when_watched: "A watched film needs a rating from 1 to 5: ask me for it."
             options:
               partition: "{year}"
               filename: "{title} ({year})"
@@ -777,6 +779,8 @@ catalogs:
                       ne: watched
                   - rating:
                       exists: true
+            constraint_hints:
+              rated_when_watched: "A watched film needs a rating from 1 to 5: ask me for it."
             options:
               partition: "{year}"
               filename: "{title} ({year})"
@@ -831,6 +835,8 @@ catalogs:
                       ne: watched
                   - rating:
                       exists: true
+            constraint_hints:
+              rated_when_watched: "A watched film needs a rating from 1 to 5: ask me for it."
             options:
               partition: "{year}"
               filename: "{title} ({year})"

package/dist/docs/guides/database-objects/columns.md

@@ -35,7 +35,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 3, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071946-add_column-add-column-minutes-to-film"
+  "migration_id": "20261019T040638-add_column-add-column-minutes-to-film"
 }
 ```
 
@@ -118,7 +118,7 @@ Answer:
   ],
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 5, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-favourite-to-film"
+  "migration_id": "20261019T040638-add_column-add-column-favourite-to-film"
 }
 ```
 
@@ -176,7 +176,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 6, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-status-to-film"
+  "migration_id": "20261019T040638-add_column-add-column-status-to-film"
 }
 ```
 
@@ -283,7 +283,7 @@ Answer:
   ],
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 9, "operation": "UPDATE" }],
-  "migration_id": "20261012T071947-rename_value-rename-film-status-value-seen-"
+  "migration_id": "20261019T040638-rename_value-rename-film-status-value-seen-"
 }
 ```
 
@@ -338,7 +338,7 @@ Answer:
   "commits": [
     { "table": "main.public.film", "version": 10, "operation": "CHANGE COLUMN" }
   ],
-  "migration_id": "20261012T071947-alter_column-alter-column-status-in-film"
+  "migration_id": "20261019T040638-alter_column-alter-column-status-in-film"
 }
 ```
 
@@ -402,7 +402,7 @@ Answer:
   "commits": [
     { "table": "main.public.film", "version": 11, "operation": "CHANGE COLUMN" }
   ],
-  "migration_id": "20261012T071947-alter_column-alter-column-minutes-in-film"
+  "migration_id": "20261019T040638-alter_column-alter-column-minutes-in-film"
 }
 ```
 
@@ -424,7 +424,7 @@ Answer:
   "commits": [
     { "table": "main.public.film", "version": 12, "operation": "CHANGE COLUMN" }
   ],
-  "migration_id": "20261012T071947-alter_column-alter-column-minutes-in-film-2"
+  "migration_id": "20261019T040638-alter_column-alter-column-minutes-in-film-2"
 }
 ```
 
@@ -454,7 +454,7 @@ Answer:
   "commits": [
     { "table": "main.public.film", "version": 13, "operation": "CHANGE COLUMN" }
   ],
-  "migration_id": "20261012T071947-alter_column-alter-column-minutes-in-film-3"
+  "migration_id": "20261019T040638-alter_column-alter-column-minutes-in-film-3"
 }
 ```
 
@@ -463,7 +463,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a12efb-5a12-7e85-a3a1-85a2fe3425ec
+id: 01a15257-0b64-7ab6-932a-3735e098cc48
 title: Nosferatu
 year: 1922
 favourite: false
@@ -490,7 +490,7 @@ Answer:
   "commits": [
     { "table": "main.public.film", "version": 14, "operation": "CHANGE COLUMN" }
   ],
-  "migration_id": "20261012T071947-alter_column-alter-column-minutes-in-film-4"
+  "migration_id": "20261019T040638-alter_column-alter-column-minutes-in-film-4"
 }
 ```
 
@@ -499,7 +499,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a12efb-5a12-7e85-a3a1-85a2fe3425ec
+id: 01a15257-0b64-7ab6-932a-3735e098cc48
 title: Nosferatu
 year: 1922
 favourite: false
@@ -541,7 +541,7 @@ Answer:
   "commits": [
     { "table": "main.public.film", "version": 15, "operation": "RENAME COLUMN" }
   ],
-  "migration_id": "20261012T071947-rename_column-rename-column-favourite-to-lov"
+  "migration_id": "20261019T040638-rename_column-rename-column-favourite-to-lov"
 }
 ```
 
@@ -603,14 +603,14 @@ Answer:
   ],
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 16, "operation": "DROP COLUMNS" }],
-  "migration_id": "20261012T071947-drop_column-drop-column-loved_it-from-film"
+  "migration_id": "20261019T040638-drop_column-drop-column-loved_it-from-film"
 }
 ```
 
 **`undo_migration`**
 
 ```json
-{ "migration_id": "20261012T071947-drop_column-drop-column-loved_it-from-film" }
+{ "migration_id": "20261019T040638-drop_column-drop-column-loved_it-from-film" }
 ```
 
 Answer:
@@ -619,8 +619,8 @@ Answer:
 {
   "ok": true,
   "op": "undo_migration",
-  "undoes": "20261012T071947-drop_column-drop-column-loved_it-from-film",
-  "migration_id": "20261012T071947-undo_migration-undo-20261012t071947-drop_colu",
+  "undoes": "20261019T040638-drop_column-drop-column-loved_it-from-film",
+  "migration_id": "20261019T040638-undo_migration-undo-20261019t040638-drop_colu",
   "conflicts": [],
   "failed": []
 }
@@ -681,7 +681,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 18, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-added-to-film"
+  "migration_id": "20261019T040638-add_column-add-column-added-to-film"
 }
 ```
 
@@ -714,7 +714,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Sherlock Jr..md"],
   "commits": [{ "table": "main.public.film", "version": 20, "operation": "WRITE" }],
-  "migration_id": "20261012T071947-insert_row-insert-into-film"
+  "migration_id": "20261019T040638-insert_row-insert-into-film-3"
 }
 ```
 
@@ -723,12 +723,12 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a12efb-5b24-7686-937c-757e0d7b754a
+id: 01a15257-0c62-7a36-afe1-f1afff29f8d8
 loved_it: false
 title: Sherlock Jr.
 year: 1924
-added: 2026-10-12
-added_at: 2026-10-12T07:19:47Z
+added: 2026-10-19
+added_at: 2026-10-19T04:06:38Z
 ---
 ```
 
@@ -759,7 +759,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 21, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-seen_at-to-film"
+  "migration_id": "20261019T040638-add_column-add-column-seen_at-to-film"
 }
 ```
 
@@ -784,7 +784,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 22, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-viewings-to-film"
+  "migration_id": "20261019T040638-add_column-add-column-viewings-to-film"
 }
 ```
 
@@ -833,7 +833,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 23, "operation": "UPDATE" }],
-  "migration_id": "20261012T071947-update_row-update-film-3"
+  "migration_id": "20261019T040638-update_row-update-film-4"
 }
 ```
 
@@ -842,7 +842,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a12efb-5a12-7e85-a3a1-85a2fe3425ec
+id: 01a15257-0b64-7ab6-932a-3735e098cc48
 title: Nosferatu
 year: 1922
 loved_it: false
@@ -942,7 +942,7 @@ Answer:
   "op": "create_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.watch", "version": 0, "operation": "CREATE TABLE" }],
-  "migration_id": "20261012T071947-create_table-create-table-main-public-watch"
+  "migration_id": "20261019T040638-create_table-create-table-main-public-watch"
 }
 ```
 
@@ -968,7 +968,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/watch/2026-10-03T2130.md"],
   "commits": [{ "table": "main.public.watch", "version": 1, "operation": "WRITE" }],
-  "migration_id": "20261012T071947-insert_row-insert-into-watch"
+  "migration_id": "20261019T040639-insert_row-insert-into-watch"
 }
 ```
 
@@ -977,7 +977,7 @@ Answer:
 ```markdown
 ---
 table: main.public.watch
-id: 01a12efb-5b61-7abf-9cb9-45a1f5a8f839
+id: 01a15257-0c9b-7856-9c12-bebb7eaf82e5
 film: His Girl Friday
 occurred_at: 2026-10-03T21:30
 where: home
@@ -1037,7 +1037,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 24, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-note_name-to-film"
+  "migration_id": "20261019T040639-add_column-add-column-note_name-to-film"
 }
 ```
 
@@ -1058,7 +1058,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 25, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261012T071947-add_column-add-column-created-to-film"
+  "migration_id": "20261019T040639-add_column-add-column-created-to-film"
 }
 ```
 
@@ -1077,7 +1077,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Charade.md"],
   "commits": [{ "table": "main.public.film", "version": 26, "operation": "WRITE" }],
-  "migration_id": "20261012T071947-insert_row-insert-into-film-2"
+  "migration_id": "20261019T040639-insert_row-insert-into-film"
 }
 ```
 
@@ -1086,14 +1086,14 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a12efb-5b90-78eb-ba11-d2990af01451
+id: 01a15257-0cc0-77b2-82b2-f18e2ec3a3e1
 loved_it: false
 title: Charade
 year: 1963
-added: 2026-10-12
-added_at: 2026-10-12T07:19:47Z
+added: 2026-10-19
+added_at: 2026-10-19T04:06:39Z
 note_name: Charade
-created: 2026-10-12T07:19:47Z
+created: 2026-10-19T04:06:39Z
 ---
 ```
 
@@ -1134,7 +1134,7 @@ Answer:
   "op": "create_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.actor", "version": 0, "operation": "CREATE TABLE" }],
-  "migration_id": "20261012T071948-create_table-create-table-main-public-actor"
+  "migration_id": "20261019T040640-create_table-create-table-main-public-actor"
 }
 ```
 
@@ -1153,7 +1153,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/actor/1904/Cary Grant.md"],
   "commits": [{ "table": "main.public.actor", "version": 1, "operation": "WRITE" }],
-  "migration_id": "20261012T071948-insert_row-insert-into-actor"
+  "migration_id": "20261019T040640-insert_row-insert-into-actor"
 }
 ```
 
@@ -1190,7 +1190,7 @@ The engine wrote this file with the columns from this page, in the operations’
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a12efb-5a06-7f54-8618-acdaa56c69f9
+id: 01a15257-0b53-73e7-8389-d60b05c9574b
 config:
   history: true