@empline/preflight 1.1.14 → 1.1.15

package/dist/checks/dependencies/dependency-health-monitor.d.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env tsx
+/**
+ * Dependency Health Monitor
+ *
+ * Lightweight, mostly-offline dependency checks intended for preflight usage.
+ *
+ * Goals:
+ * - Flag risky/non-reproducible version ranges (e.g. "*", "latest")
+ * - Flag disallowed dependency specifiers (e.g. git/file/link where undesired)
+ * - Provide lockfile duplication signals (same package resolved to many versions)
+ *
+ * Notes:
+ * - pnpm lockfile is YAML; we parse it using conservative line-based extraction
+ *   to avoid adding new deps just for YAML parsing.
+ */
+import type { PreflightResult } from "../../utils/preflight-runner";
+export declare const id = "dependencies/dependency-health-monitor";
+export declare const name = "Dependency Health Monitor";
+export declare const category = "dependencies";
+export declare const blocking = false;
+export declare const description = "Dependency Health Monitor";
+export declare const tags: string[];
+export type DependencyIssueSeverity = "error" | "warning" | "info";
+export interface DependencyIssue {
+    severity: DependencyIssueSeverity;
+    message: string;
+    dependencyName?: string;
+}
+export interface DependencyHealthMonitorOptions {
+    workspaceRoot?: string;
+    packageJsonPath?: string;
+    lockfilePath?: string;
+    checkVersionSpecifiers?: boolean;
+    checkLockfileDupes?: boolean;
+    maxDistinctVersionsWarning?: number;
+    maxDistinctVersionsError?: number;
+}
+export interface DependencyHealthReport {
+    issues: DependencyIssue[];
+    metrics: {
+        durationMs: number;
+        totalDirectDeps: number;
+        totalLockPackages: number;
+        packagesWithMultipleVersions: number;
+    };
+}
+export declare function runDependencyHealthMonitor(options?: DependencyHealthMonitorOptions): Promise<PreflightResult>;
+export declare function run(): Promise<PreflightResult>;
+//# sourceMappingURL=dependency-health-monitor.d.ts.map

package/dist/checks/dependencies/dependency-health-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-health-monitor.d.ts","sourceRoot":"","sources":["../../../src/checks/dependencies/dependency-health-monitor.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE,eAAO,MAAM,EAAE,2CAA2C,CAAC;AAC3D,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAChD,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,8BAA8B,CAAC;AACvD,eAAO,MAAM,IAAI,UAAmB,CAAC;AAErC,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,4BAA4B,EAAE,MAAM,CAAC;KACtC,CAAC;CACH;AA+GD,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,eAAe,CAAC,CAsJ1B;AAGD,wBAAsB,GAAG,6BAkCxB"}

package/dist/checks/dependencies/dependency-health-monitor.js

