monday-cli 0.3.0 → 0.5.0

package/dist/commands/update/reply.js

@@ -9,8 +9,10 @@
  * the parent update.
  *
  * **Body sources** (mutually exclusive — same shape as `update
- * create`'s plumbing, lifted into `body-source.ts` per the v0.1-plan
- * §17 R-timing rule when the third consumer arrived):
+ * create`'s plumbing, lifted into the universal `readSourceContent`
+ * helper at `src/utils/source-content.ts` per R-v0.5-NEW-18 at
+ * v0.5-M37 IMPL kickoff; the M13-specific `readUpdateBody` shape
+ * lived at `src/commands/update/body-source.ts` until the lift):
  *   - `--body <md>` — inline markdown.
  *   - `--body-file <path>` — read from disk.
  *   - `--body-file -` — read from stdin.
@@ -27,7 +29,7 @@ import { resolveClient } from '../../api/resolve-client.js';
 import { UpdateIdSchema } from '../../types/ids.js';
 import { parseArgv } from '../parse-argv.js';
 import { unwrapOrThrow } from '../../utils/parse-boundary.js';
-import { readUpdateBody } from './body-source.js';
+import { readSourceContent } from '../../utils/source-content.js';
 import { projectMutationUpdate, UPDATE_FIELDS_FRAGMENT, updateProjectionSchema, } from '../../api/update-mutation-result.js';
 import { assertResponseFieldPresent } from '../../api/response-root.js';
 const CREATE_REPLY_MUTATION = `
@@ -80,10 +82,12 @@ export const updateReplyCommand = {
                 ...opts,
             });
             const { client, globalFlags, apiVersion, toEmit } = resolveClient(ctx, program.opts());
