monday-cli 0.2.0

package/dist/commands/board/doctor.js

@@ -0,0 +1,417 @@
+/**
+ * `monday board doctor <bid>` — diagnostics on a board's shape so an
+ * agent can fix problems BEFORE they surface as runtime errors
+ * (`cli-design.md` §11.2; `v0.1-plan.md` §3 M6).
+ *
+ * Three diagnostic kinds shipped in v0.1:
+ *
+ *   1. **`duplicate_column_title`** — groups columns by NFC + case-
+ *      folded + whitespace-collapsed title. Any group with ≥2 columns
+ *      emits one diagnostic. Same normalisation rule as the §5.3
+ *      column resolver — when this fires, agents writing `--set
+ *      "<title>"=<value>` get `ambiguous_column` at runtime; this
+ *      surfaces the gotcha up front.
+ *
+ *   2. **`unsupported_column_type`** — for each non-allowlisted
+ *      column type, emits one diagnostic keyed by roadmap category
+ *      (matches `column-values.ts unsupportedColumnTypeError`'s
+ *      three-category split): `v0.2_writer_expansion`, `read_only_
+ *      forever`, or `future`. Agents reading `board doctor`'s output
+ *      know exactly which columns will fail `item set` / `item
+ *      update`, what category each falls into, and whether to expect
+ *      a write path in v0.2 vs. never.
+ *
+ *   3. **`broken_board_relation`** — for each `board_relation`
+ *      column, parses `settings_str.boardIds` and queries each
+ *      linked board via Monday's `boards(ids:)`. If a linked board
+ *      is archived, deleted, or unreachable (the response omits it
+ *      because the token has no read permission), emits one
+ *      diagnostic per missing target. This catches the
+ *      "board_relation column → archived board → silent breakage"
+ *      class agents would otherwise discover only when an item
+ *      mutation fails.
+ *
+ * **No `stale_cache` diagnostic in v0.1.** cli-design §11.2 lists
+ * "stale cache vs live" as a doctor diagnostic; the `meta.source`
+ * + `meta.cache_age_seconds` envelope slots already surface cache
+ * provenance (and `board doctor` always force-refreshes so it
+ * sees the live state). A genuine cache-drift diagnostic
+ * (cache says X, live says Y) is logged for v0.2 backfill.
+ *
+ * **No bulk diagnostic flag**. `board doctor` runs every
+ * diagnostic on every call. Future `--diagnostic <kind>` filters
+ * are an additive surface.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { loadBoardMetadata, } from '../../api/board-metadata.js';
+import { isWritableColumnType, getColumnRoadmapCategory, parseColumnSettings, } from '../../api/column-types.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+/**
+ * Per-diagnostic shape. Discriminated by `kind` so consumers can
+ * branch on a stable string. `severity` is informational — every
+ * doctor diagnostic is non-fatal (a board CAN ship with duplicate
+ * column titles; the diagnostic is "this WILL bite when an agent
+ * tries to title-resolve"). Agents that key off severity for an
+ * exit gate can use the `error` band.
+ */
+const diagnosticSeverity = z.enum(['info', 'warning', 'error']);
+const duplicateColumnTitleDiagnostic = z
+    .object({
+    kind: z.literal('duplicate_column_title'),
+    severity: diagnosticSeverity,
+    /** The normalised title that's shared by ≥2 columns. */
+    normalised_title: z.string(),
+    /** Each column that shares the normalised title. */
+    columns: z
+        .array(z
+        .object({
+        id: z.string().min(1),
+        title: z.string(),
+        type: z.string().min(1),
+    })
+        .strict())
+        .min(2),
+    message: z.string(),
+})
+    .strict();
+const unsupportedColumnTypeDiagnostic = z
+    .object({
+    kind: z.literal('unsupported_column_type'),
+    severity: diagnosticSeverity,
+    /** The column ID. */
+    column_id: z.string().min(1),
+    /** The column title (verbatim from board metadata). */
+    column_title: z.string(),
+    /** The column type Monday reports. */
+    column_type: z.string().min(1),
+    /** Roadmap category — one of three known values. */
+    category: z.enum(['v0.2_writer_expansion', 'read_only_forever', 'future']),
+    message: z.string(),
+})
+    .strict();
+const brokenBoardRelationDiagnostic = z
+    .object({
+    kind: z.literal('broken_board_relation'),
+    severity: diagnosticSeverity,
+    /** The board_relation column ID. */
+    column_id: z.string().min(1),
+    column_title: z.string(),
+    /** The linked board IDs that are archived / missing / inaccessible. */
+    missing_board_ids: z.array(z.string().min(1)).min(1),
+    /** Reason — `archived` (linked board.state === 'archived') or
+     * `unreachable` (Monday's response omitted the board, meaning
+     * the token has no read permission OR the board doesn't exist). */
+    reason: z.enum(['archived', 'deleted', 'unreachable', 'mixed']),
+    message: z.string(),
+})
+    .strict();
+const diagnosticSchema = z.discriminatedUnion('kind', [
+    duplicateColumnTitleDiagnostic,
+    unsupportedColumnTypeDiagnostic,
+    brokenBoardRelationDiagnostic,
+]);
+export const boardDoctorOutputSchema = z
+    .object({
+    board_id: z.string().min(1),
+    board_name: z.string(),
+    /**
+     * Total diagnostics fired. Zero means the board is healthy
+     * (per the v0.1 diagnostic set). Convenience sum so an agent
+     * can short-circuit on `data.total === 0` without iterating.
+     */
+    total: z.number().int().min(0),
+    diagnostics: z.array(diagnosticSchema),
+})
+    .strict();
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+})
+    .strict();
+/**
+ * Same normalisation as the §5.3 column resolver: NFC + trim +
+ * case-fold (Unicode-aware) + collapse internal whitespace. Tested
+ * across the resolver / filter / writer surfaces; using one
+ * function keeps doctor's "duplicate" definition aligned with the
+ * runtime's "ambiguous" definition.
+ */
+const normaliseTitle = (raw) => raw
+    .normalize('NFC')
+    .trim()
+    .toLocaleLowerCase('und')
+    .replace(/\s+/gu, ' ');
+/**
+ * Builds the per-category message for `unsupported_column_type`.
+ * Mirrors the runtime error builder's voice so doctor output and
+ * `item set` errors agree. Pre-fix the writer-expansion split (Codex
+ * M5b cleanup re-review #1), this diagnostic would have called every
+ * non-allowlisted type "deferred to v0.2", which doctor faithfully
+ * preserved via the category-keyed switch. M18 close (Codex round-2
+ * P2): the tentative writer-expansion row slipped from v0.2 to v0.3,
+ * so the `v0_2_writer_expansion` category's message now references
+ * v0.3. The category constant name retains its M8-era spelling for
+ * stability — renaming would churn every consumer with no wire-shape
+ * change.
+ */
+const messageForCategory = (type, category) => {
+    if (category === 'read_only_forever') {
+        return (`Column type "${type}" is computed by Monday and is not ` +
+            `writable via the API regardless of CLI version. Set the ` +
+            `underlying source column instead.`);
+    }
+    if (category === 'v0_2_writer_expansion') {
+        return (`Column type "${type}" is not yet in the friendly --set ` +
+            `translator allowlist. The tentative writer-expansion row ` +
+            `slipped from v0.2 to v0.3 at v0.2.0 release; use --set-raw ` +
+            `<col>=<json> in the meantime.`);
+    }
+    return (`Column type "${type}" is not in the friendly --set allowlist or ` +
+        `the writer-expansion roadmap. Track cli-design.md §5.3 for ` +
+        `future coverage; --set-raw works for any type Monday writes via ` +
+        `change_column_value.`);
+};
+const collectDuplicateTitles = (columns) => {
+    const groups = new Map();
+    for (const c of columns) {
+        if (c.archived === true)
+            continue;
+        const key = normaliseTitle(c.title);
+        let arr = groups.get(key);
+        if (arr === undefined) {
+            arr = [];
+            groups.set(key, arr);
+        }
+        arr.push(c);
+    }
+    const result = [];
+    for (const [normalised, group] of groups) {
+        if (group.length < 2)
+            continue;
+        result.push({
+            kind: 'duplicate_column_title',
+            severity: 'warning',
+            normalised_title: normalised,
+            columns: group.map((c) => ({ id: c.id, title: c.title, type: c.type })),
+            message: `Found ${String(group.length)} columns sharing the normalised ` +
+                `title "${normalised}". Title-based --set / --where / --filter ` +
+                `against this title will surface ambiguous_column; use the ` +
+                `explicit id:<column_id> prefix or write to the column ID directly.`,
+        });
+    }
+    return result;
+};
+const collectUnsupportedTypes = (columns) => {
+    const result = [];
+    for (const c of columns) {
+        if (c.archived === true)
+            continue;
+        if (isWritableColumnType(c.type))
+            continue;
+        const category = getColumnRoadmapCategory(c.type);
+        // Map the internal category enum to the wire-stable label so the
+        // doctor output is more readable than `v0_2_writer_expansion`.
+        // The underscore form lives in the runtime helper only;
+        // diagnostic shape uses the dotted form.
+        const wireCategory = category === 'v0_2_writer_expansion'
+            ? 'v0.2_writer_expansion'
+            : category === 'read_only_forever'
+                ? 'read_only_forever'
+                : 'future';
+        result.push({
+            kind: 'unsupported_column_type',
+            // Severity differs by category. Read-only-forever is "info"
+            // because nothing the agent can do will change it; future / v0.2
+            // are "warning" because they're temporarily blocked.
+            severity: category === 'read_only_forever' ? 'info' : 'warning',
+            column_id: c.id,
+            column_title: c.title,
+            column_type: c.type,
+            category: wireCategory,
+            message: messageForCategory(c.type, category),
+        });
+    }
+    return result;
+};
+const BOARD_RELATION_LOOKUP_QUERY = `
+  query BoardDoctorRelationLookup($ids: [ID!]!) {
+    boards(ids: $ids) {
+      id
+      name
+      state
+    }
+  }
+`;
+const boardRelationLookupResponseSchema = z.looseObject({
+    boards: z
+        .array(z
+        .object({
+        id: BoardIdSchema,
+        name: z.string(),
+        state: z.string().nullable(),
+    })
+        .strict())
+        .nullable(),
+});
+/**
+ * Defensive parse of `board_relation` settings_str. Monday's shape
+ * is `{ "boardIds": [<numeric-string>, ...] }`; older boards may
+ * omit the slot entirely. We tolerate both — the doctor only runs
+ * the relation lookup when at least one boardId is present.
+ */
+const extractLinkedBoardIds = (settings) => {
+    if (settings === null ||
+        typeof settings !== 'object' ||
+        Array.isArray(settings)) {
+        return [];
+    }
+    const boardIds = settings.boardIds;
+    if (!Array.isArray(boardIds))
+        return [];
+    return boardIds.filter((id) => typeof id === 'string');
+};
+const collectBrokenBoardRelations = async (client, metadata) => {
+    // Build a per-column map of linked-board IDs. Skip archived
+    // columns — they're not actionable. Aggregate ALL linked boards
+    // into one `boards(ids:)` call so we don't fan out per column.
+    const perColumn = new Map();
+    const allIds = new Set();
+    for (const c of metadata.columns) {
+        if (c.archived === true)
+            continue;
+        if (c.type !== 'board_relation')
+            continue;
+        const settings = parseColumnSettings(c.settings_str);
+        const ids = extractLinkedBoardIds(settings);
+        if (ids.length === 0)
+            continue;
+        perColumn.set(c.id, ids);
+        for (const id of ids) {
+            allIds.add(id);
+        }
+    }
+    if (allIds.size === 0)
+        return [];
+    const response = await client.raw(BOARD_RELATION_LOOKUP_QUERY, { ids: [...allIds] }, { operationName: 'BoardDoctorRelationLookup' });
+    const data = unwrapOrThrow(boardRelationLookupResponseSchema.safeParse(response.data), {
+        context: 'Monday returned a malformed BoardDoctorRelationLookup response',
+        details: { board_id: metadata.id },
+        hint: 'this is a data-integrity error in Monday\'s response; verify ' +
+            'the response shape and update boardRelationLookupResponseSchema ' +
+            'if Monday\'s contract has changed.',
+    });
+    const reachable = new Map();
+    for (const b of data.boards ?? []) {
+        reachable.set(b.id, { state: b.state });
+    }
+    const result = [];
+    for (const [columnId, linkedIds] of perColumn) {
+        const archived = [];
+        const unreachable = [];
+        for (const id of linkedIds) {
+            const live = reachable.get(id);
+            if (live === undefined) {
+                unreachable.push(id);
+                continue;
+            }
+            if (live.state === 'archived' || live.state === 'deleted') {
+                archived.push(id);
+            }
+        }
+        if (archived.length === 0 && unreachable.length === 0)
+            continue;
+        const column = metadata.columns.find((c) => c.id === columnId);
+        /* c8 ignore next 5 — defensive: columnId came from the same
+           metadata.columns walk that built `perColumn`, so this lookup
+           always finds the column. The branch exists to satisfy
+           `noUncheckedIndexedAccess` without forcing a non-null
+           assertion at every read. */
+        if (column === undefined)
+            continue;
+        const reason = archived.length > 0 && unreachable.length > 0
+            ? 'mixed'
+            : archived.length > 0
+                ? 'archived'
+                : 'unreachable';
+        result.push({
+            kind: 'broken_board_relation',
+            severity: 'warning',
+            column_id: columnId,
+            column_title: column.title,
+            missing_board_ids: [...archived, ...unreachable],
+            reason,
+            message: `board_relation column "${column.title}" (${columnId}) links to ` +
+                `${String(archived.length + unreachable.length)} board(s) that ` +
+                `are not active: ${archived.length > 0 ? `${String(archived.length)} archived/deleted` : ''}${archived.length > 0 && unreachable.length > 0 ? ', ' : ''}${unreachable.length > 0 ? `${String(unreachable.length)} unreachable (token may lack permission, or the board doesn't exist)` : ''}.`,
+        });
+    }
+    return result;
+};
+export const boardDoctorCommand = {
+    name: 'board.doctor',
+    summary: 'Diagnose a board for column / relation issues that bite at runtime',
+    examples: [
+        'monday board doctor 12345',
+        'monday board doctor 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardDoctorOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('doctor <boardId>')
+            .description(boardDoctorCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...boardDoctorCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardDoctorCommand.inputSchema, {
+                boardId,
+                ...opts,
+            });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            // Force-refresh so doctor sees the live state (cache hits
+            // would mean diagnostics describe stale data; the whole
+            // value of doctor is current correctness).
+            const result = await loadBoardMetadata({
+                client,
+                boardId: parsed.boardId,
+                env: ctx.env,
+                noCache: globalFlags.noCache,
+                refresh: true,
+            });
+            const dups = collectDuplicateTitles(result.metadata.columns);
+            const unsupported = collectUnsupportedTypes(result.metadata.columns);
+            const broken = await collectBrokenBoardRelations(client, result.metadata);
+            const diagnostics = [
+                ...dups,
+                ...unsupported,
+                ...broken,
+            ];
+            const data = {
+                board_id: result.metadata.id,
+                board_name: result.metadata.name,
+                total: diagnostics.length,
+                diagnostics: [...diagnostics],
+            };
+            // Doctor always force-refreshes; meta.source is always 'live'.
+            ctx.meta.setSource('live');
+            emitSuccess({
+                ctx,
+                data,
+                schema: boardDoctorCommand.outputSchema,
+                programOpts: program.opts(),
+                source: 'live',
+                apiVersion,
+                complexity: result.complexity,
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=doctor.js.map

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

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

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

@@ -0,0 +1,85 @@
+/**
+ * `monday board duplicate <bid> [--name <n>] [--workspace <wid>]
+ * [--with-updates] [--dry-run]` — duplicate a board
+ * (`cli-design.md` §4.3 line 727, `v0.2-plan.md` §3 M15).
+ *
+ * **Wire shape.** Single round-trip via `duplicate_board(board_id,
+ * duplicate_type: DuplicateBoardType!, board_name?, workspace_id?,
+ * folder_id?, keep_subscribers?)`. Returns the M15-unique
+ * `BoardDuplication { board, is_async }` SDK type — the only M15
+ * verb whose live envelope's `data` wraps because Monday's wire
+ * shape carries `is_async`. Per cli-design §6.1 (round-2 F3
+ * widening) + §6.4 board-duplicate variant.
+ *
+ * **`--with-updates` flag mapping.** Selects between Monday's
+ * three-armed `DuplicateBoardType` enum: without --with-updates
+ * the wire call uses `duplicate_board_with_pulses` (items WITHOUT
+ * updates); with --with-updates the wire call uses
+ * `duplicate_board_with_pulses_and_updates` (items WITH updates).
+ * The third arm (`duplicate_board_with_structure` — skeleton
+ * without items) is deferred to a later v0.x; agents needing it
+ * use M9's `dev mutate` escape hatch.
+ *
+ * **`is_async` semantics.** When true, Monday has queued the
+ * duplication server-side and the new board may not be fully
+ * populated by envelope time. Agents needing to operate on the
+ * duplicated items / updates poll `boards(ids: [<new_id>]) {
+ * state }` until terminal state. When false, the duplication has
+ * fully landed by envelope time and immediate follow-up reads
+ * are safe. (cli-design §6.4 board-duplicate live envelope.)
+ *
+ * **`--workspace` is optional.** Defaults to the source board's
+ * workspace; only forwards when the agent provides a value.
+ *
+ * **`--name` is optional.** Defaults to Monday's server-side
+ * "<source name> (Copy)" when omitted.
+ *
+ * **Dry-run shape** per cli-design §6.4 board-duplicate variant:
+ * `{operation: "duplicate_board", board_id, with_updates,
+ * target_workspace_id?, target_name?, board: <projected source
+ * snapshot>}`. Preflight `board get` read via `loadBoardMetadata`
+ * — cache hits observable; `meta.source: 'live' | 'cache'`.
+ * Cache-staleness caveat: pass `--no-cache` for force-live
+ * preview when freshness matters.
+ *
+ * **Idempotent: false.** Re-running creates a second copy. NOT
+ * destructive (no --yes gate — cli-design §3.1 #7 reserves the
+ * gate for destructive verbs). Same shape `monday board create`
+ * uses for non-destructive idempotency.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+/**
+ * The mutation envelope's `data` wraps `BoardDuplication { board,
+ * is_async }`. Per cli-design §6.4 board-duplicate variant + §6.1
+ * universal envelope widening (round-2 F3) — single-target verbs
+ * usually surface the projection directly, but `board duplicate`
+ * is the M15 wrapper case because `is_async` is load-bearing for
+ * agents that duplicate-then-immediately-read.
+ */
+export declare const boardDuplicateOutputSchema: z.ZodObject<{
+    board: 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>;
+    is_async: z.ZodBoolean;
+}, z.core.$strict>;
+export type BoardDuplicateOutput = z.infer<typeof boardDuplicateOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+    name: z.ZodOptional<z.ZodString>;
+    workspace: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">>;
+    withUpdates: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strict>;
+export declare const boardDuplicateCommand: CommandModule<z.infer<typeof inputSchema>, BoardDuplicateOutput>;
+export {};
+//# sourceMappingURL=duplicate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate.d.ts","sourceRoot":"","sources":["../../../src/commands/board/duplicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAoCnE;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;kBAK5B,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,QAAA,MAAM,WAAW;;;;;kBAYN,CAAC;AAeZ,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,oBAAoB,CAyMrB,CAAC"}