monday-cli 0.2.0 → 0.3.0

package/dist/commands/item/search.d.ts

@@ -1,12 +1,33 @@
 /**
- * `monday item search --board <bid> --where ...` — column-value search
- * (`cli-design.md` §5.5, `v0.1-plan.md` §3 M4).
+ * `monday item search [--board <bid> | --workspace <wid> | --favorites]
+ * --where ...` — column-value search across one or many boards
+ * (`cli-design.md` §5.5 / §13 v0.3 entry, `v0.1-plan.md` §3 M4,
+ * `v0.3-plan.md` §3 M23).
  *
- * Backed by Monday's `items_page_by_column_values` endpoint — a
- * narrower surface than `items_page`'s `query_params.rules`:
- * value-equality only, AND across columns, OR within a column's
- * values. Items matching ANY of the listed values for a given
- * column count as a hit.
+ * **v0.1 single-board path (`--board <bid>` set).** Backed by
+ * Monday's `items_page_by_column_values` endpoint — a narrower
+ * surface than `items_page`'s `query_params.rules`: value-equality
+ * only, AND across columns, OR within a column's values. Items
+ * matching ANY of the listed values for a given column count as a
+ * hit.
+ *
+ * **v0.3-M23 cross-board path (`--board` omitted; `--workspace <wid>`,
+ * `--favorites`, or no scoping lever set — all-accessible-boards
+ * mode).** Uses a different shape on the wire: `boards(ids: [...])
+ * { items_page(query_params: { rules }) }` fan-out via
+ * `src/api/cross-board-search.ts`. Per-board cursors, per-board
+ * column resolution, `--max-boards 25` default cap (hard cap 100
+ * per Decision 5 closure `3a2f1db`). At most ONE of `--board` /
+ * `--workspace` / `--favorites` may be supplied — supplying two
+ * raises `usage_error` at the input-schema layer. **Runtime body
+ * shipped at `1f09a25`** — `--favorites` calls `fetchBoardFavorites`
+ * for the ID set; `--workspace <wid>` enumerates via
+ * `boards(workspace_ids:[wid])`; no scoping lever enumerates
+ * `boards(limit:N)` for all-accessible mode. Per-board column-
+ * resolution pre-pass surfaces `column_not_found_on_board` warnings
+ * for boards lacking the `--where` columns; the walker fans out
+ * over the surviving plans + surfaces `inaccessible_boards` /
+ * `cross_board_truncated` warnings per the empirical-probe findings.
  *
  * Why a separate command from `item list --where`: the endpoints
  * are different. `items_page_by_column_values` is purpose-built for
@@ -16,17 +37,19 @@
  * Monday's full filter DSL (any_of, contains_text, comparators,
  * is_empty) but pays the per-page complexity cost.
  *
- * v0.1 surface: only the `=` operator is supported via this command.
- * Multiple `--where status=A --where status=B` against the same
- * column merge into one entry with `[A, B]` (OR within column).
- * Multiple columns AND across entries. Anything else (`~=`, `<`,
- * `:is_empty`, etc.) raises `usage_error` — agents pick `item
- * list --where` for the richer surface.
+ * v0.1 single-board operator surface: only the `=` operator is
+ * supported via this command. Multiple `--where status=A --where
+ * status=B` against the same column merge into one entry with
+ * `[A, B]` (OR within column). Multiple columns AND across entries.
+ * Anything else (`~=`, `<`, `:is_empty`, etc.) raises `usage_error`
+ * — agents pick `item list --where` for the richer surface. Same
+ * operator surface applies to the cross-board path.
  *
  * Idempotent: yes.
  */
 import { z } from 'zod';
 import { type CommandModule } from '../types.js';
+import { type CrossBoardSearchOutput } from '../../api/cross-board-search.js';
 import { type ProjectedItem } from '../../api/item-projection.js';
 export declare const itemSearchOutputSchema: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -55,13 +78,74 @@ export declare const itemSearchOutputSchema: z.ZodArray<z.ZodObject<{
     }, z.core.$loose>>;
 }, z.core.$strict>>;
 export type ItemSearchOutput = readonly ProjectedItem[];
+/**
+ * The command-registry-facing output schema. Per Codex round-2 P1-1,
+ * `monday item search`'s registry-level `outputSchema` is a union of
+ * the v0.1 single-board projection (`itemSearchOutputSchema` —
+ * `ProjectedItem[]`) AND the v0.3-M23 cross-board projection
+ * (`crossBoardSearchOutputSchema` — `CrossBoardItem[]`, each item
+ * carrying its source board id+name). The action body emits via
+ * the branch-specific schema (single-board uses
+ * `itemSearchOutputSchema` for the existing v0.1 path; cross-board
+ * uses `crossBoardSearchOutputSchema` at M23 implementation). The
+ * UNION here keeps `monday schema item.search` accurate to the
+ * runtime output across both branches.
+ *
+ * **Why a plain union and not a discriminated union.** The two
+ * shapes overlap on `id` / `name` but differ on the `board` slot
+ * (absent in single-board; required object in cross-board). Adding
+ * an explicit `cross_board: true` discriminator to one branch
+ * would carry-cost on every cross-board row for marginal agent
+ * value (the presence of the `board` slot itself discriminates).
+ * Agents that care can check `'board' in item`; agents that just
+ * want `id`/`name` consume both shapes uniformly.
+ */
+export declare const itemSearchCommandOutputSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    board_id: z.ZodNullable<z.ZodString>;
+    group_id: z.ZodNullable<z.ZodString>;
+    parent_item_id: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodNullable<z.ZodString>;
+    columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        text: z.ZodNullable<z.ZodString>;
+        value: z.ZodUnknown;
+        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        people: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>;
+}, z.core.$strict>>, z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    state: z.ZodNullable<z.ZodString>;
+    board: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>;
+    column_values: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>>]>;
+export type ItemSearchCommandOutput = ItemSearchOutput | CrossBoardSearchOutput;
 declare const inputSchema: z.ZodObject<{
-    board: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    board: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    workspace: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">>;
+    favorites: z.ZodOptional<z.ZodBoolean>;
+    maxBoards: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     where: z.ZodArray<z.ZodString>;
     all: z.ZodOptional<z.ZodBoolean>;
     limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     pageSize: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
-export declare const itemSearchCommand: CommandModule<z.infer<typeof inputSchema>, ItemSearchOutput>;
+export declare const itemSearchCommand: CommandModule<z.infer<typeof inputSchema>, ItemSearchCommandOutput>;
 export {};
 //# sourceMappingURL=search.d.ts.map

package/dist/commands/item/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/item/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAmBnE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAmDtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;mBAA+B,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,SAAS,aAAa,EAAE,CAAC;AAExD,QAAA,MAAM,WAAW;;;;;;kBAQN,CAAC;AAgJZ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAwKjB,CAAC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/item/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAOL,KAAK,sBAAsB,EAE5B,MAAM,iCAAiC,CAAC;AAmBzC,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAsDtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;mBAA+B,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,SAAS,aAAa,EAAE,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAGxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,sBAAsB,CAAC;AAEhF,QAAA,MAAM,WAAW;;;;;;;;;kBAkEb,CAAC;AAmWL,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,uBAAuB,CA+WxB,CAAC"}