business-stack 0.1.11 → 0.1.13

package/README.md

@@ -62,12 +62,24 @@ npx business-stack start
 ```
 
 - **`setup`** generates secrets, stores them in SQLite (`node_modules/business-stack/gateway/auth.sqlite`, table `stack_secrets`), and writes `gateway/.env`, `frontend/web/.env.local`, and `backend/.env` under that package path. You do not need to create `.env` files by hand.
-- **`start`** runs **`npm install`** (workspaces), **`uv sync`**, Alembic migrations, then **`npm run start`** (Turborepo: Next standalone, compiled gateway, FastAPI). The published tarball ships **pre-built** Next.js and gateway output, so **`npm run build` is skipped** on the installed package. First run can still take several minutes (Python deps + native modules).
+- **`start`** runs **`npm install`** (workspaces), **`uv sync`**, **Better Auth** migrations on `gateway/auth.sqlite` (`user`, session, etc.), **Alembic** on the backend DB, then **`npm run start`**. The published tarball ships **pre-built** Next.js and gateway JS, so **`npm run build` is skipped**. First run can still take several minutes (Python deps + native modules + `npx` for the auth CLI).
 
 Optional flags for `start`: `--skip-install`, `--skip-build`, `--skip-migrate`.
 
 **`dev`** (hot reload) is **not** available from the npm package (no app source). Clone the monorepo to develop the stack.
 
+### Terminal API client (`bs`)
+
+The same install also provides **`bs`** — a **Node** terminal client for auth, chat, ingest, pipeline, etc. (talks to your Next origin, same as the browser). With the stack running:
+
+```bash
+bs --help
+bs auth session
+bs backend hello
+```
+
+Configure the web URL with **`BUSINESS_STACK_WEB_URL`** (or **`NEXT_PUBLIC_AUTH_BASE_URL`** / **`NEXT_PUBLIC_APP_URL`**), default `http://localhost:3000`.
+
 ### 4. Optional: npm scripts in your `package.json`
 
 ```json
@@ -81,7 +93,7 @@ Optional flags for `start`: `--skip-install`, `--skip-build`, `--skip-migrate`.
 }
 ```
 
-After a local install, npm adds `node_modules/.bin/business-stack`, so these scripts work without `npx`.
+After a local install, npm adds `node_modules/.bin/business-stack` and `node_modules/.bin/bs`.
 
 ## Global install (optional)
 

package/bin/business-stack.cjs

@@ -511,8 +511,8 @@ async function runStart(opts) {
   const prebuilt = isPrebuiltNpmPackage(stackRoot);
   logPhase(
     prebuilt
-      ? "starting (install → migrate → servers; prebuilt web + gateway)"
-      : "starting (install → build → migrate → servers)",
+      ? "starting (install → DB migrations → servers; prebuilt web + gateway)"
+      : "starting (install → build → DB migrations → servers)",
   );
   logPhase(`stack root ${stackRoot}`);
   logPhase(`CLI package v${getCliPackageVersion()} — if there is no output below, run: npm i -g business-stack@latest`);
@@ -542,6 +542,13 @@ async function runStart(opts) {
     logPhase("skip npm run build (prebuilt package)");
   }
   if (!opts.skipMigrate) {
+    runCmd(
+      "better-auth migrate (gateway SQLite)",
+      "npm",
+      ["run", "migrate"],
+      path.join(stackRoot, "gateway"),
+      childEnv,
+    );
     runCmd(
       "alembic upgrade head",
       "uv",
@@ -610,7 +617,7 @@ function runDev() {
 program
   .name("business-stack")
   .description("Run the business-stack monorepo (Next + Hono gateway + FastAPI)")
-  .version("0.1.11");
+  .version("0.1.13");
 
 program
   .command("doctor")
@@ -636,7 +643,10 @@ program
   .description("Install deps, build, migrate, run production stack (turbo start)")
   .option("--skip-install", "Skip npm install")
   .option("--skip-build", "Skip turbo build")
-  .option("--skip-migrate", "Skip alembic upgrade")
+  .option(
+    "--skip-migrate",
+    "Skip DB migrations (Better Auth gateway + Alembic backend)",
+  )
   .action(async (o) => {
     try {
       await runStart(o);