monday-cli 0.3.0 → 0.5.0

package/dist/api/assets.js

@@ -0,0 +1,519 @@
+/**
+ * Asset upload surface for the v0.4-M31 `monday item upload` +
+ * `monday update upload` verbs (`cli-design.md` §2.2 + §4.3 + §6.4
+ * + §13 v0.4 entry; `v0.4-plan.md` §3 M31).
+ *
+ * **Wire surface (empirical probe 2026-05-13, API `2026-01`).** Two
+ * Monday GraphQL multipart mutations land here:
+ *
+ *   - `Mutation.add_file_to_column(column_id: String!, file: File!,
+ *     item_id: ID!) → Asset` — attaches a file to a `file`-typed
+ *     column on a specific item. Note **`column_id` is `String!`
+ *     not `ID!`** (the SDK's column-id surface is consistently
+ *     `String!` because column IDs are user-defined-looking tokens
+ *     like `'files'` / `'attachments_3'` rather than numeric).
+ *   - `Mutation.add_file_to_update(file: File!, update_id: ID!) →
+ *     Asset` — attaches a file to an Update (comment) record. Item
+ *     ID is implicit (the update's parent item).
+ *
+ * Both mutations cross the wire via `multipart/form-data` per the
+ * standard GraphQL multipart-request specification (jaydenseric).
+ * The `File` scalar is Monday's own (NOT the spec-standard `Upload`);
+ * the multipart envelope is otherwise spec-compliant — `operations`
+ * + `map` JSON parts + the file part keyed by index `0`.
+ *
+ * **Asset object — 10 fields.** `id` (ID, non-null), `name` (String,
+ * non-null — the multipart `filename` parameter), `url` (String,
+ * non-null — direct download), `public_url` (String, non-null —
+ * sharable), `file_extension` (String, non-null), `file_size` (Int,
+ * non-null — bytes), `created_at` (Date, nullable), `uploaded_by`
+ * (User, non-null — the token's owner; projected to the slim
+ * `{id, name}` shape for envelope compactness), `original_geometry`
+ * (String, nullable — image dimensions like `'1920x1080'`),
+ * `url_thumbnail` (String, nullable — image thumbnails only).
+ *
+ * **R-NEW-41 3rd consumer fires here.** Asset upload is the third
+ * site (after M27 `Webhook.config` JSON/String asymmetry + M27
+ * `NotificationTargetType` collapse) where the wire-vs-CLI semantics
+ * carry a documented asymmetry. This module's transport choice
+ * (sibling multipart module, NOT extension of `transport.ts`) is
+ * itself the load-bearing asymmetry shape — the JSON envelope's
+ * `body: JSON.stringify(...)` invariant doesn't compose with
+ * multipart/form-data's `FormData`-driven boundary parameter, so
+ * the two transports live in sibling modules with parallel
+ * interfaces. See `docs/architecture.md` "Wire-vs-CLI semantics
+ * documentation conventions" for the canonical writeup.
+ *
+ * **No new ERROR_CODES (29 stays).** Asset-upload failures route
+ * through the existing codes:
+ *
+ *   - `usage_error` — file path doesn't exist / not readable
+ *     (`details.reason: 'file_not_readable'`); file is empty
+ *     (`details.reason: 'file_empty'`); upload exceeded Monday's
+ *     per-file size limit (Monday surfaces this server-side;
+ *     `details.reason: 'file_too_large'` rewrap).
+ *   - `unsupported_column_type` — `--column <col>` resolves to a
+ *     non-`file` column type. Hint points back at the §5.3 writer
+ *     surface (Monday writes files via `add_file_to_column` for
+ *     `file` columns only; other column types route via
+ *     `change_column_value`).
+ *   - `not_found` — item / update / column doesn't exist or isn't
+ *     visible to the token.
+ *   - `validation_failed` — Monday-side rejection of the upload
+ *     payload (malformed filename, server-side virus scan flag,
+ *     etc.).
+ *   - `forbidden` / `unauthorized` — token lacks asset-write scope.
+ *
+ * Monday's per-file size cap is plan-tier-dependent and NOT exposed
+ * via the schema (verified at M31 pre-flight probe — `Plan` +
+ * `Account` carry no file-quota fields). The CLI does NOT pre-check
+ * file size against a hardcoded ceiling; Monday's runtime rejection
+ * (typically `FILE_SIZE_LIMIT_EXCEEDED` or a generic 413) is rewrapped
+ * as `usage_error` with `details.reason: 'file_too_large'` +
+ * `details.file_size_bytes` (the local `fs.stat()` measurement
+ * captured at upload time — Monday's wire rejection may not surface
+ * a size field, but the CLI already has the local size from the
+ * read leg and threads it for a stable agent-keyed envelope).
+ *
+ * **Idempotency: NO.** Each successful upload mints a new Asset
+ * with a new ID — re-running `item upload` with the same args
+ * uploads the file a second time. Agents needing register-once
+ * semantics dedupe on the CLI side (e.g., read `Item.assets` first
+ * and skip the upload if a matching `Asset.name` exists).
+ *
+ * **Status: runtime body shipped at v0.4-M31 IMPL.** Both fetchers
+ * dispatch via `inputs.multipart.request(...)` wrapped in
+ * `withRetry(...)` per cli-design §2.5; the response-parse boundary
+ * uses `mapResponse` (mirroring `MondayClient.raw`'s discipline) +
+ * `assertResponseFieldPresent` for the schema-drift / null-payload
+ * distinction + `assetSchema.safeParse(...)` via `unwrapOrThrow`
+ * for the per-field shape. Server-side size-cap rewrap fires at
+ * the error-mapping layer below.
+ */
+import { z } from 'zod';
+import { ApiError, MondayCliError } from '../utils/errors.js';
+import { unwrapOrThrow } from '../utils/parse-boundary.js';
+import { parseComplexity } from './complexity.js';
+import { mapResponse, wrapTransportError } from './errors.js';
+import { withRetry } from './retry.js';
+import { assertResponseFieldPresent } from './response-root.js';
+/**
+ * Slim projection of Monday's `User` for the `Asset.uploaded_by`
+ * slot. Monday's full User type is ~30 fields; the envelope echoes
+ * only `id` + `name` (matching the M19 `User`-projection cadence
+ * elsewhere in the CLI — `account_tags`, `board describe`'s
+ * subscribers, etc.). Future verbs that need wider User detail
+ * (`user get <uid>`) read against the full type.
+ */
+export const uploadedBySchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+})
+    .strict();
+/**
+ * Asset read-projection shape — surfaces Monday's full 10-field
+ * `Asset` object (per `scripts/probe/m31-asset-upload.ts` 2026-05-13,
+ * API `2026-01`). The output envelope echoes this verbatim so an
+ * agent reading the upload result has every field a follow-up
+ * `Query.assets(ids:)` read would surface, plus the inputs the CLI
+ * sent (echoed by the caller, not this module).
+ *
+ * `original_geometry` + `url_thumbnail` are image-only; nullable
+ * for non-image uploads. `created_at` is nullable in Monday's
+ * schema even though every successful upload sets it (the
+ * nullability is preserved for fidelity against the introspected
+ * type).
+ */
+export const assetSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    url: z.string().min(1),
+    public_url: z.string().min(1),
+    file_extension: z.string(),
+    file_size: z.number().int().nonnegative(),
+    created_at: z.string().nullable(),
+    uploaded_by: uploadedBySchema,
+    original_geometry: z.string().nullable(),
+    url_thumbnail: z.string().nullable(),
+})
+    .strict();
+/**
+ * Output shape for `monday item upload <iid> --column <col> <file>`.
+ * Echoes the wire `Asset` record plus the agent-supplied inputs
+ * (`item_id`, `column_id`, `filename`, `file_size_bytes`) so one
+ * envelope read carries the full upload context.
+ *
+ * `file_size_bytes` is the CLI-measured size at upload time (from
+ * the local file's `fs.stat()`); `asset.file_size` is Monday's
+ * server-stored size (usually identical to `file_size_bytes` but
+ * preserved separately for asymmetric-storage-encoding fidelity).
+ *
+ * `asset` is the canonical wire record; future field additions
+ * land additively per the §6.1 envelope evolution rules.
+ */
+export const itemUploadOutputSchema = z
+    .object({
+    operation: z.literal('add_file_to_column'),
+    item_id: z.string().min(1),
+    column_id: z.string().min(1),
+    filename: z.string().min(1),
+    file_size_bytes: z.number().int().nonnegative(),
+    asset: assetSchema,
+})
+    .strict();
+/**
+ * Output shape for `monday update upload <uid> <file>`. Same general
+ * shape as `itemUploadOutputSchema` but carries `update_id` instead
+ * of `item_id` + `column_id` (an Update record is the target;
+ * Monday's `Update.assets` collection grows by one on success).
+ */
+export const updateUploadOutputSchema = z
+    .object({
+    operation: z.literal('add_file_to_update'),
+    update_id: z.string().min(1),
+    filename: z.string().min(1),
+    file_size_bytes: z.number().int().nonnegative(),
+    asset: assetSchema,
+})
+    .strict();
+/**
+ * Mutation document for `add_file_to_column`. Operation name is
+ * pinned literally to `AddFileToColumn` and matches the wire
+ * `operationName` payload (R-NEW-37 W2 audit-point — caller-
+ * overridable operationName slots were closed at M27 IMPL round-1
+ * P2-1).
+ *
+ * `$file: File!` — Monday's own scalar (NOT the spec-standard
+ * `Upload!`); the multipart wire dispatcher (`assets.ts`'s caller
+ * via `MultipartTransport`) populates this slot via the spec-
+ * compliant `map` JSON pointing the file part at `variables.file`.
+ *
+ * Returns the full 10-field `Asset` selection so the output
+ * envelope captures Monday's complete view of the upload in one
+ * round-trip (no follow-up `Query.assets(ids:)` re-read needed).
+ */
+export const ADD_FILE_TO_COLUMN_MUTATION = `
+  mutation AddFileToColumn(
+    $itemId: ID!,
+    $columnId: String!,
+    $file: File!
+  ) {
+    add_file_to_column(
+      item_id: $itemId,
+      column_id: $columnId,
+      file: $file
+    ) {
+      id
+      name
+      url
+      public_url
+      file_extension
+      file_size
+      created_at
+      uploaded_by { id name }
+      original_geometry
+      url_thumbnail
+    }
+  }
+`;
+/**
+ * Mutation document for `add_file_to_update`. Operation name pinned
+ * to `AddFileToUpdate` (R-NEW-37 W2). No `column_id` — Updates
+ * carry attachments directly via `Update.assets`.
+ */
+export const ADD_FILE_TO_UPDATE_MUTATION = `
+  mutation AddFileToUpdate(
+    $updateId: ID!,
+    $file: File!
+  ) {
+    add_file_to_update(
+      update_id: $updateId,
+      file: $file
+    ) {
+      id
+      name
+      url
+      public_url
+      file_extension
+      file_size
+      created_at
+      uploaded_by { id name }
+      original_geometry
+      url_thumbnail
+    }
+  }
+`;
+/**
+ * Re-wraps Monday's server-side file-size rejection as the
+ * agent-stable `usage_error` shape (D3 closure). Monday surfaces the
+ * cap a couple of ways depending on the error path — common signals:
+ *
+ *   - `extensions.code: 'FILE_SIZE_LIMIT_EXCEEDED'` on a 200 GraphQL
+ *     errors[] payload (the most common shape — Monday's GraphQL
+ *     server stays on 200 even for input-validation rejections).
+ *   - `extensions.error_code: 'FILE_SIZE_LIMIT_EXCEEDED'` (older API
+ *     shape preserved across versions).
+ *   - HTTP 413 with no GraphQL body (rare; intermediated by an LB
+ *     between us and Monday's server).
+ *   - The bare error message contains "file size" / "file too large"
+ *     / "exceeds the limit" (string-fallback for proxy-mediated paths
+ *     that strip extensions).
+ *
+ * The matcher reads `mapResponse`'s typed error rather than the raw
+ * body — `mapResponse` already extracted the GraphQL extensions +
+ * Monday code into the `validation_failed` ApiError; we then check
+ * the same signals here to upgrade the rewrap. `details.file_size_
+ * bytes` is the local `fs.stat()` measurement the caller threaded
+ * (D3 — Monday's wire rejection may not surface a size, but the CLI
+ * has the local size from the read leg and threads a stable
+ * envelope).
+ */
+const isFileTooLargeRejection = (err) => {
+    if (err.httpStatus === 413)
+        return true;
+    const monday = err.mondayCode?.toUpperCase() ?? '';
+    if (monday === 'FILE_SIZE_LIMIT_EXCEEDED')
+        return true;
+    // Fallback to the message vocabulary — Monday occasionally returns
+    // a generic `validation_failed` with the size language inline.
+    // Match the broader `'file size'` substring (covers "file size
+    // limit exceeded" + "file size exceeds maximum" + similar
+    // proxy-rephrased variants), plus `'file too large'` and
+    // `'exceeds the limit'` for vocabulary that doesn't include
+    // "size" explicitly.
+    const msg = err.message.toLowerCase();
+    if (msg.includes('file size') ||
+        msg.includes('file too large') ||
+        msg.includes('exceeds the limit')) {
+        return true;
+    }
+    return false;
+};
+const rewrapAsFileTooLarge = ({ err, fileSizeBytes, filename, }) => new ApiError('usage_error', `Monday rejected the upload — file ${JSON.stringify(filename)} ` +
+    `exceeds the per-file size limit (uploaded ${String(fileSizeBytes)} bytes).`, {
+    cause: err,
+    details: {
+        reason: 'file_too_large',
+        file_size_bytes: fileSizeBytes,
+        filename,
+        hint: "Monday's per-file cap is plan-tier-dependent (typically 500 MB at " +
+            'standard tiers, larger at enterprise); contact Monday support to ' +
+            "confirm your account's exact ceiling.",
+    },
+});
+/**
+ * Single multipart round-trip with the standard parse-boundary
+ * (mirrors `MondayClient.raw`'s shape but for the multipart seam):
+ *
+ *   1. `multipart.request(...)` → raw transport response.
+ *   2. `mapResponse<unknown>` → tagged `MapResult` ({ok, data} or
+ *      {ok, error}); non-ok throws the typed ApiError directly so
+ *      `withRetry` can inspect `error.retryable` + `retry_after_
+ *      seconds` upstream.
+ *   3. `parseComplexity` projects any `complexity` block Monday
+ *      surfaces (asset-upload mutations don't return one today, but
+ *      keeping the same shape as `MondayClient.raw` means future
+ *      Monday API revisions surface complexity uniformly).
+ *
+ * Wrapped with `wrapTransportError` so a non-ApiError throw (a bug
+ * in the fixture transport, a future SDK shim) becomes
+ * `internal_error` rather than escaping unmapped.
+ */
+const dispatchMultipartOnce = async (inputs) => {
+    try {
+        const response = await inputs.multipart.request({
+            query: inputs.query,
+            variables: inputs.variables,
+            operationName: inputs.operationName,
+            fileVariableName: inputs.fileVariableName,
+            file: inputs.file,
+            filename: inputs.filename,
+            signal: inputs.signal,
+        });
+        const mapped = mapResponse({
+            status: response.status,
+            headers: response.headers,
+            body: response.body,
+        });
+        if (!mapped.ok) {
+            throw mapped.error;
+        }
+        const complexity = parseComplexity(response.body);
+        return { data: mapped.data, complexity };
+    }
+    catch (err) {
+        throw wrapTransportError(err);
+    }
+};
+/**
+ * Fires Monday's `add_file_to_column` mutation via the multipart
+ * transport (operationName `AddFileToColumn`, pinned literally per
+ * R-NEW-37 W2 — NOT caller-overridable). Builds the operations
+ * payload with the `file: null` placeholder per the GraphQL
+ * multipart-request spec, dispatches through `inputs.multipart` +
+ * `withRetry(...)`, parses the response — null `add_file_to_column`
+ * → `not_found` with `details.{item_id, column_id}`; non-Asset
+ * shape → `internal_error` via `assetSchema.safeParse + unwrapOr
+ * Throw`. Server-side size rejections rewrap as `usage_error` with
+ * `details.reason: 'file_too_large'` + `details.file_size_bytes`
+ * from the caller-supplied local `fs.stat()` measurement (D3).
+ *
+ * Not idempotent — re-running mints a new `Asset` ID.
+ */
+export const addFileToColumn = async (inputs) => {
+    // Spec-compliant operations payload: the file variable's value is
+    // `null` (mandatory placeholder); the multipart `map` JSON in the
+    // transport pins the file part at `variables.file`.
+    const variables = {
+        itemId: inputs.itemId,
+        columnId: inputs.columnId,
+        file: null,
+    };
+    // Rewrap server-side size rejections INSIDE the retry thunk so the
+    // resulting `usage_error` (non-retryable per CODE_RETRYABLE_DEFAULT)
+    // short-circuits `withRetry` immediately. If the rewrap lived on
+    // the outer `await withRetry(...)` catch instead, a non-JSON HTTP
+    // 413 (proxy-served HTML body) would surface as `network_error`
+    // (retryable) and the loop would re-upload the same oversized file
+    // up to `--retry` times before the rewrap finally fired (round-1
+    // P2-1 fix).
+    const result = await withRetry(async () => {
+        try {
+            return await dispatchMultipartOnce({
+                multipart: inputs.multipart,
+                query: ADD_FILE_TO_COLUMN_MUTATION,
+                variables,
+                operationName: 'AddFileToColumn',
+                fileVariableName: 'file',
+                file: inputs.file,
+                filename: inputs.filename,
+                signal: inputs.signal,
+            });
+        }
+        catch (err) {
+            if (err instanceof MondayCliError && isFileTooLargeRejection(err)) {
+                throw rewrapAsFileTooLarge({
+                    err,
+                    fileSizeBytes: inputs.file.size,
+                    filename: inputs.filename,
+                });
+            }
+            throw err;
+        }
+    }, {
+        retries: inputs.retries,
+        signal: inputs.signal,
+    });
+    // Reference `inputs.client` so future complexity-passthrough work
+    // can inspect verbose mode without changing the call signature.
+    // Today the multipart wire bypasses the JSON client entirely; the
+    // slot stays for symmetry with the JSON fetchers' shape.
+    void inputs.client;
+    const wireData = result.value.data;
+    assertResponseFieldPresent({
+        data: wireData,
+        key: 'add_file_to_column',
+        operationLabel: 'AddFileToColumn',
+        details: { item_id: inputs.itemId, column_id: inputs.columnId },
+        nullHandling: 'caller_handles',
+    });
+    // After `assertResponseFieldPresent`, `wireData` is structurally a
+    // record with the `add_file_to_column` key present (might be null).
+    const root = wireData.add_file_to_column;
+    if (root === null || root === undefined) {
+        throw new ApiError('not_found', `Item ${inputs.itemId} or column ${JSON.stringify(inputs.columnId)} ` +
+            `does not exist on a board the token has write access to.`, {
+            details: {
+                item_id: inputs.itemId,
+                column_id: inputs.columnId,
+            },
+        });
+    }
+    const asset = unwrapOrThrow(assetSchema.safeParse(root), {
+        context: 'Monday returned a malformed Asset shape from add_file_to_column',
+        details: {
+            item_id: inputs.itemId,
+            column_id: inputs.columnId,
+            filename: inputs.filename,
+        },
+    });
+    return {
+        asset,
+        source: 'live',
+        cacheAgeSeconds: null,
+        complexity: result.value.complexity,
+    };
+};
+/**
+ * Fires Monday's `add_file_to_update` mutation via the multipart
+ * transport (operationName `AddFileToUpdate`, pinned literally per
+ * R-NEW-37 W2). Mirrors {@link addFileToColumn}'s shape minus the
+ * `column_id` slot — Updates carry attachments via `Update.assets`
+ * directly. Same response-parse boundary, same `file_too_large`
+ * rewrap, same idempotency caveat (re-running mints a new Asset).
+ */
+export const addFileToUpdate = async (inputs) => {
+    const variables = {
+        updateId: inputs.updateId,
+        file: null,
+    };
+    // Same rewrap-inside-retry-thunk shape as addFileToColumn — see
+    // its inline rationale (round-1 P2-1 fix).
+    const result = await withRetry(async () => {
+        try {
+            return await dispatchMultipartOnce({
+                multipart: inputs.multipart,
+                query: ADD_FILE_TO_UPDATE_MUTATION,
+                variables,
+                operationName: 'AddFileToUpdate',
+                fileVariableName: 'file',
+                file: inputs.file,
+                filename: inputs.filename,
+                signal: inputs.signal,
+            });
+        }
+        catch (err) {
+            if (err instanceof MondayCliError && isFileTooLargeRejection(err)) {
+                throw rewrapAsFileTooLarge({
+                    err,
+                    fileSizeBytes: inputs.file.size,
+                    filename: inputs.filename,
+                });
+            }
+            throw err;
+        }
+    }, {
+        retries: inputs.retries,
+        signal: inputs.signal,
+    });
+    void inputs.client;
+    const wireData = result.value.data;
+    assertResponseFieldPresent({
+        data: wireData,
+        key: 'add_file_to_update',
+        operationLabel: 'AddFileToUpdate',
+        details: { update_id: inputs.updateId },
+        nullHandling: 'caller_handles',
+    });
+    const root = wireData.add_file_to_update;
+    if (root === null || root === undefined) {
+        throw new ApiError('not_found', `Update ${inputs.updateId} does not exist or the token has no write ` +
+            `access.`, { details: { update_id: inputs.updateId } });
+    }
+    const asset = unwrapOrThrow(assetSchema.safeParse(root), {
+        context: 'Monday returned a malformed Asset shape from add_file_to_update',
+        details: {
+            update_id: inputs.updateId,
+            filename: inputs.filename,
+        },
+    });
+    return {
+        asset,
+        source: 'live',
+        cacheAgeSeconds: null,
+        complexity: result.value.complexity,
+    };
+};
+//# sourceMappingURL=assets.js.map

