@mostajs/orm-cli 0.6.3 → 0.7.0

package/bin/mostajs.sh

@@ -246,10 +246,13 @@ detect_project() {
   JSON_SCHEMAS=()
   PKG_MANAGER=""
 
-  # Prisma
+  # Prisma (check prisma/ subdir first, then root)
   if [[ -f "$PROJECT_ROOT/prisma/schema.prisma" ]]; then
     PRISMA_SCHEMA="$PROJECT_ROOT/prisma/schema.prisma"
     DETECTED_TYPES+=("prisma")
+  elif [[ -f "$PROJECT_ROOT/schema.prisma" ]]; then
+    PRISMA_SCHEMA="$PROJECT_ROOT/schema.prisma"
+    DETECTED_TYPES+=("prisma")
   fi
 
   # OpenAPI (common names)
@@ -545,6 +548,10 @@ menu_main() {
   echo -e "  ${CYAN}r${RESET}) ${BOLD}Replicator${RESET} — CQRS master/slave, CDC rules, failover"
   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 "  ${GREEN}f${RESET}) ${BOLD}Fix Mongo _id${RESET} — codemod \`obj._id\` → \`obj.id\` after data-plug migration"
+  echo -e "  ${GREEN}m${RESET}) ${BOLD}Mongo introspect${RESET} — live MongoDB → entities.json (reverse-engineer)"
+  echo -e "  ${GREEN}v${RESET}) ${BOLD}Validate${RESET} — lint entities.json with the ORM validator (R001–R021)"
+  echo -e "  ${GREEN}l${RESET}) ${BOLD}Load data${RESET} — .env-piloted cross-dialect load (Mongo/dump/JSON/SQL → DB)"
   echo -e "  ${CYAN}0${RESET}) About / Help"
   echo
   echo -e "  ${RED}q${RESET}) Quit"
@@ -566,6 +573,10 @@ menu_main() {
     r|R) menu_replicator ;;
     b|B) menu_bootstrap ;;
     i|I) menu_install_bridge ;;
+    f|F) menu_fix_ids ;;
+    m|M) menu_mongo_introspect ;;
+    v|V) menu_validate ;;
+    l|L) menu_load_data ;;
     0) action_about ;;
     q|Q) exit 0 ;;
     *) warn "Unknown choice"; pause ;;
@@ -599,6 +610,139 @@ menu_install_bridge() {
   pause
 }
 
