monday-cli 0.6.0 → 0.7.1

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.6.0 — the verb surfaces a clear `usage_error.details.reason:
+#    v0.7.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>"
 
@@ -117,17 +117,31 @@ 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.
+# 13. Files-shaped friendly `--set` writes — the v0.6 → v0.7 carve-out
+#     set, all four CLI shapes reaching Monday's `add_file_to_column`
+#     multipart wire:
+#     - v0.6-M38 ships single-item friendly `--set <file-col>=<path>`
+#       on `monday item set` + `monday item update <iid>` (sibling-
+#       branch dispatch at the column-resolution boundary).
+#     - v0.7-M42 ships the bulk variant on `monday item update --where
+#       ... --set <file-col>=<path>` (per-item multipart fan-out under
+#       `--concurrency` / `--continue-on-error`).
+#     - v0.7-M43 ships the create-time variant on `monday item create
+#       --set <file-col>=<path>` as a two-leg `create_item` +
+#       `add_file_to_column` dispatch under the §5.8 orphan-warn
+#       atomicity envelope.
+#     The v0.4-M31 verb-shaped `monday item upload` path remains as
+#     the alternative. `--dry-run` emits `planned_changes` on every
+#     shape without the multipart round-trip.
 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
+monday item update --board 12345 --where status=Backlog \
+  --set 'Attachments'=./report.pdf --yes --continue-on-error \
+  --concurrency 4 --json                # v0.7-M42 bulk file dispatch
+monday item create --board 12345 --name "Field report" \
+  --set 'Attachments'=./report.pdf --set status='Working on it' \
+  --json                                # v0.7-M43 create-time file --set
 
 # 14. Find-or-create with idempotent matching (v0.2)
 #     Re-running with the same args is safe — 0/1/2+ matches route to
