@empline/preflight 1.0.20

package/dist/checks/organization/preflight-progress-consistency.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Preflight Progress Consistency Validation
+ *
+ * Ensures all preflight workflow files use the consistent progress indicator pattern:
+ * - Real-time progress updates with `[X/Y] Running: CheckName`
+ * - Carriage return (`\r`) for in-place updates
+ * - Clear line before printing results
+ *
+ * This prevents drift where some workflows show progress and others don't.
+ *
+ * Pattern requirements:
+ * 1. Sequential workflows (execSync): Must use progress counter and \r updates
+ * 2. Parallel workflows (mapWithConcurrency): Must track in-progress checks with Set
+ *
+ * Usage:
+ *   tsx scripts/active/preflights/organization/preflight-progress-consistency.ts
+ */
+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 fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "organization/preflight-progress-consistency";
+exports.name = "Preflight Progress Consistency";
+exports.category = "organization";
+exports.blocking = false;
+exports.description = "Preflight Progress Consistency Validation";
+exports.tags = ["organization"];
+const WORKFLOW_DIR = "scripts/active/preflights/workflows";
+// Patterns that indicate proper progress implementation
+const SEQUENTIAL_PROGRESS_PATTERNS = [
+    /process\.stdout\.write\s*\(\s*[\s\S]*?\\r\$\{emoji\.hourglass\}/, // Progress indicator with \r and emoji.hourglass
+    /\[.*\/.*\].*Running:|progress.*Running:|Running:.*\$\{(check\.name|name)\}/, // [X/Y] Running: format (literal or via variable)
+    /process\.stdout\.write\s*\(\s*["']\\r["']\s*\+\s*["'] ["']/, // Clear line pattern
+];
+const PARALLEL_PROGRESS_PATTERNS = [
+    /inProgress\w*\.add\s*\(/, // Track in-progress checks
+    /inProgress\w*\.delete\s*\(/, // Remove completed checks
+    /updateProgress|updateBlockingProgress|updateSeoProgress|updateProgressStatus/, // Progress update function
+];
+// Files that should have progress indicators
+const WORKFLOW_FILES_REQUIRING_PROGRESS = [
+    "all.ts",
+    "commit.ts",
+    "critical.ts",
+    "deploy.ts",
+    "development.ts",
+    "pre-commit.ts",
+    "pre-deploy.ts",
+];
+// Files that are exempt (simple/utility workflows)
+const EXEMPT_FILES = [
+    "affected.ts", // Git-based, minimal checks
+    "dev.ts", // Wrapper for development.ts
+];
+function detectWorkflowType(content) {
+    const hasExecSync = /execSync\s*\(/.test(content);
+    const hasMapWithConcurrency = /mapWithConcurrency/.test(content);
+    const hasPromiseAll = /Promise\.all\s*\(/.test(content) && /async\s+\(\s*\w+\s*\)\s*=>/.test(content);
+    if (hasMapWithConcurrency || hasPromiseAll)
+        return "parallel";
+    if (hasExecSync)
+        return "sequential";
+    return "unknown";
+}
+function hasSequentialProgress(content, debug = false) {
+    // Must have at least 2 of the 3 patterns
+    let matches = 0;
+    for (const pattern of SEQUENTIAL_PROGRESS_PATTERNS) {
+        const result = pattern.test(content);
+        if (debug)
+            console.log(`  DEBUG: ${pattern} = ${result}`);
+        if (result)
+            matches++;
+    }
+    if (debug)
+        console.log(`  DEBUG: Total matches = ${matches}`);
+    return matches >= 2;
+}
+function hasParallelProgress(content) {
+    // Must have at least 2 of the patterns
+    let matches = 0;
+    for (const pattern of PARALLEL_PROGRESS_PATTERNS) {
+        if (pattern.test(content))
+            matches++;
+    }
+    return matches >= 2;
+}
+function validateWorkflowFile(filePath) {
+    const issues = [];
+    const fileName = path.basename(filePath);
+    const content = fs.readFileSync(filePath, "utf-8");
+    // Skip exempt files
+    if (EXEMPT_FILES.includes(fileName)) {
+        return issues;
+    }
+    // Skip files that don't run checks (just re-export or configure)
+    const hasChecksArray = /const\s+checks\s*[=:]/.test(content) ||
+        /CONSOLIDATED_MODULES/.test(content) ||
+        /SEO_CHECKS/.test(content);
+    if (!hasChecksArray) {
+        return issues;
+    }
+    const workflowType = detectWorkflowType(content);
+    if (workflowType === "sequential") {
+        if (!hasSequentialProgress(content)) {
+            issues.push({
+                file: filePath,
+                message: `Sequential workflow missing progress indicators. Required pattern: process.stdout.write(\`\\r${console_chars_1.emoji.hourglass} [\${i}/$\{total}] Running: \${name}\`)`,
+                severity: WORKFLOW_FILES_REQUIRING_PROGRESS.includes(fileName) ? "error" : "warning",
+            });
+        }
+    }
+    else if (workflowType === "parallel") {
+        if (!hasParallelProgress(content)) {
+            issues.push({
+                file: filePath,
+                message: `Parallel workflow missing progress tracking. Required: inProgressChecks Set + updateProgress function`,
+                severity: WORKFLOW_FILES_REQUIRING_PROGRESS.includes(fileName) ? "error" : "warning",
+            });
+        }
+    }
+    // Check for old-style progress (just emoji.hourglass without \r)
+    const hasOldStyleProgress = /console\.log\s*\(\s*`\$\{emoji\.hourglass\}/.test(content) &&
+        !/process\.stdout\.write/.test(content);
+    if (hasOldStyleProgress) {
+        issues.push({
+            file: filePath,
+            message: `Uses old-style progress (console.log). Migrate to process.stdout.write with \\r for real-time updates`,
+            severity: "warning",
+        });
+    }
+    return issues;
+}
+async function run() {
+    const errors = [];
+    const warnings = [];
+    console.log(`${console_chars_1.emoji.search} Validating preflight progress consistency...\n`);
+    // Find all workflow files
+    const workflowFiles = await (0, glob_1.glob)(`${WORKFLOW_DIR}/*.ts`);
+    let checkedCount = 0;
+    let issueCount = 0;
+    for (const file of workflowFiles) {
+        const issues = validateWorkflowFile(file);
+        checkedCount++;
+        for (const issue of issues) {
+            issueCount++;
+            const relativePath = path.relative(process.cwd(), issue.file);
+            const message = `${relativePath}: ${issue.message}`;
+            if (issue.severity === "error") {
+                errors.push(message);
+                console.log(`${console_chars_1.emoji.error} ${message}`);
+            }
+            else {
+                warnings.push(message);
+                console.log(`${console_chars_1.emoji.warning}  ${message}`);
+            }
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.chart} Checked ${checkedCount} workflow files`);
+    if (errors.length === 0 && warnings.length === 0) {
+        console.log(`${console_chars_1.emoji.success} All workflows use consistent progress indicators`);
+    }
+    return {
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+// CLI execution
+(async () => {
+    const result = await run();
+    if (!result.passed) {
+        console.log(`\n${console_chars_1.emoji.error} Preflight progress consistency check failed`);
+        console.log("\nRequired pattern for sequential workflows:");
+        console.log("  process.stdout.write(`\\r${emoji.hourglass} [${i}/${total}] Running: ${name}`.padEnd(80) + '\\r')");
+        console.log("\nRequired pattern for parallel workflows:");
+        console.log("  const inProgressChecks = new Set<string>()");
+        console.log("  inProgressChecks.add(name) / inProgressChecks.delete(name)");
+        console.log("  updateProgress() function with process.stdout.write");
+        process.exit(1);
+    }
+    if (result.warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  Preflight progress consistency passed with warnings`);
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.success} Preflight progress consistency check passed`);
+    process.exit(0);
+})();
+//# sourceMappingURL=preflight-progress-consistency.js.map

package/dist/checks/organization/preflight-progress-consistency.js.map

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

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

@@ -0,0 +1,19 @@
+#!/usr/bin/env tsx
+/**
+ * Preflight System Validation (BLOCKING)
+ *
+ * A "preflight for preflights" to keep the build pipeline:
+ * - Organized (no duplicate checks / duplicate paths)
+ * - Correct (referenced script files exist)
+ * - Efficient (avoid accidentally running the same expensive module twice)
+ *
+ * Scope is intentionally narrow and safe: this does NOT try to rewrite workflows,
+ * only validates invariants we care about.
+ */
+export declare const id = "organization/preflight-system-validation";
+export declare const name = "Preflight System Validation";
+export declare const category = "organization";
+export declare const blocking = true;
+export declare const description = "Preflight System Validation (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=preflight-system-validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-system-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/organization/preflight-system-validation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AASH,eAAO,MAAM,EAAE,6CAA6C,CAAC;AAC7D,eAAO,MAAM,IAAI,gCAAgC,CAAC;AAClD,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,2CAA2C,CAAC;AACpE,eAAO,MAAM,IAAI,UAAgC,CAAC"}