haraps 1.0.3 → 1.0.5

package/README.md

@@ -0,0 +1,46 @@
+# Haraps (Hara XY Project Scaffolder)
+
+Haraps is a high-performance, automated project scaffolding CLI tailored for the **Hara XY ecosystem**. It rapidly provisions a new repository with everything an AI Coding Agent needs to execute at a senior engineering level.
+
+With a single command, Haraps injects standardized development scripts, deployment workflows, and aggressive AI alignment rules into your repository.
+
+## Usage
+
+In any new or empty repository, simply run:
+
+```bash
+npx --yes haraps
+```
+
+No installation or configuration is required. The CLI will dynamically generate the environment in the current working directory.
+
+## What it Generates
+
+When you run Haraps, it creates the following structure:
+
+### 1. Dev & Deploy Scripts
+- **`dev.sh` / `dev.ps1`**: Highly optimized local development runners that concurrently launch your Next.js frontend (port 3000) and Rust Cloudflare Worker backend (port 8787). Includes aggressive auto-cleanup for orphaned ports and a custom terminal dashboard.
+- **`deploy.sh` / `deploy.ps1`**: Standardized production deployment scripts mapping the backend to Cloudflare Wrangler and the frontend to Vercel.
+
+### 2. High-Performance Engineering Standards
+- **`AGENTS.md`**: Injects 20 hardcore engineering rules instructing the AI to prioritize edge-first execution, strict typing, zero-warning linting, security-first principles, and accessibility.
+
+### 3. Start Project Protocol
+When you open your Coding Agent in a newly scaffolded directory and type **"start project"**, the agent is hardcoded to:
+1. Ask you for the project name and description.
+2. Initialize the Next.js frontend and Rust backend adhering to your high-performance standards.
+3. Automatically initialize a new Git repository and make the first commit.
+
+### 4. Specialized Agent Skills & Workflows
+- **Ponytail (Lazy Senior Dev Mode)**: Enforces "the best code is the code never written", mandating deletion over addition and standard library usage over new dependencies.
+- **Security Review**: Equips the agent to reason like a security researcher, scanning for deep data flow vulnerabilities before deploying.
+- **Kill AI Slop**: Strips out cliché AI-generated aesthetics (e.g., indigo gradients, excessive emojis) in favor of clean, accessible UI.
+- **UI Sniper Telegram**: Sets up a webhook-based UI feedback loop straight to a Telegram group.
+- **Workflows**: Includes `git-it` (safe atomic rebasing and pushing) and `deploy-and-talk` (deployment with Telegram notifications).
+
+## Publishing Updates
+
+To publish an update to the Haraps CLI:
+1. Update the scaffolding logic in `bin/index.js`.
+2. Bump the version in `package.json`.
+3. Run `npm publish` in the package directory.

package/bin/index.js

