@vibedhost/cli 1.0.0

package/src/index.ts

@@ -0,0 +1,1028 @@
+#!/usr/bin/env node
+
+import path from "path";
+import fs from "fs";
+import {
+  API_BASE_URL,
+  readGlobalConfig,
+  writeGlobalConfig,
+  clearGlobalConfig,
+  readProjectConfig,
+  writeProjectConfig,
+  openBrowser,
+  scanDirectory,
+  createZipBuffer,
+  MAX_PAYLOAD_BYTES,
+  askQuestion,
+  inferAppName,
+  computeBufferSha256
+} from "./utils";
+
+const args = process.argv.slice(2);
+const command = args[0] || "help";
+
+async function main() {
+  switch (command) {
+    case "login":
+      await handleLogin();
+      break;
+    case "logout":
+      await handleLogout();
+      break;
+    case "whoami":
+      await handleWhoami();
+      break;
+    case "deploy":
+      await handleDeploy();
+      break;
+    case "status":
+      await handleStatus();
+      break;
+    case "logs":
+      await handleLogs();
+      break;
+    case "db":
+      await handleDb();
+      break;
+    case "env":
+      await handleEnv();
+      break;
+    case "port":
+      await handlePort();
+      break;
+    case "help":
+    case "--help":
+    case "-h":
+    default:
+      printHelp();
+      break;
+  }
+}
+
+function printHelp() {
+  console.log(`
+VibedHost Cloud Engine — Command Line Interface
+--------------------------------------------------------------------------
+Deploy web applications and manage dedicated cloud workspaces directly from
+your terminal, Claude Code, Cursor, or automated CI/CD pipelines.
+
+Website:   https://www.vibedhost.com
+Dashboard: https://www.vibedhost.com/dashboard/workspaces
+
+Usage:
+  npx vibed [command] [options]
+
+Getting Started:
+  1. Create account & workspace:  https://www.vibedhost.com/register
+  2. Authenticate terminal:       npx vibed login
+  3. Deploy local project:        npx vibed deploy
+
+Commands:
+  login              Authenticate this terminal with your VibedHost account
+  logout             Disconnect active account credentials from this machine
+  whoami             Display authenticated account and workspace inventory
+  deploy [dir]       Package and deploy local project to dedicated workspace
+  status [app]       Check real-time application deployment and routing status
+  logs [app]         Stream live application logs or container build output
+  db <create|list|link> Manage dedicated databases and link to applications
+  env <get|set>      Manage container environment variables
+  port set <port>    Update container listening port (e.g. 3000, 8080)
+
+Deployment Options:
+  --workspace <id>   Specify target workspace ID (skips interactive selection)
+  --name <name>      Override service name for this deployment
+  --port <port>      Specify internal container port (e.g. 3000, 80)
+  --domain <domain>  Specify deployment domain suffix (e.g. vibedhost.online)
+  --force, -f        Force rebuild and bypass zero-change detection
+
+Inspection Options:
+  --ai               Format latest error snippet for AI coding assistants
+
+Examples:
+  npx vibed login
+  npx vibed deploy
+  npx vibed deploy ./dist --name frontend-spa
+  npx vibed status
+  npx vibed logs my-app
+  npx vibed logs my-app --ai
+  npx vibed env set DATABASE_URL=postgresql://...
+`);
+}
+
+async function handleLogin() {
+  console.log("Initializing secure authentication session...");
+
+  try {
+    const res = await fetch(`${API_BASE_URL}/api/cli/auth/session`, {
+      method: "POST"
+    });
+    const data = (await res.json()) as any;
+
+    if (!res.ok || !data.sessionCode) {
+      console.error(`Authentication error: ${data.error || "Failed to initialize session."}`);
+      process.exit(1);
+    }
+
+    const { sessionCode, userCode, authUrl } = data;
+
+    if (userCode) {
+      console.log(`\nTerminal Pairing Code: ${userCode}`);
+    }
+    console.log("Opening browser for authentication...");
+    console.log(`If your browser does not open automatically, visit:\n${authUrl}\n`);
+    console.log("Verify that the pairing code matches in your browser (timeout in 15 minutes)...");
+
+    openBrowser(authUrl);
+
+    // Poll for authorization completion
+    const startTime = Date.now();
+    const timeoutMs = 15 * 60 * 1000;
+
+    while (Date.now() - startTime < timeoutMs) {
+      await new Promise((r) => setTimeout(r, 1800));
+
+      const pollRes = await fetch(`${API_BASE_URL}/api/cli/auth/poll?sessionCode=${sessionCode}`);
+      const pollData = (await pollRes.json()) as any;
+
+      if (pollRes.ok && pollData.status === "approved" && pollData.token) {
+        writeGlobalConfig({
+          token: pollData.token,
+          email: pollData.user?.email,
+          name: pollData.user?.name
+        });
+
+        console.log(`\nAuthentication successful!`);
+        console.log(`Logged in as: ${pollData.user?.email || "Authenticated User"}`);
+        console.log(`Run 'npx vibed deploy' inside any project directory to deploy.`);
+        return;
+      }
+
+      if (pollData.status === "expired" || pollData.status === "invalid") {
+        console.error("\nSession expired or rejected. Please run 'npx vibed login' again.");
+        process.exit(1);
+      }
+    }
+
+    console.error("\nAuthentication timed out. Please try again.");
+    process.exit(1);
+  } catch (err: any) {
+    console.error(`\nConnection error: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function handleLogout() {
+  clearGlobalConfig();
+  console.log("Logged out. Local authentication credentials cleared.");
+}
+
+async function handleWhoami() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.log("Not authenticated. Run 'npx vibed login' to connect your account.");
+    return;
+  }
+
+  try {
+    const res = await fetch(`${API_BASE_URL}/api/cli/workspaces`, {
+      headers: { Authorization: `Bearer ${config.token}` }
+    });
+    const data = (await res.json()) as any;
+
+    if (!res.ok) {
+      console.error(`Error: ${data.error || "Failed to retrieve account details."}`);
+      return;
+    }
+
+    console.log("\nVibedHost Account Overview");
+    console.log("------------------------------------------------------------");
+    console.log(`User:            ${data.userEmail || config.email || "Unknown"}`);
+    console.log(`Wallet Balance:  €${(data.walletBalance || 0).toFixed(2)}`);
+    console.log(`Workspaces:      ${data.workspaces?.length || 0} active`);
+
+    if (data.workspaces?.length > 0) {
+      console.log("\nDedicated Cloud Workspaces:");
+      data.workspaces.forEach((ws: any, idx: number) => {
+        const ramStr = ws.ramTotalGB ? `${(ws.memoryUsageGB || 0.4).toFixed(1)} GB / ${ws.ramTotalGB} GB` : "Allocated";
+        const diskStr = ws.storageTotalGB ? `${(ws.storageUsageGB || 2.0).toFixed(1)} GB / ${ws.storageTotalGB} GB` : "NVMe";
+        const bwLimit = ws.bandwidthLimitGB > 0 ? `${(ws.bandwidthLimitGB / 1000).toFixed(0)} TB` : "Unmetered";
+        const bwStr = `${(ws.bandwidthUsedGB || 0).toFixed(1)} GB / ${bwLimit}`;
+
+        console.log(`  [${idx + 1}] ${ws.name} (ID: ${ws.id})`);
+        console.log(`      Tier: ${ws.planName} • Status: ${ws.status}`);
+        console.log(`      Telemetry: RAM: ${ramStr} • Disk: ${diskStr} • Traffic: ${bwStr}`);
+        console.log(`      Deployed Services: ${ws.apps?.length || 0} active`);
+      });
+    } else {
+      console.log("\nNo workspaces provisioned yet.");
+      console.log("Launch a workspace on the web: https://www.vibedhost.com/dashboard/workspaces");
+    }
+    console.log("");
+  } catch (err: any) {
+    console.error(`Connection error: ${err.message}`);
+  }
+}
+
+async function handleDeploy() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.log(`
+VibedHost Cloud Engine — Deployment Gateway
+------------------------------------------------------------
+You are not currently authenticated.
+
+Get Started:
+1. Create an account:  https://www.vibedhost.com/register
+2. Authenticate:       npx vibed login
+`);
+    process.exit(1);
+  }
+
+  // Parse command options
+  let targetDir = process.cwd();
+  const dirArg = args[1] && !args[1].startsWith("--") ? args[1] : null;
+  if (dirArg) {
+    targetDir = path.resolve(process.cwd(), dirArg);
+  }
+
+  const workspaceFlagIndex = args.indexOf("--workspace");
+  const nameFlagIndex = args.indexOf("--name");
+  const portFlagIndex = args.indexOf("--port");
+  const domainFlagIndex = args.indexOf("--domain");
+
+  const explicitWorkspaceId = workspaceFlagIndex !== -1 ? args[workspaceFlagIndex + 1] : null;
+  const explicitAppName = nameFlagIndex !== -1 ? args[nameFlagIndex + 1] : null;
+  const explicitPort = portFlagIndex !== -1 ? args[portFlagIndex + 1] : null;
+  const explicitDomain = domainFlagIndex !== -1 ? args[domainFlagIndex + 1] : null;
+
+  if (!fs.existsSync(targetDir)) {
+    console.error(`Directory not found: ${targetDir}`);
+    process.exit(1);
+  }
+
+  const projectConfig = readProjectConfig(targetDir);
+
+  // 1. Fetch available workspaces
+  console.log("Verifying account and active workspaces...");
+  let workspaces: any[] = [];
+  try {
+    const wsRes = await fetch(`${API_BASE_URL}/api/cli/workspaces`, {
+      headers: { Authorization: `Bearer ${config.token}` }
+    });
+    const wsData = (await wsRes.json()) as any;
+
+    if (!wsRes.ok) {
+      console.error(`Authentication error: ${wsData.error || "Invalid token. Please run 'npx vibed login'."}`);
+      process.exit(1);
+    }
+
+    workspaces = (wsData.workspaces || []).filter((w: any) => w.status === "running");
+
+    if (workspaces.length === 0) {
+      console.log(`
+No active dedicated workspaces found.
+Wallet Balance: €${(wsData.walletBalance || 0).toFixed(2)}
+
+To deploy applications, launch a dedicated cloud workspace:
+https://www.vibedhost.com/dashboard/workspaces
+
+Once provisioned, run 'npx vibed deploy' again.
+`);
+      process.exit(1);
+    }
+  } catch (err: any) {
+    console.error(`Failed to reach VibedHost API: ${err.message}`);
+    process.exit(1);
+  }
+
+  // 2. Resolve target workspace ID (with interactive prompt if unlinked)
+  let targetWorkspaceId = explicitWorkspaceId || projectConfig?.workspaceId;
+
+  if (!targetWorkspaceId && process.stdin.isTTY && !explicitWorkspaceId) {
+    if (workspaces.length === 1) {
+      const confirmWs = await askQuestion(
+        `Target Workspace: ${workspaces[0].name} (${workspaces[0].planName}) [Y/n]`,
+        "y"
+      );
+      if (confirmWs.toLowerCase() === "n" || confirmWs.toLowerCase() === "no") {
+        console.log("Deployment cancelled.");
+        process.exit(0);
+      }
+      targetWorkspaceId = workspaces[0].id;
+    } else {
+      console.log("\nSelect target workspace for this deployment:");
+      workspaces.forEach((w: any, idx: number) => {
+        console.log(`  [${idx + 1}] ${w.name} (${w.planName})`);
+      });
+      const chosenIdx = await askQuestion("Enter number", "1");
+      const num = parseInt(chosenIdx, 10);
+      const selected = workspaces[num - 1] || workspaces[0];
+      targetWorkspaceId = selected.id;
+    }
+  } else if (!targetWorkspaceId) {
+    targetWorkspaceId = workspaces[0].id;
+  }
+
+  const targetWs = workspaces.find((w) => w.id === targetWorkspaceId) || workspaces[0];
+
+  // 3. Resolve service name
+  let defaultAppName = projectConfig?.appName || inferAppName(targetDir);
+  let appName = explicitAppName;
+
+  if (!appName && !projectConfig?.appName && process.stdin.isTTY) {
+    appName = await askQuestion("Service Name", defaultAppName);
+  } else if (!appName) {
+    appName = defaultAppName;
+  }
+
+  appName = String(appName)
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, "-")
+    .replace(/(^-|-$)+/g, "");
+
+  const hasForceFlag = args.includes("--force") || args.includes("-f");
+
+  // Linked Project Confirmation Guard
+  if (projectConfig?.workspaceId && process.stdin.isTTY && !explicitWorkspaceId && !hasForceFlag) {
+    const confirmLinked = await askQuestion(
+      `Deploying updates to existing service '${appName}' (Workspace: ${targetWs.name}) [Y/n]`,
+      "y"
+    );
+    if (confirmLinked.toLowerCase() === "n" || confirmLinked.toLowerCase() === "no") {
+      console.log("Deployment cancelled.");
+      process.exit(0);
+    }
+  }
+
+  // 3.5 Resolve deployment domain
+  let targetDomainSuffix = explicitDomain || projectConfig?.domain;
+  if (!targetDomainSuffix && process.stdin.isTTY) {
+    try {
+      const domRes = await fetch(`${API_BASE_URL}/api/cli/domains`, {
+        headers: { Authorization: `Bearer ${config.token}` }
+      });
+      const domainsList = ((await domRes.json()) as any[]) || [];
+      if (domainsList.length > 1) {
+        console.log("\nSelect deployment domain:");
+        domainsList.forEach((d: any, idx: number) => {
+          console.log(`  [${idx + 1}] .${d.domain}${d.isDefault ? " (Default)" : ""}`);
+        });
+        const chosenDomIdx = await askQuestion("Enter number", "1");
+        const dNum = parseInt(chosenDomIdx, 10);
+        const selectedDom = domainsList[dNum - 1] || domainsList[0];
+        targetDomainSuffix = selectedDom.domain;
+      } else if (domainsList.length === 1) {
+        targetDomainSuffix = domainsList[0].domain;
+      }
+    } catch {}
+  }
+
+  // 4. Scan Directory & Create In-Memory ZIP
+  console.log(`\nScanning project directory (${path.basename(targetDir)})...`);
+  const { files, bloatReport } = scanDirectory(targetDir);
+
+  if (files.length === 0) {
+    console.error("Error: No deployable source files found in this directory.");
+    process.exit(1);
+  }
+
+  console.log(`Packaging ${files.length} project files in memory...`);
+  const zipBuffer = createZipBuffer(files);
+  const zipSizeBytes = zipBuffer.length;
+  const zipSizeMb = (zipSizeBytes / (1024 * 1024)).toFixed(2);
+
+  // Pre-flight Size Boundary Check
+  if (zipSizeBytes > MAX_PAYLOAD_BYTES) {
+    console.error(`
+Error: Project archive size (${zipSizeMb} MB) exceeds the 50.0 MB limit.
+
+Bloat directories detected:`);
+    Object.entries(bloatReport).forEach(([dir, size]) => {
+      console.error(`  - ${dir}/ (${(size / (1024 * 1024)).toFixed(1)} MB)`);
+    });
+    console.error(`
+Resolution:
+1. Ensure 'node_modules', '.next', '.venv', and build caches are excluded.
+2. Run 'npx vibed deploy' again.
+`);
+    process.exit(1);
+  }
+
+  // Zero-Change Guard: Prevent accidental re-deploys when files are unchanged
+  const currentZipHash = computeBufferSha256(zipBuffer);
+  if (
+    projectConfig?.lastDeployHash &&
+    projectConfig.lastDeployHash === currentZipHash &&
+    process.stdin.isTTY &&
+    !hasForceFlag
+  ) {
+    const confirmRedeploy = await askQuestion(
+      `No local code changes detected since last deployment (${appName}).\nDo you want to re-deploy anyway? [y/N]`,
+      "n"
+    );
+    if (confirmRedeploy.toLowerCase() !== "y" && confirmRedeploy.toLowerCase() !== "yes") {
+      console.log("Deployment cancelled (no changes detected).");
+      process.exit(0);
+    }
+  }
+
+  console.log(`Archive packaged (${zipSizeMb} MB). Uploading to workspace [${targetWs.name}]...`);
+
+  // 5. Send Multipart Deployment Request
+  try {
+    const boundary = `----VibedFormBoundary${Date.now()}`;
+    const preBuffer = Buffer.from(
+      `--${boundary}\r\n` +
+      `Content-Disposition: form-data; name="file"; filename="project.zip"\r\n` +
+      `Content-Type: application/zip\r\n\r\n`
+    );
+
+    const midBuffer = Buffer.from(
+      `\r\n--${boundary}\r\n` +
+      `Content-Disposition: form-data; name="appName"\r\n\r\n${appName}\r\n` +
+      `--${boundary}\r\n` +
+      `Content-Disposition: form-data; name="workspaceId"\r\n\r\n${targetWs.id}\r\n` +
+      (explicitPort ? `--${boundary}\r\nContent-Disposition: form-data; name="containerPort"\r\n\r\n${explicitPort}\r\n` : "") +
+      (targetDomainSuffix ? `--${boundary}\r\nContent-Disposition: form-data; name="deploymentDomain"\r\n\r\n${targetDomainSuffix}\r\n` : "") +
+      `--${boundary}--\r\n`
+    );
+
+    const payload = Buffer.concat([preBuffer, zipBuffer, midBuffer]);
+
+    const deployRes = await fetch(`${API_BASE_URL}/api/cli/deploy`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.token}`,
+        "Content-Type": `multipart/form-data; boundary=${boundary}`,
+        "Content-Length": payload.length.toString()
+      },
+      body: payload
+    });
+
+    const rawText = await deployRes.text();
+    let result: any = {};
+    try {
+      result = JSON.parse(rawText);
+    } catch {
+      throw new Error(`Gateway returned unexpected response: ${rawText.slice(0, 100)}`);
+    }
+
+    if (deployRes.status === 429) {
+      console.error(`
+Deployment In Progress / Rate Limited
+------------------------------------------------------------
+Service:   ${appName}
+Workspace: ${targetWs.name}
+Status:    ${result.error || "A build is already in progress for this application."}
+
+Troubleshooting:
+- Stream live logs:    npx vibed logs ${appName}
+- Check status:        npx vibed status ${appName}
+- Format for AI debug: npx vibed logs ${appName} --ai
+`);
+      process.exit(1);
+    }
+
+    if (!deployRes.ok || !result.success) {
+      console.error(`
+Deployment Unsuccessful
+------------------------------------------------------------
+Service:   ${appName}
+Workspace: ${targetWs.name}
+Error:     ${result.error || "Build failed. Please check your configuration."}
+
+Troubleshooting:
+- Stream logs:         npx vibed logs ${appName}
+- Format for AI debug: npx vibed logs ${appName} --ai
+- Adjust port:         npx vibed port set 3000
+`);
+      process.exit(1);
+    }
+
+    // Save project configuration locally immediately
+    writeProjectConfig(
+      {
+        workspaceId: targetWs.id,
+        appName: result.appName || appName,
+        domain: result.domain,
+        lastDeployHash: currentZipHash
+      },
+      targetDir
+    );
+
+    console.log("Building application container in background...");
+
+    // Progressive status polling loop (up to 120 seconds)
+    const startTime = Date.now();
+    let isLive = result.status === "active";
+    let isFailed = false;
+    const finalAppName = result.appName || appName;
+
+    while (!isLive && !isFailed && Date.now() - startTime < 120000) {
+      await new Promise((r) => setTimeout(r, 2500));
+      const elapsedSec = Math.round((Date.now() - startTime) / 1000);
+      try {
+        const checkRes = await fetch(
+          `${API_BASE_URL}/api/cli/logs?appName=${encodeURIComponent(finalAppName)}`,
+          { headers: { Authorization: `Bearer ${config.token}` } }
+        );
+        const checkData = (await checkRes.json()) as any;
+
+        if (checkData.status === "active") {
+          isLive = true;
+          break;
+        } else if (checkData.status === "failed") {
+          isFailed = true;
+          break;
+        } else {
+          process.stdout.write(`\rBuilding application container in background... (${elapsedSec}s)`);
+        }
+      } catch {}
+    }
+
+    process.stdout.write("\r" + " ".repeat(65) + "\r");
+
+    if (isLive) {
+      console.log(`
+Deployment Complete!
+------------------------------------------------------------
+Service:    ${finalAppName}
+Workspace:  ${targetWs.name}
+Status:     Active
+
+Live URL:   https://${result.domain}
+------------------------------------------------------------
+`);
+    } else if (isFailed) {
+      console.error(`
+Deployment Unsuccessful
+------------------------------------------------------------
+Service:    ${finalAppName}
+Workspace:  ${targetWs.name}
+Status:     Failed
+
+Build unsuccessful.
+Run 'npx vibed logs ${finalAppName}' to view container error logs.
+------------------------------------------------------------
+`);
+      process.exit(1);
+    } else {
+      console.log(`
+Deployment In Progress
+------------------------------------------------------------
+Service:    ${finalAppName}
+Workspace:  ${targetWs.name}
+Status:     Building
+
+Your application is continuing to build in the background.
+Run 'npx vibed status' to check status.
+Run 'npx vibed logs' to view live build logs.
+------------------------------------------------------------
+`);
+    }
+  } catch (err: any) {
+    console.error(`\nDeployment error: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+async function handleStatus() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.error("Not authenticated. Please run 'npx vibed login' first.");
+    process.exit(1);
+  }
+
+  const projectConfig = readProjectConfig();
+  const appName = args[1] && !args[1].startsWith("--") ? args[1] : (projectConfig?.appName || inferAppName(process.cwd()));
+
+  try {
+    // If an app name is provided or detected in this directory, show app status + telemetry
+    if (appName) {
+      const res = await fetch(`${API_BASE_URL}/api/cli/logs?appName=${encodeURIComponent(appName)}`, {
+        headers: { Authorization: `Bearer ${config.token}` }
+      });
+      const data = (await res.json()) as any;
+
+      if (!res.ok) {
+        console.error(`Error: ${data.error || "Failed to retrieve status."}`);
+        process.exit(1);
+      }
+
+      const currentStatus = data.status || "unknown";
+
+      if (currentStatus === "active") {
+        console.log(`
+VibedHost Service Status
+------------------------------------------------------------
+Service:    ${appName}
+Workspace:  ${data.workspaceName || "Workspace"}
+Status:     Online & Active
+
+Live URL:   https://${data.domain || projectConfig?.domain}
+------------------------------------------------------------
+`);
+      } else if (currentStatus === "failed") {
+        console.log(`
+VibedHost Service Status
+------------------------------------------------------------
+Service:    ${appName}
+Workspace:  ${data.workspaceName || "Workspace"}
+Status:     Failed
+
+Build unsuccessful.
+Run 'npx vibed logs ${appName}' to view error logs.
+------------------------------------------------------------
+`);
+      } else {
+        console.log(`
+VibedHost Service Status
+------------------------------------------------------------
+Service:    ${appName}
+Workspace:  ${data.workspaceName || "Workspace"}
+Status:     Building
+
+Building application container in background.
+Run 'npx vibed logs ${appName}' to view build progress.
+------------------------------------------------------------
+`);
+      }
+      return;
+    }
+
+    // If no app name specified, display workspace fleet health & resource telemetry
+    const wsRes = await fetch(`${API_BASE_URL}/api/cli/workspaces`, {
+      headers: { Authorization: `Bearer ${config.token}` }
+    });
+    const wsData = (await wsRes.json()) as any;
+
+    if (!wsRes.ok || !wsData.workspaces || wsData.workspaces.length === 0) {
+      console.log("\nNo active dedicated workspaces found. Launch one on the web console:\nhttps://www.vibedhost.com/dashboard/workspaces\n");
+      return;
+    }
+
+    console.log("\nVibedHost Workspace Health & Telemetry");
+    console.log("------------------------------------------------------------");
+    wsData.workspaces.forEach((ws: any, idx: number) => {
+      const ramStr = ws.ramTotalGB ? `${(ws.memoryUsageGB || 0.4).toFixed(1)} GB / ${ws.ramTotalGB} GB` : "Allocated";
+      const diskStr = ws.storageTotalGB ? `${(ws.storageUsageGB || 2.0).toFixed(1)} GB / ${ws.storageTotalGB} GB` : "NVMe";
+      const bwLimit = ws.bandwidthLimitGB > 0 ? `${(ws.bandwidthLimitGB / 1000).toFixed(0)} TB` : "Unmetered";
+      const bwStr = `${(ws.bandwidthUsedGB || 0).toFixed(1)} GB / ${bwLimit}`;
+
+      console.log(`Workspace:   ${ws.name}`);
+      console.log(`Plan:        ${ws.planName}`);
+      console.log(`Status:      ${ws.status === 'running' ? 'Online & Active' : ws.status}`);
+      console.log(`CPU Load:    ${ws.computeUsage || 4}%`);
+      console.log(`Memory:      ${ramStr}`);
+      console.log(`NVMe Disk:   ${diskStr}`);
+      console.log(`Bandwidth:   ${bwStr}`);
+
+      if (ws.apps && ws.apps.length > 0) {
+        console.log(`\nActive Services (${ws.apps.length}):`);
+        ws.apps.forEach((a: any) => {
+          const urlStr = a.domain ? `https://${a.domain}` : (a.type === 'DATABASE' ? 'Internal Network' : 'Ready');
+          console.log(`  • ${a.name} (${a.status}) ➔ ${urlStr}`);
+        });
+      }
+      if (idx < wsData.workspaces.length - 1) {
+        console.log("------------------------------------------------------------");
+      }
+    });
+    console.log("------------------------------------------------------------\n");
+  } catch (err: any) {
+    console.error(`Failed to check service status: ${err.message}`);
+  }
+}
+
+async function handleLogs() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.error("Not authenticated. Please run 'npx vibed login' first.");
+    process.exit(1);
+  }
+
+  const isAiFormat = args.includes("--ai");
+  const filteredArgs = args.slice(1).filter((a) => a !== "--ai");
+  const projectConfig = readProjectConfig();
+  const appName = filteredArgs[0] || projectConfig?.appName || inferAppName(process.cwd());
+
+  if (!appName) {
+    console.error("Please specify application name: npx vibed logs <appName>");
+    process.exit(1);
+  }
+
+  try {
+    const res = await fetch(`${API_BASE_URL}/api/cli/logs?appName=${encodeURIComponent(appName)}`, {
+      headers: { Authorization: `Bearer ${config.token}` }
+    });
+    const data = (await res.json()) as any;
+
+    if (!res.ok) {
+      console.error(`Error: ${data.error || "Failed to retrieve logs."}`);
+      process.exit(1);
+    }
+
+    if (isAiFormat) {
+      console.log(`
+============================================================
+AI ASSISTANT DEBUG PROMPT (COPY AND PASTE TO CLAUDE / CURSOR)
+============================================================
+I am deploying application "${appName}" on VibedHost PaaS.
+The service encountered an error. Here are the container logs:
+
+-------------------- BEGIN LOG STREAM --------------------
+${(data.logs || "").slice(-1500)}
+--------------------- END LOG STREAM ---------------------
+
+Please analyze these logs and tell me how to resolve the error.
+============================================================
+`);
+    } else {
+      console.log(`\nLog stream for '${appName}' (${data.workspaceName || "Workspace"}):`);
+      console.log("------------------------------------------------------------");
+      console.log(data.logs || "No logs returned.");
+      console.log("------------------------------------------------------------\n");
+    }
+  } catch (err: any) {
+    console.error(`Failed to stream logs: ${err.message}`);
+  }
+}
+
+async function handleEnv() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.error("Not authenticated. Run 'npx vibed login'.");
+    process.exit(1);
+  }
+
+  const subCommand = args[1];
+  const projectConfig = readProjectConfig();
+  const appName = projectConfig?.appName || inferAppName(process.cwd());
+
+  if (!appName) {
+    console.error("No linked project found in this folder. Run inside a project directory or run 'npx vibed deploy' first.");
+    process.exit(1);
+  }
+
+  if (subCommand === "set") {
+    const keyVal = args[2];
+    if (!keyVal || !keyVal.includes("=")) {
+      console.error("Usage: npx vibed env set KEY=VALUE");
+      process.exit(1);
+    }
+    const idx = keyVal.indexOf("=");
+    const key = keyVal.substring(0, idx).trim();
+    const value = keyVal.substring(idx + 1).trim();
+
+    try {
+      const postRes = await fetch(`${API_BASE_URL}/api/cli/env`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${config.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          appName,
+          key,
+          value
+        })
+      });
+
+      if (postRes.ok) {
+        console.log(`Environment variable ${key} updated. Service restarted.`);
+      } else {
+        console.error("Failed to update environment variable.");
+      }
+    } catch (err: any) {
+      console.error(`Connection error: ${err.message}`);
+    }
+  } else {
+    // List vars
+    try {
+      const res = await fetch(`${API_BASE_URL}/api/cli/env?appName=${encodeURIComponent(appName)}`, {
+        headers: { Authorization: `Bearer ${config.token}` }
+      });
+      const data = (await res.json()) as any;
+      if (res.ok) {
+        console.log(`\nEnvironment Variables for '${appName}':`);
+        console.log("------------------------------------------------------------");
+        (data.envVars || []).forEach((v: any) => {
+          const masked = v.value.length > 8 ? `${v.value.slice(0, 4)}••••${v.value.slice(-3)}` : "••••";
+          console.log(`  ${v.key}=${masked}`);
+        });
+        console.log(`  Internal Port: ${data.port || 80}`);
+        console.log("------------------------------------------------------------\n");
+      }
+    } catch (err: any) {
+      console.error(`Error: ${err.message}`);
+    }
+  }
+}
+
+async function handlePort() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.error("Not authenticated. Run 'npx vibed login'.");
+    process.exit(1);
+  }
+
+  const subCommand = args[1];
+  const portVal = parseInt(args[2], 10);
+  const projectConfig = readProjectConfig();
+  const appName = projectConfig?.appName || inferAppName(process.cwd());
+
+  if (!appName) {
+    console.error("No linked project found in this folder.");
+    process.exit(1);
+  }
+
+  if (subCommand !== "set" || isNaN(portVal) || portVal < 1 || portVal > 65535) {
+    console.error("Usage: npx vibed port set <1-65535>");
+    process.exit(1);
+  }
+
+  try {
+    const res = await fetch(`${API_BASE_URL}/api/cli/env`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${config.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        appName,
+        port: portVal
+      })
+    });
+
+    if (res.ok) {
+      console.log(`Routing port for '${appName}' updated to ${portVal}. Network routes synchronized.`);
+    } else {
+      console.error("Failed to update container port.");
+    }
+  } catch (err: any) {
+    console.error(`Connection error: ${err.message}`);
+  }
+}
+
+async function handleDb() {
+  const config = readGlobalConfig();
+  if (!config?.token) {
+    console.error("Not authenticated. Please run 'npx vibed login' first.");
+    process.exit(1);
+  }
+
+  const subCommand = args[1] || "list";
+  const projectConfig = readProjectConfig();
+
+  // 1. DATABASE LIST
+  if (subCommand === "list") {
+    try {
+      const res = await fetch(`${API_BASE_URL}/api/cli/db`, {
+        headers: { Authorization: `Bearer ${config.token}` }
+      });
+      const data = (await res.json()) as any;
+
+      if (!res.ok) {
+        console.error(`Error: ${data.error || "Failed to fetch databases."}`);
+        process.exit(1);
+      }
+
+      const isReveal = args.includes("--reveal");
+      console.log("\nManaged Databases:");
+      console.log("------------------------------------------------------------");
+
+      if (!data.databases || data.databases.length === 0) {
+        console.log("No databases provisioned yet.");
+        console.log("Run 'npx vibed db create <name>' to launch a database.\n");
+        return;
+      }
+
+      data.databases.forEach((d: any, idx: number) => {
+        console.log(`[${idx + 1}] ${d.name} (${d.engine}) • Workspace: ${d.workspaceName}`);
+        console.log(`    Status: ${d.status}`);
+        console.log(`    URI:    ${isReveal ? d.internalUri : d.maskedUri}`);
+      });
+      console.log("------------------------------------------------------------\n");
+    } catch (err: any) {
+      console.error(`Connection error: ${err.message}`);
+    }
+    return;
+  }
+
+  // 2. DATABASE CREATE
+  if (subCommand === "create") {
+    let dbName = args[2] && !args[2].startsWith("--") ? args[2] : "";
+    const engineIndex = args.indexOf("--engine");
+    let explicitEngine = engineIndex !== -1 ? args[engineIndex + 1] : "";
+
+    if (!dbName && process.stdin.isTTY) {
+      dbName = await askQuestion("Database Service Name", "my-postgres");
+    } else if (!dbName) {
+      dbName = "my-postgres";
+    }
+
+    if (!explicitEngine && process.stdin.isTTY) {
+      console.log("\nSelect Database Engine:");
+      console.log("  [1] PostgreSQL 15     (Default)");
+      console.log("  [2] Supabase Postgres");
+      console.log("  [3] MySQL 8.0");
+      console.log("  [4] Redis 7 (In-Memory)");
+      console.log("  [5] MongoDB 6");
+      const chosen = await askQuestion("Enter number", "1");
+      const map: Record<string, string> = {
+        "1": "POSTGRES",
+        "2": "SUPABASE_POSTGRES",
+        "3": "MYSQL",
+        "4": "REDIS",
+        "5": "MONGODB"
+      };
+      explicitEngine = map[chosen] || "POSTGRES";
+    }
+
+    const cleanEngine = (explicitEngine || "POSTGRES").toUpperCase();
+    console.log(`\nProvisioning ${cleanEngine} database '${dbName}' on dedicated NVMe storage...`);
+
+    try {
+      const res = await fetch(`${API_BASE_URL}/api/cli/db`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${config.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          action: "CREATE_DB",
+          workspaceId: projectConfig?.workspaceId,
+          name: dbName,
+          engine: cleanEngine
+        })
+      });
+
+      const data = (await res.json()) as any;
+
+      if (!res.ok || !data.success) {
+        console.error(`Database launch error: ${data.error || "Failed to create database."}`);
+        process.exit(1);
+      }
+
+      console.log(`\nDatabase Ready!`);
+      console.log("------------------------------------------------------------");
+      console.log(`Name:        ${data.name}`);
+      console.log(`Engine:      ${data.engine}`);
+      console.log(`Workspace:   ${data.workspaceName}`);
+      console.log(`URI:         ${data.internalUri}`);
+      console.log("------------------------------------------------------------");
+      console.log(`To link to your app, run: npx vibed db link ${data.name}\n`);
+    } catch (err: any) {
+      console.error(`Connection error: ${err.message}`);
+    }
+    return;
+  }
+
+  // 3. DATABASE LINK
+  if (subCommand === "link") {
+    const dbTargetName = args[2] && !args[2].startsWith("--") ? args[2] : "";
+    const targetAppName = projectConfig?.appName || inferAppName(process.cwd());
+
+    if (!dbTargetName) {
+      console.error("Usage: npx vibed db link <database-name>");
+      process.exit(1);
+    }
+
+    console.log(`Linking database '${dbTargetName}' to application '${targetAppName}'...`);
+
+    try {
+      const res = await fetch(`${API_BASE_URL}/api/cli/db`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${config.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          action: "LINK_DB",
+          appName: targetAppName,
+          dbName: dbTargetName
+        })
+      });
+
+      const data = (await res.json()) as any;
+
+      if (!res.ok || !data.success) {
+        console.error(`Link error: ${data.error || "Failed to link database."}`);
+        process.exit(1);
+      }
+
+      console.log(`\nSuccessfully linked '${data.dbName}' to '${data.appName}'!`);
+      console.log(`Injected ${data.keyUsed} into environment variables. Container restarted.\n`);
+    } catch (err: any) {
+      console.error(`Connection error: ${err.message}`);
+    }
+    return;
+  }
+
+  console.log("Usage: npx vibed db [create|list|link]");
+}
+
+main().catch((err) => {
+  console.error(`Execution error: ${err.message}`);
+  process.exit(1);
+});