@lotics/cli 0.287.0 → 0.288.0

package/docs/design.md

@@ -139,7 +139,9 @@ names them. Entries planned ahead are an `agenda`; the status's moves are its hi
 Rows a status stages towards its `closed` options move by acts: each moves one option on to the next (`when` the
 status holds it, `set` to the next), at the foot of the section whose work it ends. A status with nothing closed is a
 condition a person sets. A value decided as a row reaches an outcome — why it was lost, refused, voided — is that
-act's `asks`, never a field the reader must remember to fill.
+act's `asks`, never a field the reader must remember to fill. An act reaching past the workspace — sending an invoice
+to a service, a letter by mail — runs its `workflow`, and what the workflow keeps from the answer (an invoice's id,
+its link) is named in `writes`, the act's as what it sets is.
 
 #### History
 
@@ -168,7 +170,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. Rows on
+them, or lanes of them by that link. Which children a record lists is the author's — one of them at least. A block
+listing only some of them narrows by its `where`: a select (one leg's fees), or a yes/no — a formula's for what is
+still owed — on a block that adds no rows. 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`.
 

package/docs/examples.md

@@ -529,10 +529,12 @@ Every key: the `model` reference, at the pages each section names under **Keys**
         {"alias": "placed", "type": "date"},
         {"alias": "due_date", "type": "date"},
         {"alias": "total", "type": "rollup"},
+        {"alias": "balance", "type": "formula"},
         {"alias": "units_ordered", "type": "rollup"},
         {"alias": "units_shipped", "type": "rollup"},
         {"alias": "units_picked", "type": "rollup"},
-        {"alias": "notes", "type": "text", "format": "markdown"}
+        {"alias": "notes", "type": "text", "format": "markdown"},
+        {"alias": "paid_in_full", "type": "formula"}
       ]
     },
     {
@@ -627,6 +629,14 @@ Every key: the `model` reference, at the pages each section names under **Keys**
                 "columns": ["due_date"],
                 "create": false,
                 "where": {"stage": ["draft", "confirmed", "picking", "shipped"]}
+              },
+              {
+                "rows": "order",
+                "via": "customer",
+                "title": "Shipped, still owed",
+                "columns": ["balance"],
+                "create": false,
+                "where": {"stage": ["shipped", "delivered"], "paid_in_full": false}
               }
             ]
           },

package/package.json

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