@mostajs/orm-cli 0.1.0

package/bin/mostajs.sh

@@ -0,0 +1,994 @@
+#!/usr/bin/env bash
+# mostajs.sh — Universal interactive CLI for @mostajs/orm integration
+# Works in any project directory : auto-detects Prisma, OpenAPI, JSON Schema
+# Author: Dr Hamid MADANI drmdh@msn.com
+# License: AGPL-3.0-or-later
+#
+# Install globally :
+#   curl -fsSL https://raw.githubusercontent.com/apolocine/mosta-orm-cli/main/bin/mostajs.sh -o /usr/local/bin/mostajs
+#   chmod +x /usr/local/bin/mostajs
+#
+# Or run directly :
+#   bash <(curl -fsSL https://raw.githubusercontent.com/apolocine/mosta-orm-cli/main/bin/mostajs.sh)
+#
+# Or via npx :
+#   npx @mostajs/orm-cli
+
+set -uo pipefail
+
+# ============================================================
+# META
+# ============================================================
+
+VERSION="0.1.0"
+CLI_NAME="mostajs"
+
+# ============================================================
+# PATHS — relative to the CALLER's CWD, not the script
+# ============================================================
+
+PROJECT_ROOT="$(pwd)"
+CONFIG_DIR="$PROJECT_ROOT/.mostajs"
+CONFIG_FILE="$CONFIG_DIR/config.env"
+LOG_DIR="$CONFIG_DIR/logs"
+GENERATED_DIR="$CONFIG_DIR/generated"
+
+mkdir -p "$CONFIG_DIR" "$LOG_DIR" "$GENERATED_DIR" 2>/dev/null
+
+# ============================================================
+# COLORS
+# ============================================================
+
+if [[ -t 1 ]]; then
+  RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+  BLUE='\033[0;34m'; MAGENTA='\033[0;35m'; CYAN='\033[0;36m'
+  BOLD='\033[1m'; DIM='\033[2m'; RESET='\033[0m'
+else
+  RED=''; GREEN=''; YELLOW=''; BLUE=''; MAGENTA=''; CYAN=''; BOLD=''; DIM=''; RESET=''
+fi
+
+ok()    { echo -e "  ${GREEN}✓${RESET} $*"; }
+info()  { echo -e "  ${CYAN}ℹ${RESET} $*"; }
+warn()  { echo -e "  ${YELLOW}⚠${RESET} $*"; }
+err()   { echo -e "  ${RED}✗${RESET} $*"; }
+dim()   { echo -e "  ${DIM}$*${RESET}"; }
+
+pause() {
+  echo
+  read -n 1 -r -s -p "$(echo -e "${DIM}Press any key...${RESET}")" || true
+  echo
+}
+
+ask() {
+  local prompt="$1" default="${2:-}" var
+  if [[ -n "$default" ]]; then
+    read -r -p "$(echo -e "${YELLOW}?${RESET} $prompt ${DIM}[$default]${RESET}: ")" var
+    echo "${var:-$default}"
+  else
+    read -r -p "$(echo -e "${YELLOW}?${RESET} $prompt: ")" var
+    echo "$var"
+  fi
+}
+
+confirm() {
+  local response
+  read -r -p "$(echo -e "${YELLOW}?${RESET} $1 ${DIM}[y/N]${RESET}: ")" response
+  [[ "$response" =~ ^[Yy]$ ]]
+}
+
+header() {
+  clear
+  echo -e "${BOLD}${CYAN}"
+  echo "╔══════════════════════════════════════════════════════════════════╗"
+  echo "║   @mostajs/orm-cli v$VERSION — Universal Schema Adapter Tool      ║"
+  echo "║   13 databases · 4 input formats · one command                    ║"
+  echo "╚══════════════════════════════════════════════════════════════════╝"
+  echo -e "${RESET}"
+}
+
+# ============================================================
+# CONFIG MANAGEMENT
+# ============================================================
+
+load_env() {
+  [[ -f "$CONFIG_FILE" ]] && { set -a; source "$CONFIG_FILE"; set +a; }
+}
+
+save_var() {
+  local key="$1" value="$2"
+  touch "$CONFIG_FILE"
+  grep -v "^${key}=" "$CONFIG_FILE" > "$CONFIG_FILE.tmp" 2>/dev/null || true
+  echo "${key}=${value}" >> "$CONFIG_FILE.tmp"
+  mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
+  chmod 600 "$CONFIG_FILE" 2>/dev/null || true
+}
+
+# ============================================================
+# PROJECT DETECTION
+# ============================================================
+
+detect_project() {
+  DETECTED_TYPES=()
+  PRISMA_SCHEMA=""
+  OPENAPI_FILE=""
+  JSON_SCHEMAS=()
+  PKG_MANAGER=""
+
+  # Prisma
+  if [[ -f "$PROJECT_ROOT/prisma/schema.prisma" ]]; then
+    PRISMA_SCHEMA="$PROJECT_ROOT/prisma/schema.prisma"
+    DETECTED_TYPES+=("prisma")
+  fi
+
+  # OpenAPI (common names)
+  for candidate in openapi.yaml openapi.yml openapi.json api.yaml api.yml api.json spec/openapi.yaml docs/openapi.yaml; do
+    if [[ -f "$PROJECT_ROOT/$candidate" ]]; then
+      OPENAPI_FILE="$PROJECT_ROOT/$candidate"
+      DETECTED_TYPES+=("openapi")
+      break
+    fi
+  done
+
+  # JSON Schema files
+  while IFS= read -r -d '' f; do
+    JSON_SCHEMAS+=("$f")
+  done < <(find "$PROJECT_ROOT/schemas" -name "*.json" -print0 2>/dev/null | head -c 10000)
+
+  [[ ${#JSON_SCHEMAS[@]} -gt 0 ]] && DETECTED_TYPES+=("jsonschema")
+
+  # Package manager
+  if   [[ -f "$PROJECT_ROOT/pnpm-lock.yaml" ]]; then PKG_MANAGER="pnpm"
+  elif [[ -f "$PROJECT_ROOT/yarn.lock"      ]]; then PKG_MANAGER="yarn"
+  elif [[ -f "$PROJECT_ROOT/bun.lockb"      ]]; then PKG_MANAGER="bun"
+  elif [[ -f "$PROJECT_ROOT/package.json"   ]]; then PKG_MANAGER="npm"
+  else PKG_MANAGER="npm"
+  fi
+}
+
+# ============================================================
+# npm / npx wrapper — finds the installed adapter or uses npx
+# ============================================================
+
+run_adapter_convert() {
+  local input_type="$1"  # prisma | jsonschema | openapi
+  local input_file="$2"
+  local output_file="$3"
+
+  # Check if @mostajs/orm-adapter is installed locally
+  local adapter_path=""
+  if [[ -f "$PROJECT_ROOT/node_modules/@mostajs/orm-adapter/dist/index.js" ]]; then
+    adapter_path="$PROJECT_ROOT/node_modules/@mostajs/orm-adapter/dist/index.js"
+    info "Using local @mostajs/orm-adapter"
+  else
+    # Try a neighbor path (dev setup — mosta-orm-adapter may be next to this CLI)
+    local cli_dir
+    cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+    if [[ -f "$cli_dir/../mosta-orm-adapter/dist/index.js" ]]; then
+      adapter_path="$cli_dir/../mosta-orm-adapter/dist/index.js"
+      info "Using sibling @mostajs/orm-adapter from $adapter_path"
+    else
+      warn "@mostajs/orm-adapter not found locally."
+      if confirm "Install it now ($PKG_MANAGER install --save-dev @mostajs/orm-adapter @mostajs/orm)?"; then
+        cd "$PROJECT_ROOT"
+        case "$PKG_MANAGER" in
+          pnpm) pnpm add -D @mostajs/orm-adapter @mostajs/orm ;;
+          yarn) yarn add -D @mostajs/orm-adapter @mostajs/orm ;;
+          bun)  bun add -D @mostajs/orm-adapter @mostajs/orm ;;
+          *)    npm install --save-dev @mostajs/orm-adapter @mostajs/orm --legacy-peer-deps ;;
+        esac
+        adapter_path="$PROJECT_ROOT/node_modules/@mostajs/orm-adapter/dist/index.js"
+      else
+        err "Cannot proceed without the adapter."
+        return 1
+      fi
+    fi
+  fi
+
+  local adapter_class
+  case "$input_type" in
+    prisma)     adapter_class="PrismaAdapter" ;;
+    openapi)    adapter_class="OpenApiAdapter" ;;
+    jsonschema) adapter_class="JsonSchemaAdapter" ;;
+    *) err "Unknown input type: $input_type"; return 1 ;;
+  esac
+
+  cat > "$CONFIG_DIR/convert.mjs" << EOF
+import { readFileSync, writeFileSync } from 'fs';
+import { $adapter_class } from '$adapter_path';
+
+const source = readFileSync('$input_file', 'utf8');
+const adapter = new $adapter_class();
+const warnings = [];
+const input = '$input_type' === 'jsonschema' ? JSON.parse(source) : source;
+const entities = await adapter.toEntitySchema(input, { onWarning: w => warnings.push(w) });
+
+console.log('entities : ' + entities.length);
+console.log('warnings : ' + warnings.length);
+for (const w of warnings) console.log('  [' + w.code + '] ' + (w.entity ?? '-') + ' : ' + w.message);
+
+const header = '// Auto-generated by @mostajs/orm-cli v$VERSION at ' + new Date().toISOString() + '\n';
+const code = header +
+  '// Source : $input_file\n' +
+  '// Adapter : $adapter_class\n' +
+  '// DO NOT EDIT BY HAND — regenerate with: mostajs convert\n\n' +
+  'import type { EntitySchema } from \"@mostajs/orm\";\n\n' +
+  'export const entities: EntitySchema[] = ' + JSON.stringify(entities, null, 2) + ';\n\n' +
+  'export const entityByName: Record<string, EntitySchema> = Object.fromEntries(\n' +
+  '  entities.map(e => [e.name, e])\n' +
+  ');\n';
+
+writeFileSync('$output_file', code);
+console.log('\u2713 Saved : $output_file');
+EOF
+
+  node "$CONFIG_DIR/convert.mjs" 2>&1 | tee "$LOG_DIR/convert.log"
+  return "${PIPESTATUS[0]}"
+}
+
+# ============================================================
+# MAIN MENU
+# ============================================================
+
+menu_main() {
+  load_env
+  detect_project
+  header
+  echo -e "${BOLD}Project :${RESET}  ${DIM}$PROJECT_ROOT${RESET}"
+  echo -e "${BOLD}Manager :${RESET}  ${DIM}$PKG_MANAGER${RESET}"
+  echo -e "${BOLD}Detected :${RESET} "
+  if [[ -n "$PRISMA_SCHEMA" ]]; then
+    local count
+    count=$(grep -c '^model ' "$PRISMA_SCHEMA" 2>/dev/null || echo 0)
+    ok "Prisma schema ($count models) at ${DIM}${PRISMA_SCHEMA#$PROJECT_ROOT/}${RESET}"
+  fi
+  [[ -n "$OPENAPI_FILE" ]] && ok "OpenAPI spec at ${DIM}${OPENAPI_FILE#$PROJECT_ROOT/}${RESET}"
+  [[ ${#JSON_SCHEMAS[@]} -gt 0 ]] && ok "JSON Schema files: ${#JSON_SCHEMAS[@]}"
+  [[ ${#DETECTED_TYPES[@]} -eq 0 ]] && warn "No schema detected. Menu 1 to create one, or cd into a project first."
+  echo
+
+  if [[ -f "$GENERATED_DIR/entities.ts" ]]; then
+    local count
+    count=$(grep -c '"name":' "$GENERATED_DIR/entities.ts" 2>/dev/null || echo 0)
+    ok "entities.ts generated ($count entities, $(du -h "$GENERATED_DIR/entities.ts" | cut -f1))"
+  else
+    warn "entities.ts not generated"
+  fi
+  echo
+
+  echo -e "${BOLD}${MAGENTA}━━━ MAIN MENU ━━━${RESET}"
+  echo
+  echo -e "  ${CYAN}1${RESET}) Convert schema → EntitySchema[]"
+  echo -e "  ${CYAN}2${RESET}) Configure database URIs"
+  echo -e "  ${CYAN}3${RESET}) Initialize dialects (connect + create tables)"
+  echo -e "  ${CYAN}4${RESET}) Tests menu (human / mobile / AI / curl / playwright)"
+  echo -e "  ${CYAN}5${RESET}) Start services"
+  echo -e "  ${CYAN}6${RESET}) Metrics & status"
+  echo -e "  ${CYAN}7${RESET}) View logs"
+  echo -e "  ${CYAN}8${RESET}) Health checks"
+  echo -e "  ${CYAN}9${RESET}) Generate boilerplate (src/db.ts with bridge)"
+  echo -e "  ${CYAN}0${RESET}) About / Help"
+  echo
+  echo -e "  ${RED}q${RESET}) Quit"
+  echo
+  local choice
+  choice=$(ask "Choice" "1")
+  case "$choice" in
+    1) action_convert ;;
+    2) menu_databases ;;
+    3) action_init_dialects ;;
+    4) menu_tests ;;
+    5) menu_services ;;
+    6) action_metrics ;;
+    7) action_logs ;;
+    8) action_healthcheck ;;
+    9) action_generate_boilerplate ;;
+    0) action_about ;;
+    q|Q) exit 0 ;;
+    *) warn "Unknown choice"; pause ;;
+  esac
+}
+
+# ============================================================
+# ACTION 1 : CONVERT
+# ============================================================
+
+action_convert() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Convert schema → EntitySchema[]${RESET}"
+  echo
+  detect_project
+
+  if [[ ${#DETECTED_TYPES[@]} -eq 0 ]]; then
+    err "No schema file found."
+    info "Expected files (any one) :"
+    dim "  - prisma/schema.prisma"
+    dim "  - openapi.yaml / openapi.json / api.yaml / spec/openapi.yaml"
+    dim "  - schemas/*.json"
+    echo
+    if confirm "Pick a file manually?"; then
+      local f; f=$(ask "Path to schema file (absolute or relative)")
+      [[ -z "$f" ]] && { pause; return; }
+      [[ ! -f "$f" ]] && { err "Not found: $f"; pause; return; }
+      # Infer type by extension / content
+      if [[ "$f" =~ \.prisma$ ]]; then
+        PRISMA_SCHEMA="$f"; DETECTED_TYPES=("prisma")
+      elif [[ "$f" =~ \.ya?ml$ ]] || grep -q "^openapi:" "$f" 2>/dev/null; then
+        OPENAPI_FILE="$f"; DETECTED_TYPES=("openapi")
+      else
+        JSON_SCHEMAS=("$f"); DETECTED_TYPES=("jsonschema")
+      fi
+    else
+      pause; return
+    fi
+  fi
+
+  # If multiple types, ask which one
+  local type input
+  if [[ ${#DETECTED_TYPES[@]} -eq 1 ]]; then
+    type="${DETECTED_TYPES[0]}"
+  else
+    echo "Multiple schema types detected. Choose:"
+    local i=1
+    for t in "${DETECTED_TYPES[@]}"; do echo "  $i) $t"; i=$((i+1)); done
+    local choice; choice=$(ask "Number" "1")
+    type="${DETECTED_TYPES[$((choice-1))]}"
+  fi
+
+  case "$type" in
+    prisma)     input="$PRISMA_SCHEMA" ;;
+    openapi)    input="$OPENAPI_FILE" ;;
+    jsonschema) input="${JSON_SCHEMAS[0]}" ;;
+  esac
+
+  info "Input : $input"
+  info "Output: $GENERATED_DIR/entities.ts"
+  echo
+  run_adapter_convert "$type" "$input" "$GENERATED_DIR/entities.ts"
+  pause
+}
+
+# ============================================================
+# MENU 2 : DATABASES
+# ============================================================
+
+menu_databases() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Database configuration${RESET}"
+  echo
+  echo -e "  ${CYAN}1${RESET}) MongoDB           : ${DIM}${MONGODB_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}2${RESET}) PostgreSQL        : ${DIM}${POSTGRES_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}3${RESET}) MySQL / MariaDB   : ${DIM}${MYSQL_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}4${RESET}) SQLite            : ${DIM}${SQLITE_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}5${RESET}) Oracle            : ${DIM}${ORACLE_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}6${RESET}) MSSQL             : ${DIM}${MSSQL_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}7${RESET}) DB2               : ${DIM}${DB2_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}8${RESET}) HANA              : ${DIM}${HANA_URI:-<not set>}${RESET}"
+  echo -e "  ${CYAN}9${RESET}) CockroachDB       : ${DIM}${COCKROACH_URI:-<not set>}${RESET}"
+  echo
+  echo -e "  ${CYAN}p${RESET}) App port (Next.js/Express) : ${DIM}${APP_PORT:-3000}${RESET}"
+  echo -e "  ${CYAN}n${RESET}) mosta-net port              : ${DIM}${MOSTA_NET_PORT:-4447}${RESET}"
+  echo
+  echo -e "  ${CYAN}t${RESET}) Test all connections"
+  echo -e "  ${CYAN}r${RESET}) Reset config"
+  echo -e "  ${CYAN}b${RESET}) Back"
+  echo
+  local choice; choice=$(ask "Choice" "1")
+  case "$choice" in
+    1) save_var MONGODB_URI   "$(ask 'MongoDB URI' "${MONGODB_URI:-mongodb://localhost:27017/app}")";;
+    2) save_var POSTGRES_URI  "$(ask 'PostgreSQL URI' "${POSTGRES_URI:-postgres://user:pw@localhost:5432/app}")";;
+    3) save_var MYSQL_URI     "$(ask 'MySQL/MariaDB URI' "${MYSQL_URI:-mysql://user:pw@localhost:3306/app}")";;
+    4) save_var SQLITE_URI    "$(ask 'SQLite path or :memory:' "${SQLITE_URI:-./data.sqlite}")";;
+    5) save_var ORACLE_URI    "$(ask 'Oracle URI' "${ORACLE_URI:-oracle://user:pw@localhost:1521/ORCLPDB}")";;
+    6) save_var MSSQL_URI     "$(ask 'MSSQL URI' "${MSSQL_URI:-mssql://user:pw@localhost:1433/app}")";;
+    7) save_var DB2_URI       "$(ask 'DB2 URI' "${DB2_URI:-db2://user:pw@localhost:50000/app}")";;
+    8) save_var HANA_URI      "$(ask 'HANA URI' "${HANA_URI:-hana://user:pw@localhost:39041}")";;
+    9) save_var COCKROACH_URI "$(ask 'CockroachDB URI' "${COCKROACH_URI:-postgres://user@localhost:26257/app}")";;
+    p|P) save_var APP_PORT       "$(ask 'App port' "${APP_PORT:-3000}")";;
+    n|N) save_var MOSTA_NET_PORT "$(ask 'mosta-net port' "${MOSTA_NET_PORT:-4447}")";;
+    t|T) action_test_connections; return;;
+    r|R) confirm "Really reset config?" && rm -f "$CONFIG_FILE" && ok "Reset";;
+    b|B) return;;
+    *) warn "Unknown";;
+  esac
+  pause
+  menu_databases
+}
+
+action_test_connections() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Testing connections${RESET}"
+  echo
+  load_env
+  local tested=0
+
+  if [[ -n "${MONGODB_URI:-}" ]]; then
+    info "MongoDB : $MONGODB_URI"
+    if command -v mongosh >/dev/null 2>&1; then
+      echo "db.stats()" | mongosh "$MONGODB_URI" --quiet >/dev/null 2>&1 && ok "reachable" || err "failed"
+    else warn "mongosh not installed"; fi
+    tested=$((tested+1))
+  fi
+
+  for pair in "POSTGRES_URI:psql" "MYSQL_URI:mysql" "MSSQL_URI:sqlcmd" "ORACLE_URI:sqlplus"; do
+    local var="${pair%%:*}"
+    local tool="${pair##*:}"
+    local uri="${!var:-}"
+    [[ -z "$uri" ]] && continue
+    info "$var : $uri"
+    if command -v "$tool" >/dev/null 2>&1; then
+      case "$tool" in
+        psql)   psql "$uri" -c "SELECT 1" >/dev/null 2>&1 && ok reachable || err failed;;
+        mysql)  mysql --defaults-file="/dev/null" -e "SELECT 1" >/dev/null 2>&1 && ok reachable || warn "manual test needed";;
+        *)      warn "tested via tool $tool — manual check";;
+      esac
+    else warn "$tool not installed"; fi
+    tested=$((tested+1))
+  done
+
+  [[ $tested -eq 0 ]] && warn "No URIs configured"
+  pause
+}
+
+# ============================================================
+# ACTION 3 : INIT DIALECTS
+# ============================================================
+
+action_init_dialects() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Initialize dialects${RESET}"
+  echo
+  load_env
+
+  if [[ ! -f "$GENERATED_DIR/entities.ts" ]]; then
+    err "No entities.ts. Run menu 1 (Convert) first."
+    pause; return
+  fi
+
+  info "Will attempt to initialize dialects for these URIs:"
+  local any=0
+  for var in MONGODB_URI POSTGRES_URI MYSQL_URI SQLITE_URI ORACLE_URI MSSQL_URI DB2_URI; do
+    local val="${!var:-}"
+    [[ -n "$val" ]] && { dim "  $var = $val"; any=1; }
+  done
+  [[ $any -eq 0 ]] && { err "No URIs set. Menu 2 first."; pause; return; }
+
+  confirm "Proceed?" || return
+
+  cat > "$CONFIG_DIR/init-all.mjs" << 'EOF'
+import { readFileSync } from 'fs';
+import { getDialect } from '@mostajs/orm';
+import { entities } from './generated/entities.js';
+
+const dialects = [
+  ['mongodb',  process.env.MONGODB_URI],
+  ['postgres', process.env.POSTGRES_URI],
+  ['mysql',    process.env.MYSQL_URI],
+  ['sqlite',   process.env.SQLITE_URI],
+  ['oracle',   process.env.ORACLE_URI],
+  ['mssql',    process.env.MSSQL_URI],
+  ['db2',      process.env.DB2_URI],
+];
+
+for (const [dialect, uri] of dialects) {
+  if (!uri) continue;
+  console.log(`\n\u2192 ${dialect} : ${uri}`);
+  try {
+    const d = await getDialect({ dialect, uri, schemaStrategy: 'update' });
+    await d.initSchema(entities);
+    console.log(`  \u2713 ${dialect} ready (${entities.length} entities)`);
+    await d.disconnect();
+  } catch (e) {
+    console.error(`  \u2717 ${dialect} failed : ${e.message}`);
+  }
+}
+EOF
+  cd "$PROJECT_ROOT"
+  node "$CONFIG_DIR/init-all.mjs" 2>&1 | tee "$LOG_DIR/init.log"
+  pause
+}
+
+# ============================================================
+# MENU 4 : TESTS
+# ============================================================
+
+menu_tests() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Tests menu${RESET}"
+  echo
+  echo -e "  ${CYAN}1${RESET}) Human : open app in browser"
+  echo -e "  ${CYAN}2${RESET}) Human : open mosta-net dashboard"
+  echo -e "  ${CYAN}3${RESET}) Mobile : QR code for LAN access"
+  echo -e "  ${CYAN}4${RESET}) AI : MCP endpoint config (Claude/GPT)"
+  echo -e "  ${CYAN}5${RESET}) curl : smoke test REST endpoints"
+  echo -e "  ${CYAN}6${RESET}) Playwright"
+  echo -e "  ${CYAN}7${RESET}) Jest / Vitest"
+  echo
+  echo -e "  ${CYAN}b${RESET}) Back"
+  echo
+  local choice; choice=$(ask "Choice" "1")
+  case "$choice" in
+    1) open_url "http://localhost:${APP_PORT:-3000}";;
+    2) open_url "http://localhost:${MOSTA_NET_PORT:-4447}";;
+    3) action_qr_mobile;;
+    4) action_mcp_info;;
+    5) action_curl_test;;
+    6) run_in_project "npx playwright test";;
+    7) run_in_project "$PKG_MANAGER test";;
+    b|B) return;;
+    *) warn Unknown;;
+  esac
+  pause
+  menu_tests
+}
+
+open_url() {
+  local url="$1"
+  info "Opening $url"
+  if   command -v xdg-open >/dev/null 2>&1; then xdg-open "$url" >/dev/null 2>&1 &
+  elif command -v open >/dev/null 2>&1; then open "$url" &
+  elif command -v start >/dev/null 2>&1; then start "$url"
+  else warn "Cannot auto-open. Visit: $url"
+  fi
+}
+
+action_qr_mobile() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Mobile QR${RESET}"
+  echo
+  local port="${APP_PORT:-3000}"
+  local ip
+  ip=$(hostname -I 2>/dev/null | awk '{print $1}' || \
+       ifconfig 2>/dev/null | grep -oE 'inet (addr:)?([0-9]+\.){3}[0-9]+' | grep -v '127.0' | head -1 | awk '{print $2}' | sed 's/addr://')
+  [[ -z "$ip" ]] && ip="localhost"
+  local url="http://${ip}:${port}"
+  info "$url"
+  echo
+  if command -v qrencode >/dev/null 2>&1; then
+    qrencode -t ANSIUTF8 "$url"
+  else
+    warn "qrencode missing. Install: sudo apt install qrencode"
+    echo -e "${BOLD}URL for phone : ${CYAN}$url${RESET}"
+  fi
+}
+
+action_mcp_info() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ AI / MCP${RESET}"
+  echo
+  local url="http://localhost:${MOSTA_NET_PORT:-4447}/mcp"
+  info "MCP endpoint : $url"
+  echo
+  info "Claude Desktop (~/.config/Claude/claude_desktop_config.json or %APPDATA%\\Claude):"
+  cat <<EOF
+${DIM}{
+  "mcpServers": {
+    "$(basename "$PROJECT_ROOT")": {
+      "url": "$url"
+    }
+  }
+}${RESET}
+EOF
+  echo
+  info "For any MCP-compatible client (Cursor, Continue, GPT clients), point to $url"
+  echo
+  if curl -fsS --max-time 3 "$url" >/dev/null 2>&1; then
+    ok "Endpoint responds"
+  else
+    warn "Endpoint not reachable — start mosta-net first (menu 5)"
+  fi
+}
+
+action_curl_test() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ curl smoke test${RESET}"
+  echo
+  for url in \
+    "http://localhost:${APP_PORT:-3000}/" \
+    "http://localhost:${APP_PORT:-3000}/api/health" \
+    "http://localhost:${MOSTA_NET_PORT:-4447}/" \
+    "http://localhost:${MOSTA_NET_PORT:-4447}/mcp"; do
+    info "GET $url"
+    curl -s -o /dev/null -w "    status=%{http_code}  time=%{time_total}s\n" --max-time 5 "$url" 2>/dev/null || err "failed"
+  done
+}
+
+run_in_project() {
+  cd "$PROJECT_ROOT"
+  info "Running: $1"
+  eval "$1"
+}
+
+# ============================================================
+# MENU 5 : SERVICES
+# ============================================================
+
+menu_services() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Services${RESET}"
+  echo
+  echo -e "  ${CYAN}1${RESET}) Start project dev server ($PKG_MANAGER run dev)"
+  echo -e "  ${CYAN}2${RESET}) Start mosta-net server (requires separate install)"
+  echo -e "  ${CYAN}3${RESET}) Stop all tracked services"
+  echo -e "  ${CYAN}4${RESET}) Status"
+  echo -e "  ${CYAN}5${RESET}) Show access URLs"
+  echo
+  echo -e "  ${CYAN}b${RESET}) Back"
+  echo
+  local choice; choice=$(ask "Choice" "1")
+  case "$choice" in
+    1) svc_start_dev;;
+    2) svc_start_mostanet;;
+    3) svc_stop_all;;
+    4) svc_status;;
+    5) show_urls;;
+    b|B) return;;
+    *) warn Unknown;;
+  esac
+  pause
+  menu_services
+}
+
+svc_start_dev() {
+  cd "$PROJECT_ROOT"
+  if [[ ! -f package.json ]]; then err "No package.json"; return; fi
+  info "Starting dev server (logs → $LOG_DIR/dev.log)"
+  nohup "$PKG_MANAGER" run dev > "$LOG_DIR/dev.log" 2>&1 &
+  echo "$!" > "$LOG_DIR/dev.pid"
+  ok "Started PID $!"
+  show_urls
+}
+
+svc_start_mostanet() {
+  warn "mosta-net server not yet installed. Provision with :"
+  dim "  $PKG_MANAGER install @mostajs/net"
+  dim "  then run : npx mosta-net --entities .mostajs/generated/entities.ts"
+}
+
+svc_stop_all() {
+  for pf in "$LOG_DIR"/*.pid; do
+    [[ -f "$pf" ]] || continue
+    local pid; pid=$(cat "$pf")
+    kill "$pid" 2>/dev/null && ok "Stopped $(basename "$pf" .pid) (PID $pid)"
+    rm -f "$pf"
+  done
+}
+
+svc_status() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Status${RESET}"
+  echo
+  for pf in "$LOG_DIR"/*.pid; do
+    [[ -f "$pf" ]] || continue
+    local pid; pid=$(cat "$pf")
+    local name; name=$(basename "$pf" .pid)
+    kill -0 "$pid" 2>/dev/null && ok "$name (PID $pid)" || warn "$name dead (stale)"
+  done
+  [[ -z "$(ls "$LOG_DIR"/*.pid 2>/dev/null)" ]] && dim "No services tracked"
+}
+
+show_urls() {
+  load_env
+  local ip
+  ip=$(hostname -I 2>/dev/null | awk '{print $1}' || echo localhost)
+  echo
+  echo -e "${BOLD}Access URLs${RESET}"
+  echo -e "  Dev server (local)  : ${CYAN}http://localhost:${APP_PORT:-3000}${RESET}"
+  echo -e "  Dev server (mobile) : ${CYAN}http://${ip}:${APP_PORT:-3000}${RESET}"
+  echo -e "  mosta-net           : ${CYAN}http://localhost:${MOSTA_NET_PORT:-4447}${RESET}"
+  echo -e "  MCP endpoint (AI)   : ${CYAN}http://localhost:${MOSTA_NET_PORT:-4447}/mcp${RESET}"
+}
+
+# ============================================================
+# ACTION 6 : METRICS
+# ============================================================
+
+action_metrics() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Metrics${RESET}"
+  echo
+  detect_project
+
+  echo -e "${BOLD}Source${RESET}"
+  if [[ -n "$PRISMA_SCHEMA" ]]; then
+    echo "  Prisma models  : $(grep -c '^model ' "$PRISMA_SCHEMA")"
+    echo "  Prisma lines   : $(wc -l < "$PRISMA_SCHEMA")"
+  fi
+  [[ -n "$OPENAPI_FILE" ]] && echo "  OpenAPI file   : $OPENAPI_FILE"
+  [[ ${#JSON_SCHEMAS[@]} -gt 0 ]] && echo "  JSON schemas   : ${#JSON_SCHEMAS[@]}"
+
+  echo
+  echo -e "${BOLD}Conversion${RESET}"
+  if [[ -f "$GENERATED_DIR/entities.ts" ]]; then
+    echo "  entities.ts    : $(grep -c '"name":' "$GENERATED_DIR/entities.ts") entities, $(du -h "$GENERATED_DIR/entities.ts" | cut -f1)"
+    echo "  last generated : $(stat -c '%y' "$GENERATED_DIR/entities.ts" 2>/dev/null | cut -d. -f1 || stat -f '%Sm' "$GENERATED_DIR/entities.ts" 2>/dev/null)"
+  else
+    echo "  (not generated yet)"
+  fi
+
+  echo
+  echo -e "${BOLD}Services${RESET}"
+  local n=0
+  for pf in "$LOG_DIR"/*.pid; do [[ -f "$pf" ]] && n=$((n+1)); done
+  echo "  running        : $n"
+
+  echo
+  echo -e "${BOLD}Logs${RESET}"
+  for f in "$LOG_DIR"/*.log; do
+    [[ -f "$f" ]] || continue
+    echo "  $(basename "$f") : $(wc -l < "$f") lines"
+  done
+
+  pause
+}
+
+# ============================================================
+# ACTION 7 : LOGS
+# ============================================================
+
+action_logs() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Logs${RESET}"
+  echo
+  local logs=()
+  for f in "$LOG_DIR"/*.log; do [[ -f "$f" ]] && logs+=("$f"); done
+  if [[ ${#logs[@]} -eq 0 ]]; then warn "No logs yet"; pause; return; fi
+
+  local i=1
+  for f in "${logs[@]}"; do
+    echo -e "  ${CYAN}$i${RESET}) $(basename "$f")  ${DIM}($(wc -l < "$f") lines)${RESET}"
+    i=$((i+1))
+  done
+  echo
+  local choice; choice=$(ask "File #" 1)
+  local idx=$((choice-1))
+  [[ $idx -ge 0 && $idx -lt ${#logs[@]} ]] && ${PAGER:-less} "${logs[$idx]}"
+}
+
+# ============================================================
+# ACTION 8 : HEALTH
+# ============================================================
+
+action_healthcheck() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Health checks${RESET}"
+  echo
+  detect_project
+  command -v node >/dev/null 2>&1 && ok "node $(node -v)" || err "node missing"
+  command -v "$PKG_MANAGER" >/dev/null 2>&1 && ok "$PKG_MANAGER $("$PKG_MANAGER" --version 2>&1 | head -1)" || err "$PKG_MANAGER missing"
+  [[ -f "$PROJECT_ROOT/package.json" ]] && ok "package.json" || warn "no package.json"
+  [[ -d "$PROJECT_ROOT/node_modules" ]] && ok "node_modules present" || warn "node_modules missing"
+  [[ ${#DETECTED_TYPES[@]} -gt 0 ]] && ok "schemas detected: ${DETECTED_TYPES[*]}" || warn "no schema found"
+  [[ -f "$GENERATED_DIR/entities.ts" ]] && ok "entities.ts generated" || warn "not generated"
+  [[ -f "$CONFIG_FILE" ]] && ok "config present" || warn "config not set"
+
+  command -v curl >/dev/null 2>&1 && ok "curl" || warn "curl missing"
+  command -v qrencode >/dev/null 2>&1 && ok "qrencode" || warn "qrencode missing (optional, for mobile QR)"
+  command -v mongosh >/dev/null 2>&1 && ok "mongosh" || warn "mongosh missing (optional, for mongo tests)"
+  command -v psql    >/dev/null 2>&1 && ok "psql" || warn "psql missing (optional, for PG tests)"
+  command -v xdg-open >/dev/null 2>&1 || command -v open >/dev/null 2>&1 && ok "browser-opener available" || warn "cannot auto-open URLs"
+  pause
+}
+
+# ============================================================
+# ACTION 9 : GENERATE BOILERPLATE
+# ============================================================
+
+action_generate_boilerplate() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Generate boilerplate${RESET}"
+  echo
+  echo "Available templates :"
+  echo "  1) src/db.ts — Prisma bridge wrapper (choose which models move)"
+  echo "  2) src/mosta-orm.ts — direct mosta-orm usage (no Prisma)"
+  echo "  3) .env.example with all URIs"
+  echo
+  local choice; choice=$(ask "Choice" 1)
+  case "$choice" in
+    1) gen_prisma_bridge_boilerplate;;
+    2) gen_direct_boilerplate;;
+    3) gen_env_example;;
+    *) warn Unknown;;
+  esac
+  pause
+}
+
+gen_prisma_bridge_boilerplate() {
+  local target="$PROJECT_ROOT/src/db.ts"
+  mkdir -p "$(dirname "$target")"
+  cat > "$target" <<'EOF'
+// Auto-generated by @mostajs/orm-cli
+// Prisma bridge : intercepts specific models and routes them to @mostajs/orm dialects
+
+import { PrismaClient } from '@prisma/client';
+import { mostaExtension } from '@mostajs/orm-bridge/prisma';
+import { entityByName } from '../.mostajs/generated/entities.js';
+
+const g = globalThis as unknown as { prisma?: ReturnType<typeof build> };
+
+function build() {
+  return new PrismaClient().$extends(mostaExtension({
+    models: {
+      // Example : move AuditLog to MongoDB (uncomment and adapt)
+      // AuditLog: {
+      //   dialect: 'mongodb',
+      //   url: process.env.MONGODB_URI!,
+      //   schema: entityByName.AuditLog,
+      // },
+
+      // Example : move analytics-heavy models to PostgreSQL
+      // CheckIn: {
+      //   dialect: 'postgres',
+      //   url: process.env.ANALYTICS_PG!,
+      //   schema: entityByName.CheckIn,
+      // },
+    },
+    fallback: 'source',          // unmapped models → Prisma default engine
+    onIntercept: (e) => {
+      if (process.env.NODE_ENV !== 'production') {
+        console.log(`[bridge] ${e.model}.${e.operation} → ${e.dialect} (${e.duration}ms)`);
+      }
+    },
+  }));
+}
+
+export const prisma = g.prisma ?? build();
+if (process.env.NODE_ENV !== 'production') g.prisma = prisma;
+EOF
+  ok "Written : $target"
+  info "Next steps :"
+  dim "  - Review + pick which models to move"
+  dim "  - Replace 'new PrismaClient()' with this 'prisma' import throughout your app"
+}
+
+gen_direct_boilerplate() {
+  local target="$PROJECT_ROOT/src/mosta-orm.ts"
+  mkdir -p "$(dirname "$target")"
+  cat > "$target" <<'EOF'
+// Auto-generated by @mostajs/orm-cli
+// Direct @mostajs/orm usage — no Prisma dependency
+
+import { getDialect } from '@mostajs/orm';
+import { entities, entityByName } from '../.mostajs/generated/entities.js';
+
+export async function createOrm() {
+  const dialect = await getDialect({
+    dialect: (process.env.MOSTA_DIALECT ?? 'postgres') as any,
+    uri: process.env.DATABASE_URL ?? '',
+    schemaStrategy: 'update',
+  });
+  await dialect.initSchema(entities);
+  return { dialect, entities, entityByName };
+}
+EOF
+  ok "Written : $target"
+}
+
+gen_env_example() {
+  local target="$PROJECT_ROOT/.env.example"
+  cat > "$target" <<'EOF'
+# ===== @mostajs/orm — 13 databases =====
+MONGODB_URI=mongodb://localhost:27017/app
+POSTGRES_URI=postgres://user:pw@localhost:5432/app
+MYSQL_URI=mysql://user:pw@localhost:3306/app
+SQLITE_URI=./data.sqlite
+ORACLE_URI=oracle://user:pw@localhost:1521/ORCLPDB
+MSSQL_URI=mssql://user:pw@localhost:1433/app
+DB2_URI=db2://user:pw@localhost:50000/app
+HANA_URI=hana://user:pw@localhost:39041
+COCKROACH_URI=postgres://user@localhost:26257/app
+
+APP_PORT=3000
+MOSTA_NET_PORT=4447
+EOF
+  ok "Written : $target"
+}
+
+# ============================================================
+# ACTION 0 : ABOUT
+# ============================================================
+
+action_about() {
+  header
+  cat <<EOF
+  ${BOLD}mostajs-cli v$VERSION${RESET}
+
+  Convert schemas from multiple formats to @mostajs/orm EntitySchema[]
+  and gain access to 13 databases without rewriting your code.
+
+  ${BOLD}Supported inputs${RESET}
+    - Prisma   (.prisma files)
+    - OpenAPI  (3.0, 3.1, YAML/JSON)
+    - JSON Schema (Draft-07, 2019-09, 2020-12)
+
+  ${BOLD}Supported databases${RESET}
+    PostgreSQL, MySQL, MariaDB, SQLite, MS SQL Server, Oracle, DB2,
+    CockroachDB, HANA, HSQLDB, Spanner, Sybase, MongoDB
+
+  ${BOLD}Links${RESET}
+    Packages  : @mostajs/orm, @mostajs/orm-adapter, @mostajs/orm-bridge
+    GitHub    : https://github.com/apolocine
+    Author    : Dr Hamid MADANI <drmdh@msn.com>
+    License   : AGPL-3.0-or-later (+ commercial)
+
+  ${BOLD}Workflow${RESET}
+    1. cd your/project
+    2. mostajs (this tool)
+    3. Menu 1 → convert your schema
+    4. Menu 2 → set your DB URIs
+    5. Menu 3 → init tables
+    6. Menu 9 → generate boilerplate
+    7. Menu 5 → start services
+    8. Menu 4 → test (human / mobile / AI)
+EOF
+  pause
+}
+
+# ============================================================
+# CLI SUBCOMMANDS (non-interactive)
+# ============================================================
+
+run_subcommand() {
+  case "$1" in
+    convert|c)
+      detect_project
+      [[ ${#DETECTED_TYPES[@]} -eq 0 ]] && { err "No schema found"; exit 1; }
+      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"
+      ;;
+    detect|d)
+      detect_project
+      echo "project: $PROJECT_ROOT"
+      echo "package manager: $PKG_MANAGER"
+      echo "detected: ${DETECTED_TYPES[*]:-none}"
+      [[ -n "$PRISMA_SCHEMA" ]] && echo "prisma: $PRISMA_SCHEMA"
+      [[ -n "$OPENAPI_FILE" ]] && echo "openapi: $OPENAPI_FILE"
+      ;;
+    health|h)
+      action_healthcheck
+      ;;
+    version|-v|--version)
+      echo "$CLI_NAME $VERSION"
+      ;;
+    help|-h|--help)
+      cat <<EOF
+Usage :
+  $CLI_NAME                 Interactive menu
+  $CLI_NAME convert         Run conversion (auto-detect schema type)
+  $CLI_NAME detect          Print detected schemas
+  $CLI_NAME health          Run health checks
+  $CLI_NAME version         Print version
+EOF
+      ;;
+    *)
+      err "Unknown command: $1"
+      echo "Run '$CLI_NAME help' for usage"
+      exit 1
+      ;;
+  esac
+}
+
+# ============================================================
+# MAIN
+# ============================================================
+
+# Non-interactive mode if args provided
+if [[ $# -gt 0 ]]; then
+  run_subcommand "$@"
+  exit 0
+fi
+
+# Interactive menu
+while true; do
+  menu_main
+done