@@ -0,0 +1,323 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Dependency Health Monitor
+ *
+ * Lightweight, mostly-offline dependency checks intended for preflight usage.
+ *
+ * Goals:
+ * - Flag risky/non-reproducible version ranges (e.g. "*", "latest")
+ * - Flag disallowed dependency specifiers (e.g. git/file/link where undesired)
+ * - Provide lockfile duplication signals (same package resolved to many versions)
+ *
+ * Notes:
+ * - pnpm lockfile is YAML; we parse it using conservative line-based extraction
+ *   to avoid adding new deps just for YAML parsing.
+ */
+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.runDependencyHealthMonitor = runDependencyHealthMonitor;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "dependencies/dependency-health-monitor";
+exports.name = "Dependency Health Monitor";
+exports.category = "dependencies";
+exports.blocking = false;
+exports.description = "Dependency Health Monitor";
+exports.tags = ["dependencies"];
+const DEFAULTS = {
+    checkVersionSpecifiers: true,
+    checkLockfileDupes: true,
+    maxDistinctVersionsWarning: 2,
+    maxDistinctVersionsError: 5,
+};
+function readJsonFile(filePath) {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+}
+function getLastAtIndex(value) {
+    // Handles scoped packages like "@types/node@20.11.0" (last '@' splits version)
+    return value.lastIndexOf("@");
+}
+function splitNameAndVersion(nameAtVersion) {
+    const idx = getLastAtIndex(nameAtVersion);
+    if (idx <= 0 || idx === nameAtVersion.length - 1)
+        return null;
+    return {
+        name: nameAtVersion.slice(0, idx),
+        version: nameAtVersion.slice(idx + 1),
+    };
+}
+function extractPnpmLockPackageKeys(lockText) {
+    // pnpm-lock.yaml contains a top-level "packages:" section.
+    // lockfileVersion 9 (current) uses quoted keys like:
+    //   packages:
+    //
+    //     '@scope/name@1.2.3':
+    //     'react@19.2.3':
+    //
+    // Older pnpm lock formats may use:
+    //     /react@18.3.1:
+    //     /@scope/name@1.2.3:
+    //     /pkg@1.0.0(react@18.3.1):
+    //
+    // We conservatively extract both styles.
+    const keys = [];
+    const lines = lockText.split(/\r?\n/);
+    let inPackagesSection = false;
+    for (const line of lines) {
+        if (!inPackagesSection) {
+            if (line.trim() === "packages:") {
+                inPackagesSection = true;
+            }
+            continue;
+        }
+        // Exit when we hit another top-level section
+        if (/^[^\s]/.test(line))
+            break;
+        // Style A: two spaces, then quoted key
+        const quotedMatch = line.match(/^\s{2}['"]([^'"]+)['"]:\s*$/);
+        // Style B: two spaces, then /key
+        const slashMatch = line.match(/^\s{2}\/([^:]+):\s*$/);
+        const rawKey = quotedMatch?.[1] ?? slashMatch?.[1];
+        if (!rawKey)
+            continue;
+        if (!rawKey)
+            continue;
+        // Strip peer/dependency suffix in parentheses: "pkg@1.0.0(react@18...)" → "pkg@1.0.0"
+        const keyWithoutPeers = rawKey.split("(")[0] ?? rawKey;
+        keys.push(keyWithoutPeers);
+    }
+    return keys;
+}
+function toPreflightResult(report) {
+    const errors = [];
+    const warnings = [];
+    const info = [];
+    for (const issue of report.issues) {
+        const prefix = issue.dependencyName ? `[${issue.dependencyName}] ` : "";
+        const message = `${prefix}${issue.message}`;
+        if (issue.severity === "error")
+            errors.push(message);
+        else if (issue.severity === "warning")
+            warnings.push(message);
+        else
+            info.push(message);
+    }
+    return {
+        passed: errors.length === 0,
+        errors,
+        warnings,
+        info,
+        metrics: {
+            durationMs: report.metrics.durationMs,
+            totalDirectDeps: report.metrics.totalDirectDeps,
+            totalLockPackages: report.metrics.totalLockPackages,
+            packagesWithMultipleVersions: report.metrics.packagesWithMultipleVersions,
+        },
+    };
+}
+async function runDependencyHealthMonitor(options = {}) {
+    const startTime = Date.now();
+    const workspaceRoot = options.workspaceRoot ?? process.cwd();
+    const packageJsonPath = options.packageJsonPath ?? path.join(workspaceRoot, "package.json");
+    const lockfilePath = options.lockfilePath ?? path.join(workspaceRoot, "pnpm-lock.yaml");
+    const checkVersionSpecifiers = options.checkVersionSpecifiers ?? DEFAULTS.checkVersionSpecifiers;
+    const checkLockfileDupes = options.checkLockfileDupes ?? DEFAULTS.checkLockfileDupes;
+    const maxDistinctVersionsWarning = options.maxDistinctVersionsWarning ?? DEFAULTS.maxDistinctVersionsWarning;
+    const maxDistinctVersionsError = options.maxDistinctVersionsError ?? DEFAULTS.maxDistinctVersionsError;
+    const issues = [];
+    if (!fs.existsSync(packageJsonPath)) {
+        issues.push({
+            severity: "error",
+            message: `package.json not found at ${packageJsonPath}`,
+        });
+        const durationMs = Date.now() - startTime;
+        return toPreflightResult({
+            issues,
+            metrics: {
+                durationMs,
+                totalDirectDeps: 0,
+                totalLockPackages: 0,
+                packagesWithMultipleVersions: 0,
+            },
+        });
+    }
+    const pkg = readJsonFile(packageJsonPath);
+    const directDeps = {
+        ...(pkg.dependencies ?? {}),
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.optionalDependencies ?? {}),
+    };
+    if (checkVersionSpecifiers) {
+        for (const [depName, spec] of Object.entries(directDeps)) {
+            const trimmed = String(spec).trim();
+            // Common non-reproducible/risky specifiers
+            if (trimmed === "*" || trimmed.toLowerCase() === "latest") {
+                issues.push({
+                    severity: "error",
+                    dependencyName: depName,
+                    message: `Non-reproducible version specifier: ${spec}`,
+                });
+                continue;
+            }
+            // Disallow git/file/link by default (these can break reproducibility)
+            if (/^git\+/.test(trimmed) ||
+                /^git:/.test(trimmed) ||
+                /^https?:\/\//.test(trimmed) ||
+                /^file:/.test(trimmed) ||
+                /^link:/.test(trimmed)) {
+                issues.push({
+                    severity: "warning",
+                    dependencyName: depName,
+                    message: `Potentially non-reproducible dependency specifier: ${spec}`,
+                });
+            }
+            // workspace:* is typically intentional in monorepos
+            if (/^workspace:/.test(trimmed)) {
+                issues.push({
+                    severity: "info",
+                    dependencyName: depName,
+                    message: `Workspace dependency: ${spec}`,
+                });
+            }
+        }
+    }
+    let totalLockPackages = 0;
+    let packagesWithMultipleVersions = 0;
+    if (checkLockfileDupes) {
+        if (!fs.existsSync(lockfilePath)) {
+            issues.push({
+                severity: "warning",
+                message: `pnpm lockfile not found at ${lockfilePath} (skipping lock health checks)`,
+            });
+        }
+        else {
+            const lockText = fs.readFileSync(lockfilePath, "utf-8");
+            const keys = extractPnpmLockPackageKeys(lockText);
+            totalLockPackages = keys.length;
+            const versionsByName = new Map();
+            for (const key of keys) {
+                const parsed = splitNameAndVersion(key);
+                if (!parsed)
+                    continue;
+                const set = versionsByName.get(parsed.name) ?? new Set();
+                set.add(parsed.version);
+                versionsByName.set(parsed.name, set);
+            }
+            for (const [name, versions] of versionsByName.entries()) {
+                if (versions.size <= 1)
+                    continue;
+                packagesWithMultipleVersions += 1;
+                const sortedVersions = Array.from(versions).sort();
+                const versionList = sortedVersions.slice(0, 5).join(", ");
+                const extra = sortedVersions.length > 5 ? ` (+${sortedVersions.length - 5} more)` : "";
+                if (versions.size >= maxDistinctVersionsError) {
+                    issues.push({
+                        severity: "error",
+                        dependencyName: name,
+                        message: `Resolved to ${versions.size} distinct versions in lockfile: ${versionList}${extra}`,
+                    });
+                }
+                else if (versions.size >= maxDistinctVersionsWarning) {
+                    issues.push({
+                        severity: "warning",
+                        dependencyName: name,
+                        message: `Resolved to ${versions.size} distinct versions in lockfile: ${versionList}${extra}`,
+                    });
+                }
+            }
+        }
+    }
+    const durationMs = Date.now() - startTime;
+    const report = {
+        issues,
+        metrics: {
+            durationMs,
+            totalDirectDeps: Object.keys(directDeps).length,
+            totalLockPackages,
+            packagesWithMultipleVersions,
+        },
+    };
+    return toPreflightResult(report);
+}
+// Export run function for framework compatibility
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    const result = await runDependencyHealthMonitor();
+    console.log("\n🧩 DEPENDENCY HEALTH MONITOR\n");
+    if (result.errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} ERRORS`);
+        for (const error of result.errors)
+            console.log(`- ${error}`);
+        console.log();
+    }
+    if (result.warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS`);
+        for (const warning of result.warnings)
+            console.log(`- ${warning}`);
+        console.log();
+    }
+    if (result.info && result.info.length > 0) {
+        console.log(`${console_chars_1.emoji.info}  INFO`);
+        for (const message of result.info)
+            console.log(`- ${message}`);
+        console.log();
+    }
+    if (result.metrics) {
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        console.log(`Duration: ${result.metrics.durationMs}ms`);
+        console.log(`Direct deps: ${result.metrics.totalDirectDeps}`);
+        console.log(`Lock packages: ${result.metrics.totalLockPackages}`);
+        console.log(`Multi-version packages: ${result.metrics.packagesWithMultipleVersions}`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+    }
+    return result;
+}
+// Allow direct execution
+if (require.main === module) {
+    run()
+        .then((result) => process.exit(result.passed ? 0 : 1))
+        .catch((err) => {
+        console.error("Error:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=dependency-health-monitor.js.map

package/dist/checks/dependencies/dependency-health-monitor.js.map

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

package/dist/checks/file-hygiene-validation.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env tsx
+/**
+ * File Hygiene Validation Preflight (BLOCKING)
+ *
+ * Catches file naming anti-patterns that indicate technical debt:
+ * 1. Version suffixes (-v2, -v3, etc.) - indicates unfinished migration
+ * 2. Temporary suffixes (-old, -backup, -new, -legacy, -deprecated)
+ * 3. Problematic route segments (/new/, /old/, /temp/) in app router
+ * 4. Duplicate/shadow files that should be consolidated
+ * 5. Case collisions (UserCard.tsx vs usercard.tsx)
+ * 6. Component/export name mismatches
+ * 7. Directory naming violations
+ *
+ * BLOCKING: Fails build if violations found (unless allowlisted).
+ *
+ * Usage:
+ *   pnpm preflight:file-hygiene              - BLOCKING mode
+ *   pnpm preflight:file-hygiene --warning    - Warning mode
+ *   pnpm preflight:file-hygiene --fix-preview - Show migration suggestions
+ *   pnpm preflight:file-hygiene --add-allowlist <file> - Add to allowlist
+ *   pnpm preflight:file-hygiene --check-duplicates - Check for duplicate filenames
+ *   pnpm preflight:file-hygiene --check-exports - Check component/export name match
+ */
+export declare const id = "misc/file-hygiene-validation";
+export declare const name = "File Hygiene Validation";
+export declare const category = "misc";
+export declare const blocking = true;
+export declare const description = "File Hygiene Validation Preflight (BLOCKING)";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=file-hygiene-validation.d.ts.map

package/dist/checks/file-hygiene-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-hygiene-validation.d.ts","sourceRoot":"","sources":["../../src/checks/file-hygiene-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAaH,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,iDAAiD,CAAC;AAC1E,eAAO,MAAM,IAAI,UAAwB,CAAC;AAo9B1C,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBzC"}