monday-cli 0.2.0

package/dist/commands/board/create.js

@@ -0,0 +1,226 @@
+/**
+ * `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 { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { parseArgv } from '../parse-argv.js';
+import { ApiError } from '../../utils/errors.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { BoardIdSchema, WorkspaceIdSchema } from '../../types/ids.js';
+import { BOARD_FIELDS_FRAGMENT, boardProjectionSchema, } from '../../api/board-projection.js';
+import { projectMutationBoard } from '../../api/board-mutation-result.js';
+const CREATE_BOARD_MUTATION = `
+  mutation BoardCreate(
+    $boardName: String!,
+    $boardKind: BoardKind!,
+    $workspaceId: ID,
+    $templateId: ID,
+    $description: String
+  ) {
+    create_board(
+      board_name: $boardName,
+      board_kind: $boardKind,
+      workspace_id: $workspaceId,
+      template_id: $templateId,
+      description: $description
+    ) {
+      ${BOARD_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardCreateOutputSchema = boardProjectionSchema;
+// Argv schema. `name` carries the same min(1)-after-trim discipline
+// as `workspace create` / `item create` — Monday accepts whitespace-
+// only names but they produce un-findable boards; reject at the
+// boundary. Use `.refine()` not `.transform()` so the schema stays
+// JSON-Schema-representable (the schema-export pipeline rejects
+// transforms); trim happens inside the action body before the wire
+// call.
+//
+// `workspace` and `template` are branded ID-shape strings; the
+// argv-parse-time validation matches `BoardId` / `WorkspaceId`'s
+// `/^\d+$/` regex. Per the M15 pre-flight contract (cli-design §4.3
+// + Codex round-1 F1), the CLI does NOT pre-validate template-ness
+// — non-template IDs surface a wire `validation_failed` mapped per
+// §6.5.
+const inputSchema = z
+    .object({
+    name: z.string().refine((s) => s.trim().length > 0, {
+        message: '--name must be non-empty (whitespace-only is rejected)',
+    }),
+    workspace: WorkspaceIdSchema.optional(),
+    kind: z.enum(['public', 'private', 'share']).default('public'),
+    template: BoardIdSchema.optional(),
+    description: z.string().optional(),
+})
+    .strict();
+const responseSchema = z
+    .object({
+    create_board: z.unknown(),
+})
+    .loose();
+export const boardCreateCommand = {
+    name: 'board.create',
+    summary: 'Create a new board',
+    examples: [
+        'monday board create --name "Engineering"',
+        'monday board create --name "Engineering — EU" --kind private --workspace 5 --description "EU team"',
+        'monday board create --name "Roadmap" --template 99999',
+        'monday board create --name "Preview" --dry-run --json',
+    ],
+    // create_board is non-idempotent — re-running creates a second
+    // board with the same name. Mirrors `workspace create` /
+    // `item create` rationale.
+    idempotent: false,
+    inputSchema,
+    outputSchema: boardCreateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('create')
+            .description(boardCreateCommand.summary)
+            .requiredOption('--name <n>', 'board name')
+            .option('--workspace <wid>', 'workspace ID (defaults to user main workspace)')
+            .option('--kind <k>', 'board kind: public|private|share (default: public)')
+            .option('--template <bid>', 'clone from this template board ID')
+            .option('--description <d>', 'board description')
+            .addHelpText('after', ['', 'Examples:', ...boardCreateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (opts) => {
+            const parsed = parseArgv(boardCreateCommand.inputSchema, opts);
+            const name = parsed.name.trim();
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Per cli-design §6.4 board-create variant: minimal
+                // `{operation, name, workspace_id?, kind, description?,
+                // template_id?}`. No preflight read fires — purely argv-
+                // derived; `meta.source: 'none'`. The defaulted
+                // `kind: 'public'` is surfaced explicitly so the agent
+                // sees what the live mutation would send.
+                const planned = {
+                    operation: 'create_board',
+                    name,
+                    kind: parsed.kind,
+                };
+                if (parsed.workspace !== undefined) {
+                    planned.workspace_id = parsed.workspace;
+                }
+                if (parsed.description !== undefined) {
+                    planned.description = parsed.description;
+                }
+                if (parsed.template !== undefined) {
+                    planned.template_id = parsed.template;
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [planned],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. Send each optional arg only when the agent
+            // provided one — passing `null` would explicitly clear /
+            // reject Monday's server-side default rather than letting
+            // it apply.
+            const variables = {
+                boardName: name,
+                boardKind: parsed.kind,
+            };
+            if (parsed.workspace !== undefined) {
+                variables.workspaceId = parsed.workspace;
+            }
+            if (parsed.template !== undefined) {
+                variables.templateId = parsed.template;
+            }
+            if (parsed.description !== undefined) {
+                variables.description = parsed.description;
+            }
+            const response = await client.raw(CREATE_BOARD_MUTATION, variables, { operationName: 'BoardCreate' });
+            const data = unwrapOrThrow(responseSchema.safeParse(response.data), {
+                context: 'Monday returned a malformed BoardCreate response',
+                details: { board_name: name },
+                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
+            // with schema-drift hint) from null payload (Monday returned
+            // no board → also internal_error here since create's contract
+            // is "every successful call returns a Board"). Codex M15
+            // implementation round-2 F3 lateral propagation: each M15
+            // mutation verb's response handler distinguishes the two.
+            if (!('create_board' in data)) {
+                throw new ApiError('internal_error', `Monday's BoardCreate response is missing the create_board root field`, {
+                    details: {
+                        board_name: name,
+                        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.',
+                    },
+                });
+            }
+            // R43 lift (api/board-mutation-result.ts): null-payload
+            // guard + projection. Create's null path uses
+            // `internal_error` because the contract is "every successful
+            // call returns a Board"; the helper carries the agent-
+            // supplied `board_name` in `details` because the new id
+            // doesn't exist yet on the null path.
+            const projected = projectMutationBoard({
+                raw: data.create_board,
+                errorCode: 'internal_error',
+                errorMessage: `Monday returned no board payload from create_board for name ${JSON.stringify(name)}.`,
+                detailKey: 'board_name',
+                detailValue: name,
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardCreateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/board/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;QAetB,qBAAqB;;;CAG5B,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAI7D,oEAAoE;AACpE,qEAAqE;AACrE,gEAAgE;AAChE,mEAAmE;AACnE,gEAAgE;AAChE,mEAAmE;AACnE,QAAQ;AACR,EAAE;AACF,+DAA+D;AAC/D,iEAAiE;AACjE,oEAAoE;AACpE,mEAAmE;AACnE,mEAAmE;AACnE,QAAQ;AACR,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE;QAClD,OAAO,EAAE,wDAAwD;KAClE,CAAC;IACF,SAAS,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACvC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC9D,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;CAC1B,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAG3B;IACF,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,oBAAoB;IAC7B,QAAQ,EAAE;QACR,0CAA0C;QAC1C,oGAAoG;QACpG,uDAAuD;QACvD,uDAAuD;KACxD;IACD,+DAA+D;IAC/D,yDAAyD;IACzD,2BAA2B;IAC3B,UAAU,EAAE,KAAK;IACjB,WAAW;IACX,YAAY,EAAE,uBAAuB;IACrC,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,QAAQ,CAAC;aACjB,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC;aACvC,cAAc,CAAC,YAAY,EAAE,YAAY,CAAC;aAC1C,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;aAC7E,MAAM,CAAC,YAAY,EAAE,oDAAoD,CAAC;aAC1E,MAAM,CAAC,kBAAkB,EAAE,mCAAmC,CAAC;aAC/D,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;aAChD,WAAW,CACV,OAAO,EACP,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACtF;aACA,MAAM,CAAC,KAAK,EAAE,IAAa,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,aAAa,CAC/D,GAAG,EACH,OAAO,CAAC,IAAI,EAAE,CACf,CAAC;YAEF,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACvB,oDAAoD;gBACpD,wDAAwD;gBACxD,yDAAyD;gBACzD,gDAAgD;gBAChD,uDAAuD;gBACvD,0CAA0C;gBAC1C,MAAM,OAAO,GAA4B;oBACvC,SAAS,EAAE,cAAc;oBACzB,IAAI;oBACJ,IAAI,EAAE,MAAM,CAAC,IAAI;iBAClB,CAAC;gBACF,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC;gBAC1C,CAAC;gBACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;oBACrC,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;gBAC3C,CAAC;gBACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAClC,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC;gBACxC,CAAC;gBACD,UAAU,CAAC;oBACT,GAAG;oBACH,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;oBAC3B,cAAc,EAAE,CAAC,OAAO,CAAC;oBACzB,MAAM,EAAE,MAAM;oBACd,eAAe,EAAE,IAAI;oBACrB,QAAQ,EAAE,EAAE;oBACZ,UAAU;iBACX,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,wDAAwD;YACxD,yDAAyD;YACzD,0DAA0D;YAC1D,YAAY;YACZ,MAAM,SAAS,GAA4B;gBACzC,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,MAAM,CAAC,IAAI;aACvB,CAAC;YACF,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACnC,SAAS,CAAC,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC;YAC3C,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC;YACzC,CAAC;YACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACrC,SAAS,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YAC7C,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,qBAAqB,EACrB,SAAS,EACT,EAAE,aAAa,EAAE,aAAa,EAAE,CACjC,CAAC;YACF,MAAM,IAAI,GAAG,aAAa,CACxB,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EACvC;gBACE,OAAO,EAAE,kDAAkD;gBAC3D,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;gBAC7B,IAAI,EACF,wDAAwD;oBACxD,yDAAyD;oBACzD,iCAAiC;aACpC,CACF,CAAC;YACF,8DAA8D;YAC9D,6DAA6D;YAC7D,8DAA8D;YAC9D,yDAAyD;YACzD,0DAA0D;YAC1D,0DAA0D;YAC1D,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,sEAAsE,EACtE;oBACE,OAAO,EAAE;wBACP,UAAU,EAAE,IAAI;wBAChB,IAAI,EACF,oDAAoD;4BACpD,uDAAuD;4BACvD,wDAAwD;qBAC3D;iBACF,CACF,CAAC;YACJ,CAAC;YACD,wDAAwD;YACxD,8CAA8C;YAC9C,6DAA6D;YAC7D,uDAAuD;YACvD,wDAAwD;YACxD,sCAAsC;YACtC,MAAM,SAAS,GAAG,oBAAoB,CAAC;gBACrC,GAAG,EAAE,IAAI,CAAC,YAAY;gBACtB,SAAS,EAAE,gBAAgB;gBAC3B,YAAY,EAAE,+DAA+D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG;gBACpG,SAAS,EAAE,YAAY;gBACvB,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YAEH,YAAY,CAAC;gBACX,GAAG;gBACH,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,kBAAkB,CAAC,YAAY;gBACvC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,QAAQ,EAAE,EAAE;gBACZ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBACnB,MAAM,EAAE,MAAM;gBACd,eAAe,EAAE,IAAI;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * `monday board delete <bid> --yes [--dry-run]` — delete a board
+ * (`cli-design.md` §4.3 line 705, `v0.2-plan.md` §3 M15).
+ *
+ * **Confirmation gate** (cli-design §3.1 #7 + §10.2). `--yes` is
+ * mandatory for the live path; without `--yes` (and without
+ * `--dry-run`) the command fails fast with `confirmation_required`
+ * (exit 1) carrying `details.board_id`. Same shape — and same
+ * gate-before-`resolveClient()` ordering — as `item delete` /
+ * `workspace delete` / `update delete`. R29 helper count: 6 → 7
+ * (board delete is the 7th consumer of `enforceDestructiveGate`).
+ *
+ * **Wire shape.** Single round-trip via `delete_board(board_id:
+ * ID!)`. Monday returns the deleted `Board` so the envelope's
+ * `data` is the full projection. A null result surfaces as
+ * `not_found` — the standard "id was bogus / already deleted"
+ * mapping.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-delete variant:
+ * minimal `{operation: "delete_board", board_id}`. No preflight
+ * read fires; the dry-run is purely argv-derived. `meta.source:
+ * 'none'`. Same shape (modulo `board_id`) as `workspace delete` —
+ * the destructive-no-read pattern is uniform across `item delete`
+ * / `update delete` / `workspace delete` / `board delete`.
+ *
+ * **Note on board archive vs board delete divergence.** Archive
+ * carries the source snapshot (mirroring item-archive's
+ * recoverability-aware shape — soft, reversible-via-30-day-window),
+ * delete is minimal (mirroring workspace-delete's destructive-no-
+ * read shape — hard, irrecoverable past Monday's 30-day window).
+ * Both patterns are preserved.
+ *
+ * **Idempotent: false.** Re-running surfaces `not_found` past the
+ * first call. Mirrors `item delete` / `update delete` / `workspace
+ * delete` rationale — agents can't safely retry without verifying
+ * the id still names the same record.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type BoardProjection } from '../../api/board-projection.js';
+export declare const boardDeleteOutputSchema: 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 BoardDeleteOutput = BoardProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+}, z.core.$strict>;
+export declare const boardDeleteCommand: CommandModule<z.infer<typeof inputSchema>, BoardDeleteOutput>;
+export {};
+//# sourceMappingURL=delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/board/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAWvC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;kBAAwB,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD,QAAA,MAAM,WAAW;;kBAAgD,CAAC;AAQlE,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,iBAAiB,CAqJlB,CAAC"}

package/dist/commands/board/delete.js

@@ -0,0 +1,192 @@
+/**
+ * `monday board delete <bid> --yes [--dry-run]` — delete a board
+ * (`cli-design.md` §4.3 line 705, `v0.2-plan.md` §3 M15).
+ *
+ * **Confirmation gate** (cli-design §3.1 #7 + §10.2). `--yes` is
+ * mandatory for the live path; without `--yes` (and without
+ * `--dry-run`) the command fails fast with `confirmation_required`
+ * (exit 1) carrying `details.board_id`. Same shape — and same
+ * gate-before-`resolveClient()` ordering — as `item delete` /
+ * `workspace delete` / `update delete`. R29 helper count: 6 → 7
+ * (board delete is the 7th consumer of `enforceDestructiveGate`).
+ *
+ * **Wire shape.** Single round-trip via `delete_board(board_id:
+ * ID!)`. Monday returns the deleted `Board` so the envelope's
+ * `data` is the full projection. A null result surfaces as
+ * `not_found` — the standard "id was bogus / already deleted"
+ * mapping.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-delete variant:
+ * minimal `{operation: "delete_board", board_id}`. No preflight
+ * read fires; the dry-run is purely argv-derived. `meta.source:
+ * 'none'`. Same shape (modulo `board_id`) as `workspace delete` —
+ * the destructive-no-read pattern is uniform across `item delete`
+ * / `update delete` / `workspace delete` / `board delete`.
+ *
+ * **Note on board archive vs board delete divergence.** Archive
+ * carries the source snapshot (mirroring item-archive's
+ * recoverability-aware shape — soft, reversible-via-30-day-window),
+ * delete is minimal (mirroring workspace-delete's destructive-no-
+ * read shape — hard, irrecoverable past Monday's 30-day window).
+ * Both patterns are preserved.
+ *
+ * **Idempotent: false.** Re-running surfaces `not_found` past the
+ * first call. Mirrors `item delete` / `update delete` / `workspace
+ * delete` rationale — agents can't safely retry without verifying
+ * the id still names the same record.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { parseGlobalFlags } from '../../types/global-flags.js';
+import { ApiError } from '../../utils/errors.js';
+import { enforceDestructiveGate } from '../../api/destructive-gate.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { withBoardInvalidationSingleLeg } from '../../api/board-mutation-invalidation.js';
+import { BOARD_FIELDS_FRAGMENT, boardProjectionSchema, } from '../../api/board-projection.js';
+import { projectMutationBoard } from '../../api/board-mutation-result.js';
+const DELETE_BOARD_MUTATION = `
+  mutation BoardDelete($boardId: ID!) {
+    delete_board(board_id: $boardId) {
+      ${BOARD_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardDeleteOutputSchema = boardProjectionSchema;
+const inputSchema = z.object({ boardId: BoardIdSchema }).strict();
+const responseSchema = z
+    .object({
+    delete_board: z.unknown(),
+})
+    .loose();
+export const boardDeleteCommand = {
+    name: 'board.delete',
+    summary: 'Delete a board — --yes required',
+    examples: [
+        'monday board delete 12345 --yes',
+        'monday board delete 12345 --dry-run',
+        'monday board delete 12345 --yes --json',
+    ],
+    // Re-deleting an already-deleted board surfaces `not_found`. Same
+    // rationale as workspace delete — agents can't safely retry
+    // without verifying the id still names the same record.
+    idempotent: false,
+    inputSchema,
+    outputSchema: boardDeleteOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('delete <boardId>')
+            .description(boardDeleteCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardDeleteCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId) => {
+            const parsed = parseArgv(boardDeleteCommand.inputSchema, { boardId });
+            // Gate fires BEFORE resolveClient() so a missing --yes
+            // surfaces as confirmation_required, not config_error
+            // (M10 round-1 P2 ordering invariant; R29 helper preserves
+            // it via already-parsed globalFlags).
+            const globalFlags = parseGlobalFlags(program.opts(), ctx.env);
+            enforceDestructiveGate({
+                globalFlags,
+                verb: 'board delete',
+                target: parsed.boardId,
+                detailKey: 'board_id',
+                action: 'delete the board',
+                hint: 'delete is destructive — Monday retains deleted boards ' +
+                    'in the trash for ~30 days but exposes no restore ' +
+                    'mutation; agents needing reversal must recreate via ' +
+                    '`monday board create` (lossy: new id, no items / columns ' +
+                    '/ groups / subscribers state).',
+            });
+            if (globalFlags.dryRun) {
+                // Minimal dry-run shape per §6.4 board-delete variant —
+                // no preflight read; meta.source: 'none'. Live surfaces
+                // not_found for bogus ids on its own.
+                const { apiVersion } = resolveClient(ctx, program.opts());
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'delete_board',
+                            board_id: parsed.boardId,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            // M16 retrofit per cli-design §8 single-leg call-site
+            // contract via `withBoardInvalidationSingleLeg` (R46):
+            // invalidate AFTER the closure returns (i.e. after `data`
+            // projection completes), BEFORE emitMutation so a cache-
+            // unlink failure surfaces through the runner's catch-all.
+            // The closure's throws on schema drift / null payload
+            // bypass invalidation. Required because the wire mutation
+            // removes the board entirely; without invalidation a
+            // same-process describe after delete would return stale
+            // metadata until TTL eviction. The invalidation deletes
+            // the cache file so the next read cleanly cache-misses to
+            // the live `not_found`.
+            const { data: projected, response } = await withBoardInvalidationSingleLeg({
+                boardId: parsed.boardId,
+                env: ctx.env,
+                perform: async () => {
+                    const wireResponse = await client.raw(DELETE_BOARD_MUTATION, { boardId: parsed.boardId }, { operationName: 'BoardDelete' });
+                    const data = unwrapOrThrow(responseSchema.safeParse(wireResponse.data), {
+                        context: 'Monday returned a malformed BoardDelete 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). M14 round-2 / round-3 distinction landed
+                    // proactively for M15.
+                    if (!('delete_board' in data)) {
+                        throw new ApiError('internal_error', `Monday's BoardDelete response is missing the delete_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.',
+                            },
+                        });
+                    }
+                    // R43 lift (api/board-mutation-result.ts): null-payload
+                    // guard + projection. Delete's null path uses
+                    // `not_found` (Monday's "id was bogus / already
+                    // deleted" mapping) per M14 round-2 / round-3 missing-
+                    // root vs null distinction.
+                    const projection = projectMutationBoard({
+                        raw: data.delete_board,
+                        errorCode: 'not_found',
+                        errorMessage: `Monday returned no board payload from delete_board for id ${parsed.boardId}`,
+                        detailKey: 'board_id',
+                        detailValue: parsed.boardId,
+                    });
+                    return { data: projection, response: wireResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardDeleteCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=delete.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * `monday board describe <bid>` — full board schema (`cli-design.md`
+ * §4.3, §11.2).
+ *
+ * The CLI's introspection endpoint for one board: every column with
+ * its parsed `settings_str`, every group, the workspace + folder
+ * pointers, hierarchy info (`hierarchy_type` / `is_leaf` — both raw
+ * GraphQL because the SDK doesn't type them in 14.0.0), plus a per-
+ * writable-column `example_set` so an agent can construct
+ * `--set <token>=<value>` calls without consulting Monday's docs.
+ *
+ * Reads through `loadBoardMetadata` (cache-aware). The `example_set`
+ * is fully derivable from `column.type` + `settings_str` so the
+ * shape lives here, not in `board-metadata.ts` — that module stays
+ * focused on the cache projection.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type BoardColumn } from '../../api/board-metadata.js';
+/**
+ * Exported for unit testing. Produces a per-column suggestion list
+ * the agent can copy-paste as `--set` flags. Returns `null` for
+ * non-writable column types so the M3 exit's "writable + non-writable
+ * round-trip" can be asserted.
+ */
+export declare const exampleSetForColumn: (column: BoardColumn) => string[] | null;
+export declare const boardDescribeOutputSchema: 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>;
+    board_folder_id: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    hierarchy_type: z.ZodNullable<z.ZodString>;
+    is_leaf: z.ZodNullable<z.ZodBoolean>;
+    updated_at: z.ZodNullable<z.ZodString>;
+    columns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        archived: z.ZodNullable<z.ZodBoolean>;
+        width: z.ZodNullable<z.ZodNumber>;
+        settings: z.ZodNullable<z.ZodUnknown>;
+        writable: z.ZodBoolean;
+        example_set: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    groups: 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>>;
+}, z.core.$strict>;
+export type BoardDescribeOutput = z.infer<typeof boardDescribeOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    includeArchived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const boardDescribeCommand: CommandModule<z.infer<typeof inputSchema>, BoardDescribeOutput>;
+export {};
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../../src/commands/board/describe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,6BAA6B,CAAC;AAcrC;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,WAAW,KAAG,MAAM,EAAE,GAAG,IA8EpE,CAAC;AA2BF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgB3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAEZ,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAC9C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,mBAAmB,CA8FpB,CAAC"}