@rudderjs/cli 4.4.0 → 4.6.0

package/dist/doctor/built-in/env-vars.js

@@ -0,0 +1,99 @@
+import { registerDoctorCheck } from '@rudderjs/console';
+import { readFileSafe, fileExists } from './_fs.js';
+/**
+ * Minimal `.env` parser — covers `KEY=value`, `KEY="value"`, comments, blanks.
+ * Doesn't expand `${VAR}` references; we only need to check declared keys.
+ */
+function parseEnvText(text) {
+    const out = new Map();
+    for (const rawLine of text.split('\n')) {
+        const line = rawLine.replace(/^\s+|\s+$/g, '');
+        if (!line || line.startsWith('#'))
+            continue;
+        const eq = line.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out.set(key, value);
+    }
+    return out;
+}
+registerDoctorCheck({
+    id: 'env:dotenv-loadable',
+    category: 'env',
+    title: '.env file',
+    run() {
+        if (!fileExists('.env')) {
+            const exampleHint = fileExists('.env.example')
+                ? 'Run `cp .env.example .env` and fill in the secrets'
+                : 'Create a .env file with your config (APP_KEY, AUTH_SECRET, etc.)';
+            return { status: 'error', message: 'missing', fix: exampleHint };
+        }
+        const text = readFileSafe('.env');
+        if (text === null) {
+            return { status: 'error', message: 'present but unreadable', fix: 'Check file permissions on .env' };
+        }
+        const parsed = parseEnvText(text);
+        return { status: 'ok', message: `parses (${parsed.size} keys)` };
+    },
+});
+registerDoctorCheck({
+    id: 'env:app-key',
+    category: 'env',
+    title: 'APP_KEY',
+    run() {
+        const v = process.env['APP_KEY'];
+        if (!v) {
+            return {
+                status: 'error',
+                message: 'unset',
+                fix: 'Generate a 32-byte base64 key (e.g. `node -e "console.log(require(\'crypto\').randomBytes(32).toString(\'base64\'))"`) and put it in .env',
+            };
+        }
+        // APP_KEY can be raw or base64-encoded. Accept either form, validate decoded length.
+        let decodedLen;
+        try {
+            decodedLen = Buffer.from(v, 'base64').length;
+        }
+        catch {
+            decodedLen = Buffer.byteLength(v);
+        }
+        if (decodedLen < 32) {
+            return {
+                status: 'warn',
+                message: `present but only ${decodedLen} bytes — needs ≥ 32 for AES-256`,
+                fix: 'Generate a fresh 32-byte key with `node -e "console.log(require(\'crypto\').randomBytes(32).toString(\'base64\'))"`',
+            };
+        }
+        return { status: 'ok', message: `set, ${decodedLen} bytes` };
+    },
+});
+registerDoctorCheck({
+    id: 'env:app-env',
+    category: 'env',
+    title: 'APP_ENV',
+    run() {
+        const v = process.env['APP_ENV'] ?? process.env['NODE_ENV'];
+        if (!v) {
+            return {
+                status: 'warn',
+                message: 'unset — defaults to "production" in many adapters',
+                fix: 'Add `APP_ENV=local` (or `dev`/`staging`/`production`) to .env',
+            };
+        }
+        const known = ['local', 'dev', 'development', 'test', 'staging', 'production'];
+        if (!known.includes(v)) {
+            return {
+                status: 'warn',
+                message: `non-standard value "${v}"`,
+                fix: `Use one of: ${known.join(', ')}`,
+            };
+        }
+        return { status: 'ok', message: v };
+    },
+});
+//# sourceMappingURL=env-vars.js.map

