lakebed 0.0.1 → 0.0.2

package/README.md

@@ -83,7 +83,7 @@ lakebed logs [deploy-id-or-url] [--port 3000]
 Once a Lakebed deploy runner is available, deploy a capsule with:
 
 ```sh
-lakebed deploy my-app --api https://api.lakebed.app
+lakebed deploy my-app
 ```
 
 For local deploy-runner testing:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lakebed",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Agent-native CLI and runtime for building and deploying Lakebed capsules.",
   "license": "UNLICENSED",
   "type": "module",

package/src/anonymous.js

@@ -484,7 +484,7 @@ function compileServerToIr(app, schema) {
   return { diagnostics, mutations, queries };
 }
 
-export async function createAnonymousArtifact({ app, clientOut, sourceStore, version = "0.0.1" }) {
+export async function createAnonymousArtifact({ app, clientOut, sourceStore, version = "0.0.2" }) {
   const sourceFiles = await readSourceFiles(sourceStore);
   const diagnostics = forbiddenSourceDiagnostics(sourceFiles);
   const { diagnostics: schemaDiagnostics, schema } = serializeSchema(app.schema);

package/src/cli.js

@@ -21,6 +21,7 @@ const root = process.cwd();
 const packageDir = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const packageNodeModules = resolve(packageDir, "node_modules");
 const sourceNamespace = "lakebed-source";
+const defaultDeployApiUrl = "https://api.lakebed.app";
 
 function usage() {
   console.log(`lakebed
@@ -649,10 +650,7 @@ async function buildCommand(args) {
 }
 
 function deployApiUrl(args) {
-  return String(readArg(args, "--api", process.env.LAKEBED_DEPLOY_API ?? process.env.SPAN_DEPLOY_API ?? "http://localhost:8787")).replace(
-    /\/+$/g,
-    ""
-  );
+  return String(readArg(args, "--api", process.env.LAKEBED_DEPLOY_API ?? process.env.SPAN_DEPLOY_API ?? defaultDeployApiUrl)).replace(/\/+$/g, "");
 }
 
 async function readResponseJson(response) {
@@ -672,7 +670,7 @@ async function deployCommand(args) {
     body: JSON.stringify({
       artifact: envelope.artifact,
       clientBundle: envelope.clientBundle,
-      clientVersion: "0.0.1",
+      clientVersion: "0.0.2",
       requestedTtlSeconds: ttl
     }),
     headers: {
@@ -813,9 +811,67 @@ async function dbCommand(args) {
   usage();
 }
 
+function agentInstructionsTemplate() {
+  return `# Lakebed App Instructions
+
+This is a Lakebed capsule. Build the app inside this directory using the Lakebed v0 contract.
+
+## File Layout
+
+- \`server/index.ts\`: schema, queries, and mutations.
+- \`client/index.tsx\`: Preact UI entrypoint.
+- \`shared/\`: pure TypeScript shared by client and server.
+
+## Commands
+
+Run locally:
+
+\`\`\`sh
+lakebed dev .
+\`\`\`
+
+Deploy:
+
+\`\`\`sh
+lakebed deploy .
+\`\`\`
+
+Inspect local state while \`lakebed dev\` is running:
+
+\`\`\`sh
+lakebed db list --port 3000
+lakebed db dump --port 3000
+lakebed logs --port 3000
+\`\`\`
+
+## Rules
+
+- Use \`lakebed/server\` only from \`server/index.ts\`.
+- Use \`lakebed/client\` only from \`client/index.tsx\`.
+- Do not import npm packages from app code.
+- Do not use Node built-ins in app code.
+- Use Tailwind classes directly in JSX.
+- Do not add a CSS, PostCSS, or Tailwind build pipeline.
+- Use guest auth through \`ctx.auth\` on the server and \`useAuth()\` on the client.
+- Keep \`shared/\` free of DOM, Node, env, and Lakebed runtime imports.
+
+## Current Limits
+
+- One server entry.
+- One client entry.
+- Guest auth only.
+- No file storage.
+- No outbound fetch in anonymous deploys.
+- Local state resets when \`lakebed dev\` restarts.
+`;
+}
+
 function todoTemplate(name) {
   const title = basename(name);
+  const agentInstructions = agentInstructionsTemplate();
   return {
+    "AGENTS.md": agentInstructions,
+    "CLAUDE.md": agentInstructions,
     "server/index.ts": `import { boolean, capsule, mutation, query, string, table } from "lakebed/server";
 import { cleanTodoText } from "../shared/todo";