monday-cli 0.2.0

package/dist/commands/run-by-id-lookup.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared get-by-id action helper (R7, surfaced post-M3 in
+ * `v0.1-plan.md` §15).
+ *
+ * Six v0.1 commands share a near-identical action shape:
+ *
+ *   1. `parseArgv` against the per-command input schema (positional
+ *      ID arg).
+ *   2. `resolveClient(ctx, program.opts())`.
+ *   3. `client.raw<{ <plural>: unknown[] | null }>(QUERY, {ids:[id]},
+ *      {operationName})`.
+ *   4. Extract `first = data.<plural>?.[0]` and raise `not_found` if
+ *      undefined / null.
+ *   5. Project (`schema.parse(first)` or a custom projector — `item
+ *      get` injects the column-value projection here).
+ *   6. `emitSuccess({...toEmit(response)})`.
+ *
+ * The helper compresses steps 2-6 so each command's action body is
+ * `parseArgv → runByIdLookup`. Per the trigger in §15, M4's
+ * `item get` was the 6th example — the helper's project-callback
+ * shape was the only design knob `item get` exercised that the M3
+ * five didn't. Item get fits cleanly via the optional `project`
+ * callback; the other five commands omit it (defaulting to
+ * `schema.parse`).
+ *
+ * Scoped narrowly to the get-by-id sub-shape; list / find /
+ * describe / page-walking commands stay explicit. The broader
+ * `defineNetworkCommand` factory (M2.5 R4) remains deferred — R7's
+ * narrower scope is the genuinely-identical cluster, and the wider
+ * factory would freeze the wrong abstraction at this milestone.
+ */
+import type { z } from 'zod';
+import type { RunContext } from '../cli/run.js';
+export interface RunByIdLookupInputs<O> {
+    readonly ctx: RunContext;
+    /** `program.opts()` from the commander action body. */
+    readonly programOpts: unknown;
+    readonly query: string;
+    readonly operationName: string;
+    /**
+     * Plural collection name in Monday's response shape:
+     * `'workspaces'`, `'boards'`, `'users'`, `'updates'`, `'items'`.
+     * Picked by string-key rather than a typed projector to keep the
+     * helper untyped on the response field — the per-command schema
+     * already validates the element shape.
+     */
+    readonly collectionKey: string;
+    /** The branded ID to send in `ids: [<id>]`. */
+    readonly id: string;
+    /**
+     * snake_case detail key on the `not_found` envelope's `details`,
+     * matching the resource (`workspace_id`, `item_id`, etc.).
+     * Documented per command in `cli-design.md` §6.5.
+     */
+    readonly errorDetailKey: string;
+    /**
+     * Singular kind name used in the `not_found` message
+     * (`workspace`, `item`, …). Stylistic — agents key off `code`,
+     * but humans read the message.
+     */
+    readonly kind: string;
+    readonly schema: z.ZodType<O>;
+    /**
+     * Optional projector. Defaults to `schema.parse`. `item get` wires
+     * this to a parse-then-project step — the raw GraphQL element
+     * goes through `rawItemSchema.parse` first, then `projectItem` to
+     * derive the §6.2 typed column shape.
+     */
+    readonly project?: (raw: unknown) => O;
+}
+export declare const runByIdLookup: <O>(inputs: RunByIdLookupInputs<O>) => Promise<void>;
+//# sourceMappingURL=run-by-id-lookup.d.ts.map

package/dist/commands/run-by-id-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-by-id-lookup.d.ts","sourceRoot":"","sources":["../../src/commands/run-by-id-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;CACxC;AAKD,eAAO,MAAM,aAAa,GAAU,CAAC,EACnC,QAAQ,mBAAmB,CAAC,CAAC,CAAC,KAC7B,OAAO,CAAC,IAAI,CA8Bd,CAAC"}

package/dist/commands/run-by-id-lookup.js

