@lotics/cli 0.295.2 → 0.296.0

package/docs/data_model.md

@@ -186,6 +186,21 @@ backfilled, and null clears it. A select's or a member field's default is an ARR
 field holds one (`["Unread"]`, never `"Unread"`) — option names in `add_fields`, where the keys do
 not exist yet, and option keys (`opt_…`) in `update_fields`.
 
+`default_from` (text, number, date, boolean, select, select_member, select_record_link) copies a
+value onto a NEW record off the row one of its links names: `{ link_field_key, field_key,
+options? }`, the link of cardinality `"one"` and not itself copied, the source a field of the linked
+table of this field's own type, date format and notation (a link one to the same table) — a formula,
+a rollup, or a lookup through a one-row link (or an ordered one) read as the value it holds; several
+values only into a field holding several; never into a date `derive_from` stamps. It is
+copied when the record is made and never re-read, so a later change to the source leaves the record
+alone (a line's price as it was when the line was booked). A value the write states wins, then the
+copy, then `default_value`. A select source's `options` maps its option keys onto this field's
+(`update_fields`, once the keys exist); an option left unmapped is not copied. null clears it. Deleting the link a
+copy reads through, or the field it copies off, is refused even with `force` until the copy is
+cleared; the dependency report lists the copying field as `copy_link` or `copy_source` under
+`requires_manual_action`. Any other schema change that leaves a copy unable to stand — its source
+retyped, its link made to hold many — is refused, naming the copy.
+
 ### Computed fields
 
 Read-only in records. `formula` is one key holding an object; a rollup's and a lookup's properties

package/package.json

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