monday-cli 0.4.0 → 0.6.0

package/README.md

@@ -49,7 +49,7 @@ Requires **Node.js ≥ 22**.
 #    Get one at https://<your-org>.monday.com/admin/integrations/api
 #
 #    OAuth login (`monday auth login`) is registered but deferred in
-#    v0.4.0 — the verb surfaces a clear `usage_error.details.reason:
+#    v0.6.0 — the verb surfaces a clear `usage_error.details.reason:
 #    oauth_unregistered` pointing here. Authenticate via the env var.
 export MONDAY_API_TOKEN="<your-token>"
 
@@ -97,23 +97,55 @@ monday item update --where status=Backlog --set status='Working on it' \
 monday doc list --workspace 5 --order-by used_at --limit 10 --json
 monday doc get 88001 --json                # full Document with blocks
 
-# 11. Find-or-create with idempotent matching (v0.2)
+# 11. Workdocs CRUD (v0.5-M35 + v0.5-M36 + v0.5-M37 — the full
+#     mutation surface deferred at v0.4-M32 D8 closure).
+#     Doc-level CRUD (M35): create / rename / delete / duplicate.
+monday doc create-in-workspace --workspace 5 --name "Design notes" --json
+monday doc rename 88001 --name "Design notes (v2)" --json
+monday doc duplicate 88001 --with-updates --json
+monday doc delete 88001 --yes --json
+#     Doc-block CRUD (M36): block-create / block-update / block-delete.
+#     16-value `DocBlockContentType` enum for `--type`.
+monday doc block-create 88001 --type normal_text --content '{"text":"hi"}' --json
+#     Bulk import from HTML / markdown (M37): no per-block round-trips.
+monday doc import-html --workspace 5 --html ./page.html --title "Imported" --json
+monday doc append-markdown 88001 --markdown ./notes.md --json
+
+# 12. Team writers (v0.5-M34 — deferred from v0.4 at the post-M33
+#     candidate-selection session). Six new verbs under `monday user`.
+monday user team-list --json
+monday user team-create --name "Platform" --users 7,9 --json
+monday user team-add-members <tid> --users 11,13 --json
+
+# 13. Files-shaped friendly `--set` writes (v0.6-M38 — closes the v0.4
+#     → v0.5 → v0.6 carry-over of the inline form). Single-call file
+#     upload via `--set <file-col>=<path>`; sibling-branch dispatch at
+#     the column-resolution boundary routes to the v0.4-M31 multipart
+#     `add_file_to_column` wire. `--dry-run` emits a `planned_changes`
+#     envelope without the multipart round-trip. The v0.4-M31 verb-
+#     shaped `monday item upload` path remains; this is the friendly
+#     inline alternative.
+monday item set 67890 'Attachments'=./screenshot.png --json
+monday item update 67890 --set 'Attachments'=./diagram.png --json
+monday item update 67890 --set 'Attachments'=./report.pdf --dry-run --json
+
+# 14. Find-or-create with idempotent matching (v0.2)
 #     Re-running with the same args is safe — 0/1/2+ matches route to
 #     create / update / `ambiguous_match` (one of the 29 stable error codes).
 monday item upsert --board 12345 --name "Refactor login" \
   --match-by name --set status='Working on it' --json
 
-# 12. Move a ticket forward, then comment on it
+# 15. Move a ticket forward, then comment on it
 monday item set 67890 status=Done --json
 monday update create 67890 --body "Shipped in PR #1234" --json
 
-# 13. Monday Dev convention layer (v0.3 — sprint/epic/release/task)
+# 16. Monday Dev convention layer (v0.3 — sprint/epic/release/task)
 #     First-time setup auto-detects boards by Monday's stock template names.
 monday dev discover --apply --json         # writes ~/.monday-cli/config.toml
 monday dev sprint current --json           # the active sprint
 monday dev task list --mine --json         # my open tasks
 
-# 14. Outbound writes (v0.3 — webhooks + notifications)
+# 17. Outbound writes (v0.3 — webhooks + notifications)
 monday webhook list 12345 --json
 monday notification send --user 7 --target 67890 \
   --target-type item --text "PTAL" --json
