@factiii/stack 0.1.6 → 0.1.8

package/dist/plugins/pipelines/aws/scanfix/credentials.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * AWS Credential Fixes
+ *
+ * Handles AWS account setup guidance, credential validation,
+ * and region configuration checks.
+ */
+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.credentialsFixes = void 0;
+const aws_helpers_js_1 = require("../utils/aws-helpers.js");
+exports.credentialsFixes = [
+    // ============================================================
+    // DEV STAGE - AWS CLI and account setup
+    // ============================================================
+    {
+        id: 'aws-account-not-setup',
+        stage: 'dev',
+        severity: 'critical',
+        description: 'AWS CLI not installed or not configured',
+        scan: async (config, _rootDir) => {
+            // Only check if AWS pipeline is configured
+            const awsConfig = (0, aws_helpers_js_1.getAwsConfig)(config);
+            if (!awsConfig.accessKeyId && !config.aws)
+                return false;
+            // Check if AWS CLI is installed
+            if (!(0, aws_helpers_js_1.isAwsCliInstalled)())
+                return true;
+            // Check if credentials are configured (can call STS)
+            const accountId = (0, aws_helpers_js_1.getAwsAccountId)(awsConfig.region);
+            return !accountId;
+        },
+        fix: null,
+        manualFix: [
+            'Setup AWS CLI:',
+            '',
+            '1. Create an AWS account at https://aws.amazon.com (free tier available)',
+            '',
+            '2. Install AWS CLI:',
+            '   Windows: winget install Amazon.AWSCLI',
+            '   macOS:   brew install awscli',
+            '   Linux:   curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" && unzip awscliv2.zip && sudo ./aws/install',
+            '',
+            '3. Create an IAM user in AWS Console:',
+            '   IAM → Users → Create user → Attach AdministratorAccess policy',
+            '   → Security credentials → Create access key',
+            '',
+            '4. Configure AWS CLI:',
+            '   aws configure',
+            '   (Enter Access Key ID, Secret Access Key, region)',
+        ].join('\n'),
+    },
+    {
+        id: 'aws-region-configured',
+        stage: 'dev',
+        severity: 'warning',
+        description: 'AWS region not configured in factiii.yml',
+        scan: async (config, _rootDir) => {
+            // Only check if AWS pipeline is configured
+            const { extractEnvironments } = await Promise.resolve().then(() => __importStar(require('../../../../utils/config-helpers.js')));
+            const environments = extractEnvironments(config);
+            const hasAwsEnv = Object.values(environments).some((e) => e.pipeline === 'aws');
+            if (!hasAwsEnv && !config.aws)
+                return false;
+            const awsConfig = (0, aws_helpers_js_1.getAwsConfig)(config);
+            // Check if region is explicitly set (not just default)
+            return !awsConfig.region || awsConfig.region === 'us-east-1' && !config.aws?.region;
+        },
+        fix: null,
+        manualFix: 'Set aws.region in factiii.yml under the prod environment or top-level aws block',
+    },
+    // ============================================================
+    // SECRETS STAGE - Credential validation
+    // ============================================================
+    {
+        id: 'aws-credentials-missing',
+        stage: 'secrets',
+        severity: 'critical',
+        description: 'AWS credentials not available (env vars or Ansible Vault)',
+        scan: async (config, _rootDir) => {
+            // Only check if AWS pipeline is configured
+            const { extractEnvironments } = await Promise.resolve().then(() => __importStar(require('../../../../utils/config-helpers.js')));
+            const environments = extractEnvironments(config);
+            const hasAwsEnv = Object.values(environments).some((e) => e.pipeline === 'aws');
+            if (!hasAwsEnv && !config.aws)
+                return false;
+            // Check env vars
+            if (process.env.AWS_ACCESS_KEY_ID && process.env.AWS_SECRET_ACCESS_KEY) {
+                return false;
+            }
+            // Check if Ansible Vault has AWS credentials
+            if (config.ansible?.vault_path) {
+                try {
+                    const { AnsibleVaultSecrets } = await Promise.resolve().then(() => __importStar(require('../../../../utils/ansible-vault-secrets.js')));
+                    const vault = new AnsibleVaultSecrets({
+                        vault_path: config.ansible.vault_path,
+                        vault_password_file: config.ansible.vault_password_file,
+                    });
+                    const result = await vault.checkSecrets(['aws_access_key_id', 'aws_secret_access_key']);
+                    if (result.status?.aws_access_key_id && result.status?.aws_secret_access_key) {
+                        return false;
+                    }
+                }
+                catch {
+                    // Vault not accessible
+                }
+            }
+            return true;
+        },
+        fix: null,
+        manualFix: [
+            'Configure AWS credentials via one of:',
+            '',
+            '  Option A: Environment variables',
+            '    export AWS_ACCESS_KEY_ID=AKIA...',
+            '    export AWS_SECRET_ACCESS_KEY=...',
+            '',
+            '  Option B: AWS CLI configuration',
+            '    aws configure',
+            '',
+            '  Option C: Ansible Vault (recommended)',
+            '    Add aws_access_key_id and aws_secret_access_key to your vault file',
+            '    npx factiii secrets edit',
+        ].join('\n'),
+    },
+    {
+        id: 'aws-credentials-invalid',
+        stage: 'secrets',
+        severity: 'warning',
+        description: 'AWS credentials are invalid or expired',
+        scan: async (config, _rootDir) => {
+            // Only check if AWS CLI is installed and credentials exist
+            if (!(0, aws_helpers_js_1.isAwsCliInstalled)())
+                return false;
+            if (!process.env.AWS_ACCESS_KEY_ID && !process.env.AWS_SECRET_ACCESS_KEY) {
+                // No env vars - might be using aws configure or vault
+                // Try to validate anyway
+            }
+            const awsConfig = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const accountId = (0, aws_helpers_js_1.getAwsAccountId)(awsConfig.region);
+            // If we can't get account ID, credentials are invalid
+            // But only flag if we actually have credentials configured
+            if (!accountId) {
+                // Check if aws configure has credentials
+                try {
+                    const { execSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
+                    const result = execSync('aws configure get aws_access_key_id 2>/dev/null || echo ""', {
+                        encoding: 'utf8',
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    }).trim();
+                    // Only flag as invalid if credentials exist but don't work
+                    return result.length > 0;
+                }
+                catch {
+                    return false;
+                }
+            }
+            return false;
+        },
+        fix: null,
+        manualFix: 'Check AWS credentials: aws sts get-caller-identity\nIf expired, regenerate in AWS Console: IAM → Users → Security credentials',
+    },
+];
+//# sourceMappingURL=credentials.js.map

package/dist/plugins/pipelines/aws/scanfix/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/scanfix/credentials.ts"],"names":[],"mappings":"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"}

package/dist/plugins/pipelines/aws/scanfix/db-replication.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AWS DB Replication Fixes
+ *
+ * Prereq checks for DB replication between staging (Mac Mini) and prod (RDS).
+ * Ensures PostgreSQL client is available on EC2 and RDS is reachable.
+ *
+ * Actual sync commands are in the AWS pipeline index.ts as plugin commands:
+ * - `db sync-to-prod`: pg_dump Mac Mini → SCP to EC2 → pg_restore into RDS
+ * - `db sync-to-staging`: pg_dump RDS via EC2 → SCP to Mac Mini → pg_restore
+ */
+import type { Fix } from '../../../../types/index.js';
+export declare const dbReplicationFixes: Fix[];
+//# sourceMappingURL=db-replication.d.ts.map

package/dist/plugins/pipelines/aws/scanfix/db-replication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-replication.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/scanfix/db-replication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAiB,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAwCrE,eAAO,MAAM,kBAAkB,EAAE,GAAG,EAuFnC,CAAC"}

package/dist/plugins/pipelines/aws/scanfix/db-replication.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * AWS DB Replication Fixes
+ *
+ * Prereq checks for DB replication between staging (Mac Mini) and prod (RDS).
+ * Ensures PostgreSQL client is available on EC2 and RDS is reachable.
+ *
+ * Actual sync commands are in the AWS pipeline index.ts as plugin commands:
+ * - `db sync-to-prod`: pg_dump Mac Mini → SCP to EC2 → pg_restore into RDS
+ * - `db sync-to-staging`: pg_dump RDS via EC2 → SCP to Mac Mini → pg_restore
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dbReplicationFixes = void 0;
+const aws_helpers_js_1 = require("../utils/aws-helpers.js");
+/**
+ * Find RDS instance endpoint
+ */
+function findRdsEndpoint(projectName, region) {
+    const dbId = 'factiii-' + projectName + '-db';
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws rds describe-db-instances --db-instance-identifier ' + dbId +
+        ' --query "DBInstances[0].Endpoint.Address" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Check if AWS is configured for this project
+ */
+function isAwsConfigured(config) {
+    if (config.aws)
+        return true;
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { extractEnvironments } = require('../../../../utils/config-helpers.js');
+    const environments = extractEnvironments(config);
+    return Object.values(environments).some((e) => e.pipeline === 'aws');
+}
+/**
+ * Get prod environment config
+ */
+function getProdEnv(config) {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { extractEnvironments } = require('../../../../utils/config-helpers.js');
+    const environments = extractEnvironments(config);
+    return environments.prod ?? environments.production ?? null;
+}
+exports.dbReplicationFixes = [
+    {
+        id: 'aws-rds-ec2-pg-client-missing',
+        stage: 'prod',
+        severity: 'warning',
+        description: 'PostgreSQL client not installed on EC2 (needed for DB sync)',
+        scan: async (config) => {
+            if (!isAwsConfigured(config))
+                return false;
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            // Only check if RDS exists
+            const endpoint = findRdsEndpoint(projectName, region);
+            if (!endpoint)
+                return false;
+            // Check if pg_dump is available on EC2 via SSH
+            const prodEnv = getProdEnv(config);
+            if (!prodEnv?.domain || prodEnv.domain.startsWith('EXAMPLE-'))
+                return false;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { sshExec } = require('../../../../utils/ssh-helper.js');
+                const result = await sshExec(prodEnv, 'which pg_dump 2>/dev/null || echo "not_found"');
+                return result.trim() === 'not_found';
+            }
+            catch {
+                return false; // Can't SSH — skip
+            }
+        },
+        fix: async (config) => {
+            const prodEnv = getProdEnv(config);
+            if (!prodEnv?.domain) {
+                console.log('   Production domain not configured');
+                return false;
+            }
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { sshExec } = require('../../../../utils/ssh-helper.js');
+                console.log('   Installing PostgreSQL 15 client on EC2...');
+                await sshExec(prodEnv, 'sudo apt-get update -qq && sudo apt-get install -y postgresql-client-15');
+                console.log('   PostgreSQL client installed');
+                return true;
+            }
+            catch (e) {
+                console.log('   Failed to install pg client: ' + (e instanceof Error ? e.message : String(e)));
+                return false;
+            }
+        },
+        manualFix: 'SSH to EC2 and run: sudo apt-get install -y postgresql-client-15',
+    },
+    {
+        id: 'aws-rds-connectivity',
+        stage: 'prod',
+        severity: 'critical',
+        description: 'EC2 cannot connect to RDS (check security groups)',
+        scan: async (config) => {
+            if (!isAwsConfigured(config))
+                return false;
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            const endpoint = findRdsEndpoint(projectName, region);
+            if (!endpoint)
+                return false;
+            const prodEnv = getProdEnv(config);
+            if (!prodEnv?.domain || prodEnv.domain.startsWith('EXAMPLE-'))
+                return false;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const { sshExec } = require('../../../../utils/ssh-helper.js');
+                // Check if pg_isready is available first
+                const hasPg = await sshExec(prodEnv, 'which pg_isready 2>/dev/null || echo "not_found"');
+                if (hasPg.trim() === 'not_found')
+                    return false; // Can't test without pg client
+                const result = await sshExec(prodEnv, 'pg_isready -h ' + endpoint + ' -p 5432 2>&1');
+                return !result.includes('accepting connections');
+            }
+            catch {
+                return false;
+            }
+        },
+        fix: null,
+        manualFix: [
+            'EC2 cannot reach RDS. Check:',
+            '1. RDS security group allows port 5432 from EC2 security group',
+            '2. RDS is in the same VPC as EC2',
+            '3. RDS instance status is "available"',
+            '4. Test: ssh to EC2, run: pg_isready -h <rds-endpoint> -p 5432',
+        ].join('\n'),
+    },
+];
+//# sourceMappingURL=db-replication.js.map

