monday-cli 0.2.0

package/dist/commands/item/move.js

@@ -0,0 +1,560 @@
+/**
+ * `monday item move <iid> --to-group <gid> [--to-board <bid>]
+ *  [--columns-mapping <json>] [--dry-run]` — move an item between
+ * groups (same-board) or between boards (cross-board).
+ *
+ * The fourth and final lifecycle verb closing M11 — together with M10's
+ * `archive` / `delete` / `duplicate`, completes the four-verb set
+ * Monday's API exposes (`archive_item` / `delete_item` /
+ * `duplicate_item` / `move_item_to_group` / `move_item_to_board`).
+ *
+ * **Two transports under one verb.**
+ *   - `--to-group <gid>` alone → calls `move_item_to_group`.
+ *     Same-board move; no column re-resolution; single round-trip live.
+ *   - `--to-group <gid> --to-board <bid>` → calls `move_item_to_board`.
+ *     Cross-board move; Monday requires `group_id: ID!` on the target
+ *     board (cli-design §4.3 line 530's mutual-exclusion was misleading
+ *     pre-M11 — the cross-board path needs the destination group too,
+ *     so `--to-group` is required for both forms; the §9 precondition
+ *     diff updates the line during the M11 docs sweep).
+ *   - `--to-board <bid>` alone (no `--to-group`) → `usage_error`. There
+ *     is no Monday-side default for the destination group.
+ *
+ * **`--columns-mapping <json>` (cross-board only).** A JSON object
+ * mapping source column IDs to target column IDs, e.g.
+ * `'{"status": "status_42", "due": "deadline"}'`. Maps directly to
+ * Monday's `columns_mapping: [ColumnMappingInput!]` parameter where
+ * `ColumnMappingInput = { source: ID!, target?: ID }` — strictly
+ * ID-to-ID, no value translation (per the SDK 14.0.0 typing at
+ * `node_modules/@mondaydotcomorg/api/dist/esm/index.d.ts:551`).
+ *
+ * **Strict default per §8 decision 5.** Monday's permissive default
+ * silently drops column values whose source ID doesn't exist on the
+ * target board. The CLI rejects unmatched columns pre-mutation with
+ * `usage_error` carrying `details.unmatched: [{source_col_id,
+ * source_title, source_type}]` and a `--columns-mapping` example so
+ * the agent knows exactly which columns need a mapping. Empty
+ * `--columns-mapping {}` is the explicit "drop everything (Monday's
+ * permissive default)" opt-in.
+ *
+ * **Value-overrides deferred to v0.3.** v0.2-plan §3 M11 mentioned a
+ * richer `{<src>: { id: <target>, value: <translation override> }}`
+ * form whose `value` re-runs through M5a/M8's translator on target
+ * metadata. Monday's `ColumnMappingInput` doesn't carry a value slot
+ * — supporting it would require a non-atomic post-move
+ * `change_multiple_column_values` mutation with partial-failure
+ * envelope shapes that don't yet have a precedent. Deferred; agents
+ * fire `monday item set <iid> <target>=<value>` post-move when they
+ * need value overrides. Captured in v0.2-plan §15 post-mortem.
+ *
+ * **Leg ordering.**
+ *   - **Same-board live:** single round-trip — `move_item_to_group`
+ *     directly. `meta.source: "live"`.
+ *   - **Same-board dry-run:** single round-trip — read source via
+ *     `readSourceItemForDryRun({operationName: 'ItemMoveRead'})`.
+ *     `meta.source: "live"`.
+ *   - **Cross-board live:** four legs — `lookupItemBoard` (source
+ *     board) + `loadBoardMetadata(source)` + `loadBoardMetadata(target)`
+ *     (parallel) + the unmatched check + `move_item_to_board`.
+ *     `meta.source` aggregates via `mergeSource` because the metadata
+ *     loads can hit cache.
+ *   - **Cross-board dry-run:** three legs — `readSourceItemForDryRun`
+ *     (also surfaces the source-item snapshot for the envelope) +
+ *     `lookupItemBoard` + `loadBoardMetadata(target)` + the unmatched
+ *     check. No mutation fires.
+ *
+ * **Idempotent: false.** Same-board (`move_item_to_group`) is
+ * idempotent on Monday's side per cli-design §9.1 — re-running with
+ * the item already in the target group is a wire-level no-op. But
+ * cross-board (`move_item_to_board`) re-running where the item is
+ * already on the target board is undefined behaviour (the SDK doesn't
+ * commit either way), so the verb-level marker stays `false`
+ * conservatively. Mirrors `monday item create`'s "the verb's
+ * idempotency is the conservative bound across all paths" rationale.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema, GroupIdSchema, ItemIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { ITEM_FIELDS_FRAGMENT } from '../../api/item-helpers.js';
+import { projectMutationItem } from '../../api/item-mutation-result.js';
+import { readSourceItemForDryRun } from '../../api/item-source-read.js';
+import { lookupItemBoard } from '../../api/item-board-lookup.js';
+import { loadBoardMetadata } from '../../api/board-metadata.js';
+import { SourceAggregator } from '../../api/source-aggregator.js';
+import { parseColumnMappingJson, } from '../../api/column-mapping.js';
+import { UsageError } from '../../utils/errors.js';
+import { projectedItemSchema, } from '../../api/item-projection.js';
+// Same-board mutation. `move_item_to_group(item_id, group_id)` returns
+// the moved item directly with the (unchanged) board_id and the new
+// group_id; we project through the same `ITEM_FIELDS_FRAGMENT` archive
+// + delete + duplicate use so the envelope's `data` shape stays
+// byte-identical to `item get`.
+const MOVE_ITEM_TO_GROUP_MUTATION = `
+  mutation ItemMoveToGroup($itemId: ID!, $groupId: String!) {
+    move_item_to_group(item_id: $itemId, group_id: $groupId) {
+      ${ITEM_FIELDS_FRAGMENT}
+    }
+  }
+`;
+// Cross-board mutation. Monday's `move_item_to_board` requires
+// `group_id: ID!` (the destination group on the target board) and
+// optionally accepts `columns_mapping: [ColumnMappingInput!]` where
+// `ColumnMappingInput = { source: ID!, target?: ID }`. The CLI's
+// `--columns-mapping <json>` parses to that shape directly.
+const MOVE_ITEM_TO_BOARD_MUTATION = `
+  mutation ItemMoveToBoard(
+    $itemId: ID!
+    $boardId: ID!
+    $groupId: ID!
+    $columnsMapping: [ColumnMappingInput!]
+  ) {
+    move_item_to_board(
+      item_id: $itemId
+      board_id: $boardId
+      group_id: $groupId
+      columns_mapping: $columnsMapping
+    ) {
+      ${ITEM_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const itemMoveOutputSchema = projectedItemSchema;
+const inputSchema = z
+    .object({
+    itemId: ItemIdSchema,
+    toGroup: GroupIdSchema,
+    // `--to-board` is optional. When set, the mutation routes to
+    // `move_item_to_board` (cross-board); when absent, to
+    // `move_item_to_group` (same-board).
+    toBoard: BoardIdSchema.optional(),
+    // Pre-parsed mapping. The argv layer parses + validates the JSON
+    // string via `parseColumnMappingJson` before this schema runs;
+    // the schema sees a typed `ColumnMapping` (Record<string, string>)
+    // or `undefined`. Using `z.record` rather than `z.custom` so
+    // `monday schema` can emit a proper JSON Schema for `--columns-
+    // mapping` (z.custom can't be represented in JSON Schema).
+    columnsMapping: z
+        .record(z.string().min(1), z.string().min(1))
+        .optional(),
+})
+    .strict();
+/**
+ * Computes the planned `columns_mapping` array for a cross-board move
+ * and rejects any unmatched source columns that aren't covered by the
+ * agent-supplied mapping (cli-design §8 decision 5 — strict default).
+ *
+ * "Unmatched" = source column whose ID doesn't exist on the target
+ * board AND isn't covered by `--columns-mapping`. Source columns whose
+ * IDs match a target column ID verbatim are auto-mapped (Monday would
+ * have done this anyway — we make it explicit in `columns_mapping` so
+ * the dry-run echo is comprehensive).
+ *
+ * Empty `--columns-mapping {}` is the explicit "drop everything"
+ * opt-in: it bypasses the unmatched check entirely and passes an
+ * empty mapping array to Monday, matching Monday's permissive default
+ * behaviour.
+ */
+const planColumnMappings = ({ sourceColumnIds, sourceColumnsById, targetColumnIds, mapping, }) => {
+    // Empty `{}` — the explicit "drop everything" opt-in. Skip the
+    // unmatched check entirely; Monday's permissive default applies.
+    if (mapping !== undefined && Object.keys(mapping).length === 0) {
+        return { columnsMapping: [], echo: [] };
+    }
+    const planned = [];
+    const unmatched = [];
+    const invalidMappings = [];
+    for (const sourceId of sourceColumnIds) {
+        // Check the explicit mapping first. The mapping wins over a
+        // verbatim ID match — agents can rename a same-ID column on
+        // purpose by mapping it to a different target.
+        const mapped = mapping?.[sourceId];
+        if (mapped !== undefined) {
+            // Round-2 P2 (F2): validate the mapped target exists on the
+            // target board. The parser only checks JSON shape (non-empty
+            // string); without this gate `--columns-mapping
+            // '{"status_4":"typo"}'` would bypass the strict-default
+            // unmatched check and reach Monday with a bogus target ID
+            // (silently dropped server-side). We have target metadata
+            // already loaded — fail loud here so the "reject before silent
+            // drop" guarantee covers typo'd mapping targets too.
+            if (!targetColumnIds.has(mapped)) {
+                invalidMappings.push({ source_col_id: sourceId, target_col_id: mapped });
+                continue;
+            }
+            planned.push({ source: sourceId, target: mapped });
+            continue;
+        }
+        // Verbatim ID match: source column with the same ID exists on
+        // target. This is Monday's default behaviour, but we surface it
+        // explicitly in `columns_mapping` so the dry-run echo is
+        // comprehensive.
+        if (targetColumnIds.has(sourceId)) {
+            planned.push({ source: sourceId, target: sourceId });
+            continue;
+        }
+        // Unmatched: collect with details so the agent gets the
+        // information they need to add a `--columns-mapping` entry.
+        const sourceCol = sourceColumnsById.get(sourceId);
+        unmatched.push({
+            source_col_id: sourceId,
+            source_title: sourceCol?.title ?? sourceId,
+            source_type: sourceCol?.type ?? 'unknown',
+        });
+    }
+    if (invalidMappings.length > 0) {
+        throw new UsageError(`Cross-board move's --columns-mapping points at ${String(invalidMappings.length)} target column(s) that don't exist on the target board.`, {
+            details: {
+                invalid_mappings: invalidMappings,
+                hint: 'verify the target column IDs against `monday board describe ' +
+                    '<target_bid>`; the source IDs map to target IDs that must ' +
+                    'already exist (move does not create columns).',
+            },
+        });
+    }
+    if (unmatched.length > 0) {
+        throw new UsageError(`Cross-board move would drop ${String(unmatched.length)} column ` +
+            `value(s) because no target column matches. Pass ` +
+            `--columns-mapping '{"<source_col_id>": "<target_col_id>", ...}' ` +
+            `to bridge each unmatched column, or --columns-mapping '{}' to ` +
+            `accept Monday's permissive default (silently drop unmatched).`, {
+            details: {
+                unmatched,
+                example_mapping: Object.fromEntries(unmatched.map((u) => [u.source_col_id, '<target_col_id>'])),
+            },
+        });
+    }
+    return { columnsMapping: planned, echo: planned };
+};
+/**
+ * Recursive "has content" check for a parsed wire value.
+ *
+ * Round-2 P1 (F1): the round-1 fix only treated `null`/`undefined` as
+ * empty, missing the "rich clear" shapes Monday + the M5b clear
+ * translator both produce — `{}`, `{label: null, index: null}`,
+ * `{date: null, time: null}`, `{personsAndTeams: []}`, etc. (see
+ * `column-values.ts` clear payloads + `item-projection.test.ts`
+ * cleared-date case). A cleared status / date / people cell with
+ * `value: "{}"` parses to `{}` and the round-1 filter wrongly
+ * counted it as "has data", re-introducing the F1 bug for the
+ * rich-clear case.
+ *
+ * Semantic emptiness here:
+ *   - `null` / `undefined` → empty.
+ *   - String → empty when zero-length. Non-empty strings carry data.
+ *   - Number / boolean → always has content (`0` and `false` are
+ *     legitimate values for numeric / checkbox cells).
+ *   - Array → has content when ANY element has content.
+ *   - Object → has content when ANY value has content (recursive).
+ *
+ * The recursion stops at primitive leaves; cyclic objects shouldn't
+ * appear in JSON-parsed wire payloads, so no cycle guard.
+ */
+const valueHasContent = (v) => {
+    if (v === null || v === undefined)
+        return false;
+    if (typeof v === 'string')
+        return v.length > 0;
+    if (typeof v === 'number' || typeof v === 'boolean')
+        return true;
+    if (Array.isArray(v))
+        return v.some(valueHasContent);
+    if (typeof v === 'object') {
+        return Object.values(v).some(valueHasContent);
+    }
+    /* c8 ignore next — symbol / bigint / function aren't representable
+       in JSON-parsed Monday payloads; defensive. */
+    return true;
+};
+/**
+ * Returns true when the projected column carries actual data — i.e.,
+ * a semantically non-empty wire value (recursive check) or a non-
+ * empty human-readable `text`. Empty cells (cleared rich shapes like
+ * `{}`, empty arrays, all-null leaves, or empty `text`) aren't worth
+ * mapping because Monday wouldn't carry a value across the move
+ * anyway.
+ *
+ * Why both `value` and `text`. Monday returns `text` even for read-
+ * only-shaped cells whose structured `value` is null/empty (e.g.
+ * `creation_log` rendering "Alice 5 minutes ago"). Either signal
+ * counts as "has data" for the unmatched check — agents reading the
+ * strict-default error want a precise list of what would be
+ * dropped, not noise from empty cells they never touched.
+ */
+const cellHasData = (col) => {
+    if (typeof col.text === 'string' && col.text.length > 0)
+        return true;
+    return valueHasContent(col.value);
+};
+/**
+ * Builds the de-duplicated set of source column IDs the item has a
+ * value in (i.e., the columns whose values would be lost without a
+ * mapping). The projection includes every wire `column_values` entry
+ * — even empty ones — so we filter here per `cellHasData`. Codex
+ * round-1 P1 (F1): pre-fix the function returned `Object.keys(source.
+ * columns)` and the strict-default check fired for empty unmatched
+ * source columns, blocking moves on otherwise-valid boards.
+ */
+const collectSourceColumnIds = (source) => {
+    const ids = [];
+    for (const [id, col] of Object.entries(source.columns)) {
+        if (cellHasData(col))
+            ids.push(id);
+    }
+    return ids;
+};
+export const itemMoveCommand = {
+    name: 'item.move',
+    summary: 'Move an item to a different group (same-board) or board (cross-board)',
+    examples: [
+        'monday item move 12345 --to-group new_group_id',
+        'monday item move 12345 --to-group topics --to-board 67890',
+        'monday item move 12345 --to-group topics --to-board 67890 \\',
+        "  --columns-mapping '{\"status_4\": \"status_42\"}'",
+        'monday item move 12345 --to-group topics --to-board 67890 --dry-run',
+    ],
+    // Same-board (`move_item_to_group`) is idempotent on Monday's side
+    // per cli-design §9.1 — re-running with the item already in the
+    // target group is a wire-level no-op. Cross-board
+    // (`move_item_to_board`) re-running where the item is already on
+    // the target board is undefined SDK behaviour, so the verb-level
+    // marker stays `false` conservatively. Mirrors `monday item create`
+    // (the verb's idempotency is the conservative bound across all paths).
+    idempotent: false,
+    inputSchema,
+    outputSchema: itemMoveOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'item', 'Item commands');
+        noun
+            .command('move <itemId>')
+            .description(itemMoveCommand.summary)
+            .requiredOption('--to-group <gid>', 'destination group on the target board (or current board for same-board moves)')
+            .option('--to-board <bid>', 'destination board id; without this the move stays on the current board')
+            .option('--columns-mapping <json>', "JSON {'<source_col_id>': '<target_col_id>'} mapping for cross-board moves; '{}' = drop unmatched (Monday default)")
+            .addHelpText('after', ['', 'Examples:', ...itemMoveCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (itemId, opts) => {
+            // Pre-parse the `--columns-mapping` JSON string before the zod
+            // schema runs so the schema sees a typed `ColumnMapping` (not
+            // a raw JSON-blob string). `parseColumnMappingJson` raises
+            // `usage_error` on malformed JSON, non-object roots, or
+            // non-string values per the cli-design §5.3 escape-hatch
+            // contract pattern.
+            const rawOpts = opts;
+            const columnsMapping = rawOpts.columnsMapping === undefined
+                ? undefined
+                : parseColumnMappingJson(rawOpts.columnsMapping);
+            const parsed = parseArgv(itemMoveCommand.inputSchema, {
+                itemId,
+                toGroup: rawOpts.toGroup,
+                ...(rawOpts.toBoard === undefined ? {} : { toBoard: rawOpts.toBoard }),
+                ...(columnsMapping === undefined ? {} : { columnsMapping }),
+            });
+            // Cross-board-only flag arrives without `--to-board` — usage
+            // error rather than silently dropping the mapping. cli-design
+            // §3.1 keeps argv mistakes loud.
+            if (parsed.toBoard === undefined && parsed.columnsMapping !== undefined) {
+                throw new UsageError('--columns-mapping is only valid with --to-board (cross-board moves)', {
+                    details: {
+                        hint: 'omit --columns-mapping for same-board moves; for cross-board, add --to-board <bid>',
+                    },
+                });
+            }
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            // Branch on transport. Same-board path: `move_item_to_group`
+            // (no metadata loads, no mapping check). Cross-board path:
+            // `move_item_to_board` (source + target metadata loads,
+            // unmatched check, mapping wire payload).
+            if (parsed.toBoard === undefined) {
+                await runSameBoardMove({
+                    ctx,
+                    program,
+                    client,
+                    apiVersion,
+                    toEmit,
+                    globalFlags,
+                    parsed,
+                });
+            }
+            else {
+                await runCrossBoardMove({
+                    ctx,
+                    program,
+                    client,
+                    apiVersion,
+                    toEmit,
+                    globalFlags,
+                    parsed,
+                    // Type narrowing — cross-board path requires --to-board.
+                    toBoard: parsed.toBoard,
+                });
+            }
+        });
+    },
+};
+const runSameBoardMove = async ({ ctx, program, client, apiVersion, toEmit, globalFlags, parsed, }) => {
+    if (globalFlags.dryRun) {
+        // Single-leg dry-run: read the source item via the R27 helper.
+        // The §6.4 dry-run shape carries `operation: "move_item_to_group"`,
+        // `item_id`, `to_group_id`, and the projected source snapshot so
+        // the agent can verify the right item before re-running without
+        // `--dry-run`. `meta.source: "live"` because the read fired —
+        // mirrors archive/delete/duplicate dry-run shape.
+        const projected = await readSourceItemForDryRun({
+            client,
+            itemId: parsed.itemId,
+            operationName: 'ItemMoveRead',
+        });
+        emitDryRun({
+            ctx,
+            programOpts: program.opts(),
+            plannedChanges: [
+                {
+                    operation: 'move_item_to_group',
+                    item_id: parsed.itemId,
+                    to_group_id: parsed.toGroup,
+                    item: projected,
+                },
+            ],
+            source: 'live',
+            cacheAgeSeconds: null,
+            warnings: [],
+            apiVersion,
+        });
+        return;
+    }
+    // Live path: single round-trip. `move_item_to_group` returns the
+    // moved item directly. Null result → `not_found` matching the
+    // dry-run path's null-handling so agents key off one stable code
+    // regardless of which path they took (R28 helper).
+    const response = await client.raw(MOVE_ITEM_TO_GROUP_MUTATION, {
+        itemId: parsed.itemId,
+        groupId: parsed.toGroup,
+    }, { operationName: 'ItemMoveToGroup' });
+    const projected = projectMutationItem({
+        raw: response.data.move_item_to_group,
+        itemId: parsed.itemId,
+        errorCode: 'not_found',
+        errorMessage: `Monday returned no item from move_item_to_group for id ${parsed.itemId}`,
+    });
+    emitMutation({
+        ctx,
+        data: projected,
+        schema: itemMoveCommand.outputSchema,
+        programOpts: program.opts(),
+        warnings: [],
+        ...toEmit(response),
+        source: 'live',
+        cacheAgeSeconds: null,
+    });
+};
+const runCrossBoardMove = async ({ ctx, program, client, apiVersion, toEmit, globalFlags, parsed, toBoard, }) => {
+    const sourceAgg = new SourceAggregator();
+    // Leg 1: source-item read. Two roles — provides the projected
+    // snapshot for the dry-run envelope's `item` slot AND surfaces the
+    // source item's column IDs (the keys of `columns`) for the
+    // unmatched-column check. Always live (no cache for items).
+    const sourceItem = await readSourceItemForDryRun({
+        client,
+        itemId: parsed.itemId,
+        operationName: 'ItemMoveRead',
+    });
+    sourceAgg.record('live', null);
+    // Leg 2: source-board lookup. The source item's projected
+    // `board_id` is authoritative (the read just returned it), so we
+    // skip a separate `lookupItemBoard` call. The fallback to
+    // `lookupItemBoard` only fires if the projection is null/empty —
+    // defensive against a future schema change where `board_id` is
+    // omitted from the item shape.
+    const sourceBoardId = sourceItem.board_id ??
+        (await lookupItemBoard({ client, itemId: parsed.itemId })).boardId;
+    if (sourceItem.board_id === null) {
+        // The fallback fired — count it as a live leg.
+        sourceAgg.record('live', null);
+    }
+    // Leg 3 + 4: source + target board metadata. Loaded in parallel
+    // because they're independent — the agent waits the slower of the
+    // two rather than the sum. Either may hit cache.
+    const [sourceMeta, targetMeta] = await Promise.all([
+        loadBoardMetadata({ client, boardId: sourceBoardId, env: ctx.env }),
+        loadBoardMetadata({ client, boardId: toBoard, env: ctx.env }),
+    ]);
+    sourceAgg.record(sourceMeta.source, sourceMeta.cacheAgeSeconds);
+    sourceAgg.record(targetMeta.source, targetMeta.cacheAgeSeconds);
+    // Build the source-columns-by-id map for the unmatched-column
+    // detail decoration (so unmatched columns surface with their
+    // human-readable title + type, not just IDs).
+    const sourceColumnsById = new Map(sourceMeta.metadata.columns.map((c) => [
+        c.id,
+        { id: c.id, title: c.title, type: c.type },
+    ]));
+    const targetColumnIds = new Set(targetMeta.metadata.columns.map((c) => c.id));
+    const sourceColumnIds = collectSourceColumnIds(sourceItem);
+    // Plan the columns_mapping payload + raise `usage_error` on any
+    // unmatched column the agent didn't bridge via `--columns-mapping`.
+    // Strict default per cli-design §8 decision 5.
+    const plan = planColumnMappings({
+        sourceColumnIds,
+        sourceColumnsById,
+        targetColumnIds,
+        mapping: parsed.columnsMapping,
+    });
+    if (globalFlags.dryRun) {
+        emitDryRun({
+            ctx,
+            programOpts: program.opts(),
+            plannedChanges: [
+                {
+                    operation: 'move_item_to_board',
+                    item_id: parsed.itemId,
+                    to_board_id: toBoard,
+                    to_group_id: parsed.toGroup,
+                    column_mappings: plan.echo,
+                    item: sourceItem,
+                },
+            ],
+            ...sourceAgg.result(),
+            warnings: [],
+            apiVersion,
+        });
+        return;
+    }
+    // Live path: fire the cross-board mutation. Variables match
+    // Monday's `move_item_to_board(item_id, board_id, group_id,
+    // columns_mapping)` shape exactly.
+    const response = await client.raw(MOVE_ITEM_TO_BOARD_MUTATION, {
+        itemId: parsed.itemId,
+        boardId: toBoard,
+        groupId: parsed.toGroup,
+        // Round-2 P2 (F3): the live wire mapping mirrors the dry-run
+        // `column_mappings` echo so agents reading the preview see
+        // exactly what Monday will receive. The planner always emits
+        // an array — verbatim matches surface explicitly, mappings
+        // override, empty `--columns-mapping {}` collapses to `[]`
+        // (the "drop everything" opt-in). Pre-fix the no-flag case
+        // sent `null` and the dry-run echo diverged from the wire
+        // payload, weakening the "preview shows what will happen"
+        // guarantee.
+        columnsMapping: plan.columnsMapping,
+    }, { operationName: 'ItemMoveToBoard' });
+    sourceAgg.record('live', null);
+    const projected = projectMutationItem({
+        raw: response.data.move_item_to_board,
+        itemId: parsed.itemId,
+        errorCode: 'not_found',
+        errorMessage: `Monday returned no item from move_item_to_board for id ${parsed.itemId}`,
+    });
+    emitMutation({
+        ctx,
+        data: projected,
+        schema: itemMoveCommand.outputSchema,
+        programOpts: program.opts(),
+        warnings: [],
+        ...toEmit(response),
+        ...sourceAgg.result(),
+    });
+};
+// Re-export for unit tests.
+export { cellHasData, collectSourceColumnIds, planColumnMappings };
+//# sourceMappingURL=move.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * `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 { type CommandModule } from '../types.js';
+import { type ProjectedItem } from '../../api/item-projection.js';
+export declare const itemSearchOutputSchema: 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>>;
+export type ItemSearchOutput = readonly ProjectedItem[];
+declare const inputSchema: z.ZodObject<{
+    board: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    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 {};
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +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"}