@lotics/cli 0.321.18 → 0.321.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/design.md CHANGED
@@ -27,7 +27,8 @@ or its entity is read-only (`edit: false`); a stepped status never is, since Act
27
27
  a chart, a register its Readings, and long text reads whole (a markdown Field; `block: true` on plain long text).
28
28
  - An option with a `color` draws its dot where its select is drawn; one without reads as its word. A `mark` where a
29
29
  brand or glyph names the option, on every option of a select read down a column (how it was paid, the channel).
30
- - Every app states its tile's `color`, apart from the workspace's other apps where it can be.
30
+ - Every app states its tile's `color` and `icon`, each apart from the workspace's other apps where it can be: an
31
+ app stating no icon draws the one glyph every such app shares.
31
32
  - The paperwork is the proof of the work: a files field per purpose (what arrived, what was issued to the customer, the
32
33
  carrier, the authority) in the Section where that work happens, and the source of a
33
34
  figure (a screenshot, an email, a sheet) on its row. Every files field is drawn somewhere. A paper a counterparty
@@ -97,7 +98,7 @@ or its entity is read-only (`edit: false`); a stepped status never is, since Act
97
98
  - `figure` (alias): The one number the row stands for, read at its right (a total, a quantity left)
98
99
  - `status` (Status): The stage a row moves through, a single select, drawn in the record's head, or its Side where the Side states it
99
100
  - `due` (list of alias (at least one)): Dates that are deadlines (stored, or computed as a date)
100
- - `image` (alias): A files field that pictures the row, or a one-row link to a table with a picture, whose picture the row leads with
101
+ - `image` (alias | list of alias (at least one)): A files field that pictures the row, or a one-row link to a table with a picture, whose picture the row leads with
101
102
  - `party` (`"person"` | `"organization"` | `"organisation"`): What each row is where the rows are people (a contact, a patient) or organisations (a customer, a supplier, a carrier)
102
103
  - `limits` (map of alias → (alias | number)): A number read against a bound
103
104
  - `starts` (map of alias → `"today"` | `"me"`): What a field of a row being added starts at, where that start is certain
@@ -319,7 +320,7 @@ or several members, draws their faces as a stack that names them on hover. Worke
319
320
  scan, a receipt. Every row of it then leads with its picture, or its paper's preview, wherever it is drawn —
320
321
  a row holding no picture leads with the placeholder; a link to it previews the file. `image` may instead name a
321
322
  one-row link to a table with a picture (an order line's `item`): the row leads with that row's picture, still titled by
322
- its own words. Never a field an Act keeps the paper it makes in (`into`). List
323
+ its own words — or several in order (`["product", "bundle"]`, a line linking either), the first that holds a picture leading the row. Never a field an Act keeps the paper it makes in (`into`). List
323
324
  `layout: "cards"` where the picture is how a row is found. A files field the record keeps as a folder of
324
325
  papers is drawn as a Field, read whole. Worked: `examples/cards`.
325
326
 
@@ -350,7 +351,7 @@ machine, a room), each drawn even when empty: every row a block from the first d
350
351
  second, and a free stretch adds a row there. `loads` reads what a lane carries against what it holds: hours summed
351
352
  within each day (across days, the fullest day, named), any other number the most its rows add up to at one time. A
352
353
  `no_overlap` `by` the same link refuses two rows on one resource at once. A lane per person: `by` a member field
353
- and `of` a role of the model, each member of it a lane, idle ones too. Worked: `examples/lanes`.
354
+ and `of` a group of the workspace by its id, each member of it a lane, idle ones too. Worked: `examples/lanes`.
354
355
 
355
356
  A day's work given out (stops to drivers, jobs to technicians): rows holding a day and no hour read at one day as cards
356
357
  in lanes, those no lane holds, or holding no day, first in a tray. Each lane's head reads its count, its loads and its
@@ -440,7 +441,7 @@ stage is signed once per person, read off who moved the row.
440
441
 
441
442
  A List usually opens with one band of figures or a chart, chosen for what that person watches. Its Readings stand above the rows and its filters and read the rows under the open tab, never narrowed by the controls below them. Lead with the job's headline number —
442
443
  its exception as a formula's yes/no in a Reading's `where` (what is short), never a stage the
