monday-cli 0.2.0 → 0.4.0

package/dist/commands/dev/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/commands/dev/_shared.ts"],"names":[],"mappings":"AAqBA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,UAAU,EACf,aAAa,OAAO,KACnB,OAAO,CAAC,kBAAkB,CA4C5B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,UAAU,EACnB,MAAM,MAAM,UAAU,EACtB,SAAS,MAAM,KACd,MAiBF,CAAC"}

package/dist/commands/dev/_shared.js

@@ -0,0 +1,104 @@
+/**
+ * Shared helpers for the `monday dev …` namespace verbs.
+ *
+ * Owns the per-verb preamble pattern surfaced across `dev discover`
+ * / `dev configure` / `dev doctor` (M26a) + the workflow verbs
+ * (M26b): resolve the active profile name (via the same
+ * flag-/env-/default_profile priority `src/cli/program.ts`'s
+ * preAction hook applies for token resolution) so the verb can
+ * read/write the `[profiles.<name>.dev]` block.
+ *
+ * **What this module owns.** The pure profile-name resolution. Token
+ * resolution is the preAction hook's job (already shipped at
+ * v0.3-M21); this helper picks up the same precedence chain and
+ * surfaces the resolved name for the dev block IO.
+ *
+ * **What this module does NOT own.** The dev mapping IO itself
+ * (`loadDevMapping` / `saveDevMapping` in
+ * `src/api/dev-conventions.ts`); those take the resolved profile
+ * name as a parameter.
+ */
+import { ApiError, ConfigError } from '../../utils/errors.js';
+import { loadProfilesConfig, selectProfile, } from '../../config/profiles.js';
+import { parseGlobalFlags } from '../../types/global-flags.js';
+/**
+ * Resolves the active profile name for a dev-namespace verb.
+ * Surfaces `config_error` (NOT `dev_not_configured`) when the verb
+ * runs in implicit-v1 mode — the dev namespace is fundamentally
+ * named-profile-only since the dev block lives under
+ * `[profiles.<name>.dev]`.
+ *
+ * Precedence mirrors `cli-design.md` §7.2 + `src/cli/program.ts`'s
+ * preAction hook:
+ *   1. `--profile <name>` global flag
+ *   2. `MONDAY_PROFILE` env var
+ *   3. `default_profile` in `~/.monday-cli/config.toml`
+ *   4. Implicit-v1 sentinel → throws `config_error`
+ */
+export const resolveActiveDevProfile = async (ctx, programOpts) => {
+    // HOME-truthy + length check mirrors `src/cli/program.ts:171-174`.
+    // Tests always set HOME via the per-test tmp dir; the
+    // `home === undefined` arm is defensive for production environments
+    // where HOME is unset (running under a hardened systemd unit, etc.) —
+    // not reproducible from any integration test.
+    /* c8 ignore start */
+    const home = ctx.env.HOME !== undefined && ctx.env.HOME.length > 0
+        ? ctx.env.HOME
+        : undefined;
+    const homeOptions = home !== undefined ? { home, env: ctx.env } : { env: ctx.env };
+    /* c8 ignore stop */
+    // `parseGlobalFlags` throws `UsageError` on a bad global flag
+    // (`--retry`, `--timeout`, `--profile`, etc.). Codex M26a IMPL P1-1
+    // fix: surface the UsageError synchronously so the dev verb's
+    // action body never proceeds to the file-write path with invalid
+    // globals. Previously a catch here let `dev configure` reach
+    // `saveDevMapping` before `emitMutation`'s re-parse threw the
+    // usage_error, leaving the active profile's `[profiles.<name>.dev]`
+    // block clobbered despite the rejected invocation.
+    const flagProfile = parseGlobalFlags(programOpts, ctx.env).profile;
+    const config = await loadProfilesConfig(homeOptions);
+    const selection = selectProfile({
+        flag: flagProfile,
+        env: ctx.env,
+        config,
+    });
+    if (selection.mode === 'implicit_v1') {
+        throw new ConfigError('`monday dev` verbs require a named profile', {
+            details: {
+                hint: 'set MONDAY_PROFILE=<name>, pass --profile <name>, or set `default_profile` in ~/.monday-cli/config.toml (run `monday auth login --profile <name>` to populate the credentials cache too)',
+            },
+        });
+    }
+    return { name: selection.name, homeOptions };
+};
+/**
+ * Slot-check helper for the 10 M26b workflow verbs. Every workflow
+ * verb pulls a noun-specific board ID off the loaded {@link DevMapping}
+ * + surfaces `dev_not_configured` when the slot is unset — same shape
+ * 10 times pre-lift. R-NEW-32 fires at the 10-consumer threshold
+ * (M26b IMPL); the helper lands with the workflow verbs themselves
+ * so the duplication never appears in any feat commit.
+ *
+ * **Why this is `dev_not_configured`, not `dev_board_misconfigured`.**
+ * Per cli-design §5.9 + the M26a round-1 P2-4 closure: the absence of
+ * a slot in the dev mapping is a missing CONFIGURATION (the user
+ * hasn't told the CLI which board to use). A misconfigured board —
+ * board exists but doesn't expose the expected column / wiring —
+ * surfaces from runtime checks via `dev_board_misconfigured` later in
+ * the verb. The slot-empty case stays under `dev_not_configured`.
+ */
+export const requireDevBoard = (mapping, slot, profile) => {
+    const value = mapping[slot];
+    if (value === undefined) {
+        const flag = slot.replace('_board', '-board');
+        throw new ApiError('dev_not_configured', `Monday Dev mapping for profile \`${profile}\` is missing the \`${slot}\` slot`, {
+            details: {
+                profile,
+                slot,
+                hint: `run \`monday dev configure --${flag} <bid>\` or \`monday dev discover --apply\``,
+            },
+        });
+    }
+    return value;
+};
+//# sourceMappingURL=_shared.js.map

