monday-cli 0.2.0

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

@@ -0,0 +1,64 @@
+/**
+ * `monday board archive <bid> --yes [--dry-run]` — archive a board
+ * (`cli-design.md` §4.3 line 685, `v0.2-plan.md` §3 M15).
+ *
+ * **Confirmation gate** (cli-design §3.1 #7 + §8 decision 9: archive
+ * is consistently `--yes`-gated across nouns). Mirrors `item
+ * archive` shape — gate fires BEFORE `resolveClient()` so a missing
+ * `--yes` always surfaces as `confirmation_required`, never masked
+ * by a `config_error` from `loadConfig()`'s missing-token check.
+ * R29 helper count: 6 → 7 (item archive / item delete / update
+ * delete / update clear-all / workspace delete / board archive /
+ * board delete next).
+ *
+ * **Wire shape.** Single round-trip via `archive_board(board_id:
+ * ID!)`. Monday's `archive_board` returns the archived `Board`
+ * directly, so no separate pre-mutation read is needed for the
+ * live path. The mutation response is projected through
+ * `boardProjectionSchema`.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-archive variant:
+ * `{operation: "archive_board", board_id, board: <projected source
+ * snapshot>}`. The preflight `board get` read goes through
+ * `loadBoardMetadata` so cache hits are observable; `meta.source:
+ * 'live' | 'cache'`. The snapshot is built from BoardMetadata's
+ * fields that overlap with BoardProjection (id / name /
+ * description / state / board_kind / board_folder_id /
+ * workspace_id / url / updated_at) — `items_count` and
+ * `permissions` are omitted because BoardMetadata doesn't carry
+ * them and forcing a live read for them would defeat the cache-
+ * hit purpose. Agents needing the live-projection shape get it
+ * from the live mutation envelope.
+ *
+ * **Cache-staleness caveat.** Cache-sourced snapshots may lag
+ * live state up to TTL — pass `--no-cache` for a force-live
+ * preview when freshness is critical (e.g. archiving after a
+ * recent rename).
+ *
+ * **Idempotent: true.** Re-archiving an already-archived board
+ * is a no-op on Monday's side (cli-design §9.1 idempotency
+ * table) — agents can safely retry on transient failure.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type BoardProjection } from '../../api/board-projection.js';
+export declare const boardArchiveOutputSchema: 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 BoardArchiveOutput = BoardProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+}, z.core.$strict>;
+export declare const boardArchiveCommand: CommandModule<z.infer<typeof inputSchema>, BoardArchiveOutput>;
+export {};
+//# sourceMappingURL=archive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/commands/board/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAWnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAWvC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;kBAAwB,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAEjD,QAAA,MAAM,WAAW;;kBAAgD,CAAC;AAQlE,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,kBAAkB,CAoLnB,CAAC"}

package/dist/commands/board/archive.js

@@ -0,0 +1,226 @@
+/**
+ * `monday board archive <bid> --yes [--dry-run]` — archive a board
+ * (`cli-design.md` §4.3 line 685, `v0.2-plan.md` §3 M15).
+ *
+ * **Confirmation gate** (cli-design §3.1 #7 + §8 decision 9: archive
+ * is consistently `--yes`-gated across nouns). Mirrors `item
+ * archive` shape — gate fires BEFORE `resolveClient()` so a missing
+ * `--yes` always surfaces as `confirmation_required`, never masked
+ * by a `config_error` from `loadConfig()`'s missing-token check.
+ * R29 helper count: 6 → 7 (item archive / item delete / update
+ * delete / update clear-all / workspace delete / board archive /
+ * board delete next).
+ *
+ * **Wire shape.** Single round-trip via `archive_board(board_id:
+ * ID!)`. Monday's `archive_board` returns the archived `Board`
+ * directly, so no separate pre-mutation read is needed for the
+ * live path. The mutation response is projected through
+ * `boardProjectionSchema`.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-archive variant:
+ * `{operation: "archive_board", board_id, board: <projected source
+ * snapshot>}`. The preflight `board get` read goes through
+ * `loadBoardMetadata` so cache hits are observable; `meta.source:
+ * 'live' | 'cache'`. The snapshot is built from BoardMetadata's
+ * fields that overlap with BoardProjection (id / name /
+ * description / state / board_kind / board_folder_id /
+ * workspace_id / url / updated_at) — `items_count` and
+ * `permissions` are omitted because BoardMetadata doesn't carry
+ * them and forcing a live read for them would defeat the cache-
+ * hit purpose. Agents needing the live-projection shape get it
+ * from the live mutation envelope.
+ *
+ * **Cache-staleness caveat.** Cache-sourced snapshots may lag
+ * live state up to TTL — pass `--no-cache` for a force-live
+ * preview when freshness is critical (e.g. archiving after a
+ * recent rename).
+ *
+ * **Idempotent: true.** Re-archiving an already-archived board
+ * is a no-op on Monday's side (cli-design §9.1 idempotency
+ * table) — agents can safely retry on transient failure.
+ */
+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 { enforceDestructiveGate } from '../../api/destructive-gate.js';
+import { ApiError } from '../../utils/errors.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { withBoardInvalidationSingleLeg } from '../../api/board-mutation-invalidation.js';
+import { loadBoardMetadata } from '../../api/board-metadata.js';
+import { BOARD_FIELDS_FRAGMENT, boardProjectionSchema, } from '../../api/board-projection.js';
+import { projectMutationBoard } from '../../api/board-mutation-result.js';
+const ARCHIVE_BOARD_MUTATION = `
+  mutation BoardArchive($boardId: ID!) {
+    archive_board(board_id: $boardId) {
+      ${BOARD_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardArchiveOutputSchema = boardProjectionSchema;
+const inputSchema = z.object({ boardId: BoardIdSchema }).strict();
+const responseSchema = z
+    .object({
+    archive_board: z.unknown(),
+})
+    .loose();
+export const boardArchiveCommand = {
+    name: 'board.archive',
+    summary: 'Archive a board (--yes required)',
+    examples: [
+        'monday board archive 12345 --yes',
+        'monday board archive 12345 --dry-run',
+        'monday board archive 12345 --yes --json',
+    ],
+    // Re-archiving an already-archived board is a no-op on Monday's
+    // side per cli-design §9.1; safe to retry on transient failure.
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardArchiveOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('archive <boardId>')
+            .description(boardArchiveCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardArchiveCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId) => {
+            const parsed = parseArgv(boardArchiveCommand.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 archive',
+                target: parsed.boardId,
+                detailKey: 'board_id',
+                action: 'archive the board',
+                hint: 'archive is destructive — Monday retains archived ' +
+                    'boards for 30 days but exposes no unarchive mutation ' +
+                    '(cli-design §5.4 + §8 decision 9).',
+            });
+            const { client, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Preflight read via loadBoardMetadata so the v0.1
+                // board-metadata cache can serve fresh entries.
+                // loadBoardMetadata throws ApiError(not_found) when the
+                // board is absent; bubbles to the runner's catch-all
+                // for the dry-run-not-found contract.
+                const preflight = await loadBoardMetadata({
+                    client,
+                    boardId: parsed.boardId,
+                    env: ctx.env,
+                    noCache: globalFlags.noCache,
+                });
+                const current = preflight.metadata;
+                // Project to the full BoardProjection shape — Codex M15
+                // implementation round-1 F2: cli-design pins the dry-run
+                // snapshot as the §6.2 single-resource projection (which
+                // includes items_count + permissions). BoardMetadata now
+                // carries these fields (optional+nullable on the schema
+                // so pre-M15 cache entries don't break); coerce undefined
+                // → null for the snapshot so the shape is canonical
+                // BoardProjection.
+                const snapshot = {
+                    id: current.id,
+                    name: current.name,
+                    description: current.description,
+                    state: current.state,
+                    board_kind: current.board_kind,
+                    board_folder_id: current.board_folder_id,
+                    workspace_id: current.workspace_id,
+                    url: current.url,
+                    items_count: current.items_count ?? null,
+                    updated_at: current.updated_at,
+                    permissions: current.permissions ?? null,
+                };
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'archive_board',
+                            board_id: parsed.boardId,
+                            board: snapshot,
+                        },
+                    ],
+                    source: preflight.source,
+                    cacheAgeSeconds: preflight.cacheAgeSeconds,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. archive_board returns the archived Board
+            // directly; no preflight read needed.
+            //
+            // M16 retrofit per cli-design §8 single-leg call-site
+            // contract via `withBoardInvalidationSingleLeg` (R46): the
+            // helper invalidates 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 archive
+            // flips the cached `boardMetadataSchema.state` field from
+            // 'active' to 'archived'; without invalidation a same-
+            // process `board describe` would return stale state until
+            // TTL eviction.
+            const { data: projected, response } = await withBoardInvalidationSingleLeg({
+                boardId: parsed.boardId,
+                env: ctx.env,
+                perform: async () => {
+                    const wireResponse = await client.raw(ARCHIVE_BOARD_MUTATION, { boardId: parsed.boardId }, { operationName: 'BoardArchive' });
+                    const data = unwrapOrThrow(responseSchema.safeParse(wireResponse.data), {
+                        context: 'Monday returned a malformed BoardArchive 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.
+                    if (!('archive_board' in data)) {
+                        throw new ApiError('internal_error', `Monday's BoardArchive response is missing the archive_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. Archive's null path uses
+                    // `not_found` (Monday's idiomatic missing-or-no-access
+                    // response) per M14 round-2 / round-3 missing-root vs
+                    // null distinction.
+                    const projection = projectMutationBoard({
+                        raw: data.archive_board,
+                        errorCode: 'not_found',
+                        errorMessage: `Monday returned no board payload from archive_board for id ${parsed.boardId}`,
+                        detailKey: 'board_id',
+                        detailValue: parsed.boardId,
+                    });
+                    return { data: projection, response: wireResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardArchiveCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=archive.js.map

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

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

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

@@ -0,0 +1,146 @@
+/**
+ * `monday board column-create <bid> --type <type> --title <t>
+ * [--description <d>] [--settings <json>] [--dry-run]` — create a new
+ * column on a board (`cli-design.md` §4.3 line 875,
+ * `v0.2-plan.md` §3 M16).
+ *
+ * **Wire shape.** Single round-trip via `create_column(board_id,
+ * column_type, title, description?, defaults?)`. The CLI flag
+ * `--type` maps to the wire's `column_type: ColumnType!`; the CLI
+ * flag `--settings <json>` maps to the wire's `defaults: JSON`
+ * (NOT `settings_str` — `settings_str` is the read-side
+ * serialisation of column settings returned on `Column.settings_str`;
+ * `defaults` is the write-side input parameter on `create_column`).
+ * The wire mutation also accepts `id?: String` (agent-supplied
+ * custom column id) and `after_column_id?: ID` (placement); M16
+ * deliberately omits both — agents needing them call the wire
+ * mutation via M9's `dev mutate` escape hatch.
+ *
+ * **`--type` validation.** The full `ColumnType` enum (~40 values)
+ * per SDK 14.0.0; see §2.3. Argv-parses against the explicit string
+ * literal union below (kept hand-pinned rather than imported from
+ * the SDK because the SDK's enum is `declare enum`-shaped and
+ * doesn't survive zod's `.enum(...)` constructor cleanly). Adding
+ * a Monday-side type is SemVer-minor (this list grows); removing
+ * one is SemVer-major.
+ *
+ * **`noncanonical_column_type` warning** (cli-design §6 stable
+ * warning-code registry). When `--type` resolves to a column type
+ * outside `WRITABLE_COLUMN_TYPES`, the success / dry-run envelope
+ * carries a `noncanonical_column_type` warning so agents pick the
+ * right write path from the per-category `suggested_write_path`:
+ *   - `raw_writable` → `--set-raw <col>=<json>` (agent reaches for
+ *     the v0.2 escape hatch, accepts wire-shape correctness).
+ *   - `read_only_forever` → no write path (the column exists only
+ *     for read-side display / mirror sources).
+ *   - `files_shaped` → `add_file_to_column` deferred to v0.4
+ *     (asset upload).
+ * The command STILL PROCEEDS in all cases — Monday accepts non-
+ * writable types and agents may legitimately want them. The
+ * categorisation lives in `api/column-types.ts` so the warning
+ * shape and `--set-raw`'s reject lists agree on what's read-only-
+ * forever / files-shaped.
+ *
+ * **`--settings <json>` validation.** Parsed at argv-parse-time:
+ * malformed JSON → `usage_error` exit 1, before any network call.
+ * For types in `WRITABLE_COLUMN_TYPES`, validated against a
+ * per-type zod schema (status: `{labels?}`; dropdown: `{labels?}`;
+ * numbers: `{unit?}`; date / text / long_text / people / link /
+ * email / phone: empty `{}`). Type-mismatched settings (e.g.
+ * `--type text --settings '{"labels":[]}'`) → `usage_error` with
+ * `details: {column_type, expected_keys, actual_keys, hint}`.
+ * Raw-writable / read-only-forever / files-shaped types skip
+ * type-specific validation — `--settings` for these types only
+ * requires well-formed JSON (Monday validates server-side).
+ *
+ * **Live-envelope projection.** Returned `Maybe<Column>` is projected
+ * through `columnProjectionSchema` (the M16 R45-lifted shared shape)
+ * via `projectMutationColumn`. Sharing the schema keeps create /
+ * update / delete envelopes byte-identical for the same record.
+ *
+ * **Dry-run shape** per cli-design §6.4 column-create variant:
+ * minimal `{operation: "create_column", board_id, type, title,
+ * description?, settings?}`. No preflight read fires; the dry-run
+ * is purely argv-derived. `meta.source: 'none'`. The
+ * `noncanonical_column_type` warning fires on dry-run too so the
+ * live call's behaviour is predictable.
+ *
+ * **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 `columns: [...]`
+ * list is dropped so subsequent reads in the same process see
+ * fresh state without TTL eviction.
+ *
+ * **Idempotent: false.** Re-running creates a second column with
+ * the same title (Monday auto-generates a fresh column id per
+ * call). 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 boardColumnCreateOutputSchema: 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 BoardColumnCreateOutput = ColumnProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    type: z.ZodEnum<{
+        link: "link";
+        file: "file";
+        status: "status";
+        name: "name";
+        date: "date";
+        group: "group";
+        text: "text";
+        long_text: "long_text";
+        numbers: "numbers";
+        dropdown: "dropdown";
+        people: "people";
+        email: "email";
+        phone: "phone";
+        tags: "tags";
+        board_relation: "board_relation";
+        dependency: "dependency";
+        mirror: "mirror";
+        formula: "formula";
+        auto_number: "auto_number";
+        creation_log: "creation_log";
+        last_updated: "last_updated";
+        item_id: "item_id";
+        item_assignees: "item_assignees";
+        hour: "hour";
+        person: "person";
+        time_tracking: "time_tracking";
+        subtasks: "subtasks";
+        button: "button";
+        checkbox: "checkbox";
+        color_picker: "color_picker";
+        country: "country";
+        doc: "doc";
+        integration: "integration";
+        location: "location";
+        progress: "progress";
+        rating: "rating";
+        team: "team";
+        timeline: "timeline";
+        unsupported: "unsupported";
+        vote: "vote";
+        week: "week";
+        world_clock: "world_clock";
+    }>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const boardColumnCreateCommand: CommandModule<z.infer<typeof inputSchema>, BoardColumnCreateOutput>;
+export {};
+//# sourceMappingURL=column-create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"column-create.d.ts","sourceRoot":"","sources":["../../../src/commands/board/column-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAQnE,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AA6B7C,eAAO,MAAM,6BAA6B;;;;;;;;kBAAyB,CAAC;AACpE,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAwQvD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgBN,CAAC;AA8DZ,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAClD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,uBAAuB,CAqLxB,CAAC"}