monday-cli 0.3.0 → 0.5.0

package/dist/commands/doc/rename.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `monday doc rename <doc-id> --name <n> [--dry-run]` — rename
+ * an existing workdoc (`cli-design.md` §4.3 DOC section + §13
+ * v0.5 entry; `v0.5-plan.md` §3 M35 + §8 D7-D9).
+ *
+ * **Wire shape.** Single `update_doc_name(docId, name)` round-
+ * trip via {@link renameDoc} against `mutation UpdateDocName`
+ * with `operationName: 'UpdateDocName'` (R-NEW-37 W2 audit-point).
+ * Returns Monday's opaque `JSON` scalar — the fetcher projects to
+ * the flat `{ doc_id: <echoed>, success: true }` envelope per D9.
+ *
+ * **camelCase wire-arg note.** `update_doc_name` uses camelCase
+ * `docId` on the wire (Finding 7); CLI argv stays kebab-case;
+ * error envelope `details.*` keys stay snake_case. See the
+ * canonical asymmetry note at `src/api/documents.ts` module
+ * header (4th supporting site for R-NEW-41; R-v0.5-NEW-3
+ * graduation candidate).
+ *
+ * **Argv shape.**
+ *
+ *   - `<doc-id>` — required positional (Monday's
+ *     `update_doc_name.docId` is `ID!`). Brand-validated via
+ *     {@link DocIdSchema}.
+ *   - `--name <n>` — required (Monday's `update_doc_name.name`
+ *     is `String!`). Empty string rejects at parse.
+ *
+ * **Output envelope.** Projected from Monday's opaque JSON
+ * return per D9 — `data: { doc_id: <echoed>, success: true }`.
+ * The `doc_id` echoes the input positional (the operation
+ * targeted that specific doc); `success` is the literal `true`
+ * pinned at the schema layer because Monday surfaces failure
+ * via GraphQL `errors[]` (mapped to typed `ApiError`s upstream),
+ * not via a wire-side success flag.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant.
+ * Minimal envelope listing the planned `update_doc_name`
+ * operation + the resolved input fields (`doc_id`, `name`).
+ * `meta.source: 'none'`.
+ *
+ * **Idempotent: yes.** Re-running with the same `<doc-id>` and
+ * `--name <n>` produces the same end state; Monday's wire is a
+ * no-op when the name matches the current value.
+ *
+ * **Runtime body landed at v0.5-M35 IMPL.** `parseArgv` runs
+ * BEFORE `resolveClient` so invalid argv surfaces `usage_error`
+ * ahead of any missing-token `config_error`; `resolveClient`
+ * parses global flags internally before `loadConfig`. Dry-run
+ * path emits minimal planned changes (no wire call fires); live
+ * path dispatches {@link renameDoc} + projects via `emitMutation`.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DocRenameOutput } from '../../api/documents.js';
+declare const inputSchema: z.ZodObject<{
+    docId: z.core.$ZodBranded<z.ZodString, "DocId", "out">;
+    name: z.ZodString;
+}, z.core.$strict>;
+export declare const docRenameCommand: CommandModule<z.infer<typeof inputSchema>, DocRenameOutput>;
+export {};
+//# sourceMappingURL=rename.d.ts.map

package/dist/commands/doc/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/commands/doc/rename.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAEZ,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAC1C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,eAAe,CAgFhB,CAAC"}

package/dist/commands/doc/rename.js