package/dist/commands/dev/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/commands/dev/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,aAAa,GAEd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAS/D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,GAAe,EACf,WAAoB,EACS,EAAE;IAC/B,mEAAmE;IACnE,sDAAsD;IACtD,oEAAoE;IACpE,sEAAsE;IACtE,8CAA8C;IAC9C,qBAAqB;IACrB,MAAM,IAAI,GACR,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACnD,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI;QACd,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,WAAW,GACf,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IACjE,oBAAoB;IAEpB,8DAA8D;IAC9D,oEAAoE;IACpE,8DAA8D;IAC9D,iEAAiE;IACjE,6DAA6D;IAC7D,8DAA8D;IAC9D,oEAAoE;IACpE,mDAAmD;IACnD,MAAM,WAAW,GAAG,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,aAAa,CAAC;QAC9B,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACrC,MAAM,IAAI,WAAW,CACnB,4CAA4C,EAC5C;YACE,OAAO,EAAE;gBACP,IAAI,EAAE,0LAA0L;aACjM;SACF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,OAAmB,EACnB,IAAsB,EACtB,OAAe,EACP,EAAE;IACV,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,QAAQ,CAChB,oBAAoB,EACpB,oCAAoC,OAAO,uBAAuB,IAAI,SAAS,EAC/E;YACE,OAAO,EAAE;gBACP,OAAO;gBACP,IAAI;gBACJ,IAAI,EAAE,gCAAgC,IAAI,6CAA6C;aACxF;SACF,CACF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/commands/dev/configure.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `monday dev configure [--tasks-board <bid>] [--sprints-board
+ *  <bid>] [--epics-board <bid>] [--bugs-board <bid>]
+ *  [--releases-board <bid>]` — explicit per-board override of the
+ * Monday Dev mapping for the active profile (cli-design §4.3 +
+ * §5.9 + §11.3 + §13 v0.3 entry; v0.3-plan §3 M26).
+ *
+ * **Runtime body landed at M26a IMPL.** Reads the active profile's
+ * existing `[profiles.<name>.dev]` block (or starts empty if absent),
+ * additively merges the supplied `--<noun>-board` flags, writes back
+ * via `saveDevMapping`, and emits the canonical mapping via
+ * `emitMutation`.
+ *
+ * **Argv → TOML key mapping.** Commander's option-name camelCase
+ * → the TOML config's snake_case slots:
+ *   --tasks-board    → `tasks_board`
+ *   --sprints-board  → `sprints_board`
+ *   --epics-board    → `epics_board`
+ *   --bugs-board     → `bugs_board`
+ *   --releases-board → `releases_board`
+ *
+ * Idempotent: yes (writing the same mapping is a no-op).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DevConfigureOutput } from '../../api/dev-conventions.js';
+declare const inputSchema: z.ZodObject<{
+    tasksBoard: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    sprintsBoard: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    epicsBoard: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    bugsBoard: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+    releasesBoard: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "BoardId", "out">>;
+}, z.core.$strict>;
+export declare const devConfigureCommand: CommandModule<z.infer<typeof inputSchema>, DevConfigureOutput>;
+export {};
+//# sourceMappingURL=configure.d.ts.map

