monday-cli 0.2.0

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

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

package/dist/commands/workspace/remove-users.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `monday workspace remove-users <wid> --users <id|email>,...
+ * [--dry-run]` — fan-out remove subscribers from a workspace one
+ * wire call per user (`cli-design.md` §4.3 line 529, `v0.2-plan.md`
+ * §3 M14).
+ *
+ * **Mirrors `workspace add-users` exactly** modulo the operation
+ * (`delete_users_from_workspace` rather than
+ * `add_users_to_workspace`) and the dispatch mutation. Same fan-
+ * out semantics (one wire call per user); same `--users` parser
+ * (numeric argv-derived, email through `userByEmail`); same
+ * partial-success envelope including `data.operation`; same
+ * `meta.source` aggregation rule (dry-run sees only resolver legs;
+ * live folds in every per-target dispatch leg too); same whole-
+ * call boundary (`user_not_found` when no dispatchable id remains;
+ * `usage_error` for malformed `--users` syntax).
+ *
+ * **Idempotent: yes** — Monday is no-op on re-removing a non-
+ * member. **Admin-permission-sensitive**.
+ *
+ * **R40 lift (post-M15).** The token parser, resolver loop,
+ * dispatch loop, and envelope assembly live in
+ * `src/api/users-fan-out-mutation.ts` — three M14 / M15 verbs
+ * (workspace add-users / workspace remove-users / board add-users)
+ * share the body modulo six per-verb parameters.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+export declare const workspaceRemoveUsersOutputSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"delete_users_from_workspace">;
+    results: z.ZodArray<z.ZodObject<{
+        user_id: z.ZodString;
+        ok: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkspaceRemoveUsersOutput = z.infer<typeof workspaceRemoveUsersOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    workspaceId: z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">;
+    users: z.ZodString;
+}, z.core.$strict>;
+export declare const workspaceRemoveUsersCommand: CommandModule<z.infer<typeof inputSchema>, WorkspaceRemoveUsersOutput>;
+export {};
+//# sourceMappingURL=remove-users.d.ts.map

package/dist/commands/workspace/remove-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-users.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/remove-users.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAgCnE,eAAO,MAAM,gCAAgC;;;;;;;;;;kBAKlC,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF,QAAA,MAAM,WAAW;;;kBAON,CAAC;AAEZ,eAAO,MAAM,2BAA2B,EAAE,aAAa,CACrD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,0BAA0B,CA8D3B,CAAC"}

package/dist/commands/workspace/remove-users.js

