monday-cli 0.2.0

package/dist/commands/workspace/delete.js

@@ -0,0 +1,182 @@
+/**
+ * `monday workspace delete <wid> --yes [--dry-run]` — delete an
+ * existing workspace (`cli-design.md` §4.3 line 481, `v0.2-plan.md`
+ * §3 M14).
+ *
+ * **Confirmation gate** (cli-design §3.1 #7 + §10.2). `--yes` is
+ * mandatory for the live path; without `--yes` (and without
+ * `--dry-run`) the command fails fast with `confirmation_required`
+ * (exit 1) carrying `details.workspace_id`. Same shape — and same
+ * gate-before-`resolveClient()` ordering — as `item delete` /
+ * `item archive` / `update delete` (M10 round-1 P2: the gate's
+ * contract is unconditional; a missing token must NOT mask
+ * `confirmation_required` as `config_error`).
+ *
+ * The inline gate replicates the 17-LOC pattern from the four prior
+ * destructive-verb sites. R29 lift (v0.2-plan §20) consolidates
+ * this block + the four prior sites into
+ * `src/api/destructive-gate.ts` after M14 implementation lands —
+ * workspace delete is the 5th consumer that triggers the lift.
+ *
+ * **Wire shape.** Single round-trip via `delete_workspace(workspace_
+ * id: ID!)`. Monday returns the deleted `Workspace` so the envelope's
+ * `data` is the full projection. A null result surfaces as
+ * `not_found` — the standard "id was bogus / already deleted"
+ * mapping.
+ *
+ * **Admin-permission-sensitive.** Non-admin callers surface
+ * `forbidden` (mapped from Monday's PERMISSION_DENIED extension).
+ *
+ * **Dry-run shape** per cli-design §6.4 workspace-delete variant:
+ * minimal `{operation: "delete_workspace", workspace_id}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Same shape (modulo `workspace_id` vs
+ * `update_id`) as `update delete` — the destructive-no-read pattern
+ * is uniform across `item delete` / `update delete` / `workspace
+ * delete`.
+ *
+ * **Idempotent: false.** Re-running surfaces `not_found` past the
+ * first call. Same rationale as `item delete` / `update delete` —
+ * agents can't safely retry without verifying the id still names
+ * the same record.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { parseGlobalFlags } from '../../types/global-flags.js';
+import { ApiError } from '../../utils/errors.js';
+import { enforceDestructiveGate } from '../../api/destructive-gate.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { WORKSPACE_FIELDS_FRAGMENT, workspaceProjectionSchema, } from '../../api/workspace-projection.js';
+const DELETE_WORKSPACE_MUTATION = `
+  mutation WorkspaceDelete($workspaceId: ID!) {
+    delete_workspace(workspace_id: $workspaceId) {
+      ${WORKSPACE_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const workspaceDeleteOutputSchema = workspaceProjectionSchema;
+const inputSchema = z
+    .object({ workspaceId: WorkspaceIdSchema })
+    .strict();
+const responseSchema = z
+    .object({
+    delete_workspace: z.unknown(),
+})
+    .loose();
+export const workspaceDeleteCommand = {
+    name: 'workspace.delete',
+    summary: 'Delete a workspace — --yes required',
+    examples: [
+        'monday workspace delete 12345 --yes',
+        'monday workspace delete 12345 --dry-run',
+        'monday workspace delete 12345 --yes --json',
+    ],
+    // Re-deleting an already-deleted workspace surfaces `not_found`.
+    // The CLI marks `idempotent: false` because re-running with the
+    // same `<wid>` after an interim `monday workspace create` would
+    // target a different record — see `item delete` for the full
+    // rationale.
+    idempotent: false,
+    inputSchema,
+    outputSchema: workspaceDeleteOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'workspace', 'Workspace commands');
+        noun
+            .command('delete <workspaceId>')
+            .description(workspaceDeleteCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...workspaceDeleteCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (workspaceId) => {
+            const parsed = parseArgv(workspaceDeleteCommand.inputSchema, { workspaceId });
+            // Gate BEFORE `resolveClient()` — Codex M10 round-1 P2.
+            // A missing `--yes` must surface as `confirmation_required`
+            // per cli-design §3.1 #7's unconditional contract, never
+            // masked by `config_error` when no token is configured.
+            // R29 lift (v0.2-plan §20): the helper accepts already-
+            // parsed globalFlags so the ordering invariant is visible
+            // in the call signature. Workspace delete was the 5th
+            // consumer that triggered the lift.
+            const globalFlags = parseGlobalFlags(program.opts(), ctx.env);
+            enforceDestructiveGate({
+                globalFlags,
+                verb: 'workspace delete',
+                target: parsed.workspaceId,
+                detailKey: 'workspace_id',
+                action: 'delete the workspace',
+                hint: 'delete is destructive — Monday retains deleted workspaces ' +
+                    'in the trash for ~30 days but exposes no restore mutation; ' +
+                    'agents needing reversal must recreate via `monday workspace ' +
+                    'create` (lossy: new id, no boards / users / folders state).',
+            });
+            if (globalFlags.dryRun) {
+                // Minimal dry-run shape — no preflight read fires. Per
+                // cli-design §6.4 workspace-delete variant: `operation:
+                // "delete_workspace"`, `workspace_id`, nothing else.
+                // `meta.source: 'none'` because no API call fires; live
+                // surfaces `not_found` for missing ids on its own.
+                const { apiVersion } = resolveClient(ctx, program.opts());
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'delete_workspace',
+                            workspace_id: parsed.workspaceId,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const response = await client.raw(DELETE_WORKSPACE_MUTATION, { workspaceId: parsed.workspaceId }, { operationName: 'WorkspaceDelete' });
+            const data = unwrapOrThrow(responseSchema.safeParse(response.data), {
+                context: 'Monday returned a malformed WorkspaceDelete response',
+                details: { workspace_id: parsed.workspaceId },
+                hint: 'this is a data-integrity error in Monday\'s response; ' +
+                    'verify the response shape and update responseSchema if ' +
+                    'Monday\'s contract has changed.',
+            });
+            // Codex M14 round-3 F1: distinguish "root key absent"
+            // (schema-drift → internal_error) from "value null"
+            // (workspace already deleted / id bogus → not_found).
+            if (!('delete_workspace' in data)) {
+                throw new ApiError('internal_error', `Monday's WorkspaceDelete response is missing the delete_workspace root field`, {
+                    details: {
+                        workspace_id: parsed.workspaceId,
+                        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.',
+                    },
+                });
+            }
+            const projected = projectDeletedWorkspace(data.delete_workspace, parsed.workspaceId);
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: workspaceDeleteCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+const projectDeletedWorkspace = (raw, workspaceId) => {
+    if (raw === null || raw === undefined) {
+        throw new ApiError('not_found', `Monday returned no workspace payload from delete_workspace for id ${workspaceId}`, { details: { workspace_id: workspaceId } });
+    }
+    return unwrapOrThrow(workspaceDeleteOutputSchema.safeParse(raw), {
+        context: `Monday returned a malformed workspace payload for id ${workspaceId}`,
+        details: { workspace_id: workspaceId },
+    });
+};
+//# sourceMappingURL=delete.js.map

package/dist/commands/workspace/delete.js.map

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

package/dist/commands/workspace/folders.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `monday workspace folders <wid>` — list folders inside a workspace
+ * (`cli-design.md` §4.3).
+ *
+ * GraphQL: `folders(workspace_ids: [<wid>], limit:, page:)` —
+ * page-based pagination, same shape as `workspace list`. Folders
+ * carry a `children: [Board]` array so the agent can see board
+ * groupings inline; we project minimally (id + name) — the full
+ * board metadata lives behind `board describe`.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const workspaceFoldersOutputSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    color: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodNullable<z.ZodString>;
+    owner_id: z.ZodNullable<z.ZodString>;
+    parent: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+    children: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+export type WorkspaceFoldersOutput = z.infer<typeof workspaceFoldersOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    workspaceId: z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    page: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    all: z.ZodOptional<z.ZodBoolean>;
+    limitPages: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const workspaceFoldersCommand: CommandModule<z.infer<typeof inputSchema>, WorkspaceFoldersOutput>;
+export {};
+//# sourceMappingURL=folders.d.ts.map

package/dist/commands/workspace/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAoDnE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;mBAAwB,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,QAAA,MAAM,WAAW;;;;;;kBAQN,CAAC;AAMZ,eAAO,MAAM,uBAAuB,EAAE,aAAa,CACjD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,sBAAsB,CAsEvB,CAAC"}

package/dist/commands/workspace/folders.js

@@ -0,0 +1,124 @@
+/**
+ * `monday workspace folders <wid>` — list folders inside a workspace
+ * (`cli-design.md` §4.3).
+ *
+ * GraphQL: `folders(workspace_ids: [<wid>], limit:, page:)` —
+ * page-based pagination, same shape as `workspace list`. Folders
+ * carry a `children: [Board]` array so the agent can see board
+ * groupings inline; we project minimally (id + name) — the full
+ * board metadata lives behind `board describe`.
+ *
+ * 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 { UsageError } from '../../utils/errors.js';
+import { WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { buildCapWarning, DEFAULT_MAX_PAGES, walkPages, } from '../../api/walk-pages.js';
+const WORKSPACE_FOLDERS_QUERY = `
+  query WorkspaceFolders($workspaceIds: [ID], $limit: Int, $page: Int) {
+    folders(workspace_ids: $workspaceIds, limit: $limit, page: $page) {
+      id
+      name
+      color
+      created_at
+      owner_id
+      parent {
+        id
+        name
+      }
+      children {
+        id
+        name
+      }
+    }
+  }
+`;
+const folderRefSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string(),
+})
+    .strict();
+const folderSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string(),
+    color: z.string().nullable(),
+    created_at: z.string().nullable(),
+    owner_id: z.string().nullable(),
+    parent: folderRefSchema.nullable(),
+    children: z.array(folderRefSchema.nullable()),
+})
+    .strict();
+export const workspaceFoldersOutputSchema = z.array(folderSchema);
+const inputSchema = z
+    .object({
+    workspaceId: WorkspaceIdSchema,
+    limit: z.coerce.number().int().positive().max(100).optional(),
+    page: z.coerce.number().int().positive().optional(),
+    all: z.boolean().optional(),
+    limitPages: z.coerce.number().int().positive().max(500).optional(),
+})
+    .strict();
+export const workspaceFoldersCommand = {
+    name: 'workspace.folders',
+    summary: 'List folders inside a workspace',
+    examples: [
+        'monday workspace folders 12345',
+        'monday workspace folders 12345 --all --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: workspaceFoldersOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'workspace', 'Workspace commands');
+        noun
+            .command('folders <workspaceId>')
+            .description(workspaceFoldersCommand.summary)
+            .option('--limit <n>', 'max folders per page (1-100)')
+            .option('--page <n>', 'page number (1-indexed)')
+            .option('--all', 'walk every page')
+            .option('--limit-pages <n>', `max pages under --all (1-500, default ${String(DEFAULT_MAX_PAGES)})`)
+            .addHelpText('after', ['', 'Examples:', ...workspaceFoldersCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (workspaceId, opts) => {
+            const parsed = parseArgv(workspaceFoldersCommand.inputSchema, {
+                workspaceId,
+                ...opts,
+            });
+            if (parsed.all === true && parsed.page !== undefined) {
+                throw new UsageError('--all and --page are mutually exclusive');
+            }
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const limit = parsed.limit ?? 25;
+            const maxPages = parsed.limitPages ?? DEFAULT_MAX_PAGES;
+            const result = await walkPages({
+                fetchPage: (page) => client.raw(WORKSPACE_FOLDERS_QUERY, { workspaceIds: [parsed.workspaceId], limit, page }, { operationName: 'WorkspaceFolders' }),
+                extractItems: (r) => r.data.folders ?? [],
+                pageSize: limit,
+                all: parsed.all === true,
+                startPage: parsed.page ?? 1,
+                maxPages,
+            });
+            const projected = workspaceFoldersCommand.outputSchema.parse(result.items);
+            const warnings = [];
+            if (parsed.all === true && result.hasMore) {
+                warnings.push(buildCapWarning(result.pagesFetched));
+            }
+            emitSuccess({
+                ctx,
+                data: projected,
+                schema: workspaceFoldersCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                hasMore: result.hasMore,
+                warnings,
+                ...toEmit(result.lastResponse),
+            });
+        });
+    },
+};
+//# sourceMappingURL=folders.js.map

package/dist/commands/workspace/folders.js.map

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

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

@@ -0,0 +1,35 @@
+/**
+ * `monday workspace get <wid>` — fetch one workspace by ID
+ * (`cli-design.md` §4.3, §6.2).
+ *
+ * GraphQL: `workspaces(ids: [<wid>])` returns the workspace as the
+ * first (only) entry. Monday returns an empty list — not an error —
+ * for an unknown ID; we surface that as `not_found`.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type WorkspaceProjection } from '../../api/workspace-projection.js';
+export declare const workspaceGetOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    kind: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    is_default_workspace: z.ZodNullable<z.ZodBoolean>;
+    created_at: z.ZodNullable<z.ZodString>;
+    settings: z.ZodNullable<z.ZodObject<{
+        icon: z.ZodNullable<z.ZodObject<{
+            color: z.ZodNullable<z.ZodString>;
+            image: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceGetOutput = WorkspaceProjection;
+declare const inputSchema: z.ZodObject<{
+    workspaceId: z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">;
+}, z.core.$strict>;
+export declare const workspaceGetCommand: CommandModule<z.infer<typeof inputSchema>, WorkspaceGetOutput>;
+export {};
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAU3C,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;kBAA4B,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAEZ,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,kBAAkB,CAmCnB,CAAC"}

package/dist/commands/workspace/get.js

@@ -0,0 +1,62 @@
+/**
+ * `monday workspace get <wid>` — fetch one workspace by ID
+ * (`cli-design.md` §4.3, §6.2).
+ *
+ * GraphQL: `workspaces(ids: [<wid>])` returns the workspace as the
+ * first (only) entry. Monday returns an empty list — not an error —
+ * for an unknown ID; we surface that as `not_found`.
+ *
+ * Idempotent: yes — pure read.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { runByIdLookup } from '../run-by-id-lookup.js';
+import { WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { WORKSPACE_FIELDS_FRAGMENT, workspaceProjectionSchema, } from '../../api/workspace-projection.js';
+const WORKSPACE_GET_QUERY = `
+  query WorkspaceGet($ids: [ID!]) {
+    workspaces(ids: $ids) {
+      ${WORKSPACE_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const workspaceGetOutputSchema = workspaceProjectionSchema;
+const inputSchema = z
+    .object({
+    workspaceId: WorkspaceIdSchema,
+})
+    .strict();
+export const workspaceGetCommand = {
+    name: 'workspace.get',
+    summary: 'Show a single workspace by ID',
+    examples: [
+        'monday workspace get 12345',
+        'monday workspace get 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: workspaceGetOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'workspace', 'Workspace commands');
+        noun
+            .command('get <workspaceId>')
+            .description(workspaceGetCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...workspaceGetCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (workspaceId) => {
+            const parsed = parseArgv(workspaceGetCommand.inputSchema, { workspaceId });
+            await runByIdLookup({
+                ctx,
+                programOpts: program.opts(),
+                query: WORKSPACE_GET_QUERY,
+                operationName: 'WorkspaceGet',
+                collectionKey: 'workspaces',
+                id: parsed.workspaceId,
+                errorDetailKey: 'workspace_id',
+                kind: 'workspace',
+                schema: workspaceGetCommand.outputSchema,
+            });
+        });
+    },
+};
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/workspace/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAE1B,MAAM,mCAAmC,CAAC;AAE3C,MAAM,mBAAmB,GAAG;;;QAGpB,yBAAyB;;;CAGhC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAIlE,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,WAAW,EAAE,iBAAiB;CAC/B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,+BAA+B;IACxC,QAAQ,EAAE;QACR,4BAA4B;QAC5B,mCAAmC;KACpC;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,wBAAwB;IACtC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAC1E,IAAI;aACD,OAAO,CAAC,mBAAmB,CAAC;aAC5B,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC;aACxC,WAAW,CACV,OAAO,EACP,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACvF;aACA,MAAM,CAAC,KAAK,EAAE,WAAoB,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,SAAS,CAAC,mBAAmB,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YAC3E,MAAM,aAAa,CAAC;gBAClB,GAAG;gBACH,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,KAAK,EAAE,mBAAmB;gBAC1B,aAAa,EAAE,cAAc;gBAC7B,aAAa,EAAE,YAAY;gBAC3B,EAAE,EAAE,MAAM,CAAC,WAAW;gBACtB,cAAc,EAAE,cAAc;gBAC9B,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,mBAAmB,CAAC,YAAY;aACzC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * `monday workspace list` — list every visible workspace
+ * (`cli-design.md` §4.3, §6.3).
+ *
+ * GraphQL: `workspaces(limit:, page:, kind:, state:, ids:, order_by:)`
+ *
+ * Idempotent: yes — pure read.
+ *
+ * Pagination model. Monday's `workspaces` query is page-based (not
+ * cursor-based — the §5.6 stale-cursor contract applies only to
+ * `items_page` in M4). We expose `--limit <n>` (max 100 per Monday)
+ * and `--page <n>` so an agent can walk pages explicitly. `--all`
+ * iterates from page 1 until a short page lands; the result is one
+ * flat array. The collection envelope (§6.3) carries
+ * `total_returned`, `has_more`, and the page number used.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+declare const workspaceSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    kind: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    is_default_workspace: z.ZodNullable<z.ZodBoolean>;
+    created_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type Workspace = z.infer<typeof workspaceSchema>;
+export declare const workspaceListOutputSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    kind: z.ZodNullable<z.ZodString>;
+    state: z.ZodNullable<z.ZodString>;
+    is_default_workspace: z.ZodNullable<z.ZodBoolean>;
+    created_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>>;
+export type WorkspaceListOutput = z.infer<typeof workspaceListOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    page: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>>;
+    state: z.ZodOptional<z.ZodEnum<{
+        archived: "archived";
+        deleted: "deleted";
+        all: "all";
+        active: "active";
+    }>>;
+    all: z.ZodOptional<z.ZodBoolean>;
+    limitPages: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export declare const workspaceListCommand: CommandModule<z.infer<typeof inputSchema>, WorkspaceListOutput>;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA0BnE,QAAA,MAAM,eAAe;;;;;;;;kBAUV,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,yBAAyB;;;;;;;;mBAA2B,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;kBASN,CAAC;AASZ,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAC9C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,mBAAmB,CA2EpB,CAAC"}

package/dist/commands/workspace/list.js

@@ -0,0 +1,125 @@
+/**
+ * `monday workspace list` — list every visible workspace
+ * (`cli-design.md` §4.3, §6.3).
+ *
+ * GraphQL: `workspaces(limit:, page:, kind:, state:, ids:, order_by:)`
+ *
+ * Idempotent: yes — pure read.
+ *
+ * Pagination model. Monday's `workspaces` query is page-based (not
+ * cursor-based — the §5.6 stale-cursor contract applies only to
+ * `items_page` in M4). We expose `--limit <n>` (max 100 per Monday)
+ * and `--page <n>` so an agent can walk pages explicitly. `--all`
+ * iterates from page 1 until a short page lands; the result is one
+ * flat array. The collection envelope (§6.3) carries
+ * `total_returned`, `has_more`, and the page number used.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { UsageError } from '../../utils/errors.js';
+import { parseArgv } from '../parse-argv.js';
+import { buildCapWarning, DEFAULT_MAX_PAGES, walkPages, } from '../../api/walk-pages.js';
+const WORKSPACE_LIST_QUERY = `
+  query WorkspaceList($limit: Int, $page: Int, $kind: WorkspaceKind, $state: State) {
+    workspaces(limit: $limit, page: $page, kind: $kind, state: $state) {
+      id
+      name
+      description
+      kind
+      state
+      is_default_workspace
+      created_at
+    }
+  }
+`;
+const workspaceSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string(),
+    description: z.string().nullable(),
+    kind: z.string().nullable(),
+    state: z.string().nullable(),
+    is_default_workspace: z.boolean().nullable(),
+    created_at: z.string().nullable(),
+})
+    .strict();
+export const workspaceListOutputSchema = z.array(workspaceSchema);
+const inputSchema = z
+    .object({
+    limit: z.coerce.number().int().positive().max(100).optional(),
+    page: z.coerce.number().int().positive().optional(),
+    kind: z.enum(['open', 'closed']).optional(),
+    state: z.enum(['active', 'archived', 'deleted', 'all']).optional(),
+    all: z.boolean().optional(),
+    limitPages: z.coerce.number().int().positive().max(500).optional(),
+})
+    .strict();
+const projectMany = (input) => workspaceListOutputSchema.parse(input);
+export const workspaceListCommand = {
+    name: 'workspace.list',
+    summary: 'List visible workspaces',
+    examples: [
+        'monday workspace list',
+        'monday workspace list --json',
+        'monday workspace list --kind open --state active',
+        'monday workspace list --all --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: workspaceListOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'workspace', 'Workspace commands');
+        noun
+            .command('list')
+            .description(workspaceListCommand.summary)
+            .option('--limit <n>', 'max workspaces per page (1-100, default 25)')
+            .option('--page <n>', 'page number (1-indexed)')
+            .option('--kind <k>', 'filter by kind: open|closed')
+            .option('--state <s>', 'filter by state: active|archived|deleted|all')
+            .option('--all', 'walk every page')
+            .option('--limit-pages <n>', `max pages under --all (1-500, default ${String(DEFAULT_MAX_PAGES)})`)
+            .addHelpText('after', ['', 'Examples:', ...workspaceListCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (opts) => {
+            const parsed = parseArgv(workspaceListCommand.inputSchema, opts);
+            if (parsed.all === true && parsed.page !== undefined) {
+                throw new UsageError('--all and --page are mutually exclusive');
+            }
+            const { client, toEmit } = resolveClient(ctx, program.opts());
+            const limit = parsed.limit ?? 25;
+            const maxPages = parsed.limitPages ?? DEFAULT_MAX_PAGES;
+            const result = await walkPages({
+                fetchPage: (page) => {
+                    const variables = { limit, page };
+                    if (parsed.kind !== undefined)
+                        variables.kind = parsed.kind;
+                    if (parsed.state !== undefined)
+                        variables.state = parsed.state;
+                    return client.raw(WORKSPACE_LIST_QUERY, variables, { operationName: 'WorkspaceList' });
+                },
+                extractItems: (r) => r.data.workspaces ?? [],
+                pageSize: limit,
+                all: parsed.all === true,
+                startPage: parsed.page ?? 1,
+                maxPages,
+            });
+            const projected = projectMany(result.items);
+            const warnings = [];
+            if (parsed.all === true && result.hasMore) {
+                warnings.push(buildCapWarning(result.pagesFetched));
+            }
+            emitSuccess({
+                ctx,
+                data: projected,
+                schema: workspaceListCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'collection',
+                hasMore: result.hasMore,
+                warnings,
+                ...toEmit(result.lastResponse),
+            });
+        });
+    },
+};
+//# sourceMappingURL=list.js.map