monday-cli 0.4.0 → 0.5.0

package/dist/commands/user/team-delete.js

@@ -0,0 +1,137 @@
+/**
+ * `monday user team-delete <tid> --yes [--dry-run]` — delete
+ * an existing team (`cli-design.md` §4.3 USER section + §13
+ * v0.5 entry; `v0.5-plan.md` §3 M34).
+ *
+ * **Confirmation gate** (cli-design §3.1 #7 + §10.2 + M10
+ * round-1 P2 invariant). `--yes` is mandatory for the live
+ * path; without `--yes` (and without `--dry-run`) the command
+ * fails fast with `confirmation_required` (exit 1) carrying
+ * `details.team_id`. The gate fires BEFORE `resolveClient()`
+ * so a missing token doesn't mask `confirmation_required` as
+ * `config_error` (same shape — and same gate-before-resolve
+ * ordering — as M14 `workspace delete` / M10 `item delete` /
+ * `update delete`).
+ *
+ * **Wire shape.** Single round-trip via `delete_team(team_id:
+ * <tid>)` against `mutation DeleteTeam` with `operationName:
+ * 'DeleteTeam'` (R-NEW-37 W2 audit-point). Monday returns the
+ * deleted `Team` so the envelope's `data` is the full
+ * projection — agents see the final state (name + member
+ * list) at the moment of deletion. A null `delete_team`
+ * payload surfaces `not_found` — same convention as M14
+ * `workspace delete` ("id was bogus / already deleted by a
+ * concurrent caller").
+ *
+ * **Admin-permission-sensitive.** Non-admin callers surface
+ * `forbidden` (mapped from Monday's PERMISSION_DENIED
+ * extension).
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run
+ * variant: minimal `{operation: "delete_team", team_id}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors `workspace delete` —
+ * destructive-no-read pattern is uniform across `item delete`
+ * / `update delete` / `workspace delete` / `team delete`.
+ *
+ * **Idempotent: false.** Re-running surfaces `not_found` past
+ * the first call. Same rationale as `workspace delete` —
+ * agents can't safely retry without verifying the id still
+ * names the same record.
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** Destructive gate
+ * fires BEFORE `resolveClient` (M10 round-1 P2 invariant);
+ * dry-run path emits minimal `{operation, team_id}` (no wire
+ * call); live path dispatches {@link deleteTeam} + projects via
+ * `emitMutation`.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { parseGlobalFlags } from '../../types/global-flags.js';
+import { enforceDestructiveGate } from '../../api/destructive-gate.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { TeamIdSchema } from '../../types/ids.js';
+import { deleteTeam, teamDeleteOutputSchema, } from '../../api/teams.js';
+const inputSchema = z.object({ teamId: TeamIdSchema }).strict();
+export const teamDeleteCommand = {
+    name: 'user.team-delete',
+    summary: 'Delete a team — --yes required',
+    examples: [
+        'monday user team-delete 12345 --yes',
+        'monday user team-delete 12345 --dry-run',
+        'monday user team-delete 12345 --yes --json',
+    ],
+    // Re-deleting an already-deleted team surfaces `not_found`;
+    // re-running with the same `<tid>` after an interim
+    // `team-create` would target a different record (Monday
+    // mints new TeamIds on create). Mark non-idempotent.
+    idempotent: false,
+    inputSchema,
+    outputSchema: teamDeleteOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'user', 'User commands');
+        noun
+            .command('team-delete <teamId>')
+            .description(teamDeleteCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...teamDeleteCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action(async (teamId) => {
+            const parsed = parseArgv(teamDeleteCommand.inputSchema, { teamId });
+            // Gate BEFORE `resolveClient()` — M10 round-1 P2 invariant.
+            // 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.
+            const preGateGlobalFlags = parseGlobalFlags(program.opts(), ctx.env);
+            enforceDestructiveGate({
+                globalFlags: preGateGlobalFlags,
+                verb: 'user team-delete',
+                target: parsed.teamId,
+                detailKey: 'team_id',
+                action: 'delete the team',
+                hint: 'delete is destructive — Monday\'s wire surface offers no ' +
+                    'restore mutation for teams; agents needing reversal must ' +
+                    'recreate via `monday user team-create` (lossy: new id, ' +
+                    'membership must be re-added).',
+            });
+            if (preGateGlobalFlags.dryRun) {
+                // Minimal dry-run shape — no preflight read fires. Per
+                // cli-design §6.4 mutation-dry-run variant: `operation:
+                // "delete_team"`, `team_id`, nothing else. `meta.source:
+                // 'none'` because no API call fires; live surfaces
+                // `not_found` for missing ids on its own. Mirrors
+                // workspace-delete cadence.
+                const { apiVersion } = resolveClient(ctx, program.opts());
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'delete_team',
+                            team_id: parsed.teamId,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await deleteTeam({ client, teamId: parsed.teamId });
+            emitMutation({
+                ctx,
+                data: result.team,
+                schema: teamDeleteCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=team-delete.js.map

package/dist/commands/user/team-delete.js.map

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

package/dist/commands/user/team-get.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `monday user team-get <tid>` — read a single team by ID
+ * (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `Query.teams(ids: [<tid>])` round-trip
+ * via {@link getTeam} against `query GetTeam` with
+ * `operationName: 'GetTeam'` (R-NEW-37 W2 audit-point). Monday
+ * returns `[Team]` (an array even for a single-id query); the
+ * fetcher extracts index 0. Empty array → `not_found` with
+ * `details.team_id` (Monday's wire surface collapses
+ * "doesn't exist" + "exists but inaccessible to token" into
+ * the same shape; the CLI can't distinguish them — same
+ * convention as M32 doc-get D8).
+ *
+ * **Output envelope.** Direct unwrap of the Team — `data:
+ * <Team with users + owners hydrated>`. Mirrors read-one-verb
+ * convention (`monday board get <bid>` returns `data: <Board>`,
+ * `monday user get <uid>` returns `data: <User>`). The Team's
+ * own `id` field is the echoed input; no separate `team_id`
+ * slot needed.
+ *
+ * **Teams are live-only at v0.5-M34** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_
+ * seconds: null`.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** A thin wrapper
+ * around {@link getTeam} — branded `<teamId>` → fetcher →
+ * direct-unwrap envelope.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type TeamGetOutput } from '../../api/teams.js';
+declare const inputSchema: z.ZodObject<{
+    teamId: z.core.$ZodBranded<z.ZodString, "TeamId", "out">;
+}, z.core.$strict>;
+export declare const teamGetCommand: CommandModule<z.infer<typeof inputSchema>, TeamGetOutput>;
+export {};
+//# sourceMappingURL=team-get.d.ts.map

package/dist/commands/user/team-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-get.d.ts","sourceRoot":"","sources":["../../../src/commands/user/team-get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,QAAA,MAAM,WAAW;;kBAA8C,CAAC;AAEhE,eAAO,MAAM,cAAc,EAAE,aAAa,CACxC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,aAAa,CAkDd,CAAC"}

package/dist/commands/user/team-get.js

@@ -0,0 +1,87 @@
+/**
+ * `monday user team-get <tid>` — read a single team by ID
+ * (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `Query.teams(ids: [<tid>])` round-trip
+ * via {@link getTeam} against `query GetTeam` with
+ * `operationName: 'GetTeam'` (R-NEW-37 W2 audit-point). Monday
+ * returns `[Team]` (an array even for a single-id query); the
+ * fetcher extracts index 0. Empty array → `not_found` with
+ * `details.team_id` (Monday's wire surface collapses
+ * "doesn't exist" + "exists but inaccessible to token" into
+ * the same shape; the CLI can't distinguish them — same
+ * convention as M32 doc-get D8).
+ *
+ * **Output envelope.** Direct unwrap of the Team — `data:
+ * <Team with users + owners hydrated>`. Mirrors read-one-verb
+ * convention (`monday board get <bid>` returns `data: <Board>`,
+ * `monday user get <uid>` returns `data: <User>`). The Team's
+ * own `id` field is the echoed input; no separate `team_id`
+ * slot needed.
+ *
+ * **Teams are live-only at v0.5-M34** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_
+ * seconds: null`.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** A thin wrapper
+ * around {@link getTeam} — branded `<teamId>` → fetcher →
+ * direct-unwrap envelope.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { TeamIdSchema } from '../../types/ids.js';
+import { getTeam, teamGetOutputSchema, } from '../../api/teams.js';
+const inputSchema = z.object({ teamId: TeamIdSchema }).strict();
+export const teamGetCommand = {
+    name: 'user.team-get',
+    summary: 'Read a single team by ID (includes member + owner lists)',
+    examples: [
+        'monday user team-get 12345',
+        'monday user team-get 12345 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: teamGetOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'user', 'User commands');
+        noun
+            .command('team-get <teamId>')
+            .description(teamGetCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...teamGetCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Output carries the full Team plus `users: [User]` (members) + `owners: [User]` (managers).',
+            '  - Non-existent + inaccessible teams both surface `not_found` (Monday\'s wire collapses both cases).',
+            '',
+        ].join('\n'))
+            .action(async (teamIdArg) => {
+            const parsed = parseArgv(teamGetCommand.inputSchema, {
+                teamId: teamIdArg,
+            });
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await getTeam({ client, teamId: parsed.teamId });
+            emitSuccess({
+                ctx,
+                data: result.team,
+                schema: teamGetCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'single',
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=team-get.js.map

package/dist/commands/user/team-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-get.js","sourceRoot":"","sources":["../../../src/commands/user/team-get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,OAAO,EACP,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GAGvB;IACF,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,0DAA0D;IACnE,QAAQ,EAAE;QACR,4BAA4B;QAC5B,mCAAmC;KACpC;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,mBAAmB;IACjC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QAChE,IAAI;aACD,OAAO,CAAC,mBAAmB,CAAC;aAC5B,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC;aACnC,WAAW,CACV,OAAO,EACP;YACE,EAAE;YACF,WAAW;YACX,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,EAAE;YACF,QAAQ;YACR,gGAAgG;YAChG,uGAAuG;YACvG,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACA,MAAM,CAAC,KAAK,EAAE,SAAkB,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,WAAW,EAAE;gBACnD,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;YAEH,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAChE,WAAW,CAAC;gBACV,GAAG;gBACH,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,cAAc,CAAC,YAAY;gBACnC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU;aACX,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

package/dist/commands/user/team-list.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `monday user team-list` — list every team visible to the
+ * token (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `Query.teams` round-trip via
+ * {@link listTeams} against `query ListTeams` with
+ * `operationName: 'ListTeams'` (R-NEW-37 W2 audit-point). No
+ * pagination — Monday's `Query.teams` surface has neither
+ * `limit:` / `page:` nor cursor (D6 closure); returns every
+ * visible team in one shot. Account-size cap on team count is
+ * the only natural limit.
+ *
+ * **Argv shape.** No flags — `team-list` is argv-empty.
+ *
+ * **Output envelope.** Wrapped record `data: { teams:
+ * [Team], returned_count }` mirroring M22 `monday usage` +
+ * M32 `doc list` wrapped-record cadence. No `has_more` /
+ * cursor slot (D6 — wire has no pagination).
+ *
+ * **Teams are live-only at v0.5-M34** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_
+ * seconds: null`. Team membership churns frequently; the
+ * stale-cache risk outweighs the cache-hit value.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** A single wire
+ * round-trip via {@link listTeams} populates the wrapped
+ * record envelope; `returned_count` is the cached
+ * `teams.length` for agent ergonomics.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type TeamListOutput } from '../../api/teams.js';
+declare const inputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const teamListCommand: CommandModule<z.infer<typeof inputSchema>, TeamListOutput>;
+export {};
+//# sourceMappingURL=team-list.d.ts.map

package/dist/commands/user/team-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-list.d.ts","sourceRoot":"","sources":["../../../src/commands/user/team-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAE5B,QAAA,MAAM,WAAW,iCAAwB,CAAC;AAE1C,eAAO,MAAM,eAAe,EAAE,aAAa,CACzC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,cAAc,CAsDf,CAAC"}

package/dist/commands/user/team-list.js

@@ -0,0 +1,90 @@
+/**
+ * `monday user team-list` — list every team visible to the
+ * token (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `Query.teams` round-trip via
+ * {@link listTeams} against `query ListTeams` with
+ * `operationName: 'ListTeams'` (R-NEW-37 W2 audit-point). No
+ * pagination — Monday's `Query.teams` surface has neither
+ * `limit:` / `page:` nor cursor (D6 closure); returns every
+ * visible team in one shot. Account-size cap on team count is
+ * the only natural limit.
+ *
+ * **Argv shape.** No flags — `team-list` is argv-empty.
+ *
+ * **Output envelope.** Wrapped record `data: { teams:
+ * [Team], returned_count }` mirroring M22 `monday usage` +
+ * M32 `doc list` wrapped-record cadence. No `has_more` /
+ * cursor slot (D6 — wire has no pagination).
+ *
+ * **Teams are live-only at v0.5-M34** per cli-design §8 cache
+ * scope. Output `meta.source: "live"`, `meta.cache_age_
+ * seconds: null`. Team membership churns frequently; the
+ * stale-cache risk outweighs the cache-hit value.
+ *
+ * **Idempotent: yes** (pure read).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** A single wire
+ * round-trip via {@link listTeams} populates the wrapped
+ * record envelope; `returned_count` is the cached
+ * `teams.length` for agent ergonomics.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { listTeams, teamListOutputSchema, } from '../../api/teams.js';
+const inputSchema = z.object({}).strict();
+export const teamListCommand = {
+    name: 'user.team-list',
+    summary: 'List every team visible to the token (no pagination on Monday\'s wire)',
+    examples: [
+        'monday user team-list',
+        'monday user team-list --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: teamListOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'user', 'User commands');
+        noun
+            .command('team-list')
+            .description(teamListCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...teamListCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Monday\'s `Query.teams` exposes no pagination — every visible team returns in one call.',
+            '  - Each team carries `users` (members) + `owners` (managers) lists slim-projected to {id, name, email}.',
+            '',
+        ].join('\n'))
+            .action(async (opts) => {
+            // Argv is empty for team-list; parseArgv still fires to
+            // verify "no unknown flags" at the parse boundary.
+            parseArgv(teamListCommand.inputSchema, opts ?? {});
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await listTeams({ client });
+            const returnedCount = result.teams.length;
+            emitSuccess({
+                ctx,
+                data: {
+                    teams: [...result.teams],
+                    returned_count: returnedCount,
+                },
+                schema: teamListCommand.outputSchema,
+                programOpts: program.opts(),
+                kind: 'single',
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=team-list.js.map

package/dist/commands/user/team-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-list.js","sourceRoot":"","sources":["../../../src/commands/user/team-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,SAAS,EACT,oBAAoB,GAErB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE1C,MAAM,CAAC,MAAM,eAAe,GAGxB;IACF,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,wEAAwE;IACjF,QAAQ,EAAE;QACR,uBAAuB;QACvB,8BAA8B;KAC/B;IACD,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,oBAAoB;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QAChE,IAAI;aACD,OAAO,CAAC,WAAW,CAAC;aACpB,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC;aACpC,WAAW,CACV,OAAO,EACP;YACE,EAAE;YACF,WAAW;YACX,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,EAAE;YACF,QAAQ;YACR,6FAA6F;YAC7F,0GAA0G;YAC1G,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACA,MAAM,CAAC,KAAK,EAAE,IAAa,EAAE,EAAE;YAC9B,wDAAwD;YACxD,mDAAmD;YACnD,SAAS,CAAC,eAAe,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAEnD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3C,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1C,WAAW,CAAC;gBACV,GAAG;gBACH,IAAI,EAAE;oBACJ,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;oBACxB,cAAc,EAAE,aAAa;iBAC9B;gBACD,MAAM,EAAE,eAAe,CAAC,YAAY;gBACpC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU;aACX,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,71 @@
+/**
+ * `monday user team-remove-members <tid> --users <id,...>
+ * [--dry-run]` — remove one or more users from a team
+ * (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `remove_users_from_team(team_id,
+ * user_ids)` round-trip via {@link removeUsersFromTeam}
+ * against `mutation RemoveUsersFromTeam` with `operationName:
+ * 'RemoveUsersFromTeam'` (R-NEW-37 W2 audit-point). Monday
+ * returns `ChangeTeamMembershipsResult { failed_users:
+ * [User!], successful_users: [User!] }` — same wire-level
+ * partial-success envelope as add-members. The action body
+ * wraps this into the §6.1 universal partial-success shape
+ * `data: { operation: "remove_users_from_team", team_id,
+ * results: [{ok, user_id, ...}] }` (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 #4 post-lift).
+ *
+ * **Output envelope.** Same shape as
+ * {@link teamAddMembersCommand} but with `operation:
+ * 'remove_users_from_team'` so agents that key off the
+ * operation literal can dispatch the right post-mutation
+ * recovery flow.
+ *
+ * **Wire-vs-CLI semantics asymmetry.** Same generic-
+ * `membership_failed`-code asymmetry as team-add-members; 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.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run
+ * variant. SINGLE planned operation entry `{operation:
+ * 'remove_users_from_team', team_id, user_ids: [...]}` with
+ * `user_ids` echoing the input argv order — Monday's wire is
+ * a single-shot bulk call (`remove_users_from_team(team_id,
+ * user_ids: [ID!]!)`), NOT a per-user fan-out like
+ * `monday workspace remove-users`. No preflight read fires;
+ * argv-derived. `meta.source: 'none'`.
+ *
+ * **Idempotent: yes** — Monday is no-op on a re-remove (the
+ * user already being out of the team surfaces in
+ * `successful_users[]` per Monday's wire convention).
+ *
+ * **Admin-permission-sensitive.** Non-admin callers surface
+ * `forbidden`.
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** Mirrors the
+ * `team-add-members` cadence verbatim modulo the `operation`
+ * literal — argv + `--users` parse → resolveClient → dry-run
+ * or live dispatch via {@link removeUsersFromTeam} → shared
+ * {@link projectMembershipResults} → `emitMutation`.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type TeamRemoveMembersOutput } 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 teamRemoveMembersCommand: CommandModule<z.infer<typeof inputSchema>, TeamRemoveMembersOutput>;
+export {};
+//# sourceMappingURL=team-remove-members.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-remove-members.d.ts","sourceRoot":"","sources":["../../../src/commands/user/team-remove-members.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAG5B,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAEZ,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAClD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,uBAAuB,CAiHxB,CAAC"}