monday-cli 0.2.0

package/dist/commands/item/search.js

@@ -0,0 +1,322 @@
+/**
+ * `monday item search --board <bid> --where ...` — column-value search
+ * (`cli-design.md` §5.5, `v0.1-plan.md` §3 M4).
+ *
+ * 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.
+ *
+ * Why a separate command from `item list --where`: the endpoints
+ * are different. `items_page_by_column_values` is purpose-built for
+ * "find items where status=Done" lookups across the whole board,
+ * which is faster than walking + filtering when the agent already
+ * knows the value. `item list --where` runs the rule against
+ * 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.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { UsageError } from '../../utils/errors.js';
+import { loadBoardMetadata, refreshBoardMetadata, } from '../../api/board-metadata.js';
+import { parseWhereSyntax } from '../../api/filters.js';
+import { resolveColumnsAcrossClauses } from '../../api/columns.js';
+import { isMeToken } from '../../api/me-token.js';
+import { DEFAULT_PAGE_SIZE, paginate, } from '../../api/pagination.js';
+import { idFromRawItem, projectedItemSchema, } from '../../api/item-projection.js';
+import { ITEM_FIELDS_FRAGMENT, collectColumnHeads, projectFromRaw, resolveMeFactory, titleMap, } from '../../api/item-helpers.js';
+import { buildMeta } from '../../utils/output/envelope.js';
+import { selectOutput } from '../../utils/output/select.js';
+import { startNdjsonStream } from '../../utils/output/ndjson.js';
+import { collectSecrets } from '../../cli/envelope-out.js';
+const ITEMS_PAGE_BY_COLUMN_VALUES_QUERY = `
+  query ItemsByColumnValues(
+    $boardId: ID!
+    $limit: Int!
+    $columns: [ItemsPageByColumnValuesQuery!]!
+  ) {
+    items_page_by_column_values(
+      board_id: $boardId
+      limit: $limit
+      columns: $columns
+    ) {
+      cursor
+      items {
+        ${ITEM_FIELDS_FRAGMENT}
+      }
+    }
+  }
+`;
+const ITEMS_BY_COLUMN_VALUES_NEXT_QUERY = `
+  query ItemsByColumnValuesNext($cursor: String!, $limit: Int!) {
+    next_items_page(limit: $limit, cursor: $cursor) {
+      cursor
+      items {
+        ${ITEM_FIELDS_FRAGMENT}
+      }
+    }
+  }
+`;
+export const itemSearchOutputSchema = z.array(projectedItemSchema);
+const inputSchema = z
+    .object({
+    board: BoardIdSchema,
+    where: z.array(z.string()).min(1),
+    all: z.boolean().optional(),
+    limit: z.coerce.number().int().positive().max(10_000).optional(),
+    pageSize: z.coerce.number().int().positive().max(500).optional(),
+})
+    .strict();
+const buildColumnQueries = async (inputs) => {
+    // Reject non-equality operators upfront — the endpoint doesn't
+    // support them and validating before resolution avoids burning a
+    // metadata refresh on a doomed call.
+    for (const clause of inputs.clauses) {
+        if (clause.operator.kind !== 'equals') {
+            throw new UsageError(`item search supports only the = operator (got ${clause.operator.literal} ` +
+                `in ${JSON.stringify(clause.raw)}); use \`item list --where\` for richer filters`, { details: { clause: clause.raw, operator: clause.operator.literal } });
+        }
+    }
+    // R12 lift: cache-miss-refresh + collision-warning collection are
+    // shared with `api/filters.ts buildFilterRules`. The helper
+    // resolves every clause's column token; per-clause value resolution
+    // (`me` for people) stays here.
+    const resolved = await resolveColumnsAcrossClauses({
+        metadata: inputs.metadata,
+        tokens: inputs.clauses.map((c) => c.token),
+        ...(inputs.onColumnNotFound === undefined
+            ? {}
+            : { onColumnNotFound: inputs.onColumnNotFound }),
+    });
+    let cachedMe;
+    const me = async () => {
+        cachedMe ??= await inputs.resolveMe();
+        return cachedMe;
+    };
+    // Group clauses by resolved column ID, preserving insertion order
+    // for stable result diffs.
+    const byColumn = new Map();
+    for (let i = 0; i < inputs.clauses.length; i++) {
+        const clause = inputs.clauses[i];
+        const match = resolved.matches[i];
+        /* c8 ignore next 6 — defensive: matches.length === clauses.length
+           by helper contract; the index guard exists for
+           noUncheckedIndexedAccess narrowing only. */
+        if (clause === undefined || match === undefined) {
+            throw new UsageError(`buildColumnQueries: lost clause/match alignment at index ${String(i)}`);
+        }
+        /* c8 ignore next 4 — defensive: parser guarantees binary
+           operators carry a value. */
+        if (clause.value === undefined) {
+            throw new UsageError(`internal: missing value for ${clause.raw}`);
+        }
+        let value = clause.value;
+        // `isMeToken` is the shared (`api/me-token.ts`, R15) recogniser
+        // used by all three `me`-aware surfaces — `--where Owner=me`
+        // in filters.ts, `--set Owner=me` in api/people.ts, and this
+        // search-side filter. One rule across read filters and `--set`
+        // writes per cli-design §5.3 step 3 line 704-707.
+        if (match.column.type === 'people' && isMeToken(value)) {
+            value = await me();
+        }
+        const existing = byColumn.get(match.column.id);
+        if (existing === undefined) {
+            byColumn.set(match.column.id, [value]);
+        }
+        else {
+            existing.push(value);
+        }
+    }
+    const columns = [];
+    for (const [columnId, values] of byColumn) {
+        columns.push({ column_id: columnId, column_values: values });
+    }
+    return {
+        columns,
+        // ResolverWarning widens cleanly to envelope.Warning (narrower
+        // code literal, required details). Same straight assignment
+        // filters.ts uses post-R12.
+        warnings: resolved.warnings,
+        refreshed: resolved.refreshed,
+        metadata: resolved.metadata,
+    };
+};
+const initialFetcher = (client, boardId, columns) => {
+    return (effectiveLimit) => client.raw(ITEMS_PAGE_BY_COLUMN_VALUES_QUERY, { boardId, limit: effectiveLimit, columns }, { operationName: 'ItemsByColumnValues' });
+};
+const nextFetcher = (client) => {
+    return (cursor, effectiveLimit) => client.raw(ITEMS_BY_COLUMN_VALUES_NEXT_QUERY, { cursor, limit: effectiveLimit }, { operationName: 'ItemsByColumnValuesNext' });
+};
+const extractInitial = (r) => {
+    const page = r.data.items_page_by_column_values;
+    /* c8 ignore next 2 — defensive nullish-coalescing for missing
+       items_page_by_column_values; same rationale as item/list.ts. */
+    return { cursor: page?.cursor ?? null, items: page?.items ?? [] };
+};
+const extractNext = (r) => {
+    const page = r.data.next_items_page;
+    /* c8 ignore next 2 — defensive nullish-coalescing for missing
+       next_items_page; same rationale as item/list.ts. */
+    return { cursor: page?.cursor ?? null, items: page?.items ?? [] };
+};
+export const itemSearchCommand = {
+    name: 'item.search',
+    summary: 'Search items by column value (any_of) on one board',
+    examples: [
+        "monday item search --board 12345 --where 'status=Done'",
+        "monday item search --board 12345 --where 'status=Done' --where 'status=Backlog'",
+        'monday item search --board 12345 --where owner=me --json',
+        'monday item search --board 12345 --where status=Done --all --output ndjson',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: itemSearchOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'item', 'Item commands');
+        noun
+            .command('search')
+            .description(itemSearchCommand.summary)
+            .requiredOption('--board <bid>', 'board ID (required)')
+            .requiredOption('--where <expr>', 'repeatable: <col>=<val> only (no <, ~=, :is_empty)', (value, prev) => [...prev, value], [])
+            .option('--all', 'auto-paginate every page')
+            .option('--limit <n>', 'cap total items returned across pages')
+            .option('--page-size <n>', `page size (1-500, default ${String(DEFAULT_PAGE_SIZE)})`)
+            .addHelpText('after', ['', 'Examples:', ...itemSearchCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (opts) => {
+            const parsed = parseArgv(itemSearchCommand.inputSchema, opts);
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            const meta = await loadBoardMetadata({
+                client,
+                boardId: parsed.board,
+                env: ctx.env,
+                noCache: globalFlags.noCache,
+            });
+            const clauses = parsed.where.map(parseWhereSyntax);
+            const onColumnNotFound = meta.source === 'cache'
+                ? async () => {
+                    const refreshed = await refreshBoardMetadata({
+                        client,
+                        boardId: parsed.board,
+                        env: ctx.env,
+                    });
+                    return refreshed.metadata;
+                }
+                : undefined;
+            const queryResult = await buildColumnQueries({
+                metadata: meta.metadata,
+                clauses,
+                resolveMe: resolveMeFactory(client),
+                ...(onColumnNotFound === undefined ? {} : { onColumnNotFound }),
+            });
+            const { columns, warnings: filterWarnings } = queryResult;
+            const titles = titleMap(queryResult.metadata);
+            const columnHeads = collectColumnHeads(queryResult.metadata);
+            const pageSize = parsed.pageSize ?? DEFAULT_PAGE_SIZE;
+            const effectiveSource = meta.source === 'live' && !queryResult.refreshed ? 'live' : 'mixed';
+            const effectiveCacheAge = meta.cacheAgeSeconds;
+            const format = selectOutput({
+                json: globalFlags.json,
+                table: globalFlags.table,
+                ...(globalFlags.output === undefined ? {} : { output: globalFlags.output }),
+                env: ctx.env,
+                isTTY: ctx.isTTY,
+            });
+            // Streaming NDJSON path — emit per-arrival, then the §6.3
+            // trailer (matches item list's shape; both go through
+            // `paginate.onItem` and project through the same
+            // `projectFromRaw` callback). Bypasses emitSuccess because
+            // the streaming contract requires items hitting stdout
+            // before the walk completes. M18.
+            if (format === 'ndjson') {
+                const stream = startNdjsonStream({
+                    stream: ctx.stdout,
+                    secrets: collectSecrets(ctx.env),
+                    project: (raw) => projectFromRaw(raw, titles, { omitColumnTitles: true }),
+                });
+                const result = await paginate({
+                    fetchInitial: initialFetcher(client, parsed.board, columns),
+                    fetchNext: nextFetcher(client),
+                    now: ctx.clock,
+                    extractPage: (r) => {
+                        if ('next_items_page' in r.data)
+                            return extractNext(r);
+                        return extractInitial(r);
+                    },
+                    getId: idFromRawItem,
+                    all: parsed.all === true,
+                    ...(parsed.limit === undefined ? {} : { limit: parsed.limit }),
+                    pageSize,
+                    onItem: stream.onItem,
+                });
+                // §6.3 trailer-warnings pin: filterWarnings live on the
+                // success envelope when the caller picks JSON; in NDJSON
+                // they're dropped per the §6.3 "no warnings in trailer"
+                // rule. Same shape as item list's streaming branch.
+                void filterWarnings;
+                stream.writeTrailer(buildMeta({
+                    api_version: apiVersion,
+                    cli_version: ctx.cliVersion,
+                    request_id: ctx.requestId,
+                    source: effectiveSource,
+                    retrieved_at: ctx.clock().toISOString(),
+                    cache_age_seconds: effectiveCacheAge,
+                    complexity: result.complexity,
+                    next_cursor: result.nextCursor,
+                    has_more: result.hasMore,
+                    total_returned: result.totalReturned,
+                    columns: columnHeads,
+                }));
+                return;
+            }
+            const result = await paginate({
+                fetchInitial: initialFetcher(client, parsed.board, columns),
+                fetchNext: nextFetcher(client),
+                now: ctx.clock,
+                extractPage: (r) => {
+                    if ('next_items_page' in r.data)
+                        return extractNext(r);
+                    return extractInitial(r);
+                },
+                getId: idFromRawItem,
+                all: parsed.all === true,
+                ...(parsed.limit === undefined ? {} : { limit: parsed.limit }),
+                pageSize,
+            });
+            const data = result.items.map((raw) => 
+            // §6.3 same-board title de-dup: titles live in meta.columns,
+            // not on each row.
+            projectFromRaw(raw, titles, { omitColumnTitles: true }));
+            const warnings = [...filterWarnings, ...result.warnings];
+            emitSuccess({
+                ctx,
+                data,
+                schema: itemSearchCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                nextCursor: result.nextCursor,
+                hasMore: result.hasMore,
+                totalReturned: result.totalReturned,
+                columns: columnHeads,
+                warnings,
+                ...toEmit(result.lastResponse),
+                source: effectiveSource,
+                cacheAgeSeconds: effectiveCacheAge,
+            });
+        });
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/commands/item/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/commands/item/search.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,88 @@
+/**
+ * `monday item set <iid> (<col>=<val> | --set-raw <col>=<json>)` —
+ * single-column write (`cli-design.md` §4.3 + §5.3 + §5.3 escape-
+ * hatch, `v0.1-plan.md` §3 M5b, `v0.2-plan.md` §3 M8).
+ *
+ * Two argv shapes (mutually exclusive — exactly one fires per call):
+ *   1. **Friendly** — positional `<col>=<val>`. Resolves the column,
+ *      translates the value through `column-values.ts
+ *      translateColumnValueAsync`, dispatches via `selectMutation`.
+ *   2. **Raw** — `--set-raw <col>=<json>` (M8). Resolves the column,
+ *      runs the read-only-forever / files-shaped reject lists from
+ *      `raw-write.ts translateRawColumnValue`, dispatches via the
+ *      same `selectMutation` (always `change_column_value` for
+ *      single-column raw — never the simple variant per cli-design
+ *      §5.3 line 898-901).
+ *
+ * **Two paths.** `--dry-run` orchestrates the M5a engine
+ * (`api/dry-run.ts planChanges`) which reads the item state, builds
+ * the §6.4 `planned_changes` shape, and emits a dry-run envelope
+ * (`data: null`, `meta.dry_run: true`, `planned_changes: [{...}]`).
+ * Live writes resolve the column + translate the value + select the
+ * mutation + fire it directly, returning the projected item per §6.2.
+ * Both shapes go through the same dry-run + live paths.
+ *
+ * **Board resolution** (cli-design §5.3 step 1). `--board <bid>` is
+ * authoritative; without it the CLI calls `items(ids:[<iid>])` to
+ * read `board.id` and continues. The implicit-lookup result feeds
+ * both the live write and the dry-run engine — same answer, same
+ * source-of-truth (the item's current board).
+ *
+ * **Resolver-warning preservation.** Both paths thread collision /
+ * stale-cache-refreshed warnings into the success envelope via
+ * `warnings: [...]`. On error paths that surface AFTER resolution
+ * succeeded (the `column_archived` case the dry-run engine pins),
+ * the warnings fold into `error.details.resolver_warnings` so a
+ * stale-cache-then-archived flow doesn't lose the refresh signal.
+ *
+ * **Mutation kind selection** (`api/column-values.ts selectMutation`).
+ * Item set is single-`<col>=<val>` only:
+ *   - 1 simple type (text / long_text / numbers) →
+ *     `change_simple_column_value` (bare-string `value`).
+ *   - 1 rich type (status / dropdown / date / people) →
+ *     `change_column_value` (JSON object `value`).
+ * `change_multiple_column_values` is never selected by item set —
+ * that path lights up under `monday item update` (next session).
+ *
+ * Idempotent: yes — Monday's `change_*` mutations are idempotent
+ * (re-running with the same args produces the same item state).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type ProjectedItem } from '../../api/item-projection.js';
+export declare const itemSetOutputSchema: 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>;
+export type ItemSetOutput = ProjectedItem;
+declare const inputSchema: z.ZodObject<{
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    setExpr: z.ZodOptional<z.ZodString>;
+    setRaw: z.ZodOptional<z.ZodString>;
+    board: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+}, z.core.$strict>;
+export declare const itemSetCommand: CommandModule<z.infer<typeof inputSchema>, ItemSetOutput>;
+export {};
+//# sourceMappingURL=set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/commands/item/set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAgCnE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AA8CtC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsB,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;AAE1C,QAAA,MAAM,WAAW;;;;;kBAmBd,CAAC;AAEJ,eAAO,MAAM,cAAc,EAAE,aAAa,CACxC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,aAAa,CAwOd,CAAC"}