@mostajs/orm-cli 0.3.1 → 0.4.0

package/bin/install-bridge.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+// install-bridge.mjs — one-shot codemod : scan a Prisma project, find every
+// file that instantiates PrismaClient, and rewrite it to use
+// createPrismaLikeDb() from @mostajs/orm-bridge.
+//
+// Author: Dr Hamid MADANI drmdh@msn.com
+// License: AGPL-3.0-or-later
+//
+// Usage (invoked by bin/mostajs.sh  as `mostajs install-bridge`) :
+//
+//   node install-bridge.mjs              # dry-run (default, safe)
+//   node install-bridge.mjs --apply      # actually write files
+//   node install-bridge.mjs --file X     # restrict to a single file
+//   node install-bridge.mjs --project P  # root to scan (default: cwd)
+//   node install-bridge.mjs --restore    # restore from .prisma.bak backups
+//
+// The rewriter is deliberately conservative :
+//   - It only touches files that CREATE a PrismaClient (`new PrismaClient(...)`).
+//   - It preserves the original export name (`prisma`, `db`, `client`, `default`)
+//     so none of the 10 to 10000 call-sites elsewhere in the codebase need to change.
+//   - Original file is saved as <path>.prisma.bak (never overwritten).
+//   - Re-runs are idempotent : if the file already uses createPrismaLikeDb,
+//     the codemod skips it.
+
+import { readFileSync, writeFileSync, readdirSync, statSync, existsSync, renameSync, copyFileSync } from 'node:fs';
+import { join, resolve, relative, extname } from 'node:path';
+
+// ---------- CLI ----------
+const argv = process.argv.slice(2);
+const flag = (name) => argv.includes(`--${name}`);
+const val  = (name) => { const i = argv.indexOf(`--${name}`); return i >= 0 ? argv[i + 1] : null; };
+
+const APPLY    = flag('apply');
+const RESTORE  = flag('restore');
+const ONE_FILE = val('file');
+const ROOT     = resolve(val('project') ?? process.cwd());
+const QUIET    = flag('quiet');
+
+const log = (...a) => { if (!QUIET) console.log(...a); };
+const c   = { cyan: s => `\x1b[36m${s}\x1b[0m`, yellow: s => `\x1b[33m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`, red: s => `\x1b[31m${s}\x1b[0m`, bold: s => `\x1b[1m${s}\x1b[0m`, dim: s => `\x1b[2m${s}\x1b[0m` };
+
+// ---------- Walk ----------
+const SKIP_DIRS = new Set(['node_modules', '.next', '.svelte-kit', 'dist', 'build', '.turbo', '.vercel', '.cache', 'coverage', '.git', '.vscode', '.idea']);
+const EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.js', '.jsx', '.mjs']);
+
+function* walk(dir) {
+  let entries;
+  try { entries = readdirSync(dir); } catch { return; }
+  for (const name of entries) {
+    if (SKIP_DIRS.has(name)) continue;
+    const p = join(dir, name);
+    let st;
+    try { st = statSync(p); } catch { continue; }
+    if (st.isDirectory()) yield* walk(p);
+    else if (EXTENSIONS.has(extname(name))) yield p;
+  }
+}
+
+// ---------- Detection ----------
+// Patterns we consider "PrismaClient instantiation sites"
+const RX_IMPORT = /import\s*(?:\{[^}]*PrismaClient[^}]*\}|[^;]*?)\s*from\s*['"]@prisma\/client['"]/;
+const RX_NEW    = /new\s+PrismaClient\s*\(/;
+const RX_ALREADY = /@mostajs\/orm-bridge\/prisma-client/;
+
+// Detect the export shape to preserve the name the codebase depends on.
+//   export const db = new PrismaClient(...)       → named, "db"
+//   export const prisma = new PrismaClient(...)   → named, "prisma"
+//   export default new PrismaClient(...)          → default
+//   const prisma = ...; export { prisma }         → named, "prisma"
+function detectExportShape(source) {
+  // Singleton pattern commonly used in Next.js :
+  //   const g = globalThis as ... { prisma: ... }
+  //   export const db = g.prisma ?? new PrismaClient()
+  const mNamed = source.match(/export\s+const\s+(\w+)\s*=\s*(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mNamed) return { kind: 'const', name: mNamed[1] };
+
+  const mLet = source.match(/export\s+let\s+(\w+)\s*=\s*(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mLet) return { kind: 'let', name: mLet[1] };
+
+  const mDefault = source.match(/export\s+default\s+(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mDefault) return { kind: 'default', name: null };
+
+  // Bare global : const prisma = new PrismaClient(); followed somewhere by `export { prisma }` or not
+  const mBare = source.match(/(?:^|\n)\s*(?:const|let)\s+(\w+)\s*=\s*(?:[^;]*?)\bnew\s+PrismaClient/);
+  if (mBare) {
+    const name = mBare[1];
+    if (new RegExp(`export\\s*\\{[^}]*\\b${name}\\b[^}]*\\}`).test(source)) {
+      return { kind: 'export-block', name };
+    }
+    return { kind: 'const', name };  // assume user wants to export it ; safer default
+  }
+
+  return null;
+}
+
+// ---------- Rewrite ----------
+function buildReplacement(shape) {
+  const header = `// Auto-generated by \`mostajs install-bridge\` on ${new Date().toISOString()}\n// Original file backed up as <this-file>.prisma.bak\n// Every db/prisma/client call is now routed to @mostajs/orm (13 dialects).\nimport 'server-only'\nimport { createPrismaLikeDb } from '@mostajs/orm-bridge/prisma-client'\n`;
+  if (shape.kind === 'default') {
+    return `${header}\nexport default createPrismaLikeDb()\n`;
+  }
+  const kw = shape.kind === 'let' ? 'let' : 'const';
+  if (shape.kind === 'export-block') {
+    return `${header}\n${kw} ${shape.name} = createPrismaLikeDb()\nexport { ${shape.name} }\n`;
+  }
+  return `${header}\nexport ${kw} ${shape.name} = createPrismaLikeDb()\n`;
+}
+
+// ---------- Restore ----------
+function restoreBackups() {
+  const restored = [];
+  for (const p of walk(ROOT)) {
+    if (!p.endsWith('.prisma.bak')) continue;
+    const original = p.slice(0, -'.prisma.bak'.length);
+    if (APPLY) {
+      renameSync(p, original);
+      log(`  ${c.green('✓')} restored ${c.dim(relative(ROOT, original))}`);
+    } else {
+      log(`  ${c.yellow('•')} would restore ${c.dim(relative(ROOT, original))}`);
+    }
+    restored.push(original);
+  }
+  return restored;
+}
+
+// ---------- Main ----------
+if (RESTORE) {
+  log(c.bold('▶ Restoring .prisma.bak files' + (APPLY ? '' : c.yellow(' (dry-run, use --apply)'))));
+  const r = restoreBackups();
+  log(`\n${r.length} file(s) ${APPLY ? 'restored' : 'would be restored'}`);
+  process.exit(0);
+}
+
+log(c.bold(`▶ mostajs install-bridge — scanning ${c.cyan(ROOT)}`));
+log('');
+
+const candidates = [];
+const iter = ONE_FILE ? [resolve(ROOT, ONE_FILE)] : walk(ROOT);
+for (const p of iter) {
+  let src;
+  try { src = readFileSync(p, 'utf8'); } catch { continue; }
+  if (!RX_IMPORT.test(src) && !RX_NEW.test(src)) continue;
+  if (RX_ALREADY.test(src)) {
+    log(`  ${c.dim('— skip (already bridged) ' + relative(ROOT, p))}`);
+    continue;
+  }
+  if (!RX_NEW.test(src)) continue;  // imports only = not an instantiation site
+  const shape = detectExportShape(src);
+  if (!shape) {
+    log(`  ${c.yellow('?')} ${relative(ROOT, p)} — PrismaClient detected but export shape unknown, skipping`);
+    continue;
+  }
+  candidates.push({ path: p, rel: relative(ROOT, p), shape, src });
+}
+
+if (candidates.length === 0) {
+  log(c.yellow('  No instantiation sites found.'));
+  log('');
+  log(`  Did you remove \`new PrismaClient()\` already ? The bridge may already be in place.`);
+  log(`  Re-scan with: ${c.cyan('mostajs install-bridge --restore --apply')} to undo a prior run.`);
+  process.exit(0);
+}
+
+log(c.bold(`Found ${candidates.length} PrismaClient instantiation site(s):`));
+for (const ca of candidates) {
+  log(`  ${c.green('→')} ${ca.rel}  ${c.dim(`(${ca.shape.kind}${ca.shape.name ? ' ' + ca.shape.name : ''})`)}`);
+}
+log('');
+
+if (!APPLY) {
+  log(c.yellow('Dry-run — no files written. Re-run with --apply to execute.'));
+  log('');
+  log(c.bold('Preview of rewrite for the first file :'));
+  log(c.dim('─────────────────────────────────────────'));
+  log(buildReplacement(candidates[0].shape));
+  log(c.dim('─────────────────────────────────────────'));
+  process.exit(0);
+}
+
+// ---------- Apply ----------
+log(c.bold('Applying rewrites :'));
+for (const ca of candidates) {
+  const bak = ca.path + '.prisma.bak';
+  if (!existsSync(bak)) copyFileSync(ca.path, bak);
+  writeFileSync(ca.path, buildReplacement(ca.shape));
+  log(`  ${c.green('✓')} rewrote ${ca.rel}  ${c.dim(`(backup: ${relative(ROOT, bak)})`)}`);
+}
+
+log('');
+log(c.bold(c.green(`✓ Bridge installed in ${candidates.length} file(s).`)));
+log('');
+log('Next steps :');
+log(`  1. ${c.cyan('npm i @mostajs/orm @mostajs/orm-bridge server-only --legacy-peer-deps')}`);
+log(`  2. ${c.cyan('npx @mostajs/orm-cli')}  →  menu 1 (Convert Prisma → entities.json)  →  menu 3 (init DDL)`);
+log(`  3. Set ${c.cyan('DB_DIALECT')} + ${c.cyan('SGBD_URI')} in .env (or: menu 2 → i to import)`);
+log(`  4. ${c.cyan('npm run dev')}  and test.`);
+log('');
+log(`To undo : ${c.cyan('mostajs install-bridge --restore --apply')}`);

package/bin/mostajs.sh

@@ -438,6 +438,8 @@ menu_main() {
   echo -e "  ${CYAN}8${RESET}) Health checks"
   echo -e "  ${CYAN}9${RESET}) Generate boilerplate (src/db.ts with bridge)"
   echo -e "  ${CYAN}s${RESET}) ${BOLD}Seeding${RESET} (upload / validate / apply seed data)"
+  echo -e "  ${GREEN}b${RESET}) ${BOLD}Bootstrap${RESET} — one-shot migration of a Prisma project"
+  echo -e "  ${GREEN}i${RESET}) ${BOLD}Install bridge${RESET} — codemod PrismaClient → bridge (dry-run / apply / restore)"
   echo -e "  ${CYAN}0${RESET}) About / Help"
   echo
   echo -e "  ${RED}q${RESET}) Quit"
@@ -455,12 +457,63 @@ menu_main() {
     8) action_healthcheck ;;
     9) action_generate_boilerplate ;;
     s|S) menu_seeding ;;
+    b|B) menu_bootstrap ;;
+    i|I) menu_install_bridge ;;
     0) action_about ;;
     q|Q) exit 0 ;;
     *) warn "Unknown choice"; pause ;;
   esac
 }
 
