@stacksjs/buddy 0.70.251 → 0.70.253

package/dist/commands/deploy.js

@@ -1535,6 +1535,12 @@ export function deploy(buddy) {
   };
   buddy.command("deploy [env]", descriptions.deploy).option("--domain", descriptions.domain, { default: void 0 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--prod", descriptions.production, { default: !0 }).option("--dev", descriptions.development, { default: !1 }).option("--yes", descriptions.yes, { default: !1 }).option("--site <name>", "Deploy only this one site to the existing server (multi-tenant surgical add)", { default: void 0 }).option("--staging", descriptions.staging, { default: !1 }).option("--docker", "Also build an OCI image with pantry (native, no Docker daemon) and push it to the pantry registry", { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (envArg, options) => {
     log.debug("Running `buddy deploy` ...", options);
+    if (process.argv.includes("--dry-run") || options.dryRun === !0) {
+      log.error("`buddy deploy --dry-run` is not supported.");
+      log.info("Deploy has no preview mode: provisioning, release shipping, and DNS all mutate real infrastructure.");
+      log.info("To see what would ship without touching the server, inspect `config/cloud.ts` sites, or run `buddy deploy --site <name>` to narrow a real deploy to one site.");
+      process.exit(ExitCode.FatalError);
+    }
     await ensureDeployPrerequisites(options.verbose === !0);
     const deployEnv = envArg || (options.staging ? "staging" : options.dev ? "development" : "production"), deployEnvName = deployEnv === "prod" ? "production" : deployEnv === "dev" ? "development" : deployEnv;
     process.env.APP_ENV = deployEnvName;

package/dist/commands/dev.d.ts

@@ -7,6 +7,21 @@ export declare function shouldUsePrettyDevUrls(input: {
   proxyManagedExternally: boolean
   systemAuthorized: boolean
 }): boolean;
+export declare function normalizeDevelopmentEntryPath(path: string | undefined): string;
+export declare function resolveDevelopmentLaunch(input?: {
+  root?: string
+  browser?: boolean
+  native?: boolean
+  site?: boolean
+  configuredLaunch?: 'browser' | 'native'
+}): 'browser' | 'native';
+export declare function resolveDevelopmentEntryPath(input?: {
+  root?: string
+  site?: boolean
+  configuredPath?: string
+}): string;
+export declare function developmentUrl(baseUrl: string, entryPath: string): string;
+export declare function developmentBrowserCommand(url: string, platform?: unknown): string[];
 export declare function dev(buddy: CLI): void;
 export declare function startDevelopmentServer(_options: DevOptions, _startTime?: number): Promise<void>;
 export declare function setupPrettyDevEnvironment(input: {

package/dist/commands/dev.js

@@ -72,6 +72,117 @@ export function resolvePrettyDevDomain(appUrl, nativeMode = !1) {
 export function shouldUsePrettyDevUrls(input) {
   return input.domain !== null && !input.localhostOnly && (input.proxyManagedExternally || input.systemAuthorized);
 }
+const APPLICATION_VIEW_CANDIDATES = [
+  "app/index",
+  "app",
+  "dashboard/index",
+  "dashboard",
+  "home/index",
+  "home",
+  "composer",
+  "workspace/index",
+  "workspace",
+  "feed",
+  "portal",
+  "admin",
+  "account/index",
+  "account",
+  "profile/index",
+  "profile"
+], SITE_LAYOUT_NAMES = new Set(["default", "guest", "marketing", "site"]);
+export function normalizeDevelopmentEntryPath(path) {
+  const value = path?.trim();
+  if (!value || value === "/")
+    return "/";
+  try {
+    const parsed = new URL(value, "http://stacks.localhost");
+    return `${parsed.pathname}${parsed.search}${parsed.hash}`;
+  } catch {
+    return "/";
+  }
+}
+function configuredApplicationPath(root) {
+  if (process.env.APP_PATH)
+    return process.env.APP_PATH;
+  try {
+    return readFileSync(join(root, "config/app.ts"), "utf8").match(/^[ \t]*appPath\s*:\s*(['"`])([^'"`]+)\1/m)?.[2];
+  } catch {
+    return;
+  }
+}
+function configuredDevelopmentLaunch(root) {
+  const environmentValue = process.env.STACKS_DEV_LAUNCH?.trim().toLowerCase();
+  if (environmentValue === "browser" || environmentValue === "native")
+    return environmentValue;
+  try {
+    const value = readFileSync(join(root, "config/app.ts"), "utf8").match(/\bdevLaunch\s*:\s*(['"`])(browser|native)\1/)?.[2];
+    return value === "browser" || value === "native" ? value : void 0;
+  } catch {
+    return;
+  }
+}
+export function resolveDevelopmentLaunch(input = {}) {
+  if (input.browser || input.site)
+    return "browser";
+  if (input.native)
+    return "native";
+  const root = input.root ?? projectPath();
+  return input.configuredLaunch ?? configuredDevelopmentLaunch(root) ?? "browser";
+}
+function viewSource(root, route) {
+  const base = join(root, "resources/views", route);
+  for (const extension of ["stx", "vue", "html"]) {
+    const path = `${base}.${extension}`;
+    if (existsSync(path))
+      try {
+        return readFileSync(path, "utf8");
+      } catch {
+        return "";
+      }
+  }
+  return;
+}
+function usesApplicationLayout(source) {
+  const layout = source.match(/@extends\(\s*['"]layouts\/([^'"]+)['"]\s*\)/)?.[1] ?? source.match(/@layout\(\s*['"]layouts\/([^'"]+)['"]\s*\)/)?.[1];
+  if (!layout)
+    return !1;
+  return !SITE_LAYOUT_NAMES.has(layout.split("/").at(-1) ?? layout);
+}
+export function resolveDevelopmentEntryPath(input = {}) {
+  if (input.site)
+    return "/";
+  const root = input.root ?? projectPath(), configuredPath = input.configuredPath ?? configuredApplicationPath(root);
+  if (configuredPath)
+    return normalizeDevelopmentEntryPath(configuredPath);
+  const loginExists = viewSource(root, "login") !== void 0 || viewSource(root, "auth/login") !== void 0, candidates = APPLICATION_VIEW_CANDIDATES.map((route) => ({ route, source: viewSource(root, route) })).filter((candidate) => candidate.source !== void 0), appCandidate = candidates.find((candidate) => usesApplicationLayout(candidate.source)) ?? (loginExists ? candidates[0] : void 0);
+  if (appCandidate)
+    return normalizeDevelopmentEntryPath(`/${appCandidate.route.replace(/\/index$/, "")}`);
+  return loginExists ? "/login" : "/";
+}
+export function developmentUrl(baseUrl, entryPath) {
+  const normalized = normalizeDevelopmentEntryPath(entryPath);
+  if (normalized === "/")
+    return baseUrl.replace(/\/$/, "");
+  return new URL(normalized, `${baseUrl.replace(/\/$/, "")}/`).toString();
+}
+export function developmentBrowserCommand(url, platform = process.platform) {
+  if (platform === "darwin")
+    return ["open", url];
+  if (platform === "win32")
+    return ["cmd", "/c", "start", "", url];
+  return ["xdg-open", url];
+}
+function openDevelopmentBrowser(url) {
+  if (!process.stdout.isTTY || process.env.CI || process.env.STACKS_DEV_NO_OPEN === "1")
+    return;
+  try {
+    Bun.spawn(developmentBrowserCommand(url), {
+      stdin: "ignore",
+      stdout: "ignore",
+      stderr: "ignore"
+    }).unref();
+  } catch {}
+}
 async function canStartPrettyDevProxy() {
   if (await waitForHttpsProxy(443, 150))
     return !0;
@@ -96,11 +207,15 @@ export function dev(buddy) {
     interactive: "Get asked which development server to start",
     select: "Which development server are you trying to start?",
     withLocalhost: "Include the localhost URL in the output",
+    browser: "Open the application in a browser instead of its configured native window",
+    site: "Open the marketing site instead of the application",
     project: "Target a specific project",
     verbose: "Enable verbose output"
   };
-  buddy.command("dev [server]", descriptions.dev).option("-f, --frontend", descriptions.frontend).option("-a, --api", descriptions.api).option("-c, --components", descriptions.components).option("-d, --dashboard", descriptions.dashboard).option("-k, --desktop", descriptions.desktop).option("-n, --native", descriptions.native).option("-o, --docs", descriptions.docs).option("-s, --system-tray", descriptions.systemTray).option("-i, --interactive", descriptions.interactive, { default: !1 }).option("-l, --with-localhost", descriptions.withLocalhost, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (server, options) => {
-    const perf = Bun.nanoseconds(), target = server || (options.frontend ? "frontend" : void 0) || (options.api ? "api" : void 0) || (options.components ? "components" : void 0) || (options.dashboard ? "dashboard" : void 0) || (options.desktop ? "desktop" : void 0) || (options.native ? "native" : void 0) || (options.systemTray || options["system-tray"] ? "system-tray" : void 0) || (options.docs ? "docs" : void 0);
+  buddy.command("dev [server]", descriptions.dev).option("-f, --frontend", descriptions.frontend).option("-a, --api", descriptions.api).option("-c, --components", descriptions.components).option("-d, --dashboard", descriptions.dashboard).option("-k, --desktop", descriptions.desktop).option("-n, --native", descriptions.native).option("-o, --docs", descriptions.docs).option("-s, --system-tray", descriptions.systemTray).option("-i, --interactive", descriptions.interactive, { default: !1 }).option("-l, --with-localhost", descriptions.withLocalhost, { default: !1 }).option("--browser", descriptions.browser, { default: !1 }).option("--site", descriptions.site, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (server, options) => {
+    const perf = Bun.nanoseconds();
+    process.env.STACKS_DEV_ENTRY_PATH = resolveDevelopmentEntryPath({ site: options.site });
+    const target = server || (options.frontend ? "frontend" : void 0) || (options.api ? "api" : void 0) || (options.components ? "components" : void 0) || (options.dashboard ? "dashboard" : void 0) || (options.desktop ? "desktop" : void 0) || (options.native ? "native" : void 0) || (options.systemTray || options["system-tray"] ? "system-tray" : void 0) || (options.docs ? "docs" : void 0);
     if (target) {
       const serverOptions = { ...options }, a = await actions();
       switch (target) {
@@ -120,7 +235,7 @@ export function dev(buddy) {
           await a.runDashboardDevServer(serverOptions);
           break;
         case "desktop":
-          await a.runDesktopDevServer(serverOptions);
+          await startDevelopmentServer({ ...serverOptions, native: !0 }, perf);
           break;
         case "system-tray":
           await a.runSystemTrayDevServer(serverOptions);
@@ -144,7 +259,7 @@ export function dev(buddy) {
         frontend: () => a.runFrontendDevServer(options),
         api: () => a.runApiDevServer(options),
         dashboard: () => a.runDashboardDevServer(options),
-        desktop: () => a.runDesktopDevServer(options),
+        desktop: () => startDevelopmentServer({ ...options, native: !0 }, perf),
         native: () => startDevelopmentServer({ ...options, native: !0 }, perf),
         components: () => a.runComponentsDevServer(options),
         docs: () => a.runDocsDevServer(options)
@@ -186,14 +301,8 @@ export function dev(buddy) {
     await startDevelopmentServer({ ...options, native: !0 }, perf);
   });
   buddy.command("dev:desktop", descriptions.desktop).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    const perf = await intro("buddy dev:desktop"), result = await (await actions()).runAction(Action.DevDesktop, options);
-    if (result.isErr) {
-      await outro("While running the dev:desktop command, there was an issue", { startTime: perf, useSeconds: !0 }, result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    console.log("");
-    await outro("Exited", { startTime: perf, useSeconds: !0 });
-    process.exit(ExitCode.Success);
+    const perf = await intro("buddy dev:desktop");
+    await startDevelopmentServer({ ...options, native: !0 }, perf);
   });
   buddy.command("dev:api", descriptions.api).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--no-watch-types", "Skip the model/config type-regeneration watcher", { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
     const a = await actions();
@@ -203,7 +312,8 @@ export function dev(buddy) {
       });
     await a.runApiDevServer(options);
   });
-  buddy.command("dev:frontend", descriptions.frontend).alias("dev:pages").alias("dev:views").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
+  buddy.command("dev:frontend", descriptions.frontend).alias("dev:pages").alias("dev:views").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--site", descriptions.site, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
+    process.env.STACKS_DEV_ENTRY_PATH = resolveDevelopmentEntryPath({ site: options.site });
     await (await actions()).runFrontendDevServer(options);
   });
   buddy.command("dev:dashboard", descriptions.dashboard).alias("dev:admin").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
@@ -215,7 +325,13 @@ export function dev(buddy) {
   onUnknownSubcommand(buddy, "dev");
 }
 export async function startDevelopmentServer(_options, _startTime) {
-  const options = _options, startedAt = _startTime, appUrl = process.env.APP_URL ?? "stacks.localhost", nativeMode = options.native === !0, proxyManagedExternally = process.env.STACKS_PROXY_MANAGED === "1", preferredFrontendPort = Number(process.env.PORT) || 3000, preferredApiPort = Number(process.env.PORT_API) || 3008, preferredDocsPort = Number(process.env.PORT_DOCS) || 3006, preferredDashboardPort = Number(process.env.PORT_ADMIN) || 3002;
+  const options = _options, startedAt = _startTime, appUrl = process.env.APP_URL ?? "stacks.localhost", nativeMode = resolveDevelopmentLaunch({
+    browser: options.browser,
+    native: options.native,
+    site: options.site
+  }) === "native", entryPath = resolveDevelopmentEntryPath({ site: options.site });
+  process.env.STACKS_DEV_ENTRY_PATH = entryPath;
+  const proxyManagedExternally = process.env.STACKS_PROXY_MANAGED === "1", preferredFrontendPort = Number(process.env.PORT) || 3000, preferredApiPort = Number(process.env.PORT_API) || 3008, preferredDocsPort = Number(process.env.PORT_DOCS) || 3006, preferredDashboardPort = Number(process.env.PORT_ADMIN) || 3002;
   if (process.env.STACKS_DEV_NO_KILL !== "1")
     await cleanupStaleDevProcesses([
       preferredFrontendPort,
@@ -240,7 +356,7 @@ export async function startDevelopmentServer(_options, _startTime) {
     localhostOnly,
     proxyManagedExternally,
     systemAuthorized
-  }), prettySetupRequired = prettyUrlsRequested && !usePrettyUrls, hasCustomDomain = usePrettyUrls && !proxyManagedExternally, displayedDomain = usePrettyUrls ? domain : null, dashboardDomain = displayedDomain ? `dashboard.${displayedDomain}` : null, frontendUrl = displayedDomain ? `https://${displayedDomain}` : `http://localhost:${frontendPort}`, apiUrl = displayedDomain ? `https://${displayedDomain}/api` : `http://localhost:${apiPort}`, docsUrl = displayedDomain ? `https://${displayedDomain}/docs` : `http://localhost:${docsPort}`, dashboardUrl = dashboardDomain ? `https://${dashboardDomain}` : `http://localhost:${dashboardPort}`;
+  }), prettySetupRequired = prettyUrlsRequested && !usePrettyUrls, hasCustomDomain = usePrettyUrls && !proxyManagedExternally, displayedDomain = usePrettyUrls ? domain : null, dashboardDomain = displayedDomain ? `dashboard.${displayedDomain}` : null, frontendBaseUrl = displayedDomain ? `https://${displayedDomain}` : `http://localhost:${frontendPort}`, frontendUrl = developmentUrl(frontendBaseUrl, entryPath), apiUrl = displayedDomain ? `https://${displayedDomain}/api` : `http://localhost:${apiPort}`, docsUrl = displayedDomain ? `https://${displayedDomain}/docs` : `http://localhost:${docsPort}`, dashboardUrl = dashboardDomain ? `https://${dashboardDomain}` : `http://localhost:${dashboardPort}`;
   process.env.STACKS_PROXY_MANAGED = "1";
   process.env.STACKS_DEV_QUIET = "1";
   console.log();
@@ -297,7 +413,7 @@ export async function startDevelopmentServer(_options, _startTime) {
     { name: "API", port: apiPort }
   ], readinessTimeoutMs = 30000;
   let readyAnnounced = !1;
-  const nativeUrl = `http://localhost:${frontendPort}`, nativeWindowReady = nativeMode ? waitForPort(frontendPort, readinessTimeoutMs).then(async (ready) => {
+  const nativeUrl = developmentUrl(`http://localhost:${frontendPort}`, entryPath), nativeWindowReady = nativeMode ? waitForPort(frontendPort, readinessTimeoutMs).then(async (ready) => {
     if (!ready) {
       log.warn(`Native window skipped because the frontend did not answer within ${readinessTimeoutMs / 1000}s`);
       return;
@@ -340,6 +456,8 @@ export async function startDevelopmentServer(_options, _startTime) {
       hasCustomDomain: !!appLooksCustom && !localhostOnly,
       proxyReachable: proxyManagedExternally ? !0 : proxyReachable,
       frontendUrl,
+      frontendBaseUrl,
+      entryPath,
       apiUrl,
       docsUrl,
       dashboardUrl,
@@ -351,6 +469,10 @@ export async function startDevelopmentServer(_options, _startTime) {
       dashboardPort,
       dashboardDomain
     });
+    if (!nativeMode) {
+      const browserUrl = hasCustomDomain && (proxyManagedExternally || proxyReachable) ? frontendUrl : developmentUrl(`http://localhost:${frontendPort}`, entryPath);
+      openDevelopmentBrowser(browserUrl);
+    }
     if (startedAt) {
       const elapsedMs = (Bun.nanoseconds() - startedAt) / 1e6, summary = failed.length ? `ready in ${(elapsedMs / 1000).toFixed(1)}s \u2014 ${failed.join(", ")} did not bind within ${readinessTimeoutMs / 1000}s` : `ready in ${(elapsedMs / 1000).toFixed(1)}s`;
       console.log(`  ${dim(summary)}`);
@@ -409,6 +531,8 @@ function printDevReadyBanner(input) {
     hasCustomDomain,
     proxyReachable,
     frontendUrl,
+    frontendBaseUrl,
+    entryPath,
     apiUrl,
     docsUrl,
     dashboardUrl,
@@ -419,9 +543,12 @@ function printDevReadyBanner(input) {
     domain,
     dashboardPort,
     dashboardDomain
-  } = input, verbose = options.verbose ?? !1, useProxy = hasCustomDomain && proxyReachable, feUrl = useProxy ? frontendUrl : `http://localhost:${frontendPort}`, apUrl = useProxy ? apiUrl : `http://localhost:${apiPort}`, dcUrl = useProxy ? docsUrl : `http://localhost:${docsPort}`, dbUrl = useProxy ? dashboardUrl : `http://localhost:${dashboardPort}`, blogUrl = `${feUrl}/blog`;
+  } = input, verbose = options.verbose ?? !1, useProxy = hasCustomDomain && proxyReachable, feUrl = useProxy ? frontendUrl : developmentUrl(`http://localhost:${frontendPort}`, entryPath), feBaseUrl = useProxy ? frontendBaseUrl : `http://localhost:${frontendPort}`, apUrl = useProxy ? apiUrl : `http://localhost:${apiPort}`, dcUrl = useProxy ? docsUrl : `http://localhost:${docsPort}`, dbUrl = useProxy ? dashboardUrl : `http://localhost:${dashboardPort}`, blogUrl = `${feBaseUrl}/blog`;
   console.log();
-  console.log(`  ${green("\u279C")}  ${bold("Frontend")}:    ${cyan(feUrl)}`);
+  const frontendLabel = entryPath === "/" ? "Site" : "App";
+  console.log(`  ${green("\u279C")}  ${bold(frontendLabel.padEnd(8))}:    ${cyan(feUrl)}`);
+  if (entryPath !== "/")
+    console.log(`  ${dim("\u279C")}  ${dim("Site")}:        ${dim(feBaseUrl)}`);
   if (nativeMode)
     console.log(`  ${green("\u279C")}  ${bold("Native")}:      ${cyan(`Craft \u2192 ${feUrl}`)}`);
   console.log(`  ${green("\u279C")}  ${bold("API")}:         ${cyan(apUrl)}`);
@@ -431,7 +558,7 @@ function printDevReadyBanner(input) {
   if (includeDashboard)
     console.log(`  ${green("\u279C")}  ${bold("Dashboard")}:   ${cyan(dbUrl)}`);
   if (useProxy) {
-    console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`http://localhost:${frontendPort} (bypasses the proxy)`)}`);
+    console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`${developmentUrl(`http://localhost:${frontendPort}`, entryPath)} (bypasses the proxy)`)}`);
     if (includeDashboard && dashboardDomain)
       console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`http://localhost:${dashboardPort} (dashboard, bypasses the proxy)`)}`);
   }
@@ -441,8 +568,8 @@ function printDevReadyBanner(input) {
   }
   if (verbose && domain) {
     console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`localhost:${frontendPort} \u2192 ${domain}`)}`);
-    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendUrl}/api \u2192 localhost:${apiPort}`)}`);
-    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendUrl}/docs \u2192 localhost:${docsPort}`)}`);
+    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendBaseUrl}/api \u2192 localhost:${apiPort}`)}`);
+    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendBaseUrl}/docs \u2192 localhost:${docsPort}`)}`);
     if (includeDashboard)
       console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`localhost:${dashboardPort} \u2192 ${dashboardDomain}`)}`);
   }

package/dist/commands/doctor.js

@@ -177,6 +177,26 @@ export function doctor(buddy) {
       const example = `CREATE UNIQUE INDEX IF NOT EXISTS "${first.table}_${first.columns.join("_")}_unique" ON "${first.table}" ("${first.columns.join('", "')}")`;
       throw Error(`${result.missing.length}/${result.declared.length} declared unique constraints have no UNIQUE index: ${sample}${more}. Run \`buddy migrate\` (re-queues missing unique-index migrations, #1952) \u2014 dedupe duplicate rows first or migrate hard-fails; if no migration file exists run \`buddy generate:migrations\`, or create manually: ${example}`);
     }, 1e4);
+    await probe(checks, "Migration ledger", async () => {
+      const { auditMigrationLedger } = await import("@stacksjs/database"), result = await auditMigrationLedger();
+      if (!result.supported)
+        return "Dialect not audited (skipped)";
+      if (result.entries.length === 0)
+        return "No migration files";
+      const { counts, orphans } = result;
+      if (!result.drift)
+        return `${result.entries.length} migrations, ledger consistent with the schema`;
+      const parts = [];
+      if (counts.stranded > 0)
+        parts.push(`${counts.stranded} applied but unrecorded (would re-run)`);
+      if (counts.partial > 0)
+        parts.push(`${counts.partial} half-applied`);
+      if (counts.reverted > 0)
+        parts.push(`${counts.reverted} recorded but missing from the schema`);
+      if (orphans.length > 0)
+        parts.push(`${orphans.length} ledger row(s) with no file on disk`);
+      throw Error(`Migration ledger has drifted: ${parts.join(", ")}. Inspect with \`buddy migrate:status\`, repair with \`buddy migrate:status --reconcile\`.`);
+    }, 1e4);
     await probe(checks, "FK orphans", async () => {
       const { findFkOrphans } = await import("@stacksjs/database"), result = await findFkOrphans();
       if (!result.supported)

package/dist/commands/migrate.js

@@ -553,9 +553,90 @@ export function migrate(buddy) {
       process.exit(ExitCode.FatalError);
     }
     log.success(`Wrote ${result.value.files.length} ${target} migration file(s) to database/migrations.`);
+    if (applied > 0) {
+      const { reconcileMigrationLedger } = await import("@stacksjs/database"), fixed = await reconcileMigrationLedger();
+      if (fixed.remapped.length > 0)
+        log.info(`Repointed ${fixed.remapped.length} ledger row(s) at their renumbered file.`);
+      if (fixed.recorded.length > 0)
+        log.info(`Recorded ${fixed.recorded.length} migration(s) already present in the schema.`);
+      if (fixed.skipped.length > 0)
+        log.warn(`${fixed.skipped.length} ledger entr(ies) need a look \u2014 run \`./buddy migrate:status\`.`);
+    }
     log.info("Review the change with `git diff`, then run `./buddy migrate`.");
     await outro("Regenerated.", { startTime: perf, useSeconds: !0 });
     process.exit(ExitCode.Success);
   });
+  buddy.command("migrate:status", "Compare database/migrations, the migrations ledger, and the live schema").option("--reconcile", "Repair the ledger where the schema proves what happened", { default: !1 }).option("--include-partial", "With --reconcile, also record half-applied migrations", { default: !1 }).option("--json", "Emit the audit as JSON", { default: !1 }).action(async (options) => {
+    const perf = options.json ? void 0 : await intro("buddy migrate:status"), { auditMigrationLedger, reconcileMigrationLedger } = await import("@stacksjs/database"), audit = await auditMigrationLedger();
+    if (options.json) {
+      console.log(JSON.stringify(audit, (_k, v) => v instanceof Set ? [...v] : v, 2));
+      process.exit(audit.drift ? ExitCode.FatalError : ExitCode.Success);
+    }
+    if (!audit.supported) {
+      log.info(`Dialect "${audit.dialect}" is not audited. Nothing to compare.`);
+      await outro("Skipped.", { startTime: perf, useSeconds: !0 });
+      process.exit(ExitCode.Success);
+    }
+    const { counts, entries, orphans } = audit, list = (status) => entries.filter((e) => e.status === status).map((e) => e.file), report = [], section = (heading, files) => {
+      if (files.length === 0)
+        return;
+      if (heading)
+        report.push(`  ${heading}`);
+      for (const file of files.slice(0, 8))
+        report.push(`      ${file}`);
+      if (files.length > 8)
+        report.push(`      \u2026 +${files.length - 8} more`);
+      report.push("");
+    };
+    report.push("");
+    report.push(`  Migration status: ${audit.dialect}`);
+    report.push("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    report.push(`  ${entries.length} file(s) on disk \xB7 ${audit.recordedCount} recorded in the ledger`);
+    report.push("");
+    if (counts.applied > 0)
+      report.push(`  ${counts.applied} applied - recorded, and present in the schema.`, "");
+    if (counts.unverifiable > 0)
+      report.push(`  ${counts.unverifiable} unverifiable - data migrations with no schema trace to check.`, "");
+    section(`${counts.pending} pending - not applied yet, will run on the next \`buddy migrate\`:`, list("pending"));
+    if (counts.stranded > 0) {
+      report.push(`  ${counts.stranded} STRANDED - already applied to the schema, but missing from the ledger.`);
+      report.push("  These re-run on the next `buddy migrate`, which is unsafe for anything not idempotent.");
+      section("", list("stranded"));
+    }
+    section(`${counts.partial} PARTIAL - some effects present, some missing. Needs a human:`, list("partial"));
+    section(`${counts.reverted} REVERTED - recorded as applied, but the effects are gone from the schema:`, list("reverted"));
+    if (orphans.length > 0)
+      section(`${orphans.length} orphaned ledger row(s) - recorded, but no such file on disk:`, orphans.map((o) => `${o.migration}${o.renamedTo ? `  -> renumbered to ${o.renamedTo}` : "  (no counterpart; migration deleted?)"}`));
+    console.log(report.join(`
+`));
+    if (!audit.drift) {
+      await outro("Ledger matches the corpus and the schema.", { startTime: perf, useSeconds: !0 });
+      process.exit(ExitCode.Success);
+    }
+    if (!options.reconcile) {
+      console.log(`
+  Repair with:  ./buddy migrate:status --reconcile
+  That repoints renumbered ledger rows and records migrations the schema
+  already proves. It never runs SQL from a migration file.
+`);
+      await outro("Drift detected.", { startTime: perf, useSeconds: !0 });
+      process.exit(ExitCode.FatalError);
+    }
+    const fixed = await reconcileMigrationLedger({ includePartial: options.includePartial });
+    if (fixed.remapped.length > 0)
+      log.success(`Repointed ${fixed.remapped.length} ledger row(s) at their renumbered file.`);
+    if (fixed.recorded.length > 0)
+      log.success(`Recorded ${fixed.recorded.length} migration(s) the schema already reflects.`);
+    if (fixed.skipped.length > 0) {
+      log.warn(`Left ${fixed.skipped.length} entr(ies) alone:`);
+      console.log(fixed.skipped.slice(0, 8).map((s) => `      ${s.file} \u2014 ${s.reason}`).join(`
+`) + (fixed.skipped.length > 8 ? `
+      \u2026 +${fixed.skipped.length - 8} more` : ""));
+    }
+    if (fixed.remapped.length === 0 && fixed.recorded.length === 0)
+      log.info("Nothing could be repaired automatically.");
+    await outro("Reconciled.", { startTime: perf, useSeconds: !0 });
+    process.exit(ExitCode.Success);
+  });
   onUnknownSubcommand(buddy, "migrate");
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/buddy",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.251",
+  "version": "0.70.253",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "contributors": [
@@ -88,53 +88,53 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/actions": "^0.70.251",
-    "@stacksjs/ai": "^0.70.251",
-    "@stacksjs/alias": "^0.70.251",
-    "@stacksjs/arrays": "^0.70.251",
-    "@stacksjs/auth": "^0.70.251",
-    "@stacksjs/build": "^0.70.251",
-    "@stacksjs/cache": "^0.70.251",
-    "@stacksjs/cli": "^0.70.251",
+    "@stacksjs/actions": "^0.70.253",
+    "@stacksjs/ai": "^0.70.253",
+    "@stacksjs/alias": "^0.70.253",
+    "@stacksjs/arrays": "^0.70.253",
+    "@stacksjs/auth": "^0.70.253",
+    "@stacksjs/build": "^0.70.253",
+    "@stacksjs/cache": "^0.70.253",
+    "@stacksjs/cli": "^0.70.253",
     "@stacksjs/clapp": "^0.2.12",
-    "@stacksjs/cloud": "^0.70.251",
-    "@stacksjs/collections": "^0.70.251",
-    "@stacksjs/config": "^0.70.251",
-    "@stacksjs/database": "^0.70.251",
-    "@stacksjs/desktop-build": "^0.70.251",
-    "@stacksjs/dns": "^0.70.251",
-    "@stacksjs/email": "^0.70.251",
-    "@stacksjs/enums": "^0.70.251",
-    "@stacksjs/error-handling": "^0.70.251",
-    "@stacksjs/events": "^0.70.251",
-    "@stacksjs/git": "^0.70.251",
+    "@stacksjs/cloud": "^0.70.253",
+    "@stacksjs/collections": "^0.70.253",
+    "@stacksjs/config": "^0.70.253",
+    "@stacksjs/database": "^0.70.253",
+    "@stacksjs/desktop-build": "^0.70.253",
+    "@stacksjs/dns": "^0.70.253",
+    "@stacksjs/email": "^0.70.253",
+    "@stacksjs/enums": "^0.70.253",
+    "@stacksjs/error-handling": "^0.70.253",
+    "@stacksjs/events": "^0.70.253",
+    "@stacksjs/git": "^0.70.253",
     "@stacksjs/gitit": "^0.2.5",
-    "@stacksjs/health": "^0.70.251",
+    "@stacksjs/health": "^0.70.253",
     "@stacksjs/dnsx": "^0.2.3",
     "@stacksjs/httx": "^0.1.10",
-    "@stacksjs/image": "^0.70.251",
-    "@stacksjs/lint": "^0.70.251",
-    "@stacksjs/logging": "^0.70.251",
-    "@stacksjs/notifications": "^0.70.251",
-    "@stacksjs/objects": "^0.70.251",
-    "@stacksjs/orm": "^0.70.251",
-    "@stacksjs/path": "^0.70.251",
-    "@stacksjs/skills": "^0.70.251",
-    "@stacksjs/payments": "^0.70.251",
-    "@stacksjs/realtime": "^0.70.251",
-    "@stacksjs/router": "^0.70.251",
+    "@stacksjs/image": "^0.70.253",
+    "@stacksjs/lint": "^0.70.253",
+    "@stacksjs/logging": "^0.70.253",
+    "@stacksjs/notifications": "^0.70.253",
+    "@stacksjs/objects": "^0.70.253",
+    "@stacksjs/orm": "^0.70.253",
+    "@stacksjs/path": "^0.70.253",
+    "@stacksjs/skills": "^0.70.253",
+    "@stacksjs/payments": "^0.70.253",
+    "@stacksjs/realtime": "^0.70.253",
+    "@stacksjs/router": "^0.70.253",
     "@stacksjs/rpx": "^0.11.42",
-    "@stacksjs/search-engine": "^0.70.251",
-    "@stacksjs/security": "^0.70.251",
-    "@stacksjs/server": "^0.70.251",
-    "@stacksjs/storage": "^0.70.251",
-    "@stacksjs/strings": "^0.70.251",
-    "@stacksjs/testing": "^0.70.251",
-    "@stacksjs/tunnel": "^0.70.251",
-    "@stacksjs/types": "^0.70.251",
-    "@stacksjs/ui": "^0.70.251",
-    "@stacksjs/utils": "^0.70.251",
-    "@stacksjs/validation": "^0.70.251",
+    "@stacksjs/search-engine": "^0.70.253",
+    "@stacksjs/security": "^0.70.253",
+    "@stacksjs/server": "^0.70.253",
+    "@stacksjs/storage": "^0.70.253",
+    "@stacksjs/strings": "^0.70.253",
+    "@stacksjs/testing": "^0.70.253",
+    "@stacksjs/tunnel": "^0.70.253",
+    "@stacksjs/types": "^0.70.253",
+    "@stacksjs/ui": "^0.70.253",
+    "@stacksjs/utils": "^0.70.253",
+    "@stacksjs/validation": "^0.70.253",
     "@stacksjs/ts-cloud": "^0.7.92",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",