package/dist/commands/dev/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../src/commands/dev/configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,8BAA8B,CAAC;AAGtC,QAAA,MAAM,WAAW;;;;;;kBAwBb,CAAC;AAIL,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,kBAAkB,CA2GnB,CAAC"}

package/dist/commands/dev/configure.js

@@ -0,0 +1,145 @@
+/**
+ * `monday dev configure [--tasks-board <bid>] [--sprints-board
+ *  <bid>] [--epics-board <bid>] [--bugs-board <bid>]
+ *  [--releases-board <bid>]` — explicit per-board override of the
+ * Monday Dev mapping for the active profile (cli-design §4.3 +
+ * §5.9 + §11.3 + §13 v0.3 entry; v0.3-plan §3 M26).
+ *
+ * **Runtime body landed at M26a IMPL.** Reads the active profile's
+ * existing `[profiles.<name>.dev]` block (or starts empty if absent),
+ * additively merges the supplied `--<noun>-board` flags, writes back
+ * via `saveDevMapping`, and emits the canonical mapping via
+ * `emitMutation`.
+ *
+ * **Argv → TOML key mapping.** Commander's option-name camelCase
+ * → the TOML config's snake_case slots:
+ *   --tasks-board    → `tasks_board`
+ *   --sprints-board  → `sprints_board`
+ *   --epics-board    → `epics_board`
+ *   --bugs-board     → `bugs_board`
+ *   --releases-board → `releases_board`
+ *
+ * Idempotent: yes (writing the same mapping is a no-op).
+ */
+import { z } from 'zod';
+import { ApiError } from '../../utils/errors.js';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitMutation } from '../emit.js';
+import { BoardIdSchema } from '../../types/ids.js';
+import { devConfigureOutputSchema, loadDevMapping, saveDevMapping, } from '../../api/dev-conventions.js';
+import { resolveActiveDevProfile } from './_shared.js';
+const inputSchema = z
+    .object({
+    tasksBoard: BoardIdSchema.optional(),
+    sprintsBoard: BoardIdSchema.optional(),
+    epicsBoard: BoardIdSchema.optional(),
+    bugsBoard: BoardIdSchema.optional(),
+    releasesBoard: BoardIdSchema.optional(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const anySet = value.tasksBoard !== undefined ||
+        value.sprintsBoard !== undefined ||
+        value.epicsBoard !== undefined ||
+        value.bugsBoard !== undefined ||
+        value.releasesBoard !== undefined;
+    if (!anySet) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'monday dev configure requires at least one of --tasks-board / --sprints-board / --epics-board / --bugs-board / --releases-board (run `monday dev discover` to auto-detect)',
+            path: [],
+        });
+    }
+});
+const DEV_NOT_CONFIGURED = 'dev_not_configured';
+export const devConfigureCommand = {
+    name: 'dev.configure',
+    summary: "Explicitly set Monday Dev board mappings on the active profile (alternative to `monday dev discover`)",
+    examples: [
+        'monday dev configure --tasks-board 987654 --sprints-board 987655',
+        'monday dev configure --epics-board 987656 --releases-board 987657',
+        'monday dev configure --tasks-board 987654 --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: devConfigureOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'dev', 'Monday Dev workflow shortcuts (cli-design §2.7 — convention, not API)');
+        noun
+            .command('configure')
+            .description(devConfigureCommand.summary)
+            .option('--tasks-board <bid>', 'Board ID for the Tasks board')
+            .option('--sprints-board <bid>', 'Board ID for the Sprints board')
+            .option('--epics-board <bid>', 'Board ID for the Epics board')
+            .option('--bugs-board <bid>', 'Board ID for the Bugs board')
+            .option('--releases-board <bid>', 'Board ID for the Releases board')
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...devConfigureCommand.examples.map((e) => `  ${e}`),
+            '',
+        ].join('\n'))
+            .action(async (rawOpts) => {
+            const opts = parseArgv(devConfigureCommand.inputSchema, rawOpts);
+            const profile = await resolveActiveDevProfile(ctx, program.opts());
+            // Load existing dev block (additive merge — preserves any
+            // slot the user supplied previously that this invocation
+            // doesn't touch). Missing dev block is a normal first-write
+            // case per round-1 P2-4 closure — `dev_not_configured`
+            // surfaces from doctor + workflow verbs, NOT from configure.
+            let existing;
+            try {
+                existing = await loadDevMapping(profile.name, profile.homeOptions);
+            }
+            catch (err) {
+                if (err instanceof ApiError &&
+                    err.code === DEV_NOT_CONFIGURED) {
+                    existing = {};
+                }
+                else {
+                    // Non-dev_not_configured errors bubble up; in production
+                    // `cli/program.ts`'s preAction hook surfaces `config_error`
+                    // on malformed TOML FIRST (it calls `loadProfilesConfig`
+                    // before the action runs), so this branch is defensive.
+                    /* c8 ignore next */
+                    throw err;
+                }
+            }
+            const next = { ...existing };
+            if (opts.tasksBoard !== undefined) {
+                next.tasks_board = opts.tasksBoard;
+            }
+            if (opts.sprintsBoard !== undefined) {
+                next.sprints_board = opts.sprintsBoard;
+            }
+            if (opts.epicsBoard !== undefined) {
+                next.epics_board = opts.epicsBoard;
+            }
+            if (opts.bugsBoard !== undefined) {
+                next.bugs_board = opts.bugsBoard;
+            }
+            if (opts.releasesBoard !== undefined) {
+                next.releases_board = opts.releasesBoard;
+            }
+            await saveDevMapping(profile.name, next, profile.homeOptions);
+            // Read back via loadDevMapping so the emitted envelope
+            // reflects what landed on disk (Codex M21 / M25 pattern —
+            // verify the write rather than echoing the input).
+            const stored = await loadDevMapping(profile.name, profile.homeOptions);
+            const output = {
+                profile: profile.name,
+                mapping: stored,
+            };
+            emitMutation({
+                ctx,
+                data: output,
+                schema: devConfigureCommand.outputSchema,
+                programOpts: program.opts(),
+                source: 'none',
+                cacheAgeSeconds: null,
+            });
+        });
+    },
+};
+//# sourceMappingURL=configure.js.map