@@ -0,0 +1,58 @@
+/**
+ * Shared get-by-id action helper (R7, surfaced post-M3 in
+ * `v0.1-plan.md` §15).
+ *
+ * Six v0.1 commands share a near-identical action shape:
+ *
+ *   1. `parseArgv` against the per-command input schema (positional
+ *      ID arg).
+ *   2. `resolveClient(ctx, program.opts())`.
+ *   3. `client.raw<{ <plural>: unknown[] | null }>(QUERY, {ids:[id]},
+ *      {operationName})`.
+ *   4. Extract `first = data.<plural>?.[0]` and raise `not_found` if
+ *      undefined / null.
+ *   5. Project (`schema.parse(first)` or a custom projector — `item
+ *      get` injects the column-value projection here).
+ *   6. `emitSuccess({...toEmit(response)})`.
+ *
+ * The helper compresses steps 2-6 so each command's action body is
+ * `parseArgv → runByIdLookup`. Per the trigger in §15, M4's
+ * `item get` was the 6th example — the helper's project-callback
+ * shape was the only design knob `item get` exercised that the M3
+ * five didn't. Item get fits cleanly via the optional `project`
+ * callback; the other five commands omit it (defaulting to
+ * `schema.parse`).
+ *
+ * Scoped narrowly to the get-by-id sub-shape; list / find /
+ * describe / page-walking commands stay explicit. The broader
+ * `defineNetworkCommand` factory (M2.5 R4) remains deferred — R7's
+ * narrower scope is the genuinely-identical cluster, and the wider
+ * factory would freeze the wrong abstraction at this milestone.
+ */
+import { ApiError } from '../utils/errors.js';
+import { resolveClient } from '../api/resolve-client.js';
+import { emitSuccess } from './emit.js';
+const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+export const runByIdLookup = async (inputs) => {
+    const { client, toEmit } = resolveClient(inputs.ctx, inputs.programOpts);
+    const response = await client.raw(inputs.query, { ids: [inputs.id] }, { operationName: inputs.operationName });
+    const data = response.data;
+    // The response shape is `{ <plural>: unknown[] | null }`; we read
+    // structurally so the helper can serve every command without a
+    // separately-typed RawXxx interface per noun.
+    const collection = isObject(data) ? data[inputs.collectionKey] : null;
+    const first = Array.isArray(collection) ? collection[0] : undefined;
+    if (first === undefined || first === null) {
+        throw new ApiError('not_found', `Monday returned no ${inputs.kind} for id ${inputs.id}`, { details: { [inputs.errorDetailKey]: inputs.id } });
+    }
+    const project = inputs.project ?? ((raw) => inputs.schema.parse(raw));
+    const projected = project(first);
+    emitSuccess({
+        ctx: inputs.ctx,
+        data: projected,
+        schema: inputs.schema,
+        programOpts: inputs.programOpts,
+        ...toEmit(response),
+    });
+};
+//# sourceMappingURL=run-by-id-lookup.js.map

package/dist/commands/run-by-id-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-by-id-lookup.js","sourceRoot":"","sources":["../../src/commands/run-by-id-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAwCxC,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAgC,EAAE,CAC5D,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,MAA8B,EACf,EAAE;IACjB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,MAAM,CAAC,KAAK,EACZ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EACpB,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CACxC,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,kEAAkE;IAClE,+DAA+D;IAC/D,8CAA8C;IAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,MAAM,KAAK,GAAY,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,sBAAsB,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,EAAE,EAAE,EACvD,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CACpD,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,GAAY,EAAK,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,WAAW,CAAC;QACV,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,MAAM,CAAC,QAAQ,CAAC;KACpB,CAAC,CAAC;AACL,CAAC,CAAC"}

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

