monday-cli 0.2.0

package/dist/commands/item/set.js

@@ -0,0 +1,387 @@
+/**
+ * `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 { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema, ItemIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { ApiError, MondayCliError, UsageError } from '../../utils/errors.js';
+import { resolveColumnWithRefresh, } from '../../api/columns.js';
+import { selectMutation, translateColumnValueAsync, } from '../../api/column-values.js';
+import { parseSetRawExpression, translateRawColumnValue, } from '../../api/raw-write.js';
+import { splitSetExpression } from '../../api/set-expression.js';
+import { buildResolutionContexts } from '../../api/resolution-context.js';
+import { resolveBoardId } from '../../api/item-board-lookup.js';
+import { buildColumnArchivedError } from '../../api/resolution-pass.js';
+import { foldAndRemap, foldResolverWarningsIntoError, } from '../../api/resolver-error-fold.js';
+import { planChanges } from '../../api/dry-run.js';
+import { ITEM_FIELDS_FRAGMENT } from '../../api/item-helpers.js';
+import { projectMutationItem as projectMutationItemShared } from '../../api/item-mutation-result.js';
+import { projectedItemSchema, } from '../../api/item-projection.js';
+const CHANGE_SIMPLE_COLUMN_VALUE_MUTATION = `
+  mutation ItemSetSimple(
+    $itemId: ID!
+    $boardId: ID!
+    $columnId: String!
+    $value: String!
+  ) {
+    change_simple_column_value(
+      item_id: $itemId
+      board_id: $boardId
+      column_id: $columnId
+      value: $value
+    ) {
+      ${ITEM_FIELDS_FRAGMENT}
+    }
+  }
+`;
+const CHANGE_COLUMN_VALUE_MUTATION = `
+  mutation ItemSetRich(
+    $itemId: ID!
+    $boardId: ID!
+    $columnId: String!
+    $value: JSON!
+  ) {
+    change_column_value(
+      item_id: $itemId
+      board_id: $boardId
+      column_id: $columnId
+      value: $value
+    ) {
+      ${ITEM_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const itemSetOutputSchema = projectedItemSchema;
+const inputSchema = z
+    .object({
+    itemId: ItemIdSchema,
+    // Positional `<col>=<val>` is optional in M8 — `--set-raw` is the
+    // alternative shape per cli-design §4.3 line 492-494. Exactly one
+    // of `setExpr` / `setRaw` must be present (validated below).
+    setExpr: z.string().min(1).optional(),
+    setRaw: z.string().min(1).optional(),
+    board: BoardIdSchema.optional(),
+})
+    .strict()
+    .refine((v) => (v.setExpr === undefined) !== (v.setRaw === undefined), {
+    message: 'item set requires exactly one of <col>=<val> (positional) or ' +
+        '--set-raw <col>=<json>',
+    path: ['setExpr'],
+});
+export const itemSetCommand = {
+    name: 'item.set',
+    summary: 'Write a single column value on an item',
+    examples: [
+        'monday item set 12345 status=Done',
+        'monday item set 12345 status=Done --board 67890',
+        "monday item set 12345 owner=alice@example.com --dry-run",
+        'monday item set 12345 due=+1w --json',
+        "monday item set 12345 --set-raw status='{\"label\":\"Done\"}'",
+        "monday item set 12345 --set-raw tags='{\"tag_ids\":[1,2]}' --board 67890",
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: itemSetOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'item', 'Item commands');
+        noun
+            // Positional `[setExpr]` optional so the parser accepts the
+            // `--set-raw`-only invocation per cli-design §4.3 line 492-494.
+            // The zod refinement enforces "exactly one of setExpr / setRaw".
+            .command('set <itemId> [setExpr]')
+            .description(itemSetCommand.summary)
+            .option('--board <bid>', 'board ID (skip implicit lookup)')
+            .option('--set-raw <expr>', '<col>=<json> raw write (escape hatch — bypasses friendly translator)')
+            // `--dry-run` is a global flag (`src/cli/program.ts`) — read
+            // it via `globalFlags.dryRun` rather than redeclaring on this
+            // subcommand so the flag stays single-source-of-truth across
+            // every M5b mutation surface.
+            .addHelpText('after', ['', 'Examples:', ...itemSetCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (itemId, setExpr, opts) => {
+            const parsed = parseArgv(itemSetCommand.inputSchema, {
+                itemId,
+                ...(setExpr === undefined ? {} : { setExpr }),
+                ...opts,
+            });
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            // Exactly one of setExpr / setRaw is present (zod refinement
+            // enforces XOR). Discriminate to keep the downstream code
+            // shape clear.
+            const isRaw = parsed.setRaw !== undefined;
+            const friendly = parsed.setExpr === undefined ? null : splitSetExpression(parsed.setExpr);
+            const rawParsed = parsed.setRaw === undefined ? null : parseSetRawExpression(parsed.setRaw);
+            // The token under either shape — used for resolved_ids echo +
+            // dry-run engine input.
+            const token = friendly?.token ?? rawParsed?.token;
+            /* c8 ignore next 5 — defensive: zod refinement guarantees one
+               of friendly / rawParsed is non-null, so token is non-undefined.
+               The guard exists for `noUncheckedIndexedAccess` narrowing. */
+            if (token === undefined) {
+                throw new UsageError('item set: token narrowing failed');
+            }
+            const boardId = await resolveBoardId({
+                client,
+                itemId: parsed.itemId,
+                explicit: parsed.board,
+            });
+            // Resolution contexts. `MONDAY_TIMEZONE` env override threads
+            // to date.parseDateInput per cli-design §5.3 line 765;
+            // `resolveMe` + `resolveEmail` cover the people branch's
+            // `me` token and email-lookup paths per §5.3 line 728-734.
+            const { dateResolution, peopleResolution } = buildResolutionContexts({ client, ctx, globalFlags });
+            if (globalFlags.dryRun) {
+                const result = await planChanges({
+                    client,
+                    boardId,
+                    itemId: parsed.itemId,
+                    setEntries: friendly === null ? [] : [friendly],
+                    ...(rawParsed === null ? {} : { rawEntries: [rawParsed] }),
+                    dateResolution,
+                    peopleResolution,
+                    env: ctx.env,
+                    noCache: globalFlags.noCache,
+                });
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    // PlannedChange is a closed-shape interface; the dry-run
+                    // envelope's `planned_changes` field is `unknown[]` per
+                    // §6.4 (extensions land additively). Widen here.
+                    plannedChanges: result.plannedChanges,
+                    source: result.source,
+                    cacheAgeSeconds: result.cacheAgeSeconds,
+                    warnings: result.warnings,
+                    apiVersion,
+                });
+                return;
+            }
+            // Live write path. Resolution + translation + mutation,
+            // mirroring planChanges' resolver-warnings preservation but
+            // without the item-state read (which the live mutation
+            // doesn't need — the mutation response carries the updated
+            // item).
+            const resolution = await resolveColumnWithRefresh({
+                client,
+                boardId,
+                token,
+                includeArchived: true,
+                env: ctx.env,
+                noCache: globalFlags.noCache,
+            });
+            const resolverWarnings = resolution.warnings;
+            if (resolution.match.column.archived === true) {
+                throw foldResolverWarningsIntoError(buildColumnArchivedError({
+                    columnId: resolution.match.column.id,
+                    columnTitle: resolution.match.column.title,
+                    columnType: resolution.match.column.type,
+                    boardId,
+                }), resolverWarnings);
+            }
+            // Translator + mutation-selection + live mutation all share
+            // the same resolver-warnings preservation rule. Any typed
+            // failure (UsageError from date/dropdown/people invalid
+            // input, ApiError(validation_failed) from Monday on the
+            // mutation) gets the collected collision /
+            // stale_cache_refreshed warnings folded into
+            // details.resolver_warnings — pass-1 finding F2 widened the
+            // fold from ApiError-only to MondayCliError to cover the
+            // full error surface. M8: --set-raw branch uses the same
+            // shape — `translateRawColumnValue` runs the read-only-
+            // forever / files-shaped reject lists, then dispatch.
+            let translated;
+            let mutationResult;
+            try {
+                if (isRaw) {
+                    /* c8 ignore next 4 — defensive: isRaw === true means
+                       rawParsed is non-null per the discriminator above. */
+                    if (rawParsed === null) {
+                        throw new UsageError('item set: rawParsed narrowing failed');
+                    }
+                    translated = translateRawColumnValue({
+                        id: resolution.match.column.id,
+                        type: resolution.match.column.type,
+                    }, rawParsed.value, rawParsed.rawJson);
+                }
+                else {
+                    /* c8 ignore next 4 — defensive: isRaw === false means
+                       friendly is non-null per the discriminator above. */
+                    if (friendly === null) {
+                        throw new UsageError('item set: friendly narrowing failed');
+                    }
+                    translated = await translateColumnValueAsync({
+                        column: {
+                            id: resolution.match.column.id,
+                            type: resolution.match.column.type,
+                        },
+                        value: friendly.value,
+                        dateResolution,
+                        peopleResolution,
+                    });
+                }
+                const mutation = selectMutation([translated]);
+                mutationResult = await executeMutation(client, {
+                    mutation,
+                    itemId: parsed.itemId,
+                    boardId,
+                });
+            }
+            catch (err) {
+                if (err instanceof MondayCliError) {
+                    throw await foldAndRemap({
+                        err,
+                        warnings: resolverWarnings,
+                        client,
+                        boardId,
+                        columnIds: [resolution.match.column.id],
+                        env: ctx.env,
+                        noCache: globalFlags.noCache,
+                        resolutionSource: resolution.source,
+                    });
+                }
+                throw err;
+            }
+            // Resolver warnings ride into the success envelope's
+            // top-level warnings so an agent reading a successful write
+            // still sees that the cache was stale or that the token
+            // collided with another column's title. Same shape filter
+            // reads use post-R12.
+            // ResolverWarning widens to envelope.Warning structurally
+            // (narrower code literal, required details). Same shape
+            // filters.ts and search.ts use post-R12.
+            const warnings = resolverWarnings;
+            emitMutation({
+                ctx,
+                data: mutationResult.projected,
+                schema: itemSetCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings,
+                ...toEmit(mutationResult.response),
+                // Resolution may have served from cache (and refreshed if
+                // the column wasn't there); thread the resolved source +
+                // age through. The mutation itself is always live, so a
+                // pure-cache leg never happens here — but the resolver's
+                // `mixed` outcome still surfaces as `mixed`.
+                source: resolution.source === 'cache' ? 'mixed' : resolution.source,
+                cacheAgeSeconds: resolution.cacheAgeSeconds,
+                // cli-design §5.3 step 2: echo the resolved column ID so
+                // an agent's "set then re-read" loop can use the resolved
+                // ID without consulting metadata twice. Keyed by the raw
+                // input token (the slot is `Record<string, string>` so
+                // multi-`--set` in M5b's item update extends naturally).
+                resolvedIds: { [token]: resolution.match.column.id },
+            });
+        });
+    },
+};
+/**
+ * Issues the live mutation Monday's `change_simple_column_value` /
+ * `change_column_value` accept. Returns the projected item per §6.2
+ * — Monday returns the full item shape on the mutation's payload, so
+ * one round-trip lands the write + the post-write item state. The
+ * raw response object is also returned so the caller can thread its
+ * `complexity` field through `toEmit`.
+ */
+const executeMutation = async (client, inputs) => {
+    const { mutation, itemId, boardId } = inputs;
+    if (mutation.kind === 'change_simple_column_value') {
+        const response = await client.raw(CHANGE_SIMPLE_COLUMN_VALUE_MUTATION, {
+            itemId,
+            boardId,
+            columnId: mutation.columnId,
+            value: mutation.value,
+        }, { operationName: 'ItemSetSimple' });
+        return {
+            projected: projectMutationItem(response.data.change_simple_column_value, itemId),
+            response,
+        };
+    }
+    if (mutation.kind === 'change_column_value') {
+        const response = await client.raw(CHANGE_COLUMN_VALUE_MUTATION, {
+            itemId,
+            boardId,
+            columnId: mutation.columnId,
+            // Monday's `change_column_value(value: JSON!)` accepts a
+            // plain object — the SDK / fetch layer handles the wire
+            // stringification at the GraphQL `JSON` scalar boundary.
+            // Per cli-design §5.3 step 4: the translator emits a plain
+            // JS object; the wire layer handles the JSON.stringify.
+            value: mutation.value,
+        }, { operationName: 'ItemSetRich' });
+        return {
+            projected: projectMutationItem(response.data.change_column_value, itemId),
+            response,
+        };
+    }
+    // change_multiple_column_values — reachable only when item set's
+    // single-`<col>=<val>` becomes multi-`--set` in v0.1's `item update`.
+    // Defensive guard: M5b's item set never selects multi.
+    /* c8 ignore next 9 — defensive: selectMutation only emits this
+       kind for >1 translated values; item set is single-`<col>=<val>`
+       by argv shape, so this branch is unreachable. */
+    throw new ApiError('internal_error', `item set selected ${mutation.kind} but only the single-column ` +
+        `mutations are supported here; bundling >1 set targets is item ` +
+        `update's surface.`, { details: { mutation_kind: mutation.kind, item_id: itemId } });
+};
+// Thin wrapper around `api/item-mutation-result.ts projectMutationItem`
+// (R28). M5b chose `internal_error` + "no item payload" to flag a
+// mutation that succeeded server-side but returned an empty payload
+// (rare server-side glitch); M10's destructive verbs use `not_found`
+// for Monday's idiomatic null-for-missing behaviour. Both shapes flow
+// through the shared helper; the wrapper preserves M5b's call-site
+// signature so update-/clear-/set-style call sites stay untouched.
+const projectMutationItem = (raw, itemId) => projectMutationItemShared({
+    raw,
+    itemId,
+    errorCode: 'internal_error',
+    errorMessage: `Monday returned no item payload from the mutation for id ${itemId}.`,
+});
+//# sourceMappingURL=set.js.map

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * `monday item subitems <iid>` — list direct children of an item
+ * (`cli-design.md` §2.8, `v0.1-plan.md` §3 M4).
+ *
+ * Monday's subitem hierarchy reaches up to 5 levels deep (§2.8); this
+ * command surfaces just the *direct* children of one parent. Walking
+ * deeper is the agent's concern (recursive `monday item subitems`
+ * calls). Single-fetch — Monday returns the full subitems array
+ * inline, so there's no cursor to track. The result still emits as
+ * a §6.3 collection envelope with `total_returned` so the shape
+ * matches `item list`.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type ProjectedItem } from '../../api/item-projection.js';
+export declare const itemSubitemsOutputSchema: 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 ItemSubitemsOutput = readonly ProjectedItem[];
+declare const inputSchema: z.ZodObject<{
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+}, z.core.$strict>;
+export declare const itemSubitemsCommand: CommandModule<z.infer<typeof inputSchema>, ItemSubitemsOutput>;
+export {};
+//# sourceMappingURL=subitems.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subitems.d.ts","sourceRoot":"","sources":["../../../src/commands/item/subitems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAkBtC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;mBAA+B,CAAC;AACrE,MAAM,MAAM,kBAAkB,GAAG,SAAS,aAAa,EAAE,CAAC;AAE1D,QAAA,MAAM,WAAW;;kBAA8C,CAAC;AAShE,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,kBAAkB,CA8DnB,CAAC"}

