feat(cli): implement interactive bb init project scaffolding

AGENTS.md

@@ -46,7 +46,8 @@ BASE APP STRUCTURE:
 
 ## Repository Structure Guidance
 When scaffolding implementation, use:
-- `betterbase/apps/cli` → `bb` CLI project
+- `betterbase/packages/cli` → canonical `bb` CLI implementation
+- `betterbase/apps/cli` → legacy wrapper/stub (delegates to package CLI)
 - `betterbase/apps/dashboard` → dashboard app
 - `betterbase/packages/core` → backend/core engine
 - `betterbase/packages/client` → `@betterbase/client`
@@ -60,6 +61,7 @@ When scaffolding implementation, use:
 3. Prefer small, composable files and clear package boundaries.
 4. Avoid introducing lock-in assumptions that conflict with BetterBase goals.
 5. When uncertain, bias toward the blueprint and reuse strategy docs.
+6. Ensure new templates follow the persistent project prompt above.
 
 ## Quality & Validation
 - Run lightweight checks whenever possible (format/lint/typecheck when available).

betterbase/.gitignore

@@ -5,4 +5,5 @@ dist
 .next
 .env
 .env.*
+!.env.example
 .DS_Store

betterbase/README.md

@@ -4,8 +4,9 @@ Initial BetterBase monorepo scaffold with a concrete base template.
 
 ## Structure
 
-- `apps/cli` — `bb` CLI
+- `apps/cli` — legacy CLI wrapper/stub
 - `apps/dashboard` — dashboard/studio app
+- `packages/cli` — canonical `@betterbase/cli` implementation
 - `packages/core` — core backend engine
 - `packages/client` — SDK (`@betterbase/client`)
 - `packages/shared` — shared utilities/types
@@ -20,7 +21,7 @@ Initial BetterBase monorepo scaffold with a concrete base template.
 
 ## Base Template Commands
 
-From `betterbase/templates/base`:
+From `templates/base`:
 
 - `bun run dev`
 - `bun run db:generate`

betterbase/apps/cli/README.md

@@ -0,0 +1,6 @@
+# @betterbase/cli-legacy
+
+This package is a legacy wrapper placeholder.
+
+- Canonical CLI implementation: `betterbase/packages/cli` (`@betterbase/cli`)
+- This package exists only for backwards compatibility and forwards execution.

betterbase/apps/cli/package.json

@@ -1,13 +1,13 @@
 {
-  "name": "@betterbase/cli",
+  "name": "@betterbase/cli-legacy",
   "version": "0.0.0",
   "private": true,
   "type": "module",
   "bin": {
-    "bb": "./dist/index.js"
+    "bb-legacy": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "bun build ./src/index.ts --outfile ./dist/index.js --target bun",
     "dev": "bun run src/index.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }

betterbase/apps/cli/src/index.ts

@@ -1,3 +1,15 @@
 #!/usr/bin/env node
 
-console.log('BetterBase CLI scaffold: bb');
+/**
+ * Legacy bb wrapper entrypoint.
+ *
+ * Forwards execution to the canonical CLI implementation in packages/cli.
+ */
+export async function runLegacyCli(): Promise<void> {
+  const cliModule = await import('../../../packages/cli/src/index');
+  await cliModule.runCli(process.argv);
+}
+
+if (import.meta.main) {
+  await runLegacyCli();
+}

betterbase/packages/cli/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@betterbase/cli",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "bb": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "bun run src/build.ts",
+    "dev": "bun run src/index.ts",
+    "test": "bun test",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "inquirer": "^10.2.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.6.0"
+  }
+}

betterbase/packages/cli/src/build.ts

@@ -0,0 +1,24 @@
+/**
+ * Build the CLI as a standalone bundled executable output.
+ */
+export async function buildStandaloneCli(): Promise<void> {
+  const result = await Bun.build({
+    entrypoints: ['./src/index.ts'],
+    outdir: './dist',
+    target: 'bun',
+    format: 'esm',
+    minify: false,
+    sourcemap: 'external',
+    naming: 'index.js',
+  });
+
+  if (!result.success) {
+    throw new Error(`Build failed with ${result.logs.length} error(s).`);
+  }
+
+  const outputPath = './dist/index.js';
+  const compiled = await Bun.file(outputPath).text();
+  await Bun.write(outputPath, `#!/usr/bin/env bun\n${compiled}`);
+}
+
+await buildStandaloneCli();