datanotes 3.4.2 → 3.5.0

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

@@ -236,7 +236,7 @@ Refused:
 
 ```text
 pass "time_column" or "filename" (e.g. "{name}") so rows get file names
-Hint: Check the arguments of create_table: name (string, required), description (string), columns (list of objects, required), catalog (string), schema (string), time_column (string), filename (string), partition (string), exclude (list of strings), archive (string), aliases (list of strings), history (boolean), autolink_target (boolean), row_template (string), instructions (string), fields (object), tags (object), dry_run (boolean).
+Hint: Check the arguments of create_table: name (string, required), description (string), columns (list of objects, required), catalog (string), schema (string), time_column (string), filename (string), partition (string), pack (string), pack_after_days (integer), exclude (list of strings), archive (string), aliases (list of strings), history (boolean), autolink_target (boolean), row_template (string), instructions (string), fields (object), tags (object), dry_run (boolean).
 Docs: https://datanotes.dev/reference/operations/schema.md#create_table (offline: read_docs("reference/operations/schema#create_table"))
 ```
 
@@ -314,7 +314,7 @@ Answer:
   "op": "create_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 0, "operation": "CREATE TABLE" }],
-  "migration_id": "20261024T203000-create_table-create-table-main-public-film"
+  "migration_id": "20261026T080022-create_table-create-table-main-public-film"
 }
 ```
 
@@ -359,7 +359,7 @@ Answer (70 lines)
       "path": "Films/Charade.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-230f-733e-bbe4-83739c8553c0",
+        "id": "01a17739-8ba0-705c-9dab-b7ee827fd020",
         "director": "Stanley Donen",
         "title": "Charade"
       },
@@ -369,7 +369,7 @@ Answer (70 lines)
       "path": "Films/His Girl Friday.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2310-7285-bd86-19c52b42de66",
+        "id": "01a17739-8ba0-7c30-b138-2b4e68c53f25",
         "director": "Howard Hawks",
         "title": "His Girl Friday"
       },
@@ -379,7 +379,7 @@ Answer (70 lines)
       "path": "Films/Metropolis.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2310-7849-8987-2433f84c5cd4",
+        "id": "01a17739-8ba0-738c-b096-f979386e8feb",
         "director": "Fritz Lang",
         "title": "Metropolis"
       },
@@ -389,7 +389,7 @@ Answer (70 lines)
       "path": "Films/Nosferatu.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2310-7fed-ab01-51ef740bd322",
+        "id": "01a17739-8ba0-7dbe-9ab5-50c4ce32d03f",
         "director": "F. W. Murnau",
         "title": "Nosferatu"
       },
@@ -399,7 +399,7 @@ Answer (70 lines)
       "path": "Films/The Gold Rush.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2310-7d23-9b9a-57fa004619ec",
+        "id": "01a17739-8ba0-71b1-bd5d-efdb783b9feb",
         "director": "Charlie Chaplin",
         "title": "The Gold Rush"
       },
@@ -458,7 +458,7 @@ Answer (73 lines)
       "path": "Films/Charade.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2314-76cc-a0b0-3737ae7c5e61",
+        "id": "01a17739-8ba4-75cd-8d89-591ad0529c6e",
         "director": "Stanley Donen",
         "title": "Charade"
       },
@@ -468,7 +468,7 @@ Answer (73 lines)
       "path": "Films/His Girl Friday.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2314-7ec6-b8a4-9769d2eb74ed",
+        "id": "01a17739-8ba4-7677-ace4-2eeadf460ac6",
         "director": "Howard Hawks",
         "title": "His Girl Friday"
       },
@@ -478,7 +478,7 @@ Answer (73 lines)
       "path": "Films/Metropolis.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2314-790b-b772-e40f5d94e4b1",
+        "id": "01a17739-8ba4-7812-9a1d-e09d7a786e91",
         "director": "Fritz Lang",
         "title": "Metropolis"
       },
@@ -488,7 +488,7 @@ Answer (73 lines)
       "path": "Films/Nosferatu.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2314-75a4-9a76-5d74cf364168",
+        "id": "01a17739-8ba4-7dfd-8fba-2a8d475b8c71",
         "director": "F. W. Murnau",
         "title": "Nosferatu"
       },
@@ -498,7 +498,7 @@ Answer (73 lines)
       "path": "Films/The Gold Rush.md",
       "set": {
         "table": "main.public.film",
-        "id": "01a16f9b-2314-70f1-89fe-b68f7e2d3b9f",
+        "id": "01a17739-8ba5-7a2b-8930-9fa5a3ce1c1d",
         "director": "Charlie Chaplin",
         "title": "The Gold Rush"
       },
@@ -519,7 +519,7 @@ Answer (73 lines)
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 1, "operation": "ADOPT ROWS" }],
-  "migration_id": "20261024T203000-adopt_rows-adopt-5-notes-into-film"
+  "migration_id": "20261026T080022-adopt_rows-adopt-5-notes-into-film"
 }
 ```
 