package/dist/commands/item/subitems.js

@@ -0,0 +1,86 @@
+/**
+ * `monday item subitems <iid>` — list direct children of an item
+ * (`cli-design.md` §2.8, `v0.1-plan.md` §3 M4).
+ *
+ * Monday's subitem hierarchy reaches up to 5 levels deep (§2.8); this
+ * command surfaces just the *direct* children of one parent. Walking
+ * deeper is the agent's concern (recursive `monday item subitems`
+ * calls). Single-fetch — Monday returns the full subitems array
+ * inline, so there's no cursor to track. The result still emits as
+ * a §6.3 collection envelope with `total_returned` so the shape
+ * matches `item list`.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { ApiError } from '../../utils/errors.js';
+import { ItemIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { idFromRawItem, projectItem, projectedItemSchema, } from '../../api/item-projection.js';
+import { ITEM_FIELDS_FRAGMENT, parseRawItem, } from '../../api/item-helpers.js';
+import { sortByIdAsc } from '../../api/sort.js';
+const ITEM_SUBITEMS_QUERY = `
+  query ItemSubitems($ids: [ID!]!) {
+    items(ids: $ids) {
+      id
+      subitems {
+        ${ITEM_FIELDS_FRAGMENT}
+      }
+    }
+  }
+`;
+export const itemSubitemsOutputSchema = z.array(projectedItemSchema);
+const inputSchema = z.object({ itemId: ItemIdSchema }).strict();
+export const itemSubitemsCommand = {
+    name: 'item.subitems',
+    summary: 'List direct subitems of one item (one level deep)',
+    examples: [
+        'monday item subitems 12345',
+        'monday item subitems 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: itemSubitemsOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'item', 'Item commands');
+        noun
+            .command('subitems <itemId>')
+            .description(itemSubitemsCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...itemSubitemsCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (itemId) => {
+            const parsed = parseArgv(itemSubitemsCommand.inputSchema, { itemId });
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const response = await client.raw(ITEM_SUBITEMS_QUERY, { ids: [parsed.itemId] }, { operationName: 'ItemSubitems' });
+            const first = response.data.items?.[0];
+            if (first === undefined) {
+                throw new ApiError('not_found', `Monday returned no item for id ${parsed.itemId}`, { details: { item_id: parsed.itemId } });
+            }
+            const rawSubitems = first.subitems ?? [];
+            // Per-page sort by ID asc — §3.1 #8. Subitems is a single
+            // page so this is the only sort the result sees.
+            const sorted = sortByIdAsc(rawSubitems, idFromRawItem);
+            // R18 parse-boundary wrap: malformed subitem surfaces as
+            // typed `internal_error` with `details.issues` plus the
+            // parent-item id for triage.
+            const data = sorted.map((raw) => projectItem({
+                raw: parseRawItem(raw, { parent_item_id: parsed.itemId }),
+            }));
+            emitSuccess({
+                ctx,
+                data,
+                schema: itemSubitemsCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                // Single-fetch — no cursor, no remaining pages.
+                nextCursor: null,
+                hasMore: false,
+                totalReturned: data.length,
+                ...toEmit(response),
+            });
+        });
+    },
+};
+//# sourceMappingURL=subitems.js.map

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

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

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

@@ -0,0 +1,99 @@
+/**
+ * `monday item update <iid> [--name <n>] [--set <col>=<val>]...` —
+ * multi-column atomic update + optional rename.
+ * (`cli-design.md` §4.3 line 490, §5.3, `v0.1-plan.md` §3 M5b).
+ *
+ * Two argv shapes:
+ *
+ *   1. **Single-item** (this commit): positional `<itemId>` +
+ *      repeatable `--set <col>=<val>` + optional `--name <n>`.
+ *      Multi-`--set` (≥2) bundles into one
+ *      `change_multiple_column_values` mutation (atomic on Monday's
+ *      side per §5.3 step 5). `--name` rolls into the same multi
+ *      mutation when columns are also present, otherwise fires a
+ *      dedicated `change_simple_column_value(column_id: "name", ...)`.
+ *
+ *   2. **Bulk** (next commit): `--where <expr>` repeatable + no
+ *      positional `<itemId>` — applies the same `--set` / `--name`
+ *      bundle to every matching item via Monday's `items_page`
+ *      walker. `confirmation_required` fires without `--yes` (and
+ *      without `--dry-run`) per cli-design §10.2.
+ *
+ * **`--name` + `--set` atomicity.** Per cli-design §5.3 step 5, the
+ * design promises atomicity for multi-column updates. Bundling the
+ * name into the multi mutation keeps the same atomicity guarantee
+ * for `--name + --set`. Monday's
+ * `change_multiple_column_values(column_values: JSON!)` accepts
+ * `name` as a special key in the map. The dry-run engine produces
+ * a single `PlannedChange` whose `diff` includes both column keys
+ * and a `name` key when both are passed.
+ *
+ * **`--name` only.** Single field → `change_simple_column_value(
+ * column_id: "name", value: <n>)`. Atomic by default (single
+ * mutation).
+ *
+ * **`--create-labels-if-missing`** (cli-design §4.3) — passes
+ * through to Monday's `change_*_column_value(create_labels_if_missing:
+ * true)`. Tells Monday to auto-create unknown status / dropdown
+ * labels rather than rejecting with `validation_failed`. Off by
+ * default; agents who want labels-on-demand pass the flag
+ * explicitly.
+ *
+ * Idempotent: yes — `change_*` mutations are idempotent. Multi-set
+ * is also 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 itemUpdateOutputSchema: 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 ItemUpdateOutput = ProjectedItem;
+/**
+ * Input shape — supports both single-item and bulk shapes.
+ *
+ *   - Single-item: `itemId` positional required; `where` empty.
+ *   - Bulk:        `itemId` positional omitted; `where` non-empty
+ *                  AND `board` required.
+ *
+ * The split lives in `validateInputShape` (action body) so the zod
+ * schema captures the union without the per-shape conditional logic
+ * — the action layer reads the discriminator and dispatches.
+ */
+declare const inputSchema: z.ZodObject<{
+    itemId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "ItemId", "out">>;
+    set: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    setRaw: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    name: z.ZodOptional<z.ZodString>;
+    board: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    where: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    filterJson: z.ZodOptional<z.ZodString>;
+    createLabelsIfMissing: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const itemUpdateCommand: CommandModule<z.infer<typeof inputSchema>, ItemUpdateOutput>;
+export {};
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/item/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAkDnE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAuEtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsB,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW;;;;;;;;;kBA+Cd,CAAC;AAmDJ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAqOjB,CAAC"}