monday-cli 0.2.0

package/dist/api/cache.js

@@ -0,0 +1,418 @@
+import { constants as fsConstants } from 'node:fs';
+import { chmod, mkdir, open, readdir, rename, rm, stat, unlink, writeFile, } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { CacheError } from '../utils/errors.js';
+/**
+ * Local cache for board metadata, the user directory, and the
+ * schema-version pin (`cli-design.md` §8). M3+ reads/writes; M1 ships
+ * the primitives so the `cache list/clear/stats` commands can reason
+ * over the on-disk state.
+ *
+ * Invariants:
+ *  - Files live under `$XDG_CACHE_HOME/monday-cli/` (or
+ *    `~/.cache/monday-cli/` if XDG isn't set), per §8.
+ *  - File mode is `0600`. Writes set it explicitly; reads `fstat` and
+ *    refuse anything group/world-readable.
+ *  - Writes are atomic via `tmp + rename`. A crash mid-write leaves the
+ *    previous version in place — never a half-written JSON file.
+ *  - Per-profile namespacing is deferred to v0.3+. v0.1 is single-
+ *    profile so the layout stays flat.
+ *
+ * The CLI never writes secrets here; redaction lives elsewhere. The
+ * mode rule is belt-and-braces — if a future regression slipped a
+ * sensitive field in, the file's still `0600`.
+ */
+const CACHE_DIR_NAME = 'monday-cli';
+const FILE_MODE = 0o600;
+const FILE_MODE_MASK = 0o077;
+const DEFAULT_TTL_SECONDS = 300;
+const CACHE_SCHEMA_VERSION = '1';
+export const CACHE_FILE_MODE = FILE_MODE;
+export const DEFAULT_CACHE_TTL_SECONDS = DEFAULT_TTL_SECONDS;
+/**
+ * Resolves the cache root per `cli-design.md` §8 and the XDG Base
+ * Directory spec. Order:
+ *  1. `$XDG_CACHE_HOME/monday-cli` when set and non-empty.
+ *  2. `<home>/.cache/monday-cli` otherwise.
+ *
+ * The return is always absolute. We don't create the directory here —
+ * `writeEntry` does that lazily so a read-only path (`cache list` on a
+ * fresh install) doesn't side-effect.
+ */
+export const resolveCacheRoot = (options = {}) => {
+    const env = options.env ?? process.env;
+    const home = options.home ?? homedir();
+    const xdg = env.XDG_CACHE_HOME;
+    const base = xdg !== undefined && xdg.length > 0 ? xdg : join(home, '.cache');
+    return resolve(base, CACHE_DIR_NAME);
+};
+/**
+ * Maps a typed cache key to its on-disk relative path. Centralised so
+ * every consumer (read/write/clear, plus the M1 commands) agrees on
+ * the layout.
+ */
+export const cacheKeyToRelativePath = (key) => {
+    switch (key.kind) {
+        case 'board':
+            assertSafeIdentifier(key.boardId, 'board id');
+            return join('boards', `${key.boardId}.json`);
+        case 'users':
+            return join('users', 'index.json');
+        case 'schemaVersion':
+            return join('schema', 'version.json');
+    }
+};
+const SAFE_IDENTIFIER = /^[A-Za-z0-9._-]+$/u;
+const assertSafeIdentifier = (value, label) => {
+    if (!SAFE_IDENTIFIER.test(value)) {
+        throw new CacheError(`invalid ${label}: ${JSON.stringify(value)}`, {
+            details: { hint: 'cache key segments must match [A-Za-z0-9._-]' },
+        });
+    }
+    // The character class accepts `.` and `..` literally — both are
+    // path-traversal sentinels on every common filesystem, and a
+    // future caller using `.` / `..` as a cache key would happily
+    // resolve to a parent directory. Defence in depth (Codex review
+    // suggestion): reject the bare-dots forms even though current
+    // M1 callers (board ids via `BoardIdSchema`) can't reach this.
+    if (value === '.' || value === '..') {
+        throw new CacheError(`invalid ${label}: cache key segments may not be "." or "..", got ${JSON.stringify(value)}`, { details: { hint: 'use a non-sentinel identifier' } });
+    }
+};
+const wrapFsError = (err, message, details = {}) => {
+    const cause = err instanceof Error ? err : new Error(String(err));
+    return new CacheError(message, { cause, details });
+};
+const isENOENT = (err) => {
+    if (typeof err !== 'object' || err === null) {
+        return false;
+    }
+    return err.code === 'ENOENT';
+};
+const ensureSecureDir = async (path) => {
+    // mkdir respects umask, so the explicit `mode` is advisory on some
+    // platforms. Re-apply via chmod so a tightened-after-creation
+    // directory doesn't betray cache contents to another user.
+    try {
+        await mkdir(path, { recursive: true, mode: 0o700 });
+        await chmod(path, 0o700);
+    }
+    catch (err) {
+        throw wrapFsError(err, `cannot prepare cache directory ${path}`, {
+            path,
+        });
+    }
+};
+/**
+ * Reads and parses a cache entry. Returns `undefined` on cache miss
+ * (file not present or expired). Throws `CacheError` on any other
+ * failure (permission too loose, malformed JSON, decode mismatch).
+ */
+export const readEntry = async (root, key, parse, options = {}) => {
+    const ttlSeconds = options.ttlSeconds ?? DEFAULT_TTL_SECONDS;
+    const now = (options.now ?? (() => new Date()))();
+    const relativePath = cacheKeyToRelativePath(key);
+    const fullPath = join(root, relativePath);
+    let handle;
+    try {
+        handle = await open(fullPath, fsConstants.O_RDONLY);
+    }
+    catch (err) {
+        if (isENOENT(err)) {
+            return undefined;
+        }
+        throw wrapFsError(err, `cannot read cache entry ${relativePath}`, {
+            path: fullPath,
+        });
+    }
+    try {
+        const stats = await handle.stat();
+        if ((stats.mode & FILE_MODE_MASK) !== 0) {
+            throw new CacheError(`refusing to read cache entry with insecure permissions ${formatMode(stats.mode)}`, {
+                details: {
+                    path: fullPath,
+                    mode: formatMode(stats.mode),
+                    hint: 'expected mode 0600 — delete and re-fetch',
+                },
+            });
+        }
+        const ageSeconds = Math.max(0, Math.floor((now.getTime() - stats.mtimeMs) / 1000));
+        if (ageSeconds > ttlSeconds) {
+            return undefined;
+        }
+        const raw = await handle.readFile('utf8');
+        let envelope;
+        try {
+            envelope = JSON.parse(raw);
+        }
+        catch (err) {
+            throw wrapFsError(err, `malformed cache JSON at ${relativePath}`, {
+                path: fullPath,
+            });
+        }
+        if (envelope.schema_version !== CACHE_SCHEMA_VERSION) {
+            // Treat a different cache schema as a miss — stale on-disk state
+            // shouldn't break a fresh CLI version.
+            return undefined;
+        }
+        const parsed = parse(envelope.data);
+        return {
+            data: parsed,
+            ageSeconds,
+            path: fullPath,
+            sizeBytes: stats.size,
+        };
+    }
+    finally {
+        await handle.close();
+    }
+};
+/**
+ * Writes a cache entry atomically. Sequence:
+ *  1. Ensure the parent directory exists with mode `0700`.
+ *  2. Write to a tmp sibling with mode `0600`.
+ *  3. `rename` over the final path. Atomic on the same filesystem.
+ *
+ * On any failure the tmp file is best-effort cleaned up so a half-
+ * written `.tmp` doesn't accumulate on the next call.
+ */
+export const writeEntry = async (root, key, data) => {
+    const relativePath = cacheKeyToRelativePath(key);
+    const fullPath = join(root, relativePath);
+    const dir = dirname(fullPath);
+    await ensureSecureDir(root);
+    await ensureSecureDir(dir);
+    const envelope = {
+        schema_version: CACHE_SCHEMA_VERSION,
+        created_at: new Date().toISOString(),
+        key,
+        data,
+    };
+    const payload = JSON.stringify(envelope);
+    const tmpPath = `${fullPath}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(tmpPath, payload, { mode: FILE_MODE });
+        // Some platforms ignore the `mode` on `writeFile` (umask). Re-
+        // chmod explicitly so we never leave the file group/world
+        // readable.
+        await chmod(tmpPath, FILE_MODE);
+        await rename(tmpPath, fullPath);
+        return { path: fullPath, sizeBytes: Buffer.byteLength(payload, 'utf8') };
+    }
+    catch (err) {
+        await unlink(tmpPath).catch(() => undefined);
+        throw wrapFsError(err, `cannot write cache entry ${relativePath}`, {
+            path: fullPath,
+        });
+    }
+};
+const classifyEntry = (relativePath) => {
+    const segments = relativePath.split(sep);
+    const [first] = segments;
+    if (first === 'boards' && segments.length === 2) {
+        const [, file] = segments;
+        if (file !== undefined) {
+            const id = file.replace(/\.json$/u, '');
+            return { kind: 'boards', id };
+        }
+    }
+    if (first === 'users') {
+        return { kind: 'users', id: undefined };
+    }
+    if (first === 'schema') {
+        return { kind: 'schema', id: undefined };
+    }
+    return { kind: 'other', id: undefined };
+};
+/**
+ * Walks the cache root and reports every JSON entry. Returns an empty
+ * array (not an error) when the root doesn't exist — `cache list` on
+ * a fresh install is a normal state, not a failure.
+ */
+export const listEntries = async (root, options = {}) => {
+    const now = (options.now ?? (() => new Date()))();
+    let exists = true;
+    try {
+        await stat(root);
+    }
+    catch (err) {
+        if (isENOENT(err)) {
+            exists = false;
+        }
+        else {
+            throw wrapFsError(err, `cannot stat cache root ${root}`, { path: root });
+        }
+    }
+    if (!exists) {
+        return [];
+    }
+    const found = [];
+    await walk(root, root, found, now);
+    // Stable order: sorted by relative path. Spec says agents key off
+    // shape; deterministic output is friendlier than insertion order.
+    return [...found].sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+};
+const walk = async (root, current, out, now) => {
+    let entries;
+    try {
+        entries = await readdir(current, { withFileTypes: true });
+    }
+    catch (err) {
+        throw wrapFsError(err, `cannot read cache directory ${current}`, {
+            path: current,
+        });
+    }
+    for (const entry of entries) {
+        const full = join(current, entry.name);
+        if (entry.isDirectory()) {
+            await walk(root, full, out, now);
+            continue;
+        }
+        if (!entry.isFile() || !entry.name.endsWith('.json')) {
+            // Skip non-file dirents (sockets/symlinks) and non-cache files
+            // (a stray README.txt under boards/, etc.). Either case is an
+            // un-cataloged on-disk artefact, not something `cache list`
+            // should fabricate an entry for.
+            continue;
+        }
+        let stats;
+        try {
+            stats = await stat(full);
+        }
+        catch (err) {
+            throw wrapFsError(err, `cannot stat cache file ${full}`, { path: full });
+        }
+        const relativePath = relative(root, full);
+        const { kind, id } = classifyEntry(relativePath);
+        const ageSeconds = Math.max(0, Math.floor((now.getTime() - stats.mtimeMs) / 1000));
+        out.push({
+            path: full,
+            relativePath,
+            sizeBytes: stats.size,
+            modifiedAt: new Date(stats.mtimeMs).toISOString(),
+            ageSeconds,
+            kind,
+            id,
+        });
+    }
+};
+/**
+ * Removes a single entry. Missing → no-op; reports zero removals so
+ * `cache clear --board <bid>` against an unknown board doesn't fail.
+ */
+export const clearEntry = async (root, key) => {
+    const fullPath = join(root, cacheKeyToRelativePath(key));
+    let stats;
+    try {
+        stats = await stat(fullPath);
+    }
+    catch (err) {
+        if (isENOENT(err)) {
+            return { removed: 0, bytesFreed: 0 };
+        }
+        throw wrapFsError(err, `cannot stat cache entry ${fullPath}`, {
+            path: fullPath,
+        });
+    }
+    try {
+        await unlink(fullPath);
+    }
+    catch (err) {
+        throw wrapFsError(err, `cannot remove cache entry ${fullPath}`, {
+            path: fullPath,
+        });
+    }
+    return { removed: 1, bytesFreed: stats.size };
+};
+/**
+ * Eager invalidation of a board's metadata cache entry per
+ * `cli-design.md` §8 eager-invalidation contract (M16). Thin wrapper
+ * over `clearEntry(root, { kind: 'board', boardId })` that owns the
+ * cache-root resolution so call sites — every M16 column-mutation
+ * verb plus the M15 retrofit cluster (`board update` / `archive` /
+ * `delete`) — read as `invalidateBoard(boardId)` rather than
+ * `clearEntry(resolveCacheRoot({env}), {kind:'board',boardId})`.
+ *
+ * **Idempotent.** Invalidating an already-absent entry is a no-op
+ * (matches `clearEntry`'s missing-file semantics) — callers don't
+ * need to gate the call on "is this board cached?". Errors during
+ * unlink (permission flip, disk loss) bubble as `CacheError` per the
+ * underlying primitive.
+ *
+ * **Process-local.** The on-disk cache file IS shared across
+ * processes (same `$XDG_CACHE_HOME/monday-cli/boards/<bid>.json`
+ * path), so this `unlink` does remove peer processes' cache entries;
+ * the missing primitive is inter-process locking. Cross-process
+ * coordination is explicitly deferred to v0.3 per cli-design §8 —
+ * this helper does NOT add inter-process locking.
+ *
+ * Mirrors `evictBoardMetadata` in `board-metadata.ts` (the M3-era
+ * helper that predates the eager-invalidation contract); the two
+ * helpers are intentionally parallel — `evictBoardMetadata` lives
+ * next to the metadata loader and is consumed by tests + potential
+ * future `cache clear --board <bid>` flows; `invalidateBoard` lives
+ * here next to the underlying `clearEntry` primitive and is consumed
+ * by every M16+ board-structure mutation per the §8 contract. Lifting
+ * one over the other was rejected during M16 pre-flight to keep the
+ * existing test surface unchanged.
+ */
+export const invalidateBoard = async (boardId, 
+/* c8 ignore next — defensive default; callers pass an explicit env. */
+env = process.env) => {
+    const root = resolveCacheRoot({ env });
+    return clearEntry(root, { kind: 'board', boardId });
+};
+/**
+ * Removes the entire cache root. Used by `monday cache clear` (no
+ * flag) and tests. Counts removed JSON files for reporting; the
+ * directory tree itself goes too so a follow-up `cache list` reports
+ * an empty cache, not phantom directories.
+ */
+export const clearAll = async (root) => {
+    const entries = await listEntries(root);
+    if (entries.length === 0) {
+        // Nothing to remove; only delete the dir tree if it exists so the
+        // `cache list` output stays empty afterwards.
+        await rm(root, { recursive: true, force: true });
+        return { removed: 0, bytesFreed: 0 };
+    }
+    const bytesFreed = entries.reduce((sum, e) => sum + e.sizeBytes, 0);
+    try {
+        await rm(root, { recursive: true, force: true });
+    }
+    catch (err) {
+        throw wrapFsError(err, `cannot clear cache root ${root}`, { path: root });
+    }
+    return { removed: entries.length, bytesFreed };
+};
+export const stats = async (root, options = {}) => {
+    const entries = await listEntries(root, options);
+    if (entries.length === 0) {
+        // listEntries already threw on EACCES / etc.; reaching here means
+        // the root was either missing or present-and-empty. A quick stat
+        // distinguishes — any failure (race with `rm`, etc.) is treated
+        // as "doesn't exist" rather than re-wrapping into a CacheError.
+        const exists = await stat(root).then(() => true, () => false);
+        return {
+            root,
+            exists,
+            entries: 0,
+            bytes: 0,
+            oldestAgeSeconds: null,
+            newestAgeSeconds: null,
+        };
+    }
+    const ages = entries.map((e) => e.ageSeconds);
+    return {
+        root,
+        exists: true,
+        entries: entries.length,
+        bytes: entries.reduce((sum, e) => sum + e.sizeBytes, 0),
+        oldestAgeSeconds: Math.max(...ages),
+        newestAgeSeconds: Math.min(...ages),
+    };
+};
+const formatMode = (mode) => `0${(mode & 0o777).toString(8).padStart(3, '0')}`;
+//# sourceMappingURL=cache.js.map

package/dist/api/cache.js.map

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

package/dist/api/client.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Monday GraphQL client over the injected `Transport`
+ * (`v0.1-plan.md` §3 M2).
+ *
+ * Why not the SDK's `ApiClient`. The plan's wording is
+ * "wraps `@mondaydotcomorg/api`'s `ApiClient`" but the SDK's
+ * `request()` doesn't accept an external `AbortSignal` — it builds
+ * its own controller per-call, which means the runner's SIGINT-ware
+ * abort can't cancel an in-flight request. Tests also need to swap
+ * the network stack without monkey-patching SDK internals (Codex
+ * review §2 of M0). Both problems are solved by the existing
+ * `Transport` interface, so the client routes every call through
+ * `transport.request()` and uses the SDK only for *types* — `Account`,
+ * `User`, `Complexity`, `Version`, `CURRENT_VERSION`.
+ *
+ * Header injection (`Authorization`, `API-Version`, `Content-Type`)
+ * lives in `FetchTransport` and is locked down (Codex review M0 §1
+ * follow-up). Caller-supplied headers can't override it; this client
+ * passes only operation-name and any future trace headers.
+ *
+ * Internal callers see `Record<string, unknown>` for variables. The
+ * SDK's `QueryVariables = Record<string, any>` boundary leak is
+ * contained at this module's edge — no `any` flows into `commands/*`.
+ */
+import { type RetryStats } from './retry.js';
+import type { Transport } from './transport.js';
+import type { Complexity } from '../utils/output/envelope.js';
+/**
+ * The Monday API version pinned to the SDK install. Re-exported so
+ * the production runner and `monday account version` read the same
+ * source of truth — bumping the SDK is the only way this changes.
+ */
+export declare const PINNED_API_VERSION: string;
+export interface MondayClientConfig {
+    readonly transport: Transport;
+    readonly signal: AbortSignal;
+    /**
+     * Maximum retries per request. Comes from `--retry` (default 3).
+     * Passed through to `withRetry`; the retry layer respects
+     * `error.retryable` + `retry_after_seconds`.
+     */
+    readonly retries: number;
+    /**
+     * When true, every request injects the `complexity { ... }`
+     * selection at the outermost selection set and parses the result
+     * onto `Complexity`. Comes from `--verbose`.
+     */
+    readonly verbose: boolean;
+    /**
+     * Test hooks — production wires these to defaults. Documented in
+     * `api/retry.ts` (`RetryOptions`).
+     */
+    readonly retrySleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+    readonly retryRandom?: () => number;
+}
+export interface MondayRequestOptions {
+    /**
+     * Marker passed to the transport for a friendlier `body.operationName`
+     * — Monday's logs surface this when triaging issues. Defaults to
+     * the typed-method's name (e.g. `"whoami"`).
+     */
+    readonly operationName?: string;
+}
+export interface MondayResponse<T> {
+    readonly data: T;
+    /**
+     * Always present — null when the response carried no `complexity`
+     * block, an object otherwise. Matches `cli-design.md` §6.1's rule
+     * for `meta.complexity`.
+     */
+    readonly complexity: Complexity | null;
+    /** How many transport calls happened (1 = first attempt succeeded). */
+    readonly stats: RetryStats;
+}
+/**
+ * Subset of Monday's `User` we surface on `monday account whoami` /
+ * `monday user me`. The SDK's full `User` type (~30 fields) is too
+ * wide — we project to the slim shape `cli-design.md` calls out.
+ */
+export interface WhoamiData {
+    /**
+     * `me` is nullable in the wire shape — Monday returns `null` when
+     * the token is valid syntactically but belongs to a guest /
+     * disabled user. Commands surface that case as `unauthorized`.
+     */
+    readonly me: {
+        readonly id: string;
+        readonly name: string;
+        readonly email: string;
+        readonly account: {
+            readonly id: string;
+            readonly name: string;
+            readonly slug: string | null;
+        };
+    } | null;
+}
+export interface AccountData {
+    /**
+     * Same nullability story as `me` above — Monday won't typically
+     * return a null account for a valid token, but the wire field is
+     * `Maybe<Account>` and the CLI treats null as `not_found`.
+     */
+    readonly account: {
+        readonly id: string;
+        readonly name: string;
+        readonly slug: string | null;
+        readonly country_code: string | null;
+        readonly first_day_of_the_week: string | null;
+        readonly active_members_count: number | null;
+        readonly logo: string | null;
+        readonly plan: {
+            readonly version: number;
+            readonly tier: string;
+            readonly max_users: number;
+            readonly period: string | null;
+        } | null;
+    } | null;
+}
+export interface VersionsData {
+    readonly versions: readonly {
+        readonly display_name: string;
+        readonly kind: string;
+        readonly value: string;
+    }[];
+}
+export interface ComplexityProbeData {
+    readonly complexity: {
+        readonly before: number;
+        readonly after: number;
+        readonly query: number;
+        readonly reset_in_x_seconds: number;
+    } | null;
+}
+export declare class MondayClient {
+    private readonly transport;
+    private readonly signal;
+    private readonly retries;
+    private readonly verbose;
+    private readonly retrySleep;
+    private readonly retryRandom;
+    constructor(config: MondayClientConfig);
+    /**
+     * Low-level escape hatch (`v0.1-plan.md` §3 M2 deliverable).
+     * `commands/raw` (M6) calls this directly; M2 commands use the
+     * typed wrappers. Returns the parsed `data` plus the per-request
+     * complexity meta and retry stats.
+     *
+     * Variables are typed `Record<string, unknown>` rather than the
+     * SDK's `any`-laced `QueryVariables` so the surface stays sealed.
+     */
+    readonly raw: <T>(query: string, variables: Readonly<Record<string, unknown>> | undefined, options?: MondayRequestOptions) => Promise<MondayResponse<T>>;
+    readonly whoami: () => Promise<MondayResponse<WhoamiData>>;
+    readonly account: () => Promise<MondayResponse<AccountData>>;
+    readonly versions: () => Promise<MondayResponse<VersionsData>>;
+    /**
+     * Cheapest possible call: just selects the `complexity` field with
+     * no payload. Used by `monday account complexity` to probe the
+     * budget without any other side-effect.
+     */
+    readonly complexityProbe: () => Promise<MondayResponse<ComplexityProbeData>>;
+}
+//# sourceMappingURL=client.d.ts.map

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

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