@empline/preflight 1.0.20

package/dist/checks/runtime/missing-public-env-import.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Preflight: Ensure publicEnv usage has an import
+ *
+ * Guards against runtime errors like:
+ *   ReferenceError: publicEnv is not defined
+ * when someone uses `publicEnv.*` in a client file but forgets to import it.
+ *
+ * Rule:
+ * - For any client component ("use client" in first ~10 lines) OR any file under hooks/, if it
+ *   contains `publicEnv.` then it must include an import from "@/lib/public-env".
+ *
+ * Opt-out per file (rare): add `preflight:allow-missing-publicenv-import`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const findings_writer_1 = require("../../utils/findings-writer");
+// Check metadata
+exports.id = "runtime/missing-public-env-import";
+exports.name = "Missing Public Env Import";
+exports.category = "runtime";
+exports.blocking = false;
+exports.description = "Preflight: Ensure publicEnv usage has an import";
+exports.tags = ["runtime"];
+const WORKSPACE_ROOT = process.cwd();
+const ROOTS = ["app", "components", "contexts", "hooks"];
+const ALLOWED_EXTS = new Set([".ts", ".tsx", ".js", ".jsx"]);
+const ALLOW_COMMENT = "preflight:allow-missing-publicenv-import";
+function shouldSkipDirName(dirName) {
+    return (dirName === "node_modules" ||
+        dirName === ".next" ||
+        dirName === ".git" ||
+        dirName === "dist" ||
+        dirName === "build" ||
+        dirName === "coverage" ||
+        dirName === "test-results" ||
+        dirName === "reports" ||
+        dirName === "backups" ||
+        dirName === "scripts" ||
+        dirName === "prisma" ||
+        dirName === "__mocks__");
+}
+function collectFiles(dir, out) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (shouldSkipDirName(entry.name))
+                continue;
+            if (fullPath.includes(`${path.sep}app${path.sep}api${path.sep}`))
+                continue;
+            collectFiles(fullPath, out);
+            continue;
+        }
+        const ext = path.extname(entry.name);
+        if (!ALLOWED_EXTS.has(ext))
+            continue;
+        out.push(fullPath);
+    }
+}
+function hasUseClientDirective(fileContent) {
+    const lines = fileContent.split(/\r?\n/);
+    const firstLines = lines
+        .slice(0, 10)
+        .map((l) => l.trim())
+        .filter(Boolean);
+    return firstLines.some((l) => l === '"use client";' ||
+        l === "'use client';" ||
+        l === '"use client"' ||
+        l === "'use client'");
+}
+function hasPublicEnvImport(fileContent) {
+    // Allow any import style that resolves to @/lib/public-env
+    // Examples:
+    //   import { publicEnv } from "@/lib/public-env";
+    //   import { publicEnv } from '@/lib/public-env';
+    return /from\s+["']@\/lib\/public-env["']/.test(fileContent);
+}
+function analyzeFile(filePath) {
+    const content = fs.readFileSync(filePath, "utf8");
+    if (content.includes(ALLOW_COMMENT))
+        return [];
+    const rel = path.relative(WORKSPACE_ROOT, filePath);
+    const isHooksFile = rel.startsWith(`hooks${path.sep}`);
+    const isClientFile = hasUseClientDirective(content);
+    if (!isHooksFile && !isClientFile)
+        return [];
+    if (!/\bpublicEnv\s*\./.test(content))
+        return [];
+    if (hasPublicEnvImport(content))
+        return [];
+    const firstIdx = content.search(/\bpublicEnv\s*\./);
+    const loc = firstIdx >= 0 ? (0, findings_writer_1.indexToLineCol)(content, firstIdx) : undefined;
+    return [
+        {
+            file: rel.replaceAll(path.sep, "/"),
+            line: loc?.line,
+            column: loc?.col,
+            message: "Uses publicEnv.* but is missing import from '@/lib/public-env'",
+        },
+    ];
+}
+function run() {
+    const files = [];
+    for (const root of ROOTS) {
+        const abs = path.join(WORKSPACE_ROOT, root);
+        if (fs.existsSync(abs))
+            collectFiles(abs, files);
+    }
+    const findings = files.flatMap(analyzeFile);
+    (0, findings_writer_1.writeFindings)(findings.map((f) => ({
+        severity: "error",
+        message: f.message,
+        file: f.file,
+        range: {
+            startLine: f.line,
+            startColumn: f.column,
+        },
+    })));
+    if (findings.length === 0) {
+        console.log(`${console_chars_1.emoji.success} Preflight: publicEnv imports look good`);
+        return { errors: 0, warnings: 0 };
+    }
+    console.log(`${console_chars_1.emoji.error} Preflight: Found ${findings.length} file(s) using publicEnv without import`);
+    console.log('   Fix: add `import { publicEnv } from "@/lib/public-env";`.');
+    console.log("");
+    for (const f of findings) {
+        console.log(`- ${f.file}`);
+        console.log(`  ${f.message}`);
+    }
+    return { errors: findings.length, warnings: 0 };
+}
+if (require.main === module) {
+    const result = run();
+    process.exit(result.errors > 0 ? 1 : 0);
+}
+//# sourceMappingURL=missing-public-env-import.js.map

package/dist/checks/runtime/missing-public-env-import.js.map

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

package/dist/checks/runtime/node-deprecations.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env tsx
+/**
+ * Node Deprecations Preflight (Warning)
+ *
+ * Purpose:
+ * - Surface known Node.js deprecation sources early (during build), before they show up
+ *   as runtime warnings in dev servers / Playwright.
+ *
+ * Current focus:
+ * - DEP0169: url.parse() is deprecated. We currently see this emitted by Next.js internals.
+ *
+ * Notes:
+ * - We do NOT mutate node_modules.
+ * - This is warning-only because some deprecations are controlled by upstream (Next.js).
+ */
+export declare const id = "runtime/node-deprecations";
+export declare const name = "Node Deprecations";
+export declare const category = "runtime";
+export declare const blocking = false;
+export declare const description = "Node Deprecations Preflight (Warning)";
+export declare const tags: string[];
+//# sourceMappingURL=node-deprecations.d.ts.map

package/dist/checks/runtime/node-deprecations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-deprecations.d.ts","sourceRoot":"","sources":["../../../src/checks/runtime/node-deprecations.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AASH,eAAO,MAAM,EAAE,8BAA8B,CAAC;AAC9C,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,QAAQ,YAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,0CAA0C,CAAC;AACnE,eAAO,MAAM,IAAI,UAAc,CAAC"}

package/dist/checks/runtime/node-deprecations.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Node Deprecations Preflight (Warning)
+ *
+ * Purpose:
+ * - Surface known Node.js deprecation sources early (during build), before they show up
+ *   as runtime warnings in dev servers / Playwright.
+ *
+ * Current focus:
+ * - DEP0169: url.parse() is deprecated. We currently see this emitted by Next.js internals.
+ *
+ * Notes:
+ * - We do NOT mutate node_modules.
+ * - This is warning-only because some deprecations are controlled by upstream (Next.js).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "runtime/node-deprecations";
+exports.name = "Node Deprecations";
+exports.category = "runtime";
+exports.blocking = false;
+exports.description = "Node Deprecations Preflight (Warning)";
+exports.tags = ["runtime"];
+function safeReadText(filePath) {
+    try {
+        return node_fs_1.default.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function exists(filePath) {
+    try {
+        return node_fs_1.default.existsSync(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+function findNextUrlParseUsages() {
+    const candidates = [
+        "node_modules/next/dist/esm/server/lib/router-server.js",
+        "node_modules/next/dist/esm/server/lib/router-utils/resolve-routes.js",
+        "node_modules/next/dist/esm/server/lib/router-utils/setup-dev-bundler.js",
+        "node_modules/next/dist/esm/server/image-optimizer.js",
+    ];
+    const hits = [];
+    for (const rel of candidates) {
+        const abs = node_path_1.default.join(process.cwd(), rel);
+        if (!exists(abs))
+            continue;
+        const text = safeReadText(abs);
+        if (!text)
+            continue;
+        if (text.includes("url.parse(") || text.includes("nodeUrl.parse(")) {
+            hits.push({
+                kind: "next-url-parse",
+                message: "Next.js internal code contains url.parse() usage (triggers Node DEP0169 deprecation warnings).",
+                file: rel,
+            });
+        }
+    }
+    return hits;
+}
+function findSourceUrlParseUsages() {
+    const roots = ["app", "components", "contexts", "hooks", "lib", "scripts", "tests", "types"];
+    const hits = [];
+    const visit = (dir) => {
+        let entries = [];
+        try {
+            entries = node_fs_1.default.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const abs = node_path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "node_modules" || entry.name === ".next" || entry.name === "dist")
+                    continue;
+                visit(abs);
+                continue;
+            }
+            if (!/\.(ts|tsx|js|jsx|mjs|cjs)$/.test(entry.name))
+                continue;
+            const text = safeReadText(abs);
+            if (!text)
+                continue;
+            if (text.includes("url.parse(")) {
+                hits.push({
+                    kind: "source-url-parse",
+                    message: "Source code contains url.parse() usage (deprecated in Node; prefer new URL()).",
+                    file: node_path_1.default.relative(process.cwd(), abs).replace(/\\/g, "/"),
+                });
+            }
+        }
+    };
+    for (const root of roots) {
+        const abs = node_path_1.default.join(process.cwd(), root);
+        if (exists(abs))
+            visit(abs);
+    }
+    return hits;
+}
+function readNextVersion() {
+    const nextPkg = node_path_1.default.join(process.cwd(), "node_modules", "next", "package.json");
+    const raw = safeReadText(nextPkg);
+    if (!raw)
+        return null;
+    try {
+        const json = JSON.parse(raw);
+        return json.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(node_path_1.default.basename(__filename, ".ts"));
+    const nodeVersion = process.version;
+    const nextVersion = readNextVersion();
+    const findings = [...findSourceUrlParseUsages(), ...findNextUrlParseUsages()];
+    console.log("\n🧯 NODE DEPRECATIONS PREFLIGHT");
+    console.log((0, console_chars_1.createDivider)(80, "heavy"));
+    console.log(`Node: ${nodeVersion}${nextVersion ? ` | Next: ${nextVersion}` : ""}`);
+    if (findings.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No known deprecation patterns detected.`);
+        process.exit(0);
+    }
+    console.log(`${console_chars_1.emoji.warning} Warning: ${findings.length} potential deprecation sources found.\n`);
+    for (const f of findings.slice(0, 30)) {
+        console.log(`- ${f.message}${f.file ? `\n  at: ${f.file}` : ""}`);
+    }
+    if (findings.length > 30) {
+        console.log(`\n${console_chars_1.chars.ellipsis}and ${findings.length - 30} more.`);
+    }
+    const nextUrlParseCount = findings.filter((f) => f.kind === "next-url-parse").length;
+    if (nextUrlParseCount > 0) {
+        console.log("\nRecommended actions (DEP0169 url.parse):");
+        console.log("- If you can: upgrade Next.js to a version that removes url.parse().");
+        console.log("- Otherwise: pin Node to the project engine (see package.json) or LTS if newer Node emits extra warnings.");
+        console.log("- You can silence warnings locally with NODE_OPTIONS=--no-deprecation, but that hides signal rather than fixing root cause.");
+    }
+    // Warning-only preflight
+    process.exit(0);
+}
+void main();
+//# sourceMappingURL=node-deprecations.js.map

package/dist/checks/runtime/node-deprecations.js.map

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

package/dist/checks/runtime/node25-compatibility.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env tsx
+/**
+ * Node 25 Compatibility Preflight (Static)
+ *
+ * Goal:
+ * - Catch dependency engine ranges that explicitly exclude Node 25.
+ * - Runs fast and deterministically during build (after install).
+ *
+ * What it does:
+ * - Scans installed package.json files under pnpm's node_modules layout.
+ * - Flags packages whose `engines.node` appears capped below 25.
+ *
+ * Important:
+ * - This does NOT prove runtime compatibility.
+ * - It is an early warning system that catches obvious engine incompat.
+ *
+ * Usage:
+ *   pnpm -s tsx scripts/active/preflights/runtime/node25-compatibility.ts
+ *   pnpm -s tsx scripts/active/preflights/runtime/node25-compatibility.ts --mode=warn
+ *   pnpm -s tsx scripts/active/preflights/runtime/node25-compatibility.ts --blocking
+ */
+export declare const id = "runtime/node25-compatibility";
+export declare const name = "Node25 Compatibility";
+export declare const category = "runtime";
+export declare const blocking = false;
+export declare const description = "Node 25 Compatibility Preflight (Static)";
+export declare const tags: string[];
+//# sourceMappingURL=node25-compatibility.d.ts.map

package/dist/checks/runtime/node25-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node25-compatibility.d.ts","sourceRoot":"","sources":["../../../src/checks/runtime/node25-compatibility.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAaH,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAC3C,eAAO,MAAM,QAAQ,YAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,6CAA6C,CAAC;AACtE,eAAO,MAAM,IAAI,UAAc,CAAC"}

package/dist/checks/runtime/node25-compatibility.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Node 25 Compatibility Preflight (Static)
+ *
+ * Goal:
+ * - Catch dependency engine ranges that explicitly exclude Node 25.
+ * - Runs fast and deterministically during build (after install).
+ *
+ * What it does:
+ * - Scans installed package.json files under pnpm's node_modules layout.
+ * - Flags packages whose `engines.node` appears capped below 25.
+ *
+ * Important:
+ * - This does NOT prove runtime compatibility.
+ * - It is an early warning system that catches obvious engine incompat.
+ *
+ * Usage:
+ *   pnpm -s tsx scripts/active/preflights/runtime/node25-compatibility.ts
+ *   pnpm -s tsx scripts/active/preflights/runtime/node25-compatibility.ts --mode=warn
+ *   pnpm -s tsx scripts/active/preflights/runtime/node25-compatibility.ts --blocking
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const console_chars_1 = require("../../utils/console-chars");
+const glob_1 = require("glob");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const findings_writer_1 = require("../../utils/findings-writer");
+// Check metadata
+exports.id = "runtime/node25-compatibility";
+exports.name = "Node25 Compatibility";
+exports.category = "runtime";
+exports.blocking = false;
+exports.description = "Node 25 Compatibility Preflight (Static)";
+exports.tags = ["runtime"];
+function parseMode(argv) {
+    if (argv.includes("--blocking"))
+        return "blocking";
+    const modeArg = argv.find((a) => a.startsWith("--mode="));
+    if (modeArg) {
+        const value = modeArg.slice("--mode=".length).trim();
+        if (value === "warn")
+            return "warn";
+        if (value === "blocking")
+            return "blocking";
+    }
+    if (argv.includes("--warn"))
+        return "warn";
+    return "warn";
+}
+function normalizeSlashes(p) {
+    return p.replace(/\\/g, "/");
+}
+function safeReadJson(filePath) {
+    try {
+        const raw = node_fs_1.default.readFileSync(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function isEngineCappedBelow25(enginesNode) {
+    const raw = String(enginesNode ?? "").trim();
+    if (!raw)
+        return { capped: false, reason: "" };
+    const normalized = raw.replace(/\s+/g, " ").toLowerCase();
+    // Heuristic checks for explicit upper bounds below 25.
+    // Examples we want to catch:
+    // - ">=18 <25"
+    // - "<25"
+    // - "<=24"
+    // - "^24" / "~24" / "24.x" / "24"
+    // These are not exhaustive semver parsing, but catch the common patterns.
+    // Explicit upper bounds
+    if (/(^|\s|\|\|)<\s*25(\.|\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range has upper bound < 25" };
+    }
+    if (/(^|\s|\|\|)<=\s*24(\.|\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range has upper bound <= 24" };
+    }
+    if (/(^|\s|\|\|)<\s*24(\.|\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range has upper bound < 24" };
+    }
+    // Caret/tilde-major pinning that effectively caps below 25.
+    // Note: ^24 means <25, ~24 means <25.
+    if (/(^|\s|\|\|)\^\s*24(\.|\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range uses ^24 (caps below 25)" };
+    }
+    if (/(^|\s|\|\|)~\s*24(\.|\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range uses ~24 (caps below 25)" };
+    }
+    // Exact-ish pins (24.x, 24, =24, 24.*)
+    if (/(^|\s|\|\|)=\s*24(\.|\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range pins to 24" };
+    }
+    if (/(^|\s|\|\|)24\.x(\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range pins to 24.x" };
+    }
+    if (/(^|\s|\|\|)24\.\*(\s|$)/.test(normalized)) {
+        return { capped: true, reason: "engine range pins to 24.*" };
+    }
+    if (/(^|\s|\|\|)24(\s|$)/.test(normalized) && !/[<>=~^]/.test(normalized)) {
+        // Very conservative: a bare "24" is usually a pin.
+        return { capped: true, reason: "engine range appears pinned to 24" };
+    }
+    return { capped: false, reason: "" };
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(node_path_1.default.basename(__filename, ".ts"));
+    const mode = parseMode(process.argv.slice(2));
+    // Only meaningful after install.
+    const pnpmRoot = node_path_1.default.join(process.cwd(), "node_modules", ".pnpm");
+    if (!node_fs_1.default.existsSync(pnpmRoot)) {
+        console.log(`${console_chars_1.emoji.info} Node 25 compatibility check skipped (node_modules/.pnpm not found). Run after install.`);
+        process.exit(0);
+    }
+    const packageJsonPaths = await (0, glob_1.glob)([
+        "node_modules/.pnpm/*/node_modules/*/package.json",
+        // Scoped packages are nested one extra level: .../node_modules/@scope/name/package.json
+        "node_modules/.pnpm/*/node_modules/@*/*/package.json",
+    ], {
+        cwd: process.cwd(),
+        nodir: true,
+        windowsPathsNoEscape: true,
+        ignore: ["**/node_modules/.cache/**"],
+    });
+    const findings = [];
+    for (const relPath of packageJsonPaths) {
+        const absPath = node_path_1.default.join(process.cwd(), relPath);
+        const pkg = safeReadJson(absPath);
+        if (!pkg)
+            continue;
+        const name = String(pkg.name ?? "").trim();
+        const version = String(pkg.version ?? "").trim();
+        const enginesNode = String(pkg.engines?.node ?? "").trim();
+        if (!name || !version || !enginesNode)
+            continue;
+        // Ignore our own workspaces (workspace:* packages are not located in .pnpm typically,
+        // but keep this safe in case of linkage).
+        if (name.startsWith("@supercatch/"))
+            continue;
+        const { capped, reason } = isEngineCappedBelow25(enginesNode);
+        if (!capped)
+            continue;
+        findings.push({
+            name,
+            version,
+            enginesNode,
+            packageJsonPath: normalizeSlashes(relPath),
+            reason,
+        });
+    }
+    // De-dupe by name@version@enginesNode
+    const unique = new Map();
+    for (const f of findings) {
+        unique.set(`${f.name}@${f.version}::${f.enginesNode}`, f);
+    }
+    const results = Array.from(unique.values()).sort((a, b) => {
+        if (a.name !== b.name)
+            return a.name.localeCompare(b.name);
+        return a.version.localeCompare(b.version);
+    });
+    (0, findings_writer_1.writeFindings)(results.map((f) => ({
+        severity: mode === "blocking" ? "error" : "warning",
+        message: `${f.name}@${f.version}: engines.node '${f.enginesNode}' (${f.reason})`,
+        file: f.packageJsonPath,
+        range: { startLine: 1 },
+        code: "node25-engines",
+    })));
+    console.log("\n🧩 NODE 25 COMPATIBILITY PREFLIGHT");
+    console.log((0, console_chars_1.createDivider)(80, "heavy"));
+    if (results.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No installed dependencies appear to exclude Node 25 via engines.node`);
+        process.exit(0);
+    }
+    const header = mode === "blocking" ? `${console_chars_1.emoji.error}` : `${console_chars_1.emoji.warning}`;
+    const severityLabel = mode === "blocking" ? "Blocking" : "Warning";
+    console.log(`${header} ${severityLabel}: ${results.length} dependencies declare engines.node ranges that appear capped below 25.`);
+    console.log("These packages may break when running on Node 25 (or simply haven't declared support yet).\n");
+    for (const f of results.slice(0, 40)) {
+        console.log(`- ${f.name}@${f.version} (${f.reason})`);
+        console.log(`  engines.node: ${f.enginesNode}`);
+        console.log(`  at: ${f.packageJsonPath}`);
+    }
+    if (results.length > 40) {
+        console.log(`\n${console_chars_1.chars.ellipsis}and ${results.length - 40} more.`);
+    }
+    console.log("\nRecommended actions:");
+    console.log("- Upgrade the flagged packages (or their parents) to versions that support Node 25.");
+    console.log("- If the package works on Node 25 but engines are outdated, consider filing an upstream issue/PR.");
+    process.exit(mode === "blocking" ? 1 : 0);
+}
+void main();
+//# sourceMappingURL=node25-compatibility.js.map

package/dist/checks/runtime/node25-compatibility.js.map

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

package/dist/checks/runtime/process-stdio-usage.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env tsx
+/**
+ * Preflight: Unsafe process stdio usage in shared app code
+ *
+ * Catches runtime issues like:
+ *   TypeError: Cannot read properties of undefined (reading 'write')
+ * when client/edge bundles execute code that calls:
+ *   process.stdout.write(...)
+ *   process.stderr.write(...)
+ *
+ * Rule:
+ * - Disallow direct `process.(stdout|stderr).write(` in app-shared folders.
+ * - Allow opt-out per file via: `preflight:allow-process-stdio`
+ */
+export declare const id = "runtime/process-stdio-usage";
+export declare const name = "Process Stdio Usage";
+export declare const category = "runtime";
+export declare const blocking = false;
+export declare const description = "Preflight: Unsafe process stdio usage in shared app code";
+export declare const tags: string[];
+declare function run(): {
+    errors: number;
+    warnings: number;
+};
+export { run };
+//# sourceMappingURL=process-stdio-usage.d.ts.map

package/dist/checks/runtime/process-stdio-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-stdio-usage.d.ts","sourceRoot":"","sources":["../../../src/checks/runtime/process-stdio-usage.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAUH,eAAO,MAAM,EAAE,gCAAgC,CAAC;AAChD,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAC1C,eAAO,MAAM,QAAQ,YAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,6DAA6D,CAAC;AACtF,eAAO,MAAM,IAAI,UAAc,CAAC;AA8GhC,iBAAS,GAAG,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAsCnD;AAOD,OAAO,EAAE,GAAG,EAAE,CAAC"}