@@ -182,7 +214,7 @@ Every JSON response uses the same universal envelope:
   "meta": {
     "schema_version": "1",
     "api_version": "2026-01",
-    "cli_version": "0.4.0",
+    "cli_version": "0.6.0",
     "request_id": "0e6f1a7b-...",
     "source": "live",
     "cache_age_seconds": null,
@@ -282,27 +314,47 @@ See [`.env.example`](./.env.example) for all supported variables
 
 ## Scope
 
-**v0.4.0 (current — `monday-cli@0.4.0` on npm):**
+**v0.6.0 (current — `monday-cli@0.6.0` on npm):**
+the v0.5 surface PLUS files-shaped friendly `--set <file-col>=<path>`
+writes on `monday item set` + `monday item update` (single-item
+paths), closing the v0.4 → v0.5 → v0.6 carry-over of the inline
+form. Sibling-branch dispatch at the column-resolution boundary
+routes file `--set` to the v0.4-M31 `add_file_to_column` multipart
+wire; the friendly translator stays JSON-output-shaped for the 13
+existing writable types. **No breaking changes vs v0.5.0** — the
+v0.6 surface is additive (M38 only). Built as a single milestone
+(M38). See [CHANGELOG.md](./CHANGELOG.md) for the full
+per-milestone release notes.
+
+**OAuth deferral (unchanged from v0.5.0).** `monday auth login` is
+registered but the canonical Monday OAuth app is not registered in
+v0.6.0; the verb surfaces a clear `usage_error.details.reason:
+oauth_unregistered` pointing at `MONDAY_API_TOKEN`. Multi-profile
+config + per-profile credentials cache work fully against API
+tokens; OAuth registration revisits in v0.6.x / v0.7 contingent on
+user demand.
+
+**v0.5.0 (the previous release):**
+the v0.4 surface PLUS the full team-writer surface
+(`monday user team-list/get/create/delete/add-members/remove-members`),
+the full Monday workdocs CRUD mutation surface — doc-level
+(`monday doc create-in-workspace/create-on-column/rename/delete/duplicate`),
+doc-block (`monday doc block-create/block-update/block-delete`),
+and doc-content import (`monday doc import-html/append-markdown`) —
+closing the v0.4-M32 workdocs-mutation deferral. **16 new CLI
+verbs across 9 wire mutations.** Built incrementally across M34–M37.
+
+**v0.4.0 (the prior release):**
 the v0.3 surface PLUS long-poll item activity streaming
 (`monday item watch <iid>` — NDJSON), parallel bulk dispatch
 (`monday item update --where ... --concurrency <N>`), asset uploads
 (`monday item upload` / `monday update upload` — multipart wire),
 Monday workdocs reads (`monday doc list` / `monday doc get` — full
-workdocs CRUD mutation surface deferred to v0.5), and shell
-completion (`monday completion bash|zsh|fish`). **No breaking
-changes vs v0.3.0** — every v0.4 surface is additive. Built
-incrementally across M29–M33. See [CHANGELOG.md](./CHANGELOG.md)
-for the full per-milestone release notes.
-
-**OAuth deferral (unchanged from v0.3.0).** `monday auth login` is
-registered but the canonical Monday OAuth app is not registered in
-v0.4.0; the verb surfaces a clear `usage_error.details.reason:
-oauth_unregistered` pointing at `MONDAY_API_TOKEN`. Multi-profile
-config + per-profile credentials cache work fully against API
-tokens; OAuth registration revisits in v0.4.x / v0.5 contingent on
-user demand.
+workdocs CRUD mutation surface deferred to v0.5; shipped at v0.5),
+and shell completion (`monday completion bash|zsh|fish`). Built
+incrementally across M29–M33.
 
-**v0.3.0 (the previous release):**
+**v0.3.0 (the earlier release):**
 the v0.2 mutating core PLUS the Monday Dev convention layer
 (`monday dev` namespace — sprint / epic / release / task workflow
 shortcuts on top of standard board CRUD), multi-profile auth
