monday-cli 0.2.0

package/dist/commands/board/group-update.js

@@ -0,0 +1,341 @@
+/**
+ * `monday board group-update <bid> <gid> [--name <n>] [--color <c>]
+ * [--dry-run]` — change one or more group fields (`cli-design.md`
+ * §4.3 line 1245, `v0.2-plan.md` §3 M17).
+ *
+ * **Wire shape — per-attribute fan-out across a single surface.**
+ * Monday's `update_group(board_id, group_id, group_attribute:
+ * GroupAttributes!, new_value: String!)` per SDK 14.0.0
+ * `MutationUpdate_GroupArgs`. Both `group_attribute` and `new_value`
+ * are required at the wire (unlike column-update's `change_column_
+ * metadata` whose arguments are both optional). Per-attribute fan-
+ * out routes every `--name` / `--color` flag through the same
+ * mutation with a different `group_attribute` enum value. The
+ * `GroupAttributes` enum carries five values total (`title` /
+ * `color` / `position` / `relative_position_after` / `relative_
+ * position_before`); v0.2 surfaces only `title` (via `--name`) and
+ * `color` (via `--color`). M17 deliberately OMITS the position-
+ * related flags — `position` is per-changelog deprecated and the
+ * literal `top|bottom` semantics through `update_group` are
+ * unreliable; repositioning is deferred to v0.3 with `--before
+ * <gid>` / `--after <gid>` flags mapping to the non-deprecated
+ * `relative_position_after` / `relative_position_before` enum
+ * values. Multi-flag invocations fan out N sequential wire calls
+ * (sequential per §8 decision 8 — parallel waits for v0.4
+ * `--concurrency`).
+ *
+ * **Whole-call envelope — no partial-success leak.** The envelope
+ * is `ok: true` only when EVERY per-field call succeeded; on any
+ * per-field failure the envelope is `ok: false` with the failed
+ * call's error code. Mirrors `column-update` / `board-update`
+ * contract.
+ *
+ * **Live-path partial-application caveat.** Server-side state is
+ * NOT transactional across per-attribute mutations: if call #1
+ * succeeds and call #2 fails, fields from #1 stay committed and
+ * are NOT rolled back. Agents re-issuing after failure should re-
+ * read the group to see what landed before retrying the unapplied
+ * tail.
+ *
+ * **Data projects from the trailing call (no force-live read leg).**
+ * Monday's `update_group` returns `Maybe<Group>` post-mutation with
+ * the FULL Group projection — the trailing call's response is
+ * authoritative for every group-metadata field. Mirrors `column-
+ * update`'s no-force-live shape and DIVERGES from `board update`'s
+ * force-live shape (board's per-attribute calls return the changed
+ * slice only, requiring a final whole-board read leg). This is the
+ * load-bearing M17-pre-flight finding (cli-design §6.4 group-update
+ * partial-application caveat).
+ *
+ * **Argv discipline.** At least one of `--name` / `--color` is
+ * required — zero-flag invocation surfaces as `usage_error` (exit
+ * 1) at argv-parse, before any network leg. Mirrors `column-
+ * update`'s rule.
+ *
+ * **Dry-run shape** per cli-design §6.4 group-update variant: a
+ * field-level `from → to` diff per provided field. The `from`
+ * state requires a preflight `board describe`-shaped read — routed
+ * through `loadBoardMetadata` so cache hits are observable;
+ * `meta.source: 'live' | 'cache'`. When the board doesn't exist
+ * the preflight surfaces `not_found` (exit 2). When the group ID
+ * isn't on the board, the dry-run surfaces `not_found` with
+ * `details.group_id`. Cache-staleness caveat: the `from` snapshot
+ * may lag live state up to the cache TTL; pass `--no-cache` for a
+ * force-live preflight when preview freshness is critical.
+ *
+ * **Eager invalidation** (cli-design §8 fan-out call-site contract).
+ * After the per-attribute loop settles, `invalidateBoard(boardId)`
+ * fires ONCE — conditional on at least one per-attribute call
+ * having succeeded (the wire-state high-water mark). On whole-call
+ * success this is the same trigger as the single-leg case; on
+ * whole-call partial-application failure (call N+1 fails after
+ * call N succeeded), invalidation still fires because the cache
+ * must reflect the partially-applied server state. Zero-legs-
+ * succeeded skips invalidation (server state unchanged). The
+ * contract generalises cleanly to N-leg fan-out by gating on the
+ * loop's high-water-mark counter rather than per-call timing.
+ *
+ * **Idempotent: yes.** Re-applying the same field values is a
+ * no-op on Monday's side (same input leaves same group metadata).
+ * NOT destructive (no `--yes` gate).
+ */
+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 } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { ApiError } from '../../utils/errors.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { withBoardInvalidationFanOut } from '../../api/board-mutation-invalidation.js';
+import { findBoardChildOrThrow } from '../../api/board-child-finder.js';
+import { loadBoardMetadata } from '../../api/board-metadata.js';
+import { GROUP_COLOR_VALUES } from '../../api/group-color.js';
+import { GROUP_FIELDS_FRAGMENT, groupProjectionSchema, projectMutationGroup, } from '../../api/group-mutation-result.js';
+const UPDATE_GROUP_MUTATION = `
+  mutation GroupUpdate(
+    $boardId: ID!,
+    $groupId: String!,
+    $groupAttribute: GroupAttributes!,
+    $newValue: String!
+  ) {
+    update_group(
+      board_id: $boardId,
+      group_id: $groupId,
+      group_attribute: $groupAttribute,
+      new_value: $newValue
+    ) {
+      ${GROUP_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardGroupUpdateOutputSchema = groupProjectionSchema;
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    // Group ids are stable lower-snake-case slugs ("topics", etc.)
+    // — not numeric. Branded `GroupIdSchema` in `types/ids.ts`
+    // distinguishes them from ColumnId / BoardId at the type
+    // level.
+    groupId: GroupIdSchema,
+    name: z
+        .string()
+        .refine((s) => s.trim().length > 0, {
+        message: '--name must be non-empty (whitespace-only is rejected)',
+    })
+        .optional(),
+    // Per cli-design §4.3 group-update: --color is argv-parse
+    // validated against the same pinned palette group-create uses
+    // (see api/group-color.ts). Sharing the constant means a value
+    // accepted by group-create round-trips through group-update
+    // without surprise rejections.
+    color: z.enum(GROUP_COLOR_VALUES).optional(),
+})
+    .strict()
+    .refine((v) => v.name !== undefined || v.color !== undefined, {
+    message: 'group update requires at least one of --name / --color',
+});
+const responseSchema = z
+    .object({
+    update_group: z.unknown(),
+})
+    .loose();
+// Deterministic dispatch order: name (→ title) first, then color.
+// The iteration order isn't observable on whole-call success
+// (single envelope) but IS observable on partial-application
+// failure (server-side state shows fields applied in order before
+// the failure). Mirrors `column-update`'s FIELD_DISPATCH_ORDER pin.
+const FIELD_DISPATCH_ORDER = ['name', 'color'];
+export const boardGroupUpdateCommand = {
+    name: 'board.group-update',
+    summary: 'Update one or more fields of a group',
+    examples: [
+        'monday board group-update 12345 topics --name "Sprint 42"',
+        'monday board group-update 12345 topics --color blue',
+        'monday board group-update 12345 topics --name "Sprint 42" --color blue',
+        'monday board group-update 12345 topics --name "Preview" --dry-run --json',
+    ],
+    // Re-applying the same field values is a server-side no-op —
+    // safe to retry on transient failure. Mirrors `column-update` /
+    // `board update` rationale.
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardGroupUpdateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('group-update <boardId> <groupId>')
+            .description(boardGroupUpdateCommand.summary)
+            .option('--name <n>', 'new group name (maps to wire group_attribute: title)')
+            .option('--color <c>', 'new group color (maps to wire group_attribute: color)')
+            .addHelpText('after', ['', 'Examples:', ...boardGroupUpdateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, groupId, opts) => {
+            const parsed = parseArgv(boardGroupUpdateCommand.inputSchema, {
+                boardId,
+                groupId,
+                ...opts,
+            });
+            const trimmedName = parsed.name?.trim();
+            // No trim on color — the enum check on inputSchema rejects
+            // anything outside GROUP_COLOR_VALUES; values that survive
+            // are exact palette-name matches.
+            const colorValue = parsed.color;
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Preflight `boards(ids:)` read via loadBoardMetadata so
+                // the v0.1 board-metadata cache can serve fresh entries.
+                // `meta.source: 'live' | 'cache'`. Cache-staleness
+                // caveat: `from` values may lag up to TTL; agents pass
+                // `--no-cache` when preview freshness is critical.
+                const preflight = await loadBoardMetadata({
+                    client,
+                    boardId: parsed.boardId,
+                    env: ctx.env,
+                    noCache: globalFlags.noCache,
+                });
+                // R51 lift — `findBoardChildOrThrow` consolidates the
+                // board-level read succeeded but the group ID isn't on
+                // the board → not_found-with-details.group_id carve-out
+                // shared with `column-update` + `group-archive`.
+                const current = findBoardChildOrThrow({
+                    metadata: preflight.metadata,
+                    kind: 'groups',
+                    id: parsed.groupId,
+                    boardId: parsed.boardId,
+                });
+                const diff = {};
+                if (trimmedName !== undefined) {
+                    // Surface the diff key as `name` (the CLI flag name)
+                    // even though the wire's GroupAttributes value is
+                    // `title` — agents reading the dry-run shouldn't need
+                    // to know about the wire-level rename. The current
+                    // value comes from the cached projection's `title`
+                    // field.
+                    diff.name = { from: current.title, to: trimmedName };
+                }
+                if (colorValue !== undefined) {
+                    diff.color = { from: current.color, to: colorValue };
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'update_group',
+                            board_id: parsed.boardId,
+                            group_id: parsed.groupId,
+                            diff,
+                        },
+                    ],
+                    source: preflight.source,
+                    cacheAgeSeconds: preflight.cacheAgeSeconds,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. Build the dispatch plan in deterministic order
+            // (name → color) so partial-application failure modes are
+            // testable.
+            const dispatchPlan = [];
+            for (const field of FIELD_DISPATCH_ORDER) {
+                if (field === 'name' && trimmedName !== undefined) {
+                    dispatchPlan.push({
+                        field: 'name',
+                        value: trimmedName,
+                        groupAttribute: 'title',
+                    });
+                }
+                else if (field === 'color' && colorValue !== undefined) {
+                    dispatchPlan.push({
+                        field: 'color',
+                        value: colorValue,
+                        groupAttribute: 'color',
+                    });
+                }
+            }
+            // Fan-out: per-attribute calls in order. The R46 helper
+            // (`withBoardInvalidationFanOut`) owns the §8 high-water-
+            // mark counter and the post-loop invalidation gate; the
+            // closure here just calls `recordLegSuccess()` after each
+            // successful leg and returns `{data, response}` for the
+            // emitMutation step below. The trailing per-attribute
+            // call's response is authoritative for the projection AND
+            // for `meta.request_id` / complexity — Monday's
+            // `update_group` returns the FULL Group post-mutation, so
+            // no force-live read leg fires (distinguishes group-update
+            // from board-update).
+            const { data: projected, response: lastResponse } = await withBoardInvalidationFanOut({
+                boardId: parsed.boardId,
+                env: ctx.env,
+                runFanOut: async ({ recordLegSuccess }) => {
+                    let lastProjected;
+                    let trailingResponse;
+                    for (const entry of dispatchPlan) {
+                        const response = await client.raw(UPDATE_GROUP_MUTATION, {
+                            boardId: parsed.boardId,
+                            groupId: parsed.groupId,
+                            groupAttribute: entry.groupAttribute,
+                            newValue: entry.value,
+                        }, { operationName: 'GroupUpdate' });
+                        const data = unwrapOrThrow(responseSchema.safeParse(response.data), {
+                            context: 'Monday returned a malformed GroupUpdate response',
+                            details: {
+                                board_id: parsed.boardId,
+                                group_id: parsed.groupId,
+                            },
+                            hint: "this is a data-integrity error in Monday's response; " +
+                                'verify the mutation response shape and update the schema ' +
+                                "if Monday's contract has changed.",
+                        });
+                        if (!('update_group' in data)) {
+                            throw new ApiError('internal_error', `Monday's GroupUpdate response is missing the update_group root field`, {
+                                details: {
+                                    board_id: parsed.boardId,
+                                    group_id: parsed.groupId,
+                                    hint: "this is a schema-drift error in Monday's GraphQL " +
+                                        'response; verify the mutation declaration and update ' +
+                                        "the response schema if Monday's contract has changed.",
+                                },
+                            });
+                        }
+                        // R48 lift: null-payload guard + projection. group-
+                        // update's null path uses `not_found` (Monday's
+                        // idiomatic missing-or-no-access response).
+                        lastProjected = projectMutationGroup({
+                            raw: data.update_group,
+                            errorCode: 'not_found',
+                            errorMessage: `Monday returned no group payload from update_group for board ${parsed.boardId} group ${parsed.groupId}`,
+                            boardId: parsed.boardId,
+                            idKey: 'group_id',
+                            idValue: parsed.groupId,
+                        });
+                        trailingResponse = response;
+                        recordLegSuccess();
+                    }
+                    // Defensive — TS can't narrow that the success path
+                    // always sets these (the loop only runs when at
+                    // least one flag is set, and the .refine() on
+                    // inputSchema enforces ≥1 flag, but the type system
+                    // doesn't see the cross-block invariant).
+                    /* c8 ignore next 6 */
+                    if (lastProjected === undefined || trailingResponse === undefined) {
+                        throw new ApiError('internal_error', 'group update completed without a trailing wire response — this is a CLI bug', { details: { board_id: parsed.boardId, group_id: parsed.groupId } });
+                    }
+                    return { data: lastProjected, response: trailingResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardGroupUpdateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(lastResponse),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=group-update.js.map

package/dist/commands/board/group-update.js.map

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

package/dist/commands/board/groups.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `monday board groups <bid>` — list a board's groups
+ * (`cli-design.md` §4.3).
+ *
+ * Reads through `loadBoardMetadata` so the shared cache covers
+ * `board describe` / `board columns` / `board groups` with one
+ * fetch.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const boardGroupsOutputSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    color: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodString>;
+    archived: z.ZodNullable<z.ZodBoolean>;
+    deleted: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strict>>;
+export type BoardGroupsOutput = z.infer<typeof boardGroupsOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    includeArchived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const boardGroupsCommand: CommandModule<z.infer<typeof inputSchema>, BoardGroupsOutput>;
+export {};
+//# sourceMappingURL=groups.d.ts.map

package/dist/commands/board/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../src/commands/board/groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBnE,eAAO,MAAM,uBAAuB;;;;;;;mBAA0B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAEZ,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,iBAAiB,CA8DlB,CAAC"}

package/dist/commands/board/groups.js

@@ -0,0 +1,85 @@
+/**
+ * `monday board groups <bid>` — list a board's groups
+ * (`cli-design.md` §4.3).
+ *
+ * Reads through `loadBoardMetadata` so the shared cache covers
+ * `board describe` / `board columns` / `board groups` with one
+ * fetch.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { loadBoardMetadata } from '../../api/board-metadata.js';
+const groupOutSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string(),
+    color: z.string().nullable(),
+    position: z.string().nullable(),
+    archived: z.boolean().nullable(),
+    deleted: z.boolean().nullable(),
+})
+    .strict();
+export const boardGroupsOutputSchema = z.array(groupOutSchema);
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    includeArchived: z.boolean().optional(),
+})
+    .strict();
+export const boardGroupsCommand = {
+    name: 'board.groups',
+    summary: "List a board's groups",
+    examples: [
+        'monday board groups 12345',
+        'monday board groups 12345 --include-archived --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardGroupsOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('groups <boardId>')
+            .description(boardGroupsCommand.summary)
+            .option('--include-archived', 'show archived/deleted groups too')
+            .addHelpText('after', ['', 'Examples:', ...boardGroupsCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardGroupsCommand.inputSchema, {
+                boardId,
+                ...opts,
+            });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await loadBoardMetadata({
+                client,
+                boardId: parsed.boardId,
+                env: ctx.env,
+                noCache: globalFlags.noCache,
+            });
+            const groups = parsed.includeArchived === true
+                ? result.metadata.groups
+                : result.metadata.groups.filter((g) => g.archived !== true && g.deleted !== true);
+            ctx.meta.setSource(result.source);
+            emitSuccess({
+                ctx,
+                data: boardGroupsCommand.outputSchema.parse(groups),
+                schema: boardGroupsCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                // Single-fetch payload (Monday returns the full group list
+                // in one request), so `has_more` is unconditionally false.
+                hasMore: false,
+                source: result.source,
+                apiVersion,
+                complexity: result.complexity,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+            });
+        });
+    },
+};
+//# sourceMappingURL=groups.js.map

package/dist/commands/board/groups.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * `monday board list` — list visible boards (`cli-design.md` §4.3, §6.3).
+ *
+ * GraphQL: `boards(limit:, page:, ids:, workspace_ids:, state:,
+ * order_by:)`. Page-based, same flag surface as `workspace list`.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const boardListOutputSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    board_kind: z.ZodNullable<z.ZodString>;
+    board_folder_id: z.ZodNullable<z.ZodString>;
+    workspace_id: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    items_count: z.ZodNullable<z.ZodNumber>;
+    updated_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>>;
+export type BoardListOutput = z.infer<typeof boardListOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    workspace: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">>;
+    state: z.ZodOptional<z.ZodEnum<{
+        archived: "archived";
+        deleted: "deleted";
+        all: "all";
+        active: "active";
+    }>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    page: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    all: z.ZodOptional<z.ZodBoolean>;
+    limitPages: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const boardListCommand: CommandModule<z.infer<typeof inputSchema>, BoardListOutput>;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/board/list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAuDnE,eAAO,MAAM,qBAAqB;;;;;;;;;;;mBAAuB,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,QAAA,MAAM,WAAW;;;;;;;;;;;;kBASN,CAAC;AAMZ,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAC1C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,eAAe,CA0EhB,CAAC"}

package/dist/commands/board/list.js

@@ -0,0 +1,135 @@
+/**
+ * `monday board list` — list visible boards (`cli-design.md` §4.3, §6.3).
+ *
+ * GraphQL: `boards(limit:, page:, ids:, workspace_ids:, state:,
+ * order_by:)`. Page-based, same flag surface as `workspace list`.
+ *
+ * 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 { UsageError } from '../../utils/errors.js';
+import { WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { buildCapWarning, DEFAULT_MAX_PAGES, walkPages, } from '../../api/walk-pages.js';
+const BOARD_LIST_QUERY = `
+  query BoardList(
+    $limit: Int
+    $page: Int
+    $workspaceIds: [ID]
+    $state: State
+  ) {
+    boards(
+      limit: $limit
+      page: $page
+      workspace_ids: $workspaceIds
+      state: $state
+    ) {
+      id
+      name
+      description
+      state
+      board_kind
+      board_folder_id
+      workspace_id
+      url
+      items_count
+      updated_at
+    }
+  }
+`;
+const boardSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string(),
+    description: z.string().nullable(),
+    state: z.string().nullable(),
+    board_kind: z.string().nullable(),
+    board_folder_id: z.string().nullable(),
+    workspace_id: z.string().nullable(),
+    url: z.string().nullable(),
+    items_count: z.number().int().nullable(),
+    updated_at: z.string().nullable(),
+})
+    .strict();
+export const boardListOutputSchema = z.array(boardSchema);
+const inputSchema = z
+    .object({
+    workspace: WorkspaceIdSchema.optional(),
+    state: z.enum(['active', 'archived', 'deleted', 'all']).optional(),
+    limit: z.coerce.number().int().positive().max(100).optional(),
+    page: z.coerce.number().int().positive().optional(),
+    all: z.boolean().optional(),
+    limitPages: z.coerce.number().int().positive().max(500).optional(),
+})
+    .strict();
+export const boardListCommand = {
+    name: 'board.list',
+    summary: 'List boards (optionally scoped to a workspace)',
+    examples: [
+        'monday board list',
+        'monday board list --workspace 12345 --state active',
+        'monday board list --all --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardListOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('list')
+            .description(boardListCommand.summary)
+            .option('--workspace <wid>', 'restrict to one workspace')
+            .option('--state <s>', 'active|archived|deleted|all')
+            .option('--limit <n>', 'page size (1-100, default 25)')
+            .option('--page <n>', '1-indexed page')
+            .option('--all', 'walk every page')
+            .option('--limit-pages <n>', `max pages under --all (1-500, default ${String(DEFAULT_MAX_PAGES)})`)
+            .addHelpText('after', ['', 'Examples:', ...boardListCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (opts) => {
+            const parsed = parseArgv(boardListCommand.inputSchema, opts);
+            if (parsed.all === true && parsed.page !== undefined) {
+                throw new UsageError('--all and --page are mutually exclusive');
+            }
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const limit = parsed.limit ?? 25;
+            const maxPages = parsed.limitPages ?? DEFAULT_MAX_PAGES;
+            const result = await walkPages({
+                fetchPage: (page) => {
+                    const variables = { limit, page };
+                    if (parsed.workspace !== undefined) {
+                        variables.workspaceIds = [parsed.workspace];
+                    }
+                    if (parsed.state !== undefined)
+                        variables.state = parsed.state;
+                    return client.raw(BOARD_LIST_QUERY, variables, {
+                        operationName: 'BoardList',
+                    });
+                },
+                extractItems: (r) => r.data.boards ?? [],
+                pageSize: limit,
+                all: parsed.all === true,
+                startPage: parsed.page ?? 1,
+                maxPages,
+            });
+            const projected = boardListCommand.outputSchema.parse(result.items);
+            const warnings = [];
+            if (parsed.all === true && result.hasMore) {
+                warnings.push(buildCapWarning(result.pagesFetched));
+            }
+            emitSuccess({
+                ctx,
+                data: projected,
+                schema: boardListCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                hasMore: result.hasMore,
+                warnings,
+                ...toEmit(result.lastResponse),
+            });
+        });
+    },
+};
+//# sourceMappingURL=list.js.map