package/dist/commands/dev/configure.js.map

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

package/dist/commands/dev/discover.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `monday dev discover [--apply]` — auto-detect Monday Dev board
+ * mappings + optionally apply them to the active profile
+ * (cli-design §4.3 + §11.3 + §13 v0.3 entry; v0.3-plan §3 M26).
+ *
+ * **Runtime body landed at M26a IMPL.** Walks the user's accessible
+ * boards via `discoverDevBoards`, applies the
+ * `buildDiscoverMappingFromMatches` collapse on the per-noun match
+ * results, and — when `--apply` is set — additively merges the
+ * heuristic findings into the active profile's
+ * `[profiles.<name>.dev]` block via `saveDevMapping`. Mirrors the
+ * M21 oauth-stub / M24 history-stub precedent — argv shape pinned
+ * at pre-flight, runtime body filled at IMPL.
+ *
+ * **Additive-merge semantics on `--apply`.** Heuristic findings are
+ * merged on top of any existing dev block (heuristic wins on slot
+ * conflict; unset slots in the heuristic result preserve existing
+ * values). This preserves user-configured slots the heuristic can't
+ * fill (e.g. a workspace with no `Sprints` board where the user set
+ * `sprints_board` manually).
+ *
+ * Idempotent: yes when `--apply` is not set (pure read). When
+ * `--apply` is set: idempotent on equal mappings (re-discovery
+ * against the same workspace shape rewrites the same block).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DevDiscoverOutput } from '../../api/dev-conventions.js';
+declare const inputSchema: z.ZodObject<{
+    apply: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const devDiscoverCommand: CommandModule<z.infer<typeof inputSchema>, DevDiscoverOutput>;
+export {};
+//# sourceMappingURL=discover.d.ts.map

package/dist/commands/dev/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../../src/commands/dev/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EAML,KAAK,iBAAiB,EAEvB,MAAM,8BAA8B,CAAC;AAGtC,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAIZ,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAC5C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,iBAAiB,CAmGlB,CAAC"}

package/dist/commands/dev/discover.js

@@ -0,0 +1,117 @@
+/**
+ * `monday dev discover [--apply]` — auto-detect Monday Dev board
+ * mappings + optionally apply them to the active profile
+ * (cli-design §4.3 + §11.3 + §13 v0.3 entry; v0.3-plan §3 M26).
+ *
+ * **Runtime body landed at M26a IMPL.** Walks the user's accessible
+ * boards via `discoverDevBoards`, applies the
+ * `buildDiscoverMappingFromMatches` collapse on the per-noun match
+ * results, and — when `--apply` is set — additively merges the
+ * heuristic findings into the active profile's
+ * `[profiles.<name>.dev]` block via `saveDevMapping`. Mirrors the
+ * M21 oauth-stub / M24 history-stub precedent — argv shape pinned
+ * at pre-flight, runtime body filled at IMPL.
+ *
+ * **Additive-merge semantics on `--apply`.** Heuristic findings are
+ * merged on top of any existing dev block (heuristic wins on slot
+ * conflict; unset slots in the heuristic result preserve existing
+ * values). This preserves user-configured slots the heuristic can't
+ * fill (e.g. a workspace with no `Sprints` board where the user set
+ * `sprints_board` manually).
+ *
+ * Idempotent: yes when `--apply` is not set (pure read). When
+ * `--apply` is set: idempotent on equal mappings (re-discovery
+ * against the same workspace shape rewrites the same block).
+ */
+import { z } from 'zod';
+import { ApiError } from '../../utils/errors.js';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { buildDiscoverMappingFromMatches, devDiscoverOutputSchema, discoverDevBoards, loadDevMapping, saveDevMapping, } from '../../api/dev-conventions.js';
+import { resolveActiveDevProfile } from './_shared.js';
+const inputSchema = z
+    .object({
+    apply: z.boolean().optional(),
+})
+    .strict();
+const DEV_NOT_CONFIGURED = 'dev_not_configured';
+export const devDiscoverCommand = {
+    name: 'dev.discover',
+    summary: 'Auto-detect Monday Dev board mappings (tasks/sprints/epics/releases/bugs) and optionally write them to the active profile',
+    examples: [
+        'monday dev discover',
+        'monday dev discover --apply',
+        'monday dev discover --json',
+    ],
+    idempotent: true,
+    inputSchema,
+    outputSchema: devDiscoverOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'dev', 'Monday Dev workflow shortcuts (cli-design §2.7 — convention, not API)');
+        noun
+            .command('discover')
+            .description(devDiscoverCommand.summary)
+            .option('--apply', "Write the detected mapping into the active profile's `[profiles.<name>.dev]` block. Without --apply, the command is a pure read and only prints the mapping.")
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...devDiscoverCommand.examples.map((e) => `  ${e}`),
+            '',
+        ].join('\n'))
+            .action(async (rawOpts) => {
+            const opts = parseArgv(devDiscoverCommand.inputSchema, rawOpts);
+            const apply = opts.apply ?? false;
+            const profile = await resolveActiveDevProfile(ctx, program.opts());
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await discoverDevBoards({ client });
+            const heuristicMapping = buildDiscoverMappingFromMatches(result.matches);
+            let finalMapping = heuristicMapping;
+            if (apply) {
+                let existing;
+                try {
+                    existing = await loadDevMapping(profile.name, profile.homeOptions);
+                }
+                catch (err) {
+                    if (err instanceof ApiError &&
+                        err.code === DEV_NOT_CONFIGURED) {
+                        // First-write case — no existing dev block. Round-1
+                        // P2-4 closure: dev discover doesn't surface
+                        // `dev_not_configured` for itself; absence is normal.
+                        existing = {};
+                    }
+                    else {
+                        // Non-dev_not_configured errors from `loadDevMapping`
+                        // bubble up to the runner's catch-all. In production,
+                        // the only realistic source is `config_error` on
+                        // malformed TOML, which `cli/program.ts`'s preAction
+                        // hook surfaces FIRST (it calls `loadProfilesConfig`
+                        // before the action runs); this branch is defensive.
+                        /* c8 ignore next */
+                        throw err;
+                    }
+                }
+                finalMapping = { ...existing, ...heuristicMapping };
+                await saveDevMapping(profile.name, finalMapping, profile.homeOptions);
+            }
+            const output = {
+                profile: profile.name,
+                mapping: finalMapping,
+                matches: result.matches,
+                applied: apply,
+            };
+            emitSuccess({
+                ctx,
+                data: output,
+                schema: devDiscoverCommand.outputSchema,
+                programOpts: program.opts(),
+                apiVersion,
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+            });
+        });
+    },
+};
+//# sourceMappingURL=discover.js.map