@@ -50,24 +50,98 @@ fs.chmodSync(path.resolve(process.cwd(), 'dev.sh'), '755');
 
 writeFile('dev.ps1', `
 # =============================================
-# Local Development Runner (Rust + Next.js)
+# Project Local Development Runner
 # =============================================
+# Starts the Backend and Next.js frontend
+# using concurrently in a single terminal window.
 
+Write-Host ""
+Write-Host "=============================================" -ForegroundColor Cyan
+Write-Host "  🚀 Project Local Dev Server" -ForegroundColor Cyan
 Write-Host "=============================================" -ForegroundColor Cyan
-Write-Host "  🚀 Local Dev Server (Rust + Next.js)" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "  Backend             → http://localhost:8787" -ForegroundColor Green
+Write-Host "  Frontend            → http://localhost:3000" -ForegroundColor Blue
+Write-Host ""
+Write-Host "  Starting unified development environment..." -ForegroundColor Yellow
 Write-Host "=============================================" -ForegroundColor Cyan
+Write-Host ""
+
+# Cleanup zombie worker processes and ports to prevent conflicts
+Write-Host "  Performing aggressive process cleanup..." -ForegroundColor Gray
+
+# Define processes to kill
+$procNames = @("workerd", "node", "concurrently")
+
+foreach ($procName in $procNames) {
+    $procs = Get-Process $procName -ErrorAction SilentlyContinue
+    if ($procs) {
+        Write-Host "  Stopping $procName ($($procs.Count) instances)..." -ForegroundColor Yellow
+        $procs | Stop-Process -Force -ErrorAction SilentlyContinue
+    }
+}
+
+# Active verification loop to ensure all target processes have fully exited
+$maxWaitSeconds = 5
+$stopwatch = [System.Diagnostics.Stopwatch]::StartNew()
+while ($stopwatch.Elapsed.TotalSeconds -lt $maxWaitSeconds) {
+    $remainingProcs = Get-Process $procNames -ErrorAction SilentlyContinue
+    if (-not $remainingProcs) {
+        break
+    }
+    Start-Sleep -Milliseconds 200
+}
+
+# Function to robustly remove a directory with retry logic
+function Remove-CacheDirectory($path, $label) {
+    if (Test-Path $path) {
+        Write-Host "  Purging $label cache ($path)..." -ForegroundColor Gray
+        $attempts = 0
+        $maxAttempts = 5
+        $success = $false
+
+        while ($attempts -lt $maxAttempts -and -not $success) {
+            try {
+                Remove-Item -Recurse -Force $path -ErrorAction Stop
+                $success = $true
+            } catch {
+                $attempts++
+                if ($attempts -lt $maxAttempts) {
+                    Write-Host "    Lock detected on $path. Retrying ($attempts/$maxAttempts)..." -ForegroundColor DarkYellow
+                    Start-Sleep -Milliseconds (300 * $attempts)
+                } else {
+                    Write-Host "    Warning: Could not fully purge $path. Some files may be locked." -ForegroundColor Red
+                }
+            }
+        }
+    }
+}
+
+# Hard clear of wrangler state and Next.js cache
+Remove-CacheDirectory "backend/.wrangler" "wrangler state"
+Remove-CacheDirectory "frontend/.next" "frontend Turbopack cache"
 
-# Aggressive cleanup of ports 3000 and 8787
 $ports = @(8787, 3000)
 foreach ($port in $ports) {
-    $netstatOutput = netstat -ano | Select-String ":$port\\s+.*LISTENING\\s+(\\d+)"
-    if ($netstatOutput) {
-        $targetPid = $netstatOutput.Matches[0].Groups[1].Value
-        Write-Host "  Freeing port $port (PID $targetPid)..." -ForegroundColor Yellow
-        Stop-Process -Id $targetPid -Force -ErrorAction SilentlyContinue
+    Write-Host "  Ensuring port $port is free..." -ForegroundColor Gray
+    $retryCount = 0
+    while ($retryCount -lt 5) {
+        $netstatOutput = netstat -ano | Select-String ":$port\s+.*LISTENING\s+(\d+)"
+        if ($netstatOutput) {
+            $targetPid = $netstatOutput.Matches[0].Groups[1].Value
+            Write-Host "  Port $port occupied by PID $targetPid. Terminating..." -ForegroundColor Red
+            Stop-Process -Id $targetPid -Force -ErrorAction SilentlyContinue
+            Start-Sleep -Seconds 1
+            $retryCount++
+        } else {
+            break
+        }
     }
 }
 
+$env:WRANGLER_SEND_METRICS = "false"
+$env:NODE_OPTIONS = "--max-old-space-size=4096"
+
 Write-Host "Starting development environment..." -ForegroundColor Green
 $runnerScript = @'
 const { spawn, execSync } = require('child_process');
@@ -87,6 +161,8 @@ function formatUptime() {
     const elapsed = Math.floor((Date.now() - startTime) / 1000);
     const m = Math.floor(elapsed / 60).toString().padStart(2, '0');
     const s = (elapsed % 60).toString().padStart(2, '0');
+    const h = Math.floor(elapsed / 3600);
+    if (h > 0) return \`\${h}h \${m}m \${s}s\`;
     return \`\${m}m \${s}s\`;
 }
 
@@ -97,41 +173,119 @@ function updateLegend() {
     if (!process.stdout.isTTY) return;
     const rows = process.stdout.rows || 30;
     const cols = process.stdout.columns || 80;
+    
     if (rows !== lastRows || cols !== lastCols) {
-        process.stdout.write(\`\\x1b[1;\${rows - 2}r\`);
+        process.stdout.write(\`\x1b[1;\${rows - 2}r\`);
         lastRows = rows;
         lastCols = cols;
     }
-    const lineCount = (buffer.match(/\\n/g) || []).length;
-    const legend1 = \` [Copy] 'c': All (\${lineCount}L) | 's': 500L | 'w': Backend | 'f': Frontend | 'e': Errors \`;
-    const legend2 = \` [System] Uptime: \${formatUptime()} | 'x': Clear | 'r': Restart ALL | 'q': Quit \`;
-    process.stdout.write(\`\\x1b[s\\x1b[\${rows - 1};1H\\x1b[42m\\x1b[30m\${legend1.padEnd(cols)}\\x1b[0m\\x1b[\${rows};1H\\x1b[42m\\x1b[30m\${legend2.padEnd(cols)}\\x1b[0m\\x1b[u\`);
+    
+    const lineCount = (buffer.match(/\n/g) || []).length;
+    const sizeStr = formatSize(Buffer.byteLength(buffer, 'utf8'));
+    const uptimeStr = formatUptime();
+    const legend1 = \` [Copy] 'c': All (\${lineCount}L / \${sizeStr}) | 's': 500L | 'w': Backend | 'f': Frontend | 'e': Errors \`;
+    const legend2 = \` [System] Uptime: \${uptimeStr} | 'x': Clear | 'r': Restart ALL | '1': Frontend | '2': Backend | 'q': Quit | 'Q': Clean & Quit \`;
+    
+    process.stdout.write(\`\x1b[s\`); 
+    process.stdout.write(\`\x1b[\${rows - 1};1H\x1b[42m\x1b[30m\${legend1.padEnd(cols)}\x1b[0m\`);
+    process.stdout.write(\`\x1b[\${rows};1H\x1b[42m\x1b[30m\${legend2.padEnd(cols)}\x1b[0m\`);
+    process.stdout.write(\`\x1b[u\`); 
+}
+
+let legendInterval;
+function startLegendUpdater() {
+    if (legendInterval) clearInterval(legendInterval);
+    legendInterval = setInterval(() => {
+        updateLegend();
+    }, 1000);
+}
+
+function cleanupLegend() {
+    if (legendInterval) clearInterval(legendInterval);
+    if (!process.stdout.isTTY) return;
+    process.stdout.write('\x1b[r');
+}
+
+process.stdout.on('resize', () => {
+    if (!process.stdout.isTTY) return;
+    cleanupLegend();
+    console.clear();
+    lastRows = 0;
+    updateLegend();
+});
+
+function extractErrors(text) {
+    const lines = text.split('\n');
+    const errorPattern = /(error|exception|fail|⨯|✗|traceback)/i;
+    let inErrorBlock = false;
+    let blockStart = 0;
+    const blocks = [];
+    
+    for (let i = 0; i < lines.length; i++) {
+        if (errorPattern.test(lines[i]) || (inErrorBlock && lines[i].trim().startsWith('at '))) {
+            if (!inErrorBlock) {
+                inErrorBlock = true;
+                blockStart = Math.max(0, i - 2); 
+            }
+        } else {
+            if (inErrorBlock) {
+                if (lines[i].trim() === '') continue;
+                const blockEnd = Math.min(lines.length - 1, i + 2);
+                blocks.push(lines.slice(blockStart, blockEnd + 1).join('\n'));
+                inErrorBlock = false;
+            }
+        }
+    }
+    if (inErrorBlock) {
+        blocks.push(lines.slice(blockStart).join('\n'));
+    }
+    return blocks.length > 0 ? blocks.join('\n\n--- [Next Error Block] ---\n\n') : '';
 }
 
-setInterval(updateLegend, 1000);
+function formatPrefix(isError, source) {
+    const d = new Date();
+    const ts = String(d.getHours()).padStart(2, '0') + ':' + 
+               String(d.getMinutes()).padStart(2, '0') + ':' + 
+               String(d.getSeconds()).padStart(2, '0');
+    const color = source === 'worker' ? '\x1b[36m' : '\x1b[35m';
+    const tag = source === 'worker' ? '[BACKEND]' : '[FRONTEND]';
+    return \`\x1b[90m[\${ts}]\x1b[0m \${color}\${tag}\x1b[0m \`;
+}
 
 function createStreamHandler(isError, source) {
     let remainder = '';
     return (d) => {
         const chunk = remainder + d.toString();
-        const lines = chunk.split('\\n');
+        const lines = chunk.split('\n');
         remainder = lines.pop();
         for (let line of lines) {
-            line = line.replace(/\\x1b\\[[23]J/g, '').replace(/\\r/g, '').replace(/^\\[[^\\]]+\\]\\s*/, '');
+            line = line.replace(/\x1b\[[23]J/g, '').replace(/\x1b\[[0-9;]*H/g, '').replace(/\x1bc/g, '');
+            line = line.replace(/\x1b\[[0-9]*[A-G]/g, '').replace(/\x1b\[[0-9]*[K]/g, '');
+            line = line.replace(/\r/g, '');
+            line = line.replace(/^\[[^\]]+\]\s*/, '');
+
             if (line.trim() === '') continue;
-            const tag = source === 'worker' ? '\\x1b[36m[BACKEND]\\x1b[0m' : '\\x1b[35m[FRONTEND]\\x1b[0m';
-            const out = \`\${tag} \${line}\\n\`;
+
+            const prefix = formatPrefix(isError, source);
+            const out = prefix + line + '\n';
+            
             if (isError) process.stderr.write(out);
             else process.stdout.write(out);
             buffer += out;
         }
-        if (buffer.length > 500000) buffer = buffer.slice(-250000);
+        if (buffer.length > 1000000) {
+            const idx = buffer.indexOf('\n', buffer.length - 500000);
+            buffer = buffer.slice(idx === -1 ? -500000 : idx + 1);
+        }
     };
 }
 
 function startWorker() {
     workerChild = spawn('npx.cmd', ['concurrently', '-c', 'cyan', '-n', 'worker', '"cd backend && npx wrangler dev"'], {
-        env: { ...process.env, FORCE_COLOR: '1' }, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true, shell: true
+        env: { ...process.env, FORCE_COLOR: '1' },
+        stdio: ['ignore', 'pipe', 'pipe'],
+        windowsHide: true,
+        shell: true
     });
     workerChild.stdout.on('data', createStreamHandler(false, 'worker'));
     workerChild.stderr.on('data', createStreamHandler(true, 'worker'));
@@ -139,43 +293,132 @@ function startWorker() {
 
 function startFrontend() {
     frontendChild = spawn('npx.cmd', ['concurrently', '-c', 'magenta', '-n', 'frontend', '"cd frontend && npm run dev"'], {
-        env: { ...process.env, FORCE_COLOR: '1' }, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true, shell: true
+        env: { ...process.env, FORCE_COLOR: '1' },
+        stdio: ['ignore', 'pipe', 'pipe'],
+        windowsHide: true,
+        shell: true
     });
     frontendChild.stdout.on('data', createStreamHandler(false, 'frontend'));
     frontendChild.stderr.on('data', createStreamHandler(true, 'frontend'));
 }
 
-startWorker();
-startFrontend();
+function startServices() {
+    startWorker();
+    startFrontend();
+}
+
 console.clear();
 updateLegend();
+startLegendUpdater();
+startServices();
 
 if (process.stdin.isTTY) {
     process.stdin.setRawMode(true);
     process.stdin.resume();
     process.stdin.setEncoding('utf8');
     process.stdin.on('data', k => {
-        if (k === 'c' || k === 's' || k === 'w' || k === 'f' || k === 'e') {
-            const clean = buffer.replace(/\\x1B(?:[@-Z\\-_]|\\[[0-?]*[ -/]*[@-~])/g, '');
-            let out = clean;
-            if (k === 's') out = clean.split('\\n').slice(-500).join('\\n');
-            if (k === 'w') out = clean.split('\\n').filter(l => l.includes('[BACKEND]')).slice(-1000).join('\\n');
-            if (k === 'f') out = clean.split('\\n').filter(l => l.includes('[FRONTEND]')).slice(-1000).join('\\n');
-            try { execSync('clip', { input: out }); console.log('\\n\\x1b[32m📋 Copied to clipboard!\\x1b[0m\\n'); } catch (e) {}
-        } else if (k === 'r') {
-            console.log('\\n\\x1b[33m🔄 Restarting...\\x1b[0m\\n');
+        const now = Date.now();
+        if (k === 'c' || k === 'C') {
+            const clean = buffer.replace(/\x1B(?:[@-Z\-_]|\[[0-?]*[ -/]*[@-~])/g, '');
+            if (!clean.trim()) {
+                console.log('\n\x1b[33m⚠️ Buffer is empty.\x1b[0m\n');
+                return;
+            }
+            try {
+                execSync('clip', { input: clean });
+                console.log('\n\x1b[32m📋 Copied ALL logs to clipboard!\x1b[0m\n');
+            } catch (e) {}
+        } else if (k === 's' || k === 'S') {
+            const clean = buffer.replace(/\x1B(?:[@-Z\-_]|\[[0-?]*[ -/]*[@-~])/g, '');
+            const shortLines = clean.split('\n').slice(-500).join('\n');
+            try {
+                execSync('clip', { input: shortLines });
+                console.log('\n\x1b[32m📋 Copied last 500 lines to clipboard!\x1b[0m\n');
+            } catch (e) {}
+        } else if (k === 'w' || k === 'W') {
+            const clean = buffer.replace(/\x1B(?:[@-Z\-_]|\[[0-?]*[ -/]*[@-~])/g, '');
+            const workerLogs = clean.split('\n').filter(l => l.includes('[BACKEND]')).slice(-1000).join('\n');
+            try {
+                execSync('clip', { input: workerLogs });
+                console.log('\n\x1b[32m📋 Copied BACKEND logs to clipboard!\x1b[0m\n');
+            } catch (e) {}
+        } else if (k === 'f' || k === 'F') {
+            const clean = buffer.replace(/\x1B(?:[@-Z\-_]|\[[0-?]*[ -/]*[@-~])/g, '');
+            const frontendLogs = clean.split('\n').filter(l => l.includes('[FRONTEND]')).slice(-1000).join('\n');
+            try {
+                execSync('clip', { input: frontendLogs });
+                console.log('\n\x1b[32m📋 Copied FRONTEND logs to clipboard!\x1b[0m\n');
+            } catch (e) {}
+        } else if (k === 'e' || k === 'E') {
+            const clean = buffer.replace(/\x1B(?:[@-Z\-_]|\[[0-?]*[ -/]*[@-~])/g, '');
+            const errors = extractErrors(clean);
+            if (errors) {
+                try {
+                    execSync('clip', { input: errors });
+                    console.log('\n\x1b[31m🚨 Errors copied to clipboard!\x1b[0m\n');
+                } catch (e) {}
+            } else {
+                console.log('\n\x1b[32m✅ No errors detected.\x1b[0m\n');
+            }
+        } else if (k === 'r' || k === 'R') {
+            if (now - lastRestartTime < 1000) return;
+            lastRestartTime = now;
+            console.log('\n\x1b[33m🔄 Restarting ALL services...\x1b[0m\n');
+            if (workerChild) try { execSync('taskkill /pid ' + workerChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
+            if (frontendChild) try { execSync('taskkill /pid ' + frontendChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
+            startServices();
+        } else if (k === '1') {
+            if (now - lastRestartTime < 1000) return;
+            lastRestartTime = now;
+            console.log('\n\x1b[33m🔄 Restarting FRONTEND...\x1b[0m\n');
+            if (frontendChild) try { execSync('taskkill /pid ' + frontendChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
+            startFrontend();
+        } else if (k === '2') {
+            if (now - lastRestartTime < 1000) return;
+            lastRestartTime = now;
+            console.log('\n\x1b[33m🔄 Restarting BACKEND...\x1b[0m\n');
+            if (workerChild) try { execSync('taskkill /pid ' + workerChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
+            startWorker();
+        } else if (k === 'x' || k === 'X') {
+            console.clear();
+            buffer = '';
+            lastRows = 0;
+            updateLegend();
+            console.log('\x1b[32m🧹 Terminal cleared.\x1b[0m\n');
+        } else if (k === '\u0003' || k === 'q') {
+            console.log('\n\x1b[33mStopping services...\x1b[0m');
+            cleanupLegend();
             if (workerChild) try { execSync('taskkill /pid ' + workerChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
             if (frontendChild) try { execSync('taskkill /pid ' + frontendChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
-            startWorker(); startFrontend();
-        } else if (k === '\\u0003' || k === 'q') {
+            process.exit();
+        } else if (k === 'Q') {
+            console.log('\n\x1b[31m🧹 Cleaning cache and dependencies, then stopping services...\x1b[0m');
+            cleanupLegend();
             if (workerChild) try { execSync('taskkill /pid ' + workerChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
             if (frontendChild) try { execSync('taskkill /pid ' + frontendChild.pid + ' /t /f', { stdio: 'ignore' }); } catch(e) {}
+            
+            console.log('\x1b[33mRemoving node_modules, .next, and .wrangler...\x1b[0m');
+            const fs = require('fs');
+            const pathsToClean = ['frontend/.next', 'backend/.wrangler', 'frontend/node_modules', 'backend/node_modules', 'node_modules'];
+            for (const p of pathsToClean) {
+                try { fs.rmSync(p, { recursive: true, force: true }); } catch(e) {}
+            }
+            console.log('\x1b[32mCleanup complete.\x1b[0m');
             process.exit();
         }
     });
 }
+
+process.on('SIGINT', () => {
+    cleanupLegend();
+    process.exit();
+});
+process.on('exit', () => {
+    cleanupLegend();
+    console.clear();
+});
 '@
-$runnerPath = Join-Path $env:TEMP "mediqueue-dev-runner.js"
+$runnerPath = Join-Path $env:TEMP "project-dev-runner.js"
 Set-Content -Path $runnerPath -Value $runnerScript -Encoding UTF8
 node $runnerPath
 `);