+# ------------------------------------------------------------
+# Interactive wrapper for `install-bridge` codemod
+# ------------------------------------------------------------
+menu_install_bridge() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Install bridge — PrismaClient codemod${RESET}"
+  echo
+  echo "  ${CYAN}1${RESET}) Dry-run : list files that would be rewritten (default)"
+  echo "  ${CYAN}2${RESET}) Apply   : rewrite PrismaClient sites to createPrismaLikeDb()"
+  echo "  ${CYAN}3${RESET}) Restore : revert .prisma.bak files (dry-run)"
+  echo "  ${CYAN}4${RESET}) Restore : revert .prisma.bak files (apply)"
+  echo "  ${RED}0${RESET}) Back"
+  echo
+  local cli_dir
+  cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+  local choice; choice=$(ask "Choice" "1")
+  case "$choice" in
+    1) node "$cli_dir/bin/install-bridge.mjs" ;;
+    2) node "$cli_dir/bin/install-bridge.mjs" --apply ;;
+    3) node "$cli_dir/bin/install-bridge.mjs" --restore ;;
+    4) node "$cli_dir/bin/install-bridge.mjs" --restore --apply ;;
+    0) return ;;
+    *) warn "Unknown" ;;
+  esac
+  pause
+}
+
+# ------------------------------------------------------------
+# Interactive wrapper for `bootstrap` — one-shot full migration
+# ------------------------------------------------------------
+menu_bootstrap() {
+  header
+  echo -e "${BOLD}${GREEN}▶ Bootstrap — full Prisma → @mostajs/orm migration${RESET}"
+  echo
+  echo "This will, in ${BOLD}this project${RESET} :"
+  echo "  1. Rewrite every ${CYAN}new PrismaClient()${RESET} site to use ${CYAN}createPrismaLikeDb()${RESET}"
+  echo "     (originals backed up as ${DIM}*.prisma.bak${RESET})"
+  echo "  2. Install ${CYAN}@mostajs/orm${RESET} + ${CYAN}@mostajs/orm-bridge${RESET} + ${CYAN}server-only${RESET}"
+  echo "  3. Convert ${CYAN}prisma/schema.prisma${RESET} → ${DIM}.mostajs/generated/entities.json${RESET}"
+  echo "  4. Write ${DIM}.mostajs/config.env${RESET} (default : sqlite ./data.sqlite) and init DDL"
+  echo
+  warn "Existing code changes will be backed up but NOT committed — review the diff before pushing."
+  echo
+  local go; go=$(ask "Proceed? (y/N)" "N")
+  [[ "$go" =~ ^[yY]$ ]] || { info "Cancelled"; return; }
+  run_subcommand bootstrap
+  pause
+}
+
 # ============================================================
 # ACTION 1 : CONVERT
 # ============================================================