-            const body = await readUpdateBody({
-                inlineBody: parsed.body,
-                bodyFile: globalFlags.bodyFile,
+            const body = await readSourceContent({
+                inline: parsed.body,
+                file: globalFlags.bodyFile,
                 stdin: ctx.stdin,
+                inlineFlagName: '--body',
+                fileFlagName: '--body-file',
                 verbHint: 'monday update reply requires either --body <md> or ' +
                     '--body-file <path>. Use --body-file - to read from stdin.',
             });

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * `monday update upload <uid> <file>` — attach a file to an Update
+ * (comment) via Monday's `add_file_to_update` mutation
+ * (cli-design.md §4.3 + §6.4 asset-upload sub-section + §13 v0.4
+ * entry; v0.4-plan.md §3 M31).
+ *
+ * **Wire shape.** Single multipart/form-data round-trip via
+ * {@link addFileToUpdate} against `mutation AddFileToUpdate` with
+ * `operationName: 'AddFileToUpdate'` (R-NEW-37 W2 audit-point).
+ * Same `MultipartTransport` seam as `item upload`; no column-id
+ * involved (Updates carry attachments via `Update.assets` directly,
+ * not via column values).
+ *
+ * **Argv shape.** Two positional args:
+ *
+ *   - `<uid>` — numeric update ID; brand-validated via
+ *     {@link UpdateIdSchema}.
+ *   - `<file>` — local file path (same constraints as
+ *     `monday item upload`: regular readable file; stdin not
+ *     supported at v0.4-M31).
+ *
+ * **No column-type validation needed.** Updates accept any file
+ * type Monday supports — no column-shape gating like
+ * `item upload`'s `file`-only check. Server-side validation handles
+ * the rest (size cap, filename sanity, virus scan).
+ *
+ * **Local file failures + size handling — same `details.reason`
+ * discrimination as `item upload`.** Three values:
+ *   - `'file_not_readable'` — ENOENT / EACCES / path is a
+ *     directory; fires at IMPL via `fs.stat()` pre-check.
+ *   - `'file_empty'` — zero-byte file; fires via `fs.stat()`.
+ *   - `'file_too_large'` — Monday's server-side size-cap
+ *     rejection rewrap; carries `details.file_size_bytes`
+ *     from the local `fs.stat()` measurement at upload
+ *     time (NOT a Monday error-payload field — Monday's
+ *     wire rejection may not surface a size; the CLI
+ *     threads the locally-measured size into the details
+ *     slot for a stable agent-keyed envelope).
+ * No CLI-side hardcoded size pre-check; Monday's per-file cap
+ * is plan-tier-dependent and not exposed via the schema.
+ *
+ * **`--dry-run` shape** per §6.4 asset-upload variant — emits
+ * `{operation: 'add_file_to_update', update_id, file_path,
+ * filename, file_size_bytes}` with `meta.source: 'none'`. No wire
+ * call fires.
+ *
+ * **Idempotency: NO** — re-running uploads a second copy. Agents
+ * needing register-once dedupe on `Update.assets` reads.
+ *
+ * **Cache invalidation.** N/A — Updates aren't part of the §8
+ * cache scope (board-metadata-only); the upload changes the
+ * Update's asset collection but nothing the cache tracks.
+ *
+ * **Status: runtime body shipped at v0.4-M31 IMPL** — mirrors
+ * `item upload` minus the column-resolution + cache-invalidation
+ * legs (Updates aren't part of the §8 cache scope; no per-column
+ * type check needed because Updates accept any file type Monday
+ * supports).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type UpdateUploadOutput } from '../../api/assets.js';
+declare const inputSchema: z.ZodObject<{
+    updateId: z.core.$ZodBranded<z.ZodString, "UpdateId", "out">;
+    file: z.ZodString;
+}, z.core.$strict>;
+export declare const updateUploadCommand: CommandModule<z.infer<typeof inputSchema>, UpdateUploadOutput>;
+export {};
+//# sourceMappingURL=upload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/commands/update/upload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGnE,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,qBAAqB,CAAC;AAM7B,QAAA,MAAM,WAAW;;;kBAcN,CAAC;AAEZ,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,kBAAkB,CAuLnB,CAAC"}

package/dist/commands/update/upload.js

@@ -0,0 +1,235 @@
+/**
+ * `monday update upload <uid> <file>` — attach a file to an Update
+ * (comment) via Monday's `add_file_to_update` mutation
+ * (cli-design.md §4.3 + §6.4 asset-upload sub-section + §13 v0.4
+ * entry; v0.4-plan.md §3 M31).
+ *
+ * **Wire shape.** Single multipart/form-data round-trip via
+ * {@link addFileToUpdate} against `mutation AddFileToUpdate` with
+ * `operationName: 'AddFileToUpdate'` (R-NEW-37 W2 audit-point).
+ * Same `MultipartTransport` seam as `item upload`; no column-id
+ * involved (Updates carry attachments via `Update.assets` directly,
+ * not via column values).
+ *
+ * **Argv shape.** Two positional args:
+ *
+ *   - `<uid>` — numeric update ID; brand-validated via
+ *     {@link UpdateIdSchema}.
+ *   - `<file>` — local file path (same constraints as
+ *     `monday item upload`: regular readable file; stdin not
+ *     supported at v0.4-M31).
+ *
+ * **No column-type validation needed.** Updates accept any file
+ * type Monday supports — no column-shape gating like
+ * `item upload`'s `file`-only check. Server-side validation handles
+ * the rest (size cap, filename sanity, virus scan).
+ *
+ * **Local file failures + size handling — same `details.reason`
+ * discrimination as `item upload`.** Three values:
+ *   - `'file_not_readable'` — ENOENT / EACCES / path is a
+ *     directory; fires at IMPL via `fs.stat()` pre-check.
+ *   - `'file_empty'` — zero-byte file; fires via `fs.stat()`.
+ *   - `'file_too_large'` — Monday's server-side size-cap
+ *     rejection rewrap; carries `details.file_size_bytes`
+ *     from the local `fs.stat()` measurement at upload
+ *     time (NOT a Monday error-payload field — Monday's
+ *     wire rejection may not surface a size; the CLI
+ *     threads the locally-measured size into the details
+ *     slot for a stable agent-keyed envelope).
+ * No CLI-side hardcoded size pre-check; Monday's per-file cap
+ * is plan-tier-dependent and not exposed via the schema.
+ *
+ * **`--dry-run` shape** per §6.4 asset-upload variant — emits
+ * `{operation: 'add_file_to_update', update_id, file_path,
+ * filename, file_size_bytes}` with `meta.source: 'none'`. No wire
+ * call fires.
+ *
+ * **Idempotency: NO** — re-running uploads a second copy. Agents
+ * needing register-once dedupe on `Update.assets` reads.
+ *
+ * **Cache invalidation.** N/A — Updates aren't part of the §8
+ * cache scope (board-metadata-only); the upload changes the
+ * Update's asset collection but nothing the cache tracks.
+ *
+ * **Status: runtime body shipped at v0.4-M31 IMPL** — mirrors
+ * `item upload` minus the column-resolution + cache-invalidation
+ * legs (Updates aren't part of the §8 cache scope; no per-column
+ * type check needed because Updates accept any file type Monday
+ * supports).
+ */
+import { z } from 'zod';
+import { stat as fsStat, access as fsAccess, readFile } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+import { resolve as resolvePath, basename } from 'node:path';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { UpdateIdSchema } from '../../types/ids.js';
+import { updateUploadOutputSchema, addFileToUpdate, } from '../../api/assets.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { UsageError, asError, errorCode } from '../../utils/errors.js';
+import { sniffContentType } from '../../utils/mime.js';
+import { emitMutation, emitDryRun } from '../emit.js';
+const inputSchema = z
+    .object({
+    updateId: UpdateIdSchema,
+    file: z
+        .string()
+        .min(1, {
+        message: '<file> must be a non-empty local file path; stdin (`-`) is not supported in v0.4-M31 (a future contract extension may add stdin support once a `--filename <name>` companion flag is pinned).',
+    })
+        .refine((p) => p !== '-', {
+        message: '<file> cannot be `-` — stdin upload is not supported in v0.4-M31. Pass a local file path resolved relative to cwd. A future contract extension may add stdin support once a `--filename <name>` companion flag is pinned.',
+    }),
+})
+    .strict();
+export const updateUploadCommand = {
+    name: 'update.upload',
+    summary: 'Attach a file to an Update (comment) via add_file_to_update',
+    examples: [
+        'monday update upload 98765 ./screenshot.png',
+        'monday update upload 98765 ./report.pdf --dry-run',
+    ],
+    idempotent: false,
+    inputSchema,
+    outputSchema: updateUploadOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'update', 'Update (comment) commands (cli-design §4.3 UPDATE)');
+        noun
+            .command('upload <updateId> <file>')
+            .description(updateUploadCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...updateUploadCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Uploads cross the wire as multipart/form-data (different transport from JSON-only verbs).',
+            '  - File path is resolved relative to the cwd; stdin (`-`) is not supported in this release.',
+            '  - Re-running with the same args creates a second Asset; `add_file_to_update` is not idempotent.',
+            '',
+        ].join('\n'))
+            .action(async (updateIdArg, fileArg) => {
+            const parsed = parseArgv(updateUploadCommand.inputSchema, {
+                updateId: updateIdArg,
+                file: fileArg,
+            });
+            // Same fs.stat() + fs.access(R_OK) pre-check shape as
+            // `item upload` (round-1 P2-2 fix). Pre-resolveClient so a
+            // missing/unreadable-file error surfaces as usage_error
+            // (exit 1) before any token check.
+            const filePath = resolvePath(process.cwd(), parsed.file);
+            const filename = basename(filePath);
+            let fileSizeBytes;
+            try {
+                const stats = await fsStat(filePath);
+                if (!stats.isFile()) {
+                    throw new UsageError(`<file> ${JSON.stringify(parsed.file)} is not a regular file ` +
+                        `(resolved to ${JSON.stringify(filePath)}).`, {
+                        details: {
+                            reason: 'file_not_readable',
+                            file_path: filePath,
+                            hint: 'pass a path to a regular readable file; directories ' +
+                                'and special files (sockets, devices) are rejected.',
+                        },
+                    });
+                }
+                await fsAccess(filePath, fsConstants.R_OK);
+                fileSizeBytes = stats.size;
+            }
+            catch (err) {
+                if (err instanceof UsageError) {
+                    throw err;
+                }
+                const code = errorCode(err);
+                throw new UsageError(`<file> ${JSON.stringify(parsed.file)} cannot be read ` +
+                    `(resolved to ${JSON.stringify(filePath)}): ` +
+                    `${asError(err).message}.`, {
+                    cause: err,
+                    details: {
+                        reason: 'file_not_readable',
+                        file_path: filePath,
+                        ...(code === undefined ? {} : { errno_code: code }),
+                        hint: 'check that the path exists, is readable by the current ' +
+                            'user, and isn\'t a directory.',
+                    },
+                });
+            }
+            if (fileSizeBytes === 0) {
+                throw new UsageError(`<file> ${JSON.stringify(parsed.file)} is empty (0 bytes); ` +
+                    `Monday rejects empty uploads server-side.`, {
+                    details: {
+                        reason: 'file_empty',
+                        file_path: filePath,
+                        filename,
+                        file_size_bytes: 0,
+                        hint: 'Monday returns FILE_SIZE_LIMIT_EXCEEDED on empty ' +
+                            'uploads. Provide a non-empty file or remove the upload ' +
+                            'call.',
+                    },
+                });
+            }
+            const { client, globalFlags, apiVersion, multipart, toEmit } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // D5 closure mirror — dry-run is fs.stat()-backed; no
+                // wire mutation; no file bytes loaded. `update upload`
+                // dry-run carries `update_id` instead of `item_id` +
+                // `column_id`; otherwise structurally identical to the
+                // `item upload` dry-run shape. `file_path` is the
+                // argv-derived path per cli-design §6.4 sample (round-2
+                // P3-2 fix; mirrors `item upload`).
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'add_file_to_update',
+                            update_id: parsed.updateId,
+                            file_path: parsed.file,
+                            filename,
+                            file_size_bytes: fileSizeBytes,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    apiVersion,
+                });
+                return;
+            }
+            const bytes = await readFile(filePath);
+            const file = new Blob([bytes], { type: sniffContentType(filename) });
+            const result = await addFileToUpdate({
+                client,
+                multipart,
+                updateId: parsed.updateId,
+                file,
+                filename,
+                signal: ctx.signal,
+                retries: globalFlags.retry,
+            });
+            // No cache invalidation per D6 — Updates aren't part of the
+            // §8 cache scope (which covers board metadata only).
+            const data = {
+                operation: 'add_file_to_update',
+                update_id: parsed.updateId,
+                filename,
+                file_size_bytes: fileSizeBytes,
+                asset: result.asset,
+            };
+            emitMutation({
+                ctx,
+                data,
+                schema: updateUploadCommand.outputSchema,
+                programOpts: program.opts(),
+                ...toEmit({
+                    data: result.asset,
+                    complexity: result.complexity,
+                    stats: { attempts: 1, totalBackoffMs: 0 },
+                }),
+                source: 'live',
+                cacheAgeSeconds: null,
+                complexity: result.complexity,
+            });
+        });
+    },
+};
+//# sourceMappingURL=upload.js.map

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

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

