monday-cli 0.2.0 → 0.3.0

package/dist/api/tag-directory.js

@@ -0,0 +1,325 @@
+/**
+ * Per-account tag-directory lookup helper for the v0.3-M19 `tags`
+ * friendly translator. Mirrors the `userByEmail` user-directory
+ * pattern in `src/api/resolvers.ts:191–402` (the existing precedent —
+ * there is no standalone `user-directory.ts` module; the user-
+ * directory cache / lookup / refresh-on-miss machinery lives inside
+ * `resolvers.ts`).
+ *
+ * **Two surfaces.**
+ *
+ *   - `loadAccountTags({client, env?, noCache?})` — full-directory
+ *     reader. Cache-then-live: prefers a fresh on-disk
+ *     `account_tags/index.json` cache entry; falls through to a live
+ *     `account { tags { id name } }` query on miss / expiry / `noCache`,
+ *     and writes the response back to the cache. Also exposes
+ *     `complexity: Complexity | null` for the live-fetch leg, mirroring
+ *     `BoardMetadataLoadResult` so `monday account tags --verbose` can
+ *     report budget like other cache-backed reads.
+ *
+ *   - `resolveTags({client, input, env?, noCache?})` — name-list →
+ *     tag-id resolver. Splits the input on commas, trims, deduplicates,
+ *     NFC + case-fold matches against the cache; on any miss, refreshes
+ *     the directory once (live `account.tags` re-fetch) and re-checks.
+ *     Residual misses surface as `tag_not_found` per cli-design §6.5
+ *     with `details.tags: misses[]` in array form (Decision 1, closed
+ *     at `4c652d5`). Returns `{ ids, misses, source, cacheAgeSeconds }`
+ *     so the caller can populate `meta.source` + `meta.cache_age_seconds`
+ *     per cli-design §6.1.
+ *
+ * **Cache shape.** Per-account scope (`{ kind: 'accountTags' }` cache
+ * key, no per-board fan-out — Monday's data model scopes tags to the
+ * account, not the workspace). On-disk path
+ * `account_tags/index.json`; mode `0600` per the cache layer's existing
+ * security contract.
+ *
+ * **Refresh on miss.** A `--set tags=foo` call against a cache that
+ * doesn't list `foo` re-fetches the account directory, upserts, and
+ * re-checks before surfacing `tag_not_found`. Mirrors the
+ * `userByEmail` cache-then-live-refresh-then-error sequence verbatim.
+ */
+import { z } from 'zod';
+import { readEntry, resolveCacheRoot, writeEntry, DEFAULT_CACHE_TTL_SECONDS, } from './cache.js';
+import { ApiError } from '../utils/errors.js';
+const DECIMAL_TAG_ID_PATTERN = /^\d+$/u;
+const accountTagSchema = z
+    .object({
+    id: z.string().regex(DECIMAL_TAG_ID_PATTERN, {
+        message: 'tag id must be a decimal non-negative integer string',
+    }),
+    name: z.string(),
+})
+    .strict();
+const accountTagsSchema = z.array(accountTagSchema);
+const ACCOUNT_TAGS_QUERY = `
+  query AccountTags {
+    account {
+      tags {
+        id
+        name
+      }
+    }
+  }
+`;
+const readDirectoryCache = async (env) => {
+    const root = resolveCacheRoot({ env });
+    try {
+        const hit = await readEntry(root, { kind: 'accountTags' }, (raw) => accountTagsSchema.parse(raw), { ttlSeconds: DEFAULT_CACHE_TTL_SECONDS });
+        if (hit === undefined)
+            return undefined;
+        return { entries: hit.data, ageSeconds: hit.ageSeconds };
+    }
+    catch {
+        // A corrupt or unreadable cache file is non-fatal — the caller
+        // will fall through to a live fetch. Same shape `userByEmail`
+        // uses (`resolvers.ts:264–266`).
+        return undefined;
+    }
+};
+const writeDirectoryCache = async (env, entries) => {
+    const root = resolveCacheRoot({ env });
+    try {
+        await writeEntry(root, { kind: 'accountTags' }, entries);
+    }
+    catch {
+        // Best-effort — cache write failures don't block the lookup
+        // (mirrors `userByEmail`'s `writeDirectoryCache` policy).
+    }
+};
+/**
+ * Loads the full per-account tag directory. Used by `monday account
+ * tags` (the read verb that resolves the §6.5 `tag_not_found.details
+ * .hint` forward-reference) and by `resolveTags`'s refresh-on-miss
+ * path. Cache-then-live: prefers a fresh on-disk entry; falls
+ * through to a live `account.tags` query on miss / expiry /
+ * `noCache`. Cache writes are best-effort (disk full / permission
+ * flips don't block the lookup).
+ */
+export const loadAccountTags = async (inputs) => {
+    /* c8 ignore next — defensive fallback; tests always pass `env`. */
+    const env = inputs.env ?? process.env;
+    const noCache = inputs.noCache ?? false;
+    if (!noCache) {
+        const cached = await readDirectoryCache(env);
+        if (cached !== undefined) {
+            return {
+                tags: cached.entries,
+                source: 'cache',
+                cacheAgeSeconds: cached.ageSeconds,
+                complexity: null,
+            };
+        }
+    }
+    const response = await inputs.client.raw(ACCOUNT_TAGS_QUERY, undefined, { operationName: 'AccountTags' });
+    // Codex post-Commit-5 P1-1 fix: `account === null` is NOT a
+    // successful empty directory — it indicates auth/scope/account-
+    // shape problems (guest token, disabled account, schema drift).
+    // Collapsing it to `[]` would hide the real issue and let later
+    // tag writes fail as `tag_not_found` instead of surfacing the
+    // account-level problem. Surface as `not_found` matching
+    // `account info`'s shape.
+    if (response.data.account === null) {
+        throw new ApiError('not_found', 'Monday returned no account for the supplied token (guest, ' +
+            'disabled, or restricted-scope token?). The per-account tag ' +
+            'directory cannot be loaded without an account.', {
+            details: {
+                hint: 'verify the token is for an active account user — try ' +
+                    '`monday account whoami` to see the resolved identity.',
+            },
+        });
+    }
+    const tagsRaw = response.data.account.tags ?? [];
+    // Parse-then-wrap (R17 / `validation.md` "Never bubble raw ZodError
+    // out of a parse boundary"). Malformed Monday responses surface as
+    // typed `internal_error` with `details.issues` rather than a bare
+    // ZodError that the runner's catch-all maps to `internal_error` but
+    // loses the failing field path.
+    const parsed = accountTagsSchema.safeParse(tagsRaw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((i) => ({
+            path: i.path.join('.'),
+            message: i.message,
+            code: i.code,
+        }));
+        throw new ApiError('internal_error', `Monday returned a malformed account.tags response — the directory ` +
+            `schema rejected the payload at ${issues.length.toString()} ` +
+            `issue${issues.length === 1 ? '' : 's'}.`, {
+            cause: parsed.error,
+            details: {
+                issues,
+                hint: "this is a data-integrity error in Monday's response (or an " +
+                    "accountTagsSchema drift); verify the response shape and " +
+                    "update accountTagsSchema if Monday's contract has changed.",
+            },
+        });
+    }
+    const fresh = parsed.data;
+    if (!noCache) {
+        await writeDirectoryCache(env, fresh);
+    }
+    return {
+        tags: fresh,
+        source: 'live',
+        cacheAgeSeconds: null,
+        complexity: response.complexity,
+    };
+};
+/**
+ * NFC + case-fold + whitespace-collapse normalisation for tag-name
+ * matching. Same rule as `cli-design.md` §5.3 step 2's column-token
+ * normalisation — agents learning one rule shouldn't have to learn a
+ * different one for tags vs columns vs status labels. A stray
+ * trailing space or a `Café` vs `Café` (NFD) variant resolves to the
+ * same tag.
+ */
+const normaliseFold = (s) => s.normalize('NFC').trim().replace(/\s+/gu, ' ').toLocaleLowerCase('und');
+const matchTags = (entries, inputs) => {
+    // Build a lookup table once per match pass. Multiple input tokens
+    // matching the same tag entry resolve to the same id (deduplication
+    // happens upstream in `resolveTags`).
+    const byNormalised = new Map();
+    for (const entry of entries) {
+        byNormalised.set(normaliseFold(entry.name), entry);
+    }
+    const ids = [];
+    const misses = [];
+    for (const input of inputs) {
+        const hit = byNormalised.get(normaliseFold(input));
+        if (hit === undefined) {
+            misses.push(input);
+            continue;
+        }
+        // Decimal regex on the schema gates the `Number()` conversion;
+        // safe-integer guard mirrors the people translator's defensive
+        // shape (`people.ts:300`).
+        const parsed = Number(hit.id);
+        /* c8 ignore next 7 — the schema's regex (`/^\d+$/u`) gates entries
+           at parse boundary; combined with Number.isSafeInteger this branch
+           only fires if Monday surfaces a >2^53 tag id, which exceeds the
+           documented cap. Defensive guard for noUncheckedIndexedAccess +
+           future-proofing. */
+        if (!Number.isSafeInteger(parsed)) {
+            throw new ApiError('internal_error', `Monday returned a tag id "${hit.id}" that exceeds the JavaScript ` +
+                `safe-integer range (2^53 - 1). Number(id) would lose precision, ` +
+                `corrupting the wire payload.`, {
+                details: {
+                    tag_name: hit.name,
+                    tag_id: hit.id,
+                    hint: 'this is a data-integrity error in the account-tag ' +
+                        'directory; report it at the monday-cli issues tracker.',
+                },
+            });
+        }
+        ids.push(parsed);
+    }
+    return { ids, misses };
+};
+const dedupePreserveOrder = (tokens) => {
+    const seen = new Set();
+    const out = [];
+    for (const token of tokens) {
+        const key = normaliseFold(token);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(token);
+    }
+    return out;
+};
+/**
+ * Resolves a comma-split tag-name list against the per-account
+ * directory. Returns numeric tag IDs for the matched names and
+ * carries the misses through so the caller can construct a
+ * `tag_not_found` error envelope with `details.tags: misses[]` per
+ * cli-design §6.5 (`4c652d5`).
+ *
+ * **Three-step lookup** mirroring `userByEmail`:
+ *
+ *   1. Read the on-disk cache (skipped on `noCache`). Match input
+ *      tokens against cached entries with NFC + case-fold +
+ *      whitespace-collapse.
+ *   2. If any input token misses against the cached set, refresh
+ *      the directory once via a live `account.tags` query (also
+ *      skipped on `noCache` — the live leg always runs but the
+ *      result isn't cached).
+ *   3. Match input tokens against the freshly-loaded set. Any
+ *      residual miss is surfaced as `tag_not_found` (caller's
+ *      responsibility — this function returns the misses array
+ *      and the caller decides whether to throw).
+ *
+ * **Empty input handled by the caller** — this function does not
+ * reject an empty input list; `column-values.ts`'s `tags` translator
+ * is the boundary that surfaces `usage_error` for `--set tags=""`
+ * (mirroring the dropdown / people empty-input contract).
+ */
+export const resolveTags = async (inputs) => {
+    /* c8 ignore next — defensive fallback; tests always pass `env`. */
+    const env = inputs.env ?? process.env;
+    const noCache = inputs.noCache ?? false;
+    const tokens = inputs.input
+        .split(',')
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0);
+    const dedup = dedupePreserveOrder(tokens);
+    // Empty after split+trim+filter+dedup: caller boundary handles. The
+    // resolver returns an empty result so the translator can decide
+    // (the friendly translator throws usage_error before reaching this
+    // function, but this contract stays defensive).
+    if (dedup.length === 0) {
+        return { ids: [], misses: [], source: 'cache', cacheAgeSeconds: null };
+    }
+    let cacheHitAge = null;
+    let cacheMatched;
+    if (!noCache) {
+        const cached = await readDirectoryCache(env);
+        if (cached !== undefined) {
+            cacheHitAge = cached.ageSeconds;
+            cacheMatched = matchTags(cached.entries, dedup);
+            if (cacheMatched.misses.length === 0) {
+                return {
+                    ids: cacheMatched.ids,
+                    misses: [],
+                    source: 'cache',
+                    cacheAgeSeconds: cached.ageSeconds,
+                };
+            }
+        }
+    }
+    // Refresh-on-miss: bypass cache and hit live directly, then upsert
+    // the fresh entries into the cache. Same shape as `userByEmail`'s
+    // `users(emails:)` fallback — the cache may be stale (Monday's UI
+    // created a new tag between cache write and this call), so going
+    // through `loadAccountTags` would just re-read the same stale
+    // cache. The `noCache: true` override forces the live leg.
+    const live = await loadAccountTags({
+        client: inputs.client,
+        env,
+        noCache: true,
+    });
+    // Upsert the freshly-loaded directory into the cache so the next
+    // call benefits from the refresh (skipped on `noCache: true` —
+    // the agent explicitly disabled cache writes).
+    if (!noCache) {
+        await writeDirectoryCache(env, live.tags);
+    }
+    const liveMatched = matchTags(live.tags, dedup);
+    // Determine source discriminant. If the cache leg matched some but
+    // not all, the result mixes cache + live (we re-matched the entire
+    // input against live, so technically the final ids come from live —
+    // but we still touched cache, so `mixed` is the honest signal).
+    // If the cache leg matched nothing OR was skipped, this is a pure
+    // `live` resolution.
+    const source = cacheMatched !== undefined && cacheMatched.ids.length > 0 ? 'mixed' : 'live';
+    return {
+        ids: liveMatched.ids,
+        misses: liveMatched.misses,
+        source,
+        // For `'mixed'`, surface the cache leg's age as the worst-case
+        // staleness the agent observed — matches the broader §6.1
+        // mixed-source/cache-age contract (`mergeCacheAge` keeps the
+        // oldest age across legs that hit cache). For `'live'` (no
+        // cache leg fired), null.
+        cacheAgeSeconds: source === 'mixed' ? cacheHitAge : null,
+    };
+};
+//# sourceMappingURL=tag-directory.js.map

package/dist/api/tag-directory.js.map

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

package/dist/api/time-tracking.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Time-tracking start/stop verb primitives for the v0.3-M20
+ * `monday item time-track start / stop` surface (cli-design §5.2
+ * carve-out 2 — verb-shaped column-type extensions surface as
+ * `<noun> <subnoun> <verb>`).
+ *
+ * **Documentation-only verbs at v0.3.** An empirical probe against a
+ * real Monday workspace on 2026-05-10 against API version `2026-01`
+ * confirmed that Monday's public GraphQL API exposes **no mutation
+ * for writing to `time_tracking` columns**:
+ *
+ *   - `change_simple_column_value` rejects every candidate value
+ *     (`"true"`, `"false"`, `"start"`, `"stop"`) with
+ *     `CorrectedValueException`. Verbatim Monday response: *"column
+ *     type DurationColumn is not supporting changing the column
+ *     value with simple column value, please check our API
+ *     documentation for the correct data structure for this
+ *     column."* — paraphrased elsewhere for brevity.
+ *   - `change_column_value` rejects every candidate JSON shape
+ *     (`{running:true}`, `{running:false}`, `{started_at}`,
+ *     `{ended_at}`, `{}`) with `InvalidColumnTypeException`.
+ *     Verbatim Monday response: *"This column type is not supported
+ *     yet in the API"* (`actual_type: "DurationColumn"`).
+ *   - Full mutation-root introspection (152 mutations) found zero
+ *     time-tracking-related mutations matching
+ *     `/time|track|session|duration|start|stop|play|pause|timer/i`.
+ *
+ * The pre-flight contract assumed `change_simple_column_value` would
+ * route through; that assumption was empirically wrong. M20 ships the
+ * verbs **as documentation-only** so the CLI surface is stable when
+ * Monday eventually exposes the underlying mutation: agents can
+ * grep for `monday item time-track start` and see a registered verb
+ * that today rejects with a clear `usage_error` and a hint pointing
+ * at Monday's UI as the only write path.
+ *
+ * **Two surfaces.**
+ *
+ *   - `startTimeTracking({client, boardId, itemId, columnId, env?})`
+ *     — when Monday's API supports it, will flip the column from
+ *     stopped → running. Today, rejects with `usage_error` per the
+ *     `API_UNSUPPORTED_HINT` constant below.
+ *   - `stopTimeTracking({client, boardId, itemId, columnId, env?})`
+ *     — when Monday's API supports it, will flip the column from
+ *     running → stopped. Today, rejects with the same `usage_error`.
+ *
+ * The four exported `*Inputs` / `*Result` interfaces are kept verbatim
+ * from the pre-flight (`a702af2`) so when Monday ships the mutation,
+ * the api-layer change is small: replace the rejection bodies with
+ * the actual wire call against the pinned input shape. The
+ * `commands/item/time-track/{start,stop}.ts` command files will need
+ * follow-up wiring at the same time — column resolution against board
+ * metadata, `--dry-run` branching to emit `planned_changes`, and an
+ * `emitMutation` call against the primitive's success result.
+ *
+ * **Decisions 4.1 / 4.2 / 4.3 (v0.3-plan §3 M20)** stay closed but
+ * unenforceable today — the verb rejects before any state-machine
+ * branch is reachable. They describe the future behavior:
+ *
+ *   - **4.1 — `start` against a running column:** future
+ *     `usage_error` with `details.running: true` (state-discriminant);
+ *     hint will point at the stop verb.
+ *   - **4.2 — `stop` against a non-running column:** future
+ *     symmetric `usage_error` with `details.running: false`.
+ *   - **4.3 — Idempotency:** future verbs will be non-idempotent
+ *     (start opens a new session each time; stop closes the open one
+ *     — both throw on invalid pre-state).
+ *
+ * Today, every invocation throws the same `usage_error` regardless
+ * of pre-state, so the discriminants don't surface yet.
+ *
+ * **No cache surface, no board-invalidation fan-out.**
+ * `time_tracking` columns don't cache and don't affect board
+ * structure; the `env` slot in the inputs is preserved for parity
+ * with sibling primitives (test-isolation), not for cache-key
+ * resolution.
+ */
+import type { MondayClient } from './client.js';
+import type { BoardId, ItemId } from '../types/ids.js';
+/**
+ * Inputs to the `startTimeTracking` primitive. Pinned at pre-flight
+ * (`a702af2`); kept unchanged so M20-implementation's documentation-
+ * only rejection becomes a one-sided swap to a real wire call when
+ * Monday ships API support.
+ *
+ * `client` + `env` are unused today — the rejection is constructed
+ * synchronously in the body — but the contract retains them so
+ * future implementation has a stable signature.
+ */
+export interface StartTimeTrackingInputs {
+    readonly client: MondayClient;
+    readonly boardId: BoardId;
+    readonly itemId: ItemId;
+    readonly columnId: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+/**
+ * Inputs to the `stopTimeTracking` primitive. Same shape as
+ * `StartTimeTrackingInputs` — the verb pair will route through the
+ * same `(board_id, item_id, column_id)` triple at the wire layer
+ * once Monday exposes the mutation.
+ */
+export interface StopTimeTrackingInputs {
+    readonly client: MondayClient;
+    readonly boardId: BoardId;
+    readonly itemId: ItemId;
+    readonly columnId: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+/**
+ * Result of a `startTimeTracking` call once Monday's API supports
+ * time-tracking writes. **Aspirational at v0.3** — the verb rejects
+ * today, so this shape never materialises on the wire. Pinned so
+ * agents grepping the type surface see the documented future shape.
+ *
+ * `running: true` is a literal — verb-success implies the column
+ * state flipped to running. `startedAt` carries Monday's
+ * authoritative session-start timestamp.
+ */
+export interface StartTimeTrackingResult {
+    readonly itemId: string;
+    readonly columnId: string;
+    readonly running: true;
+    readonly startedAt: string;
+}
+/**
+ * Result of a `stopTimeTracking` call once Monday's API supports
+ * time-tracking writes. **Aspirational at v0.3** — see
+ * `StartTimeTrackingResult`.
+ *
+ * `startedAt` mirrors `TimeTrackingHistoryItem.started_at` (`null`
+ * when Monday omits it on the just-closed session record);
+ * `endedAt` is the stop wall-clock; `durationSeconds` is the
+ * just-stopped session's duration in seconds, **`null` when
+ * `startedAt` is `null`** — SDK 14.0.0 exposes no per-history
+ * duration field, so without a `startedAt` the per-session duration
+ * is uncomputable.
+ */
+export interface StopTimeTrackingResult {
+    readonly itemId: string;
+    readonly columnId: string;
+    readonly running: false;
+    readonly startedAt: string | null;
+    readonly endedAt: string;
+    readonly durationSeconds: number | null;
+}
+/**
+ * Documentation-only `start` verb. Rejects with `usage_error` on
+ * every invocation; the inputs are echoed in `details` so agents
+ * inspecting the envelope can confirm the call site they intended.
+ *
+ * When Monday ships the underlying mutation, replace the body with
+ * the wire call (likely `change_simple_column_value` once Monday
+ * extends DurationColumn's accepted-value enum, or a new dedicated
+ * `start_time_tracking` mutation if Monday exposes one).
+ */
+export declare const startTimeTracking: (inputs: StartTimeTrackingInputs) => Promise<StartTimeTrackingResult>;
+/**
+ * Documentation-only `stop` verb. Mirrors `startTimeTracking`'s
+ * rejection shape; differs only in the verb name in the
+ * envelope's `error.message` (so agents grepping the envelope
+ * for "time-track stop" vs "time-track start" can disambiguate
+ * the call site they invoked).
+ */
+export declare const stopTimeTracking: (inputs: StopTimeTrackingInputs) => Promise<StopTimeTrackingResult>;
+//# sourceMappingURL=time-tracking.d.ts.map

package/dist/api/time-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.d.ts","sourceRoot":"","sources":["../../src/api/time-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAwBD;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,uBAAuB,CAgB/B,CAAC;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,sBAAsB,KAC7B,OAAO,CAAC,sBAAsB,CAgB9B,CAAC"}

package/dist/api/time-tracking.js

@@ -0,0 +1,135 @@
+/**
+ * Time-tracking start/stop verb primitives for the v0.3-M20
+ * `monday item time-track start / stop` surface (cli-design §5.2
+ * carve-out 2 — verb-shaped column-type extensions surface as
+ * `<noun> <subnoun> <verb>`).
+ *
+ * **Documentation-only verbs at v0.3.** An empirical probe against a
+ * real Monday workspace on 2026-05-10 against API version `2026-01`
+ * confirmed that Monday's public GraphQL API exposes **no mutation
+ * for writing to `time_tracking` columns**:
+ *
+ *   - `change_simple_column_value` rejects every candidate value
+ *     (`"true"`, `"false"`, `"start"`, `"stop"`) with
+ *     `CorrectedValueException`. Verbatim Monday response: *"column
+ *     type DurationColumn is not supporting changing the column
+ *     value with simple column value, please check our API
+ *     documentation for the correct data structure for this
+ *     column."* — paraphrased elsewhere for brevity.
+ *   - `change_column_value` rejects every candidate JSON shape
+ *     (`{running:true}`, `{running:false}`, `{started_at}`,
+ *     `{ended_at}`, `{}`) with `InvalidColumnTypeException`.
+ *     Verbatim Monday response: *"This column type is not supported
+ *     yet in the API"* (`actual_type: "DurationColumn"`).
+ *   - Full mutation-root introspection (152 mutations) found zero
+ *     time-tracking-related mutations matching
+ *     `/time|track|session|duration|start|stop|play|pause|timer/i`.
+ *
+ * The pre-flight contract assumed `change_simple_column_value` would
+ * route through; that assumption was empirically wrong. M20 ships the
+ * verbs **as documentation-only** so the CLI surface is stable when
+ * Monday eventually exposes the underlying mutation: agents can
+ * grep for `monday item time-track start` and see a registered verb
+ * that today rejects with a clear `usage_error` and a hint pointing
+ * at Monday's UI as the only write path.
+ *
+ * **Two surfaces.**
+ *
+ *   - `startTimeTracking({client, boardId, itemId, columnId, env?})`
+ *     — when Monday's API supports it, will flip the column from
+ *     stopped → running. Today, rejects with `usage_error` per the
+ *     `API_UNSUPPORTED_HINT` constant below.
+ *   - `stopTimeTracking({client, boardId, itemId, columnId, env?})`
+ *     — when Monday's API supports it, will flip the column from
+ *     running → stopped. Today, rejects with the same `usage_error`.
+ *
+ * The four exported `*Inputs` / `*Result` interfaces are kept verbatim
+ * from the pre-flight (`a702af2`) so when Monday ships the mutation,
+ * the api-layer change is small: replace the rejection bodies with
+ * the actual wire call against the pinned input shape. The
+ * `commands/item/time-track/{start,stop}.ts` command files will need
+ * follow-up wiring at the same time — column resolution against board
+ * metadata, `--dry-run` branching to emit `planned_changes`, and an
+ * `emitMutation` call against the primitive's success result.
+ *
+ * **Decisions 4.1 / 4.2 / 4.3 (v0.3-plan §3 M20)** stay closed but
+ * unenforceable today — the verb rejects before any state-machine
+ * branch is reachable. They describe the future behavior:
+ *
+ *   - **4.1 — `start` against a running column:** future
+ *     `usage_error` with `details.running: true` (state-discriminant);
+ *     hint will point at the stop verb.
+ *   - **4.2 — `stop` against a non-running column:** future
+ *     symmetric `usage_error` with `details.running: false`.
+ *   - **4.3 — Idempotency:** future verbs will be non-idempotent
+ *     (start opens a new session each time; stop closes the open one
+ *     — both throw on invalid pre-state).
+ *
+ * Today, every invocation throws the same `usage_error` regardless
+ * of pre-state, so the discriminants don't surface yet.
+ *
+ * **No cache surface, no board-invalidation fan-out.**
+ * `time_tracking` columns don't cache and don't affect board
+ * structure; the `env` slot in the inputs is preserved for parity
+ * with sibling primitives (test-isolation), not for cache-key
+ * resolution.
+ */
+import { ApiError } from '../utils/errors.js';
+/**
+ * Hint string shipped on every documentation-only rejection. Names
+ * the empirical probe (date + API version + the exact error codes
+ * Monday returned for each candidate wire shape) so an agent reading
+ * the envelope's `details.hint` can self-verify the limitation
+ * without re-running the probe themselves.
+ */
+const API_UNSUPPORTED_HINT = "Monday's public GraphQL API does not currently expose a " +
+    'mutation for writing to time_tracking columns. Empirical probe ' +
+    '(2026-05-10, API version 2026-01): change_simple_column_value ' +
+    "rejects every candidate value with CorrectedValueException " +
+    '("DurationColumn does not support simple column value writes"); ' +
+    'change_column_value rejects every candidate JSON shape with ' +
+    'InvalidColumnTypeException ("This column type is not supported ' +
+    'yet in the API"); the mutation root has no time-tracking-' +
+    'related mutation. Use Monday\'s UI to start/stop time-tracking ' +
+    'sessions until Monday ships API support — the verb is ' +
+    'registered for forward-compatibility so agent scripts targeting ' +
+    '`monday item time-track start/stop` are stable across the ' +
+    'eventual swap.';
+/**
+ * Documentation-only `start` verb. Rejects with `usage_error` on
+ * every invocation; the inputs are echoed in `details` so agents
+ * inspecting the envelope can confirm the call site they intended.
+ *
+ * When Monday ships the underlying mutation, replace the body with
+ * the wire call (likely `change_simple_column_value` once Monday
+ * extends DurationColumn's accepted-value enum, or a new dedicated
+ * `start_time_tracking` mutation if Monday exposes one).
+ */
+export const startTimeTracking = (inputs) => Promise.reject(new ApiError('usage_error', "`monday item time-track start` is registered for forward-" +
+    "compatibility but cannot fire today — Monday's public API " +
+    'does not currently support writing to time_tracking columns.', {
+    details: {
+        board_id: inputs.boardId,
+        item_id: inputs.itemId,
+        column_id: inputs.columnId,
+        hint: API_UNSUPPORTED_HINT,
+    },
+}));
+/**
+ * Documentation-only `stop` verb. Mirrors `startTimeTracking`'s
+ * rejection shape; differs only in the verb name in the
+ * envelope's `error.message` (so agents grepping the envelope
+ * for "time-track stop" vs "time-track start" can disambiguate
+ * the call site they invoked).
+ */
+export const stopTimeTracking = (inputs) => Promise.reject(new ApiError('usage_error', "`monday item time-track stop` is registered for forward-" +
+    "compatibility but cannot fire today — Monday's public API " +
+    'does not currently support writing to time_tracking columns.', {
+    details: {
+        board_id: inputs.boardId,
+        item_id: inputs.itemId,
+        column_id: inputs.columnId,
+        hint: API_UNSUPPORTED_HINT,
+    },
+}));
+//# sourceMappingURL=time-tracking.js.map

package/dist/api/time-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.js","sourceRoot":"","sources":["../../src/api/time-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAyE9C;;;;;;GAMG;AACH,MAAM,oBAAoB,GACxB,0DAA0D;IAC1D,iEAAiE;IACjE,gEAAgE;IAChE,6DAA6D;IAC7D,kEAAkE;IAClE,8DAA8D;IAC9D,iEAAiE;IACjE,2DAA2D;IAC3D,iEAAiE;IACjE,wDAAwD;IACxD,kEAAkE;IAClE,4DAA4D;IAC5D,gBAAgB,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAA+B,EACG,EAAE,CACpC,OAAO,CAAC,MAAM,CACZ,IAAI,QAAQ,CACV,aAAa,EACb,2DAA2D;IACzD,4DAA4D;IAC5D,8DAA8D,EAChE;IACE,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,IAAI,EAAE,oBAAoB;KAC3B;CACF,CACF,CACF,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAA8B,EACG,EAAE,CACnC,OAAO,CAAC,MAAM,CACZ,IAAI,QAAQ,CACV,aAAa,EACb,0DAA0D;IACxD,4DAA4D;IAC5D,8DAA8D,EAChE;IACE,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,IAAI,EAAE,oBAAoB;KAC3B;CACF,CACF,CACF,CAAC"}

package/dist/api/transport.js

@@ -1,4 +1,4 @@
-import { ApiError } from '../utils/errors.js';
+import { ApiError, errorCode } from '../utils/errors.js';
 /**
  * Builds a `Transport` over `fetch`. Owns:
  *  - `Authorization: <token>` (no `Bearer ` prefix per Monday's API).
@@ -119,8 +119,8 @@ const isAbortError = (err) => {
  */
 const describeFetchError = (err) => {
     if (err instanceof Error) {
-        const code = err.code;
-        if (typeof code === 'string') {
+        const code = errorCode(err);
+        if (code !== undefined) {
             if (code.startsWith('ENOTFOUND') || code.startsWith('EAI_')) {
                 return 'fetch failed: dns lookup failed';
             }