package/dist/doctor/built-in/env-vars.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Built-in doctor checks owned by `@rudderjs/cli`. Each module's side-effect
+ * import calls `registerDoctorCheck()` so the checks are visible to the
+ * orchestrator after `loadBuiltInChecks()` runs.
+ */
+import './node-version.js';
+import './package-manager.js';
+import './env-vars.js';
+import './structure.js';
+import './deps.js';
+import './runtime.js';
+export declare function loadBuiltInChecks(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/built-in/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,mBAAmB,CAAA;AAC1B,OAAO,sBAAsB,CAAA;AAC7B,OAAO,eAAe,CAAA;AACtB,OAAO,gBAAgB,CAAA;AACvB,OAAO,WAAW,CAAA;AAClB,OAAO,cAAc,CAAA;AAErB,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Built-in doctor checks owned by `@rudderjs/cli`. Each module's side-effect
+ * import calls `registerDoctorCheck()` so the checks are visible to the
+ * orchestrator after `loadBuiltInChecks()` runs.
+ */
+import './node-version.js';
+import './package-manager.js';
+import './env-vars.js';
+import './structure.js';
+import './deps.js';
+import './runtime.js';
+export function loadBuiltInChecks() {
+    // Module loading is sufficient — side-effect imports above call
+    // registerDoctorCheck() at module-init time. This function exists so the
+    // doctor command can force the imports (otherwise tree-shaking would
+    // drop them).
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/built-in/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,mBAAmB,CAAA;AAC1B,OAAO,sBAAsB,CAAA;AAC7B,OAAO,eAAe,CAAA;AACtB,OAAO,gBAAgB,CAAA;AACvB,OAAO,WAAW,CAAA;AAClB,OAAO,cAAc,CAAA;AAErB,MAAM,UAAU,iBAAiB;IAC/B,gEAAgE;IAChE,yEAAyE;IACzE,qEAAqE;IACrE,cAAc;AAChB,CAAC"}

package/dist/doctor/built-in/node-version.d.ts

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

package/dist/doctor/built-in/node-version.d.ts.map

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

package/dist/doctor/built-in/node-version.js

@@ -0,0 +1,72 @@
+import { registerDoctorCheck } from '@rudderjs/console';
+import { readJsonSafe } from './_fs.js';
+/**
+ * Loose semver `Major.Minor.Patch` parser — good enough to compare against a
+ * package.json `engines.node` range like `^20.19.0 || >=22.12.0`.
+ *
+ * We don't pull in `semver` because the CLI ships with the framework and
+ * pulling a 3rd-party parser for one comparison is wasteful. The range syntax
+ * we accept matches what create-rudder-app generates.
+ */
+function parseVersion(v) {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(v);
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+function cmp(a, b) {
+    for (let i = 0; i < 3; i++) {
+        const ai = a[i], bi = b[i];
+        if (ai !== bi)
+            return ai - bi;
+    }
+    return 0;
+}
+function matchesRange(version, range) {
+    // Handle `||` alternation
+    return range.split('||').some(part => matchesSingle(version, part.trim()));
+}
+function matchesSingle(version, range) {
+    // ^X.Y.Z — same major, >= X.Y.Z
+    let m = /^\^(\d+)\.(\d+)\.(\d+)$/.exec(range);
+    if (m) {
+        const target = [Number(m[1]), Number(m[2]), Number(m[3])];
+        return version[0] === target[0] && cmp(version, target) >= 0;
+    }
+    // >=X.Y.Z
+    m = /^>=\s*(\d+)\.(\d+)\.(\d+)$/.exec(range);
+    if (m) {
+        const target = [Number(m[1]), Number(m[2]), Number(m[3])];
+        return cmp(version, target) >= 0;
+    }
+    // Exact `X.Y.Z`
+    m = /^=?\s*(\d+)\.(\d+)\.(\d+)$/.exec(range);
+    if (m) {
+        const target = [Number(m[1]), Number(m[2]), Number(m[3])];
+        return cmp(version, target) === 0;
+    }
+    return false;
+}
+registerDoctorCheck({
+    id: 'env:node-version',
+    category: 'env',
+    title: 'Node version',
+    run() {
+        const pkg = readJsonSafe('package.json');
+        const range = pkg?.engines?.node;
+        const current = parseVersion(process.version);
+        if (!current) {
+            return { status: 'warn', message: `couldn't parse Node version "${process.version}"` };
+        }
+        if (!range) {
+            return { status: 'ok', message: `${process.version} (no engines.node constraint)` };
+        }
+        if (matchesRange(current, range)) {
+            return { status: 'ok', message: `${process.version} (matches ${range})` };
+        }
+        return {
+            status: 'error',
+            message: `${process.version} does not satisfy ${range}`,
+            fix: `Install a Node version matching ${range} (use \`nvm install\`, fnm, or asdf)`,
+        };
+    },
+});
+//# sourceMappingURL=node-version.js.map

package/dist/doctor/built-in/node-version.js.map

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

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

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

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

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

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

@@ -0,0 +1,55 @@
+import { registerDoctorCheck } from '@rudderjs/console';
+import { fileExists } from './_fs.js';
+function detect() {
+    const lockMap = [
+        ['pnpm-lock.yaml', 'pnpm'],
+        ['package-lock.json', 'npm'],
+        ['yarn.lock', 'yarn'],
+        ['bun.lockb', 'bun'],
+        ['bun.lock', 'bun'],
+    ];
+    const lockfiles = lockMap.filter(([f]) => fileExists(f)).map(([f]) => f);
+    const fromLockfile = lockfiles.length === 1
+        ? lockMap.find(([f]) => f === lockfiles[0])[1]
+        : null;
+    const ua = process.env['npm_config_user_agent'] ?? '';
+    const fromUserAgent = ua.startsWith('pnpm') ? 'pnpm' :
+        ua.startsWith('yarn') ? 'yarn' :
+            ua.startsWith('bun') ? 'bun' :
+                ua.startsWith('npm') ? 'npm' :
+                    null;
+    return { fromLockfile, fromUserAgent, lockfiles };
+}
+registerDoctorCheck({
+    id: 'env:package-manager',
+    category: 'env',
+    title: 'Package manager',
+    run() {
+        const d = detect();
+        if (d.lockfiles.length === 0) {
+            return {
+                status: 'error',
+                message: 'no lockfile found',
+                fix: 'Run your package manager install (e.g. `pnpm install`, `npm install`, `yarn install`)',
+            };
+        }
+        if (d.lockfiles.length > 1) {
+            return {
+                status: 'warn',
+                message: `multiple lockfiles present: ${d.lockfiles.join(', ')}`,
+                fix: `Pick one PM and delete the others — mixed lockfiles cause flaky installs`,
+            };
+        }
+        const pm = d.fromLockfile;
+        const ua = d.fromUserAgent;
+        if (ua && ua !== pm) {
+            return {
+                status: 'warn',
+                message: `lockfile is ${pm} but ran with ${ua}`,
+                fix: `Run with ${pm} (\`${pm} install\`, \`${pm} <script>\`) to match the lockfile`,
+            };
+        }
+        return { status: 'ok', message: `${pm} — lockfile present` };
+    },
+});
+//# sourceMappingURL=package-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../../src/doctor/built-in/package-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAWrC,SAAS,MAAM;IACb,MAAM,OAAO,GAAqD;QAChE,CAAC,gBAAgB,EAAM,MAAM,CAAC;QAC9B,CAAC,mBAAmB,EAAG,KAAK,CAAC;QAC7B,CAAC,WAAW,EAAW,MAAM,CAAC;QAC9B,CAAC,WAAW,EAAW,KAAK,CAAC;QAC7B,CAAC,UAAU,EAAY,KAAK,CAAC;KAC9B,CAAA;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACxE,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC;QACzC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,IAAI,CAAA;IAER,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAA;IACrD,MAAM,aAAa,GACjB,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAChC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAChC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC/B,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAE,CAAC,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,CAAA;IAEN,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,CAAA;AACnD,CAAC;AAED,mBAAmB,CAAC;IAClB,EAAE,EAAQ,qBAAqB;IAC/B,QAAQ,EAAE,KAAK;IACf,KAAK,EAAK,iBAAiB;IAC3B,GAAG;QACD,MAAM,CAAC,GAAG,MAAM,EAAE,CAAA;QAClB,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAG,OAAO;gBAChB,OAAO,EAAE,mBAAmB;gBAC5B,GAAG,EAAM,uFAAuF;aACjG,CAAA;QACH,CAAC;QACD,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,MAAM,EAAG,MAAM;gBACf,OAAO,EAAE,+BAA+B,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAChE,GAAG,EAAM,0EAA0E;aACpF,CAAA;QACH,CAAC;QACD,MAAM,EAAE,GAAG,CAAC,CAAC,YAAa,CAAA;QAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAA;QAC1B,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpB,OAAO;gBACL,MAAM,EAAG,MAAM;gBACf,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,EAAE;gBAC/C,GAAG,EAAM,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,oCAAoC;aACxF,CAAA;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAA;IAC9D,CAAC;CACF,CAAC,CAAA"}

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

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

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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"}