@launchmatic/cli 0.3.1 → 0.4.0

package/README.md

@@ -0,0 +1,178 @@
+# @launchmatic/cli
+
+Deploy from your terminal. The official CLI for [Launchmatic](https://launchmatic.io) — detect, build, and ship your apps to the cloud in seconds.
+
+## Install
+
+```bash
+npm install -g @launchmatic/cli
+```
+
+## Quick Start
+
+```bash
+lm login                # Authenticate with GitHub
+lm quicklaunch          # Detect, configure, and deploy — one command
+```
+
+Or use **Lightspeed** to create an app from a prompt:
+
+```bash
+c -c a real-time chat app with rooms
+```
+
+## Commands
+
+### Core
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `lm login` | | Authenticate via GitHub OAuth |
+| `lm init` | | Initialize a project in the current directory |
+| `lm deploy` | | Build and deploy the current service |
+| `lm quicklaunch` | `lm ql` | Detect, configure, and deploy in one shot |
+| `lm status` | | Show service status, URL, and last deployment |
+| `lm logs` | | Stream live deployment logs |
+| `lm destroy` | | Tear down a service (requires confirmation) |
+
+### AI / Lightspeed
+
+| Command | Description |
+|---------|-------------|
+| `c -c <prompt>` | Create a new app from a natural language description |
+| `c <prompt>` | Modify an existing service with AI |
+| `lm lightspeed` | Same as `c`, integrated into the main CLI |
+
+### Environment & Domains
+
+| Command | Description |
+|---------|-------------|
+| `lm env set KEY=VALUE ...` | Set environment variables |
+| `lm env list` | List environment variables |
+| `lm domains add <hostname>` | Add a custom domain (shows DNS config) |
+
+### Deployments
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `lm deployments list` | `lm deploys ls` | View deployment history |
+| `lm deployments info <id>` | | Deployment details |
+| `lm deployments cancel <id>` | | Cancel a running deployment |
+| `lm deployments rollback <id>` | | Roll back to a previous deployment |
+
+### Preview Environments
+
+| Command | Description |
+|---------|-------------|
+| `lm preview list` | List active preview environments |
+| `lm preview create <branch>` | Create a preview deployment for a branch |
+| `lm preview delete <id>` | Delete a preview environment |
+
+### Database
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `lm db create` | | Provision a new database |
+| `lm db list` | `lm db ls` | List databases |
+| `lm db connect` | `lm db url` | Get connection string |
+| `lm db query <sql>` | `lm db q` | Run a SQL query |
+| `lm db shell` | `lm db sh` | Interactive SQL shell |
+| `lm db tables` | | List tables |
+| `lm db dump` | | Export database dump |
+| `lm db seed` | | Seed database |
+| `lm db credentials` | `lm db creds` | Show database credentials |
+| `lm db link` | | Link a database to a service |
+| `lm db delete` | `lm db rm` | Delete a database |
+
+Supports PostgreSQL, Redis, and MongoDB via `--engine`.
+
+### GitHub Repo
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `lm repo view` | `lm repo v` | Show repo info |
+| `lm repo prs` | | List pull requests |
+| `lm repo issues` | | List issues |
+| `lm repo issue-create` | `lm repo ic` | Create an issue |
+| `lm repo branches` | `lm repo br` | List branches |
+| `lm repo commits` | `lm repo log` | Show commit history |
+| `lm repo releases` | `lm repo rl` | List releases |
+| `lm repo actions` | `lm repo runs` | View GitHub Actions runs |
+| `lm repo browse` | `lm repo web` | Open repo in browser |
+| `lm repo clone` | | Clone the repo |
+| `lm repo diff` | | Show diff |
+| `lm repo stash` | | Stash changes |
+
+### Infrastructure
+
+| Command | Description |
+|---------|-------------|
+| `lm infra list -t <team>` | List pods with CPU, memory, and readiness |
+| `lm infra logs <pod>` | Stream pod logs |
+| `lm infra describe <pod>` | Describe a pod |
+| `lm infra restart <pod>` | Restart a pod |
+| `lm infra delete <pod>` | Delete a pod |
+
+### Browser Automation
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `lm browser screenshot [url]` | `lm b ss` | Take a screenshot |
+| `lm browser pdf [url]` | | Generate a PDF |
+| `lm browser open [url]` | | Open in headed browser |
+| `lm browser test [url]` | | Run smoke tests (links, console, a11y) |
+| `lm browser wait [url]` | | Wait for a page to be reachable |
+| `lm browser codegen [url]` | | Record and generate test code |
+| `lm browser devices` | | List available device profiles |
+
+### Utilities
+
+| Command | Description |
+|---------|-------------|
+| `lm doctor` | Scan project for deployment issues and fixes |
+| `lm usage summary` | View CPU, memory, network, and replica stats |
+| `lm usage history` | Resource usage over time (default 24h) |
+| `lm api-key list` | List API keys |
+| `lm api-key create <name>` | Create an API key |
+| `lm api-key delete <id>` | Delete an API key |
+
+## Examples
+
+```bash
+# Deploy a project from the current directory
+lm init
+lm deploy
+
+# One-command deploy with auto-detection
+lm quicklaunch
+
+# Create an app with AI
+c -c a markdown blog with syntax highlighting
+
+# Modify an existing app
+c add a dark mode toggle to the settings page
+
+# Check project health before deploying
+lm doctor
+
+# Manage environment variables
+lm env set DATABASE_URL=postgres://... REDIS_URL=redis://...
+
+# Stream logs
+lm logs
+
+# Roll back a bad deployment
+lm deployments rollback <deployment-id>
+
+# Interactive database shell
+lm db shell
+```
+
+## Requirements
+
+- Node.js >= 20
+- A [Launchmatic](https://launchmatic.io) account
+
+## License
+
+MIT

package/dist/index.js

@@ -20211,6 +20211,60 @@ async function api(path6, options = {}) {
   }
   return res.json();
 }
+async function* streamApi(path6, options = {}) {
+  const { accessToken } = getTokens();
+  const url = `${getApiUrl()}${path6}`;
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "text/event-stream",
+    ...options.headers || {}
+  };
+  if (accessToken) headers["Authorization"] = `Bearer ${accessToken}`;
+  const res = await fetch(url, { ...options, headers });
+  if (!res.ok || !res.body) {
+    let message = `HTTP ${res.status}`;
+    try {
+      const body = await res.json();
+      if (body.error) message = body.error;
+    } catch {
+    }
+    throw new ApiError(res.status, message);
+  }
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { value, done } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let boundary = buffer.indexOf("\n\n");
+      while (boundary !== -1) {
+        const frame = buffer.slice(0, boundary);
+        buffer = buffer.slice(boundary + 2);
+        const dataLines = [];
+        for (const line of frame.split("\n")) {
+          if (line.startsWith("data:")) {
+            dataLines.push(line.slice(5).trimStart());
+          }
+        }
+        if (dataLines.length > 0) {
+          const json = dataLines.join("\n");
+          try {
+            yield JSON.parse(json);
+          } catch {
+          }
+        }
+        boundary = buffer.indexOf("\n\n");
+      }
+    }
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+}
 
 // src/commands/login.ts
 function authPage(success, error) {
@@ -20242,7 +20296,7 @@ function authPage(success, error) {
 <body>
   <div class="card">
     <div class="logo">
-      <svg width="24" height="24" viewBox="0 0 52 36" fill="none"><polygon points="44,18 8,6 13,18 8,30" stroke="#C8E0FF" stroke-width="2.5" fill="none"/></svg>
+      <svg width="24" height="24" viewBox="0 0 52 36" fill="none" style="transform:rotate(-45deg)"><polygon points="44,18 8,6 13,18 8,30" stroke="#C8E0FF" stroke-width="2.5" fill="none"/></svg>
       Launchmatic
     </div>
     <div class="icon">${icon}</div>
@@ -20303,7 +20357,9 @@ function waitForOAuth(apiUrl) {
       if (settled) return false;
       settled = true;
       rl.close();
-      process.stdin.unref();
+      if (typeof process.stdin.unref === "function") {
+        process.stdin.unref();
+      }
       server.close();
       server.unref();
       return true;
@@ -21328,6 +21384,20 @@ function detectLocal(cwd) {
   if (existsSync2(join(cwd, "package.json"))) {
     const pkg = readPkg(cwd);
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (deps?.["stirrup-ai"]) {
+      return {
+        runtime: "nodejs",
+        framework: "Stirrup",
+        buildCmd: "npm install",
+        startCmd: "npx stirrup serve",
+        port: 3711,
+        confidence: "high",
+        recommendedStorageGi: 2,
+        recommendedStorageMountPath: "/data",
+        recommendedMemory: "1Gi",
+        requiredEnvVars: ["ANTHROPIC_API_KEY"]
+      };
+    }
     const hasIndex = existsSync2(join(cwd, "index.html")) || existsSync2(join(cwd, "public", "index.html"));
     const hasServerDep = Object.keys(deps || {}).some(
       (d) => /^(express|fastify|next|nuxt|remix|gatsby|astro|vite|svelte|@angular|react-scripts|koa|hapi|nestjs)/.test(
@@ -25179,9 +25249,241 @@ function registerDeployments(program3) {
   });
 }
 
+// src/commands/agent.ts
+import readline6 from "readline";
+async function callAgent(message, threadId, systemHint) {
+  return api("/api/v1/agent", {
+    method: "POST",
+    body: JSON.stringify({
+      message,
+      thread_id: threadId,
+      system_hint: systemHint
+    })
+  });
+}
+async function streamAgentToTerminal(message, threadId, systemHint, showTools) {
+  const events = streamApi("/api/v1/agent/stream", {
+    method: "POST",
+    body: JSON.stringify({
+      message,
+      thread_id: threadId,
+      system_hint: systemHint
+    })
+  });
+  const summary = {
+    threadId: null,
+    text: "",
+    toolCalls: 0,
+    iterations: 0,
+    failed: false
+  };
+  let textStarted = false;
+  for await (const event of events) {
+    switch (event.type) {
+      case "thread":
+        summary.threadId = event.thread_id;
+        break;
+      case "iteration_start":
+        summary.iterations = event.n;
+        break;
+      case "text_delta":
+        if (!textStarted) {
+          process.stdout.write(source_default.cyan("agent: "));
+          textStarted = true;
+        }
+        process.stdout.write(event.delta);
+        summary.text += event.delta;
+        break;
+      case "tool_call":
+        if (showTools) {
+          if (textStarted) process.stdout.write("\n");
+          process.stdout.write(source_default.dim(`  \u2192 ${event.name}`));
+          summary.toolCalls++;
+        }
+        break;
+      case "tool_result":
+        if (showTools) {
+          if (event.ok) process.stdout.write(source_default.dim(` \u2713 ${event.summary}
+`));
+          else process.stdout.write(source_default.red(` \u2717 ${event.summary}
+`));
+          textStarted = false;
+        }
+        break;
+      case "error":
+        if (textStarted) process.stdout.write("\n");
+        process.stdout.write(source_default.red(`error: ${event.message}
+`));
+        summary.failed = true;
+        break;
+      case "done":
+        if (textStarted) process.stdout.write("\n");
+        break;
+    }
+  }
+  return summary;
+}
+function buildSystemHint(opts) {
+  const parts = [];
+  if (contextExists()) {
+    try {
+      const ctx = readContext();
+      parts.push(`Default project: ${ctx.projectId}. Default service: ${ctx.serviceId}.`);
+    } catch {
+    }
+  }
+  if (opts.service) parts.push(`User explicitly scoped this session to service: ${opts.service}.`);
+  if (opts.environment) parts.push(`User explicitly scoped this session to environment: ${opts.environment}.`);
+  return parts.length > 0 ? parts.join(" ") : null;
+}
+function printToolTrace(calls) {
+  for (const call of calls) {
+    const icon = call.error ? source_default.red("\u2717") : source_default.dim("\u2192");
+    const summary = call.error ? source_default.red(call.error) : source_default.dim("ok");
+    console.log(`  ${icon} ${source_default.cyan(call.name)} ${summary}`);
+  }
+}
+function prompt5(question) {
+  const rl = readline6.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve4) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve4(answer);
+    });
+  });
+}
+function registerAgent(program3) {
+  program3.command("agent").description("Talk to the Launchmatic agent \u2014 multi-step reasoning over your services").option("-p, --prompt <text>", "Run a single prompt and exit (non-interactive)").option("--json", "Emit machine-readable JSON instead of human-friendly text (disables streaming)").option("--no-stream", "Buffer the full response before printing (default: stream)").option("--thread-id <id>", "Continue an existing thread").option("--service <serviceId>", "Scope the session to a specific service").option("--environment <env>", "Scope the session to a specific environment (e.g. preview, production)").option("--show-tools", "Show each tool call the agent makes (default off in human mode)").action(async (opts) => {
+    if (!isLoggedIn()) {
+      console.error(source_default.red('Not logged in. Run "lm login" first.'));
+      process.exitCode = 1;
+      return;
+    }
+    const systemHint = buildSystemHint(opts);
+    let threadId = opts.threadId ?? null;
+    const useStream = opts.stream !== false && !opts.json;
+    if (opts.prompt) {
+      if (opts.json) {
+        try {
+          const res = await callAgent(opts.prompt, threadId, systemHint);
+          console.log(JSON.stringify(res, null, 2));
+        } catch (err) {
+          console.error(source_default.red(`Agent error: ${err instanceof Error ? err.message : String(err)}`));
+          process.exitCode = 1;
+        }
+        return;
+      }
+      if (useStream) {
+        try {
+          const summary = await streamAgentToTerminal(opts.prompt, threadId, systemHint, opts.showTools ?? false);
+          if (summary.failed) {
+            process.exitCode = 1;
+            return;
+          }
+          if (summary.threadId) {
+            console.log();
+            console.log(source_default.dim(`Thread: ${summary.threadId}  (resume with --thread-id ${summary.threadId})`));
+          }
+        } catch (err) {
+          console.error(source_default.red(`Agent error: ${err instanceof Error ? err.message : String(err)}`));
+          process.exitCode = 1;
+        }
+        return;
+      }
+      const spinner = ora("Thinking...").start();
+      try {
+        const res = await callAgent(opts.prompt, threadId, systemHint);
+        spinner.stop();
+        if (opts.showTools && res.tool_calls.length > 0) {
+          printToolTrace(res.tool_calls);
+          console.log();
+        }
+        console.log(res.text);
+        console.log();
+        console.log(source_default.dim(`Thread: ${res.thread_id}  (resume with --thread-id ${res.thread_id})`));
+      } catch (err) {
+        spinner.fail(source_default.red(`Agent error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exitCode = 1;
+      }
+      return;
+    }
+    console.log(source_default.bold.cyan("\n  Launchmatic Agent") + source_default.dim(" \u2014 type your request, /help for commands, /quit to exit"));
+    if (threadId) console.log(source_default.dim(`  Resuming thread ${threadId}
+`));
+    else console.log();
+    const rl = readline6.createInterface({ input: process.stdin, output: process.stdout });
+    const handleLine = async (line) => {
+      const text = line.trim();
+      if (!text) return false;
+      if (text === "/quit" || text === "/exit") return true;
+      if (text === "/help") {
+        console.log(source_default.dim("  /thread        show current thread id"));
+        console.log(source_default.dim("  /new           start a new thread"));
+        console.log(source_default.dim("  /tools         toggle tool-call display"));
+        console.log(source_default.dim("  /quit          exit"));
+        return false;
+      }
+      if (text === "/thread") {
+        console.log(source_default.dim(`  ${threadId ?? "(no thread yet)"}`));
+        return false;
+      }
+      if (text === "/new") {
+        threadId = null;
+        console.log(source_default.dim("  Started fresh thread."));
+        return false;
+      }
+      if (text === "/tools") {
+        opts.showTools = !opts.showTools;
+        console.log(source_default.dim(`  show-tools: ${opts.showTools ? "on" : "off"}`));
+        return false;
+      }
+      if (useStream) {
+        try {
+          const summary = await streamAgentToTerminal(text, threadId, systemHint, opts.showTools ?? false);
+          if (summary.threadId) threadId = summary.threadId;
+          console.log();
+        } catch (err) {
+          console.error(source_default.red(`Agent error: ${err instanceof Error ? err.message : String(err)}`));
+        }
+        return false;
+      }
+      const spinner = ora("Thinking...").start();
+      try {
+        const res = await callAgent(text, threadId, systemHint);
+        threadId = res.thread_id;
+        spinner.stop();
+        if (opts.showTools && res.tool_calls.length > 0) {
+          printToolTrace(res.tool_calls);
+          console.log();
+        }
+        console.log(source_default.cyan("agent:"), res.text);
+        console.log();
+      } catch (err) {
+        spinner.fail(source_default.red(`Agent error: ${err instanceof Error ? err.message : String(err)}`));
+      }
+      return false;
+    };
+    let done = false;
+    while (!done) {
+      const line = await new Promise((resolve4) => {
+        rl.question(source_default.cyan("> "), (answer) => resolve4(answer));
+        rl.once("close", () => resolve4(null));
+      });
+      if (line === null) {
+        done = true;
+        break;
+      }
+      done = await handleLine(line);
+    }
+    rl.close();
+    console.log(source_default.dim("\n  Bye."));
+    void prompt5;
+  });
+}
+
 // src/index.ts
 var program2 = new Command();
-program2.name("lm").description("Launchmatic CLI \u2014 deploy from your terminal").version("0.3.0");
+program2.name("lm").description("Launchmatic CLI \u2014 deploy from your terminal").version("0.4.0");
 registerLogin(program2);
 registerInit(program2);
 registerDeploy(program2);
@@ -25201,4 +25503,5 @@ registerUsage(program2);
 registerPreview(program2);
 registerApiKey(program2);
 registerDeployments(program2);
+registerAgent(program2);
 program2.parse();

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "@launchmatic/cli",
-  "version": "0.3.1",
-  "description": "Launchmatic CLI — deploy from your terminal",
-  "private": false,
-  "type": "module",
-  "bin": {
-    "lm": "dist/index.js",
-    "c": "dist/c.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsup",
-    "start": "node dist/index.js"
-  },
-  "dependencies": {
-    "playwright-core": "^1.58.2"
-  },
-  "devDependencies": {
-    "@launchmatic/tsconfig": "workspace:*",
-    "@launchmatic/validator": "workspace:*",
-    "@types/node": "^22.0.0",
-    "@types/ws": "^8.5.12",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "conf": "^13.0.1",
-    "open": "^10.1.0",
-    "ora": "^8.1.0",
-    "tsup": "^8.5.1",
-    "tsx": "^4.19.0",
-    "typescript": "^5.6.3",
-    "ws": "^8.18.0"
-  }
-}
+{
+  "name": "@launchmatic/cli",
+  "version": "0.4.0",
+  "description": "Launchmatic CLI — deploy from your terminal",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "lm": "dist/index.js",
+    "c": "dist/c.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "playwright-core": "^1.58.2"
+  },
+  "devDependencies": {
+    "@launchmatic/tsconfig": "workspace:*",
+    "@launchmatic/validator": "workspace:*",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.12",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "open": "^10.1.0",
+    "ora": "^8.1.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.3",
+    "ws": "^8.18.0"
+  }
+}