monday-cli 0.2.0

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

@@ -0,0 +1,239 @@
+/**
+ * `monday board group-create <bid> --name <n> [--color <c>]
+ * [--dry-run]` — create a new group on a board (`cli-design.md`
+ * §4.3 line 1174, `v0.2-plan.md` §3 M17).
+ *
+ * **Wire shape.** Single round-trip via `create_group(board_id,
+ * group_name, position?, position_relative_method?, relative_to?,
+ * group_color?)` per SDK 14.0.0 `MutationCreate_GroupArgs`. The CLI
+ * flag `--name` maps to wire `group_name: String!`; `--color` maps
+ * to wire `group_color: String?`. M17 deliberately OMITS all three
+ * placement surfaces (`position` is per-changelog deprecated and
+ * `top|bottom` literal semantics are wire-ambiguous; the relative-
+ * position pair `position_relative_method` + `relative_to` is
+ * deferred to v0.3 with `--before <gid>` / `--after <gid>` flags).
+ * Agents needing placement today call the wire mutation via M9's
+ * `dev mutate` escape hatch.
+ *
+ * **`--color` validation.** Monday's accepted colour names are
+ * documented outside the SDK's typed surface (the SDK types
+ * `group_color` as plain `String?`); the v0.2 implementation owns
+ * the field set per cli-design §4.3 group-create. Argv-parses
+ * against the pinned `GROUP_COLOR_VALUES` palette in
+ * `src/api/group-color.ts` (shared with `group-update` so a colour
+ * accepted by create round-trips through update without surprise
+ * rejections). Bogus palette names surface as `usage_error` (exit
+ * 1) BEFORE any network call. Mirrors M16 column-create's per-type
+ * `--settings` field-set ownership rationale — pinning specific
+ * values inline in the contract would force docs revisions every
+ * time Monday tweaks the palette; the implementation owns the
+ * field set so the contract pins only the SHAPE.
+ *
+ * **Live-envelope projection.** Returned `Maybe<Group>` is projected
+ * through `groupProjectionSchema` (the M17 R48-lifted shared shape)
+ * via `projectMutationGroup`. Sharing the schema keeps create /
+ * update / archive / duplicate / delete envelopes byte-identical
+ * for the same record.
+ *
+ * **Dry-run shape** per cli-design §6.4 group-create variant:
+ * minimal `{operation: "create_group", board_id, name, color?}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`.
+ *
+ * **Eager invalidation** (cli-design §8 single-leg call-site
+ * contract). On success, calls `invalidateBoard(boardId)` AFTER
+ * the success envelope's `data` projection completes — never
+ * before the wire mutation, never between mutation and projection.
+ * Skipped on the error path (a failed single-leg call didn't
+ * change board state). The cache entry's stale `groups: [...]`
+ * list is dropped so subsequent reads in the same process see
+ * fresh state without TTL eviction.
+ *
+ * **Idempotent: false.** Re-running creates a second group with
+ * the same name (Monday auto-generates a fresh group id per call).
+ * 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 } from '../../types/ids.js';
+import { withBoardInvalidationSingleLeg } from '../../api/board-mutation-invalidation.js';
+import { GROUP_COLOR_VALUES } from '../../api/group-color.js';
+import { GROUP_FIELDS_FRAGMENT, groupProjectionSchema, projectMutationGroup, } from '../../api/group-mutation-result.js';
+const CREATE_GROUP_MUTATION = `
+  mutation GroupCreate(
+    $boardId: ID!,
+    $groupName: String!,
+    $groupColor: String
+  ) {
+    create_group(
+      board_id: $boardId,
+      group_name: $groupName,
+      group_color: $groupColor
+    ) {
+      ${GROUP_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardGroupCreateOutputSchema = groupProjectionSchema;
+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)',
+    }),
+    // Per cli-design §4.3 group-create: --color is argv-parse
+    // validated against the pinned Monday-supported palette.
+    // M17 implementation owns the field set (see api/group-color.ts);
+    // values outside the set surface as usage_error (exit 1) before
+    // any network call. Mirrors M16 column-create's per-type
+    // `--settings` field-set ownership rationale.
+    color: z.enum(GROUP_COLOR_VALUES).optional(),
+})
+    .strict();
+const responseSchema = z
+    .object({
+    create_group: z.unknown(),
+})
+    .loose();
+export const boardGroupCreateCommand = {
+    name: 'board.group-create',
+    summary: 'Create a new group on a board',
+    examples: [
+        'monday board group-create 12345 --name "Sprint 42"',
+        'monday board group-create 12345 --name "Sprint 42" --color blue',
+        'monday board group-create 12345 --name "Preview" --dry-run --json',
+    ],
+    // create_group is non-idempotent — re-running creates a second
+    // group with the same name (Monday auto-generates a fresh group
+    // id per call). Mirrors `board create` / `workspace create` /
+    // `item create` / `column-create` rationale.
+    idempotent: false,
+    inputSchema,
+    outputSchema: boardGroupCreateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('group-create <boardId>')
+            .description(boardGroupCreateCommand.summary)
+            .requiredOption('--name <n>', 'group name')
+            .option('--color <c>', 'group color (Monday-supported palette name)')
+            .addHelpText('after', ['', 'Examples:', ...boardGroupCreateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardGroupCreateCommand.inputSchema, {
+                boardId,
+                ...opts,
+            });
+            const name = parsed.name.trim();
+            // No trim on color — the enum check on inputSchema rejects
+            // anything outside GROUP_COLOR_VALUES, which already covers
+            // exact-match shapes.
+            const color = parsed.color;
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Per cli-design §6.4 group-create variant: minimal
+                // `{operation, board_id, name, color?}`. No preflight
+                // read fires — purely argv-derived; meta.source: 'none'.
+                const planned = {
+                    operation: 'create_group',
+                    board_id: parsed.boardId,
+                    name,
+                };
+                if (color !== undefined) {
+                    planned.color = color;
+                }
+                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.
+            const variables = {
+                boardId: parsed.boardId,
+                groupName: name,
+            };
+            if (color !== undefined) {
+                variables.groupColor = color;
+            }
+            // §8 single-leg call-site contract via `withBoardInvalidation
+            // SingleLeg` (R46): the helper invalidates AFTER the closure
+            // returns (i.e. after `data` projection completes). On the
+            // error path the closure's throw bypasses invalidation —
+            // matching the §8 "skip on error" rule. Ordered BEFORE
+            // emitMutation so a cache-unlink failure surfaces through
+            // the runner's catch-all rather than double-emitting after
+            // a success envelope hit stdout.
+            const { data: projected, response } = await withBoardInvalidationSingleLeg({
+                boardId: parsed.boardId,
+                env: ctx.env,
+                perform: async () => {
+                    const wireResponse = await client.raw(CREATE_GROUP_MUTATION, variables, { operationName: 'GroupCreate' });
+                    const data = unwrapOrThrow(responseSchema.safeParse(wireResponse.data), {
+                        context: 'Monday returned a malformed GroupCreate response',
+                        details: { board_id: parsed.boardId, 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 group → also internal_
+                    // error here since create's contract is "every
+                    // successful call returns a Group"). Mirrors the M16
+                    // column-create / M15 board-create missing-root-key vs
+                    // null-payload split.
+                    if (!('create_group' in data)) {
+                        throw new ApiError('internal_error', `Monday's GroupCreate response is missing the create_group root field`, {
+                            details: {
+                                board_id: parsed.boardId,
+                                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.",
+                            },
+                        });
+                    }
+                    // R48 lift (api/group-mutation-result.ts): null-payload
+                    // guard + projection. Create's null path uses `internal_
+                    // error` because the contract is "every successful call
+                    // returns a Group"; the helper carries the agent-
+                    // supplied `name` in `details` (paired with `board_id`)
+                    // because the new group id doesn't exist yet on the
+                    // null path.
+                    const projection = projectMutationGroup({
+                        raw: data.create_group,
+                        errorCode: 'internal_error',
+                        errorMessage: `Monday returned no group payload from create_group for board ${parsed.boardId} name ${JSON.stringify(name)}.`,
+                        boardId: parsed.boardId,
+                        idKey: 'name',
+                        idValue: name,
+                    });
+                    return { data: projection, response: wireResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardGroupCreateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=group-create.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * `monday board group-delete <bid> <gid> --yes [--dry-run]` —
+ * delete a group from a board (`cli-design.md` §4.3 line 1506,
+ * `v0.2-plan.md` §3 M17).
+ *
+ * **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, group_id, hint}` per
+ * cli-design §6.5 single-target shape — the wire signature
+ * (`delete_group(board_id, group_id)`) is two-tuple, so both ids
+ * echo. Same gate-before-`resolveClient()` ordering as `item
+ * delete` / `workspace delete` / `board delete` / `column-delete`
+ * / `group-archive`. R29 helper count: 9 → 10 (group-delete is the
+ * 10th consumer of `enforceDestructiveGate`); 3rd two-tuple
+ * `extraDetails` consumer after column-delete + group-archive.
+ *
+ * **`--dry-run` bypasses the confirmation gate** per cli-design
+ * §3.1 #7 — dry-run is non-executing and the gate is for live
+ * destructive writes only. `group-delete <bid> <gid> --dry-run`
+ * without `--yes` emits the dry-run envelope with `meta.source:
+ * 'none'`, matching `item delete` / `update delete` / `workspace
+ * delete` / `board delete` / `column-delete` precedent.
+ *
+ * **Wire shape.** Single round-trip via `delete_group(board_id,
+ * group_id)` per SDK 14.0.0 `MutationDelete_GroupArgs`. Monday
+ * returns `Maybe<Group>` (the group's last-look projection before
+ * deletion). A null result surfaces as `not_found` — the standard
+ * "id was bogus / already deleted" mapping.
+ *
+ * **Dry-run shape** per cli-design §6.4 group-delete variant:
+ * minimal `{operation: "delete_group", board_id, group_id}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors the destructive-no-read pattern
+ * uniform across `item delete` / `update delete` / `workspace
+ * delete` / `board delete` / M16 `column-delete`. Note the
+ * deliberate divergence from `group-archive`'s snapshot-bearing
+ * dry-run shape: archive carries the source snapshot
+ * (item-archive / board-archive precedent — recoverable
+ * destructive; preview shows what will be hidden), delete is
+ * minimal (workspace-delete / board-delete / column-delete
+ * precedent — irrecoverable destructive past Monday's retention
+ * window; the agent already knows what they're deleting).
+ *
+ * **Eager invalidation** (cli-design §8 single-leg call-site
+ * contract). On success, calls `invalidateBoard(boardId)` AFTER
+ * the success envelope's `data` projection completes; ordered
+ * BEFORE `emitMutation` so a cache-unlink failure surfaces
+ * through the runner's catch-all. Skipped on the error path.
+ * Required because the deleted group must drop from the cached
+ * `groups: [...]` list; without invalidation a same-process
+ * `board describe` / `monday board groups <bid>` would surface a
+ * phantom group until TTL eviction.
+ *
+ * **Idempotent: false.** Re-deleting an already-deleted group
+ * surfaces `not_found` past the first call — the wire-level
+ * converges, but the CLI-level surfaces a different envelope.
+ * Mirrors `item delete` / `update delete` / `workspace delete` /
+ * `board delete` / `column-delete` rationale.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type GroupProjection } from '../../api/group-mutation-result.js';
+export declare const boardGroupDeleteOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    color: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodString>;
+    archived: z.ZodNullable<z.ZodBoolean>;
+    deleted: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strict>;
+export type BoardGroupDeleteOutput = GroupProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    groupId: z.core.$ZodBranded<z.ZodString, "GroupId", "out">;
+}, z.core.$strict>;
+export declare const boardGroupDeleteCommand: CommandModule<z.infer<typeof inputSchema>, BoardGroupDeleteOutput>;
+export {};
+//# sourceMappingURL=group-delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-delete.d.ts","sourceRoot":"","sources":["../../../src/commands/board/group-delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAU5C,eAAO,MAAM,4BAA4B;;;;;;;kBAAwB,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAErD,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAQZ,eAAO,MAAM,uBAAuB,EAAE,aAAa,CACjD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,sBAAsB,CAwJvB,CAAC"}

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

@@ -0,0 +1,222 @@
+/**
+ * `monday board group-delete <bid> <gid> --yes [--dry-run]` —
+ * delete a group from a board (`cli-design.md` §4.3 line 1506,
+ * `v0.2-plan.md` §3 M17).
+ *
+ * **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, group_id, hint}` per
+ * cli-design §6.5 single-target shape — the wire signature
+ * (`delete_group(board_id, group_id)`) is two-tuple, so both ids
+ * echo. Same gate-before-`resolveClient()` ordering as `item
+ * delete` / `workspace delete` / `board delete` / `column-delete`
+ * / `group-archive`. R29 helper count: 9 → 10 (group-delete is the
+ * 10th consumer of `enforceDestructiveGate`); 3rd two-tuple
+ * `extraDetails` consumer after column-delete + group-archive.
+ *
+ * **`--dry-run` bypasses the confirmation gate** per cli-design
+ * §3.1 #7 — dry-run is non-executing and the gate is for live
+ * destructive writes only. `group-delete <bid> <gid> --dry-run`
+ * without `--yes` emits the dry-run envelope with `meta.source:
+ * 'none'`, matching `item delete` / `update delete` / `workspace
+ * delete` / `board delete` / `column-delete` precedent.
+ *
+ * **Wire shape.** Single round-trip via `delete_group(board_id,
+ * group_id)` per SDK 14.0.0 `MutationDelete_GroupArgs`. Monday
+ * returns `Maybe<Group>` (the group's last-look projection before
+ * deletion). A null result surfaces as `not_found` — the standard
+ * "id was bogus / already deleted" mapping.
+ *
+ * **Dry-run shape** per cli-design §6.4 group-delete variant:
+ * minimal `{operation: "delete_group", board_id, group_id}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors the destructive-no-read pattern
+ * uniform across `item delete` / `update delete` / `workspace
+ * delete` / `board delete` / M16 `column-delete`. Note the
+ * deliberate divergence from `group-archive`'s snapshot-bearing
+ * dry-run shape: archive carries the source snapshot
+ * (item-archive / board-archive precedent — recoverable
+ * destructive; preview shows what will be hidden), delete is
+ * minimal (workspace-delete / board-delete / column-delete
+ * precedent — irrecoverable destructive past Monday's retention
+ * window; the agent already knows what they're deleting).
+ *
+ * **Eager invalidation** (cli-design §8 single-leg call-site
+ * contract). On success, calls `invalidateBoard(boardId)` AFTER
+ * the success envelope's `data` projection completes; ordered
+ * BEFORE `emitMutation` so a cache-unlink failure surfaces
+ * through the runner's catch-all. Skipped on the error path.
+ * Required because the deleted group must drop from the cached
+ * `groups: [...]` list; without invalidation a same-process
+ * `board describe` / `monday board groups <bid>` would surface a
+ * phantom group until TTL eviction.
+ *
+ * **Idempotent: false.** Re-deleting an already-deleted group
+ * surfaces `not_found` past the first call — the wire-level
+ * converges, but the CLI-level surfaces a different envelope.
+ * Mirrors `item delete` / `update delete` / `workspace delete` /
+ * `board delete` / `column-delete` rationale.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema, GroupIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { 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 { GROUP_FIELDS_FRAGMENT, groupProjectionSchema, projectMutationGroup, } from '../../api/group-mutation-result.js';
+const DELETE_GROUP_MUTATION = `
+  mutation GroupDelete($boardId: ID!, $groupId: String!) {
+    delete_group(board_id: $boardId, group_id: $groupId) {
+      ${GROUP_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardGroupDeleteOutputSchema = groupProjectionSchema;
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    groupId: GroupIdSchema,
+})
+    .strict();
+const responseSchema = z
+    .object({
+    delete_group: z.unknown(),
+})
+    .loose();
+export const boardGroupDeleteCommand = {
+    name: 'board.group-delete',
+    summary: 'Delete a group from a board — --yes required',
+    examples: [
+        'monday board group-delete 12345 topics --yes',
+        'monday board group-delete 12345 topics --dry-run',
+        'monday board group-delete 12345 topics --yes --json',
+    ],
+    // Re-deleting an already-deleted group surfaces not_found —
+    // same rationale as workspace / board / update / item / column
+    // delete.
+    idempotent: false,
+    inputSchema,
+    outputSchema: boardGroupDeleteOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('group-delete <boardId> <groupId>')
+            .description(boardGroupDeleteCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardGroupDeleteCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, groupId) => {
+            const parsed = parseArgv(boardGroupDeleteCommand.inputSchema, {
+                boardId,
+                groupId,
+            });
+            // 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). The two-tuple wire
+            // signature carries both ids in the confirmation envelope
+            // per cli-design §6.5: `extraDetails: {board_id}` rides
+            // alongside the canonical `group_id` detailKey.
+            const globalFlags = parseGlobalFlags(program.opts(), ctx.env);
+            enforceDestructiveGate({
+                globalFlags,
+                verb: 'board group-delete',
+                target: parsed.groupId,
+                detailKey: 'group_id',
+                extraDetails: { board_id: parsed.boardId },
+                action: `delete group ${parsed.groupId} from board ${parsed.boardId}`,
+                hint: 'delete is destructive — Monday retains deleted groups ' +
+                    'past their retention window; pass `--dry-run` first to ' +
+                    'preview, or use `monday board group-archive` for a ' +
+                    'recoverable hide (cli-design §4.3 group-delete + §8 ' +
+                    'decision 9).',
+            });
+            if (globalFlags.dryRun) {
+                // Minimal dry-run shape per §6.4 group-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_group',
+                            board_id: parsed.boardId,
+                            group_id: parsed.groupId,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            // §8 single-leg call-site contract via `withBoardInvalidation
+            // SingleLeg` (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 — a failed call
+            // didn't change board state.
+            const { data: projected, response } = await withBoardInvalidationSingleLeg({
+                boardId: parsed.boardId,
+                env: ctx.env,
+                perform: async () => {
+                    const wireResponse = await client.raw(DELETE_GROUP_MUTATION, { boardId: parsed.boardId, groupId: parsed.groupId }, { operationName: 'GroupDelete' });
+                    const data = unwrapOrThrow(responseSchema.safeParse(wireResponse.data), {
+                        context: 'Monday returned a malformed GroupDelete response',
+                        details: { board_id: parsed.boardId, group_id: parsed.groupId },
+                        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 (group missing →
+                    // not_found). Mirrors the M15 board-delete + M16
+                    // column-delete distinction.
+                    if (!('delete_group' in data)) {
+                        throw new ApiError('internal_error', `Monday's GroupDelete response is missing the delete_group root field`, {
+                            details: {
+                                board_id: parsed.boardId,
+                                group_id: parsed.groupId,
+                                hint: "this is a schema-drift error in Monday's GraphQL " +
+                                    'response; verify the mutation declaration and update ' +
+                                    "the response schema if Monday's contract has changed.",
+                            },
+                        });
+                    }
+                    // R48 lift: null-payload guard + projection. Delete's
+                    // null path uses `not_found` (Monday's "id was bogus /
+                    // already deleted" mapping).
+                    const projection = projectMutationGroup({
+                        raw: data.delete_group,
+                        errorCode: 'not_found',
+                        errorMessage: `Monday returned no group payload from delete_group for board ${parsed.boardId} group ${parsed.groupId}`,
+                        boardId: parsed.boardId,
+                        idKey: 'group_id',
+                        idValue: parsed.groupId,
+                    });
+                    return { data: projection, response: wireResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardGroupDeleteCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=group-delete.js.map

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

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

package/dist/commands/board/group-duplicate.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `monday board group-duplicate <bid> <gid> [--name <n>]
+ * [--dry-run]` — duplicate a group on a board (`cli-design.md`
+ * §4.3 line 1441, `v0.2-plan.md` §3 M17).
+ *
+ * **Wire shape.** Single round-trip via `duplicate_group(board_id,
+ * group_id, add_to_top?, group_title?)` per SDK 14.0.0
+ * `MutationDuplicate_GroupArgs`. Returns `Maybe<Group>` (the
+ * newly-duplicated group, with a fresh ID auto-generated by
+ * Monday). `--name <n>` maps to wire `group_title?` (when omitted,
+ * Monday's wire-side default naming applies — typically
+ * `"<source name> (copy)"`, but the exact convention is server-
+ * side, not pinned by the CLI). M17 deliberately OMITS
+ * `add_to_top: Boolean` — agents needing placement control call
+ * the wire mutation via M9's `dev mutate` escape hatch (mirrors
+ * M16 column-create's omission of `after_column_id`).
+ *
+ * **Load-bearing divergence from sibling duplicate verbs.** `monday
+ * item duplicate` and `monday board duplicate` both surface
+ * `--with-updates` (mapping to wire `with_updates: Boolean` on
+ * `duplicate_item` / `duplicate_board`); `monday board group-
+ * duplicate` does NOT, because Monday's `duplicate_group` wire
+ * signature has no equivalent argument. The pre-pre-flight
+ * v0.2-plan §3 M17 draft listed `[--with-updates]` for group-
+ * duplicate; the M17 pre-flight pinned the wire truth and dropped
+ * the flag.
+ *
+ * **Live-envelope projection.** Returned `Maybe<Group>` is
+ * projected through `groupProjectionSchema` via
+ * `projectMutationGroup`. The CLI's success envelope's `data` is
+ * the new group's projection (not the source's).
+ *
+ * **Dry-run shape** per cli-design §6.4 group-duplicate variant:
+ * minimal `{operation: "duplicate_group", board_id, group_id,
+ * name?}`. No preflight read leg fires (Monday's `duplicate_group`
+ * reports `not_found` if the IDs are bogus and the dry-run is
+ * purely argv-derived — mirrors `column-delete`'s no-read pattern,
+ * even though group-duplicate is non-destructive). `meta.source:
+ * 'none'`.
+ *
+ * **Eager invalidation** (cli-design §8 single-leg call-site
+ * contract). On success, calls `invalidateBoard(boardId)` AFTER
+ * the success envelope's `data` projection completes. The cached
+ * `groups: [...]` list grew by one entry, so subsequent reads in
+ * the same process see the new group without TTL eviction.
+ *
+ * **Idempotent: false.** Every call creates a new group with a
+ * fresh ID (mirrors `item duplicate` / `board duplicate`). NOT
+ * destructive (no `--yes` gate).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type GroupProjection } from '../../api/group-mutation-result.js';
+export declare const boardGroupDuplicateOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    color: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodString>;
+    archived: z.ZodNullable<z.ZodBoolean>;
+    deleted: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strict>;
+export type BoardGroupDuplicateOutput = GroupProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    groupId: z.core.$ZodBranded<z.ZodString, "GroupId", "out">;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const boardGroupDuplicateCommand: CommandModule<z.infer<typeof inputSchema>, BoardGroupDuplicateOutput>;
+export {};
+//# sourceMappingURL=group-duplicate.d.ts.map

package/dist/commands/board/group-duplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-duplicate.d.ts","sourceRoot":"","sources":["../../../src/commands/board/group-duplicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAQnE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAkB5C,eAAO,MAAM,+BAA+B;;;;;;;kBAAwB,CAAC;AACrE,MAAM,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAExD,QAAA,MAAM,WAAW;;;;kBAWN,CAAC;AAQZ,eAAO,MAAM,0BAA0B,EAAE,aAAa,CACpD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,yBAAyB,CAqJ1B,CAAC"}