monday-cli 0.2.0

package/dist/commands/board/describe.js

@@ -0,0 +1,241 @@
+/**
+ * `monday board describe <bid>` — full board schema (`cli-design.md`
+ * §4.3, §11.2).
+ *
+ * The CLI's introspection endpoint for one board: every column with
+ * its parsed `settings_str`, every group, the workspace + folder
+ * pointers, hierarchy info (`hierarchy_type` / `is_leaf` — both raw
+ * GraphQL because the SDK doesn't type them in 14.0.0), plus a per-
+ * writable-column `example_set` so an agent can construct
+ * `--set <token>=<value>` calls without consulting Monday's docs.
+ *
+ * Reads through `loadBoardMetadata` (cache-aware). The `example_set`
+ * is fully derivable from `column.type` + `settings_str` so the
+ * shape lives here, not in `board-metadata.ts` — that module stays
+ * focused on the cache projection.
+ *
+ * Idempotent: yes.
+ */
+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, parseColumnSettings, } from '../../api/column-types.js';
+/**
+ * Exported for unit testing. Produces a per-column suggestion list
+ * the agent can copy-paste as `--set` flags. Returns `null` for
+ * non-writable column types so the M3 exit's "writable + non-writable
+ * round-trip" can be asserted.
+ */
+export const exampleSetForColumn = (column) => {
+    if (!isWritableColumnType(column.type))
+        return null;
+    switch (column.type) {
+        case 'text':
+            return [`--set ${column.id}='Refactor login'`];
+        case 'long_text':
+            return [`--set ${column.id}='Multi-line\\ndescription text'`];
+        case 'numbers':
+            return [`--set ${column.id}=42`];
+        case 'status': {
+            const settings = (parseColumnSettings(column.settings_str) ?? {});
+            const labels = settings.labels ?? {};
+            const labelEntries = Object.entries(labels);
+            if (labelEntries.length === 0) {
+                return [
+                    `--set ${column.id}=Done`,
+                    `--set ${column.id}=1   # by index`,
+                ];
+            }
+            const first = labelEntries[0];
+            /* c8 ignore next 6 — defensive: labelEntries was already
+               length-checked above, so `first` cannot be undefined. The
+               guard exists for `noUncheckedIndexedAccess` narrowing. */
+            if (first === undefined) {
+                return [
+                    `--set ${column.id}=Done`,
+                    `--set ${column.id}=1   # by index`,
+                ];
+            }
+            const [firstIndex, firstLabel] = first;
+            return [
+                `--set ${column.id}='${firstLabel}'`,
+                `--set ${column.id}=${firstIndex}   # by index`,
+            ];
+        }
+        case 'dropdown': {
+            const settings = (parseColumnSettings(column.settings_str) ?? {});
+            const labels = settings.labels ?? [];
+            if (labels.length === 0) {
+                return [`--set ${column.id}='Backend,Frontend'`];
+            }
+            const sample = labels.slice(0, 2).map((l) => l.name).join(',');
+            return [
+                `--set ${column.id}='${sample}'`,
+                `--set ${column.id}='${String(labels[0]?.id ?? 1)}'   # by id`,
+            ];
+        }
+        case 'date':
+            return [
+                `--set ${column.id}=2026-05-01`,
+                `--set ${column.id}=tomorrow`,
+                `--set ${column.id}=+3d`,
+            ];
+        case 'people':
+            return [
+                `--set ${column.id}=alice@example.com`,
+                `--set ${column.id}=me`,
+            ];
+        case 'link':
+            return [
+                `--set ${column.id}=https://example.com`,
+                `--set ${column.id}='https://example.com|Site'`,
+            ];
+        case 'email':
+            return [
+                `--set ${column.id}=alice@example.com`,
+                `--set ${column.id}='alice@example.com|Alice'`,
+            ];
+        case 'phone':
+            return [
+                `--set ${column.id}='+15551234567|US'`,
+            ];
+        /* c8 ignore next 2 — unreachable: isWritableColumnType gates the
+           entry, so any column.type that lands here is one of the cases
+           above. */
+        default:
+            return null;
+    }
+};
+const describeColumnSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string(),
+    type: z.string(),
+    description: z.string().nullable(),
+    archived: z.boolean().nullable(),
+    width: z.number().nullable(),
+    settings: z.unknown().nullable(),
+    writable: z.boolean(),
+    example_set: z.array(z.string()).nullable(),
+})
+    .strict();
+const describeGroupSchema = z
+    .object({
+    id: z.string().min(1),
+    title: z.string(),
+    color: z.string().nullable(),
+    position: z.string().nullable(),
+    archived: z.boolean().nullable(),
+    deleted: z.boolean().nullable(),
+})
+    .strict();
+export const boardDescribeOutputSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string(),
+    description: z.string().nullable(),
+    state: z.string().nullable(),
+    board_kind: z.string().nullable(),
+    workspace_id: z.string().nullable(),
+    board_folder_id: z.string().nullable(),
+    url: z.string().nullable(),
+    hierarchy_type: z.string().nullable(),
+    is_leaf: z.boolean().nullable(),
+    updated_at: z.string().nullable(),
+    columns: z.array(describeColumnSchema),
+    groups: z.array(describeGroupSchema),
+})
+    .strict();
+const inputSchema = z
+    .object({
+    boardId: BoardIdSchema,
+    includeArchived: z.boolean().optional(),
+})
+    .strict();
+export const boardDescribeCommand = {
+    name: 'board.describe',
+    summary: 'Full board schema — columns, groups, hierarchy, example_set per writable column',
+    examples: [
+        'monday board describe 12345',
+        'monday board describe 12345 --json --include-archived',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: boardDescribeOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'board', 'Board commands');
+        noun
+            .command('describe <boardId>')
+            .description(boardDescribeCommand.summary)
+            .option('--include-archived', 'show archived columns / groups')
+            .addHelpText('after', ['', 'Examples:', ...boardDescribeCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (boardId, opts) => {
+            const parsed = parseArgv(boardDescribeCommand.inputSchema, {
+                boardId,
+                ...opts,
+            });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await loadBoardMetadata({
+                client,
+                boardId: parsed.boardId,
+                env: ctx.env,
+                noCache: globalFlags.noCache,
+            });
+            const includeArchived = parsed.includeArchived ?? false;
+            const cols = includeArchived
+                ? result.metadata.columns
+                : result.metadata.columns.filter((c) => c.archived !== true);
+            const groups = includeArchived
+                ? result.metadata.groups
+                : result.metadata.groups.filter((g) => g.archived !== true && g.deleted !== true);
+            const data = {
+                id: result.metadata.id,
+                name: result.metadata.name,
+                description: result.metadata.description,
+                state: result.metadata.state,
+                board_kind: result.metadata.board_kind,
+                workspace_id: result.metadata.workspace_id,
+                board_folder_id: result.metadata.board_folder_id,
+                url: result.metadata.url,
+                hierarchy_type: result.metadata.hierarchy_type,
+                is_leaf: result.metadata.is_leaf,
+                updated_at: result.metadata.updated_at,
+                columns: cols.map((c) => ({
+                    id: c.id,
+                    title: c.title,
+                    type: c.type,
+                    description: c.description,
+                    archived: c.archived,
+                    width: c.width,
+                    settings: parseColumnSettings(c.settings_str),
+                    writable: isWritableColumnType(c.type),
+                    example_set: exampleSetForColumn(c),
+                })),
+                groups: groups.map((g) => ({
+                    id: g.id,
+                    title: g.title,
+                    color: g.color,
+                    position: g.position,
+                    archived: g.archived,
+                    deleted: g.deleted,
+                })),
+            };
+            ctx.meta.setSource(result.source);
+            emitSuccess({
+                ctx,
+                data,
+                schema: boardDescribeCommand.outputSchema,
+                programOpts: program.opts(),
+                source: result.source,
+                apiVersion,
+                complexity: result.complexity,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+            });
+        });
+    },
+};
+//# sourceMappingURL=describe.js.map

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

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

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

