@rudderjs/cli 4.4.0 → 4.5.0

package/dist/doctor/built-in/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/runtime.ts"],"names":[],"mappings":""}

package/dist/doctor/built-in/runtime.js

@@ -0,0 +1,82 @@
+import net from 'node:net';
+import { execSync } from 'node:child_process';
+import { registerDoctorCheck } from '@rudderjs/console';
+import { getBootStatus } from '../boot-status.js';
+// ─── runtime:app-boot ─────────────────────────────────────
+//
+// The boot itself happens in the doctor command's --deep handler (BEFORE
+// runChecks runs); the check's only job is to surface the captured status.
+// This indirection means a boot crash doesn't blow up the orchestrator —
+// every subsequent runtime check still gets a chance to render, and we can
+// recognize "boot didn't happen" (status = null) as a "should never see"
+// signal (it'd mean the doctor command was invoked without --deep but
+// someone left needsBoot on a check by mistake).
+registerDoctorCheck({
+    id: 'runtime:app-boot',
+    category: 'runtime',
+    title: 'Application bootstrap',
+    needsBoot: true,
+    run() {
+        const status = getBootStatus();
+        if (!status) {
+            return {
+                status: 'warn',
+                message: 'boot was not attempted (internal — should not see this)',
+            };
+        }
+        if (status.ok) {
+            return { status: 'ok', message: `booted in ${status.durationMs.toFixed(0)}ms` };
+        }
+        return {
+            status: 'error',
+            message: `boot threw: ${(status.error ?? '').split('\n')[0]}`,
+            detail: status.error ?? '',
+            fix: 'Read the stack trace above — usually a missing env var, an unreachable service (DB / Redis / SMTP), or a provider whose dependency hasn\'t been registered. Run without `--deep` to see env/deps checks first.',
+        };
+    },
+});
+// ─── runtime:port-free ────────────────────────────────────
+function portInUseHolder(port) {
+    // `lsof` is preinstalled on macOS / most Linux. The Windows equivalent is
+    // `netstat -ano | findstr :3000` — we don't shell out there since this is
+    // a best-effort hint and Windows users have less to gain from a PID.
+    if (process.platform === 'win32')
+        return null;
+    try {
+        const out = execSync(`lsof -ti :${port}`, { stdio: ['ignore', 'pipe', 'ignore'], timeout: 1000 });
+        const pid = out.toString().trim().split('\n')[0];
+        return pid || null;
+    }
+    catch {
+        return null;
+    }
+}
+registerDoctorCheck({
+    id: 'runtime:port-free',
+    category: 'runtime',
+    title: 'PORT free',
+    needsBoot: true,
+    async run() {
+        const port = Number(process.env['PORT'] ?? 3000);
+        if (Number.isNaN(port) || port < 1 || port > 65535) {
+            return { status: 'warn', message: `PORT="${process.env['PORT']}" is not a valid number` };
+        }
+        const bound = await new Promise((resolve) => {
+            const server = net.createServer();
+            server.once('error', (err) => resolve({ ok: false, code: err.code ?? 'UNKNOWN' }));
+            server.once('listening', () => server.close(() => resolve({ ok: true })));
+            server.listen(port, '127.0.0.1');
+        });
+        if (bound.ok)
+            return { status: 'ok', message: `${port} available` };
+        if (bound.code === 'EADDRINUSE') {
+            const pid = portInUseHolder(port);
+            const fix = pid
+                ? `Stop the process: \`kill ${pid}\` (or set PORT=<other> in .env)`
+                : `Set PORT=<other> in .env, or free port ${port}`;
+            return { status: 'error', message: `${port} in use${pid ? ` (PID ${pid})` : ''}`, fix };
+        }
+        return { status: 'warn', message: `bind failed: ${bound.code}` };
+    },
+});
+//# sourceMappingURL=runtime.js.map

package/dist/doctor/built-in/runtime.js.map

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

package/dist/doctor/built-in/structure.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=structure.d.ts.map

package/dist/doctor/built-in/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/structure.ts"],"names":[],"mappings":""}

package/dist/doctor/built-in/structure.js