package/dist/api/assets.js.map

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

package/dist/api/column-types.d.ts

@@ -128,8 +128,12 @@ export declare const isReadOnlyForeverType: (type: string) => type is ReadOnlyFo
  * `change_column_value` / `change_multiple_column_values`, so a
  * `--set-raw` raw payload cannot reach the right wire surface for
  * these types — `--set-raw` rejects them with `unsupported_column_
- * type` carrying `deferred_to: "v0.4"` (asset upload pinned to v0.4
- * per cli-design §13).
+ * type` carrying `deferred_to: "v0.6"`. v0.4-M31 shipped the verb-
+ * shaped path (`monday item upload`); the `--set-raw <file-col>=
+ * <json>` form remains deferred because it would need a separate
+ * dispatch from the escape-hatch boundary into the multipart wire.
+ * Slot slipped from v0.5 to v0.6 at v0.5 release-prep — v0.5 didn't
+ * pick up the dispatch either.
  *
  * Currently one entry (`file`); the slot is plural because Monday may
  * surface other multipart-upload-shaped types in future API versions
@@ -207,8 +211,10 @@ export declare const getColumnRoadmapCategory: (type: string) => ColumnRoadmapCa
  *     path` is `null` (agents can't write at all; the column
  *     exists for read-side display / mirror sources only).
  *   - `'files_shaped'`: Monday writes the type via `add_file_to_
- *     column` (multipart upload), pinned to v0.4 (asset upload).
- *     Currently `file` only.
+ *     column` (multipart upload). `monday item upload <iid> --column
+ *     <col> <file>` shipped at v0.4-M31 as the agent-facing verb;
+ *     `suggested_write_path` carries that pointer. Currently
+ *     `file` only.
  *
  * Returns `null` for canonical types (membership in `WRITABLE_COLUMN_
  * TYPES`) — `column-create` skips emitting the warning when the type
@@ -224,9 +230,9 @@ export interface NoncanonicalColumnTypeDetails {
     /**
      * The path agents should use to write to the column post-creation,
      * matching cli-design §5.3 escape-hatch contract — `--set-raw
