deployai 0.1.0-beta.6 → 0.1.0-beta.8

package/README.md

@@ -38,7 +38,7 @@ Node 20 or newer. No other setup: the CLI talks to https://deployai.co.il.
 
 | Command | What it does |
 |---------|--------------|
-| `deployai init` | Creates `DEPLOYAI.md` (rules for the AI agent) and `.deployai/project.json`. Never edits your code and does not link a project (use `link`). `--force` overwrites `DEPLOYAI.md`. |
+| `deployai init` | Creates `DEPLOYAI.md` (rules for the AI agent: the stack to build with, what to avoid, how to keep existing data), adds one line pointing to it in `AGENTS.md` and `CLAUDE.md`, and `.deployai/project.json`. Run it first in a new project, even an empty folder. Never edits your code and does not link a project (use `link`). `--force` overwrites `DEPLOYAI.md`, `--no-agent-files` leaves `AGENTS.md` and `CLAUDE.md` alone. |
 | `deployai inspect` | Shows framework, package manager, language, database, storage and the number of env files (values are never read). `--json` for machine output. |
 | `deployai check` | Lists blockers and warnings with file and line. It answers only whether the project can run on DeployAI. More below. |
 | `deployai login` | Logs in through the browser (device code). The token lasts 30 days and is stored in `~/.deployai/config.json` with the API address that issued it; it is never sent to another address. |

package/dist/index.js

