monday-cli 0.2.0

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * `monday board subscribers <bid>` — list users subscribed to a board
+ * (`cli-design.md` §4.3).
+ *
+ * GraphQL: `boards(ids: [<bid>]) { subscribers { id name email is_guest enabled } }`.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const boardSubscribersOutputSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+    is_guest: z.ZodNullable<z.ZodBoolean>;
+    enabled: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strict>>;
+export type BoardSubscribersOutput = z.infer<typeof boardSubscribersOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+}, z.core.$strict>;
+export declare const boardSubscribersCommand: CommandModule<z.infer<typeof inputSchema>, BoardSubscribersOutput>;
+export {};
+//# sourceMappingURL=subscribers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../../src/commands/board/subscribers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAgCnE,eAAO,MAAM,4BAA4B;;;;;;mBAA4B,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,QAAA,MAAM,WAAW;;kBAAgD,CAAC;AAMlE,eAAO,MAAM,uBAAuB,EAAE,aAAa,CACjD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,sBAAsB,CA4DvB,CAAC"}

package/dist/commands/board/subscribers.js

@@ -0,0 +1,89 @@
+/**
+ * `monday board subscribers <bid>` — list users subscribed to a board
+ * (`cli-design.md` §4.3).
+ *
+ * GraphQL: `boards(ids: [<bid>]) { subscribers { id name email is_guest enabled } }`.
+ *
+ * Idempotent: yes.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { ApiError } from '../../utils/errors.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+const BOARD_SUBSCRIBERS_QUERY = `
+  query BoardSubscribers($ids: [ID!]) {
+    boards(ids: $ids) {
+      id
+      subscribers {
+        id
+        name
+        email
+        is_guest
+        enabled
+      }
+    }
+  }
+`;
+const subscriberSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string(),
+    email: z.string(),
+    is_guest: z.boolean().nullable(),
+    enabled: z.boolean().nullable(),
+})
+    .strict();
+export const boardSubscribersOutputSchema = z.array(subscriberSchema);
+const inputSchema = z.object({ boardId: BoardIdSchema }).strict();
+export const boardSubscribersCommand = {
+    name: 'board.subscribers',
+    summary: 'List users subscribed to a board',
+    examples: [
+        'monday board subscribers 12345',
+        'monday board subscribers 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardSubscribersOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('subscribers <boardId>')
+            .description(boardSubscribersCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardSubscribersCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId) => {
+            const parsed = parseArgv(boardSubscribersCommand.inputSchema, { boardId });
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const response = await client.raw(BOARD_SUBSCRIBERS_QUERY, { ids: [parsed.boardId] }, { operationName: 'BoardSubscribers' });
+            const first = response.data.boards?.[0];
+            if (first === undefined) {
+                throw new ApiError('not_found', `Monday returned no board for id ${parsed.boardId}`, { details: { board_id: parsed.boardId } });
+            }
+            const subs = boardSubscribersCommand.outputSchema.parse(
+            /* c8 ignore next — the GraphQL `subscribers` selection is
+               non-nullable per Monday's schema, but the SDK's typed
+               shape models it as optional. The fallback exists for
+               that type-vs-runtime gap; in practice every successful
+               response carries a (possibly empty) array. */
+            first.subscribers ?? []);
+            emitSuccess({
+                ctx,
+                data: subs,
+                schema: boardSubscribersCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                // Subscribers come back inline with no pagination — the
+                // GraphQL `subscribers` field returns the full set in one
+                // request. `has_more` is unconditionally false; agents
+                // expecting the §6.3 collection meta read this rather
+                // than infer it from a missing key.
+                hasMore: false,
+                ...toEmit(response),
+            });
+        });
+    },
+};
+//# sourceMappingURL=subscribers.js.map

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * `monday board update <bid> [--name <n>] [--description <d>]
+ * [--dry-run]` — change one or more board fields
+ * (`cli-design.md` §4.3 line 631, `v0.2-plan.md` §3 M15).
+ *
+ * **Wire shape — divergence from `update_workspace`.** Monday's
+ * `update_board(board_id, board_attribute: BoardAttributes!,
+ * new_value: String!)` is **per-attribute** — each wire call
+ * updates exactly one field. The CLI fans out one wire call per
+ * provided flag: `board update <bid> --name X --description Y`
+ * fires two sequential `update_board` 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. This matches `update_workspace`'s single-
+ * mutation surface from M14 — agents see a uniform "all fields
+ * applied or the call failed" envelope shape regardless of how
+ * many wire calls fired underneath.
+ *
+ * **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
+ * server-side and are not rolled back. Agents re-issuing after
+ * failure should re-read the board to see what landed before
+ * retrying the unapplied tail.
+ *
+ * **Force-live final read.** The post-mutation `boards(ids:)`
+ * read MUST bypass the v0.1 board-metadata cache — pre-flight
+ * Codex round-2 F2 pinned this as load-bearing for the success
+ * envelope (a cached read could surface stale `data.name`
+ * post-update). The CLI fires the read via `client.raw` directly
+ * rather than `loadBoardMetadata`, which keeps it always-live;
+ * `meta.source: 'live'` for the live success path. M16's eager-
+ * invalidation contract will additionally invalidate the cache
+ * entry post-success so subsequent commands also see fresh state.
+ *
+ * **Argv discipline.** At least one of `--name` / `--description`
+ * is required — zero-flag invocation surfaces as `usage_error`
+ * (exit 1) at argv-parse, before any network leg. Mirrors
+ * `workspace update`'s "at least one of --name / --kind /
+ * --description required" rule.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-update variant: a
+ * field-level `from → to` diff per provided field. The `from`
+ * state requires a preflight `board get` 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). 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.
+ *
+ * **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 BoardProjection } from '../../api/board-projection.js';
+export declare const boardUpdateOutputSchema: 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 BoardUpdateOutput = BoardProjection;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const boardUpdateCommand: CommandModule<z.infer<typeof inputSchema>, BoardUpdateOutput>;
+export {};
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/board/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AASnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAyBvC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;kBAAwB,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD,QAAA,MAAM,WAAW;;;;kBAcb,CAAC;AA0BL,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,iBAAiB,CA2PlB,CAAC"}