@@ -548,6 +601,7 @@ menu_databases() {
   echo -e "  ${CYAN}p${RESET}) APP_PORT            : ${DIM}${APP_PORT:-3000}${RESET}"
   echo
   echo -e "  ${CYAN}t${RESET}) Test all connections"
+  echo -e "  ${CYAN}i${RESET}) ${BOLD}Import from project .env${RESET} (auto-detect app's real DB)"
   echo -e "  ${CYAN}e${RESET}) Export to .env.local in project"
   echo -e "  ${CYAN}r${RESET}) Reset config"
   echo -e "  ${CYAN}b${RESET}) Back"
@@ -565,6 +619,7 @@ menu_databases() {
     n|N) save_var MOSTA_NET_TRANSPORT "$(ask 'MOSTA_NET_TRANSPORT (rest|sse|graphql|mcp|websocket|jsonrpc|grpc|odata)' "${MOSTA_NET_TRANSPORT:-rest}")";;
     p|P) save_var APP_PORT            "$(ask 'APP_PORT' "${APP_PORT:-3000}")";;
     t|T) action_test_connections; return;;
+    i|I) action_import_env ;;
     e|E) export_env_local ;;
     r|R) confirm "Really reset config?" && rm -f "$CONFIG_FILE" && ok "Reset";;
     b|B) return;;
