@lotics/cli 0.284.3 → 0.286.0

package/docs/design.md

@@ -64,6 +64,7 @@ then check again. A note refuses nothing.
 | Papers to read | an act's `intake` with `fills` | `model/acts` |
 | Calls and visits | an act's `record` | `model/acts` |
 | Documents covering lines | a rows block with `under` | `model/blocks` |
+| Rows on file a record takes in | a rows block with `pick` | `model/blocks` |
 | One owner's question across jobs | a dashboard app | `model/dashboards` |
 
 ### Faces and pictures
@@ -167,7 +168,9 @@ default record: every field a person writes.
 
 Rows that each belong to one row of another entity (a one-row link to it) are drawn under that row: a `rows` block on
 its record, a `timeline` where they are a log, an `agenda` where they are planned on a day and within it, a roster of
-them, or lanes of them by that link. Which children a record lists is the author's — one of them at least.
+them, or lanes of them by that link. Which children a record lists is the author's — one of them at least. Rows on
+file before the row they come to belong to — a job's cost lines before the supplier bill over them — are picked into
+it: a rows block with `pick`, often with `create: false` and `remove: false`.
 
 ### Papers
 
@@ -188,12 +191,16 @@ placeholder, the reader ticking which to make. A template no act names is made b
 
 A paper the business is brought and reads is an act's `intake`: the press takes the papers, an agent reads
 them, and each is filed as the line of its kind in the child the record `expect`s, while `fills` writes what
-they state into the record's fields — shown before it is saved. Worked: `examples/case`.
+they state into the record's fields — a single link as a row the agent finds among those the app reads of its
+entity — shown before it is saved. Worked: `examples/case`.
 
 #### Under
 
 A rows block with `under`: the documents that cover lines (an invoice over its fee lines) stand as headings
-over the lines they cover, and a line no document covers offers to make one.
+over the lines they cover, and a line no document covers offers to make one. A document entered as it arrives,
+over lines already on file (a supplier bill), picks them from its own record instead: a rows block with `pick`.
+Choose one per document: a document a make covers lines by is never also picked into, since a pick does not check
+what the make does.
 
 ### Calls
 

package/package.json

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