+# ------------------------------------------------------------
+# Interactive wrapper for `fix-ids` codemod (Mongo _id → id)
+# ------------------------------------------------------------
+menu_fix_ids() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Fix Mongo _id → id — post data-plug migration codemod${RESET}"
+  echo
+  echo -e "  ${DIM}@mostajs/orm normalizes ${CYAN}_id${DIM}→${CYAN}id${DIM} for every dialect (mongo included),${RESET}"
+  echo -e "  ${DIM}so app code must read ${CYAN}obj.id${DIM}. This rewrites stale ${CYAN}obj._id${DIM} reads.${RESET}"
+  echo
+  echo -e "  ${CYAN}1${RESET}) Dry-run : list \`._id\` reads that would be rewritten (default)"
+  echo -e "  ${CYAN}2${RESET}) Apply   : rewrite \`obj._id\` → \`obj.id\` (backups : *.mongoid.bak)"
+  echo -e "  ${CYAN}3${RESET}) Restore : revert .mongoid.bak files (dry-run)"
+  echo -e "  ${CYAN}4${RESET}) Restore : revert .mongoid.bak files (apply)"
+  echo -e "  ${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/fix-mongo-id.mjs" --project "$PROJECT_ROOT" ;;
+    2) node "$cli_dir/bin/fix-mongo-id.mjs" --project "$PROJECT_ROOT" --apply ;;
+    3) node "$cli_dir/bin/fix-mongo-id.mjs" --project "$PROJECT_ROOT" --restore ;;
+    4) node "$cli_dir/bin/fix-mongo-id.mjs" --project "$PROJECT_ROOT" --restore --apply ;;
+    0) return ;;
+    *) warn "Unknown" ;;
+  esac
+  pause
+}
+
+# ------------------------------------------------------------
+# Interactive wrapper for `mongo-introspect` (live MongoDB → entities.json)
+# ------------------------------------------------------------
+menu_mongo_introspect() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Mongo introspect — reverse-engineer a live MongoDB${RESET}"
+  echo
+  echo -e "  ${DIM}Samples documents per collection and infers EntitySchema[] →${RESET}"
+  echo -e "  ${DIM}${GENERATED_DIR}/entities.json (the ORM drops _id/__v, ObjectId → string id).${RESET}"
+  echo
+  if [[ "${DB_DIALECT:-}" != "mongodb" ]]; then
+    warn "DB_DIALECT is '${DB_DIALECT:-<unset>}', not 'mongodb'."
+    info "Set it (menu 2 → i to import from the project .env), or enter a URI now."
+  fi
+  local uri; uri=$(ask "MongoDB URI" "${SGBD_URI:-mongodb://localhost:27017/mydb}")
+  [[ -z "$uri" ]] && { warn "No URI"; pause; return; }
+  local sample; sample=$(ask "Docs to sample per collection" "200")
+  local cli_dir
+  cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+  node "$cli_dir/bin/mongo-introspect.mjs" --uri "$uri" --sample "$sample" --out "$GENERATED_DIR/entities.json" --project "$PROJECT_ROOT"
+  pause
+}
+
+# ------------------------------------------------------------
+# Interactive wrapper for `validate` (ORM validator over entities.json)
+# ------------------------------------------------------------
+menu_validate() {
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Validate — ORMConceptValidator (R001–R021)${RESET}"
+  echo
+  if [[ ! -f "$GENERATED_DIR/entities.json" ]]; then
+    err "No entities.json. Run menu 1 (Convert) or menu m (Mongo introspect) first."
+    pause; return
+  fi
+  echo -e "  ${CYAN}1${RESET}) Text report (default)"
+  echo -e "  ${CYAN}2${RESET}) Markdown → report saved next to entities.json"
+  echo -e "  ${CYAN}3${RESET}) JSON (stdout)"
+  echo -e "  ${CYAN}4${RESET}) Text + cross-file rules (prompt for --src dir)"
+  echo -e "  ${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/validate.mjs" --project "$PROJECT_ROOT" ;;
+    2) node "$cli_dir/bin/validate.mjs" --project "$PROJECT_ROOT" --format markdown --out "$GENERATED_DIR/validation-report.md" ;;
+    3) node "$cli_dir/bin/validate.mjs" --project "$PROJECT_ROOT" --format json ;;
+    4) local src; src=$(ask "Sources root (e.g. ./src)" "$PROJECT_ROOT/src")
+       node "$cli_dir/bin/validate.mjs" --project "$PROJECT_ROOT" --src "$src" ;;
+    0) return ;;
+    *) warn "Unknown" ;;
+  esac
+  pause
+}
+
+# ------------------------------------------------------------
+# Interactive wrapper for `load-data` — .env-piloted cross-dialect load
+# (delegates to @mostajs/orm-copy-data's `mostajs-load` bin)
+# ------------------------------------------------------------
+menu_load_data() {
+  load_env
+  header
+  echo -e "${BOLD}${MAGENTA}▶ Load data — charge un dump vers la base .env (cross-dialecte)${RESET}"
+  echo
+  echo -e "  ${DIM}Destination (.env) : ${CYAN}${DB_DIALECT:-<DB_DIALECT non défini>}${DIM} → ${CYAN}${SGBD_URI:-<SGBD_URI non défini>}${RESET}"
+  if [[ -f "$GENERATED_DIR/entities.json" ]]; then
+    echo -e "  ${DIM}Schémas : ${GENERATED_DIR}/entities.json ${GREEN}(présent)${RESET}"
+  else
+    warn "entities.json absent → lance d'abord le menu ${BOLD}m${RESET} (Mongo introspect) ou ${BOLD}1${RESET} (Convert)."
+  fi
+  echo
+  echo -e "  ${BOLD}Source :${RESET}"
+  echo -e "   ${CYAN}1${RESET}) MongoDB live (URI)"
+  echo -e "   ${CYAN}2${RESET}) mongodump (dossier BSON → mongorestore)"
+  echo -e "   ${CYAN}3${RESET}) Export JSON (fichier)"
+  echo -e "   ${CYAN}4${RESET}) Dump SQL (fichier)"
+  echo -e "   ${RED}0${RESET}) Retour"
+  echo
+
+  ensure_pkg "@mostajs/orm-copy-data" || { pause; return; }
+  local cd_main cd_bin
+  cd_main="$(resolve_pkg_path '@mostajs/orm-copy-data')" || { err "copy-data introuvable"; pause; return; }
+  cd_bin="$(dirname "$(dirname "$cd_main")")/bin/load-data.mjs"
+  [[ -f "$cd_bin" ]] || { err "bin mostajs-load absent — @mostajs/orm-copy-data ≥0.3.0 requis"; pause; return; }
+
+  local choice; choice=$(ask "Choix" "1")
+  case "$choice" in
+    1) local uri; uri=$(ask "URI Mongo source" "${SOURCE_SGBD_URI:-mongodb://127.0.0.1:27017/TicketFlow}")
+       node "$cd_bin" --project "$PROJECT_ROOT" --from mongo --source-uri "$uri" ;;
+    2) local dir; dir=$(ask "Dossier mongodump (BSON)" "./dump/TicketFlow")
+       local ruri; ruri=$(ask "URI Mongo de restauration" "${SOURCE_SGBD_URI:-mongodb://127.0.0.1:27017/tf_restore}")
+       node "$cd_bin" --project "$PROJECT_ROOT" --from mongodump --dump-dir "$dir" --restore-uri "$ruri" ;;
+    3) local f; f=$(ask "Fichier JSON" "./dump.json")
+       node "$cd_bin" --project "$PROJECT_ROOT" --from json --source-file "$f" ;;
+    4) local f; f=$(ask "Fichier SQL" "./dump.sql")
+       node "$cd_bin" --project "$PROJECT_ROOT" --from sql --source-file "$f" ;;
+    0) return ;;
+    *) warn "Inconnu" ;;
+  esac
+  pause
+}
+
 # ------------------------------------------------------------
 # Interactive wrapper for `bootstrap` — one-shot full migration
 # ------------------------------------------------------------