@@ -0,0 +1,93 @@
+import { registerDoctorCheck } from '@rudderjs/console';
+import { fileExists, readFileSafe, anyExists } from './_fs.js';
+registerDoctorCheck({
+    id: 'structure:bootstrap-app',
+    category: 'structure',
+    title: 'bootstrap/app.ts',
+    run() {
+        if (!fileExists('bootstrap/app.ts')) {
+            return {
+                status: 'error',
+                message: 'missing',
+                fix: 'Scaffold a fresh app via `pnpm create rudder@latest`, or write bootstrap/app.ts using Application.configure({...}).create()',
+            };
+        }
+        // Lexical-parse only — we deliberately don't import the module here
+        // (it boots providers and would defeat the skip-boot fast path).
+        const text = readFileSafe('bootstrap/app.ts') ?? '';
+        if (!/Application\.configure/.test(text)) {
+            return {
+                status: 'warn',
+                message: 'present but does not call Application.configure(…)',
+                fix: 'See docs/guide/bootstrap.md for the expected shape',
+            };
+        }
+        return { status: 'ok', message: 'parses' };
+    },
+});
+registerDoctorCheck({
+    id: 'structure:bootstrap-providers',
+    category: 'structure',
+    title: 'bootstrap/providers.ts',
+    run() {
+        if (!fileExists('bootstrap/providers.ts')) {
+            return {
+                status: 'error',
+                message: 'missing',
+                fix: 'Create bootstrap/providers.ts with `export default [...(await defaultProviders())]`',
+            };
+        }
+        const text = readFileSafe('bootstrap/providers.ts') ?? '';
+        if (!/export\s+default/.test(text)) {
+            return {
+                status: 'warn',
+                message: 'present but has no default export',
+                fix: 'bootstrap/providers.ts must `export default [...]`',
+            };
+        }
+        return { status: 'ok', message: 'has default export' };
+    },
+});
+registerDoctorCheck({
+    id: 'structure:routes',
+    category: 'structure',
+    title: 'routes/*',
+    run() {
+        const have = ['routes/web.ts', 'routes/api.ts', 'routes/console.ts'].filter(fileExists);
+        if (have.length === 0) {
+            return {
+                status: 'error',
+                message: 'no routes/* files found',
+                fix: 'Create at least one of routes/web.ts, routes/api.ts',
+            };
+        }
+        return { status: 'ok', message: have.join(', ') };
+    },
+});
+registerDoctorCheck({
+    id: 'structure:welcome-view',
+    category: 'structure',
+    title: 'Welcome view / index page',
+    run() {
+        // The scaffolder ships one of these depending on the recipe:
+        //   - Controller-view mode: app/Views/Welcome.* (with `export const route = '/'`)
+        //   - Vike-direct mode:     pages/index/+Page.*
+        const viewCandidates = [
+            'app/Views/Welcome.tsx', 'app/Views/Welcome.vue', 'app/Views/Welcome.jsx',
+            'app/Views/Welcome.ts', 'app/Views/Welcome.js', 'app/Views/Welcome.html',
+        ];
+        const pageCandidates = [
+            'pages/index/+Page.tsx', 'pages/index/+Page.vue', 'pages/index/+Page.jsx',
+            'pages/index/+Page.ts',
+        ];
+        if (anyExists(viewCandidates) || anyExists(pageCandidates)) {
+            return { status: 'ok', message: 'found' };
+        }
+        return {
+            status: 'warn',
+            message: 'no landing page found',
+            fix: 'Add app/Views/Welcome.tsx (with `export const route = \'/\'`) or pages/index/+Page.tsx',
+        };
+    },
+});
+//# sourceMappingURL=structure.js.map

package/dist/doctor/built-in/structure.js.map

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

package/dist/doctor/fixer.d.ts

@@ -0,0 +1,39 @@
+import type { DoctorCheck, DoctorResult } from '@rudderjs/console';
+import type { CheckOutcome } from './orchestrator.js';
+export interface FixOutcome {
+    id: string;
+    title: string;
+    /** Status of the check *before* the fixer ran. */
+    before: CheckOutcome['status'];
+    /** Status of the check *after* the fixer ran. */
+    after: DoctorResult['status'];
+    /** Did the user skip (declined the prompt)? */
+    skipped: boolean;
+    /** Fixer's own message ("ran prisma generate", "vendored 4 files", …). */
+    message: string;
+    /** If the fixer itself threw, the captured error. */
+    error?: string;
+    durationMs: number;
+}
+export interface FixOptions {
+    /** Skip prompts — assume yes. */
+    yes?: boolean;
+    /** Override the prompt for tests. Returns true → run, false → skip. */
+    prompt?: (check: DoctorCheck, outcome: CheckOutcome) => Promise<boolean> | boolean;
+}
+export interface FixResult {
+    outcomes: FixOutcome[];
+    /** How many fixers were eligible (failing + has fixer). */
+    eligible: number;
+    /** How many fixers actually ran (not skipped). */
+    applied: number;
+}
+/**
+ * Iterate outcomes from a fast-path doctor run, and for every failing check
+ * that declares a `fixer()`, prompt the user (unless `yes` is set) and run it.
+ *
+ * Fixers must be idempotent regenerate-style operations — a fixer that throws
+ * is caught and reported as a red fix outcome; doctor itself never crashes.
+ */
+export declare function applyFixes(outcomes: CheckOutcome[], opts?: FixOptions): Promise<FixResult>;
+//# sourceMappingURL=fixer.d.ts.map

