monday-cli 0.2.0

package/dist/api/resolver-error-fold.js

@@ -0,0 +1,230 @@
+/**
+ * Resolver-error-folding helpers (`v0.1-plan.md` §17 R19).
+ *
+ * Two-helper module that consolidates the resolver-warning preservation
+ * pattern + the cache-sourced `validation_failed` → `column_archived`
+ * remap pattern. Lifted in M5b session 2 (2026-04-30) before
+ * `item clear` / `item update` could copy them.
+ *
+ * **Why a shared module.** Both helpers were born inside
+ * `commands/item/set.ts` (M5b session 1, Codex pass-1 findings F2/F4),
+ * and the dry-run engine carried an inline shape of the resolver-
+ * warning fold for its own `column_archived` throw path. M5b's
+ * `item clear` / `item update` would each need the same two helpers
+ * verbatim — copying the ~80 LOC three more times would set the next
+ * Codex pass up to flag drift between copies. R7 / R8 timing rule:
+ * extract on the THIRD example, not the second; M5b session 2 lands
+ * the third (item update) and the fourth (item clear) in the same
+ * session, so the helper's shape absorbs both new examples in this
+ * commit.
+ *
+ * **Scope.** Two exports, both pure functions:
+ *   - `foldResolverWarningsIntoError` — folds resolver warnings into a
+ *     thrown `MondayCliError`'s `details.resolver_warnings` slot. Used
+ *     by every typed post-resolution failure across the M5b mutation
+ *     surfaces (translator `UsageError`s, `ApiError(unsupported_column_
+ *     type)` / `user_not_found`, mutation-time `validation_failed`,
+ *     `column_archived` from the dry-run engine).
+ *   - `maybeRemapValidationFailedToArchived` — async helper that
+ *     inspects a thrown `validation_failed` after a cache-sourced
+ *     resolution and, if a forced metadata refresh confirms the
+ *     column is archived, remaps the error to `column_archived` so
+ *     agents key off the stable code.
+ *
+ * **Why not inside `api/columns.ts`.** Already 533 lines and owns the
+ * read-side resolver. The fold helpers are write-side concerns
+ * (consumed by command actions + the dry-run engine, not by the
+ * resolver itself) and `columns.ts` shouldn't import from
+ * `board-metadata.ts`'s refresh path beyond what the resolver needs.
+ * A separate module also gives the helpers their own unit-test surface
+ * without dragging the resolver's full test fixture.
+ */
+import { ApiError, MondayCliError, UsageError } from '../utils/errors.js';
+import { refreshBoardMetadata } from './board-metadata.js';
+/**
+ * Folds resolver warnings (`column_token_collision` /
+ * `stale_cache_refreshed`) into a thrown error's
+ * `details.resolver_warnings` slot. Returns a NEW error of the same
+ * code with merged details; the original is discarded.
+ *
+ * **No-op fast path.** When `resolverWarnings` is empty, the original
+ * error passes through unchanged — no allocation, same identity.
+ *
+ * **Class preservation.** The fold reconstructs the error via the
+ * concrete typed-error constructor matching `err.code` so the new
+ * error stays the same class:
+ *   - `usage_error` → `UsageError`
+ *   - `config_error` / `cache_error` → `MondayCliError` base class
+ *     (no specific class for these in v0.1, though the contract
+ *     covers them so a future `ConfigError` / `CacheError` lift
+ *     would just need one more branch).
+ *   - everything else (the Monday-API surface) → `ApiError`.
+ *
+ * Pre-fix, `commands/item/set.ts` only handled `ApiError` — a
+ * `UsageError` translator failure (date / dropdown / people invalid
+ * input) would bypass the fold and lose the resolver context (Codex
+ * pass-1 finding F2). Lifted shape covers every `MondayCliError`
+ * subclass.
+ */
+export const foldResolverWarningsIntoError = (err, resolverWarnings) => {
+    if (resolverWarnings.length === 0)
+        return err;
+    const detailWarnings = resolverWarnings.map((w) => ({
+        code: w.code,
+        message: w.message,
+        details: w.details,
+    }));
+    const merged = mergeDetails(err, detailWarnings);
+    if (err.code === 'usage_error') {
+        return new UsageError(err.message, merged);
+    }
+    if (err.code === 'config_error' || err.code === 'cache_error') {
+        return new MondayCliError(err.code, err.message, merged);
+    }
+    return new ApiError(err.code, err.message, merged);
+};
+const mergeDetails = (err, detailWarnings) => ({
+    cause: err.cause,
+    ...(err.httpStatus === undefined ? {} : { httpStatus: err.httpStatus }),
+    ...(err.mondayCode === undefined ? {} : { mondayCode: err.mondayCode }),
+    ...(err.requestId === undefined ? {} : { requestId: err.requestId }),
+    retryable: err.retryable,
+    ...(err.retryAfterSeconds === undefined
+        ? {}
+        : { retryAfterSeconds: err.retryAfterSeconds }),
+    details: {
+        ...(err.details ?? {}),
+        resolver_warnings: detailWarnings,
+    },
+});
+/**
+ * Inspects a thrown `validation_failed` after a cache-sourced
+ * resolution and remaps it to `column_archived` if a forced-fresh
+ * metadata refresh confirms ANY of the translated columns is
+ * archived.
+ *
+ * Codex pass-1 finding F4: the archived-column guarantee was
+ * cache-stale in one direction — when cached metadata said active
+ * but Monday had since archived the column, the live mutation fired
+ * and surfaced as `validation_failed`, not the stable
+ * `column_archived` code agents key off (cli-design §6.5). This
+ * helper closes that gap.
+ *
+ * **Multi-column probe** (Codex M5b finding #3). Callers pass every
+ * translated real column ID; the helper scans them in input order
+ * and remaps to the first archived one. Single-column callers pass
+ * a one-element array. Multi-column updates pass every column they
+ * tried to write so a later-archived column is still caught.
+ *
+ * **Resolver warnings preserved.** When the caller has already
+ * folded resolver warnings (via `foldResolverWarningsIntoError`)
+ * into the original error's `details.resolver_warnings`, the
+ * remapped error inherits the slot via `details: { ...existing,
+ * ... }` so a stale-cache-then-archived flow doesn't drop the
+ * refresh signal.
+ *
+ * **Identity preservation.** Returns the original error unchanged
+ * when the code isn't `validation_failed`, when the resolution was
+ * live-sourced, when `columnIds` is empty, or when the post-refresh
+ * scan finds no archived target. The cache write that
+ * `refreshBoardMetadata` performs is a useful side-effect — agents
+ * retrying after the failure see the corrected metadata.
+ */
+export const maybeRemapValidationFailedToArchived = async (err, inputs) => {
+    if (err.code !== 'validation_failed')
+        return err;
+    if (inputs.resolutionSource === 'live')
+        return err;
+    if (inputs.columnIds.length === 0)
+        return err;
+    let refreshed;
+    try {
+        refreshed = await refreshBoardMetadata({
+            client: inputs.client,
+            boardId: inputs.boardId,
+            env: inputs.env,
+            noCache: inputs.noCache,
+        });
+    }
+    catch {
+        // Refresh failed — propagate the original validation_failed
+        // unchanged rather than masking with an unrelated refresh
+        // error. The agent's retry loop will hit the same path.
+        return err;
+    }
+    // Walk `columnIds` in input order; first archived match wins.
+    // Pre-fix this only checked `inputs.columnIds[0]` (then named
+    // `columnId`), missing later-archived columns in multi-column
+    // updates — Codex M5b finding #3.
+    let archived;
+    for (const columnId of inputs.columnIds) {
+        const live = refreshed.metadata.columns.find((c) => c.id === columnId);
+        if (live?.archived === true) {
+            archived = { id: columnId, title: live.title, type: live.type };
+            break;
+        }
+    }
+    if (archived === undefined)
+        return err;
+    // Confirmed archived. Build a column_archived error preserving
+    // the original error's resolver_warnings slot.
+    const existing = err.details ?? {};
+    return new ApiError('column_archived', `Column ${JSON.stringify(archived.id)} on board ` +
+        `${inputs.boardId} is archived (Monday rejected the mutation as ` +
+        `validation_failed; a forced metadata refresh confirmed the ` +
+        `archived state). Un-archive the column in Monday or pick a ` +
+        `different target.`, {
+        cause: err,
+        details: {
+            ...existing,
+            column_id: archived.id,
+            column_title: archived.title,
+            column_type: archived.type,
+            board_id: inputs.boardId,
+            remapped_from: 'validation_failed',
+            hint: 'cache-sourced resolution missed the archived flag; the CLI ' +
+                'forced a live refresh after the mutation failed and confirmed ' +
+                'the column is now archived. Resolver warnings (if any) carry ' +
+                'the pre-refresh state.',
+        },
+    });
+};
+/**
+ * The post-mutation catch-arm pattern lifted from five sites
+ * (`set.ts`, `clear.ts`, `update.ts` single + bulk, `create.ts`)
+ * — see v0.2-plan §12 R26.
+ *
+ * Each site did the same two steps in order:
+ *   1. Fold resolver warnings into the thrown error so a
+ *      stale-cache-then-failure flow keeps the refresh signal.
+ *   2. Probe the F4 cache-sourced-archived remap so a
+ *      `validation_failed` after stale-cache resolution surfaces
+ *      as `column_archived` (the stable code agents key off per
+ *      cli-design §6.5).
+ *
+ * Bulk's per-item-progress decoration stays a bulk-specific
+ * concern: callers do `foldAndRemap` first, then attach the
+ * `applied_count` / `applied_to` / `failed_at_item` /
+ * `matched_count` slot before re-throwing.
+ *
+ * The Codex M9 P1 finding (cache-stale archived columns surfacing
+ * as `validation_failed` from `item create`) was caused by the
+ * create path skipping this exact catch arm. Lifting reduces the
+ * surface where a future command can forget to wire it — M10's
+ * three new mutation commands inherit `foldAndRemap` rather than
+ * copy the pattern a 6th-7th-8th time.
+ */
+export const foldAndRemap = async (inputs) => {
+    const folded = foldResolverWarningsIntoError(inputs.err, inputs.warnings);
+    if (inputs.columnIds.length === 0)
+        return folded;
+    return maybeRemapValidationFailedToArchived(folded, {
+        client: inputs.client,
+        boardId: inputs.boardId,
+        columnIds: inputs.columnIds,
+        env: inputs.env,
+        noCache: inputs.noCache,
+        resolutionSource: inputs.resolutionSource,
+    });
+};
+//# sourceMappingURL=resolver-error-fold.js.map

