monday-cli 0.2.0

package/dist/commands/item/get.js

@@ -0,0 +1,66 @@
+/**
+ * `monday item get <iid>` — single item by ID (`cli-design.md` §6.2).
+ *
+ * GraphQL: `items(ids: [<iid>])` with full column_values inline. The
+ * Monday `items` query is the only way to fetch a single item;
+ * passing exactly one ID returns at most one element. A null result
+ * (item archived to a board the token can't read, or genuinely
+ * non-existent) surfaces as `not_found`.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { runByIdLookup } from '../run-by-id-lookup.js';
+import { ItemIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { projectItem, projectedItemSchema, } from '../../api/item-projection.js';
+import { ITEM_FIELDS_FRAGMENT, parseRawItem, } from '../../api/item-helpers.js';
+const ITEM_GET_QUERY = `
+  query ItemGet($ids: [ID!]!) {
+    items(ids: $ids) {
+      ${ITEM_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const itemGetOutputSchema = projectedItemSchema;
+const inputSchema = z.object({ itemId: ItemIdSchema }).strict();
+export const itemGetCommand = {
+    name: 'item.get',
+    summary: 'Show one item by ID with full column values',
+    examples: [
+        'monday item get 12345',
+        'monday item get 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: itemGetOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'item', 'Item commands');
+        noun
+            .command('get <itemId>')
+            .description(itemGetCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...itemGetCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (itemId) => {
+            const parsed = parseArgv(itemGetCommand.inputSchema, { itemId });
+            await runByIdLookup({
+                ctx,
+                programOpts: program.opts(),
+                query: ITEM_GET_QUERY,
+                operationName: 'ItemGet',
+                collectionKey: 'items',
+                id: parsed.itemId,
+                errorDetailKey: 'item_id',
+                kind: 'item',
+                schema: itemGetCommand.outputSchema,
+                // Item-specific projection: parse the raw GraphQL element
+                // through `parseRawItem` (R18 wrap — malformed Monday
+                // payload surfaces as typed `internal_error` with
+                // `details.issues` and `item_id`), then derive the §6.2
+                // typed column shape via projectItem.
+                project: (raw) => projectItem({ raw: parseRawItem(raw, { item_id: parsed.itemId }) }),
+            });
+        });
+    },
+};
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/item/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,YAAY,GACb,MAAM,2BAA2B,CAAC;AAEnC,MAAM,cAAc,GAAG;;;QAGf,oBAAoB;;;CAG3B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAGvD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAGvB;IACF,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,6CAA6C;IACtD,QAAQ,EAAE;QACR,uBAAuB;QACvB,8BAA8B;KAC/B;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,mBAAmB;IACjC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QAChE,IAAI;aACD,OAAO,CAAC,cAAc,CAAC;aACvB,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC;aACnC,WAAW,CACV,OAAO,EACP,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAClF;aACA,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACjE,MAAM,aAAa,CAAC;gBAClB,GAAG;gBACH,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,KAAK,EAAE,cAAc;gBACrB,aAAa,EAAE,SAAS;gBACxB,aAAa,EAAE,OAAO;gBACtB,EAAE,EAAE,MAAM,CAAC,MAAM;gBACjB,cAAc,EAAE,SAAS;gBACzB,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,cAAc,CAAC,YAAY;gBACnC,0DAA0D;gBAC1D,sDAAsD;gBACtD,kDAAkD;gBAClD,wDAAwD;gBACxD,sCAAsC;gBACtC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACf,WAAW,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;aACtE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * `monday item list --board <bid>` — paginated item listing
+ * (`cli-design.md` §2.4 / §5.5 / §5.6 / §6.3, `v0.1-plan.md` §3 M4).
+ *
+ * The heaviest M4 read. Pulls together every M3 / M4 foundation:
+ *
+ *   - `loadBoardMetadata` (M3) — needed by the filter parser to
+ *     resolve `<col>` tokens and by the §6.3 column-title
+ *     de-duplication slot.
+ *   - `buildQueryParams` (M4 filters.ts) — turns repeatable
+ *     `--where` flags into Monday's `query_params.rules` payload,
+ *     or passes `--filter-json` through. `me` sugar resolves via
+ *     the `client.whoami()` callback — cached for the duration of
+ *     the build call.
+ *   - `paginate` (M4 pagination.ts) — `items_page` + `next_items_page`
+ *     walker with the §5.6 stale-cursor fail-fast contract.
+ *   - `projectItem` (M4 item-projection.ts) — produces the §6.2
+ *     single-item shape; titles fold into the §6.3 collection-meta
+ *     `columns` slot to avoid per-row repetition.
+ *
+ * NDJSON streaming mode bypasses the `emitSuccess` collect-then-emit
+ * path so items reach stdout as they arrive (per §6.3 / §3.1 #1 —
+ * agents can `monday item list --output ndjson | jq` without
+ * waiting for the whole walk). Mid-walk `stale_cursor` still emits a
+ * valid NDJSON stream up to the failure point and the standard
+ * §6.5 error envelope on stderr — the runner's catch-all picks up
+ * the thrown ApiError and writes the error envelope with the
+ * documented exit code.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type ProjectedItem } from '../../api/item-projection.js';
+export declare const itemListOutputSchema: 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 ItemListOutput = readonly ProjectedItem[];
+declare const inputSchema: z.ZodObject<{
+    board: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    group: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "GroupId", "out">>;
+    where: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    filterJson: z.ZodOptional<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 itemListCommand: CommandModule<z.infer<typeof inputSchema>, ItemListOutput>;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/item/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBnE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAuCtC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;mBAA+B,CAAC;AACjE,MAAM,MAAM,cAAc,GAAG,SAAS,aAAa,EAAE,CAAC;AAEtD,QAAA,MAAM,WAAW;;;;;;;;kBAuBN,CAAC;AA0CZ,eAAO,MAAM,eAAe,EAAE,aAAa,CACzC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,cAAc,CAyMf,CAAC"}

package/dist/commands/item/list.js

@@ -0,0 +1,284 @@
+/**
+ * `monday item list --board <bid>` — paginated item listing
+ * (`cli-design.md` §2.4 / §5.5 / §5.6 / §6.3, `v0.1-plan.md` §3 M4).
+ *
+ * The heaviest M4 read. Pulls together every M3 / M4 foundation:
+ *
+ *   - `loadBoardMetadata` (M3) — needed by the filter parser to
+ *     resolve `<col>` tokens and by the §6.3 column-title
+ *     de-duplication slot.
+ *   - `buildQueryParams` (M4 filters.ts) — turns repeatable
+ *     `--where` flags into Monday's `query_params.rules` payload,
+ *     or passes `--filter-json` through. `me` sugar resolves via
+ *     the `client.whoami()` callback — cached for the duration of
+ *     the build call.
+ *   - `paginate` (M4 pagination.ts) — `items_page` + `next_items_page`
+ *     walker with the §5.6 stale-cursor fail-fast contract.
+ *   - `projectItem` (M4 item-projection.ts) — produces the §6.2
+ *     single-item shape; titles fold into the §6.3 collection-meta
+ *     `columns` slot to avoid per-row repetition.
+ *
+ * NDJSON streaming mode bypasses the `emitSuccess` collect-then-emit
+ * path so items reach stdout as they arrive (per §6.3 / §3.1 #1 —
+ * agents can `monday item list --output ndjson | jq` without
+ * waiting for the whole walk). Mid-walk `stale_cursor` still emits a
+ * valid NDJSON stream up to the failure point and the standard
+ * §6.5 error envelope on stderr — the runner's catch-all picks up
+ * the thrown ApiError and writes the error envelope with the
+ * documented exit code.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema, GroupIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { loadBoardMetadata, refreshBoardMetadata, } from '../../api/board-metadata.js';
+import { buildQueryParams } from '../../api/filters.js';
+import { DEFAULT_PAGE_SIZE, paginate, } from '../../api/pagination.js';
+import { fetchItemsPage, fetchNextItemsPage, } from '../../api/items-page-walker.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 { parseGlobalFlags, } from '../../types/global-flags.js';
+import { collectSecrets } from '../../cli/envelope-out.js';
+// items_page GraphQL surface lifted into `api/items-page-walker.ts`
+// per §18 R34 (post-M12). The helper builds the queries inline from
+// `operationName` + `itemFields` + optional `groupId` — the
+// top-level / by-group split (`boards.items_page` vs
+// `boards.groups.items_page`) and the malformed-response parse
+// boundary live there. `paginate.ts` stays the cursor walker for
+// this command's --all / --limit / --page-size / NDJSON onItem /
+// complexity tracking.
+/**
+ * Per-row schema is `z.unknown()` — list.ts hands raw rows to
+ * `projectFromRaw` (which is the boundary that types each row).
+ * Keeping the helper untyped here preserves byte-identical behaviour
+ * (no per-row narrowing on the items_page page itself).
+ */
+const listItemSchema = z.unknown();
+export const itemListOutputSchema = z.array(projectedItemSchema);
+const inputSchema = z
+    .object({
+    board: BoardIdSchema,
+    group: GroupIdSchema.optional(),
+    where: z.array(z.string()).optional(),
+    // Parity with `item update --filter-json` — see that file's note.
+    // Read-only here so not destructive, but `''` is never a valid
+    // `query_params` JSON object; reject at the schema boundary so
+    // the failure surfaces as `usage_error` rather than as a confusing
+    // "no filter applied" silent passthrough. `.refine(trim)` rather
+    // than `.min(1)` catches whitespace-only inputs too without
+    // burning a board-metadata network call first.
+    filterJson: z
+        .string()
+        .refine((s) => s.trim().length > 0, '--filter-json must be a non-empty JSON object')
+        .optional(),
+    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 initialFetcher = (client, boardId, group, queryParams) => {
+    const operationName = group === undefined ? 'ItemsPage' : 'ItemsPageByGroup';
+    return (effectiveLimit) => fetchItemsPage({
+        client,
+        operationName,
+        boardId,
+        ...(group === undefined ? {} : { groupId: group }),
+        limit: effectiveLimit,
+        queryParams,
+        itemFields: ITEM_FIELDS_FRAGMENT,
+        itemSchema: listItemSchema,
+    });
+};
+const nextFetcher = (client) => {
+    return (cursor, effectiveLimit) => fetchNextItemsPage({
+        client,
+        operationName: 'NextItemsPage',
+        cursor,
+        limit: effectiveLimit,
+        itemFields: ITEM_FIELDS_FRAGMENT,
+        itemSchema: listItemSchema,
+    });
+};
+export const itemListCommand = {
+    name: 'item.list',
+    summary: 'List items on a board with cursor pagination + filters',
+    examples: [
+        'monday item list --board 12345 --json',
+        "monday item list --board 12345 --where 'status=Done' --json",
+        "monday item list --board 12345 --where 'status=Done' --where 'owner=me'",
+        'monday item list --board 12345 --all --output ndjson',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: itemListOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'item', 'Item commands');
+        noun
+            .command('list')
+            .description(itemListCommand.summary)
+            .requiredOption('--board <bid>', 'board ID (required)')
+            .option('--group <gid>', 'restrict to one group')
+            .option('--where <expr>', 'repeatable filter: <col><op><val> or <col>:is_empty', (value, prev) => [...prev, value], [])
+            .option('--filter-json <json>', 'literal Monday query_params (escape hatch)')
+            .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:', ...itemListCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (opts) => {
+            const parsed = parseArgv(itemListCommand.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,
+            });
+            // Build the cache-aware refresh callback only when metadata
+            // came from cache — refreshing live data wouldn't help and
+            // would burn an extra request. When refresh fires, the
+            // returned BoardMetadata becomes the new view for titles +
+            // columnHeads.
+            let activeMetadata = meta.metadata;
+            const onColumnNotFound = meta.source === 'cache'
+                ? async () => {
+                    const refreshed = await refreshBoardMetadata({
+                        client,
+                        boardId: parsed.board,
+                        env: ctx.env,
+                    });
+                    activeMetadata = refreshed.metadata;
+                    return refreshed.metadata;
+                }
+                : undefined;
+            const filterResult = await buildQueryParams({
+                metadata: meta.metadata,
+                resolveMe: resolveMeFactory(client),
+                whereClauses: parsed.where ?? [],
+                filterJson: parsed.filterJson,
+                ...(onColumnNotFound === undefined ? {} : { onColumnNotFound }),
+            });
+            const queryParams = filterResult.queryParams;
+            const filterWarnings = filterResult.warnings;
+            // Effective meta source per §6.1:
+            //  - metadata live + items live   → live
+            //  - metadata cache + items live  → mixed (filterResult.refreshed
+            //    doesn't matter here — the data is still partly cache-derived)
+            //  - metadata cache + refresh fired during filter resolution
+            //    → mixed (the original cache was stale, refresh was forced).
+            // The original cacheAgeSeconds is preserved so agents can read
+            // "how stale was the cache when this ran" — same pattern as
+            // resolveColumnWithRefresh per Codex M3 pass-2 §1.
+            const effectiveSource = meta.source === 'live' && !filterResult.refreshed ? 'live' : 'mixed';
+            const effectiveCacheAge = meta.cacheAgeSeconds;
+            const titles = titleMap(activeMetadata);
+            const columnHeads = collectColumnHeads(activeMetadata);
+            const pageSize = parsed.pageSize ?? DEFAULT_PAGE_SIZE;
+            const flags = {
+                all: parsed.all === true,
+                ...(parsed.limit === undefined ? { limit: undefined } : { limit: parsed.limit }),
+            };
+            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. Bypasses emitSuccess because the streaming
+            // contract requires items hitting stdout before the walk
+            // completes. R52 (M18) lifted the stream helper into
+            // `utils/output/ndjson.ts`; per-call `Meta` stays at the
+            // call site so per-noun trailer shape (item list/search
+            // carries `meta.columns`; update list does not) lives at
+            // the caller.
+            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, parsed.group, queryParams),
+                    fetchNext: nextFetcher(client),
+                    now: ctx.clock,
+                    extractPage: (r) => r.data,
+                    getId: idFromRawItem,
+                    all: flags.all,
+                    ...(flags.limit === undefined ? {} : { limit: flags.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. If a future milestone needs them in-stream, the
+                // contract path is `_meta.warnings` (extend `Meta`,
+                // don't add a sibling key). Suppress the unused-variable
+                // lint hint on the streaming branch with a void cast.
+                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;
+            }
+            // Non-streaming path — collect, project, emit through the
+            // standard envelope.
+            const result = await paginate({
+                fetchInitial: initialFetcher(client, parsed.board, parsed.group, queryParams),
+                fetchNext: nextFetcher(client),
+                now: ctx.clock,
+                extractPage: (r) => r.data,
+                getId: idFromRawItem,
+                all: flags.all,
+                ...(flags.limit === undefined ? {} : { limit: flags.limit }),
+                pageSize,
+            });
+            const data = result.items.map((raw) => projectFromRaw(raw, titles, { omitColumnTitles: true }));
+            const warnings = [...filterWarnings, ...result.warnings];
+            // Re-parse the global flags so commander's runtime shape gets
+            // normalised by parseGlobalFlags before emit reads it. (The
+            // flags variable above is already normalised; this just keeps
+            // emit's contract — programOpts is the raw shape — explicit.)
+            parseGlobalFlags(program.opts(), ctx.env);
+            const baseEmit = toEmit(result.lastResponse);
+            emitSuccess({
+                ctx,
+                data,
+                schema: itemListCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                nextCursor: result.nextCursor,
+                hasMore: result.hasMore,
+                totalReturned: result.totalReturned,
+                columns: columnHeads,
+                warnings,
+                ...baseEmit,
+                // Override toEmit's `live` / `null` defaults when the
+                // metadata leg came from cache. Items still came from the
+                // live items_page query, so source: 'mixed' + the original
+                // cacheAgeSeconds is the §6.1-correct view (Codex M4 §2).
+                source: effectiveSource,
+                cacheAgeSeconds: effectiveCacheAge,
+            });
+        });
+    },
+};
+//# sourceMappingURL=list.js.map

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

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

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