package/dist/doctor/fixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixer.d.ts","sourceRoot":"","sources":["../../src/doctor/fixer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAQ,MAAM,CAAA;IAChB,KAAK,EAAK,MAAM,CAAA;IAChB,kDAAkD;IAClD,MAAM,EAAI,YAAY,CAAC,QAAQ,CAAC,CAAA;IAChC,iDAAiD;IACjD,KAAK,EAAK,YAAY,CAAC,QAAQ,CAAC,CAAA;IAChC,+CAA+C;IAC/C,OAAO,EAAG,OAAO,CAAA;IACjB,0EAA0E;IAC1E,OAAO,EAAG,MAAM,CAAA;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAI,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uEAAuE;IACvE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CACnF;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAG,UAAU,EAAE,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,EAAG,MAAM,CAAA;IACjB,kDAAkD;IAClD,OAAO,EAAI,MAAM,CAAA;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,GAAM,UAAe,GACxB,OAAO,CAAC,SAAS,CAAC,CA2DpB"}

package/dist/doctor/fixer.js

@@ -0,0 +1,80 @@
+import { getRegisteredChecks } from '@rudderjs/console';
+/**
+ * Iterate outcomes from a fast-path doctor run, and for every failing check
+ * that declares a `fixer()`, prompt the user (unless `yes` is set) and run it.
+ *
+ * Fixers must be idempotent regenerate-style operations — a fixer that throws
+ * is caught and reported as a red fix outcome; doctor itself never crashes.
+ */
+export async function applyFixes(outcomes, opts = {}) {
+    // Build an id → check map so we can find each fixer by outcome id.
+    const byId = new Map();
+    for (const c of getRegisteredChecks())
+        byId.set(c.id, c);
+    // Eligible = failed (warn|error) AND check declares a fixer.
+    const eligible = outcomes.filter(o => o.status !== 'ok' && byId.get(o.id)?.fixer);
+    if (eligible.length === 0) {
+        return { outcomes: [], eligible: 0, applied: 0 };
+    }
+    const promptFn = opts.prompt ?? (opts.yes ? () => true : defaultPrompt);
+    const fixOutcomes = [];
+    let applied = 0;
+    for (const outcome of eligible) {
+        const check = byId.get(outcome.id);
+        const fixer = check.fixer;
+        const accepted = await promptFn(check, outcome);
+        if (!accepted) {
+            fixOutcomes.push({
+                id: outcome.id,
+                title: outcome.title,
+                before: outcome.status,
+                after: outcome.status,
+                skipped: true,
+                message: 'skipped',
+                durationMs: 0,
+            });
+            continue;
+        }
+        const t0 = performance.now();
+        let result;
+        let error;
+        try {
+            result = await fixer();
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            result = { status: 'error', message: `fixer threw: ${msg}` };
+            error = msg;
+        }
+        applied++;
+        const fo = {
+            id: outcome.id,
+            title: outcome.title,
+            before: outcome.status,
+            after: result.status,
+            skipped: false,
+            message: result.message,
+            durationMs: performance.now() - t0,
+        };
+        if (error)
+            fo.error = error;
+        fixOutcomes.push(fo);
+    }
+    return { outcomes: fixOutcomes, eligible: eligible.length, applied };
+}
+/**
+ * Default interactive prompt — uses @clack/prompts. Lazy-imported so the
+ * test path can pass `prompt: () => true/false` without pulling clack into
+ * the test process at all.
+ */
+async function defaultPrompt(check, outcome) {
+    const { confirm, isCancel } = await import('@clack/prompts');
+    const result = await confirm({
+        message: `Apply fix for ${check.title}? (${outcome.message})`,
+        initialValue: true,
+    });
+    if (isCancel(result))
+        return false;
+    return result === true;
+}
+//# sourceMappingURL=fixer.js.map

package/dist/doctor/fixer.js.map

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

package/dist/doctor/load-package-checks.d.ts

@@ -0,0 +1,2 @@
+export declare function loadPackageChecks(): Promise<void>;
+//# sourceMappingURL=load-package-checks.d.ts.map

