@getmagical/cli 0.11.0 → 0.12.1

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/README.md CHANGED
@@ -31,6 +31,34 @@ mgcl automations run-draft --draft-automation-id ... --agent-id ... --idempotenc
31
31
  mgcl automations publish --draft-automation-id ... # non-production only: mgcl refuses against the production API, and the API rejects it too
32
32
  ```
33
33
 
34
+ ## Search automation runs
35
+
36
+ ```bash
37
+ mgcl automation-runs list --search 'REF-123456' --automation-id <id> --json
38
+ mgcl automation-runs list-page --search 'REF-123456' --limit 20 --page 0 --json
39
+ ```
40
+
41
+ Both commands search on the server before pagination and combine `--search`
42
+ with the existing automation, workflow, status, invocation-type, and date
43
+ filters. Search ignores outer whitespace, matches case-insensitively, and
44
+ looks for substrings in run IDs, automation names, run input/shared-input
45
+ values, and current Data Store leaf values. Empty or whitespace-only search
46
+ disables the search predicate while preserving the other filters. PostgreSQL `ILIKE` patterns apply:
47
+ `%` matches any sequence, `_` matches one character, and backslash escapes
48
+ pattern characters. NUL characters are rejected.
49
+
50
+ Nested input values and Data Store leaves are searched in their JSON text
51
+ representation, so escaped quotes or backslashes can cause misses. Prefer a
52
+ simpler identifying fragment, then inspect the candidate's actual values.
53
+
54
+ `list` returns an array. `list-page` returns `items`, `page`, `pageSize`,
55
+ `hasMore`, `total`, and `isTotalTruncated`. Use `hasMore` to continue paging;
56
+ when `isTotalTruncated` is true, `total` is only a lower bound. Searched pages
57
+ avoid counting all matches: totals become exact on a nonempty terminal page
58
+ or an empty first page. An empty page beyond the end cannot establish the
59
+ exact total. Random ordering supports only page 0 and searched random samples
60
+ always report a truncated total.
61
+
34
62
  ## Regression tests
35
63
 
36
64
  Choose how many historical baseline runs to test per pathway: