monday-cli 0.2.0 → 0.4.0

package/dist/utils/signal.js

@@ -0,0 +1,45 @@
+/**
+ * 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 const extractSignalReason = (signal) => {
+    const reason = signal.reason;
+    return reason instanceof Error ? reason : new Error('aborted');
+};
+//# sourceMappingURL=signal.js.map

package/dist/utils/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../src/utils/signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAmB,EAAS,EAAE;IAChE,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monday-cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Agent-first CLI for Monday.com — read boards, file backlog items, transition statuses, and post comments from the terminal. Built for AI coding agents (Claude Code, Codex) with humans as a welcome second audience.",
   "type": "module",
   "engines": {
@@ -69,6 +69,7 @@
     "dotenv": "^17.0.0",
     "graphql": "^16.8.2",
     "ora": "^9.0.0",
+    "smol-toml": "^1.6.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/dist/commands/account/client-helper.d.ts

@@ -1,37 +0,0 @@
-/**
- * Shared `MondayClient` construction for the `account/*` commands.
- *
- * Each network command needs the same plumbing — load config (for
- * the API token + URL + version), pick up global flags (`--retry`,
- * `--verbose`, `--api-version`, `--timeout`), and either wrap the
- * injected `Transport` (test path) or build a `FetchTransport` from
- * config (production path). Centralising here:
- *
- *   - keeps the action body in each command focused on the GraphQL
- *     call + envelope mapping;
- *   - means the `--api-version` precedence rule (flag > env > SDK
- *     pin) lives in one place;
- *   - means a future profile switch / OAuth path swaps in here once,
- *     not per-command.
- *
- * The injected `ctx.transport` always wins — that's the fixture seam
- * for integration tests. Production callers leave it undefined and
- * a fresh `FetchTransport` is built per command invocation, so each
- * call sees the live config (same as the SDK's per-call client).
- */
-import { MondayClient } from '../../api/client.js';
-import { type GlobalFlags } from '../../types/global-flags.js';
-import type { RunContext } from '../../cli/run.js';
-export interface ResolvedClient {
-    readonly client: MondayClient;
-    readonly globalFlags: GlobalFlags;
-    /**
-     * The actual `API-Version` value sent on the wire — `--api-version`
-     * flag > `MONDAY_API_VERSION` env > SDK pin. Surfaced so the
-     * envelope's `meta.api_version` carries the same value the request
-     * carried.
-     */
-    readonly apiVersion: string;
-}
-export declare const resolveClient: (ctx: RunContext, programOpts: unknown) => ResolvedClient;
-//# sourceMappingURL=client-helper.d.ts.map

package/dist/commands/account/client-helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-helper.d.ts","sourceRoot":"","sources":["../../../src/commands/account/client-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,GACxB,KAAK,UAAU,EACf,aAAa,OAAO,KACnB,cAoCF,CAAC"}

package/dist/commands/account/client-helper.js

@@ -1,55 +0,0 @@
-/**
- * Shared `MondayClient` construction for the `account/*` commands.
- *
- * Each network command needs the same plumbing — load config (for
- * the API token + URL + version), pick up global flags (`--retry`,
- * `--verbose`, `--api-version`, `--timeout`), and either wrap the
- * injected `Transport` (test path) or build a `FetchTransport` from
- * config (production path). Centralising here:
- *
- *   - keeps the action body in each command focused on the GraphQL
- *     call + envelope mapping;
- *   - means the `--api-version` precedence rule (flag > env > SDK
- *     pin) lives in one place;
- *   - means a future profile switch / OAuth path swaps in here once,
- *     not per-command.
- *
- * The injected `ctx.transport` always wins — that's the fixture seam
- * for integration tests. Production callers leave it undefined and
- * a fresh `FetchTransport` is built per command invocation, so each
- * call sees the live config (same as the SDK's per-call client).
- */
-import { createFetchTransport } from '../../api/transport.js';
-import { MondayClient, PINNED_API_VERSION } from '../../api/client.js';
-import { loadConfig } from '../../config/load.js';
-import { parseGlobalFlags, } from '../../types/global-flags.js';
-export const resolveClient = (ctx, programOpts) => {
-    const globalFlags = parseGlobalFlags(programOpts, ctx.env);
-    const config = loadConfig(ctx.env);
-    // Precedence: explicit flag > env-derived config > SDK pin.
-    const apiVersion = globalFlags.apiVersion ?? config.apiVersion ?? PINNED_API_VERSION;
-    // Honour `--timeout` over the env / config default. Same reading
-    // as the design intent: the flag is a *per-invocation* override.
-    const timeoutMs = globalFlags.timeout ?? config.requestTimeoutMs;
-    const transport = ctx.transport ??
-        createFetchTransport({
-            endpoint: config.apiUrl,
-            apiToken: config.apiToken,
-            apiVersion,
-            timeoutMs,
-        });
-    const client = new MondayClient({
-        transport,
-        signal: ctx.signal,
-        retries: globalFlags.retry,
-        verbose: globalFlags.verbose,
-    });
-    // Stash the resolved meta on the runner so an error envelope
-    // emitted by the catch-all carries the same api_version + source
-    // a success envelope would. Without this, `--api-version 2026-04
-    // account whoami` failing with HTTP 401 produced an error envelope
-    // claiming `api_version: "2026-01"` (Codex M2 review §2).
-    ctx.setMetaHint({ apiVersion, source: 'live' });
-    return { client, globalFlags, apiVersion };
-};
-//# sourceMappingURL=client-helper.js.map

package/dist/commands/account/client-helper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-helper.js","sourceRoot":"","sources":["../../../src/commands/account/client-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AAerC,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,GAAe,EACf,WAAoB,EACJ,EAAE;IAClB,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEnC,4DAA4D;IAC5D,MAAM,UAAU,GACd,WAAW,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,IAAI,kBAAkB,CAAC;IAEpE,iEAAiE;IACjE,iEAAiE;IACjE,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,IAAI,MAAM,CAAC,gBAAgB,CAAC;IAEjE,MAAM,SAAS,GACb,GAAG,CAAC,SAAS;QACb,oBAAoB,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC,MAAM;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU;YACV,SAAS;SACV,CAAC,CAAC;IAEL,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,SAAS;QACT,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,WAAW,CAAC,KAAK;QAC1B,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC,CAAC;IAEH,6DAA6D;IAC7D,iEAAiE;IACjE,iEAAiE;IACjE,mEAAmE;IACnE,0DAA0D;IAC1D,GAAG,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAC7C,CAAC,CAAC"}