Add local dev bootstrap command

README.md

@@ -20,14 +20,21 @@ Turbopack-first rebuild of a fiscal.ai-style terminal with Vercel AI SDK integra
 
 ```bash
 bun install
-bun run db:generate
-bun run db:migrate
+cp .env.example .env
 bun run dev
 ```
 
 Open [http://localhost:3000](http://localhost:3000).
 
-The default database path is `data/fiscal.sqlite` via `DATABASE_URL=file:data/fiscal.sqlite`.
+`bun run dev` is the local-safe entrypoint. It bootstraps the local SQLite schema from `drizzle/` when needed, forces Better Auth to a localhost origin, uses same-origin API calls, and falls back to local SQLite + Workflow local runtime even if `.env` still contains deployment-oriented values. If port `3000` is already in use and you did not set `PORT`, it automatically picks the next open local port and keeps Better Auth in sync with that port.
+
+If you need raw `next dev` behavior without those overrides, use:
+
+```bash
+bun run dev:next
+```
+
+The default local database path is `data/fiscal.sqlite` via `DATABASE_URL=file:data/fiscal.sqlite`.
 
 ## Production build
 
@@ -116,8 +123,8 @@ Use root `.env` or root `.env.local`:
 NEXT_PUBLIC_API_URL=
 DATABASE_URL=file:data/fiscal.sqlite
 BETTER_AUTH_SECRET=replace-with-a-long-random-secret
-BETTER_AUTH_BASE_URL=https://fiscal.b11studio.xyz
-BETTER_AUTH_TRUSTED_ORIGINS=https://fiscal.b11studio.xyz
+BETTER_AUTH_BASE_URL=http://localhost:3000
+BETTER_AUTH_TRUSTED_ORIGINS=http://localhost:3000
 
 ZHIPU_API_KEY=
 ZHIPU_MODEL=glm-5
@@ -126,7 +133,10 @@ AI_TEMPERATURE=0.2
 
 SEC_USER_AGENT=Fiscal Clone <support@fiscal.local>
 
-WORKFLOW_TARGET_WORLD=@workflow/world-postgres
+# local dev default
+WORKFLOW_TARGET_WORLD=local
+
+# docker / production runtime
 WORKFLOW_POSTGRES_URL=postgres://workflow:workflow@workflow-postgres:5432/workflow
 WORKFLOW_POSTGRES_WORKER_CONCURRENCY=10
 WORKFLOW_POSTGRES_JOB_PREFIX=fiscal_
@@ -138,6 +148,7 @@ WORKFLOW_LOCAL_QUEUE_CONCURRENCY=100
 
 `ZHIPU_API_KEY` is required for AI workloads (extraction and report generation). Missing or invalid credentials fail AI tasks.
 `ZHIPU_BASE_URL` is deprecated and ignored; runtime always uses `https://api.z.ai/api/coding/paas/v4`.
+`bun run dev` will still normalize Better Auth origin, same-origin API routing, SQLite path, and Workflow runtime for localhost boot if this file contains deployment values.
 
 ## API surface