@@ -612,6 +756,7 @@ menu_bootstrap() {
   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 "  5. Scan app code for Mongo residue ${CYAN}obj._id${RESET} / ${CYAN}new ObjectId()${RESET} (dry-run ; ${DIM}fix-ids${RESET})"
   echo
   warn "Existing code changes will be backed up but NOT committed — review the diff before pushing."
   echo
@@ -3936,6 +4081,50 @@ run_subcommand() {
       shift
       node "$cli_dir/bin/install-bridge.mjs" "$@"
       ;;
+    fix-ids|fix-mongo-id|fixids)
+      # mostajs fix-ids [--apply] [--file X] [--project P] [--map old:new] [--restore]
+      # Codemod : repairs Mongo-era `obj._id` reads left in app code after a
+      # Mongoose → @mostajs/orm (data-plug) migration. The ORM's normalizer maps
+      # `_id`→`id` for EVERY dialect (mongo included), so the app must read `.id`.
+      # Dry-run by default ; pass --apply to write (backups : *.mongoid.bak).
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      shift
+      node "$cli_dir/bin/fix-mongo-id.mjs" "$@"
+      ;;
+    mongo-introspect|introspect|mi)
+      # mostajs mongo-introspect [--uri ...] [--sample N] [--out F] [--project P]
+      # Reverse-engineer a LIVE MongoDB into .mostajs/generated/entities.json by
+      # sampling docs (uses $SGBD_URI if --uri is omitted). The "migrer" step for
+      # Mongo projects that have no Prisma/OpenAPI schema.
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      shift
+      node "$cli_dir/bin/mongo-introspect.mjs" "$@"
+      ;;
+    validate|val)
+      # mostajs validate [--entities F] [--src DIR] [--format text|json|markdown]
+      #                  [--ignore r1,r2] [--out F] [--ci] [--max-warnings N]
+      # Run @mostajs/orm's ORMConceptValidator (R001–R021) over entities.json.
+      local cli_dir
+      cli_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+      shift
+      node "$cli_dir/bin/validate.mjs" "$@"
+      ;;
+    load-data|load|ld)
+      # mostajs load-data --from mongo|mongodump|json|sql [...flags]
+      # Thin DELEGATE to @mostajs/orm-copy-data's `mostajs-load` bin (where the
+      # feature lives). Destination from .env (DB_DIALECT/SGBD_URI) ; needs
+      # entities.json (run `mostajs mongo-introspect` first).
+      shift
+      ensure_pkg "@mostajs/orm-copy-data" || exit 1
+      local cd_main cd_bin
+      cd_main="$(resolve_pkg_path '@mostajs/orm-copy-data')" \
+        || { err "@mostajs/orm-copy-data introuvable après installation."; exit 1; }
+      cd_bin="$(dirname "$(dirname "$cd_main")")/bin/load-data.mjs"
+      [[ -f "$cd_bin" ]] || { err "bin mostajs-load absent ($cd_bin) — mets à jour @mostajs/orm-copy-data (≥0.3.0)."; exit 1; }
+      node "$cd_bin" --project "$PROJECT_ROOT" "$@"
+      ;;
     bootstrap|b)
       # mostajs bootstrap : the full zero-touch migration for a Prisma project.
       #   1. Rewrite every `new PrismaClient(...)` site (install-bridge --apply)
