@empline/preflight 1.0.20

package/dist/checks/system/orphaned-scripts-detection.js

@@ -0,0 +1,335 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Orphaned Scripts Detection
+ *
+ * Detects scripts in scripts/active/ that are not referenced anywhere:
+ * - package.json scripts
+ * - Other scripts (imports)
+ * - CI workflows (.github/)
+ * - Documentation
+ *
+ * Usage:
+ *   pnpm preflight:orphaned-scripts          # Detect and report
+ *   pnpm preflight:orphaned-scripts --fix    # Move orphaned to scripts/archived/
+ *   pnpm preflight:orphaned-scripts --dry-run # Show what --fix would do
+ *
+ * Industry best practice: Run detection on every build, run --fix manually.
+ */
+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;
+const glob_1 = require("glob");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+// Check metadata
+exports.id = "system/orphaned-scripts-detection";
+exports.name = "Orphaned Scripts Detection";
+exports.category = "system";
+exports.blocking = false;
+exports.description = "Orphaned Scripts Detection";
+exports.tags = ["system"];
+const ARCHIVE_DIR = "scripts/archived";
+// Directories to skip (utilities, configs, etc.)
+const SKIP_DIRS = new Set(["utils", "config", "lib", "_shared", "node_modules", "dist"]);
+// Categories that are typically run manually and shouldn't be flagged
+const MANUAL_RUN_CATEGORIES = new Set([
+    "codemods", // One-time code transformations
+    "fixes", // Manual fix scripts
+    "maintenance", // Manual maintenance tasks
+    "remediations", // Manual remediation scripts
+    "migrations", // Database migrations
+]);
+// Files that are entry points and should never be flagged
+const ENTRY_POINTS = new Set(["index.ts", "index.js", "main.ts", "main.js"]);
+function isFixMode() {
+    return process.argv.includes("--fix");
+}
+function isDryRun() {
+    return process.argv.includes("--dry-run");
+}
+function isVerbose() {
+    return process.argv.includes("--verbose");
+}
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedGitHubWorkflowFiles = null;
+async function getGitHubWorkflowFiles() {
+    if (!_cachedGitHubWorkflowFiles) {
+        _cachedGitHubWorkflowFiles = await file_cache_1.fileCache.getGitHubWorkflowFiles();
+    }
+    return _cachedGitHubWorkflowFiles;
+}
+let _cachedScriptsActiveFiles = null;
+async function getScriptsActiveFiles() {
+    if (!_cachedScriptsActiveFiles) {
+        _cachedScriptsActiveFiles = await file_cache_1.fileCache.getScriptsActiveFiles();
+    }
+    return _cachedScriptsActiveFiles;
+}
+async function getReferenceSources() {
+    const sources = [];
+    // package.json
+    if (fs.existsSync("package.json")) {
+        sources.push({
+            name: "package.json",
+            content: fs.readFileSync("package.json", "utf-8"),
+        });
+    }
+    // CI workflows
+    const ciFiles = await getGitHubWorkflowFiles();
+    for (const file of ciFiles) {
+        sources.push({
+            name: file,
+            content: fs.readFileSync(file, "utf-8"),
+        });
+    }
+    // All TypeScript/JavaScript files (for imports)
+    const codeFiles = await (0, glob_1.glob)(["scripts/active/**/*.{ts,js,mjs}", "app/**/*.{ts,tsx}", "lib/**/*.{ts,tsx}"], {
+        windowsPathsNoEscape: true,
+        ignore: ["**/node_modules/**"],
+    });
+    for (const file of codeFiles) {
+        sources.push({
+            name: file,
+            content: fs.readFileSync(file, "utf-8"),
+        });
+    }
+    // Documentation
+    const docFiles = await (0, glob_1.glob)(["docs/**/*.md", "*.md", ".kiro/**/*.md"], {
+        windowsPathsNoEscape: true,
+    });
+    for (const file of docFiles) {
+        sources.push({
+            name: file,
+            content: fs.readFileSync(file, "utf-8"),
+        });
+    }
+    return sources;
+}
+function isScriptReferenced(scriptPath, sources) {
+    const normalized = scriptPath.replace(/\\/g, "/");
+    const basename = path.basename(scriptPath);
+    const basenameNoExt = basename.replace(/\.(ts|js|mjs)$/, "");
+    // Check various reference patterns
+    const patterns = [
+        normalized, // Full path
+        normalized.replace("scripts/active/", ""), // Relative from scripts/active
+        basename, // Just filename
+        basenameNoExt, // Filename without extension
+        `"${basenameNoExt}"`, // Quoted name (in package.json)
+        `'${basenameNoExt}'`, // Single quoted
+    ];
+    for (const source of sources) {
+        for (const pattern of patterns) {
+            if (source.content.includes(pattern)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+async function findOrphanedScripts() {
+    const orphaned = [];
+    // Get all scripts in active directory
+    const allScripts = await getScriptsActiveFiles();
+    const sources = await getReferenceSources();
+    const combinedContent = sources.map((s) => s.content).join("\n");
+    for (const file of allScripts) {
+        const relativePath = file.replace(/\\/g, "/");
+        const basename = path.basename(file);
+        // Skip entry points
+        if (ENTRY_POINTS.has(basename))
+            continue;
+        // Skip utility directories
+        const dirName = path.dirname(relativePath).split("/").pop() || "";
+        if (SKIP_DIRS.has(dirName))
+            continue;
+        // Skip manual-run categories (codemods, fixes, etc.)
+        const category = relativePath.split("/")[2] || "root";
+        if (MANUAL_RUN_CATEGORIES.has(category))
+            continue;
+        // Check if referenced
+        if (!isScriptReferenced(relativePath, sources)) {
+            const content = fs.readFileSync(file, "utf-8");
+            const stats = fs.statSync(file);
+            const category = relativePath.split("/")[2] || "root"; // scripts/active/[category]/...
+            orphaned.push({
+                file,
+                relativePath,
+                lines: content.split("\n").length,
+                lastModified: stats.mtime,
+                category,
+            });
+        }
+    }
+    // Sort by category, then by lines (largest first)
+    orphaned.sort((a, b) => {
+        if (a.category !== b.category)
+            return a.category.localeCompare(b.category);
+        return b.lines - a.lines;
+    });
+    return orphaned;
+}
+function archiveScript(script, dryRun) {
+    const targetDir = path.join(ARCHIVE_DIR, script.category);
+    const targetPath = path.join(targetDir, path.basename(script.file));
+    if (dryRun) {
+        console.log(`   [DRY-RUN] Would move: ${script.relativePath} ${console_chars_1.chars.arrow} ${targetPath}`);
+        return true;
+    }
+    try {
+        // Create target directory if needed
+        if (!fs.existsSync(targetDir)) {
+            fs.mkdirSync(targetDir, { recursive: true });
+        }
+        // Move file
+        fs.renameSync(script.file, targetPath);
+        console.log(`   ${console_chars_1.chars.check} Moved: ${script.relativePath} ${console_chars_1.chars.arrow} ${targetPath}`);
+        return true;
+    }
+    catch (err) {
+        console.error(`   ${console_chars_1.chars.cross} Failed to move ${script.relativePath}: ${err}`);
+        return false;
+    }
+}
+async function main() {
+    const fixMode = isFixMode();
+    const dryRun = isDryRun();
+    const verbose = isVerbose();
+    console.log(`\n${console_chars_1.emoji.search} ORPHANED SCRIPTS DETECTION`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Mode: ${fixMode ? (dryRun ? "dry-run" : "fix") : "detect"}`);
+    console.log("Scanning scripts/active/ for unreferenced scripts...\n");
+    const orphaned = await findOrphanedScripts();
+    // Group by category
+    const byCategory = new Map();
+    for (const script of orphaned) {
+        if (!byCategory.has(script.category)) {
+            byCategory.set(script.category, []);
+        }
+        byCategory.get(script.category).push(script);
+    }
+    // Report findings
+    if (orphaned.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  ORPHANED SCRIPTS FOUND`);
+        console.log((0, console_chars_1.createDivider)(60, "heavy"));
+        const totalLines = orphaned.reduce((sum, s) => sum + s.lines, 0);
+        console.log(`\nTotal: ${orphaned.length} scripts (${totalLines} lines)\n`);
+        for (const [category, scripts] of [...byCategory.entries()].sort()) {
+            const categoryLines = scripts.reduce((sum, s) => sum + s.lines, 0);
+            console.log(`\n${console_chars_1.emoji.folder} ${category}/ (${scripts.length} scripts, ${categoryLines} lines)`);
+            for (const script of scripts.slice(0, verbose ? 100 : 10)) {
+                const age = Math.floor((Date.now() - script.lastModified.getTime()) / (1000 * 60 * 60 * 24));
+                console.log(`   ${path.basename(script.file).padEnd(45)} ${String(script.lines).padStart(4)} lines  ${age}d old`);
+            }
+            if (!verbose && scripts.length > 10) {
+                console.log(`   ... and ${scripts.length - 10} more`);
+            }
+        }
+        // Fix mode
+        if (fixMode) {
+            console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+            console.log(dryRun
+                ? `${console_chars_1.emoji.search} DRY-RUN: Showing what would be archived...`
+                : `${console_chars_1.emoji.database}  ARCHIVING ORPHANED SCRIPTS...`);
+            console.log((0, console_chars_1.createDivider)(60, "heavy"));
+            let moved = 0;
+            let failed = 0;
+            for (const script of orphaned) {
+                if (archiveScript(script, dryRun)) {
+                    moved++;
+                }
+                else {
+                    failed++;
+                }
+            }
+            console.log(`\n${dryRun ? "Would archive" : "Archived"}: ${moved} scripts`);
+            if (failed > 0) {
+                console.log(`Failed: ${failed} scripts`);
+            }
+            if (!dryRun && moved > 0) {
+                console.log(`\n${console_chars_1.emoji.hint} Next steps:`);
+                console.log("   1. Review archived scripts in scripts/archived/");
+                console.log("   2. Delete if truly obsolete, or restore if needed");
+                console.log("   3. Commit the changes");
+            }
+        }
+        else {
+            // Detection mode - provide recommendations
+            console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+            console.log(`${console_chars_1.emoji.hint} RECOMMENDATIONS`);
+            console.log((0, console_chars_1.createDivider)(60, "heavy"));
+            console.log("   1. Review each script to confirm it's truly unused");
+            console.log("   2. If needed, add reference in package.json or import it");
+            console.log("   3. If obsolete, run: pnpm preflight:orphaned-scripts --fix");
+            console.log("   4. Preview first with: pnpm preflight:orphaned-scripts --dry-run");
+        }
+        // Write report
+        const reportPath = "test-results/orphaned-scripts-report.json";
+        const reportDir = path.dirname(reportPath);
+        if (!fs.existsSync(reportDir)) {
+            fs.mkdirSync(reportDir, { recursive: true });
+        }
+        fs.writeFileSync(reportPath, JSON.stringify({
+            timestamp: new Date().toISOString(),
+            totalOrphaned: orphaned.length,
+            totalLines: totalLines,
+            byCategory: Object.fromEntries([...byCategory.entries()].map(([cat, scripts]) => [
+                cat,
+                scripts.map((s) => ({
+                    file: s.relativePath,
+                    lines: s.lines,
+                    lastModified: s.lastModified.toISOString(),
+                })),
+            ])),
+        }, null, 2));
+        console.log(`\n${console_chars_1.emoji.memo} Report: ${reportPath}`);
+        // Exit status - only block in detect mode (not fix mode)
+        if (!fixMode) {
+            console.log(`\n${console_chars_1.emoji.warning}  Orphaned scripts detected (non-blocking warning)`);
+        }
+    }
+    else {
+        console.log(`${console_chars_1.emoji.success} No orphaned scripts found!`);
+    }
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error} Preflight failed:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=orphaned-scripts-detection.js.map

package/dist/checks/system/orphaned-scripts-detection.js.map

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

package/dist/checks/system/preflight-command-validation.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env tsx
+/**
+ * Preflight Command Validation
+ *
+ * Comprehensive validation of preflight command hygiene. Ensures all preflight
+ * scripts are properly registered in package.json and all references are valid.
+ *
+ * BLOCKING CHECKS (exit code 1):
+ * - Broken script paths: package.json references non-existent files
+ * - Missing consolidated aliases: scripts in /consolidated/ without package.json entry
+ * - Orphaned scripts: scripts in key folders (workflows, system) without aliases
+ *
+ * WARNING CHECKS (exit code 0):
+ * - Duplicate aliases: same script registered under multiple names
+ * - Invalid references: documentation referencing non-existent commands
+ *
+ * Usage:
+ *   pnpm preflight:command-validation          # Run all checks
+ *   pnpm preflight:command-validation --verbose # Show detailed context
+ *   pnpm preflight:command-validation --suggest <cmd> # Get suggestions for a command
+ *
+ * Exit codes:
+ *   0 - All blocking checks pass (warnings may exist)
+ *   1 - Blocking issues found (must fix before deployment)
+ */
+export declare const id = "system/preflight-command-validation";
+export declare const name = "Preflight Command Validation";
+export declare const category = "system";
+export declare const blocking = true;
+export declare const description = "Preflight Command Validation";
+export declare const tags: string[];
+//# sourceMappingURL=preflight-command-validation.d.ts.map

package/dist/checks/system/preflight-command-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-command-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/system/preflight-command-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,eAAO,MAAM,EAAE,wCAAwC,CAAC;AACxD,eAAO,MAAM,IAAI,iCAAiC,CAAC;AACnD,eAAO,MAAM,QAAQ,WAAW,CAAC;AACjC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,iCAAiC,CAAC;AAC1D,eAAO,MAAM,IAAI,UAA0B,CAAC"}