@@ -214,7 +228,7 @@ Every JSON response uses the same universal envelope:
   "meta": {
     "schema_version": "1",
     "api_version": "2026-01",
-    "cli_version": "0.6.0",
+    "cli_version": "0.7.0",
     "request_id": "0e6f1a7b-...",
     "source": "live",
     "cache_age_seconds": null,
@@ -314,7 +328,34 @@ See [`.env.example`](./.env.example) for all supported variables
 
 ## Scope
 
-**v0.6.0 (current — `monday-cli@0.6.0` on npm):**
+**v0.7.0 (current — `monday-cli@0.7.0` on npm):**
+the v0.6 surface PLUS the two file-`--set` carve-outs deferred at
+v0.6-M38 — bulk `monday item update --where ... --set <file-col>=
+<path>` (M42, per-item multipart fan-out under `--concurrency` /
+`--continue-on-error`) and create-time `monday item create --set
+<file-col>=<path>` (M43, two-leg `create_item` + `add_file_to_
+column` dispatch under the §5.8 orphan-warn atomicity envelope).
+**No breaking changes vs v0.6.0** — the v0.7 surface is additive
+(M42 + M43 only). Built incrementally as two milestones (M42 +
+M43); both close v0.6-M38 D5 / D6 deferrals so the friendly file-
+`--set` form now reaches every callShape (single-item / bulk /
+create-time). The originally-planned Monday API `2026-04` pin
+bump (M39) + `monday item set-description` (M40) + `monday doc
+block-create-bulk` (M41) DEFERRED at 2026-05-20 pending
+`@mondaydotcomorg/api` SDK 15.x publishing with
+`CURRENT_VERSION = '2026-04'` natively — see the per-milestone
+breakdown below. See [CHANGELOG.md](./CHANGELOG.md) for the full
+per-milestone release notes.
+
+**OAuth deferral (unchanged from v0.6.0).** `monday auth login` is
+registered but the canonical Monday OAuth app is not registered in
+v0.7.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.7.x / v0.8 contingent on
+user demand.
+
+**v0.6.0 (the previous release):**
 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
@@ -323,18 +364,10 @@ 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.
+(M38). The bulk + create-time carve-outs deferred at v0.6-M38
+(D5 / D6) carry forward to v0.7 (above).
 
-**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):**
+**v0.5.0 (the prior 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
@@ -344,7 +377,7 @@ 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):**
+**v0.4.0 (the earlier 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
@@ -354,7 +387,7 @@ 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 earlier release):**
+**v0.3.0 (an even-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
@@ -644,6 +677,69 @@ row `tags`, `board_relation`, `dependency`.
   D13 empirical-probe pinning (rejected at 500KB, OK at 250KB on
   both surfaces).
 
+**What v0.7 added (M42 + M43; full per-milestone narrative in
+[CHANGELOG.md](./CHANGELOG.md)):**
+
+- **M42** — `monday item update --where ... --set <file-col>=
+  <path>` ships the bulk file-`--set` carve-out fold deferred at
+  v0.6-M38 D5. Per-item multipart fan-out across the `--where`-
+  resolved item-id set, dispatched through the existing v0.4-M30
+  `dispatchParallel` over a shared `MultipartTransport`. `--
+  concurrency 1..32` (default 1) opts into bounded parallel
+  dispatch; `--continue-on-error` partitions per-item wire
+  failures into the M25 partial-success envelope while leaving
+  whole-call-abort semantics for the upfront local file pre-check
+  (cli-design §5.8). New aggregate `data.summary` slots:
+  `column_id` / `filename` / `file_size_bytes` echo the dispatched
+  file alongside `matched_count` / `applied_count` / `failed_count`.
+  Reuses M31's multipart wire verbatim + v0.6-M38's
+  `executeFileColumnSet` runtime body — no new wire op. The pre-
+  v0.7-M42 literal `"file_set_on_bulk_unsupported"` (the M38 D5
+  rejection) stays RESERVED in docstrings + regression-guarded;
+  the runtime path no longer surfaces it.
+
+- **M43** — `monday item create --set <file-col>=<path>` ships
+  the create-time file-`--set` carve-out fold deferred at v0.6-
+  M38 D6. Two-leg dispatch: leg-1 `create_item` bundles the non-
+  file `column_values` atomically into the wire call; leg-2
+  `add_file_to_column` attaches the file to the newly-created
+  item. Pair is non-atomic by construction — leg-2 failure
+  surfaces `internal_error` with `details.reason: "create_then_
+  file_upload_partial_failure"` + `details.created_item_id`
+  echoing the leg-1 orphan + `details.column_id` + `details.
+  cause` (M31 wire-failure projection) + `details.hint`
+  directing agents to retry leg-2 alone (`monday item set <iid>
+  <file-col>=<path>`) OR rollback (`monday item delete <iid>
+  --yes`) per the §5.8 orphan-warn atomicity envelope (D1
+  closure). `--dry-run` emits two `planned_changes` entries
+  (`create_item` with bundled non-file `column_values`, then
+  `add_file_to_column`); leg-2 carries no `item_id` slot because
+  the item doesn't exist at dry-run time. Reuses M31's multipart
+  wire + v0.6-M38's `executeFileColumnSet` runtime body — no new
+  wire op. The pre-v0.7-M43 literal
+  `"file_set_on_create_unsupported"` (the M38 D6 rejection) stays
+  RESERVED + regression-guarded; the runtime path no longer
+  surfaces it. The mixed-set mutex rule SUPPRESSED on
+  `'item_create'` per D6 asymmetry — `create_item` natively
+  bundles non-file `column_values` atomically into leg-1 so the
+  multi-`--set` shape is legitimate at create time (universal
+  multi-file mutex still applies — 2+ file entries reject as
+  before).
+
+- **Deferred from v0.7 (pending SDK 15.x with `CURRENT_VERSION
+  = '2026-04'` natively):** M39 (Monday API pin bump `2026-01`
+  → `2026-04`), M40 (`monday item set-description <iid>` via
+  `set_item_description_content`), M41 (`monday doc block-
+  create-bulk <did>` via `create_doc_blocks`). The original
+  v0.7 framing collapsed to the M42 + M43 carve-out folds at
+  2026-05-20 because (a) SDK 15.x hadn't published, (b) M40's
+  empirical probe revealed paid-tier gating + opaque
+  `INTERNAL_SERVER_ERROR { service: 'docs-api' }` on free-tier
+  accounts, and (c) the string-literal API-version override
+  carried maintenance overhead disproportionate to a single
+  user-blocked verb. Findings preserved for the re-attempt
+  session.
+
 **What v0.6 added (M38; full per-milestone narrative in
 [CHANGELOG.md](./CHANGELOG.md)):**
 
@@ -654,17 +750,28 @@ row `tags`, `board_relation`, `dependency`.
   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
+  existing writable types (per D1 closure). Mutex rules
+  (post v0.7-M42 + v0.7-M43 carve-out folds): exactly one
+  file `--set` per call on every callShape (universal multi-
+  file mutex — 2+ entries surface `usage_error.details.reason:
+  "multi_file_set_unsupported"`); 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
+  error.details.reason: "mixed_file_and_value_sets"` on
+  `'item_set'` / `'item_update_single'` / `'item_update_bulk'`,
+  SUPPRESSED on `'item_create'` per v0.7-M43 D6 asymmetry
+  (`create_item` natively bundles non-file `column_values`
+  atomically into leg-1). The bulk `item update --where ...
+  --set <file-col>=<path>` path shipped at v0.7-M42 (D5
+  carve-out fold; per-item multipart fan-out under
+  `--concurrency` / `--continue-on-error`); the create-time
+  `item create --set <file-col>=<path>` path shipped at
+  v0.7-M43 (D6 carve-out fold; two-leg `create_item` +
+  `add_file_to_column` dispatch under the §5.8 orphan-warn
+  atomicity envelope). The v0.6-M38 literals
+  `"file_set_on_bulk_unsupported"` and
+  `"file_set_on_create_unsupported"` stay RESERVED in
+  docstrings + regression-guarded; the runtime path no longer
+  surfaces them. `--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
@@ -673,27 +780,33 @@ row `tags`, `board_relation`, `dependency`.
   `unsupported_column_type` / `not_found` / `validation_failed`
   codes with `details.reason` discrimination).
 