package/dist/commands/board/update.js

@@ -0,0 +1,328 @@
+/**
+ * `monday board update <bid> [--name <n>] [--description <d>]
+ * [--dry-run]` — change one or more board fields
+ * (`cli-design.md` §4.3 line 631, `v0.2-plan.md` §3 M15).
+ *
+ * **Wire shape — divergence from `update_workspace`.** Monday's
+ * `update_board(board_id, board_attribute: BoardAttributes!,
+ * new_value: String!)` is **per-attribute** — each wire call
+ * updates exactly one field. The CLI fans out one wire call per
+ * provided flag: `board update <bid> --name X --description Y`
+ * fires two sequential `update_board` 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. This matches `update_workspace`'s single-
+ * mutation surface from M14 — agents see a uniform "all fields
+ * applied or the call failed" envelope shape regardless of how
+ * many wire calls fired underneath.
+ *
+ * **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
+ * server-side and are not rolled back. Agents re-issuing after
+ * failure should re-read the board to see what landed before
+ * retrying the unapplied tail.
+ *
+ * **Force-live final read.** The post-mutation `boards(ids:)`
+ * read MUST bypass the v0.1 board-metadata cache — pre-flight
+ * Codex round-2 F2 pinned this as load-bearing for the success
+ * envelope (a cached read could surface stale `data.name`
+ * post-update). The CLI fires the read via `client.raw` directly
+ * rather than `loadBoardMetadata`, which keeps it always-live;
+ * `meta.source: 'live'` for the live success path. M16's eager-
+ * invalidation contract will additionally invalidate the cache
+ * entry post-success so subsequent commands also see fresh state.
+ *
+ * **Argv discipline.** At least one of `--name` / `--description`
+ * is required — zero-flag invocation surfaces as `usage_error`
+ * (exit 1) at argv-parse, before any network leg. Mirrors
+ * `workspace update`'s "at least one of --name / --kind /
+ * --description required" rule.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-update variant: a
+ * field-level `from → to` diff per provided field. The `from`
+ * state requires a preflight `board get` 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). 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.
+ *
+ * **Idempotent: yes.** Re-applying the same field values is a
+ * no-op on Monday's side. NOT destructive (no `--yes` gate).
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { ApiError, UsageError } from '../../utils/errors.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { withBoardInvalidationFanOut } from '../../api/board-mutation-invalidation.js';
+import { 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 UPDATE_BOARD_MUTATION = `
+  mutation BoardUpdate(
+    $boardId: ID!,
+    $boardAttribute: BoardAttributes!,
+    $newValue: String!
+  ) {
+    update_board(
+      board_id: $boardId,
+      board_attribute: $boardAttribute,
+      new_value: $newValue
+    )
+  }
+`;
+const BOARD_FINAL_READ_QUERY = `
+  query BoardUpdateFinalRead($ids: [ID!]) {
+    boards(ids: $ids) {
+      ${BOARD_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const boardUpdateOutputSchema = boardProjectionSchema;
+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)',
+    })
+        .optional(),
+    description: z.string().optional(),
+})
+    .strict()
+    .refine((v) => v.name !== undefined || v.description !== undefined, {
+    message: 'board update requires at least one of --name / --description',
+});
+const updateMutationResponseSchema = z
+    .object({
+    update_board: z.unknown(),
+})
+    .loose();
+const finalReadResponseSchema = z
+    .object({
+    boards: z.array(z.unknown()).nullable().optional(),
+})
+    .loose();
+// Deterministic dispatch order: name first, then description. The
+// iteration order isn't observable on success (single envelope) but
+// IS observable on partial-application failure (server-side state
+// shows fields applied in order before the failure). Pinning the
+// order makes failure-recovery testable.
+const FIELD_DISPATCH_ORDER = ['name', 'description'];
+export const boardUpdateCommand = {
+    name: 'board.update',
+    summary: 'Update one or more fields of a board',
+    examples: [
+        'monday board update 12345 --name "Engineering — EU"',
+        'monday board update 12345 --description "EU team board"',
+        'monday board update 12345 --name "Renamed" --description "Updated"',
+        'monday board update 12345 --name "Preview" --dry-run --json',
+    ],
+    // update_board is per-attribute body-replace — re-running with
+    // the same values is a server-side no-op. Mark idempotent so
+    // agents can retry on transient failure.
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardUpdateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('update <boardId>')
+            .description(boardUpdateCommand.summary)
+            .option('--name <n>', 'new board name')
+            .option('--description <d>', 'new board description')
+            .addHelpText('after', ['', 'Examples:', ...boardUpdateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardUpdateCommand.inputSchema, {
+                boardId,
+                ...opts,
+            });
+            const trimmedName = parsed.name?.trim();
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Preflight `boards(ids:)` read via loadBoardMetadata so
+                // the v0.1 board-metadata cache can serve fresh entries.
+                // `meta.source: 'live' | 'cache'`. Cache-staleness caveat:
+                // `from` values may lag up to TTL; agents pass
+                // `--no-cache` when preview freshness is critical.
+                // loadBoardMetadata throws ApiError(not_found) when the
+                // board is absent — bubbles up through 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;
+                const diff = {};
+                if (trimmedName !== undefined) {
+                    diff.name = { from: current.name, to: trimmedName };
+                }
+                if (parsed.description !== undefined) {
+                    diff.description = {
+                        from: current.description,
+                        to: parsed.description,
+                    };
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'update_board',
+                            board_id: parsed.boardId,
+                            diff,
+                        },
+                    ],
+                    source: preflight.source,
+                    cacheAgeSeconds: preflight.cacheAgeSeconds,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. Per-field fan-out: one update_board wire call
+            // per provided flag. Sequential per §8 decision 8. Defensive
+            // (schema's .refine() already enforces "at least one flag",
+            // but if a regression bypassed argv-parse the empty list
+            // would emit a confusing zero-call success).
+            const dispatchPlan = [];
+            for (const attribute of FIELD_DISPATCH_ORDER) {
+                if (attribute === 'name' && trimmedName !== undefined) {
+                    dispatchPlan.push({ attribute: 'name', value: trimmedName });
+                }
+                else if (attribute === 'description' &&
+                    parsed.description !== undefined) {
+                    dispatchPlan.push({
+                        attribute: 'description',
+                        value: parsed.description,
+                    });
+                }
+            }
+            /* c8 ignore next 6 */
+            if (dispatchPlan.length === 0) {
+                throw new UsageError('board update requires at least one of --name / --description', { details: { board_id: parsed.boardId } });
+            }
+            // §8 fan-out call-site contract via `withBoardInvalidation
+            // FanOut` (R46): the helper owns the high-water-mark counter
+            // and the partial-application invalidation gate; the closure
+            // here drives the per-attribute loop + the final force-live
+            // read + the projection, calling `recordLegSuccess()` after
+            // each successful per-attribute call.
+            //
+            // The final-read leg lives INSIDE `runFanOut` (matching
+            // pre-R46 structure per Codex M16 round-1 F1) so a final-
+            // read failure with succeededLegs > 0 still triggers
+            // invalidation — the per-attribute mutations already
+            // committed server-side state, so the cache must reflect
+            // them even if the trailing read couldn't surface the
+            // post-update snapshot.
+            const { data: projected, response: finalResponse } = await withBoardInvalidationFanOut({
+                boardId: parsed.boardId,
+                env: ctx.env,
+                runFanOut: async ({ recordLegSuccess }) => {
+                    for (const { attribute, value } of dispatchPlan) {
+                        const response = await client.raw(UPDATE_BOARD_MUTATION, {
+                            boardId: parsed.boardId,
+                            boardAttribute: attribute,
+                            newValue: value,
+                        }, { operationName: 'BoardUpdate' });
+                        const data = unwrapOrThrow(updateMutationResponseSchema.safeParse(response.data), {
+                            context: 'Monday returned a malformed BoardUpdate response',
+                            details: {
+                                board_id: parsed.boardId,
+                                board_attribute: attribute,
+                            },
+                            hint: 'this is a data-integrity error in Monday\'s response; ' +
+                                'verify the mutation response shape and update the schema ' +
+                                'if Monday\'s contract has changed.',
+                        });
+                        // Distinguish "root key absent" (schema-drift →
+                        // internal_error) from "value null" (Monday-side
+                        // failure with no errors[] — Codex M15
+                        // implementation round-1 F1: a 200 response with
+                        // `update_board: null` and no errors[] is NOT a
+                        // per-field success; it's a null-payload failure
+                        // that must abort the sequence BEFORE the final
+                        // read fires false-success.
+                        if (!('update_board' in data)) {
+                            throw new ApiError('internal_error', `Monday's BoardUpdate response is missing the update_board root field`, {
+                                details: {
+                                    board_id: parsed.boardId,
+                                    board_attribute: attribute,
+                                    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.',
+                                },
+                            });
+                        }
+                        if (data.update_board === null || data.update_board === undefined) {
+                            throw new ApiError('internal_error', `Monday's BoardUpdate returned a null update_board payload for board_attribute ${attribute}`, {
+                                details: {
+                                    board_id: parsed.boardId,
+                                    board_attribute: attribute,
+                                    hint: 'a null payload with no GraphQL errors[] is a server-side ' +
+                                        'failure path; agents should retry after re-reading the ' +
+                                        'board to see what landed before this call.',
+                                },
+                            });
+                        }
+                        void response;
+                        recordLegSuccess();
+                    }
+                    // Final force-live read for the success envelope's
+                    // `data` slot. `client.raw` doesn't go through the
+                    // cache, so this always fires fresh — pre-flight
+                    // Codex round-2 F2 pinned this as load-bearing (a
+                    // cached read could surface stale post-update name).
+                    const finalReadResponse = await client.raw(BOARD_FINAL_READ_QUERY, { ids: [parsed.boardId] }, { operationName: 'BoardUpdateFinalRead' });
+                    const finalData = unwrapOrThrow(finalReadResponseSchema.safeParse(finalReadResponse.data), {
+                        context: 'Monday returned a malformed BoardUpdateFinalRead response',
+                        details: { board_id: parsed.boardId },
+                    });
+                    const first = (finalData.boards ?? [])[0];
+                    // R43 lift (api/board-mutation-result.ts): null-
+                    // payload guard + projection. Defensive
+                    // `internal_error` per M14 round-2 / round-3
+                    // missing-root vs null distinction — per-field calls
+                    // succeeded but the final read couldn't find the
+                    // board, so surface contract anomaly rather than a
+                    // no-op success.
+                    const finalProjected = projectMutationBoard({
+                        raw: first,
+                        errorCode: 'internal_error',
+                        errorMessage: `Monday returned no board for id ${parsed.boardId} on the final post-update read`,
+                        detailKey: 'board_id',
+                        detailValue: parsed.boardId,
+                    });
+                    return { data: finalProjected, response: finalReadResponse };
+                },
+            });
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: boardUpdateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                // Use the final-read response for meta (request_id,
+                // complexity) — it's the freshest wire call and reflects
+                // the success-path's last interaction with Monday.
+                ...toEmit(finalResponse),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=update.js.map

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

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