package/dist/commands/dev/discover.js.map

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

package/dist/commands/dev/doctor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `monday dev doctor` — diagnostics for the active profile's
+ * Monday Dev mapping (cli-design §4.3 + §5.9 + §11.3; v0.3-plan
+ * §3 M26).
+ *
+ * **Runtime body landed at M26a IMPL.** Loads the active profile's
+ * `[profiles.<name>.dev]` block (surfaces `dev_not_configured` if
+ * absent — per round-1 P2-4, this is the verb that DOES fire the
+ * code), hydrates every configured board via a single
+ * `boards(ids:)` call, then runs each of the 10
+ * `DEV_DOCTOR_CHECK_NAMES` checks in order. Surfaces per-check
+ * status as `ok` / `warn` / `fail` in `data.checks[]`; `summary`
+ * carries the roll-up counts.
+ *
+ * **Decision 2 closure (M26 pre-flight — doctor diagnostics).**
+ * The check-name vocabulary (10 entries post-round-1 Codex
+ * fix-ups; see `DEV_DOCTOR_CHECK_NAMES` in
+ * `src/api/dev-conventions.ts`) is pinned at the pre-flight +
+ * carries an additive-only contract (adding a check is
+ * non-breaking; removing or renaming is major). Per-check
+ * `details` shape is per-check additive — pinned at this IMPL
+ * commit alongside the runtime body of each check.
+ *
+ * **Exit-code policy.** The verb's exit code stays 0 regardless of
+ * per-check `fail_count` — `dev doctor`'s success is "diagnostics
+ * completed"; agents inspect `data.summary.fail_count` for drift.
+ * `dev_board_misconfigured` is reserved for the case where the
+ * doctor itself can't complete; the per-check-level `fail` entries
+ * surface in `data.checks[]` rather than as a top-level error.
+ *
+ * Idempotent: yes (pure read).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../types.js';
+import { type DevDoctorOutput } from '../../api/dev-conventions.js';
+declare const inputSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const devDoctorCommand: CommandModule<z.infer<typeof inputSchema>, DevDoctorOutput>;
+export {};
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/dev/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/dev/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAInE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAGtC,QAAA,MAAM,WAAW,iCAAwB,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAC1C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,eAAe,CAiEhB,CAAC"}