@@ -647,6 +702,95 @@ list_extra_bindings() {
   done
 }
 
+# Import DB config from the project's own .env file.
+# This is CRUCIAL when your app (Prisma, NextAuth, ...) already has a
+# DATABASE_URL / MONGODB_URI / POSTGRES_URL. Seeding the wrong DB leads to
+# the classic "users are in mosta-net /api/v1/users but login fails" bug.
+action_import_env() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Import DB config from project .env${RESET}"
+  echo
+
+  local candidates=(".env.local" ".env" ".env.production" ".env.development")
+  local -a available=()
+  for f in "${candidates[@]}"; do
+    [[ -f "$PROJECT_ROOT/$f" ]] && available+=("$f")
+  done
+
+  if [[ ${#available[@]} -eq 0 ]]; then
+    err "No .env* file found in $PROJECT_ROOT"
+    pause; return
+  fi
+
+  echo "Found env files :"
+  local i=1
+  for f in "${available[@]}"; do
+    echo -e "  ${CYAN}$i${RESET}) $f"
+    i=$((i+1))
+  done
+  echo
+  local choice; choice=$(ask "Number" 1)
+  local src_file="${available[$((choice-1))]}"
+  [[ -z "$src_file" ]] && return
+  local src_path="$PROJECT_ROOT/$src_file"
+
+  # Extract common DB URI variables — priority order matters
+  # MONGODB_URI > DATABASE_URL > POSTGRES_URL > MYSQL_URL > SGBD_URI
+  local found_uri="" found_var="" found_dialect=""
+  for var in SGBD_URI DATABASE_URL MONGODB_URI POSTGRES_URL POSTGRES_URI MYSQL_URL MYSQL_URI POSTGRESQL_URL; do
+    # Read value, skip commented lines, strip quotes
+    local val
+    val=$(grep -E "^${var}=" "$src_path" 2>/dev/null | grep -v "^#" | head -1 | sed "s/^${var}=//" | sed 's/^"\(.*\)"$/\1/' | sed "s/^'\(.*\)'$/\1/")
+    if [[ -n "$val" ]]; then
+      found_uri="$val"
+      found_var="$var"
+      break
+    fi
+  done
+
+  if [[ -z "$found_uri" ]]; then
+    err "No DB URI found in $src_file"
+    info "Searched : SGBD_URI, DATABASE_URL, MONGODB_URI, POSTGRES_URL/URI, MYSQL_URL/URI"
+    pause; return
+  fi
+
+  # Detect dialect from URI scheme
+  found_dialect=$(detect_dialect_from_uri "$found_uri")
+  if [[ "$found_dialect" == "unknown" ]]; then
+    warn "Could not auto-detect dialect from URI: $found_uri"
+    found_dialect=$(ask "Dialect name (mongodb|postgres|mysql|...)" "")
+    [[ -z "$found_dialect" ]] && { pause; return; }
+  fi
+
+  info "Detected :"
+  echo -e "  Variable : ${CYAN}$found_var${RESET}"
+  echo -e "  URI      : ${DIM}$found_uri${RESET}"
+  echo -e "  Dialect  : ${MAGENTA}$found_dialect${RESET}"
+  echo
+
+  # Special Prisma note
+  if [[ "$found_var" == "MONGODB_URI" ]] || [[ "$found_var" == "DATABASE_URL" ]]; then
+    dim "  (This is likely the Prisma datasource — the same DB your app uses for login/auth.)"
+    echo
+  fi
+
+  if confirm "Save as DB_DIALECT + SGBD_URI ?"; then
+    save_var DB_DIALECT "$found_dialect"
+    save_var SGBD_URI   "$found_uri"
+    # Suggest a strategy based on environment context
+    if [[ "$src_file" == ".env.production" ]]; then
+      save_var DB_SCHEMA_STRATEGY "validate"
+      info "Auto-set DB_SCHEMA_STRATEGY=validate (production)"
+    elif [[ -z "${DB_SCHEMA_STRATEGY:-}" ]]; then
+      save_var DB_SCHEMA_STRATEGY "update"
+    fi
+    ok "Config imported"
+    echo
+    info "Next step : menu 2 → t (test connection), then menu S → 4 (seed)"
+  fi
+  pause
+}
+
 # Export a .env.local file compatible with @mostajs/orm convention
 export_env_local() {
   local target="$PROJECT_ROOT/.env.mostajs"
@@ -2225,6 +2369,14 @@ EOF
 
 run_subcommand() {
   case "$1" in
+    diagnose|diag|d)
+      # mostajs diagnose [email] [password]
+      # Walks through: config vs project datasource mismatch, DB connection,
+      # user lookup, isActive check, bcrypt verification.
+      local email="${2:-}"
+      local password="${3:-}"
+      action_diagnose_login "$email" "$password"
+      ;;
     hash|h)
       # mostajs hash <plaintext> [cost]
       local pw="${2:-}"
@@ -2296,6 +2448,71 @@ run_subcommand() {
     health|h)
       action_healthcheck
       ;;
+    install-bridge|ib)
+      # mostajs install-bridge [--apply] [--file X] [--project P] [--restore]
+      # Codemod : scans the project for `new PrismaClient(...)` sites and rewrites
+      # them in place to use createPrismaLikeDb() from @mostajs/orm-bridge.
+      # Dry-run by default ; pass --apply to write the changes.
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      shift
+      node "$cli_dir/bin/install-bridge.mjs" "$@"
+      ;;
+    bootstrap|b)
+      # mostajs bootstrap : the full zero-touch migration for a Prisma project.
+      #   1. Run the codemod on the whole tree  (install-bridge --apply)
+      #   2. npm install @mostajs/orm @mostajs/orm-bridge server-only
+      #   3. Convert prisma/schema.prisma → entities.json
+      #   4. Write .mostajs/config.env + init SQLite DDL
+      #   5. Tell the user what remains (.env, seeds, run dev).
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      detect_project
+      [[ ${#DETECTED_TYPES[@]} -eq 0 ]] && { err "No schema found. Bootstrap needs a prisma/schema.prisma (or OpenAPI/JSONSchema)."; exit 1; }
+
+      echo -e "\n\e[1m▶ Step 1/4 : rewrite PrismaClient sites\e[0m"
+      node "$cli_dir/bin/install-bridge.mjs" --apply || { err "Codemod failed"; exit 1; }
+
+      echo -e "\n\e[1m▶ Step 2/4 : install runtime deps\e[0m"
+      ( cd "$PROJECT_ROOT" && $PKG_MANAGER install @mostajs/orm @mostajs/orm-bridge server-only --legacy-peer-deps 2>&1 | tail -3 )
+
+      echo -e "\n\e[1m▶ Step 3/4 : convert schema + init DDL\e[0m"
+      local type="${DETECTED_TYPES[0]}" input
+      case "$type" in
+        prisma)     input="$PRISMA_SCHEMA" ;;
+        openapi)    input="$OPENAPI_FILE" ;;
+        jsonschema) input="${JSON_SCHEMAS[0]}" ;;
+      esac
+      run_adapter_convert "$type" "$input" "$GENERATED_DIR/entities.ts"
+
+      mkdir -p "$CONFIG_DIR"
+      if [[ ! -f "$CONFIG_DIR/config.env" ]]; then
+        cat > "$CONFIG_DIR/config.env" <<CFG
+DB_DIALECT=sqlite
+SGBD_URI=./data.sqlite
+DB_SCHEMA_STRATEGY=update
+CFG
+        ok "  wrote $CONFIG_DIR/config.env (defaults: sqlite ./data.sqlite)"
+      fi
+      action_init_dialects || warn "DDL init returned non-zero — inspect and retry with menu 3"
+
+      echo -e "\n\e[1m▶ Step 4/4 : done\e[0m"
+      cat <<DONE
+
+  ✓ Bridge installed in-place.  Original files backed up as *.prisma.bak
+  ✓ Schema converted :   $GENERATED_DIR/entities.json
+  ✓ SQLite DDL applied : $PROJECT_ROOT/data.sqlite
+
+  Next :
+    - Add seeds to $CONFIG_DIR/seeds/*.json   (one file per entity)
+    - $CLI_NAME             # menu S → h (hash) → 4 (apply)
+    - npm run dev
+
+  To undo the codemod :
+    $CLI_NAME install-bridge --restore --apply
+
+DONE
+      ;;
     version|-v|--version)
       echo "$CLI_NAME $VERSION"
       ;;
@@ -2303,14 +2520,21 @@ run_subcommand() {
       cat <<EOF
 Usage :
   $CLI_NAME                         Interactive menu
+  $CLI_NAME bootstrap               One-shot migration : codemod + deps + convert + DDL
+  $CLI_NAME install-bridge          Codemod only (dry-run ; add --apply to write)
+  $CLI_NAME install-bridge --apply  Rewrite PrismaClient sites to use @mostajs/orm-bridge
+  $CLI_NAME install-bridge --restore --apply     Undo a prior install-bridge
   $CLI_NAME convert                 Run conversion (auto-detect schema type)
   $CLI_NAME detect                  Print detected schemas
   $CLI_NAME health                  Run health checks
   $CLI_NAME hash <password> [cost]  Hash a password with bcrypt (cost default 10)
   $CLI_NAME verify <password> <hash> Check if a plain password matches a bcrypt hash
+  $CLI_NAME diagnose [email] [pw]   Walk through login diagnostics
   $CLI_NAME version                 Print version
 
 Examples:
+  $CLI_NAME bootstrap               → zero-touch migrate a Prisma project to @mostajs/orm
+  $CLI_NAME install-bridge          → preview rewrites without touching files
   $CLI_NAME hash 'Admin@123456'     → \$2b\$10\$N9qo8uLOickgx2ZMRZoMyeIjZA...
   $CLI_NAME verify 'Admin@123456' '\$2b\$10\$N9qo...'
 EOF

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mostajs/orm-cli",
-  "version": "0.3.1",
-  "description": "Universal CLI to integrate @mostajs/orm into any project — auto-detects Prisma, OpenAPI, JSON Schema. Interactive menu + subcommands. 13 databases.",
+  "version": "0.4.0",
+  "description": "Universal CLI to integrate @mostajs/orm into any project — one-shot `mostajs bootstrap` migrates a Prisma project (codemod + deps + schema convert + DDL) to 13 databases with zero code change.",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
   "license": "AGPL-3.0-or-later",
   "type": "module",