@lotics/cli 0.311.3 → 0.311.5

package/docs/agent_surface.md

@@ -36,9 +36,9 @@ app has.
 | `<child>_by_<link>_picks` | The <child> rows no <entity> holds through "<link>" yet, that one <entity> may pick, narrowed by what the reader typed. | `search`?; `same_<link>` per `same` link | a block that picks existing rows into the record |
 | `register_reading_<n>` | <label>: how many <entity> rows there are. Each row carries `__count`. | the list's; `from`? / `to`? where the reading states `over`, or its `tab` is dated `in` a period; `to` where its `tab` is of rows `open` on a day | each of `register.readings` by its place among them, counted from 0 — but the work against its plan (`progress`), which reads the list's own rows; none over `books`. A reading stating `alias` is called by it |
 | `dashboard_reading_<n>` | <label>: how many <entity> rows there are. Each row carries `__count`. | `from`? / `to`? where the reading states `over` | each of a dashboard's readings, counted from 0; a reading stating `alias` is called by it |
-| `block_reading_<n>` | <label>: how many <child> rows there are. Each row carries `__count`. | `<entity>_id` | each reading or funnel block of the record, by its place among the record's blocks, counted from 0; a reading stating `alias` is called by it |
+| `block_reading_<n>` | <label>: how many <child> rows there are. Each row carries `__count`. | `<entity>_id`; `same_<field>` where it is a list stating `same` | each reading, list or funnel block of the record, by its place among the record's blocks, counted from 0; a reading stating `alias` is called by it |
 | `<entity>_register_reading_<n>` | <label>: how many <entity> rows there are. Each row carries `__count`. | the list's; `from`? / `to`? where the reading states `over` | each of a log's `register.readings` by its place among them, counted from 0, named by the log's entity; a reading stating `alias` is called `<entity>_<alias>` |
-| `<entity>_block_reading_<n>` | <label>: how many <child> rows there are. Each row carries `__count`. | `<entity>_id` | each reading or funnel block of the record a row of a book or of a log opens, by its place among that record's blocks, counted from 0, named by the book's or the log's entity |
+| `<entity>_block_reading_<n>` | <label>: how many <child> rows there are. Each row carries `__count`. | `<entity>_id`; `same_<field>` where it is a list stating `same` | each reading, list or funnel block of the record a row of a book or of a log opens, by its place among that record's blocks, counted from 0, named by the book's or the log's entity |
 | `<reading>_bound` | <label> / <bound>: the sum of "<bound>" over the <entity> rows. Each row carries `__count`, `__sum`. | its reading's | a metric whose value `records.limits` bounds: the bound's sum, beside the reading's own |
 | `<entity>_export_rows` | Every row of <entity> the reader may see, with every field "<template>" may print. | the list's | a `register.export` that fills a template |
 | `<entity>_export_rows_of_<book>` | Every row of <entity> the reader may see, with every field "<template>" may print. | the list's | a report of some of an app's `books`: their rows alone, each book named in turn |

package/docs/design.md

@@ -76,7 +76,7 @@ then check again. A note refuses nothing.
 | A log of what happened | a `timeline` block | `model/timeline-and-agenda` |
 | Opened to be worked on | the record's `sections`, in the order the work reaches them — `at` where it moves in steps | `model/record-page` |
 | A record whose page is its own arrangement of pieces the app already states | `record.compose` | `model/composed-page` |
-| Rows that each belong to another row | a `rows` block on that row's record | `model/blocks` |
+| Rows that each belong to another row | a `rows` block on that row's record; a `list` block where read-only | `model/blocks`, `model/list-block` |
 | Moving through a status | an act per move, `status.history`, and the register's `readings` | `model/acts`, `model/status`, `model/readings` |
 | Steps people drop out of between | a `funnel` block on the record whose child rows count them | `model/reading-blocks` |
 | A record's own numbers nobody keys, read at a glance | a `figures` block: two to eight of them as tiles, one holding nothing read as not measured | `model/reading-blocks` |

package/docs/examples.md

@@ -637,6 +637,12 @@ Every key: the `model` reference, at the pages each section names under **Keys**
                 "columns": ["balance"],
                 "create": false,
                 "where": {"stage": ["shipped", "delivered"], "paid_in_full": false}
+              },
+              {
+                "list": "service_visit",
+                "columns": ["engineer", "job"],
+                "app": "visits",
+                "label": "Service visits"
               }
             ]
           },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.311.3",
+  "version": "0.311.5",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {