@beechcms/cli 0.6.0-preview.4 → 0.6.0

package/dist/index.js

@@ -1,17 +1,17 @@
-// src/commands/seed-load.ts
-import pc3 from "picocolors";
-import {
-  SEED_REGISTRY as SEED_REGISTRY2,
-  generateCreateTable,
-  generateDraftTable,
-  generateIndexes,
-  generateFtsTable,
-  generateFtsTriggers,
-  generateJunctionTable,
-  generateJunctionIndexes,
-  generateJunctionDraftTable,
-  sortSeedsByDependencies
-} from "@beechcms/core";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/lib/wrangler.ts
 import { spawnSync } from "node:child_process";
@@ -105,363 +105,376 @@ function resolveDbName(configPath) {
     return "beech-db";
   }
 }
+var init_wrangler = __esm({
+  "src/lib/wrangler.ts"() {
+    "use strict";
+  }
+});
 
-// src/lib/schema-diff.ts
-import pc from "picocolors";
-import { getExpectedColumns } from "@beechcms/core";
-function isSeedClean(diff) {
-  return diff.tableExists && diff.columns.every((c) => c.status === "ok");
+// src/commands/init.ts
+var init_exports = {};
+__export(init_exports, {
+  init: () => init
+});
+import pc4 from "picocolors";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { createInterface } from "node:readline/promises";
+import { resolve as resolve2, basename } from "node:path";
+import { spawnSync as spawnSync2 } from "node:child_process";
+function checkWranglerAuth() {
+  const result = spawnSync2("npx", ["wrangler", "whoami", "--json"], {
+    encoding: "utf-8",
+    cwd: process.cwd(),
+    shell: true
+  });
+  return result.status === 0;
 }
-function renderSeedDiff(diff) {
-  const table = `content_${diff.slug}`;
-  if (!diff.tableExists) {
-    console.log(pc.red(`  \u2717 ${table} \u2014 table missing`));
-    return;
-  }
-  const problems = diff.columns.filter((c) => c.status !== "ok");
-  if (problems.length === 0) {
-    console.log(pc.green(`  \u2713 ${table}`));
-    return;
-  }
-  console.log(pc.yellow(`  \u26A0 ${table}`));
-  for (const col of problems) {
-    switch (col.status) {
-      case "missing":
-        console.log(pc.red(`    + missing column: ${col.name} ${col.expectedType}`));
-        break;
-      case "extra":
-        console.log(pc.dim(`    ~ orphaned column: "${col.name}" (${col.actualType}) \u2014 in DB, not in seeds.ts`));
-        break;
-      case "type_mismatch":
-        console.log(pc.red(`    \u2260 type mismatch:  ${col.name} (expected ${col.expectedType}, got ${col.actualType})`));
-        break;
-      case "fk_missing":
-        console.log(pc.red(`    \u292C missing FK: ${col.name} \u2192 content_${col.expectedTarget}(id)`));
-        break;
-      case "fk_mismatch":
-        console.log(pc.yellow(`    \u292C FK mismatch: ${col.name} expected ${col.expected}, got ${col.actual}`));
-        break;
-      case "index_missing":
-        console.log(pc.yellow(`    \u2298 missing index on ${col.name}`));
-        break;
+function checkWranglerPlaceholders(configPath) {
+  try {
+    const raw = readFileSync2(configPath, "utf-8");
+    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    const parsed = JSON.parse(stripped);
+    const bindings = parsed?.d1_databases ?? [];
+    const issues = [];
+    for (const b of bindings) {
+      const id = b.database_id ?? "";
+      if (!id || PLACEHOLDER_DB_IDS.includes(id)) {
+        issues.push(`d1_databases[0].database_id is "${id || "(empty)"}"`);
+      }
     }
+    return issues;
+  } catch {
+    return [];
   }
 }
-async function diffSeed(seed, options) {
-  const tableName = `content_${seed.slug}`;
-  const expected = getExpectedColumns(seed);
-  let actual;
+function readProjectName(configPath) {
+  if (!configPath) return basename(process.cwd());
   try {
-    actual = queryD1(`PRAGMA table_info(${tableName})`, options);
+    const raw = readFileSync2(configPath, "utf-8");
+    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    const parsed = JSON.parse(stripped);
+    return parsed?.name || basename(process.cwd());
   } catch {
-    return { slug: seed.slug, tableExists: false, columns: expected.map((c) => ({ name: c.name, status: "missing", expectedType: c.sqlType })) };
+    return basename(process.cwd());
   }
-  if (actual.length === 0) {
-    return { slug: seed.slug, tableExists: false, columns: expected.map((c) => ({ name: c.name, status: "missing", expectedType: c.sqlType })) };
+}
+function readBucketName(configPath) {
+  if (!configPath) return null;
+  try {
+    const raw = readFileSync2(configPath, "utf-8");
+    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    const parsed = JSON.parse(stripped);
+    const buckets = parsed?.r2_buckets ?? [];
+    return buckets[0]?.bucket_name ?? null;
+  } catch {
+    return null;
   }
-  const actualMap = new Map(actual.map((r) => [r.name, r]));
-  const expectedSet = new Set(expected.map((c) => c.name));
-  const columns = [];
-  for (const col of expected) {
-    const actualRow = actualMap.get(col.name);
-    if (!actualRow) {
-      columns.push({ name: col.name, status: "missing", expectedType: col.sqlType });
-    } else if (actualRow.type.toUpperCase() !== col.sqlType) {
-      columns.push({ name: col.name, status: "type_mismatch", expectedType: col.sqlType, actualType: actualRow.type });
-    } else {
-      columns.push({ name: col.name, status: "ok" });
-    }
+}
+function createD1Database(dbName) {
+  const result = spawnSync2("npx", ["wrangler", "d1", "create", dbName, "--json"], {
+    encoding: "utf-8",
+    cwd: process.cwd(),
+    shell: true,
+    stdio: ["inherit", "pipe", "pipe"]
+  });
+  if (result.status !== 0) return null;
+  try {
+    const parsed = JSON.parse(result.stdout);
+    return parsed?.uuid ?? parsed?.database_id ?? null;
+  } catch {
+    return null;
   }
-  for (const row of actual) {
-    if (!expectedSet.has(row.name)) {
-      columns.push({ name: row.name, status: "extra", actualType: row.type });
+}
+function createR2Bucket(bucketName) {
+  const result = spawnSync2("npx", ["wrangler", "r2", "bucket", "create", bucketName], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    shell: true
+  });
+  return result.status === 0;
+}
+function patchWranglerConfig(configPath, dbId) {
+  try {
+    let raw = readFileSync2(configPath, "utf-8");
+    for (const placeholder of PLACEHOLDER_DB_IDS) {
+      raw = raw.split(placeholder).join(dbId);
     }
+    raw = raw.replace(/"database_id"\s*:\s*""/g, `"database_id": "${dbId}"`);
+    writeFileSync2(configPath, raw, "utf-8");
+    return true;
+  } catch {
+    return false;
   }
-  const relationBranches = seed.branches.filter((b) => b.type === "relation" && b.targetSeed);
-  if (relationBranches.length > 0) {
-    let fkList = [];
-    let indexList = [];
-    try {
-      fkList = queryD1(`PRAGMA foreign_key_list(${tableName})`, options);
-      indexList = queryD1(`PRAGMA index_list(${tableName})`, options);
-    } catch {
-    }
-    const fkByCol = /* @__PURE__ */ new Map();
-    for (const fk of fkList) {
-      fkByCol.set(fk.from, fk);
+}
+function printManualDbInstructions() {
+  console.log(pc4.dim("\n  Update your D1 database_id in wrangler.jsonc,"));
+  console.log(pc4.dim("  or create a new database with:"));
+  console.log(pc4.cyan("\n  \u2192 Run:  npx wrangler d1 create my-project-db"));
+  console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
+}
+function echoApiKeys(configPath) {
+  if (!configPath) return;
+  try {
+    const raw = readFileSync2(configPath, "utf-8");
+    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    const parsed = JSON.parse(stripped);
+    const vars = parsed?.vars ?? {};
+    const readKey = vars["PUBLIC_READ_API_KEY"];
+    const writeKey = vars["PUBLIC_WRITE_API_KEY"];
+    if (!readKey && !writeKey) return;
+    console.log(pc4.dim("  API keys detected in wrangler.jsonc:\n"));
+    if (readKey) {
+      const masked = readKey.length > 8 ? readKey.slice(0, 4) + "****" + readKey.slice(-4) : "****";
+      console.log(pc4.dim(`    PUBLIC_READ_API_KEY  = ${masked}`));
     }
-    const indexNames = new Set(indexList.map((i) => i.name));
-    for (const branch of relationBranches) {
-      const expectedFkTable = `content_${branch.targetSeed}`;
-      const expectedOnDelete = (branch.onDelete ?? "SET NULL").toUpperCase();
-      const expectedIndexName = `idx_${seed.slug}_${branch.alias}`;
-      const colDiff = columns.find((c) => c.name === branch.alias);
-      if (!colDiff || colDiff.status === "missing") continue;
-      const fk = fkByCol.get(branch.alias);
-      if (!fk) {
-        colDiff.status = "fk_missing";
-        colDiff.expectedTarget = branch.targetSeed;
-      } else {
-        const actualTable = fk.table;
-        const actualOnDelete = fk.on_delete.toUpperCase();
-        if (actualTable !== expectedFkTable || actualOnDelete !== expectedOnDelete) {
-          colDiff.status = "fk_mismatch";
-          colDiff.expected = `\u2192 ${expectedFkTable}(id) ON DELETE ${expectedOnDelete}`;
-          colDiff.actual = `\u2192 ${actualTable}(id) ON DELETE ${actualOnDelete}`;
-          colDiff.expectedTarget = branch.targetSeed;
-        }
-      }
-      if (!indexNames.has(expectedIndexName)) {
-        if (colDiff.status === "ok") {
-          colDiff.status = "index_missing";
-        } else {
-          columns.push({ name: branch.alias, status: "index_missing" });
-        }
-      }
+    if (writeKey) {
+      const masked = writeKey.length > 8 ? writeKey.slice(0, 4) + "****" + writeKey.slice(-4) : "****";
+      console.log(pc4.dim(`    PUBLIC_WRITE_API_KEY = ${masked}`));
     }
+    console.log(pc4.dim("\n  Use these in your frontend as the X-API-Key header.\n"));
+  } catch {
   }
-  return { slug: seed.slug, tableExists: true, columns };
-}
-
-// src/commands/validate.ts
-import pc2 from "picocolors";
-import { SEED_REGISTRY, validateSeedDefinitions } from "@beechcms/core";
-function validateSeeds(registry) {
-  return validateSeedDefinitions(Object.values(registry));
 }
-async function validate(args) {
-  const registry = args.registry ?? SEED_REGISTRY;
-  if (Object.keys(registry).length === 0) {
-    console.warn(pc2.yellow("\n  Warning: SEED_REGISTRY is empty. Create a seeds.ts in your project root.\n"));
-    return;
-  }
-  console.log(pc2.cyan("\n  beech validate \u2014 checking seeds\n"));
-  const errors = validateSeeds(registry);
-  const fatalErrors = errors.filter((e) => e.fatal);
-  const warnings = errors.filter((e) => !e.fatal);
-  for (const e of fatalErrors) {
-    console.log(pc2.red(`  \u2717 ${e.slug} (fatal)`));
-    for (const msg of e.messages) {
-      console.log(pc2.red(`      \u2192 ${msg}`));
-    }
+function checkFiles(cwd, checkDevVars) {
+  let ok = true;
+  const workerExists = existsSync2(resolve2(cwd, "worker.ts")) || existsSync2(resolve2(cwd, "worker.js"));
+  if (!workerExists) {
+    console.log(pc4.red("  \u2717 worker.ts        \u2014 missing (required)"));
+    ok = false;
+  } else {
+    console.log(pc4.green("  \u2713 worker.ts"));
   }
-  const warningMap = new Map(warnings.map((e) => [e.slug, e.messages]));
-  const allWarningSlugsSeen = new Set(warnings.map((e) => e.slug));
-  for (const seed of Object.values(registry)) {
-    const msgs = warningMap.get(seed.slug);
-    if (!msgs) {
-      if (!allWarningSlugsSeen.has(seed.slug)) {
-        const hasFatal = fatalErrors.some((e) => e.slug === seed.slug);
-        if (!hasFatal) console.log(pc2.green(`  \u2713 ${seed.slug}`));
-      }
-    } else {
-      console.log(pc2.yellow(`  \u26A0 ${seed.slug}`));
-      for (const msg of msgs) {
-        console.log(pc2.yellow(`      \u2192 ${msg}`));
-      }
-    }
+  const configPath = findWranglerConfig();
+  const configInCwd = configPath && (configPath === resolve2(cwd, "wrangler.jsonc") || configPath === resolve2(cwd, "wrangler.json") || configPath === resolve2(cwd, "wrangler.toml"));
+  if (!configInCwd) {
+    console.log(pc4.red("  \u2717 wrangler.jsonc   \u2014 missing (required)"));
+    ok = false;
+  } else {
+    console.log(pc4.green(`  \u2713 ${basename(configPath)}`));
   }
-  console.log("");
-  const totalFatal = fatalErrors.reduce((n, e) => n + e.messages.length, 0);
-  const totalWarnings = warnings.reduce((n, e) => n + e.messages.length, 0);
-  if (totalFatal > 0) {
-    const s = totalFatal !== 1 ? "s" : "";
-    console.log(pc2.red(`  Found ${totalFatal} fatal error${s}. Fix before loading.
-`));
-    process.exit(1);
-  } else if (totalWarnings > 0) {
-    const s = totalWarnings !== 1 ? "s" : "";
-    console.log(pc2.yellow(`  Found ${totalWarnings} warning${s}. Review seeds above.
-`));
+  const seedsExists = existsSync2(resolve2(cwd, "seeds.ts")) || existsSync2(resolve2(cwd, "seeds.js")) || existsSync2(resolve2(cwd, "seed.ts")) || existsSync2(resolve2(cwd, "seed.js"));
+  if (!seedsExists) {
+    console.log(pc4.yellow("  \u26A0 seeds.ts         \u2014 not found (optional: needed only for the one-time code \u2192 DB load; after `beech seed:load`, the DB is canonical)"));
   } else {
-    console.log(pc2.green("  All seeds valid.\n"));
+    console.log(pc4.green("  \u2713 seeds.ts"));
+  }
+  if (checkDevVars) {
+    if (!existsSync2(resolve2(cwd, ".dev.vars"))) {
+      console.log(pc4.dim("  \u25CB .dev.vars        \u2014 not found (optional: only needed for production R2 credentials)"));
+    } else {
+      console.log(pc4.green("  \u2713 .dev.vars"));
+    }
   }
+  return ok;
 }
-
-// src/commands/seed-load.ts
-function buildSeedRegistrationSql(seed) {
-  const json = sqlQuote(JSON.stringify(seed));
-  return [
-    `INSERT INTO seeds (slug, definition, status, source, created_at, updated_at)`,
-    `VALUES (${sqlQuote(seed.slug)}, ${json}, 'active', 'code', unixepoch(), unixepoch())`,
-    `ON CONFLICT(slug) DO UPDATE SET definition = excluded.definition, status = 'active', updated_at = excluded.updated_at;`
-  ].join("\n");
+function printNextSteps(local) {
+  const localFlag = local ? " --local" : "";
+  console.log(pc4.dim("  Next steps:"));
+  console.log(pc4.cyan(`  1. npx beech seed:load${localFlag}`));
+  console.log(pc4.dim("      \u2192 create content tables and register seed definitions in D1"));
+  console.log(pc4.cyan("  2. npx wrangler dev"));
+  console.log(pc4.dim("      \u2192 start API + dashboard"));
+  console.log(pc4.dim("  3. Open http://localhost:8789/admin\n"));
 }
-var SEED_META_BUMP_SQL = `UPDATE seed_meta SET value = CAST(CAST(value AS INTEGER) + 1 AS TEXT) WHERE id = 'registry_version';`;
-function buildStatements(seed) {
-  const stmts = [generateCreateTable(seed), ...generateIndexes(seed)];
-  const draft = generateDraftTable(seed);
-  if (draft) stmts.push(draft);
-  const fts = generateFtsTable(seed);
-  if (fts) {
-    stmts.push(fts, ...generateFtsTriggers(seed));
-  }
-  for (const branch of seed.branches) {
-    if (branch.type !== "relation" || branch.multiple !== true) continue;
-    stmts.push(generateJunctionTable(seed, branch), ...generateJunctionIndexes(seed, branch));
-    const draftJunction = generateJunctionDraftTable(seed, branch);
-    if (draftJunction) stmts.push(draftJunction);
+function getExistingTables(options) {
+  try {
+    const rows = queryD1(
+      `SELECT name FROM sqlite_master WHERE type='table'`,
+      options
+    );
+    return rows.map((r) => r.name);
+  } catch {
+    return null;
   }
-  return stmts;
 }
-async function runDiff(options, registry) {
-  const seeds = sortSeedsByDependencies(Object.values(registry));
-  console.log(pc3.cyan("\n  Diffing schema\u2026\n"));
-  let allOk = true;
-  for (const seed of seeds) {
-    const result = await diffSeed(seed, options);
-    renderSeedDiff(result);
-    if (!isSeedClean(result)) allOk = false;
-  }
-  console.log("");
-  if (allOk) {
-    console.log(pc3.green("  Schema matches seeds. No action needed.\n"));
-  } else {
-    console.log(pc3.yellow("  Run `beech seed:load` to apply missing tables/columns.\n"));
+async function init(args) {
+  const cwd = process.cwd();
+  console.log(pc4.cyan("\n  beech init \u2014 project check\n"));
+  const filesOk = checkFiles(cwd, args.local);
+  if (!filesOk) {
+    console.log(pc4.red("\n  \u2717 Required files missing\n"));
+    console.log(pc4.dim("  Fix the errors above before initialising the database."));
+    console.log(pc4.cyan("\n  \u2192 See: https://beechcms.dev/docs/getting-started\n"));
+    process.exit(1);
   }
-}
-async function runLoad(options, dryRun, registry) {
-  const seeds = sortSeedsByDependencies(Object.values(registry));
-  if (dryRun) {
-    console.log(pc3.cyan("\n  -- dry-run: SQL that would be executed\n"));
-    for (const seed of seeds) {
-      const stmts = buildStatements(seed);
-      console.log(pc3.dim(`  -- content_${seed.slug}`));
-      for (const stmt of stmts) {
-        console.log(stmt + "\n");
-      }
-      console.log(pc3.dim(`  -- register ${seed.slug} in seeds table`));
-      console.log(buildSeedRegistrationSql(seed) + "\n");
-    }
-    console.log(pc3.dim("  -- bump registry_version"));
-    console.log(SEED_META_BUMP_SQL + "\n");
+  console.log(pc4.green("\n  All required files present.\n"));
+  if (!args.initDb) {
+    echoApiKeys(findWranglerConfig());
+    const localFlag = args.local ? " --local" : "";
+    console.log(pc4.dim("  Next steps:"));
+    console.log(pc4.dim(`  1. npx beech init --db${localFlag}     # initialise D1 database`));
+    console.log(pc4.dim(`  2. npx beech seed:load${localFlag}     # create content tables`));
+    console.log(pc4.dim("  3. npx wrangler dev                 # start API + dashboard"));
+    console.log(pc4.dim("  4. Open http://localhost:8789/admin\n"));
     return;
   }
-  console.log(pc3.cyan(`
-  Loading seeds into ${options.local ? "local" : "remote"} D1 (${options.db})\u2026
-`));
-  for (const seed of seeds) {
-    const stmts = [...buildStatements(seed), buildSeedRegistrationSql(seed)];
-    const sql = stmts.join("\n\n") + "\n";
-    process.stdout.write(`  ${pc3.dim("\u2192")} content_${seed.slug}\u2026 `);
-    const ok = executeD1File(sql, options);
-    if (!ok) {
-      console.log(pc3.red("failed"));
-      console.log(pc3.red(`
-  \u2717 Failed to apply schema for content_${seed.slug}
+  const configPath = findWranglerConfig();
+  if (configPath) {
+    const placeholders = checkWranglerPlaceholders(configPath);
+    if (placeholders.length > 0) {
+      console.log(pc4.yellow("  \u26A0 wrangler.jsonc contains placeholder values:\n"));
+      for (const issue of placeholders) {
+        console.log(pc4.yellow(`    - ${issue}`));
+      }
+      if (process.stdin.isTTY && !args.nonInteractive) {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        let autoCreate = false;
+        try {
+          const answer = (await rl.question(
+            pc4.cyan("\n  \u2192 Create a new D1 database (and R2 bucket) on Cloudflare automatically? (Y/n): ")
+          )).trim().toLowerCase();
+          autoCreate = !answer || answer === "y" || answer === "yes";
+        } finally {
+          rl.close();
+        }
+        if (autoCreate) {
+          const authed = checkWranglerAuth();
+          if (!authed) {
+            console.log(pc4.red("\n  \u2717 Not logged in to Cloudflare\n"));
+            console.log(pc4.dim("  BeechCMS needs access to your Cloudflare account to create the database."));
+            console.log(pc4.cyan("\n  \u2192 Run:  npx wrangler login"));
+            console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
+            process.exit(1);
+          }
+          const projectName = readProjectName(configPath);
+          const dbName = `${projectName}-db`;
+          const bucketName = readBucketName(configPath) || `${projectName}-media`;
+          console.log(pc4.dim(`
+  Creating D1 database "${dbName}"\u2026`));
+          const dbId = createD1Database(dbName);
+          if (!dbId) {
+            console.log(pc4.red("\n  \u2717 Failed to create D1 database\n"));
+            console.log(pc4.dim("  Create it manually and retry:"));
+            console.log(pc4.cyan(`
+  \u2192 Run:  npx wrangler d1 create ${dbName}`));
+            console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
+            process.exit(1);
+          }
+          console.log(pc4.green(`  \u2713 D1 database created (id: ${dbId})`));
+          console.log(pc4.dim(`
+  Creating R2 bucket "${bucketName}"\u2026`));
+          const r2Ok = createR2Bucket(bucketName);
+          if (r2Ok) {
+            console.log(pc4.green(`  \u2713 R2 bucket "${bucketName}" created`));
+          } else {
+            console.log(pc4.yellow(`  \u26A0 R2 bucket creation failed (may already exist \u2014 continuing)`));
+          }
+          console.log(pc4.dim("\n  Updating wrangler.jsonc\u2026"));
+          const patched = patchWranglerConfig(configPath, dbId);
+          if (patched) {
+            console.log(pc4.green("  \u2713 wrangler.jsonc updated\n"));
+          } else {
+            console.log(pc4.yellow(`  \u26A0 Could not update wrangler.jsonc automatically
 `));
-      console.log(pc3.dim("  wrangler reported an error above."));
-      console.log(pc3.dim(`  Most likely causes:`));
-      console.log(pc3.dim(`    - Database "${options.db}" not found or wrong database_id`));
-      if (!options.local) {
-        console.log(pc3.dim("    - Not logged in to Cloudflare"));
-        console.log(pc3.cyan("\n  \u2192 Run:  npx wrangler login"));
-        console.log(pc3.cyan("  \u2192 Then: npx beech seed:load\n"));
+            console.log(pc4.dim(`  Set database_id = "${dbId}" in wrangler.jsonc manually, then retry:`));
+            console.log(pc4.cyan("  \u2192 Run: npx beech init --db\n"));
+            process.exit(1);
+          }
+        } else {
+          printManualDbInstructions();
+          process.exit(1);
+        }
+      } else if (args.nonInteractive && args.local) {
+        console.log(pc4.dim("  --yes: proceeding with local mode (no remote resources needed)\n"));
       } else {
-        console.log(pc3.cyan("\n  \u2192 Run:  npx beech init --db --local   # re-initialise local DB"));
-        console.log(pc3.cyan("  \u2192 Then: npx beech seed:load --local\n"));
+        if (args.nonInteractive) {
+          console.log(pc4.red("\n  \u2717 Cannot proceed non-interactively: remote database has a placeholder database_id\n"));
+          console.log(pc4.dim("  Set a real database_id in wrangler.jsonc, then retry."));
+          process.exit(1);
+        }
+        printManualDbInstructions();
+        process.exit(1);
       }
-      process.exit(1);
     }
-    console.log(pc3.green("done"));
-  }
-  executeD1File(SEED_META_BUMP_SQL, options);
-  console.log(pc3.green("\n  All seeds loaded.\n"));
-  console.log(pc3.dim("  Definitions registered in the database."));
-  console.log(pc3.dim("  seed.ts is no longer required at runtime \u2014 you may keep it for code-first edits or delete it.\n"));
-}
-async function seedLoad(args) {
-  const registry = args.registry ?? SEED_REGISTRY2;
-  if (Object.keys(registry).length === 0) {
-    console.log(pc3.yellow("\n  \u2717 No seeds found\n"));
-    console.log(pc3.dim("  Create a seeds.ts file in your project root with at least one content type."));
-    console.log(pc3.cyan("\n  \u2192 Run: npx beech seed:create\n"));
-    return;
   }
-  const validationErrors = validateSeeds(registry);
-  const fatalErrors = validationErrors.filter((e) => e.fatal);
-  const warnings = validationErrors.filter((e) => !e.fatal);
-  if (fatalErrors.length > 0) {
-    const total = fatalErrors.reduce((n, e) => n + e.messages.length, 0);
-    const s = total !== 1 ? "s" : "";
-    console.log(pc3.red(`
-  \u2717 Seed validation found ${total} fatal error${s}. Cannot load schema.
-`));
-    for (const e of fatalErrors) {
-      console.log(pc3.red(`  \u2717 ${e.slug}`));
-      for (const msg of e.messages) {
-        console.log(pc3.red(`      \u2192 ${msg}`));
-      }
+  if (!args.local) {
+    const authed = checkWranglerAuth();
+    if (!authed) {
+      console.log(pc4.red("  \u2717 Not logged in to Cloudflare\n"));
+      console.log(pc4.dim("  BeechCMS needs access to your Cloudflare account to manage the D1 database."));
+      console.log(pc4.cyan("\n  \u2192 Run:  npx wrangler login"));
+      console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
+      process.exit(1);
     }
-    console.log("");
-    process.exit(1);
-  }
-  if (warnings.length > 0) {
-    const total = warnings.reduce((n, e) => n + e.messages.length, 0);
-    const s = total !== 1 ? "s" : "";
-    console.log(pc3.yellow(`
-  \u26A0 Seed validation found ${total} issue${s}. Schema changes will still be applied.
-`));
-    console.log(pc3.dim('  Run "npx beech validate" for details.\n'));
   }
-  const configPath = findWranglerConfig();
   const db = args.db ?? resolveDbName(configPath);
-  const options = {
-    db,
-    local: args.local,
-    configPath
-  };
-  if (!args.dryRun && !args.diff) {
-    try {
-      const rows = queryD1(
-        `SELECT name FROM sqlite_master WHERE type='table' AND name IN ('seeds','seed_meta')`,
-        options
-      );
-      if (rows.length < 2) {
-        console.log(pc3.red("\n  \u2717 System tables not found (seeds, seed_meta)\n"));
-        console.log(pc3.dim("  Run `beech init --db` first to initialise the database."));
-        const flag = args.local ? " --local" : "";
-        console.log(pc3.cyan(`
-  \u2192 Run: npx beech init --db${flag}
+  const options = { db, local: args.local, configPath };
+  console.log(pc4.cyan(`  Checking database "${db}" (${args.local ? "local" : "remote"})\u2026
 `));
-        process.exit(1);
-      }
-    } catch {
-      console.log(pc3.red("\n  \u2717 Could not query the database\n"));
-      console.log(pc3.dim("  Run `beech init --db` first to initialise the database."));
+  const existingTables = getExistingTables(options);
+  const missingTables = SYSTEM_TABLES.filter((t) => !existingTables?.includes(t));
+  if (!args.local) {
+    if (existingTables === null) {
+      console.log(pc4.red("  \u2717 Remote database unreachable\n"));
+      console.log(pc4.dim("  Most likely causes:"));
+      console.log(pc4.dim("    - Wrong database_id in wrangler.jsonc"));
+      console.log(pc4.dim("    - Worker not yet deployed"));
+      console.log(pc4.cyan("\n  \u2192 Fix:  Update d1_databases.database_id in wrangler.jsonc"));
+      console.log(pc4.cyan("  \u2192 Then: npm run deploy\n"));
       process.exit(1);
     }
+    if (missingTables.length > 0) {
+      console.log(pc4.yellow(`  \u26A0 Missing system tables: ${missingTables.join(", ")}
+`));
+      console.log(pc4.dim("  Most likely causes:"));
+      console.log(pc4.dim("    - Wrong database_id in wrangler.jsonc"));
+      console.log(pc4.dim("    - Migrations did not run during deploy"));
+      console.log(pc4.cyan("\n  \u2192 Fix:  Update d1_databases.database_id in wrangler.jsonc"));
+      console.log(pc4.cyan("  \u2192 Then: npm run deploy\n"));
+      process.exit(1);
+    }
+    for (const table of SYSTEM_TABLES) {
+      console.log(pc4.green(`  \u2713 ${table}`));
+    }
+    console.log(pc4.green("\n  All system tables present. Remote database is initialized.\n"));
+    return;
   }
-  if (args.diff) {
-    await runDiff(options, registry);
+  if (existingTables === null) {
+    console.log(pc4.yellow("  Database unreachable or not yet created \u2014 applying base schema\u2026\n"));
+  } else if (missingTables.length === 0) {
+    console.log(pc4.green("  \u2713 All system tables present. Database already initialised.\n"));
+    printNextSteps(args.local);
+    return;
   } else {
-    await runLoad(options, args.dryRun, registry);
+    console.log(pc4.yellow(`  Missing system tables: ${missingTables.join(", ")}`));
+    console.log(pc4.cyan("\n  Applying base schema\u2026\n"));
   }
+  const ok = executeD1File(BASE_SCHEMA_SQL, options);
+  if (!ok) {
+    console.log(pc4.red("\n  \u2717 Database initialisation failed\n"));
+    console.log(pc4.dim("  wrangler reported an error above."));
+    console.log(pc4.cyan("\n  \u2192 Run: npx beech init --db --local\n"));
+    process.exit(1);
+  }
+  console.log(pc4.green("\n  \u2713 worker.ts"));
+  console.log(pc4.green(`  \u2713 ${configPath ? basename(configPath) : "wrangler.jsonc"}`));
+  console.log(pc4.green("  \u2713 seeds.ts"));
+  console.log(pc4.green("  \u2713 Local D1 system tables ready\n"));
+  echoApiKeys(configPath);
+  printNextSteps(args.local);
 }
-
-// src/commands/init.ts
-import pc4 from "picocolors";
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { createInterface } from "node:readline/promises";
-import { resolve as resolve2, basename } from "node:path";
-import { spawnSync as spawnSync2 } from "node:child_process";
-var SYSTEM_TABLES = [
-  "users",
-  "refresh_tokens",
-  "password_reset_tokens",
-  "public_idempotency_keys",
-  "analytics",
-  "system_stats",
-  "activity_logs",
-  "notifications",
-  "media_objects",
-  "content_event_log",
-  "automations",
-  "seeds",
-  "seed_meta",
-  "site_settings"
-];
-var BASE_SCHEMA_SQL = `
+var SYSTEM_TABLES, BASE_SCHEMA_SQL, PLACEHOLDER_DB_IDS;
+var init_init = __esm({
+  "src/commands/init.ts"() {
+    "use strict";
+    init_wrangler();
+    SYSTEM_TABLES = [
+      "users",
+      "refresh_tokens",
+      "password_reset_tokens",
+      "public_idempotency_keys",
+      "analytics",
+      "system_stats",
+      "activity_logs",
+      "notifications",
+      "media_objects",
+      "content_event_log",
+      "automations",
+      "seeds",
+      "seed_meta",
+      "site_settings"
+    ];
+    BASE_SCHEMA_SQL = `
 CREATE TABLE IF NOT EXISTS users (
     id                  TEXT    NOT NULL PRIMARY KEY,
     email               TEXT    NOT NULL UNIQUE,
@@ -623,344 +636,367 @@ CREATE TABLE IF NOT EXISTS site_settings (
     value TEXT NOT NULL
 );
 `.trim();
-var PLACEHOLDER_DB_IDS = [
-  "INCOLLA_QUI_IL_TUO_ID_D1",
-  "FILL_IN_YOUR_D1_DATABASE_ID",
-  "YOUR_D1_DATABASE_ID"
-];
-function checkWranglerAuth() {
-  const result = spawnSync2("npx", ["wrangler", "whoami", "--json"], {
-    encoding: "utf-8",
-    cwd: process.cwd(),
-    shell: true
-  });
-  return result.status === 0;
+    PLACEHOLDER_DB_IDS = [
+      "INCOLLA_QUI_IL_TUO_ID_D1",
+      "FILL_IN_YOUR_D1_DATABASE_ID",
+      "YOUR_D1_DATABASE_ID"
+    ];
+  }
+});
+
+// src/commands/seed-load.ts
+init_wrangler();
+import pc3 from "picocolors";
+import {
+  SEED_REGISTRY as SEED_REGISTRY2,
+  generateCreateTable,
+  generateDraftTable,
+  generateIndexes,
+  generateFtsTable,
+  generateFtsTriggers,
+  generateJunctionTable,
+  generateJunctionIndexes,
+  generateJunctionDraftTable,
+  sortSeedsByDependencies
+} from "@beechcms/core";
+
+// src/lib/schema-diff.ts
+init_wrangler();
+import pc from "picocolors";
+import { getExpectedColumns } from "@beechcms/core";
+function isSeedClean(diff) {
+  return diff.tableExists && diff.columns.every((c) => c.status === "ok");
 }
-function checkWranglerPlaceholders(configPath) {
-  try {
-    const raw = readFileSync2(configPath, "utf-8");
-    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
-    const parsed = JSON.parse(stripped);
-    const bindings = parsed?.d1_databases ?? [];
-    const issues = [];
-    for (const b of bindings) {
-      const id = b.database_id ?? "";
-      if (!id || PLACEHOLDER_DB_IDS.includes(id)) {
-        issues.push(`d1_databases[0].database_id is "${id || "(empty)"}"`);
-      }
+function renderSeedDiff(diff) {
+  const table = `content_${diff.slug}`;
+  if (!diff.tableExists) {
+    console.log(pc.red(`  \u2717 ${table} \u2014 table missing`));
+    return;
+  }
+  const problems = diff.columns.filter((c) => c.status !== "ok");
+  if (problems.length === 0) {
+    console.log(pc.green(`  \u2713 ${table}`));
+    return;
+  }
+  console.log(pc.yellow(`  \u26A0 ${table}`));
+  for (const col of problems) {
+    switch (col.status) {
+      case "missing":
+        console.log(pc.red(`    + missing column: ${col.name} ${col.expectedType}`));
+        break;
+      case "extra":
+        console.log(pc.dim(`    ~ orphaned column: "${col.name}" (${col.actualType}) \u2014 in DB, not in seeds.ts`));
+        break;
+      case "type_mismatch":
+        console.log(pc.red(`    \u2260 type mismatch:  ${col.name} (expected ${col.expectedType}, got ${col.actualType})`));
+        break;
+      case "fk_missing":
+        console.log(pc.red(`    \u292C missing FK: ${col.name} \u2192 content_${col.expectedTarget}(id)`));
+        break;
+      case "fk_mismatch":
+        console.log(pc.yellow(`    \u292C FK mismatch: ${col.name} expected ${col.expected}, got ${col.actual}`));
+        break;
+      case "index_missing":
+        console.log(pc.yellow(`    \u2298 missing index on ${col.name}`));
+        break;
     }
-    return issues;
-  } catch {
-    return [];
   }
 }
-function readProjectName(configPath) {
-  if (!configPath) return basename(process.cwd());
+async function diffSeed(seed, options) {
+  const tableName = `content_${seed.slug}`;
+  const expected = getExpectedColumns(seed);
+  let actual;
   try {
-    const raw = readFileSync2(configPath, "utf-8");
-    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
-    const parsed = JSON.parse(stripped);
-    return parsed?.name || basename(process.cwd());
+    actual = queryD1(`PRAGMA table_info(${tableName})`, options);
   } catch {
-    return basename(process.cwd());
+    return { slug: seed.slug, tableExists: false, columns: expected.map((c) => ({ name: c.name, status: "missing", expectedType: c.sqlType })) };
   }
-}
-function readBucketName(configPath) {
-  if (!configPath) return null;
-  try {
-    const raw = readFileSync2(configPath, "utf-8");
-    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
-    const parsed = JSON.parse(stripped);
-    const buckets = parsed?.r2_buckets ?? [];
-    return buckets[0]?.bucket_name ?? null;
-  } catch {
-    return null;
+  if (actual.length === 0) {
+    return { slug: seed.slug, tableExists: false, columns: expected.map((c) => ({ name: c.name, status: "missing", expectedType: c.sqlType })) };
   }
-}
-function createD1Database(dbName) {
-  const result = spawnSync2("npx", ["wrangler", "d1", "create", dbName, "--json"], {
-    encoding: "utf-8",
-    cwd: process.cwd(),
-    shell: true,
-    stdio: ["inherit", "pipe", "pipe"]
-  });
-  if (result.status !== 0) return null;
-  try {
-    const parsed = JSON.parse(result.stdout);
-    return parsed?.uuid ?? parsed?.database_id ?? null;
-  } catch {
-    return null;
+  const actualMap = new Map(actual.map((r) => [r.name, r]));
+  const expectedSet = new Set(expected.map((c) => c.name));
+  const columns = [];
+  for (const col of expected) {
+    const actualRow = actualMap.get(col.name);
+    if (!actualRow) {
+      columns.push({ name: col.name, status: "missing", expectedType: col.sqlType });
+    } else if (actualRow.type.toUpperCase() !== col.sqlType) {
+      columns.push({ name: col.name, status: "type_mismatch", expectedType: col.sqlType, actualType: actualRow.type });
+    } else {
+      columns.push({ name: col.name, status: "ok" });
+    }
   }
-}
-function createR2Bucket(bucketName) {
-  const result = spawnSync2("npx", ["wrangler", "r2", "bucket", "create", bucketName], {
-    stdio: "inherit",
-    cwd: process.cwd(),
-    shell: true
-  });
-  return result.status === 0;
-}
-function patchWranglerConfig(configPath, dbId) {
-  try {
-    let raw = readFileSync2(configPath, "utf-8");
-    for (const placeholder of PLACEHOLDER_DB_IDS) {
-      raw = raw.split(placeholder).join(dbId);
+  for (const row of actual) {
+    if (!expectedSet.has(row.name)) {
+      columns.push({ name: row.name, status: "extra", actualType: row.type });
+    }
+  }
+  const relationBranches = seed.branches.filter((b) => b.type === "relation" && b.targetSeed);
+  if (relationBranches.length > 0) {
+    let fkList = [];
+    let indexList = [];
+    try {
+      fkList = queryD1(`PRAGMA foreign_key_list(${tableName})`, options);
+      indexList = queryD1(`PRAGMA index_list(${tableName})`, options);
+    } catch {
+    }
+    const fkByCol = /* @__PURE__ */ new Map();
+    for (const fk of fkList) {
+      fkByCol.set(fk.from, fk);
+    }
+    const indexNames = new Set(indexList.map((i) => i.name));
+    for (const branch of relationBranches) {
+      const expectedFkTable = `content_${branch.targetSeed}`;
+      const expectedOnDelete = (branch.onDelete ?? "SET NULL").toUpperCase();
+      const expectedIndexName = `idx_${seed.slug}_${branch.alias}`;
+      const colDiff = columns.find((c) => c.name === branch.alias);
+      if (!colDiff || colDiff.status === "missing") continue;
+      const fk = fkByCol.get(branch.alias);
+      if (!fk) {
+        colDiff.status = "fk_missing";
+        colDiff.expectedTarget = branch.targetSeed;
+      } else {
+        const actualTable = fk.table;
+        const actualOnDelete = fk.on_delete.toUpperCase();
+        if (actualTable !== expectedFkTable || actualOnDelete !== expectedOnDelete) {
+          colDiff.status = "fk_mismatch";
+          colDiff.expected = `\u2192 ${expectedFkTable}(id) ON DELETE ${expectedOnDelete}`;
+          colDiff.actual = `\u2192 ${actualTable}(id) ON DELETE ${actualOnDelete}`;
+          colDiff.expectedTarget = branch.targetSeed;
+        }
+      }
+      if (!indexNames.has(expectedIndexName)) {
+        if (colDiff.status === "ok") {
+          colDiff.status = "index_missing";
+        } else {
+          columns.push({ name: branch.alias, status: "index_missing" });
+        }
+      }
     }
-    raw = raw.replace(/"database_id"\s*:\s*""/g, `"database_id": "${dbId}"`);
-    writeFileSync2(configPath, raw, "utf-8");
-    return true;
-  } catch {
-    return false;
   }
+  return { slug: seed.slug, tableExists: true, columns };
 }
-function printManualDbInstructions() {
-  console.log(pc4.dim("\n  Update your D1 database_id in wrangler.jsonc,"));
-  console.log(pc4.dim("  or create a new database with:"));
-  console.log(pc4.cyan("\n  \u2192 Run:  npx wrangler d1 create my-project-db"));
-  console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
+
+// src/commands/validate.ts
+import pc2 from "picocolors";
+import { SEED_REGISTRY, validateSeedDefinitions } from "@beechcms/core";
+function validateSeeds(registry) {
+  return validateSeedDefinitions(Object.values(registry));
 }
-function echoApiKeys(configPath) {
-  if (!configPath) return;
-  try {
-    const raw = readFileSync2(configPath, "utf-8");
-    const stripped = raw.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
-    const parsed = JSON.parse(stripped);
-    const vars = parsed?.vars ?? {};
-    const readKey = vars["PUBLIC_READ_API_KEY"];
-    const writeKey = vars["PUBLIC_WRITE_API_KEY"];
-    if (!readKey && !writeKey) return;
-    console.log(pc4.dim("  API keys detected in wrangler.jsonc:\n"));
-    if (readKey) {
-      const masked = readKey.length > 8 ? readKey.slice(0, 4) + "****" + readKey.slice(-4) : "****";
-      console.log(pc4.dim(`    PUBLIC_READ_API_KEY  = ${masked}`));
+async function validate(args) {
+  const registry = args.registry ?? SEED_REGISTRY;
+  if (Object.keys(registry).length === 0) {
+    console.warn(pc2.yellow("\n  Warning: SEED_REGISTRY is empty. Create a seeds.ts in your project root.\n"));
+    return;
+  }
+  console.log(pc2.cyan("\n  beech validate \u2014 checking seeds\n"));
+  const errors = validateSeeds(registry);
+  const fatalErrors = errors.filter((e) => e.fatal);
+  const warnings = errors.filter((e) => !e.fatal);
+  for (const e of fatalErrors) {
+    console.log(pc2.red(`  \u2717 ${e.slug} (fatal)`));
+    for (const msg of e.messages) {
+      console.log(pc2.red(`      \u2192 ${msg}`));
     }
-    if (writeKey) {
-      const masked = writeKey.length > 8 ? writeKey.slice(0, 4) + "****" + writeKey.slice(-4) : "****";
-      console.log(pc4.dim(`    PUBLIC_WRITE_API_KEY = ${masked}`));
+  }
+  const warningMap = new Map(warnings.map((e) => [e.slug, e.messages]));
+  const allWarningSlugsSeen = new Set(warnings.map((e) => e.slug));
+  for (const seed of Object.values(registry)) {
+    const msgs = warningMap.get(seed.slug);
+    if (!msgs) {
+      if (!allWarningSlugsSeen.has(seed.slug)) {
+        const hasFatal = fatalErrors.some((e) => e.slug === seed.slug);
+        if (!hasFatal) console.log(pc2.green(`  \u2713 ${seed.slug}`));
+      }
+    } else {
+      console.log(pc2.yellow(`  \u26A0 ${seed.slug}`));
+      for (const msg of msgs) {
+        console.log(pc2.yellow(`      \u2192 ${msg}`));
+      }
     }
-    console.log(pc4.dim("\n  Use these in your frontend as the X-API-Key header.\n"));
-  } catch {
   }
-}
-function checkFiles(cwd, checkDevVars) {
-  let ok = true;
-  const workerExists = existsSync2(resolve2(cwd, "worker.ts")) || existsSync2(resolve2(cwd, "worker.js"));
-  if (!workerExists) {
-    console.log(pc4.red("  \u2717 worker.ts        \u2014 missing (required)"));
-    ok = false;
+  console.log("");
+  const totalFatal = fatalErrors.reduce((n, e) => n + e.messages.length, 0);
+  const totalWarnings = warnings.reduce((n, e) => n + e.messages.length, 0);
+  if (totalFatal > 0) {
+    const s = totalFatal !== 1 ? "s" : "";
+    console.log(pc2.red(`  Found ${totalFatal} fatal error${s}. Fix before loading.
+`));
+    process.exit(1);
+  } else if (totalWarnings > 0) {
+    const s = totalWarnings !== 1 ? "s" : "";
+    console.log(pc2.yellow(`  Found ${totalWarnings} warning${s}. Review seeds above.
+`));
   } else {
-    console.log(pc4.green("  \u2713 worker.ts"));
+    console.log(pc2.green("  All seeds valid.\n"));
   }
-  const configPath = findWranglerConfig();
-  const configInCwd = configPath && (configPath === resolve2(cwd, "wrangler.jsonc") || configPath === resolve2(cwd, "wrangler.json") || configPath === resolve2(cwd, "wrangler.toml"));
-  if (!configInCwd) {
-    console.log(pc4.red("  \u2717 wrangler.jsonc   \u2014 missing (required)"));
-    ok = false;
-  } else {
-    console.log(pc4.green(`  \u2713 ${basename(configPath)}`));
+}
+
+// src/commands/seed-load.ts
+function buildSeedRegistrationSql(seed) {
+  const json = sqlQuote(JSON.stringify(seed));
+  return [
+    `INSERT INTO seeds (slug, definition, status, source, created_at, updated_at)`,
+    `VALUES (${sqlQuote(seed.slug)}, ${json}, 'active', 'code', unixepoch(), unixepoch())`,
+    `ON CONFLICT(slug) DO UPDATE SET definition = excluded.definition, status = 'active', updated_at = excluded.updated_at;`
+  ].join("\n");
+}
+var SEED_META_BUMP_SQL = `UPDATE seed_meta SET value = CAST(CAST(value AS INTEGER) + 1 AS TEXT) WHERE id = 'registry_version';`;
+function buildStatements(seed) {
+  const stmts = [generateCreateTable(seed), ...generateIndexes(seed)];
+  const draft = generateDraftTable(seed);
+  if (draft) stmts.push(draft);
+  const fts = generateFtsTable(seed);
+  if (fts) {
+    stmts.push(fts, ...generateFtsTriggers(seed));
+  }
+  for (const branch of seed.branches) {
+    if (branch.type !== "relation" || branch.multiple !== true) continue;
+    stmts.push(generateJunctionTable(seed, branch), ...generateJunctionIndexes(seed, branch));
+    const draftJunction = generateJunctionDraftTable(seed, branch);
+    if (draftJunction) stmts.push(draftJunction);
+  }
+  return stmts;
+}
+async function runDiff(options, registry) {
+  const seeds = sortSeedsByDependencies(Object.values(registry));
+  console.log(pc3.cyan("\n  Diffing schema\u2026\n"));
+  let allOk = true;
+  for (const seed of seeds) {
+    const result = await diffSeed(seed, options);
+    renderSeedDiff(result);
+    if (!isSeedClean(result)) allOk = false;
   }
-  const seedsExists = existsSync2(resolve2(cwd, "seeds.ts")) || existsSync2(resolve2(cwd, "seeds.js")) || existsSync2(resolve2(cwd, "seed.ts")) || existsSync2(resolve2(cwd, "seed.js"));
-  if (!seedsExists) {
-    console.log(pc4.yellow("  \u26A0 seeds.ts         \u2014 not found (optional: needed only for the one-time code \u2192 DB load; after `beech seed:load`, the DB is canonical)"));
+  console.log("");
+  if (allOk) {
+    console.log(pc3.green("  Schema matches seeds. No action needed.\n"));
   } else {
-    console.log(pc4.green("  \u2713 seeds.ts"));
+    console.log(pc3.yellow("  Run `beech seed:load` to apply missing tables/columns.\n"));
   }
-  if (checkDevVars) {
-    if (!existsSync2(resolve2(cwd, ".dev.vars"))) {
-      console.log(pc4.dim("  \u25CB .dev.vars        \u2014 not found (optional: only needed for production R2 credentials)"));
-    } else {
-      console.log(pc4.green("  \u2713 .dev.vars"));
+}
+async function runLoad(options, dryRun, registry) {
+  const seeds = sortSeedsByDependencies(Object.values(registry));
+  if (dryRun) {
+    console.log(pc3.cyan("\n  -- dry-run: SQL that would be executed\n"));
+    for (const seed of seeds) {
+      const stmts = buildStatements(seed);
+      console.log(pc3.dim(`  -- content_${seed.slug}`));
+      for (const stmt of stmts) {
+        console.log(stmt + "\n");
+      }
+      console.log(pc3.dim(`  -- register ${seed.slug} in seeds table`));
+      console.log(buildSeedRegistrationSql(seed) + "\n");
     }
+    console.log(pc3.dim("  -- bump registry_version"));
+    console.log(SEED_META_BUMP_SQL + "\n");
+    return;
   }
-  return ok;
-}
-function printNextSteps(local) {
-  const localFlag = local ? " --local" : "";
-  console.log(pc4.dim("  Next steps:"));
-  console.log(pc4.cyan(`  1. npx beech seed:load${localFlag}`));
-  console.log(pc4.dim("      \u2192 create content tables and register seed definitions in D1"));
-  console.log(pc4.cyan("  2. npx wrangler dev"));
-  console.log(pc4.dim("      \u2192 start API + dashboard"));
-  console.log(pc4.dim("  3. Open http://localhost:8789/admin\n"));
-}
-function getExistingTables(options) {
-  try {
-    const rows = queryD1(
-      `SELECT name FROM sqlite_master WHERE type='table'`,
-      options
-    );
-    return rows.map((r) => r.name);
-  } catch {
-    return null;
+  console.log(pc3.cyan(`
+  Loading seeds into ${options.local ? "local" : "remote"} D1 (${options.db})\u2026
+`));
+  for (const seed of seeds) {
+    const stmts = [...buildStatements(seed), buildSeedRegistrationSql(seed)];
+    const sql = stmts.join("\n\n") + "\n";
+    process.stdout.write(`  ${pc3.dim("\u2192")} content_${seed.slug}\u2026 `);
+    const ok = executeD1File(sql, options);
+    if (!ok) {
+      console.log(pc3.red("failed"));
+      console.log(pc3.red(`
+  \u2717 Failed to apply schema for content_${seed.slug}
+`));
+      console.log(pc3.dim("  wrangler reported an error above."));
+      console.log(pc3.dim(`  Most likely causes:`));
+      console.log(pc3.dim(`    - Database "${options.db}" not found or wrong database_id`));
+      if (!options.local) {
+        console.log(pc3.dim("    - Not logged in to Cloudflare"));
+        console.log(pc3.cyan("\n  \u2192 Run:  npx wrangler login"));
+        console.log(pc3.cyan("  \u2192 Then: npx beech seed:load\n"));
+      } else {
+        console.log(pc3.cyan("\n  \u2192 Run:  npx beech init --db --local   # re-initialise local DB"));
+        console.log(pc3.cyan("  \u2192 Then: npx beech seed:load --local\n"));
+      }
+      process.exit(1);
+    }
+    console.log(pc3.green("done"));
   }
+  executeD1File(SEED_META_BUMP_SQL, options);
+  console.log(pc3.green("\n  All seeds loaded.\n"));
+  console.log(pc3.dim("  Definitions registered in the database."));
+  console.log(pc3.dim("  seed.ts is no longer required at runtime \u2014 you may keep it for code-first edits or delete it.\n"));
 }
-async function init(args) {
-  const cwd = process.cwd();
-  console.log(pc4.cyan("\n  beech init \u2014 project check\n"));
-  const filesOk = checkFiles(cwd, args.local);
-  if (!filesOk) {
-    console.log(pc4.red("\n  \u2717 Required files missing\n"));
-    console.log(pc4.dim("  Fix the errors above before initialising the database."));
-    console.log(pc4.cyan("\n  \u2192 See: https://beechcms.dev/docs/getting-started\n"));
-    process.exit(1);
-  }
-  console.log(pc4.green("\n  All required files present.\n"));
-  if (!args.initDb) {
-    echoApiKeys(findWranglerConfig());
-    const localFlag = args.local ? " --local" : "";
-    console.log(pc4.dim("  Next steps:"));
-    console.log(pc4.dim(`  1. npx beech init --db${localFlag}     # initialise D1 database`));
-    console.log(pc4.dim(`  2. npx beech seed:load${localFlag}     # create content tables`));
-    console.log(pc4.dim("  3. npx wrangler dev                 # start API + dashboard"));
-    console.log(pc4.dim("  4. Open http://localhost:8789/admin\n"));
+async function seedLoad(args) {
+  const registry = args.registry ?? SEED_REGISTRY2;
+  if (Object.keys(registry).length === 0) {
+    console.log(pc3.yellow("\n  \u2717 No seeds found\n"));
+    console.log(pc3.dim("  Create a seeds.ts file in your project root with at least one content type."));
+    console.log(pc3.cyan("\n  \u2192 Run: npx beech seed:create\n"));
     return;
   }
-  const configPath = findWranglerConfig();
-  if (configPath) {
-    const placeholders = checkWranglerPlaceholders(configPath);
-    if (placeholders.length > 0) {
-      console.log(pc4.yellow("  \u26A0 wrangler.jsonc contains placeholder values:\n"));
-      for (const issue of placeholders) {
-        console.log(pc4.yellow(`    - ${issue}`));
-      }
-      if (process.stdin.isTTY && !args.nonInteractive) {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        let autoCreate = false;
-        try {
-          const answer = (await rl.question(
-            pc4.cyan("\n  \u2192 Create a new D1 database (and R2 bucket) on Cloudflare automatically? (Y/n): ")
-          )).trim().toLowerCase();
-          autoCreate = !answer || answer === "y" || answer === "yes";
-        } finally {
-          rl.close();
-        }
-        if (autoCreate) {
-          const authed = checkWranglerAuth();
-          if (!authed) {
-            console.log(pc4.red("\n  \u2717 Not logged in to Cloudflare\n"));
-            console.log(pc4.dim("  BeechCMS needs access to your Cloudflare account to create the database."));
-            console.log(pc4.cyan("\n  \u2192 Run:  npx wrangler login"));
-            console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
-            process.exit(1);
-          }
-          const projectName = readProjectName(configPath);
-          const dbName = `${projectName}-db`;
-          const bucketName = readBucketName(configPath) || `${projectName}-media`;
-          console.log(pc4.dim(`
-  Creating D1 database "${dbName}"\u2026`));
-          const dbId = createD1Database(dbName);
-          if (!dbId) {
-            console.log(pc4.red("\n  \u2717 Failed to create D1 database\n"));
-            console.log(pc4.dim("  Create it manually and retry:"));
-            console.log(pc4.cyan(`
-  \u2192 Run:  npx wrangler d1 create ${dbName}`));
-            console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
-            process.exit(1);
-          }
-          console.log(pc4.green(`  \u2713 D1 database created (id: ${dbId})`));
-          console.log(pc4.dim(`
-  Creating R2 bucket "${bucketName}"\u2026`));
-          const r2Ok = createR2Bucket(bucketName);
-          if (r2Ok) {
-            console.log(pc4.green(`  \u2713 R2 bucket "${bucketName}" created`));
-          } else {
-            console.log(pc4.yellow(`  \u26A0 R2 bucket creation failed (may already exist \u2014 continuing)`));
-          }
-          console.log(pc4.dim("\n  Updating wrangler.jsonc\u2026"));
-          const patched = patchWranglerConfig(configPath, dbId);
-          if (patched) {
-            console.log(pc4.green("  \u2713 wrangler.jsonc updated\n"));
-          } else {
-            console.log(pc4.yellow(`  \u26A0 Could not update wrangler.jsonc automatically
+  const validationErrors = validateSeeds(registry);
+  const fatalErrors = validationErrors.filter((e) => e.fatal);
+  const warnings = validationErrors.filter((e) => !e.fatal);
+  if (fatalErrors.length > 0) {
+    const total = fatalErrors.reduce((n, e) => n + e.messages.length, 0);
+    const s = total !== 1 ? "s" : "";
+    console.log(pc3.red(`
+  \u2717 Seed validation found ${total} fatal error${s}. Cannot load schema.
 `));
-            console.log(pc4.dim(`  Set database_id = "${dbId}" in wrangler.jsonc manually, then retry:`));
-            console.log(pc4.cyan("  \u2192 Run: npx beech init --db\n"));
-            process.exit(1);
-          }
-        } else {
-          printManualDbInstructions();
-          process.exit(1);
-        }
-      } else if (args.nonInteractive && args.local) {
-        console.log(pc4.dim("  --yes: proceeding with local mode (no remote resources needed)\n"));
-      } else {
-        if (args.nonInteractive) {
-          console.log(pc4.red("\n  \u2717 Cannot proceed non-interactively: remote database has a placeholder database_id\n"));
-          console.log(pc4.dim("  Set a real database_id in wrangler.jsonc, then retry."));
-          process.exit(1);
-        }
-        printManualDbInstructions();
-        process.exit(1);
+    for (const e of fatalErrors) {
+      console.log(pc3.red(`  \u2717 ${e.slug}`));
+      for (const msg of e.messages) {
+        console.log(pc3.red(`      \u2192 ${msg}`));
       }
     }
+    console.log("");
+    process.exit(1);
   }
-  if (!args.local) {
-    const authed = checkWranglerAuth();
-    if (!authed) {
-      console.log(pc4.red("  \u2717 Not logged in to Cloudflare\n"));
-      console.log(pc4.dim("  BeechCMS needs access to your Cloudflare account to manage the D1 database."));
-      console.log(pc4.cyan("\n  \u2192 Run:  npx wrangler login"));
-      console.log(pc4.cyan("  \u2192 Then: npx beech init --db\n"));
-      process.exit(1);
-    }
+  if (warnings.length > 0) {
+    const total = warnings.reduce((n, e) => n + e.messages.length, 0);
+    const s = total !== 1 ? "s" : "";
+    console.log(pc3.yellow(`
+  \u26A0 Seed validation found ${total} issue${s}. Schema changes will still be applied.
+`));
+    console.log(pc3.dim('  Run "npx beech validate" for details.\n'));
   }
+  const configPath = findWranglerConfig();
   const db = args.db ?? resolveDbName(configPath);
-  const options = { db, local: args.local, configPath };
-  console.log(pc4.cyan(`  Checking database "${db}" (${args.local ? "local" : "remote"})\u2026
-`));
-  const existingTables = getExistingTables(options);
-  const missingTables = SYSTEM_TABLES.filter((t) => !existingTables?.includes(t));
-  if (!args.local) {
-    if (existingTables === null) {
-      console.log(pc4.red("  \u2717 Remote database unreachable\n"));
-      console.log(pc4.dim("  Most likely causes:"));
-      console.log(pc4.dim("    - Wrong database_id in wrangler.jsonc"));
-      console.log(pc4.dim("    - Worker not yet deployed"));
-      console.log(pc4.cyan("\n  \u2192 Fix:  Update d1_databases.database_id in wrangler.jsonc"));
-      console.log(pc4.cyan("  \u2192 Then: npm run deploy\n"));
-      process.exit(1);
-    }
-    if (missingTables.length > 0) {
-      console.log(pc4.yellow(`  \u26A0 Missing system tables: ${missingTables.join(", ")}
+  const options = {
+    db,
+    local: args.local,
+    configPath
+  };
+  if (!args.dryRun && !args.diff) {
+    try {
+      const rows = queryD1(
+        `SELECT name FROM sqlite_master WHERE type='table' AND name IN ('seeds','seed_meta')`,
+        options
+      );
+      if (rows.length < 2) {
+        console.log(pc3.red("\n  \u2717 System tables not found (seeds, seed_meta)\n"));
+        console.log(pc3.dim("  Run `beech init --db` first to initialise the database."));
+        const flag = args.local ? " --local" : "";
+        console.log(pc3.cyan(`
+  \u2192 Run: npx beech init --db${flag}
 `));
-      console.log(pc4.dim("  Most likely causes:"));
-      console.log(pc4.dim("    - Wrong database_id in wrangler.jsonc"));
-      console.log(pc4.dim("    - Migrations did not run during deploy"));
-      console.log(pc4.cyan("\n  \u2192 Fix:  Update d1_databases.database_id in wrangler.jsonc"));
-      console.log(pc4.cyan("  \u2192 Then: npm run deploy\n"));
+        process.exit(1);
+      }
+    } catch {
+      console.log(pc3.red("\n  \u2717 Could not query the database\n"));
+      console.log(pc3.dim("  Run `beech init --db` first to initialise the database."));
       process.exit(1);
     }
-    for (const table of SYSTEM_TABLES) {
-      console.log(pc4.green(`  \u2713 ${table}`));
-    }
-    console.log(pc4.green("\n  All system tables present. Remote database is initialized.\n"));
-    return;
   }
-  if (existingTables === null) {
-    console.log(pc4.yellow("  Database unreachable or not yet created \u2014 applying base schema\u2026\n"));
-  } else if (missingTables.length === 0) {
-    console.log(pc4.green("  \u2713 All system tables present. Database already initialised.\n"));
-    printNextSteps(args.local);
-    return;
+  if (args.diff) {
+    await runDiff(options, registry);
   } else {
-    console.log(pc4.yellow(`  Missing system tables: ${missingTables.join(", ")}`));
-    console.log(pc4.cyan("\n  Applying base schema\u2026\n"));
-  }
-  const ok = executeD1File(BASE_SCHEMA_SQL, options);
-  if (!ok) {
-    console.log(pc4.red("\n  \u2717 Database initialisation failed\n"));
-    console.log(pc4.dim("  wrangler reported an error above."));
-    console.log(pc4.cyan("\n  \u2192 Run: npx beech init --db --local\n"));
-    process.exit(1);
+    await runLoad(options, args.dryRun, registry);
   }
-  console.log(pc4.green("\n  \u2713 worker.ts"));
-  console.log(pc4.green(`  \u2713 ${configPath ? basename(configPath) : "wrangler.jsonc"}`));
-  console.log(pc4.green("  \u2713 seeds.ts"));
-  console.log(pc4.green("  \u2713 Local D1 system tables ready\n"));
-  echoApiKeys(configPath);
-  printNextSteps(args.local);
 }
 
+// src/index.ts
+init_init();
+
 // src/commands/seed-create.ts
 import pc5 from "picocolors";
 import { createInterface as createInterface2 } from "node:readline/promises";
@@ -1110,6 +1146,7 @@ async function seedCreate(_args) {
 }
 
 // src/commands/deploy.ts
+init_wrangler();
 import pc6 from "picocolors";
 import { spawnSync as spawnSync3 } from "node:child_process";
 import { readFileSync as readFileSync4 } from "node:fs";
@@ -1207,6 +1244,7 @@ async function deploy(args) {
 }
 
 // src/commands/onboard.ts
+init_init();
 import pc7 from "picocolors";
 async function onboard(args) {
   console.log(pc7.cyan("\n  beech onboard \u2014 full provisioning\n"));
@@ -1263,14 +1301,82 @@ async function update(_args) {
 }
 
 // src/commands/reset.ts
+import pc11 from "picocolors";
+import { createInterface as createInterface3 } from "node:readline/promises";
+
+// src/commands/db-reset.ts
 import pc9 from "picocolors";
 import { spawnSync as spawnSync5 } from "node:child_process";
 import { existsSync as existsSync4, readFileSync as readFileSync5, rmSync as rmSync2 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
-import { createInterface as createInterface3 } from "node:readline/promises";
+async function dbReset(_args) {
+  console.log(pc9.cyan("\n  beech db:reset \u2014 reset local database\n"));
+  const cwd = process.cwd();
+  const apiDir = resolve4(cwd, "apps", "api");
+  let dbResetSuccess = false;
+  if (existsSync4(resolve4(apiDir, "package.json"))) {
+    const result = spawnSync5("npm", ["run", "db:reset:local"], {
+      stdio: "inherit",
+      cwd: apiDir,
+      shell: true
+    });
+    dbResetSuccess = result.status === 0;
+  } else if (existsSync4(resolve4(cwd, "package.json"))) {
+    const pkg = JSON.parse(readFileSync5(resolve4(cwd, "package.json"), "utf-8"));
+    if (pkg.scripts?.["db:reset:local"]) {
+      const result = spawnSync5("npm", ["run", "db:reset:local"], {
+        stdio: "inherit",
+        cwd,
+        shell: true
+      });
+      dbResetSuccess = result.status === 0;
+    } else {
+      const wranglerStateDir = resolve4(cwd, ".wrangler/state");
+      if (existsSync4(wranglerStateDir)) {
+        console.log(pc9.dim("  Removing .wrangler/state\u2026"));
+        rmSync2(wranglerStateDir, { recursive: true, force: true });
+      }
+      if (existsSync4(resolve4(cwd, "scripts", "bootstrap-d1.mjs"))) {
+        const result = spawnSync5("node", ["scripts/bootstrap-d1.mjs"], {
+          stdio: "inherit",
+          cwd,
+          shell: true
+        });
+        dbResetSuccess = result.status === 0;
+      } else {
+        console.log(pc9.yellow("  \u26A0 Could not find database reset script."));
+        const { init: init2 } = await Promise.resolve().then(() => (init_init(), init_exports));
+        try {
+          await init2({ initDb: true, local: true });
+          dbResetSuccess = true;
+        } catch {
+          dbResetSuccess = false;
+        }
+      }
+    }
+  } else {
+    const wranglerStateDir = resolve4(cwd, ".wrangler/state");
+    if (existsSync4(wranglerStateDir)) {
+      console.log(pc9.dim("  Removing .wrangler/state\u2026"));
+      rmSync2(wranglerStateDir, { recursive: true, force: true });
+    }
+    dbResetSuccess = true;
+  }
+  if (dbResetSuccess) {
+    console.log(pc9.green("\n  \u2713 Local database reset completed."));
+  } else {
+    console.log(pc9.red("\n  \u2717 Database reset failed."));
+    process.exit(1);
+    return;
+  }
+}
+
+// src/commands/dev-reset.ts
+import pc10 from "picocolors";
+import { spawnSync as spawnSync6 } from "node:child_process";
 function isDockerInstalled() {
   try {
-    const result = spawnSync5("docker", ["--version"], { stdio: "ignore", shell: true });
+    const result = spawnSync6("docker", ["--version"], { stdio: "ignore", shell: true });
     return result.status === 0;
   } catch {
     return false;
@@ -1278,130 +1384,82 @@ function isDockerInstalled() {
 }
 function isDockerRunning() {
   try {
-    const result = spawnSync5("docker", ["info"], { stdio: "ignore", shell: true });
+    const result = spawnSync6("docker", ["info"], { stdio: "ignore", shell: true });
     return result.status === 0;
   } catch {
     return false;
   }
 }
+async function devReset() {
+  console.log(pc10.cyan("\n  beech dev:reset \u2014 reset Docker environment\n"));
+  if (!isDockerInstalled()) {
+    console.log(pc10.red("  \u2717 Docker is not installed or not found in your PATH."));
+    process.exit(1);
+    return;
+  }
+  if (!isDockerRunning()) {
+    console.log(pc10.yellow("  \u26A0 Docker is installed, but the Docker daemon is NOT running."));
+    process.exit(1);
+    return;
+  }
+  console.log(pc10.dim("  Resetting Docker containers and volumes\u2026\n"));
+  const result = spawnSync6("docker", ["compose", "-f", "docker/docker-compose.yml", "down", "-v"], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    shell: true
+  });
+  if (result.status === 0) {
+    console.log(pc10.green("\n  \u2713 Docker containers stopped and volumes removed."));
+  } else {
+    console.log(pc10.red("\n  \u2717 Docker reset failed."));
+    process.exit(1);
+    return;
+  }
+}
+
+// src/commands/reset.ts
 async function reset(args) {
-  console.log(pc9.cyan("\n  beech reset \u2014 cleanup environments\n"));
+  console.log(pc11.cyan("\n  beech reset \u2014 cleanup environments\n"));
   let resetDb = args.db || args.all;
   let resetDocker = args.docker || args.all;
   if (!args.db && !args.docker && !args.all) {
-    if (process.stdin.isTTY) {
+    if (args.yes) {
+      resetDb = true;
+      resetDocker = true;
+    } else if (process.stdin.isTTY) {
       const rl = createInterface3({ input: process.stdin, output: process.stdout });
       try {
         const answer = (await rl.question(
-          pc9.cyan("  \u2192 No options provided. Would you like to reset everything (DB & Docker)? (y/N): ")
+          pc11.cyan("  \u2192 No options provided. Would you like to reset everything (DB & Docker)? (y/N): ")
         )).trim().toLowerCase();
         if (answer === "y" || answer === "yes") {
           resetDb = true;
           resetDocker = true;
         } else {
-          console.log(pc9.dim("\n  Reset cancelled. Use --db, --docker, or --all.\n"));
+          console.log(pc11.dim("\n  Reset cancelled. Use --db, --docker, or --all.\n"));
           return;
         }
       } finally {
         rl.close();
       }
     } else {
-      console.log(pc9.red("\n  \u2717 Error: Please specify what to reset using --db, --docker, or --all.\n"));
+      console.log(pc11.red("\n  \u2717 Error: Please specify what to reset using --db, --docker, or --all.\n"));
       process.exit(1);
     }
   }
-  const cwd = process.cwd();
   if (resetDocker) {
-    if (!isDockerInstalled()) {
-      console.log(pc9.red("  \u2717 Docker is not installed or not found in your PATH."));
-      console.log(pc9.dim("    Please install Docker to reset Docker containers and volumes.\n"));
-      if (!args.all) {
-        process.exit(1);
-      }
-    } else if (!isDockerRunning()) {
-      console.log(pc9.yellow("  \u26A0 Docker is installed, but the Docker daemon is NOT running."));
-      console.log(pc9.dim("    Please start Docker Desktop or your Docker daemon to reset containers.\n"));
-      if (!args.all) {
-        process.exit(1);
-      }
-    } else {
-      console.log(pc9.dim("  Resetting Docker containers and volumes\u2026\n"));
-      const result = spawnSync5("docker", ["compose", "down", "-v"], {
-        stdio: "inherit",
-        cwd,
-        shell: true
-      });
-      if (result.status === 0) {
-        console.log(pc9.green("\n  \u2713 Docker containers stopped and volumes removed."));
-      } else {
-        console.log(pc9.red("\n  \u2717 Docker reset failed."));
-      }
-    }
+    await devReset();
   }
   if (resetDb) {
-    console.log(pc9.dim("\n  Resetting local database\u2026\n"));
-    let dbResetSuccess = false;
-    const apiDir = resolve4(cwd, "apps", "api");
-    if (existsSync4(resolve4(apiDir, "package.json"))) {
-      const result = spawnSync5("npm", ["run", "db:reset:local"], {
-        stdio: "inherit",
-        cwd: apiDir,
-        shell: true
-      });
-      dbResetSuccess = result.status === 0;
-    } else if (existsSync4(resolve4(cwd, "package.json"))) {
-      const pkg = JSON.parse(readFileSync5(resolve4(cwd, "package.json"), "utf-8"));
-      if (pkg.scripts?.["db:reset:local"]) {
-        const result = spawnSync5("npm", ["run", "db:reset:local"], {
-          stdio: "inherit",
-          cwd,
-          shell: true
-        });
-        dbResetSuccess = result.status === 0;
-      } else {
-        const wranglerStateDir = resolve4(cwd, ".wrangler/state");
-        if (existsSync4(wranglerStateDir)) {
-          console.log(pc9.dim("  Removing .wrangler/state\u2026"));
-          rmSync2(wranglerStateDir, { recursive: true, force: true });
-        }
-        if (existsSync4(resolve4(cwd, "scripts", "bootstrap-d1.mjs"))) {
-          const result = spawnSync5("node", ["scripts/bootstrap-d1.mjs"], {
-            stdio: "inherit",
-            cwd,
-            shell: true
-          });
-          dbResetSuccess = result.status === 0;
-        } else {
-          console.log(pc9.yellow("  \u26A0 Could not find database reset script."));
-          const initResult = spawnSync5("npx", ["beech", "init", "--db", "--local"], {
-            stdio: "inherit",
-            cwd,
-            shell: true
-          });
-          dbResetSuccess = initResult.status === 0;
-        }
-      }
-    } else {
-      const wranglerStateDir = resolve4(cwd, ".wrangler/state");
-      if (existsSync4(wranglerStateDir)) {
-        console.log(pc9.dim("  Removing .wrangler/state\u2026"));
-        rmSync2(wranglerStateDir, { recursive: true, force: true });
-      }
-      dbResetSuccess = true;
-    }
-    if (dbResetSuccess) {
-      console.log(pc9.green("\n  \u2713 Local database reset completed."));
-    } else {
-      console.log(pc9.red("\n  \u2717 Database reset failed."));
-    }
+    await dbReset({});
   }
-  console.log(pc9.dim("\n  Reset process finished.\n"));
 }
 
 // src/commands/generate-types.ts
+init_wrangler();
 import { writeFileSync as writeFileSync4, mkdirSync } from "node:fs";
 import { dirname, resolve as resolve5 } from "node:path";
-import pc10 from "picocolors";
+import pc12 from "picocolors";
 import { generateSeedTypes } from "@beechcms/core";
 function loadSeedsFromD1(db) {
   const configPath = findWranglerConfig();
@@ -1417,7 +1475,7 @@ async function generateTypes(args) {
   if (args.local) {
     const registry = args.registry ?? {};
     if (Object.keys(registry).length === 0) {
-      console.log(pc10.red("\n  \u2717 No seeds found (seeds.ts empty or missing).\n"));
+      console.log(pc12.red("\n  \u2717 No seeds found (seeds.ts empty or missing).\n"));
       process.exit(1);
     }
     seeds = Object.values(registry);
@@ -1425,7 +1483,7 @@ async function generateTypes(args) {
     const db = args.db ?? resolveDbName(findWranglerConfig());
     seeds = loadSeedsFromD1(db);
     if (seeds.length === 0) {
-      console.log(pc10.red(`
+      console.log(pc12.red(`
   \u2717 No active seeds in D1 (${db}). Run \`beech seed:load\` first.
 `));
       process.exit(1);
@@ -1435,13 +1493,14 @@ async function generateTypes(args) {
   const outPath = resolve5(process.cwd(), args.out);
   mkdirSync(dirname(outPath), { recursive: true });
   writeFileSync4(outPath, code, "utf-8");
-  console.log(pc10.green(`
+  console.log(pc12.green(`
   \u2713 Generated ${seeds.length} interface(s) \u2192 ${args.out}
 `));
 }
 
 // src/commands/schema-diff.ts
-import pc11 from "picocolors";
+init_wrangler();
+import pc13 from "picocolors";
 import { resolve as resolve6 } from "node:path";
 import { SEED_REGISTRY as SEED_REGISTRY3, sortSeedsByDependencies as sortSeedsByDependencies2 } from "@beechcms/core";
 
@@ -1530,13 +1589,13 @@ function resolveMigrationsDir(override) {
 async function schemaDiff(args) {
   const registry = args.registry ?? SEED_REGISTRY3;
   if (Object.keys(registry).length === 0) {
-    console.log(pc11.yellow("\n  \u2717 No seeds found \u2014 nothing to diff.\n"));
+    console.log(pc13.yellow("\n  \u2717 No seeds found \u2014 nothing to diff.\n"));
     return;
   }
   const configPath = findWranglerConfig();
   const options = { db: args.db ?? resolveDbName(configPath), local: args.local, configPath };
   const seeds = sortSeedsByDependencies2(Object.values(registry));
-  console.log(pc11.cyan(`
+  console.log(pc13.cyan(`
   Diffing schema vs ${args.local ? "local" : "remote"} D1 (${options.db})\u2026
 `));
   const diffs = [];
@@ -1548,45 +1607,323 @@ async function schemaDiff(args) {
     if (!isSeedClean(d)) clean = false;
   }
   if (clean) {
-    console.log(pc11.green("\n  Schema matches seeds. No migration needed.\n"));
+    console.log(pc13.green("\n  Schema matches seeds. No migration needed.\n"));
     return;
   }
   const plan = buildMigrationSql(diffs, registry);
   if (!args.write) {
-    console.log(pc11.dim("\n  -- proposed additive migration (preview):\n"));
+    console.log(pc13.dim("\n  -- proposed additive migration (preview):\n"));
     console.log(plan.sql);
     if (plan.destructiveSlugs.length) {
-      console.log(pc11.yellow(`
+      console.log(pc13.yellow(`
   \u26A0 Destructive drift in: ${plan.destructiveSlugs.join(", ")} \u2014 not auto-migrated.`));
     }
-    console.log(pc11.cyan("\n  \u2192 Re-run with --write to save the migration file.\n"));
+    console.log(pc13.cyan("\n  \u2192 Re-run with --write to save the migration file.\n"));
     return;
   }
   if (plan.additiveCount === 0) {
-    console.log(pc11.yellow("\n  \u26A0 Only destructive drift detected \u2014 no additive migration written."));
-    console.log(pc11.dim("  Author a reviewed migration by hand for renames/drops/type changes.\n"));
+    console.log(pc13.yellow("\n  \u26A0 Only destructive drift detected \u2014 no additive migration written."));
+    console.log(pc13.dim("  Author a reviewed migration by hand for renames/drops/type changes.\n"));
     return;
   }
   const dir = resolveMigrationsDir(args.migrationsDir);
   const index = nextMigrationIndex(dir);
   const file = writeMigrationFile(dir, index, args.name ?? "schema_sync", plan.sql);
-  console.log(pc11.green(`
+  console.log(pc13.green(`
   \u2713 Wrote ${file} (${plan.additiveCount} statement(s)).`));
-  console.log(pc11.dim("  Review, commit, then `wrangler d1 migrations apply --remote` in CI.\n"));
+  console.log(pc13.dim("  Review, commit, then `wrangler d1 migrations apply --remote` in CI.\n"));
   if (plan.destructiveSlugs.length) {
-    console.log(pc11.yellow(`  \u26A0 Destructive drift in ${plan.destructiveSlugs.join(", ")} was NOT included.
+    console.log(pc13.yellow(`  \u26A0 Destructive drift in ${plan.destructiveSlugs.join(", ")} was NOT included.
+`));
+  }
+}
+
+// src/commands/db-migrate.ts
+import pc14 from "picocolors";
+import { spawnSync as spawnSync7 } from "node:child_process";
+import { existsSync as existsSync6 } from "node:fs";
+import { resolve as resolve7 } from "node:path";
+async function dbMigrate(_args) {
+  console.log(pc14.cyan("\n  beech db:migrate \u2014 apply migrations\n"));
+  const cwd = process.cwd();
+  const apiDir = resolve7(cwd, "apps", "api");
+  if (existsSync6(resolve7(apiDir, "package.json"))) {
+    const result = spawnSync7("npm", ["run", "db:migrate:local"], {
+      stdio: "inherit",
+      cwd: apiDir,
+      shell: true
+    });
+    if (result.status !== 0) {
+      console.log(pc14.red("\n  \u2717 Failed to apply migrations."));
+      process.exit(1);
+      return;
+    }
+  } else if (existsSync6(resolve7(cwd, "scripts", "bootstrap-d1.mjs"))) {
+    const result = spawnSync7("node", ["scripts/bootstrap-d1.mjs"], {
+      stdio: "inherit",
+      cwd,
+      shell: true
+    });
+    if (result.status !== 0) {
+      console.log(pc14.red("\n  \u2717 Failed to apply migrations."));
+      process.exit(1);
+      return;
+    }
+  } else {
+    console.log(pc14.yellow("  \u26A0 Could not find database migration script."));
+    process.exit(1);
+    return;
+  }
+  console.log(pc14.green("\n  \u2713 Migrations applied successfully."));
+}
+
+// src/commands/dev.ts
+import pc15 from "picocolors";
+import { spawnSync as spawnSync8 } from "node:child_process";
+import { existsSync as existsSync7 } from "node:fs";
+import { resolve as resolve8 } from "node:path";
+async function dev(args) {
+  console.log(pc15.cyan("\n  beech dev \u2014 start development environment\n"));
+  const cwd = process.cwd();
+  const devScript = resolve8(cwd, "scripts", "dev.mjs");
+  if (!existsSync7(devScript)) {
+    console.log(pc15.red("  \u2717 Could not find development script (scripts/dev.mjs)."));
+    process.exit(1);
+    return;
+  }
+  const env = { ...process.env };
+  if (args.plain) {
+    env.BEECH_DEV_PLAIN = "1";
+  }
+  const result = spawnSync8("node", ["scripts/dev.mjs"], {
+    stdio: "inherit",
+    cwd,
+    env,
+    shell: true
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+    return;
+  }
+}
+
+// src/commands/dev-stop.ts
+import pc16 from "picocolors";
+import { spawnSync as spawnSync9 } from "node:child_process";
+function isDockerInstalled2() {
+  try {
+    const result = spawnSync9("docker", ["--version"], { stdio: "ignore", shell: true });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function isDockerRunning2() {
+  try {
+    const result = spawnSync9("docker", ["info"], { stdio: "ignore", shell: true });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+async function devStop() {
+  console.log(pc16.cyan("\n  beech dev:stop \u2014 stop Docker environment\n"));
+  if (!isDockerInstalled2()) {
+    console.log(pc16.red("  \u2717 Docker is not installed or not found in your PATH."));
+    process.exit(1);
+    return;
+  }
+  if (!isDockerRunning2()) {
+    console.log(pc16.yellow("  \u26A0 Docker is installed, but the Docker daemon is NOT running."));
+    process.exit(1);
+    return;
+  }
+  console.log(pc16.dim("  Stopping Docker containers\u2026\n"));
+  const result = spawnSync9("docker", ["compose", "-f", "docker/docker-compose.yml", "stop"], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    shell: true
+  });
+  if (result.status === 0) {
+    console.log(pc16.green("\n  \u2713 Docker containers stopped."));
+  } else {
+    console.log(pc16.red("\n  \u2717 Failed to stop Docker containers."));
+    process.exit(1);
+    return;
+  }
+}
+
+// src/commands/dev-tunnel.ts
+import pc17 from "picocolors";
+import { spawnSync as spawnSync10 } from "node:child_process";
+async function devTunnel() {
+  console.log(pc17.cyan("\n  beech dev:tunnel \u2014 get Cloudflare Tunnel URL\n"));
+  const result = spawnSync10("docker", ["compose", "-f", "docker/docker-compose.yml", "logs", "tunnel"], {
+    encoding: "utf-8",
+    cwd: process.cwd(),
+    shell: true
+  });
+  if (result.status !== 0) {
+    console.log(pc17.red("  \u2717 Failed to retrieve tunnel logs."));
+    process.exit(1);
+    return;
+  }
+  const logs2 = result.stdout + (result.stderr || "");
+  const match = logs2.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/g);
+  if (match && match.length > 0) {
+    const url = match[match.length - 1];
+    console.log(pc17.green(`  \u2713 Active Cloudflare Tunnel URL: ${pc17.bold(url)}`));
+  } else {
+    console.log(pc17.yellow("  \u26A0 No active Cloudflare Tunnel URL found in logs."));
+    console.log(pc17.dim("    Make sure the dev server is running with Docker (`pnpm beech dev`)."));
+  }
+}
+
+// src/commands/mailpit-clear.ts
+import pc18 from "picocolors";
+async function mailpitClear() {
+  console.log(pc18.cyan("\n  beech mailpit:clear \u2014 clear test emails\n"));
+  try {
+    const res = await fetch("http://localhost:8025/api/v1/messages", {
+      method: "DELETE"
+    });
+    if (res.ok) {
+      console.log(pc18.green("  \u2713 Mailpit inbox cleared successfully."));
+    } else {
+      console.log(pc18.red(`  \u2717 Failed to clear Mailpit inbox: ${res.statusText}`));
+      process.exit(1);
+      return;
+    }
+  } catch (err) {
+    console.log(pc18.red(`  \u2717 Error connecting to Mailpit: ${err.message}`));
+    console.log(pc18.dim("    Make sure Mailpit is running (default port 8025)."));
+    process.exit(1);
+    return;
+  }
+}
+
+// src/commands/logs.ts
+import pc19 from "picocolors";
+import { spawnSync as spawnSync11 } from "node:child_process";
+var SERVICE_MAP = {
+  mailpit: "mailpit",
+  db: "sqlite-web",
+  sqlite: "sqlite-web",
+  tunnel: "tunnel",
+  storage: "minio",
+  minio: "minio"
+};
+async function logs(args) {
+  const inputService = args.service?.toLowerCase();
+  if (!inputService || !SERVICE_MAP[inputService]) {
+    console.log(pc19.red("\n  \u2717 Error: Please specify a valid service name."));
+    console.log(pc19.dim("\n  Accepted services:"));
+    console.log(`    - ${pc19.cyan("mailpit")}`);
+    console.log(`    - ${pc19.cyan("db")} / ${pc19.cyan("sqlite")}`);
+    console.log(`    - ${pc19.cyan("tunnel")}`);
+    console.log(`    - ${pc19.cyan("storage")} / ${pc19.cyan("minio")}
+`);
+    process.exit(1);
+    return;
+  }
+  const service = SERVICE_MAP[inputService];
+  console.log(pc19.cyan(`
+  beech logs ${inputService} \u2014 streaming logs for ${service}\u2026
 `));
+  const result = spawnSync11("docker", ["compose", "-f", "docker/docker-compose.yml", "logs", "-f", service], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    shell: true
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+    return;
+  }
+}
+
+// src/commands/test.ts
+import pc20 from "picocolors";
+import { spawnSync as spawnSync12 } from "node:child_process";
+import { existsSync as existsSync8 } from "node:fs";
+import { resolve as resolve9 } from "node:path";
+async function test(args) {
+  console.log(pc20.cyan("\n  beech test \u2014 run test suite\n"));
+  const cwd = process.cwd();
+  let command = "turbo";
+  let commandArgs = ["run", "test"];
+  if (args.diff) {
+    const diffScript = resolve9(cwd, "scripts", "test-coverage-diff.mjs");
+    if (existsSync8(diffScript)) {
+      command = "node";
+      commandArgs = ["scripts/test-coverage-diff.mjs"];
+    } else {
+      console.log(pc20.red("  \u2717 Coverage diff script not found (scripts/test-coverage-diff.mjs)."));
+      process.exit(1);
+      return;
+    }
+  } else if (args.coverage) {
+    commandArgs = ["run", "test:coverage"];
+  }
+  const result = spawnSync12(command, commandArgs, {
+    stdio: "inherit",
+    cwd,
+    shell: true
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+    return;
+  }
+}
+
+// src/commands/lint.ts
+import pc21 from "picocolors";
+import { spawnSync as spawnSync13 } from "node:child_process";
+async function lint() {
+  console.log(pc21.cyan("\n  beech lint \u2014 check code style\n"));
+  const result = spawnSync13("turbo", ["run", "lint"], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    shell: true
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+// src/commands/doctor.ts
+import pc22 from "picocolors";
+import { spawnSync as spawnSync14 } from "node:child_process";
+async function doctor() {
+  console.log(pc22.cyan("\n  beech doctor \u2014 React diagnostics\n"));
+  const result = spawnSync14("pnpm", ["dlx", "react-doctor@latest"], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    shell: true
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
   }
 }
 export {
+  dbMigrate,
+  dbReset,
   deploy,
+  dev,
+  devReset,
+  devStop,
+  devTunnel,
+  doctor,
   generateTypes,
   init,
+  lint,
+  logs,
+  mailpitClear,
   onboard,
   reset,
   schemaDiff,
   seedCreate,
   seedLoad,
+  test,
   update,
   validate,
   validateSeeds