@@ -21365,7 +21365,7 @@ var CLI_MAP_NODES = [
   n("cmd-start", "cli", "start <id>", "\u05DE\u05DB\u05D9\u05DF \u05D0\u05EA \u05D4\u05EA\u05D9\u05E7\u05D9\u05D9\u05D4 \u05DC\u05E4\u05D9 \u05DB\u05DC \u05D4\u05D1\u05D7\u05D9\u05E8\u05D5\u05EA: \u05EA\u05D9\u05E7\u05D9\u05D9\u05D4, \u05D3\u05D5\u05D2\u05DE\u05D4 \u05D5\u05D4\u05EA\u05E7\u05E0\u05D4, \u05E7\u05D5\u05D1\u05E5 \u05D4\u05E4\u05E8\u05D8\u05D9\u05DD \u05D5\u05D7\u05D9\u05D1\u05D5\u05E8 \u05DC\u05D0\u05EA\u05E8. \u05DE\u05D3\u05E4\u05D9\u05E1 \u05DC\u05E1\u05D5\u05DB\u05DF \u05D0\u05EA \u05D4\u05D8\u05E7\u05E1\u05D8 \u05D5\u05D0\u05EA \u05D4\u05E4\u05E7\u05D5\u05D3\u05D5\u05EA.", "Prepares the folder with every choice: folder, sample and install, the details file and the site link. Prints the text and the commands for the agent."),
   n("cmd-samples", "cli", "samples [key]", "\u05E8\u05E9\u05D9\u05DE\u05EA \u05D4\u05D3\u05D5\u05D2\u05DE\u05D0\u05D5\u05EA, \u05D0\u05D5 \u05D4\u05D5\u05E8\u05D3\u05D4 \u05E9\u05DC \u05D0\u05D7\u05EA.", "Lists the samples, or downloads one."),
   n("cmd-check", "cli", "check", "\u05D4\u05D0\u05DD \u05D4\u05E4\u05E8\u05D5\u05D9\u05E7\u05D8 \u05D9\u05DB\u05D5\u05DC \u05DC\u05E8\u05D5\u05E5 \u05D0\u05E6\u05DC\u05E0\u05D5: \u05D7\u05D5\u05E1\u05DE\u05D9\u05DD \u05D5\u05D0\u05D6\u05D4\u05E8\u05D5\u05EA, \u05E2\u05DD \u05E4\u05E8\u05D5\u05DE\u05E4\u05D8 \u05EA\u05D9\u05E7\u05D5\u05DF.", "Can the project run on our hosting: blockers and warnings, with a fix prompt."),
-  n("cmd-init", "cli", "init", "\u05D9\u05D5\u05E6\u05E8 DEPLOYAI.md \u05D5 .deployai/project.json.", "Creates DEPLOYAI.md and .deployai/project.json."),
+  n("cmd-init", "cli", "init", "\u05D9\u05D5\u05E6\u05E8 DEPLOYAI.md \u05E2\u05DD \u05D4\u05DB\u05DC\u05DC\u05D9\u05DD \u05DC\u05E1\u05D5\u05DB\u05DF, \u05E9\u05D5\u05E8\u05D4 \u05D0\u05DC\u05D9\u05D5 \u05D1 AGENTS.md \u05D5 CLAUDE.md, \u05D5 .deployai/project.json. \u05E8\u05D0\u05E9\u05D5\u05DF \u05D1\u05E4\u05E8\u05D5\u05D9\u05E7\u05D8 \u05D7\u05D3\u05E9.", "Creates DEPLOYAI.md with the agent rules, a line to it in AGENTS.md and CLAUDE.md, and .deployai/project.json. First in a new project."),
   n("cmd-inspect", "cli", "inspect", "\u05DE\u05D4 \u05D6\u05D5\u05D4\u05D4 \u05D1\u05E4\u05E8\u05D5\u05D9\u05E7\u05D8: \u05DE\u05E1\u05D2\u05E8\u05EA, \u05E9\u05E4\u05D4, \u05DE\u05E1\u05D3 \u05E0\u05EA\u05D5\u05E0\u05D9\u05DD.", "What the project is: framework, language, database."),
   n("cmd-login", "cli", "login", "\u05DB\u05E0\u05D9\u05E1\u05D4 \u05D1\u05D3\u05E4\u05D3\u05E4\u05DF, \u05D1\u05E2\u05DC \u05D4\u05D0\u05EA\u05E8 \u05DE\u05D0\u05E9\u05E8.", "Login in the browser, the owner approves."),
   n("cmd-logout", "cli", "logout", "\u05DE\u05D1\u05D8\u05DC \u05D0\u05EA \u05D4\u05D8\u05D5\u05E7\u05DF \u05D5\u05D9\u05D5\u05E6\u05D0 \u05DE\u05D4\u05D7\u05E9\u05D1\u05D5\u05DF \u05D1\u05DE\u05D7\u05E9\u05D1 \u05D4\u05D6\u05D4.", "Cancels the token and logs out on this computer."),
@@ -21643,6 +21643,26 @@ var SPACES = {
   test: build("test", { ...CLOUDFLARE_SPACES.prod, kvNamespaceId: "", sitesZoneId: null, backupBucket: null, toolsWorkerUrl: "" }, { ...SPACE_ADDRESSES.prod, appUrl: "http://localhost:3000", siteUrl: "http://localhost:3000", trustedOrigins: [], storage: "local" })
 };
 
+// ../shared/src/agent-rules.ts
+var BUILD_WITH = [
+  `Frameworks: ${SUPPORTED_FRAMEWORKS.map((f) => f.name).join(", ")}. In beta: ${BETA_FRAMEWORKS.map((f) => f.name).join(", ")} (Next.js through the OpenNext Cloudflare adapter).`,
+  "Database: Cloudflare D1 (SQLite), through Drizzle with drizzle-orm/d1 or Prisma with the D1 adapter.",
+  "Uploaded files and images: Cloudflare R2 (object storage), never the local disk.",
+  "Settings and secrets: environment variables, set with: npx deployai@latest env set <key>",
+  "Images: resize at build time or serve them as they are; no native image modules at runtime.",
+  "Passwords: bcryptjs or Web Crypto, never native bcrypt.",
+  "Server code runs per request: no long-running processes, background servers or child processes."
+];
+var KEEP_DATA_RULES = [
+  "Moving to DeployAI changes where data lives. It never moves the data by itself. Before you switch any of these, save a copy inside the project and tell the user, in simple words, what was saved and where:",
+  "- Database (Postgres, MySQL, MongoDB, a SQLite file): export it to a file (pg_dump, mysqldump, mongoexport, sqlite3 .dump), so it can be imported into D1 later.",
+  "- Uploaded files and images on the local disk or another storage service: keep them in a folder (download them first if they are on another service), so they can be uploaded to R2 later.",
+  "- User accounts and passwords: keep existing password hashes working (bcryptjs reads bcrypt hashes), so no one has to reset.",
+  "- Sessions and cache (Redis, memory): these can be lost, and users may have to log in again. Say so.",
+  "Never delete the old database, files or storage service."
+];
+var AGENT_POINTER = "Read DEPLOYAI.md before you write code, change the plan or add a dependency: this project is published with DeployAI.";
+
 // src/config.ts
 import { randomUUID } from "crypto";
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -21790,6 +21810,7 @@ var M = {
     startInstalled: "Installed its packages (npm install).",
     startBrief: "Wrote the owner's details to {file} (kept out of git and never uploaded).",
     startLinked: 'Linked this folder to the site "{name}".',
+    startRules: "Wrote the rules for your agent to DEPLOYAI.md (never uploaded).",
     startRelinked: 'Linked this folder to the site "{name}" instead of the site it was linked to.',
     statusLine: "Status: {s}",
     ready: "ready",
@@ -21803,6 +21824,7 @@ var M = {
     pasteFix: "  Paste the prompt below into your AI editor, then run: npx deployai@latest check",
     copied: "  (copied to clipboard)",
     runDeploy: '  Run: npx deployai@latest deploy -m "<message>"',
+    initHint: "  So your agent follows the DeployAI rules, run: npx deployai@latest init",
     deployTitle: "DeployAI deploy",
     guestTitle: "DeployAI deploy (no account)",
     uploading: "Uploading...",
@@ -21959,6 +21981,7 @@ var M = {
     startInstalled: "\u05D4\u05D7\u05D1\u05D9\u05DC\u05D5\u05EA \u05E9\u05DC\u05D4 \u05D4\u05D5\u05EA\u05E7\u05E0\u05D5 (npm install).",
     startBrief: "\u05D4\u05E4\u05E8\u05D8\u05D9\u05DD \u05E9\u05DC \u05D1\u05E2\u05DC \u05D4\u05D0\u05EA\u05E8 \u05E0\u05DB\u05EA\u05D1\u05D5 \u05DC {file} (\u05DC\u05D0 \u05E0\u05DB\u05E0\u05E1\u05D9\u05DD \u05DC\u05BEgit \u05D5\u05DC\u05D0 \u05E2\u05D5\u05DC\u05D9\u05DD \u05DC\u05D0\u05EA\u05E8).",
     startLinked: '\u05D4\u05EA\u05D9\u05E7\u05D9\u05D9\u05D4 \u05D7\u05D5\u05D1\u05E8\u05D4 \u05DC\u05D0\u05EA\u05E8 "{name}".',
+    startRules: "\u05D4\u05DB\u05DC\u05DC\u05D9\u05DD \u05DC\u05E1\u05D5\u05DB\u05DF \u05E0\u05DB\u05EA\u05D1\u05D5 \u05DC DEPLOYAI.md (\u05DC\u05D0 \u05E2\u05D5\u05DC\u05D9\u05DD \u05DC\u05D0\u05EA\u05E8).",
     startRelinked: '\u05D4\u05EA\u05D9\u05E7\u05D9\u05D9\u05D4 \u05D7\u05D5\u05D1\u05E8\u05D4 \u05DC\u05D0\u05EA\u05E8 "{name}" \u05D1\u05DE\u05E7\u05D5\u05DD \u05D4\u05D0\u05EA\u05E8 \u05E9\u05D4\u05D9\u05D9\u05EA\u05D4 \u05DE\u05D7\u05D5\u05D1\u05E8\u05EA \u05D0\u05DC\u05D9\u05D5.',
     statusLine: "\u05DE\u05E6\u05D1: {s}",
     ready: "\u05DE\u05D5\u05DB\u05DF \u05DC\u05E2\u05DC\u05D5\u05EA",
@@ -21972,6 +21995,7 @@ var M = {
     pasteFix: "  \u05D4\u05D3\u05D1\u05D9\u05E7\u05D5 \u05D0\u05EA \u05D4\u05E4\u05E8\u05D5\u05DE\u05E4\u05D8 \u05E9\u05DC\u05DE\u05D8\u05D4 \u05DC\u05E1\u05D5\u05DB\u05DF, \u05D5\u05D0\u05D6 \u05D4\u05E8\u05D9\u05E6\u05D5: npx deployai@latest check",
     copied: "  (\u05D4\u05D5\u05E2\u05EA\u05E7)",
     runDeploy: '  \u05D4\u05E8\u05D9\u05E6\u05D5: npx deployai@latest deploy -m "<message>"',
+    initHint: "  \u05DB\u05D3\u05D9 \u05E9\u05D4\u05E1\u05D5\u05DB\u05DF \u05D9\u05E2\u05D1\u05D5\u05D3 \u05DC\u05E4\u05D9 \u05D4\u05DB\u05DC\u05DC\u05D9\u05DD \u05E9\u05DC DeployAI, \u05D4\u05E8\u05D9\u05E6\u05D5: npx deployai@latest init",
     deployTitle: "DeployAI deploy",
     guestTitle: "DeployAI deploy (\u05D1\u05DC\u05D9 \u05D7\u05E9\u05D1\u05D5\u05DF)",
     uploading: "\u05DE\u05E2\u05DC\u05D9\u05DD...",
@@ -22132,7 +22156,7 @@ function messages(root) {
 }
 
 // src/version.ts
-var CLI_VERSION = "0.1.0-beta.6";
+var CLI_VERSION = "0.1.0-beta.8";
 
 // src/api.ts
 function apiContext(apiFlag) {
@@ -22361,7 +22385,7 @@ async function sendTelemetryEvent(ctx, event) {
 }
 
 // src/commands/init.ts
-import { existsSync as existsSync5, writeFileSync as writeFileSync3 } from "fs";
+import { appendFileSync, existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
 import { join as join5 } from "path";
 
 // src/analyze.ts
@@ -22529,6 +22553,7 @@ function planUpload(root) {
 }
 
 // src/analyze.ts
+var INIT_FILES = /* @__PURE__ */ new Set(["DEPLOYAI.md", "AGENTS.md", "CLAUDE.md"]);
 var CODE_EXT = /\.(js|jsx|ts|tsx|mjs|cjs|mts|cts|vue|svelte|astro)$/;
 var SECRET_SCAN_EXT = /\.(js|jsx|ts|tsx|mjs|cjs|mts|cts|vue|svelte|astro|json|ya?ml|toml|html|prisma)$/;
 var LOCKFILES = /* @__PURE__ */ new Set(["package-lock.json", "pnpm-lock.yaml", "yarn.lock", "bun.lock", "bun.lockb"]);
@@ -22886,7 +22911,7 @@ function analyzeProject(root) {
   }
   const otherStack = detectOtherStack(files.map((f) => f.rel));
   if (otherStack) add({ code: "other_stack", severity: "blocker", detail: ` ${otherStack.name}` });
-  const empty = !files.some((f) => !f.rel.startsWith(".deployai/") && f.rel !== "DEPLOYAI.md" && !isEnvFile(f.rel.split("/").pop() ?? ""));
+  const empty = !files.some((f) => !f.rel.startsWith(".deployai/") && !INIT_FILES.has(f.rel) && !isEnvFile(f.rel.split("/").pop() ?? ""));
   if (empty) add({ code: "no_files", severity: "blocker" });
   if (framework.id === "unknown" && !otherStack && !empty) {
     add({ code: "unknown_framework", severity: "warning", detail: framework.flavor ? ` (looks like ${framework.flavor})` : "" });
@@ -22984,13 +23009,34 @@ This project is published with DeployAI.
 
 Always explain to the user in simple words, in the language they write to you in. The user may not read English.
 
-Do not add:
+When you install or set something up, say what it does for the site, not the package name. Say "installing the site runtime" or "setting up a local test database", not "installing the Cloudflare adapter" or "installing wrangler".
+
+Before you write code or change the plan, compare it with these rules. If something in it does not fit, say what and propose the change.
+
+## Build with
+
+${BUILD_WITH.map((l) => `- ${l}`).join("\n")}
+
+To start from working code, see the samples: npx deployai@latest samples
+
+## Do not add
+
 - local file system writes
 - database drivers DeployAI does not support (see: npx deployai@latest inspect)
 - long-running processes or background servers
 - native binary modules
 - DeployAI or any cloud credentials in source code
 
+## Do not run
+
+- wrangler commands that need a Cloudflare account (login, deploy, d1 create, r2 bucket create). Wrangler is installed only for local development. The user does not need a Cloudflare account: DeployAI creates the database and storage and publishes the site, with: npx deployai@latest deploy
+
+## Keep existing data
+
+${KEEP_DATA_RULES.join("\n")}
+
+## Check
+
 Before adding a dependency or a new server feature, run: npx deployai@latest check
 Ask the developer before removing any existing functionality.
 
@@ -22998,9 +23044,11 @@ Files:
 - .deployai/project.json: project id and settings (safe to commit)
 - .deployai/last-check.json: latest check result (not committed)
 `;
+var AGENT_FILES = ["AGENTS.md", "CLAUDE.md"];
 function runInit(root, opts = {}) {
   const created = [];
   const kept = [];
+  const updated = [];
   const md = join5(root, "DEPLOYAI.md");
   if (existsSync5(md) && !opts.force) {
     kept.push("DEPLOYAI.md");
@@ -23008,20 +23056,35 @@ function runInit(root, opts = {}) {
     writeFileSync3(md, DEPLOYAI_MD);
     created.push("DEPLOYAI.md");
   }
+  if (opts.agentFiles !== false) {
+    for (const name of AGENT_FILES) {
+      const file2 = join5(root, name);
+      const text = existsSync5(file2) ? readFileSync5(file2, "utf8") : null;
+      if (text === null) {
+        writeFileSync3(file2, `${AGENT_POINTER}
+`);
+        created.push(name);
+      } else if (text.includes("DEPLOYAI.md")) {
+        kept.push(name);
+      } else {
+        const eol = text.includes("\r\n") ? "\r\n" : "\n";
+        const gap = !text.trim() ? "" : text.endsWith("\n") ? eol : eol + eol;
+        appendFileSync(file2, `${gap}${AGENT_POINTER}${eol}`);
+        updated.push(name);
+      }
+    }
+  }
   ensureDeployaiDir(root);
   const existing = readProject(root);
+  const framework = existing?.framework ?? analyzeProject(root).inspect.framework.id;
   if (existing) {
     kept.push(".deployai/project.json");
   } else {
-    const analysis = analyzeProject(root);
-    writeProject(root, {
-      projectId: null,
-      framework: analysis.inspect.framework.id,
-      createdAt: (/* @__PURE__ */ new Date()).toISOString()
-    });
+    writeProject(root, { projectId: null, framework, createdAt: (/* @__PURE__ */ new Date()).toISOString() });
     created.push(".deployai/project.json");
   }
-  return { created, kept };
+  const hasCode = existsSync5(join5(root, "package.json")) || framework !== "unknown";
+  return { created, kept, updated, hasCode };
 }
 function initCommand(root, opts) {
   const res = runInit(root, opts);
@@ -23031,6 +23094,7 @@ function initCommand(root, opts) {
   out(
     rows([
       ...res.created.map((f) => ["Created", f]),
+      ...res.updated.map((f) => ["Added a line", `${f} (read DEPLOYAI.md)`]),
       ...res.kept.map((f) => ["Kept", f]),
       ["Guard", ".deployai/last-check.json (git ignored)"],
       ["Linked project", project?.projectId ?? "none yet"]
@@ -23038,12 +23102,18 @@ function initCommand(root, opts) {
   );
   out();
   out("Next step");
-  out("  Run: npx deployai@latest check");
+  if (res.hasCode) {
+    out("  Run: npx deployai@latest check");
+  } else {
+    out("  Start from a sample: npx deployai@latest samples");
+    out("  Or tell your agent what to build, or to review your plan. It follows DEPLOYAI.md.");
+  }
   if (!project?.projectId) out("  Then: npx deployai@latest login, npx deployai@latest link");
 }
 
 // src/commands/check.ts
-import { writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync6, writeFileSync as writeFileSync4 } from "fs";
+import { join as join6 } from "path";
 
 // src/prompt.ts
 var PROMPT_RULES = [
@@ -23053,8 +23123,10 @@ var PROMPT_RULES = [
   "Keep the project runnable outside DeployAI.",
   "Never add credentials to source code.",
   "Explain every step to the user in simple words, in the language they write to you in.",
-  "For the database, use D1 as shown in the DeployAI CRUD sample."
+  "For the database, use D1 as shown in the DeployAI CRUD sample.",
+  "Follow DEPLOYAI.md for every future change. If it is missing, run: npx deployai@latest init"
 ];
+var DATA_CODES = /* @__PURE__ */ new Set(["fs_write", "unsupported_db_postgres", "unsupported_db_mysql", "unsupported_db_mongodb", "unsupported_db_sqlite_file", "native_module_bcrypt"]);
 var MAX_LOCATIONS = 3;
 function locList(items) {
   const locs = [...new Set(items.map(locationOf).filter(Boolean))];
@@ -23093,6 +23165,11 @@ function buildPrompt(analysis) {
     if (def) lines.push(`- ${def.fixForAgent}`);
   }
   lines.push("");
+  if (blockerGroups.some((g) => DATA_CODES.has(g.code))) {
+    lines.push("Keep existing data:");
+    lines.push(...KEEP_DATA_RULES);
+    lines.push("");
+  }
   lines.push("Rules:");
   for (const r of PROMPT_RULES) lines.push(`- ${r}`);
   lines.push("");
@@ -23242,6 +23319,7 @@ async function runCheck(root, ctx, opts = {}) {
     } else {
       out(t("runDeploy"));
     }
+    if (!existsSync6(join6(root, "DEPLOYAI.md"))) out(t("initHint"));
   }
   await telemetry;
   return a;
@@ -23455,7 +23533,7 @@ async function linkCommand(root, ctx, target, opts) {
 import { createInterface as createInterface2 } from "readline/promises";
 
 // src/tar.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync6 } from "fs";
 import { gzipSync } from "zlib";
 var BLOCK = 512;
 function writeString(buf, offset, length, value) {
@@ -23539,7 +23617,7 @@ function packFiles(files) {
   return createTarGz(
     files.map((f) => ({
       name: f.rel,
-      data: readFileSync5(f.abs),
+      data: readFileSync6(f.abs),
       mtimeMs: f.mtimeMs,
       mode: f.mode & 64 ? 493 : 420
     }))
@@ -23742,8 +23820,8 @@ async function claimCommand(root, ctx, opts) {
 
 // src/commands/samples.ts
 import { createInterface as createInterface3 } from "readline/promises";
-import { existsSync as existsSync6, mkdirSync as mkdirSync3, readdirSync as readdirSync3, writeFileSync as writeFileSync5 } from "fs";
-import { dirname, join as join6, relative, resolve, sep } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, readdirSync as readdirSync3, writeFileSync as writeFileSync5 } from "fs";
+import { dirname, join as join7, relative, resolve, sep } from "path";
 import { gunzipSync } from "zlib";
 var SAMPLES = [
   { key: "landing", title: "Landing page: a full one-page site with WhatsApp sign-up", stack: "static HTML and CSS" },
@@ -23754,7 +23832,7 @@ var SAMPLES = [
   { key: "admin", title: "Back office with login: dashboard, orders, stock, customers", stack: "Astro on Workers, D1" }
 ];
 var MAX_BYTES = 20 * 1024 * 1024;
-var IGNORED = /* @__PURE__ */ new Set([".git", ".DS_Store", "Thumbs.db", ".deployai"]);
+var IGNORED = /* @__PURE__ */ new Set([".git", ".DS_Store", "Thumbs.db", ".deployai", "DEPLOYAI.md", "AGENTS.md", "CLAUDE.md"]);
 function listSamples(apiUrl) {
   out("DeployAI samples");
   out("");
@@ -23764,7 +23842,7 @@ function listSamples(apiUrl) {
   out(`See them live:              ${apiUrl}/samples`);
 }
 function filesIn(dir) {
-  return existsSync6(dir) ? readdirSync3(dir).filter((f) => !IGNORED.has(f)) : [];
+  return existsSync7(dir) ? readdirSync3(dir).filter((f) => !IGNORED.has(f)) : [];
 }
 function freeFolder(cwd, key) {
   for (let n2 = 1; ; n2++) {
@@ -23847,7 +23925,7 @@ async function samplesCommand(cwd, ctx, key, opts = {}) {
   }
   const written = await downloadSample(ctx, sample.key, root);
   const base = resolve(root);
-  const hasPackage = existsSync6(join6(base, "package.json"));
+  const hasPackage = existsSync7(join7(base, "package.json"));
   out(base === resolve(cwd) ? `Downloaded the ${sample.key} sample: ${written} files.` : `Downloaded the ${sample.key} sample into the new folder ${relative(cwd, base)}: ${written} files. Work in that folder from now on.`);
   out("");
   const t = messages(base);
@@ -23992,8 +24070,8 @@ async function statusCommand(root, ctx) {
 
 // src/commands/start.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync7, writeFileSync as writeFileSync6 } from "fs";
-import { join as join7, relative as relative2, resolve as resolve2 } from "path";
+import { existsSync as existsSync8, writeFileSync as writeFileSync6 } from "fs";
+import { join as join8, relative as relative2, resolve as resolve2 } from "path";
 var REASONS = { start_not_found: "startNotFound", start_expired: "startExpired", start_used_up: "startUsedUp" };
 var reason = (code) => messages(process.cwd())(REASONS[code] ?? "startNotFound");
 async function fetchStart(ctx, id) {
@@ -24031,19 +24109,20 @@ async function startCommand(cwd, ctx, id, opts = {}) {
   if (sample && !sameSite) {
     const written = await downloadSample(ctx, sample.key, root);
     done.push(t("startDownloaded", { key: sample.key, n: written }));
-    if (existsSync7(join7(root, "package.json"))) {
+    if (existsSync8(join8(root, "package.json"))) {
       if (opts.install !== false && install(root)) done.push(t("startInstalled"));
       else steps.unshift({ cmd: "npm install", say: "Installs the sample's packages." });
     }
   }
   if (choices.brief) {
     ensureDeployaiDir(root);
-    writeFileSync6(join7(root, BRIEF_FILE), `# The owner's details
+    writeFileSync6(join8(root, BRIEF_FILE), `# The owner's details
 
 ${choices.brief}
 `);
     done.push(t("startBrief", { file: BRIEF_FILE }));
   }
+  if (runInit(root).created.includes("DEPLOYAI.md")) done.push(t("startRules"));
   if (choices.projectId) {
     const before = readProject(root);
     writeProject(root, { ...before ?? {}, projectId: choices.projectId, name: choices.name ?? void 0, slug: choices.slug ?? void 0, createdAt: before?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString() });
@@ -24069,7 +24148,7 @@ ${choices.brief}
 }
 
 // src/commands/addon.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
 import { resolve as resolve3 } from "path";
 function linkedProjectId2(root) {
   const id = readProject(root)?.projectId;
@@ -24150,7 +24229,7 @@ async function addonDoneCommand(root, ctx, runId, opts) {
   let report;
   if (opts.report) {
     try {
-      report = JSON.parse(readFileSync6(resolve3(root, opts.report), "utf8"));
+      report = JSON.parse(readFileSync7(resolve3(root, opts.report), "utf8"));
     } catch {
       throw new CliError(`Cannot read the report file ${opts.report} as JSON.`, 1, "usage");
     }
@@ -24246,7 +24325,7 @@ function buildProgram() {
   const g = (cmd) => cmd.optsWithGlobals();
   const root = (cmd) => resolve4(g(cmd).dir ?? process.cwd());
   const ctx = (cmd) => apiContext(g(cmd).api);
-  program.command("init").description("create DEPLOYAI.md and .deployai/ guard files").option("--force", "overwrite DEPLOYAI.md").action((opts, cmd) => initCommand(root(cmd), opts));
+  program.command("init").description("create DEPLOYAI.md and .deployai/ guard files").option("--force", "overwrite DEPLOYAI.md").option("--no-agent-files", "do not add the DEPLOYAI.md line to AGENTS.md and CLAUDE.md").action((opts, cmd) => initCommand(root(cmd), opts));
   program.command("inspect").description("show framework, package manager, language, database, storage").option("--json", "machine readable output").action((opts, cmd) => inspectCommand(root(cmd), opts));
   program.command("check").description("can this project run on DeployAI: blockers and warnings, with the AI prompt").option("--json", "machine readable output").option("--no-clipboard", "do not copy the prompt to the clipboard").action(async (opts, cmd) => {
     const a = await runCheck(root(cmd), ctx(cmd), opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deployai",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.8",
   "description": "Check a site built with an AI editor, see what has to change, and publish it to DeployAI. Hebrew first.",
   "keywords": [
     "deployai",