monday-cli 0.2.0

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

@@ -0,0 +1,224 @@
+/**
+ * `monday board column-delete <bid> <cid> --yes [--dry-run]` — delete
+ * a column on a board (`cli-design.md` §4.3 line 1098, `v0.2-plan.md`
+ * §3 M16).
+ *
+ * **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, column_id, hint}` per
+ * cli-design §6.5 single-target shape — the wire signature
+ * (`delete_column(board_id, column_id)`) is two-tuple, so both ids
+ * echo. Same gate-before-`resolveClient()` ordering as `item delete`
+ * / `workspace delete` / `board delete`. R29 helper count: 7 → 8
+ * (column-delete is the 8th consumer of `enforceDestructiveGate`,
+ * the first to use the new `extraDetails` slot for two-tuple
+ * destructive verbs).
+ *
+ * **`--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. `column-delete <bid> <cid> --dry-run` without
+ * `--yes` emits the dry-run envelope with `meta.source: 'none'`,
+ * matching `item delete` / `update delete` / `workspace delete` /
+ * `board delete` precedent.
+ *
+ * **Wire shape.** Single round-trip via `delete_column(board_id,
+ * column_id)`. Monday returns `Maybe<Column>` (the column'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 column-delete variant:
+ * minimal `{operation: "delete_column", board_id, column_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`.
+ *
+ * **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 rather than double-emitting after a success
+ * envelope hit stdout. Skipped on the error path (a failed call
+ * didn't change board state).
+ *
+ * **Idempotent: false.** Re-deleting an already-deleted column
+ * 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` rationale.
+ *
+ * **Note on column-archive divergence.** Monday's API has no
+ * `archive_column` mutation — column lifecycle is delete-only,
+ * mirroring the underlying API surface. The CLI doesn't surface
+ * a `column-archive` verb (cli-design §4.3 column-delete line ~1166).
+ */
+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 { 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 { COLUMN_FIELDS_FRAGMENT, columnProjectionSchema, projectMutationColumn, } from '../../api/column-mutation-result.js';
+const DELETE_COLUMN_MUTATION = `
+  mutation ColumnDelete($boardId: ID!, $columnId: String!) {
+    delete_column(board_id: $boardId, column_id: $columnId) {
+      ${COLUMN_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardColumnDeleteOutputSchema = 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,
+})
+    .strict();
+const responseSchema = z
+    .object({
+    delete_column: z.unknown(),
+})
+    .loose();
+export const boardColumnDeleteCommand = {
+    name: 'board.column-delete',
+    summary: 'Delete a column from a board — --yes required',
+    examples: [
+        'monday board column-delete 12345 status_4 --yes',
+        'monday board column-delete 12345 status_4 --dry-run',
+        'monday board column-delete 12345 status_4 --yes --json',
+    ],
+    // Re-deleting an already-deleted column surfaces not_found — same
+    // rationale as workspace / board / update / item delete.
+    idempotent: false,
+    inputSchema,
+    outputSchema: boardColumnDeleteOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('column-delete <boardId> <columnId>')
+            .description(boardColumnDeleteCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardColumnDeleteCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, columnId) => {
+            const parsed = parseArgv(boardColumnDeleteCommand.inputSchema, {
+                boardId,
+                columnId,
+            });
+            // 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 `column_id` detailKey so agents
+            // see both ids without re-parsing argv.
+            const globalFlags = parseGlobalFlags(program.opts(), ctx.env);
+            enforceDestructiveGate({
+                globalFlags,
+                verb: 'board column-delete',
+                target: parsed.columnId,
+                detailKey: 'column_id',
+                extraDetails: { board_id: parsed.boardId },
+                action: `delete column ${parsed.columnId} from board ${parsed.boardId}`,
+                hint: 'delete is destructive — Monday has no archive_column / ' +
+                    'restore_column mutation, so column lifecycle is delete-only ' +
+                    '(cli-design §4.3 column-delete + §8 decision 9). Re-creating ' +
+                    'a column with the same title yields a fresh id; existing item ' +
+                    'values for the old column are not migrated.',
+            });
+            if (globalFlags.dryRun) {
+                // Minimal dry-run shape per §6.4 column-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_column',
+                            board_id: parsed.boardId,
+                            column_id: parsed.columnId,
+                        },
+                    ],
+                    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_COLUMN_MUTATION, { boardId: parsed.boardId, columnId: parsed.columnId }, { operationName: 'ColumnDelete' });
+                    const data = unwrapOrThrow(responseSchema.safeParse(wireResponse.data), {
+                        context: 'Monday returned a malformed ColumnDelete response',
+                        details: { board_id: parsed.boardId, column_id: parsed.columnId },
+                        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 (column missing →
+                    // not_found). Mirrors the M15 board-delete + column-
+                    // create distinction.
+                    if (!('delete_column' in data)) {
+                        throw new ApiError('internal_error', `Monday's ColumnDelete response is missing the delete_column 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. Delete's
+                    // null path uses `not_found` (Monday's "id was bogus /
+                    // already deleted" mapping) per the column-update /
+                    // column-delete R45 mapping.
+                    const projection = projectMutationColumn({
+                        raw: data.delete_column,
+                        errorCode: 'not_found',
+                        errorMessage: `Monday returned no column payload from delete_column for board ${parsed.boardId} column ${parsed.columnId}`,
+                        boardId: parsed.boardId,
+                        columnIdKey: 'column_id',
+                        columnIdValue: parsed.columnId,
+                    });
+                    return { data: projection, response: wireResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardColumnDeleteCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=column-delete.js.map

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

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

package/dist/commands/board/column-update.d.ts

@@ -0,0 +1,92 @@
+/**
+ * `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 { type CommandModule } from '../types.js';
+import { type ColumnProjection } from '../../api/column-mutation-result.js';
+export declare const boardColumnUpdateOutputSchema: 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 BoardColumnUpdateOutput = ColumnProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    columnId: z.core.$ZodBranded<z.ZodString, "ColumnId", "out">;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const boardColumnUpdateCommand: CommandModule<z.infer<typeof inputSchema>, BoardColumnUpdateOutput>;
+export {};
+//# sourceMappingURL=column-update.d.ts.map

package/dist/commands/board/column-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-update.d.ts","sourceRoot":"","sources":["../../../src/commands/board/column-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnE,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AA4B7C,eAAO,MAAM,6BAA6B;;;;;;;;kBAAyB,CAAC;AACpE,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAEvD,QAAA,MAAM,WAAW;;;;;kBAoBb,CAAC;AAgCL,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAClD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,uBAAuB,CA4QxB,CAAC"}