deploy-stack 0.12.3 → 0.14.0

package/README.md

@@ -30,6 +30,7 @@ You retain complete ownership of your infrastructure code without relying on bla
 **🚀 Zero-Config Deployments**
 * **Framework Agnostic:** Tailored container presets for Next.js, Express.js, FastAPI, Go, Django, Rails, Nuxt 3, and Static Sites (React, Vue, SvelteKit, Astro).
 * **Smart Discovery:** Automatically detects build output directories and generates highly optimized, multi-stage Dockerfiles.
+* **PaaS Migration Engine:** Natively parses Heroku `Procfile` configurations and `vercel.json` files to automatically translate proprietary edge routing (redirects/rewrites) and background workers into standard AWS Fargate and Application Load Balancer architectures.
 * **Database Scaffolding:** Automatically provisions fully isolated, zero-trust AWS RDS PostgreSQL databases for backend monoliths.
 
 **🛡️ DevSecOps & Security**
@@ -83,7 +84,7 @@ The interactive wizard will analyze your codebase, detect your framework, estima
   Strips all `deploy-stack` metadata and management tags from your project, leaving behind pure, standard Terraform and GitHub Actions files. You retain 100% ownership.
 
 * **`npx deploy-stack --headless`**
-  Bypasses the interactive wizard for fully programmatic execution. Perfect for CI/CD pipelines, custom scripts, or AI agent integration. Accepts flags like `--framework=static`, `--region=us-east-1`, and `--size=micro`.
+  Bypasses the interactive wizard for fully programmatic execution. Perfect for CI/CD pipelines, custom scripts, or AI agent integration. Accepts flags like `--framework=static`, `--region=us-east-2`, and `--size=micro`.
 
 ---
 