package/dist/commands/user/_team-membership.d.ts

@@ -0,0 +1,10 @@
+import type { TeamMembershipResult, TeamUser } from '../../api/teams.js';
+export interface ProjectMembershipResultsInputs {
+    readonly inputUserIds: readonly string[];
+    readonly failedUsers: readonly TeamUser[];
+    readonly successfulUsers: readonly TeamUser[];
+    readonly operation: 'add_users_to_team' | 'remove_users_from_team';
+    readonly teamId: string;
+}
+export declare const projectMembershipResults: (inputs: ProjectMembershipResultsInputs) => readonly TeamMembershipResult[];
+//# sourceMappingURL=_team-membership.d.ts.map

package/dist/commands/user/_team-membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_team-membership.d.ts","sourceRoot":"","sources":["../../../src/commands/user/_team-membership.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EACV,oBAAoB,EACpB,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,mBAAmB,GAAG,wBAAwB,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgBD,eAAO,MAAM,wBAAwB,GACnC,QAAQ,8BAA8B,KACrC,SAAS,oBAAoB,EA2C/B,CAAC"}

package/dist/commands/user/_team-membership.js

@@ -0,0 +1,88 @@
+/**
+ * Shared partial-success projection helper for the two team-
+ * membership verbs (`monday user team-add-members` +
+ * `monday user team-remove-members`).
+ *
+ * Both verbs receive a wire `ChangeTeamMembershipsResult` shape
+ * (`failed_users: [User!]` + `successful_users: [User!]`) and
+ * must project to the universal §6.1 partial-success envelope's
+ * `results: [{user_id, ok, ...}]` shape with input order
+ * preserved. The two action bodies' projection logic is
+ * byte-identical modulo the `operation` literal — lifting at
+ * IMPL kickoff keeps both call sites at one helper invocation +
+ * pins the input-order + bucket-lookup discipline in one place.
+ *
+ * **Wire-vs-CLI semantics asymmetry.** Monday's `failed_users[]`
+ * carries the User object but no per-user reason on the wire;
+ * the projection emits a generic `membership_failed` error code.
+ * See `teamMembershipResultSchema` JSDoc in `src/api/teams.ts`
+ * for the canonical asymmetry note + `docs/architecture.md`
+ * cross-link (R-NEW-41 4th consumer trigger).
+ *
+ * **Input-order discipline.** Result order mirrors the input
+ * `--users <id,...>` order; for each input user_id the helper
+ * looks up in the failed set first (preserving wire's explicit
+ * failure flag) then the successful map. An input user_id
+ * missing from BOTH buckets surfaces `internal_error` —
+ * Monday's wire is expected to return every input user in one
+ * bucket, and a missing user indicates a wire-shape regression
+ * worth surfacing loudly rather than silently dropping a record.
+ *
+ * **Single-file scope.** The `_` prefix mirrors the M26b
+ * `dev/_shared.ts` cadence — module-private helpers shared
+ * across sibling commands but never exported beyond the
+ * containing namespace.
+ */
+import { ApiError } from '../../utils/errors.js';
+/**
+ * Generic per-user failure message used when Monday's wire
+ * surfaces a user in `failed_users[]` without a per-user reason
+ * (the wire's `ChangeTeamMembershipsResult` carries no error /
+ * reason / message slot — round-2 probe verified 2 fields only).
+ * Surfacing a uniform message keeps agent recovery flows
+ * predictable; agents key off `error.code === 'membership_failed'`
+ * to retry or surface to the user.
+ */
+const FAILED_MEMBERSHIP_MESSAGE = 'Monday rejected this user for team membership change ' +
+    '(no per-user reason on the wire — see `docs/architecture.md` ' +
+    'Wire-vs-CLI semantics documentation conventions).';
+export const projectMembershipResults = (inputs) => {
+    const failedById = new Map();
+    for (const user of inputs.failedUsers) {
+        failedById.set(user.id, user);
+    }
+    const successfulById = new Map();
+    for (const user of inputs.successfulUsers) {
+        successfulById.set(user.id, user);
+    }
+    return inputs.inputUserIds.map((userId) => {
+        if (failedById.has(userId)) {
+            return {
+                user_id: userId,
+                ok: false,
+                error: {
+                    code: 'membership_failed',
+                    message: FAILED_MEMBERSHIP_MESSAGE,
+                },
+            };
+        }
+        const successful = successfulById.get(userId);
+        if (successful !== undefined) {
+            return {
+                user_id: userId,
+                ok: true,
+                user: successful,
+            };
+        }
+        throw new ApiError('internal_error', `Monday's ${inputs.operation} response omitted user ${userId} from both failed_users and successful_users (wire-shape regression).`, {
+            details: {
+                team_id: inputs.teamId,
+                user_id: userId,
+                operation: inputs.operation,
+                hint: 'wire shape regression — re-probe ' +
+                    '`ChangeTeamMembershipsResult` to confirm bucket semantics',
+            },
+        });
+    });
+};
+//# sourceMappingURL=_team-membership.js.map