@@ -0,0 +1,135 @@
+/**
+ * `monday doc rename <doc-id> --name <n> [--dry-run]` — rename
+ * an existing workdoc (`cli-design.md` §4.3 DOC section + §13
+ * v0.5 entry; `v0.5-plan.md` §3 M35 + §8 D7-D9).
+ *
+ * **Wire shape.** Single `update_doc_name(docId, name)` round-
+ * trip via {@link renameDoc} against `mutation UpdateDocName`
+ * with `operationName: 'UpdateDocName'` (R-NEW-37 W2 audit-point).
+ * Returns Monday's opaque `JSON` scalar — the fetcher projects to
+ * the flat `{ doc_id: <echoed>, success: true }` envelope per D9.
+ *
+ * **camelCase wire-arg note.** `update_doc_name` uses camelCase
+ * `docId` on the wire (Finding 7); CLI argv stays kebab-case;
+ * error envelope `details.*` keys stay snake_case. See the
+ * canonical asymmetry note at `src/api/documents.ts` module
+ * header (4th supporting site for R-NEW-41; R-v0.5-NEW-3
+ * graduation candidate).
+ *
+ * **Argv shape.**
+ *
+ *   - `<doc-id>` — required positional (Monday's
+ *     `update_doc_name.docId` is `ID!`). Brand-validated via
+ *     {@link DocIdSchema}.
+ *   - `--name <n>` — required (Monday's `update_doc_name.name`
+ *     is `String!`). Empty string rejects at parse.
+ *
+ * **Output envelope.** Projected from Monday's opaque JSON
+ * return per D9 — `data: { doc_id: <echoed>, success: true }`.
+ * The `doc_id` echoes the input positional (the operation
+ * targeted that specific doc); `success` is the literal `true`
+ * pinned at the schema layer because Monday surfaces failure
+ * via GraphQL `errors[]` (mapped to typed `ApiError`s upstream),
+ * not via a wire-side success flag.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant.
+ * Minimal envelope listing the planned `update_doc_name`
+ * operation + the resolved input fields (`doc_id`, `name`).
+ * `meta.source: 'none'`.
+ *
+ * **Idempotent: yes.** Re-running with the same `<doc-id>` and
+ * `--name <n>` produces the same end state; Monday's wire is a
+ * no-op when the name matches the current value.
+ *
+ * **Runtime body landed at v0.5-M35 IMPL.** `parseArgv` runs
+ * BEFORE `resolveClient` so invalid argv surfaces `usage_error`
+ * ahead of any missing-token `config_error`; `resolveClient`
+ * parses global flags internally before `loadConfig`. Dry-run
+ * path emits minimal planned changes (no wire call fires); live
+ * path dispatches {@link renameDoc} + 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 { DocIdSchema } from '../../types/ids.js';
+import { renameDoc, docRenameOutputSchema, } from '../../api/documents.js';
+const inputSchema = z
+    .object({
+    docId: DocIdSchema,
+    name: z.string().min(1, '--name must not be empty'),
+})
+    .strict();
+export const docRenameCommand = {
+    name: 'doc.rename',
+    summary: 'Rename an existing workdoc (--name required)',
+    examples: [
+        'monday doc rename 12345678 --name "Q4 launch plan (revised)"',
+        'monday doc rename 12345678 --name "Q4 launch plan (revised)" --dry-run --json',
+    ],
+    // Renaming to the current name is a no-op on Monday's wire;
+    // re-running idempotently converges.
+    idempotent: true,
+    inputSchema,
+    outputSchema: docRenameOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'doc', 'Workdoc commands');
+        noun
+            .command('rename <docId>')
+            .description(docRenameCommand.summary)
+            .requiredOption('--name <n>', 'new doc name (Monday\'s `String!` — must not be empty)')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...docRenameCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Envelope projects Monday\'s opaque JSON return to `{ doc_id, success: true }` (D9 closure).',
+            '  - `--dry-run` emits the planned `update_doc_name` operation + resolved input fields (no wire call fires; `meta.source: "none"`).',
+            '',
+        ].join('\n'))
+            .action(async (docIdArg, opts) => {
+            const parsed = parseArgv(docRenameCommand.inputSchema, {
+                docId: docIdArg,
+                ...opts,
+            });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'update_doc_name',
+                            doc_id: parsed.docId,
+                            name: parsed.name,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const result = await renameDoc({
+                client,
+                docId: parsed.docId,
+                name: parsed.name,
+            });
+            emitMutation({
+                ctx,
+                data: result.result,
+                schema: docRenameCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=rename.js.map

package/dist/commands/doc/rename.js.map

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

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgMhD,eAAO,MAAM,kBAAkB,QAAO,SAAS,aAAa,EAmG3D,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4UhD,eAAO,MAAM,kBAAkB,QAAO,SAAS,aAAa,EAyH3D,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/commands/index.js

@@ -153,6 +153,13 @@ import { boardFavoritesCommand } from './board/favorites.js';
 // shipped at `d058172` with Codex impl review fix-ups at
 // `5f10cda` (round 1) + `a024961` (round 2).
 import { itemHistoryCommand } from './item/history.js';
+// M29 (v0.4) — `monday item watch <iid>`. Polling-based event stream
+// over the M24 `item-history-projection.ts` projector. Pre-flight stub
+// only at this commit (cli-design §14.4 closure at `31713fb`; runtime
+// body lands at M29 IMPL); stub registers the verb surface so the
+// command count + agent introspection via `monday schema` reflect the
+// shape without exposing the runtime to invocation.
+import { itemWatchCommand } from './item/watch.js';
 // M26 (v0.3) — `dev` namespace workflow shortcuts (cli-design §5.2
 // carve-out 1; convention, not API per §2.7). Three-level depth:
 // `dev sprint current`, `dev task done`, etc. Pre-flight stubs at
@@ -182,6 +189,139 @@ import { webhookListCommand } from './webhook/list.js';
 import { webhookCreateCommand } from './webhook/create.js';
 import { webhookDeleteCommand } from './webhook/delete.js';
 import { notificationSendCommand } from './notification/send.js';
+// M31 (v0.4) — asset upload (`item upload` / `update upload`). Two
+// new write verbs crossing the wire via multipart/form-data (NOT
+// the JSON-only `client.request` seam). Shipped end-to-end at
+// v0.4-M31 (cli-design §4.3 + §6.4 asset-upload sub-section + §13
+// v0.4 entry; v0.4-plan §3 M31 + §13 post-mortem). First v0.4
+// transport extension; fired R-NEW-41 3rd consumer
+// (`docs/architecture.md` "Wire-vs-CLI semantics documentation
+// conventions" section).
+import { itemUploadCommand } from './item/upload.js';
+import { updateUploadCommand } from './update/upload.js';
+// M32 (v0.4) — workdocs read surface (`doc list` / `doc get`).
+// Read-only at v0.4 per cli-design §13 v0.4 entry; full docs CRUD
+// deferred to v0.5. Pre-flight stubs at this commit (argv schema +
+// wire query documents only); runtime bodies + integration tests
+// land at M32 IMPL. Empirical probe at `scripts/probe/m32-docs.ts`
+// (2026-05-14, API `2026-01`) pinned `Query.docs(...)` signature +
+// the 14-field `Document` projection + the 9-field `DocumentBlock`
+// shape + the `DocsOrderBy` 2-value enum.
+import { docListCommand } from './doc/list.js';
+import { docGetCommand } from './doc/get.js';
+// M35 (v0.5) — doc-level CRUD mutation surface (`doc create-in-
+// workspace` / `create-on-column` / `rename` / `delete` /
+// `duplicate`). 5 new mutation verbs under the existing `doc`
+// namespace; second v0.5 milestone after M34 team writers.
+// Pre-flight stubs at this commit (argv schema + wire mutation
+// documents + envelope projection only); runtime bodies +
+// integration tests land at M35 IMPL. Empirical probe at
+// `scripts/probe/v0.5-doc-mutations.ts` + `v0.5-inputs-and-results.ts`
+// + `v0.5-nested-inputs.ts` (2026-05-15, API `2026-01`) pinned
+// Monday's `Mutation.create_doc / update_doc_name / delete_doc /
+// duplicate_doc` signatures + the `CreateDocInput` mutually-
+// exclusive `board` vs `workspace` shape + the `DuplicateType`
+// 2-value enum + the opaque-JSON return cadence for the 3 non-
+// create mutations. D7 closure: two CLI verbs over one with
+// placement choosers. D8 closure: drop `--name <n>` from
+// duplicate (no wire-side rename slot). D9 closure: project
+// opaque JSON returns to `{ doc_id, success: true }` envelope.
+// 5 doc-content / per-block mutations defer across M36 and M37
+// per the v0.5 doc-CRUD-mutation backlog sequencing: M36
+// covers per-block CRUD (3 wire mutations — `create_doc_block` /
+// `update_doc_block` / `delete_doc_block`); M37 covers doc-
+// content import (2 wire mutations — `import_doc_from_html` /
+// `add_content_to_doc_from_markdown`).
+import { docCreateInWorkspaceCommand } from './doc/create-in-workspace.js';
+import { docCreateOnColumnCommand } from './doc/create-on-column.js';
+import { docRenameCommand } from './doc/rename.js';
+import { docDeleteCommand } from './doc/delete.js';
+import { docDuplicateCommand } from './doc/duplicate.js';
+// M36 (v0.5) — per-block CRUD mutation surface (`doc block-create` /
+// `block-update` / `block-delete`). 3 new mutation verbs under the
+// existing `doc` namespace; third v0.5 milestone after M34 team
+// writers + M35 doc-level CRUD. Pre-flight stubs at this commit
+// (argv schema + wire mutation documents + output schemas only —
+// OBJECT-return direct-unwrap envelope shapes, distinct from M35's
+// opaque-JSON projection cadence); runtime bodies + integration
+// tests land at M36 IMPL.
+// Empirical probe at `scripts/probe/v0.5-doc-mutations.ts` +
+// `v0.5-inputs-and-results.ts` (2026-05-15, API `2026-01`) pinned
+// Monday's `Mutation.create_doc_block` / `update_doc_block` /
+// `delete_doc_block` signatures + the 16-value
+// `DocBlockContentType` closed enum + the `DocumentBlockIdOnly`
+// single-field delete return shape. D10 closure: reject unknown
+// `--type` values at parse boundary. D11 closure: per-block
+// content payload structure deferred to IMPL cassettes for 16-
+// shape breadth.
+import { docBlockCreateCommand } from './doc/block-create.js';
+import { docBlockUpdateCommand } from './doc/block-update.js';
+import { docBlockDeleteCommand } from './doc/block-delete.js';
+// M37 (v0.5) — doc-content import mutation surface (`doc import-html` /
+// `append-markdown`). 2 new mutation verbs under the existing `doc`
+// namespace; fourth v0.5 milestone after M34 team writers + M35 doc-
+// level CRUD + M36 per-block CRUD. **Shipped at v0.5-M37 IMPL**
+// (argv schema + wire mutation documents + custom-OBJECT projection
+// schemas + parse-boundary size guard per D13 + runtime bodies +
+// file/stdin source reading via the lifted `readSourceContent`
+// helper [R-v0.5-NEW-18; src/utils/source-content.ts] + runtime
+// size guard at the read boundary defense-in-depth with the schema
+// `.refine()` for inline + 36 integration tests across
+// `tests/integration/commands/doc-{import-html,append-markdown}.test.ts`).
+// Empirical probes:
+//   - `scripts/probe/v0.5-doc-mutations.ts` + `v0.5-inputs-and-results
+//     .ts` (2026-05-15, API `2026-01`) pinned Monday's `Mutation.import_
+//     doc_from_html` + `add_content_to_doc_from_markdown` signatures +
+//     `ImportDocFromHtmlResult` / `DocBlocksFromMarkdownResult` 3-field
+//     custom OBJECT shapes (`success!`, `doc_id|block_ids?`, `error?`).
+//   - `scripts/probe/v0.5-m37-size-limits.ts` (2026-05-17, API
+//     `2026-01`) pinned the empirical wire-side payload-size threshold
+//     between 250KB-OK and 500KB-rejected on both surfaces (D13
+//     closure). The rejection shape is `errors[]: [{ message: 'Internal
+//     Server Error', extensions: { code: 'INTERNAL_SERVER_ERROR' } }]`
+//     — NOT the documented `success: false + error` envelope; the CLI
+//     pre-empts via a parse-boundary size guard at
+//     `MAX_DOC_IMPORT_PAYLOAD_BYTES = 256_000`.
+// D12 closure: project the custom OBJECT — `success: false + populated
+// error` → `validation_failed`; empty `error` → `internal_error` (wire-
+// regression hint). D13 closure: CLI parse-boundary guard capped
+// at 256_000 bytes (`MAX_DOC_IMPORT_PAYLOAD_BYTES`; conservative
+// pin at the last-known-good probe size).
+import { docImportHtmlCommand } from './doc/import-html.js';
+import { docAppendMarkdownCommand } from './doc/append-markdown.js';
+// M34 (v0.5) — team writer surface (`user team-list` / `team-get` /
+// `team-create` / `team-delete` / `team-add-members` /
+// `team-remove-members`). 6 new verbs under the existing `user`
+// namespace; first v0.5 milestone. Pre-flight stubs at this commit
+// (argv schema + wire query/mutation documents only); runtime bodies
+// + integration tests land at M34 IMPL. Empirical probe at
+// `scripts/probe/v0.5-team-mutations.ts` (2026-05-15, API `2026-01`)
+// pinned Monday's `Query.teams` signature + the 6-field `Team`
+// projection + the `CreateTeamAttributesInput` 4-field input + the
+// `ChangeTeamMembershipsResult` partial-success wire envelope. No
+// `update_team` mutation exists (D1 drop --description; D2 no
+// team-update verb); 6 tangential team-shaped mutations
+// (assign_team_owners + add_teams_to_board etc.) deferred to v0.5.x
+// per D4 closure.
+import { teamListCommand } from './user/team-list.js';
+import { teamGetCommand } from './user/team-get.js';
+import { teamCreateCommand } from './user/team-create.js';
+import { teamDeleteCommand } from './user/team-delete.js';
+import { teamAddMembersCommand } from './user/team-add-members.js';
+import { teamRemoveMembersCommand } from './user/team-remove-members.js';
+// M33 (v0.4) — `monday completion <bash|zsh|fish>`. Shell-completion
+// script emitter; first non-envelope stdout surface in the CLI
+// (cli-design §3.1 raw-bytes carve-out). Empirical-probe finding at
+// M33 pre-flight (`grep -rn 'completion\|complete' node_modules/
+// commander/lib/ node_modules/commander/typings/` 2026-05-14, commander
+// 14.0.3) returned zero hits — commander has no built-in completion
+// machinery, so the verb hand-rolls per-shell templates at runtime (no
+// runtime dep added). Shipped end-to-end at v0.4-M33 IMPL: argv schema
+// + commander wiring + `--json` envelope schema + the three-mode
+// format-aware action body + three per-shell template builders that
+// walk `program.commands` at emit time so completions stay in sync
+// with the registry.
+import { completionCommand } from './completion.js';
 // M6 commands — diagnostics + GraphQL escape hatch + agent-flow E2E.
 import { rawCommand } from './raw/index.js';
 import { boardDoctorCommand } from './board/doctor.js';
@@ -232,6 +372,12 @@ export const getCommandRegistry = () => {
         userListCommand,
         userGetCommand,
         userMeCommand,
+        teamListCommand,
+        teamGetCommand,
+        teamCreateCommand,
+        teamDeleteCommand,
+        teamAddMembersCommand,
+        teamRemoveMembersCommand,
         updateListCommand,
         updateGetCommand,
         itemGetCommand,
@@ -240,6 +386,7 @@ export const getCommandRegistry = () => {
         itemSearchCommand,
         itemSubitemsCommand,
         itemHistoryCommand,
+        itemWatchCommand,
         itemSetCommand,
         itemClearCommand,
         itemUpdateCommand,
@@ -281,6 +428,21 @@ export const getCommandRegistry = () => {
         webhookCreateCommand,
         webhookDeleteCommand,
         notificationSendCommand,
+        itemUploadCommand,
+        updateUploadCommand,
+        docListCommand,
+        docGetCommand,
+        docCreateInWorkspaceCommand,
+        docCreateOnColumnCommand,
+        docRenameCommand,
+        docDeleteCommand,
+        docDuplicateCommand,
+        docBlockCreateCommand,
+        docBlockUpdateCommand,
+        docBlockDeleteCommand,
+        docImportHtmlCommand,
+        docAppendMarkdownCommand,
+        completionCommand,
         rawCommand,
         boardDoctorCommand,
     ];

package/dist/commands/index.js.map

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

package/dist/commands/item/create.js

@@ -420,13 +420,13 @@ const resolveCreateMode = async (inputs) => {
                 `creation is deferred. Use a classic board ` +
                 `(hierarchy_type null/"classic"). v0.3 M28 Decision 11 closure: ` +
                 `Monday's sub_items_board carries no subtasks column at API ` +
-                `2026-01, so depth-2 subitems have no data-model home — v0.4 ` +
+                `2026-01, so depth-2 subitems have no data-model home — v0.6 ` +
                 `picks the feature up if Monday surfaces the capability.`, {
                 details: {
                     parent_item_id: dispatch.parentItemId,
                     parent_board_id: parent.boardId,
                     hierarchy_type: parent.hierarchyType,
-                    deferred_to: 'v0.4',
+                    deferred_to: 'v0.6',
                 },
             });
         }

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

@@ -94,6 +94,7 @@ declare const inputSchema: z.ZodObject<{
     filterJson: z.ZodOptional<z.ZodString>;
     createLabelsIfMissing: z.ZodOptional<z.ZodBoolean>;
     continueOnError: z.ZodOptional<z.ZodBoolean>;
+    concurrency: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
 export declare const itemUpdateCommand: CommandModule<z.infer<typeof inputSchema>, ItemUpdateOutput>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/item/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA+CnE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAUtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsB,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;kBA8Dd,CAAC;AA2DJ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CA+OjB,CAAC"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/item/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA+CnE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AActC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsB,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;kBAmFd,CAAC;AA0FJ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAoPjB,CAAC"}

package/dist/commands/item/update.js

@@ -68,6 +68,7 @@ import { ConfirmationRequiredError, } from '../../utils/errors.js';
 import { resolveMeFactory } from '../../api/item-helpers.js';
 import { projectedItemSchema, } from '../../api/item-projection.js';
 import { runPartialSuccessBulkUpdate, buildPartialSuccessBulkSummary, partialSuccessBulkUpdateDataSchema, PARTIAL_SUCCESS_BULK_DISPATCH_SOURCE, } from '../../api/partial-success-bulk.js';
+import { MIN_CONCURRENCY, MAX_CONCURRENCY, } from '../../api/parallel-dispatch.js';
 export const itemUpdateOutputSchema = projectedItemSchema;
 /**
  * Input shape — supports both single-item and bulk shapes.
@@ -126,6 +127,27 @@ const inputSchema = z
     // `validateInputShape` rejects `--continue-on-error` on the
     // single-item path with a `usage_error`.
     continueOnError: z.boolean().optional(),
+    // v0.4-M30 pre-flight (cli-design §6.4 "Bulk per-item
+    // partial-success — Parallel dispatch" + §9.3). Opt-in to
+    // bounded parallel per-item dispatch under
+    // `--continue-on-error`. `undefined` or `1` preserves the
+    // M25 sequential path verbatim; `> 1` routes through
+    // {@link dispatchParallel} (stub at pre-flight, runtime at
+    // M30 IMPL). Range pinned at argv-parse-time to
+    // `[MIN_CONCURRENCY, MAX_CONCURRENCY]` (1..32) — under any
+    // plausible Monday per-account cap (cli-design §2.5).
+    //
+    // `validateInputShape` rejects `--concurrency` on the
+    // single-item path AND rejects `--concurrency` without
+    // `--continue-on-error` (the fail-fast bulk path doesn't
+    // have a defined "abort N in-flight" semantic at M30; that's
+    // explicitly deferred per v0.4-plan §8 D2 closure).
+    concurrency: z.coerce
+        .number()
+        .int('--concurrency must be an integer')
+        .min(MIN_CONCURRENCY, `--concurrency must be ≥ ${String(MIN_CONCURRENCY)}`)
+        .max(MAX_CONCURRENCY, `--concurrency must be ≤ ${String(MAX_CONCURRENCY)}`)
+        .optional(),
 })
     .strict()
     // At least one of --set / --set-raw / --name must be provided. An
@@ -157,6 +179,11 @@ const validateInputShape = (parsed) => {
                 '--filter-json). Single-item update has no per-item-failure ' +
                 'surface — a single-item failure IS the whole-call failure.', { details: { item_id: parsed.itemId } });
         }
+        if (parsed.concurrency !== undefined) {
+            throw new UsageError('--concurrency is only valid on the bulk partial-success path ' +
+                '(--where / --filter-json + --continue-on-error). Single-item ' +
+                'update has no per-item dispatch loop to parallelise.', { details: { item_id: parsed.itemId } });
+        }
         /* c8 ignore next 4 — defensive: hasItemId === true means
            parsed.itemId is non-undefined; the type guard exists for TS. */
         if (parsed.itemId === undefined) {
@@ -164,6 +191,26 @@ const validateInputShape = (parsed) => {
         }
         return { kind: 'single', itemId: parsed.itemId };
     }