@@ -317,7 +369,7 @@ outbound writes (`monday webhook list/create/delete` +
 tentative-row carryover. **No breaking changes vs v0.2.0** — every
 v0.3 surface is additive. Built incrementally across M19–M28.
 
-**v0.2.0 (the prior release):**
+**v0.2.0 (the foundation-of-mutations release):**
 the v0.1 read-only core + safe-mutations surface PLUS the full
 mutation surface (item lifecycle, update mutations, workspace
 lifecycle, board lifecycle, board columns + groups). Built
@@ -548,20 +600,107 @@ row `tags`, `board_relation`, `dependency`.
   templates (commander 14.0.3 ships no built-in completion
   machinery, verified by empirical probe at M33 pre-flight).
 
-**v0.5 (next):** `team` writers (deferred from v0.4-M34 at the
-post-v0.4-M33 candidate-selection session), Monday workdocs CRUD
-mutation surface (9 mutations deferred at v0.4-M32 D8 closure),
-multi-level subitems remain conditional on Monday's data model
-surfacing them, cross-board `item move` value-overrides (slipped
-from v0.4 at v0.4 release-prep — Monday's `ColumnMappingInput`
-carries no value slot), and resumable cross-board cursor pagination
-(slipped from v0.4 — per-board cursor-lifetime under aggregation
-needs design work).
+**What v0.5 added (M34–M37; full per-milestone narrative in
+[CHANGELOG.md](./CHANGELOG.md)):**
+
+- **M34** — `monday user team-list/get/create/delete/add-members/
+  remove-members` ship the full team-writer surface. The two read
+  verbs (`team-list` / `team-get`) close the v0.4-M33 candidate-
+  selection deferral; the four mutations introduce a new partial-
+  success projection for `team-add-members` / `team-remove-members`
+  (Monday's `change_team_memberships` returns `failed_users` +
+  `successful_users` lists; the CLI projects to the universal §6.1
+  `results: [{user_id, ok, ...}]` shape with input-order preserved
+  + failed-bucket-priority discipline).
+- **M35** — `monday doc create-in-workspace/create-on-column/rename/
+  delete/duplicate` ship the doc-level CRUD writer surface. Two
+  create variants (per D7) — `create-in-workspace` (`--workspace`
+  required + optional `--folder` / `--kind`) vs `create-on-column`
+  (`--item` + `--column` against an existing file-shaped column).
+  `rename` (`update_doc_name`), `delete --yes` (`delete_doc` — the
+  destructive verb in the cluster), and `duplicate [--with-updates]`
+  (`duplicate_doc`) round out the lifecycle. Backed by 4 Monday
+  wire mutations.
+- **M36** — `monday doc block-create/block-update/block-delete`
+  ship the doc-block CRUD surface. `--type <DocBlockContentType>`
+  takes one of 16 enum values (`normal_text` / `large_title` /
+  `quote` / `bulleted_list` / `check_list` / `code` / `divider` /
+  …) per D10 closure. `--content <json>` (parsed via the M27-lifted
+  `parseJsonArg` helper). Per-type content payload shapes
+  documented in `docs/output-shapes.md` "Per-block content shapes"
+  reference table — 7 cassette-pinned variants + 9 TBD / inferred
+  variants awaiting follow-up cassettes per D11.
+- **M37** — `monday doc import-html/append-markdown` ship bulk
+  doc-content import in a single wire round-trip (no per-block
+  loop). `import-html` creates a new doc from an HTML payload;
+  `append-markdown` appends blocks to an existing doc from a
+  markdown payload. Both surface mutex argv sources
+  (`--html <file|-> | --html-string <s>` /
+  `--markdown <file|-> | --markdown-string <s>`) backed by the new
+  generic `readSourceContent` helper at `src/utils/source-content.ts`
+  (R-v0.5-NEW-18 lifted ahead-of-feat from M13's `readUpdateBody`
+  — 5 consumers post-lift). Wire-side payload cap pre-empted at
+  parse boundary via `MAX_DOC_IMPORT_PAYLOAD_BYTES = 256_000` per
+  D13 empirical-probe pinning (rejected at 500KB, OK at 250KB on
+  both surfaces).
+
+**What v0.6 added (M38; full per-milestone narrative in
+[CHANGELOG.md](./CHANGELOG.md)):**
+
+- **M38** — `monday item set <iid> <file-col>=<path>` +
+  `monday item update <iid> --set <file-col>=<path>` ship the
+  files-shaped friendly `--set` writer path, closing the v0.4 →
+  v0.5 → v0.6 carry-over of the inline form. Sibling-branch
+  dispatch at the column-resolution boundary routes file `--set`
+  to the v0.4-M31 `add_file_to_column` multipart wire; the
+  friendly translator stays JSON-output-shaped for the 13
+  existing writable types (per D1 closure). Mutex rules at M38:
+  exactly one file `--set` per call; mixing a file `--set` with
+  any value `--set` / `--set-raw` / `--name` surfaces `usage_
+  error.details.reason: "mixed_file_and_value_sets"`; 2+ file
+  `--set` entries surface `usage_error.details.reason: "multi_
+  file_set_unsupported"` (both deferred to v0.6.x per D2). The
+  bulk `item update --where ... --set <file-col>=<path>` and
+  `item create --set <file-col>=<path>` paths reject at the
+  resolution boundary with `details.reason: "file_set_on_bulk_
+  unsupported"` / `"file_set_on_create_unsupported"` (D5 / D6 —
+  defer to v0.6.x). `--set-raw <file-col>=<json>` STAYS REJECTED
+  per D3 — Monday's wire has no JSON-shape for
+  `change_column_value` on file columns; `monday item upload`
+  from v0.4-M31 remains the verb-shaped alternative path. **No
+  new ERROR_CODES** at M38 (registry stays at 29 — all
+  rejections route through existing `usage_error` /
+  `unsupported_column_type` / `not_found` / `validation_failed`
+  codes with `details.reason` discrimination).
+
+**v0.7 (next):** **Carry-forward backlog** (unpicked
+candidates remain in cli-design.md §13 slipped-candidates list
+pending future candidate-selection sessions): multi-level
+subitems remain conditional on Monday's data model surfacing
+them (slipped from v0.4 → v0.5 → v0.6 → v0.7 across three
+consecutive release-preps — Monday's `sub_items_board` still
+carries no `subtasks` column at API `2026-01`); cross-board
+`item move` value-overrides (Monday's `ColumnMappingInput`
+still carries no value slot — slipped three times for the same
+reason); resumable cross-board cursor pagination (per-board
+cursor-lifetime under aggregation needs design work);
+profile-scoped argument defaults (filed at the v0.6 kickoff
+candidate-selection session — extends `~/.monday-cli/config.toml`
+with a `[profiles.<name>.defaults]` table carrying scoping args;
+requires a prerequisite §13 carve-out Decision at pre-flight
+distinguishing aliases-as-stored-command-strings (still
+non-goal) from defaults-as-stored-flag-values (carve-out)).
+**v0.6.x carve-outs** ride on top: bulk + create file `--set`
+paths (D5 / D6 deferrals); multi-file `--set` per call (D2);
+file-`--set` stdin support (D7); these defer to v0.6.x within
+the v0.6 series.
 
 See [`docs/cli-design.md`](./docs/cli-design.md) §13 for the
-full roadmap, [`docs/v0.4-plan.md`](./docs/v0.4-plan.md) for the
-v0.4 milestone history, [`docs/v0.3-plan.md`](./docs/v0.3-plan.md)
-for v0.3, and [`docs/v0.2-plan.md`](./docs/v0.2-plan.md) for v0.2.
+full roadmap, [`docs/v0.6-plan.md`](./docs/v0.6-plan.md) for the
+v0.6 milestone history, [`docs/v0.5-plan.md`](./docs/v0.5-plan.md)
+for v0.5, [`docs/v0.4-plan.md`](./docs/v0.4-plan.md) for v0.4,
+[`docs/v0.3-plan.md`](./docs/v0.3-plan.md) for v0.3, and
+[`docs/v0.2-plan.md`](./docs/v0.2-plan.md) for v0.2.
 
 See [CHANGELOG.md](./CHANGELOG.md) for the per-release contract.
 

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

@@ -124,14 +124,30 @@ export declare const isReadOnlyForeverType: (type: string) => type is ReadOnlyFo
  * column_values` (`cli-design.md` §5.3 writer-expansion roadmap "files"
  * row + the escape-hatch contract).
  *
- * The friendly translator and `--set-raw` both go through
- * `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.5"`. 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.
+ * **Two write paths reach the multipart wire** post-v0.6-M38:
+ *
+ *   - **v0.4-M31 verb-shaped**: `monday item upload <iid> --column
+ *     <col> <file>` + `monday update upload <uid> <file>`. Direct
+ *     multipart dispatch via `addFileToColumn` /
+ *     `addFileToUpdate` (`src/api/assets.ts`).
+ *   - **v0.6-M38 friendly translator**: `monday item set <iid>
+ *     <file-col>=<path>` + `monday item update <iid> --set
+ *     <file-col>=<path>`. Sibling dispatch leg at the command
+ *     action body that detects `column.type === 'file'` AFTER
+ *     resolution + routes through `executeFileColumnSet`
+ *     (`src/api/file-column-set.ts`), which itself wraps M31's
+ *     `addFileToColumn` verbatim. Single-item only at M38; mutex
+ *     rules at the resolution boundary (D2/D5/D6 closures —
+ *     bulk + create paths reject; mixed-set rejects; multi-file-
+ *     set rejects).
+ *
+ * The `--set-raw <file-col>=<json>` form STAYS REJECTED at v0.6-M38
+ * per D3 closure — Monday's wire has no JSON-shape for
+ * `change_column_value` on file columns, and the escape-hatch
+ * contract "user supplies the JSON `change_column_value` accepts"
+ * doesn't compose with multipart. The rejection now points at
+ * BOTH write paths (M31 verb + M38 friendly `--set`) as
+ * alternatives.
  *
  * Currently one entry (`file`); the slot is plural because Monday may
  * surface other multipart-upload-shaped types in future API versions
@@ -209,10 +225,14 @@ 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). `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.
+ *     column` (multipart upload). Two write paths post-v0.6-M38:
+ *     `monday item upload <iid> --column <col> <file>` (M31; verb-
+ *     shaped) + `monday item set <iid> <file-col>=<path>` /
+ *     `monday item update <iid> --set <file-col>=<path>` (M38;
+ *     friendly translator dispatch). `suggested_write_path` is a
+ *     single human-readable string joining BOTH paths with ` OR `
+ *     (R-v0.6-NEW-3 watch-item: lift to `readonly string[]` at the
+ *     2nd N>1 consumer). Currently `file` only.
  *
  * Returns `null` for canonical types (membership in `WRITABLE_COLUMN_
  * TYPES`) — `column-create` skips emitting the warning when the type
