monday-cli 0.3.0 → 0.5.0

package/dist/commands/doc/block-delete.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `monday doc block-delete <block-id> --yes [--dry-run]` — delete
+ * an existing rich-text block from a workdoc (`cli-design.md`
+ * §4.3 DOC section + §13 v0.5 entry; `v0.5-plan.md` §3 M36 +
+ * §8 D10-D11).
+ *
+ * **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.block_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` / `team delete` / `doc delete`).
+ *
+ * **Wire shape.** Single `delete_doc_block(block_id) →
+ * DocumentBlockIdOnly` round-trip via {@link deleteDocBlock}
+ * against `mutation DeleteDocBlock` with `operationName:
+ * 'DeleteDocBlock'` (R-NEW-37 W2 audit-point). Returns a single-
+ * field OBJECT (`{id: String!}`) — Monday's wire mints a typed
+ * shape distinct from `DocumentBlock` (the deletion endpoint only
+ * confirms the id, doesn't echo the pre-delete content).
+ *
+ * **Snake_case wire arg names.** M36's wire uses snake_case
+ * (`block_id`) — back to Monday's standard cadence after the M35
+ * camelCase asymmetry. NOT a new R-NEW-41 supporting site.
+ *
+ * **Argv shape.**
+ *
+ *   - `<block-id>` — required positional (Monday's
+ *     `delete_doc_block.block_id` is `String!`). Brand-validated
+ *     via {@link DocBlockIdSchema} (opaque non-empty string).
+ *
+ * **Output envelope.** Direct unwrap of the
+ * {@link documentBlockIdOnlySchema} shape — `data: { id }`. Envelope
+ * is intentionally narrower than the create/update variants
+ * because Monday's `delete_doc_block` wire only returns the id
+ * (NOT the full pre-delete block); the agent contract doesn't
+ * gain from speculatively rehydrating the block on the way out.
+ * Mirrors M35 `doc delete`'s narrow `{doc_id, success: true}`
+ * envelope-narrower-than-create rationale.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant:
+ * minimal `{operation: "delete_doc_block", block_id}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors `workspace delete` /
+ * `team delete` / `doc delete` — destructive-no-read pattern is
+ * uniform across destructive verbs.
+ *
+ * **Idempotent: false.** Re-running surfaces `not_found` past the
+ * first call (Monday's `delete_doc_block` wire returns null
+ * payload for already-deleted blocks; the fetcher rewraps to
+ * `not_found` per the standard delete cadence). Same rationale
+ * as `workspace delete` / `team delete` / `doc delete` — agents
+ * can't safely retry without verifying the id still names the
+ * same record.
+ *
+ * **Runtime body landed at v0.5-M36 IMPL.** Destructive gate fires
+ * BEFORE `resolveClient` (M10 round-1 P2 invariant); dry-run path
+ * emits minimal `{operation: "delete_doc_block", block_id}` (no wire
+ * call); live path dispatches {@link deleteDocBlock} + projects via
+ * `emitMutation`.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DocBlockDeleteOutput } from '../../api/documents.js';
+declare const inputSchema: z.ZodObject<{
+    blockId: z.core.$ZodBranded<z.ZodString, "DocBlockId", "out">;
+}, z.core.$strict>;
+export declare const docBlockDeleteCommand: CommandModule<z.infer<typeof inputSchema>, DocBlockDeleteOutput>;
+export {};
+//# sourceMappingURL=block-delete.d.ts.map

package/dist/commands/doc/block-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-delete.d.ts","sourceRoot":"","sources":["../../../src/commands/doc/block-delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAOnE,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,WAAW;;kBAAmD,CAAC;AAErE,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,oBAAoB,CA8FrB,CAAC"}

package/dist/commands/doc/block-delete.js

