monday-cli 0.4.0 → 0.5.0

package/dist/commands/user/team-add-members.js

@@ -0,0 +1,186 @@
+/**
+ * `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 { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { TeamIdSchema, UserIdSchema } from '../../types/ids.js';
+import { parseBrandedListArg } from '../../utils/parse-brand-list.js';
+import { addUsersToTeam, teamAddMembersOutputSchema, } from '../../api/teams.js';
+import { projectMembershipResults } from './_team-membership.js';
+const inputSchema = z
+    .object({
+    teamId: TeamIdSchema,
+    users: z.string().min(1, '--users must not be empty'),
+})
+    .strict();
+export const teamAddMembersCommand = {
+    name: 'user.team-add-members',
+    summary: 'Add users to a team (partial-success envelope)',
+    examples: [
+        'monday user team-add-members 12345 --users 67890',
+        'monday user team-add-members 12345 --users 67890,67891',
+        'monday user team-add-members 12345 --users 67890 --dry-run --json',
+    ],
+    // Re-adding an existing team member is a no-op on Monday's
+    // wire (the user surfaces as `successful_users[]`); mark
+    // idempotent so agents can retry on transient failure.
+    idempotent: true,
+    inputSchema,
+    outputSchema: teamAddMembersOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'user', 'User commands');
+        noun
+            .command('team-add-members <teamId>')
+            .description(teamAddMembersCommand.summary)
+            .requiredOption('--users <list>', 'Comma-separated numeric user IDs to add (maps to wire `user_ids: [ID!]!`).')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...teamAddMembersCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Envelope is per-cli-design §6.1 partial-success (`results: [{user_id, ok, ...}]`).',
+            '  - Re-adding an existing member is a no-op (surfaces as `successful_users[]`).',
+            '',
+        ].join('\n'))
+            .action(async (teamIdArg, opts) => {
+            const parsed = parseArgv(teamAddMembersCommand.inputSchema, {
+                teamId: teamIdArg,
+                ...opts,
+            });
+            // Parse `--users` once at the boundary so a malformed
+            // user ID surfaces `usage_error` ahead of any wire call.
+            // Lifted helper at R-NEW-70 (consumer #3 post-lift).
+            const userIds = parseBrandedListArg(parsed.users, UserIdSchema, {
+                flagName: '--users',
+                entryDescription: 'numeric user ID',
+                hint: 'user IDs are numeric (e.g. 67890)',
+                emptyEntryHint: 'e.g. --users 67890,67891 — no leading, trailing, or ' +
+                    'duplicate commas',
+            });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Minimal dry-run shape per cli-design §6.4 — single
+                // planned operation echoing what the live wire call
+                // would send. No preflight read fires; `meta.source:
+                // 'none'`.
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'add_users_to_team',
+                            team_id: parsed.teamId,
+                            user_ids: [...userIds],
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const result = await addUsersToTeam({
+                client,
+                teamId: parsed.teamId,
+                userIds,
+            });
+            const results = projectMembershipResults({
+                inputUserIds: userIds,
+                failedUsers: result.failedUsers,
+                successfulUsers: result.successfulUsers,
+                operation: 'add_users_to_team',
+                teamId: parsed.teamId,
+            });
+            const data = {
+                operation: 'add_users_to_team',
+                team_id: parsed.teamId,
+                results: [...results],
+            };
+            emitMutation({
+                ctx,
+                data,
+                schema: teamAddMembersCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=team-add-members.js.map

package/dist/commands/user/team-add-members.js.map

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

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

@@ -0,0 +1,82 @@
+/**
+ * `monday user team-create --name <n> [--users <id,...>]
+ * [--guest-team] [--allow-empty] [--dry-run]` — create a new
+ * team (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `create_team(input, options)` round-
+ * trip via {@link createTeam} against `mutation CreateTeam`
+ * with `operationName: 'CreateTeam'` (R-NEW-37 W2 audit-point).
+ * Returns the created `Team` with `id` populated post-create
+ * + any `--users <id,...>` hydrated into the `users` slot.
+ *
+ * **Argv shape.**
+ *
+ *   - `--name <n>` — required (Monday's `CreateTeamAttributes
+ *     Input.name` is `String!`). Empty string rejects at the
+ *     parse boundary.
+ *   - `--users <id,...>` — optional, comma-separated numeric
+ *     user IDs (maps to wire `subscriber_ids: [ID!]`). Each
+ *     entry brand-validated via {@link UserIdSchema} through
+ *     the lifted {@link parseBrandedListArg} helper (R-NEW-70
+ *     consumer #2 post-lift). Wire description: "Must not be
+ *     empty, unless allow_empty_team is set"; the CLI
+ *     surface forwards a non-empty list when supplied, OR
+ *     omits the variable entirely when `--users` is absent.
+ *   - `--guest-team` — optional boolean (maps to wire
+ *     `is_guest_team: Boolean`). Absent → omitted (Monday's
+ *     server-side default applies).
+ *   - `--allow-empty` — optional boolean (maps to wire
+ *     `options.allow_empty_team: Boolean`). Absent → omitted.
+ *
+ * **Out-of-scope flags carried forward from probe findings:**
+ *
+ *   - `--parent <ptid>` (wire slot exists via
+ *     `CreateTeamAttributesInput.parent_team_id`) — D3
+ *     deferral; agent-UX hierarchical-team semantics
+ *     unclear today. Flag deferred to v0.5.x.
+ *   - `--description` (no wire-side persistence; `Team`
+ *     object carries no `description` field) — D1 closure;
+ *     dropped from v0.4 cli-design row.
+ *
+ * **Output envelope.** Direct unwrap of the created Team —
+ * `data: <Team>`. Mirrors M14 `workspace create` cadence.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant.
+ * Minimal envelope listing the planned `create_team` operation
+ * + the resolved input fields (`name`, optional `is_guest_team`,
+ * optional `subscriber_ids`, optional `allow_empty_team`). No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors M14 `workspace create` cadence —
+ * the create-no-read pattern is uniform across non-destructive
+ * write verbs (`workspace create` / `board create` / now
+ * `user team-create`).
+ *
+ * **Idempotent: false.** Re-running `team-create --name foo`
+ * creates a SECOND team with the same name (Monday allows
+ * duplicate team names). Agents that need idempotency must
+ * pair with a `team-list` lookup first.
+ *
+ * **Admin-permission-sensitive.** Non-admin tokens surface
+ * `forbidden` (mapped from Monday's PERMISSION_DENIED
+ * extension).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** Argv parsing +
+ * `--users` comma-split run BEFORE `resolveClient` so a
+ * malformed `--users` surfaces `usage_error` ahead of any
+ * missing-token `config_error`. Dry-run path emits minimal
+ * planned changes (no wire call fires); live path dispatches
+ * {@link createTeam} + projects via `emitMutation`.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type TeamCreateOutput } from '../../api/teams.js';
+declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    users: z.ZodOptional<z.ZodString>;
+    guestTeam: z.ZodOptional<z.ZodBoolean>;
+    allowEmpty: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const teamCreateCommand: CommandModule<z.infer<typeof inputSchema>, TeamCreateOutput>;
+export {};
+//# sourceMappingURL=team-create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-create.d.ts","sourceRoot":"","sources":["../../../src/commands/user/team-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,QAAA,MAAM,WAAW;;;;;kBAeN,CAAC;AAEZ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAiIjB,CAAC"}

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

@@ -0,0 +1,206 @@
+/**
+ * `monday user team-create --name <n> [--users <id,...>]
+ * [--guest-team] [--allow-empty] [--dry-run]` — create a new
+ * team (`cli-design.md` §4.3 USER section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M34).
+ *
+ * **Wire shape.** Single `create_team(input, options)` round-
+ * trip via {@link createTeam} against `mutation CreateTeam`
+ * with `operationName: 'CreateTeam'` (R-NEW-37 W2 audit-point).
+ * Returns the created `Team` with `id` populated post-create
+ * + any `--users <id,...>` hydrated into the `users` slot.
+ *
+ * **Argv shape.**
+ *
+ *   - `--name <n>` — required (Monday's `CreateTeamAttributes
+ *     Input.name` is `String!`). Empty string rejects at the
+ *     parse boundary.
+ *   - `--users <id,...>` — optional, comma-separated numeric
+ *     user IDs (maps to wire `subscriber_ids: [ID!]`). Each
+ *     entry brand-validated via {@link UserIdSchema} through
+ *     the lifted {@link parseBrandedListArg} helper (R-NEW-70
+ *     consumer #2 post-lift). Wire description: "Must not be
+ *     empty, unless allow_empty_team is set"; the CLI
+ *     surface forwards a non-empty list when supplied, OR
+ *     omits the variable entirely when `--users` is absent.
+ *   - `--guest-team` — optional boolean (maps to wire
+ *     `is_guest_team: Boolean`). Absent → omitted (Monday's
+ *     server-side default applies).
+ *   - `--allow-empty` — optional boolean (maps to wire
+ *     `options.allow_empty_team: Boolean`). Absent → omitted.
+ *
+ * **Out-of-scope flags carried forward from probe findings:**
+ *
+ *   - `--parent <ptid>` (wire slot exists via
+ *     `CreateTeamAttributesInput.parent_team_id`) — D3
+ *     deferral; agent-UX hierarchical-team semantics
+ *     unclear today. Flag deferred to v0.5.x.
+ *   - `--description` (no wire-side persistence; `Team`
+ *     object carries no `description` field) — D1 closure;
+ *     dropped from v0.4 cli-design row.
+ *
+ * **Output envelope.** Direct unwrap of the created Team —
+ * `data: <Team>`. Mirrors M14 `workspace create` cadence.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant.
+ * Minimal envelope listing the planned `create_team` operation
+ * + the resolved input fields (`name`, optional `is_guest_team`,
+ * optional `subscriber_ids`, optional `allow_empty_team`). No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors M14 `workspace create` cadence —
+ * the create-no-read pattern is uniform across non-destructive
+ * write verbs (`workspace create` / `board create` / now
+ * `user team-create`).
+ *
+ * **Idempotent: false.** Re-running `team-create --name foo`
+ * creates a SECOND team with the same name (Monday allows
+ * duplicate team names). Agents that need idempotency must
+ * pair with a `team-list` lookup first.
+ *
+ * **Admin-permission-sensitive.** Non-admin tokens surface
+ * `forbidden` (mapped from Monday's PERMISSION_DENIED
+ * extension).
+ *
+ * **Runtime body landed at v0.5-M34 IMPL.** Argv parsing +
+ * `--users` comma-split run BEFORE `resolveClient` so a
+ * malformed `--users` surfaces `usage_error` ahead of any
+ * missing-token `config_error`. Dry-run path emits minimal
+ * planned changes (no wire call fires); live path dispatches
+ * {@link createTeam} + projects via `emitMutation`.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { UserIdSchema } from '../../types/ids.js';
+import { parseBrandedListArg } from '../../utils/parse-brand-list.js';
+import { createTeam, teamCreateOutputSchema, } from '../../api/teams.js';
+const inputSchema = z
+    .object({
+    name: z.string().min(1, '--name must not be empty'),
+    /**
+     * Raw comma-separated user IDs (e.g. `"67890,67891"`). Split
+     * + brand-validated inside the action body via
+     * {@link parseBrandedListArg} so the per-entry parse boundary
+     * fires AFTER the top-level argv parse — keeps the error
+     * envelope's `details.issues[].path` pointing at the
+     * `--users` argv slot rather than a per-entry index.
+     */
+    users: z.string().min(1, '--users must not be empty').optional(),
+    guestTeam: z.boolean().optional(),
+    allowEmpty: z.boolean().optional(),
+})
+    .strict();
+export const teamCreateCommand = {
+    name: 'user.team-create',
+    summary: 'Create a new team (--name required; optional initial members + flags)',
+    examples: [
+        'monday user team-create --name "Backend Eng"',
+        'monday user team-create --name "Backend Eng" --users 67890,67891',
+        'monday user team-create --name "Empty Bootstrap" --allow-empty',
+        'monday user team-create --name "Vendor Access" --guest-team --users 67890',
+        'monday user team-create --name "Backend Eng" --users 67890 --dry-run --json',
+    ],
+    // Re-running creates a duplicate-named team — Monday's wire
+    // does NOT dedupe by name. Mark non-idempotent so agents
+    // don't naively retry on transient failures.
+    idempotent: false,
+    inputSchema,
+    outputSchema: teamCreateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'user', 'User commands');
+        noun
+            .command('team-create')
+            .description(teamCreateCommand.summary)
+            .requiredOption('--name <n>', 'team name (Monday\'s `String!` — must not be empty)')
+            .option('--users <list>', 'Comma-separated numeric user IDs for initial team membership (maps to wire `subscriber_ids: [ID!]`).')
+            .option('--guest-team', 'mark the team as a guest team (maps to wire `is_guest_team: true`)')
+            .option('--allow-empty', 'allow team creation with no initial members (maps to wire `options.allow_empty_team: true`)')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...teamCreateCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Monday allows duplicate team names; this verb is non-idempotent.',
+            '  - `--dry-run` emits the planned `create_team` operation + resolved input fields (no wire call fires; `meta.source: "none"`).',
+            '  - `--parent <ptid>` is deferred to v0.5.x (hierarchical-team UX TBD).',
+            '  - No `--description` slot — Monday\'s Team object carries no description field.',
+            '',
+        ].join('\n'))
+            .action(async (opts) => {
+            const parsed = parseArgv(teamCreateCommand.inputSchema, opts);
+            // Parse `--users` once at the boundary so a malformed
+            // user ID surfaces `usage_error` ahead of any wire call.
+            // Empty entries (trailing comma, double comma) reject
+            // with a clear hint; non-numeric entries reject via the
+            // UserIdSchema brand. Lifted helper at R-NEW-70 (consumer
+            // #2 post-lift).
+            const userIds = parsed.users === undefined
+                ? undefined
+                : parseBrandedListArg(parsed.users, UserIdSchema, {
+                    flagName: '--users',
+                    entryDescription: 'numeric user ID',
+                    hint: 'user IDs are numeric (e.g. 67890)',
+                    emptyEntryHint: 'e.g. --users 67890,67891 — no leading, trailing, or ' +
+                        'duplicate commas',
+                });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                // Minimal dry-run shape per cli-design §6.4 mutation-
+                // dry-run variant — argv-derived, no preflight read.
+                // Only supplied input slots land in the planned payload
+                // (mirrors the wire-side omit-vs-null discipline the live
+                // path uses; agents see exactly what the live mutation
+                // would send).
+                const planned = {
+                    operation: 'create_team',
+                    name: parsed.name,
+                };
+                if (userIds !== undefined) {
+                    planned.subscriber_ids = [...userIds];
+                }
+                if (parsed.guestTeam !== undefined) {
+                    planned.is_guest_team = parsed.guestTeam;
+                }
+                if (parsed.allowEmpty !== undefined) {
+                    planned.allow_empty_team = parsed.allowEmpty;
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [planned],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const result = await createTeam({
+                client,
+                name: parsed.name,
+                ...(userIds === undefined ? {} : { subscriberIds: userIds }),
+                ...(parsed.guestTeam === undefined
+                    ? {}
+                    : { isGuestTeam: parsed.guestTeam }),
+                ...(parsed.allowEmpty === undefined
+                    ? {}
+                    : { allowEmptyTeam: parsed.allowEmpty }),
+            });
+            emitMutation({
+                ctx,
+                data: result.team,
+                schema: teamCreateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=team-create.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * `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 { type CommandModule } from '../types.js';
+import { type TeamDeleteOutput } from '../../api/teams.js';
+declare const inputSchema: z.ZodObject<{
+    teamId: z.core.$ZodBranded<z.ZodString, "TeamId", "out">;
+}, z.core.$strict>;
+export declare const teamDeleteCommand: CommandModule<z.infer<typeof inputSchema>, TeamDeleteOutput>;
+export {};
+//# sourceMappingURL=team-delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"team-delete.d.ts","sourceRoot":"","sources":["../../../src/commands/user/team-delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAOnE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,QAAA,MAAM,WAAW;;kBAA8C,CAAC;AAEhE,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAsFjB,CAAC"}