monday-cli 0.5.0 → 0.7.0

package/dist/commands/item/update.d.ts

@@ -45,8 +45,26 @@
  */
 import { z } from 'zod';
 import { type CommandModule } from '../types.js';
+import type { MondayClient } from '../../api/client.js';
+import { type FileColumnSetOutput, type PreCheckM38FileDispatchResult } from '../../api/file-column-set.js';
+import type { MultipartTransport } from '../../api/multipart-transport.js';
+import type { RunContext } from '../../cli/run.js';
 import { type ProjectedItem } from '../../api/item-projection.js';
-export declare const itemUpdateOutputSchema: z.ZodObject<{
+import type { Warning } from '../../utils/output/envelope.js';
+/**
+ * Output envelope union — projected-item for the JSON translator
+ * path (text / status / dropdown / date / people / etc.) +
+ * file-dispatch envelope for the friendly `--set <file-col>=<path>`
+ * path. The file-dispatch shape ships across v0.6-M38 (single-item
+ * — `operation: 'add_file_to_column'`) and v0.7-M42 (bulk —
+ * `operation: 'item_update_bulk_file_set'`; the per-item fan-out's
+ * `data.results[i].asset` slots wrap M31's `Asset` projection). The
+ * union below admits only the single-item shape because the bulk
+ * variant is emitted via its own `bulkFileSetDataSchema` at the
+ * `runItemUpdateBulkFileDispatch` helper; agents discriminate on
+ * `operation` (present + literal value identifies the variant).
+ */
+export declare const itemUpdateOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     board_id: z.ZodNullable<z.ZodString>;
@@ -71,8 +89,29 @@ export declare const itemUpdateOutputSchema: z.ZodObject<{
             kind: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$loose>>>;
     }, z.core.$loose>>;
-}, z.core.$strict>;
-export type ItemUpdateOutput = ProjectedItem;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"add_file_to_column">;
+    item_id: z.ZodString;
+    column_id: z.ZodString;
+    filename: z.ZodString;
+    file_size_bytes: z.ZodNumber;
+    asset: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodString;
+        public_url: z.ZodString;
+        file_extension: z.ZodString;
+        file_size: z.ZodNumber;
+        created_at: z.ZodNullable<z.ZodString>;
+        uploaded_by: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>;
+        original_geometry: z.ZodNullable<z.ZodString>;
+        url_thumbnail: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export type ItemUpdateOutput = ProjectedItem | FileColumnSetOutput;
 /**
  * Input shape — supports both single-item and bulk shapes.
  *
@@ -96,6 +135,167 @@ declare const inputSchema: z.ZodObject<{
     continueOnError: z.ZodOptional<z.ZodBoolean>;
     concurrency: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
+type ParsedInput = z.infer<typeof inputSchema>;
 export declare const itemUpdateCommand: CommandModule<z.infer<typeof inputSchema>, ItemUpdateOutput>;
+/**
+ * Per-item dispatch result for v0.7-M42 bulk file `--set` carve-out
+ * fold. Mirrors the M25 `partialSuccessBulkUpdateResultSchema` shape
+ * with the file-dispatch's `asset` slot replacing the JSON path's
+ * `item` projection:
+ *
+ *   - Success: `{ item_id, ok: true, asset: { id, name, ... } }`
+ *   - Failure: `{ item_id, ok: false, error: { code, message } }`
+ *
+ * Schema landed at the v0.7-M42 pre-flight contract diff
+ * (`160330b`); runtime body shipped at v0.7-M42 IMPL (`22df2fa`)
+ * + R1 fix-up (`968b154`).
+ */
+export declare const bulkFileSetResultSchema: z.ZodObject<{
+    item_id: z.ZodString;
+    ok: z.ZodBoolean;
+    asset: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$loose>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BulkFileSetResult = z.infer<typeof bulkFileSetResultSchema>;
+/**
+ * Output `data` shape for the v0.7-M42 bulk file `--set` envelope.
+ * Mirrors M25's `partialSuccessBulkUpdateDataSchema` structure —
+ * `operation: 'item_update_bulk_file_set'` literal discriminator
+ * + `summary.{matched_count, applied_count, failed_count,
+ * board_id}` aggregate slots + per-item `results[]` array.
+ *
+ * Invariant: `matched_count === applied_count + failed_count` for
+ * every emitted envelope (mirrors M25's invariant).
+ */
+export declare const bulkFileSetDataSchema: z.ZodObject<{
+    operation: z.ZodLiteral<"item_update_bulk_file_set">;
+    summary: z.ZodObject<{
+        matched_count: z.ZodNumber;
+        applied_count: z.ZodNumber;
+        failed_count: z.ZodNumber;
+        board_id: z.ZodString;
+        column_id: z.ZodString;
+        filename: z.ZodString;
+        file_size_bytes: z.ZodNumber;
+    }, z.core.$strip>;
+    results: z.ZodArray<z.ZodObject<{
+        item_id: z.ZodString;
+        ok: z.ZodBoolean;
+        asset: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$loose>>;
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BulkFileSetData = z.infer<typeof bulkFileSetDataSchema>;
+interface RunItemUpdateBulkFileDispatchInputs {
+    readonly parsed: ParsedInput;
+    readonly client: MondayClient;
+    readonly multipart: MultipartTransport;
+    readonly ctx: RunContext;
+    readonly programOpts: unknown;
+    readonly apiVersion: string;
+    readonly boardId: string;
+    readonly matchedItemIds: readonly string[];
+    readonly m38: Extract<PreCheckM38FileDispatchResult, {
+        kind: 'file_bulk';
+    }>;
+    readonly metaSource: 'live' | 'cache' | 'mixed';
+    readonly metaCacheAgeSeconds: number | null;
+    readonly filterWarnings: readonly Warning[];
+    readonly retries: number;
+    /**
+     * v0.7-M42 IMPL: dry-run vs live branching. Carries `globalFlags.dryRun`
+     * from the bulk action body so the helper emits the D4 planned_changes
+     * envelope (per-item `add_file_to_column` entry) without burning multipart
+     * wire round-trips, or runs the per-item dispatch loop on the live path.
+     * Mirrors the M38 single-file helper's `isDryRun` slot for consistency
+     * across the file-dispatch family.
+     */
+    readonly isDryRun: boolean;
+    /**
+     * v0.7-M42 IMPL Codex R1 P1-1 fix: `globalFlags.noCache` threaded
+     * through so `foldAndRemap` (Codex pass-1 F4 remap from `src/api/
+     * resolver-error-fold.ts`) can refresh stale board metadata when a
+     * cache-served file-column resolution surfaces `validation_failed`
+     * post-dispatch. Without this, per-item failures bypass the
+     * stable-code rule (cli-design §6.5) — `column_archived` would not
+     * remap and agents would see `validation_failed` for an archived
+     * file column on file-bulk dispatch while the JSON-bulk path
+     * already surfaces `column_archived` for the same root cause.
+     */
+    readonly noCache: boolean;
+}
+/**
+ * Bulk file `--set` per-item dispatch helper (v0.7-M42 D5 carve-out
+ * fold).
+ *
+ * **Status: runtime body shipped at v0.7-M42 IMPL.** argv parse,
+ * shape validation, board-metadata load, pre-check (which returned
+ * `kind: 'file_bulk'` for callers reaching this helper), items_page
+ * walk, and the confirmation gate run upstream — this helper takes
+ * the resolved file-column dispatch slot + matched item-IDs and
+ * fans the multipart wire across them under the partial-success vs
+ * fail-fast contract.
+ *
+ * **Execution shape:**
+ *
+ *   1. Single upfront `precheckLocalFile(inputs.m38.rawValue)` —
+ *      one file path shared across all matched items. Failure
+ *      surfaces as `usage_error` (`file_not_readable` /
+ *      `file_empty`) whole-call-abort regardless of
+ *      `--continue-on-error` per D3 + cli-design §5.8 atomicity
+ *      discipline (pre-checks MUST fire BEFORE any wire round-trip).
+ *   2. Dry-run branch — emits the D4-shaped envelope with one
+ *      `add_file_to_column` planned_change per matched item-ID
+ *      (no file bytes loaded; no multipart wire). Unlike M38
+ *      single-item which pins `source: 'none'` (its dry-run is
+ *      pure-local), bulk dry-run carries the upstream legs'
+ *      aggregated `source` (metadata load + items_page walk —
+ *      `mixed` when metadata was cache-served, `live` otherwise);
+ *      reaching this branch already paid for those wire legs.
+ *   3. Live dispatch — two shapes per `parsed.continueOnError`:
+ *      - **Fail-fast (default)** — sequential loop over matched
+ *        items (no `--concurrency` per M30 D2 closure:
+ *        `--concurrency requires --continue-on-error`); first
+ *        per-item failure aborts whole-call with the v0.1-shaped
+ *        `details.applied_to` / `applied_count` / `failed_at_item`
+ *        / `matched_count` decoration so agents see how many
+ *        items applied before the failure.
+ *      - **`--continue-on-error`** — routes through
+ *        {@link dispatchSequential} (concurrency `undefined`/`1`)
+ *        or {@link dispatchParallel} (concurrency `> 1`) over a
+ *        shared {@link MultipartTransport}; per-item failures
+ *        land as `data.results[i].error: {code, message}` records,
+ *        successes carry `data.results[i].asset` via a side-map
+ *        fold keyed by `item_id`. `internal_error` re-throws
+ *        whole-call via the shared dispatchers' escape hatch
+ *        (M14 round-2 F1 precedent) so schema drift surfaces as
+ *        top-level `ok: false` rather than per-record.
+ *   4. Cache invalidation — single `invalidateBoard(boardId, env)`
+ *      after the dispatch loop completes (mirrors M38's single-
+ *      leg invalidate timing; one board covers every matched
+ *      item's mutated `asset` slot).
+ *   5. Envelope emit — `data: BulkFileSetData` with the
+ *      `operation: 'item_update_bulk_file_set'` literal
+ *      discriminator + per-item `results[]` + aggregate
+ *      `summary.{matched_count, applied_count, failed_count,
+ *      board_id, column_id, filename, file_size_bytes}`. Warnings
+ *      threaded as `dedupeWarnings([...filterWarnings,
+ *      ...m38.warnings])` (mirrors the JSON-bulk path); source
+ *      derives from `metaSource` (cache-served metadata + live
+ *      wire calls → `mixed`).
+ */
+export declare const runItemUpdateBulkFileDispatch: (inputs: RunItemUpdateBulkFileDispatchInputs) => Promise<void>;
 export {};
 //# sourceMappingURL=update.d.ts.map

package/dist/commands/item/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/item/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA+CnE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AActC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsB,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;kBAmFd,CAAC;AA0FJ,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAoPjB,CAAC"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/item/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAOnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EACnC,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AA8C3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAYtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;kBAmFd,CAAC;AAEJ,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAwF/C,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAC3C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,gBAAgB,CAuVjB,CAAC;AAi7BF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAgBlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAYhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,6BAA6B,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,SAAS,OAAO,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,eAAO,MAAM,6BAA6B,GACxC,QAAQ,mCAAmC,KAC1C,OAAO,CAAC,IAAI,CA4bd,CAAC"}