@@ -0,0 +1,161 @@
+/**
+ * `monday doc block-delete <block-id> --yes [--dry-run]` — delete
+ * an existing rich-text block from a workdoc (`cli-design.md`
+ * §4.3 DOC section + §13 v0.5 entry; `v0.5-plan.md` §3 M36 +
+ * §8 D10-D11).
+ *
+ * **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.block_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` / `team delete` / `doc delete`).
+ *
+ * **Wire shape.** Single `delete_doc_block(block_id) →
+ * DocumentBlockIdOnly` round-trip via {@link deleteDocBlock}
+ * against `mutation DeleteDocBlock` with `operationName:
+ * 'DeleteDocBlock'` (R-NEW-37 W2 audit-point). Returns a single-
+ * field OBJECT (`{id: String!}`) — Monday's wire mints a typed
+ * shape distinct from `DocumentBlock` (the deletion endpoint only
+ * confirms the id, doesn't echo the pre-delete content).
+ *
+ * **Snake_case wire arg names.** M36's wire uses snake_case
+ * (`block_id`) — back to Monday's standard cadence after the M35
+ * camelCase asymmetry. NOT a new R-NEW-41 supporting site.
+ *
+ * **Argv shape.**
+ *
+ *   - `<block-id>` — required positional (Monday's
+ *     `delete_doc_block.block_id` is `String!`). Brand-validated
+ *     via {@link DocBlockIdSchema} (opaque non-empty string).
+ *
+ * **Output envelope.** Direct unwrap of the
+ * {@link documentBlockIdOnlySchema} shape — `data: { id }`. Envelope
+ * is intentionally narrower than the create/update variants
+ * because Monday's `delete_doc_block` wire only returns the id
+ * (NOT the full pre-delete block); the agent contract doesn't
+ * gain from speculatively rehydrating the block on the way out.
+ * Mirrors M35 `doc delete`'s narrow `{doc_id, success: true}`
+ * envelope-narrower-than-create rationale.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant:
+ * minimal `{operation: "delete_doc_block", block_id}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`. Mirrors `workspace delete` /
+ * `team delete` / `doc delete` — destructive-no-read pattern is
+ * uniform across destructive verbs.
+ *
+ * **Idempotent: false.** Re-running surfaces `not_found` past the
+ * first call (Monday's `delete_doc_block` wire returns null
+ * payload for already-deleted blocks; the fetcher rewraps to
+ * `not_found` per the standard delete cadence). Same rationale
+ * as `workspace delete` / `team delete` / `doc delete` — agents
+ * can't safely retry without verifying the id still names the
+ * same record.
+ *
+ * **Runtime body landed at v0.5-M36 IMPL.** Destructive gate fires
+ * BEFORE `resolveClient` (M10 round-1 P2 invariant); dry-run path
+ * emits minimal `{operation: "delete_doc_block", block_id}` (no wire
+ * call); live path dispatches {@link deleteDocBlock} + 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 { DocBlockIdSchema } from '../../types/ids.js';
+import { deleteDocBlock, docBlockDeleteOutputSchema, } from '../../api/documents.js';
+const inputSchema = z.object({ blockId: DocBlockIdSchema }).strict();
+export const docBlockDeleteCommand = {
+    name: 'doc.block-delete',
+    summary: 'Delete a rich-text block from a workdoc — --yes required',
+    examples: [
+        'monday doc block-delete blk_abc123 --yes',
+        'monday doc block-delete blk_abc123 --dry-run',
+        'monday doc block-delete blk_abc123 --yes --json',
+    ],
+    // Re-deleting an already-deleted block surfaces `not_found`;
+    // re-running with the same `<block-id>` after an interim
+    // `doc block-create` would target a different record (Monday
+    // mints new block IDs on create). Mark non-idempotent.
+    idempotent: false,
+    inputSchema,
+    outputSchema: docBlockDeleteOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'doc', 'Workdoc commands');
+        noun
+            .command('block-delete <blockId>')
+            .description(docBlockDeleteCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...docBlockDeleteCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Destructive — Monday\'s wire offers no restore mutation for blocks; agents needing reversal must recreate via `monday doc block-create` (lossy: new id, new position).',
+            '  - Envelope projects Monday\'s `DocumentBlockIdOnly` wire return to `{ id }` — narrower than create/update because Monday\'s delete endpoint doesn\'t echo block content.',
+            '  - `--dry-run` emits the planned `delete_doc_block` operation + resolved input fields (no wire call fires; `meta.source: "none"`).',
+            '',
+        ].join('\n'))
+            .action(async (blockIdArg) => {
+            const parsed = parseArgv(docBlockDeleteCommand.inputSchema, {
+                blockId: blockIdArg,
+            });
+            // 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: 'doc block-delete',
+                target: parsed.blockId,
+                detailKey: 'block_id',
+                action: 'delete the doc block',
+                hint: 'block-delete is destructive — Monday\'s wire surface offers ' +
+                    'no restore mutation for doc blocks; agents needing reversal ' +
+                    'must recreate via `monday doc block-create` (lossy: new id, ' +
+                    'new position; content must be re-supplied).',
+            });
+            if (preGateGlobalFlags.dryRun) {
+                // Minimal dry-run shape — no preflight read fires. Mirrors
+                // `doc delete` / `team delete` / `workspace delete` cadence.
+                const { apiVersion } = resolveClient(ctx, program.opts());
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        { operation: 'delete_doc_block', block_id: parsed.blockId },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await deleteDocBlock({
+                client,
+                blockId: parsed.blockId,
+            });
+            emitMutation({
+                ctx,
+                data: result.block,
+                schema: docBlockDeleteCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=block-delete.js.map

package/dist/commands/doc/block-delete.js.map

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

package/dist/commands/doc/block-update.d.ts

@@ -0,0 +1,75 @@
+/**
+ * `monday doc block-update <block-id> --content <json> [--dry-run]`
+ * — replace the content payload of an existing rich-text block
+ * inside a workdoc (`cli-design.md` §4.3 DOC section + §13 v0.5
+ * entry; `v0.5-plan.md` §3 M36 + §8 D10-D11).
+ *
+ * **Wire shape.** Single `update_doc_block(block_id, content) →
+ * DocumentBlock` round-trip via {@link updateDocBlock} against
+ * `mutation UpdateDocBlock` with `operationName: 'UpdateDocBlock'`
+ * (R-NEW-37 W2 audit-point). Returns the full 9-field
+ * `DocumentBlock` shape per the M32 probe (id / type / content /
+ * position / parent_block_id / doc_id / created_at / created_by /
+ * updated_at). OBJECT-return cadence (distinct from M35's opaque-
+ * JSON projection cadence).
+ *
+ * **Snake_case wire arg names.** M36's wire uses snake_case
+ * (`block_id`) — back to Monday's standard cadence after the M35
+ * camelCase asymmetry. NOT a new R-NEW-41 supporting site.
+ *
+ * **No `--type` slot on the wire.** Monday's `update_doc_block`
+ * mutation has no `type` arg — content type is fixed at creation
+ * time. Agents needing to switch a block's content type must
+ * `block-delete` + `block-create` (lossy: new id, new position).
+ * The CLI surface mirrors the wire constraint exactly — no
+ * client-side "change type" shim that papers over the destructive
+ * recreate.
+ *
+ * **Argv shape.**
+ *
+ *   - `<block-id>` — required positional (Monday's
+ *     `update_doc_block.block_id` is `String!`). Brand-validated
+ *     via {@link DocBlockIdSchema} (opaque non-empty string —
+ *     distinct from `DocId`'s numeric shape).
+ *   - `--content <json>` — required JSON-string slot. Parsed once
+ *     at the argv boundary via `parseJsonArg` (R-NEW-42 helper, 5th
+ *     consumer; same shape `monday raw --vars` /
+ *     `board column-create --settings` /
+ *     `webhook create --config` / `doc block-create --content`
+ *     use). The parsed JS value passes through to Monday's wire
+ *     `JSON` scalar unmodified. The new content payload MUST match
+ *     the existing block's `DocBlockContentType` shape (Monday's
+ *     wire rejects shape-incompatible payloads with
+ *     `validation_failed`); the CLI doesn't pre-validate.
+ *
+ * **Output envelope.** Direct unwrap of the updated DocumentBlock
+ * — `data: <DocumentBlock>` per cli-design §6.1 single-record
+ * convention. Mirrors `block-create`'s output shape — Monday's
+ * wire returns the full post-update block.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant:
+ * minimal `{operation: "update_doc_block", block_id, content}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`.
+ *
+ * **Idempotent: yes.** Re-running with the same `<block-id>` and
+ * `--content` produces the same end state; Monday's wire is a
+ * no-op when the content value matches.
+ *
+ * **Runtime body landed at v0.5-M36 IMPL.** `parseArgv` +
+ * `parseJsonArg` fire BEFORE `resolveClient` so invalid argv
+ * surfaces `usage_error` ahead of any missing-token `config_error`
+ * (R-NEW-76 graduated discipline). Dry-run path emits minimal
+ * planned changes (no wire call fires); live path dispatches
+ * {@link updateDocBlock} + projects via `emitMutation`.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DocBlockUpdateOutput } from '../../api/documents.js';
+declare const inputSchema: z.ZodObject<{
+    blockId: z.core.$ZodBranded<z.ZodString, "DocBlockId", "out">;
+    content: z.ZodString;
+}, z.core.$strict>;
+export declare const docBlockUpdateCommand: CommandModule<z.infer<typeof inputSchema>, DocBlockUpdateOutput>;
+export {};
+//# sourceMappingURL=block-update.d.ts.map

package/dist/commands/doc/block-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-update.d.ts","sourceRoot":"","sources":["../../../src/commands/doc/block-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAMnE,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,WAAW;;;kBAKN,CAAC;AAEZ,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,oBAAoB,CAqGrB,CAAC"}

package/dist/commands/doc/block-update.js

@@ -0,0 +1,162 @@
+/**
+ * `monday doc block-update <block-id> --content <json> [--dry-run]`
+ * — replace the content payload of an existing rich-text block
+ * inside a workdoc (`cli-design.md` §4.3 DOC section + §13 v0.5
+ * entry; `v0.5-plan.md` §3 M36 + §8 D10-D11).
+ *
+ * **Wire shape.** Single `update_doc_block(block_id, content) →
+ * DocumentBlock` round-trip via {@link updateDocBlock} against
+ * `mutation UpdateDocBlock` with `operationName: 'UpdateDocBlock'`
+ * (R-NEW-37 W2 audit-point). Returns the full 9-field
+ * `DocumentBlock` shape per the M32 probe (id / type / content /
+ * position / parent_block_id / doc_id / created_at / created_by /
+ * updated_at). OBJECT-return cadence (distinct from M35's opaque-
+ * JSON projection cadence).
+ *
+ * **Snake_case wire arg names.** M36's wire uses snake_case
+ * (`block_id`) — back to Monday's standard cadence after the M35
+ * camelCase asymmetry. NOT a new R-NEW-41 supporting site.
+ *
+ * **No `--type` slot on the wire.** Monday's `update_doc_block`
+ * mutation has no `type` arg — content type is fixed at creation
+ * time. Agents needing to switch a block's content type must
+ * `block-delete` + `block-create` (lossy: new id, new position).
+ * The CLI surface mirrors the wire constraint exactly — no
+ * client-side "change type" shim that papers over the destructive
+ * recreate.
+ *
+ * **Argv shape.**
+ *
+ *   - `<block-id>` — required positional (Monday's
+ *     `update_doc_block.block_id` is `String!`). Brand-validated
+ *     via {@link DocBlockIdSchema} (opaque non-empty string —
+ *     distinct from `DocId`'s numeric shape).
+ *   - `--content <json>` — required JSON-string slot. Parsed once
+ *     at the argv boundary via `parseJsonArg` (R-NEW-42 helper, 5th
+ *     consumer; same shape `monday raw --vars` /
+ *     `board column-create --settings` /
+ *     `webhook create --config` / `doc block-create --content`
+ *     use). The parsed JS value passes through to Monday's wire
+ *     `JSON` scalar unmodified. The new content payload MUST match
+ *     the existing block's `DocBlockContentType` shape (Monday's
+ *     wire rejects shape-incompatible payloads with
+ *     `validation_failed`); the CLI doesn't pre-validate.
+ *
+ * **Output envelope.** Direct unwrap of the updated DocumentBlock
+ * — `data: <DocumentBlock>` per cli-design §6.1 single-record
+ * convention. Mirrors `block-create`'s output shape — Monday's
+ * wire returns the full post-update block.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant:
+ * minimal `{operation: "update_doc_block", block_id, content}`. No
+ * preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`.
+ *
+ * **Idempotent: yes.** Re-running with the same `<block-id>` and
+ * `--content` produces the same end state; Monday's wire is a
+ * no-op when the content value matches.
+ *
+ * **Runtime body landed at v0.5-M36 IMPL.** `parseArgv` +
+ * `parseJsonArg` fire BEFORE `resolveClient` so invalid argv
+ * surfaces `usage_error` ahead of any missing-token `config_error`
+ * (R-NEW-76 graduated discipline). Dry-run path emits minimal
+ * planned changes (no wire call fires); live path dispatches
+ * {@link updateDocBlock} + projects via `emitMutation`.
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { parseJsonArg } from '../../utils/json.js';
+import { emitDryRun, emitMutation } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { DocBlockIdSchema } from '../../types/ids.js';
+import { updateDocBlock, docBlockUpdateOutputSchema, } from '../../api/documents.js';
+const inputSchema = z
+    .object({
+    blockId: DocBlockIdSchema,
+    content: z.string().min(1, '--content must not be empty'),
+})
+    .strict();
+export const docBlockUpdateCommand = {
+    name: 'doc.block-update',
+    summary: 'Replace the content payload of an existing doc block (--content required)',
+    examples: [
+        'monday doc block-update blk_abc123 --content \'{"alignment":"center","content":"Hi"}\'',
+        'monday doc block-update blk_abc123 --content \'{"items":["x","y","z"]}\' --dry-run --json',
+    ],
+    // Re-running with the same content is a no-op on Monday's wire;
+    // re-running converges idempotently.
+    idempotent: true,
+    inputSchema,
+    outputSchema: docBlockUpdateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'doc', 'Workdoc commands');
+        noun
+            .command('block-update <blockId>')
+            .description(docBlockUpdateCommand.summary)
+            .requiredOption('--content <json>', 'new block content payload (JSON-encoded string parsed at argv boundary; shape must match the block\'s existing content type)')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...docBlockUpdateCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - Monday\'s wire has no `type` arg on `update_doc_block`; content type is fixed at block creation. Agents needing to change type use `doc block-delete` + `doc block-create` (lossy: new id, new position).',
+            '  - Per-block content shapes are documented in `output-shapes.md` "Per-block content shapes" reference table.',
+            '  - `--dry-run` emits the planned `update_doc_block` operation + resolved input fields (no wire call fires; `meta.source: "none"`).',
+            '',
+        ].join('\n'))
+            .action(async (blockIdArg, opts) => {
+            const parsed = parseArgv(docBlockUpdateCommand.inputSchema, {
+                blockId: blockIdArg,
+                content: opts.content,
+            });
+            // Parse the opaque `--content` JSON string once at the
+            // boundary (R-NEW-42 lift).
+            const parsedContent = parseJsonArg(parsed.content, {
+                context: '--content must be a valid JSON-encoded string',
+                details: {
+                    block_id: parsed.blockId,
+                    hint: 'check the JSON syntax — strings need double-quotes; the ' +
+                        'shell may consume quotes if --content is not single-quoted',
+                },
+            });
+            const { client, globalFlags, apiVersion } = resolveClient(ctx, program.opts());
+            if (globalFlags.dryRun) {
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [
+                        {
+                            operation: 'update_doc_block',
+                            block_id: parsed.blockId,
+                            content: parsedContent,
+                        },
+                    ],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const result = await updateDocBlock({
+                client,
+                blockId: parsed.blockId,
+                content: parsedContent,
+            });
+            emitMutation({
+                ctx,
+                data: result.block,
+                schema: docBlockUpdateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=block-update.js.map

package/dist/commands/doc/block-update.js.map

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

package/dist/commands/doc/create-in-workspace.d.ts

@@ -0,0 +1,76 @@
+/**
+ * `monday doc create-in-workspace --workspace <wid> --name <n>
+ * [--folder <fid>] [--kind public|private|share] [--dry-run]` —
+ * create a new workspace-scoped workdoc (`cli-design.md` §4.3
+ * DOC section + §13 v0.5 entry; `v0.5-plan.md` §3 M35 + §8 D7-D9).
+ *
+ * **Wire shape.** Single `create_doc(location: {workspace: ...})`
+ * round-trip via {@link createDocInWorkspace} against `mutation
+ * CreateDocInWorkspace` with `operationName:
+ * 'CreateDocInWorkspace'` (R-NEW-37 W2 audit-point). Returns the
+ * created `Document` with `id` populated post-create. The wire's
+ * `CreateDocInput` is mutually-exclusive between `board` (item-
+ * scoped) and `workspace` (workspace-scoped) variants per D7; this
+ * verb supplies only the `workspace` slot. The sibling verb
+ * `monday doc create-on-column` covers the board variant.
+ *
+ * **Argv shape.**
+ *
+ *   - `--workspace <wid>` — required (Monday's
+ *     `CreateDocWorkspaceInput.workspace_id` is `ID!`). Numeric
+ *     workspace ID; brand-validated via {@link WorkspaceIdSchema}
+ *     at the parse boundary.
+ *   - `--name <n>` — required (Monday's
+ *     `CreateDocWorkspaceInput.name` is `String!`). Empty string
+ *     rejects at parse.
+ *   - `--folder <fid>` — optional (maps to wire `folder_id: ID`).
+ *     Numeric folder ID; brand-validated via the existing folder-
+ *     id brand. Absent → omitted (doc lands at workspace root).
+ *   - `--kind <k>` — optional 3-value closed enum
+ *     (`public` / `private` / `share`); maps to wire
+ *     `kind: BoardKind`. Absent → omitted (Monday's wire applies
+ *     the workspace-default kind).
+ *
+ * **Output envelope.** Direct unwrap of the created Document —
+ * `data: <Document>`. Mirrors M32 `doc get` cadence (sans the
+ * `blocks` slot — Monday returns `blocks: null` on a fresh create).
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant.
+ * Minimal envelope listing the planned `create_doc` operation +
+ * the resolved input fields (`workspace_id`, `name`, optional
+ * `folder_id`, optional `kind`). No preflight read fires; the
+ * dry-run is purely argv-derived. `meta.source: 'none'`.
+ *
+ * **Idempotent: false.** Re-running `doc create-in-workspace
+ * --name foo` creates a SECOND doc with the same name (Monday
+ * allows duplicate doc names within a workspace). Agents that
+ * need idempotency must pair with a `doc list` lookup first.
+ *
+ * **Permission-sensitive.** Tokens lacking workdoc-create scope
+ * on the target workspace surface `forbidden` (mapped from
+ * Monday's PERMISSION_DENIED extension).
+ *
+ * **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 createDocInWorkspace} + projects via
+ * `emitMutation`.
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DocCreateInWorkspaceOutput } from '../../api/documents.js';
+declare const inputSchema: z.ZodObject<{
+    workspace: z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">;
+    name: z.ZodString;
+    folder: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DocFolderId", "out">>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        private: "private";
+        share: "share";
+    }>>;
+}, z.core.$strict>;
+export declare const docCreateInWorkspaceCommand: CommandModule<z.infer<typeof inputSchema>, DocCreateInWorkspaceOutput>;
+export {};
+//# sourceMappingURL=create-in-workspace.d.ts.map

package/dist/commands/doc/create-in-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-in-workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/doc/create-in-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKnE,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,WAAW;;;;;;;;;kBAON,CAAC;AAEZ,eAAO,MAAM,2BAA2B,EAAE,aAAa,CACrD,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,0BAA0B,CAoG3B,CAAC"}