@@ -0,0 +1,104 @@
+/**
+ * `monday schema [<command>]` — emits the CLI surface as JSON Schema
+ * 2020-12 (`cli-design.md` §11.1).
+ *
+ * Two consumers:
+ *
+ *  - **Agents.** Ingest `monday schema --json` once per session;
+ *    every command's input flags + output shape are described
+ *    machine-readably. No `--help` scraping, no doc parsing,
+ *    no English-message dependence. The error-code list is
+ *    embedded so agents key off `code` against the same source
+ *    of truth this CLI does.
+ *
+ *  - **The CLI itself.** Every command's `outputSchema` is the
+ *    same zod schema the `emitSuccess` drift-catch reads. The
+ *    schema command and the runtime contract can never diverge
+ *    because there's only one schema.
+ *
+ * `z.toJSONSchema` (zod v4 native) handles brand / refinement /
+ * coercion round-trips that earlier zod-to-JSON-Schema libs got
+ * wrong. Sharp-edge note: brands erase to their wrapped type in
+ * the JSON Schema output (a `BoardId` becomes a `string` with
+ * the regex), which is the right behaviour for an external
+ * consumer — they validate against the wire shape, not the brand.
+ *
+ * Idempotent: yes — pure read.
+ *
+ * The command lives at the top of the namespace (`monday schema`),
+ * not as a verb under a noun, because it describes the entire
+ * surface, not a Monday concept.
+ */
+import { z } from 'zod';
+import type { CommandModule } from '../types.js';
+export declare const schemaOutputSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"1">;
+    api_version: z.ZodString;
+    cli_version: z.ZodString;
+    commands: z.ZodRecord<z.ZodString, z.ZodObject<{
+        name: z.ZodString;
+        summary: z.ZodString;
+        examples: z.ZodArray<z.ZodString>;
+        idempotent: z.ZodBoolean;
+        input: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+        output: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    }, z.core.$strict>>;
+    error_codes: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            usage_error: "usage_error";
+            confirmation_required: "confirmation_required";
+            not_found: "not_found";
+            ambiguous_name: "ambiguous_name";
+            ambiguous_column: "ambiguous_column";
+            ambiguous_match: "ambiguous_match";
+            column_not_found: "column_not_found";
+            user_not_found: "user_not_found";
+            unsupported_column_type: "unsupported_column_type";
+            column_archived: "column_archived";
+            unauthorized: "unauthorized";
+            forbidden: "forbidden";
+            rate_limited: "rate_limited";
+            complexity_exceeded: "complexity_exceeded";
+            daily_limit_exceeded: "daily_limit_exceeded";
+            concurrency_exceeded: "concurrency_exceeded";
+            ip_rate_limited: "ip_rate_limited";
+            resource_locked: "resource_locked";
+            validation_failed: "validation_failed";
+            stale_cursor: "stale_cursor";
+            config_error: "config_error";
+            cache_error: "cache_error";
+            network_error: "network_error";
+            timeout: "timeout";
+            dev_not_configured: "dev_not_configured";
+            dev_board_misconfigured: "dev_board_misconfigured";
+            internal_error: "internal_error";
+        }>;
+        exit_code: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<130>]>;
+        retryable: z.ZodBoolean;
+        typical_http_status: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    exit_codes: z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        meaning: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SchemaOutput = z.infer<typeof schemaOutputSchema>;
+declare const inputSchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export interface BuildSchemaOptions {
+    readonly modules: readonly CommandModule[];
+    readonly apiVersion: string;
+    readonly cliVersion: string;
+    /** When set, narrow `commands` to just this dotted name. */
+    readonly only?: string;
+}
+/**
+ * Pure builder so unit tests can validate the emitted shape against
+ * a JSON Schema validator without spawning commander / running an
+ * envelope through emit.
+ */
+export declare const buildSchemaOutput: (options: BuildSchemaOptions) => SchemaOutput;
+export declare const schemaCommand: CommandModule<z.infer<typeof inputSchema>, SchemaOutput>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAiDjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAUZ,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAaD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,kBAAkB,KAAG,YAoC/D,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,aAAa,CACvC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,YAAY,CA0Cb,CAAC"}

package/dist/commands/schema/index.js

