monday-cli 0.2.0

package/dist/utils/errors.js

@@ -0,0 +1,264 @@
+/**
+ * Typed errors for the CLI. Every thrown error carries a stable
+ * `code` from `cli-design.md` §6.5 — agents key off the code, never
+ * the English `message`. v0.1 froze 26 codes; `ambiguous_match` ships
+ * in v0.2 M12 (`item upsert` with 2+ matches), bringing the count to
+ * 27. `dev_*` codes ship in v0.3 but are listed here so the M5b agent
+ * doesn't need to backfill the type.
+ */
+export const ERROR_CODES = [
+    'usage_error',
+    'confirmation_required',
+    'not_found',
+    'ambiguous_name',
+    'ambiguous_column',
+    'ambiguous_match',
+    'column_not_found',
+    'user_not_found',
+    'unsupported_column_type',
+    'column_archived',
+    'unauthorized',
+    'forbidden',
+    'rate_limited',
+    'complexity_exceeded',
+    'daily_limit_exceeded',
+    'concurrency_exceeded',
+    'ip_rate_limited',
+    'resource_locked',
+    'validation_failed',
+    'stale_cursor',
+    'config_error',
+    'cache_error',
+    'network_error',
+    'timeout',
+    'dev_not_configured',
+    'dev_board_misconfigured',
+    'internal_error',
+];
+/**
+ * Base class for everything thrown out of `commands/` and `api/`.
+ * The shape mirrors `cli-design.md` §6.5 one-to-one — the runner
+ * builds the JSON envelope by reading these fields.
+ */
+export class MondayCliError extends Error {
+    code;
+    httpStatus;
+    mondayCode;
+    requestId;
+    retryable;
+    retryAfterSeconds;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = new.target.name;
+        this.code = code;
+        this.httpStatus = options.httpStatus;
+        this.mondayCode = options.mondayCode;
+        this.requestId = options.requestId;
+        // `retryable` defaults from a per-code table so callers can stay
+        // terse when the default matches; explicit `false`/`true` always wins.
+        this.retryable = options.retryable ?? CODE_RETRYABLE_DEFAULT[code];
+        this.retryAfterSeconds = options.retryAfterSeconds;
+        this.details = options.details;
+    }
+}
+/**
+ * `cli-design.md` §6.5 retryable column. Defaults only — callers
+ * override when Monday's response says otherwise (e.g. a `cache_error`
+ * that's auto-retried without cache becomes non-retryable to the user).
+ *
+ * Exported because `monday schema` surfaces this per code so agents
+ * can decide retry strategy without consuming a real error envelope
+ * first (Codex review §3). Frozen so a future import can't mutate
+ * the table out from under the schema emitter (the runtime view of
+ * the contract should be the same one across the process lifetime).
+ */
+export const CODE_RETRYABLE_DEFAULT = Object.freeze({
+    usage_error: false,
+    confirmation_required: false,
+    not_found: false,
+    ambiguous_name: false,
+    ambiguous_column: false,
+    ambiguous_match: false,
+    column_not_found: false,
+    user_not_found: false,
+    unsupported_column_type: false,
+    column_archived: false,
+    unauthorized: false,
+    forbidden: false,
+    rate_limited: true,
+    complexity_exceeded: true,
+    daily_limit_exceeded: false,
+    concurrency_exceeded: true,
+    ip_rate_limited: true,
+    resource_locked: true,
+    validation_failed: false,
+    stale_cursor: false,
+    config_error: false,
+    cache_error: true,
+    network_error: true,
+    timeout: true,
+    dev_not_configured: false,
+    dev_board_misconfigured: false,
+    internal_error: false,
+});
+/**
+ * Best-effort hint for the HTTP status the user would observe when
+ * this error originates from Monday. Most Monday application errors
+ * arrive with `200 OK` and a GraphQL `errors[]` payload, so a
+ * `null` here means "no fixed expectation; check the live envelope's
+ * `http_status` field". Surfaced via `monday schema` so agents can
+ * pre-build retry / backoff logic without observing an error first.
+ *
+ * Frozen for the same reason as `CODE_RETRYABLE_DEFAULT`.
+ */
+export const CODE_TYPICAL_HTTP_STATUS = Object.freeze({
+    usage_error: null,
+    confirmation_required: null,
+    not_found: 200,
+    ambiguous_name: null,
+    ambiguous_column: null,
+    ambiguous_match: null,
+    column_not_found: null,
+    user_not_found: null,
+    unsupported_column_type: null,
+    column_archived: 200,
+    unauthorized: 401,
+    forbidden: 403,
+    rate_limited: 200,
+    complexity_exceeded: 200,
+    daily_limit_exceeded: 200,
+    concurrency_exceeded: 200,
+    ip_rate_limited: 200,
+    resource_locked: 423,
+    validation_failed: 200,
+    stale_cursor: 200,
+    config_error: null,
+    cache_error: null,
+    network_error: null,
+    timeout: null,
+    dev_not_configured: null,
+    dev_board_misconfigured: null,
+    internal_error: null,
+});
+/** Bad flag / missing positional / mutually exclusive inputs. */
+export class UsageError extends MondayCliError {
+    constructor(message, options = {}) {
+        super('usage_error', message, options);
+    }
+}
+/** Destructive op without `--yes` (`cli-design.md` §3.1 #7). */
+export class ConfirmationRequiredError extends MondayCliError {
+    constructor(message, options = {}) {
+        super('confirmation_required', message, options);
+    }
+}
+/** Missing/invalid token, malformed config. Exit code 3. */
+export class ConfigError extends MondayCliError {
+    constructor(message, options = {}) {
+        super('config_error', message, options);
+    }
+}
+/** Local cache I/O failure — auto-retried without cache. */
+export class CacheError extends MondayCliError {
+    constructor(message, options = {}) {
+        super('cache_error', message, options);
+    }
+}
+/**
+ * Anything originating from the Monday API or transport layer —
+ * the API client (M2) maps GraphQL/HTTP/network failures to a
+ * specific code via `new ApiError(code, ...)`.
+ */
+export class ApiError extends MondayCliError {
+}
+/** Last-resort code for unknown errors — comes with a "report this" hint. */
+export class InternalError extends MondayCliError {
+    constructor(message, options = {}) {
+        super('internal_error', message, options);
+    }
+}
+/**
+ * Compile-time guard: forces a `never` to be reachable, so any path
+ * that hits it in practice is a bug. Used as the trailing branch of
+ * exhaustive switches over discriminated unions — adding a new case
+ * to the union without updating the switch fails type-checking
+ * locally rather than only at the call site.
+ */
+/* c8 ignore start — defensive guard; type system makes the `never`
+   parameter unreachable. Exists so adding a new variant to a
+   discriminated union without updating the consuming switch fails
+   type-checking, not silently. */
+const assertNever = (value, context) => {
+    throw new InternalError(`unreachable: ${context} reached with ${JSON.stringify(value)}`);
+};
+/* c8 ignore stop */
+/**
+ * Maps an error code to the exit code documented in `cli-design.md`
+ * §3.1 #5. Note `confirmation_required` is *not* exit 1 — it's a
+ * usage-style error that still wants a non-zero exit, but the design
+ * explicitly groups everything that's "the CLI rejected the call"
+ * under exit 1.
+ */
+export const exitCodeForError = (code) => {
+    switch (code) {
+        case 'usage_error':
+        case 'confirmation_required':
+            return 1;
+        case 'config_error':
+            return 3;
+        case 'not_found':
+        case 'ambiguous_name':
+        case 'ambiguous_column':
+        case 'ambiguous_match':
+        case 'column_not_found':
+        case 'user_not_found':
+        case 'unsupported_column_type':
+        case 'column_archived':
+        case 'unauthorized':
+        case 'forbidden':
+        case 'rate_limited':
+        case 'complexity_exceeded':
+        case 'daily_limit_exceeded':
+        case 'concurrency_exceeded':
+        case 'ip_rate_limited':
+        case 'resource_locked':
+        case 'validation_failed':
+        case 'stale_cursor':
+        case 'cache_error':
+        case 'network_error':
+        case 'timeout':
+        case 'dev_not_configured':
+        case 'dev_board_misconfigured':
+        case 'internal_error':
+            return 2;
+        /* c8 ignore next 2 — assertNever is an exhaustiveness guard. */
+        default:
+            return assertNever(code, 'exitCodeForError');
+    }
+};
+/**
+ * Maps an `AbortReason` to its surfaced error. SIGINT bypasses the
+ * envelope entirely (exit 130, no JSON on stderr — agents reading
+ * exit codes from `kill` already know why); timeouts are an `ApiError`
+ * with `code: "timeout"`; explicit `cancel` is whatever the caller
+ * decided when they aborted.
+ */
+export const errorForAbortReason = (reason) => {
+    switch (reason.kind) {
+        case 'timeout':
+            return new ApiError('timeout', `request timed out after ${reason.afterMs.toString()}ms`, { details: { timeout_ms: reason.afterMs } });
+        case 'sigint':
+            // The runner short-circuits on SIGINT before this is read, but
+            // surfacing a typed error keeps the contract symmetric.
+            return new MondayCliError('internal_error', 'aborted by SIGINT', {
+                details: { abort_reason: 'sigint' },
+            });
+        case 'cancel':
+            return new MondayCliError('internal_error', reason.reason ?? 'cancelled', { details: { abort_reason: 'cancel' } });
+        /* c8 ignore next 2 — assertNever is an exhaustiveness guard. */
+        default:
+            return assertNever(reason, 'errorForAbortReason');
+    }
+};
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,39 @@
+import { type RedactOptions } from './redact.js';
+/**
+ * stderr-only structured logger. Stdout carries the result; stderr
+ * is for human-only signal (`cli-design.md` §3.1 rule 1). Every
+ * payload runs through `redact()` first so the Monday API token
+ * never reaches a log line under any verbosity.
+ *
+ * Level matrix (`cli-design.md` §3.1, §4.4):
+ * - `error` — always emitted; even `--quiet` keeps these.
+ * - `warn`  — suppressed by `--quiet`; otherwise stderr text.
+ * - `info`  — TTY-only (follow-up hints, progress). Off when piped.
+ * - `debug` — `--verbose` only (request bodies, complexity cost).
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export interface LoggerOptions {
+    readonly stderr: NodeJS.WritableStream;
+    readonly isTTY: boolean;
+    readonly verbose: boolean;
+    readonly quiet: boolean;
+    /**
+     * Process env, used to auto-collect known sensitive values for
+     * the redactor's value-scan layer. When set, the logger pulls
+     * `MONDAY_API_TOKEN` (if non-empty) and merges it into
+     * `redactOptions.secrets`. This is the default-safe path for
+     * `--verbose` debug output — without it, a future caller that
+     * forgets to thread `redactOptions.secrets` through would leak
+     * the token verbatim into stderr (Codex M2 review §5).
+     */
+    readonly env?: NodeJS.ProcessEnv;
+    readonly redactOptions?: RedactOptions;
+}
+export interface Logger {
+    error: (payload: unknown) => void;
+    warn: (payload: unknown) => void;
+    info: (payload: unknown) => void;
+    debug: (payload: unknown) => void;
+}
+export declare const createLogger: (options: LoggerOptions) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAYD,eAAO,MAAM,YAAY,GAAI,SAAS,aAAa,KAAG,MAyCrD,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,49 @@
+import { redact } from './redact.js';
+const formatPayload = (payload) => {
+    if (typeof payload === 'string') {
+        return payload;
+    }
+    if (payload === undefined) {
+        return 'undefined';
+    }
+    return JSON.stringify(payload);
+};
+export const createLogger = (options) => {
+    const { stderr, isTTY, verbose, quiet, redactOptions, env } = options;
+    // Re-read env at write-time so a token loaded by `loadConfig`'s
+    // dotenv after the logger was constructed still gets scrubbed —
+    // matches the runner's collectSecrets-on-emit pattern.
+    const envForSecrets = env;
+    const write = (level, payload) => {
+        const explicitSecrets = redactOptions?.secrets ?? [];
+        const envToken = envForSecrets?.MONDAY_API_TOKEN;
+        const envSecrets = typeof envToken === 'string' && envToken.length > 0 ? [envToken] : [];
+        const mergedSecrets = [...explicitSecrets, ...envSecrets];
+        const effectiveOptions = mergedSecrets.length > 0
+            ? { ...(redactOptions ?? {}), secrets: mergedSecrets }
+            : redactOptions ?? {};
+        const redacted = redact(payload, effectiveOptions);
+        stderr.write(`monday: [${level}] ${formatPayload(redacted)}\n`);
+    };
+    return {
+        error: (payload) => {
+            write('error', payload);
+        },
+        warn: (payload) => {
+            if (!quiet) {
+                write('warn', payload);
+            }
+        },
+        info: (payload) => {
+            if (isTTY && !quiet) {
+                write('info', payload);
+            }
+        },
+        debug: (payload) => {
+            if (verbose) {
+                write('debug', payload);
+            }
+        },
+    };
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAyCzD,MAAM,aAAa,GAAG,CAAC,OAAgB,EAAU,EAAE;IACjD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAU,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAEtE,gEAAgE;IAChE,gEAAgE;IAChE,uDAAuD;IACvD,MAAM,aAAa,GAAG,GAAG,CAAC;IAC1B,MAAM,KAAK,GAAG,CAAC,KAAe,EAAE,OAAgB,EAAQ,EAAE;QACxD,MAAM,eAAe,GAAG,aAAa,EAAE,OAAO,IAAI,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,aAAa,EAAE,gBAAgB,CAAC;QACjD,MAAM,UAAU,GACd,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,aAAa,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,UAAU,CAAC,CAAC;QAC1D,MAAM,gBAAgB,GACpB,aAAa,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE;YACtD,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,KAAK,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YAChB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YAChB,IAAI,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBACpB,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/utils/output/envelope.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Universal envelope builders (`cli-design.md` §6).
+ *
+ * Every command's stdout JSON is built through one of four functions
+ * here so the shape stays in lockstep with the contract — the M2
+ * envelope contract test (`v0.1-plan.md` §5.2) inspects the output
+ * of every command and asserts the keys are present in the canonical
+ * order. Adding a top-level field is a non-breaking change *only* if
+ * it's tacked on the end of the canonical order; renames/reorders
+ * are a major-version bump.
+ */
+import type { ErrorCode, MondayCliError } from '../errors.js';
+export type SchemaVersion = '1';
+export declare const CURRENT_SCHEMA_VERSION: SchemaVersion;
+export type DataSource = 'live' | 'cache' | 'mixed' | 'none';
+export interface Complexity {
+    readonly used: number;
+    readonly remaining: number;
+    readonly reset_in_seconds: number;
+}
+export interface ColumnHead {
+    readonly id: string;
+    readonly type: string;
+    readonly title: string;
+}
+/**
+ * Inputs to `buildMeta`. Loose ordering — `buildMeta` slots them into
+ * the canonical envelope-meta order so per-command call sites don't
+ * have to think about it.
+ */
+export interface MetaInput {
+    readonly api_version: string;
+    readonly cli_version: string;
+    readonly request_id: string;
+    readonly source: DataSource;
+    readonly retrieved_at: string;
+    readonly cache_age_seconds?: number | null;
+    readonly complexity?: Complexity | null;
+    readonly dry_run?: boolean;
+    readonly next_cursor?: string | null;
+    readonly has_more?: boolean;
+    readonly total_returned?: number;
+    readonly columns?: Readonly<Record<string, ColumnHead>>;
+}
+export interface Meta {
+    readonly schema_version: SchemaVersion;
+    readonly api_version: string;
+    readonly cli_version: string;
+    readonly request_id: string;
+    readonly source: DataSource;
+    readonly cache_age_seconds: number | null;
+    readonly retrieved_at: string;
+    /**
+     * `cli-design.md` §6.1: "Always null without `--verbose` to avoid
+     * an extra GraphQL field on every query." So this field is always
+     * **present**; it's just `null` until `--verbose` makes the
+     * GraphQL `complexity` selection.
+     */
+    readonly complexity: Complexity | null;
+    readonly dry_run?: true;
+    readonly next_cursor?: string | null;
+    readonly has_more?: boolean;
+    readonly total_returned?: number;
+    readonly columns?: Readonly<Record<string, ColumnHead>>;
+}
+export interface Warning {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+export interface ErrorEnvelopeBody {
+    readonly code: ErrorCode;
+    readonly message: string;
+    readonly http_status: number | null;
+    readonly monday_code: string | null;
+    readonly request_id: string;
+    readonly retryable: boolean;
+    readonly retry_after_seconds: number | null;
+    readonly details: Readonly<Record<string, unknown>> | null;
+}
+export interface SuccessEnvelope<T> {
+    readonly ok: true;
+    readonly data: T;
+    readonly meta: Meta;
+    readonly warnings: readonly Warning[];
+}
+export interface MutationEnvelope<T> extends SuccessEnvelope<T> {
+    readonly side_effects?: readonly Readonly<Record<string, unknown>>[];
+    /**
+     * Token → resolved column ID map for the columns this mutation
+     * targeted. Per `cli-design.md` §5.3 step 2 line 709-710:
+     * "The resolved `column_id` is **echoed in mutation output**
+     * (§6.4 `resolved_ids`) so agents can capture stable IDs for
+     * future calls." The dry-run envelope's `planned_changes[].
+     * resolved_ids` carries the same shape; the live mutation
+     * envelope mirrors it so an agent's "set then re-read" loop
+     * can use the resolved ID without consulting metadata twice.
+     *
+     * Optional — present only on mutation envelopes that resolved
+     * tokens (read commands omit). The slot is canonical-position
+     * AFTER `side_effects` so the existing canonical key order
+     * stays stable.
+     */
+    readonly resolved_ids?: Readonly<Record<string, string>>;
+}
+export interface DryRunEnvelope {
+    readonly ok: true;
+    readonly data: null;
+    readonly meta: Meta;
+    readonly planned_changes: readonly Readonly<Record<string, unknown>>[];
+    readonly warnings: readonly Warning[];
+}
+export interface ErrorEnvelope {
+    readonly ok: false;
+    readonly error: ErrorEnvelopeBody;
+    readonly meta: Meta;
+}
+/**
+ * Builds a `meta` object in the canonical key order. Optional fields
+ * are only inserted when their input is defined — keeps unrelated
+ * commands from carrying empty `next_cursor`/`columns` pairs.
+ */
+export declare const buildMeta: (input: MetaInput) => Meta;
+export declare const buildSuccess: <T>(data: T, meta: Meta, warnings?: readonly Warning[]) => SuccessEnvelope<T>;
+export interface BuildMutationInputs<T> {
+    readonly data: T;
+    readonly meta: Meta;
+    readonly warnings?: readonly Warning[];
+    readonly sideEffects?: readonly Readonly<Record<string, unknown>>[];
+    /**
+     * Per cli-design §5.3 step 2: token → resolved column ID echo.
+     * Omit on mutations that don't resolve tokens (e.g. a future
+     * `item rename` that only writes `name`).
+     */
+    readonly resolvedIds?: Readonly<Record<string, string>>;
+}
+export declare const buildMutation: <T>(inputs: BuildMutationInputs<T>) => MutationEnvelope<T>;
+export declare const buildDryRun: (plannedChanges: readonly Readonly<Record<string, unknown>>[], meta: Meta, warnings?: readonly Warning[]) => DryRunEnvelope;
+export declare const buildError: (error: MondayCliError, meta: Meta) => ErrorEnvelope;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/utils/output/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/utils/output/envelope.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/envelope.js

@@ -0,0 +1,120 @@
+/**
+ * Universal envelope builders (`cli-design.md` §6).
+ *
+ * Every command's stdout JSON is built through one of four functions
+ * here so the shape stays in lockstep with the contract — the M2
+ * envelope contract test (`v0.1-plan.md` §5.2) inspects the output
+ * of every command and asserts the keys are present in the canonical
+ * order. Adding a top-level field is a non-breaking change *only* if
+ * it's tacked on the end of the canonical order; renames/reorders
+ * are a major-version bump.
+ */
+export const CURRENT_SCHEMA_VERSION = '1';
+/**
+ * Builds a `meta` object in the canonical key order. Optional fields
+ * are only inserted when their input is defined — keeps unrelated
+ * commands from carrying empty `next_cursor`/`columns` pairs.
+ */
+export const buildMeta = (input) => {
+    // Constructed via property assignment in canonical order; JS object
+    // literals preserve insertion order for string keys, which is what
+    // the snapshot tests rely on.
+    const meta = {
+        schema_version: CURRENT_SCHEMA_VERSION,
+        api_version: input.api_version,
+        cli_version: input.cli_version,
+        request_id: input.request_id,
+        source: input.source,
+        cache_age_seconds: input.cache_age_seconds ?? null,
+        retrieved_at: input.retrieved_at,
+        // §6.1: complexity is always present; null until --verbose
+        // selects the GraphQL field. Insert it at this fixed position
+        // so the canonical key order doesn't depend on the input.
+        complexity: input.complexity ?? null,
+    };
+    if (input.dry_run === true) {
+        meta.dry_run = true;
+    }
+    if (input.next_cursor !== undefined) {
+        meta.next_cursor = input.next_cursor;
+    }
+    if (input.has_more !== undefined) {
+        meta.has_more = input.has_more;
+    }
+    if (input.total_returned !== undefined) {
+        meta.total_returned = input.total_returned;
+    }
+    if (input.columns !== undefined) {
+        meta.columns = input.columns;
+    }
+    return meta;
+};
+export const buildSuccess = (data, meta, warnings = []) => ({
+    ok: true,
+    data,
+    meta,
+    warnings,
+});
+export const buildMutation = (inputs) => {
+    const env = {
+        ok: true,
+        data: inputs.data,
+        meta: inputs.meta,
+        warnings: inputs.warnings ?? [],
+    };
+    if (inputs.sideEffects !== undefined && inputs.sideEffects.length > 0) {
+        env.side_effects = inputs.sideEffects;
+    }
+    if (inputs.resolvedIds !== undefined) {
+        env.resolved_ids = inputs.resolvedIds;
+    }
+    return env;
+};
+export const buildDryRun = (plannedChanges, meta, warnings = []) => ({
+    ok: true,
+    data: null,
+    // `dry_run: true` is part of the contract — slot it in via buildMeta
+    // so the field lands in the canonical position.
+    meta: meta.dry_run === true ? meta : buildMeta({ ...metaInputFromMeta(meta), dry_run: true }),
+    planned_changes: plannedChanges,
+    warnings,
+});
+export const buildError = (error, meta) => ({
+    ok: false,
+    error: {
+        code: error.code,
+        message: error.message,
+        http_status: error.httpStatus ?? null,
+        monday_code: error.mondayCode ?? null,
+        request_id: error.requestId ?? meta.request_id,
+        retryable: error.retryable,
+        retry_after_seconds: error.retryAfterSeconds ?? null,
+        details: error.details ?? null,
+    },
+    meta,
+});
+const metaInputFromMeta = (meta) => {
+    const input = {
+        api_version: meta.api_version,
+        cli_version: meta.cli_version,
+        request_id: meta.request_id,
+        source: meta.source,
+        retrieved_at: meta.retrieved_at,
+        cache_age_seconds: meta.cache_age_seconds,
+        complexity: meta.complexity,
+    };
+    if (meta.next_cursor !== undefined) {
+        input.next_cursor = meta.next_cursor;
+    }
+    if (meta.has_more !== undefined) {
+        input.has_more = meta.has_more;
+    }
+    if (meta.total_returned !== undefined) {
+        input.total_returned = meta.total_returned;
+    }
+    if (meta.columns !== undefined) {
+        input.columns = meta.columns;
+    }
+    return input;
+};
+//# sourceMappingURL=envelope.js.map

package/dist/utils/output/envelope.js.map

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

package/dist/utils/output/json.d.ts

@@ -0,0 +1,10 @@
+/**
+ * JSON renderer (`cli-design.md` §3.1, §6).
+ *
+ * Pretty-prints with 2-space indent, trailing newline. Indentation
+ * keeps casual `cat`'d output readable; `jq` and other consumers
+ * tolerate whitespace fine. JSON output **never truncates** — that's
+ * the whole point of the format-vs-presentation split (§3.2).
+ */
+export declare const renderJson: (envelope: unknown, stream: NodeJS.WritableStream) => void;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/utils/output/json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,OAAO,EACjB,QAAQ,MAAM,CAAC,cAAc,KAC5B,IAEF,CAAC"}