robodev 0.29.0 → 0.31.0

package/src/frontend-build.test.ts

@@ -32,27 +32,54 @@ test("resolveFrontendPaths keeps outDir inside the project", () => {
   );
 });
 
-test("mapFrontendOutDir remaps text files and skips binaries", async () => {
+test("mapFrontendOutDir remaps text files and includes public binaries", async () => {
   const out = await mkdtemp(join(tmpdir(), "rd-out-"));
   try {
     await writeFile(join(out, "index.html"), "<html><body>app</body></html>");
     await mkdir(join(out, "assets"), { recursive: true });
     await writeFile(join(out, "assets/index-abc.js"), "console.log(1)");
     await writeFile(join(out, "assets/index-abc.css"), "body{color:red}");
-    await writeFile(join(out, "assets/font.woff2"), "binary-font");
-    await writeFile(join(out, "icon.png"), "binary-png");
-    const { files, skippedBinaries } = await mapFrontendOutDir(out);
+    await writeFile(join(out, "assets/font.woff2"), Buffer.from("binary-font"));
+    await writeFile(join(out, "icon.png"), Buffer.from("binary-png"));
+    const files = await mapFrontendOutDir(out);
     const paths = new Set(files.map((file) => file.path));
     assert.ok(paths.has("index.html"));
     assert.ok(paths.has("public/assets/index-abc.js"));
     assert.ok(paths.has("public/assets/index-abc.css"));
-    assert.ok(!paths.has("public/assets/font.woff2"));
-    assert.ok(!paths.has("public/icon.png"));
-    assert.equal(skippedBinaries, true);
+    assert.ok(paths.has("public/assets/font.woff2"));
+    assert.ok(paths.has("public/icon.png"));
     assert.equal(
       files.find((file) => file.path === "index.html")?.content,
       "<html><body>app</body></html>",
     );
+    assert.equal(
+      files.find((file) => file.path === "public/assets/font.woff2")?.content,
+      Buffer.from("binary-font").toString("base64"),
+    );
+    assert.equal(
+      files.find((file) => file.path === "public/icon.png")?.content,
+      Buffer.from("binary-png").toString("base64"),
+    );
+  } finally {
+    await rm(out, { recursive: true, force: true });
+  }
+});
+
+test("mapFrontendOutDir throws when dist still has denied files", async () => {
+  const out = await mkdtemp(join(tmpdir(), "rd-out-skip-"));
+  try {
+    await writeFile(join(out, "index.html"), "<html></html>");
+    await mkdir(join(out, "assets"), { recursive: true });
+    await writeFile(join(out, "assets/app.wasm"), Buffer.from("wasm"));
+    await writeFile(join(out, "clip.mp4"), Buffer.from("mp4"));
+    await assert.rejects(
+      () => mapFrontendOutDir(out),
+      (err: unknown) =>
+        err instanceof Error &&
+        /cannot be uploaded/.test(err.message) &&
+        err.message.includes("public/assets/app.wasm") &&
+        err.message.includes("public/clip.mp4"),
+    );
   } finally {
     await rm(out, { recursive: true, force: true });
   }

package/src/frontend-build.ts

@@ -2,7 +2,12 @@ import { execFile, spawn } from "node:child_process";
 import { readdir, readFile, stat } from "node:fs/promises";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import { promisify } from "node:util";
-import { assertCollectedFile, type CollectedFile, shouldCollectPath } from "./collect-files.js";
+import {
+  assertCollectedFile,
+  type CollectedFile,
+  readCollectedContent,
+  shouldCollectPath,
+} from "./collect-files.js";
 import { isFrontendConfig, normalizeFrontendConfig, type FrontendConfig } from "./config.js";
 
 const execFileAsync = promisify(execFile);
@@ -132,12 +137,9 @@ function mappedDeployPath(relFromOutDir: string): string {
   return `public/${rel}`;
 }
 
-export async function mapFrontendOutDir(outDirAbs: string): Promise<{
-  files: CollectedFile[];
-  skippedBinaries: boolean;
-}> {
+export async function mapFrontendOutDir(outDirAbs: string): Promise<CollectedFile[]> {
   const files: CollectedFile[] = [];
-  let skippedBinaries = false;
+  const skipped: string[] = [];
 
   async function walk(dir: string): Promise<void> {
     let entries;
@@ -156,10 +158,10 @@ export async function mapFrontendOutDir(outDirAbs: string): Promise<{
       const rel = relative(outDirAbs, abs).replaceAll("\\", "/");
       const deployPath = mappedDeployPath(rel);
       if (!shouldCollectPath(deployPath)) {
-        skippedBinaries = true;
+        skipped.push(deployPath);
         continue;
       }
-      const content = await readFile(abs, "utf8");
+      const content = await readCollectedContent(abs, deployPath);
       const file = { path: deployPath, content };
       assertCollectedFile(file);
       files.push(file);
@@ -167,7 +169,24 @@ export async function mapFrontendOutDir(outDirAbs: string): Promise<{
   }
 
   await walk(outDirAbs);
-  return { files, skippedBinaries };
+  if (skipped.length > 0) {
+    throw new Error(
+      `Frontend build produced files that cannot be uploaded: ${skipped.sort().join(", ")}`,
+    );
+  }
+  return files;
+}
+
+export async function frontendOutIndexExists(
+  projectRoot: string,
+  frontend: FrontendConfig,
+): Promise<boolean> {
+  try {
+    const { outAbs } = resolveFrontendPaths(projectRoot, frontend);
+    return (await stat(join(outAbs, "index.html"))).isFile();
+  } catch {
+    return false;
+  }
 }
 
 export async function buildAndCollectFrontend(
@@ -199,14 +218,9 @@ export async function buildAndCollectFrontend(
     throw new Error(`Frontend build did not produce ${join(outAbs, "index.html")}`);
   }
 
-  const { files, skippedBinaries } = await mapFrontendOutDir(outAbs);
+  const files = await mapFrontendOutDir(outAbs);
   if (!files.some((file) => file.path === "index.html")) {
     throw new Error(`Frontend build did not produce ${join(outAbs, "index.html")}`);
   }
-  if (skippedBinaries) {
-    console.log(
-      "Skipped binary frontend assets (fonts/images). Hosted UI may use system font fallback.",
-    );
-  }
   return files;
 }

package/src/index.ts

@@ -23,7 +23,11 @@ import {
 } from "./config.js";
 import { waitUntilLive } from "./wait-until-live.js";
 import { collectFiles, mergeCollectedFiles, type CollectedFile } from "./collect-files.js";
-import { buildAndCollectFrontend, commandAvailable } from "./frontend-build.js";
+import {
+  buildAndCollectFrontend,
+  commandAvailable,
+  frontendOutIndexExists,
+} from "./frontend-build.js";
 import {
   emitStarter,
   loadCatalog,
@@ -49,6 +53,15 @@ Commands:
   create [path] [--starter <id>] [--empty] [--org <id>]  Create a project, scaffold a starter, and deploy
   link [projectId]     Write robodev/.robodev in the current folder
   deploy [--force]     Deploy schema, APIs, jobs, and frontend (local Vite build when .robodev frontend is set)
+  dev [options]        Run this project's APIs locally on an embedded Postgres, no Starbase needed
+
+dev options:
+  --port <n>           API port (default 4000)
+  --db-port <n>        Postgres port (default 0 = pick a free one)
+  --database-url <url> Use an existing Postgres instead of the embedded one
+  --force              Apply destructive schema changes
+  --no-watch           Compile once and serve, without watching files
+  --with-fe            Also start apps/fe with VITE_API_URL pointed at the local API
 `);
   process.exit(1);
 }
@@ -538,6 +551,9 @@ async function runCreate(args: string[]): Promise<void> {
       });
       feHosted = true;
     } catch (error) {
+      if (await frontendOutIndexExists(root, defaultFrontendConfig())) {
+        throw error;
+      }
       console.log(error instanceof Error ? error.message : error);
       console.log("Frontend build failed. Deploying schema and APIs only.");
       skipFrontendBuild = true;
@@ -618,6 +634,11 @@ async function main(): Promise<void> {
     case "deploy":
       await runDeploy(args.includes("--force"));
       break;
+    case "dev": {
+      const { main: runDev } = await import("./dev.js");
+      await runDev(args);
+      break;
+    }
     default:
       usage();
   }

package/templates/auth-chat/.rulesync/rules/project-overview.md

@@ -13,7 +13,7 @@ cursor:
 
 This project is a Vite React frontend in `apps/fe` plus a Robodev backend under **`robodev/`** (`robodev/database.ts` + `robodev/api/**/*.ts` + `robodev/hooks/auth.ts` using `@robodev-ai/sdk`). There is no Expo / mobile app in this starter. End-user auth is reserved on the project host at `/api/user/*`. There is no in-browser fake backend.
 
-`robodev deploy` from this root uploads schema and APIs. It does not host the Povio SPA. Run the UI with bun in `apps/fe`.
+`robodev deploy` from this root uploads schema, APIs, and (when `.robodev` has a `frontend` block) the local Vite build as a hosted static SPA. Use bun in `apps/fe` to iterate locally.
 
 Shared AI rules and skills are authored in `.rulesync/`. Generated files for Codex, Claude Code, and Cursor are local outputs and should be regenerated with `bun rules:gen`.
 

package/templates/auth-chat/apps/fe/package.json

@@ -5,7 +5,7 @@
   "description": "Auth chat starter frontend",
   "type": "module",
   "scripts": {
-    "dev": "bunx --bun vite",
+    "dev": "vite --host",
     "build": "bun run openapi:gen && bunx --bun vite build",
     "clean": "rimraf dist src/openapi",
     "lint": "oxlint --type-aware . ../../robodev/api ../../robodev/database.ts --fix",

package/templates/auth-chat/package.json

@@ -4,14 +4,15 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "dev": "robodev dev --with-fe",
     "deploy": "robodev deploy",
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.8.0"
+    "@robodev-ai/sdk": "^0.10.0"
   },
   "devDependencies": {
-    "robodev": "^0.29.0",
+    "robodev": "^0.31.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }

package/templates/backend/package.json

@@ -4,13 +4,14 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "dev": "robodev dev",
     "deploy": "robodev deploy"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.8.0"
+    "@robodev-ai/sdk": "^0.10.0"
   },
   "devDependencies": {
-    "robodev": "^0.29.0",
+    "robodev": "^0.31.0",
     "typescript": "^5.9.2"
   }
 }

package/templates/empty/package.json

@@ -4,13 +4,14 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "dev": "robodev dev",
     "deploy": "robodev deploy"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.8.0"
+    "@robodev-ai/sdk": "^0.10.0"
   },
   "devDependencies": {
-    "robodev": "^0.29.0",
+    "robodev": "^0.31.0",
     "typescript": "^5.9.2"
   }
 }

package/templates/marketplace/.rulesync/rules/project-overview.md

@@ -13,7 +13,7 @@ cursor:
 
 This project is a Vite React frontend in `apps/fe` plus a Robodev backend under **`robodev/`** (`robodev/database.ts` + `robodev/api/**/*.ts` using `@robodev-ai/sdk`). There is no Expo / mobile app in this starter. End-user auth is reserved on the project host at `/api/user/*`. There is no in-browser fake backend.
 
-`robodev deploy` from this root uploads schema and APIs. It does not host the Povio SPA. Run the UI with bun in `apps/fe`.
+`robodev deploy` from this root uploads schema, APIs, and (when `.robodev` has a `frontend` block) the local Vite build as a hosted static SPA. Use bun in `apps/fe` to iterate locally.
 
 Shared AI rules and skills are authored in `.rulesync/`. Generated files for Codex, Claude Code, and Cursor are local outputs and should be regenerated with `bun rules:gen`.
 

package/templates/marketplace/apps/fe/package.json

@@ -5,7 +5,7 @@
   "description": "Marketplace starter frontend",
   "type": "module",
   "scripts": {
-    "dev": "bunx --bun vite",
+    "dev": "vite --host",
     "build": "bun run openapi:gen && bunx --bun vite build",
     "clean": "rimraf dist src/openapi",
     "lint": "oxlint --type-aware . ../../robodev/api ../../robodev/database.ts --fix",

package/templates/marketplace/package.json

@@ -4,14 +4,15 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "dev": "robodev dev --with-fe",
     "deploy": "robodev deploy",
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.8.0"
+    "@robodev-ai/sdk": "^0.10.0"
   },
   "devDependencies": {
-    "robodev": "^0.29.0",
+    "robodev": "^0.31.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }

package/templates/space/.rulesync/rules/project-overview.md

@@ -13,7 +13,7 @@ cursor:
 
 This project is a Vite React frontend in `apps/fe` plus a Robodev backend under **`robodev/`** (`robodev/database.ts` + `robodev/api/**/*.ts` using `@robodev-ai/sdk`). There is no Expo / mobile app in this starter. End-user auth is reserved on the project host at `/api/user/*`. There is no in-browser fake backend.
 
-`robodev deploy` from this root uploads schema and APIs. It does not host the Povio SPA. Run the UI with bun in `apps/fe`.
+`robodev deploy` from this root uploads schema, APIs, and (when `.robodev` has a `frontend` block) the local Vite build as a hosted static SPA. Use bun in `apps/fe` to iterate locally.
 
 Shared AI rules and skills are authored in `.rulesync/`. Generated files for Codex, Claude Code, and Cursor are local outputs and should be regenerated with `bun rules:gen`.
 

package/templates/space/apps/fe/package.json

@@ -5,7 +5,7 @@
   "description": "Space starter frontend",
   "type": "module",
   "scripts": {
-    "dev": "bunx --bun vite",
+    "dev": "vite --host",
     "build": "bun run openapi:gen && bunx --bun vite build",
     "clean": "rimraf dist src/openapi",
     "lint": "oxlint --type-aware . ../../robodev/api ../../robodev/database.ts --fix",

package/templates/space/package.json

@@ -4,14 +4,15 @@
   "private": true,
   "type": "module",
   "scripts": {
+    "dev": "robodev dev --with-fe",
     "deploy": "robodev deploy",
     "rules:gen": "rulesync generate"
   },
   "dependencies": {
-    "@robodev-ai/sdk": "^0.8.0"
+    "@robodev-ai/sdk": "^0.10.0"
   },
   "devDependencies": {
-    "robodev": "^0.29.0",
+    "robodev": "^0.31.0",
     "rulesync": "^8.18.0",
     "typescript": "^5.9.2"
   }