@@ -4355,8 +4544,16 @@ TREE
           ;;
       esac
 
-      # ─── Step 5 : Summary ───
-      echo -e "\n\e[1m▶ Step 5/6 : Summary\e[0m"
+      # ─── Step : repair Mongo _id / ObjectId residue in app code ───
+      # @mostajs/orm exposes ids as `id` (string) for EVERY dialect (mongo via its
+      # normalizer), so app code must stop reading `obj._id` / wrapping `new ObjectId()`.
+      # Run as a DRY-RUN here (non-destructive / CI-safe) and tell the user to apply.
+      echo -e "\n\e[1m▶ Step 5/6 : repair Mongo _id / ObjectId in app code (codemod, dry-run)\e[0m"
+      node "$cli_dir/bin/fix-mongo-id.mjs" --project "$PROJECT_ROOT" 2>&1 | sed 's/^/  /' || true
+      info "  To apply : ${CLI_NAME} fix-ids --apply   (backups *.mongoid.bak ; undo: --restore --apply)"
+
+      # ─── Step 6 : Summary ───
+      echo -e "\n\e[1m▶ Step 6/6 : Summary\e[0m"
       if (( BS_OK_CODEMOD && BS_OK_DEPS && BS_OK_CONVERT && BS_OK_DDL )); then
         cat <<DONE
 