package/dist/commands/dev/doctor.js

@@ -0,0 +1,91 @@
+/**
+ * `monday dev doctor` — diagnostics for the active profile's
+ * Monday Dev mapping (cli-design §4.3 + §5.9 + §11.3; v0.3-plan
+ * §3 M26).
+ *
+ * **Runtime body landed at M26a IMPL.** Loads the active profile's
+ * `[profiles.<name>.dev]` block (surfaces `dev_not_configured` if
+ * absent — per round-1 P2-4, this is the verb that DOES fire the
+ * code), hydrates every configured board via a single
+ * `boards(ids:)` call, then runs each of the 10
+ * `DEV_DOCTOR_CHECK_NAMES` checks in order. Surfaces per-check
+ * status as `ok` / `warn` / `fail` in `data.checks[]`; `summary`
+ * carries the roll-up counts.
+ *
+ * **Decision 2 closure (M26 pre-flight — doctor diagnostics).**
+ * The check-name vocabulary (10 entries post-round-1 Codex
+ * fix-ups; see `DEV_DOCTOR_CHECK_NAMES` in
+ * `src/api/dev-conventions.ts`) is pinned at the pre-flight +
+ * carries an additive-only contract (adding a check is
+ * non-breaking; removing or renaming is major). Per-check
+ * `details` shape is per-check additive — pinned at this IMPL
+ * commit alongside the runtime body of each check.
+ *
+ * **Exit-code policy.** The verb's exit code stays 0 regardless of
+ * per-check `fail_count` — `dev doctor`'s success is "diagnostics
+ * completed"; agents inspect `data.summary.fail_count` for drift.
+ * `dev_board_misconfigured` is reserved for the case where the
+ * doctor itself can't complete; the per-check-level `fail` entries
+ * surface in `data.checks[]` rather than as a top-level error.
+ *
+ * Idempotent: yes (pure read).
+ */
+import { z } from 'zod';
+import { ensureSubcommand } from '../types.js';
+import { parseArgv } from '../parse-argv.js';
+import { emitSuccess } from '../emit.js';
+import { resolveClient } from '../../api/resolve-client.js';
+import { devDoctorOutputSchema, loadDevMapping, runDevDoctor, } from '../../api/dev-conventions.js';
+import { resolveActiveDevProfile } from './_shared.js';
+const inputSchema = z.object({}).strict();
+export const devDoctorCommand = {
+    name: 'dev.doctor',
+    summary: "Validate the active profile's Monday Dev mapping against current board shape (status columns, board_relation wiring, canonical labels)",
+    examples: ['monday dev doctor', 'monday dev doctor --json'],
+    idempotent: true,
+    inputSchema,
+    outputSchema: devDoctorOutputSchema,
+    attach: (program, ctx) => {
+        const noun = ensureSubcommand(program, 'dev', 'Monday Dev workflow shortcuts (cli-design §2.7 — convention, not API)');
+        noun
+            .command('doctor')
+            .description(devDoctorCommand.summary)
+            .addHelpText('after', [
+            '',
+            'Examples:',
+            ...devDoctorCommand.examples.map((e) => `  ${e}`),
+            '',
+        ].join('\n'))
+            .action(async (rawOpts) => {
+            parseArgv(devDoctorCommand.inputSchema, rawOpts);
+            const profile = await resolveActiveDevProfile(ctx, program.opts());
+            // loadDevMapping throws `dev_not_configured` when no
+            // `[profiles.<name>.dev]` block exists — doctor's contract
+            // requires a configured mapping to diagnose against.
+            const mapping = await loadDevMapping(profile.name, profile.homeOptions);
+            const { client, apiVersion } = resolveClient(ctx, program.opts());
+            const result = await runDevDoctor({
+                client,
+                profile: profile.name,
+                mapping,
+            });
+            const output = {
+                profile: profile.name,
+                mapping,
+                checks: result.checks,
+                summary: result.summary,
+            };
+            emitSuccess({
+                ctx,
+                data: output,
+                schema: devDoctorCommand.outputSchema,
+                programOpts: program.opts(),
+                apiVersion,
+                source: result.source,
+                cacheAgeSeconds: result.cacheAgeSeconds,
+                complexity: result.complexity,
+            });
+        });
+    },
+};
+//# sourceMappingURL=doctor.js.map