@@ -0,0 +1,183 @@
+/**
+ * `monday schema [<command>]` — emits the CLI surface as JSON Schema
+ * 2020-12 (`cli-design.md` §11.1).
+ *
+ * Two consumers:
+ *
+ *  - **Agents.** Ingest `monday schema --json` once per session;
+ *    every command's input flags + output shape are described
+ *    machine-readably. No `--help` scraping, no doc parsing,
+ *    no English-message dependence. The error-code list is
+ *    embedded so agents key off `code` against the same source
+ *    of truth this CLI does.
+ *
+ *  - **The CLI itself.** Every command's `outputSchema` is the
+ *    same zod schema the `emitSuccess` drift-catch reads. The
+ *    schema command and the runtime contract can never diverge
+ *    because there's only one schema.
+ *
+ * `z.toJSONSchema` (zod v4 native) handles brand / refinement /
+ * coercion round-trips that earlier zod-to-JSON-Schema libs got
+ * wrong. Sharp-edge note: brands erase to their wrapped type in
+ * the JSON Schema output (a `BoardId` becomes a `string` with
+ * the regex), which is the right behaviour for an external
+ * consumer — they validate against the wire shape, not the brand.
+ *
+ * Idempotent: yes — pure read.
+ *
+ * The command lives at the top of the namespace (`monday schema`),
+ * not as a verb under a noun, because it describes the entire
+ * surface, not a Monday concept.
+ */
+import { z } from 'zod';
+import { CODE_RETRYABLE_DEFAULT, CODE_TYPICAL_HTTP_STATUS, ERROR_CODES, exitCodeForError, UsageError, } from '../../utils/errors.js';
+import { getCommandRegistry } from '../index.js';
+import { emitSuccess } from '../emit.js';
+const jsonSchemaSchema = z.unknown();
+const commandEntrySchema = z
+    .object({
+    name: z.string().min(1),
+    summary: z.string().min(1),
+    examples: z.array(z.string()),
+    idempotent: z.boolean(),
+    input: jsonSchemaSchema,
+    output: jsonSchemaSchema,
+})
+    .strict();
+const errorCodeEntrySchema = z
+    .object({
+    code: z.enum(ERROR_CODES),
+    exit_code: z.union([
+        z.literal(0),
+        z.literal(1),
+        z.literal(2),
+        z.literal(3),
+        z.literal(130),
+    ]),
+    /**
+     * Default retry policy per `cli-design.md` §6.5. Per-instance
+     * `error.retryable` may override (e.g. a Monday rate-limit
+     * response with a custom Retry-After) — agents check the live
+     * envelope first, fall back to this hint.
+     */
+    retryable: z.boolean(),
+    /**
+     * Typical HTTP status when this code originates from Monday's
+     * API. `null` for codes with no fixed expectation (config /
+     * cache / usage failures, anything originating local).
+     */
+    typical_http_status: z.number().int().nullable(),
+})
+    .strict();
+const exitCodeEntrySchema = z
+    .object({
+    code: z.number().int(),
+    meaning: z.string().min(1),
+})
+    .strict();
+export const schemaOutputSchema = z
+    .object({
+    schema_version: z.literal('1'),
+    api_version: z.string().min(1),
+    cli_version: z.string().min(1),
+    commands: z.record(z.string(), commandEntrySchema),
+    error_codes: z.array(errorCodeEntrySchema),
+    exit_codes: z.array(exitCodeEntrySchema),
+})
+    .strict();
+const inputSchema = z
+    .object({
+    command: z.string().min(1).optional(),
+})
+    .strict();
+const EXIT_CODES = [
+    { code: 0, meaning: 'success' },
+    { code: 1, meaning: 'usage error (bad flags, missing required args)' },
+    { code: 2, meaning: 'API or local-resource error (network, cache, validation)' },
+    { code: 3, meaning: 'config error (missing/invalid token)' },
+    { code: 130, meaning: 'aborted by SIGINT' },
+];
+const toCommandEntry = (mod) => ({
+    name: mod.name,
+    summary: mod.summary,
+    examples: [...mod.examples],
+    idempotent: mod.idempotent,
+    input: z.toJSONSchema(mod.inputSchema),
+    output: z.toJSONSchema(mod.outputSchema),
+});
+/**
+ * Pure builder so unit tests can validate the emitted shape against
+ * a JSON Schema validator without spawning commander / running an
+ * envelope through emit.
+ */
+export const buildSchemaOutput = (options) => {
+    let modules;
+    if (options.only !== undefined) {
+        const found = options.modules.find((m) => m.name === options.only);
+        if (found === undefined) {
+            const available = options.modules.map((m) => m.name).sort();
+            throw new UsageError(`unknown command "${options.only}"`, {
+                details: { hint: 'see `monday schema` for the full list', available },
+            });
+        }
+        modules = [found];
+    }
+    else {
+        modules = options.modules;
+    }
+    // Lexicographic order so two runs in different registration order
+    // produce byte-equal output — agents diff `monday schema --json`
+    // across versions to spot contract changes.
+    const sorted = [...modules].sort((a, b) => a.name.localeCompare(b.name));
+    const commands = Object.fromEntries(sorted.map((m) => [m.name, toCommandEntry(m)]));
+    return {
+        schema_version: '1',
+        api_version: options.apiVersion,
+        cli_version: options.cliVersion,
+        commands,
+        error_codes: ERROR_CODES.map((code) => ({
+            code,
+            exit_code: exitCodeForError(code),
+            retryable: CODE_RETRYABLE_DEFAULT[code],
+            typical_http_status: CODE_TYPICAL_HTTP_STATUS[code],
+        })),
+        exit_codes: [...EXIT_CODES],
+    };
+};
+export const schemaCommand = {
+    name: 'schema',
+    summary: 'Emit the CLI command surface as JSON Schema 2020-12',
+    examples: [
+        'monday schema --json',
+        'monday schema config.show --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: schemaOutputSchema,
+    attach: (program, ctx) => {
+        program
+            .command('schema')
+            .argument('[command]', 'narrow output to a single command (dotted name, e.g. config.show)')
+            .description(schemaCommand.summary)
+            .addHelpText('after', ['', 'Examples:', ...schemaCommand.examples.map((e) => `  ${e}`), ''].join('\n'))
+            .action((commandArg, opts) => {
+            const parsed = schemaCommand.inputSchema.parse({
+                ...(commandArg === undefined ? {} : { command: commandArg }),
+                ...opts,
+            });
+            const data = buildSchemaOutput({
+                modules: getCommandRegistry(),
+                apiVersion: ctx.env.MONDAY_API_VERSION ?? '2026-01',
+                cliVersion: ctx.cliVersion,
+                ...(parsed.command === undefined ? {} : { only: parsed.command }),
+            });
+            emitSuccess({
+                ctx,
+                data,
+                schema: schemaCommand.outputSchema,
+                programOpts: program.opts(),
+            });
+        });
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/commands/schema/index.js.map

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

package/dist/commands/types.d.ts

@@ -0,0 +1,66 @@
+import type { Command } from 'commander';
+import type { z } from 'zod';
+import type { RunContext } from '../cli/run.js';
+/**
+ * A registered CLI command (`v0.1-plan.md` §4 DoD #2).
+ *
+ * Every command — top-level (`schema`) or noun-verb (`config show`)
+ * — exports one of these. The static `commandRegistry`
+ * (`src/commands/index.ts`) collects them; `run()` walks the registry
+ * once per invocation to wire commander, and `monday schema` walks
+ * the same registry to emit JSON Schema.
+ *
+ * The contract is:
+ *
+ *  - `name` is the dotted path from `monday`: `"config.show"`,
+ *    `"cache.clear"`, `"schema"`. Used as the JSON Schema key and the
+ *    `monday schema <command>` argument.
+ *  - `inputSchema` validates the parsed argv at the action boundary
+ *    (per `validation.md` "parse, don't validate"). It's the source
+ *    of truth for `monday schema`'s input description.
+ *  - `outputSchema` describes the `data` payload the success envelope
+ *    will carry — it's executable, so the integration tests can
+ *    `outputSchema.parse(data)` to catch drift, and `monday schema`
+ *    emits it via `z.toJSONSchema`.
+ *  - `attach(program, ctx)` wires the command onto commander. It owns
+ *    parent-noun creation (`ensureSubcommand`), positional / flag
+ *    declarations, the `addHelpText('after', ...)` example, and the
+ *    action body. The action: parses argv via `inputSchema`, calls
+ *    the command's logic, validates via `outputSchema`, and emits
+ *    via `emitSuccess`.
+ *
+ * Why a generic interface and not a concrete class: per-command
+ * differences (positional vs flag-only, single-resource vs
+ * collection, accepts-stdin or not) are best captured as code in
+ * `attach` rather than ferried through shared options that grow
+ * unbounded as the surface expands.
+ */
+export interface CommandModule<I = unknown, O = unknown> {
+    readonly name: string;
+    /** One-line summary used as `description()` on commander. */
+    readonly summary: string;
+    /**
+     * Usage examples emitted via `addHelpText('after', ...)`. Per the
+     * `cli.md` rule, every command has at least one. Lines should
+     * start with `monday <cmd>` (no `$` prefix — the dollar-sign hurts
+     * copy-paste).
+     */
+    readonly examples: readonly string[];
+    /**
+     * Documented per command (`v0.1-plan.md` §4 DoD #6). Read-only
+     * commands are trivially idempotent; mutations document explicitly
+     * whether re-running with the same args is safe.
+     */
+    readonly idempotent: boolean;
+    readonly inputSchema: z.ZodType<I>;
+    readonly outputSchema: z.ZodType<O>;
+    readonly attach: (program: Command, ctx: RunContext) => void;
+}
+/**
+ * Idempotently finds-or-creates a noun-level command on `program`.
+ * Multiple verb commands share the same parent (`monday config show`,
+ * `monday config path`); each `attach` calls this so the parent is
+ * registered exactly once regardless of registration order.
+ */
+export declare const ensureSubcommand: (program: Command, name: string, summary: string) => Command;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,EAChB,MAAM,MAAM,EACZ,SAAS,MAAM,KACd,OAOF,CAAC"}

package/dist/commands/types.js

@@ -0,0 +1,15 @@
+/**
+ * Idempotently finds-or-creates a noun-level command on `program`.
+ * Multiple verb commands share the same parent (`monday config show`,
+ * `monday config path`); each `attach` calls this so the parent is
+ * registered exactly once regardless of registration order.
+ */
+export const ensureSubcommand = (program, name, summary) => {
+    const existing = program.commands.find((c) => c.name() === name);
+    if (existing !== undefined) {
+        return existing;
+    }
+    const child = program.command(name).description(summary);
+    return child;
+};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AA4DA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAgB,EAChB,IAAY,EACZ,OAAe,EACN,EAAE;IACX,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;IACjE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/commands/update/body-source.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared body-source resolver for the comment-cluster verbs (`update
+ * create` / `update reply` / `update edit`). Lifted out of M5b's
+ * `update create` when the third consumer arrived — `update edit`
+ * (M13) — per the v0.1-plan §17 R-timing rule ("lift on the third
+ * consumer").
+ *
+ * Reads the markdown body from one of the three accepted sources:
+ *
+ *   1. `--body <md>` (`inlineBody`) — inline.
+ *   2. `--body-file <path>` (`bodyFile`) — from disk.
+ *   3. `--body-file -` — from stdin (`ctx.stdin`).
+ *
+ * Throws `usage_error` for:
+ *   - Both `--body` and `--body-file` set (mutually exclusive).
+ *   - Neither set (no source).
+ *   - `--body-file -` with no `ctx.stdin` available (programmer
+ *     wiring bug; should not happen via the binary).
+ *   - Empty (or whitespace-only) result after read (Monday rejects
+ *     empty body strings; surface up-front rather than wait for
+ *     `validation_failed`).
+ */
+export interface ReadBodyInputs {
+    /** `--body <md>` value (per-command flag). */
+    readonly inlineBody: string | undefined;
+    /** `--body-file <path>` value (global flag — see `types/global-flags.ts`). */
+    readonly bodyFile: string | undefined;
+    /** `ctx.stdin` from the runner — needed for `--body-file -`. */
+    readonly stdin: NodeJS.ReadableStream | undefined;
+    /**
+     * Verb name for the "no source" error message (e.g. "monday update
+     * reply requires either --body <md> or ..."). Defaults to a generic
+     * phrasing if omitted.
+     */
+    readonly verbHint?: string;
+}
+export declare const readUpdateBody: (inputs: ReadBodyInputs) => Promise<string>;
+//# sourceMappingURL=body-source.d.ts.map

package/dist/commands/update/body-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-source.d.ts","sourceRoot":"","sources":["../../../src/commands/update/body-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,GAAG,SAAS,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,eAAO,MAAM,cAAc,GACzB,QAAQ,cAAc,KACrB,OAAO,CAAC,MAAM,CAuEhB,CAAC"}

package/dist/commands/update/body-source.js

@@ -0,0 +1,80 @@
+/**
+ * Shared body-source resolver for the comment-cluster verbs (`update
+ * create` / `update reply` / `update edit`). Lifted out of M5b's
+ * `update create` when the third consumer arrived — `update edit`
+ * (M13) — per the v0.1-plan §17 R-timing rule ("lift on the third
+ * consumer").
+ *
+ * Reads the markdown body from one of the three accepted sources:
+ *
+ *   1. `--body <md>` (`inlineBody`) — inline.
+ *   2. `--body-file <path>` (`bodyFile`) — from disk.
+ *   3. `--body-file -` — from stdin (`ctx.stdin`).
+ *
+ * Throws `usage_error` for:
+ *   - Both `--body` and `--body-file` set (mutually exclusive).
+ *   - Neither set (no source).
+ *   - `--body-file -` with no `ctx.stdin` available (programmer
+ *     wiring bug; should not happen via the binary).
+ *   - Empty (or whitespace-only) result after read (Monday rejects
+ *     empty body strings; surface up-front rather than wait for
+ *     `validation_failed`).
+ */
+import { readFile } from 'node:fs/promises';
+import { UsageError } from '../../utils/errors.js';
+const DEFAULT_NO_SOURCE_VERB = 'monday update create / reply / edit requires either --body <md> or ' +
+    '--body-file <path>. Use --body-file - to read from stdin.';
+export const readUpdateBody = async (inputs) => {
+    const { inlineBody, bodyFile, stdin } = inputs;
+    const verbHint = inputs.verbHint ?? DEFAULT_NO_SOURCE_VERB;
+    if (inlineBody !== undefined && bodyFile !== undefined) {
+        throw new UsageError('--body and --body-file are mutually exclusive; pick one.', { details: { has_inline_body: true, body_file: bodyFile } });
+    }
+    if (inlineBody !== undefined) {
+        if (inlineBody.trim().length === 0) {
+            // Empty-after-trim must reject too — `--body "   "` shouldn't
+            // sneak past and surface as Monday's `validation_failed`
+            // post-mutation. Same trim policy the file / stdin branches
+            // apply.
+            throw new UsageError('--body cannot be empty (or whitespace-only). Pass markdown ' +
+                'content or use --body-file <path> to read from disk / stdin.');
+        }
+        return inlineBody;
+    }
+    if (bodyFile === undefined) {
+        throw new UsageError(verbHint);
+    }
+    if (bodyFile === '-') {
+        if (stdin === undefined) {
+            throw new UsageError('--body-file - requested stdin, but no stdin is wired into ' +
+                'the runner. This is a programmer wiring bug.');
+        }
+        const chunks = [];
+        for await (const chunk of stdin) {
+            chunks.push(Buffer.from(chunk));
+        }
+        const body = Buffer.concat(chunks).toString('utf8').trimEnd();
+        if (body.length === 0) {
+            throw new UsageError('stdin produced an empty body. Pipe non-empty content into ' +
+                '--body-file - or pass --body <md> inline.', { details: { body_file: '-' } });
+        }
+        return body;
+    }
+    // File on disk. UTF-8 always; binary content would corrupt the
+    // markdown anyway. Trim trailing whitespace so a trailing newline
+    // from `cat foo.md` doesn't surface as a literal `\n` in the
+    // posted comment.
+    const raw = await readFile(bodyFile, 'utf8').catch((err) => {
+        throw new UsageError(`--body-file: failed to read ${JSON.stringify(bodyFile)} (${err instanceof Error ? err.message : String(err)}).`, {
+            cause: err,
+            details: { body_file: bodyFile },
+        });
+    });
+    const body = raw.trimEnd();
+    if (body.length === 0) {
+        throw new UsageError(`--body-file: ${JSON.stringify(bodyFile)} is empty (after trim). ` +
+            `Monday rejects empty comment bodies.`, { details: { body_file: bodyFile } });
+    }
+    return body;
+};
+//# sourceMappingURL=body-source.js.map