npm - betterstart-cli - Versions diffs - 0.0.85 → 0.0.87 - Mend

betterstart-cli 0.0.85 → 0.0.87

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/cli.js CHANGED Viewed

@@ -22,6 +22,7 @@ import {
 // cli.ts
 import { readFileSync } from "fs";
+import * as p29 from "@clack/prompts";
 // core-engine/commands/require-init.ts
 import path2 from "path";
@@ -74,7 +75,13 @@ function createAddCommand(runtime) {
     "--skip-migration",
     "Skip running db:push after installing schema-backed presets",
     false
-  ).option("--cwd <path>", "Project root path").action((items, options) => runtime.runAdd(items, options));
+  ).option("--cwd <path>", "Project root path").addHelpText(
+    "after",
+    `
+Examples:
+  $ betterstart add blog
+  $ betterstart add r2 --integration`
+  ).action((items, options) => runtime.runAdd(items, options));
 }
 function collectRepeatedOption(value, previous = []) {
   return [...previous, value];
@@ -95,6 +102,12 @@ function createCreateCommand(runtime) {
     "--accept-generated",
     "Accept generated output for files that would otherwise get merge conflicts",
     false
+  ).addHelpText(
+    "after",
+    `
+Examples:
+  $ betterstart create entity
+  $ betterstart create form contact`
   ).action(
     (kind, schemaName, options) => runtime.runCreate(kind, schemaName, options)
   );
@@ -104,12 +117,18 @@ function createGenerateCommand(runtime) {
     "--accept-generated",
     "Accept generated output for files that would otherwise get merge conflicts",
     false
-  ).option("-a, --all", "Regenerate all schemas", false).option("--interactive", "Prompt during generate --all", false).option("--skip-migration", "Skip running db:push after generation", false).option("--cwd <path>", "Project root path").action(
+  ).option("-a, --all", "Regenerate all schemas", false).option("--interactive", "Prompt during generate --all", false).option("--skip-migration", "Skip running db:push after generation", false).option("--cwd <path>", "Project root path").addHelpText(
+    "after",
+    `
+Examples:
+  $ betterstart generate posts
+  $ betterstart generate --all --skip-migration`
+  ).action(
     (schemaName, options) => runtime.runGenerate(schemaName, options)
   );
 }
 function createInitCommand(runtime) {
-  return new Command("init").description("Scaffold Admin into a new or existing Next.js app").argument("[name]", "Project name (creates new directory if fresh project)").option("--presets <presets>", "Comma-separated content preset IDs (e.g. blog)").option("--integrations <integrations>", "Comma-separated integration IDs (e.g. r2,resend)").option("--namespace <name>", "Generated admin namespace (e.g. admin, dashboard)").option("-y, --yes", "Skip prompts (defaults to manual database, local storage, and no deploy)").option("--skip-migration", "Skip running drizzle-kit push after scaffolding").option("--skip-admin-creation", "Skip prompting to create the initial admin user").option("--skip-dev-server-start", "Skip prompting to start the development server").option(
+  return new Command("init").description("Scaffold Admin into a new or existing Next.js app").argument("[name]", "Project name (creates new directory if fresh project)").option("--presets <presets>", "Comma-separated content preset IDs (e.g. blog)").option("--integrations <integrations>", "Comma-separated integration IDs (e.g. r2,resend)").option("--namespace <name>", "Generated admin namespace (e.g. admin, dashboard)").option("-y, --yes", "Skip prompts (defaults to manual database, local storage, and no deploy)").option("--json", "With --yes, print a machine-readable setup result on stdout", false).option("--skip-migration", "Skip running drizzle-kit push after scaffolding").option("--skip-admin-creation", "Skip prompting to create the initial admin user").option("--skip-dev-server-start", "Skip prompting to start the development server").option(
     "--database-url <url>",
     "PostgreSQL database connection string (postgres:// or postgresql://)"
   ).option("--database-provider <provider>", "Database provider: vercel, railway, or manual").option(
@@ -118,15 +137,22 @@ function createInitCommand(runtime) {
   ).option("--deploy-provider <provider>", "Deploy provider: vercel, railway, or none").option("--database-plan <id>", "Neon plan id for a Vercel-provisioned database").option("--railway-workspace <id-or-name>", "Railway workspace for a new project").option("--railway-project <id-or-name>", "Existing Railway project to intentionally reuse").option("--railway-environment <id-or-name>", "Railway environment (default: production)").option("--railway-service <id-or-name>", "Railway app service (default: web)").option(
     "--railway-bucket-region <region>",
     "Railway bucket region: sjc, iad, ams, or sin (default: iad)"
-  ).option("--force", "Overwrite all existing Admin files (nuclear option)").action(
+  ).option("--force", "Overwrite all existing Admin files (nuclear option)").addHelpText(
+    "after",
+    `
+Examples:
+  $ betterstart init
+  $ betterstart init my-app --yes --database-url <url>
+  $ betterstart init --yes --database-provider vercel --deploy-provider vercel --json`
+  ).action(
     (name, options) => runtime.runInit(name, options)
   );
 }
 function createListPresetsCommand(runtime) {
-  return new Command("list-presets").description("List available BetterStart presets").option("--cwd <path>", "Project root path").action((options) => runtime.runListPresets(options));
+  return new Command("list-presets").description("List available BetterStart presets").option("--json", "Print presets as JSON on stdout", false).option("--cwd <path>", "Project root path").action((options) => runtime.runListPresets(options));
 }
 function createListIntegrationsCommand(runtime) {
-  return new Command("list-integrations").description("List available BetterStart integrations").option("--cwd <path>", "Project root path").action((options) => runtime.runListIntegrations(options));
+  return new Command("list-integrations").description("List available BetterStart integrations").option("--json", "Print integrations as JSON on stdout", false).option("--cwd <path>", "Project root path").action((options) => runtime.runListIntegrations(options));
 }
 function createRemoveCommand(runtime) {
   return new Command("remove").description("Remove installed BetterStart presets or integrations").argument("<items...>", "Preset or integration IDs to remove (e.g. blog r2)").option("-f, --force", "Skip confirmation prompt", false).option("--integration", "Remove integration IDs instead of content preset IDs", false).option("--cwd <path>", "Project root path").action((items, options) => runtime.runRemove(items, options));
@@ -137,13 +163,29 @@ function createRemoveSchemaCommand(runtime) {
   );
 }
 function createSeedCommand(runtime) {
-  return new Command("seed").description("Create the initial admin user").option("--cwd <path>", "Project root path").action((options) => runtime.runSeed(options));
+  return new Command("seed").description("Create the initial admin user").option("--email <email>", "Admin email (required off-TTY)").option(
+    "--name <name>",
+    'Admin display name (defaults to "Admin"); set the password via BETTERSTART_ADMIN_PASSWORD off-TTY'
+  ).option("--cwd <path>", "Project root path").addHelpText(
+    "after",
+    `
+Examples:
+  $ betterstart seed
+  $ BETTERSTART_ADMIN_PASSWORD=<password> betterstart seed --email admin@example.com`
+  ).action((options) => runtime.runSeed(options));
 }
 function createUninstallCommand(runtime) {
   return new Command("uninstall").description("Remove all Admin files and undo modifications made by betterstart init").option("-f, --force", "Skip all confirmation prompts", false).option("--cwd <path>", "Project root path").action((options) => runtime.runUninstall(options));
 }
 function createUpdateCommand(runtime) {
-  return new Command("update").alias("update-component").description("Update Admin components from the latest CLI templates").argument("[components...]", "Component names to update (e.g., media-field button)").option("--list", "List all available components").option("--all", "Update all components").option("--shadcn-preset <preset>", "Apply a shadcn preset to Admin UI components").option("--only <parts>", "Apply only supported shadcn preset parts: theme").option("--cwd <path>", "Project root path").action(
+  return new Command("update").alias("update-component").description("Update Admin components from the latest CLI templates").argument("[components...]", "Component names to update (e.g., media-field button)").option("--list", "List all available components").option("--json", "With --list, print components as JSON on stdout", false).option("--all", "Update all components").option("--shadcn-preset <preset>", "Apply a shadcn preset to Admin UI components").option("--only <parts>", "Apply only supported shadcn preset parts: theme").option("-y, --yes", "Skip the overwrite confirmation", false).option("--cwd <path>", "Project root path").addHelpText(
+    "after",
+    `
+Examples:
+  $ betterstart update --list
+  $ betterstart update media-field
+  $ betterstart update --all --yes`
+  ).action(
     (components, options) => runtime.runUpdate(components, options)
   );
 }
@@ -156,7 +198,7 @@ function createUpdateStylesCommand(runtime) {
 // adapters/next/commands/add.ts
 import path27 from "path";
-import * as p4 from "@clack/prompts";
+import * as p6 from "@clack/prompts";
 // core-engine/config/serialize.ts
 import fs3 from "fs";
@@ -186,6 +228,7 @@ function compactShortStringArrays(json) {
 // core-engine/snapshots/store.ts
 var BARREL_SCOPE = "_barrels";
 var REMOVED_SCOPE = "_removed";
+var UNSUPPORTED_PROJECT_STATE_MESSAGE = "Project state is unsupported or incomplete. Re-run `betterstart init --force` to create the current snapshot-backed layout.";
 function normalizeLineEndings(content) {
   return content.replace(/\r\n/g, "\n");
 }
@@ -459,6 +502,7 @@ function createNextAppCommand() {
 // adapters/next/config.ts
 import fs6 from "fs";
 import path7 from "path";
+import * as clack from "@clack/prompts";
 // adapters/next/config/detect.ts
 import fs5 from "fs";
@@ -691,11 +735,22 @@ async function resolveConfig(cwd) {
   };
   return config;
 }
+async function resolveConfigOrExit(cwd) {
+  try {
+    return await resolveConfig(cwd);
+  } catch (error) {
+    clack.log.error(
+      `Error loading config: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+}
 // adapters/next/generators/post-generate.ts
 import { execFileSync as execFileSync2 } from "child_process";
 import fs8 from "fs";
 import path10 from "path";
+import * as p3 from "@clack/prompts";
 // adapters/next/init/scaffolders/dependencies.ts
 import { spawn } from "child_process";
@@ -1739,6 +1794,19 @@ ${stderr}`.trim();
   });
 }
+// adapters/next/utils/next-steps.ts
+import * as p2 from "@clack/prompts";
+function printNextSteps(options) {
+  const steps = [`1. Review ${options.reviewLabel}`];
+  if (options.needsMigration) {
+    steps.push("2. Run database migration: db:push");
+    steps.push(`3. Start the dev server and visit ${options.route}`);
+  } else {
+    steps.push(`2. Start the dev server and visit ${options.route}`);
+  }
+  p2.note(steps.join("\n"), "Next steps");
+}
 // adapters/next/generators/post-generate.ts
 var BIOME_FORMAT_TIMEOUT_MS = 3e4;
 function loadEnvFile(cwd) {
@@ -1838,26 +1906,25 @@ function ensureDatabasePushDependencies(cwd, pm) {
   if (missing.length === 0) {
     return true;
   }
-  console.log(
-    `
-  Installing database push dependencies (${missing.map((dependency) => dependency.name).join(", ")})...`
+  p3.log.info(
+    `Installing database push dependencies (${missing.map((dependency) => dependency.name).join(", ")})...`
   );
   for (const dependency of missing) {
     const installed2 = installDependency(cwd, pm, dependency.name, dependency.dev);
     if (!installed2) {
-      console.log(`  Failed to install ${dependency.name}`);
+      p3.log.warn(`Failed to install ${dependency.name}`);
       return false;
     }
   }
   const ready = hasPostgresRuntimeDependency(cwd) && hasDrizzleKitPostgresDriverDependency(cwd);
   if (ready) {
-    console.log("  Database push dependencies installed");
+    p3.log.success("Database push dependencies installed");
   } else {
     const unresolved = [
       !hasPostgresRuntimeDependency(cwd) ? POSTGRES_RUNTIME_DEP : null,
       !hasDrizzleKitPostgresDriverDependency(cwd) ? DRIZZLE_KIT_POSTGRES_DRIVER_DEP : null
     ].filter((dependency) => Boolean(dependency));
-    console.log(`  Installed dependencies but could not resolve ${unresolved.join(", ")}`);
+    p3.log.warn(`Installed dependencies but could not resolve ${unresolved.join(", ")}`);
   }
   return ready;
 }
@@ -1895,16 +1962,14 @@ async function runPostGenerate(cwd, schemaName, options = {}) {
   if (options.hasConflicts) {
     result.dbPush = "skipped";
     result.lintFix = "skipped";
-    console.log(
-      `
-  Database: skipped (resolve conflict markers in ${options.conflictPaths?.length ?? 0} file(s), then re-run)`
-    );
-    console.log("  Formatting: skipped (biome refuses files with conflict markers)");
-    for (const conflictPath of options.conflictPaths ?? []) {
-      console.log(`    - ${conflictPath}`);
-    }
-    console.log(
-      "\n  Resolve markers in the files above and re-run the BetterStart command that wrote them. Post-write tasks run automatically once every file is clean."
+    const lines = [
+      `Database: skipped (resolve conflict markers in ${options.conflictPaths?.length ?? 0} file(s), then re-run)`,
+      "Formatting: skipped (biome refuses files with conflict markers)",
+      ...(options.conflictPaths ?? []).map((conflictPath) => `  - ${conflictPath}`)
+    ];
+    p3.log.warn(lines.join("\n"));
+    p3.log.message(
+      "Resolve markers in the files above and re-run the BetterStart command that wrote them. Post-write tasks run automatically once every file is clean."
     );
     return result;
   }
@@ -1913,63 +1978,71 @@ async function runPostGenerate(cwd, schemaName, options = {}) {
     const dbUrl = process.env.DATABASE_URL;
     if (!dbUrl) {
       result.dbPush = "no-db-url";
-      console.log("\n  Database: skipped (no DATABASE_URL configured)");
-      console.log("    To sync later: run db:push after setting DATABASE_URL");
+      p3.log.warn(
+        [
+          "Database: skipped (no DATABASE_URL configured)",
+          "  To sync later: run db:push after setting DATABASE_URL"
+        ].join("\n")
+      );
     } else if (!ensureDatabasePushDependencies(cwd, pm)) {
       result.dbPush = "failed";
-      console.log(
-        "  Database push failed (install database dependencies and run drizzle-kit push manually)"
+      p3.log.warn(
+        "Database push failed (install database dependencies and run drizzle-kit push manually)"
       );
     } else if (hasPkgScript(cwd, "db:push")) {
-      console.log("\n  Running db:push...");
+      p3.log.info("Running db:push...");
       const ok = runPmScript(pm, "db:push", cwd);
       result.dbPush = ok ? "success" : "failed";
-      console.log(ok ? "  Database schema synced" : "  Database push failed (run db:push manually)");
+      if (ok) {
+        p3.log.success("Database schema synced");
+      } else {
+        p3.log.warn("Database push failed (run db:push manually)");
+      }
     } else {
-      console.log("\n  Running drizzle-kit push...");
+      p3.log.info("Running drizzle-kit push...");
       try {
         const pushResult = await runDrizzlePush(cwd, { interactive: true });
         if (!pushResult.success) {
           throw new Error(pushResult.error ?? "drizzle-kit push failed");
         }
         result.dbPush = "success";
-        console.log("  Database schema synced");
+        p3.log.success("Database schema synced");
       } catch {
         result.dbPush = "failed";
-        console.log("  Database push failed (run drizzle-kit push manually)");
+        p3.log.warn("Database push failed (run drizzle-kit push manually)");
       }
     }
   } else {
-    console.log(`
-  Database: skipped (${options.skipMigrationMessage ?? "--skip-migration"})`);
+    p3.log.info(`Database: skipped (${options.skipMigrationMessage ?? "--skip-migration"})`);
   }
   if (hasPkgScript(cwd, "lint:fix")) {
-    console.log("  Running lint:fix...");
+    p3.log.info("Running lint:fix...");
     const ok = runPmScript(pm, "lint:fix", cwd, BIOME_FORMAT_TIMEOUT_MS);
     result.lintFix = ok ? "success" : "failed";
-    console.log(ok ? "  Code formatted" : "  Lint fix had issues (run lint:fix manually)");
+    if (ok) {
+      p3.log.success("Code formatted");
+    } else {
+      p3.log.warn("Lint fix had issues (run lint:fix manually)");
+    }
   } else {
     try {
       if (!runBiomeCheckWrite(cwd)) {
         throw new Error("Biome binary not found");
       }
       result.lintFix = "success";
-      console.log("  Code formatted with Biome");
+      p3.log.success("Code formatted with Biome");
     } catch {
       result.lintFix = "failed";
-      console.log("  Biome formatting had issues (run biome check --write manually)");
+      p3.log.warn("Biome formatting had issues (run biome check --write manually)");
     }
   }
   if (options.showNextSteps !== false) {
     const schemaRoute = options.schemaRoutePath ?? `${options.adminRoutePath ?? "/admin"}/${schemaName}`;
-    console.log("\n  Next steps:");
-    console.log("    1. Review the generated files");
-    if (options.skipMigration || result.dbPush !== "success") {
-      console.log("    2. Run database migration: db:push");
-      console.log(`    3. Start the dev server and visit ${schemaRoute}`);
-    } else {
-      console.log(`    2. Start the dev server and visit ${schemaRoute}`);
-    }
+    printNextSteps({
+      reviewLabel: "the generated files",
+      needsMigration: Boolean(options.skipMigration) || result.dbPush !== "success",
+      route: schemaRoute
+    });
   }
   return result;
 }
@@ -1977,7 +2050,7 @@ async function runPostGenerate(cwd, schemaName, options = {}) {
 // adapters/next/integration-runtime.ts
 import fs14 from "fs";
 import path17 from "path";
-import * as p2 from "@clack/prompts";
+import * as p4 from "@clack/prompts";
 // core-engine/schema/schema-reader.ts
 import fs9 from "fs";
@@ -3303,12 +3376,12 @@ async function resolveTextEnvValue(options) {
   if (existingValue) {
     return existingValue;
   }
-  const result = await p2.text({
+  const result = await p4.text({
     message: options.message,
     defaultValue: options.defaultValue,
     validate: options.validate
   });
-  if (p2.isCancel(result)) {
+  if (p4.isCancel(result)) {
     throw new Error(options.cancelMessage);
   }
   options.overwriteEnvKeys.add(options.key);
@@ -3319,11 +3392,11 @@ async function resolvePasswordEnvValue(options) {
   if (existingValue) {
     return existingValue;
   }
-  const result = await p2.password({
+  const result = await p4.password({
     message: options.message,
     validate: options.validate
   });
-  if (p2.isCancel(result)) {
+  if (p4.isCancel(result)) {
     throw new Error(options.cancelMessage);
   }
   options.overwriteEnvKeys.add(options.key);
@@ -5704,14 +5777,14 @@ function buildStepsConstant(steps) {
 ${entries.join(",\n")}
 ]`;
 }
-function buildComponentSource(p27) {
+function buildComponentSource(p30) {
   const providerOpen = `    <NuqsAdapter>
       <React.Suspense fallback={null}>
-        <${p27.pascal}FormInner />
+        <${p30.pascal}FormInner />
       </React.Suspense>
     </NuqsAdapter>`;
   const exportWrapper = `
-export function ${p27.pascal}Form() {
+export function ${p30.pascal}Form() {
   return (
 ${providerOpen}
   )
@@ -5720,22 +5793,22 @@ ${providerOpen}
   return `'use client'
 import { standardSchemaResolver } from '@hookform/resolvers/standard-schema'
-import { ChevronLeft, ChevronRight${p27.hasListFields ? ", Trash2" : ""} } from 'lucide-react'
+import { ChevronLeft, ChevronRight${p30.hasListFields ? ", Trash2" : ""} } from 'lucide-react'
 import { createParser, useQueryState } from 'nuqs'
 import { NuqsAdapter } from 'nuqs/adapters/next/app'
 import * as React from 'react'
-${p27.rhfImport}
+${p30.rhfImport}
 import { z } from 'zod/v3'
-import { create${p27.pascal}Submission } from '@admin/actions/${p27.actionImportPath}'
+import { create${p30.pascal}Submission } from '@admin/actions/${p30.actionImportPath}'
 const formSchema = z.object({
-${p27.zodFields}
+${p30.zodFields}
 })
 type FormValues = z.infer<typeof formSchema>
 ${buildFieldErrorHelper()}
-${p27.stepsConst}
+${p30.stepsConst}
 const stepParser = createParser({
   parse(value) {
@@ -5753,7 +5826,7 @@ const stepParser = createParser({
   }
 }).withDefault(0)
-function ${p27.pascal}FormInner() {
+function ${p30.pascal}FormInner() {
   const [currentStep, setCurrentStep] = useQueryState('step', stepParser)
   const [submitted, setSubmitted] = React.useState(false)
   const [submitting, startSubmitTransition] = React.useTransition()
@@ -5761,11 +5834,11 @@ function ${p27.pascal}FormInner() {
   const form = useForm<FormValues>({
     resolver: standardSchemaResolver(formSchema),
     defaultValues: {
-${p27.defaults}
+${p30.defaults}
     },
   })
-${p27.fieldArraySetup}${p27.watchSetup}
+${p30.fieldArraySetup}${p30.watchSetup}
   async function handleNext() {
     const stepFields = STEPS[currentStep].fields as (keyof FormValues)[]
     const isValid = await form.trigger(stepFields, { shouldFocus: true })
@@ -5781,9 +5854,9 @@ ${p27.fieldArraySetup}${p27.watchSetup}
   function onSubmit(values: FormValues) {
     startSubmitTransition(async () => {
       try {
-        const result = await create${p27.pascal}Submission(values)
+        const result = await create${p30.pascal}Submission(values)
         if (result.success) {
-          ${p27.successHandler}
+          ${p30.successHandler}
         } else {
           form.setError('root', { message: result.error || 'Something went wrong' })
         }
@@ -5797,7 +5870,7 @@ ${p27.fieldArraySetup}${p27.watchSetup}
     return (
       <div className="rounded-sm border p-6 text-center">
         <h3 className="text-lg font-semibold">Thank you!</h3>
-        <p className="mt-2 text-muted-foreground">${p27.successMessage}</p>
+        <p className="mt-2 text-muted-foreground">${p30.successMessage}</p>
       </div>
     )
   }
@@ -5814,7 +5887,7 @@ ${p27.fieldArraySetup}${p27.watchSetup}
         {/* Step content */}
         <div key={currentStep} className="animate-in fade-in duration-300 space-y-6">
-${p27.stepContentBlocks}
+${p30.stepContentBlocks}
         </div>
         {form.formState.errors.root && (
@@ -5848,7 +5921,7 @@ ${p27.stepContentBlocks}
               onClick={() => form.handleSubmit(onSubmit)()}
               className="inline-flex h-9 items-center justify-center rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground shadow-xs transition-colors hover:bg-primary/90 disabled:pointer-events-none disabled:opacity-50"
             >
-              {submitting ? 'Submitting...' : ${p27.submitText}}
+              {submitting ? 'Submitting...' : ${p30.submitText}}
             </button>
           )}
         </div>
@@ -17672,7 +17745,7 @@ function readPresetTemplate(presetId, relativePath) {
 // adapters/next/snapshots/apply.ts
 import fs20 from "fs";
 import path24 from "path";
-import * as p3 from "@clack/prompts";
+import * as p5 from "@clack/prompts";
 // core-engine/snapshots/ast-substitution.ts
 import { Node, Project } from "ts-morph";
@@ -18339,7 +18412,7 @@ function isInteractiveSession(interactive) {
   return interactive && Boolean(process.stdin.isTTY) && process.env.CI !== "true";
 }
 async function promptNoBaseDecision(filePath) {
-  const answer = await p3.select({
+  const answer = await p5.select({
     message: `File already exists without snapshot base: ${filePath}`,
     options: [
       { value: "backup", label: "Backup and overwrite", hint: "recommended" },
@@ -18348,7 +18421,7 @@ async function promptNoBaseDecision(filePath) {
     ],
     initialValue: "backup"
   });
-  if (p3.isCancel(answer)) {
+  if (p5.isCancel(answer)) {
     throw new Error("Generation cancelled.");
   }
   return answer;
@@ -19218,43 +19291,40 @@ function listAvailablePresets() {
 // adapters/next/commands/add.ts
 function printAddNextSteps(installKind, hasSchemaChanges, result, adminRoutePath) {
-  console.log("\n  Next steps:");
-  console.log(`    1. Review the installed ${installKind} files`);
-  if (hasSchemaChanges && result.dbPush !== "success") {
-    console.log("    2. Run database migration: db:push");
-    console.log(`    3. Start the dev server and review ${adminRoutePath}`);
-    return;
-  }
-  console.log(`    2. Start the dev server and review ${adminRoutePath}`);
+  printNextSteps({
+    reviewLabel: `the installed ${installKind} files`,
+    needsMigration: hasSchemaChanges && result.dbPush !== "success",
+    route: adminRoutePath
+  });
 }
 async function runAddCommand(items, options) {
   const installIntegrationsMode = Boolean(options.integration);
   const presetIds = items.filter(isPresetId);
   const integrationIds = items.filter(isIntegrationId);
   if (!installIntegrationsMode && integrationIds.length > 0) {
-    p4.log.error(
+    p6.log.error(
       `Integration IDs require --integration. Run \`betterstart add --integration ${integrationIds.join(" ")}\`.`
     );
     process.exit(1);
   }
   if (installIntegrationsMode && presetIds.length > 0) {
-    p4.log.error(`Preset IDs cannot be installed with --integration: ${presetIds.join(", ")}`);
+    p6.log.error(`Preset IDs cannot be installed with --integration: ${presetIds.join(", ")}`);
     process.exit(1);
   }
   const invalidItems = installIntegrationsMode ? items.filter((integrationId) => !isIntegrationId(integrationId)) : items.filter((presetId) => !isPresetId(presetId));
   if (invalidItems.length > 0) {
-    p4.log.error(
+    p6.log.error(
       installIntegrationsMode ? formatUnknownIntegrationMessage(invalidItems) : formatUnknownPresetMessage(invalidItems)
     );
     process.exit(1);
   }
   const cwd = options.cwd ? path27.resolve(options.cwd) : process.cwd();
-  const config = await resolveConfig(cwd);
+  const config = await resolveConfigOrExit(cwd);
   const adminRoutePath = resolveAdminNamespace(config.frameworkConfig.next.namespace).routePath;
   const pm = detectPackageManager(cwd);
   const cliSyncResult = await syncProjectCliDependency(cwd, pm);
   if (cliSyncResult && !cliSyncResult.success) {
-    p4.log.error(cliSyncResult.error ?? "Failed to sync betterstart-cli");
+    p6.log.error(cliSyncResult.error ?? "Failed to sync betterstart-cli");
     process.exit(1);
   }
   if (installIntegrationsMode) {
@@ -19268,10 +19338,10 @@ async function runAddCommand(items, options) {
     });
     writeConfigFile(cwd, result2.config);
     if (result2.warnings.length > 0) {
-      p4.note(result2.warnings.join("\n"), "Warnings");
+      p6.note(result2.warnings.join("\n"), "Warnings");
     }
     if (result2.installed.length === 0 && result2.activated.length === 0 && result2.skipped.length > 0) {
-      p4.outro(`No changes made. Already installed: ${result2.skipped.join(", ")}`);
+      p6.outro(`No changes made. Already installed: ${result2.skipped.join(", ")}`);
       return;
     }
     const conflictPaths2 = scanConflictPaths(cwd);
@@ -19293,12 +19363,12 @@ async function runAddCommand(items, options) {
       result2.installed.length > 0 ? `Installed integration${result2.installed.length === 1 ? "" : "s"}: ${result2.installed.join(", ")}` : null,
       result2.activated.length > 0 ? `Activated integration${result2.activated.length === 1 ? "" : "s"}: ${result2.activated.join(", ")}` : null
     ].filter(Boolean);
-    p4.outro(messages.join("\n"));
+    p6.outro(messages.join("\n"));
     return;
   }
   const invalidPresets = items.filter((presetId) => !isPresetId(presetId));
   if (invalidPresets.length > 0) {
-    p4.log.error(formatUnknownPresetMessage(invalidPresets));
+    p6.log.error(formatUnknownPresetMessage(invalidPresets));
     process.exit(1);
   }
   const result = await installPresets({
@@ -19311,11 +19381,11 @@ async function runAddCommand(items, options) {
   });
   writeConfigFile(cwd, result.config);
   if (result.installed.length === 0 && result.skipped.length > 0) {
-    p4.outro(`No changes made. Already installed: ${result.skipped.join(", ")}`);
+    p6.outro(`No changes made. Already installed: ${result.skipped.join(", ")}`);
     return;
   }
   if (result.warnings.length > 0) {
-    p4.note(result.warnings.join("\n"), "Warnings");
+    p6.note(result.warnings.join("\n"), "Warnings");
   }
   const installedSchemaNames = result.installed.flatMap(
     (presetId) => getPresetDefinition(presetId).schemaFiles.map((schemaFile) => schemaFile.replace(/\.json$/, ""))
@@ -19332,14 +19402,14 @@ async function runAddCommand(items, options) {
   if (conflictPaths.length === 0) {
     printAddNextSteps("preset", hasSchemaChanges, postGenerateResult, adminRoutePath);
   }
-  p4.outro(
+  p6.outro(
     `Installed preset${result.installed.length === 1 ? "" : "s"}: ${result.installed.join(", ")}`
   );
 }
 // adapters/next/commands/add-field.ts
 import path30 from "path";
-import * as p8 from "@clack/prompts";
+import * as p10 from "@clack/prompts";
 // core-engine/schema/add-field.ts
 import fs23 from "fs";
@@ -19991,7 +20061,7 @@ function getTabFields(tab) {
 // adapters/next/commands/generate.ts
 import fs24 from "fs";
 import path29 from "path";
-import * as p6 from "@clack/prompts";
+import * as p8 from "@clack/prompts";
 // core-engine/snapshots/rename-detector.ts
 function levenshtein(a, b) {
@@ -20085,7 +20155,7 @@ function diffSchemas(before, after) {
 // core-engine/utils/spinner.ts
 import { stripVTControlCharacters } from "util";
-import * as p5 from "@clack/prompts";
+import * as p7 from "@clack/prompts";
 var RENDER_OVERHEAD = 7;
 var MIN_MESSAGE_WIDTH = 8;
 function fitSpinnerMessage(message) {
@@ -20132,7 +20202,7 @@ function hasActiveSpinner() {
   return activeSpinners > 0;
 }
 function spinner2(options) {
-  const inner = p5.spinner({ ...options, cancelMessage: "Setup cancelled." });
+  const inner = p7.spinner({ ...options, cancelMessage: "Setup cancelled." });
   const guided = options?.withGuide !== false;
   let started = false;
   const setStarted = (next) => {
@@ -20251,9 +20321,7 @@ function assertSnapshotStateOrExit(cwd) {
   if (snapshotRootExists(cwd)) {
     return;
   }
-  console.error(
-    "  Project state is unsupported or incomplete. Re-run `betterstart init --force` to create the current snapshot-backed layout."
-  );
+  p8.log.error(UNSUPPORTED_PROJECT_STATE_MESSAGE);
   process.exit(1);
 }
 function printSchemaDiff(scope, loaded, cwd) {
@@ -20266,35 +20334,36 @@ function printSchemaDiff(scope, loaded, cwd) {
   if (diff.added.length === 0 && diff.removed.length === 0 && diff.changed.length === 0 && diff.customComponents.added.length === 0 && diff.customComponents.removed.length === 0) {
     return;
   }
-  console.log(`  Schema diff for ${scope}:`);
+  const lines = [`Schema diff for ${scope}:`];
   if (diff.added.length > 0) {
-    console.log(`    + fields: ${diff.added.map((field) => field.name).join(", ")}`);
+    lines.push(`  + fields: ${diff.added.map((field) => field.name).join(", ")}`);
   }
   if (diff.removed.length > 0) {
-    console.log(`    - fields: ${diff.removed.map((field) => field.name).join(", ")}`);
+    lines.push(`  - fields: ${diff.removed.map((field) => field.name).join(", ")}`);
   }
   if (diff.changed.length > 0) {
-    console.log(
-      `    ~ fields: ${diff.changed.map((entry) => `${entry.before.name}:${entry.before.type}->${entry.after.type}`).join(", ")}`
+    lines.push(
+      `  ~ fields: ${diff.changed.map((entry) => `${entry.before.name}:${entry.before.type}->${entry.after.type}`).join(", ")}`
     );
   }
   if (renameCandidates.length > 0) {
-    console.log(
-      `    ? rename candidates: ${renameCandidates.map((entry) => `${entry.before}->${entry.after}`).join(", ")}`
+    lines.push(
+      `  ? rename candidates: ${renameCandidates.map((entry) => `${entry.before}->${entry.after}`).join(", ")}`
     );
   }
   if (diff.customComponents.added.length > 0 || diff.customComponents.removed.length > 0) {
-    console.log(
-      `    custom cells: +[${diff.customComponents.added.join(", ")}] -[${diff.customComponents.removed.join(", ")}]`
+    lines.push(
+      `  custom cells: +[${diff.customComponents.added.join(", ")}] -[${diff.customComponents.removed.join(", ")}]`
     );
   }
+  p8.log.message(lines.join("\n"));
 }
 async function promptConfirm(message) {
-  const result = await p6.confirm({
+  const result = await p8.confirm({
     message,
     initialValue: true
   });
-  if (p6.isCancel(result)) {
+  if (p8.isCancel(result)) {
     throw new Error("Generation cancelled.");
   }
   return Boolean(result);
@@ -20358,9 +20427,9 @@ function collectRenamePreview(cwd, remotePaths, plan) {
     }
     for (const change of result.previewChanges) {
       previewLines.push(
-        `    ${change.path}:${change.line}
-      - ${change.before || "(empty)"}
-      + ${change.after || "(empty)"}`
+        `  ${change.path}:${change.line}
+    - ${change.before || "(empty)"}
+    + ${change.after || "(empty)"}`
       );
     }
   }
@@ -20423,8 +20492,8 @@ async function maybeBuildRenamePlan(loaded, cwd, config, generatedFiles, options
     customCells: validatedCustomCells.renames
   };
   if (finalPlan.fields.length === 0 && finalPlan.customCells.length === 0) {
-    for (const warning of validatedCustomCells.warnings) {
-      console.warn(`  ${warning}`);
+    if (validatedCustomCells.warnings.length > 0) {
+      p8.log.warn(validatedCustomCells.warnings.join("\n"));
     }
     return void 0;
   }
@@ -20433,19 +20502,19 @@ async function maybeBuildRenamePlan(loaded, cwd, config, generatedFiles, options
     generatedFiles.map((file) => file.path),
     finalPlan
   );
-  console.log("  Proposed rename substitutions:");
-  for (const line of formatRenameSelectionSummary(finalPlan)) {
-    console.log(`    ${line}`);
-  }
+  const renameLines = [
+    "Proposed rename substitutions:",
+    ...formatRenameSelectionSummary(finalPlan).map((line) => `  ${line}`)
+  ];
   const previewLines = preview.previewLines.slice(0, 20);
-  for (const line of previewLines) {
-    console.log(line);
-  }
+  renameLines.push(...previewLines);
   if (preview.previewLines.length > previewLines.length) {
-    console.log(`    ... ${preview.previewLines.length - previewLines.length} more change(s)`);
+    renameLines.push(`  ... ${preview.previewLines.length - previewLines.length} more change(s)`);
   }
-  for (const warning of [...validatedCustomCells.warnings, ...preview.warnings]) {
-    console.warn(`  ${warning}`);
+  p8.log.message(renameLines.join("\n"));
+  const warnings = [...validatedCustomCells.warnings, ...preview.warnings];
+  if (warnings.length > 0) {
+    p8.log.warn(warnings.join("\n"));
   }
   const confirmed = await promptConfirm("Apply these rename substitutions before merge?");
   return confirmed ? finalPlan : void 0;
@@ -20525,37 +20594,38 @@ async function applyBarrels(cwd, config, options) {
   });
 }
 function printApplySummary(schemaName, summary) {
-  console.log(`  ${schemaName}:`);
+  const lines = [`${schemaName}:`];
   if (summary.tombstoneCleared) {
-    console.log(`    Tombstone cleared: ${summary.tombstoneCleared}`);
+    lines.push(`  Tombstone cleared: ${summary.tombstoneCleared}`);
   }
   if (summary.writtenFresh.length > 0) {
-    console.log(`    written fresh: ${summary.writtenFresh.length}`);
+    lines.push(`  written fresh: ${summary.writtenFresh.length}`);
   }
   if (summary.overwritten.length > 0) {
-    console.log(`    overwritten: ${summary.overwritten.length}`);
+    lines.push(`  overwritten: ${summary.overwritten.length}`);
   }
   if (summary.mergedCleanly.length > 0) {
-    console.log(`    merged cleanly: ${summary.mergedCleanly.length}`);
+    lines.push(`  merged cleanly: ${summary.mergedCleanly.length}`);
   }
   if (summary.acceptedGenerated.length > 0) {
-    console.log(`    accepted generated: ${summary.acceptedGenerated.length}`);
+    lines.push(`  accepted generated: ${summary.acceptedGenerated.length}`);
   }
   if (summary.conflictPaths.length > 0) {
-    console.log(`    with conflicts: ${summary.conflictPaths.length}`);
+    lines.push(`  with conflicts: ${summary.conflictPaths.length}`);
   }
   if (summary.orphanedDeleted.length > 0) {
-    console.log(`    orphaned deleted: ${summary.orphanedDeleted.length}`);
+    lines.push(`  orphaned deleted: ${summary.orphanedDeleted.length}`);
   }
   if (summary.orphanedKept.length > 0) {
-    console.log(`    orphaned kept: ${summary.orphanedKept.length}`);
+    lines.push(`  orphaned kept: ${summary.orphanedKept.length}`);
   }
   if (summary.skipped.length > 0) {
-    console.log(`    skipped: ${summary.skipped.join(", ")}`);
+    lines.push(`  skipped: ${summary.skipped.join(", ")}`);
   }
   if (summary.skippedCleared.length > 0) {
-    console.log(`    skip entries cleared: ${summary.skippedCleared.join(", ")}`);
+    lines.push(`  skip entries cleared: ${summary.skippedCleared.join(", ")}`);
   }
+  p8.log.message(lines.join("\n"));
 }
 async function runGenerateCommand(schemaName, options) {
   const cwd = options.cwd ? path29.resolve(options.cwd) : process.cwd();
@@ -20564,9 +20634,7 @@ async function runGenerateCommand(schemaName, options) {
   try {
     config = await resolveConfig(cwd);
   } catch (error) {
-    console.error(
-      `  Error loading config: ${error instanceof Error ? error.message : String(error)}`
-    );
+    p8.log.error(`Error loading config: ${error instanceof Error ? error.message : String(error)}`);
     process.exit(1);
   }
   assertSnapshotStateOrExit(cwd);
@@ -20576,9 +20644,7 @@ async function runGenerateCommand(schemaName, options) {
   if (options.all) {
     const schemaNames = listSchemaNames(schemasDir);
     if (schemaNames.length === 0) {
-      console.error(`
-  No schemas found in ${schemasDir}
-`);
+      p8.log.error(`No schemas found in ${schemasDir}`);
       process.exit(1);
     }
     const failed = [];
@@ -20586,16 +20652,14 @@ async function runGenerateCommand(schemaName, options) {
     const processedRoutes = [];
     let markdownDepsChecked = false;
     const adminRoutePath2 = resolveAdminNamespace(config.frameworkConfig.next.namespace).routePath;
-    console.log(`
-  BetterStart Generator \u2014 regenerating ${schemaNames.length} schema(s)
-`);
+    p8.intro(`BetterStart Generator \u2014 regenerating ${schemaNames.length} schema(s)`);
     for (const name of schemaNames) {
       if (hasTombstone(cwd, name)) {
         if (loadManifest(cwd, name)) {
           clearTombstone(cwd, name);
-          console.warn(`  - ${name}: tombstone cleared (manifest present)`);
+          p8.log.warn(`${name}: tombstone cleared (manifest present)`);
         } else {
-          console.log(`  - ${name}: skipped (tombstoned)`);
+          p8.log.message(`${name}: skipped (tombstoned)`);
           continue;
         }
       }
@@ -20621,7 +20685,7 @@ async function runGenerateCommand(schemaName, options) {
         processed.push(name);
         processedRoutes.push(getGeneratedSchemaRoutePath(loaded2, adminRoutePath2));
       } catch (error) {
-        console.error(`  \u2717 ${name}: ${error instanceof Error ? error.message : String(error)}`);
+        p8.log.error(`${name}: ${error instanceof Error ? error.message : String(error)}`);
         failed.push(name);
       }
     }
@@ -20644,15 +20708,14 @@ async function runGenerateCommand(schemaName, options) {
       });
     }
     if (failed.length > 0) {
-      console.error(`
-  Failed: ${failed.join(", ")}`);
+      p8.log.error(`Failed: ${failed.join(", ")}`);
       process.exit(1);
     }
-    console.log("");
+    p8.outro(`Regenerated ${processed.length}/${schemaNames.length} schema(s)`);
     return;
   }
   if (!schemaName) {
-    console.error("  Error: schema name is required (or use --all)");
+    p8.log.error("Error: schema name is required (or use --all)");
     process.exit(1);
   }
   let loaded;
@@ -20660,25 +20723,20 @@ async function runGenerateCommand(schemaName, options) {
     loaded = loadSchema(schemasDir, schemaName);
   } catch (error) {
     if (error instanceof SchemaNotFoundError) {
-      console.error(`  ${error.message}`);
+      p8.log.error(error.message);
     } else {
-      console.error(
-        `  Error loading schema: ${error instanceof Error ? error.message : String(error)}`
-      );
+      p8.log.error(`Error loading schema: ${error instanceof Error ? error.message : String(error)}`);
     }
     process.exit(1);
   }
   const validationErrors = validateLoadedSchema(loaded);
   if (validationErrors.length > 0) {
-    console.error("  Schema validation failed:");
-    for (const error of validationErrors) {
-      console.error(`    - ${error}`);
-    }
+    p8.log.error(
+      ["Schema validation failed:", ...validationErrors.map((error) => `  - ${error}`)].join("\n")
+    );
     process.exit(1);
   }
-  console.log(`
-  BetterStart Generator \u2014 ${loaded.schema.name}
-`);
+  p8.intro(`BetterStart Generator \u2014 ${loaded.schema.name}`);
   const needsMarkdownRenderer = schemaNeedsMarkdownRenderer(loaded);
   await ensureMarkdownRendererDependencies(cwd, needsMarkdownRenderer);
   const result = await applySchemaGeneration(loaded, cwd, config, {
@@ -20703,38 +20761,38 @@ async function runGenerateCommand(schemaName, options) {
     adminRoutePath,
     schemaRoutePath: getGeneratedSchemaRoutePath(loaded, adminRoutePath)
   });
-  console.log("");
+  p8.outro(`Generated ${loaded.schema.name}`);
 }
 // adapters/next/commands/schema-prompts.ts
-import * as p7 from "@clack/prompts";
+import * as p9 from "@clack/prompts";
 function isInteractiveSession3() {
   return Boolean(process.stdin.isTTY) && process.env.CI !== "true";
 }
 function fail(message) {
-  p7.log.error(message);
+  p9.log.error(message);
   process.exit(1);
 }
 function cancel2(context) {
-  p7.cancel(context.cancelMessage);
+  p9.cancel(context.cancelMessage);
   process.exit(0);
 }
 function cancelIfNeeded(context, value) {
-  if (p7.isCancel(value)) {
+  if (p9.isCancel(value)) {
     cancel2(context);
   }
   return value;
 }
 async function promptConfirm2(context, message, initialValue = true) {
-  const confirmed = await p7.confirm({ message, initialValue });
-  if (p7.isCancel(confirmed)) {
+  const confirmed = await p9.confirm({ message, initialValue });
+  if (p9.isCancel(confirmed)) {
     cancel2(context);
   }
   return Boolean(confirmed);
 }
 async function promptText(context, message, optionsOrDefaultValue) {
   const options = typeof optionsOrDefaultValue === "string" ? { defaultValue: optionsOrDefaultValue } : optionsOrDefaultValue ?? {};
-  const value = await p7.text({
+  const value = await p9.text({
     message,
     defaultValue: options.defaultValue,
     placeholder: options.placeholder,
@@ -20751,7 +20809,7 @@ async function promptText(context, message, optionsOrDefaultValue) {
   return String(cancelIfNeeded(context, value)).trim();
 }
 async function promptOptionalText(context, message) {
-  const value = await p7.text({
+  const value = await p9.text({
     message,
     placeholder: "Leave blank to skip"
   });
@@ -20759,7 +20817,7 @@ async function promptOptionalText(context, message) {
   return result || void 0;
 }
 async function promptSelectValue(context, message, options, initialValue) {
-  const value = await p7.select({
+  const value = await p9.select({
     message,
     options,
     initialValue
@@ -20978,7 +21036,7 @@ async function shouldPromptRequired(type) {
   return !["group", "section", "tabs", "separator"].includes(type);
 }
 async function promptFormFileOptions(context) {
-  const selected = await p7.multiselect({
+  const selected = await p9.multiselect({
     message: "Field options",
     options: [
       { value: "required", label: "Required field?" },
@@ -21017,7 +21075,7 @@ async function promptFieldOptions(context, kind, type, creatable) {
     try {
       return parseInteractiveOptionsList(value);
     } catch (error) {
-      p7.log.error(error instanceof Error ? error.message : String(error));
+      p9.log.error(error instanceof Error ? error.message : String(error));
     }
   }
 }
@@ -21135,7 +21193,7 @@ async function promptChildFields(context, kind, schemasDir, scope, fields, depth
     const addChild = fields.length === 0 ? await promptConfirm2(context, "Add a child field?", true) : await promptConfirm2(context, "Add another child field?", false);
     if (!addChild) {
       if (fields.length === 0) {
-        p7.log.warn("Containers need at least one child field.");
+        p9.log.warn("Containers need at least one child field.");
         continue;
       }
       return;
@@ -21160,7 +21218,7 @@ async function promptTabsField(context, kind, schemasDir, scope, name, label, de
     const addTab = field.tabs.length === 0 ? await promptConfirm2(context, "Add a tab?", true) : await promptConfirm2(context, "Add another tab?", false);
     if (!addTab) {
       if (field.tabs.length === 0) {
-        p7.log.warn("Tabs need at least one tab.");
+        p9.log.warn("Tabs need at least one tab.");
         continue;
       }
       return field;
@@ -21185,7 +21243,7 @@ async function promptTabsField(context, kind, schemasDir, scope, name, label, de
         const addChild = mainFields.length + sidebarFields.length === 0 ? await promptConfirm2(context, "Add a tab child field?", true) : await promptConfirm2(context, "Add another tab child field?", false);
         if (!addChild) {
           if (mainFields.length + sidebarFields.length === 0) {
-            p7.log.warn("Tabs need at least one child field.");
+            p9.log.warn("Tabs need at least one child field.");
             continue;
           }
           break;
@@ -21256,7 +21314,7 @@ async function applyAdvancedOptions(context, field, kind, type, options) {
       if (Number.isInteger(parsed) && parsed > 0) {
         record.length = parsed;
       } else {
-        p7.log.warn("Skipped invalid length.");
+        p9.log.warn("Skipped invalid length.");
       }
     }
   }
@@ -21414,11 +21472,11 @@ function hasNonInteractiveFieldOptions(options) {
   );
 }
 function fail2(message) {
-  p8.log.error(message);
+  p10.log.error(message);
   process.exit(1);
 }
 function cancel4(message = "Add field cancelled.") {
-  p8.cancel(message);
+  p10.cancel(message);
   process.exit(0);
 }
 function schemaNameFromLoaded(loaded) {
@@ -21523,7 +21581,7 @@ function printPreview(loaded, owner, firstTimeGeneration, insertion, options) {
   } else {
     lines.push("schema integration: none");
   }
-  p8.note(
+  p10.note(
     `${lines.join("\n")}
 ${stringifyProjectJson(insertion.field).trim()}`,
@@ -21556,7 +21614,7 @@ Re-run with --yes to confirm these warning cases.`);
     }
     return;
   }
-  p8.note(warnings.join("\n"), "Warnings");
+  p10.note(warnings.join("\n"), "Warnings");
   const confirmed = await promptConfirm3("Continue with these warnings?", true);
   if (!confirmed) {
     cancel4();
@@ -21617,11 +21675,9 @@ async function runAddFieldCommand(schemaName, options) {
   const cwd = options.cwd ? path30.resolve(options.cwd) : process.cwd();
   const nonInteractive = hasNonInteractiveFieldOptions(options);
   if (!snapshotRootExists(cwd)) {
-    fail2(
-      "Project state is unsupported or incomplete. Re-run `betterstart init --force` to create the current snapshot-backed layout."
-    );
+    fail2(UNSUPPORTED_PROJECT_STATE_MESSAGE);
   }
-  const config = await resolveConfig(cwd);
+  const config = await resolveConfigOrExit(cwd);
   const paths = resolveProjectPaths(config);
   const schemasDir = path30.join(cwd, ...paths.schemasDir.split("/"));
   const selectedSchemaName = await resolveSchemaNameInteractively(schemasDir, schemaName);
@@ -21675,7 +21731,7 @@ ${validationErrors.map((error) => `  - ${error}`).join("\n")}`
     }
   }
   writeAuthoredGeneratedSchema(loaded);
-  p8.log.success(`Updated ${path30.relative(cwd, loaded.filePath)}`);
+  p10.log.success(`Updated ${path30.relative(cwd, loaded.filePath)}`);
   try {
     await runGenerateCommand(selectedSchemaName, {
       force: false,
@@ -21686,8 +21742,8 @@ ${validationErrors.map((error) => `  - ${error}`).join("\n")}`
       cwd
     });
   } catch (error) {
-    p8.log.error(error instanceof Error ? error.message : String(error));
-    p8.log.info(
+    p10.log.error(error instanceof Error ? error.message : String(error));
+    p10.log.info(
       `Schema JSON was kept. Re-run \`betterstart generate ${selectedSchemaName}${options.skipMigration ? " --skip-migration" : ""}\` after resolving the issue.`
     );
     process.exit(1);
@@ -21697,7 +21753,7 @@ ${validationErrors.map((error) => `  - ${error}`).join("\n")}`
 // adapters/next/commands/create.ts
 import fs25 from "fs";
 import path31 from "path";
-import * as p9 from "@clack/prompts";
+import * as p11 from "@clack/prompts";
 var CREATE_PROMPT_CONTEXT = {
   cancelMessage: "Create schema cancelled."
 };
@@ -21888,7 +21944,7 @@ async function promptTabSlotFields(kind, schemasDir, titleField) {
     );
     if (!addField) {
       if (!hasFields) {
-        p9.log.warn("Tabs need at least one child field.");
+        p11.log.warn("Tabs need at least one child field.");
         continue;
       }
       return { main, sidebar };
@@ -21936,7 +21992,7 @@ async function promptSchemaTab(kind, schemasDir, titleField, existingTabs) {
       while (fields.length === 0) {
         await promptAdditionalSchemaFields(kind, schemasDir, fields);
         if (fields.length === 0) {
-          p9.log.warn("Tabs need at least one child field.");
+          p11.log.warn("Tabs need at least one child field.");
         }
       }
     }
@@ -22026,7 +22082,7 @@ async function promptFormSubmissionColumns(schema) {
   }
   const existingColumnNames = schema.columns ? new Set(schema.columns.map((column) => column.accessorKey)) : void 0;
   const initialValues = existingColumnNames ? fields.filter((field) => existingColumnNames.has(field.name)).map((field) => field.name) : fields.map((field) => field.name);
-  const selected = await p9.multiselect({
+  const selected = await p11.multiselect({
     message: "Submission table columns",
     options: fields.map((field) => ({
       value: field.name,
@@ -22035,7 +22091,7 @@ async function promptFormSubmissionColumns(schema) {
     initialValues,
     required: false
   });
-  if (p9.isCancel(selected)) {
+  if (p11.isCancel(selected)) {
     cancel2(CREATE_PROMPT_CONTEXT);
   }
   const selectedNames = new Set(selected);
@@ -22095,7 +22151,7 @@ function schemaFilePath(kind, schemasDir, schemaName) {
   return kind === "form" ? path31.join(schemasDir, "forms", `${schemaName}.json`) : path31.join(schemasDir, `${schemaName}.json`);
 }
 function printPreview2(loaded, cwd) {
-  p9.note(
+  p11.note(
     `schema: ${loaded.name} (${loaded.kind})
 path: ${path31.relative(cwd, loaded.filePath)}
 owner: user
@@ -22108,14 +22164,12 @@ async function runCreateCommand(kindInput, schemaName, options) {
   const kind = normalizeKind(kindInput);
   const cwd = options.cwd ? path31.resolve(options.cwd) : process.cwd();
   if (!snapshotRootExists(cwd)) {
-    fail(
-      "Project state is unsupported or incomplete. Re-run `betterstart init --force` to create the current snapshot-backed layout."
-    );
+    fail(UNSUPPORTED_PROJECT_STATE_MESSAGE);
   }
   if (!isInteractiveSession3()) {
     fail("Interactive create requires a TTY.");
   }
-  const config = await resolveConfig(cwd);
+  const config = await resolveConfigOrExit(cwd);
   const paths = resolveProjectPaths(config);
   const schemasDir = path31.join(cwd, ...paths.schemasDir.split("/"));
   const metadata = await promptMetadata(kind, schemaName, schemasDir);
@@ -22150,7 +22204,7 @@ ${validationErrors.map((error) => `  - ${error}`).join("\n")}`
   }
   fs25.mkdirSync(path31.dirname(filePath), { recursive: true });
   writeAuthoredGeneratedSchema(loaded);
-  p9.log.success(`Created ${path31.relative(cwd, filePath)}`);
+  p11.log.success(`Created ${path31.relative(cwd, filePath)}`);
   try {
     await runGenerateCommand(metadata.name, {
       force: false,
@@ -22161,8 +22215,8 @@ ${validationErrors.map((error) => `  - ${error}`).join("\n")}`
       cwd
     });
   } catch (error) {
-    p9.log.error(error instanceof Error ? error.message : String(error));
-    p9.log.info(
+    p11.log.error(error instanceof Error ? error.message : String(error));
+    p11.log.info(
       `Schema JSON was kept. Re-run \`betterstart generate ${metadata.name}${options.skipMigration ? " --skip-migration" : ""}\` after resolving the issue.`
     );
     process.exit(1);
@@ -22174,14 +22228,14 @@ import { execFileSync as execFileSync5, spawn as spawn6 } from "child_process";
 import fs41 from "fs";
 import path52 from "path";
 import { PassThrough } from "stream";
-import * as p22 from "@clack/prompts";
+import * as p24 from "@clack/prompts";
 // core-engine/utils/cancel-guard.ts
-import * as p10 from "@clack/prompts";
+import * as p12 from "@clack/prompts";
 function installSetupCancelGuard() {
   const onSignal = () => {
     if (!hasActiveSpinner()) {
-      p10.cancel("Setup cancelled.");
+      p12.cancel("Setup cancelled.");
     }
     process.exit(0);
   };
@@ -22193,6 +22247,15 @@ function installSetupCancelGuard() {
   };
 }
+// core-engine/utils/json-mode.ts
+function redirectStdoutToStderr() {
+  const originalWrite = process.stdout.write.bind(process.stdout);
+  process.stdout.write = ((chunk, encodingOrCallback, callback) => typeof encodingOrCallback === "function" ? process.stderr.write(chunk, encodingOrCallback) : process.stderr.write(chunk, encodingOrCallback, callback));
+  return () => {
+    process.stdout.write = originalWrite;
+  };
+}
 // core-engine/utils/prompt-theme.ts
 var GREEN_STEP_SUBMIT = "\x1B[32m\u25C7\x1B[39m";
 var GREEN_CHECK = "\x1B[32m\u2713\x1B[39m";
@@ -22216,18 +22279,27 @@ function installPromptCheckmarks() {
   };
 }
+// core-engine/utils/redact.ts
+var REDACTED = "[redacted]";
+function redactSecrets(text7) {
+  return text7.replace(/(\b[a-z][a-z0-9+.-]*:\/\/[^\s:@/]+:)[^\s@]+@/gi, `$1${REDACTED}@`).replace(/\b(bearer\s+)[a-z0-9._~+/=-]+/gi, `$1${REDACTED}`).replace(
+    /(\b[\w-]*(?:token|secret|password|passwd|api[-_]?key|apikey)[\w-]*\s*[=:]\s*)(["']?)[^\s"']{4,}\2/gi,
+    `$1$2${REDACTED}$2`
+  );
+}
 // adapters/next/init/prompts/database.ts
 import { execFileSync as execFileSync4 } from "child_process";
-import * as p11 from "@clack/prompts";
+import * as p13 from "@clack/prompts";
 import pc from "picocolors";
 var VERCEL_NEON_URL = "https://vercel.com/dashboard/integrations/checkout/neon";
 async function promptServices() {
-  const choice = await p11.select({
+  const choice = await p13.select({
     message: "Connect a PostgreSQL Database",
     options: [
       {
         value: "vercel",
-        label: "Vercel (Neon Postgress)",
+        label: "Vercel (Neon Postgres)",
         hint: "Automatically provision a Neon Postgres database"
       },
       {
@@ -22243,8 +22315,8 @@ async function promptServices() {
     ],
     initialValue: "vercel"
   });
-  if (p11.isCancel(choice)) {
-    p11.cancel("Setup cancelled.");
+  if (p13.isCancel(choice)) {
+    p13.cancel("Setup cancelled.");
     process.exit(0);
   }
   if (choice === "vercel") {
@@ -22258,7 +22330,7 @@ async function promptServices() {
 }
 function openBrowserVercelNeon() {
   openBrowser(VERCEL_NEON_URL);
-  p11.log.info(
+  p13.log.info(
     `Opening Vercel... Create a Neon Postgres database, then copy the ${pc.cyan("DATABASE_URL")} from the dashboard.`
   );
 }
@@ -22268,12 +22340,12 @@ function openBrowserVercelNeonResource(url) {
     return;
   }
   openBrowser(url);
-  p11.log.info(
+  p13.log.info(
     `Opening Vercel... Copy the Neon ${pc.cyan("DATABASE_URL")} from the database dashboard, then paste it below.`
   );
 }
 async function promptConnectionString() {
-  const input = await p11.text({
+  const input = await p13.text({
     message: "Paste your PostgreSQL connection string",
     placeholder: "postgres://user:pass@host/db",
     validate(val) {
@@ -22287,8 +22359,8 @@ async function promptConnectionString() {
       }
     }
   });
-  if (p11.isCancel(input)) {
-    p11.cancel("Setup cancelled.");
+  if (p13.isCancel(input)) {
+    p13.cancel("Setup cancelled.");
     process.exit(0);
   }
   return input.replace(/^['"]|['"]$/g, "").trim();
@@ -22308,8 +22380,7 @@ function openBrowser(url) {
 }
 // adapters/next/init/prompts/presets.ts
-import { styleText } from "util";
-import * as p12 from "@clack/prompts";
+import * as p14 from "@clack/prompts";
 // adapters/next/init/scaffolders/env.ts
 import crypto2 from "crypto";
@@ -22459,6 +22530,7 @@ function scaffoldEnv(cwd, options) {
 }
 // adapters/next/init/prompts/presets.ts
+import pc2 from "picocolors";
 function maskBlobToken(token) {
   const match = /^(vercel_blob_rw_[A-Za-z0-9]+)_/.exec(token);
   if (match) return `${match[1]}_***`;
@@ -22473,7 +22545,7 @@ async function promptPresets(cwd, options = {}) {
       overwriteKeys.add(key);
     }
   };
-  const storage = await p12.select({
+  const storage = await p14.select({
     message: "Choose a file storage",
     options: [
       {
@@ -22492,13 +22564,13 @@ async function promptPresets(cwd, options = {}) {
       {
         value: "local",
         label: "Local filesystem (public/media)",
-        hint: "\u26A0 For testing only"
+        hint: "\u25B2 For testing only"
       }
     ],
     initialValue: "vercel-blob"
   });
-  if (p12.isCancel(storage)) {
-    p12.cancel("Setup cancelled.");
+  if (p14.isCancel(storage)) {
+    p14.cancel("Setup cancelled.");
     process.exit(0);
   }
   if (storage === "r2") {
@@ -22508,7 +22580,7 @@ async function promptPresets(cwd, options = {}) {
     if (flow?.ok && flow.config) {
       mergeIntegrationConfig(flow.config);
     } else if (flow) {
-      p12.log.warn(
+      p14.log.warn(
         "Continuing without Railway bucket credentials \u2014 rerun betterstart add --integration railway-bucket after fixing Railway access."
       );
     } else {
@@ -22525,7 +22597,7 @@ async function promptPresets(cwd, options = {}) {
       });
       overwriteKeys.add("BLOB_READ_WRITE_TOKEN");
     } else if (flow) {
-      p12.log.warn(
+      p14.log.warn(
         "Continuing without a Blob token \u2014 add BLOB_READ_WRITE_TOKEN to .env.local from the store on vercel.com/dashboard/stores."
       );
       sections.push({
@@ -22534,9 +22606,8 @@ async function promptPresets(cwd, options = {}) {
       });
     } else {
       if (existingToken) {
-        p12.log.info(
-          `Using the existing BLOB_READ_WRITE_TOKEN from .env.local ${styleText(
-            "dim",
+        p14.log.info(
+          `Using the existing BLOB_READ_WRITE_TOKEN from .env.local ${pc2.dim(
             `(${maskBlobToken(existingToken)})`
           )}`
         );
@@ -22544,7 +22615,7 @@ async function promptPresets(cwd, options = {}) {
       mergeIntegrationConfig(await collectIntegrationConfig(cwd, ["vercel-blob"]));
     }
   }
-  const selectedPresets = await p12.multiselect({
+  const selectedPresets = await p14.multiselect({
     message: "Select presets",
     options: [
       {
@@ -22556,8 +22627,8 @@ async function promptPresets(cwd, options = {}) {
     required: false,
     initialValues: ["blog"]
   });
-  if (p12.isCancel(selectedPresets)) {
-    p12.cancel("Setup cancelled.");
+  if (p14.isCancel(selectedPresets)) {
+    p14.cancel("Setup cancelled.");
     process.exit(0);
   }
   const integrations = [];
@@ -22584,9 +22655,9 @@ async function promptPresets(cwd, options = {}) {
 }
 // adapters/next/init/prompts/project.ts
-import * as p13 from "@clack/prompts";
+import * as p15 from "@clack/prompts";
 async function promptProject(defaultName) {
-  const projectName = await p13.text({
+  const projectName = await p15.text({
     message: "What is your project named?",
     placeholder: defaultName ?? "(Press Enter to use default)",
     defaultValue: defaultName ?? ".",
@@ -22599,15 +22670,15 @@ async function promptProject(defaultName) {
       return void 0;
     }
   });
-  if (p13.isCancel(projectName)) {
-    p13.cancel("Setup cancelled.");
+  if (p15.isCancel(projectName)) {
+    p15.cancel("Setup cancelled.");
     process.exit(0);
   }
   return { projectName: projectName.trim() || "." };
 }
 // adapters/next/init/providers.ts
-import * as p14 from "@clack/prompts";
+import * as p16 from "@clack/prompts";
 var DATABASE_PROVIDERS = ["vercel", "railway", "manual"];
 var STORAGE_PROVIDERS = ["vercel-blob", "railway-bucket", "r2", "local"];
 var DEPLOY_PROVIDERS = ["vercel", "railway", "none"];
@@ -22664,7 +22735,7 @@ function validateResolvedDatabaseProvider(provider, options) {
   }
 }
 async function promptDeployProvider(initialValue = "none") {
-  const provider = await p14.select({
+  const provider = await p16.select({
     message: "Deploy this project",
     options: [
       {
@@ -22682,8 +22753,8 @@ async function promptDeployProvider(initialValue = "none") {
     ],
     initialValue
   });
-  if (p14.isCancel(provider)) {
-    p14.cancel("Setup cancelled.");
+  if (p16.isCancel(provider)) {
+    p16.cancel("Setup cancelled.");
     process.exit(0);
   }
   return provider;
@@ -22692,7 +22763,7 @@ async function promptDeployProvider(initialValue = "none") {
 // adapters/next/init/railway/deploy.ts
 import fs28 from "fs";
 import path34 from "path";
-import * as p16 from "@clack/prompts";
+import * as p18 from "@clack/prompts";
 // adapters/next/init/deploy/guard.ts
 import { spawn as spawn3 } from "child_process";
@@ -22789,7 +22860,7 @@ function guardBetterstartConfig(cwd, restores) {
 }
 // adapters/next/init/railway/project.ts
-import * as p15 from "@clack/prompts";
+import * as p17 from "@clack/prompts";
 // adapters/next/init/railway/runner.ts
 import { spawn as spawn4 } from "child_process";
@@ -22930,7 +23001,7 @@ function railwayOutputTail(output, maxLines = 20) {
 }
 // adapters/next/init/railway/project.ts
-import pc2 from "picocolors";
+import pc3 from "picocolors";
 function isString(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
@@ -23073,22 +23144,22 @@ async function ensureRailwayProject(runner, options) {
         createWorkspace = options.workspaces[0]?.id;
       } else if (!createWorkspace && options.interactive && options.workspaces?.length) {
         projectSpinner.clear();
-        const workspace = await p15.select({
+        const workspace = await p17.select({
           message: "Choose a Railway workspace",
           options: options.workspaces.map((candidate) => ({
             value: candidate.id,
             label: candidate.name
           }))
         });
-        if (p15.isCancel(workspace)) {
-          p15.cancel("Setup cancelled.");
+        if (p17.isCancel(workspace)) {
+          p17.cancel("Setup cancelled.");
           process.exit(0);
         }
         createWorkspace = workspace;
         projectSpinner.start("Checking Railway project names");
       }
       const projects = await listRailwayProjects(runner, options.cwd, options.env);
-      projectSpinner.message(`Creating Railway project ${pc2.cyan(options.projectName)}`);
+      projectSpinner.message(`Creating Railway project ${pc3.cyan(options.projectName)}`);
       const created = await createRailwayProject(
         runner,
         options.cwd,
@@ -23368,7 +23439,7 @@ ${credentialsResult.stderr}`) ?? `Could not retrieve credentials for Railway buc
 }
 // adapters/next/init/railway/deploy.ts
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 var DEPLOY_TIMEOUT_MS = 9e5;
 var ENV_TIMEOUT_MS = 3e4;
 var ENV_SYNC_SKIP_KEYS = /* @__PURE__ */ new Set([
@@ -23607,7 +23678,7 @@ async function runRailwayDeployFlow(options) {
     );
     envSpinner.clear();
     for (const key of sync.failed) {
-      p16.log.warn(`Could not set ${pc3.cyan(key)} on Railway.`);
+      p18.log.warn(`Could not set ${pc4.cyan(key)} on Railway.`);
     }
     if (sync.failed.length > 0) {
       return {
@@ -23622,13 +23693,13 @@ async function runRailwayDeployFlow(options) {
     const packageGuard = await guardProjectForDeploy(options.cwd);
     guardSpinner.clear();
     if (packageGuard.lockfile === "failed") {
-      p16.log.warn(
+      p18.log.warn(
         "Could not refresh pnpm-lock.yaml after removing betterstart-cli \u2014 the remote install may fail."
       );
     }
     for (const dependency of packageGuard.localSpecDeps) {
-      p16.log.warn(
-        `Dependency ${pc3.cyan(dependency)} uses a local spec that cannot install on Railway.`
+      p18.log.warn(
+        `Dependency ${pc4.cyan(dependency)} uses a local spec that cannot install on Railway.`
       );
     }
     const deploySpinner = spinner2();
@@ -23662,7 +23733,7 @@ async function runRailwayDeployFlow(options) {
       packageGuard.restore();
     }
     if (!deploy.success) {
-      deploySpinner.stop(`${pc3.yellow("\u25B2")} Railway deploy did not complete`);
+      deploySpinner.stop(`${pc4.yellow("\u25B2")} Railway deploy did not complete`);
       const logs = await readFailedDeploymentLogs(options.session, options.cwd, service);
       return {
         ok: false,
@@ -23672,7 +23743,7 @@ async function runRailwayDeployFlow(options) {
 ${deploy.stderr}`) ?? deploy.errorMessage
       };
     }
-    deploySpinner.stop(url ? `Deployed ${pc3.cyan(url)}` : "Deployed to Railway");
+    deploySpinner.stop(url ? `Deployed ${pc4.cyan(url)}` : "Deployed to Railway");
     return { ok: true, url, service, syncedEnvKeys: sync.synced };
   } catch (error) {
     return { ok: false, detail: error instanceof Error ? error.message : String(error) };
@@ -23680,8 +23751,8 @@ ${deploy.stderr}`) ?? deploy.errorMessage
 }
 // adapters/next/init/railway/auth.ts
-import * as p17 from "@clack/prompts";
-import pc4 from "picocolors";
+import * as p19 from "@clack/prompts";
+import pc5 from "picocolors";
 var WHOAMI_TIMEOUT_MS = 3e4;
 var LOGIN_TIMEOUT_MS = 3e5;
 function isRailwayAccount(value) {
@@ -23732,7 +23803,7 @@ async function ensureRailwayAuth(runner, cwd, options) {
       checkSpinner.clear();
     } else {
       checkSpinner.stop(
-        existing.account?.email ? `Signed in to Railway as ${pc4.cyan(existing.account.email)}` : "Signed in to Railway"
+        existing.account?.email ? `Signed in to Railway as ${pc5.cyan(existing.account.email)}` : "Signed in to Railway"
       );
     }
     return existing;
@@ -23750,7 +23821,7 @@ async function ensureRailwayAuth(runner, cwd, options) {
     return { authed: false, reason: existing.reason };
   }
   checkSpinner.clear();
-  p17.log.info(
+  p19.log.info(
     "Sign in to Railway to continue. Railway will open your browser or show a device code."
   );
   const login = await runRailway(runner, ["login"], {
@@ -23767,7 +23838,7 @@ async function ensureRailwayAuth(runner, cwd, options) {
   const verified = await checkRailwayAuth(runner, cwd, env);
   if (verified.authed) {
     verifySpinner.stop(
-      verified.account?.email ? `Signed in to Railway as ${pc4.cyan(verified.account.email)}` : "Signed in to Railway"
+      verified.account?.email ? `Signed in to Railway as ${pc5.cyan(verified.account.email)}` : "Signed in to Railway"
     );
     return verified;
   }
@@ -25637,12 +25708,12 @@ function scaffoldTsconfig(cwd, config) {
 }
 // adapters/next/init/vercel/flow.ts
-import * as p21 from "@clack/prompts";
-import pc8 from "picocolors";
+import * as p23 from "@clack/prompts";
+import pc9 from "picocolors";
 // adapters/next/init/vercel/auth.ts
-import * as p18 from "@clack/prompts";
-import pc5 from "picocolors";
+import * as p20 from "@clack/prompts";
+import pc6 from "picocolors";
 // adapters/next/init/vercel/runner.ts
 import { spawn as spawn5 } from "child_process";
@@ -25883,9 +25954,9 @@ async function ensureVercelAuth(runner, cwd, options) {
     return { authed: false, reason: existing.reason };
   }
   checkSpinner.clear();
-  const signInMessage = `Sign in to Vercel to continue ${pc5.dim("(or press Ctrl-C to enter a connection string manually)")}`;
+  const signInMessage = `Sign in to Vercel to continue ${pc6.dim("(or press Ctrl-C to enter a connection string manually)")}`;
   const signInRows = clackLogRows(signInMessage);
-  p18.log.info(signInMessage);
+  p20.log.info(signInMessage);
   let streamedRows = 0;
   const login = await runVercel(runner, ["login"], {
     cwd,
@@ -25913,12 +25984,12 @@ async function ensureVercelAuth(runner, cwd, options) {
   return { authed: false, reason: "login-failed" };
 }
 function signedInMessage(username) {
-  return username ? `Signed in to Vercel as ${pc5.cyan(username)}` : "Signed in to Vercel";
+  return username ? `Signed in to Vercel as ${pc6.cyan(username)}` : "Signed in to Vercel";
 }
 // adapters/next/init/vercel/blob.ts
-import * as p19 from "@clack/prompts";
-import pc6 from "picocolors";
+import * as p21 from "@clack/prompts";
+import pc7 from "picocolors";
 // adapters/next/init/vercel/env-pull.ts
 import fs36 from "fs";
@@ -26159,8 +26230,8 @@ async function provisionBlobStoreInteractive(runner, cwd, options) {
     if (terminalFallbackRan) break;
     terminalFallbackRan = true;
     quietSpinner.clear();
-    p19.log.info(
-      `Create your Blob store in the Vercel prompts below ${pc6.dim(
+    p21.log.info(
+      `Create your Blob store in the Vercel prompts below ${pc7.dim(
         "(connect it to all environments)."
       )}`
     );
@@ -26358,8 +26429,8 @@ function guardEnvLocal(cwd) {
 }
 // adapters/next/init/vercel/neon.ts
-import * as p20 from "@clack/prompts";
-import pc7 from "picocolors";
+import * as p22 from "@clack/prompts";
+import pc8 from "picocolors";
 var PROVISION_TIMEOUT_MS2 = 18e4;
 var INTERACTIVE_PROVISION_TIMEOUT_MS2 = 6e5;
 var ACCEPT_TERMS_URL_PATTERN = /https:\/\/vercel\.com\/\S+\/integrations\/accept-terms\/\S+/i;
@@ -26377,7 +26448,7 @@ async function provisionNeonInteractive(runner, cwd, options) {
     termsResolved = true;
     quietSpinner.clear();
     eraseRows(termsNotice.rows);
-    p20.log.step(termsNotice.text);
+    p22.log.step(termsNotice.text);
   };
   const quiet = await runVercel(runner, neonAddArgs(options), {
     cwd,
@@ -26392,11 +26463,11 @@ async function provisionNeonInteractive(runner, cwd, options) {
         const message = "Please accept the Neon terms in your browser";
         termsNotice = {
           text: `${message}
-${pc7.dim(termsUrl)}`,
+${pc8.dim(termsUrl)}`,
           rows: clackLogRows(message) + clackLogRows(termsUrl) - 1
         };
         quietSpinner.clear();
-        p20.log.info(termsNotice.text);
+        p22.log.info(termsNotice.text);
         quietSpinner.start("Waiting for the terms to be accepted");
         return;
       }
@@ -26412,8 +26483,8 @@ ${pc7.dim(termsUrl)}`,
     return readNeonProvisionInfo(quiet.stdout);
   }
   quietSpinner.clear();
-  p20.log.info(
-    `Create your Neon database in the Vercel prompts below ${pc7.dim(
+  p22.log.info(
+    `Create your Neon database in the Vercel prompts below ${pc8.dim(
       "(the Free plan is recommended)."
     )}`
   );
@@ -26489,14 +26560,14 @@ async function runVercelNeonFlow(options) {
       allowLogin: options.interactive
     });
     if (!auth.authed) {
-      p21.log.warn(authFailureMessage(auth.reason));
+      p23.log.warn(authFailureMessage(auth.reason));
       return { ok: false };
     }
     await ensureLinkedProject(runner, options.cwd, options.projectName, env, auth.username);
     const neon = await provisionNeonForMode(runner, options);
     if (neon.failure) {
-      p21.log.warn(neonFailureMessage(neon.failure));
-      if (neon.detail) p21.log.message(pc8.dim(neon.detail));
+      p23.log.warn(neonFailureMessage(neon.failure));
+      if (neon.detail) p23.log.message(pc9.dim(redactSecrets(neon.detail)));
       return { ok: false };
     }
     const databaseUrl = await pullNeonDatabaseUrl(runner, options.cwd, env);
@@ -26509,7 +26580,7 @@ async function runVercelNeonFlow(options) {
       dismissSignedInNote
     };
   } catch (error) {
-    p21.log.warn(
+    p23.log.warn(
       `Vercel provisioning failed: ${error instanceof Error ? error.message : String(error)}`
     );
     return { ok: false };
@@ -26531,14 +26602,14 @@ async function runVercelBlobFlow(options) {
       allowLogin: options.interactive
     });
     if (!auth.authed) {
-      p21.log.warn(authFailureMessage(auth.reason));
+      p23.log.warn(authFailureMessage(auth.reason));
       return { ok: false };
     }
     await ensureLinkedProject(runner, options.cwd, options.projectName, env, auth.username);
     const blob = await provisionBlobForMode(runner, options);
     if (blob.failure || !blob.token) {
-      p21.log.warn(blobFailureMessage(blob.failure));
-      if (blob.detail) p21.log.message(pc8.dim(blob.detail));
+      p23.log.warn(blobFailureMessage(blob.failure));
+      if (blob.detail) p23.log.message(pc9.dim(redactSecrets(blob.detail)));
       return { ok: false };
     }
     return {
@@ -26547,7 +26618,7 @@ async function runVercelBlobFlow(options) {
       blobStoreName: blob.storeName
     };
   } catch (error) {
-    p21.log.warn(
+    p23.log.warn(
       `Vercel provisioning failed: ${error instanceof Error ? error.message : String(error)}`
     );
     return { ok: false };
@@ -26569,7 +26640,7 @@ async function runVercelDeployFlow(options) {
       allowLogin: options.interactive ?? true
     });
     if (!auth.authed) {
-      p21.log.warn(authFailureMessage(auth.reason));
+      p23.log.warn(authFailureMessage(auth.reason));
       printManualDeployHint();
       return { ok: false };
     }
@@ -26579,8 +26650,8 @@ async function runVercelDeployFlow(options) {
     const sync = await syncVercelProductionEnv(runner, options.cwd, env);
     envSpinner.clear();
     for (const key of sync.failed) {
-      p21.log.warn(
-        `Could not set ${pc8.cyan(key)} on Vercel \u2014 add it in the project's environment settings.`
+      p23.log.warn(
+        `Could not set ${pc9.cyan(key)} on Vercel \u2014 add it in the project's environment settings.`
       );
     }
     ensureVercelJsonFramework(options.cwd);
@@ -26589,13 +26660,13 @@ async function runVercelDeployFlow(options) {
     const packageGuard = await guardProjectForDeploy(options.cwd);
     guardSpinner.clear();
     if (packageGuard.lockfile === "failed") {
-      p21.log.warn(
+      p23.log.warn(
         "Could not refresh pnpm-lock.yaml after removing betterstart-cli \u2014 the remote install may fail."
       );
     }
     for (const dep of packageGuard.localSpecDeps) {
-      p21.log.warn(
-        `Dependency ${pc8.cyan(dep)} uses a local spec that cannot install on Vercel \u2014 the remote build may fail.`
+      p23.log.warn(
+        `Dependency ${pc9.cyan(dep)} uses a local spec that cannot install on Vercel \u2014 the remote build may fail.`
       );
     }
     const deploySpinner = spinner2();
@@ -26610,16 +26681,16 @@ async function runVercelDeployFlow(options) {
       packageGuard.restore();
     }
     if (deploy.failure) {
-      deploySpinner.stop(`${pc8.yellow("\u25B2")} ${deployFailureMessage(deploy.failure)}`);
-      if (deploy.detail) p21.log.message(pc8.dim(deploy.detail));
+      deploySpinner.stop(`${pc9.yellow("\u25B2")} ${deployFailureMessage(deploy.failure)}`);
+      if (deploy.detail) p23.log.message(pc9.dim(redactSecrets(deploy.detail)));
       printManualDeployHint();
       return { ok: false };
     }
     const url = deploy.url;
-    deploySpinner.stop(url ? `Deployed ${pc8.cyan(url)}` : "Deployed to Vercel");
+    deploySpinner.stop(url ? `Deployed ${pc9.cyan(url)}` : "Deployed to Vercel");
     return { ok: true, url, syncedEnvKeys: sync.synced };
   } catch (error) {
-    p21.log.warn(`Vercel deploy failed: ${error instanceof Error ? error.message : String(error)}`);
+    p23.log.warn(`Vercel deploy failed: ${error instanceof Error ? error.message : String(error)}`);
     printManualDeployHint();
     return { ok: false };
   } finally {
@@ -26627,12 +26698,12 @@ async function runVercelDeployFlow(options) {
   }
 }
 function printManualDeployHint() {
-  p21.log.info(`You can deploy manually: ${pc8.cyan("vercel deploy --prod")}`);
+  p23.log.info(`You can deploy manually: ${pc9.cyan("vercel deploy --prod")}`);
 }
 async function ensureLinkedProject(runner, cwd, projectName, env, scope) {
   if (readLinkedProjectId(cwd)) return;
   const projectSpinner = spinner2();
-  projectSpinner.start(`Creating a Vercel project ${pc8.cyan(projectName)}`);
+  projectSpinner.start(`Creating a Vercel project ${pc9.cyan(projectName)}`);
   const project2 = await createVercelProject(runner, cwd, projectName, { env, scope });
   projectSpinner.clear();
   if (!project2.linked || !project2.projectId) {
@@ -26644,7 +26715,7 @@ async function pullNeonDatabaseUrl(runner, cwd, env) {
   neonSpinner.start("Retrieving DATABASE_URL from Vercel");
   const databaseUrl = await pullVercelEnvValue(runner, cwd, readDbUrlFromDotenv, env);
   if (!databaseUrl) {
-    neonSpinner.stop(`${pc8.yellow("\u25B2")} No DATABASE_URL came back from Vercel`);
+    neonSpinner.stop(`${pc9.yellow("\u25B2")} No DATABASE_URL came back from Vercel`);
     return void 0;
   }
   neonSpinner.clear();
@@ -26704,12 +26775,19 @@ function neonFailureMessage(reason) {
 }
 // adapters/next/commands/init.ts
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 // adapters/next/commands/seed.ts
 import fs40 from "fs";
 import path51 from "path";
-import * as clack from "@clack/prompts";
+import * as clack2 from "@clack/prompts";
+// core-engine/utils/interactive.ts
+function isInteractiveSession4() {
+  return Boolean(process.stdin.isTTY) && process.env.CI !== "true";
+}
+// adapters/next/commands/seed.ts
 function buildSeedScript(authBasePath = "/api/admin/auth") {
   return `/**
  * BetterStart Admin \u2014 Seed Script
@@ -26882,44 +26960,80 @@ main().catch((err) => {
 }
 async function runSeedCommand(options) {
   const cwd = options.cwd ? path51.resolve(options.cwd) : process.cwd();
-  clack.intro("BetterStart Seed");
+  clack2.intro("BetterStart Seed");
   let config;
   try {
     config = await resolveConfig(cwd);
   } catch (err) {
-    clack.cancel(`Error loading config: ${err instanceof Error ? err.message : String(err)}`);
+    clack2.cancel(`Error loading config: ${err instanceof Error ? err.message : String(err)}`);
     process.exit(1);
   }
   const adminDir = config.paths?.admin ?? "./admin";
-  const email = await clack.text({
-    message: "Admin email",
-    placeholder: "admin@example.com",
-    validate: (v) => {
-      if (!v || !v.includes("@")) return "Please enter a valid email";
+  const interactive = isInteractiveSession4();
+  let email;
+  if (options.email) {
+    if (!options.email.includes("@")) {
+      clack2.log.error(`Invalid email "${options.email}".`);
+      process.exit(1);
     }
-  });
-  if (clack.isCancel(email)) {
-    clack.cancel("Cancelled.");
-    return;
+    email = options.email;
+  } else if (!interactive) {
+    clack2.log.error("Provide --email to run seed without a terminal.");
+    process.exit(1);
+  } else {
+    const emailInput = await clack2.text({
+      message: "Admin email",
+      placeholder: "admin@example.com",
+      validate: (v) => {
+        if (!v || !v.includes("@")) return "Please enter a valid email";
+      }
+    });
+    if (clack2.isCancel(emailInput)) {
+      clack2.cancel("Cancelled.");
+      return;
+    }
+    email = emailInput;
   }
-  const password4 = await clack.password({
-    message: "Admin password",
-    validate: (v) => {
-      if (!v || v.length < 8) return "Password must be at least 8 characters";
+  const envPassword = process.env.BETTERSTART_ADMIN_PASSWORD;
+  let password4;
+  if (envPassword) {
+    if (envPassword.length < 8) {
+      clack2.log.error("BETTERSTART_ADMIN_PASSWORD must be at least 8 characters.");
+      process.exit(1);
     }
-  });
-  if (clack.isCancel(password4)) {
-    clack.cancel("Cancelled.");
-    return;
+    password4 = envPassword;
+  } else if (!interactive) {
+    clack2.log.error("Set BETTERSTART_ADMIN_PASSWORD to run seed without a terminal.");
+    process.exit(1);
+  } else {
+    const passwordInput = await clack2.password({
+      message: "Admin password",
+      validate: (v) => {
+        if (!v || v.length < 8) return "Password must be at least 8 characters";
+      }
+    });
+    if (clack2.isCancel(passwordInput)) {
+      clack2.cancel("Cancelled.");
+      return;
+    }
+    password4 = passwordInput;
   }
-  const name = await clack.text({
-    message: "Admin name",
-    placeholder: "Admin",
-    defaultValue: "Admin"
-  });
-  if (clack.isCancel(name)) {
-    clack.cancel("Cancelled.");
-    return;
+  let name;
+  if (options.name) {
+    name = options.name;
+  } else if (!interactive) {
+    name = "Admin";
+  } else {
+    const nameInput = await clack2.text({
+      message: "Admin name",
+      placeholder: "Admin",
+      defaultValue: "Admin"
+    });
+    if (clack2.isCancel(nameInput)) {
+      clack2.cancel("Cancelled.");
+      return;
+    }
+    name = nameInput;
   }
   const scriptsDir = path51.join(cwd, adminDir, "scripts");
   const seedPath = path51.join(scriptsDir, "seed.ts");
@@ -26962,11 +27076,21 @@ async function runSeedCommand(options) {
     if (result.code === 2) {
       const existingName = result.stdout.split("\n").find((l) => l.startsWith("EXISTING_USER:"))?.replace("EXISTING_USER:", "")?.trim() || "unknown";
       seedSpinner.stop(`Account already exists for ${email}`);
-      const overwrite = await clack.confirm({
+      if (!interactive) {
+        clack2.log.error(
+          `An admin account (${existingName}) already exists for ${email}. Replacing it needs a terminal.`
+        );
+        try {
+          fs40.unlinkSync(seedPath);
+        } catch {
+        }
+        process.exit(1);
+      }
+      const overwrite = await clack2.confirm({
         message: `An admin account (${existingName}) already exists with this email. Replace it?`
       });
-      if (clack.isCancel(overwrite) || !overwrite) {
-        clack.cancel("Seed cancelled.");
+      if (clack2.isCancel(overwrite) || !overwrite) {
+        clack2.cancel("Seed cancelled.");
         try {
           fs40.unlinkSync(seedPath);
         } catch {
@@ -26982,12 +27106,12 @@ async function runSeedCommand(options) {
   } catch (err) {
     seedSpinner.stop("Failed to create admin user");
     const errMsg = err instanceof Error ? err.message : String(err);
-    clack.log.error(errMsg);
-    clack.log.info("You can run the seed script manually:");
-    clack.log.info(
+    clack2.log.error(errMsg);
+    clack2.log.info("You can run the seed script manually:");
+    clack2.log.info(
       `  SEED_EMAIL="${email}" SEED_PASSWORD="..." npx tsx ${path51.relative(cwd, seedPath)}`
     );
-    clack.outro("");
+    clack2.outro("");
     process.exit(1);
   }
   try {
@@ -26997,7 +27121,7 @@ async function runSeedCommand(options) {
     }
   } catch {
   }
-  clack.outro(`Admin user ready: ${email}`);
+  clack2.outro(`Admin user ready: ${email}`);
 }
 // adapters/next/commands/init.ts
@@ -27010,16 +27134,16 @@ function addVersionToBoxBottomBorder(box2, version2) {
   if (!bottomLine) {
     return box2;
   }
-  const leftCornerIndex = bottomLine.indexOf(p22.S_CORNER_BOTTOM_LEFT);
-  const rightCornerIndex = bottomLine.lastIndexOf(p22.S_CORNER_BOTTOM_RIGHT);
+  const leftCornerIndex = bottomLine.indexOf(p24.S_CORNER_BOTTOM_LEFT);
+  const rightCornerIndex = bottomLine.lastIndexOf(p24.S_CORNER_BOTTOM_RIGHT);
   const label = ` v${version2} `;
-  const borderWidth = rightCornerIndex - leftCornerIndex - p22.S_CORNER_BOTTOM_LEFT.length;
+  const borderWidth = rightCornerIndex - leftCornerIndex - p24.S_CORNER_BOTTOM_LEFT.length;
   if (leftCornerIndex === -1 || rightCornerIndex === -1 || borderWidth < label.length) {
     return box2;
   }
   const leftBorderWidth = Math.floor((borderWidth - label.length) / 2);
   const rightBorderWidth = borderWidth - label.length - leftBorderWidth;
-  lines[bottomLineIndex] = `${bottomLine.slice(0, leftCornerIndex + p22.S_CORNER_BOTTOM_LEFT.length)}${p22.S_BAR_H.repeat(leftBorderWidth)}${label}${p22.S_BAR_H.repeat(rightBorderWidth)}${bottomLine.slice(rightCornerIndex)}`;
+  lines[bottomLineIndex] = `${bottomLine.slice(0, leftCornerIndex + p24.S_CORNER_BOTTOM_LEFT.length)}${p24.S_BAR_H.repeat(leftBorderWidth)}${label}${p24.S_BAR_H.repeat(rightBorderWidth)}${bottomLine.slice(rightCornerIndex)}`;
   return lines.join("\n");
 }
 function renderInitBanner() {
@@ -27029,7 +27153,7 @@ function renderInitBanner() {
   output.on("data", (chunk) => {
     box2 += chunk.toString();
   });
-  p22.box(
+  p24.box(
     `
 \u2584   \u2597 \u2597     \u2584\u2596\u2597     \u2597
 \u2599\u2598\u2588\u258C\u259C\u2598\u259C\u2598\u2588\u258C\u259B\u2598\u259A \u259C\u2598\u2580\u258C\u259B\u2598\u259C\u2598
@@ -27122,6 +27246,14 @@ function removeExistingAdminPaths(cwd, namespaces) {
   return removed;
 }
 async function runInitCommand(name, options) {
+  let restoreStdout;
+  if (options.json) {
+    if (!options.yes) {
+      p24.log.error("--json requires --yes.");
+      process.exit(1);
+    }
+    restoreStdout = redirectStdoutToStderr();
+  }
   installPromptCheckmarks();
   const disposeCancelGuard = installSetupCancelGuard();
   renderInitBanner();
@@ -27138,7 +27270,7 @@ async function runInitCommand(name, options) {
     }
   } catch (error) {
     disposeCancelGuard();
-    p22.log.error(error instanceof Error ? error.message : String(error));
+    p24.log.error(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
   let cwd = process.cwd();
@@ -27149,7 +27281,7 @@ async function runInitCommand(name, options) {
     try {
       namespace = validateAdminNamespace(options.namespace);
     } catch (error) {
-      p22.log.error(error instanceof Error ? error.message : String(error));
+      p24.log.error(error instanceof Error ? error.message : String(error));
       process.exit(1);
     }
   }
@@ -27158,13 +27290,13 @@ async function runInitCommand(name, options) {
     try {
       projectPrompt = options.yes ? resolveNonInteractiveProject(name) : await promptProject(name);
     } catch (error) {
-      p22.log.error(error instanceof Error ? error.message : String(error));
+      p24.log.error(error instanceof Error ? error.message : String(error));
       process.exit(1);
     }
   }
   if (!options.yes && !options.namespace) {
     const defaultDashboardPath = resolveAdminNamespace(DEFAULT_ADMIN_NAMESPACE).routePath;
-    const namespaceInput = await p22.text({
+    const namespaceInput = await p24.text({
       message: "Enter the dashboard path",
       placeholder: `eg. ${defaultDashboardPath}`,
       defaultValue: defaultDashboardPath,
@@ -27177,8 +27309,8 @@ async function runInitCommand(name, options) {
         }
       }
     });
-    if (p22.isCancel(namespaceInput)) {
-      p22.cancel("Setup cancelled.");
+    if (p24.isCancel(namespaceInput)) {
+      p24.cancel("Setup cancelled.");
       process.exit(0);
     }
     namespace = validateAdminDashboardPath(namespaceInput);
@@ -27190,51 +27322,52 @@ async function runInitCommand(name, options) {
   if (project2.isExisting) {
     srcDir = project2.hasSrcDir;
     if (!project2.hasTypeScript) {
-      p22.log.error("TypeScript is required. Please add a tsconfig.json first.");
+      p24.log.error("TypeScript is required. Please add a tsconfig.json first.");
       process.exit(1);
     }
     if (forceMode) {
       const nuked = removeExistingAdminPaths(cwd, await resolveForceInitNamespaces(cwd, namespace));
       if (nuked > 0) {
-        p22.log.warn(`${pc9.yellow("Force mode:")} removed ${nuked} existing admin paths`);
+        p24.log.warn(`${pc10.yellow("Force mode:")} removed ${nuked} existing admin paths`);
       }
       project2 = detectProject(cwd, namespace);
     } else if (project2.conflicts.length > 0) {
-      const conflictLines = project2.conflicts.map((c) => `${pc9.yellow("\u25B2")} ${c}`);
+      const conflictLines = project2.conflicts.map((c) => `${pc10.yellow("\u25B2")} ${c}`);
       conflictLines.push(
         "",
-        pc9.dim(`Use ${pc9.bold("--force")} to remove existing admin files before scaffolding.`)
+        pc10.dim(`Use ${pc10.bold("--force")} to remove existing admin files before scaffolding.`)
       );
-      p22.note(conflictLines.join("\n"), pc9.yellow("Conflicts"));
-      if (!options.yes) {
-        const proceed = await p22.confirm({
-          message: [
-            `Continue with ${pc9.bold(pc9.cyan("--force"))}?`,
-            `${pc9.cyan("\u2502")}  ${pc9.dim("This will force overwrite the existing admin code.")}`,
-            pc9.cyan("\u2502")
-          ].join("\n"),
-          initialValue: true
-        });
-        if (p22.isCancel(proceed) || !proceed) {
-          p22.cancel("Setup cancelled.");
-          process.exit(0);
-        }
-        forceMode = true;
-        const nuked = removeExistingAdminPaths(
-          cwd,
-          await resolveForceInitNamespaces(cwd, namespace)
+      p24.note(conflictLines.join("\n"), pc10.yellow("Conflicts"));
+      if (options.yes) {
+        p24.log.error(
+          "Can't continue with --yes while admin files conflict. Re-run with --force to remove them first."
         );
-        if (nuked > 0) {
-          p22.log.warn(`${pc9.yellow("Force mode:")} removed ${nuked} existing admin paths`);
-        }
-        project2 = detectProject(cwd, namespace);
+        process.exit(1);
       }
+      const proceed = await p24.confirm({
+        message: [
+          `Continue with ${pc10.bold(pc10.cyan("--force"))}?`,
+          `${pc10.cyan("\u2502")}  ${pc10.dim("This will force overwrite the existing admin code.")}`,
+          pc10.cyan("\u2502")
+        ].join("\n"),
+        initialValue: true
+      });
+      if (p24.isCancel(proceed) || !proceed) {
+        p24.cancel("Setup cancelled.");
+        process.exit(0);
+      }
+      forceMode = true;
+      const nuked = removeExistingAdminPaths(cwd, await resolveForceInitNamespaces(cwd, namespace));
+      if (nuked > 0) {
+        p24.log.warn(`${pc10.yellow("Force mode:")} removed ${nuked} existing admin paths`);
+      }
+      project2 = detectProject(cwd, namespace);
     }
   } else {
     const freshProject = projectPrompt;
     srcDir = false;
     if (!options.yes) {
-      const pmChoice = await p22.select({
+      const pmChoice = await p24.select({
         message: "Which package manager do you want to use?",
         options: [
           { value: "pnpm", label: "pnpm", hint: "recommended" },
@@ -27242,8 +27375,8 @@ async function runInitCommand(name, options) {
           { value: "bun", label: "bun" }
         ]
       });
-      if (p22.isCancel(pmChoice)) {
-        p22.cancel("Setup cancelled.");
+      if (p24.isCancel(pmChoice)) {
+        p24.cancel("Setup cancelled.");
         process.exit(0);
       }
       pm = pmChoice;
@@ -27278,11 +27411,11 @@ async function runInitCommand(name, options) {
         process.stderr.write(`${createNextAppResult.output.trimEnd()}
 `);
       }
-      p22.log.error(createNextAppResult.error);
-      p22.log.info(
+      p24.log.error(createNextAppResult.error);
+      p24.log.info(
         `You can create the project manually:
-  ${pc9.cyan(`npx create-next-app@latest ${freshProject.projectName} --typescript --tailwind --app`)}
-  Then run ${pc9.cyan("betterstart init")} inside it.`
+  ${pc10.cyan(`npx create-next-app@latest ${freshProject.projectName} --typescript --tailwind --app`)}
+  Then run ${pc10.cyan("betterstart init")} inside it.`
       );
       process.exit(1);
     }
@@ -27293,14 +27426,14 @@ async function runInitCommand(name, options) {
     );
     if (!hasPackageJson || !hasNextConfig) {
       createNextAppSpinner.stop(`Failed to create Next.js app: ${displayName}`);
-      p22.log.error(
+      p24.log.error(
         "create-next-app completed but the project was not created. This can happen with nested npx calls."
       );
       const manualCmd = `npx create-next-app@latest ${freshProject.projectName} --typescript --tailwind --app`;
-      p22.log.info(
+      p24.log.info(
         `Create the project manually:
-  ${pc9.cyan(manualCmd)}
-  Then run ${pc9.cyan("betterstart init")} inside it.`
+  ${pc10.cyan(manualCmd)}
+  Then run ${pc10.cyan("betterstart init")} inside it.`
       );
       process.exit(1);
     }
@@ -27346,22 +27479,22 @@ async function runInitCommand(name, options) {
   try {
     validateResolvedDatabaseProvider(databaseProvider, options);
   } catch (error) {
-    p22.log.error(error instanceof Error ? error.message : String(error));
+    p24.log.error(error instanceof Error ? error.message : String(error));
     process.exit(1);
   }
   if (databaseProvider === "manual") {
     const candidate = options.databaseUrl ?? existingDbUrl ?? promptedManualUrl;
     if (candidate && !isValidDbUrl(candidate)) {
-      p22.log.error(
-        `Invalid database URL. Must start with ${pc9.cyan("postgres://")} or ${pc9.cyan("postgresql://")}`
+      p24.log.error(
+        `Invalid database URL. Must start with ${pc10.cyan("postgres://")} or ${pc10.cyan("postgresql://")}`
       );
       process.exit(1);
     }
     if (candidate) {
       databaseUrl = candidate;
       if (existingDbUrl === candidate && !options.databaseUrl) {
-        p22.log.info(
-          `Using the existing DATABASE_URL from .env.local ${pc9.dim(`(${maskDbUrl(candidate)})`)}`
+        p24.log.info(
+          `Using the existing DATABASE_URL from .env.local ${pc10.dim(`(${maskDbUrl(candidate)})`)}`
         );
       }
     } else if (!options.yes) {
@@ -27380,7 +27513,7 @@ async function runInitCommand(name, options) {
       persistDatabaseUrl(cwd, databaseUrl);
       dismissVercelSignedInNote = flow.dismissSignedInNote;
     } else if (options.yes) {
-      p22.log.error(
+      p24.log.error(
         flow.ok ? "Created a Neon database, but DATABASE_URL could not be retrieved from Vercel." : "Vercel database provisioning did not complete."
       );
       process.exit(1);
@@ -27389,7 +27522,7 @@ async function runInitCommand(name, options) {
       databaseUrl = await promptConnectionString();
       persistDatabaseUrl(cwd, databaseUrl);
     } else {
-      p22.log.info("Falling back to a manual database connection string.");
+      p24.log.info("Falling back to a manual database connection string.");
       openBrowserVercelNeon();
       databaseUrl = await promptConnectionString();
     }
@@ -27403,11 +27536,11 @@ async function runInitCommand(name, options) {
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       if (options.yes) {
-        p22.log.error(`Railway database provisioning failed: ${message}`);
+        p24.log.error(`Railway database provisioning failed: ${message}`);
         process.exit(1);
       }
-      p22.log.warn(`Railway database provisioning failed: ${message}`);
-      p22.log.info("Falling back to a manual database connection string.");
+      p24.log.warn(`Railway database provisioning failed: ${message}`);
+      p24.log.info("Falling back to a manual database connection string.");
       databaseUrl = await promptConnectionString();
     }
   }
@@ -27437,7 +27570,7 @@ async function runInitCommand(name, options) {
       return { ok: true, config: config2 };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      p22.log.warn(`Railway bucket provisioning failed: ${message}`);
+      p24.log.warn(`Railway bucket provisioning failed: ${message}`);
       return { ok: false };
     }
   };
@@ -27451,7 +27584,7 @@ async function runInitCommand(name, options) {
     if (storage === "r2") {
       const missingR2Keys = R2_ENV_KEYS.filter((key) => !readEnvVar(cwd, key)?.trim());
       if (options.yes && missingR2Keys.length > 0) {
-        p22.log.error(
+        p24.log.error(
           `Cloudflare R2 is missing required environment variables: ${missingR2Keys.join(", ")}.`
         );
         process.exit(1);
@@ -27465,7 +27598,7 @@ async function runInitCommand(name, options) {
         if (flow.ok && flow.config) {
           mergeCollectedIntegrationConfig(flow.config);
         } else if (options.yes) {
-          p22.log.error("Railway bucket provisioning did not complete.");
+          p24.log.error("Railway bucket provisioning did not complete.");
           process.exit(1);
         }
       }
@@ -27484,10 +27617,10 @@ async function runInitCommand(name, options) {
         });
         collectedIntegrationConfig.overwriteKeys.add("BLOB_READ_WRITE_TOKEN");
       } else if (options.yes) {
-        p22.log.error("Vercel Blob provisioning did not complete.");
+        p24.log.error("Vercel Blob provisioning did not complete.");
         process.exit(1);
       } else {
-        p22.log.warn(
+        p24.log.warn(
           "Continuing without a Blob token \u2014 add BLOB_READ_WRITE_TOKEN to .env.local from the store on vercel.com/dashboard/stores."
         );
         collectedIntegrationConfig.sections.push({
@@ -27561,7 +27694,7 @@ async function runInitCommand(name, options) {
   const nextConfigResult = scaffoldNextConfig({ cwd, nextMajorVersion });
   s.clear();
   if (nextConfigResult.status === "unsupported") {
-    p22.log.warn("The Next.js config could not be updated automatically \u2014 review it manually.");
+    p24.log.warn("The Next.js config could not be updated automatically \u2014 review it manually.");
   }
   const drizzleConfigPath = path52.join(cwd, "drizzle.config.ts");
   if (!dbFiles.includes("drizzle.config.ts") && fs41.existsSync(drizzleConfigPath)) {
@@ -27572,20 +27705,20 @@ async function runInitCommand(name, options) {
         readNamespacedTemplate("drizzle.config.ts", namespace),
         "utf-8"
       );
-      p22.log.success("Updated drizzle.config.ts");
+      p24.log.success("Updated drizzle.config.ts");
     } else if (!options.yes) {
-      const overwrite = await p22.confirm({
+      const overwrite = await p24.confirm({
         message: "drizzle.config.ts already exists. Overwrite with latest version?",
         initialValue: true
       });
-      if (!p22.isCancel(overwrite) && overwrite) {
+      if (!p24.isCancel(overwrite) && overwrite) {
         const { readNamespacedTemplate } = await import("./template-reader-X6KFP7B3.js");
         fs41.writeFileSync(
           drizzleConfigPath,
           readNamespacedTemplate("drizzle.config.ts", namespace),
           "utf-8"
         );
-        p22.log.success("Updated drizzle.config.ts");
+        p24.log.success("Updated drizzle.config.ts");
       }
     }
   }
@@ -27610,11 +27743,11 @@ async function runInitCommand(name, options) {
     s.stop("");
   } else {
     s.stop("Failed to install dependencies");
-    p22.log.warning(depsResult.error ?? "Unknown error");
-    p22.log.info(
+    p24.log.warn(depsResult.error ?? "Unknown error");
+    p24.log.info(
       `You can install them manually:
-  ${pc9.cyan(`${pm} add ${depsResult.dependencies.join(" ")}`)}
-  ${pc9.cyan(`${pm} add -D ${depsResult.devDeps.join(" ")}`)}`
+  ${pc10.cyan(`${pm} add ${depsResult.dependencies.join(" ")}`)}
+  ${pc10.cyan(`${pm} add -D ${depsResult.devDeps.join(" ")}`)}`
     );
     disposeCancelGuard();
     process.exit(1);
@@ -27667,22 +27800,22 @@ async function runInitCommand(name, options) {
   writeConfigFile(cwd, resolvedIntegrationInstallResult.config);
   const usesLocalStorage = resolvedIntegrationInstallResult.config.storage.provider === "local";
   for (const err of coreSchemasResult.errors) {
-    p22.log.warn(`Core schemas: ${err}`);
+    p24.log.warn(`Core schemas: ${err}`);
   }
   for (const warning of resolvedPresetInstallResult.warnings) {
-    p22.log.warn(warning);
+    p24.log.warn(warning);
   }
   for (const warning of resolvedIntegrationInstallResult.warnings) {
-    p22.log.warn(warning);
+    p24.log.warn(warning);
   }
   if (usesLocalStorage) {
-    p22.log.warn(
+    p24.log.warn(
       "Local filesystem storage is only for development or self-hosted persistent-disk deployments. Use Vercel Blob, Railway Bucket, or Cloudflare R2 for hosted production."
     );
   }
   let dbPushed = false;
   if (depsResult.success && options.skipMigration && hasDbUrl(cwd)) {
-    p22.log.info(`Skipping database schema push ${pc9.dim("(--skip-migration)")}`);
+    p24.log.info(`Skipping database schema push ${pc10.dim("(--skip-migration)")}`);
   } else if (depsResult.success && hasDbUrl(cwd)) {
     let driverReady = hasDrizzleKitPostgresDriverDependency(cwd);
     if (!driverReady) {
@@ -27697,9 +27830,9 @@ async function runInitCommand(name, options) {
       });
       if (!driverResult.success) {
         s.stop("Database push failed");
-        p22.log.warning(driverResult.error ?? `Failed to install ${DRIZZLE_KIT_POSTGRES_DRIVER_DEP}`);
-        p22.log.info(
-          `Install ${DRIZZLE_KIT_POSTGRES_DRIVER_DEP} manually, then run: ${pc9.cyan(drizzlePushCommand(pm))}`
+        p24.log.warn(driverResult.error ?? `Failed to install ${DRIZZLE_KIT_POSTGRES_DRIVER_DEP}`);
+        p24.log.info(
+          `Install ${DRIZZLE_KIT_POSTGRES_DRIVER_DEP} manually, then run: ${pc10.cyan(drizzlePushCommand(pm))}`
         );
       } else {
         driverReady = hasDrizzleKitPostgresDriverDependency(cwd);
@@ -27726,8 +27859,8 @@ async function runInitCommand(name, options) {
           const verification = await verifyDatabaseReachable(cwd);
           clearDbSpinner();
           if (!verification.success) {
-            p22.log.warning(verification.error);
-            p22.log.error("Database was not reachable. Aborting setup.");
+            p24.log.warn(verification.error);
+            p24.log.error("Database was not reachable. Aborting setup.");
             process.exit(1);
           }
         } else {
@@ -27740,22 +27873,21 @@ async function runInitCommand(name, options) {
           s.stop("Database push failed");
         }
         const pushError = pushResult.error ?? "Unknown error";
-        p22.log.warning(pushError);
+        p24.log.warn(pushError);
         if (isDatabaseReachabilityError(pushError)) {
-          p22.log.error("Database was not reachable. Aborting setup.");
+          p24.log.error("Database was not reachable. Aborting setup.");
           process.exit(1);
         }
-        p22.log.info(`You can run it manually: ${pc9.cyan(drizzlePushCommand(pm))}`);
+        p24.log.info(`You can run it manually: ${pc10.cyan(drizzlePushCommand(pm))}`);
       }
     }
   }
   let seedEmail;
-  let seedPassword;
   let seedSuccess = false;
   let adminAccountReady = false;
   if (dbPushed && options.skipAdminCreation) {
-    p22.log.info(
-      `Skipping admin user creation ${pc9.dim(`(use ${betterstartExecCommand(pm, "seed")} later)`)}`
+    p24.log.info(
+      `Skipping admin user creation ${pc10.dim(`(use ${betterstartExecCommand(pm, "seed")} later)`)}`
     );
   }
   if (dbPushed && !options.yes && !options.skipAdminCreation) {
@@ -27766,14 +27898,14 @@ async function runInitCommand(name, options) {
     const adminCheck = await checkExistingAdmin(cwd, adminDir, authBasePath);
     s.clear();
     if (adminCheck.error) {
-      p22.log.warning(`Could not verify existing admin account ${pc9.dim(`(${adminCheck.error})`)}`);
+      p24.log.warn(`Could not verify existing admin account ${pc10.dim(`(${adminCheck.error})`)}`);
       if (isDatabaseReachabilityError(adminCheck.error)) {
-        p22.log.error("Database was not reachable. Aborting setup.");
+        p24.log.error("Database was not reachable. Aborting setup.");
         process.exit(1);
       }
     } else if (adminCheck.existingAdmin) {
       const existingAdminLabel = formatAdminIdentity(adminCheck.existingAdmin);
-      const adminAction = await p22.select({
+      const adminAction = await p24.select({
         message: "Found an already existing admin account. Do you want to replace it or skip?",
         options: [
           {
@@ -27787,28 +27919,28 @@ async function runInitCommand(name, options) {
           }
         ]
       });
-      if (p22.isCancel(adminAction)) {
-        p22.cancel("Setup cancelled.");
+      if (p24.isCancel(adminAction)) {
+        p24.cancel("Setup cancelled.");
         process.exit(0);
       }
       if (adminAction === "skip") {
         adminAccountReady = true;
-        p22.log.info(`Keeping existing admin account ${pc9.dim(`(${existingAdminLabel})`)}`);
+        p24.log.info(`Keeping existing admin account ${pc10.dim(`(${existingAdminLabel})`)}`);
       } else {
         replaceExistingAdmin = true;
       }
     }
     if (!adminAccountReady) {
-      const credentials = await p22.group(
+      const credentials = await p24.group(
         {
-          email: () => p22.text({
+          email: () => p24.text({
             message: "Admin email",
             placeholder: "admin@example.com",
             validate: (v) => {
               if (!v || !v.includes("@")) return "Please enter a valid email";
             }
           }),
-          password: () => p22.password({
+          password: () => p24.password({
             message: "Admin password",
             validate: (v) => {
               if (!v || v.length < 8) return "Password must be at least 8 characters";
@@ -27817,14 +27949,13 @@ async function runInitCommand(name, options) {
         },
         {
           onCancel: () => {
-            p22.cancel("Setup cancelled.");
+            p24.cancel("Setup cancelled.");
             process.exit(0);
           }
         }
       );
       seedEmail = credentials.email;
-      seedPassword = credentials.password;
-      const credentialPromptRows = clackPromptRows("Admin email", credentials.email) + clackPromptRows("Admin password", p22.S_PASSWORD_MASK.repeat(credentials.password.length));
+      const credentialPromptRows = clackPromptRows("Admin email", credentials.email) + clackPromptRows("Admin password", p24.S_PASSWORD_MASK.repeat(credentials.password.length));
       let rowsBelowCredentialPrompts = 0;
       let seedOverwriteMode = replaceExistingAdmin ? "admin" : void 0;
       s.start(replaceExistingAdmin ? "Replacing admin user" : "Creating admin user");
@@ -27837,11 +27968,11 @@ async function runInitCommand(name, options) {
         seedOverwriteMode
       );
       if (seedResult.existingUser) {
-        const existingAccountMessage = `${pc9.yellow("\u25B2")} An account already exists for ${credentials.email}`;
+        const existingAccountMessage = `${pc10.yellow("\u25B2")} An account already exists for ${credentials.email}`;
         s.stop(existingAccountMessage);
         rowsBelowCredentialPrompts += clackLogRows(existingAccountMessage);
         const replaceAccountMessage = "Replace the existing account with this email?";
-        const replace = await p22.confirm({
+        const replace = await p24.confirm({
           message: replaceAccountMessage,
           initialValue: false
         });
@@ -27849,7 +27980,7 @@ async function runInitCommand(name, options) {
           replaceAccountMessage,
           replace === true ? "Yes" : "No"
         );
-        if (!p22.isCancel(replace) && replace) {
+        if (!p24.isCancel(replace) && replace) {
           seedOverwriteMode = "email";
           s.start("Replacing admin user");
           seedResult = await runSeed(
@@ -27863,7 +27994,7 @@ async function runInitCommand(name, options) {
         }
       }
       if (seedResult.success) {
-        const seedSuccessMessage = seedOverwriteMode === "admin" ? `Admin user replaced` : `Admin user ${pc9.green(seedEmail)} created`;
+        const seedSuccessMessage = seedOverwriteMode === "admin" ? `Admin user replaced` : `Admin user ${pc10.green(seedEmail)} created`;
         s.stop(seedSuccessMessage);
         rowsBelowCredentialPrompts += clackLogRows(seedSuccessMessage);
         eraseRowsAbove(credentialPromptRows, rowsBelowCredentialPrompts);
@@ -27871,14 +28002,14 @@ async function runInitCommand(name, options) {
         adminAccountReady = true;
       } else if (seedResult.error) {
         s.stop(`Failed to create admin user`);
-        p22.note(
-          `${pc9.red(seedResult.error)}
+        p24.note(
+          `${pc10.red(seedResult.error)}
-Run manually: ${pc9.cyan(betterstartExecCommand(pm, "seed"))}`,
-          pc9.red("Seed failed")
+Run manually: ${pc10.cyan(betterstartExecCommand(pm, "seed"))}`,
+          pc10.red("Seed failed")
         );
         if (isDatabaseReachabilityError(seedResult.error)) {
-          p22.log.error("Database was not reachable. Aborting setup.");
+          p24.log.error("Database was not reachable. Aborting setup.");
           process.exit(1);
         }
       }
@@ -27909,6 +28040,7 @@ Run manually: ${pc9.cyan(betterstartExecCommand(pm, "seed"))}`,
     const initialDeployProvider = railwaySessionPromise ? "railway" : readLinkedProjectId(cwd) ? "vercel" : "none";
     deployProvider = await promptDeployProvider(initialDeployProvider);
   }
+  let deployedUrl;
   if (deployProvider === "vercel") {
     const deployFlow = await runVercelDeployFlow({
       cwd,
@@ -27916,12 +28048,13 @@ Run manually: ${pc9.cyan(betterstartExecCommand(pm, "seed"))}`,
       interactive: !options.yes,
       env: process.env
     });
+    deployedUrl = deployFlow.url;
     if (!deployFlow.ok) {
       if (options.yes) {
-        p22.log.error("Vercel deploy did not complete.");
+        p24.log.error("Vercel deploy did not complete.");
         process.exit(1);
       }
-      p22.log.warn("Vercel deploy did not complete; continuing.");
+      p24.log.warn("Vercel deploy did not complete; continuing.");
     }
   } else if (deployProvider === "railway") {
     try {
@@ -27937,40 +28070,65 @@ Run manually: ${pc9.cyan(betterstartExecCommand(pm, "seed"))}`,
           bucketUrlStyle: railwayBucketUrlStyle
         })
       });
+      deployedUrl = deployFlow.url;
       if (!deployFlow.ok) {
-        if (deployFlow.detail) p22.log.message(pc9.dim(deployFlow.detail));
+        if (deployFlow.detail) p24.log.message(pc10.dim(redactSecrets(deployFlow.detail)));
         if (options.yes) {
-          p22.log.error("Railway deploy did not complete.");
+          p24.log.error("Railway deploy did not complete.");
           process.exit(1);
         }
-        p22.log.warn("Railway deploy did not complete; continuing.");
+        p24.log.warn("Railway deploy did not complete; continuing.");
       }
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       if (options.yes) {
-        p22.log.error(`Railway deploy failed: ${message}`);
+        p24.log.error(`Railway deploy failed: ${message}`);
         process.exit(1);
       }
-      p22.log.warn(`Railway deploy failed: ${message}`);
+      p24.log.warn(`Railway deploy failed: ${message}`);
     }
   }
   if (!options.yes && !options.skipDevServerStart) {
     const devCmd = runCommand(pm, "dev");
-    const startDev = await p22.confirm({
+    const startDev = await p24.confirm({
       message: "Start the development server?",
       initialValue: true
     });
-    if (!p22.isCancel(startDev) && startDev) {
+    if (!p24.isCancel(startDev) && startDev) {
       disposeCancelGuard();
-      await startManagedDevServer(cwd, devCmd, adminLoginUrl, {
-        email: seedSuccess && seedEmail ? seedEmail : void 0,
-        password: seedSuccess && seedPassword ? seedPassword : void 0
-      });
+      await startManagedDevServer(
+        cwd,
+        devCmd,
+        adminLoginUrl,
+        seedSuccess && seedEmail ? seedEmail : void 0
+      );
       return;
     }
   }
   disposeCancelGuard();
-  p22.outro("Done!");
+  if (options.json && restoreStdout) {
+    restoreStdout();
+    console.log(
+      JSON.stringify(
+        {
+          namespace,
+          configPath: CONFIG_FILE_NAME,
+          databaseProvider,
+          storageProvider: presetSelection.storage,
+          deployProvider,
+          presets: presetSelection.presets,
+          integrations: presetSelection.integrations,
+          adminUrl: adminLoginUrl,
+          adminEmail: seedEmail ?? null,
+          deployedUrl: deployedUrl ?? null
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  p24.outro(`Admin ready at ${adminNamespace.routePath}`);
 }
 function isValidDbUrl(url) {
   return url.startsWith("postgres://") || url.startsWith("postgresql://");
@@ -28356,12 +28514,11 @@ function stripAnsi2(value) {
   return value.replace(ANSI_ESCAPE_PATTERN2, "");
 }
 function printAdminReadyNote(state) {
-  const lines = [`Admin: ${pc9.cyan(state.adminLoginUrl)}`];
-  if (state.adminEmail && state.adminPassword) {
-    lines.unshift(`Password: ${pc9.cyan(state.adminPassword)}`);
-    lines.unshift(`Admin user: ${pc9.cyan(state.adminEmail)}`);
+  const lines = [`Admin: ${pc10.cyan(state.adminLoginUrl)}`];
+  if (state.adminEmail) {
+    lines.unshift(`Admin user: ${pc10.cyan(state.adminEmail)}`);
   }
-  p22.note(lines.join("\n"), "Admin ready");
+  p24.note(lines.join("\n"), "Admin ready");
 }
 function shouldSuppressDevServerStartupLine(line) {
   const plain = stripAnsi2(line).trim();
@@ -28424,7 +28581,7 @@ function pipeManagedDevServerStream(stream, target, state) {
     flushBuffer(true);
   });
 }
-function startManagedDevServer(cwd, devCmd, adminLoginUrl, adminCredentials) {
+function startManagedDevServer(cwd, devCmd, adminLoginUrl, adminEmail) {
   return new Promise((resolve, reject) => {
     const [bin, ...args] = devCmd.split(" ");
     const child = spawn6(bin, args, {
@@ -28435,8 +28592,7 @@ function startManagedDevServer(cwd, devCmd, adminLoginUrl, adminCredentials) {
       suppressStartup: true,
       readyLogged: false,
       adminLoginUrl,
-      adminEmail: adminCredentials?.email,
-      adminPassword: adminCredentials?.password
+      adminEmail
     };
     const forwardSignal = (signal) => {
       if (!child.killed) {
@@ -28473,74 +28629,133 @@ function startManagedDevServer(cwd, devCmd, adminLoginUrl, adminCredentials) {
 // adapters/next/commands/list-integrations.ts
 import path53 from "path";
-import * as p23 from "@clack/prompts";
+import * as p25 from "@clack/prompts";
+// core-engine/utils/table.ts
+function renderTableRows(rows) {
+  const widths = [];
+  for (const row of rows) {
+    row.forEach((cell, index) => {
+      if (index < row.length - 1) {
+        widths[index] = Math.max(widths[index] ?? 0, cell.length);
+      }
+    });
+  }
+  return rows.map(
+    (row) => row.map((cell, index) => index < row.length - 1 ? cell.padEnd(widths[index]) : cell).join("  ").trimEnd()
+  );
+}
+// adapters/next/commands/list-integrations.ts
 async function runListIntegrationsCommand(options) {
   const cwd = options.cwd ? path53.resolve(options.cwd) : process.cwd();
-  const config = await resolveConfig(cwd);
+  if (options.json) {
+    let installed2;
+    try {
+      installed2 = new Set((await resolveConfig(cwd)).integrations.installed);
+    } catch (error) {
+      console.error(
+        `Error loading config: ${error instanceof Error ? error.message : String(error)}`
+      );
+      process.exit(1);
+    }
+    const items = listAvailableIntegrations().map((integration) => ({
+      id: integration.id,
+      status: installed2.has(integration.id) ? "installed" : "available",
+      kind: integration.kind,
+      description: integration.description
+    }));
+    console.log(JSON.stringify(items, null, 2));
+    return;
+  }
+  const config = await resolveConfigOrExit(cwd);
   const installedIntegrations = new Set(config.integrations.installed);
-  const lines = listAvailableIntegrations().map((integration) => {
-    const status = installedIntegrations.has(integration.id) ? "installed" : "available";
-    return `${integration.id.padEnd(12)} ${status.padEnd(10)} ${integration.kind.padEnd(8)} ${integration.description}`;
-  });
-  p23.note(lines.join("\n"), "BetterStart integrations");
-  p23.outro(
-    `${installedIntegrations.size} installed, ${lines.length - installedIntegrations.size} available`
+  const rows = listAvailableIntegrations().map((integration) => [
+    integration.id,
+    installedIntegrations.has(integration.id) ? "installed" : "available",
+    integration.kind,
+    integration.description
+  ]);
+  p25.note(renderTableRows(rows).join("\n"), "BetterStart integrations");
+  p25.outro(
+    `${installedIntegrations.size} installed, ${rows.length - installedIntegrations.size} available`
   );
 }
 // adapters/next/commands/list-presets.ts
 import path54 from "path";
-import * as p24 from "@clack/prompts";
+import * as p26 from "@clack/prompts";
 async function runListPresetsCommand(options) {
   const cwd = options.cwd ? path54.resolve(options.cwd) : process.cwd();
-  const config = await resolveConfig(cwd);
+  if (options.json) {
+    let installed2;
+    try {
+      installed2 = new Set((await resolveConfig(cwd)).presets.installed);
+    } catch (error) {
+      console.error(
+        `Error loading config: ${error instanceof Error ? error.message : String(error)}`
+      );
+      process.exit(1);
+    }
+    const items = listAvailablePresets().map((preset) => ({
+      id: preset.id,
+      status: installed2.has(preset.id) ? "installed" : "available",
+      kind: preset.kind,
+      description: preset.description
+    }));
+    console.log(JSON.stringify(items, null, 2));
+    return;
+  }
+  const config = await resolveConfigOrExit(cwd);
   const installedPresets = new Set(config.presets.installed);
-  const lines = listAvailablePresets().map((preset) => {
-    const status = installedPresets.has(preset.id) ? "installed" : "available";
-    return `${preset.id.padEnd(10)} ${status.padEnd(10)} ${preset.kind.padEnd(12)} ${preset.description}`;
-  });
-  p24.note(lines.join("\n"), "BetterStart presets");
-  p24.outro(`${installedPresets.size} installed, ${lines.length - installedPresets.size} available`);
+  const rows = listAvailablePresets().map((preset) => [
+    preset.id,
+    installedPresets.has(preset.id) ? "installed" : "available",
+    preset.kind,
+    preset.description
+  ]);
+  p26.note(renderTableRows(rows).join("\n"), "BetterStart presets");
+  p26.outro(`${installedPresets.size} installed, ${rows.length - installedPresets.size} available`);
 }
 // adapters/next/commands/remove.ts
 import path55 from "path";
-import * as p25 from "@clack/prompts";
+import * as p27 from "@clack/prompts";
 async function runRemoveCommand(items, options) {
   const removeIntegrationsMode = Boolean(options.integration);
   if (!removeIntegrationsMode && items.includes("core")) {
-    p25.log.error("The core Admin cannot be removed.");
+    p27.log.error("The core Admin cannot be removed.");
     process.exit(1);
   }
   const presetIds = items.filter(isPresetId);
   const integrationIds = items.filter(isIntegrationId);
   if (!removeIntegrationsMode && integrationIds.length > 0) {
-    p25.log.error(
+    p27.log.error(
       `Integration IDs require --integration. Run \`betterstart remove --integration ${integrationIds.join(" ")}\`.`
     );
     process.exit(1);
   }
   if (removeIntegrationsMode && presetIds.length > 0) {
-    p25.log.error(`Preset IDs cannot be removed with --integration: ${presetIds.join(", ")}`);
+    p27.log.error(`Preset IDs cannot be removed with --integration: ${presetIds.join(", ")}`);
     process.exit(1);
   }
   const invalidItems = removeIntegrationsMode ? items.filter((integrationId) => !isIntegrationId(integrationId)) : items.filter((presetId) => !isPresetId(presetId));
   if (invalidItems.length > 0) {
-    p25.log.error(
+    p27.log.error(
       removeIntegrationsMode ? formatUnknownIntegrationMessage(invalidItems) : formatUnknownPresetMessage(invalidItems)
     );
     process.exit(1);
   }
   const cwd = options.cwd ? path55.resolve(options.cwd) : process.cwd();
-  const config = await resolveConfig(cwd);
+  const config = await resolveConfigOrExit(cwd);
   const pm = detectPackageManager(cwd);
   if (!options.force) {
-    const confirmed = await p25.confirm({
+    const confirmed = await p27.confirm({
       message: `Remove ${removeIntegrationsMode ? "integration" : "preset"}${items.length === 1 ? "" : "s"} ${items.join(", ")}?`,
       initialValue: false
     });
-    if (p25.isCancel(confirmed) || !confirmed) {
-      p25.cancel(`${removeIntegrationsMode ? "Integration" : "Preset"} removal cancelled.`);
+    if (p27.isCancel(confirmed) || !confirmed) {
+      p27.cancel(`${removeIntegrationsMode ? "Integration" : "Preset"} removal cancelled.`);
       process.exit(0);
     }
   }
@@ -28553,13 +28768,13 @@ async function runRemoveCommand(items, options) {
     });
     writeConfigFile(cwd, result2.config);
     if (result2.removed.length === 0) {
-      p25.outro("No integrations were removed.");
+      p27.outro("No integrations were removed.");
       return;
     }
     if (result2.warnings.length > 0) {
-      p25.note(result2.warnings.join("\n"), "Warnings");
+      p27.note(result2.warnings.join("\n"), "Warnings");
     }
-    p25.outro(
+    p27.outro(
       `Removed integration${result2.removed.length === 1 ? "" : "s"}: ${result2.removed.join(", ")}`
     );
     return;
@@ -28572,31 +28787,19 @@ async function runRemoveCommand(items, options) {
   });
   writeConfigFile(cwd, result.config);
   if (result.removed.length === 0) {
-    p25.outro("No presets were removed.");
+    p27.outro("No presets were removed.");
     return;
   }
   if (result.warnings.length > 0) {
-    p25.note(result.warnings.join("\n"), "Warnings");
+    p27.note(result.warnings.join("\n"), "Warnings");
   }
-  p25.outro(`Removed preset${result.removed.length === 1 ? "" : "s"}: ${result.removed.join(", ")}`);
+  p27.outro(`Removed preset${result.removed.length === 1 ? "" : "s"}: ${result.removed.join(", ")}`);
 }
 // adapters/next/commands/remove-schema.ts
 import fs42 from "fs";
 import path56 from "path";
-import readline from "readline";
-async function promptConfirm4(message) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve) => {
-    rl.question(`${message} (y/N) `, (answer) => {
-      rl.close();
-      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
-    });
-  });
-}
+import * as clack3 from "@clack/prompts";
 function removePath2(cwd, filePath) {
   const fullPath = path56.join(cwd, ...filePath.split("/"));
   const existed = fs42.existsSync(fullPath);
@@ -28642,35 +28845,40 @@ async function runRemoveSchemaCommand(schemaName, options) {
     schemaName
   );
   if (owner === "core") {
-    console.error(
-      `  "${schemaName}" is a core Admin module and cannot be removed with remove-schema.`
+    clack3.log.error(
+      `"${schemaName}" is a core Admin module and cannot be removed with remove-schema.`
     );
     process.exit(1);
   }
   if (owner.startsWith("preset:")) {
-    console.error(`  "${schemaName}" is owned by ${owner}. Remove the owning preset instead.`);
+    clack3.log.error(`"${schemaName}" is owned by ${owner}. Remove the owning preset instead.`);
     process.exit(1);
   }
   const cwd = options.cwd ? path56.resolve(options.cwd) : process.cwd();
-  const config = await resolveConfig(cwd);
+  const config = await resolveConfigOrExit(cwd);
   const paths = resolveProjectPaths(config);
   const manifest = loadManifest(cwd, schemaName);
   if (!snapshotRootExists(cwd)) {
-    console.error(
-      "  Project state is unsupported or incomplete. Re-run `betterstart init --force` to create the current snapshot-backed layout."
-    );
+    clack3.log.error(UNSUPPORTED_PROJECT_STATE_MESSAGE);
     process.exit(1);
   }
   if (!manifest) {
-    console.error(
-      "  Project state is unsupported or incomplete. Re-run `betterstart init --force` to create the current snapshot-backed layout."
-    );
+    clack3.log.error(UNSUPPORTED_PROJECT_STATE_MESSAGE);
     process.exit(1);
   }
   if (!options.force) {
-    const confirmed = await promptConfirm4(`  Remove generated files for ${schemaName}?`);
-    if (!confirmed) {
-      console.log("\n  Cancelled.\n");
+    if (!isInteractiveSession4()) {
+      clack3.log.error(
+        `Removing generated files for ${schemaName} needs confirmation. Re-run with --force.`
+      );
+      process.exit(1);
+    }
+    const confirmed = await clack3.confirm({
+      message: `Remove generated files for ${schemaName}?`,
+      initialValue: false
+    });
+    if (clack3.isCancel(confirmed) || !confirmed) {
+      clack3.cancel("Cancelled.");
       return;
     }
   }
@@ -28718,18 +28926,18 @@ async function runRemoveSchemaCommand(schemaName, options) {
     force: false,
     interactive: false
   });
-  console.log(`
-  Removed generated files for ${schemaName}.`);
-  console.log(`  Tombstone written: .betterstart/snapshots/_removed/${schemaName}`);
-  console.log("  Schema JSON preserved.");
-  console.log("");
+  clack3.log.info(
+    `Tombstone written: .betterstart/snapshots/_removed/${schemaName}
+Schema JSON preserved.`
+  );
+  clack3.outro(`Removed generated files for ${schemaName}`);
 }
 // adapters/next/commands/uninstall.ts
 import fs44 from "fs";
 import path57 from "path";
-import * as p26 from "@clack/prompts";
-import pc10 from "picocolors";
+import * as p28 from "@clack/prompts";
+import pc11 from "picocolors";
 // adapters/next/commands/uninstall-cleaners.ts
 import fs43 from "fs";
@@ -28950,8 +29158,8 @@ function buildUninstallPlan(cwd, namespaceValue) {
       count: configFiles.length,
       unit: configFiles.length === 1 ? "file" : "files",
       execute() {
-        for (const p27 of configPaths) {
-          if (fs44.existsSync(p27)) fs44.unlinkSync(p27);
+        for (const p30 of configPaths) {
+          if (fs44.existsSync(p30)) fs44.unlinkSync(p30);
         }
       }
     });
@@ -29015,7 +29223,7 @@ function buildUninstallPlan(cwd, namespaceValue) {
 }
 async function runUninstallCommand(options) {
   const cwd = options.cwd ? path57.resolve(options.cwd) : process.cwd();
-  p26.intro(pc10.bgRed(pc10.white(" BetterStart Uninstall ")));
+  p28.intro(pc11.bgRed(pc11.white(" BetterStart Uninstall ")));
   let namespace = DEFAULT_ADMIN_NAMESPACE;
   try {
     const config = await resolveConfig(cwd);
@@ -29024,23 +29232,23 @@ async function runUninstallCommand(options) {
   }
   const steps = buildUninstallPlan(cwd, namespace);
   if (steps.length === 0) {
-    p26.log.success(`${pc10.green("\u2713")} Nothing to remove \u2014 project is already clean.`);
-    p26.outro("Done");
+    p28.log.success(`${pc11.green("\u2713")} Nothing to remove \u2014 project is already clean.`);
+    p28.outro("Project already clean");
     return;
   }
   const planLines = steps.map((step) => {
     const names = step.items.join(" ");
-    const countLabel = pc10.dim(`${step.count} ${step.unit}`);
-    return `${pc10.red("\xD7")} ${names}  ${countLabel}`;
+    const countLabel = pc11.dim(`${step.count} ${step.unit}`);
+    return `${pc11.red("\u2717")} ${names}  ${countLabel}`;
   });
-  p26.note(planLines.join("\n"), "Uninstall plan");
+  p28.note(planLines.join("\n"), "Uninstall plan");
   if (!options.force) {
-    const confirmed = await p26.confirm({
+    const confirmed = await p28.confirm({
       message: "Proceed with uninstall?",
       initialValue: false
     });
-    if (p26.isCancel(confirmed) || !confirmed) {
-      p26.cancel("Uninstall cancelled.");
+    if (p28.isCancel(confirmed) || !confirmed) {
+      p28.cancel("Uninstall cancelled.");
       process.exit(0);
     }
   }
@@ -29052,15 +29260,15 @@ async function runUninstallCommand(options) {
   }
   const parts = steps.map((step) => `${step.count} ${step.unit}`);
   s.stop(`Removed ${parts.join(", ")}`);
-  p26.note(pc10.dim("Database tables were NOT dropped \u2014 drop them manually if needed."), "Next steps");
-  p26.outro("Uninstall complete");
+  p28.note(pc11.dim("Database tables were NOT dropped \u2014 drop them manually if needed."), "Next steps");
+  p28.outro("Uninstall complete");
 }
 // adapters/next/commands/update-component.ts
 import { execFileSync as execFileSync6 } from "child_process";
 import fs45 from "fs";
 import path58 from "path";
-import * as clack2 from "@clack/prompts";
+import * as clack4 from "@clack/prompts";
 import fsExtra from "fs-extra";
 var STATIC_CUSTOM_DEPENDENCIES = {
   "content-editor": [
@@ -29239,6 +29447,7 @@ var TIPTAP_TEMPLATE_DEPENDENCIES = [
   "media-field"
 ];
 var TIPTAP_CONTENT_EDITOR_DIRECTORIES = ["tiptap-extension", "tiptap-node", "tiptap-ui"];
+var MAX_OVERWRITE_PREVIEW_ROWS = 20;
 var CODEMIRROR_PACKAGE_DEPS = [
   "@codemirror/commands",
   "@codemirror/lang-javascript",
@@ -30928,50 +31137,67 @@ async function runUpdateCommand(components, options) {
   const cwd = options.cwd ? path58.resolve(options.cwd) : process.cwd();
   const normalizedOnly = normalizeShadcnPresetOnly(options.only);
   validateShadcnPresetOptions(components, options);
+  if (options.json && !options.list) {
+    clack4.cancel("--json can only be used with --list.");
+    process.exit(1);
+  }
   if (options.list) {
-    const all = getAllComponentNames();
-    clack2.intro("Available components");
     const uiComponents = getStaticUiComponentEntries();
     const customComponents = getStaticCustomComponentEntries();
     const templateKeys = Object.keys(TEMPLATE_REGISTRY).sort();
-    console.log();
-    console.log(`  Shadcn UI Components (${uiComponents.length})`);
-    console.log(`  ${"\u2500".repeat(50)}`);
-    console.log(`  ${"Name".padEnd(28)} ${"Path"}`);
-    console.log(`  ${"\u2500".repeat(50)}`);
-    for (const component of uiComponents) {
-      console.log(`  ${component.name.padEnd(28)} components/ui/${component.file}`);
-    }
-    console.log();
-    console.log(`  Custom Components (${customComponents.length})`);
-    console.log(`  ${"\u2500".repeat(56)}`);
-    console.log(`  ${"Name".padEnd(28)} ${"Path"}`);
-    console.log(`  ${"\u2500".repeat(56)}`);
-    for (const component of customComponents) {
-      console.log(`  ${component.name.padEnd(28)} components/custom/${component.file}`);
-    }
-    console.log();
-    console.log(`  Template Components (${templateKeys.length})`);
-    console.log(`  ${"\u2500".repeat(56)}`);
-    console.log(`  ${"Name".padEnd(28)} ${"Path"}`);
-    console.log(`  ${"\u2500".repeat(56)}`);
-    for (const name of templateKeys) {
+    const templatePath = (name) => {
       const entry = TEMPLATE_REGISTRY[name];
-      const relPath = entry.displayPath ?? entry.relPath;
-      console.log(`  ${name.padEnd(28)} ${relPath}`);
-    }
-    console.log();
-    console.log(`  Special`);
-    console.log(`  ${"\u2500".repeat(56)}`);
-    console.log(`  ${"tiptap".padEnd(28)} components/custom/content-editor/tiptap-*/ (all files)`);
-    console.log();
-    clack2.outro(`${all.length} components available`);
+      return entry.displayPath ?? (typeof entry.relPath === "string" ? entry.relPath : "");
+    };
+    if (options.json) {
+      const items = [
+        ...uiComponents.map((component) => ({
+          name: component.name,
+          path: `components/ui/${component.file}`,
+          kind: "ui"
+        })),
+        ...customComponents.map((component) => ({
+          name: component.name,
+          path: `components/custom/${component.file}`,
+          kind: "custom"
+        })),
+        ...templateKeys.map((name) => ({ name, path: templatePath(name), kind: "template" })),
+        { name: "tiptap", path: "components/custom/content-editor/tiptap-*/", kind: "special" }
+      ];
+      console.log(JSON.stringify(items, null, 2));
+      return;
+    }
+    const all = getAllComponentNames();
+    clack4.intro("Available components");
+    clack4.note(
+      renderTableRows(
+        uiComponents.map((component) => [component.name, `components/ui/${component.file}`])
+      ).join("\n"),
+      `Shadcn UI Components (${uiComponents.length})`
+    );
+    clack4.note(
+      renderTableRows(
+        customComponents.map((component) => [component.name, `components/custom/${component.file}`])
+      ).join("\n"),
+      `Custom Components (${customComponents.length})`
+    );
+    clack4.note(
+      renderTableRows(templateKeys.map((name) => [name, templatePath(name)])).join("\n"),
+      `Template Components (${templateKeys.length})`
+    );
+    clack4.note(
+      renderTableRows([["tiptap", "components/custom/content-editor/tiptap-*/ (all files)"]]).join(
+        "\n"
+      ),
+      "Special"
+    );
+    clack4.outro(`${all.length} components available`);
     return;
   }
-  const config = await resolveConfig(cwd);
+  const config = await resolveConfigOrExit(cwd);
   const admin = path58.resolve(cwd, config.paths.admin);
   if (!fs45.existsSync(admin)) {
-    clack2.cancel(
+    clack4.cancel(
       `Admin directory not found at ${config.paths.admin}. Run 'betterstart init' first.`
     );
     process.exit(1);
@@ -30986,12 +31212,12 @@ async function runUpdateCommand(components, options) {
     return;
   }
   if (!options.all && components.length === 0) {
-    clack2.log.error(
+    clack4.log.error(
       "Provide component names or use --all. Run with --list to see available components."
     );
     process.exit(1);
   }
-  clack2.intro("BetterStart Update Components");
+  clack4.intro("BetterStart Update Components");
   const toUpdate = options.all ? getAllComponentNamesForConfig(config) : components;
   const uiDir = resolveCliAssetPath("shared-assets", "react-admin", "ui");
   const customDir = resolveCliAssetPath("shared-assets", "react-admin", "custom");
@@ -31000,6 +31226,7 @@ async function runUpdateCommand(components, options) {
   const updatedTemplateNames = /* @__PURE__ */ new Set();
   const updatedStaticNames = /* @__PURE__ */ new Set();
   const requiredPackageDependencies = /* @__PURE__ */ new Set();
+  const pendingWrites = [];
   function trackPackageDependencies(name) {
     for (const dependency of COMPONENT_PACKAGE_DEPENDENCIES[name] ?? []) {
       requiredPackageDependencies.add(dependency);
@@ -31010,12 +31237,12 @@ async function runUpdateCommand(components, options) {
       return false;
     }
     if (entry.requiredPreset && !hasPreset(config, entry.requiredPreset)) {
-      clack2.log.warning(`${name} requires the ${entry.requiredPreset} preset and was skipped.`);
+      clack4.log.warn(`${name} requires the ${entry.requiredPreset} preset and was skipped.`);
       skipped++;
       return false;
     }
     if (entry.requiredIntegration && !hasIntegration(config, entry.requiredIntegration)) {
-      clack2.log.warning(
+      clack4.log.warn(
         `${name} requires the ${entry.requiredIntegration} integration and was skipped.`
       );
       skipped++;
@@ -31025,14 +31252,19 @@ async function runUpdateCommand(components, options) {
     const baseDir = entry.base === "cwd" ? cwd : admin;
     const destPath = path58.join(baseDir, relPath);
     if (entry.preserveExisting && fs45.existsSync(destPath)) {
-      clack2.log.info(`Preserved ${relPath}`);
+      clack4.log.info(`Preserved ${relPath}`);
       updatedTemplateNames.add(name);
       skipped++;
       return false;
     }
-    fsExtra.ensureDirSync(path58.dirname(destPath));
-    fs45.writeFileSync(destPath, content, "utf-8");
-    clack2.log.success(`Updated ${relPath}`);
+    pendingWrites.push({
+      displayPath: relPath,
+      write: () => {
+        fsExtra.ensureDirSync(path58.dirname(destPath));
+        fs45.writeFileSync(destPath, content, "utf-8");
+        clack4.log.success(`Updated ${relPath}`);
+      }
+    });
     updatedTemplateNames.add(name);
     trackPackageDependencies(name);
     updated++;
@@ -31061,17 +31293,29 @@ async function runUpdateCommand(components, options) {
     const namespace = config.frameworkConfig.next.namespace;
     const namespacedAssetFile = applyAdminNamespaceToPath(assetFile, namespace);
     const destPath = path58.join(admin, "components", assetDirectory, namespacedAssetFile);
-    fsExtra.ensureDirSync(path58.dirname(destPath));
-    writeNamespacedFile(path58.join(assetDir, assetFile), destPath, namespace);
-    clack2.log.success(`Updated components/${assetDirectory}/${namespacedAssetFile}`);
+    pendingWrites.push({
+      displayPath: `components/${assetDirectory}/${namespacedAssetFile}`,
+      write: () => {
+        fsExtra.ensureDirSync(path58.dirname(destPath));
+        writeNamespacedFile(path58.join(assetDir, assetFile), destPath, namespace);
+        clack4.log.success(`Updated components/${assetDirectory}/${namespacedAssetFile}`);
+      }
+    });
     if (assetDirectory === "custom") {
       const assetSubdir = path58.join(assetDir, name);
       if (fs45.existsSync(assetSubdir) && fs45.statSync(assetSubdir).isDirectory()) {
         const namespacedName = applyAdminNamespaceToPath(name, namespace);
         const destSubdir = path58.join(admin, "components", assetDirectory, namespacedName);
-        fsExtra.emptyDirSync(destSubdir);
-        copyNamespacedDirectory(assetSubdir, destSubdir, namespace);
-        clack2.log.success(`Updated components/${assetDirectory}/${namespacedName}/ (all files)`);
+        pendingWrites.push({
+          displayPath: `components/${assetDirectory}/${namespacedName}/ (template files)`,
+          write: () => {
+            fsExtra.ensureDirSync(destSubdir);
+            copyNamespacedDirectory(assetSubdir, destSubdir, namespace);
+            clack4.log.success(
+              `Updated components/${assetDirectory}/${namespacedName}/ (template files)`
+            );
+          }
+        });
       }
     }
     updatedStaticNames.add(key);
@@ -31100,25 +31344,34 @@ async function runUpdateCommand(components, options) {
     if (!fs45.existsSync(srcBaseDir)) {
       return false;
     }
-    let copied = false;
+    const dirsToCopy = [];
     for (const directory of TIPTAP_CONTENT_EDITOR_DIRECTORIES) {
       const srcDir = path58.join(srcBaseDir, directory);
       if (!fs45.existsSync(srcDir)) {
         continue;
       }
-      const destDir = path58.join(destBaseDir, applyAdminNamespaceToPath(directory, namespace));
-      fsExtra.emptyDirSync(destDir);
-      copyNamespacedDirectory(srcDir, destDir, namespace);
-      copied = true;
+      dirsToCopy.push({
+        srcDir,
+        destDir: path58.join(destBaseDir, applyAdminNamespaceToPath(directory, namespace))
+      });
     }
-    if (!copied) {
+    if (dirsToCopy.length === 0) {
       return false;
     }
-    clack2.log.success("Updated components/custom/content-editor/tiptap-*/ (all files)");
+    pendingWrites.push({
+      displayPath: "components/custom/content-editor/tiptap-*/ (template files)",
+      write: () => {
+        for (const { srcDir, destDir } of dirsToCopy) {
+          fsExtra.ensureDirSync(destDir);
+          copyNamespacedDirectory(srcDir, destDir, namespace);
+        }
+        clack4.log.success("Updated components/custom/content-editor/tiptap-*/ (template files)");
+        removeLegacyDirectory(path58.join(admin, "components", "custom", "tiptap"));
+      }
+    });
     updatedStaticNames.add(key);
     trackPackageDependencies("tiptap");
     updated++;
-    removeLegacyDirectory(path58.join(admin, "components", "custom", "tiptap"));
     for (const dependencyName of TIPTAP_TEMPLATE_DEPENDENCIES) {
       writeNamedDependency(dependencyName);
     }
@@ -31154,14 +31407,44 @@ async function runUpdateCommand(components, options) {
     }
     if (name === "tiptap") {
       if (!writeTiptapTemplates()) {
-        clack2.log.warning("tiptap templates not found");
+        clack4.log.warn("tiptap templates not found");
         skipped++;
       }
       continue;
     }
-    clack2.log.warning(`Unknown component: ${name}`);
+    clack4.log.warn(`Unknown component: ${name}`);
     skipped++;
   }
+  if (pendingWrites.length > 0) {
+    const displayPaths = pendingWrites.map((entry) => entry.displayPath);
+    const preview = displayPaths.slice(0, MAX_OVERWRITE_PREVIEW_ROWS);
+    if (displayPaths.length > preview.length) {
+      preview.push(`\u2026 and ${displayPaths.length - preview.length} more`);
+    }
+    clack4.note(
+      preview.join("\n"),
+      `Overwriting ${displayPaths.length} file${displayPaths.length === 1 ? "" : "s"}`
+    );
+    if (!options.yes) {
+      if (!isInteractiveSession4()) {
+        clack4.log.error(
+          `Overwriting ${displayPaths.length} file${displayPaths.length === 1 ? "" : "s"} needs confirmation. Re-run with --yes.`
+        );
+        process.exit(1);
+      }
+      const proceed = await clack4.confirm({
+        message: "Overwrite these files with the latest templates?",
+        initialValue: true
+      });
+      if (clack4.isCancel(proceed) || !proceed) {
+        clack4.cancel("Update cancelled.");
+        process.exit(0);
+      }
+    }
+    for (const entry of pendingWrites) {
+      entry.write();
+    }
+  }
   syncInstalledPresetManifests(cwd, config);
   syncInstalledIntegrationManifests(cwd, config);
   const projectPackageJson = readProjectPackageJson2(cwd);
@@ -31169,11 +31452,11 @@ async function runUpdateCommand(components, options) {
     (dependency) => !hasDeclaredPackage2(projectPackageJson, dependency)
   );
   if (missingPackageDependencies.length > 0) {
-    clack2.log.warning(
+    clack4.log.warn(
       `Updated components require package dependencies that are not declared: ${missingPackageDependencies.join(", ")}. Run 'pnpm betterstart update-deps' before building.`
     );
   }
-  clack2.outro(
+  clack4.outro(
     `Updated ${updated} component${updated !== 1 ? "s" : ""}${skipped > 0 ? `, ${skipped} skipped` : ""}`
   );
 }
@@ -31184,22 +31467,22 @@ function removeLegacyDirectory(dirPath) {
 }
 function validateShadcnPresetOptions(components, options) {
   if (options.only && !options.shadcnPreset) {
-    clack2.cancel("--only can only be used with --shadcn-preset.");
+    clack4.cancel("--only can only be used with --shadcn-preset.");
     process.exit(1);
   }
   if (!options.shadcnPreset) {
     return;
   }
   if (options.list) {
-    clack2.cancel("--list cannot be combined with --shadcn-preset.");
+    clack4.cancel("--list cannot be combined with --shadcn-preset.");
     process.exit(1);
   }
   if (options.all) {
-    clack2.cancel("--all cannot be combined with --shadcn-preset.");
+    clack4.cancel("--all cannot be combined with --shadcn-preset.");
     process.exit(1);
   }
   if (components.length > 0) {
-    clack2.cancel("Component names cannot be combined with --shadcn-preset.");
+    clack4.cancel("Component names cannot be combined with --shadcn-preset.");
     process.exit(1);
   }
 }
@@ -31209,7 +31492,7 @@ function normalizeShadcnPresetOnly(value) {
   }
   const parts = value.split(",").map((part) => part.trim().toLowerCase()).filter(Boolean);
   if (parts.length !== 1 || parts[0] !== "theme") {
-    clack2.cancel(
+    clack4.cancel(
       "Admin-only shadcn preset updates currently support --only theme. Omit --only to apply the full preset."
     );
     process.exit(1);
@@ -31233,11 +31516,11 @@ function runShadcnPresetUpdate({
     ...getHostProjectFilesToRestore(cwd)
   ];
   if (!preset) {
-    clack2.cancel("--shadcn-preset requires a preset code, preset name, or preset URL.");
+    clack4.cancel("--shadcn-preset requires a preset code, preset name, or preset URL.");
     process.exit(1);
   }
   if (!fs45.existsSync(adminGlobalsPath)) {
-    clack2.cancel(
+    clack4.cancel(
       `Admin globals file not found at ${path58.relative(cwd, adminGlobalsPath)}. Run 'betterstart update admin-globals' first.`
     );
     process.exit(1);
@@ -31247,8 +31530,8 @@ function runShadcnPresetUpdate({
     filePath,
     snapshot: snapshotFile(filePath)
   }));
-  clack2.intro("BetterStart Shadcn Preset");
-  clack2.log.info(`Applying preset to ${path58.join(config.paths.admin, "components/ui")}`);
+  clack4.intro("BetterStart Shadcn Preset");
+  clack4.log.info(`Applying preset to ${path58.join(config.paths.admin, "components/ui")}`);
   let failed = false;
   try {
     fs45.writeFileSync(
@@ -31270,10 +31553,10 @@ function runShadcnPresetUpdate({
     }
   }
   if (failed) {
-    clack2.cancel("shadcn preset application failed.");
+    clack4.cancel("shadcn preset application failed.");
     process.exit(1);
   }
-  clack2.outro(
+  clack4.outro(
     only ? `Applied shadcn preset parts (${only}) to the Admin.` : "Applied shadcn preset to Admin UI components and styles."
   );
 }
@@ -31309,7 +31592,7 @@ function resolveLocalShadcnBin(cwd) {
   const binName = process.platform === "win32" ? "shadcn.cmd" : "shadcn";
   const shadcnBin = path58.join(cwd, "node_modules", ".bin", binName);
   if (!fs45.existsSync(shadcnBin)) {
-    clack2.cancel(
+    clack4.cancel(
       `shadcn is not installed in this project. Run 'betterstart update-deps' and try again.`
     );
     process.exit(1);
@@ -31349,13 +31632,13 @@ function restoreFile(filePath, snapshot) {
 // adapters/next/commands/update-deps.ts
 import path59 from "path";
-import * as clack3 from "@clack/prompts";
+import * as clack5 from "@clack/prompts";
 async function runUpdateDepsCommand(options) {
   const cwd = options.cwd ? path59.resolve(options.cwd) : process.cwd();
-  clack3.intro("BetterStart Update Dependencies");
+  clack5.intro("BetterStart Update Dependencies");
   const pm = detectPackageManager(cwd);
-  clack3.log.info(`Package manager: ${pm}`);
-  const config = await resolveConfig(cwd);
+  clack5.log.info(`Package manager: ${pm}`);
+  const config = await resolveConfigOrExit(cwd);
   const dependencyPlan = getDependencyPlan(
     getInstalledPresets(config),
     getInstalledIntegrations(config),
@@ -31378,25 +31661,25 @@ async function runUpdateDepsCommand(options) {
     s.stop(`Installed ${result.dependencies.length} deps + ${result.devDeps.length} dev deps`);
   } else {
     s.stop("Dependency install failed");
-    clack3.log.error(result.error ?? "Unknown error");
+    clack5.log.error(result.error ?? "Unknown error");
     process.exit(1);
   }
-  clack3.outro("Dependencies updated");
+  clack5.outro("Dependencies updated");
 }
 // adapters/next/commands/update-styles.ts
 import fs46 from "fs";
 import path60 from "path";
-import * as clack4 from "@clack/prompts";
+import * as clack6 from "@clack/prompts";
 async function runUpdateStylesCommand(options) {
   const cwd = options.cwd ? path60.resolve(options.cwd) : process.cwd();
-  clack4.intro("BetterStart Update Styles");
-  const config = await resolveConfig(cwd);
+  clack6.intro("BetterStart Update Styles");
+  const config = await resolveConfigOrExit(cwd);
   const adminDir = config.paths.admin;
   const namespace = resolveAdminNamespace(config.frameworkConfig.next.namespace);
   const targetPath = path60.join(cwd, adminDir, namespace.globalsFile);
   if (!fs46.existsSync(targetPath)) {
-    clack4.cancel(`${namespace.globalsFile} not found at ${path60.relative(cwd, targetPath)}`);
+    clack6.cancel(`${namespace.globalsFile} not found at ${path60.relative(cwd, targetPath)}`);
     process.exit(1);
   }
   fs46.writeFileSync(
@@ -31404,8 +31687,8 @@ async function runUpdateStylesCommand(options) {
     applyAdminNamespaceToContent(readTemplate("admin-globals.css"), namespace.segment),
     "utf-8"
   );
-  clack4.log.success(`Updated ${path60.relative(cwd, targetPath)}`);
-  clack4.outro("Styles updated");
+  clack6.log.success(`Updated ${path60.relative(cwd, targetPath)}`);
+  clack6.outro("Styles updated");
 }
 // adapters/next/commands-runtime.ts
@@ -31428,11 +31711,12 @@ var nextCommandRuntime = {
 // cli.ts
 import { Command as Command2 } from "commander";
+import pc12 from "picocolors";
 var { version } = JSON.parse(
   readFileSync(new URL("../package.json", import.meta.url), "utf-8")
 );
 var program = new Command2();
-program.name("betterstart").description("Scaffold a preset and integration based Admin into any Next.js 16 application").version(version);
+program.name("betterstart").description("Scaffold a preset- and integration-based Admin into any Next.js 16 application").version(version);
 program.hook("preAction", (_command, actionCommand) => {
   requireInitializedProject(actionCommand);
 });
@@ -31450,5 +31734,16 @@ program.addCommand(createUninstallCommand(nextCommandRuntime));
 program.addCommand(createUpdateCommand(nextCommandRuntime));
 program.addCommand(createUpdateDepsCommand(nextCommandRuntime));
 program.addCommand(createUpdateStylesCommand(nextCommandRuntime));
-program.parse();
+try {
+  await program.parseAsync();
+} catch (error) {
+  if (process.env.BETTERSTART_DEBUG) {
+    console.error(error);
+  } else {
+    const message = error instanceof Error && error.message ? error.message : String(error);
+    p29.log.error(message);
+    p29.log.message(pc12.dim("Re-run with BETTERSTART_DEBUG=1 for the full stack trace."));
+  }
+  process.exit(1);
+}
 //# sourceMappingURL=cli.js.map