monday-cli 0.2.0 → 0.3.0

package/dist/config/profiles.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Profile-config loader for the v0.3-M21 multi-profile surface
+ * (cli-design §7.2 — `~/.monday-cli/config.toml`).
+ *
+ * **What this module owns.** Reading + parsing the TOML config file,
+ * the per-profile config schema (zod-validated at the parse boundary
+ * per `.claude/rules/validation.md`), and the profile-selection
+ * resolver per §7.2 source order:
+ *
+ *     `--profile flag > MONDAY_PROFILE env > default_profile in
+ *      config > implicit v1 mode (no config file present)`
+ *
+ * **What this module does NOT own.** The credentials cache (token
+ * source-order within a profile) lives in
+ * `src/config/credentials.ts`.
+ *
+ * **Token-storage rule (cli-design §7.2 + §7.4 + .claude/rules/
+ * security.md):** tokens are NEVER stored in `config.toml`. Profile
+ * entries reference an env-var name via `api_token_env =
+ * "MONDAY_API_TOKEN_<X>"` (the env var's *name*, never its value).
+ * Two layers of defense:
+ *
+ *   1. **Structural exclusion** — `.strict()` on the zod object
+ *      rejects unknown keys (`api_token`, `access_token`, `secret`).
+ *   2. **Value-level shape check** — `api_token_env` is constrained
+ *      to the env-var-identifier regex `/^[A-Z_][A-Z0-9_]*$/u`.
+ */
+import { z } from 'zod';
+/** Filename under `~/.monday-cli/`. Pinned for HOME-scoping. */
+export declare const PROFILES_CONFIG_FILE_NAME = "config.toml";
+/** Parent directory under HOME (shared with credentials cache). */
+export declare const PROFILES_DIR_NAME = ".monday-cli";
+/**
+ * Optional `[profiles.<name>.dev]` block per cli-design §11.3 (Monday
+ * Dev convenience). Pinned here so v0.3-M26 (`monday dev …`) can read
+ * the same shape without a fresh schema landing alongside that
+ * milestone.
+ */
+export declare const profileDevBlockSchema: z.ZodObject<{
+    tasks_board: z.ZodOptional<z.ZodString>;
+    sprints_board: z.ZodOptional<z.ZodString>;
+    epics_board: z.ZodOptional<z.ZodString>;
+    bugs_board: z.ZodOptional<z.ZodString>;
+    releases_board: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ProfileDevBlock = z.infer<typeof profileDevBlockSchema>;
+export declare const profileEntrySchema: z.ZodObject<{
+    api_token_env: z.ZodOptional<z.ZodString>;
+    api_version: z.ZodOptional<z.ZodString>;
+    default_workspace: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    dev: z.ZodOptional<z.ZodObject<{
+        tasks_board: z.ZodOptional<z.ZodString>;
+        sprints_board: z.ZodOptional<z.ZodString>;
+        epics_board: z.ZodOptional<z.ZodString>;
+        bugs_board: z.ZodOptional<z.ZodString>;
+        releases_board: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProfileEntry = z.infer<typeof profileEntrySchema>;
+/**
+ * Top-level config-file shape per cli-design §7.2.
+ */
+export declare const profilesConfigSchema: z.ZodObject<{
+    default_profile: z.ZodOptional<z.ZodString>;
+    profiles: z.ZodRecord<z.ZodString, z.ZodObject<{
+        api_token_env: z.ZodOptional<z.ZodString>;
+        api_version: z.ZodOptional<z.ZodString>;
+        default_workspace: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        dev: z.ZodOptional<z.ZodObject<{
+            tasks_board: z.ZodOptional<z.ZodString>;
+            sprints_board: z.ZodOptional<z.ZodString>;
+            epics_board: z.ZodOptional<z.ZodString>;
+            bugs_board: z.ZodOptional<z.ZodString>;
+            releases_board: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProfilesConfig = z.infer<typeof profilesConfigSchema>;
+export interface ProfilesRootOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly home?: string;
+}
+/**
+ * Resolves the absolute config-file path. Pure helper.
+ */
+export declare const resolveProfilesConfigPath: (options?: ProfilesRootOptions) => string;
+/**
+ * Reads + parses `~/.monday-cli/config.toml`. Returns `undefined`
+ * when the file does not exist (typical first-run state — implicit
+ * v1 mode applies). Throws `config_error` for parse failures (TOML
+ * malformed) or schema-validation failures (unknown keys, type
+ * mismatch, token-smuggled-as-env-var-name).
+ */
+export declare const loadProfilesConfig: (options?: ProfilesRootOptions) => Promise<ProfilesConfig | undefined>;
+export interface SelectProfileInputs {
+    readonly flag: string | undefined;
+    readonly env: NodeJS.ProcessEnv;
+    readonly config: ProfilesConfig | undefined;
+}
+export type SelectProfileResult = {
+    readonly mode: 'named';
+    readonly name: string;
+    readonly entry: ProfileEntry;
+} | {
+    readonly mode: 'implicit_v1';
+};
+/**
+ * Resolves the active profile per cli-design §7.2 source order:
+ *
+ *   1. `flag` (from `--profile <name>`).
+ *   2. `env.MONDAY_PROFILE`.
+ *   3. `config.default_profile`.
+ *   4. Implicit-v1 sentinel.
+ *
+ * Surfaces `config_error` when:
+ *   - any of (1)/(2)/(3) names a profile not present in the config
+ *     file, OR
+ *   - `flag` / `MONDAY_PROFILE` is set but no config file exists
+ *     (the flag/env imply per-profile resolution that the missing
+ *     config can't fulfil).
+ */
+export declare const selectProfile: (inputs: SelectProfileInputs) => SelectProfileResult;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/config/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;kBAQvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAUpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;kBAkBpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;kBAKtB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAS,mBAAwB,KAChC,MAGF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAS,mBAAwB,KAChC,OAAO,CAAC,cAAc,GAAG,SAAS,CA6DpC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,mBAAmB,KAC1B,mBAmEF,CAAC"}

package/dist/config/profiles.js

@@ -0,0 +1,227 @@
+/**
+ * Profile-config loader for the v0.3-M21 multi-profile surface
+ * (cli-design §7.2 — `~/.monday-cli/config.toml`).
+ *
+ * **What this module owns.** Reading + parsing the TOML config file,
+ * the per-profile config schema (zod-validated at the parse boundary
+ * per `.claude/rules/validation.md`), and the profile-selection
+ * resolver per §7.2 source order:
+ *
+ *     `--profile flag > MONDAY_PROFILE env > default_profile in
+ *      config > implicit v1 mode (no config file present)`
+ *
+ * **What this module does NOT own.** The credentials cache (token
+ * source-order within a profile) lives in
+ * `src/config/credentials.ts`.
+ *
+ * **Token-storage rule (cli-design §7.2 + §7.4 + .claude/rules/
+ * security.md):** tokens are NEVER stored in `config.toml`. Profile
+ * entries reference an env-var name via `api_token_env =
+ * "MONDAY_API_TOKEN_<X>"` (the env var's *name*, never its value).
+ * Two layers of defense:
+ *
+ *   1. **Structural exclusion** — `.strict()` on the zod object
+ *      rejects unknown keys (`api_token`, `access_token`, `secret`).
+ *   2. **Value-level shape check** — `api_token_env` is constrained
+ *      to the env-var-identifier regex `/^[A-Z_][A-Z0-9_]*$/u`.
+ */
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { parse as parseToml } from 'smol-toml';
+import { z } from 'zod';
+import { ConfigError, asError } from '../utils/errors.js';
+import { isENOENT } from '../utils/fs.js';
+/** Filename under `~/.monday-cli/`. Pinned for HOME-scoping. */
+export const PROFILES_CONFIG_FILE_NAME = 'config.toml';
+/** Parent directory under HOME (shared with credentials cache). */
+export const PROFILES_DIR_NAME = '.monday-cli';
+/**
+ * Optional `[profiles.<name>.dev]` block per cli-design §11.3 (Monday
+ * Dev convenience). Pinned here so v0.3-M26 (`monday dev …`) can read
+ * the same shape without a fresh schema landing alongside that
+ * milestone.
+ */
+export const profileDevBlockSchema = z
+    .object({
+    tasks_board: z.string().min(1).optional(),
+    sprints_board: z.string().min(1).optional(),
+    epics_board: z.string().min(1).optional(),
+    bugs_board: z.string().min(1).optional(),
+    releases_board: z.string().min(1).optional(),
+})
+    .strict();
+/**
+ * Env-var identifier shape (POSIX-style). Rejects token-looking
+ * values like `tok-fixture-xxxx` or JWT-looking values like
+ * `eyJhbGciOi...` so a user pasting a token under the allowed
+ * `api_token_env` key fails at parse time.
+ */
+const ENV_VAR_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/u;
+export const profileEntrySchema = z
+    .object({
+    api_token_env: z
+        .string()
+        .min(1)
+        .regex(ENV_VAR_NAME_PATTERN, {
+        message: '`api_token_env` must be an env-var name (e.g., `MONDAY_API_TOKEN_WORK`), NOT the token value itself. The CLI never reads tokens from `config.toml`; reference an env var or use `monday auth login` instead.',
+    })
+        .optional(),
+    api_version: z
+        .string()
+        .regex(/^\d{4}-\d{2}$/u, { message: 'expected YYYY-MM' })
+        .optional(),
+    default_workspace: z.string().min(1).optional(),
+    timezone: z.string().min(1).optional(),
+    dev: profileDevBlockSchema.optional(),
+})
+    .strict();
+/**
+ * Top-level config-file shape per cli-design §7.2.
+ */
+export const profilesConfigSchema = z
+    .object({
+    default_profile: z.string().min(1).optional(),
+    profiles: z.record(z.string().min(1), profileEntrySchema),
+})
+    .strict();
+/**
+ * Resolves the absolute config-file path. Pure helper.
+ */
+export const resolveProfilesConfigPath = (options = {}) => {
+    const home = options.home ?? homedir();
+    return join(home, PROFILES_DIR_NAME, PROFILES_CONFIG_FILE_NAME);
+};
+/**
+ * Reads + parses `~/.monday-cli/config.toml`. Returns `undefined`
+ * when the file does not exist (typical first-run state — implicit
+ * v1 mode applies). Throws `config_error` for parse failures (TOML
+ * malformed) or schema-validation failures (unknown keys, type
+ * mismatch, token-smuggled-as-env-var-name).
+ */
+export const loadProfilesConfig = async (options = {}) => {
+    const fullPath = resolveProfilesConfigPath(options);
+    let raw;
+    try {
+        raw = await readFile(fullPath, 'utf8');
+    }
+    catch (err) {
+        if (isENOENT(err)) {
+            return undefined;
+        }
+        // Non-ENOENT readFile errors (EACCES, EISDIR) are platform-
+        // specific and not reproducible from a tmp-dir test.
+        /* c8 ignore start */
+        throw new ConfigError(`cannot read profiles config ${fullPath}`, {
+            cause: asError(err),
+            details: { path: fullPath },
+        });
+        /* c8 ignore stop */
+    }
+    let tomlParsed;
+    try {
+        tomlParsed = parseToml(raw);
+    }
+    catch (err) {
+        throw new ConfigError(`malformed TOML in profiles config ${fullPath}`, {
+            cause: asError(err),
+            details: {
+                path: fullPath,
+                hint: 'check the file for unmatched quotes, missing `=`, or invalid section headers',
+            },
+        });
+    }
+    const result = profilesConfigSchema.safeParse(tomlParsed);
+    if (!result.success) {
+        const issues = result.error.issues.map((i) => ({
+            path: i.path.join('.'),
+            message: i.message,
+            code: i.code,
+        }));
+        const summary = issues
+            .map((i) => (i.path !== '' ? `${i.path}: ${i.message}` : i.message))
+            .join('; ');
+        throw new ConfigError(`invalid profiles config: ${summary}`, {
+            cause: result.error,
+            details: {
+                path: fullPath,
+                issues,
+                hint: 'profile entries must reference an env-var NAME via `api_token_env`, never the token value itself; tokens belong in env vars or the credentials cache (run `monday auth login`).',
+            },
+        });
+    }
+    return result.data;
+};
+/**
+ * Resolves the active profile per cli-design §7.2 source order:
+ *
+ *   1. `flag` (from `--profile <name>`).
+ *   2. `env.MONDAY_PROFILE`.
+ *   3. `config.default_profile`.
+ *   4. Implicit-v1 sentinel.
+ *
+ * Surfaces `config_error` when:
+ *   - any of (1)/(2)/(3) names a profile not present in the config
+ *     file, OR
+ *   - `flag` / `MONDAY_PROFILE` is set but no config file exists
+ *     (the flag/env imply per-profile resolution that the missing
+ *     config can't fulfil).
+ */
+export const selectProfile = (inputs) => {
+    const flagName = inputs.flag !== undefined && inputs.flag.length > 0
+        ? inputs.flag
+        : undefined;
+    const envName = inputs.env.MONDAY_PROFILE !== undefined &&
+        inputs.env.MONDAY_PROFILE.length > 0
+        ? inputs.env.MONDAY_PROFILE
+        : undefined;
+    // (1)/(2): explicit selection. The credentials cache is the
+    // authoritative store for tokens (cli-design §7.4.1), and
+    // `monday auth login --profile <name>` populates it without
+    // requiring a `config.toml` edit. Two cases:
+    //
+    //   - No config file: return a synthetic empty entry. The caller
+    //     resolves the token via `resolveProfileToken`, which checks
+    //     the credentials cache first and surfaces `config_error`
+    //     only if neither cache nor `api_token_env` is populated.
+    //   - Config file present but profile not in `profiles`: error
+    //     loud — the user expressed an explicit `[profiles.<name>]`
+    //     intent that the file doesn't satisfy.
+    const explicit = flagName ?? envName;
+    if (explicit !== undefined) {
+        if (inputs.config === undefined) {
+            return { mode: 'named', name: explicit, entry: {} };
+        }
+        const entry = inputs.config.profiles[explicit];
+        if (entry === undefined) {
+            throw new ConfigError(`profile \`${explicit}\` not found in ~/.monday-cli/config.toml`, {
+                details: {
+                    profile: explicit,
+                    available_profiles: Object.keys(inputs.config.profiles),
+                    source: flagName !== undefined ? '--profile flag' : 'MONDAY_PROFILE env',
+                    hint: `add a [profiles.${explicit}] section to ~/.monday-cli/config.toml, OR run \`monday auth login --profile ${explicit}\` to populate the credentials cache directly`,
+                },
+            });
+        }
+        return { mode: 'named', name: explicit, entry };
+    }
+    // (3): default_profile from config.
+    if (inputs.config?.default_profile !== undefined) {
+        const name = inputs.config.default_profile;
+        const entry = inputs.config.profiles[name];
+        if (entry === undefined) {
+            throw new ConfigError(`default_profile \`${name}\` not found in ~/.monday-cli/config.toml`, {
+                details: {
+                    profile: name,
+                    available_profiles: Object.keys(inputs.config.profiles),
+                    source: 'default_profile in config.toml',
+                    hint: 'set `default_profile` to one of the listed available_profiles, or remove the `default_profile` line to fall back to the first profile listed',
+                },
+            });
+        }
+        return { mode: 'named', name, entry };
+    }
+    // (4): implicit v1.
+    return { mode: 'implicit_v1' };
+};
+//# sourceMappingURL=profiles.js.map

package/dist/config/profiles.js.map

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

package/dist/types/global-flags.d.ts

@@ -51,7 +51,7 @@ export interface GlobalFlags {
     readonly verbose: boolean;
     readonly noColor: boolean;
     readonly noCache: boolean;
-    readonly profile: 'default' | undefined;
+    readonly profile: string | undefined;
     readonly apiVersion: string | undefined;
     readonly timeout: number | undefined;
     readonly retry: number;

package/dist/types/global-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-flags.d.ts","sourceRoot":"","sources":["../../src/types/global-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;kBAyC7B,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAEhD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAkED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,EAChB,MAAK,MAAM,CAAC,UAAe,KAC1B,WA+BF,CAAC"}
+{"version":3,"file":"global-flags.d.ts","sourceRoot":"","sources":["../../src/types/global-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmDxB,eAAO,MAAM,cAAc,8CAA+C,CAAC;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;kBAyC7B,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAEhD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAiED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,EAChB,MAAK,MAAM,CAAC,UAAe,KAC1B,WA+BF,CAAC"}

package/dist/types/global-flags.js

@@ -22,8 +22,20 @@ import { UsageError } from '../utils/errors.js';
  *    schema, then projects into the normalised `GlobalFlags` shape
  *    the rest of the codebase consumes (`noCache`, `noColor`,
  *    `columns: string[]`). Also resolves `--profile` against
- *    `MONDAY_PROFILE` env per the §8 decision-5 deferral
- *    (accept absent or `default`; anything else is `usage_error`).
+ *    `MONDAY_PROFILE` env per cli-design §7.2 (`--profile` flag >
+ *    `MONDAY_PROFILE` env; mismatch is `usage_error`). The actual
+ *    profile-config + credentials-cache lookup happens later in
+ *    `cli/run.ts`'s config-load step at v0.3-M21 implementation;
+ *    pre-flight only widens the structural acceptance.
+ *
+ * **v0.3-M21 pre-flight widening.** Pre-v0.3 the resolver rejected
+ * any profile name other than `default` with a v0.3 hint; with the
+ * §7.2 / §7.3 / §7.4 surface in force from M21 onwards, any non-
+ * empty profile name parses through structurally. The actual
+ * resolution-to-token step (cache > api_token_env > config_error)
+ * lands at M21 implementation in `cli/run.ts`; until then, non-auth
+ * commands using `--profile work` silently use the implicit-v1
+ * (`MONDAY_API_TOKEN`) token.
  *
  * Codex review §4–§6 caught the original schema's drift — it
  * declared `noCache: boolean` and `columns: string[]` and tested
@@ -31,8 +43,6 @@ import { UsageError } from '../utils/errors.js';
  * This rewrite uses commander's actual shape on the input boundary
  * and produces the consumer-friendly shape on the output boundary.
  */
-const PROFILE_V03_HINT = 'Multi-profile support lands in v0.3 (`monday auth login`). ' +
-    'For now, omit --profile/MONDAY_PROFILE or set them to `default`.';
 const apiVersionSchema = z
     .string()
     .regex(/^\d{4}-\d{2}$/u, { message: 'expected YYYY-MM' });
@@ -92,10 +102,19 @@ const splitColumns = (raw) => {
     return parts.length === 0 ? undefined : parts;
 };
 /**
- * `--profile` deferral (`v0.1-plan.md` §8 decision 5). Accept absent
- * or the literal `default`; anything else is `usage_error` with a
- * v0.3 hint. `MONDAY_PROFILE` env is treated identically — flag and
- * env must agree if both are set.
+ * `--profile` source-priority resolver per cli-design §7.2.
+ *
+ * Returns the chosen profile name (or `undefined` when neither flag
+ * nor env is set, signalling the implicit-v1 path). The flag wins
+ * over the env when both are set to the same value; a mismatch
+ * surfaces `usage_error` per the same rule.
+ *
+ * **v0.3-M21 pre-flight surface.** Any non-empty string parses
+ * through; the actual lookup (does the named profile exist in
+ * `~/.monday-cli/config.toml`? does `~/.monday-cli/credentials`
+ * have an entry for it? is the named `api_token_env` populated?)
+ * is M21 implementation work in `cli/run.ts`'s config-load step.
+ * `parseGlobalFlags` does NOT touch the filesystem.
  */
 const resolveProfile = (flagValue, envValue) => {
     const fromFlag = flagValue !== undefined && flagValue.length > 0
@@ -111,14 +130,7 @@ const resolveProfile = (flagValue, envValue) => {
             },
         });
     }
-    const chosen = fromFlag ?? fromEnv;
-    if (chosen === undefined) {
-        return undefined;
-    }
-    if (chosen !== 'default') {
-        throw new UsageError(`profile "${chosen}" is not supported in v0.1`, { details: { hint: PROFILE_V03_HINT } });
-    }
-    return 'default';
+    return fromFlag ?? fromEnv;
 };
 const formatZodIssues = (err) => {
     const issues = err.issues.map((issue) => ({

package/dist/types/global-flags.js.map

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

package/dist/types/ids.d.ts

@@ -26,6 +26,7 @@ export declare const ItemIdSchema: z.core.$ZodBranded<z.ZodString, "ItemId", "ou
 export declare const UserIdSchema: z.core.$ZodBranded<z.ZodString, "UserId", "out">;
 export declare const WorkspaceIdSchema: z.core.$ZodBranded<z.ZodString, "WorkspaceId", "out">;
 export declare const UpdateIdSchema: z.core.$ZodBranded<z.ZodString, "UpdateId", "out">;
+export declare const WebhookIdSchema: z.core.$ZodBranded<z.ZodString, "WebhookId", "out">;
 export declare const ColumnIdSchema: z.core.$ZodBranded<z.ZodString, "ColumnId", "out">;
 export declare const GroupIdSchema: z.core.$ZodBranded<z.ZodString, "GroupId", "out">;
 export type BoardId = z.infer<typeof BoardIdSchema>;
@@ -35,4 +36,5 @@ export type GroupId = z.infer<typeof GroupIdSchema>;
 export type UserId = z.infer<typeof UserIdSchema>;
 export type WorkspaceId = z.infer<typeof WorkspaceIdSchema>;
 export type UpdateId = z.infer<typeof UpdateIdSchema>;
+export type WebhookId = z.infer<typeof WebhookIdSchema>;
 //# sourceMappingURL=ids.d.ts.map

package/dist/types/ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/types/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AAEzD,eAAO,MAAM,aAAa,mDAAqC,CAAC;AAChE,eAAO,MAAM,YAAY,kDAAoC,CAAC;AAC9D,eAAO,MAAM,YAAY,kDAAoC,CAAC;AAC9D,eAAO,MAAM,iBAAiB,uDAAyC,CAAC;AACxE,eAAO,MAAM,cAAc,oDAAsC,CAAC;AAIlE,eAAO,MAAM,cAAc,oDAAmC,CAAC;AAC/D,eAAO,MAAM,aAAa,mDAAkC,CAAC;AAE7D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/types/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AAEzD,eAAO,MAAM,aAAa,mDAAqC,CAAC;AAChE,eAAO,MAAM,YAAY,kDAAoC,CAAC;AAC9D,eAAO,MAAM,YAAY,kDAAoC,CAAC;AAC9D,eAAO,MAAM,iBAAiB,uDAAyC,CAAC;AACxE,eAAO,MAAM,cAAc,oDAAsC,CAAC;AAClE,eAAO,MAAM,eAAe,qDAAuC,CAAC;AAIpE,eAAO,MAAM,cAAc,oDAAmC,CAAC;AAC/D,eAAO,MAAM,aAAa,mDAAkC,CAAC;AAE7D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/types/ids.js

@@ -1,8 +1,9 @@
 import { z } from 'zod';
 /**
- * Branded zod schemas for the seven ID kinds Monday surfaces. Brands
- * make `BoardId`/`ItemId`/etc. nominally distinct at the type level
- * even though they're all numeric strings on the wire — passing a
+ * Branded zod schemas for the eight ID kinds Monday surfaces (M27
+ * added `WebhookId` alongside the seven v0.1 brands). Brands make
+ * `BoardId`/`ItemId`/etc. nominally distinct at the type level even
+ * though they're all numeric strings on the wire — passing a
  * `BoardId` where an `ItemId` is wanted becomes a compile error,
  * which is the whole point.
  *
@@ -44,6 +45,7 @@ export const ItemIdSchema = numericIdSchema.brand();
 export const UserIdSchema = numericIdSchema.brand();
 export const WorkspaceIdSchema = numericIdSchema.brand();
 export const UpdateIdSchema = numericIdSchema.brand();
+export const WebhookIdSchema = numericIdSchema.brand();
 // Column and group IDs are stable lower-snake-case slugs ("status_4",
 // "topics") — not numeric. Validate as non-empty strings only.
 export const ColumnIdSchema = slugIdSchema.brand();

package/dist/types/ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/types/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;AAEzD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE;IACrC,OAAO,EAAE,yBAAyB;CACnC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,EAAa,CAAC;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,KAAK,EAAiB,CAAC;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,EAAc,CAAC;AAElE,sEAAsE;AACtE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,EAAc,CAAC;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,EAAa,CAAC"}
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/types/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;AAEzD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE;IACrC,OAAO,EAAE,yBAAyB;CACnC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,EAAa,CAAC;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,EAAY,CAAC;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,KAAK,EAAiB,CAAC;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,EAAc,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,EAAe,CAAC;AAEpE,sEAAsE;AACtE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,EAAc,CAAC;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,EAAa,CAAC"}

package/dist/utils/errors.d.ts

@@ -3,10 +3,22 @@
  * `code` from `cli-design.md` §6.5 — agents key off the code, never
  * the English `message`. v0.1 froze 26 codes; `ambiguous_match` ships
  * in v0.2 M12 (`item upsert` with 2+ matches), bringing the count to
- * 27. `dev_*` codes ship in v0.3 but are listed here so the M5b agent
- * doesn't need to backfill the type.
+ * 27. `tag_not_found` registered pre-v0.3-M19 as the writer-expansion
+ * close prerequisite (cli-design §6.5 entry landed at `4c652d5`); the
+ * runtime throw site lands at M19 implementation when the `tags`
+ * friendly translator + `tag-directory.ts` ship — but the union
+ * widens at the M19 pre-flight contract diff so M19 feat commits
+ * throw into a stable typed surface (28 total). `oauth_failed` joined
+ * at the v0.3-M21 pre-flight contract diff as the `monday auth login`
+ * umbrella per cli-design §7.3.3 (29 total) — `details.reason`
+ * discriminates the failure mode (`csrf_mismatch`, `user_denied`,
+ * `authorization_failed`, `code_exchange_failed`, `timeout`,
+ * `port_in_use`, `browser_unavailable`); the runtime throw sites land
+ * at M21 implementation when `src/api/oauth.ts` + `src/commands/auth/*`
+ * ship their wire bodies. `dev_*` codes ship in v0.3 but are listed here
+ * so the M5b agent doesn't need to backfill the type.
  */
-export declare const ERROR_CODES: readonly ["usage_error", "confirmation_required", "not_found", "ambiguous_name", "ambiguous_column", "ambiguous_match", "column_not_found", "user_not_found", "unsupported_column_type", "column_archived", "unauthorized", "forbidden", "rate_limited", "complexity_exceeded", "daily_limit_exceeded", "concurrency_exceeded", "ip_rate_limited", "resource_locked", "validation_failed", "stale_cursor", "config_error", "cache_error", "network_error", "timeout", "dev_not_configured", "dev_board_misconfigured", "internal_error"];
+export declare const ERROR_CODES: readonly ["usage_error", "confirmation_required", "not_found", "ambiguous_name", "ambiguous_column", "ambiguous_match", "column_not_found", "user_not_found", "tag_not_found", "unsupported_column_type", "column_archived", "unauthorized", "forbidden", "rate_limited", "complexity_exceeded", "daily_limit_exceeded", "concurrency_exceeded", "ip_rate_limited", "resource_locked", "validation_failed", "stale_cursor", "oauth_failed", "config_error", "cache_error", "network_error", "timeout", "dev_not_configured", "dev_board_misconfigured", "internal_error"];
 export type ErrorCode = (typeof ERROR_CODES)[number];
 /**
  * The CLI's exit code surface (`cli-design.md` §3.1 #5).
@@ -118,4 +130,46 @@ export declare const exitCodeForError: (code: ErrorCode) => ExitCode;
  * decided when they aborted.
  */
 export declare const errorForAbortReason: (reason: AbortReason) => MondayCliError;
+/**
+ * Narrows a caught `unknown` to its message string. The standard
+ * `useUnknownInCatchVariables`-narrowing idiom for project code that
+ * needs the human-readable text without the full Error object.
+ *
+ * **R-NEW-14 lift (post-M23 audit).** Previously inlined 11+ times
+ * across the codebase since M2/M6 — see `docs/v0.3-plan.md` §22
+ * R-NEW-14 entry for the missed-trigger history. M22's
+ * `src/api/probes.ts:errorMessage` is the smoking gun: the developer
+ * needed the helper and wrote a local copy instead of finding the
+ * 9+ inline sites. Lift consolidates those into one canonical
+ * helper.
+ */
+export declare const errorMessage: (err: unknown) => string;
+/**
+ * Coerces a caught `unknown` to a real `Error` for `cause:`
+ * propagation. The companion to {@link errorMessage} for code paths
+ * that want the full Error object to thread through a `cause:`
+ * chain rather than just the message string.
+ *
+ * **R-NEW-15 lift (post-M23 audit).** Previously inlined 6+ times
+ * across M1 + M21 modules (`src/api/cache.ts`,
+ * `src/config/credentials.ts`, `src/config/profiles.ts`,
+ * `src/api/oauth-test-helper.ts`). M22's `src/api/probes.ts:asError`
+ * is the smoking gun (local copy with an `AbortSignal.reason`
+ * fallback parameter — superseded here by the shared helper).
+ * See `docs/v0.3-plan.md` §22 R-NEW-15 for the missed-trigger
+ * history.
+ */
+export declare const asError: (err: unknown) => Error;
+/**
+ * Extracts the Node `err.code` property in a type-safe way, returning
+ * the string when present and `undefined` otherwise.
+ *
+ * **R-NEW-16 lift (post-M23 audit).** Generalises the
+ * `(err as { code?: unknown }).code` pattern that R-NEW-1's
+ * `isENOENT` open-coded. Three named consumers as of M22 (probes.ts
+ * + transport.ts + utils/fs.ts's `isENOENT`). `isENOENT` is now a
+ * one-liner on top of this. See `docs/v0.3-plan.md` §22 R-NEW-16
+ * for the trigger history.
+ */
+export declare const errorCode: (err: unknown) => string | undefined;
 //# sourceMappingURL=errors.d.ts.map

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

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