@lotics/cli 0.297.2 → 0.298.1

package/docs/design.md

@@ -62,9 +62,10 @@ then check again. A note refuses nothing.
 | 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` |
 | Rows that each belong to another row | a `rows` block on that row's record | `model/blocks` |
 | 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` |
 | Counted over a period | the register's `tabs` over one `period`; an `open` tab's `where` reads only what was true at the period's end, never a status the row moves on from | `model/tabs` |
 | Papers a case gathers | a rows block with `expect`; the papers made, an act's `templates` | `model/blocks`, `model/papers-and-recordings` |
-| Papers to read | an act's `intake` with `fills` | `model/papers-and-recordings` |
+| Papers an agent reads, where the owner asked for one | an act's `intake` with `fills` | `model/papers-and-recordings` |
 | Calls and visits | an act's `record` | `model/papers-and-recordings` |
 | Documents covering lines | a rows block with `under` | `model/blocks` |
 | Rows on file a record takes in | a rows block with `pick` | `model/blocks` |
@@ -174,6 +175,15 @@ A `pivot` reads on a dashboard. A dashboard app (`dashboard`) answers one owner'
 reading windowed by the period the reader picks, and a `list` reading hands over the rows to act on. A
 record's `metric`, `breakdown` and `trend` blocks read its own child rows. Worked: `examples/approval`, `examples/dashboard`.
 
+#### Funnel
+
+A `funnel` block reads a record's child rows as steps, each a number column summed over them — a week's channels
+from impressions to bookings, an order's lines from ordered to shipped. It states how much of the first step
+each later one keeps, the share lost between two neighbours, and the last over the first. State two to eight
+`steps` in one unit; where the path turns — reach, then conversion — state two blocks, so the second's bars are
+read over its own first step. A step no row holds a number in reads as not measured, so leave a count empty
+rather than typing a zero nobody measured.
+
 ### The record
 
 #### Sections
@@ -214,6 +224,10 @@ them, and each is filed as the line of its kind in the child the record `expect`
 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`.
 
+An agent act — an `intake`, a `record`'s `fills` — spends a run on every press and writes what the record
+says, so it is stated only where the owner asked for an agent to do that job; otherwise a paper brought is its
+line of the `expect` block, and a person types what it states.
+
 #### Under
 
 A rows block with `under`: the documents that cover lines (an invoice over its fee lines) stand as headings
@@ -228,7 +242,7 @@ what the make does.
 
 An act's `record`: the press records a call, visit or meeting — its audio, its transcript, its screen where
 captured — and files it as a new row of the record's `timeline` child (`into`), stamped `at` and `by`;
-`fills` lets an agent fill that row's fields from the transcript. Worked: `examples/calls`.
+`fills` lets an agent fill that row's fields from the transcript, where the owner asked for one. Worked: `examples/calls`.
 
 ## The visual bar
 

package/docs/workflows.md

@@ -47,7 +47,7 @@ const open = await query_records({
 await send_email({
   to: "team@example.com",
   subject: "Weekly digest",
-  body: `${size(open.records)} tickets open as of ${formatDate(now(), "YYYY-MM-DD")}.`,
+  body: `${size(open.records)} tickets open as of ${formatDate(now(), "yyyy-MM-dd")}.`,
 });
 ```
 

package/package.json

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