monday-cli 0.2.0

package/dist/commands/board/duplicate.js

@@ -0,0 +1,281 @@
+/**
+ * `monday board duplicate <bid> [--name <n>] [--workspace <wid>]
+ * [--with-updates] [--dry-run]` — duplicate a board
+ * (`cli-design.md` §4.3 line 727, `v0.2-plan.md` §3 M15).
+ *
+ * **Wire shape.** Single round-trip via `duplicate_board(board_id,
+ * duplicate_type: DuplicateBoardType!, board_name?, workspace_id?,
+ * folder_id?, keep_subscribers?)`. Returns the M15-unique
+ * `BoardDuplication { board, is_async }` SDK type — the only M15
+ * verb whose live envelope's `data` wraps because Monday's wire
+ * shape carries `is_async`. Per cli-design §6.1 (round-2 F3
+ * widening) + §6.4 board-duplicate variant.
+ *
+ * **`--with-updates` flag mapping.** Selects between Monday's
+ * three-armed `DuplicateBoardType` enum: without --with-updates
+ * the wire call uses `duplicate_board_with_pulses` (items WITHOUT
+ * updates); with --with-updates the wire call uses
+ * `duplicate_board_with_pulses_and_updates` (items WITH updates).
+ * The third arm (`duplicate_board_with_structure` — skeleton
+ * without items) is deferred to a later v0.x; agents needing it
+ * use M9's `dev mutate` escape hatch.
+ *
+ * **`is_async` semantics.** When true, Monday has queued the
+ * duplication server-side and the new board may not be fully
+ * populated by envelope time. Agents needing to operate on the
+ * duplicated items / updates poll `boards(ids: [<new_id>]) {
+ * state }` until terminal state. When false, the duplication has
+ * fully landed by envelope time and immediate follow-up reads
+ * are safe. (cli-design §6.4 board-duplicate live envelope.)
+ *
+ * **`--workspace` is optional.** Defaults to the source board's
+ * workspace; only forwards when the agent provides a value.
+ *
+ * **`--name` is optional.** Defaults to Monday's server-side
+ * "<source name> (Copy)" when omitted.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-duplicate variant:
+ * `{operation: "duplicate_board", board_id, with_updates,
+ * target_workspace_id?, target_name?, board: <projected source
+ * snapshot>}`. Preflight `board get` read via `loadBoardMetadata`
+ * — cache hits observable; `meta.source: 'live' | 'cache'`.
+ * Cache-staleness caveat: pass `--no-cache` for force-live
+ * preview when freshness matters.
+ *
+ * **Idempotent: false.** Re-running creates a second copy. NOT
+ * destructive (no --yes gate — cli-design §3.1 #7 reserves the
+ * gate for destructive verbs). Same shape `monday board create`
+ * uses for non-destructive idempotency.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema, WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { ApiError } from '../../utils/errors.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { loadBoardMetadata } from '../../api/board-metadata.js';
+import { BOARD_FIELDS_FRAGMENT, boardProjectionSchema, } from '../../api/board-projection.js';
+import { projectMutationBoard } from '../../api/board-mutation-result.js';
+const DUPLICATE_BOARD_MUTATION = `
+  mutation BoardDuplicate(
+    $boardId: ID!,
+    $duplicateType: DuplicateBoardType!,
+    $boardName: String,
+    $workspaceId: ID
+  ) {
+    duplicate_board(
+      board_id: $boardId,
+      duplicate_type: $duplicateType,
+      board_name: $boardName,
+      workspace_id: $workspaceId
+    ) {
+      board {
+        ${BOARD_FIELDS_FRAGMENT}
+      }
+      is_async
+    }
+  }
+`;
+/**
+ * The mutation envelope's `data` wraps `BoardDuplication { board,
+ * is_async }`. Per cli-design §6.4 board-duplicate variant + §6.1
+ * universal envelope widening (round-2 F3) — single-target verbs
+ * usually surface the projection directly, but `board duplicate`
+ * is the M15 wrapper case because `is_async` is load-bearing for
+ * agents that duplicate-then-immediately-read.
+ */
+export const boardDuplicateOutputSchema = z
+    .object({
+    board: boardProjectionSchema,
+    is_async: z.boolean(),
+})
+    .strict();
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    name: z
+        .string()
+        .refine((s) => s.trim().length > 0, {
+        message: '--name must be non-empty (whitespace-only is rejected)',
+    })
+        .optional(),
+    workspace: WorkspaceIdSchema.optional(),
+    withUpdates: z.boolean().optional().default(false),
+})
+    .strict();
+const responseSchema = z
+    .object({
+    duplicate_board: z.unknown(),
+})
+    .loose();
+const duplicationPayloadSchema = z
+    .object({
+    board: z.unknown(),
+    is_async: z.boolean(),
+})
+    .loose();
+export const boardDuplicateCommand = {
+    name: 'board.duplicate',
+    summary: "Duplicate a board (optionally including its items' updates)",
+    examples: [
+        'monday board duplicate 12345',
+        'monday board duplicate 12345 --name "Engineering — EU" --workspace 5',
+        'monday board duplicate 12345 --with-updates',
+        'monday board duplicate 12345 --dry-run --json',
+    ],
+    // Re-running creates a second copy. Mirrors `board create` /
+    // `item duplicate` rationale.
+    idempotent: false,
+    inputSchema,
+    outputSchema: boardDuplicateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('duplicate <boardId>')
+            .description(boardDuplicateCommand.summary)
+            .option('--name <n>', "new board name (defaults to '<source> (Copy)')")
+            .option('--workspace <wid>', "destination workspace ID (defaults to source's workspace)")
+            .option('--with-updates', "include the source items' updates (Monday's `with_updates` enum)")
+            .addHelpText('after', ['', 'Examples:', ...boardDuplicateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardDuplicateCommand.inputSchema, {
+                boardId,
+                ...opts,
+            });
+            const trimmedName = parsed.name?.trim();
+            // No confirmation gate — duplicate is creative, not
+            // destructive (cli-design §3.1 #7). resolveClient runs
+            // first so a missing token surfaces as config_error before
+            // any wire attempt.
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Preflight via loadBoardMetadata so the v0.1 board-
+                // metadata cache can serve fresh entries. Cache-staleness
+                // caveat applies — agents pass --no-cache for force-live
+                // preview when freshness is critical.
+                const preflight = await loadBoardMetadata({
+                    client,
+                    boardId: parsed.boardId,
+                    env: ctx.env,
+                    noCache: globalFlags.noCache,
+                });
+                const current = preflight.metadata;
+                // Project to the full BoardProjection shape — Codex M15
+                // implementation round-1 F2: cli-design pins the dry-run
+                // snapshot as the §6.2 single-resource projection
+                // (mirrors board archive's snapshot fix in the same
+                // round).
+                const snapshot = {
+                    id: current.id,
+                    name: current.name,
+                    description: current.description,
+                    state: current.state,
+                    board_kind: current.board_kind,
+                    board_folder_id: current.board_folder_id,
+                    workspace_id: current.workspace_id,
+                    url: current.url,
+                    items_count: current.items_count ?? null,
+                    updated_at: current.updated_at,
+                    permissions: current.permissions ?? null,
+                };
+                const planned = {
+                    operation: 'duplicate_board',
+                    board_id: parsed.boardId,
+                    with_updates: parsed.withUpdates,
+                    board: snapshot,
+                };
+                if (parsed.workspace !== undefined) {
+                    planned.target_workspace_id = parsed.workspace;
+                }
+                if (trimmedName !== undefined) {
+                    planned.target_name = trimmedName;
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [planned],
+                    source: preflight.source,
+                    cacheAgeSeconds: preflight.cacheAgeSeconds,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. Map --with-updates to the DuplicateBoardType
+            // enum: false → duplicate_board_with_pulses (items only,
+            // no updates); true → duplicate_board_with_pulses_and_
+            // updates (items + their updates).
+            const duplicateType = parsed.withUpdates
+                ? 'duplicate_board_with_pulses_and_updates'
+                : 'duplicate_board_with_pulses';
+            const variables = {
+                boardId: parsed.boardId,
+                duplicateType,
+            };
+            if (trimmedName !== undefined) {
+                variables.boardName = trimmedName;
+            }
+            if (parsed.workspace !== undefined) {
+                variables.workspaceId = parsed.workspace;
+            }
+            const response = await client.raw(DUPLICATE_BOARD_MUTATION, variables, { operationName: 'BoardDuplicate' });
+            const data = unwrapOrThrow(responseSchema.safeParse(response.data), {
+                context: 'Monday returned a malformed BoardDuplicate response',
+                details: { board_id: parsed.boardId },
+                hint: 'this is a data-integrity error in Monday\'s response; ' +
+                    'verify the response shape and update responseSchema if ' +
+                    'Monday\'s contract has changed.',
+            });
+            // Distinguish missing-root-key (schema-drift →
+            // internal_error) from null payload (board missing →
+            // not_found). Same M14 round-2/round-3 distinction.
+            if (!('duplicate_board' in data)) {
+                throw new ApiError('internal_error', `Monday's BoardDuplicate response is missing the duplicate_board root field`, {
+                    details: {
+                        board_id: parsed.boardId,
+                        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.',
+                    },
+                });
+            }
+            if (data.duplicate_board === null || data.duplicate_board === undefined) {
+                throw new ApiError('not_found', `Monday returned no BoardDuplication payload from duplicate_board for id ${parsed.boardId}`, { details: { board_id: parsed.boardId } });
+            }
+            // BoardDuplication has two fields — `board` (the
+            // duplicated board's projection) and `is_async`. Parse the
+            // wrapper here (R43 only covers the inner-board projection,
+            // not the wrapped envelope unique to duplicate), then
+            // project the inner board through `projectMutationBoard`
+            // (api/board-mutation-result.ts). Inner-board null path
+            // uses `internal_error` because the wrapper succeeded
+            // server-side but the projection is empty — schema-drift /
+            // server-side glitch rather than the agent-recovery
+            // story `not_found` carries.
+            const wrapper = unwrapOrThrow(duplicationPayloadSchema.safeParse(data.duplicate_board), {
+                context: 'Monday returned a malformed BoardDuplication payload',
+                details: { board_id: parsed.boardId },
+            });
+            const projectedBoard = projectMutationBoard({
+                raw: wrapper.board,
+                errorCode: 'internal_error',
+                errorMessage: `Monday returned no board inside BoardDuplication for source id ${parsed.boardId}`,
+                detailKey: 'board_id',
+                detailValue: parsed.boardId,
+            });
+            emitMutation({
+                ctx,
+                data: { board: projectedBoard, is_async: wrapper.is_async },
+                schema: boardDuplicateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=duplicate.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * `monday board find <name>` — name-based lookup against `boards`
+ * (`cli-design.md` §5.7).
+ *
+ * GraphQL: a paged `boards` walk filtered by `--workspace`/`--state`,
+ * then `findOne` selects the unique match. Multi-match raises
+ * `ambiguous_name` with `details.candidates`; zero matches →
+ * `not_found`. `--first` opts into the lowest-ID match, with a
+ * `warnings: [{ code: 'first_of_many' }]` entry attached.
+ *
+ * Why a client-side walk rather than a server-side filter: Monday's
+ * `boards` query has no name-substring filter — the only way to
+ * find by name is to read every visible board. The walk caps at
+ * `--limit-pages × 100` to avoid pathological reads on giant
+ * accounts; default 5 pages × 100 = 500 boards. Real-world boards-
+ * per-account counts run hundreds in the heaviest cases. Agents
+ * that hit the cap can pass `--workspace <wid>` to narrow.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const boardFindOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    board_kind: z.ZodNullable<z.ZodString>;
+    workspace_id: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type BoardFindOutput = z.infer<typeof boardFindOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    workspace: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">>;
+    state: z.ZodOptional<z.ZodEnum<{
+        archived: "archived";
+        deleted: "deleted";
+        all: "all";
+        active: "active";
+    }>>;
+    first: z.ZodOptional<z.ZodBoolean>;
+    limitPages: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const boardFindCommand: CommandModule<z.infer<typeof inputSchema>, BoardFindOutput>;
+export {};
+//# sourceMappingURL=find.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/commands/board/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA6CnE,eAAO,MAAM,qBAAqB;;;;;;;;kBAAc,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,QAAA,MAAM,WAAW;;;;;;;;;;;kBAQN,CAAC;AASZ,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAC1C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,eAAe,CA6FhB,CAAC"}

package/dist/commands/board/find.js

@@ -0,0 +1,153 @@
+/**
+ * `monday board find <name>` — name-based lookup against `boards`
+ * (`cli-design.md` §5.7).
+ *
+ * GraphQL: a paged `boards` walk filtered by `--workspace`/`--state`,
+ * then `findOne` selects the unique match. Multi-match raises
+ * `ambiguous_name` with `details.candidates`; zero matches →
+ * `not_found`. `--first` opts into the lowest-ID match, with a
+ * `warnings: [{ code: 'first_of_many' }]` entry attached.
+ *
+ * Why a client-side walk rather than a server-side filter: Monday's
+ * `boards` query has no name-substring filter — the only way to
+ * find by name is to read every visible board. The walk caps at
+ * `--limit-pages × 100` to avoid pathological reads on giant
+ * accounts; default 5 pages × 100 = 500 boards. Real-world boards-
+ * per-account counts run hundreds in the heaviest cases. Agents
+ * that hit the cap can pass `--workspace <wid>` to narrow.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { findOne } from '../../api/resolvers.js';
+import { WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { walkPages } from '../../api/walk-pages.js';
+const BOARD_FIND_QUERY = `
+  query BoardFind(
+    $limit: Int
+    $page: Int
+    $workspaceIds: [ID]
+    $state: State
+  ) {
+    boards(
+      limit: $limit
+      page: $page
+      workspace_ids: $workspaceIds
+      state: $state
+    ) {
+      id
+      name
+      description
+      state
+      board_kind
+      workspace_id
+      url
+    }
+  }
+`;
+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(),
+    workspace_id: z.string().nullable(),
+    url: z.string().nullable(),
+})
+    .strict();
+export const boardFindOutputSchema = boardSchema;
+const inputSchema = z
+    .object({
+    name: z.string().min(1),
+    workspace: WorkspaceIdSchema.optional(),
+    state: z.enum(['active', 'archived', 'deleted', 'all']).optional(),
+    first: z.boolean().optional(),
+    limitPages: z.coerce.number().int().positive().max(50).optional(),
+})
+    .strict();
+const PAGE_SIZE = 100;
+const DEFAULT_PAGES = 5;
+export const boardFindCommand = {
+    name: 'board.find',
+    summary: 'Find a single board by name (uses findOne semantics)',
+    examples: [
+        'monday board find "Refactor login"',
+        'monday board find "Roadmap" --workspace 12345',
+        'monday board find "Many matches" --first --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardFindOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('find <name>')
+            .description(boardFindCommand.summary)
+            .option('--workspace <wid>', 'restrict scope to one workspace')
+            .option('--state <s>', 'active|archived|deleted|all (default active)')
+            .option('--first', 'on multiple matches, pick the lowest-ID match')
+            .option('--limit-pages <n>', `how many 100-board pages to scan (default ${String(DEFAULT_PAGES)})`)
+            .addHelpText('after', ['', 'Examples:', ...boardFindCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (name, opts) => {
+            const parsed = parseArgv(boardFindCommand.inputSchema, {
+                name,
+                ...opts,
+            });
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const cap = parsed.limitPages ?? DEFAULT_PAGES;
+            const walked = await walkPages({
+                fetchPage: (page) => {
+                    const variables = {
+                        limit: PAGE_SIZE,
+                        page,
+                    };
+                    if (parsed.workspace !== undefined) {
+                        variables.workspaceIds = [parsed.workspace];
+                    }
+                    if (parsed.state !== undefined)
+                        variables.state = parsed.state;
+                    return client.raw(BOARD_FIND_QUERY, variables, {
+                        operationName: 'BoardFind',
+                    });
+                },
+                extractItems: (r) => r.data.boards ?? [],
+                pageSize: PAGE_SIZE,
+                all: true,
+                maxPages: cap,
+            });
+            const lastResponse = walked.lastResponse;
+            // Strict-parse the haystack so a malformed response surfaces
+            // as `internal_error` from the runner — mirrors how every
+            // other M3 list-shaped command behaves.
+            const haystack = z.array(boardSchema).parse(walked.items);
+            const result = findOne(haystack, parsed.name, (b) => ({ id: b.id, name: b.name }), {
+                kind: 'board',
+                ...(parsed.first === undefined ? {} : { first: parsed.first }),
+            });
+            const warnings = [];
+            if (result.firstOfMany) {
+                warnings.push({
+                    code: 'first_of_many',
+                    message: `--first picked one of ${String(result.candidates.length)} matches`,
+                    details: {
+                        candidates: result.candidates.map((c) => ({ id: c.id, name: c.name })),
+                    },
+                });
+            }
+            emitSuccess({
+                ctx,
+                data: result.resource,
+                schema: boardFindCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings,
+                ...toEmit(lastResponse),
+            });
+        });
+    },
+};
+//# sourceMappingURL=find.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * `monday board get <bid>` — single board by ID (`cli-design.md` §6.2).
+ *
+ * Single-resource shape; columns and groups are NOT inlined here —
+ * `board describe` is the heavier read for that. Keeps `board get`
+ * cheap for agents who just need name / state / kind.
+ *
+ * **Projection-helper migration (M15).** The output schema + GraphQL
+ * field set live in `api/board-projection.ts` from M15 onwards, shared
+ * with the M15 board lifecycle cluster (`board create` / `update` /
+ * `archive` / `duplicate`). Pre-M15 the schema was inlined here;
+ * lifting it kept rendered wire bytes byte-identical (6-space
+ * continuation indent matches the existing column) and lets the
+ * mutation cluster reuse the same projection. Mirrors the R39
+ * workspace-projection lift.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type BoardProjection } from '../../api/board-projection.js';
+export declare const boardGetOutputSchema: 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>;
+    permissions: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type BoardGetOutput = BoardProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+}, z.core.$strict>;
+export declare const boardGetCommand: CommandModule<z.infer<typeof inputSchema>, BoardGetOutput>;
+export {};
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/board/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAUvC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;kBAAwB,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAE7C,QAAA,MAAM,WAAW;;kBAAgD,CAAC;AAElE,eAAO,MAAM,eAAe,EAAE,aAAa,CACzC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,cAAc,CAmCf,CAAC"}

package/dist/commands/board/get.js

@@ -0,0 +1,66 @@
+/**
+ * `monday board get <bid>` — single board by ID (`cli-design.md` §6.2).
+ *
+ * Single-resource shape; columns and groups are NOT inlined here —
+ * `board describe` is the heavier read for that. Keeps `board get`
+ * cheap for agents who just need name / state / kind.
+ *
+ * **Projection-helper migration (M15).** The output schema + GraphQL
+ * field set live in `api/board-projection.ts` from M15 onwards, shared
+ * with the M15 board lifecycle cluster (`board create` / `update` /
+ * `archive` / `duplicate`). Pre-M15 the schema was inlined here;
+ * lifting it kept rendered wire bytes byte-identical (6-space
+ * continuation indent matches the existing column) and lets the
+ * mutation cluster reuse the same projection. Mirrors the R39
+ * workspace-projection lift.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { runByIdLookup } from '../run-by-id-lookup.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { BOARD_FIELDS_FRAGMENT, boardProjectionSchema, } from '../../api/board-projection.js';
+const BOARD_GET_QUERY = `
+  query BoardGet($ids: [ID!]) {
+    boards(ids: $ids) {
+      ${BOARD_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardGetOutputSchema = boardProjectionSchema;
+const inputSchema = z.object({ boardId: BoardIdSchema }).strict();
+export const boardGetCommand = {
+    name: 'board.get',
+    summary: 'Show one board by ID (lightweight; use board describe for columns)',
+    examples: [
+        'monday board get 12345',
+        'monday board get 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardGetOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('get <boardId>')
+            .description(boardGetCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardGetCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId) => {
+            const parsed = parseArgv(boardGetCommand.inputSchema, { boardId });
+            await runByIdLookup({
+                ctx,
+                programOpts: program.opts(),
+                query: BOARD_GET_QUERY,
+                operationName: 'BoardGet',
+                collectionKey: 'boards',
+                id: parsed.boardId,
+                errorDetailKey: 'board_id',
+                kind: 'board',
+                schema: boardGetCommand.outputSchema,
+            });
+        });
+    },
+};
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/board/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;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,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,eAAe,GAAG;;;QAGhB,qBAAqB;;;CAG5B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAI1D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAElE,MAAM,CAAC,MAAM,eAAe,GAGxB;IACF,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,oEAAoE;IAC7E,QAAQ,EAAE;QACR,wBAAwB;QACxB,+BAA+B;KAChC;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,oBAAoB;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAClE,IAAI;aACD,OAAO,CAAC,eAAe,CAAC;aACxB,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC;aACpC,WAAW,CACV,OAAO,EACP,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACnF;aACA,MAAM,CAAC,KAAK,EAAE,OAAgB,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACnE,MAAM,aAAa,CAAC;gBAClB,GAAG;gBACH,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,KAAK,EAAE,eAAe;gBACtB,aAAa,EAAE,UAAU;gBACzB,aAAa,EAAE,QAAQ;gBACvB,EAAE,EAAE,MAAM,CAAC,OAAO;gBAClB,cAAc,EAAE,UAAU;gBAC1B,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,eAAe,CAAC,YAAY;aACrC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}