-     * <col>=<json>` for raw-writable types, `add_file_to_column
-     * (deferred to v0.4)` for files-shaped types, `null` for read-
-     * only-forever types (no write path exists).
+     * <col>=<json>` for raw-writable types, `monday item upload`
+     * (v0.4-M31, multipart) for files-shaped types, `null` for
+     * read-only-forever types (no write path exists).
      */
     readonly suggestedWritePath: string | null;
 }

package/dist/api/column-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../../src/api/column-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,qJA4BxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIxE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,kBAC/B,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,GAAG,IAAI,KAAG,OAOxD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,aAU9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAM/C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,MAAM,KACX,IAAI,IAAI,uBAA8D,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,4GAe1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM3E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,mBAC5B,CAAC;AAElC;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,mBAAoB,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMlE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,eAC7B,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,mBAAmB,GACnB,QAAQ,CAAC;AAEb,eAAO,MAAM,wBAAwB,GACnC,MAAM,MAAM,KACX,qBAIF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,KACX,6BAA6B,GAAG,IAelC,CAAC"}
+{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../../src/api/column-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,qJA4BxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIxE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,kBAC/B,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,GAAG,IAAI,KAAG,OAOxD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,aAU9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAM/C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,MAAM,KACX,IAAI,IAAI,uBAA8D,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,4GAe1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM3E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,mBAC5B,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,kBAAkB,mBAAoB,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMlE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,eAC7B,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,mBAAmB,GACnB,QAAQ,CAAC;AAEb,eAAO,MAAM,wBAAwB,GACnC,MAAM,MAAM,KACX,qBAIF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,KACX,6BAA6B,GAAG,IAelC,CAAC"}

package/dist/api/column-types.js

@@ -190,8 +190,12 @@ export const isReadOnlyForeverType = (type) => READ_ONLY_FOREVER_SET.has(type);
  * `change_column_value` / `change_multiple_column_values`, so a
  * `--set-raw` raw payload cannot reach the right wire surface for
  * these types — `--set-raw` rejects them with `unsupported_column_
- * type` carrying `deferred_to: "v0.4"` (asset upload pinned to v0.4
- * per cli-design §13).
+ * type` carrying `deferred_to: "v0.6"`. v0.4-M31 shipped the verb-
+ * shaped path (`monday item upload`); the `--set-raw <file-col>=
+ * <json>` form remains deferred because it would need a separate
+ * dispatch from the escape-hatch boundary into the multipart wire.
+ * Slot slipped from v0.5 to v0.6 at v0.5 release-prep — v0.5 didn't
+ * pick up the dispatch either.
  *
  * Currently one entry (`file`); the slot is plural because Monday may
  * surface other multipart-upload-shaped types in future API versions
@@ -223,7 +227,7 @@ export const categorizeNoncanonicalColumnType = (type) => {
     if (isFilesShapedType(type)) {
         return {
             category: 'files_shaped',
-            suggestedWritePath: 'add_file_to_column (deferred to v0.4)',
+            suggestedWritePath: 'monday item upload (v0.4-M31, multipart)',
         };
     }
     return {

package/dist/api/column-types.js.map

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

package/dist/api/column-values.d.ts

@@ -629,7 +629,14 @@ export declare const bundleColumnValues: (translated: readonly TranslatedColumnV
  *     `add_file_to_column` (multipart upload) rather than
  *     `change_column_value`, so neither friendly translator nor
  *     `--set-raw` can reach the wire surface. Carry
- *     `deferred_to: "v0.4"`; hint flags the multipart-upload nature.
+ *     `deferred_to: "v0.6"`; hint points at `monday item upload`
+ *     (shipped v0.4-M31; multipart wire — the alternative path
+ *     agents should use today). The `deferred_to` slot tracks the
+ *     friendly `--set <file-col>=<path>` form specifically; v0.4
+ *     shipped the verb-shaped path (`monday item upload`); v0.5
+ *     didn't pick up the inline-`--set` translator either (the
+ *     translator boundary still doesn't dispatch into the multipart
+ *     wire); slot slipped from v0.5 to v0.6 at v0.5 release-prep.
  *   - **`time_tracking`** — verb-shaped extension (start/stop, not
  *     value writes); v0.3-deferred. Carry `deferred_to: "v0.3"`;
  *     hint points at the upcoming verb surface.