package/dist/commands/dev/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/commands/dev/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,YAAY,GAEb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAGzB;IACF,IAAI,EAAE,YAAY;IAClB,OAAO,EACL,wIAAwI;IAC1I,QAAQ,EAAE,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;IAC3D,UAAU,EAAE,IAAI;IAChB,WAAW;IACX,YAAY,EAAE,qBAAqB;IACnC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAC3B,OAAO,EACP,KAAK,EACL,uEAAuE,CACxE,CAAC;QACF,IAAI;aACD,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC;aACrC,WAAW,CACV,OAAO,EACP;YACE,EAAE;YACF,WAAW;YACX,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACA,MAAM,CAAC,KAAK,EAAE,OAAgB,EAAE,EAAE;YACjC,SAAS,CAAC,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,qDAAqD;YACrD,2DAA2D;YAC3D,qDAAqD;YACrD,MAAM,OAAO,GAAG,MAAM,cAAc,CAClC,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,WAAW,CACpB,CAAC;YAEF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,MAAM;gBACN,OAAO,EAAE,OAAO,CAAC,IAAI;gBACrB,OAAO;aACR,CAAC,CAAC;YAEH,MAAM,MAAM,GAAoB;gBAC9B,OAAO,EAAE,OAAO,CAAC,IAAI;gBACrB,OAAO;gBACP,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;YAEF,WAAW,CAAC;gBACV,GAAG;gBACH,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,gBAAgB,CAAC,YAAY;gBACrC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3B,UAAU;gBACV,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