@@ -205,24 +448,162 @@ echo -e "\\e[32mDeployment Complete!\\e[0m"
 fs.chmodSync(path.resolve(process.cwd(), 'deploy.sh'), '755');
 
 writeFile('deploy.ps1', `
+param(
+    [switch]$SkipFrontend = $false,
+    [switch]$SkipBackend = $false,
+    [switch]$Fast = $false
+)
+
+if ($Fast) {
+    Write-Host "[FAST] Fast mode enabled." -ForegroundColor Cyan
+}
+
 $ErrorActionPreference = 'Stop'
+Set-Location $PSScriptRoot
+
+# Load .env files if present
+$envFiles = @(".env", ".env.local", "frontend\\.env.local")
+foreach ($file in $envFiles) {
+    $envFile = Join-Path $PSScriptRoot $file
+    if (Test-Path $envFile) {
+        Write-Host "[RESILIENCE] Loading environment variables from $file..." -ForegroundColor Cyan
+        Get-Content $envFile | Where-Object { $_ -match '^\s*([^#\s][^=]+)=(.*)' } | ForEach-Object {
+            $name = $matches[1].Trim()
+            $value = $matches[2].Trim()
+            if ($value -match '^"(.*)"$') { $value = $matches[1] }
+            elseif ($value -match "^'(.*)'$") { $value = $matches[1] }
+            [Environment]::SetEnvironmentVariable($name, $value, "Process")
+        }
+    }
+}
 
-Write-Host "=============================================" -ForegroundColor Cyan
-Write-Host "  🚀 Deploying System (Rust + Next.js)" -ForegroundColor Cyan
-Write-Host "=============================================" -ForegroundColor Cyan
+Write-Host "[RESILIENCE] Terminating conflicting processes to prevent locks..." -ForegroundColor Yellow
+$conflictingProcs = Get-WmiObject Win32_Process | Where-Object { 
+    $_.Name -match 'node.exe' -and 
+    ($_.CommandLine -match 'next build' -or $_.CommandLine -match 'tsc' -or $_.CommandLine -match 'wrangler deploy') 
+}
+foreach ($p in $conflictingProcs) {
+    Stop-Process -Id $p.ProcessId -Force -ErrorAction SilentlyContinue
+}
 
-Write-Host "[1/2] Deploying Rust Cloudflare Worker..." -ForegroundColor Green
-Set-Location backend
-npx wrangler deploy
-Set-Location ..
+$GlobalReport = [PSCustomObject]@{
+    StartTime = (Get-Date)
+    Status = "Running"
+    Steps = @()
+    Error = $null
+}
 
-Write-Host "[2/2] Deploying Next.js Frontend..." -ForegroundColor Blue
-Set-Location frontend
-npm run build
-npx vercel deploy --prod
-Set-Location ..
+$ReportsDir = Join-Path $PSScriptRoot "deployment_reports"
+if (!(Test-Path $ReportsDir)) { New-Item -ItemType Directory -Path $ReportsDir | Out-Null }
+
+function Add-Step {
+    param([string]$Name, [string]$Status, [string]$Details = "")
+    $GlobalReport.Steps += [PSCustomObject]@{
+        Name = $Name
+        Status = $Status
+        Details = $Details
+        Time = (Get-Date).ToString("T")
+    }
+}
+
+function Generate-FinalReport {
+    param([string]$FinalStatus)
+    $GlobalReport.Status = $FinalStatus
+    
+    $reportText = "=================================================\`n"
+    $reportText += "PROJECT DEPLOYMENT REPORT\`n"
+    $reportText += "=================================================\`n"
+    $reportText += "Status:    $FinalStatus\`n"
+    $reportText += "Duration:  $((Get-Date) - $GlobalReport.StartTime)\`n"
+    $reportText += "-------------------------------------------------\`n"
+    
+    foreach ($step in $GlobalReport.Steps) {
+        $indicator = if ($step.Status -eq "SUCCESS") { "[OK]" } else { "[FAIL]" }
+        $reportText += "$indicator [$($step.Time)] $($step.Name): $($step.Status)\`n"
+        if ($step.Details) { $reportText += "   > $($step.Details)\`n" }
+    }
+    
+    if ($GlobalReport.Error) {
+        $reportText += "-------------------------------------------------\`n"
+        $reportText += "CRITICAL ERROR:\`n$($GlobalReport.Error)\`n"
+    }
+    $reportText += "=================================================\`n"
+    
+    $statusIndicator = if ($FinalStatus -eq "SUCCESS") { "SUCCESS" } else { "FAILED" }
+    $humanTime = (Get-Date).ToString("ddMMM_hh-mmtt")
+    $fileName = "Deploy_\${statusIndicator}_\${humanTime}.txt"
+    $filePath = Join-Path $ReportsDir $fileName
+    $reportText | Out-File -FilePath $filePath
+    
+    try { $reportText | Set-Clipboard } catch {}
+    return $reportText
+}
+
+function Invoke-ModernCommand {
+    param([string]$Step, [scriptblock]$Script, [switch]$NoExit)
+    Write-Host ""
+    Write-Host "[STEP] $($Step)..." -ForegroundColor Yellow
+    try {
+        $global:LASTEXITCODE = 0
+        & $Script
+        $exitCode = $LASTEXITCODE
+        
+        if ($exitCode -eq 0) {
+            Add-Step $Step "SUCCESS"
+            Write-Host "[OK] $Step completed successfully." -ForegroundColor Green
+        } else {
+            throw "Command failed with exit code $exitCode."
+        }
+    } catch {
+        $errorMsg = $_.ToString()
+        Add-Step $Step "FAILED" "Critical Error: See Global Report"
+        $GlobalReport.Error = "Step: $Step\`nError: $errorMsg"
+        
+        if ($NoExit) {
+            Write-Host "[WARN] $Step failed, but continuing." -ForegroundColor Yellow
+            throw $errorMsg
+        }
+
+        $finalReport = Generate-FinalReport "FAILED"
+        Write-Host "\`nDEPLOYMENT FAILED!\`n$errorMsg" -ForegroundColor Red
+        Write-Host "[CLIPBOARD] Full error report copied to your clipboard!" -ForegroundColor Cyan
+        
+        Set-Location $PSScriptRoot
+        exit 1
+    }
+}
+
+if (!$SkipBackend) {
+    try {
+        Push-Location backend
+        Invoke-ModernCommand "Rust Backend Deployment" { npx wrangler deploy }
+    } finally {
+        Pop-Location
+    }
+} else {
+    Add-Step "Backend Deployment" "SKIPPED"
+}
+
+if (!$SkipFrontend) {
+    try {
+        Push-Location frontend
+        $env:NODE_OPTIONS = "--max-old-space-size=8192"
+        $lockFile = Join-Path (Get-Location) ".next\lock"
+        if (Test-Path $lockFile) { Remove-Item -Force $lockFile -ErrorAction SilentlyContinue }
+        
+        Invoke-ModernCommand "Frontend Build" { npm run build }
+        Invoke-ModernCommand "Frontend Vercel Deploy" { npx vercel deploy --prod }
+    } finally {
+        Pop-Location
+    }
+} else {
+    Add-Step "Frontend Deployment" "SKIPPED"
+}
 
-Write-Host "Deployment Complete!" -ForegroundColor Green
+$finalReport = Generate-FinalReport "SUCCESS"
+Write-Host "\`nDEPLOYMENT SUCCESSFUL!" -ForegroundColor Green
+Write-Host $finalReport
+Write-Host "[CLIPBOARD] Full report copied to your clipboard!" -ForegroundColor Cyan
 `);
 
 // 3. Agent Rules

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "haraps",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "NPM package to scaffold standard development environment, deployment scripts, AGENTS.md guidelines, and core workflows for a Next.js frontend + Rust Cloudflare Worker backend.",
   "main": "bin/index.js",
   "bin": {