@beechcms/cli 0.6.0-preview.2 → 0.6.0-preview.4

package/src/commands/onboard.ts

@@ -1,32 +1,32 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-
-import pc from 'picocolors'
-import type { Seed } from '@beechcms/core'
-import { init } from './init.js'
-import { seedLoad } from './seed-load.js'
-
-export interface OnboardOptions {
-  local: boolean
-  yes: boolean
-  db?: string
-  registry?: Record<string, Seed> | null
-}
-
-export async function onboard(args: OnboardOptions): Promise<void> {
-  console.log(pc.cyan('\n  beech onboard — full provisioning\n'))
-
-  // Step 1: file check + DB init
-  await init({ initDb: true, local: args.local, db: args.db, nonInteractive: args.yes })
-
-  // Step 2: create content tables + register definitions + bump registry_version
-  await seedLoad({ dryRun: false, diff: false, local: args.local, db: args.db, registry: args.registry ?? null })
-
-  // Step 3: next steps
-  console.log(pc.cyan('\n  Provisioning complete.\n'))
-  console.log(pc.dim('  Next steps:'))
-  console.log(pc.cyan('  1. npx wrangler dev'))
-  console.log(pc.dim('      → start API + dashboard'))
-  console.log(pc.dim('  2. Open http://localhost:8789/admin'))
-  console.log(pc.dim('      → complete setup wizard to create admin user\n'))
-}
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+
+import pc from 'picocolors'
+import type { Seed } from '@beechcms/core'
+import { init } from './init.js'
+import { seedLoad } from './seed-load.js'
+
+export interface OnboardOptions {
+  local: boolean
+  yes: boolean
+  db?: string
+  registry?: Record<string, Seed> | null
+}
+
+export async function onboard(args: OnboardOptions): Promise<void> {
+  console.log(pc.cyan('\n  beech onboard — full provisioning\n'))
+
+  // Step 1: file check + DB init
+  await init({ initDb: true, local: args.local, db: args.db, nonInteractive: args.yes })
+
+  // Step 2: create content tables + register definitions + bump registry_version
+  await seedLoad({ dryRun: false, diff: false, local: args.local, db: args.db, registry: args.registry ?? null })
+
+  // Step 3: next steps
+  console.log(pc.cyan('\n  Provisioning complete.\n'))
+  console.log(pc.dim('  Next steps:'))
+  console.log(pc.cyan('  1. npx wrangler dev'))
+  console.log(pc.dim('      → start API + dashboard'))
+  console.log(pc.dim('  2. Open http://localhost:8789/admin'))
+  console.log(pc.dim('      → complete setup wizard to create admin user\n'))
+}

package/src/commands/reset.ts