@@ -123,6 +124,7 @@ your-project/
 * **[Ruby on Rails](https://github.com/anton-codes-iac/deploy-stack-rails-example):** A production Rails 7+ setup featuring an auto-provisioned PostgreSQL database and secure `.auto.tfvars` Master Key injection.
 * **[Nuxt 3 (SSR)](https://github.com/anton-codes-iac/deploy-stack-nuxt-example):** Demonstrates a fully server-side rendered Nuxt application using Nitro's optimized Node output.
 * **[Django / Python](https://github.com/anton-codes-iac/deploy-stack-django-example):** A secure Gunicorn/WSGI implementation with PostgreSQL and unprivileged container adapters.
+* **[Heroku to AWS Migration (Django)](https://github.com/anton-codes-iac/deploy-stack-heroku-django-example):** A classic Heroku-style monolith migrated via the Procfile Importer, demonstrating a multi-container Web and Celery Worker architecture deployed from a single codebase.
 * **[Go / Fiber](https://github.com/anton-codes-iac/deploy-stack-go-example):** A distroless, compiled Go binary deployment demonstrating ultra-low memory footprints and instant boot times.
 ---
 
@@ -156,7 +158,7 @@ npx deploy-stack --no-telemetry
 
 ### Phase 6: Migration & Trust Engine (Current)
 - [x] **Dry-Run Visualization:** Interactive pre-flight terminal UI with ASCII topology maps and precise, dynamic AWS cost estimation.
-- [ ] **PaaS Importers:** Auto-parse `vercel.json` or Heroku `Procfile` configurations to map build commands and environment variables automatically.
+- [x] **PaaS Importers:** Auto-parse `vercel.json` and Heroku `Procfile` configurations to map routing rules, web commands, and background workers automatically.
 - [ ] **Docker Compose to ECS Translator:** Automatically converting a familiar local `docker-compose.yml` into production ECS task definitions.
 - [ ] **AI Agent Rulesets:** Publishing `.cursorrules` and Copilot instructions that teach AI assistants exactly how to utilize the CLI on the user's behalf.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deploy-stack",
-  "version": "0.12.3",
+  "version": "0.14.0",
   "description": "Provision production-ready AWS infrastructure and CI/CD pipelines in seconds.",
   "engines": {
     "node": ">=18.0.0"

package/release-notes.md

@@ -0,0 +1,14 @@
+# 🚀 Vercel Escape Hatch, Orchestrator Refactor & Advanced Telemetry
+
+This release introduces the second half of our PaaS Migration Engine, focusing on seamlessly escaping Vercel's proprietary edge network, alongside an internal architectural cleanup.
+
+### ✨ What's New
+* **Vercel Edge Routing Migration:** `deploy-stack` now automatically parses `vercel.json` files. It natively translates Vercel edge redirects (301/302) and regex path matching directly into standard AWS Application Load Balancer Listener Rules.
+* **Vendor Lock-In Detection:** The CLI now proactively analyzes framework configuration files (`next.config.mjs`, `svelte.config.js`, `astro.config.mjs`) during the pre-flight checks. It warns users if they are locked into Vercel-specific adapters and provides exact instructions on how to switch to standard Node/Standalone outputs for AWS containerization.
+
+### 🛠️ Architecture & Telemetry
+* **Core Orchestrator Refactor:** Stripped over 250 lines of business logic and UI prompting out of `init.js`, establishing a clean, strictly isolated `src/utils/` toolbox pattern for future PaaS parsers.
+* **Wide Telemetry Payloads:** Upgraded the analytics engine to capture detailed execution context (CLI version, headless status, desired task counts, and specific migration vectors like Heroku/Vercel) to better map the user deployment funnel.
+
+### 🐛 Bug Fixes
+* **Next.js Standalone Enforcement:** Explicit warnings are now surfaced if a Next.js project is missing the critical `output: 'standalone'` directive before attempting to provision cloud resources.

package/src/commands/apply.js

@@ -5,6 +5,7 @@ import { intro, outro, spinner, log, cancel } from '@clack/prompts';
 import color from 'picocolors';
 import { renderDryRunPreview, parseTerraformConfig } from '../utils/visualizer.js';
 import { detectFramework } from '../utils/detector.js';
+import { trackEvent, flushTelemetry } from '../core/telemetry.js';
 
 // Helper to run a command while piping the latest stdout line into a @clack spinner
 function runTerraformCommand(args, cwd, spin, loadingPrefix) {
@@ -111,7 +112,7 @@ export async function applyStack(options = {}) {
         // 6. Run terraform apply
         s.start('Provisioning AWS infrastructure (this may take 3–5 minutes)...');
         await runTerraformCommand(['apply', '-auto-approve'], tfDir, s, 'Provisioning');
-        s.stop('AWS infrastructure provisioned successfully!');
+        s.stop('Cloud resources provisioned.');
 
         // 7. Extract and print the outputs
         const outputs = await getTerraformOutputs(tfDir);
@@ -125,6 +126,14 @@ export async function applyStack(options = {}) {
 
         outro(`${finalMessage}\n\n  ${color.yellow('Push code to deploy your app and clear the 503 error:')}\n  ${color.cyan('git add . && git commit -m "ci: infra" && git push origin main')}`);
 
+        const actualProjectName = path.basename(process.cwd());
+        trackEvent('infrastructure_applied', {
+            projectName: actualProjectName,
+            framework: detectedConfig.framework,
+            success: true
+        });
+        await flushTelemetry();
+
         process.exit(0);
 
     } catch (error) {
@@ -146,6 +155,15 @@ export async function applyStack(options = {}) {
             log.message(`${color.bold('To debug manually, navigate to your terraform folder:')}`);
             log.message(color.cyan('cd terraform && terraform apply'));
         }
+
+        const actualProjectName = path.basename(process.cwd());
+        trackEvent('infrastructure_applied', {
+            projectName: actualProjectName,
+            success: false,
+            error_code: error.code || 'UNKNOWN'
+        });
+        await flushTelemetry();
+
         process.exit(1);
     }
 }

package/src/commands/destroy.js

@@ -77,7 +77,7 @@ export async function destroyStack() {
     const regionMatch = backendContent.match(/region\s*=\s*"([^"]+)"/);
 
     const bucketName = bucketMatch ? bucketMatch[1] : null;
-    const region = regionMatch ? regionMatch[1] : 'us-east-1';
+    const region = regionMatch ? regionMatch[1] : 'us-east-2';
 
     // 2. Execute Terraform Destroy
     s.start('Destroying AWS compute resources (this takes a few minutes)...');
@@ -87,6 +87,15 @@ export async function destroyStack() {
     } catch (error) {
         s.stop(color.red('❌ Terraform destroy failed.'));
         console.error(color.red(error.message));
+
+        const actualProjectName = path.basename(process.cwd());
+        trackEvent('infrastructure_destroyed', {
+            projectName: actualProjectName,
+            success: false,
+            error_code: error.code || 'UNKNOWN'
+        });
+        await flushTelemetry();
+
         process.exit(1);
     }
 
@@ -111,9 +120,11 @@ export async function destroyStack() {
         }
     }
 
-    trackEvent('project_destroyed', {
+    const actualProjectName = path.basename(process.cwd());
+    trackEvent('infrastructure_destroyed', {
+        projectName: actualProjectName,
         region,
-        bucket: bucketName,
+        retained_state_bucket: !(deleteS3Bucket && typeof deleteS3Bucket !== 'symbol'),
         success: true
     });
     await flushTelemetry();

package/src/commands/doctor.js

@@ -1,6 +1,7 @@
 import { intro, outro, spinner } from '@clack/prompts';
 import color from 'picocolors';
 import { checkDependency } from '../utils/system.js';
+import { trackEvent, flushTelemetry } from '../core/telemetry.js';
 
 export async function runDoctor() {
     intro(color.bgCyan(color.black(' deploy-stack ☁️  ')));
@@ -36,4 +37,9 @@ export async function runDoctor() {
     } else {
         outro(color.yellow('Please install the missing dependencies before running the provisioning tool.'));
     }
+
+    trackEvent('doctor_run', {
+        success: hasTerraform && hasAws && hasDocker && hasGit
+    });
+    await flushTelemetry();
 }

package/src/commands/eject.js

@@ -2,6 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import { intro, outro, confirm, spinner, cancel } from '@clack/prompts';
 import color from 'picocolors';
+import { trackEvent, flushTelemetry } from '../core/telemetry.js';
 
 export async function ejectStack() {
     intro(color.bgRed(color.white(' deploy-stack eject ⏏️  ')));
@@ -68,6 +69,12 @@ export async function ejectStack() {
 
     s.stop('Ejection complete.');
 
+    const actualProjectName = path.basename(process.cwd());
+    trackEvent('project_ejected', {
+        projectName: actualProjectName
+    });
+    await flushTelemetry();
+
     outro(`
     ${color.green('✅ Successfully ejected from deploy-stack!')}
     

package/src/commands/init.js

@@ -1,23 +1,33 @@
 import fsSync from 'fs';
-import fs from 'fs/promises';
 import path from 'path';
-import { intro, outro, group, text, select, spinner, cancel, confirm, log } from '@clack/prompts';
+import { intro, outro, spinner, log } from '@clack/prompts';
 import color from 'picocolors';
-import { execSync } from 'child_process';
 
 import { checkDependency } from '../utils/system.js';
-import { detectFramework } from '../utils/detector.js';
+import {
+    detectFramework,
+    parseProcfile,
+    parseVercelConfig,
+    analyzeNextConfig,
+    analyzeSvelteConfig,
+    analyzeAstroConfig
+} from '../utils/detector.js';
 import { trackEvent, flushTelemetry } from '../core/telemetry.js';
 import { getFrameworkWarning } from '../utils/warnings.js';
 import { provisionStateBucket } from '../utils/aws.js';
 import { generateTemplates } from '../utils/generator.js';
 import { handleExistingFiles } from '../utils/backup.js';
 import { estimateMonthlyCost } from '../utils/visualizer.js';
+import { getTargetDirectory, getProjectConfig } from '../utils/prompts.js';
+import { resolveDjangoWsgi, handleRailsCI } from '../utils/frameworks.js';
+
+const pkg = JSON.parse(fsSync.readFileSync(new URL('../../package.json', import.meta.url)));
+const CLI_VERSION = pkg.version;
 
 export async function mainStack({ isHeadless = false, headlessOptions = {} } = {}) {
     const startTime = Date.now();
 
-    // 0. Silent Pre-flight check
+    // 1. Silent Pre-flight check
     const hasTerraform = await checkDependency('terraform');
     if (!hasTerraform) {
         console.error(color.red('✖ Terraform is not installed.'));
@@ -25,260 +35,65 @@ export async function mainStack({ isHeadless = false, headlessOptions = {} } = {
         process.exit(1);
     }
 
-    const getFlag = (key, defaultValue) => headlessOptions[key] !== undefined ? headlessOptions[key] : defaultValue;
-
-    let projectName, actualProjectName, targetDir;
-    let finalFramework, detectedFramework;
-    let djangoWsgi = 'core.wsgi';
-    let setupType = 'quick';
-    let needsDatabase = false;
-    let disableDefaultCI = false;
-    let project = {};
-    let currentGitBranch = 'main';
-
-    if (isHeadless) {
-        // --- HEADLESS MODE ---
-        projectName = getFlag('dir', '.');
-        actualProjectName = projectName === '.' ? path.basename(process.cwd()) : projectName;
-        targetDir = projectName === '.' ? process.cwd() : path.join(process.cwd(), projectName);
-
-        detectedFramework = detectFramework(targetDir);
-        finalFramework = getFlag('framework', detectedFramework ? detectedFramework.id : 'static');
-
-        project = {
-            region: getFlag('region', 'us-east-1'),
-            port: getFlag('port', finalFramework === 'static' ? '8080' : '3000'),
-            size: getFlag('size', 'micro'),
-            healthCheckPath: getFlag('healthCheckPath', '/'),
-            desiredCount: getFlag('desiredCount', '1'),
-            branch: getFlag('branch', 'main')
-        };
+    if (!isHeadless) intro(color.bgCyan(color.black(' deploy-stack ☁️  ')));
 
-        console.log(color.cyan(`🤖 Running deploy-stack in headless mode [${finalFramework} -> ${project.region}]`));
-    } else {
-        // --- INTERACTIVE MODE ---
-        // 1. Start the CLI
-        intro(color.bgCyan(color.black(' deploy-stack ☁️  ')));
+    // 2. Resolve Target & Scan Codebase
+    const dirConfig = await getTargetDirectory(isHeadless, headlessOptions);
+    const detectedFramework = detectFramework(dirConfig.targetDir);
+    const procfile = parseProcfile(dirConfig.targetDir);
+    const vercelRules = parseVercelConfig(dirConfig.targetDir);
 
-        // 2. Ask for the target directory FIRST
-        projectName = await text({
-            message: 'Where should we generate the infrastructure? (Type "." for current directory)',
-            placeholder: '.',
-            initialValue: '.',
-            validate: (value) => {
-                if (!value) return 'Please enter a name or directory.';
-                if (value !== '.' && value.includes(' ')) return 'Name cannot contain spaces.';
-            },
-        });
-
-        if (typeof projectName === 'symbol') {
-            cancel('Operation cancelled.');
-            process.exit(0);
-        }
-
-        actualProjectName = projectName === '.' ? path.basename(process.cwd()) : projectName;
-        targetDir = projectName === '.' ? process.cwd() : path.join(process.cwd(), projectName);
-
-        // 2.5 Run the scanner
-        const detectedFramework = detectFramework(targetDir);
-        if (detectedFramework) {
-            log.success(`Auto-detected framework: ${detectedFramework.name}`);
-        }
+    if (!isHeadless) {
+        if (detectedFramework) log.success(`Auto-detected framework: ${detectedFramework.name}`);
+        if (procfile && procfile.web) log.success(`Auto-detected Procfile (web command: ${procfile.web.join(' ')})`);
+        if (vercelRules) log.success(`Auto-detected vercel.json (Migrating edge network rules)`);
+    }
 
-        // 2.6 Resolve the framework
-        finalFramework = detectedFramework ? detectedFramework.id : null;
+    if (isHeadless) console.log(color.cyan(`🤖 Running deploy-stack in headless mode`));
 
-        if (!finalFramework) {
-            finalFramework = await select({
-                message: 'Which framework preset should we configure?',
-                options: [
-                    { value: 'node', label: 'Node.js / Express' },
-                    { value: 'nextjs', label: 'Next.js (Standalone)' },
-                    { value: 'nuxt', label: 'Nuxt 3 (SSR)' },
-                    { value: 'python', label: 'Python FastAPI' },
-                    { value: 'django', label: 'Django (Python)' },
-                    { value: 'rails', label: 'Ruby on Rails' },
-                    { value: 'go', label: 'Go (Golang)' },
-                    { value: 'static', label: 'Static Site (Gatsby, React, plain HTML via Nginx)' },
-                ],
-            });
+    // 3. Gather Configuration & Framework Quirks
+    const config = await getProjectConfig(isHeadless, headlessOptions, dirConfig.targetDir, detectedFramework);
+    const djangoWsgi = await resolveDjangoWsgi(dirConfig.targetDir, procfile, config.framework, isHeadless);
+    const disableDefaultCI = await handleRailsCI(dirConfig.targetDir, config.framework, isHeadless);
 
-            if (typeof finalFramework === 'symbol') {
-                cancel('Operation cancelled.');
-                process.exit(0);
+    // 4. Framework Migration Checks (Vercel Escape Hatch)
+    if (!isHeadless) {
+        if (config.framework === 'nextjs') {
+            const nextConfig = analyzeNextConfig(dirConfig.targetDir);
+            if (nextConfig.hasConfig && !nextConfig.isStandalone) {
+                log.warn(color.yellow('⚠️ Next.js config is missing "output: \'standalone\'". Your CI/CD Docker build will crash until you add it!'));
             }
-        }
-
-        // --- DJANGO SPECIFIC PROMPT ---
-        djangoWsgi = 'core.wsgi';
-        if (finalFramework === 'django') {
-            djangoWsgi = await text({
-                message: 'What is the Python module path to your Django wsgi.py?',
-                placeholder: 'core.wsgi',
-                initialValue: 'core.wsgi',
-            });
-            if (typeof djangoWsgi === 'symbol') process.exit(0);
-        }
-
-        // 3. Prompt for Setup Mode
-        setupType = await select({
-            message: 'Choose your setup mode:',
-            options: [
-                { value: 'quick', label: '⚡ Quickstart (Recommended)', hint: 'Production defaults, minimal prompts' },
-                { value: 'advanced', label: '🛠️  Advanced Configuration', hint: 'Customize health checks, task count, branch, etc.' },
-            ],
-        });
-
-        if (typeof setupType === 'symbol') {
-            cancel('Operation cancelled.');
-            process.exit(0);
-        }
-
-        // 4. Set intelligent defaults & check current Git branch
-        let defaultPort = '3000';
-
-        if (finalFramework === 'static') defaultPort = '8080';
-        if (finalFramework === 'python' || finalFramework === 'django') defaultPort = '8000';
-        if (finalFramework === 'rails') defaultPort = '3000';
-        if (finalFramework === 'go') defaultPort = '8080';
-
-        currentGitBranch = 'main';
-        try {
-            currentGitBranch = execSync('git symbolic-ref --short HEAD', { cwd: targetDir, stdio: 'pipe' }).toString().trim();
-        } catch (e) {
-            // Not a git repo yet, fallback to 'main'
-        }
-
-        // 5. Ask for Managed Database (Only for Backend/Fullstack Frameworks)
-        needsDatabase = false;
-        const isBackendFramework = ['node', 'nextjs', 'nuxt', 'python', 'django', 'rails', 'go'].includes(finalFramework);
-
-        if (isBackendFramework) {
-            const dbChoice = await confirm({
-                message: 'Do you need a managed AWS RDS PostgreSQL database? (Adds ~$14/month or uses AWS Free Tier)',
-                initialValue: false,
-            });
-
-            if (typeof dbChoice === 'symbol') {
-                cancel('Provisioning cancelled.')
-                process.exit(0);
+        } else if (detectedFramework?.name === 'SvelteKit') {
+            const svelteConfig = analyzeSvelteConfig(dirConfig.targetDir);
+            if (svelteConfig.adapter === 'vercel' || svelteConfig.adapter === 'auto') {
+                log.warn(color.yellow('⚠️ SvelteKit is locked into the Vercel/Auto adapter. Switch to @sveltejs/adapter-node (for SSR) to deploy on AWS.'));
             }
-            needsDatabase = dbChoice;
-        }
-
-        // 6. Prompt Configuration Group
-        project = await group(
-            {
-                region: () =>
-                    select({
-                        message: 'Which AWS region do you want to deploy to?',
-                        options: [
-                            { value: 'us-east-1', label: 'us-east-1 (N. Virginia)' },
-                            { value: 'us-east-2', label: 'us-east-2 (Ohio)' },
-                            { value: 'eu-west-1', label: 'eu-west-1 (Ireland)' },
-                            { value: 'eu-central-1', label: 'EU (Frankfurt)' },
-                            { value: 'ap-southeast-2', label: 'Asia Pacific (Sydney)' },
-                        ],
-                    }),
-                port: () =>
-                    text({
-                        message: 'What port does your container expose?',
-                        placeholder: defaultPort,
-                        defaultValue: defaultPort,
-                    }),
-                size: () =>
-                    select({
-                        message: 'Select your Fargate compute size:',
-                        options: [
-                            { value: 'micro', label: 'Micro (0.25 vCPU, 512MB RAM) - Best for POCs' },
-                            { value: 'small', label: 'Small (0.5 vCPU, 1GB RAM) - Best for small Projects' },
-                        ],
-                    }),
-                // --- Advanced-Only Prompts (Skipped if setupType === 'quick') ---
-                healthCheckPath: () => {
-                    if (setupType === 'quick') return undefined;
-                    return text({
-                        message: 'ALB Health Check Path:',
-                        placeholder: '/',
-                        defaultValue: '/',
-                    });
-                },
-                desiredCount: () => {
-                    if (setupType === 'quick') return undefined;
-                    return select({
-                        message: 'How many container replicas (tasks) should run?',
-                        options: [
-                            { value: '1', label: '1 Task (Single instance - lowest cost)' },
-                            { value: '2', label: '2 Tasks (High Availability across AZs)' },
-                        ],
-                        defaultValue: '1',
-                    });
-                },
-                branch: () => {
-                    if (setupType === 'quick') return undefined;
-                    return text({
-                        message: 'Primary Git deployment branch for CI/CD:',
-                        placeholder: currentGitBranch,
-                        defaultValue: currentGitBranch,
-                    });
-                },
-            },
-            {
-                onCancel: () => {
-                    cancel('Provisioning cancelled.');
-                    process.exit(0);
-                },
+        } else if (detectedFramework?.name === 'Astro') {
+            const astroConfig = analyzeAstroConfig(dirConfig.targetDir);
+            if (astroConfig.adapter === 'vercel') {
+                log.warn(color.yellow('⚠️ Astro is locked into the Vercel adapter. Switch to @astrojs/node (for SSR) to deploy on AWS.'));
             }
-        );
+        }
     }
 
-    // 7. Map the user's choices and update the variables
-    const cpu = project.size === 'small' ? '512' : '256';
-    const memory = project.size === 'small' ? '1024' : '512';
-    const computeTier = project.size === 'small' ? 'Small (0.5 vCPU, 1GB RAM)' : 'Micro (0.25 vCPU, 512MB RAM)';
-
-    const costs = estimateMonthlyCost({ cpu: parseInt(cpu), memory: parseInt(memory), hasDb: needsDatabase });
-    const estimatedCost = `~$${costs.totalMonthly} / month${needsDatabase ? ' (Includes Fargate + RDS PostgreSQL)' : ''}`;
+    // 5. Calculate Derived Values
+    const cpu = config.size === 'small' ? '512' : '256';
+    const memory = config.size === 'small' ? '1024' : '512';
+    const computeTier = config.size === 'small' ? 'Small (0.5 vCPU, 1GB RAM)' : 'Micro (0.25 vCPU, 512MB RAM)';
 
-    const healthCheckPath = project.healthCheckPath || '/';
-    const desiredCount = project.desiredCount || '1';
-    const deployBranch = project.branch || currentGitBranch;
+    const costs = estimateMonthlyCost({ cpu: parseInt(cpu), memory: parseInt(memory), hasDb: config.needsDatabase });
+    const estimatedCost = `~$${costs.totalMonthly} / month${config.needsDatabase ? ' (Includes Fargate + RDS PostgreSQL)' : ''}`;
     const buildDir = detectedFramework?.buildDir || 'dist';
 
-    // 7.1 Check for conflicting CI boilerplate (Rails)
-    if (finalFramework === 'rails') {
-        const ciPath = path.join(targetDir, '.github', 'workflows', 'ci.yml');
-        const dependabotPath = path.join(targetDir, '.github', 'dependabot.yml');
-
-        if (fsSync.existsSync(ciPath) || fsSync.existsSync(dependabotPath)) {
-            if (!isHeadless) {
-                console.log('');
-                const ciContent = await confirm({
-                    message: color.yellow('We detected default Rails GitHub Actions (ci.yml, dependabot.yml) that usually crash in isolated CI environments without a database. Would you like deploy-stack to safely disable them by renaming them to .bak?'),
-                    initialValue: true,
-                });
-                if (typeof ciContent === 'symbol') {
-                    cancel('Provisioning cancelled.');
-                    process.exit(0);
-                }
-                disableDefaultCI = ciContent;
-            } else {
-                // Headless: automatically disable conflicting CI
-                disableDefaultCI = true;
-            }
-        }
-    }
-
-    // 8. Safely handle existing files (Backup and auto-prune)
-    await handleExistingFiles(targetDir, isHeadless);
+    // 6. Handle Backups & Provision Remote State
+    await handleExistingFiles(dirConfig.targetDir, isHeadless);
 
     const s = spinner();
     s.start('Provisioning infrastructure...');
 
-    // 9. Provision S3 bucket for Terraform state & enable versioning
     let awsAccountId, stateBucketName;
     try {
-        const bucketData = await provisionStateBucket(project.region, actualProjectName);
+        const bucketData = await provisionStateBucket(config.region, dirConfig.actualProjectName);
         awsAccountId = bucketData.awsAccountId;
         stateBucketName = bucketData.stateBucketName;
     } catch (error) {
@@ -289,69 +104,75 @@ export async function mainStack({ isHeadless = false, headlessOptions = {} } = {
         process.exit(1);
     }
 
+    // 7. Synthesize Templates
     s.message('Synthesizing Terraform templates...');
-
-    // 10. Generate all templates and directories
-    await generateTemplates(targetDir, {
-        PROJECT_NAME: actualProjectName,
-        REGION: project.region,
-        PORT: project.port,
+    await generateTemplates(dirConfig.targetDir, {
+        PROJECT_NAME: dirConfig.actualProjectName,
+        REGION: config.region,
+        PORT: config.port,
         CPU: cpu,
         MEMORY: memory,
         COMPUTE_TIER: computeTier,
         ESTIMATED_COST: estimatedCost,
         STATE_BUCKET: stateBucketName,
         AWS_ACCOUNT_ID: awsAccountId,
-        HEALTH_CHECK_PATH: healthCheckPath,
-        DESIRED_COUNT: desiredCount,
-        DEPLOY_BRANCH: deployBranch,
+        HEALTH_CHECK_PATH: config.healthCheckPath,
+        DESIRED_COUNT: config.desiredCount,
+        DEPLOY_BRANCH: config.branch,
         BUILD_DIR: buildDir,
-        finalFramework: finalFramework,
-        NEEDS_DATABASE: needsDatabase,
+        finalFramework: config.framework,
+        NEEDS_DATABASE: config.needsDatabase,
         DJANGO_WSGI: djangoWsgi,
-        DISABLE_DEFAULT_CI: disableDefaultCI
+        DISABLE_DEFAULT_CI: disableDefaultCI,
+        PROCFILE: procfile,
+        VERCEL_RULES: vercelRules
     });
 
-    // 11. Track the event in telemetry
+    // 8. Telemetry
     trackEvent('project_provisioned', {
-        projectName: actualProjectName,
-        framework: finalFramework,
-        specific_framework: detectedFramework?.name || finalFramework,
-        region: project.region,
-        size: project.size,
-        setup_mode: setupType,
-        desiredCount: desiredCount,
-        duration_ms: Date.now() - startTime
+        // 1. Core & Context
+        projectName: dirConfig.actualProjectName,
+        cli_version: CLI_VERSION,
+        is_headless: isHeadless,
+        setup_mode: config.setupType,
+        duration_ms: Date.now() - startTime,
+
+        // 2. Infrastructure Shape
+        framework: config.framework,
+        specific_framework: detectedFramework?.name || config.framework,
+        region: config.region,
+        size: config.size,
+        desired_count: parseInt(config.desiredCount),
+        has_database: config.needsDatabase,
+        has_custom_health_check: config.healthCheckPath !== '/',
+
+        // 3. Advanced Features & PaaS Context
+        has_worker: !!(procfile && procfile.worker),
+        is_heroku_migration: !!procfile,
+        is_vercel_migration: !!vercelRules,
     });
 
     s.stop('Infrastructure provisioned successfully!');
 
-    // 12. Provide the Outro, Framework Warnings and Next Steps
+    // 9. Output
     let frameworkWarnings = '';
-    if (!(finalFramework === 'static' && detectedFramework?.buildDir)) {
-        frameworkWarnings = getFrameworkWarning(finalFramework);
+    if (!(config.framework === 'static' && detectedFramework?.buildDir)) {
+        frameworkWarnings = getFrameworkWarning(config.framework);
     }
 
-    const isGitInitialized = fsSync.existsSync(path.join(targetDir, '.git'));
-
-    const needsCd = projectName && projectName !== '.';
-    const applyStep = needsCd
-        ? `cd ${projectName} && npx deploy-stack apply --yes`
-        : 'npx deploy-stack apply';
-
+    const isGitInitialized = fsSync.existsSync(path.join(dirConfig.targetDir, '.git'));
+    const needsCd = dirConfig.projectName && dirConfig.projectName !== '.';
+    const applyStep = needsCd ? `cd ${dirConfig.projectName} && npx --yes deploy-stack apply` : 'npx --yes deploy-stack apply';
     const gitInstructions = isGitInitialized
         ? `git add . && git commit -m "chore: add AWS infrastructure and CI/CD" && git push`
-        : `git init && git add . && git commit -m "chore: add AWS infrastructure and CI/CD" && git branch -M ${deployBranch} && git remote add origin https://github.com/your-username/your-repo.git && git push -u origin ${deployBranch}`;
+        : `git init && git add . && git commit -m "chore: add AWS infrastructure and CI/CD" && git branch -M ${config.branch} && git remote add origin https://github.com/your-username/your-repo.git && git push -u origin ${config.branch}`;
 
-    const outroMessage = `${color.green('✅ Templates generated!')} ${color.blue('🛡️ DevSecOps scanning enabled.')}
+    outro(`${color.green('✅ Templates generated!')} ${color.blue('🛡️ DevSecOps scanning enabled.')}
     ${frameworkWarnings ? `\n  ${frameworkWarnings}` : ''}
     ${color.yellow('Next steps:')}
     1. ${color.cyan(applyStep)}
     2. ${color.cyan(gitInstructions)}
-    ${color.magenta('🚀 Need help?')} ${color.underline('https://calendly.com/anton-codes-iac/15min')}`;
-
-    outro(outroMessage);
+    ${color.magenta('🚀 Need help?')} ${color.underline('https://calendly.com/anton-codes-iac/15min')}`);
 
-    // 13.Ensure all analytics are sent before the CLI terminates
     await flushTelemetry();
 }