monday-cli 0.2.0 → 0.4.0

package/dist/commands/dev/task/list.js

@@ -0,0 +1,227 @@
+/**
+ * `monday dev task list [--mine] [--status not_done|done|stuck|working_on_it]
+ *  [--sprint current|<sid>]` — list tasks on the configured tasks
+ * board (cli-design §4.3 + §5.9; v0.3-plan §3 M26b).
+ *
+ * **Runtime body landed at M26b IMPL.** Loads the active profile's
+ * `tasks_board`, walks `items_page`, then applies the client-side
+ * filters supplied by argv:
+ *
+ *   - `--mine` resolves `me` via `client.whoami()` and keeps rows
+ *     whose `people`-type column entries include the resolved user
+ *     ID. (Matches against any people column; tasks boards may
+ *     have multiple — Owner / Assignee / etc.)
+ *   - `--status not_done` keeps rows whose status column label is
+ *     not `Done` / `Cancelled`; `--status done` keeps `Done` /
+ *     `Cancelled`; `--status stuck` keeps `Stuck`; `--status
+ *     working_on_it` keeps `Working on it`.
+ *   - `--sprint current` resolves the active sprint (per the same
+ *     date-range derivation `dev sprint current` uses) and filters
+ *     by the configured sprint→task `board_relation` column.
+ *     `--sprint <sid>` accepts a numeric sprint item ID directly.
+ *
+ * Idempotent: yes (pure read).
+ */
+import { z } from 'zod';
+import { ApiError } from '../../../utils/errors.js';
+import { ensureSubcommand } from '../../types.js';
+import { parseArgv } from '../../parse-argv.js';
+import { emitSuccess } from '../../emit.js';
+import { resolveClient } from '../../../api/resolve-client.js';
+import { classifySprint, dayEpoch, extractDateRange, extractLinkedItemIds, findRelationColumnIdToBoard, hydrateDevBoardColumns, loadDevMapping, walkDevBoardItems, } from '../../../api/dev-conventions.js';
+import { resolveActiveDevProfile, requireDevBoard } from '../_shared.js';
+import { resolveMeFactory } from '../../../api/item-helpers.js';
+import { projectedItemSchema, } from '../../../api/item-projection.js';
+const TASK_STATUS_LITERALS = ['not_done', 'done', 'stuck', 'working_on_it'];
+const sprintFilterSchema = z.union([
+    z.literal('current'),
+    z.string().regex(/^\d+$/u, { message: '--sprint must be `current` or a numeric sprint ID' }),
+]);
+const inputSchema = z
+    .object({
+    mine: z.boolean().optional(),
+    status: z.enum(TASK_STATUS_LITERALS).optional(),
+    sprint: sprintFilterSchema.optional(),
+})
+    .strict();
+const outputSchema = z.array(projectedItemSchema);
+/**
+ * Returns the projected status label of a task — first status / color
+ * column with a non-empty `label` or `text` wins.
+ */
+const taskStatusLabel = (item) => {
+    for (const col of Object.values(item.columns)) {
+        if (col.type !== 'status' && col.type !== 'color')
+            continue;
+        if (typeof col.label === 'string' && col.label.length > 0)
+            return col.label;
+        if (typeof col.text === 'string' && col.text.length > 0)
+            return col.text;
+    }
+    return null;
+};
+const isDoneOrCancelled = (label) => {
+    if (label === null)
+        return false;
+    const lower = label.toLocaleLowerCase('und');
+    return lower === 'done' || lower === 'cancelled' || lower === 'canceled';
+};
+const matchStatusFilter = (item, filter) => {
+    const label = taskStatusLabel(item);
+    const lower = label === null ? null : label.toLocaleLowerCase('und');
+    switch (filter) {
+        case 'not_done':
+            return !isDoneOrCancelled(label);
+        case 'done':
+            return isDoneOrCancelled(label);
+        case 'stuck':
+            return lower === 'stuck';
+        case 'working_on_it':
+            return lower === 'working on it';
+    }
+};
+const isAssignedTo = (item, userId) => {
+    for (const col of Object.values(item.columns)) {
+        if (col.type !== 'people')
+            continue;
+        if (!Array.isArray(col.people))
+            continue;
+        for (const p of col.people) {
+            if (p.id === userId)
+                return true;
+        }
+    }
+    return false;
+};
+export const devTaskListCommand = {
+    name: 'dev.task.list',
+    summary: 'List tasks on the configured tasks board (filter by --mine, --status, --sprint)',
+    examples: [
+        'monday dev task list',
+        'monday dev task list --mine',
+        'monday dev task list --status not_done --sprint current',
+        'monday dev task list --sprint 12345678 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema,
+    attach: (program, ctx) => {
+        const dev = ensureSubcommand(program, 'dev', 'Monday Dev workflow shortcuts (cli-design §2.7 — convention, not API)');
+        const task = ensureSubcommand(dev, 'task', 'Task workflow verbs (three-level depth per cli-design §5.2 carve-out 1)');
+        task
+            .command('list')
+            .description(devTaskListCommand.summary)
+            .option('--mine', 'Restrict to tasks assigned to the connected user (resolved via the `me` token).')
+            .option('--status <status>', 'Filter by status: not_done | done | stuck | working_on_it. `not_done` is the agent-flow default for "tasks I still need to handle".')
+            .option('--sprint <sprintIdOrCurrent>', 'Filter to tasks in a specific sprint. Accepts the literal `current` (resolves via `monday dev sprint current`) or a numeric sprint item ID.')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...devTaskListCommand.examples.map((e) => `  ${e}`),
+            '',
+        ].join('\n'))
+            .action(async (rawOpts) => {
+            const opts = parseArgv(devTaskListCommand.inputSchema, rawOpts);
+            const profile = await resolveActiveDevProfile(ctx, program.opts());
+            const mapping = await loadDevMapping(profile.name, profile.homeOptions);
+            const tasksBoard = requireDevBoard(mapping, 'tasks_board', profile.name);
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            // Resolve --sprint if present. `current` needs the sprints
+            // board hydrated + a sprints walk; numeric form just uses the
+            // ID directly.
+            let sprintItemId;
+            let relationColumnId;
+            let aggregateComplexity = null;
+            if (opts.sprint !== undefined) {
+                const sprintsBoard = requireDevBoard(mapping, 'sprints_board', profile.name);
+                // Resolve the tasks→sprints relation column ID (hydrate
+                // tasks board columns once).
+                const hydrated = await hydrateDevBoardColumns(client, tasksBoard, 'DevTaskListHydrate');
+                aggregateComplexity = hydrated.complexity;
+                relationColumnId = findRelationColumnIdToBoard(hydrated.columns, sprintsBoard);
+                if (relationColumnId === undefined) {
+                    throw new ApiError('dev_board_misconfigured', `tasks board ${tasksBoard} has no board_relation column linking to sprints board ${sprintsBoard}`, {
+                        details: {
+                            board_id: tasksBoard,
+                            target_slot: 'sprints_board',
+                            target_board_id: sprintsBoard,
+                            reason: 'no_matching_relation',
+                            hint: 'run `monday dev doctor` for the `tasks_to_sprints_relation` check',
+                        },
+                    });
+                }
+                if (opts.sprint === 'current') {
+                    // Walk the sprints board to find the active sprint.
+                    const sprintWalk = await walkDevBoardItems({
+                        client,
+                        boardId: sprintsBoard,
+                        operationName: 'DevTaskListSprintCurrent',
+                        now: ctx.clock,
+                    });
+                    const todayEpoch = dayEpoch(ctx.clock().toISOString());
+                    /* c8 ignore next 3 */
+                    if (todayEpoch === null) {
+                        throw new Error('unreachable: ctx.clock() produced an unparseable ISO string');
+                    }
+                    const active = sprintWalk.items.find((i) => classifySprint(extractDateRange(i), todayEpoch) === 'active');
+                    if (active === undefined) {
+                        throw new ApiError('not_found', `no active sprint on board ${sprintsBoard} for profile \`${profile.name}\``, {
+                            details: {
+                                profile: profile.name,
+                                board_id: sprintsBoard,
+                                hint: 'inspect upcoming sprints with `monday dev sprint list --state future`',
+                            },
+                        });
+                    }
+                    sprintItemId = active.id;
+                }
+                else {
+                    sprintItemId = opts.sprint;
+                }
+            }
+            // Resolve `me` once when --mine is set.
+            let meId;
+            if (opts.mine === true) {
+                meId = await resolveMeFactory(client)();
+            }
+            // Walk tasks_board.
+            const { items, complexity: walkComplexity } = await walkDevBoardItems({
+                client,
+                boardId: tasksBoard,
+                operationName: 'DevTaskList',
+                now: ctx.clock,
+            });
+            let filtered = items;
+            if (opts.status !== undefined) {
+                const statusFilter = opts.status;
+                filtered = filtered.filter((i) => matchStatusFilter(i, statusFilter));
+            }
+            if (meId !== undefined) {
+                const id = meId;
+                filtered = filtered.filter((i) => isAssignedTo(i, id));
+            }
+            if (sprintItemId !== undefined && relationColumnId !== undefined) {
+                const colId = relationColumnId;
+                const sid = sprintItemId;
+                filtered = filtered.filter((task) => {
+                    const relCol = task.columns[colId];
+                    if (relCol === undefined)
+                        return false;
+                    return extractLinkedItemIds(relCol.value).includes(sid);
+                });
+            }
+            emitSuccess({
+                ctx,
+                data: filtered,
+                schema: devTaskListCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                apiVersion,
+                source: 'live',
+                cacheAgeSeconds: null,
+                complexity: walkComplexity ?? aggregateComplexity,
+            });
+        });
+    },
+};
+//# sourceMappingURL=list.js.map