@@ -0,0 +1,157 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+
+import pc from 'picocolors'
+import { spawnSync } from 'node:child_process'
+import { existsSync, readFileSync, rmSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { createInterface } from 'node:readline/promises'
+
+export interface ResetOptions {
+  db?: boolean
+  docker?: boolean
+  all?: boolean
+}
+
+function isDockerInstalled(): boolean {
+  try {
+    const result = spawnSync('docker', ['--version'], { stdio: 'ignore', shell: true })
+    return result.status === 0
+  } catch {
+    return false
+  }
+}
+
+function isDockerRunning(): boolean {
+  try {
+    const result = spawnSync('docker', ['info'], { stdio: 'ignore', shell: true })
+    return result.status === 0
+  } catch {
+    return false
+  }
+}
+
+export async function reset(args: ResetOptions): Promise<void> {
+  console.log(pc.cyan('\n  beech reset — cleanup environments\n'))
+
+  let resetDb = args.db || args.all
+  let resetDocker = args.docker || args.all
+
+  if (!args.db && !args.docker && !args.all) {
+    if (process.stdin.isTTY) {
+      const rl = createInterface({ input: process.stdin, output: process.stdout })
+      try {
+        const answer = (await rl.question(
+          pc.cyan('  → No options provided. Would you like to reset everything (DB & Docker)? (y/N): ')
+        )).trim().toLowerCase()
+        if (answer === 'y' || answer === 'yes') {
+          resetDb = true
+          resetDocker = true
+        } else {
+          console.log(pc.dim('\n  Reset cancelled. Use --db, --docker, or --all.\n'))
+          return
+        }
+      } finally {
+        rl.close()
+      }
+    } else {
+      console.log(pc.red('\n  ✗ Error: Please specify what to reset using --db, --docker, or --all.\n'))
+      process.exit(1)
+    }
+  }
+
+  const cwd = process.cwd()
+
+  // Reset Docker
+  if (resetDocker) {
+    if (!isDockerInstalled()) {
+      console.log(pc.red('  ✗ Docker is not installed or not found in your PATH.'))
+      console.log(pc.dim('    Please install Docker to reset Docker containers and volumes.\n'))
+      if (!args.all) {
+        process.exit(1)
+      }
+    } else if (!isDockerRunning()) {
+      console.log(pc.yellow('  ⚠ Docker is installed, but the Docker daemon is NOT running.'))
+      console.log(pc.dim('    Please start Docker Desktop or your Docker daemon to reset containers.\n'))
+      if (!args.all) {
+        process.exit(1)
+      }
+    } else {
+      console.log(pc.dim('  Resetting Docker containers and volumes…\n'))
+      const result = spawnSync('docker', ['compose', 'down', '-v'], {
+        stdio: 'inherit',
+        cwd,
+        shell: true,
+      })
+
+      if (result.status === 0) {
+        console.log(pc.green('\n  ✓ Docker containers stopped and volumes removed.'))
+      } else {
+        console.log(pc.red('\n  ✗ Docker reset failed.'))
+      }
+    }
+  }
+
+  // Reset DB
+  if (resetDb) {
+    console.log(pc.dim('\n  Resetting local database…\n'))
+    let dbResetSuccess = false
+    const apiDir = resolve(cwd, 'apps', 'api')
+
+    if (existsSync(resolve(apiDir, 'package.json'))) {
+      const result = spawnSync('npm', ['run', 'db:reset:local'], {
+        stdio: 'inherit',
+        cwd: apiDir,
+        shell: true,
+      })
+      dbResetSuccess = result.status === 0
+    } else if (existsSync(resolve(cwd, 'package.json'))) {
+      const pkg = JSON.parse(readFileSync(resolve(cwd, 'package.json'), 'utf-8'))
+      if (pkg.scripts?.['db:reset:local']) {
+        const result = spawnSync('npm', ['run', 'db:reset:local'], {
+          stdio: 'inherit',
+          cwd,
+          shell: true,
+        })
+        dbResetSuccess = result.status === 0
+      } else {
+        const wranglerStateDir = resolve(cwd, '.wrangler/state')
+        if (existsSync(wranglerStateDir)) {
+          console.log(pc.dim('  Removing .wrangler/state…'))
+          rmSync(wranglerStateDir, { recursive: true, force: true })
+        }
+        if (existsSync(resolve(cwd, 'scripts', 'bootstrap-d1.mjs'))) {
+          const result = spawnSync('node', ['scripts/bootstrap-d1.mjs'], {
+            stdio: 'inherit',
+            cwd,
+            shell: true,
+          })
+          dbResetSuccess = result.status === 0
+        } else {
+          console.log(pc.yellow('  ⚠ Could not find database reset script.'))
+          const initResult = spawnSync('npx', ['beech', 'init', '--db', '--local'], {
+            stdio: 'inherit',
+            cwd,
+            shell: true,
+          })
+          dbResetSuccess = initResult.status === 0
+        }
+      }
+    } else {
+      const wranglerStateDir = resolve(cwd, '.wrangler/state')
+      if (existsSync(wranglerStateDir)) {
+        console.log(pc.dim('  Removing .wrangler/state…'))
+        rmSync(wranglerStateDir, { recursive: true, force: true })
+      }
+      dbResetSuccess = true
+    }
+
+    if (dbResetSuccess) {
+      console.log(pc.green('\n  ✓ Local database reset completed.'))
+    } else {
+      console.log(pc.red('\n  ✗ Database reset failed.'))
+    }
+  }
+
+  console.log(pc.dim('\n  Reset process finished.\n'))
+}

package/src/commands/schema-diff.ts

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+
+import pc from 'picocolors'
+import { resolve } from 'node:path'
+import { SEED_REGISTRY, sortSeedsByDependencies, type Seed } from '@beechcms/core'
+import { findWranglerConfig, resolveDbName, type WranglerOptions } from '../lib/wrangler.js'
+import { diffSeed, renderSeedDiff, isSeedClean } from '../lib/schema-diff.js'
+import { nextMigrationIndex, buildMigrationSql, writeMigrationFile } from '../lib/migration-writer.js'
+
+export interface SchemaDiffOptions {
+  /** Compare against remote D1 (default: local). */
+  local: boolean
+  /** When set, write an additive migration file instead of just printing. */
+  write: boolean
+  /** Optional migration name (used in the filename). */
+  name?: string
+  /** Override migrations dir (default: <cwd>/apps/api/migrations). */
+  migrationsDir?: string
+  /** Override D1 database name. */
+  db?: string
+  registry?: Record<string, Seed> | null
+}
+
+function resolveMigrationsDir(override?: string): string {
+  if (override) return resolve(process.cwd(), override)
+  return resolve(process.cwd(), 'apps', 'api', 'migrations')
+}
+
+export async function schemaDiff(args: SchemaDiffOptions): Promise<void> {
+  const registry = args.registry ?? SEED_REGISTRY
+  if (Object.keys(registry).length === 0) {
+    console.log(pc.yellow('\n  ✗ No seeds found — nothing to diff.\n'))
+    return
+  }
+
+  const configPath = findWranglerConfig()
+  const options: WranglerOptions = { db: args.db ?? resolveDbName(configPath), local: args.local, configPath }
+  const seeds = sortSeedsByDependencies(Object.values(registry))
+
+  console.log(pc.cyan(`\n  Diffing schema vs ${args.local ? 'local' : 'remote'} D1 (${options.db})…\n`))
+  const diffs = []
+  let clean = true
+  for (const seed of seeds) {
+    const d = await diffSeed(seed, options)
+    diffs.push(d)
+    renderSeedDiff(d)
+    if (!isSeedClean(d)) clean = false
+  }
+
+  if (clean) { console.log(pc.green('\n  Schema matches seeds. No migration needed.\n')); return }
+
+  const plan = buildMigrationSql(diffs, registry)
+  if (!args.write) {
+    console.log(pc.dim('\n  -- proposed additive migration (preview):\n'))
+    console.log(plan.sql)
+    if (plan.destructiveSlugs.length) {
+      console.log(pc.yellow(`\n  ⚠ Destructive drift in: ${plan.destructiveSlugs.join(', ')} — not auto-migrated.`))
+    }
+    console.log(pc.cyan('\n  → Re-run with --write to save the migration file.\n'))
+    return
+  }
+
+  if (plan.additiveCount === 0) {
+    console.log(pc.yellow('\n  ⚠ Only destructive drift detected — no additive migration written.'))
+    console.log(pc.dim('  Author a reviewed migration by hand for renames/drops/type changes.\n'))
+    return
+  }
+
+  const dir = resolveMigrationsDir(args.migrationsDir)
+  const index = nextMigrationIndex(dir)
+  const file = writeMigrationFile(dir, index, args.name ?? 'schema_sync', plan.sql)
+  console.log(pc.green(`\n  ✓ Wrote ${file} (${plan.additiveCount} statement(s)).`))
+  console.log(pc.dim('  Review, commit, then `wrangler d1 migrations apply --remote` in CI.\n'))
+  if (plan.destructiveSlugs.length) {
+    console.log(pc.yellow(`  ⚠ Destructive drift in ${plan.destructiveSlugs.join(', ')} was NOT included.\n`))
+  }
+}