443
- status chips already count, nor the overdue rows the register's summary line counts from `records.due` — then at most the mix (`by` a field) and the movement (`by` a date), varied by job. A movement over a date is stated, never defaulted; so is a sum, but for the one a status register with a money figure leads with by default: that figure over its open rows. A register with no such figure and no single select to split by gets no default band.
444
+ status chips already count, nor the overdue rows the register's summary line counts from `records.due` — then at most the mix (`by` a field) and the movement (`by` a date), varied by job. A movement over a date is stated, never defaulted; so is a sum, but for the one a status register with a money figure leads with by default: that figure over its open rows, titled by them ("Price (open)"). A register with no such figure and no single select to split by gets no default band.
444
445
  A grid (`by` and `across`) reads on a Sheet. A Sheet — a View of Readings at the App's root, beside its Lists or alone —
445
446
  answers one owner's question across jobs, each Reading windowed by the reader's period (the App's `period`), and a
446
447
  List on it hands over the rows to act on. Many Readings stand on several Sheets, each a View the reader picks. A
package/docs/workflows.md CHANGED
@@ -895,7 +895,7 @@ write on that row; reads are real and nothing is written.
895
895
 
896
896
  | part of the header | what it holds |
897
897
  |---|---|
898
- | `type` | the write it follows: `create`, `update` or `delete` |
898
+ | `type` | the write it follows: `create`, `update` or `delete`; a `delete` workflow runs once, when the row is deleted; deleting it for good from the trash runs none |
899
899
  | `table` | the table's alias |
900
900
  | `when` | optional expression over `record`, `prev_record` and `changes`; the workflow runs only after a write where it is truthy |
901
901
  | `changed` | optional, with `type: "update"`: field aliases; the workflow runs only after an update that changes any one of them |
@@ -33,7 +33,7 @@ A record read carries `comment_count` (a workflow body gets it when it reads it)
33
33
 
34
34
  ## Deleting and restoring
35
35
 
36
- A keyed entry is removed by `null`: a field, check, view, option, instruction, query alias, a member or a group. A resource addressed by its id is deleted with `delete: true` and brought back with `restore: true`, beside its id: a table in a `set_tables` item (`{ table_id, delete: true }`; `cascade` deletes the links that point at the deleted tables and is refused unless the call deletes; `force` goes with a patch that loses stored values and is refused on a call that only deletes or restores), a knowledge doc (`set_knowledge` with `knowledge_doc_id`), a template (`set_template` with `template_id`), an app (`set_app` with `app_id`) and a workflow (`set_workflow` with `workflow_id`; a deletion only). Records are deleted by `delete_records` and brought back by `update_records` with `restore: true` and `record_ids` or `filters`: the rows their delete took come back with them, all or none, and a row needing its link stays deleted while the row it names does. `delete` takes no other key. A call that deletes asks for approval; one that does not never does.
36
+ A keyed entry is removed by `null`: a field, check, view, option, instruction, query alias, a member or a group. A resource addressed by its id is deleted with `delete: true` and brought back with `restore: true`, beside its id: a table in a `set_tables` item (`{ table_id, delete: true }`; `cascade` deletes the links that point at the deleted tables and is refused unless the call deletes; `force` goes with a patch that loses stored values and is refused on a call that only deletes or restores), a knowledge doc (`set_knowledge` with `knowledge_doc_id`), a template (`set_template` with `template_id`), an app (`set_app` with `app_id`) and a workflow (`set_workflow` with `workflow_id`; a deletion only). Records are deleted by `delete_records` and removed for good, once in the trash, by `delete_records` with `permanent: true` and `record_ids` or `filters` (an organization admin's own credential alone, never inside a workflow; the records and their comments go, their audit history stays), and brought back by `update_records` with `restore: true` and `record_ids` or `filters`: the rows their delete took come back with them, all or none, and a row needing its link stays deleted while the row it names does. `delete` takes no other key. A call that deletes asks for approval; one that does not never does.
37
37
 
38
38
  ## Locking and changing a locked record
39
39
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lotics/cli",
3
- "version": "0.321.18",
3
+ "version": "0.321.20",
4
4
  "description": "Lotics SDK and CLI for AI agents",
5
5
  "type": "module",
6
6
  "bin": {