@@ -0,0 +1,108 @@
+/**
+ * `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 { type CommandModule } from '../types.js';
+export declare const boardDoctorOutputSchema: z.ZodObject<{
+    board_id: z.ZodString;
+    board_name: z.ZodString;
+    total: z.ZodNumber;
+    diagnostics: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"duplicate_column_title">;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        normalised_title: z.ZodString;
+        columns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            type: z.ZodString;
+        }, z.core.$strict>>;
+        message: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unsupported_column_type">;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        column_id: z.ZodString;
+        column_title: z.ZodString;
+        column_type: z.ZodString;
+        category: z.ZodEnum<{
+            read_only_forever: "read_only_forever";
+            future: "future";
+            "v0.2_writer_expansion": "v0.2_writer_expansion";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"broken_board_relation">;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        column_id: z.ZodString;
+        column_title: z.ZodString;
+        missing_board_ids: z.ZodArray<z.ZodString>;
+        reason: z.ZodEnum<{
+            mixed: "mixed";
+            archived: "archived";
+            deleted: "deleted";
+            unreachable: "unreachable";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+export type BoardDoctorOutput = z.infer<typeof boardDoctorOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    boardId: z.core.$ZodBranded<z.ZodString, "BoardId", "out">;
+}, z.core.$strict>;
+export declare const boardDoctorCommand: CommandModule<z.infer<typeof inputSchema>, BoardDoctorOutput>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/board/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA0FnE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAiQZ,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,iBAAiB,CAwElB,CAAC"}