package/dist/commands/cache/clear.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `monday cache clear` — removes cache entries (`cli-design.md` §8).
+ *
+ *   monday cache clear                  → wipe everything
+ *   monday cache clear --board <bid>    → drop one board's metadata
+ *
+ * Idempotent: yes — clearing an already-empty cache is a no-op
+ * (reports zero removals rather than failing).
+ *
+ * Stays read-write-safe: the cache root is never traversed outside
+ * `resolveCacheRoot()`'s output. `--board <bid>` is validated with
+ * the safe-identifier regex inside `cacheKeyToRelativePath`, so a
+ * caller-supplied `../etc/passwd` returns `cache_error` rather than
+ * deleting anything outside the cache directory.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const cacheClearOutputSchema: z.ZodObject<{
+    root: z.ZodString;
+    scope: z.ZodEnum<{
+        board: "board";
+        all: "all";
+    }>;
+    board_id: z.ZodNullable<z.ZodString>;
+    removed: z.ZodNumber;
+    bytes_freed: z.ZodNumber;
+}, z.core.$strict>;
+export type CacheClearOutput = z.infer<typeof cacheClearOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    board: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const cacheClearCommand: CommandModule<z.infer<typeof inputSchema>, CacheClearOutput>;
+export {};
+//# sourceMappingURL=clear.d.ts.map

package/dist/commands/cache/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../src/commands/cache/clear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAqBnE,eAAO,MAAM,sBAAsB;;;;;;;;;kBAQxB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAEZ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAsEjB,CAAC"}