monday-cli 0.4.0 → 0.5.0

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

@@ -0,0 +1,206 @@
+/**
+ * `monday doc block-create <doc-id> --type <DocBlockContentType>
+ * --content <json> [--after <bid>] [--parent <bid>] [--dry-run]` —
+ * create a new rich-text block inside an existing workdoc
+ * (`cli-design.md` §4.3 DOC section + §13 v0.5 entry;
+ * `v0.5-plan.md` §3 M36 + §8 D10-D11).
+ *
+ * **Wire shape.** Single `create_doc_block(doc_id, type, content,
+ * after_block_id?, parent_block_id?) → DocumentBlock` round-trip
+ * via {@link createDocBlock} against `mutation CreateDocBlock`
+ * with `operationName: 'CreateDocBlock'` (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
+ * (`doc_id`, `after_block_id`, `parent_block_id`) — back to Monday's
+ * standard cadence after the M35 camelCase asymmetry. The fetcher's
+ * GraphQL document maps camelCase variables to snake_case wire args
+ * (`doc_id: $docId`); CLI argv stays kebab-case (`--after <bid>` /
+ * `--parent <bid>`); error envelope `details.*` keys stay
+ * snake_case per cli-design §6.5. NOT a new R-NEW-41 supporting
+ * site — M36 is the symmetric path, M35 was the asymmetric one.
+ *
+ * **Argv shape.**
+ *
+ *   - `<doc-id>` — required positional (Monday's
+ *     `create_doc_block.doc_id` is `ID!`). Brand-validated via
+ *     {@link DocIdSchema}.
+ *   - `--type <t>` — required closed enum (16 values per the M36
+ *     empirical probe; see {@link DOC_BLOCK_CONTENT_TYPE_VALUES}).
+ *     Maps to wire `type: DocBlockContentType!`. Unknown values
+ *     reject at the parse boundary with `usage_error.details.
+ *     issues[]` per D10 closure.
+ *   - `--content <json>` — required JSON-string slot. Parsed once
+ *     at the argv boundary via `parseJsonArg` (R-NEW-42 helper, 4th
+ *     consumer; same shape `monday raw --vars` /
+ *     `board column-create --settings` / `webhook create --config`
+ *     use). The parsed JS value is passed through to Monday's wire
+ *     `JSON` scalar unmodified. **Per-type content payload
+ *     structure** varies across the 16 `DocBlockContentType`
+ *     variants per D11 — `docs/output-shapes.md` "Per-block content
+ *     shapes" reference table marks cassette-pinned shapes and
+ *     TBD / inferred variants pending live-probe cassettes. The CLI
+ *     accepts every variant + dispatches unmodified; a shape-
+ *     incompatible `--content` for the chosen `--type` surfaces
+ *     `validation_failed` from Monday at the live path. The CLI
+ *     doesn't pre-validate the inner content shape.
+ *   - `--after <bid>` — optional opaque-string block id (maps to
+ *     wire `after_block_id: String`). Brand-validated via
+ *     {@link DocBlockIdSchema}. Absent → block inserted at the
+ *     document head (Monday's wire default per probe description).
+ *   - `--parent <bid>` — optional opaque-string block id (maps to
+ *     wire `parent_block_id: String`). Brand-validated via
+ *     {@link DocBlockIdSchema}. Absent → block lands at the
+ *     document root level (no parent nesting).
+ *
+ * **Output envelope.** Direct unwrap of the created DocumentBlock
+ * — `data: <DocumentBlock>` per cli-design §6.1 single-record
+ * convention. Mirrors M35 `doc create-in-workspace` /
+ * `create-on-column` cadence (full Document direct-unwrap on
+ * create); M36 returns the per-block shape instead.
+ *
+ * **Dry-run shape** per cli-design §6.4 mutation-dry-run variant.
+ * Minimal envelope listing the planned `create_doc_block`
+ * operation + the resolved input fields (`doc_id`, `type`,
+ * `content`, optional `after_block_id`, optional `parent_block_id`).
+ * No preflight read fires; the dry-run is purely argv-derived.
+ * `meta.source: 'none'`.
+ *
+ * **Idempotent: false.** Re-running `doc block-create` creates a
+ * SECOND block under the same anchor (Monday's wire allows
+ * duplicate content blocks within a doc). Agents that need
+ * idempotency must pair with a `doc get <doc-id>` lookup first to
+ * verify the block doesn't already exist.
+ *
+ * **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 createDocBlock} + 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 { DocIdSchema, DocBlockIdSchema } from '../../types/ids.js';
+import { createDocBlock, DOC_BLOCK_CONTENT_TYPE_VALUES, docBlockCreateOutputSchema, } from '../../api/documents.js';
+const inputSchema = z
+    .object({
+    docId: DocIdSchema,
+    type: z.enum(DOC_BLOCK_CONTENT_TYPE_VALUES),
+    content: z.string().min(1, '--content must not be empty'),
+    after: DocBlockIdSchema.optional(),
+    parent: DocBlockIdSchema.optional(),
+})
+    .strict();
+export const docBlockCreateCommand = {
+    name: 'doc.block-create',
+    summary: 'Create a new rich-text block inside a workdoc (--type + --content required)',
+    examples: [
+        'monday doc block-create 88010 --type normal_text --content \'{"alignment":"left","content":"Hello"}\'',
+        'monday doc block-create 88010 --type code --content \'{"language":"ts","code":"console.log(1)"}\' --after blk_abc123',
+        'monday doc block-create 88010 --type bulleted_list --content \'{"items":["a","b"]}\' --parent blk_layout1',
+        'monday doc block-create 88010 --type divider --content \'{}\' --dry-run --json',
+    ],
+    // Monday allows duplicate content blocks within a doc — re-running
+    // creates a second block at the same anchor. Mark non-idempotent
+    // so agents don't naively retry on transient failures.
+    idempotent: false,
+    inputSchema,
+    outputSchema: docBlockCreateOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'doc', 'Workdoc commands');
+        noun
+            .command('block-create <docId>')
+            .description(docBlockCreateCommand.summary)
+            .requiredOption(`--type <${DOC_BLOCK_CONTENT_TYPE_VALUES.join('|')}>`, 'block content type (maps to wire `type: DocBlockContentType!`); 16 closed values')
+            .requiredOption('--content <json>', 'block content payload (JSON-encoded string parsed at argv boundary; shape varies per --type per Monday\'s `JSON` scalar)')
+            .option('--after <bid>', 'optional opaque block ID (maps to wire `after_block_id: String`); absent → block inserted at document head')
+            .option('--parent <bid>', 'optional opaque parent block ID (maps to wire `parent_block_id: String`); absent → block lands at document root')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...docBlockCreateCommand.examples.map((e) => `  ${e}`),
+            '',
+            'Notes:',
+            '  - `--content` must be a valid JSON string; per-block content shapes are documented in `output-shapes.md` "Per-block content shapes" reference table.',
+            '  - Monday allows duplicate blocks at the same anchor; this verb is non-idempotent.',
+            '  - `--dry-run` emits the planned `create_doc_block` operation + resolved input fields (no wire call fires; `meta.source: "none"`).',
+            '',
+        ].join('\n'))
+            .action(async (docIdArg, opts) => {
+            const parsed = parseArgv(docBlockCreateCommand.inputSchema, {
+                docId: docIdArg,
+                type: opts.type,
+                content: opts.content,
+                ...(opts.after === undefined ? {} : { after: opts.after }),
+                ...(opts.parent === undefined ? {} : { parent: opts.parent }),
+            });
+            // Parse the opaque `--content` JSON string once at the
+            // boundary. Threading the raw string to Monday's `JSON`
+            // scalar would double-encode (Monday sees a JSON-string-of-
+            // a-string); parsing to a JS value first sends the intended
+            // shape. R-NEW-42 lift: shared `parseJsonArg` helper.
+            const parsedContent = parseJsonArg(parsed.content, {
+                context: '--content must be a valid JSON-encoded string',
+                details: {
+                    doc_id: parsed.docId,
+                    type: parsed.type,
+                    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) {
+                const planned = {
+                    operation: 'create_doc_block',
+                    doc_id: parsed.docId,
+                    type: parsed.type,
+                    content: parsedContent,
+                };
+                if (parsed.after !== undefined) {
+                    planned.after_block_id = parsed.after;
+                }
+                if (parsed.parent !== undefined) {
+                    planned.parent_block_id = parsed.parent;
+                }
+                emitDryRun({
+                    ctx,
+                    programOpts: program.opts(),
+                    plannedChanges: [planned],
+                    source: 'none',
+                    cacheAgeSeconds: null,
+                    warnings: [],
+                    apiVersion,
+                });
+                return;
+            }
+            const result = await createDocBlock({
+                client,
+                docId: parsed.docId,
+                type: parsed.type,
+                content: parsedContent,
+                ...(parsed.after === undefined ? {} : { afterBlockId: parsed.after }),
+                ...(parsed.parent === undefined ? {} : { parentBlockId: parsed.parent }),
+            });
+            emitMutation({
+                ctx,
+                data: result.block,
+                schema: docBlockCreateCommand.outputSchema,
+                programOpts: program.opts(),
+                warnings: [],
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+                apiVersion,
+            });
+        });
+    },
+};
+//# sourceMappingURL=block-create.js.map

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

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

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"}