monday-cli 0.2.0 → 0.4.0

package/dist/utils/json.js

@@ -0,0 +1,86 @@
+/**
+ * Shared JSON-shape type-guards (`docs/v0.3-plan.md` §22 R-NEW-27
+ * lift, post-M24 close-docs audit).
+ *
+ * Before this lift, six structurally-identical `isObject` /
+ * `isJsonObject` / `isPlainObject` guards existed across the
+ * codebase (4 production + 2 test). The pattern accumulated
+ * silently from M2 (fixtures + e2e infrastructure) through M24
+ * (item-history-projection JSON parsing). M24's developer added
+ * a fresh local copy rather than discovering the existing 5 — the
+ * same miss + mass-migrate cadence as R-NEW-14/15/16 (error
+ * utilities) and R-NEW-19 (safeParse → unwrapOrThrow).
+ *
+ * Consumers narrow `unknown` to `Readonly<Record<string, unknown>>`
+ * before reading keyed fields off untrusted external payloads
+ * (Monday wire responses, JSON-from-disk cassettes, e2e fixture
+ * server bodies). `Readonly` is the more defensive choice — none
+ * of the existing consumers mutate the guarded value, and any
+ * downstream code that needs a mutable shape casts explicitly.
+ */
+/**
+ * Type-guard for "value is a plain JSON object" — narrows
+ * `unknown` to `Readonly<Record<string, unknown>>`. Returns
+ * false for null, arrays, and primitives.
+ */
+export const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/**
+ * `parseJsonArg` (R-NEW-42 lift, post-M27-close drift sweep).
+ *
+ * Three sites in `src/commands/*` consume a JSON-encoded argv
+ * string + reject malformed JSON as `usage_error`:
+ *
+ *   - `monday raw --vars <json>` / `--vars-file <path>`
+ *     (`src/commands/raw/index.ts`)
+ *   - `monday board column-create --settings <json>`
+ *     (`src/commands/board/column-create.ts`)
+ *   - `monday webhook create --config <json>`
+ *     (`src/commands/webhook/create.ts`, M27 IMPL)
+ *
+ * Each site pre-lift wrapped `JSON.parse` in try/catch + threw
+ * `UsageError` with a verb-specific message + `cause: err` +
+ * verb-specific `details`. The shape is structurally identical;
+ * the only variation is the message prefix + which detail-keys
+ * land. M27 IMPL pushed the count to 3, crossing the R7/R8
+ * 3-consumer threshold; this lift ships at the post-M27-close
+ * drift sweep mirroring R-NEW-38's same-cadence lift at
+ * `c71a96d`.
+ *
+ * Behavioural note: pre-lift, `webhook/create.ts` did NOT
+ * interpolate the underlying `JSON.parse` error message
+ * (just the static `'--config must be a valid JSON-encoded
+ * string'` text). The other two sites used `errorMessage(err)`
+ * to surface the SyntaxError detail. The lift normalises to
+ * always interpolate — better diagnostic value, no
+ * agent-facing contract change (the `error.code` stays
+ * `usage_error`; only `error.message` widens).
+ */
+import { UsageError } from './errors.js';
+import { errorMessage } from './errors.js';
+/**
+ * Parses a JSON-encoded argv string. Returns the parsed value
+ * (`unknown` — caller narrows via downstream zod / type-guard);
+ * on `SyntaxError` (or any other thrown value from `JSON.parse`)
+ * throws `UsageError` with the supplied context, the underlying
+ * error as `cause`, and the supplied `details`.
+ *
+ * Use at every argv-parse-boundary that consumes user-supplied
+ * JSON (`--vars`, `--settings`, `--config`, future
+ * `--<field>-json` flags). Do NOT use for response-side parsing
+ * (Monday wire returns) — those go through `unwrapOrThrow` +
+ * a zod schema.
+ */
+export const parseJsonArg = (raw, options) => {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new UsageError(`${options.context} (${errorMessage(err)})`, {
+            cause: err,
+            ...(options.details === undefined
+                ? {}
+                : { details: options.details }),
+        });
+    }
+};
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,CAAU,EAC8B,EAAE,CAC1C,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsB3C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,GAAW,EACX,OAA4B,EACnB,EAAE;IACX,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,GAAG,OAAO,CAAC,OAAO,KAAK,YAAY,CAAC,GAAG,CAAC,GAAG,EAC3C;YACE,KAAK,EAAE,GAAG;YACV,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;gBAC/B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;SAClC,CACF,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/mime.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Best-effort MIME-type sniff from a file's extension. Used by the
+ * v0.4-M31 asset-upload verbs (`item upload` / `update upload`) to
+ * populate the `Blob`'s `Content-Type` slot before the multipart
+ * dispatch — Monday's multipart parser surfaces this as the asset's
+ * `Content-Type` header on the binary part.
+ *
+ * **Lifted at v0.4-M31 IMPL** from byte-identical inline copies in
+ * `src/commands/item/upload.ts` + `src/commands/update/upload.ts`
+ * (2-consumer trigger fired at IMPL — duplication caught at the
+ * coverage check + a future asset-upload-shaped surface — webhook
+ * delivery, OAuth refresh, etc. — would be the 3rd). Mirrors the
+ * R-NEW-29 (`executeItemMutation`) / R-NEW-30
+ * (`resolveActiveDevProfile`) lift-at-N-consumer cadence.
+ *
+ * **Scope: deliberately narrow.** The CLI is not a MIME-detection
+ * library; the table covers the common image / document / archive /
+ * media types an agent's likely upload picks up by extension. Unknown
+ * extensions fall back to `application/octet-stream`, which Monday
+ * accepts and treats as binary. Future extensions land additively
+ * by extending the switch.
+ */
+export declare const sniffContentType: (filename: string) => string;
+//# sourceMappingURL=mime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../src/utils/mime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAwCnD,CAAC"}

