@factiii/stack 0.1.2

package/dist/utils/dns-validator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * DNS Validator
+ *
+ * Utilities for validating and resolving hostnames.
+ */
+/**
+ * Check if a hostname is resolvable
+ */
+export declare function isHostnameResolvable(hostname: string): Promise<boolean>;
+/**
+ * Generate common hostname variations to check
+ * e.g., "staging-api.domain.com" -> ["api-staging.domain.com", "staging.api.domain.com"]
+ */
+export declare function generateHostnameVariations(hostname: string): string[];
+/**
+ * Find a resolvable alternative hostname
+ */
+export declare function findResolvableAlternative(hostname: string): Promise<string | null>;
+//# sourceMappingURL=dns-validator.d.ts.map

package/dist/utils/dns-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns-validator.d.ts","sourceRoot":"","sources":["../../src/utils/dns-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBrE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB"}

package/dist/utils/dns-validator.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * DNS Validator
+ *
+ * Utilities for validating and resolving hostnames.
+ */
+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.isHostnameResolvable = isHostnameResolvable;
+exports.generateHostnameVariations = generateHostnameVariations;
+exports.findResolvableAlternative = findResolvableAlternative;
+const dns = __importStar(require("dns"));
+const dnsPromises = dns.promises;
+/**
+ * Check if a hostname is resolvable
+ */
+async function isHostnameResolvable(hostname) {
+    try {
+        await dnsPromises.lookup(hostname);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate common hostname variations to check
+ * e.g., "staging-api.domain.com" -> ["api-staging.domain.com", "staging.api.domain.com"]
+ */
+function generateHostnameVariations(hostname) {
+    const parts = hostname.split('.');
+    if (parts.length < 3)
+        return [];
+    const subdomain = parts[0];
+    const domain = parts.slice(1).join('.');
+    if (!subdomain)
+        return [];
+    const variations = [];
+    // Check for hyphenated subdomains
+    if (subdomain.includes('-')) {
+        const subParts = subdomain.split('-');
+        // Reverse order: "staging-api" -> "api-staging"
+        const reversed = [...subParts].reverse();
+        variations.push(`${reversed.join('-')}.${domain}`);
+        // Dot notation: "staging-api" -> "staging.api"
+        variations.push(`${subParts.join('.')}.${domain}`);
+    }
+    return variations;
+}
+/**
+ * Find a resolvable alternative hostname
+ */
+async function findResolvableAlternative(hostname) {
+    const variations = generateHostnameVariations(hostname);
+    for (const variation of variations) {
+        if (await isHostnameResolvable(variation)) {
+            return variation;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=dns-validator.js.map

package/dist/utils/dns-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns-validator.js","sourceRoot":"","sources":["../../src/utils/dns-validator.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASH,oDAOC;AAMD,gEAsBC;AAKD,8DAYC;AA3DD,yCAA2B;AAE3B,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;AAEjC;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,QAAgB;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,kCAAkC;IAClC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,gDAAgD;QAChD,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QACzC,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QACnD,+CAA+C;QAC/C,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,yBAAyB,CAC7C,QAAgB;IAEhB,MAAM,UAAU,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAExD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/env-validator.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Environment File Validator
+ *
+ * Utilities for parsing and validating .env files.
+ */
+import type { FactiiiConfig } from '../types/index.js';
+interface EnvVars {
+    [key: string]: string;
+}
+interface KeyComparison {
+    match: boolean;
+    missing: string[];
+    extra: string[];
+}
+interface EmptyCheck {
+    allFilled: boolean;
+    empty: string[];
+}
+interface PlaceholderInfo {
+    key: string;
+    value: string;
+}
+interface PlaceholderCheck {
+    hasPlaceholders: boolean;
+    placeholders: PlaceholderInfo[];
+}
+interface ProdDifferences {
+    changed: string[];
+    onlyLocal: string[];
+    onlyGitHub: string[];
+}
+interface GitHubSecrets {
+    PROD_ENVS?: EnvVars;
+}
+interface AutoConfig {
+    isStagingSecret?: boolean;
+    allowIdenticalEnvVars?: string[];
+}
+interface ConfigWithAuto extends FactiiiConfig {
+    auto?: AutoConfig;
+}
+interface EnvValidationResult {
+    devExists: boolean;
+    stagingExists: boolean;
+    prodExists: boolean;
+    prodLocal: boolean;
+    prodGitHub: boolean;
+    prodGitignored: boolean;
+    stagingGitignored: boolean;
+    keysMatch: boolean;
+    allFilled: boolean;
+    warnings: string[];
+    errors: string[];
+    dev: EnvVars | null;
+    staging: EnvVars | null;
+    prod: EnvVars | null;
+    prodGitHubData?: EnvVars;
+    prodDifferences?: ProdDifferences;
+}
+/**
+ * Parse .env file into key-value object
+ * @param filepath - Path to .env file
+ * @returns Parsed key-value pairs or null if file doesn't exist
+ */
+export declare function parseEnvFile(filepath: string): EnvVars | null;
+/**
+ * Check if value looks like a placeholder
+ * @param value - Environment variable value
+ */
+export declare function looksLikePlaceholder(value: string): boolean;
+/**
+ * Check if file is in .gitignore
+ * @param rootDir - Root directory
+ * @param filename - Filename to check
+ */
+export declare function isGitignored(rootDir: string, filename: string): boolean;
+/**
+ * Compare keys between two env objects
+ * @param expected - Expected keys (from .env.example)
+ * @param actual - Actual keys to validate
+ */
+export declare function compareEnvKeys(expected: EnvVars, actual: EnvVars): KeyComparison;
+/**
+ * Check if env values are filled (not empty)
+ * @param env - Environment variables
+ */
+export declare function checkValuesNotEmpty(env: EnvVars): EmptyCheck;
+/**
+ * Check for placeholder values
+ * @param env - Environment variables
+ */
+export declare function checkForPlaceholders(env: EnvVars): PlaceholderCheck;
+/**
+ * Compare values between environments
+ * @param env1 - First environment
+ * @param env2 - Second environment
+ * @returns Keys with matching values
+ */
+export declare function findMatchingValues(env1: EnvVars, env2: EnvVars): string[];
+/**
+ * Validate environment file setup
+ * @param rootDir - Root directory
+ * @param config - Parsed factiii.yml config
+ * @param githubSecrets - Optional GitHub secrets for comparison
+ */
+export declare function validateEnvFiles(rootDir: string, config?: ConfigWithAuto, githubSecrets?: GitHubSecrets | null): EnvValidationResult;
+export {};
+//# sourceMappingURL=env-validator.d.ts.map

package/dist/utils/env-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.d.ts","sourceRoot":"","sources":["../../src/utils/env-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,UAAU,OAAO;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,UAAU;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,UAAU,cAAe,SAAQ,aAAa;IAC5C,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA4B7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAY3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgCvE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAYhF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAa5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAanE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAUzE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,cAAqC,EAC7C,aAAa,GAAE,aAAa,GAAG,IAAW,GACzC,mBAAmB,CA6KrB"}

package/dist/utils/env-validator.js

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * Environment File Validator
+ *
+ * Utilities for parsing and validating .env files.
+ */
+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.parseEnvFile = parseEnvFile;
+exports.looksLikePlaceholder = looksLikePlaceholder;
+exports.isGitignored = isGitignored;
+exports.compareEnvKeys = compareEnvKeys;
+exports.checkValuesNotEmpty = checkValuesNotEmpty;
+exports.checkForPlaceholders = checkForPlaceholders;
+exports.findMatchingValues = findMatchingValues;
+exports.validateEnvFiles = validateEnvFiles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Parse .env file into key-value object
+ * @param filepath - Path to .env file
+ * @returns Parsed key-value pairs or null if file doesn't exist
+ */
+function parseEnvFile(filepath) {
+    if (!fs.existsSync(filepath)) {
+        return null;
+    }
+    const content = fs.readFileSync(filepath, 'utf8');
+    const env = {};
+    const lines = content.split('\n');
+    for (const line of lines) {
+        // Skip empty lines and comments
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        // Parse KEY=VALUE
+        const match = trimmed.match(/^([^=]+)=(.*)$/);
+        if (match) {
+            const key = match[1]?.trim();
+            const value = match[2]?.trim();
+            if (key) {
+                env[key] = value ?? '';
+            }
+        }
+    }
+    return env;
+}
+/**
+ * Check if value looks like a placeholder
+ * @param value - Environment variable value
+ */
+function looksLikePlaceholder(value) {
+    if (!value || value === '') {
+        return true;
+    }
+    return (value.includes('EXAMPLE') ||
+        value.includes('<FILL') ||
+        value.includes('your-') ||
+        value.includes('TODO') ||
+        value.includes('CHANGE_ME'));
+}
+/**
+ * Check if file is in .gitignore
+ * @param rootDir - Root directory
+ * @param filename - Filename to check
+ */
+function isGitignored(rootDir, filename) {
+    const gitignorePath = path.join(rootDir, '.gitignore');
+    if (!fs.existsSync(gitignorePath)) {
+        return false;
+    }
+    const gitignore = fs.readFileSync(gitignorePath, 'utf8');
+    const lines = gitignore.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        // Check exact match or pattern match
+        if (trimmed === filename) {
+            return true;
+        }
+        // Check pattern match (e.g., .env.* matches .env.prod)
+        if (trimmed.includes('*')) {
+            const pattern = trimmed.replace(/\*/g, '.*');
+            const regex = new RegExp(`^${pattern}$`);
+            if (regex.test(filename)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Compare keys between two env objects
+ * @param expected - Expected keys (from .env.example)
+ * @param actual - Actual keys to validate
+ */
+function compareEnvKeys(expected, actual) {
+    const expectedKeys = Object.keys(expected);
+    const actualKeys = Object.keys(actual);
+    const missing = expectedKeys.filter((key) => !actualKeys.includes(key));
+    const extra = actualKeys.filter((key) => !expectedKeys.includes(key));
+    return {
+        match: missing.length === 0 && extra.length === 0,
+        missing,
+        extra,
+    };
+}
+/**
+ * Check if env values are filled (not empty)
+ * @param env - Environment variables
+ */
+function checkValuesNotEmpty(env) {
+    const empty = [];
+    for (const [key, value] of Object.entries(env)) {
+        if (!value || value.trim() === '') {
+            empty.push(key);
+        }
+    }
+    return {
+        allFilled: empty.length === 0,
+        empty,
+    };
+}
+/**
+ * Check for placeholder values
+ * @param env - Environment variables
+ */
+function checkForPlaceholders(env) {
+    const placeholders = [];
+    for (const [key, value] of Object.entries(env)) {
+        if (looksLikePlaceholder(value)) {
+            placeholders.push({ key, value });
+        }
+    }
+    return {
+        hasPlaceholders: placeholders.length > 0,
+        placeholders,
+    };
+}
+/**
+ * Compare values between environments
+ * @param env1 - First environment
+ * @param env2 - Second environment
+ * @returns Keys with matching values
+ */
+function findMatchingValues(env1, env2) {
+    const matching = [];
+    for (const key of Object.keys(env1)) {
+        if (env2[key] && env1[key] === env2[key]) {
+            matching.push(key);
+        }
+    }
+    return matching;
+}
+/**
+ * Validate environment file setup
+ * @param rootDir - Root directory
+ * @param config - Parsed factiii.yml config
+ * @param githubSecrets - Optional GitHub secrets for comparison
+ */
+function validateEnvFiles(rootDir, config = {}, githubSecrets = null) {
+    const results = {
+        devExists: false,
+        stagingExists: false,
+        prodExists: false,
+        prodLocal: false,
+        prodGitHub: false,
+        prodGitignored: false,
+        stagingGitignored: false,
+        keysMatch: true,
+        allFilled: true,
+        warnings: [],
+        errors: [],
+        dev: null,
+        staging: null,
+        prod: null,
+    };
+    // Parse .env files
+    const devPath = path.join(rootDir, '.env.example');
+    const stagingPath = path.join(rootDir, '.env.staging');
+    const prodPath = path.join(rootDir, '.env.prod');
+    results.dev = parseEnvFile(devPath);
+    results.staging = parseEnvFile(stagingPath);
+    results.prod = parseEnvFile(prodPath);
+    results.devExists = results.dev !== null;
+    results.stagingExists = results.staging !== null;
+    results.prodLocal = results.prod !== null;
+    // Check if prod exists in GitHub
+    if (githubSecrets?.PROD_ENVS) {
+        results.prodGitHub = true;
+        results.prodGitHubData = githubSecrets.PROD_ENVS;
+    }
+    results.prodExists = results.prodLocal || results.prodGitHub;
+    // Critical: .env.example must exist
+    if (!results.devExists) {
+        results.errors.push('.env.example not found (required as template)');
+        return results;
+    }
+    // Critical: .env.staging must exist
+    if (!results.stagingExists) {
+        results.errors.push('.env.staging not found (required)');
+    }
+    // Warning: .env.prod missing (OK if in GitHub)
+    if (!results.prodExists) {
+        results.errors.push('.env.prod not found locally or in GitHub Secrets');
+    }
+    else if (!results.prodLocal && results.prodGitHub) {
+        results.warnings.push('.env.prod not local, using GitHub Secrets (OK for security)');
+    }
+    // Validate .gitignore
+    if (results.prodLocal) {
+        results.prodGitignored = isGitignored(rootDir, '.env.prod');
+        if (!results.prodGitignored) {
+            results.errors.push('.env.prod MUST be in .gitignore');
+        }
+    }
+    const isStagingSecret = config.auto?.isStagingSecret !== false; // default true
+    results.stagingGitignored = isGitignored(rootDir, '.env.staging');
+    if (isStagingSecret && !results.stagingGitignored) {
+        results.warnings.push('.env.staging not gitignored (isStagingSecret: true)');
+    }
+    // Validate staging keys match dev
+    if (results.stagingExists && results.dev && results.staging) {
+        const keyCompare = compareEnvKeys(results.dev, results.staging);
+        if (!keyCompare.match) {
+            results.keysMatch = false;
+            if (keyCompare.missing.length > 0) {
+                results.errors.push(`.env.staging missing keys: ${keyCompare.missing.join(', ')}`);
+            }
+            if (keyCompare.extra.length > 0) {
+                results.warnings.push(`.env.staging extra keys: ${keyCompare.extra.join(', ')}`);
+            }
+        }
+        // Check values not empty
+        const valueCheck = checkValuesNotEmpty(results.staging);
+        if (!valueCheck.allFilled) {
+            results.allFilled = false;
+            results.errors.push(`.env.staging empty values: ${valueCheck.empty.join(', ')}`);
+        }
+        // Check for placeholders
+        const placeholderCheck = checkForPlaceholders(results.staging);
+        if (placeholderCheck.hasPlaceholders) {
+            results.warnings.push(`.env.staging has placeholder values: ${placeholderCheck.placeholders.map((p) => p.key).join(', ')}`);
+        }
+    }
+    // Validate prod keys (local or GitHub)
+    const prodEnv = results.prodLocal ? results.prod : results.prodGitHubData;
+    if (prodEnv && results.dev) {
+        const keyCompare = compareEnvKeys(results.dev, prodEnv);
+        if (!keyCompare.match) {
+            results.keysMatch = false;
+            const source = results.prodLocal ? 'local' : 'GitHub';
+            if (keyCompare.missing.length > 0) {
+                results.errors.push(`.env.prod (${source}) missing keys: ${keyCompare.missing.join(', ')}`);
+            }
+            if (keyCompare.extra.length > 0) {
+                results.warnings.push(`.env.prod (${source}) extra keys: ${keyCompare.extra.join(', ')}`);
+            }
+        }
+        // Check values not empty
+        const valueCheck = checkValuesNotEmpty(prodEnv);
+        if (!valueCheck.allFilled) {
+            results.allFilled = false;
+            const source = results.prodLocal ? 'local' : 'GitHub';
+            results.errors.push(`.env.prod (${source}) empty values: ${valueCheck.empty.join(', ')}`);
+        }
+        // Check for placeholders
+        const placeholderCheck = checkForPlaceholders(prodEnv);
+        if (placeholderCheck.hasPlaceholders) {
+            const source = results.prodLocal ? 'local' : 'GitHub';
+            results.warnings.push(`.env.prod (${source}) has placeholder values: ${placeholderCheck.placeholders.map((p) => p.key).join(', ')}`);
+        }
+    }
+    // Compare staging vs prod values (should be different)
+    if (results.staging && prodEnv) {
+        const matching = findMatchingValues(results.staging, prodEnv);
+        const allowedIdentical = config.auto?.allowIdenticalEnvVars ?? [];
+        const actualWarnings = matching.filter((key) => !allowedIdentical.includes(key));
+        if (actualWarnings.length > 0) {
+            results.warnings.push(`Staging/prod values identical (should differ): ${actualWarnings.join(', ')}`);
+        }
+    }
+    // Compare local prod vs GitHub prod
+    if (results.prodLocal && results.prodGitHub && results.prod && results.prodGitHubData) {
+        const localKeys = Object.keys(results.prod);
+        const githubKeys = Object.keys(results.prodGitHubData);
+        const differences = [];
+        for (const key of localKeys) {
+            if (results.prod[key] !== results.prodGitHubData[key]) {
+                differences.push(key);
+            }
+        }
+        // Check for keys only in one or the other
+        const onlyLocal = localKeys.filter((k) => !githubKeys.includes(k));
+        const onlyGitHub = githubKeys.filter((k) => !localKeys.includes(k));
+        if (differences.length > 0 || onlyLocal.length > 0 || onlyGitHub.length > 0) {
+            results.warnings.push('Local .env.prod differs from GitHub PROD_ENVS');
+            results.prodDifferences = {
+                changed: differences,
+                onlyLocal,
+                onlyGitHub,
+            };
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=env-validator.js.map

package/dist/utils/env-validator.js.map

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

package/dist/utils/github-workflow-monitor.d.ts

@@ -0,0 +1,49 @@
+/**
+ * GitHub Workflow Monitor
+ *
+ * Utility for triggering GitHub Actions workflows and monitoring their progress.
+ * Uses GitHub CLI (gh) for authentication and API access.
+ */
+interface WorkflowRunStatus {
+    status: string;
+    conclusion: string;
+    url: string;
+}
+interface TriggerAndWatchResult {
+    success: boolean;
+    url?: string;
+    runId?: number;
+    error?: string;
+}
+interface StreamLogsResult {
+    success: boolean;
+    exitCode?: number;
+}
+declare class GitHubWorkflowMonitor {
+    constructor();
+    /**
+     * Check if GitHub CLI is installed and authenticated
+     */
+    private checkGhCli;
+    /**
+     * Trigger a workflow and return the run ID
+     *
+     * @param workflowFile - The workflow file name (e.g., 'factiii-scan-staging.yml')
+     * @param environment - Optional environment name (only used for workflows that accept inputs)
+     */
+    triggerWorkflow(workflowFile: string, environment?: string): Promise<number>;
+    /**
+     * Stream logs from a workflow run
+     */
+    streamLogs(runId: number): Promise<StreamLogsResult>;
+    /**
+     * Get the status of a workflow run
+     */
+    getRunStatus(runId: number): Promise<WorkflowRunStatus>;
+    /**
+     * Trigger a workflow and wait for completion with live logs
+     */
+    triggerAndWatch(workflowFile: string, environment?: string): Promise<TriggerAndWatchResult>;
+}
+export default GitHubWorkflowMonitor;
+//# sourceMappingURL=github-workflow-monitor.d.ts.map

package/dist/utils/github-workflow-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-workflow-monitor.d.ts","sourceRoot":"","sources":["../../src/utils/github-workflow-monitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,cAAM,qBAAqB;;IAKzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkBlB;;;;;OAKG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6ClF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuB1D;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe7D;;OAEG;IACG,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC;CAiClC;AAED,eAAe,qBAAqB,CAAC"}