@@ -536,7 +536,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-2314-76cc-a0b0-3737ae7c5e61
+id: 01a17739-8ba4-75cd-8d89-591ad0529c6e
 year: 1963
 minutes: 113
 status: watched
@@ -623,7 +623,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Battleship Potemkin.md"],
   "commits": [{ "table": "main.public.film", "version": 2, "operation": "WRITE" }],
-  "migration_id": "20261024T203000-insert_row-insert-into-film"
+  "migration_id": "20261026T080022-insert_row-insert-into-film"
 }
 ```
 
@@ -655,7 +655,7 @@ Answer:
   "op": "add_column",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 4, "operation": "ADD COLUMNS" }],
-  "migration_id": "20261024T203002-add_column-add-column-added_by-to-film"
+  "migration_id": "20261026T080023-add_column-add-column-added_by-to-film"
 }
 ```
 
@@ -683,7 +683,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Night of the Living Dead.md"],
   "commits": [{ "table": "main.public.film", "version": 5, "operation": "WRITE" }],
-  "migration_id": "20261024T203002-insert_row-insert-into-film"
+  "migration_id": "20261026T080023-insert_row-insert-into-film"
 }
 ```
 
@@ -692,7 +692,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-2919-7508-87ca-f5b7fa31c65d
+id: 01a17739-91a8-7d50-b7e0-af83bffa43f7
 director: George A. Romero
 minutes: 96
 status: to watch
@@ -734,7 +734,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-2ba1-7ac8-8f00-71d7b7fe5143
+id: 01a17739-943f-76a1-9d85-9c3352710227
 year: 1924
 minutes: 45
 status: to watch
@@ -762,7 +762,7 @@ Answer:
   "op": "alter_table",
   "planned_texts": ["datanotes/metastore.yaml"],
   "commits": [{ "table": "main.public.film", "version": 7, "operation": "ALTER TABLE" }],
-  "migration_id": "20261024T203004-alter_table-alter-table-main-public-film"
+  "migration_id": "20261026T080026-alter_table-alter-table-main-public-film"
 }
 ```
 
@@ -825,7 +825,7 @@ This is the table as you inferred, corrected and extended it on this page. Its d
 
 ```yaml
 # Metastore (Datanotes): catalogs, schemas, tables, columns, views.
-id: 01a16f9b-22f5-7be8-a003-1d43db75c224
+id: 01a17739-8b2f-792b-9de9-2dce203b6c01
 config:
   history: true
 

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

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

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

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

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

@@ -31,7 +31,7 @@ Answer:
   "files_created": 1,
   "planned_creates": ["datanotes/main/public/film/Metropolis.md"],
   "commits": [{ "table": "main.public.film", "version": 1, "operation": "WRITE" }],
-  "migration_id": "20261024T202950-insert_row-insert-into-film"
+  "migration_id": "20261026T080012-insert_row-insert-into-film"
 }
 ```
 
@@ -40,7 +40,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9a-fc9a-7240-be4c-cdf811716ef7
+id: 01a17739-663d-79f3-9d66-608a7164e699
 title: Metropolis
 year: 1927
 minutes: 153
@@ -103,7 +103,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 6, "operation": "UPDATE" }],
-  "migration_id": "20261024T202955-update_row-update-film"
+  "migration_id": "20261026T080017-update_row-update-film"
 }
 ```
 
@@ -174,7 +174,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 8, "operation": "UPDATE" }],
-  "migration_id": "20261024T202955-update_row-update-film-3",
+  "migration_id": "20261026T080017-update_row-update-film-3",
   "ambiguous_mentions": [
     {
       "path": "datanotes/main/public/film/Nosferatu.md",
@@ -193,7 +193,7 @@ Answer:
 ```markdown
 ---
 table: main.public.film