+    // v0.4-M30 D2 closure: `--concurrency` requires `--continue-on-error`.
+    // The fail-fast bulk path (cli-design §6.4 default + §6.5 "Bulk per-
+    // item failure") doesn't have a well-defined "abort N in-flight"
+    // semantic — the first per-item error aborts the loop today, and a
+    // parallel variant would need to decide which in-flight calls to
+    // cancel + how to report `details.applied_to` against a non-
+    // sequential dispatch order. That extension is deferred; M30 lands
+    // only the partial-success-bulk parallel path where the universal
+    // partial-success rule (cli-design §6.1) makes "let every in-flight
+    // dispatch complete and capture per-record outcomes" unambiguous.
+    if (parsed.concurrency !== undefined && parsed.continueOnError !== true) {
+        throw new UsageError('--concurrency requires --continue-on-error. The fail-fast bulk ' +
+            'path does not yet support parallel dispatch (deferred per ' +
+            'v0.4-plan M30 D2). Either drop --concurrency or add ' +
+            '--continue-on-error to opt in to the partial-success envelope.', {
+            details: {
+                concurrency: parsed.concurrency,
+            },
+        });
+    }
     return { kind: 'bulk' };
 };
 export const itemUpdateCommand = {
@@ -178,6 +225,7 @@ export const itemUpdateCommand = {
         'monday item update 12345 --set status=Done --dry-run --json',
         "monday item update 12345 --set-raw status='{\"label\":\"Done\"}'",
         "monday item update 12345 --set status=Done --set-raw tags_1='{\"tag_ids\":[1,2]}'",
+        'monday item update --board 67890 --where status=Backlog --set status=Working --continue-on-error --concurrency 8 --yes',
     ],
     idempotent: true,
     inputSchema,
@@ -201,6 +249,7 @@ export const itemUpdateCommand = {
             // global one).
             .option('--create-labels-if-missing', 'auto-create unknown status / dropdown labels (Monday flag)')
             .option('--continue-on-error', 'bulk only: attempt every matched item and emit a partial-success envelope with per-item {item_id, ok, error?} records (v0.3-M25)')
+            .option('--concurrency <n>', `bulk + --continue-on-error only: fan out at most N (${String(MIN_CONCURRENCY)}..${String(MAX_CONCURRENCY)}) per-item dispatches in parallel; default 1 = sequential (v0.4-M30)`)
             .addHelpText('after', ['', 'Examples:', ...itemUpdateCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
             .action(async (itemId, opts) => {
             const parsed = parseArgv(itemUpdateCommand.inputSchema, {
@@ -735,6 +784,18 @@ const runBulk = async (inputs) => {
             env: ctx.env,
             noCache: globalFlags.noCache,
             resolutionSource: remapSource,
+            // v0.4-M30: thread the argv `--concurrency` slot through.
+            // `undefined` (default) preserves the M25 sequential dispatch;
+            // `> 1` routes through dispatchParallel (bounded async-pool).
+            // Argv parser pinned the value to
+            // [MIN_CONCURRENCY, MAX_CONCURRENCY] (1..32) before reaching here.
+            concurrency: parsed.concurrency,
+            // v0.4-M30: SIGINT during a parallel dispatch aborts the pool's
+            // scheduler at the next worker-loop iteration; in-flight wire
+            // calls abort via the MondayClient.signal. Sequential route
+            // sees the same signal so cooperative-abort semantics match
+            // (R-NEW-28 axis 6).
+            signal: ctx.signal,
         });
         // Per-item dispatch leg is always live — fold into the
         // aggregator. Mirrors the fail-fast path's terminal