package/dist/commands/dev/epic/items.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `monday dev epic items <eid>` — list the task items linked to
+ * a named epic (cli-design §4.3 + §5.9; v0.3-plan §3 M26b).
+ *
+ * **Runtime body landed at M26b IMPL.** Same shape as
+ * `dev sprint items` but operates against the `tasks_to_epics_relation`
+ * board_relation column (the M26a round-2 P2-3 fix replaced the
+ * epics↔releases relation with this one; epics ↔ tasks is the
+ * actually-consumed wiring at v0.3).
+ *
+ * **<eid> resolution.** Positional epic ID is an item ID on the
+ * epics board. `ItemIdSchema` validates the shape at the argv layer.
+ *
+ * Idempotent: yes (pure read).
+ */
+import { z } from 'zod';
+import { type CommandModule } from '../../types.js';
+import { type ProjectedItem } from '../../../api/item-projection.js';
+declare const inputSchema: z.ZodObject<{
+    epicId: z.core.$ZodBranded<z.ZodString, "ItemId", "out">;
+}, z.core.$strict>;
+export declare const devEpicItemsCommand: CommandModule<z.infer<typeof inputSchema>, readonly ProjectedItem[]>;
+export {};
+//# sourceMappingURL=items.d.ts.map

package/dist/commands/dev/epic/items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../../../src/commands/dev/epic/items.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAatE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAEzC,QAAA,MAAM,WAAW;;kBAIN,CAAC;AAIZ,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAC7C,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAC3B,SAAS,aAAa,EAAE,CAmGzB,CAAC"}