monday-cli 0.2.0

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

@@ -0,0 +1,364 @@
+/**
+ * `monday board column-update <bid> <cid> [--title <t>]
+ * [--description <d>] [--dry-run]` — change one or more column fields
+ * (`cli-design.md` §4.3 line 1004, `v0.2-plan.md` §3 M16).
+ *
+ * **Wire shape — per-attribute fan-out across two surfaces.** Monday's
+ * column-update API splits across `change_column_title(board_id,
+ * column_id, title)` for `--title` and `change_column_metadata(
+ * board_id, column_id, column_property?: ColumnProperty, value?:
+ * String)` for `--description`. Both arguments on `change_column_
+ * metadata` are optional at the wire (SDK 14.0.0 `MutationChange_
+ * Column_MetadataArgs`); the CLI always supplies both whenever
+ * `--description` is provided (`column_property: description`,
+ * `value: <description>`). The `ColumnProperty` enum (SDK 14.0.0)
+ * carries only `title` / `description` values; the CLI routes
+ * `--title` to `change_column_title` (the more specific Monday
+ * surface) rather than to `change_column_metadata({column_property:
+ * title})`. 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 `board update`'s contract from M15.
+ *
+ * **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
+ * column to see what landed before retrying the unapplied tail.
+ *
+ * **Data projects from the trailing call (no force-live read leg).**
+ * Monday's column-mutation responses return `Maybe<Column>` post-
+ * mutation, so the trailing call's response is authoritative for
+ * both fields — distinguishing column-update from `board update`
+ * (which forces-live because its wire response is per-attribute
+ * and a final whole-board read is needed for the projection).
+ *
+ * **Argv discipline.** At least one of `--title` / `--description` is
+ * required — zero-flag invocation surfaces as `usage_error` (exit 1)
+ * at argv-parse, before any network leg. Mirrors `board update`'s
+ * "at least one of --name / --description required" rule.
+ *
+ * **Dry-run shape** per cli-design §6.4 column-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 column ID
+ * isn't on the board, the dry-run surfaces `not_found` with
+ * `details.column_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. 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, ColumnIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { ApiError, UsageError } 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 { COLUMN_FIELDS_FRAGMENT, columnProjectionSchema, projectMutationColumn, } from '../../api/column-mutation-result.js';
+const CHANGE_COLUMN_TITLE_MUTATION = `
+  mutation ColumnChangeTitle($boardId: ID!, $columnId: String!, $title: String!) {
+    change_column_title(board_id: $boardId, column_id: $columnId, title: $title) {
+      ${COLUMN_FIELDS_FRAGMENT}
+    }
+  }
+`;
+const CHANGE_COLUMN_METADATA_MUTATION = `
+  mutation ColumnChangeMetadata(
+    $boardId: ID!,
+    $columnId: String!,
+    $columnProperty: ColumnProperty!,
+    $value: String!
+  ) {
+    change_column_metadata(
+      board_id: $boardId,
+      column_id: $columnId,
+      column_property: $columnProperty,
+      value: $value
+    ) {
+      ${COLUMN_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardColumnUpdateOutputSchema = columnProjectionSchema;
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    // Column ids are non-numeric slug strings (e.g. `status_4`,
+    // `text__1`); the branded `ColumnIdSchema` in `types/ids.ts`
+    // owns the slug-shape `min(1)` regex + the nominal brand so
+    // a future caller can't confuse a ColumnId with a GroupId at
+    // the type level.
+    columnId: ColumnIdSchema,
+    title: z
+        .string()
+        .refine((s) => s.trim().length > 0, {
+        message: '--title must be non-empty (whitespace-only is rejected)',
+    })
+        .optional(),
+    description: z.string().optional(),
+})
+    .strict()
+    .refine((v) => v.title !== undefined || v.description !== undefined, {
+    message: 'column update requires at least one of --title / --description',
+});
+const titleResponseSchema = z
+    .object({
+    change_column_title: z.unknown(),
+})
+    .loose();
+const metadataResponseSchema = z
+    .object({
+    change_column_metadata: z.unknown(),
+})
+    .loose();
+// Deterministic dispatch order: title first, then description. 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 `board update`'s FIELD_DISPATCH_ORDER pin.
+const FIELD_DISPATCH_ORDER = ['title', 'description'];
+export const boardColumnUpdateCommand = {
+    name: 'board.column-update',
+    summary: 'Update one or more fields of a column',
+    examples: [
+        'monday board column-update 12345 status_4 --title "Priority"',
+        'monday board column-update 12345 status_4 --description "Owner-set urgency"',
+        'monday board column-update 12345 status_4 --title "Priority" --description "Owner-set urgency"',
+        'monday board column-update 12345 status_4 --title "Preview" --dry-run --json',
+    ],
+    // Re-applying the same field values is a server-side no-op — safe
+    // to retry on transient failure. Mirrors `board update`'s rationale.
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardColumnUpdateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('column-update <boardId> <columnId>')
+            .description(boardColumnUpdateCommand.summary)
+            .option('--title <t>', 'new column title')
+            .option('--description <d>', 'new column description')
+            .addHelpText('after', ['', 'Examples:', ...boardColumnUpdateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, columnId, opts) => {
+            const parsed = parseArgv(boardColumnUpdateCommand.inputSchema, {
+                boardId,
+                columnId,
+                ...opts,
+            });
+            const trimmedTitle = parsed.title?.trim();
+            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 column ID isn't on
+                // the board → not_found-with-details.column_id carve-out
+                // shared with `group-update` + `group-archive`.
+                const current = findBoardChildOrThrow({
+                    metadata: preflight.metadata,
+                    kind: 'columns',
+                    id: parsed.columnId,
+                    boardId: parsed.boardId,
+                });
+                const diff = {};
+                if (trimmedTitle !== undefined) {
+                    diff.title = { from: current.title, to: trimmedTitle };
+                }
+                if (parsed.description !== undefined) {
+                    diff.description = {
+                        from: current.description,
+                        to: parsed.description,
+                    };
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'update_column',
+                            board_id: parsed.boardId,
+                            column_id: parsed.columnId,
+                            diff,
+                        },
+                    ],
+                    source: preflight.source,
+                    cacheAgeSeconds: preflight.cacheAgeSeconds,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. Build the dispatch plan in deterministic order
+            // (title → description) so partial-application failure modes
+            // are testable.
+            const dispatchPlan = [];
+            for (const field of FIELD_DISPATCH_ORDER) {
+                if (field === 'title' && trimmedTitle !== undefined) {
+                    dispatchPlan.push({ field: 'title', value: trimmedTitle });
+                }
+                else if (field === 'description' &&
+                    parsed.description !== undefined) {
+                    dispatchPlan.push({ field: 'description', value: parsed.description });
+                }
+            }
+            /* c8 ignore next 6 */
+            if (dispatchPlan.length === 0) {
+                throw new UsageError('column update requires at least one of --title / --description', { details: { board_id: parsed.boardId, column_id: parsed.columnId } });
+            }
+            // 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.
+            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) {
+                        if (entry.field === 'title') {
+                            const response = await client.raw(CHANGE_COLUMN_TITLE_MUTATION, {
+                                boardId: parsed.boardId,
+                                columnId: parsed.columnId,
+                                title: entry.value,
+                            }, { operationName: 'ColumnChangeTitle' });
+                            const data = unwrapOrThrow(titleResponseSchema.safeParse(response.data), {
+                                context: 'Monday returned a malformed ColumnChangeTitle response',
+                                details: {
+                                    board_id: parsed.boardId,
+                                    column_id: parsed.columnId,
+                                },
+                                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 (!('change_column_title' in data)) {
+                                throw new ApiError('internal_error', `Monday's ColumnChangeTitle response is missing the change_column_title root field`, {
+                                    details: {
+                                        board_id: parsed.boardId,
+                                        column_id: parsed.columnId,
+                                        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.",
+                                    },
+                                });
+                            }
+                            // R45 lift: null-payload guard + projection.
+                            // column-update's null path uses `not_found`
+                            // (Monday's idiomatic missing-or-no-access
+                            // response).
+                            lastProjected = projectMutationColumn({
+                                raw: data.change_column_title,
+                                errorCode: 'not_found',
+                                errorMessage: `Monday returned no column payload from change_column_title for board ${parsed.boardId} column ${parsed.columnId}`,
+                                boardId: parsed.boardId,
+                                columnIdKey: 'column_id',
+                                columnIdValue: parsed.columnId,
+                            });
+                            trailingResponse = response;
+                            recordLegSuccess();
+                        }
+                        else {
+                            const response = await client.raw(CHANGE_COLUMN_METADATA_MUTATION, {
+                                boardId: parsed.boardId,
+                                columnId: parsed.columnId,
+                                columnProperty: 'description',
+                                value: entry.value,
+                            }, { operationName: 'ColumnChangeMetadata' });
+                            const data = unwrapOrThrow(metadataResponseSchema.safeParse(response.data), {
+                                context: 'Monday returned a malformed ColumnChangeMetadata response',
+                                details: {
+                                    board_id: parsed.boardId,
+                                    column_id: parsed.columnId,
+                                },
+                                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 (!('change_column_metadata' in data)) {
+                                throw new ApiError('internal_error', `Monday's ColumnChangeMetadata response is missing the change_column_metadata root field`, {
+                                    details: {
+                                        board_id: parsed.boardId,
+                                        column_id: parsed.columnId,
+                                        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.",
+                                    },
+                                });
+                            }
+                            lastProjected = projectMutationColumn({
+                                raw: data.change_column_metadata,
+                                errorCode: 'not_found',
+                                errorMessage: `Monday returned no column payload from change_column_metadata for board ${parsed.boardId} column ${parsed.columnId}`,
+                                boardId: parsed.boardId,
+                                columnIdKey: 'column_id',
+                                columnIdValue: parsed.columnId,
+                            });
+                            trailingResponse = response;
+                            recordLegSuccess();
+                        }
+                    }
+                    // Defensive — TS can't narrow that the success path
+                    // always sets these (the loop only adds to dispatchPlan
+                    // 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', 'column update completed without a trailing wire response — this is a CLI bug', { details: { board_id: parsed.boardId, column_id: parsed.columnId } });
+                    }
+                    return { data: lastProjected, response: trailingResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardColumnUpdateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(lastResponse),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=column-update.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * `monday board columns <bid>` — list a board's columns
+ * (`cli-design.md` §4.3, §6.3).
+ *
+ * Reads through the cached `loadBoardMetadata` so a follow-up `item set`
+ * call (M5b) doesn't pay the same fetch twice. `--no-cache` bypasses
+ * (global flag); `--include-archived` opts archived columns back into
+ * the view per §5.3 step 6.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const boardColumnsOutputSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    archived: z.ZodNullable<z.ZodBoolean>;
+    settings_str: z.ZodNullable<z.ZodString>;
+    width: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>>;
+export type BoardColumnsOutput = z.infer<typeof boardColumnsOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    includeArchived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const boardColumnsCommand: CommandModule<z.infer<typeof inputSchema>, BoardColumnsOutput>;
+export {};
+//# sourceMappingURL=columns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../../src/commands/board/columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAmBnE,eAAO,MAAM,wBAAwB;;;;;;;;mBAA2B,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAaZ,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,kBAAkB,CAmEnB,CAAC"}

package/dist/commands/board/columns.js

@@ -0,0 +1,102 @@
+/**
+ * `monday board columns <bid>` — list a board's columns
+ * (`cli-design.md` §4.3, §6.3).
+ *
+ * Reads through the cached `loadBoardMetadata` so a follow-up `item set`
+ * call (M5b) doesn't pay the same fetch twice. `--no-cache` bypasses
+ * (global flag); `--include-archived` opts archived columns back into
+ * the view per §5.3 step 6.
+ *
+ * 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 columnOutSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string(),
+    type: z.string(),
+    description: z.string().nullable(),
+    archived: z.boolean().nullable(),
+    settings_str: z.string().nullable(),
+    width: z.number().nullable(),
+})
+    .strict();
+export const boardColumnsOutputSchema = z.array(columnOutSchema);
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    includeArchived: z.boolean().optional(),
+})
+    .strict();
+const project = (cols) => cols.map((c) => ({
+    id: c.id,
+    title: c.title,
+    type: c.type,
+    description: c.description,
+    archived: c.archived,
+    settings_str: c.settings_str,
+    width: c.width,
+}));
+export const boardColumnsCommand = {
+    name: 'board.columns',
+    summary: "List a board's columns (cached for the M5b write path)",
+    examples: [
+        'monday board columns 12345',
+        'monday board columns 12345 --include-archived --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardColumnsOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('columns <boardId>')
+            .description(boardColumnsCommand.summary)
+            .option('--include-archived', 'show archived columns too')
+            .addHelpText('after', ['', 'Examples:', ...boardColumnsCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardColumnsCommand.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 cols = parsed.includeArchived === true
+                ? result.metadata.columns
+                : result.metadata.columns.filter((c) => c.archived !== true);
+            const projected = project(cols);
+            // resolveClient seeded `meta.source = 'live'`; override with
+            // the actual data origin so the (unused) error path and the
+            // success path agree.
+            ctx.meta.setSource(result.source);
+            emitSuccess({
+                ctx,
+                data: projected,
+                schema: boardColumnsCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                // The board metadata payload is fetched in a single
+                // request — Monday returns every column at once — so
+                // `has_more` is unconditionally false (§6.3).
+                hasMore: false,
+                source: result.source,
+                apiVersion,
+                // Cache hits never have complexity (no GraphQL call ran).
+                complexity: result.complexity,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+            });
+        });
+    },
+};
+//# sourceMappingURL=columns.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * `monday board create --name <n> [--workspace <wid>]
+ * [--kind public|private|share] [--template <bid>]
+ * [--description <d>] [--dry-run]` — create a new board
+ * (`cli-design.md` §4.3 line 600, `v0.2-plan.md` §3 M15).
+ *
+ * **Wire shape.** Single round-trip via `create_board(board_name,
+ * board_kind, workspace_id?, template_id?, description?)`. Monday's
+ * GraphQL signature pins `board_kind: BoardKind!` (required at the
+ * wire); the CLI defaults `--kind` to `public` when omitted so
+ * agents don't have to remember the wire constraint. `--workspace`
+ * is optional — Monday creates the board in the user's main
+ * workspace when omitted. `--template <bid>` clones from a Monday
+ * template (templates are managed via Monday's UI; the
+ * `BoardKind` enum has no `template` value, so the CLI doesn't
+ * pre-validate template-ness ahead of the wire call — non-template
+ * IDs surface a wire error re-mapped per §6.5). `--description`
+ * is optional; omitting it sends no argument and Monday's server-
+ * side default applies.
+ *
+ * **Live-envelope projection.** Returned `Board` is projected
+ * through `boardProjectionSchema` (the shape `board get` already
+ * pins post-M15). Sharing the schema keeps create / get / update /
+ * duplicate envelopes byte-identical for the same record — a
+ * downstream `monday board get <bid>` after a successful create
+ * returns the same JSON shape.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-create variant:
+ * minimal `{operation: "create_board", name, workspace_id?, kind,
+ * description?, template_id?}`. No preflight read fires; the dry-
+ * run is purely argv-derived. `meta.source: 'none'`.
+ *
+ * **Idempotent: false.** Re-running creates a duplicate board with
+ * the same name. Agents needing dedupe should call
+ * `monday board list` first. NOT destructive (no `--yes` gate).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type BoardProjection } from '../../api/board-projection.js';
+export declare const boardCreateOutputSchema: 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 BoardCreateOutput = BoardProjection;
+declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    workspace: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">>;
+    kind: z.ZodDefault<z.ZodEnum<{
+        public: "public";
+        private: "private";
+        share: "share";
+    }>>;
+    template: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const boardCreateCommand: CommandModule<z.infer<typeof inputSchema>, BoardCreateOutput>;
+export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/board/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAOnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAuBvC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;kBAAwB,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAgBhD,QAAA,MAAM,WAAW;;;;;;;;;;kBAUN,CAAC;AAQZ,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,iBAAiB,CAuJlB,CAAC"}