package/dist/api/resolver-error-fold.js.map

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

package/dist/api/resolvers.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Name-resolution helpers (`v0.1-plan.md` §3 M3, `cli-design.md` §5.7).
+ *
+ * Two surfaces:
+ *
+ *   - `findOne(scope, name)` — single-source-of-truth for the
+ *     `find` verb. Returns the unique match; raises
+ *     `ambiguous_name` with `details.candidates` on a multi-match;
+ *     `not_found` on zero. `--first` opts into "lowest ID wins"
+ *     (rarely the right call for agents; humans use it). M3 wires
+ *     `monday board find`; M4 wires `monday item find`. The matching
+ *     logic is intentionally NFC-aware + case-fold to match §5.3's
+ *     column rules — agents learning one rule shouldn't have to
+ *     learn a different one for names.
+ *
+ *   - `userByEmail(client, email)` — directory lookup with a
+ *     `users(emails: [...])` fallback. M3 doesn't actually call
+ *     this from a command (read-only `user list/get/me` operate by
+ *     ID or whoami), but the function is needed by M5a's
+ *     `--set Owner=alice@example.com` value translator. Lives here
+ *     because email→ID resolution is the same lookup users make from
+ *     two different feature surfaces. The user-directory cache
+ *     (`api/cache.ts users` key) ships alongside.
+ *
+ * **NFC + case-fold for names.** Same rule as §5.3 step 2: NFC
+ * normalise, trim, collapse internal whitespace, case-fold (Unicode-
+ * aware, locale-independent). Keeps "Status" / "Status " /
+ * "STATUS" / "Café" / "Café" all matching the same target.
+ */
+import { z } from 'zod';
+import type { MondayClient } from './client.js';
+import { type UserId } from '../types/ids.js';
+export interface FindOneCandidate<T> {
+    readonly id: string;
+    readonly name: string;
+    readonly resource: T;
+}
+export interface FindOneOptions {
+    /**
+     * On multiple matches, return the candidate with the lexicographically
+     * lowest ID (numeric IDs string-compare correctly because both sides
+     * are decimal strings of the same length when from the same kind).
+     * Default false — multi-match raises `ambiguous_name` with
+     * `details.candidates`.
+     */
+    readonly first?: boolean;
+    /**
+     * Display name for the resource kind in error messages
+     * (`"board"`, `"item"`, …). Default `"resource"`.
+     */
+    readonly kind?: string;
+}
+export interface FindOneResult<T> {
+    readonly resource: T;
+    /**
+     * `true` when `--first` selected one of multiple matches.
+     * Commands surface this as a `warnings: [{ code: 'first_of_many' }]`
+     * entry so the caller knows the resolution was non-unique.
+     */
+    readonly firstOfMany: boolean;
+    /**
+     * The full candidate set. Useful for the warning payload and for
+     * future debug output; not normally rendered.
+     */
+    readonly candidates: readonly FindOneCandidate<T>[];
+}
+/**
+ * Picks the single resource whose name matches `query`. Pure
+ * function — caller passes in the haystack (e.g. all visible
+ * boards) and the projector that extracts `{id, name}` from each.
+ *
+ * Three matching passes, exactly mirroring §5.3 step 2:
+ *   1. NFC-normalised exact name.
+ *   2. NFC + case-fold name.
+ * Step 1 wins over step 2; multiple matches in either pass raise
+ * `ambiguous_name` (unless `--first` is set).
+ */
+export declare const findOne: <T>(haystack: readonly T[], query: string, project: (t: T) => {
+    readonly id: string;
+    readonly name: string;
+}, options?: FindOneOptions) => FindOneResult<T>;
+/**
+ * User-directory entry shape. The `id` field is constrained to a
+ * decimal non-negative integer string (`0`, `42`, `1234567`) — not
+ * just any non-empty string — because callers (M5a's people
+ * translator, future commands) eventually convert it to a JS number
+ * for wire payloads. Loose `z.string().min(1)` would let `"0x2a"` /
+ * `"1e3"` / `"42 "` into the directory cache where they'd silently
+ * corrupt every later consumer's `Number(id)` conversion.
+ *
+ * The validating regex (`DECIMAL_USER_ID_PATTERN`, `src/types/
+ * ids.ts`) is also imported by `api/people.ts`'s `idStringToNumber`
+ * for a defence-in-depth check at the translator boundary — same
+ * rule, two layers (R16 consolidated the two prior verbatim copies
+ * onto a single source of truth).
+ */
+declare const userDirectoryEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    email: z.ZodString;
+}, z.core.$strict>;
+export type UserDirectoryEntry = z.infer<typeof userDirectoryEntrySchema>;
+export interface UserByEmailInputs {
+    readonly client: MondayClient;
+    readonly email: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly noCache?: boolean;
+}
+export interface UserByEmailResult {
+    readonly user: UserDirectoryEntry;
+    readonly source: 'cache' | 'live';
+    readonly cacheAgeSeconds: number | null;
+}
+/**
+ * Looks up a user by email. Prefers the local user-directory cache;
+ * on miss, calls `users(emails: [...])` and folds the result back
+ * into the cache. Unknown email → `user_not_found` with the
+ * unmatched email in `details`.
+ *
+ * Email matching is NFC + case-fold so `Alice@Example.COM` and
+ * `alice@example.com` resolve identically.
+ */
+export declare const userByEmail: (inputs: UserByEmailInputs) => Promise<UserByEmailResult>;
+/**
+ * Cast a `string` to a `UserId`. Used by callers that hold a
+ * directory-projected ID and need the branded form for downstream
+ * APIs. Validates via the same regex as the schema brand.
+ */
+export declare const userIdFromString: (id: string) => UserId;
+export {};
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/api/resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../src/api/resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAA2B,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AASvE,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;CACrD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,UAAU,SAAS,CAAC,EAAE,EACtB,OAAO,MAAM,EACb,SAAS,CAAC,CAAC,EAAE,CAAC,KAAK;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,UAAS,cAAmB,KAC3B,aAAa,CAAC,CAAC,CAwCjB,CAAC;AAqDF;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,wBAAwB;;;;kBAQnB,CAAC;AAIZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAgB1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAuDD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,iBAAiB,KACxB,OAAO,CAAC,iBAAiB,CAwE3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,MAAM,KAAG,MAQ7C,CAAC"}

