NevaDocs

Appearance

Contribuer ​

Sur cette page ​

Environnement ​

bash
git clone https://github.com/Hajrudin-Zelef/Marexcode.git
cd Marexcode
npm ci

Node ≥ 22. Pour l'interface OpenTUI : Bun ≥ 1.3.14 puis bun install.

Commandes de développement ​

bash
npm run build              # bundles esbuild vers dist/
npm run typecheck          # tsc --noEmit (Node/Ink)
npm run typecheck:opentui  # tsc --noEmit (OpenTUI)
npm test                   # suite hors ligne
npm test -- --network      # inclut les tests réseau (opt-in)
npm run test:integration   # scénarios réels (~2 min, réseau)
npm run bench              # garde-fous de performance
npm run validate           # 15 contrôles + build + tests + bench

Avant un push ​

Le hook pre-push exécute npm run validate et bloque le push en cas de régression. La suite compte 340 tests exportés (335 hors ligne) ; les tests réseau sont exclus par défaut pour rester déterministes.

bash
npm run validate   # à lancer aussi à la main avant une PR

Règles de contribution ​

  • Un test pour tout changement de comportement
  • Interfaces stables — ne cassez pas les commandes/outils existants sans discussion
  • Docs à jour — toute fonctionnalité visible mérite sa page (ou sa section) dans docs/
  • Échecs explicites — pas de repli silencieux (invariants)
  • Public-safe — jamais de clé, de chemin privé ni de nom de modèle interne dans les docs et les exemples