openpouch 0.2.1 → 0.2.3

package/README.md

@@ -10,6 +10,13 @@ npx openpouch deploy
 
 You get a live `https://<slug>.openpouch.sh` URL plus a claim link. The agent deploys autonomously; a human claims it via the link to keep it. openpouch writes the deployment truth (`deploy.manifest.json`, `deploy.evidence.json`, `DEPLOYMENT.md`) back into your repo, so any agent can resume after context loss.
 
+> **Framework frontends (React/Vite/Next/Svelte…): deploy the _built output_, not the source folder.** Build first, then point `deploy` at the build directory:
+> ```bash
+> npm run build
+> npx openpouch deploy dist     # Vite → dist/ · CRA → build/ · Next static export → out/
+> ```
+> If you run `openpouch deploy` in an unbuilt frontend root, it **stops and tells you which folder to deploy** instead of silently shipping source that won't run (use `openpouch deploy .` to force the current folder). Server-side build-on-deploy is on the roadmap.
+
 ## Accounts (optional)
 
 Start anonymous, or create a free account for higher limits — entirely from the agent, no dashboard:

package/openpouch.js

@@ -5129,7 +5129,7 @@ async function approveCommand(ctx, requestId) {
 }
 
 // packages/cli/src/deploy-engine.ts
-var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var sleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
 var TERMINAL = /* @__PURE__ */ new Set(["live", "failed", "canceled"]);
 async function runSmokeChecks(url, healthcheck) {
   const check = healthcheck ?? { path: "/", expectStatus: 200, timeoutMs: 1e4 };
@@ -5363,6 +5363,7 @@ function renderAgentsSection(projectName) {
     "",
     `${projectName} deploys via openpouch \u2014 an agent-native deployment control plane. This works the same from any agent harness.`,
     "",
+    "- **Framework frontends (React/Vite/Next/Svelte\u2026): deploy the _built output_, not the source folder.** Build first, then point deploy at the build directory: `npm run build`, then `openpouch deploy dist` (Vite\u2192`dist/`, CRA\u2192`build/`, Next static export\u2192`out/`). Running `openpouch deploy` in an unbuilt frontend root is refused with the right folder to use (`openpouch deploy .` forces the current folder); server-side build-on-deploy is on the roadmap.",
     "- **Deployment truth** (what is live, where, which commit, rollback anchor): read `DEPLOYMENT.md` or `deploy.evidence.json`. Config lives in `deploy.manifest.json`, agent permissions in `deploy.policy.json`.",
     "- **CLI:** `openpouch inspect` \xB7 `plan` \xB7 `preview` (autonomous if policy allows) \xB7 `prod` \xB7 `verify` \xB7 `logs` \xB7 `rollback`. Add `--json` for a single machine-readable JSON object; errors come as `{category, message, fix}` \u2014 act on the fix. Exit codes are documented API.",
     "- **Relay the `summary` to your human:** every result (CLI `--json` and MCP) carries a top-level `summary` \u2014 plain-language, jargon-free text written for a non-technical operator. Pass it on verbatim: it says what happened, whether the app is live and healthy, the live link, and what (if anything) the human needs to do. The **live URL is the primary result** \u2014 on a successful deploy it's the top-level `url` field, ready to share.",
@@ -5627,8 +5628,8 @@ async function initCommand(ctx, flags) {
 
 // packages/cli/src/commands/instant.ts
 import { spawn } from "node:child_process";
-import { readFile as readFile7 } from "node:fs/promises";
-import { basename as basename2, join as join7 } from "node:path";
+import { readFile as readFile7, stat } from "node:fs/promises";
+import { basename as basename2, join as join7, resolve } from "node:path";
 var TAR_EXCLUDES = [
   "./node_modules",
   "./.git",
@@ -5641,7 +5642,7 @@ var TAR_EXCLUDES = [
   "./.openpouch"
 ];
 function buildTarball(cwd) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const args = ["-czf", "-", ...TAR_EXCLUDES.flatMap((e) => ["--exclude", e]), "-C", cwd, "."];
     const tar = spawn("tar", args, { stdio: ["ignore", "pipe", "pipe"] });
     const chunks = [];
@@ -5650,7 +5651,7 @@ function buildTarball(cwd) {
     tar.stderr.on("data", (c) => stderr += String(c));
     tar.on("error", reject);
     tar.on("close", (code) => {
-      if (code === 0) resolve(Buffer.concat(chunks));
+      if (code === 0) resolve2(Buffer.concat(chunks));
       else reject(new Error(`tar exited ${code}: ${stderr.trim().slice(0, 300)}`));
     });
   });
@@ -5663,7 +5664,49 @@ async function projectHint(cwd) {
   }
   return basename2(cwd) || "joey";
 }
-async function instantCommand(ctx) {
+async function unbuiltFrontendHint(dir) {
+  const buildDirs = [];
+  for (const c of ["dist", "build", "out"]) {
+    try {
+      if ((await stat(join7(dir, c))).isDirectory()) buildDirs.push(c);
+    } catch {
+    }
+  }
+  let html;
+  try {
+    html = await readFile7(join7(dir, "index.html"), "utf8");
+  } catch {
+    html = void 0;
+  }
+  const devEntry = html !== void 0 && (/src=["']\/?src\//.test(html) || /\.(jsx|tsx|ts|vue|svelte)["']/.test(html));
+  let noEntrySpa = false;
+  if (html === void 0) {
+    try {
+      const pkg = JSON.parse(await readFile7(join7(dir, "package.json"), "utf8"));
+      if (pkg.scripts?.["build"]) {
+        try {
+          noEntrySpa = (await stat(join7(dir, "src"))).isDirectory();
+        } catch {
+          noEntrySpa = false;
+        }
+      }
+    } catch {
+    }
+  }
+  return { buildDirs, isUnbuilt: devEntry || noEntrySpa };
+}
+async function instantCommand(ctx, dir) {
+  const explicitDir = dir !== void 0 && dir !== "";
+  const targetDir = explicitDir ? resolve(ctx.cwd, dir) : ctx.cwd;
+  if (explicitDir) {
+    try {
+      if (!(await stat(targetDir)).isDirectory()) {
+        return errorResult(EXIT.USAGE, "usage", `not a directory: ${dir}`, "Pass a folder to deploy, e.g. `openpouch deploy dist`.");
+      }
+    } catch {
+      return errorResult(EXIT.USAGE, "usage", `folder not found: ${dir}`, "Pass an existing folder, e.g. `openpouch deploy dist`.");
+    }
+  }
   const loaded = await loadManifest(ctx.cwd);
   if (loaded.status === "ok") {
     const envs = Object.values(loaded.manifest.environments ?? {});
@@ -5677,9 +5720,16 @@ async function instantCommand(ctx) {
       );
     }
   }
+  if (!explicitDir) {
+    const { buildDirs, isUnbuilt } = await unbuiltFrontendHint(targetDir);
+    if (isUnbuilt) {
+      const fix = buildDirs.length > 0 ? `This looks like an unbuilt frontend. Deploy the build output instead: \`openpouch deploy ${buildDirs[0]}\` \u2014 or \`openpouch deploy .\` to ship this folder as-is.` : "This looks like an unbuilt frontend (index.html references source modules). Build first, then deploy the build folder: `npm run build`, then `openpouch deploy dist` \u2014 or `openpouch deploy .` to ship this folder as-is.";
+      return errorResult(EXIT.USAGE, "usage", "refusing to deploy what looks like unbuilt frontend source", fix);
+    }
+  }
   let tarball;
   try {
-    tarball = await buildTarball(ctx.cwd);
+    tarball = await buildTarball(targetDir);
   } catch (e) {
     return errorResult(EXIT.UNEXPECTED, "provider", `could not package the project: ${e.message}`, "Ensure `tar` is available and the directory is readable.");
   }
@@ -6222,7 +6272,7 @@ var USAGE = [
   "usage: openpouch <command> [--json]",
   "",
   "commands:",
-  "  deploy         zero-config instant preview on openpouch's own infra (anonymous, or under your account if a key is set)",
+  "  deploy [dir]   zero-config instant preview on openpouch's own infra \u2014 deploys ./<dir> (e.g. `deploy dist`) or the current folder (anonymous, or under your account if a key is set)",
   "  signup         create an openpouch account: --email <addr> or --github (gives you an API key)",
   "  activate       finish an email signup: --account <id> --token <token> (saves your API key)",
   "  whoami         show the account behind your API key: tier + current usage",
@@ -6296,7 +6346,7 @@ async function run(argv, ctx) {
   try {
     switch (command) {
       case "deploy":
-        return render(await instantCommand(ctx), json);
+        return render(await instantCommand(ctx, parsed.positionals[1]), json);
       case "signup":
         return render(await signupCommand(ctx, { email: parsed.values.email, github: parsed.values.github === true }), json);
       case "activate":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpouch",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "openpouch 🦘 — agent-native hosting, built for coding agents. Deploy any folder to a live URL in one command: npx openpouch deploy",
   "license": "Apache-2.0",
   "type": "module",