@beechcms/cms 0.6.0-preview.3 → 0.6.0

package/bin/cli.mjs

@@ -5,77 +5,94 @@ import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { resolve } from 'node:path'
 import { pathToFileURL } from 'node:url'
-
+import pc from 'picocolors'
 
 const [,, command, ...args] = process.argv
 
 const COMMANDS = {
-  build:          cmdBuild,
-  'seed:load':    cmdSeedLoad,
-  'seed:create':  cmdSeedCreate,
-  'init':         cmdInit,
-  'validate':     cmdValidate,
-  'deploy':       cmdDeploy,
-  'update':       cmdUpdate,
-  'onboard':      cmdOnboard,
-  'reset':        cmdReset,
+  build:            cmdBuild,
+  'seed:load':      cmdSeedLoad,
+  'seed:create':    cmdSeedCreate,
+  'schema:diff':    cmdSchemaDiff,
+  'init':           cmdInit,
+  'validate':       cmdValidate,
+  'deploy':         cmdDeploy,
+  'update':         cmdUpdate,
+  'onboard':        cmdOnboard,
+  'reset':          cmdReset,
+  'generate:types': cmdGenerateTypes,
+  // New unified command mappings:
+  'db:migrate':     cmdDbMigrate,
+  'db:reset':       cmdDbReset,
+  'dev':            cmdDev,
+  'start':          cmdDev,
+  'dev:stop':       cmdDevStop,
+  'dev:reset':      cmdDevReset,
+  'dev:tunnel':     cmdDevTunnel,
+  'mailpit:clear':  cmdMailpitClear,
+  'logs':           cmdLogs,
+  'test':           cmdTest,
+  'lint':           cmdLint,
+  'doctor':         cmdDoctor,
 }
 
 function help() {
   console.log(`
-  beech <command> [options]
+  ${pc.cyan('beech')} <command> [options]
 
-  Commands:
-    init            Check project files and optionally initialise the database
+  ${pc.bold('1. Local Management & Onboarding')}
+    ${pc.cyan('init')}            Check project files and optionally initialise the database
       --db            Also initialise the D1 database (system tables)
       --remote        Target remote D1 instead of local (default: local)
       --db-name <n>   Override D1 database name
+      --yes, -y       Run in non-interactive mode
+    ${pc.cyan('onboard')}         One-command local provisioning (init --db + seed:load)
+      --remote        Target remote D1 instead of local (default: local)
+      --yes, -y       Skip all interactive prompts (non-interactive mode)
+      --db <name>     Override D1 database name
+    ${pc.cyan('update')}          Update internals to latest, then apply system D1 migrations
 
-    build           Rebuild @beechcms/core after editing seeds.ts
-
-    validate        Validate SEED_REGISTRY for common errors (duplicate aliases,
-                    missing displayNameAlias, duplicate slugs). Exit code 1 on errors.
+  ${pc.bold('2. Database & Migrations')}
+    ${pc.cyan('db:migrate')}      Apply all pending local migrations
+    ${pc.cyan('db:reset')}        Remove local Wrangler state and re-bootstrap database
 
-    seed:load       Create/update content tables from SEED_REGISTRY
+  ${pc.bold('3. Seed & Schema Management')}
+    ${pc.cyan('seed:create')}     Interactive wizard — generate a new Seed schema in seeds.ts
+    ${pc.cyan('seed:load')}       Create/update content tables from SEED_REGISTRY
       --dry-run       Print SQL without executing
       --diff          Show schema differences vs current DB
       --remote        Execute against remote D1 (default: local)
       --db <name>     Override D1 database name
-
-    seed:create     Interactive wizard — generate a new Seed definition and append
-                    it to seeds.ts, including SEED_REGISTRY entry
-
-    deploy          Deploy Worker, sync remote schema, and verify /admin
+    ${pc.cyan('schema:diff')}     Diff SEED_REGISTRY vs D1 and generate additive SQL migration
+      --write         Write the migration file (default: preview only)
+      --name <name>   Migration name used in the filename
+      --remote        Diff against remote D1 (default: local)
+      --db <name>     Override D1 database name
+    ${pc.cyan('validate')}        Validate seeds registry for errors
+    ${pc.cyan('generate:types')}  Generate TypeScript interfaces from seed definitions
+      --out <path>    Output file (default: src/types/beech.ts)
+      --local         Read from seeds.ts instead of querying live D1
+
+  ${pc.bold('4. Local Stack & Docker')}
+    ${pc.cyan('dev / start')}     Start the local dev environment (Docker + API + Dashboard)
+      --plain         Avoid Ink visual TUI and run clean log streaming
+    ${pc.cyan('dev:stop')}        Stop Docker containers without wiping data
+    ${pc.cyan('dev:reset')}       Stop Docker containers and remove all persistent volumes
+    ${pc.cyan('dev:tunnel')}      Display Cloudflare tunnel public testing URL
+    ${pc.cyan('mailpit:clear')}   Clear local test inbox in Mailpit
+
+  ${pc.bold('5. Logs Streaming')}
+    ${pc.cyan('logs <service>')}   Show streaming logs for docker service: mailpit, db, tunnel, storage
+
+  ${pc.bold('6. Quality & Deployment')}
+    ${pc.cyan('test')}            Run the test suite via Turborepo / Vitest
+      --coverage      Generate coverage reports
+      --diff          Run test coverage only for files modified on the branch
+    ${pc.cyan('lint')}            Run ESLint quality checks
+    ${pc.cyan('deploy')}          Compile, test, deploy to Cloudflare environment
       --skip-seed     Skip remote seed:load step
       --skip-check    Skip /admin reachability check
-
-    update          Update @beechcms/api and @beechcms/core to latest, then
-                    apply any new system migrations to the local database
-
-    onboard         One-command local provisioning (init + seed:load). Designed
-                    for non-interactive use by agents and CI.
-      --remote        Target remote D1 instead of local (default: local)
-      --yes           Skip all interactive prompts (non-interactive mode)
-      --db <name>     Override D1 database name
-
-    reset           Reset database and/or Docker containers/volumes
-      --db            Wipe local Wrangler state & bootstrap D1 DB
-      --docker        Down Docker containers and wipe volumes
-      --all           Reset both (database & docker)
-
-  Scaffold a new project (interactive, or pass --yes for non-interactive defaults):
-    npm create @beechcms/cms [project-name] [--yes] [--with-examples]
-
-  Golden path (local):
-    npx beech onboard --local --yes   # fully automated
-    # or step by step:
-    npx beech init --db --local
-    npx beech seed:load --local
-    npx wrangler dev
-
-  Golden path (deploy):
-    npx beech deploy
-    npx beech init --db --remote   # verify remote DB post-deploy
+    ${pc.cyan('doctor')}          Execute React diagnostics check on Dashboard
 `)
 }
 