-id: 01a16f9b-0dbb-7154-b84c-122a05f5cb15
+id: 01a17739-767a-77ab-a08d-62945d014f77
 title: Nosferatu
 year: 1922
 status: watched
@@ -246,7 +246,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 9, "operation": "UPDATE" }],
-  "migration_id": "20261024T202955-update_row-update-film-4"
+  "migration_id": "20261026T080017-update_row-update-film-4"
 }
 ```
 
@@ -332,7 +332,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 10, "operation": "UPDATE" }],
-  "migration_id": "20261024T202955-update_rows-update-film"
+  "migration_id": "20261026T080017-update_rows-update-film"
 }
 ```
 
@@ -370,7 +370,7 @@ Answer:
   ],
   "planned_creates": ["datanotes/main/public/film/Battleship Potemkin.md"],
   "commits": [{ "table": "main.public.film", "version": 11, "operation": "MERGE" }],
-  "migration_id": "20261024T202955-merge_rows-merge-2-rows-into-film"
+  "migration_id": "20261026T080017-merge_rows-merge-2-rows-into-film"
 }
 ```
 
@@ -431,7 +431,7 @@ Answer:
     }
   ],
   "commits": [{ "table": "main.public.film", "version": 12, "operation": "DELETE" }],
-  "migration_id": "20261024T202955-delete_rows-archive-1-rows-of-film"
+  "migration_id": "20261026T080017-delete_rows-archive-1-rows-of-film"
 }
 ```
 
@@ -568,6 +568,6 @@ Answer (51 lines)
     { "table": "main.public.film", "version": 22, "operation": "MOVE ROWS" },
     { "table": "main.public.watchlist", "version": 1, "operation": "MOVE ROWS" }
   ],
-  "migration_id": "20261024T202955-move_rows-move-4-rows-from-film-to-watch"
+  "migration_id": "20261026T080017-move_rows-move-4-rows-from-film-to-watch"
 }
 ```

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

@@ -87,7 +87,7 @@ Answer (62 lines)
         {
           "start": 81,
           "end": 86,
-          "context": "-a4e8-0331bc07052a\nname: Cary Grant\n---\n\n"
+          "context": "-8ec2-3a91780e27f5\nname: Cary Grant\n---\n\n"
         }
       ]
     },

package/dist/docs/reference/cli.md

@@ -3,7 +3,7 @@
 > The datanotes command and its options.
 
 ```text
-datanotes 3.4.2: Markdown notes as database tables, for you and your agents.
+datanotes 3.5.0: Markdown notes as database tables, for you and your agents.
 
 
 Usage:
@@ -20,6 +20,8 @@ Usage:
   datanotes extension update | rollback | remove <name> --database <folder>   change an installed one
   datanotes extension list --database <folder>    the installed extensions
   datanotes extension check <folder>             check an extension's repository (for its authors)
+  datanotes pack-merge <base> <ours> <theirs> [<path>]   git's merge driver of packs of rows, row by row
+                                               (git sync registers it: merge.datanotes-pack.driver)
   Every command takes --vault <folder> instead of --database for a vault holding the database.
   datanotes mcp --database <folder>            MCP server over stdio, on the engine running on the folder
                                                (or one it starts for the session)

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