-**v0.7 (next):** **Carry-forward backlog** (unpicked
+**v0.8 (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.
+them (slipped from v0.4 → v0.5 → v0.6 → v0.7 → v0.8 across
+four consecutive release-preps — Monday's `sub_items_board`
+still carries no `subtasks` column at API `2026-01`, and v0.7
+pivoted away from API `2026-04` at 2026-05-20 so the data-
+model probe gate moves to v0.8's planned `2026-07` pin);
+cross-board `item move` value-overrides (Monday's
+`ColumnMappingInput` still carries no value slot — slipped four
+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)). Multi-file `--set` per call (v0.6-M38 D2
+deferral) and file-`--set` stdin support (v0.6-M38 D7 deferral)
+remain v0.7.x / future candidates. **v0.7-deferred milestones**:
+M39 (API pin `2026-04`) + M40 (`item set-description`) + M41
+(`doc block-create-bulk`) re-open when `@mondaydotcomorg/api`
+SDK 15.x ships natively — earliest target is v0.8 if Monday's
+SDK cadence holds (≈2 months between major SDK bumps per the
+13.0.0 / 14.0.0 / 15.0.0 trajectory).
 
 See [`docs/cli-design.md`](./docs/cli-design.md) §13 for the
 full roadmap, [`docs/v0.6-plan.md`](./docs/v0.6-plan.md) for the

package/dist/api/board-metadata.d.ts

@@ -7,9 +7,11 @@
  * The data is cached on disk via `api/cache.ts` (5-minute default TTL,
  * `--no-cache` bypasses) and the cache miss path issues a single
  * GraphQL call against the raw `client.raw<T>` escape hatch — the
- * SDK's typed `boards` query doesn't expose `hierarchy_type` /
- * `is_leaf`, both of which the design's "describe" output requires
- * (`cli-design.md` §2.8).
+ * SDK's typed `boards` query doesn't expose `hierarchy_type`, which
+ * the design's "describe" output requires (`cli-design.md` §2.8).
+ * (`is_leaf` was also fetched here until Monday removed it from the
+ * `Board` type at API 2026-01 — the query no longer selects it; see
+ * the schema comment + memory `project-is-leaf-live-drift`.)
  *
  * The cache layer holds Monday-shape JSON; this module is the *only*
  * place that reshapes Monday's response into the projected
@@ -35,6 +37,7 @@ import { z } from 'zod';
 import type { MondayClient } from './client.js';
 import { type BoardId } from '../types/ids.js';
 import type { Complexity } from '../utils/output/envelope.js';
+export declare const BOARD_METADATA_QUERY = "\n  query BoardMetadata($ids: [ID!]!) {\n    boards(ids: $ids) {\n      id\n      name\n      description\n      state\n      board_kind\n      board_folder_id\n      workspace_id\n      url\n      hierarchy_type\n      items_count\n      permissions\n      updated_at\n      groups {\n        id\n        title\n        color\n        position\n        archived\n        deleted\n      }\n      columns {\n        id\n        title\n        type\n        description\n        archived\n        settings_str\n        width\n      }\n    }\n  }\n";
 declare const groupSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
@@ -62,7 +65,7 @@ export declare const boardMetadataSchema: z.ZodObject<{
     workspace_id: z.ZodNullable<z.ZodString>;
     url: z.ZodNullable<z.ZodString>;
     hierarchy_type: z.ZodNullable<z.ZodString>;
-    is_leaf: z.ZodNullable<z.ZodBoolean>;
+    is_leaf: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     items_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     permissions: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     updated_at: z.ZodNullable<z.ZodString>;

package/dist/api/board-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board-metadata.d.ts","sourceRoot":"","sources":["../../src/api/board-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAuC9D,QAAA,MAAM,WAAW;;;;;;;kBASN,CAAC;AAEZ,QAAA,MAAM,YAAY;;;;;;;;kBAUP,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBrB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAUrD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC;AAkED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,uBAAuB,CAsDjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,KAC/C,OAAO,CAAC,uBAAuB,CACe,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,GAAG,MAAM,EAEzB,MAAK,MAAM,CAAC,UAAwB,KACnC,OAAO,CAAC,IAAI,CAId,CAAC"}
+{"version":3,"file":"board-metadata.d.ts","sourceRoot":"","sources":["../../src/api/board-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAO9D,eAAO,MAAM,oBAAoB,siBAkChC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;kBASN,CAAC;AAEZ,QAAA,MAAM,YAAY;;;;;;;;kBAUP,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgCrB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAUrD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC;AAkED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,uBAAuB,CAsDjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,KAC/C,OAAO,CAAC,uBAAuB,CACe,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,GAAG,MAAM,EAEzB,MAAK,MAAM,CAAC,UAAwB,KACnC,OAAO,CAAC,IAAI,CAId,CAAC"}

package/dist/api/board-metadata.js

@@ -7,9 +7,11 @@
  * The data is cached on disk via `api/cache.ts` (5-minute default TTL,
  * `--no-cache` bypasses) and the cache miss path issues a single
  * GraphQL call against the raw `client.raw<T>` escape hatch — the
- * SDK's typed `boards` query doesn't expose `hierarchy_type` /
- * `is_leaf`, both of which the design's "describe" output requires
- * (`cli-design.md` §2.8).
+ * SDK's typed `boards` query doesn't expose `hierarchy_type`, which
+ * the design's "describe" output requires (`cli-design.md` §2.8).
+ * (`is_leaf` was also fetched here until Monday removed it from the
+ * `Board` type at API 2026-01 — the query no longer selects it; see
+ * the schema comment + memory `project-is-leaf-live-drift`.)
  *
  * The cache layer holds Monday-shape JSON; this module is the *only*
  * place that reshapes Monday's response into the projected
@@ -36,7 +38,12 @@ import { clearEntry, readEntry, resolveCacheRoot, writeEntry, DEFAULT_CACHE_TTL_
 import { BoardIdSchema } from '../types/ids.js';
 import { ApiError } from '../utils/errors.js';
 import { unwrapOrThrow } from '../utils/parse-boundary.js';
-const BOARD_METADATA_QUERY = `
+// Exported so the RUN_LIVE_TESTS schema-drift smoke test can run the
+// exact production document against the live API — the is_leaf
+// regression (Monday removed the field from `Board` at 2026-01) shipped
+// precisely because the test suite mocks the network boundary and never
+// exercised the real field selection. See tests/e2e/live-schema-drift.test.ts.
+export const BOARD_METADATA_QUERY = `
   query BoardMetadata($ids: [ID!]!) {
     boards(ids: $ids) {
       id
@@ -48,7 +55,6 @@ const BOARD_METADATA_QUERY = `
       workspace_id
       url
       hierarchy_type
-      is_leaf
       items_count
       permissions
       updated_at
@@ -104,7 +110,16 @@ export const boardMetadataSchema = z
     workspace_id: z.string().nullable(),
     url: z.string().nullable(),
     hierarchy_type: z.string().nullable(),
-    is_leaf: z.boolean().nullable(),
+    // Monday removed `is_leaf` from the `Board` type at API 2026-01
+    // (live introspection: the field is gone; the canned query no
+    // longer selects it). Kept optional+nullable so (a) the live
+    // projection parses a response that omits it and (b) pre-removal
+    // on-disk cache entries that still carry it parse cleanly. The
+    // `board describe` output preserves the key (null-projected) to
+    // stay non-breaking per cli-design §6.1 — dropping the output
+    // key entirely is a SemVer-major change deferred to the next
+    // major. See memory `project-is-leaf-live-drift`.
+    is_leaf: z.boolean().nullable().optional(),
     // Optional+nullable so existing pre-M15 cache entries (which
     // didn't carry these fields) parse cleanly post-bump. New
     // BOARD_METADATA_QUERY runs include the fields; the M15 board

package/dist/api/board-metadata.js.map

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

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

@@ -124,30 +124,49 @@ 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).
  *
- * **Two write paths reach the multipart wire** post-v0.6-M38:
+ * **Four write paths reach the multipart wire** post-v0.7-M43:
  *
  *   - **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
+ *   - **v0.6-M38 friendly translator (single-item)**: `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).
+ *     `addFileToColumn` verbatim. Single-item at v0.6-M38.
+ *   - **v0.7-M42 friendly translator (bulk)**: `monday item update
+ *     --where ... --set <file-col>=<path>` (D5 carve-out fold from
+ *     v0.6-M38). Per-item multipart fan-out via
+ *     `runItemUpdateBulkFileDispatch` in
+ *     `src/commands/item/update.ts` under `--concurrency` /
+ *     `--continue-on-error`.
+ *   - **v0.7-M43 friendly translator (create-time)**: `monday item
+ *     create --set <file-col>=<path>` (D6 carve-out fold from
+ *     v0.6-M38). Two-leg `create_item` (with bundled non-file
+ *     `column_values`) + `add_file_to_column` dispatch via
+ *     `runItemCreateFileDispatch` in `src/commands/item/create.ts`
+ *     under the §5.8 orphan-warn atomicity envelope (D1 closure).
  *
- * The `--set-raw <file-col>=<json>` form STAYS REJECTED at v0.6-M38
- * per D3 closure — Monday's wire has no JSON-shape for
+ * Mutex rules at the resolution boundary (D2 closures + folded
+ * D5/D6): multi-file `--set` rejects universally
+ * (`multi_file_set_unsupported`); mixed file + value `--set` /
+ * `--set-raw` / `--name` rejects on `'item_set'` /
+ * `'item_update_single'` / `'item_update_bulk'` callShapes
+ * (`mixed_file_and_value_sets`), SUPPRESSED on `'item_create'`
+ * per v0.7-M43 asymmetry (`create_item` natively bundles
+ * non-file `column_values` atomically into leg-1).
+ *
+ * The `--set-raw <file-col>=<json>` form STAYS REJECTED 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.
+ * doesn't compose with multipart. The rejection points at every
+ * shipped friendly write path: v0.4-M31 verb-shaped `monday item
+ * upload` + v0.6-M38 single-item friendly `--set` + v0.7-M42
+ * bulk friendly `--set` + v0.7-M43 create-time friendly `--set`.
  *
  * Currently one entry (`file`); the slot is plural because Monday may
  * surface other multipart-upload-shaped types in future API versions
@@ -225,14 +244,20 @@ 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). 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.
+ *     column` (multipart upload). Four write paths post-v0.7-M43:
+ *     `monday item upload <iid> --column <col> <file>` (v0.4-M31;
+ *     verb-shaped) + `monday item set <iid> <file-col>=<path>` /
+ *     `monday item update <iid> --set <file-col>=<path>` (v0.6-M38;
+ *     single-item friendly translator dispatch) + `monday item
+ *     update --where ... --set <file-col>=<path>` (v0.7-M42; bulk
+ *     friendly translator dispatch with per-item multipart fan-out)
+ *     + `monday item create --set <file-col>=<path>` (v0.7-M43;
+ *     create-time two-leg friendly translator dispatch under the
+ *     §5.8 orphan-warn atomicity envelope).
+ *     `suggested_write_path` is a single human-readable string
+ *     joining every shipped path 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
@@ -254,14 +279,22 @@ export interface NoncanonicalColumnTypeDetails {
      *   - `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.
+     *   - `files_shaped` types post-v0.7-M43: a single human-readable
+     *     string joining every shipped write path with ` OR ` — the
+     *     v0.6-M38 friendly `monday item set <iid> <file-col>=<path>` /
+     *     `monday item update <iid> --set <file-col>=<path>` (single-
+     *     item dispatch); the v0.7-M42 friendly `monday item update
+     *     --where ... --set <file-col>=<path>` (bulk per-item multipart
+     *     fan-out); the v0.7-M43 friendly `monday item create --set
+     *     <file-col>=<path>` (create-time two-leg dispatch under the
+     *     §5.8 orphan-warn atomicity envelope); 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. (At v0.7-M42
+     *     IMPL the string went from 2-path to 3-path; at v0.7-M43
+     *     pre-flight it went to 4-path; R-v0.6-NEW-3 trigger remains
+     *     pending until a downstream consumer needs structured-array
+     *     iteration.)
      */
     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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,MAAM,8BAA8B,GACtC,cAAc,GACd,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,gCAAgC,GAC3C,MAAM,MAAM,KACX,6BAA6B,GAAG,IAgBlC,CAAC"}