@@ -159,9 +176,10 @@ async function cmdInit(args) {
   const remote  = args.includes('--remote')
   const dbIdx   = args.indexOf('--db-name')
   const db      = dbIdx !== -1 ? args[dbIdx + 1] : undefined
+  const yes     = args.includes('--yes') || args.includes('-y')
 
   const { init } = await import('@beechcms/cli')
-  await init({ initDb, local: !remote, db })
+  await init({ initDb, local: !remote, db, yes })
 }
 
 async function cmdSeedLoad(args) {
@@ -203,7 +221,7 @@ async function cmdUpdate(_args) {
 
 async function cmdOnboard(args) {
   const local    = !args.includes('--remote')
-  const yes      = args.includes('--yes')
+  const yes      = args.includes('--yes') || args.includes('-y')
   const dbIdx    = args.indexOf('--db')
   const db       = dbIdx !== -1 ? args[dbIdx + 1] : undefined
   const registry = await tryLoadLocalRegistry()
@@ -215,9 +233,95 @@ async function cmdReset(args) {
   const db     = args.includes('--db')
   const docker = args.includes('--docker')
   const all    = args.includes('--all')
-  
+  const yes    = args.includes('--yes') || args.includes('-y')
+
   const { reset } = await import('@beechcms/cli')
-  await reset({ db, docker, all })
+  await reset({ db, docker, all, yes })
+}
+
+async function cmdSchemaDiff(args) {
+  const remote  = args.includes('--remote')
+  const write   = args.includes('--write')
+  const nameIdx = args.indexOf('--name')
+  const name    = nameIdx !== -1 ? args[nameIdx + 1] : undefined
+  const dbIdx   = args.indexOf('--db')
+  const db      = dbIdx !== -1 ? args[dbIdx + 1] : undefined
+  const registry = await tryLoadLocalRegistry()
+  const { schemaDiff } = await import('@beechcms/cli')
+  await schemaDiff({ local: !remote, write, name, db, registry })
+}
+
+async function cmdGenerateTypes(args) {
+  const outIdx = args.indexOf('--out')
+  const out    = outIdx !== -1 ? args[outIdx + 1] : 'src/types/beech.ts'
+  const local  = args.includes('--local')
+  const dbIdx  = args.indexOf('--db')
+  const db     = dbIdx !== -1 ? args[dbIdx + 1] : undefined
+
+  const registry = local ? await tryLoadLocalRegistry() : null
+
+  const { generateTypes } = await import('@beechcms/cli')
+  await generateTypes({ out, local, db, registry })
+}
+
+// New unified command wrappers:
+async function cmdDbMigrate(args) {
+  const { dbMigrate } = await import('@beechcms/cli')
+  await dbMigrate({})
+}
+
+async function cmdDbReset(args) {
+  const { dbReset } = await import('@beechcms/cli')
+  await dbReset({})
+}
+
+async function cmdDev(args) {
+  const plain = args.includes('--plain')
+  const { dev } = await import('@beechcms/cli')
+  await dev({ plain })
+}
+
+async function cmdDevStop(args) {
+  const { devStop } = await import('@beechcms/cli')
+  await devStop()
+}
+
+async function cmdDevReset(args) {
+  const { devReset } = await import('@beechcms/cli')
+  await devReset()
+}
+
+async function cmdDevTunnel(args) {
+  const { devTunnel } = await import('@beechcms/cli')
+  await devTunnel()
+}
+
+async function cmdMailpitClear(args) {
+  const { mailpitClear } = await import('@beechcms/cli')
+  await mailpitClear()
+}
+
+async function cmdLogs(args) {
+  const service = args[0]
+  const { logs } = await import('@beechcms/cli')
+  await logs({ service })
+}
+
+async function cmdTest(args) {
+  const coverage = args.includes('--coverage')
+  const diff     = args.includes('--diff')
+  const { test } = await import('@beechcms/cli')
+  await test({ coverage, diff })
+}
+
+async function cmdLint(args) {
+  const { lint } = await import('@beechcms/cli')
+  await lint()
+}
+
+async function cmdDoctor(args) {
+  const { doctor } = await import('@beechcms/cli')
+  await doctor()
 }
 
 const handler = COMMANDS[command]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beechcms/cms",
-  "version": "0.6.0-preview.3",
+  "version": "0.6.0",
   "description": "Edge-Native, Schema-Driven Headless CMS built on Cloudflare Workers, D1, and R2. Features the Botanical Engine for alias-stable field management, a modular widget layer, and a React + Vite admin dashboard.",
   "keywords": [
     "cms",
@@ -38,9 +38,13 @@
   },
   "type": "module",
   "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
     "@vitest/coverage-v8": "^4.1.0",
     "cross-env": "^10.1.0",
+    "eslint": "^9.39.1",
     "execa": "^9.6.1",
+    "globals": "^16.5.0",
     "husky": "^9.1.7",
     "ink": "^6.8.0",
     "ink-spinner": "^5.0.0",
@@ -52,11 +56,16 @@
     "strip-ansi": "^7.2.0",
     "tsx": "^4.22.4",
     "turbo": "^2.9.18",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.12.0",
+    "typescript": "^7.0.2",
+    "typescript-eslint": "^8.63.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.1.0",
+    "vue": "^3.5.39"
   },
   "dependencies": {
-    "@beechcms/cli": "^0.6.0-preview.3",
+    "@beechcms/cli": "^0.6.0",
     "@clack/prompts": "^0.9.1",
     "picocolors": "^1.1.1"
   },
@@ -73,6 +82,11 @@
     }
   },
   "scripts": {
+    "docs:generate": "typedoc",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "typedoc && vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "beech": "node bin/cli.mjs",
     "dev": "node scripts/dev.mjs",
     "dev:full": "node scripts/dev.mjs",
     "dev:plain": "cross-env BEECH_DEV_PLAIN=1 node scripts/dev.mjs",
@@ -85,11 +99,13 @@
     "dev:stop": "docker compose -f docker/docker-compose.yml stop",
     "dev:reset": "docker compose -f docker/docker-compose.yml down -v",
     "build": "turbo run build",
+    "lint": "turbo run lint",
     "type-check": "turbo run type-check",
     "test": "turbo run test",
     "test:coverage": "turbo run test:coverage",
     "test:diff": "node scripts/test-coverage-diff.mjs",
     "test:dev-cli": "vitest run --config scripts/dev-cli/vitest.config.ts",
+    "pipeline": "node scripts/pipeline.mjs",
     "setup:graph": "node scripts/setup-graph.mjs",
     "release": "node scripts/release.mjs",
     "release:preview": "node scripts/release.mjs --preview",