package/dist/utils/mime.js

@@ -0,0 +1,64 @@
+/**
+ * Best-effort MIME-type sniff from a file's extension. Used by the
+ * v0.4-M31 asset-upload verbs (`item upload` / `update upload`) to
+ * populate the `Blob`'s `Content-Type` slot before the multipart
+ * dispatch — Monday's multipart parser surfaces this as the asset's
+ * `Content-Type` header on the binary part.
+ *
+ * **Lifted at v0.4-M31 IMPL** from byte-identical inline copies in
+ * `src/commands/item/upload.ts` + `src/commands/update/upload.ts`
+ * (2-consumer trigger fired at IMPL — duplication caught at the
+ * coverage check + a future asset-upload-shaped surface — webhook
+ * delivery, OAuth refresh, etc. — would be the 3rd). Mirrors the
+ * R-NEW-29 (`executeItemMutation`) / R-NEW-30
+ * (`resolveActiveDevProfile`) lift-at-N-consumer cadence.
+ *
+ * **Scope: deliberately narrow.** The CLI is not a MIME-detection
+ * library; the table covers the common image / document / archive /
+ * media types an agent's likely upload picks up by extension. Unknown
+ * extensions fall back to `application/octet-stream`, which Monday
+ * accepts and treats as binary. Future extensions land additively
+ * by extending the switch.
+ */
+export const sniffContentType = (filename) => {
+    const lastDot = filename.lastIndexOf('.');
+    const ext = lastDot >= 0 ? filename.slice(lastDot + 1).toLowerCase() : '';
+    switch (ext) {
+        case 'png':
+            return 'image/png';
+        case 'jpg':
+        case 'jpeg':
+            return 'image/jpeg';
+        case 'gif':
+            return 'image/gif';
+        case 'webp':
+            return 'image/webp';
+        case 'svg':
+            return 'image/svg+xml';
+        case 'pdf':
+            return 'application/pdf';
+        case 'json':
+            return 'application/json';
+        case 'txt':
+        case 'log':
+        case 'md':
+            return 'text/plain';
+        case 'csv':
+            return 'text/csv';
+        case 'html':
+            return 'text/html';
+        case 'zip':
+            return 'application/zip';
+        case 'gz':
+            return 'application/gzip';
+        case 'mp4':
+            return 'video/mp4';
+        case 'mov':
+            return 'video/quicktime';
+        case 'mp3':
+            return 'audio/mpeg';
+        default:
+            return 'application/octet-stream';
+    }
+};
+//# sourceMappingURL=mime.js.map