package/dist/doctor/load-package-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-package-checks.d.ts","sourceRoot":"","sources":["../../src/doctor/load-package-checks.ts"],"names":[],"mappings":"AAkCA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBvD"}

package/dist/doctor/load-package-checks.js

@@ -0,0 +1,53 @@
+/**
+ * Lazy-load doctor checks from installed framework packages.
+ *
+ * Only invoked when `rudder doctor` runs — checks are useless outside the
+ * doctor command, so paying the import cost on every CLI invocation would
+ * be wasteful.
+ *
+ * Each contributing package exports a `<package>/doctor` subpath whose
+ * import has the side effect of calling `registerDoctorCheck()` for its
+ * rules. Adding a new contributing package: append to PACKAGES_WITH_CHECKS
+ * AND ensure the package's `package.json#exports` declares the subpath.
+ *
+ * Resolution: imports resolve from `process.cwd()`, NOT from this file's
+ * location. The cli doesn't declare these packages as dependencies — the
+ * USER's app does, and pnpm's strict mode means cli's node_modules doesn't
+ * see them. createRequire'ing from the user's package.json fixes that.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+const PACKAGES_WITH_CHECKS = [
+    // Phase 3 first wave — every package here ships a `<package>/doctor`
+    // subpath whose side-effect import calls `registerDoctorCheck()` for its
+    // rules. The dynamic import is `tryImport`-wrapped below, so packages not
+    // installed in the user's app are silently skipped.
+    '@rudderjs/auth', '@rudderjs/session', '@rudderjs/hash',
+    '@rudderjs/orm-prisma', '@rudderjs/orm-drizzle',
+    '@rudderjs/cashier-paddle',
+    '@rudderjs/queue-bullmq', '@rudderjs/queue-inngest',
+    '@rudderjs/mail',
+    '@rudderjs/ai', '@rudderjs/mcp',
+    '@rudderjs/telescope', '@rudderjs/pulse', '@rudderjs/horizon',
+];
+export async function loadPackageChecks() {
+    // Resolve via direct path through the user's `node_modules/<pkg>/dist/doctor.js`,
+    // not `import('<pkg>/doctor')` — the `./doctor` subpath only ships an `import`
+    // condition (no `require`/`default`), which `createRequire().resolve()`
+    // refuses to match. Walking the symlink/file path bypasses the conditional
+    // exports machinery and works the same on pnpm (symlinked) and npm/yarn
+    // (flat node_modules). Documented as the ESM-only-peer resolution workaround.
+    await Promise.all(PACKAGES_WITH_CHECKS.map(async (pkg) => {
+        try {
+            const target = path.join(process.cwd(), 'node_modules', pkg, 'dist', 'doctor.js');
+            if (!fs.existsSync(target))
+                return;
+            await import(/* @vite-ignore */ pathToFileURL(target).href);
+        }
+        catch {
+            /* package not installed, or its doctor entry failed to load */
+        }
+    }));
+}
+//# sourceMappingURL=load-package-checks.js.map

package/dist/doctor/load-package-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-package-checks.js","sourceRoot":"","sources":["../../src/doctor/load-package-checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,MAAM,oBAAoB,GAAa;IACrC,qEAAqE;IACrE,yEAAyE;IACzE,0EAA0E;IAC1E,oDAAoD;IACpD,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB;IACvD,sBAAsB,EAAE,uBAAuB;IAC/C,0BAA0B;IAC1B,wBAAwB,EAAE,yBAAyB;IACnD,gBAAgB;IAChB,cAAc,EAAE,eAAe;IAC/B,qBAAqB,EAAE,iBAAiB,EAAE,mBAAmB;CAC9D,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,kFAAkF;IAClF,+EAA+E;IAC/E,wEAAwE;IACxE,2EAA2E;IAC3E,wEAAwE;IACxE,8EAA8E;IAC9E,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;YACjF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAM;YAClC,MAAM,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/doctor/orchestrator.d.ts