@@ -0,0 +1,181 @@
+/**
+ * `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 { type CommandModule } from '../types.js';
+import { type ColumnMapping } from '../../api/column-mapping.js';
+import { type ProjectedItem } from '../../api/item-projection.js';
+export declare const itemMoveOutputSchema: 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 ItemMoveOutput = ProjectedItem;
+declare const inputSchema: z.ZodObject<{
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+    toGroup: z.core.$ZodBranded<z.ZodString, "GroupId", "out">;
+    toBoard: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    columnsMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+interface ColumnMappingPlan {
+    /** The columns_mapping array fed to the wire mutation. */
+    readonly columnsMapping: readonly {
+        readonly source: string;
+        readonly target: string;
+    }[];
+    /** Echoed to the dry-run envelope's `column_mappings` slot. */
+    readonly echo: readonly {
+        readonly source: string;
+        readonly target: string;
+    }[];
+}
+/**
+ * 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.
+ */
+declare const planColumnMappings: ({ sourceColumnIds, sourceColumnsById, targetColumnIds, mapping, }: {
+    readonly sourceColumnIds: readonly string[];
+    readonly sourceColumnsById: ReadonlyMap<string, {
+        readonly id: string;
+        readonly title: string;
+        readonly type: string;
+    }>;
+    readonly targetColumnIds: ReadonlySet<string>;
+    readonly mapping: ColumnMapping | undefined;
+}) => ColumnMappingPlan;
+/**
+ * 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.
+ */
+declare const cellHasData: (col: {
+    readonly value?: unknown;
+    readonly text?: string | null;
+}) => boolean;
+/**
+ * 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.
+ */
+declare const collectSourceColumnIds: (source: ProjectedItem) => readonly string[];
+export declare const itemMoveCommand: CommandModule<z.infer<typeof inputSchema>, ItemMoveOutput>;
+export { cellHasData, collectSourceColumnIds, planColumnMappings };
+//# sourceMappingURL=move.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../../src/commands/item/move.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAYnE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AA8CtC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsB,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;;;kBAkBN,CAAC;AAQZ,UAAU,iBAAiB;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzF,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChF;AAED;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,kBAAkB,GAAI,mEAKzB;IACD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,WAAW,CACrC,MAAM,EACN;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CACvE,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;CAC7C,KAAG,iBAsFH,CAAC;AAuCF;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,WAAW,GAAI,KAAK;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAG,OAGvF,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,sBAAsB,GAC1B,QAAQ,aAAa,KACpB,SAAS,MAAM,EAMjB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAAa,CACzC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,cAAc,CAmHf,CAAC;AA4NF,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC"}