package/dist/utils/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../src/utils/mime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC;QAC5B,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,IAAI;YACP,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC;QAC3B,KAAK,IAAI;YACP,OAAO,kBAAkB,CAAC;QAC5B,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC;QAC3B,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,0BAA0B,CAAC;IACtC,CAAC;AACH,CAAC,CAAC"}

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

@@ -40,6 +40,28 @@ export interface MetaInput {
     readonly next_cursor?: string | null;
     readonly has_more?: boolean;
     readonly total_returned?: number;
+    /**
+     * v0.4-M29 streaming-trailer session counters per cli-design §14.4
+     * closure + output-shapes.md `item watch` entry. Flat under `_meta`
+     * (NOT nested) so agents read each slot directly. Set only by
+     * `monday item watch <iid>`; absent on every other surface.
+     */
+    readonly events_emitted?: number;
+    readonly polls_made?: number;
+    readonly failed_polls?: number;
+    readonly watch_duration_seconds?: number;
+    readonly last_seen_event_id?: string | null;
+    readonly circuit_broken_at?: string | null;
+    readonly exit_reason?: string;
+    /**
+     * §6.3 streaming-trailer warnings channel. NDJSON has no envelope-
+     * level `warnings[]` slot (warnings would otherwise interleave with
+     * resource lines and break the "trailer = stream-end sentinel"
+     * contract); the agreed home is `_meta.warnings`. Set by streaming
+     * verbs whose walker accumulates warnings (currently `item watch`'s
+     * `WatchSessionWarning[]` channel).
+     */
+    readonly warnings?: readonly Warning[];
     readonly columns?: Readonly<Record<string, ColumnHead>>;
 }
 export interface Meta {
@@ -61,6 +83,14 @@ export interface Meta {
     readonly next_cursor?: string | null;
     readonly has_more?: boolean;
     readonly total_returned?: number;
+    readonly events_emitted?: number;
+    readonly polls_made?: number;
+    readonly failed_polls?: number;
+    readonly watch_duration_seconds?: number;
+    readonly last_seen_event_id?: string | null;
+    readonly circuit_broken_at?: string | null;
+    readonly exit_reason?: string;
+    readonly warnings?: readonly Warning[];
     readonly columns?: Readonly<Record<string, ColumnHead>>;
 }
 export interface Warning {

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

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

package/dist/utils/output/envelope.js

@@ -44,6 +44,32 @@ export const buildMeta = (input) => {
     if (input.total_returned !== undefined) {
         meta.total_returned = input.total_returned;
     }
+    // v0.4-M29 streaming-trailer slots. Inserted between `total_returned`
+    // and `columns` to match the output-shapes.md `item watch` sample.
+    if (input.events_emitted !== undefined) {
+        meta.events_emitted = input.events_emitted;
+    }
+    if (input.polls_made !== undefined) {
+        meta.polls_made = input.polls_made;
+    }
+    if (input.failed_polls !== undefined) {
+        meta.failed_polls = input.failed_polls;
+    }
+    if (input.watch_duration_seconds !== undefined) {
+        meta.watch_duration_seconds = input.watch_duration_seconds;
+    }
+    if (input.last_seen_event_id !== undefined) {
+        meta.last_seen_event_id = input.last_seen_event_id;
+    }
+    if (input.circuit_broken_at !== undefined) {
+        meta.circuit_broken_at = input.circuit_broken_at;
+    }
+    if (input.exit_reason !== undefined) {
+        meta.exit_reason = input.exit_reason;
+    }
+    if (input.warnings !== undefined) {
+        meta.warnings = input.warnings;
+    }
     if (input.columns !== undefined) {
         meta.columns = input.columns;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/utils/output/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,CAAC,MAAM,sBAAsB,GAAkB,GAAG,CAAC;AAqHzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAgB,EAAQ,EAAE;IAClD,oEAAoE;IACpE,mEAAmE;IACnE,8BAA8B;IAC9B,MAAM,IAAI,GAcN;QACF,cAAc,EAAE,sBAAsB;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;QAClD,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,2DAA2D;QAC3D,8DAA8D;QAC9D,0DAA0D;QAC1D,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;KACrC,CAAC;IAEF,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAO,EACP,IAAU,EACV,WAA+B,EAAE,EACb,EAAE,CAAC,CAAC;IACxB,EAAE,EAAE,IAAI;IACR,IAAI;IACJ,IAAI;IACJ,QAAQ;CACT,CAAC,CAAC;AAeH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAA8B,EACT,EAAE;IACvB,MAAM,GAAG,GAOL;QACF,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;KAChC,CAAC;IACF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,cAA4D,EAC5D,IAAU,EACV,WAA+B,EAAE,EACjB,EAAE,CAAC,CAAC;IACpB,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,IAAI;IACV,qEAAqE;IACrE,gDAAgD;IAChD,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7F,eAAe,EAAE,cAAc;IAC/B,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAqB,EACrB,IAAU,EACK,EAAE,CAAC,CAAC;IACnB,EAAE,EAAE,KAAK;IACT,KAAK,EAAE;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACrC,WAAW,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACrC,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,UAAU;QAC9C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,mBAAmB,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;QACpD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;KAC/B;IACD,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,IAAU,EAAa,EAAE;IAClD,MAAM,KAAK,GAEP;QACF,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;IACF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACvC,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/utils/output/envelope.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import type { Meta, Warning } from './envelope.js';
+import type { ColumnHead, Complexity, DataSource, Meta, Warning } from './envelope.js';
 /**
  * NDJSON renderer for collections (`cli-design.md` §6.3).
  *
@@ -20,7 +20,7 @@ import type { Meta, Warning } from './envelope.js';
  * processing without waiting for the whole walk, not so the
  * presentation layer can drop bytes.
  *
- * Two surfaces:
+ * Three surfaces:
  *
  * - `renderNdjson` (collect-then-emit) — used when the caller
  *   already has the full data array. Single function, no streaming
@@ -34,6 +34,14 @@ import type { Meta, Warning } from './envelope.js';
  *   (M7), `item search` (M18), `update list` (M18). Was previously
  *   a private helper in `src/commands/item/list.ts`; lifted at the
  *   3-consumer trigger.
+ *
+ * - `buildStreamingTrailerMeta` (R53, post-v0.2 cleanup-window lift)
+ *   — sibling to `startNdjsonStream`. Builds the canonical
+ *   §6.3 trailer Meta from the walker result + the three
+ *   source/cache/api inputs. Same three consumers; consolidates
+ *   the ~15-line `buildMeta(...)` boilerplate that was repeated
+ *   across each call site, with cursor-vs-page + column-bearing-
+ *   vs-not divergence handled via optional inputs.
  */
 export interface NdjsonInput {
     readonly data: readonly unknown[];
@@ -55,7 +63,9 @@ export declare const renderNdjson: (input: NdjsonInput, stream: NodeJS.WritableS
  *   (typically `ctx.stdout`).
  * - `secrets` — token bytes the redactor scrubs from every emitted
  *   line (per `.claude/rules/security.md` "value-scanning filter").
- *   Caller passes `collectSecrets(ctx.env)`.
+ *   Caller passes `collectSecrets(ctx.env, ctx.runtimeSecrets)`
+ *   (the v0.3-M21 §7.4.3 redaction-runtime extension folds
+ *   credentials-cache `access_token` values in via the second arg).
  * - `project` — per-item projection callback. Decouples the helper
  *   from per-noun output shape: item list/search projects raw
  *   Monday rows through `projectFromRaw`; update list runs items
@@ -89,4 +99,81 @@ export interface NdjsonStreamHandle<T> {
     readonly writeTrailer: (meta: Meta) => void;
 }
 export declare const startNdjsonStream: <T>(inputs: NdjsonStreamInputs<T>) => NdjsonStreamHandle<T>;
+/**
+ * Inputs to `buildStreamingTrailerMeta` (R53 lift, v0.2-plan §22).
+ * Sibling to `startNdjsonStream` — both implement §6.3.
+ *
+ * Three NDJSON consumers (item list / item search / update list)
+ * end up calling `buildMeta(...)` with structurally near-identical
+ * inputs, varying only on whether the noun carries `next_cursor`
+ * (cursor-walked vs page-walked) and `meta.columns` (column-bearing
+ * or not). The helper takes the walker-shaped `result` block + the
+ * three meta source/cache/api inputs + an optional `columns` slot,
+ * builds the canonical-key-order Meta via `buildMeta`, and returns
+ * it ready for `stream.writeTrailer`.
+ *
+ * Five fields total — within the >4-parameter heuristic that
+ * deferred R44 / R49 / R50, since `ctx` and `result` are
+ * structurally complete units (not flat scalars to count).
+ *
+ * Per-consumer divergence the helper preserves:
+ * - cursor-walked consumers (item list / item search) populate
+ *   `result.nextCursor`; the trailer carries `next_cursor`.
+ * - page-walked consumers (update list) omit `result.nextCursor`;
+ *   the trailer drops `next_cursor` entirely (buildMeta convention:
+ *   undefined input → key absent from output).
+ * - column-bearing consumers (item list / item search) populate
+ *   `columns`; non-bearing consumers (update list) omit it; the
+ *   trailer mirrors the input shape on a per-consumer basis.
+ *
+ * The complexity slot is always required: the cursor-walker exposes
+ * it directly on `result.complexity`; the page-walker exposes it
+ * via `result.lastResponse.complexity`. Each consumer extracts at
+ * the call site; the helper takes the post-extraction value.
+ */
+export interface StreamingTrailerInputs {
+    readonly ctx: {
+        readonly cliVersion: string;
+        readonly requestId: string;
+        readonly clock: () => Date;
+    };
+    readonly apiVersion: string;
+    readonly source: DataSource;
+    readonly cacheAgeSeconds: number | null;
+    readonly result: {
+        readonly hasMore: boolean;
+        readonly totalReturned: number;
+        readonly complexity: Complexity | null;
+        /** Omit for page-walked consumers; trailer drops `next_cursor`. */
+        readonly nextCursor?: string | null;
+    };
+    /** Omit for non-column-bearing nouns; trailer drops `columns`. */
+    readonly columns?: Readonly<Record<string, ColumnHead>>;
+    /**
+     * v0.4-M29 `monday item watch` session counters. Optional bundle —
+     * absent for every streaming verb except `item watch`. Lands flat
+     * under `_meta` (not nested under a sub-object) so agents read
+     * each slot directly per cli-design §6.3 + the `item watch` entry
+     * in output-shapes.md.
+     */
+    readonly session?: {
+        readonly eventsEmitted: number;
+        readonly pollsMade: number;
+        readonly failedPolls: number;
+        readonly watchDurationSeconds: number;
+        readonly lastSeenEventId: string | null;
+        readonly circuitBrokenAt: string | null;
+        readonly exitReason: string;
+    };
+    /**
+     * §6.3 streaming-trailer warnings channel. Folded into
+     * `_meta.warnings[]` per the NDJSON contract (resource lines +
+     * final `_meta`; warnings NOT interleaved with event records).
+     * Currently set by `item watch`'s `WatchSessionWarning[]`
+     * accumulator; previously omitted by every NDJSON consumer
+     * (the slot is additive — backwards-compatible).
+     */
+    readonly warnings?: readonly Warning[];
+}
+export declare const buildStreamingTrailerMeta: (inputs: StreamingTrailerInputs) => Meta;
 //# sourceMappingURL=ndjson.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../../src/utils/output/ndjson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,eAAO,MAAM,YAAY,GACvB,OAAO,WAAW,EAClB,QAAQ,MAAM,CAAC,cAAc,KAC5B,IAKF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC7C;AAgBD,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,QAAQ,kBAAkB,CAAC,CAAC,CAAC,KAC5B,kBAAkB,CAAC,CAAC,CAatB,CAAC"}
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../../src/utils/output/ndjson.ts"],"names":[],"mappings":"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"}

package/dist/utils/output/ndjson.js

@@ -1,3 +1,4 @@
+import { buildMeta } from './envelope.js';
 import { redact } from '../redact.js';
 export const renderNdjson = (input, stream) => {
     for (const resource of input.data) {
@@ -30,4 +31,36 @@ export const startNdjsonStream = (inputs) => {
         },
     };
 };
+export const buildStreamingTrailerMeta = (inputs) => buildMeta({
+    api_version: inputs.apiVersion,
+    cli_version: inputs.ctx.cliVersion,
+    request_id: inputs.ctx.requestId,
+    source: inputs.source,
+    retrieved_at: inputs.ctx.clock().toISOString(),
+    cache_age_seconds: inputs.cacheAgeSeconds,
+    complexity: inputs.result.complexity,
+    has_more: inputs.result.hasMore,
+    total_returned: inputs.result.totalReturned,
+    // Conditional spreads preserve `exactOptionalPropertyTypes`'s
+    // "undefined ≠ absent" rule: passing the keys with explicit
+    // `undefined` would not compile against the optional `?:` slots
+    // in `MetaInput`, even though `buildMeta` would have stripped
+    // them anyway.
+    ...(inputs.result.nextCursor === undefined
+        ? {}
+        : { next_cursor: inputs.result.nextCursor }),
+    ...(inputs.session === undefined
+        ? {}
+        : {
+            events_emitted: inputs.session.eventsEmitted,
+            polls_made: inputs.session.pollsMade,
+            failed_polls: inputs.session.failedPolls,
+            watch_duration_seconds: inputs.session.watchDurationSeconds,
+            last_seen_event_id: inputs.session.lastSeenEventId,
+            circuit_broken_at: inputs.session.circuitBrokenAt,
+            exit_reason: inputs.session.exitReason,
+        }),
+    ...(inputs.warnings === undefined ? {} : { warnings: inputs.warnings }),
+    ...(inputs.columns === undefined ? {} : { columns: inputs.columns }),
+});
 //# sourceMappingURL=ndjson.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ndjson.js","sourceRoot":"","sources":["../../../src/utils/output/ndjson.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAkDtC,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAkB,EAClB,MAA6B,EACvB,EAAE;IACR,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC,CAAC;AA6CF,MAAM,aAAa,GAAG,KAAK,EACzB,MAA6B,EAC7B,KAAa,EACE,EAAE;IACjB,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO;IAChC,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAA6B,EACN,EAAE;IACzB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC5C,OAAO;QACL,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACrB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,MAAM,aAAa,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"ndjson.js","sourceRoot":"","sources":["../../../src/utils/output/ndjson.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AA+BH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA0GD;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,EAAE,UAAS,aAAkB,KAAG,OASpE,CAAC"}
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAwCH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAkID;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,EAAE,UAAS,aAAkB,KAAG,OASpE,CAAC"}

package/dist/utils/redact.js

@@ -25,10 +25,19 @@
  * with a `[Circular]` marker — never the original value, never a
  * thrown error that could leak in a stack trace.
  */
+// `access_token` joins the list at v0.3-M21 pre-flight per cli-design
+// §7.4.3 — the credentials cache (§7.4.1) keys per-profile entries
+// under `access_token: <opaque-monday-token>`, so any path that
+// emits a credentials-cache excerpt (debug bundle, error envelopes
+// rooted in a credentials-read failure) scrubs the value via this
+// list. The runtime value-scanning extension that loads + folds
+// credentials values into the secret-bag lands at M21 implementation
+// alongside the `monday auth login` body.
 const DEFAULT_SENSITIVE_KEYS = [
     'apiToken',
     'Authorization',
     'MONDAY_API_TOKEN',
+    'access_token',
 ];
 // Negative lookahead `(?!s)` excludes plural forms (`tokens`,
 // `secrets`, `passwords`, `api_keys`) — those are container key
@@ -125,6 +134,28 @@ const redactInternal = (value, ctx) => {
     const result = {};
     for (const [key, child] of Object.entries(value)) {
         if (isSensitiveKey(key, ctx.extraKeys, ctx.extraPattern)) {
+            // Default: redact. Only booleans, finite numbers, and `null`
+            // are preserved verbatim — these cannot encode a token byte
+            // sequence in JSON output and are the carrier types for
+            // structural-presence shapes like `set: {MONDAY_API_TOKEN:
+            // true}` (M22 `monday status` env-var-pickup probe per
+            // cli-design §11.5.2). Symbols, functions, bigints, and
+            // `undefined` redact wholesale because:
+            //   - Symbol descriptions can encode secret bytes
+            //     (`Symbol("tok-…")`),
+            //   - function source can encode secret bytes,
+            //   - bigints could theoretically encode a numeric token,
+            //   - `undefined` is omitted by `JSON.stringify` (no visible
+            //     side effect), but consistency: anything that isn't a
+            //     bool/number/null defaults to redact.
+            // Codex M22 W8 ratified the allowlist shape so the
+            // loosening doesn't leak via unusual scalar types.
+            if (typeof child === 'boolean' ||
+                typeof child === 'number' ||
+                child === null) {
+                result[key] = child;
+                continue;
+            }
             result[key] = ctx.placeholder;
             continue;
         }

package/dist/utils/redact.js.map

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

package/dist/utils/signal.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AbortSignal utilities shared across dispatchers + streaming verbs
+ * (R-NEW-55).
+ *
+ * Three consumers today share the "extract `signal.reason` as an
+ * Error, fall back to a fresh `Error('aborted')`" pattern:
+ *
+ *   1. `src/api/partial-success-mutation.ts:dispatchSequential` —
+ *      iteration-boundary signal check; re-throws the reason
+ *      whole-call.
+ *   2. `src/api/parallel-dispatch.ts:dispatchParallel` — worker-
+ *      loop signal check; re-throws + sets the pool's `aborted`
+ *      flag so other workers stop scheduling new dispatches.
+ *   3. `src/api/item-watch.ts:sleepWithSignal` — both the
+ *      race-window guard (sync `signal.aborted` check before
+ *      listener registration) and the abort-listener path
+ *      reject the sleep promise with the extracted reason.
+ *
+ * `src/api/retry.ts:signalAbortError` is semantically adjacent but
+ * DELIBERATELY divergent: retry.ts assigns `name = 'AbortError'` to
+ * match the Web Platform's DOMException-style surface so callers
+ * can branch on `err.name === 'AbortError'`. Stays inline to
+ * preserve the DOMException naming. {@link extractSignalReason}
+ * below matches the dispatcher / sleep-helper semantics (no
+ * `AbortError` rename); retry.ts carries its own naming-preserving
+ * variant.
+ */
+/**
+ * Reads `signal.reason` and returns it as an `Error` instance the
+ * caller can `throw` directly. When the abort reason is already an
+ * `Error`, return it verbatim — preserves cause chains, error
+ * classes (`UsageError`, `ApiError`, etc.), and any
+ * caller-attached details. When the reason is anything else (a
+ * bare string, `undefined`, a non-Error object), wrap in a fresh
+ * `Error('aborted')` so the caller always has a throwable shape.
+ *
+ * Used by `dispatchSequential` + `dispatchParallel` (iteration /
+ * worker-loop signal check) and `sleepWithSignal` (race-window
+ * abort + listener-fired abort).
+ */
+export declare const extractSignalReason: (signal: AbortSignal) => Error;
+//# sourceMappingURL=signal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/utils/signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,WAAW,KAAG,KAGzD,CAAC"}