@@ -0,0 +1,34 @@
+import type { DoctorStatus } from '@rudderjs/console';
+export interface CheckOutcome {
+    id: string;
+    category: string;
+    title: string;
+    status: DoctorStatus;
+    message: string;
+    fix?: string;
+    detail?: string;
+    /** Wall-clock ms for the check's `run()`. */
+    durationMs: number;
+}
+export interface RunOptions {
+    /** If true, include checks marked `needsBoot: true`. */
+    deep?: boolean;
+    /** Filter checks by id substring (used by `--only` flag in future). */
+    filter?: string;
+}
+export interface RunResult {
+    outcomes: CheckOutcome[];
+    totalMs: number;
+    counts: {
+        ok: number;
+        warn: number;
+        error: number;
+    };
+}
+/**
+ * Collect every registered check, filter by `deep` / `filter`, run them
+ * concurrently within each category (categories run sequentially so the
+ * report renders in declared order).
+ */
+export declare function runChecks(opts?: RunOptions): Promise<RunResult>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/doctor/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/doctor/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAQ,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAK,MAAM,CAAA;IAChB,MAAM,EAAI,YAAY,CAAA;IACtB,OAAO,EAAG,MAAM,CAAA;IAChB,GAAG,CAAC,EAAM,MAAM,CAAA;IAChB,MAAM,CAAC,EAAG,MAAM,CAAA;IAChB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,IAAI,CAAC,EAAK,OAAO,CAAA;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAG,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,OAAO,EAAG,MAAM,CAAA;IAChB,MAAM,EAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACtD;AA6BD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA8BzE"}

package/dist/doctor/orchestrator.js

@@ -0,0 +1,65 @@
+import { getRegisteredChecks } from '@rudderjs/console';
+/**
+ * Run a single check. Thrown errors are caught and reported as red outcomes
+ * with the message `unhandled exception: <e.message>` so a single buggy check
+ * never crashes the doctor command itself.
+ */
+async function runOne(check) {
+    const t0 = performance.now();
+    let result;
+    try {
+        result = await check.run();
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        result = { status: 'error', message: `unhandled exception: ${msg}` };
+    }
+    const outcome = {
+        id: check.id,
+        category: check.category,
+        title: check.title,
+        status: result.status,
+        message: result.message,
+        durationMs: performance.now() - t0,
+    };
+    if (result.fix !== undefined)
+        outcome.fix = result.fix;
+    if (result.detail !== undefined)
+        outcome.detail = result.detail;
+    return outcome;
+}
+/**
+ * Collect every registered check, filter by `deep` / `filter`, run them
+ * concurrently within each category (categories run sequentially so the
+ * report renders in declared order).
+ */
+export async function runChecks(opts = {}) {
+    const t0 = performance.now();
+    const all = getRegisteredChecks().filter(c => {
+        if (!opts.deep && c.needsBoot)
+            return false;
+        // --only <substring> matches EITHER id OR category — `--only orm`
+        // catches `orm-prisma:db-connect` AND `orm-drizzle:schema`; `--only runtime`
+        // catches every `category: 'runtime'` check regardless of its package prefix.
+        if (opts.filter && !c.id.includes(opts.filter) && !c.category.includes(opts.filter))
+            return false;
+        return true;
+    });
+    // Group by category preserving first-seen order
+    const byCat = new Map();
+    for (const c of all) {
+        const list = byCat.get(c.category) ?? [];
+        list.push(c);
+        byCat.set(c.category, list);
+    }
+    const outcomes = [];
+    for (const [, checks] of byCat) {
+        const results = await Promise.all(checks.map(runOne));
+        outcomes.push(...results);
+    }
+    const counts = { ok: 0, warn: 0, error: 0 };
+    for (const o of outcomes)
+        counts[o.status]++;
+    return { outcomes, totalMs: performance.now() - t0, counts };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/doctor/orchestrator.js.map

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

package/dist/doctor/reporter.d.ts

@@ -0,0 +1,21 @@
+import type { RunResult } from './orchestrator.js';
+import type { FixResult } from './fixer.js';
+export interface ReportOptions {
+    /** Show `detail` blocks for every outcome (default: only on failure). */
+    verbose?: boolean;
+    /** Suppress ANSI colors (auto-detected via NO_COLOR or non-TTY). */
+    plain?: boolean;
+}
+/**
+ * Render a doctor report as one block of stdout-ready text. The caller is
+ * responsible for printing — keeps this unit pure for tests.
+ */
+export declare function renderReport(result: RunResult, opts?: ReportOptions): string;
+/** Map outcome counts to a process exit code: 0 if no errors, 1 otherwise. */
+export declare function exitCodeFor(result: RunResult): number;
+/**
+ * Render the per-fix outcomes from `applyFixes()` as a single block.
+ * Shows before → after status for each eligible check + a summary line.
+ */
+export declare function renderFixReport(result: FixResult, opts?: ReportOptions): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/doctor/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/doctor/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAoB3C,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oEAAoE;IACpE,KAAK,CAAC,EAAI,OAAO,CAAA;CAClB;AAeD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAqDhF;AAgBD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CA+CnF"}