package/dist/api/resolvers.js

@@ -0,0 +1,262 @@
+/**
+ * Name-resolution helpers (`v0.1-plan.md` §3 M3, `cli-design.md` §5.7).
+ *
+ * Two surfaces:
+ *
+ *   - `findOne(scope, name)` — single-source-of-truth for the
+ *     `find` verb. Returns the unique match; raises
+ *     `ambiguous_name` with `details.candidates` on a multi-match;
+ *     `not_found` on zero. `--first` opts into "lowest ID wins"
+ *     (rarely the right call for agents; humans use it). M3 wires
+ *     `monday board find`; M4 wires `monday item find`. The matching
+ *     logic is intentionally NFC-aware + case-fold to match §5.3's
+ *     column rules — agents learning one rule shouldn't have to
+ *     learn a different one for names.
+ *
+ *   - `userByEmail(client, email)` — directory lookup with a
+ *     `users(emails: [...])` fallback. M3 doesn't actually call
+ *     this from a command (read-only `user list/get/me` operate by
+ *     ID or whoami), but the function is needed by M5a's
+ *     `--set Owner=alice@example.com` value translator. Lives here
+ *     because email→ID resolution is the same lookup users make from
+ *     two different feature surfaces. The user-directory cache
+ *     (`api/cache.ts users` key) ships alongside.
+ *
+ * **NFC + case-fold for names.** Same rule as §5.3 step 2: NFC
+ * normalise, trim, collapse internal whitespace, case-fold (Unicode-
+ * aware, locale-independent). Keeps "Status" / "Status " /
+ * "STATUS" / "Café" / "Café" all matching the same target.
+ */
+import { z } from 'zod';
+import { ApiError, UsageError } from '../utils/errors.js';
+import { readEntry, resolveCacheRoot, writeEntry, DEFAULT_CACHE_TTL_SECONDS, } from './cache.js';
+import { DECIMAL_USER_ID_PATTERN } from '../types/ids.js';
+const normalise = (s) => s.normalize('NFC').trim().replace(/\s+/gu, ' ');
+const caseFold = (s) => s.toLocaleLowerCase('und');
+const normaliseFold = (s) => caseFold(normalise(s));
+/**
+ * Picks the single resource whose name matches `query`. Pure
+ * function — caller passes in the haystack (e.g. all visible
+ * boards) and the projector that extracts `{id, name}` from each.
+ *
+ * Three matching passes, exactly mirroring §5.3 step 2:
+ *   1. NFC-normalised exact name.
+ *   2. NFC + case-fold name.
+ * Step 1 wins over step 2; multiple matches in either pass raise
+ * `ambiguous_name` (unless `--first` is set).
+ */
+export const findOne = (haystack, query, project, options = {}) => {
+    const kind = options.kind ?? 'resource';
+    const target = normalise(query);
+    if (target.length === 0) {
+        throw new UsageError(`find ${kind}: query must be a non-empty name`);
+    }
+    const projected = haystack.map((t) => {
+        const p = project(t);
+        return { id: p.id, name: p.name, resource: t };
+    });
+    const exact = projected.filter((c) => normalise(c.name) === target);
+    if (exact.length === 1) {
+        const [only] = exact;
+        if (only !== undefined) {
+            return { resource: only.resource, firstOfMany: false, candidates: exact };
+        }
+    }
+    if (exact.length > 1) {
+        return resolveMulti(exact, query, kind, options.first ?? false);
+    }
+    const folded = caseFold(target);
+    const fuzzy = projected.filter((c) => caseFold(normalise(c.name)) === folded);
+    if (fuzzy.length === 1) {
+        const [only] = fuzzy;
+        if (only !== undefined) {
+            return { resource: only.resource, firstOfMany: false, candidates: fuzzy };
+        }
+    }
+    if (fuzzy.length > 1) {
+        return resolveMulti(fuzzy, query, kind, options.first ?? false);
+    }
+    throw new ApiError('not_found', `No ${kind} matches name ${JSON.stringify(query)}`, { details: { query, kind } });
+};
+const resolveMulti = (matches, query, kind, first) => {
+    if (first) {
+        // Lowest ID wins — string-compares fine for same-kind numeric
+        // IDs because both sides are decimal strings of equal length.
+        // Fall back to localeCompare on length-mismatched IDs so we
+        // pick a deterministic winner even when the assumption breaks.
+        const sorted = [...matches].sort((a, b) => a.id.length === b.id.length
+            ? a.id.localeCompare(b.id)
+            : a.id.length - b.id.length);
+        const [winner] = sorted;
+        /* c8 ignore next 8 — defensive: caller passes non-empty `matches`,
+           so `sorted[0]` is always defined. Guard exists for
+           `noUncheckedIndexedAccess` narrowing. */
+        if (winner === undefined) {
+            throw new ApiError('not_found', `No ${kind} matches name ${JSON.stringify(query)}`, { details: { query, kind } });
+        }
+        return {
+            resource: winner.resource,
+            firstOfMany: true,
+            candidates: matches,
+        };
+    }
+    throw new ApiError('ambiguous_name', `Name ${JSON.stringify(query)} matches ${String(matches.length)} ${kind}s; ` +
+        `pass --first to pick the lowest-ID match or call \`${kind} get <id>\`.`, {
+        details: {
+            query,
+            kind,
+            candidates: matches.map((c) => ({ id: c.id, name: c.name })),
+        },
+    });
+};
+// ---------------------------------------------------------------------
+// userByEmail — directory cache + users(emails:) fallback
+// ---------------------------------------------------------------------
+/**
+ * User-directory entry shape. The `id` field is constrained to a
+ * decimal non-negative integer string (`0`, `42`, `1234567`) — not
+ * just any non-empty string — because callers (M5a's people
+ * translator, future commands) eventually convert it to a JS number
+ * for wire payloads. Loose `z.string().min(1)` would let `"0x2a"` /
+ * `"1e3"` / `"42 "` into the directory cache where they'd silently
+ * corrupt every later consumer's `Number(id)` conversion.
+ *
+ * The validating regex (`DECIMAL_USER_ID_PATTERN`, `src/types/
+ * ids.ts`) is also imported by `api/people.ts`'s `idStringToNumber`
+ * for a defence-in-depth check at the translator boundary — same
+ * rule, two layers (R16 consolidated the two prior verbatim copies
+ * onto a single source of truth).
+ */
+const userDirectoryEntrySchema = z
+    .object({
+    id: z.string().regex(DECIMAL_USER_ID_PATTERN, {
+        message: 'user id must be a decimal non-negative integer string',
+    }),
+    name: z.string(),
+    email: z.string(),
+})
+    .strict();
+const userDirectorySchema = z.array(userDirectoryEntrySchema);
+const USERS_BY_EMAIL_QUERY = `
+  query UsersByEmail($emails: [String!]) {
+    users(emails: $emails, limit: 100) {
+      id
+      name
+      email
+    }
+  }
+`;
+const readDirectoryCache = async (env) => {
+    const root = resolveCacheRoot({ env });
+    try {
+        const hit = await readEntry(root, { kind: 'users' }, (raw) => userDirectorySchema.parse(raw), { ttlSeconds: DEFAULT_CACHE_TTL_SECONDS });
+        if (hit === undefined)
+            return undefined;
+        return { entries: hit.data, ageSeconds: hit.ageSeconds };
+    }
+    catch {
+        return undefined;
+    }
+};
+const writeDirectoryCache = async (env, entries) => {
+    const root = resolveCacheRoot({ env });
+    try {
+        await writeEntry(root, { kind: 'users' }, entries);
+    }
+    catch {
+        // Best-effort — cache write failures don't block the lookup.
+    }
+};
+const upsertCache = async (env, fresh) => {
+    const existing = await readDirectoryCache(env);
+    const byId = new Map();
+    for (const entry of existing?.entries ?? []) {
+        byId.set(entry.id, entry);
+    }
+    for (const entry of fresh) {
+        byId.set(entry.id, entry);
+    }
+    await writeDirectoryCache(env, [...byId.values()]);
+};
+const matchInCache = (entries, email) => {
+    const target = normaliseFold(email);
+    return entries.find((e) => normaliseFold(e.email) === target);
+};
+/**
+ * Looks up a user by email. Prefers the local user-directory cache;
+ * on miss, calls `users(emails: [...])` and folds the result back
+ * into the cache. Unknown email → `user_not_found` with the
+ * unmatched email in `details`.
+ *
+ * Email matching is NFC + case-fold so `Alice@Example.COM` and
+ * `alice@example.com` resolve identically.
+ */
+export const userByEmail = 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) {
+            const hit = matchInCache(cached.entries, inputs.email);
+            if (hit !== undefined) {
+                return { user: hit, source: 'cache', cacheAgeSeconds: cached.ageSeconds };
+            }
+        }
+    }
+    const response = await inputs.client.raw(USERS_BY_EMAIL_QUERY, { emails: [inputs.email] }, { operationName: 'UsersByEmail' });
+    const users = response.data.users ?? [];
+    // R17: parse-then-wrap. Per `validation.md`'s "Never bubble raw
+    // ZodError out of a parse boundary" rule, malformed Monday
+    // responses (e.g. a future tenant where `id` is a hex string)
+    // surface as a typed `internal_error` carrying `details.issues`
+    // rather than a bare ZodError. Pre-R17, the raw ZodError reached
+    // the runner's catch-all which DID map to `internal_error` (the
+    // right semantic code) but lost the issues array — agents
+    // debugging a malformed Monday response saw only the bare
+    // message. The newly-tightened `id` regex (R-people pass-2 F4)
+    // makes this surface more reachable: every malformed ID from
+    // Monday now hits this boundary instead of silently caching.
+    const parsed = userDirectorySchema.safeParse(users);
+    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 users response for email ` +
+            `${JSON.stringify(inputs.email)} — the directory schema rejected ` +
+            `the payload at ${issues.length} ` +
+            `issue${issues.length === 1 ? '' : 's'}.`, {
+            cause: parsed.error,
+            details: {
+                email: inputs.email,
+                issues,
+                hint: 'this is a data-integrity error in Monday\'s response (or a ' +
+                    'directory-schema drift); verify the response shape and update ' +
+                    'userDirectoryEntrySchema if Monday\'s contract has changed.',
+            },
+        });
+    }
+    const fresh = parsed.data;
+    if (!noCache && fresh.length > 0) {
+        await upsertCache(env, fresh);
+    }
+    const match = matchInCache(fresh, inputs.email);
+    if (match !== undefined) {
+        return { user: match, source: 'live', cacheAgeSeconds: null };
+    }
+    throw new ApiError('user_not_found', `No Monday user matches email ${JSON.stringify(inputs.email)}`, { details: { email: inputs.email } });
+};
+/**
+ * Cast a `string` to a `UserId`. Used by callers that hold a
+ * directory-projected ID and need the branded form for downstream
+ * APIs. Validates via the same regex as the schema brand.
+ */
+export const userIdFromString = (id) => {
+    if (!/^\d+$/u.test(id)) {
+        throw new ApiError('internal_error', `Monday returned a non-numeric user id: ${JSON.stringify(id)}`);
+    }
+    return id;
+};
+//# sourceMappingURL=resolvers.js.map

package/dist/api/resolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.js","sourceRoot":"","sources":["../../src/api/resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAe,MAAM,iBAAiB,CAAC;AAEvE,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE,CACtC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAElD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAEnE,MAAM,aAAa,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAuCpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,QAAsB,EACtB,KAAa,EACb,OAAiE,EACjE,UAA0B,EAAE,EACV,EAAE;IACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,QAAQ,IAAI,kCAAkC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,SAAS,GAAmC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,MAAM,IAAI,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAClD,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC7B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACnB,OAAuC,EACvC,KAAa,EACb,IAAY,EACZ,KAAc,EACI,EAAE;IACpB,IAAI,KAAK,EAAE,CAAC;QACV,8DAA8D;QAC9D,8DAA8D;QAC9D,4DAA4D;QAC5D,+DAA+D;QAC/D,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM;YACzB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAC9B,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;QACxB;;mDAE2C;QAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,QAAQ,CAChB,WAAW,EACX,MAAM,IAAI,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAClD,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC7B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,OAAO;SACpB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK;QAC1E,sDAAsD,IAAI,cAAc,EAC1E;QACE,OAAO,EAAE;YACP,KAAK;YACL,IAAI;YACJ,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SAC7D;KACF,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,wEAAwE;AACxE,0DAA0D;AAC1D,wEAAwE;AAExE;;;;;;;;;;;;;;GAcG;AACH,MAAM,wBAAwB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAuB,EAAE;QAC5C,OAAO,EAAE,uDAAuD;KACjE,CAAC;IACF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAI9D,MAAM,oBAAoB,GAAG;;;;;;;;CAQ5B,CAAC;AAmBF,MAAM,kBAAkB,GAAG,KAAK,EAC9B,GAAsB,EACiF,EAAE;IACzG,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,IAAI,EACJ,EAAE,IAAI,EAAE,OAAO,EAAE,EACjB,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,EACvC,EAAE,UAAU,EAAE,yBAAyB,EAAE,CAC1C,CAAC;QACF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,KAAK,EAC/B,GAAsB,EACtB,OAAsC,EACvB,EAAE;IACjB,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,KAAK,EACvB,GAAsB,EACtB,KAAoC,EACrB,EAAE;IACjB,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA8B,CAAC;IACnD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,mBAAmB,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACnB,OAAsC,EACtC,KAAa,EACmB,EAAE;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,MAAyB,EACG,EAAE;IAC9B,mEAAmE;IACnE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CACtC,oBAAoB,EACpB,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC1B,EAAE,aAAa,EAAE,cAAc,EAAE,CAClC,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACxC,gEAAgE;IAChE,2DAA2D;IAC3D,8DAA8D;IAC9D,gEAAgE;IAChE,iEAAiE;IACjE,gEAAgE;IAChE,0DAA0D;IAC1D,0DAA0D;IAC1D,+DAA+D;IAC/D,6DAA6D;IAC7D,6DAA6D;IAC7D,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,uDAAuD;YACrD,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC;YAClE,kBAAkB,MAAM,CAAC,MAAM,GAAG;YAClC,QAAQ,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAC3C;YACE,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE;gBACP,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM;gBACN,IAAI,EACF,6DAA6D;oBAC7D,gEAAgE;oBAChE,6DAA6D;aAChE;SACF,CACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,gCAAgC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9D,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CACrC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAU,EAAE;IACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,gBAAgB,EAChB,0CAA0C,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,EAAY,CAAC;AACtB,CAAC,CAAC"}