package/dist/commands/user/_team-membership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_team-membership.js","sourceRoot":"","sources":["../../../src/commands/user/_team-membership.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAcjD;;;;;;;;GAQG;AACH,MAAM,yBAAyB,GAC7B,uDAAuD;IACvD,+DAA+D;IAC/D,mDAAmD,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,MAAsC,EACL,EAAE;IACnC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACtC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAoB,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC1C,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAwB,EAAE;QAC9D,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,yBAAyB;iBACnC;aACF,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,UAAU;aACjB,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,YAAY,MAAM,CAAC,SAAS,0BAA0B,MAAM,uEAAuE,EACnI;YACE,OAAO,EAAE;gBACP,OAAO,EAAE,MAAM,CAAC,MAAM;gBACtB,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,IAAI,EACF,mCAAmC;oBACnC,2DAA2D;aAC9D;SACF,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/commands/user/team-add-members.d.ts

@@ -0,0 +1,81 @@
+/**
+ * `monday user team-add-members <tid> --users <id,...>
+ * [--dry-run]` — add one or more users to a team (`cli-design.md`
+ * §4.3 USER section + §13 v0.5 entry; `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `add_users_to_team(team_id, user_ids)`
+ * round-trip via {@link addUsersToTeam} against `mutation
+ * AddUsersToTeam` with `operationName: 'AddUsersToTeam'`
+ * (R-NEW-37 W2 audit-point). Monday returns
+ * `ChangeTeamMembershipsResult { failed_users: [User!],
+ * successful_users: [User!] }` — a wire-level partial-success
+ * envelope. The action body wraps this into the §6.1
+ * universal partial-success shape `data: { operation:
+ * "add_users_to_team", team_id, results: [{ok, user_id, ...}]
+ * }` at the verb boundary (D5 closure).
+ *
+ * **Argv shape.**
+ *
+ *   - `<teamId>` — positional `TeamId`. Required, brand-
+ *     validated at parse boundary.
+ *   - `--users <id,...>` — required, comma-separated numeric
+ *     user IDs (maps to wire `user_ids: [ID!]!`). Each entry
+ *     brand-validated via {@link UserIdSchema} through the
+ *     lifted {@link parseBrandedListArg} helper (R-NEW-70
+ *     consumer #3 post-lift).
+ *
+ * **Output envelope.** Per cli-design §6.1 universal partial-
+ * success shape — emits one `ok: true` envelope with
+ * `data: { operation: "add_users_to_team", team_id, results:
+ * [{user_id, ok, user?, error?}] }`. The wire's
+ * `failed_users[]` projects to `{ok: false, user_id, error:
+ * {code: "membership_failed", message: <generic>}}` records;
+ * the wire's `successful_users[]` projects to `{ok: true,
+ * user_id, user: {id, name, email}}` records. Result order
+ * mirrors the input `--users <id,...>` order (input ID echoed
+ * into `user_id` for correlation; wire User object hydrated
+ * into `user` slot when successful).
+ *
+ * **Wire-vs-CLI semantics asymmetry.** See
+ * `teamMembershipResultSchema` JSDoc in `src/api/teams.ts` for
+ * the canonical note + cross-link to `docs/architecture.md`'s
+ * "Wire-vs-CLI semantics documentation conventions" section
+ * (R-NEW-41 4th consumer trigger).
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run
+ * variant. SINGLE planned operation entry `{operation:
+ * 'add_users_to_team', team_id, user_ids: [...]}` with
+ * `user_ids` echoing the input argv order — Monday's wire
+ * is a single-shot bulk call (`add_users_to_team(team_id,
+ * user_ids: [ID!]!)`), NOT a per-user fan-out like
+ * `monday workspace add-users` (which dispatches sequentially
+ * one wire call per user). No preflight read fires; argv-
+ * derived. `meta.source: 'none'`.
+ *
+ * **Idempotent: yes** — Monday is no-op on a re-add (the
+ * user already being in the team surfaces as `successful_
+ * users[]` regardless). Same idempotency story as
+ * `workspace add-users`.
+ *
+ * **Admin-permission-sensitive.** Non-admin callers surface
+ * `forbidden` (mapped from Monday's PERMISSION_DENIED
+ * extension).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** Argv + `--users`
+ * parse run BEFORE `resolveClient` (usage-error-before-config-
+ * error precedence). Dry-run path emits the minimal planned
+ * shape; live path dispatches {@link addUsersToTeam} and
+ * projects `failed_users[]` / `successful_users[]` into the
+ * universal §6.1 partial-success envelope via
+ * {@link projectMembershipResults} (input order preserved).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type TeamAddMembersOutput } from '../../api/teams.js';
+declare const inputSchema: z.ZodObject<{
+    teamId: z.core.$ZodBranded<z.ZodString, "TeamId", "out">;
+    users: z.ZodString;
+}, z.core.$strict>;
+export declare const teamAddMembersCommand: CommandModule<z.infer<typeof inputSchema>, TeamAddMembersOutput>;
+export {};
+//# sourceMappingURL=team-add-members.d.ts.map

package/dist/commands/user/team-add-members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-add-members.d.ts","sourceRoot":"","sources":["../../../src/commands/user/team-add-members.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAG5B,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAEZ,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,oBAAoB,CAiHrB,CAAC"}