@@ -226,11 +246,22 @@ export type NoncanonicalColumnTypeCategory = 'raw_writable' | 'read_only_forever
 export interface NoncanonicalColumnTypeDetails {
     readonly category: NoncanonicalColumnTypeCategory;
     /**
-     * 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, `monday item upload`
-     * (v0.4-M31, multipart) for files-shaped types, `null` for
-     * read-only-forever types (no write path exists).
+     * The path(s) agents should use to write to the column post-
+     * creation, matching cli-design §5.3 escape-hatch + dispatch
+     * contracts:
+     *
+     *   - `raw_writable` types: `--set-raw <col>=<json>`.
+     *   - `read_only_forever` types: `null` (no write path exists —
+     *     the column exists for read-side display / mirror sources
+     *     only).
+     *   - `files_shaped` types post-v0.6-M38: a single human-readable
+     *     string joining BOTH write paths with ` OR ` — the v0.6-M38
+     *     friendly `monday item set <iid> <file-col>=<path>` /
+     *     `monday item update <iid> --set <file-col>=<path>` dispatch
+     *     AND the v0.4-M31 verb-shaped `monday item upload <iid>
+     *     --column <col> <file>`. R-v0.6-NEW-3 watch-item: lift to
+     *     `readonly string[]` at the 2nd N>1 consumer for structured
+     *     enumeration.
      */
     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;;;;;;;;;;;;;;;;;;;GAmBG;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,KACX,6BAA6B,GAAG,IAgBlC,CAAC"}

package/dist/api/column-types.js

@@ -186,14 +186,30 @@ export const isReadOnlyForeverType = (type) => READ_ONLY_FOREVER_SET.has(type);
  * column_values` (`cli-design.md` §5.3 writer-expansion roadmap "files"
  * row + the escape-hatch contract).
  *
- * The friendly translator and `--set-raw` both go through
- * `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.5"`. 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.
+ * **Two write paths reach the multipart wire** post-v0.6-M38:
+ *
+ *   - **v0.4-M31 verb-shaped**: `monday item upload <iid> --column
+ *     <col> <file>` + `monday update upload <uid> <file>`. Direct
+ *     multipart dispatch via `addFileToColumn` /
+ *     `addFileToUpdate` (`src/api/assets.ts`).
+ *   - **v0.6-M38 friendly translator**: `monday item set <iid>
+ *     <file-col>=<path>` + `monday item update <iid> --set
+ *     <file-col>=<path>`. Sibling dispatch leg at the command
+ *     action body that detects `column.type === 'file'` AFTER
+ *     resolution + routes through `executeFileColumnSet`
+ *     (`src/api/file-column-set.ts`), which itself wraps M31's
+ *     `addFileToColumn` verbatim. Single-item only at M38; mutex
+ *     rules at the resolution boundary (D2/D5/D6 closures —
+ *     bulk + create paths reject; mixed-set rejects; multi-file-
+ *     set rejects).
+ *
+ * The `--set-raw <file-col>=<json>` form STAYS REJECTED at v0.6-M38
+ * per D3 closure — Monday's wire has no JSON-shape for
+ * `change_column_value` on file columns, and the escape-hatch
+ * contract "user supplies the JSON `change_column_value` accepts"
+ * doesn't compose with multipart. The rejection now points at
+ * BOTH write paths (M31 verb + M38 friendly `--set`) as
+ * alternatives.
  *
  * Currently one entry (`file`); the slot is plural because Monday may
  * surface other multipart-upload-shaped types in future API versions
@@ -225,7 +241,7 @@ export const categorizeNoncanonicalColumnType = (type) => {
     if (isFilesShapedType(type)) {
         return {
             category: 'files_shaped',
-            suggestedWritePath: 'monday item upload (v0.4-M31, multipart)',
+            suggestedWritePath: 'monday item set <iid> <file-col>=<path> (v0.6-M38; friendly) OR monday item upload <iid> --column <col> <file> (v0.4-M31; verb-shaped)',
         };
     }
     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

@@ -627,15 +627,23 @@ export declare const bundleColumnValues: (translated: readonly TranslatedColumnV
  *     `deferred_to: "v0.3"`; hint nudges agents at `--set-raw`.
  *   - **`files`-shaped** (currently `file` only) — Monday writes via
  *     `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.5"`; 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`) but not
- *     the inline-`--set` translator, which would need to dispatch
- *     from the friendly-translator boundary into the multipart wire.
+ *     `change_column_value`. v0.6-M38 ships the friendly
+ *     `--set <file-col>=<path>` form via a sibling dispatch leg at
+ *     the command action body (see `src/api/file-column-set.ts`);
+ *     the rejection table row here fires ONLY for paths that
+ *     don't route through the M38 dispatch — specifically the
+ *     `item create` carve-in (`create_item.column_values` is
+ *     JSON-only and can't accept a multipart file part; M38 D6
+ *     closure defers create-time file upload to v0.6.x) + the
+ *     bulk path (`item update --where ... --set <file-col>=
+ *     <path>`; M38 D5 closure defers per-item file dispatch to
+ *     v0.6.x). The friendly translator's M38-routed entries
+ *     never hit this `UNSUPPORTED_TABLE.files_shaped` row —
+ *     they branch off ahead of the translator call at the
+ *     action body level. Hint points at `monday item upload`
+ *     (v0.4-M31; verb-shaped multipart) AND `monday item set` /
+ *     `monday item update --set <file-col>=<path>` (v0.6-M38;
+ *     friendly translator dispatch).
  *   - **`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.

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

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

package/dist/api/column-values.js

@@ -1093,15 +1093,23 @@ export const bundleColumnValues = (translated) => {
  *     `deferred_to: "v0.3"`; hint nudges agents at `--set-raw`.
  *   - **`files`-shaped** (currently `file` only) — Monday writes via
  *     `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.5"`; 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`) but not
- *     the inline-`--set` translator, which would need to dispatch
- *     from the friendly-translator boundary into the multipart wire.
+ *     `change_column_value`. v0.6-M38 ships the friendly
+ *     `--set <file-col>=<path>` form via a sibling dispatch leg at
+ *     the command action body (see `src/api/file-column-set.ts`);
+ *     the rejection table row here fires ONLY for paths that
+ *     don't route through the M38 dispatch — specifically the
+ *     `item create` carve-in (`create_item.column_values` is
+ *     JSON-only and can't accept a multipart file part; M38 D6
+ *     closure defers create-time file upload to v0.6.x) + the
+ *     bulk path (`item update --where ... --set <file-col>=
+ *     <path>`; M38 D5 closure defers per-item file dispatch to
+ *     v0.6.x). The friendly translator's M38-routed entries
+ *     never hit this `UNSUPPORTED_TABLE.files_shaped` row —
+ *     they branch off ahead of the translator call at the
+ *     action body level. Hint points at `monday item upload`
+ *     (v0.4-M31; verb-shaped multipart) AND `monday item set` /
+ *     `monday item update --set <file-col>=<path>` (v0.6-M38;
+ *     friendly translator dispatch).
  *   - **`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.
@@ -1171,17 +1179,24 @@ const UNSUPPORTED_TABLE = {
     files_shaped: {
         message: (columnId, type) => `Column "${columnId}" has type "${type}", which Monday writes ` +
             `via add_file_to_column (multipart upload) rather than ` +
-            `change_column_value. The friendly --set translator can't ` +
-            `reach this surface; --set-raw <col>=<json> can't either. ` +
+            `change_column_value. The v0.6-M38 friendly --set ` +
+            `<file-col>=<path> form dispatches into the multipart wire on ` +
+            `\`monday item set\` + \`monday item update\` (single-item ` +
+            `only); this rejection row fires on paths the M38 dispatch ` +
+            `doesn't cover (item create, bulk item update --where). ` +
             `Use \`monday item upload <iid> --column <col> <file>\` ` +
-            `(v0.4-M31, multipart wire) for file columns.`,
+            `(v0.4-M31; verb-shaped) OR \`monday item set <iid> ` +
+            `<file-col>=<path>\` / \`monday item update <iid> --set ` +
+            `<file-col>=<path>\` (v0.6-M38; friendly translator).`,
         details: () => ({
-            deferred_to: 'v0.5',
-            hint: 'use `monday item upload <iid> --column <col> <file>` ' +
-                '(shipped v0.4-M31, multipart wire) — the friendly ' +
-                '--set translator + --set-raw both target ' +
-                'change_column_value-shaped types and can\'t reach the ' +
-                'multipart wire.',
+            hint: 'two write paths reach Monday\'s add_file_to_column ' +
+                'multipart wire: `monday item upload <iid> --column <col> ' +
+                '<file>` (v0.4-M31; verb-shaped) and `monday item set <iid> ' +
+                '<file-col>=<path>` / `monday item update <iid> --set ' +
+                '<file-col>=<path>` (v0.6-M38; friendly translator ' +
+                'dispatch, single-item only). The bulk + create paths ' +
+                'reject file-shaped columns at v0.6-M38 — those defer to ' +
+                'v0.6.x per cli-design §5.3 + §13 v0.6 entry.',
         }),
     },
     time_tracking: {