package/dist/commands/dev/task/list.js.map

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

package/dist/commands/dev/task/start.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `monday dev task start <iid>` — set a task's status to
+ * "Working on it" on the configured tasks board (cli-design §4.3
+ * + §5.9; v0.3-plan §3 M26b).
+ *
+ * **Runtime body landed at M26b IMPL.** Loads the active profile's
+ * dev mapping, routes the status flip through the shared
+ * {@link flipTaskStatus} helper (hydrates the tasks board's status
+ * column, resolves the canonical "Working on it" label
+ * case-insensitively, fires `change_simple_column_value` via the
+ * shared {@link executeItemMutation}).
+ *
+ * **Convention, not API.** Pure convenience over
+ * `monday item update <iid> --board <tasks_board> --set status=
+ * "Working on it"`. The dev namespace's value is naming the
+ * workflow concept (`task start`) over the CRUD primitive.
+ *
+ * Idempotent: yes — Monday's `change_simple_column_value` is
+ * idempotent for equal values.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../../types.js';
+import { type ProjectedItem } from '../../../api/item-projection.js';
+declare const inputSchema: z.ZodObject<{
+    itemId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+}, z.core.$strict>;
+export declare const devTaskStartCommand: CommandModule<z.infer<typeof inputSchema>, ProjectedItem>;
+export {};
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/dev/task/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../../src/commands/dev/task/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAUtE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAEzC,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAEZ,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,aAAa,CAsEd,CAAC"}

