zinkee 0.1.41 → 0.1.42

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/AGENTS.md CHANGED
@@ -37,6 +37,7 @@ Use this order when reasoning about behavior:
37
37
  - `displays`
38
38
  - `automations`
39
39
  - `document-templates`
40
+ - `formulas`
40
41
 
41
42
  ## Implementation Shape
42
43
 
package/README.md CHANGED
@@ -18,6 +18,7 @@ Implemented command groups:
18
18
  - `displays`
19
19
  - `automations`
20
20
  - `document-templates`
21
+ - `formulas`
21
22
 
22
23
  ## Requirements
23
24
 
@@ -815,6 +816,27 @@ zinkee document-templates assets download <template-uuid> <asset-uuid> > contrac
815
816
 
816
817
  ---
817
818
 
819
+ ## Formula recalculation
820
+
821
+ Queue a full recalculation without changing the formula text. Acceptance means
822
+ the work was queued; it does not mean calculation has completed.
823
+
824
+ ```bash
825
+ zinkee formulas recompute field <schema> <field>
826
+ zinkee formulas recompute schema <schema> --yes
827
+ zinkee formulas recompute workspace --yes
828
+ ```
829
+
830
+ `schema` and `field` accept UUIDs or slugs. Prefer the smallest useful scope.
831
+ Schema and workspace recalculations require `--yes` because they can enqueue
832
+ substantial work and trigger dependent formula cascades. All three commands are
833
+ blocked by global `--read-only` mode.
834
+
835
+ Use `--json --example formulas recompute <scope>` for canonical payloads and
836
+ responses.
837
+
838
+ ---
839
+
818
840
  ## Discovery
819
841
 
820
842
  ```bash
@@ -825,5 +847,6 @@ zinkee --json automations list
825
847
  zinkee --json automations plugins list
826
848
  zinkee --json automations connections list
827
849
  zinkee --json document-templates list
850
+ zinkee --json formulas recompute field <schema> <field>
828
851
  zinkee --example <command path>
829
852
  ```