@@ -20,7 +20,7 @@ Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [View
 
 **Describe Table** · read-only
 
-Describe a table (`catalog.schema.table` or a shorter unambiguous name): `qualified`, `name`, `catalog`, `schema`, `description`, `aliases`, `layout` (`folder`, `row_folder`: the folder pattern of new rows, `archive`), `options` (`partition`, `filename`, `archive`, `exclude`), typed `columns` with label/aliases/description and the dense flag, `untyped_fields`, `row_count`, and when set: `tags`, `bases` (the bases it inherits from, in order), `constraints` (its CHECKs, name → where), `constraint_hints` (their own hints, name → hint), `instructions` (how to fill a row: follow them before you write one), `row_template`, `history`, `autolink_target`, `fields` (their values).
+Describe a table (`catalog.schema.table` or a shorter unambiguous name): `qualified`, `name`, `catalog`, `schema`, `description`, `aliases`, `layout` (`folder`, `row_folder`: the folder pattern of new rows, `archive`), `options` (`partition`, `filename`, `archive`, `exclude`, `pack`, `pack_after_days`), typed `columns` with label/aliases/description and the dense flag, `untyped_fields`, `row_count`, and when set: `tags`, `bases` (the bases it inherits from, in order), `constraints` (its CHECKs, name → where), `constraint_hints` (their own hints, name → hint), `instructions` (how to fill a row: follow them before you write one), `row_template`, `history`, `autolink_target`, `fields` (their values).
 
 Before adding a column (e.g. a new metric), read `columns` and match your concept against `name`, `label`, `aliases` and `description`; reuse an existing column when it means the same.
 
@@ -114,3 +114,32 @@ Examples: [Find notes by meaning](https://datanotes.dev/guides/search/semantic/)
 | Parameter | Type    | Required | Default | Description                                     |
 | --------- | ------- | -------- | ------- | ----------------------------------------------- |
 | `rebuild` | boolean |          | `false` | Re-embed every note, not only the changed ones. |
+
+## `pack_rows`
+
+**Pack Rows** · destructive write
+
+Put the rows of a table’s closed periods into packs: one note per period (`<table> <key>.md` in the table’s folder), a `##` section per row, `key:: value` lines for its values. The table needs a `pack` option (create_table / alter_table, e.g. `"{occurred_at:YYYY-MM}"`). A period is closed `pack_after_days` days after it ends (default 7); `key` packs only that period. Nothing changes for the engine and its readers: select_rows, links, the graph and the change feed still see each row at its path, with its values, text and file_modified (no change event, no new version). Links from other notes to a packed row become `[[pack#row]]`, which Obsidian follows too. A row stays a note of its own (`excluded`, with the reason) when it changed in the last 24 hours, has a `#` or `##` heading in its text, is not at the path its values give, or its note is not in the form the engine writes. The engine also packs on its own once a day (setting `autoPack`). Needs the engine service. Journaled: undo_migration takes the rows out again. Use `dry_run` to see `packs` first.
+
+Examples: [Packs of rows](https://datanotes.dev/guides/database-objects/packs/).
+
+| Parameter | Type      | Required | Default | Description |
+| --------- | --------- | -------- | ------- | ----------- |
+| `table`   | string    | yes      |         |             |
+| `key`     | string \\ | null     |         | `null`      |
+| `dry_run` | boolean   |          | `false` |             |
+
+## `unpack_rows`
+
+**Unpack Rows** · destructive write
+
+Take rows out of their packs as notes of their own, at their paths, with the text and the modification time they had (the opposite of pack_rows): every pack of the table, the pack of `key`, or only the rows `where` matches (as select_rows filters). A pack left without rows goes. Links `[[pack#row]]` from other notes become links to the notes. Needed before alter_table changes the table’s `pack`, `partition`, `filename` or name. Silent for the rows, journaled (undo_migration packs them again).
+
+Examples: [Packs of rows](https://datanotes.dev/guides/database-objects/packs/).
+
+| Parameter | Type      | Required | Default | Description |
+| --------- | --------- | -------- | ------- | ----------- |
+| `table`   | string    | yes      |         |             |
+| `key`     | string \\ | null     |         | `null`      |
+| `where`   | object \\ | null     |         | `null`      |
+| `dry_run` | boolean   |          | `false` |             |

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

@@ -19,7 +19,7 @@ Query rows: `{table, total, rows: [{path, ...}]}`. `table` may be a view, `syste
 * `this_note`: vault path of the note the result is for: `{this.*}` tokens in a view’s query and in `where` read it (`{this.date}`, `{this.link}`, `{this.name}`, `{this.path}`); without it (or a front matter key the note lacks) a token stays as written and matches no row, whatever the operator (`within` included).
 * Ordered enums compare by position. Time travel: `version` (of one table) or `timestamp`. With `timestamp` a join, a view, a union or `base:<name>` reads every table in it as of that time (`versions`: the version read of each); a table that did not exist then adds no rows to a union or base. `version` is refused where several tables are read; information_schema has no history. Views and bases keep today’s definition, and links followed by `where` (`project.kind`, `within`) or `expand` read the linked rows as they are now.
 
-Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Views](https://datanotes.dev/guides/database-objects/views/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Validation](https://datanotes.dev/guides/data-quality/validation/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Read and filter rows](https://datanotes.dev/guides/read-and-write/read-and-filter/), [Joins and aggregates](https://datanotes.dev/guides/read-and-write/joins-and-aggregates/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
+Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Views](https://datanotes.dev/guides/database-objects/views/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Packs of rows](https://datanotes.dev/guides/database-objects/packs/), [Validation](https://datanotes.dev/guides/data-quality/validation/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Read and filter rows](https://datanotes.dev/guides/read-and-write/read-and-filter/), [Joins and aggregates](https://datanotes.dev/guides/read-and-write/joins-and-aggregates/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
 
 | Parameter      | Type         | Required     | Default | Description |
 | -------------- | ------------ | ------------ | ------- | ----------- |

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

@@ -12,7 +12,7 @@ Every write is validated. Writes to rows and to the schema are journaled and und
 
 Insert a row (new note). When describe_table gives the table’s `instructions`, fill the row as they say. Values are validated against the columns; the note path comes from the table’s `path`/`filename` patterns (e.g. an event logged today about last night lands in last night’s day folder when you set `occurred_at` to last night). `body` is the note text. Generated / identity columns are computed (do not pass them); CHECK constraints are enforced. Returns `migration_id` (undo) and the created path in `planned_creates`. `body` links the notes it mentions by name, at their first mention (automatic links; off with `autolink: false` or the database’s `autolink` setting). `links_added` lists the links made; `ambiguous_mentions` lists the mentions left as text with the notes they may name: read those, then link the right one with update_row and `autolink: false`, or leave the text.
 
-Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Validation](https://datanotes.dev/guides/data-quality/validation/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Change data feed](https://datanotes.dev/guides/history/change-data-feed/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
+Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Packs of rows](https://datanotes.dev/guides/database-objects/packs/), [Validation](https://datanotes.dev/guides/data-quality/validation/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Change data feed](https://datanotes.dev/guides/history/change-data-feed/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
 
 | Parameter  | Type       | Required | Default | Description |
 | ---------- | ---------- | -------- | ------- | ----------- |
@@ -34,7 +34,7 @@ Update exactly ONE row, addressed by its `id` (the system UUID) or its `path`; r
 * `expect`: compare-and-set — `{"status": "open"}` writes only if the row still has those values (a person may have changed it since you read it); otherwise refused, nothing written.
 * `autolink`: the text written links the notes it mentions by name, at their first mention (off with `autolink: false` or the database’s setting). `links_added` lists the links made; `ambiguous_mentions` the mentions left as text with the notes they may name: read those, then link the right one with update_row and `autolink: false`, or leave the text.
 
-Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Change data feed](https://datanotes.dev/guides/history/change-data-feed/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
+Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Packs of rows](https://datanotes.dev/guides/database-objects/packs/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Hand edits](https://datanotes.dev/guides/data-quality/hand-edits/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Journal and undo](https://datanotes.dev/guides/history/journal-and-undo/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/), [Change data feed](https://datanotes.dev/guides/history/change-data-feed/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
 
 | Parameter       | Type         | Required | Default | Description |
 | --------------- | ------------ | -------- | ------- | ----------- |
@@ -147,7 +147,7 @@ Several writes that succeed or fail together. `operations`: `[{"op": ..., ...arg
 
 The schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).
 
-Examples: [Views](https://datanotes.dev/guides/database-objects/views/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
+Examples: [Views](https://datanotes.dev/guides/database-objects/views/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Packs of rows](https://datanotes.dev/guides/database-objects/packs/), [CHECK constraints](https://datanotes.dev/guides/data-quality/check-constraints/), [Batch writes](https://datanotes.dev/guides/read-and-write/batch/), [Restore a table or the database](https://datanotes.dev/guides/history/restore/).
 
 | Parameter    | Type      | Required | Default | Description |
 | ------------ | --------- | -------- | ------- | ----------- |

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

@@ -15,14 +15,14 @@ Create a table: `name`, in `catalog` and `schema` (default: the database’s def
 * `description` (required): what a row of the table records. Every column needs its own `description` too, what it holds: the table is refused otherwise, with every missing one listed. Descriptions are how agents and people understand the schema, so write them for a reader who never saw the notes. The engine writes those of `id` and of `identity` “uuid” / “created” columns.
 * `columns`: specs like `{"name": "kind", "type": "enum", "values": ["a","b"], "required": true, "description": "What kind of entry the row is"}`. Types: string, integer, number, boolean, date, datetime, enum, link, list (+ `items`), json. Attributes: required, default (`"{now}"`/`"{today}"`), min, max, step, values, `ordered` (enum in order: filters/avg use the position), ref (link target, full `catalog.schema.table` or “self”), unique, label, description, aliases, `generated` (e.g. `"date(occurred_at)"`, `"{name} {surname}"`), `identity` (“filename” | “created”), `vocabulary` (allowed values = names of another table’s rows), `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), `inverse` on a link column: the column of the `ref` table that links back (`friends` ↔ `friends`, `children` ↔ `parents`, `partner` ↔ `partner`); writes keep both sides in step.
 * `time_column`: rows named by that date/datetime; otherwise `filename` (e.g. `"{name}"`).
-* The table’s options, as alter_table names them: `aliases` (how agents find it, with the description), `partition`, `exclude`, `archive`, `history` (keep its versions; default: the database’s setting), `autolink_target` (true / false: may automatic links link its rows? default: yes, unless its rows are named by a date or a time, as with `time_column`).
+* The table’s options, as alter_table names them: `aliases` (how agents find it, with the description), `partition`, `exclude`, `archive`, `history` (keep its versions; default: the database’s setting), `autolink_target` (true / false: may automatic links link its rows? default: yes, unless its rows are named by a date or a time, as with `time_column`). `pack` (a template of a date column, such as `"{occurred_at:YYYY-MM}"`: once a period is over, one note holds its rows, `##` section by section; select_rows still gives one row each) and `pack_after_days` (default 7): see pack_rows.
 * `row_template`: markdown body of new rows. Shared columns come from bases: `set_table_bases`.
 * `instructions`: how to fill a row, for agents (Markdown); describe_table returns them.
 * `tags`: key/value labels of the table, strings (`{"domain": "health"}`); list_tables and describe_table return them, alter_table changes them. Enum columns: `values` and, for each, its meaning in `value_descriptions` (`{"stated": "the user said it", …}`): describe_table shows them and a refused value lists them. Generated 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). Generated 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(…)`, `min(…)`, `max(…)`, 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. Filtered 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.
 
 The schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).
 
-Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/).
+Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Columns and types](https://datanotes.dev/guides/database-objects/columns/), [Bases](https://datanotes.dev/guides/database-objects/bases/), [Relations and hierarchies](https://datanotes.dev/guides/database-objects/relations/), [Packs of rows](https://datanotes.dev/guides/database-objects/packs/), [Write and move rows](https://datanotes.dev/guides/read-and-write/write-rows/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/).
 
 | Parameter         | Type         | Required | Default | Description |
 | ----------------- | ------------ | -------- | ------- | ----------- |
@@ -34,6 +34,8 @@ Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/data
 | `time_column`     | string \\    | null     |         | `null`      |
 | `filename`        | string \\    | null     |         | `null`      |
 | `partition`       | string \\    | null     |         | `null`      |
+| `pack`            | string \\    | null     |         | `null`      |
+| `pack_after_days` | integer \\   | null     |         | `null`      |
 | `exclude`         | string\[] \\ | null     |         | `null`      |
 | `archive`         | string \\    | null     |         | `null`      |
 | `aliases`         | string\[] \\ | null     |         | `null`      |
@@ -65,11 +67,11 @@ Examples: [Tables](https://datanotes.dev/guides/database-objects/tables/).
 
 **Alter Table** · destructive write
 
-Alter a table: move it (`catalog`, `schema`), rename it (`name`), change `partition` / `filename` patterns, `description` (changes, never goes: “” is refused), `aliases`, `exclude` folders, `row_template` (“” removes it), `instructions` (how to fill a row, for agents; “” removes them), `history` (true | false | “default”), `autolink_target` (true | false | “default”: may automatic links link its rows? default: yes, unless its rows are named by a date or a time) or `tags` (key/value labels merged into the table’s, e.g. `{"domain": "health"}`; a `null` value removes that tag; `clear_tags: true` removes every tag first, so with `tags` the table keeps exactly those), `archive` (folder name inside the table folder) or `fields` (untyped fields, name → default; a `null` value removes one). Rows, archive and transaction log follow; links are updated; renamed rows keep their old name in `aliases`. A change of metadata only (tags, description, aliases, history, autolink_target, row_template, instructions, fields) rewrites the table entry alone: no row is moved or rewritten. Refused when a row cannot fill a pattern. Renaming or moving the table rewrites what names it in other definitions: the `ref` and `vocabulary` of the columns of other tables and bases (lists of links included) and the tables of views (`table`, `union[].table`, `join.table`); `schema_references` lists them. CHECKs and `ref_where` / `ref_by` that read it through a link follow the new `ref`. Use `dry_run` to see `planned_moves`; undo with undo_migration.
+Alter a table: move it (`catalog`, `schema`), rename it (`name`), change `partition` / `filename` patterns, `description` (changes, never goes: “” is refused), `aliases`, `exclude` folders, `row_template` (“” removes it), `instructions` (how to fill a row, for agents; “” removes them), `history` (true | false | “default”), `autolink_target` (true | false | “default”: may automatic links link its rows? default: yes, unless its rows are named by a date or a time) or `tags` (key/value labels merged into the table’s, e.g. `{"domain": "health"}`; a `null` value removes that tag; `clear_tags: true` removes every tag first, so with `tags` the table keeps exactly those), `archive` (folder name inside the table folder) or `fields` (untyped fields, name → default; a `null` value removes one). Rows, archive and transaction log follow; links are updated; renamed rows keep their old name in `aliases`. A change of metadata only (tags, description, aliases, history, autolink_target, row_template, instructions, fields, pack_after_days) rewrites the table entry alone: no row is moved or rewritten. `pack` sets the period of the table’s packs of rows (`"{occurred_at:YYYY-MM}"`; “” removes it), `pack_after_days` the days after a period’s end before its rows go into a pack (“default”: 7). While rows are in packs, changing `pack`, `partition`, `filename` or the table’s name is refused: unpack_rows first. Refused when a row cannot fill a pattern. Renaming or moving the table rewrites what names it in other definitions: the `ref` and `vocabulary` of the columns of other tables and bases (lists of links included) and the tables of views (`table`, `union[].table`, `join.table`); `schema_references` lists them. CHECKs and `ref_where` / `ref_by` that read it through a link follow the new `ref`. Use `dry_run` to see `planned_moves`; undo with undo_migration.
 
 The schema changes only through operations like this one: never edit metastore.yaml by hand (no validation, no undo).
 
-Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/).
+Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/database-objects/catalogs-and-schemas/), [Tables](https://datanotes.dev/guides/database-objects/tables/), [Packs of rows](https://datanotes.dev/guides/database-objects/packs/), [Automatic links](https://datanotes.dev/guides/read-and-write/automatic-links/), [Import existing notes](https://datanotes.dev/guides/read-and-write/import-notes/), [Table history and time travel](https://datanotes.dev/guides/history/table-history/).
 
 | Parameter         | Type         | Required       | Default | Description                                                          |
 | ----------------- | ------------ | -------------- | ------- | -------------------------------------------------------------------- |
@@ -78,6 +80,8 @@ Examples: [Catalogs, schemas and the database](https://datanotes.dev/guides/data
 | `schema`          | string \\    | null           |         | `null`                                                               |
 | `name`            | string \\    | null           |         | `null`                                                               |
 | `partition`       | string \\    | null           |         | `null`                                                               |
+| `pack`            | string \\    | null           |         | `null`                                                               |
+| `pack_after_days` | integer \\   | `"default"` \\ | null    |                                                                      |
 | `filename`        | string \\    | null           |         | `null`                                                               |
 | `description`     | string \\    | null           |         | `null`                                                               |
 | `aliases`         | string\[] \\ | null           |         | `null`                                                               |