@beechcms/cli 0.6.0-preview.3 → 0.6.0

package/dist/index.js

@@ -1,17 +1,17 @@
-// src/commands/seed-load.ts
-import pc2 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,350 +105,376 @@ function resolveDbName(configPath) {
     return "beech-db";
   }
 }
+var init_wrangler = __esm({
+  "src/lib/wrangler.ts"() {
+    "use strict";
+  }
+});
 
-// src/lib/schema-diff.ts
-import { getExpectedColumns } from "@beechcms/core";
-async function diffSeed(seed, options) {
-  const tableName = `content_${seed.slug}`;
-  const expected = getExpectedColumns(seed);
-  let actual;
+// 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 checkWranglerPlaceholders(configPath) {
   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);
+    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 { slug: seed.slug, tableExists: false, columns: expected.map((c) => ({ name: c.name, status: "missing", expectedType: c.sqlType })) };
+    return [];
   }
-  if (actual.length === 0) {
-    return { slug: seed.slug, tableExists: false, columns: expected.map((c) => ({ name: c.name, status: "missing", expectedType: c.sqlType })) };
+}
+function readProjectName(configPath) {
+  if (!configPath) return basename(process.cwd());
+  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());
+  } catch {
+    return basename(process.cwd());
   }
-  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 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;
   }
-  for (const row of actual) {
-    if (!expectedSet.has(row.name)) {
-      columns.push({ name: row.name, status: "extra", actualType: row.type });
-    }
+}
+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 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 {
+}
+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);
     }
-    const fkByCol = /* @__PURE__ */ new Map();
-    for (const fk of fkList) {
-      fkByCol.set(fk.from, fk);
+    raw = raw.replace(/"database_id"\s*:\s*""/g, `"database_id": "${dbId}"`);
+    writeFileSync2(configPath, raw, "utf-8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+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 pc 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(pc.yellow("\n  Warning: SEED_REGISTRY is empty. Create a seeds.ts in your project root.\n"));
-    return;
+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"));
   }
-  console.log(pc.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(pc.red(`  \u2717 ${e.slug} (fatal)`));
-    for (const msg of e.messages) {
-      console.log(pc.red(`      \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)}`));
   }
-  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(pc.green(`  \u2713 ${seed.slug}`));
-      }
+  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(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(pc.yellow(`  \u26A0 ${seed.slug}`));
-      for (const msg of msgs) {
-        console.log(pc.yellow(`      \u2192 ${msg}`));
-      }
+      console.log(pc4.green("  \u2713 .dev.vars"));
     }
   }