@@ -0,0 +1,122 @@
+/**
+ * `monday workspace remove-users <wid> --users <id|email>,...
+ * [--dry-run]` — fan-out remove subscribers from a workspace one
+ * wire call per user (`cli-design.md` §4.3 line 529, `v0.2-plan.md`
+ * §3 M14).
+ *
+ * **Mirrors `workspace add-users` exactly** modulo the operation
+ * (`delete_users_from_workspace` rather than
+ * `add_users_to_workspace`) and the dispatch mutation. Same fan-
+ * out semantics (one wire call per user); same `--users` parser
+ * (numeric argv-derived, email through `userByEmail`); same
+ * partial-success envelope including `data.operation`; same
+ * `meta.source` aggregation rule (dry-run sees only resolver legs;
+ * live folds in every per-target dispatch leg too); same whole-
+ * call boundary (`user_not_found` when no dispatchable id remains;
+ * `usage_error` for malformed `--users` syntax).
+ *
+ * **Idempotent: yes** — Monday is no-op on re-removing a non-
+ * member. **Admin-permission-sensitive**.
+ *
+ * **R40 lift (post-M15).** The token parser, resolver loop,
+ * dispatch loop, and envelope assembly live in
+ * `src/api/users-fan-out-mutation.ts` — three M14 / M15 verbs
+ * (workspace add-users / workspace remove-users / board add-users)
+ * share the body modulo six per-verb parameters.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { WorkspaceIdSchema } from '../../types/ids.js';
+import { parseArgv } from '../parse-argv.js';
+import { dispatchUsersFanOut, parseUsersArg, } from '../../api/users-fan-out-mutation.js';
+const REMOVE_USERS_FROM_WORKSPACE_MUTATION = `
+  mutation WorkspaceRemoveUsers($workspaceId: ID!, $userIds: [ID!]!) {
+    delete_users_from_workspace(workspace_id: $workspaceId, user_ids: $userIds) {
+      id
+    }
+  }
+`;
+const errorShape = z
+    .object({
+    code: z.string().min(1),
+    message: z.string(),
+})
+    .strict();
+const liveResultRecordSchema = z
+    .object({
+    user_id: z.string().min(1),
+    ok: z.boolean(),
+    error: errorShape.optional(),
+})
+    .strict();
+export const workspaceRemoveUsersOutputSchema = z
+    .object({
+    operation: z.literal('delete_users_from_workspace'),
+    results: z.array(liveResultRecordSchema),
+})
+    .strict();
+const inputSchema = z
+    .object({
+    workspaceId: WorkspaceIdSchema,
+    users: z
+        .string()
+        .min(1, '--users must not be empty'),
+})
+    .strict();
+export const workspaceRemoveUsersCommand = {
+    name: 'workspace.remove-users',
+    summary: 'Remove users from a workspace (partial-success envelope)',
+    examples: [
+        'monday workspace remove-users 12345 --users 67890,67891',
+        'monday workspace remove-users 12345 --users alice@example.test,67891',
+        'monday workspace remove-users 12345 --users 67890 --dry-run --json',
+    ],
+    // Re-removing a non-member is a no-op on Monday's side; mark
+    // idempotent so agents can retry on transient failure.
+    idempotent: true,
+    inputSchema,
+    outputSchema: workspaceRemoveUsersOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'workspace', 'Workspace commands');
+        noun
+            .command('remove-users <workspaceId>')
+            .description(workspaceRemoveUsersCommand.summary)
+            .requiredOption('--users <list>', 'comma-separated numeric ids and/or emails')
+            .addHelpText('after', ['', 'Examples:', ...workspaceRemoveUsersCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (workspaceId, opts) => {
+            const parsed = parseArgv(workspaceRemoveUsersCommand.inputSchema, {
+                workspaceId,
+                ...opts,
+            });
+            // parseUsersArg runs BEFORE resolveClient so a malformed
+            // `--users` surfaces as usage_error (exit 1) ahead of any
+            // missing-token config_error (exit 3).
+            const tokens = parseUsersArg(parsed.users);
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            await dispatchUsersFanOut({
+                client,
+                ctx,
+                programOpts: program.opts(),
+                globalFlags,
+                apiVersion,
+                toEmit,
+                tokens,
+                scope: {
+                    id: parsed.workspaceId,
+                    key: 'workspace_id',
+                    variableKey: 'workspaceId',
+                },
+                mutation: {
+                    query: REMOVE_USERS_FROM_WORKSPACE_MUTATION,
+                    operationName: 'WorkspaceRemoveUsers',
+                    rootKey: 'delete_users_from_workspace',
+                },
+                dataOperation: 'delete_users_from_workspace',
+                verbDescription: 'workspace remove-users',
+                outputSchema: workspaceRemoveUsersOutputSchema,
+            });
+        });
+    },
+};
+//# sourceMappingURL=remove-users.js.map

package/dist/commands/workspace/remove-users.js.map

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

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

@@ -0,0 +1,68 @@
+/**
+ * `monday workspace update <wid> [--name <n>] [--kind open|closed]
+ * [--description <d>] [--dry-run]` — change one or more workspace
+ * fields (`cli-design.md` §4.3 line 462, `v0.2-plan.md` §3 M14).
+ *
+ * **Wire shape.** Single round-trip via `update_workspace(id,
+ * attributes: UpdateWorkspaceAttributesInput)`. The SDK marks the
+ * mutation's `id?` argument as optional but it's required in
+ * practice; the CLI takes it as a required positional.
+ * `attributes` is `{name?, kind?, description?}` — only the fields
+ * the agent provided land on the wire (omitting a flag means
+ * "leave unchanged"; partial-input is the SDK's intended shape).
+ *
+ * **Argv discipline.** At least one of `--name` / `--kind` /
+ * `--description` is required — zero-flag invocation surfaces as
+ * `usage_error` (exit 1) at argv-parse, before any network leg.
+ * Mirrors `item update`'s "at least one of --name / --set / --set-
+ * raw required" rule.
+ *
+ * **Dry-run shape** per cli-design §6.4 workspace-update variant:
+ * a field-level diff with `from → to` per provided field. The
+ * `from` state requires a preflight `workspace get` read leg, so
+ * dry-run is two-leg (read + diff-build); `meta.source: 'live'`
+ * because the read fired (workspace metadata isn't cached in v0.2).
+ * When the workspace itself doesn't exist, the preflight surfaces
+ * `not_found` (exit 2) — agents shouldn't have to interpret a
+ * would-fail dry-run shape (mirrors the `item move --to-board`
+ * unmatched-columns rule).
+ *
+ * **Idempotent: yes.** Re-applying the same field values is a no-op
+ * on Monday's side — `update_workspace` writes the new attributes
+ * verbatim. Mark `idempotent: true` so agents can retry on transient
+ * failure without divergence.
+ *
+ * **NOT destructive** (no `--yes` gate per cli-design §3.1 #7 — the
+ * gate is reserved for destructive ops only).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type WorkspaceProjection } from '../../api/workspace-projection.js';
+export declare const workspaceUpdateOutputSchema: 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 WorkspaceUpdateOutput = WorkspaceProjection;
+declare const inputSchema: z.ZodObject<{
+    workspaceId: z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">;
+    name: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        closed: "closed";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const workspaceUpdateCommand: CommandModule<z.infer<typeof inputSchema>, WorkspaceUpdateOutput>;
+export {};
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAOnE,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAkB3C,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;kBAA4B,CAAC;AAErE,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAExD,QAAA,MAAM,WAAW;;;;;;;;kBAmBd,CAAC;AAmBJ,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAChD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,qBAAqB,CAyLtB,CAAC"}

package/dist/commands/workspace/update.js

@@ -0,0 +1,237 @@
+/**
+ * `monday workspace update <wid> [--name <n>] [--kind open|closed]
+ * [--description <d>] [--dry-run]` — change one or more workspace
+ * fields (`cli-design.md` §4.3 line 462, `v0.2-plan.md` §3 M14).
+ *
+ * **Wire shape.** Single round-trip via `update_workspace(id,
+ * attributes: UpdateWorkspaceAttributesInput)`. The SDK marks the
+ * mutation's `id?` argument as optional but it's required in
+ * practice; the CLI takes it as a required positional.
+ * `attributes` is `{name?, kind?, description?}` — only the fields
+ * the agent provided land on the wire (omitting a flag means
+ * "leave unchanged"; partial-input is the SDK's intended shape).
+ *
+ * **Argv discipline.** At least one of `--name` / `--kind` /
+ * `--description` is required — zero-flag invocation surfaces as
+ * `usage_error` (exit 1) at argv-parse, before any network leg.
+ * Mirrors `item update`'s "at least one of --name / --set / --set-
+ * raw required" rule.
+ *
+ * **Dry-run shape** per cli-design §6.4 workspace-update variant:
+ * a field-level diff with `from → to` per provided field. The
+ * `from` state requires a preflight `workspace get` read leg, so
+ * dry-run is two-leg (read + diff-build); `meta.source: 'live'`
+ * because the read fired (workspace metadata isn't cached in v0.2).
+ * When the workspace itself doesn't exist, the preflight surfaces
+ * `not_found` (exit 2) — agents shouldn't have to interpret a
+ * would-fail dry-run shape (mirrors the `item move --to-board`
+ * unmatched-columns rule).
+ *
+ * **Idempotent: yes.** Re-applying the same field values is a no-op
+ * on Monday's side — `update_workspace` writes the new attributes
+ * verbatim. Mark `idempotent: true` so agents can retry on transient
+ * failure without divergence.
+ *
+ * **NOT destructive** (no `--yes` gate per cli-design §3.1 #7 — the
+ * gate is reserved for destructive ops only).
+ */
+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 { ApiError, UsageError } from '../../utils/errors.js';
+import { unwrapOrThrow } from '../../utils/parse-boundary.js';
+import { WORKSPACE_FIELDS_FRAGMENT, workspaceProjectionSchema, } from '../../api/workspace-projection.js';
+const WORKSPACE_UPDATE_PREFLIGHT_QUERY = `
+  query WorkspaceUpdatePreflight($ids: [ID!]) {
+    workspaces(ids: $ids) {
+      ${WORKSPACE_FIELDS_FRAGMENT}
+    }
+  }
+`;
+const UPDATE_WORKSPACE_MUTATION = `
+  mutation WorkspaceUpdate($id: ID!, $attributes: UpdateWorkspaceAttributesInput!) {
+    update_workspace(id: $id, attributes: $attributes) {
+      ${WORKSPACE_FIELDS_FRAGMENT}
+    }
+  }
+`;
+export const workspaceUpdateOutputSchema = workspaceProjectionSchema;
+const inputSchema = z
+    .object({
+    workspaceId: WorkspaceIdSchema,
+    name: z
+        .string()
+        .refine((s) => s.trim().length > 0, {
+        message: '--name must be non-empty (whitespace-only is rejected)',
+    })
+        .optional(),
+    kind: z.enum(['open', 'closed']).optional(),
+    description: z.string().optional(),
+})
+    .strict()
+    .refine((v) => v.name !== undefined || v.kind !== undefined || v.description !== undefined, {
+    message: 'workspace update requires at least one of --name / --kind / --description',
+});
+const preflightResponseSchema = z
+    .object({
+    workspaces: z.array(z.unknown()).nullable().optional(),
+})
+    .loose();
+const liveResponseSchema = z
+    .object({
+    update_workspace: z.unknown(),
+})
+    .loose();
+export const workspaceUpdateCommand = {
+    name: 'workspace.update',
+    summary: 'Update one or more fields of a workspace',
+    examples: [
+        'monday workspace update 12345 --name "Marketing — EU"',
+        'monday workspace update 12345 --kind closed',
+        'monday workspace update 12345 --name "Renamed" --description "Updated"',
+        'monday workspace update 12345 --kind closed --dry-run --json',
+    ],
+    // update_workspace is body-replace per provided field — re-running
+    // with the same values is a server-side no-op. Mark idempotent so
+    // agents can retry on transient failure.
+    idempotent: true,
+    inputSchema,
+    outputSchema: workspaceUpdateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'workspace', 'Workspace commands');
+        noun
+            .command('update <workspaceId>')
+            .description(workspaceUpdateCommand.summary)
+            .option('--name <n>', 'new workspace name')
+            .option('--kind <k>', 'new workspace kind: open|closed')
+            .option('--description <d>', 'new workspace description')
+            .addHelpText('after', ['', 'Examples:', ...workspaceUpdateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (workspaceId, opts) => {
+            const parsed = parseArgv(workspaceUpdateCommand.inputSchema, {
+                workspaceId,
+                ...opts,
+            });
+            // Trim post-parse so the wire call sends the canonical form;
+            // the schema's `.refine()` already rejected whitespace-only
+            // input but didn't strip surrounding whitespace. Description
+            // is intentionally left untrimmed — workspace descriptions
+            // legitimately carry leading whitespace for formatting.
+            const trimmedName = parsed.name?.trim();
+            const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Preflight `workspaces(ids:)` read to surface the `from`
+                // state per provided field. `meta.source: 'live'` — the
+                // read fires; workspace metadata isn't cached in v0.2.
+                const preflight = await client.raw(WORKSPACE_UPDATE_PREFLIGHT_QUERY, { ids: [parsed.workspaceId] }, { operationName: 'WorkspaceUpdatePreflight' });
+                const preflightData = unwrapOrThrow(preflightResponseSchema.safeParse(preflight.data), {
+                    context: 'Monday returned a malformed WorkspaceUpdatePreflight response',
+                    details: { workspace_id: parsed.workspaceId },
+                });
+                const first = (preflightData.workspaces ?? [])[0];
+                if (first === undefined || first === null) {
+                    throw new ApiError('not_found', `Monday returned no workspace for id ${parsed.workspaceId}`, { details: { workspace_id: parsed.workspaceId } });
+                }
+                const current = unwrapOrThrow(workspaceUpdateOutputSchema.safeParse(first), {
+                    context: 'Monday returned a malformed workspace payload (preflight)',
+                    details: { workspace_id: parsed.workspaceId },
+                });
+                const diff = {};
+                if (trimmedName !== undefined) {
+                    diff.name = { from: current.name, to: trimmedName };
+                }
+                if (parsed.kind !== undefined) {
+                    diff.kind = { from: current.kind, to: parsed.kind };
+                }
+                if (parsed.description !== undefined) {
+                    diff.description = {
+                        from: current.description,
+                        to: parsed.description,
+                    };
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'update_workspace',
+                            workspace_id: parsed.workspaceId,
+                            diff,
+                        },
+                    ],
+                    source: 'live',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            // Live path. Build the partial `attributes` payload —
+            // only set keys for fields the agent explicitly provided so
+            // Monday leaves untouched fields alone.
+            const attributes = {};
+            if (trimmedName !== undefined)
+                attributes.name = trimmedName;
+            if (parsed.kind !== undefined)
+                attributes.kind = parsed.kind;
+            if (parsed.description !== undefined) {
+                attributes.description = parsed.description;
+            }
+            // Defensive: the schema's `.refine()` already enforces "at
+            // least one of --name / --kind / --description", but if a
+            // future regression bypassed argv-parse the empty `attributes`
+            // would surface as a Monday-side validation error — surface
+            // it as `usage_error` so the failure mode stays consistent.
+            /* c8 ignore next 6 */
+            if (Object.keys(attributes).length === 0) {
+                throw new UsageError('workspace update requires at least one of --name / --kind / --description', { details: { workspace_id: parsed.workspaceId } });
+            }
+            const response = await client.raw(UPDATE_WORKSPACE_MUTATION, { id: parsed.workspaceId, attributes }, { operationName: 'WorkspaceUpdate' });
+            const data = unwrapOrThrow(liveResponseSchema.safeParse(response.data), {
+                context: 'Monday returned a malformed WorkspaceUpdate 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 missing → not_found). Pre-fix, both landed
+            // as not_found and agents couldn't tell a CLI/API contract
+            // break from a normal resource absence.
+            if (!('update_workspace' in data)) {
+                throw new ApiError('internal_error', `Monday's WorkspaceUpdate response is missing the update_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 = projectUpdatedWorkspace(data.update_workspace, parsed.workspaceId);
+            emitMutation({
+                ctx,
+                data: projected,
+                schema: workspaceUpdateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                ...toEmit(response),
+                source: 'live',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+const projectUpdatedWorkspace = (raw, workspaceId) => {
+    if (raw === null || raw === undefined) {
+        throw new ApiError('not_found', `Monday returned no workspace payload from update_workspace for id ${workspaceId}`, { details: { workspace_id: workspaceId } });
+    }
+    return unwrapOrThrow(workspaceUpdateOutputSchema.safeParse(raw), {
+        context: `Monday returned a malformed workspace payload for id ${workspaceId}`,
+        details: { workspace_id: workspaceId },
+    });
+};
+//# sourceMappingURL=update.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/workspace/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAE1B,MAAM,mCAAmC,CAAC;AAE3C,MAAM,gCAAgC,GAAG;;;QAGjC,yBAAyB;;;CAGhC,CAAC;AAEF,MAAM,yBAAyB,GAAG;;;QAG1B,yBAAyB;;;CAGhC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAyB,CAAC;AAIrE,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,WAAW,EAAE,iBAAiB;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE;QAClC,OAAO,EAAE,wDAAwD;KAClE,CAAC;SACD,QAAQ,EAAE;IACb,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,EAClF;IACE,OAAO,EACL,2EAA2E;CAC9E,CACF,CAAC;AAEJ,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACvD,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;CAC9B,CAAC;KACD,KAAK,EAAE,CAAC;AAOX,MAAM,CAAC,MAAM,sBAAsB,GAG/B;IACF,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,0CAA0C;IACnD,QAAQ,EAAE;QACR,uDAAuD;QACvD,6CAA6C;QAC7C,wEAAwE;QACxE,8DAA8D;KAC/D;IACD,mEAAmE;IACnE,kEAAkE;IAClE,yCAAyC;IACzC,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,2BAA2B;IACzC,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,sBAAsB,CAAC;aAC/B,WAAW,CAAC,sBAAsB,CAAC,OAAO,CAAC;aAC3C,MAAM,CAAC,YAAY,EAAE,oBAAoB,CAAC;aAC1C,MAAM,CAAC,YAAY,EAAE,iCAAiC,CAAC;aACvD,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;aACxD,WAAW,CACV,OAAO,EACP,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1F;aACA,MAAM,CAAC,KAAK,EAAE,WAAoB,EAAE,IAAa,EAAE,EAAE;YACpD,MAAM,MAAM,GAAG,SAAS,CAAC,sBAAsB,CAAC,WAAW,EAAE;gBAC3D,WAAW;gBACX,GAAI,IAA0C;aAC/C,CAAC,CAAC;YACH,6DAA6D;YAC7D,4DAA4D;YAC5D,6DAA6D;YAC7D,2DAA2D;YAC3D,wDAAwD;YACxD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAExC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,aAAa,CAC/D,GAAG,EACH,OAAO,CAAC,IAAI,EAAE,CACf,CAAC;YAEF,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;gBACvB,0DAA0D;gBAC1D,wDAAwD;gBACxD,uDAAuD;gBACvD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,GAAG,CAChC,gCAAgC,EAChC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAC7B,EAAE,aAAa,EAAE,0BAA0B,EAAE,CAC9C,CAAC;gBACF,MAAM,aAAa,GAAG,aAAa,CACjC,uBAAuB,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EACjD;oBACE,OAAO,EACL,+DAA+D;oBACjE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE;iBAC9C,CACF,CAAC;gBACF,MAAM,KAAK,GAAY,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,uCAAuC,MAAM,CAAC,WAAW,EAAE,EAC3D,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAClD,CAAC;gBACJ,CAAC;gBACD,MAAM,OAAO,GAAG,aAAa,CAC3B,2BAA2B,CAAC,SAAS,CAAC,KAAK,CAAC,EAC5C;oBACE,OAAO,EAAE,2DAA2D;oBACpE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE;iBAC9C,CACF,CAAC;gBAEF,MAAM,IAAI,GAA8B,EAAE,CAAC;gBAC3C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;gBACtD,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC9B,IAAI,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;gBACtD,CAAC;gBACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;oBACrC,IAAI,CAAC,WAAW,GAAG;wBACjB,IAAI,EAAE,OAAO,CAAC,WAAW;wBACzB,EAAE,EAAE,MAAM,CAAC,WAAW;qBACvB,CAAC;gBACJ,CAAC;gBAED,UAAU,CAAC;oBACT,GAAG;oBACH,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;oBAC3B,cAAc,EAAE;wBACd;4BACE,SAAS,EAAE,kBAAkB;4BAC7B,YAAY,EAAE,MAAM,CAAC,WAAW;4BAChC,IAAI;yBACL;qBACF;oBACD,MAAM,EAAE,MAAM;oBACd,eAAe,EAAE,IAAI;oBACrB,QAAQ,EAAE,EAAE;oBACZ,UAAU;iBACX,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,sDAAsD;YACtD,4DAA4D;YAC5D,wCAAwC;YACxC,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,IAAI,WAAW,KAAK,SAAS;gBAAE,UAAU,CAAC,IAAI,GAAG,WAAW,CAAC;YAC7D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;gBAAE,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YAC7D,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACrC,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YAC9C,CAAC;YACD,2DAA2D;YAC3D,0DAA0D;YAC1D,+DAA+D;YAC/D,4DAA4D;YAC5D,4DAA4D;YAC5D,sBAAsB;YACtB,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,UAAU,CAClB,2EAA2E,EAC3E,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAClD,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,yBAAyB,EACzB,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,EACtC,EAAE,aAAa,EAAE,iBAAiB,EAAE,CACrC,CAAC;YACF,MAAM,IAAI,GAAG,aAAa,CACxB,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC3C;gBACE,OAAO,EAAE,sDAAsD;gBAC/D,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE;gBAC7C,IAAI,EACF,wDAAwD;oBACxD,yDAAyD;oBACzD,iCAAiC;aACpC,CACF,CAAC;YACF,sDAAsD;YACtD,oDAAoD;YACpD,wDAAwD;YACxD,2DAA2D;YAC3D,wCAAwC;YACxC,IAAI,CAAC,CAAC,kBAAkB,IAAI,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,8EAA8E,EAC9E;oBACE,OAAO,EAAE;wBACP,YAAY,EAAE,MAAM,CAAC,WAAW;wBAChC,IAAI,EACF,oDAAoD;4BACpD,uDAAuD;4BACvD,wDAAwD;qBAC3D;iBACF,CACF,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,uBAAuB,CACvC,IAAI,CAAC,gBAAgB,EACrB,MAAM,CAAC,WAAW,CACnB,CAAC;YAEF,YAAY,CAAC;gBACX,GAAG;gBACH,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,sBAAsB,CAAC,YAAY;gBAC3C,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,QAAQ,EAAE,EAAE;gBACZ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBACnB,MAAM,EAAE,MAAM;gBACd,eAAe,EAAE,IAAI;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAC9B,GAAY,EACZ,WAAmB,EACI,EAAE;IACzB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,qEAAqE,WAAW,EAAE,EAClF,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAClB,2BAA2B,CAAC,SAAS,CAAC,GAAG,CAAC,EAC1C;QACE,OAAO,EAAE,wDAAwD,WAAW,EAAE;QAC9E,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE;KACvC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,33 @@
+export interface Config {
+    readonly apiToken: string;
+    readonly apiVersion: string | undefined;
+    readonly apiUrl: string;
+    readonly requestTimeoutMs: number;
+}
+export interface LoadConfigOptions {
+    /**
+     * Whether to read a `.env` file from `cwd` and merge it into `env` with
+     * existing values winning. Defaults to `true` only when `env` is the
+     * live `process.env`; tests that inject their own env get a clean
+     * read by default.
+     */
+    readonly loadDotenv?: boolean;
+    /** Directory to look for `.env` in. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+}
+/**
+ * Resolves runtime config from environment variables.
+ *
+ * Validation is strict so misconfiguration surfaces at startup, not on
+ * the first GraphQL call. Raw `ZodError`s never escape — they're wrapped
+ * in `ConfigError` (`code: "config_error"`, exit 3 per `cli-design.md`
+ * §3.1 #5) with a structured `details.issues` per zod path. The runner's
+ * catch-all sees a typed CLI error and emits the §6 envelope; without
+ * the wrap, a missing token surfaces as `internal_error` and exit 2.
+ *
+ * `.env` is loaded with `override: false` so explicit shell exports
+ * always win over file defaults — agents pinning a token in their
+ * shell aren't surprised by a stale `.env` next to the repo.
+ */
+export declare const loadConfig: (env?: NodeJS.ProcessEnv, options?: LoadConfigOptions) => Config;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GACrB,MAAK,MAAM,CAAC,UAAwB,EACpC,UAAS,iBAAsB,KAC9B,MAwDF,CAAC"}

package/dist/config/load.js

@@ -0,0 +1,81 @@
+import { config as dotenvConfig } from 'dotenv';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+import { ConfigError } from '../utils/errors.js';
+// Validate the env vars under their actual names so error messages
+// reference what the user can fix (`MONDAY_API_TOKEN`) rather than the
+// internal camelCase property.
+const envSchema = z.object({
+    MONDAY_API_TOKEN: z.string().min(1),
+    MONDAY_API_VERSION: z.string().regex(/^\d{4}-\d{2}$/u).optional(),
+    MONDAY_API_URL: z.url().default('https://api.monday.com/v2'),
+    MONDAY_REQUEST_TIMEOUT_MS: z.coerce.number().int().positive().default(30_000),
+});
+/**
+ * Resolves runtime config from environment variables.
+ *
+ * Validation is strict so misconfiguration surfaces at startup, not on
+ * the first GraphQL call. Raw `ZodError`s never escape — they're wrapped
+ * in `ConfigError` (`code: "config_error"`, exit 3 per `cli-design.md`
+ * §3.1 #5) with a structured `details.issues` per zod path. The runner's
+ * catch-all sees a typed CLI error and emits the §6 envelope; without
+ * the wrap, a missing token surfaces as `internal_error` and exit 2.
+ *
+ * `.env` is loaded with `override: false` so explicit shell exports
+ * always win over file defaults — agents pinning a token in their
+ * shell aren't surprised by a stale `.env` next to the repo.
+ */
+export const loadConfig = (env = process.env, options = {}) => {
+    const { loadDotenv = env === process.env, cwd = process.cwd() } = options;
+    if (loadDotenv) {
+        dotenvConfig({
+            path: resolve(cwd, '.env'),
+            processEnv: env,
+            override: false,
+            quiet: true,
+        });
+    }
+    const result = envSchema.safeParse({
+        MONDAY_API_TOKEN: env.MONDAY_API_TOKEN,
+        MONDAY_API_VERSION: env.MONDAY_API_VERSION,
+        MONDAY_API_URL: env.MONDAY_API_URL,
+        MONDAY_REQUEST_TIMEOUT_MS: env.MONDAY_REQUEST_TIMEOUT_MS,
+    });
+    if (!result.success) {
+        const issues = result.error.issues.map((issue) => ({
+            path: issue.path.join('.'),
+            message: issue.message,
+            code: issue.code,
+        }));
+        const summary = issues
+            .map((i) => (i.path ? `${i.path}: ${i.message}` : i.message))
+            .join('; ');
+        const failedPaths = new Set(issues.map((i) => i.path));
+        // Conditional hint: only point at MONDAY_API_TOKEN when the
+        // missing-token path is what failed. For malformed
+        // version/URL/timeout we name the right env var per-issue
+        // instead of misleading the agent toward an unrelated fix.
+        const details = { issues };
+        if (failedPaths.has('MONDAY_API_TOKEN')) {
+            details.hint = 'set MONDAY_API_TOKEN in your shell or .env';
+        }
+        else if (failedPaths.has('MONDAY_API_VERSION')) {
+            details.hint = 'MONDAY_API_VERSION must match YYYY-MM (e.g. 2026-01)';
+        }
+        else if (failedPaths.has('MONDAY_API_URL')) {
+            details.hint = 'MONDAY_API_URL must be a valid URL';
+        }
+        else if (failedPaths.has('MONDAY_REQUEST_TIMEOUT_MS')) {
+            details.hint = 'MONDAY_REQUEST_TIMEOUT_MS must be a positive integer (ms)';
+        }
+        throw new ConfigError(`invalid Monday CLI config: ${summary}`, { cause: result.error, details });
+    }
+    const parsed = result.data;
+    return {
+        apiToken: parsed.MONDAY_API_TOKEN,
+        apiVersion: parsed.MONDAY_API_VERSION,
+        apiUrl: parsed.MONDAY_API_URL,
+        requestTimeoutMs: parsed.MONDAY_REQUEST_TIMEOUT_MS,
+    };
+};
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { loadConfig } from './config/load.js';
+export type { Config } from './config/load.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}