package/dist/plugins/pipelines/aws/scanfix/db-replication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-replication.js","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/scanfix/db-replication.ts"],"names":[],"mappings":"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"}

package/dist/plugins/pipelines/aws/scanfix/ec2.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AWS EC2 Fixes
+ *
+ * Provisions EC2 key pair, instance, and Elastic IP.
+ * Uses Ubuntu 22.04 AMI, t2.micro (free tier), public subnet.
+ * Key pair private key is stored in Ansible Vault.
+ */
+import type { Fix } from '../../../../types/index.js';
+export declare const ec2Fixes: Fix[];
+//# sourceMappingURL=ec2.d.ts.map

package/dist/plugins/pipelines/aws/scanfix/ec2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ec2.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/pipelines/aws/scanfix/ec2.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAiB,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAmGrE,eAAO,MAAM,QAAQ,EAAE,GAAG,EA2LzB,CAAC"}

package/dist/plugins/pipelines/aws/scanfix/ec2.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * AWS EC2 Fixes
+ *
+ * Provisions EC2 key pair, instance, and Elastic IP.
+ * Uses Ubuntu 22.04 AMI, t2.micro (free tier), public subnet.
+ * Key pair private key is stored in Ansible Vault.
+ */
+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.ec2Fixes = void 0;
+const aws_helpers_js_1 = require("../utils/aws-helpers.js");
+/**
+ * Find VPC by factiii:project tag
+ */
+function findVpc(projectName, region) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-vpcs --filters "Name=tag:factiii:project,Values=' + projectName + '" --query "Vpcs[0].VpcId" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Find subnet by tag and type
+ */
+function findSubnet(projectName, region, type) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-subnets --filters "Name=tag:factiii:project,Values=' + projectName + '" "Name=tag:factiii:subnet-type,Values=' + type + '" --query "Subnets[0].SubnetId" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Find security group by name and VPC
+ */
+function findSecurityGroup(groupName, vpcId, region) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-security-groups --filters "Name=group-name,Values=' + groupName + '" "Name=vpc-id,Values=' + vpcId + '" --query "SecurityGroups[0].GroupId" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Find EC2 key pair by name
+ */
+function findKeyPair(keyName, region) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-key-pairs --key-names ' + keyName + ' --query "KeyPairs[0].KeyPairId" --output text', region);
+    return !!result && result !== 'None' && result !== 'null';
+}
+/**
+ * Find running EC2 instance by tag
+ */
+function findInstance(projectName, region) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-instances --filters "Name=tag:factiii:project,Values=' + projectName + '" "Name=instance-state-name,Values=running,stopped" --query "Reservations[0].Instances[0].InstanceId" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Find Elastic IP associated with an instance
+ */
+function findElasticIp(instanceId, region) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-addresses --filters "Name=instance-id,Values=' + instanceId + '" --query "Addresses[0].PublicIp" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Get latest Ubuntu 22.04 AMI for the region
+ */
+function getUbuntuAmi(region) {
+    const result = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-images --owners 099720109477 --filters "Name=name,Values=ubuntu/images/hvm-ssd/ubuntu-jammy-22.04-amd64-server-*" "Name=state,Values=available" --query "sort_by(Images, &CreationDate)[-1].ImageId" --output text', region);
+    if (!result || result === 'None' || result === 'null')
+        return null;
+    return result.replace(/"/g, '');
+}
+/**
+ * Check if AWS is configured for this project
+ */
+function isAwsConfigured(config) {
+    if (config.aws)
+        return true;
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { extractEnvironments } = require('../../../../utils/config-helpers.js');
+    const environments = extractEnvironments(config);
+    return Object.values(environments).some((e) => e.pipeline === 'aws');
+}
+exports.ec2Fixes = [
+    {
+        id: 'aws-keypair-missing',
+        stage: 'prod',
+        severity: 'critical',
+        description: 'EC2 key pair not created for SSH access',
+        scan: async (config) => {
+            if (!isAwsConfigured(config))
+                return false;
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            return !findKeyPair('factiii-' + projectName, region);
+        },
+        fix: async (config) => {
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            const keyName = 'factiii-' + projectName;
+            try {
+                // Create key pair — AWS returns the private key material
+                const result = (0, aws_helpers_js_1.awsExec)('aws ec2 create-key-pair --key-name ' + keyName + ' --key-type ed25519 --query "KeyMaterial" --output text', region);
+                // Save private key to ~/.ssh/prod_deploy_key
+                const os = await Promise.resolve().then(() => __importStar(require('os')));
+                const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+                const path = await Promise.resolve().then(() => __importStar(require('path')));
+                const sshDir = path.join(os.homedir(), '.ssh');
+                if (!fs.existsSync(sshDir)) {
+                    fs.mkdirSync(sshDir, { mode: 0o700 });
+                }
+                const keyPath = path.join(sshDir, 'prod_deploy_key');
+                fs.writeFileSync(keyPath, result + '\n', { mode: 0o600 });
+                console.log('   Created key pair: ' + keyName);
+                console.log('   Private key saved to: ' + keyPath);
+                // Store in Ansible Vault if configured
+                if (config.ansible?.vault_path) {
+                    console.log('   TIP: Add this key to Ansible Vault with: npx factiii secrets edit');
+                }
+                return true;
+            }
+            catch (e) {
+                console.log('   Failed to create key pair: ' + (e instanceof Error ? e.message : String(e)));
+                return false;
+            }
+        },
+        manualFix: 'Create key pair: aws ec2 create-key-pair --key-name factiii-{name} --key-type ed25519',
+    },
+    {
+        id: 'aws-ec2-instance-missing',
+        stage: 'prod',
+        severity: 'critical',
+        description: 'EC2 instance not created (Ubuntu 22.04, t2.micro)',
+        scan: async (config) => {
+            if (!isAwsConfigured(config))
+                return false;
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            return !findInstance(projectName, region);
+        },
+        fix: async (config) => {
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            const vpcId = findVpc(projectName, region);
+            if (!vpcId) {
+                console.log('   VPC must be created first');
+                return false;
+            }
+            const publicSubnet = findSubnet(projectName, region, 'public');
+            if (!publicSubnet) {
+                console.log('   Public subnet must be created first');
+                return false;
+            }
+            const ec2SgId = findSecurityGroup('factiii-' + projectName + '-ec2', vpcId, region);
+            if (!ec2SgId) {
+                console.log('   EC2 security group must be created first');
+                return false;
+            }
+            const keyName = 'factiii-' + projectName;
+            if (!findKeyPair(keyName, region)) {
+                console.log('   Key pair must be created first');
+                return false;
+            }
+            try {
+                // Get latest Ubuntu 22.04 AMI
+                const amiId = getUbuntuAmi(region);
+                if (!amiId) {
+                    console.log('   Failed to find Ubuntu 22.04 AMI for region ' + region);
+                    return false;
+                }
+                console.log('   Using AMI: ' + amiId);
+                // Launch instance
+                const instanceResult = (0, aws_helpers_js_1.awsExec)('aws ec2 run-instances' +
+                    ' --image-id ' + amiId +
+                    ' --instance-type t2.micro' +
+                    ' --key-name ' + keyName +
+                    ' --security-group-ids ' + ec2SgId +
+                    ' --subnet-id ' + publicSubnet +
+                    ' --count 1' +
+                    ' ' + (0, aws_helpers_js_1.tagSpec)('instance', projectName), region);
+                const instanceId = JSON.parse(instanceResult).Instances[0].InstanceId;
+                console.log('   Launched EC2 instance: ' + instanceId);
+                console.log('   Instance type: t2.micro (free tier eligible)');
+                console.log('   Waiting for instance to be running...');
+                // Wait for instance to be running
+                (0, aws_helpers_js_1.awsExec)('aws ec2 wait instance-running --instance-ids ' + instanceId, region);
+                // Get public IP
+                const ipResult = (0, aws_helpers_js_1.awsExecSafe)('aws ec2 describe-instances --instance-ids ' + instanceId + ' --query "Reservations[0].Instances[0].PublicIpAddress" --output text', region);
+                if (ipResult && ipResult !== 'None') {
+                    console.log('   Public IP: ' + ipResult.replace(/"/g, ''));
+                    console.log('   NOTE: This IP will change on restart. Run fix again for Elastic IP.');
+                }
+                return true;
+            }
+            catch (e) {
+                console.log('   Failed to launch EC2 instance: ' + (e instanceof Error ? e.message : String(e)));
+                return false;
+            }
+        },
+        manualFix: 'Launch EC2: aws ec2 run-instances --image-id <ubuntu-ami> --instance-type t2.micro --key-name factiii-{name}',
+    },
+    {
+        id: 'aws-ec2-elastic-ip',
+        stage: 'prod',
+        severity: 'warning',
+        description: 'Elastic IP not assigned to EC2 instance (IP changes on restart)',
+        scan: async (config) => {
+            if (!isAwsConfigured(config))
+                return false;
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            const instanceId = findInstance(projectName, region);
+            if (!instanceId)
+                return false; // Instance must exist first
+            return !findElasticIp(instanceId, region);
+        },
+        fix: async (config) => {
+            const { region } = (0, aws_helpers_js_1.getAwsConfig)(config);
+            const projectName = (0, aws_helpers_js_1.getProjectName)(config);
+            const instanceId = findInstance(projectName, region);
+            if (!instanceId) {
+                console.log('   EC2 instance must be created first');
+                return false;
+            }
+            try {
+                // Allocate Elastic IP
+                const eipResult = (0, aws_helpers_js_1.awsExec)('aws ec2 allocate-address --domain vpc ' + (0, aws_helpers_js_1.tagSpec)('elastic-ip', projectName), region);
+                const parsed = JSON.parse(eipResult);
+                const allocationId = parsed.AllocationId;
+                const publicIp = parsed.PublicIp;
+                console.log('   Allocated Elastic IP: ' + publicIp);
+                // Associate with instance
+                (0, aws_helpers_js_1.awsExec)('aws ec2 associate-address --allocation-id ' + allocationId + ' --instance-id ' + instanceId, region);
+                console.log('   Associated with instance: ' + instanceId);
+                console.log('   Update factiii.yml prod.domain to: ' + publicIp);
+                return true;
+            }
+            catch (e) {
+                console.log('   Failed to allocate Elastic IP: ' + (e instanceof Error ? e.message : String(e)));
+                return false;
+            }
+        },
+        manualFix: 'Allocate Elastic IP and associate with EC2 instance',
+    },
+];
+//# sourceMappingURL=ec2.js.map