-  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(pc.red(`  Found ${totalFatal} fatal error${s}. Fix before loading.
-`));
-    process.exit(1);
-  } else if (totalWarnings > 0) {
-    const s = totalWarnings !== 1 ? "s" : "";
-    console.log(pc.yellow(`  Found ${totalWarnings} warning${s}. Review seeds above.
-`));
-  } else {
-    console.log(pc.green("  All seeds valid.\n"));
-  }
+  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(pc2.cyan("\n  Diffing schema\u2026\n"));
-  let allOk = true;
-  for (const seed of seeds) {
-    const result = await diffSeed(seed, options);
-    const tableName = `content_${seed.slug}`;
-    if (!result.tableExists) {
-      console.log(pc2.red(`  \u2717 ${tableName} \u2014 table missing`));
-      allOk = false;
-      continue;
-    }
-    const problems = result.columns.filter((c) => c.status !== "ok");
-    if (problems.length === 0) {
-      console.log(pc2.green(`  \u2713 ${tableName}`));
-      continue;
-    }
-    allOk = false;
-    console.log(pc2.yellow(`  \u26A0 ${tableName}`));
-    for (const col of problems) {
-      if (col.status === "missing") {
-        console.log(pc2.red(`    + missing column: ${col.name} ${col.expectedType}`));
-      } else if (col.status === "extra") {
-        console.log(pc2.dim(`    ~ orphaned column: "${col.name}" (${col.actualType}) \u2014 exists in DB but not in seeds.ts`));
-      } else if (col.status === "type_mismatch") {
-        console.log(pc2.red(`    \u2260 type mismatch:  ${col.name} (expected ${col.expectedType}, got ${col.actualType})`));
-      } else if (col.status === "fk_missing") {
-        console.log(pc2.red(`    \u292C missing FK: ${col.name} \u2192 content_${col.expectedTarget}(id)`));
-      } else if (col.status === "fk_mismatch") {
-        console.log(pc2.yellow(`    \u292C FK mismatch: ${col.name} expected ${col.expected}, got ${col.actual}`));
-      } else if (col.status === "index_missing") {
-        console.log(pc2.yellow(`    \u2298 missing index on ${col.name}`));
-      }
-    }
-  }
-  console.log("");
-  if (allOk) {
-    console.log(pc2.green("  Schema matches seeds. No action needed.\n"));
-  } else {
-    console.log(pc2.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(pc2.cyan("\n  -- dry-run: SQL that would be executed\n"));
-    for (const seed of seeds) {
-      const stmts = buildStatements(seed);
-      console.log(pc2.dim(`  -- content_${seed.slug}`));
-      for (const stmt of stmts) {
-        console.log(stmt + "\n");
-      }
-      console.log(pc2.dim(`  -- register ${seed.slug} in seeds table`));
-      console.log(buildSeedRegistrationSql(seed) + "\n");
-    }
-    console.log(pc2.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(pc2.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(`  ${pc2.dim("\u2192")} content_${seed.slug}\u2026 `);
-    const ok = executeD1File(sql, options);
-    if (!ok) {
-      console.log(pc2.red("failed"));
-      console.log(pc2.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(pc2.dim("  wrangler reported an error above."));
-      console.log(pc2.dim(`  Most likely causes:`));
-      console.log(pc2.dim(`    - Database "${options.db}" not found or wrong database_id`));
-      if (!options.local) {
-        console.log(pc2.dim("    - Not logged in to Cloudflare"));
-        console.log(pc2.cyan("\n  \u2192 Run:  npx wrangler login"));
-        console.log(pc2.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(pc2.cyan("\n  \u2192 Run:  npx beech init --db --local   # re-initialise local DB"));
-        console.log(pc2.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(pc2.green("done"));
-  }
-  executeD1File(SEED_META_BUMP_SQL, options);
-  console.log(pc2.green("\n  All seeds loaded.\n"));
-  console.log(pc2.dim("  Definitions registered in the database."));
-  console.log(pc2.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(pc2.yellow("\n  \u2717 No seeds found\n"));
-    console.log(pc2.dim("  Create a seeds.ts file in your project root with at least one content type."));
-    console.log(pc2.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(pc2.red(`
-  \u2717 Seed validation found ${total} fatal error${s}. Cannot load schema.
-`));
-    for (const e of fatalErrors) {
-      console.log(pc2.red(`  \u2717 ${e.slug}`));
-      for (const msg of e.messages) {
-        console.log(pc2.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(pc2.yellow(`
-  \u26A0 Seed validation found ${total} issue${s}. Schema changes will still be applied.
-`));
-    console.log(pc2.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(pc2.red("\n  \u2717 System tables not found (seeds, seed_meta)\n"));
-        console.log(pc2.dim("  Run `beech init --db` first to initialise the database."));
-        const flag = args.local ? " --local" : "";
-        console.log(pc2.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(pc2.red("\n  \u2717 Could not query the database\n"));
-      console.log(pc2.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 pc3 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,
@@ -610,346 +636,369 @@ 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 });
     }
-    raw = raw.replace(/"database_id"\s*:\s*""/g, `"database_id": "${dbId}"`);
-    writeFileSync2(configPath, raw, "utf-8");
-    return true;
-  } catch {
-    return false;
   }
-}
-function printManualDbInstructions() {
-  console.log(pc3.dim("\n  Update your D1 database_id in wrangler.jsonc,"));
-  console.log(pc3.dim("  or create a new database with:"));
-  console.log(pc3.cyan("\n  \u2192 Run:  npx wrangler d1 create my-project-db"));
-  console.log(pc3.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(pc3.dim("  API keys detected in wrangler.jsonc:\n"));
-    if (readKey) {
-      const masked = readKey.length > 8 ? readKey.slice(0, 4) + "****" + readKey.slice(-4) : "****";
-      console.log(pc3.dim(`    PUBLIC_READ_API_KEY  = ${masked}`));
+  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 {
     }
-    if (writeKey) {
-      const masked = writeKey.length > 8 ? writeKey.slice(0, 4) + "****" + writeKey.slice(-4) : "****";
-      console.log(pc3.dim(`    PUBLIC_WRITE_API_KEY = ${masked}`));
+    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" });
+        }
+      }
     }
-    console.log(pc3.dim("\n  Use these in your frontend as the X-API-Key header.\n"));
-  } catch {
   }
+  return { slug: seed.slug, tableExists: true, columns };
 }
-function checkFiles(cwd, checkDevVars) {
-  let ok = true;
-  const workerExists = existsSync2(resolve2(cwd, "worker.ts")) || existsSync2(resolve2(cwd, "worker.js"));
-  if (!workerExists) {
-    console.log(pc3.red("  \u2717 worker.ts        \u2014 missing (required)"));
-    ok = false;
-  } else {
-    console.log(pc3.green("  \u2713 worker.ts"));
-  }
-  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(pc3.red("  \u2717 wrangler.jsonc   \u2014 missing (required)"));
-    ok = false;
-  } else {
-    console.log(pc3.green(`  \u2713 ${basename(configPath)}`));
+
+// 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;
   }
-  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(pc3.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(pc3.green("  \u2713 seeds.ts"));
+  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 (checkDevVars) {
-    if (!existsSync2(resolve2(cwd, ".dev.vars"))) {
-      console.log(pc3.dim("  \u25CB .dev.vars        \u2014 not found (optional: only needed for production R2 credentials)"));
+  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(pc3.green("  \u2713 .dev.vars"));
+      console.log(pc2.yellow(`  \u26A0 ${seed.slug}`));
+      for (const msg of msgs) {
+        console.log(pc2.yellow(`      \u2192 ${msg}`));
+      }
     }
   }
-  return ok;
+  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(pc2.green("  All seeds valid.\n"));
+  }
 }
-function printNextSteps(local) {
-  const localFlag = local ? " --local" : "";
-  console.log(pc3.dim("  Next steps:"));
-  console.log(pc3.cyan(`  1. npx beech seed:load${localFlag}`));
-  console.log(pc3.dim("      \u2192 create content tables and register seed definitions in D1"));
-  console.log(pc3.cyan("  2. npx wrangler dev"));
-  console.log(pc3.dim("      \u2192 start API + dashboard"));
-  console.log(pc3.dim("  3. Open http://localhost:8789/admin\n"));
+
+// 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 getExistingTables(options) {
-  try {
-    const rows = queryD1(
-      `SELECT name FROM sqlite_master WHERE type='table'`,
-      options
-    );
-    return rows.map((r) => r.name);
-  } catch {
-    return null;
+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 init(args) {
-  const cwd = process.cwd();
-  console.log(pc3.cyan("\n  beech init \u2014 project check\n"));
-  const filesOk = checkFiles(cwd, args.local);
-  if (!filesOk) {
-    console.log(pc3.red("\n  \u2717 Required files missing\n"));
-    console.log(pc3.dim("  Fix the errors above before initialising the database."));
-    console.log(pc3.cyan("\n  \u2192 See: https://beechcms.dev/docs/getting-started\n"));
-    process.exit(1);
+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(pc3.green("\n  All required files present.\n"));
-  if (!args.initDb) {
-    echoApiKeys(findWranglerConfig());
-    const localFlag = args.local ? " --local" : "";
-    console.log(pc3.dim("  Next steps:"));
-    console.log(pc3.dim(`  1. npx beech init --db${localFlag}     # initialise D1 database`));
-    console.log(pc3.dim(`  2. npx beech seed:load${localFlag}     # create content tables`));
-    console.log(pc3.dim("  3. npx wrangler dev                 # start API + dashboard"));
-    console.log(pc3.dim("  4. Open http://localhost:8789/admin\n"));
-    return;
+  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"));
   }
-  const configPath = findWranglerConfig();
-  if (configPath) {
-    const placeholders = checkWranglerPlaceholders(configPath);
-    if (placeholders.length > 0) {
-      console.log(pc3.yellow("  \u26A0 wrangler.jsonc contains placeholder values:\n"));
-      for (const issue of placeholders) {
-        console.log(pc3.yellow(`    - ${issue}`));
+}
+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");
       }
-      if (process.stdin.isTTY && !args.nonInteractive) {
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        let autoCreate = false;
-        try {
-          const answer = (await rl.question(
-            pc3.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(pc3.red("\n  \u2717 Not logged in to Cloudflare\n"));
-            console.log(pc3.dim("  BeechCMS needs access to your Cloudflare account to create the database."));
-            console.log(pc3.cyan("\n  \u2192 Run:  npx wrangler login"));
-            console.log(pc3.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(pc3.dim(`
-  Creating D1 database "${dbName}"\u2026`));
-          const dbId = createD1Database(dbName);
-          if (!dbId) {
-            console.log(pc3.red("\n  \u2717 Failed to create D1 database\n"));
-            console.log(pc3.dim("  Create it manually and retry:"));
-            console.log(pc3.cyan(`
-  \u2192 Run:  npx wrangler d1 create ${dbName}`));
-            console.log(pc3.cyan("  \u2192 Then: npx beech init --db\n"));
-            process.exit(1);
-          }
-          console.log(pc3.green(`  \u2713 D1 database created (id: ${dbId})`));
-          console.log(pc3.dim(`
-  Creating R2 bucket "${bucketName}"\u2026`));
-          const r2Ok = createR2Bucket(bucketName);
-          if (r2Ok) {
-            console.log(pc3.green(`  \u2713 R2 bucket "${bucketName}" created`));
-          } else {
-            console.log(pc3.yellow(`  \u26A0 R2 bucket creation failed (may already exist \u2014 continuing)`));
-          }
-          console.log(pc3.dim("\n  Updating wrangler.jsonc\u2026"));
-          const patched = patchWranglerConfig(configPath, dbId);
-          if (patched) {
-            console.log(pc3.green("  \u2713 wrangler.jsonc updated\n"));
-          } else {
-            console.log(pc3.yellow(`  \u26A0 Could not update wrangler.jsonc automatically
+      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;
+  }
+  console.log(pc3.cyan(`
+  Loading seeds into ${options.local ? "local" : "remote"} D1 (${options.db})\u2026
 `));
-            console.log(pc3.dim(`  Set database_id = "${dbId}" in wrangler.jsonc manually, then retry:`));
-            console.log(pc3.cyan("  \u2192 Run: npx beech init --db\n"));
-            process.exit(1);
-          }
-        } else {
-          printManualDbInstructions();
-          process.exit(1);
-        }
-      } else if (args.nonInteractive && args.local) {
-        console.log(pc3.dim("  --yes: proceeding with local mode (no remote resources needed)\n"));
+  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 {
-        if (args.nonInteractive) {
-          console.log(pc3.red("\n  \u2717 Cannot proceed non-interactively: remote database has a placeholder database_id\n"));
-          console.log(pc3.dim("  Set a real database_id in wrangler.jsonc, then retry."));
-          process.exit(1);
-        }
-        printManualDbInstructions();
-        process.exit(1);
+        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.local) {
-    const authed = checkWranglerAuth();
-    if (!authed) {
-      console.log(pc3.red("  \u2717 Not logged in to Cloudflare\n"));
-      console.log(pc3.dim("  BeechCMS needs access to your Cloudflare account to manage the D1 database."));
-      console.log(pc3.cyan("\n  \u2192 Run:  npx wrangler login"));
-      console.log(pc3.cyan("  \u2192 Then: npx beech init --db\n"));
       process.exit(1);
     }
+    console.log(pc3.green("done"));
   }
-  const db = args.db ?? resolveDbName(configPath);
-  const options = { db, local: args.local, configPath };
-  console.log(pc3.cyan(`  Checking database "${db}" (${args.local ? "local" : "remote"})\u2026
+  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.
 `));
-  const existingTables = getExistingTables(options);
-  const missingTables = SYSTEM_TABLES.filter((t) => !existingTables?.includes(t));
-  if (!args.local) {
-    if (existingTables === null) {
-      console.log(pc3.red("  \u2717 Remote database unreachable\n"));
-      console.log(pc3.dim("  Most likely causes:"));
-      console.log(pc3.dim("    - Wrong database_id in wrangler.jsonc"));
-      console.log(pc3.dim("    - Worker not yet deployed"));
-      console.log(pc3.cyan("\n  \u2192 Fix:  Update d1_databases.database_id in wrangler.jsonc"));
-      console.log(pc3.cyan("  \u2192 Then: npm run deploy\n"));
-      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}`));
+      }
     }
-    if (missingTables.length > 0) {
-      console.log(pc3.yellow(`  \u26A0 Missing system tables: ${missingTables.join(", ")}
+    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}
 `));
-      console.log(pc3.dim("  Most likely causes:"));
-      console.log(pc3.dim("    - Wrong database_id in wrangler.jsonc"));
-      console.log(pc3.dim("    - Migrations did not run during deploy"));
-      console.log(pc3.cyan("\n  \u2192 Fix:  Update d1_databases.database_id in wrangler.jsonc"));
-      console.log(pc3.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(pc3.green(`  \u2713 ${table}`));
-    }
-    console.log(pc3.green("\n  All system tables present. Remote database is initialized.\n"));
-    return;
   }
-  if (existingTables === null) {
-    console.log(pc3.yellow("  Database unreachable or not yet created \u2014 applying base schema\u2026\n"));
-  } else if (missingTables.length === 0) {
-    console.log(pc3.green("  \u2713 All system tables present. Database already initialised.\n"));
-    printNextSteps(args.local);
-    return;
+  if (args.diff) {
+    await runDiff(options, registry);
   } else {
-    console.log(pc3.yellow(`  Missing system tables: ${missingTables.join(", ")}`));
-    console.log(pc3.cyan("\n  Applying base schema\u2026\n"));
-  }
-  const ok = executeD1File(BASE_SCHEMA_SQL, options);
-  if (!ok) {
-    console.log(pc3.red("\n  \u2717 Database initialisation failed\n"));
-    console.log(pc3.dim("  wrangler reported an error above."));
-    console.log(pc3.cyan("\n  \u2192 Run: npx beech init --db --local\n"));
-    process.exit(1);
+    await runLoad(options, args.dryRun, registry);
   }
-  console.log(pc3.green("\n  \u2713 worker.ts"));
-  console.log(pc3.green(`  \u2713 ${configPath ? basename(configPath) : "wrangler.jsonc"}`));
-  console.log(pc3.green("  \u2713 seeds.ts"));
-  console.log(pc3.green("  \u2713 Local D1 system tables ready\n"));
-  echoApiKeys(configPath);
-  printNextSteps(args.local);
 }
 
+// src/index.ts
+init_init();
+
 // src/commands/seed-create.ts
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 import { createInterface as createInterface2 } from "node:readline/promises";
 import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
 import { resolve as resolve3 } from "node:path";
@@ -1020,35 +1069,35 @@ function findSeedsFile() {
 async function seedCreate(_args) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
   const ask = async (q, fallback = "") => {
-    const hint = fallback ? pc4.dim(` [${fallback}]`) : "";
+    const hint = fallback ? pc5.dim(` [${fallback}]`) : "";
     const answer = await rl.question(`  ${q}${hint}: `);
     return answer.trim() || fallback;
   };
   const askYN = async (q, defaultYes = true) => {
-    const hint = defaultYes ? pc4.dim(" (Y/n)") : pc4.dim(" (y/N)");
+    const hint = defaultYes ? pc5.dim(" (Y/n)") : pc5.dim(" (y/N)");
     const answer = (await rl.question(`  ${q}${hint}: `)).trim().toLowerCase();
     if (!answer) return defaultYes;
     return answer === "y" || answer === "yes";
   };
-  console.log(pc4.cyan("\n  beech seed:create \u2014 new content type wizard\n"));
+  console.log(pc5.cyan("\n  beech seed:create \u2014 new content type wizard\n"));
   try {
     const label = await ask('Content type name (singular, e.g. "Article")');
     if (!label) {
       rl.close();
-      console.log(pc4.red("\n  \u2717 Name required.\n"));
+      console.log(pc5.red("\n  \u2717 Name required.\n"));
       process.exit(1);
     }
     const defaultSlug = slugify(label) + "s";
     const slug = slugify(await ask("Slug (plural, used in URL + table name)", defaultSlug)) || defaultSlug;
     const labelPlural = await ask("Plural label", label + "s") || label + "s";
     const branches = [];
-    console.log(pc4.dim("\n  Now define the fields. Press Enter to accept defaults.\n"));
+    console.log(pc5.dim("\n  Now define the fields. Press Enter to accept defaults.\n"));
     let addMore = true;
     while (addMore) {
-      console.log(pc4.dim(`  \u2500\u2500\u2500 Field ${branches.length + 1} \u2500\u2500\u2500`));
+      console.log(pc5.dim(`  \u2500\u2500\u2500 Field ${branches.length + 1} \u2500\u2500\u2500`));
       const alias = await ask('  Alias (camelCase, e.g. "title", "publishedAt")');
       if (!alias) {
-        console.log(pc4.yellow("  Alias required \u2014 skipping."));
+        console.log(pc5.yellow("  Alias required \u2014 skipping."));
         addMore = await askYN("\n  Add a field?");
         continue;
       }
@@ -1062,14 +1111,14 @@ async function seedCreate(_args) {
     }
     rl.close();
     if (branches.length === 0) {
-      console.log(pc4.yellow("\n  No fields defined \u2014 seed not created.\n"));
+      console.log(pc5.yellow("\n  No fields defined \u2014 seed not created.\n"));
       process.exit(0);
     }
     const seedBlock = generateSeedBlock(slug, label, labelPlural, branches);
     const cName = toConstName(slug);
     const seedsPath = findSeedsFile();
     if (!seedsPath) {
-      console.log(pc4.yellow("\n  Could not find seeds.ts. Add this to your seeds file manually:\n"));
+      console.log(pc5.yellow("\n  Could not find seeds.ts. Add this to your seeds file manually:\n"));
       console.log(seedBlock);
       process.exit(0);
     }
@@ -1078,18 +1127,18 @@ async function seedCreate(_args) {
     const withSeed = content + seedBlock;
     const withRegistry = tryInsertRegistryEntry(withSeed, slug, cName);
     writeFileSync3(seedsPath, withRegistry ?? withSeed, "utf-8");
-    console.log(pc4.green(`
+    console.log(pc5.green(`
   \u2713 Seed "${slug}" appended to ${seedsPath}
 `));
     if (!withRegistry) {
-      console.log(pc4.yellow(`  \u26A0 Could not auto-update SEED_REGISTRY \u2014 add this entry manually:
+      console.log(pc5.yellow(`  \u26A0 Could not auto-update SEED_REGISTRY \u2014 add this entry manually:
 `));
-      console.log(pc4.cyan(`    ${slug}: ${cName},
+      console.log(pc5.cyan(`    ${slug}: ${cName},
 `));
     }
-    console.log(pc4.dim("  Next steps:"));
-    console.log(pc4.cyan("  npx beech seed:load --local"));
-    console.log(pc4.dim("  \u2192 create the new content table in your local D1 database\n"));
+    console.log(pc5.dim("  Next steps:"));
+    console.log(pc5.cyan("  npx beech seed:load --local"));
+    console.log(pc5.dim("  \u2192 create the new content table in your local D1 database\n"));
   } catch (err) {
     rl.close();
     throw err;
@@ -1097,7 +1146,8 @@ async function seedCreate(_args) {
 }
 
 // src/commands/deploy.ts
-import pc5 from "picocolors";
+init_wrangler();
+import pc6 from "picocolors";
 import { spawnSync as spawnSync3 } from "node:child_process";
 import { readFileSync as readFileSync4 } from "node:fs";
 function readWorkerName(configPath) {
@@ -1128,8 +1178,8 @@ async function checkAdmin(url) {
   }
 }
 async function deploy(args) {
-  console.log(pc5.cyan("\n  beech deploy\n"));
-  console.log(pc5.dim("  [1/3] Deploying Worker\u2026\n"));
+  console.log(pc6.cyan("\n  beech deploy\n"));
+  console.log(pc6.dim("  [1/3] Deploying Worker\u2026\n"));
   const deployResult = spawnSync3("npm", ["run", "deploy"], {
     stdio: ["inherit", "pipe", "inherit"],
     encoding: "utf-8",
@@ -1139,33 +1189,33 @@ async function deploy(args) {
   const deployStdout = deployResult.stdout ?? "";
   if (deployStdout) process.stdout.write(deployStdout);
   if (deployResult.status !== 0) {
-    console.log(pc5.red("\n  \u2717 Worker deploy failed\n"));
-    console.log(pc5.dim("  Check the wrangler output above for details."));
-    console.log(pc5.cyan("\n  \u2192 Run:  npx wrangler login           # if not authenticated"));
-    console.log(pc5.cyan("  \u2192 Or:   Update wrangler.jsonc        # if database_id is wrong\n"));
+    console.log(pc6.red("\n  \u2717 Worker deploy failed\n"));
+    console.log(pc6.dim("  Check the wrangler output above for details."));
+    console.log(pc6.cyan("\n  \u2192 Run:  npx wrangler login           # if not authenticated"));
+    console.log(pc6.cyan("  \u2192 Or:   Update wrangler.jsonc        # if database_id is wrong\n"));
     process.exit(1);
   }
   const deployedUrl = extractWorkerUrl(deployStdout);
-  console.log(pc5.green("\n  \u2713 Worker deployed"));
+  console.log(pc6.green("\n  \u2713 Worker deployed"));
   if (args.skipSeed) {
-    console.log(pc5.dim("\n  [2/3] Skipping seed:load (--skip-seed)"));
+    console.log(pc6.dim("\n  [2/3] Skipping seed:load (--skip-seed)"));
   } else {
-    console.log(pc5.dim("\n  [2/3] Syncing content schema to remote D1\u2026\n"));
+    console.log(pc6.dim("\n  [2/3] Syncing content schema to remote D1\u2026\n"));
     const seedResult = spawnSync3("npx", ["beech", "seed:load"], {
       stdio: "inherit",
       cwd: process.cwd(),
       shell: true
     });
     if (seedResult.status !== 0) {
-      console.log(pc5.yellow("\n  \u26A0 seed:load failed\n"));
-      console.log(pc5.dim("  Sync the remote content schema manually:"));
-      console.log(pc5.cyan("  \u2192 Run: npx beech seed:load\n"));
+      console.log(pc6.yellow("\n  \u26A0 seed:load failed\n"));
+      console.log(pc6.dim("  Sync the remote content schema manually:"));
+      console.log(pc6.cyan("  \u2192 Run: npx beech seed:load\n"));
     } else {
-      console.log(pc5.green("\n  \u2713 Content schema synced"));
+      console.log(pc6.green("\n  \u2713 Content schema synced"));
     }
   }
   if (args.skipCheck) {
-    console.log(pc5.dim("\n  [3/3] Skipping admin check (--skip-check)\n"));
+    console.log(pc6.dim("\n  [3/3] Skipping admin check (--skip-check)\n"));
     return;
   }
   const adminBase = deployedUrl ?? (() => {
@@ -1173,91 +1223,160 @@ async function deploy(args) {
     return workerName ? `https://${workerName}.workers.dev` : null;
   })();
   if (!adminBase) {
-    console.log(pc5.dim("\n  [3/3] Could not determine worker URL \u2014 skipping admin check\n"));
-    console.log(pc5.dim("  The deployed URL is printed by wrangler above. Open <url>/admin to verify.\n"));
+    console.log(pc6.dim("\n  [3/3] Could not determine worker URL \u2014 skipping admin check\n"));
+    console.log(pc6.dim("  The deployed URL is printed by wrangler above. Open <url>/admin to verify.\n"));
     return;
   }
-  console.log(pc5.dim(`
+  console.log(pc6.dim(`
   [3/3] Checking ${adminBase}/admin\u2026
 `));
   const { ok, status } = await checkAdmin(adminBase);
   if (ok) {
-    console.log(pc5.green(`  \u2713 Admin reachable at: ${adminBase}/admin
+    console.log(pc6.green(`  \u2713 Admin reachable at: ${adminBase}/admin
 `));
   } else {
     const statusStr = status != null ? ` (HTTP ${status})` : "";
-    console.log(pc5.yellow(`  \u26A0 Admin returned an error${statusStr} at: ${adminBase}/admin
+    console.log(pc6.yellow(`  \u26A0 Admin returned an error${statusStr} at: ${adminBase}/admin
 `));
-    console.log(pc5.dim("  The database may not be fully initialized."));
-    console.log(pc5.cyan("  \u2192 Run: npx beech init --db --remote\n"));
+    console.log(pc6.dim("  The database may not be fully initialized."));
+    console.log(pc6.cyan("  \u2192 Run: npx beech init --db --remote\n"));
   }
 }
 
 // src/commands/onboard.ts
-import pc6 from "picocolors";
+init_init();
+import pc7 from "picocolors";
 async function onboard(args) {
-  console.log(pc6.cyan("\n  beech onboard \u2014 full provisioning\n"));
+  console.log(pc7.cyan("\n  beech onboard \u2014 full provisioning\n"));
   await init({ initDb: true, local: args.local, db: args.db, nonInteractive: args.yes });
   await seedLoad({ dryRun: false, diff: false, local: args.local, db: args.db, registry: args.registry ?? null });
-  console.log(pc6.cyan("\n  Provisioning complete.\n"));
-  console.log(pc6.dim("  Next steps:"));
-  console.log(pc6.cyan("  1. npx wrangler dev"));
-  console.log(pc6.dim("      \u2192 start API + dashboard"));
-  console.log(pc6.dim("  2. Open http://localhost:8789/admin"));
-  console.log(pc6.dim("      \u2192 complete setup wizard to create admin user\n"));
+  console.log(pc7.cyan("\n  Provisioning complete.\n"));
+  console.log(pc7.dim("  Next steps:"));
+  console.log(pc7.cyan("  1. npx wrangler dev"));
+  console.log(pc7.dim("      \u2192 start API + dashboard"));
+  console.log(pc7.dim("  2. Open http://localhost:8789/admin"));
+  console.log(pc7.dim("      \u2192 complete setup wizard to create admin user\n"));
 }
 
 // src/commands/update.ts
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 import { spawnSync as spawnSync4 } from "node:child_process";
 async function update(_args) {
-  console.log(pc7.cyan("\n  beech update\n"));
-  console.log(pc7.dim("  [1/2] Installing latest BeechCMS packages\u2026\n"));
+  console.log(pc8.cyan("\n  beech update\n"));
+  console.log(pc8.dim("  [1/2] Installing latest BeechCMS packages\u2026\n"));
   const installResult = spawnSync4(
     "npm",
     ["install", "@beechcms/api@latest", "@beechcms/core@latest"],
     { stdio: "inherit", cwd: process.cwd(), shell: true }
   );
   if (installResult.status !== 0) {
-    console.log(pc7.red("\n  \u2717 npm install failed\n"));
-    console.log(pc7.dim("  Check the output above for details."));
-    console.log(pc7.dim("  You may need to resolve version conflicts manually."));
-    console.log(pc7.cyan("\n  \u2192 Try: npm install --legacy-peer-deps\n"));
+    console.log(pc8.red("\n  \u2717 npm install failed\n"));
+    console.log(pc8.dim("  Check the output above for details."));
+    console.log(pc8.dim("  You may need to resolve version conflicts manually."));
+    console.log(pc8.cyan("\n  \u2192 Try: npm install --legacy-peer-deps\n"));
     process.exit(1);
   }
-  console.log(pc7.green("\n  \u2713 Packages updated"));
-  console.log(pc7.dim("\n  [2/2] Applying system migrations to local database\u2026\n"));
+  console.log(pc8.green("\n  \u2713 Packages updated"));
+  console.log(pc8.dim("\n  [2/2] Applying system migrations to local database\u2026\n"));
   const initResult = spawnSync4(
     "npx",
     ["beech", "init", "--db", "--local"],
     { stdio: "inherit", cwd: process.cwd(), shell: true }
   );
   if (initResult.status !== 0) {
-    console.log(pc7.yellow("\n  \u26A0 Local DB update failed\n"));
-    console.log(pc7.dim("  Apply system migrations manually:"));
-    console.log(pc7.cyan("  \u2192 Run: npx beech init --db --local\n"));
+    console.log(pc8.yellow("\n  \u26A0 Local DB update failed\n"));
+    console.log(pc8.dim("  Apply system migrations manually:"));
+    console.log(pc8.cyan("  \u2192 Run: npx beech init --db --local\n"));
   } else {
-    console.log(pc7.green("\n  \u2713 Local database updated"));
+    console.log(pc8.green("\n  \u2713 Local database updated"));
   }
-  console.log(pc7.dim("\n  Local update complete.\n"));
-  console.log(pc7.dim("  Next steps:"));
-  console.log(pc7.cyan("  1. npx beech seed:load --local"));
-  console.log(pc7.dim("      \u2192 sync content schema to local DB"));
-  console.log(pc7.cyan("  2. npm run deploy"));
-  console.log(pc7.dim("      \u2192 deploy updated API + dashboard"));
-  console.log(pc7.cyan("  3. npx beech seed:load"));
-  console.log(pc7.dim("      \u2192 sync remote schema\n"));
+  console.log(pc8.dim("\n  Local update complete.\n"));
+  console.log(pc8.dim("  Next steps:"));
+  console.log(pc8.cyan("  1. npx beech seed:load --local"));
+  console.log(pc8.dim("      \u2192 sync content schema to local DB"));
+  console.log(pc8.cyan("  2. npm run deploy"));
+  console.log(pc8.dim("      \u2192 deploy updated API + dashboard"));
+  console.log(pc8.cyan("  3. npx beech seed:load"));
+  console.log(pc8.dim("      \u2192 sync remote schema\n"));
 }
 
 // src/commands/reset.ts
-import pc8 from "picocolors";
+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;
@@ -1265,132 +1384,546 @@ 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(pc8.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(
-          pc8.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(pc8.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(pc8.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(pc8.red("  \u2717 Docker is not installed or not found in your PATH."));
-      console.log(pc8.dim("    Please install Docker to reset Docker containers and volumes.\n"));
-      if (!args.all) {
-        process.exit(1);
-      }
-    } else if (!isDockerRunning()) {
-      console.log(pc8.yellow("  \u26A0 Docker is installed, but the Docker daemon is NOT running."));
-      console.log(pc8.dim("    Please start Docker Desktop or your Docker daemon to reset containers.\n"));
-      if (!args.all) {
-        process.exit(1);
-      }
-    } else {
-      console.log(pc8.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(pc8.green("\n  \u2713 Docker containers stopped and volumes removed."));
-      } else {
-        console.log(pc8.red("\n  \u2717 Docker reset failed."));
-      }
-    }
+    await devReset();
   }
   if (resetDb) {
-    console.log(pc8.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(pc8.dim("  Removing .wrangler/state\u2026"));
-          rmSync2(wranglerStateDir, { recursive: true, force: true });
+    await dbReset({});
+  }
+}
+
+// src/commands/generate-types.ts
+init_wrangler();
+import { writeFileSync as writeFileSync4, mkdirSync } from "node:fs";
+import { dirname, resolve as resolve5 } from "node:path";
+import pc12 from "picocolors";
+import { generateSeedTypes } from "@beechcms/core";
+function loadSeedsFromD1(db) {
+  const configPath = findWranglerConfig();
+  const options = { db, local: false, configPath };
+  const rows = queryD1(
+    `SELECT slug, definition FROM seeds WHERE status = 'active';`,
+    options
+  );
+  return rows.map((r) => JSON.parse(r.definition));
+}
+async function generateTypes(args) {
+  let seeds;
+  if (args.local) {
+    const registry = args.registry ?? {};
+    if (Object.keys(registry).length === 0) {
+      console.log(pc12.red("\n  \u2717 No seeds found (seeds.ts empty or missing).\n"));
+      process.exit(1);
+    }
+    seeds = Object.values(registry);
+  } else {
+    const db = args.db ?? resolveDbName(findWranglerConfig());
+    seeds = loadSeedsFromD1(db);
+    if (seeds.length === 0) {
+      console.log(pc12.red(`
+  \u2717 No active seeds in D1 (${db}). Run \`beech seed:load\` first.
+`));
+      process.exit(1);
+    }
+  }
+  const code = generateSeedTypes(seeds);
+  const outPath = resolve5(process.cwd(), args.out);
+  mkdirSync(dirname(outPath), { recursive: true });
+  writeFileSync4(outPath, code, "utf-8");
+  console.log(pc12.green(`
+  \u2713 Generated ${seeds.length} interface(s) \u2192 ${args.out}
+`));
+}
+
+// src/commands/schema-diff.ts
+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";
+
+// src/lib/migration-writer.ts
+import { readdirSync, writeFileSync as writeFileSync5, existsSync as existsSync5, mkdirSync as mkdirSync2 } from "node:fs";
+import { join as join2 } from "node:path";
+import {
+  generateAddColumn,
+  generateIndexes as generateIndexes2,
+  planCreateSeed
+} from "@beechcms/core";
+var DESTRUCTIVE = /* @__PURE__ */ new Set([
+  "extra",
+  "type_mismatch",
+  "fk_mismatch"
+]);
+function nextMigrationIndex(migrationsDir) {
+  if (!existsSync5(migrationsDir)) return "0000";
+  let max = -1;
+  for (const f of readdirSync(migrationsDir)) {
+    const m = /^(\d{4})_/.exec(f);
+    if (m) max = Math.max(max, Number(m[1]));
+  }
+  return String(max + 1).padStart(4, "0");
+}
+function buildMigrationSql(diffs, registry) {
+  const lines = [];
+  let additiveCount = 0;
+  const destructiveSlugs = [];
+  for (const diff of diffs) {
+    const seed = registry[diff.slug];
+    if (!seed) continue;
+    if (!diff.tableExists) {
+      lines.push(`-- ${diff.slug}: create table from scratch`);
+      for (const stmt of planCreateSeed(seed)) {
+        lines.push(stmt);
+        additiveCount++;
+      }
+      lines.push("");
+      continue;
+    }
+    const missing = diff.columns.filter((c) => c.status === "missing");
+    const idxMissing = diff.columns.filter((c) => c.status === "index_missing");
+    const destructive = diff.columns.filter((c) => DESTRUCTIVE.has(c.status));
+    if (missing.length || idxMissing.length) {
+      lines.push(`-- ${diff.slug}: additive changes`);
+      for (const col of missing) {
+        const branch = seed.branches.find((b) => b.alias === col.name);
+        if (branch) {
+          lines.push(generateAddColumn(seed, branch));
+          additiveCount++;
         }
-        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(pc8.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;
+      }
+      if (idxMissing.length) {
+        for (const stmt of generateIndexes2(seed)) {
+          lines.push(stmt);
+          additiveCount++;
         }
       }
-    } else {
-      const wranglerStateDir = resolve4(cwd, ".wrangler/state");
-      if (existsSync4(wranglerStateDir)) {
-        console.log(pc8.dim("  Removing .wrangler/state\u2026"));
-        rmSync2(wranglerStateDir, { recursive: true, force: true });
+      lines.push("");
+    }
+    if (destructive.length) {
+      destructiveSlugs.push(diff.slug);
+      lines.push(`-- \u26A0 ${diff.slug}: DESTRUCTIVE drift NOT auto-migrated \u2014 review manually:`);
+      for (const col of destructive) {
+        lines.push(`--   ${col.status}: ${col.name}` + (col.actualType ? ` (db: ${col.actualType})` : ""));
       }
-      dbResetSuccess = true;
+      lines.push("");
+    }
+  }
+  return { sql: lines.join("\n").trimEnd() + "\n", additiveCount, destructiveSlugs };
+}
+function writeMigrationFile(migrationsDir, index, name, sql) {
+  if (!existsSync5(migrationsDir)) mkdirSync2(migrationsDir, { recursive: true });
+  const safe = name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "") || "schema_sync";
+  const file = join2(migrationsDir, `${index}_${safe}.sql`);
+  writeFileSync5(file, sql, "utf-8");
+  return file;
+}
+
+// src/commands/schema-diff.ts
+function resolveMigrationsDir(override) {
+  if (override) return resolve6(process.cwd(), override);
+  return resolve6(process.cwd(), "apps", "api", "migrations");
+}
+async function schemaDiff(args) {
+  const registry = args.registry ?? SEED_REGISTRY3;
+  if (Object.keys(registry).length === 0) {
+    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(pc13.cyan(`
+  Diffing schema vs ${args.local ? "local" : "remote"} D1 (${options.db})\u2026
+`));
+  const diffs = [];
+  let clean = true;
+  for (const seed of seeds) {
+    const d = await diffSeed(seed, options);
+    diffs.push(d);
+    renderSeedDiff(d);
+    if (!isSeedClean(d)) clean = false;
+  }
+  if (clean) {
+    console.log(pc13.green("\n  Schema matches seeds. No migration needed.\n"));
+    return;
+  }
+  const plan = buildMigrationSql(diffs, registry);
+  if (!args.write) {
+    console.log(pc13.dim("\n  -- proposed additive migration (preview):\n"));
+    console.log(plan.sql);
+    if (plan.destructiveSlugs.length) {
+      console.log(pc13.yellow(`
+  \u26A0 Destructive drift in: ${plan.destructiveSlugs.join(", ")} \u2014 not auto-migrated.`));
     }
-    if (dbResetSuccess) {
-      console.log(pc8.green("\n  \u2713 Local database reset completed."));
+    console.log(pc13.cyan("\n  \u2192 Re-run with --write to save the migration file.\n"));
+    return;
+  }
+  if (plan.additiveCount === 0) {
+    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(pc13.green(`
+  \u2713 Wrote ${file} (${plan.additiveCount} statement(s)).`));
+  console.log(pc13.dim("  Review, commit, then `wrangler d1 migrations apply --remote` in CI.\n"));
+  if (plan.destructiveSlugs.length) {
+    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(pc8.red("\n  \u2717 Database reset failed."));
+      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);
   }
-  console.log(pc8.dim("\n  Reset process finished.\n"));
 }
 export {
+  dbMigrate,
+  dbReset,
   deploy,
+  dev,
+  devReset,
+  devStop,
+  devTunnel,
+  doctor,
+  generateTypes,
   init,
+  lint,
+  logs,
+  mailpitClear,
   onboard,
   reset,
+  schemaDiff,
   seedCreate,
   seedLoad,
+  test,
   update,
   validate,
   validateSeeds