package/dist/commands/dev/task/start.js

@@ -0,0 +1,90 @@
+/**
+ * `monday dev task start <iid>` — set a task's status to
+ * "Working on it" on the configured tasks board (cli-design §4.3
+ * + §5.9; v0.3-plan §3 M26b).
+ *
+ * **Runtime body landed at M26b IMPL.** Loads the active profile's
+ * dev mapping, routes the status flip through the shared
+ * {@link flipTaskStatus} helper (hydrates the tasks board's status
+ * column, resolves the canonical "Working on it" label
+ * case-insensitively, fires `change_simple_column_value` via the
+ * shared {@link executeItemMutation}).
+ *
+ * **Convention, not API.** Pure convenience over
+ * `monday item update <iid> --board <tasks_board> --set status=
+ * "Working on it"`. The dev namespace's value is naming the
+ * workflow concept (`task start`) over the CRUD primitive.
+ *
+ * Idempotent: yes — Monday's `change_simple_column_value` is
+ * idempotent for equal values.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../../types.js';
+import { parseArgv } from '../../parse-argv.js';
+import { emitMutation } from '../../emit.js';
+import { resolveClient } from '../../../api/resolve-client.js';
+import { ItemIdSchema } from '../../../types/ids.js';
+import { flipTaskStatus, loadDevMapping, } from '../../../api/dev-conventions.js';
+import { resolveActiveDevProfile, requireDevBoard } from '../_shared.js';
+import { projectedItemSchema, } from '../../../api/item-projection.js';
+const inputSchema = z
+    .object({
+    itemId: ItemIdSchema,
+})
+    .strict();
+export const devTaskStartCommand = {
+    name: 'dev.task.start',
+    summary: 'Set a task\'s status to "Working on it" on the configured tasks board',
+    examples: [
+        'monday dev task start 12345678',
+        'monday dev task start 12345678 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: projectedItemSchema,
+    attach: (program, ctx) => {
+        const dev = ensureSubcommand(program, 'dev', 'Monday Dev workflow shortcuts (cli-design §2.7 — convention, not API)');
+        const task = ensureSubcommand(dev, 'task', 'Task workflow verbs (three-level depth per cli-design §5.2 carve-out 1)');
+        task
+            .command('start <itemId>')
+            .description(devTaskStartCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...devTaskStartCommand.examples.map((e) => `  ${e}`),
+            '',
+        ].join('\n'))
+            .action(async (itemIdArg) => {
+            const parsed = parseArgv(devTaskStartCommand.inputSchema, {
+                itemId: itemIdArg,
+            });
+            const profile = await resolveActiveDevProfile(ctx, program.opts());
+            const mapping = await loadDevMapping(profile.name, profile.homeOptions);
+            const tasksBoard = requireDevBoard(mapping, 'tasks_board', profile.name);
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const flip = await flipTaskStatus({
+                client,
+                tasksBoard,
+                itemId: parsed.itemId,
+                canonical: 'Working on it',
+                hydrateOperation: 'DevTaskStartHydrate',
+            });
+            emitMutation({
+                ctx,
+                data: flip.projected,
+                schema: devTaskStartCommand.outputSchema,
+                programOpts: program.opts(),
+                apiVersion,
+                source: 'live',
+                cacheAgeSeconds: null,
+                complexity: flip.complexity,
+                // cli-design §5.3 step 2 + docs/output-shapes.md §M26 task
+                // verb shapes: echo the resolved status-column ID so an
+                // agent's "set then re-read" loop can reuse the stable ID
+                // without a second metadata lookup (Codex round-1 P2-1).
+                resolvedIds: { status: flip.columnId },
+            });
+        });
+    },
+};
+//# sourceMappingURL=start.js.map

package/dist/commands/dev/task/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../src/commands/dev/task/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,mBAAmB,GAEpB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,MAAM,EAAE,YAAY;CACrB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,uEAAuE;IAChF,QAAQ,EAAE;QACR,gCAAgC;QAChC,uCAAuC;KACxC;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,mBAAmB;IACjC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,gBAAgB,CAC1B,OAAO,EACP,KAAK,EACL,uEAAuE,CACxE,CAAC;QACF,MAAM,IAAI,GAAG,gBAAgB,CAC3B,GAAG,EACH,MAAM,EACN,yEAAyE,CAC1E,CAAC;QACF,IAAI;aACD,OAAO,CAAC,gBAAgB,CAAC;aACzB,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC;aACxC,WAAW,CACV,OAAO,EACP;YACE,EAAE;YACF,WAAW;YACX,GAAG,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACA,MAAM,CAAC,KAAK,EAAE,SAAkB,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE;gBACxD,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YACxE,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAEzE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAElE,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC;gBAChC,MAAM;gBACN,UAAU;gBACV,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,eAAe;gBAC1B,gBAAgB,EAAE,qBAAqB;aACxC,CAAC,CAAC;YAEH,YAAY,CAAC;gBACX,GAAG;gBACH,IAAI,EAAE,IAAI,CAAC,SAAS;gBACpB,MAAM,EAAE,mBAAmB,CAAC,YAAY;gBACxC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,UAAU;gBACV,MAAM,EAAE,MAAM;gBACd,eAAe,EAAE,IAAI;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,2DAA2D;gBAC3D,wDAAwD;gBACxD,0DAA0D;gBAC1D,yDAAyD;gBACzD,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE;aACvC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

package/dist/commands/doc/get.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `monday doc get <did>` — read a single workdoc by ID, including
+ * its rich-text block body (cli-design.md §4.3 DOC section + §13
+ * v0.4 entry; v0.4-plan.md §3 M32).
+ *
+ * **Wire shape.** Single `Query.docs(ids: [<did>])` round-trip via
+ * {@link getDocument} against `query GetDoc` with `operationName:
+ * 'GetDoc'` (R-NEW-37 W2 audit-point). Monday returns `[Document]`
+ * (an array even for a single-id query); the fetcher extracts
+ * index 0. Empty array → `not_found` with `details.doc_id` (D8 —
+ * Monday's wire surface collapses "doesn't exist" + "exists but
+ * inaccessible to token" into the same shape; the CLI can't
+ * distinguish them).
+ *
+ * **Output envelope (D9).** Direct unwrap of the Document — `data:
+ * <Document with blocks>`. Mirrors the read-one-verb convention
+ * (`monday board get <bid>` returns `data: <Board>`, `monday user
+ * get <uid>` returns `data: <User>`). The Document's own `id`
+ * field is the echoed input; no separate `doc_id` slot is needed.
+ * `data.blocks: [DocumentBlock]` is the rich-text body hydrated
+ * from `Document.blocks` (always present on success — never null
+ * for a doc that resolved).
+ *
+ * **Docs are live-only at v0.4-M32** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_seconds:
+ * null`. Per-doc body content is content-heavy + frequently
+ * human-edited; the stale-cache risk outweighs the cache-hit
+ * value.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.4-M32 IMPL.** Argv parsing + schema +
+ * commander wiring all ship as the real shipped surface; the action
+ * body's wire-call dispatch + envelope emit are below. The verb is
+ * a thin wrapper around {@link getDocument} — branded `<docId>` →
+ * fetcher → direct-unwrap envelope.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DocGetOutput } from '../../api/documents.js';
+declare const inputSchema: z.ZodObject<{
+    docId: z.core.$ZodBranded<z.ZodString, "DocId", "out">;
+}, z.core.$strict>;
+export declare const docGetCommand: CommandModule<z.infer<typeof inputSchema>, DocGetOutput>;
+export {};
+//# sourceMappingURL=get.d.ts.map

package/dist/commands/doc/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/doc/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,WAAW;;kBAA4C,CAAC;AAE9D,eAAO,MAAM,aAAa,EAAE,aAAa,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,YAAY,CAyDb,CAAC"}

package/dist/commands/doc/get.js

@@ -0,0 +1,95 @@
+/**
+ * `monday doc get <did>` — read a single workdoc by ID, including
+ * its rich-text block body (cli-design.md §4.3 DOC section + §13
+ * v0.4 entry; v0.4-plan.md §3 M32).
+ *
+ * **Wire shape.** Single `Query.docs(ids: [<did>])` round-trip via
+ * {@link getDocument} against `query GetDoc` with `operationName:
+ * 'GetDoc'` (R-NEW-37 W2 audit-point). Monday returns `[Document]`
+ * (an array even for a single-id query); the fetcher extracts
+ * index 0. Empty array → `not_found` with `details.doc_id` (D8 —
+ * Monday's wire surface collapses "doesn't exist" + "exists but
+ * inaccessible to token" into the same shape; the CLI can't
+ * distinguish them).
+ *
+ * **Output envelope (D9).** Direct unwrap of the Document — `data:
+ * <Document with blocks>`. Mirrors the read-one-verb convention
+ * (`monday board get <bid>` returns `data: <Board>`, `monday user
+ * get <uid>` returns `data: <User>`). The Document's own `id`
+ * field is the echoed input; no separate `doc_id` slot is needed.
+ * `data.blocks: [DocumentBlock]` is the rich-text body hydrated
+ * from `Document.blocks` (always present on success — never null
+ * for a doc that resolved).
+ *
+ * **Docs are live-only at v0.4-M32** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_seconds:
+ * null`. Per-doc body content is content-heavy + frequently
+ * human-edited; the stale-cache risk outweighs the cache-hit
+ * value.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.4-M32 IMPL.** Argv parsing + schema +
+ * commander wiring all ship as the real shipped surface; the action
+ * body's wire-call dispatch + envelope emit are below. The verb is
+ * a thin wrapper around {@link getDocument} — branded `<docId>` →
+ * fetcher → direct-unwrap envelope.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { DocIdSchema } from '../../types/ids.js';
+import { docGetOutputSchema, getDocument, } from '../../api/documents.js';
+const inputSchema = z.object({ docId: DocIdSchema }).strict();
+export const docGetCommand = {
+    name: 'doc.get',
+    summary: 'Read a single workdoc by ID (includes block body)',
+    examples: [
+        'monday doc get 12345678',
+        'monday doc get 12345678 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: docGetOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'doc', 'Document commands (workdocs; read-only at v0.4 — see cli-design §13 v0.4 entry)');
+        noun
+            .command('get <docId>')
+            .description(docGetCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...docGetCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Output carries the full Document plus `blocks: [DocumentBlock]` (rich-text body).',
+            '  - Non-existent + inaccessible docs both surface `not_found` (Monday\'s wire collapses both cases).',
+            '',
+        ].join('\n'))
+            .action(async (docIdArg) => {
+            const parsed = parseArgv(docGetCommand.inputSchema, {
+                docId: docIdArg,
+            });
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await getDocument({
+                client,
+                docId: parsed.docId,
+            });
+            emitSuccess({
+                ctx,
+                data: result.document,
+                schema: docGetCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'single',
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=get.js.map

package/dist/commands/doc/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/doc/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,WAAW,GAEZ,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE9D,MAAM,CAAC,MAAM,aAAa,GAGtB;IACF,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,mDAAmD;IAC5D,QAAQ,EAAE;QACR,yBAAyB;QACzB,gCAAgC;KACjC;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,kBAAkB;IAChC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAC3B,OAAO,EACP,KAAK,EACL,iFAAiF,CAClF,CAAC;QACF,IAAI;aACD,OAAO,CAAC,aAAa,CAAC;aACtB,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC;aAClC,WAAW,CACV,OAAO,EACP;YACE,EAAE;YACF,WAAW;YACX,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,EAAE;YACF,QAAQ;YACR,uFAAuF;YACvF,sGAAsG;YACtG,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACA,MAAM,CAAC,KAAK,EAAE,QAAiB,EAAE,EAAE;YAClC,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE;gBAClD,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;YAEH,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,MAAM;gBACN,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YACH,WAAW,CAAC;gBACV,GAAG;gBACH,IAAI,EAAE,MAAM,CAAC,QAAQ;gBACrB,MAAM,EAAE,aAAa,CAAC,YAAY;gBAClC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU;aACX,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

package/dist/commands/doc/list.d.ts

@@ -0,0 +1,83 @@
+/**
+ * `monday doc list [--workspace <wid>,...] [--order-by <created_at|
+ * used_at>] [--limit <n>] [--page <n>]` — list workdocs visible to
+ * the token, optionally filtered by workspace and sorted by recency
+ * (cli-design.md §4.3 DOC section + §13 v0.4 entry; v0.4-plan.md §3
+ * M32).
+ *
+ * **Wire shape.** Single `Query.docs(...)` round-trip via
+ * {@link listDocuments} against `query ListDocs` with
+ * `operationName: 'ListDocs'` (R-NEW-37 W2 audit-point). Page/limit
+ * pagination — Monday's workdocs surface has no `items_page`-style
+ * cursor; agents paginate by incrementing `--page`. The list row
+ * projection ships every base Document field EXCEPT `blocks` per
+ * D6 closure (rich-text bodies belong to `monday doc get <did>`).
+ *
+ * **Argv shape.**
+ *
+ *   - `--workspace <wid>,...` — comma-separated workspace ID
+ *     filter (maps to wire `workspace_ids: [ID]`). Optional;
+ *     absent → unfiltered (every visible doc across the account).
+ *     Each entry is brand-validated via {@link WorkspaceIdSchema}.
+ *     Inaccessible workspace IDs surface as empty filter results
+ *     per D4 — Monday's wire silently drops unknown workspace IDs
+ *     rather than rejecting the call; the CLI doesn't fire a
+ *     resolver warning because the wire doesn't distinguish "no
+ *     docs in workspace X" from "X not accessible".
+ *   - `--order-by <created_at|used_at>` — pinned 2-value enum
+ *     (per the M32 probe of `DocsOrderBy`). Default
+ *     `created_at`. Both values sort `desc` server-side; no
+ *     ascending variant on Monday's wire.
+ *   - `--limit <n>` — `[1, 100]`, default `25` (matches Monday's
+ *     wire-side default; ceiling pins worst-case payload size).
+ *     Out-of-range argv rejects at parse boundary with
+ *     `usage_error` (no wire call fires).
+ *   - `--page <n>` — 1-based, default `1`. Out-of-range argv
+ *     rejects at parse boundary.
+ *
+ * **Output envelope (D9).** Wrapped record `data: { documents:
+ * [Document], page, limit, returned_count, has_more }`.
+ * `has_more` is the `returned_count === limit` heuristic —
+ * Monday's wire doesn't surface a total count, so "exactly limit
+ * rows returned" is the only signal that a follow-up page may
+ * exist. Agents that need exhaustive listing loop until
+ * `has_more: false`.
+ *
+ * **Docs are live-only at v0.4-M32** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_seconds:
+ * null`. Workdocs are content-heavy + frequently human-edited; the
+ * stale-cache risk outweighs the cache-hit value.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.4-M32 IMPL.** Argv parsing + schema +
+ * commander wiring + `--workspace` comma-split helper all ship as
+ * the real shipped argv surface; the action body's wire-call
+ * dispatch + envelope emit are below. The verb is a thin wrapper
+ * around {@link listDocuments} — comma-split argv → branded array
+ * → fetcher → envelope.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DocListOutput } from '../../api/documents.js';
+declare const inputSchema: z.ZodObject<{
+    workspace: z.ZodOptional<z.ZodString>;
+    orderBy: z.ZodOptional<z.ZodEnum<{
+        created_at: "created_at";
+        used_at: "used_at";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const docListCommand: CommandModule<z.infer<typeof inputSchema>, DocListOutput>;
+/**
+ * Internals exposed for unit-test access (argv parser pinning).
+ * NOT a public API — the comma-split helper + decimal parser stay
+ * production-internal.
+ */
+export declare const _internals: {
+    readonly parseWorkspaceListArg: (raw: string) => readonly string[];
+    readonly parseStrictDecimal: (raw: string) => number;
+};
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/doc/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/doc/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,WAAW;;;;;;;;kBA6BN,CAAC;AAEZ,eAAO,MAAM,cAAc,EAAE,aAAa,CACxC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,aAAa,CA4Gd,CAAC;AA2EF;;;;GAIG;AACH,eAAO,MAAM,UAAU;0CA7Ca,MAAM,KAAG,SAAS,MAAM,EAAE;uCAlB7B,MAAM,KAAG,MAAM;CAkEtC,CAAC"}