@@ -4405,6 +4602,15 @@ Usage :
   $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 fix-ids                 Codemod : Mongo \`obj._id\`→\`obj.id\` + \`new ObjectId(x)\`→\`x\`
+                                      (dry-run ; add --apply to write, --restore to undo)
+  $CLI_NAME mongo-introspect        Reverse-engineer a live MongoDB → entities.json
+                                      (--uri ... --sample N ; uses \$SGBD_URI by default)
+  $CLI_NAME validate                Lint entities.json with the ORM validator (R001–R021)
+                                      (--format text|json|markdown --src DIR --ci)
+  $CLI_NAME load-data --from mongo|mongodump|json|sql …
+                                      .env-piloted cross-dialect load (delegates to
+                                      @mostajs/orm-copy-data ; dest = DB_DIALECT/SGBD_URI)
   $CLI_NAME convert                 Run conversion (auto-detect schema type)
   $CLI_NAME detect                  Print detected schemas
   $CLI_NAME health                  Run health checks

package/bin/validate.mjs

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+// validate.mjs — run @mostajs/orm's ORMConceptValidator over the entities the CLI
+// generated (`.mostajs/generated/entities.json`). Thin wrapper around the
+// published validator API (validateSchemas + reporters), so a migrated Mongo (or
+// any) project can be linted for schema anti-patterns (R001–R021).
+//
+// @author Dr Hamid MADANI <drmdh@msn.com>
+// License: AGPL-3.0-or-later
+//
+// Usage (invoked by bin/mostajs.sh as `mostajs validate`) :
+//
+//   node validate.mjs                          # text report on entities.json
+//   node validate.mjs --entities path.json      # explicit entities file
+//   node validate.mjs --src ./src               # enable cross-file rules (R005…)
+//   node validate.mjs --format markdown --out report.md
+//   node validate.mjs --ignore R015,R017
+//   node validate.mjs --ci --max-warnings 0     # exit 1 if findings ≥ threshold
+
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const argv = process.argv.slice(2);
+const flag = (n) => argv.includes(`--${n}`);
+const val  = (n, d) => { const i = argv.indexOf(`--${n}`); return i >= 0 ? argv[i + 1] : d; };
+
+const ROOT      = resolve(val('project', process.cwd()));
+const ENTITIES  = resolve(val('entities', `${ROOT}/.mostajs/generated/entities.json`));
+const SRC       = val('src') ? resolve(val('src')) : undefined;
+let   FORMAT    = val('format', 'text'); if (FORMAT === 'md') FORMAT = 'markdown';
+const OUT       = val('out') ? resolve(val('out')) : undefined;
+const IGNORE    = (val('ignore', '') || '').split(',').map((s) => s.trim()).filter(Boolean);
+const CI        = flag('ci');
+const MAXW      = Number(val('max-warnings', '0')) || 0;
+
+const c = { red: s => `\x1b[31m${s}\x1b[0m`, yellow: s => `\x1b[33m${s}\x1b[0m`, green: s => `\x1b[32m${s}\x1b[0m`, cyan: s => `\x1b[36m${s}\x1b[0m`, bold: s => `\x1b[1m${s}\x1b[0m`, dim: s => `\x1b[2m${s}\x1b[0m` };
+
+// ── Load entities.json (array of EntitySchema, as produced by convert / introspect) ──
+let schemas;
+try {
+  const raw = JSON.parse(readFileSync(ENTITIES, 'utf8'));
+  schemas = Array.isArray(raw) ? raw : (Array.isArray(raw.entities) ? raw.entities : null);
+  if (!schemas) throw new Error('not an EntitySchema[] (nor { entities: [...] })');
+} catch (e) {
+  console.error(c.red(`✗ Cannot read entities : ${ENTITIES}`));
+  console.error(c.dim(`  ${e.message}`));
+  console.error(`  Generate it first : ${c.cyan('mostajs convert')}  or  ${c.cyan('mostajs mongo-introspect')}`);
+  process.exit(2);
+}
+
+// ── Resolve the validator from the project first, then the CLI's own deps ──
+let validator;
+const cliDir = resolve(new URL('..', import.meta.url).pathname);
+for (const base of [ROOT, cliDir]) {
+  try {
+    const p = require.resolve('@mostajs/orm/validator', { paths: [base] });
+    validator = await import(pathToFileURL(p).href);
+    break;
+  } catch { /* try next */ }
+}
+// Final fallback : bare specifier resolves against the CLI's own node_modules.
+if (!validator) {
+  try { validator = await import('@mostajs/orm/validator'); } catch { /* give up below */ }
+}
+if (!validator) {
+  console.error(c.red('✗ @mostajs/orm (validator) not found in project or CLI.'));
+  console.error(`  Install it : ${c.cyan('npm i @mostajs/orm')}`);
+  process.exit(2);
+}
+
+const { validateSchemas, formatText, formatJson, formatMarkdown } = validator;
+
+// ── Run ──
+const report = await validateSchemas(schemas, { sourceRoot: SRC, ignore: IGNORE });
+
+const rendered = FORMAT === 'json' ? formatJson(report, true)
+  : FORMAT === 'markdown' ? formatMarkdown(report)
+    : formatText(report, { verbose: flag('verbose') });
+
+if (OUT) { writeFileSync(OUT, rendered); console.error(c.green(`✓ Report written : ${OUT}`)); }
+else { console.log(rendered); }
+
+// ── Summary line + CI gate ──
+const sev = report.countBySeverity || {};
+const warnOrWorse = (sev.error || 0) + (sev.warning || 0);
+console.error(
+  `\n${c.bold('Validate')} : ${report.schemaCount} schema(s) · ` +
+  `${c.red((sev.error || 0) + ' error')} · ${c.yellow((sev.warning || 0) + ' warning')} · ` +
+  `${c.dim((sev.info || 0) + ' info')}  ${c.dim(`(${report.durationMs}ms)`)}`,
+);
+
+if (CI && warnOrWorse > MAXW) {
+  console.error(c.red(`✗ CI gate : ${warnOrWorse} finding(s) ≥ max-warnings (${MAXW})`));
+  process.exit(1);
+}
+process.exit(0);

package/llms.txt

@@ -0,0 +1,75 @@
+# @mostajs/orm-cli — fiche LLM
+> CLI universelle pour intégrer @mostajs/orm — `mostajs bootstrap` migre un projet Prisma vers 13 bases sans toucher au code.
+
+- Version: 0.6.4 · Licence: AGPL-3.0-or-later · Auteur: Dr Hamid MADANI <drmdh@msn.com>
+- Chemin: mostajs/mosta-orm-cli · Statut audit: partiel (paquet bin/ uniquement, pas de dist/ TS exporté)
+
+## RÔLE
+Outil en ligne de commande. La commande phare `mostajs bootstrap` migre un projet Prisma
+existant vers @mostajs/orm en une passe : codemod (réécriture des `new PrismaClient(...)`),
+installation des runtimes, conversion du schéma, application du DDL. Aucun changement de code
+applicatif n'est requis. Fournit aussi un menu interactif et des sous-commandes utilitaires.
+Ce paquet est un exécutable (bin), pas une bibliothèque importable.
+
+## INSTALLATION
+npx @mostajs/orm-cli bootstrap        # zero-install (recommandé)
+npm install -g @mostajs/orm-cli       # global -> commande `mostajs`
+
+## EXPORTS
+Aucun export de bibliothèque. Le paquet expose un binaire :
+- `mostajs` -> ./bin/mostajs-launcher.cjs
+Fichiers bin : mostajs-launcher.cjs, install-bridge.mjs, mostajs.sh, mostajs.bat.
+
+## API — SOUS-COMMANDES
+- `mostajs bootstrap` — migration complète : codemod + install + convert + DDL
+  (chaque étape s'arrête à la première erreur, v0.4.1+)
+- `mostajs install-bridge` — lance le codemod en dry-run (rapport, aucune écriture)
+- `mostajs install-bridge --apply` — applique les changements du codemod
+- `mostajs install-bridge --file <path>` — restreint le codemod à un fichier
+- `mostajs install-bridge --restore --apply` — restaure les sauvegardes `*.prisma.bak`
+- `mostajs convert` — auto-détecte le schéma (Prisma / OpenAPI / JSONSchema) et le convertit
+- `mostajs detect` — affiche ce qui est détecté dans le projet
+- `mostajs health` — vérifie Node / pnpm / schémas / état de entities.json
+- `mostajs hash <password> [cost]` — hash bcrypt d'un mot de passe (données de seed)
+- `mostajs verify <password> <hash>` — vérifie une paire mot de passe / hash
+- `mostajs diagnose [email] [password]` — diagnostic de login
+- `mostajs help` / `mostajs version`
+- `mostajs` (sans argument) — menu interactif (convert, config URIs, init dialectes,
+  tests, services, métriques, logs, health, génération boilerplate, seeding, bootstrap)
+
+## TYPES CLÉS
+Sans objet — paquet purement CLI.
+
+## PATTERN
+```bash
+cd my-existing-prisma-app
+npx @mostajs/orm-cli bootstrap
+npm run dev
+# db.User.findMany(...) tourne maintenant sur l'un des 13 SGBD. Zéro changement de code.
+
+# pour annuler :
+npx @mostajs/orm-cli install-bridge --restore --apply
+```
+Le codemod réécrit chaque site `new PrismaClient(...)` en `createPrismaLikeDb()` importé
+de `@mostajs/orm-bridge/prisma-client`, sauvegarde l'original en `<fichier>.prisma.bak`,
+et préserve la forme d'export (`const db`, `const prisma`, `export default`…).
+Le bootstrap produit `.mostajs/config.env`, `.mostajs/generated/entities.json`,
+`.mostajs/seeds/*.json` et `.mostajs/logs/`.
+
+## DÉPEND DE
+- @mostajs/orm (dependency directe). À l'exécution, installe aussi dans le projet cible
+  @mostajs/orm-bridge et @mostajs/orm-adapter.
+- bcryptjs (hash/verify), better-sqlite3 (DDL SQLite par défaut)
+
+## PIÈGES
+- `install-bridge` est dry-run PAR DÉFAUT — il faut `--apply` pour écrire les fichiers.
+- Détection codemod : fichier devant contenir `import ... from '@prisma/client'` ET
+  `new PrismaClient(`. Les fichiers déjà migrés vers `@mostajs/orm-bridge/prisma-client`
+  sont ignorés (ré-exécution idempotente).
+- Conversion de schéma : passe par @mostajs/orm-adapter (Prisma / OpenAPI / JSON Schema).
+- Le bootstrap configure SQLite par défaut ; changer ensuite `DB_DIALECT` + `SGBD_URI`
+  dans `.mostajs/config.env` (ou `.env`) pour cibler un autre des 13 SGBD.
+- Paquet non importable — ne pas tenter `import ... from '@mostajs/orm-cli'`.
+
+## RÉFÉRENCES
+- README.md · CHANGELOG.md · docs/How2.md, docs/MONITORING.md · install.sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/orm-cli",
-  "version": "0.6.3",
+  "version": "0.7.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",
@@ -11,7 +11,9 @@
   "files": [
     "bin",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "llms.txt",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "mostajs",
@@ -42,8 +44,8 @@
     "win32"
   ],
   "dependencies": {
-    "@mostajs/orm": "^1.9.2",
+    "@mostajs/orm": "^2.6.0",
     "bcryptjs": "^2.4.3",
     "better-sqlite3": "^12.9.0"
   }
-}
+}