create-byan-agent 2.58.1 → 2.59.1

package/CHANGELOG.md

@@ -9,6 +9,90 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.59.1] - 2026-07-21
+
+### Added — app Desktop BYAN 1.0.0 : construite, empaquetee, prouvee
+- L'app Electron (`app/`, produit "BYAN") est desormais construite et empaquetee
+  reellement. Preuve sur ce depot : `BYAN-1.0.0.AppImage` (108 Mo) et
+  `byan-app_1.0.0_amd64.deb` (74,6 Mo) produits par electron-builder ; le deb
+  installe `/opt/BYAN/byan` — le chemin exact que la detection du CLI
+  (`install/lib/desktop-app.js`) sonde pour ouvrir la fenetre native.
+- Preuve d'execution du paquet (rejouable) : le serveur webui embarque, forke
+  exactement comme l'app le fait (NODE_PATH, PORT=0), repond ready + `/health`
+  200 + `/api/status` 200 avec la detection rendue par le moteur d'install.
+- Correctifs de lancement du paquet (revue adversariale : 1 block puis approve) :
+  - les ressources embarquees conservent la structure du depot
+    (`install/src/webui` + `install/lib` + `src/byan-v2/lib`) pour que les
+    require() relatifs resolvent a l'identique ;
+  - dependances du serveur declarees dans l'app et depaquetees en fichiers
+    reels (le fils forke n'a pas acces a l'archive asar) ;
+  - `.npmrc install-links=true` : la dependance locale byan-platform-config est
+    copiee, pas liee (electron-builder refuse un lien sortant de `app/`) ;
+  - `executableName: byan` cote Linux ; icone Windows regeneree en 256px ;
+    icone macOS convertie depuis le png au build (l'icns n'existe pas en depot).
+- Release 3 OS : la chaine GitHub Actions existante construit
+  ubuntu/windows/macos et attache les artefacts a une release brouillon sur tag
+  `desktop-v*` (tag dedie — les tags `v*` portent les versions npm et ne
+  declenchent plus de release Desktop). Mode d'emploi dans `app/README.md`.
+
+### Fixed — serveur webui : le contrat PORT=0 est honore
+- `install/src/webui/server.js` (expedie par npm) : `options.port ?? 3000` (0
+  est une valeur valide : le systeme assigne un port libre) et l'entree fork
+  lit desormais `PORT` et `BYAN_PROJECT_ROOT` d'environnement. L'usage CLI
+  (port explicite en argument) est inchange.
+
+## [2.59.0] - 2026-07-21
+
+### Fixed — assistant web : detection Claude/Codex reparee, interface en francais
+- **Detection reparee.** L'ecran Detection affichait "not detected" pour Claude
+  Code et Codex sur une machine ou les deux sont installes (constat terrain,
+  Arch Linux). Cause : la route de statut interrogeait un detecteur qui cherchait
+  le fichier de config de Claude DESKTOP (l'app de chat,
+  `~/.config/Claude/claude_desktop_config.json`) et un dossier `.codex/prompts`
+  relatif au projet. La detection plateforme passe desormais par le moteur
+  d'installation (`detectEnvironment`) : `~/.claude` ou binaire `claude`,
+  `~/.codex` ou binaire `codex` — les faits machine, pas les artefacts d'une
+  autre application.
+- **Interface en francais.** Les 7 etapes du wizard (accueil, detection, mode,
+  configuration, recapitulatif, installation, termine), la mise a jour et le
+  journal parlent francais (`lang="fr"`).
+
+### Changed — mode AUTO conforme au contrat
+- Le mode AUTO ne baptise plus l'utilisateur "User" en anglais : il affiche une
+  configuration minimale qui demande **comment tu veux etre appele** (plus nom
+  et repertoire du projet, pre-remplis), puis va au recapitulatif.
+- Defauts corriges : langue **Francais**, **tous les agents** (les 5 modules
+  core/bmm/bmb/tea/cis), plateformes = celles detectees sur la machine. Le
+  recapitulatif affiche "Agents : tous (roster complet)".
+- Tests : `install/__tests__/webui-detection.test.js` (7 cas — cablage moteur de
+  la detection + garde-fous sur les defauts du front).
+
+### Docs — decision Electron vs Tauri
+- Decision gravee dans `app/README.md` : Electron est conserve pour l'app
+  Desktop. Raison dominante : le serveur local est en Node ; Electron l'embarque
+  gratuitement, Tauri exigerait un Node annexe (qui annule son avantage de
+  taille) ou une reecriture du serveur. La coquille Electron existe deja
+  (main/preload/renderer, tests bout-en-bout, config de construction
+  Linux/Windows). A reevaluer seulement si le serveur quitte Node.
+
+## [2.58.2] - 2026-07-21
+
+### Fixed — l'assistant web plantait a l'ouverture (Cannot find module 'ws')
+- Symptome : `create-byan-agent` (assistant web par defaut) plantait aussitot
+  avec `Error: Cannot find module 'ws'` depuis `install/src/webui/server.js`,
+  sur une installation globale `npm i -g`.
+- Cause : `ws` (le serveur WebSocket de l'assistant) etait declare uniquement
+  dans `install/package.json` (interne, non publie). `npm` installe les
+  dependances du `package.json` RACINE ; `ws` en etait absent, donc introuvable
+  une fois le paquet installe.
+- Correctif : `ws` (`^8.20.0`) ajoute aux dependances racine, la ou npm
+  l'installe reellement.
+- Filet anti-regression : nouveau test `install/__tests__/shipped-deps.test.js`
+  qui scanne le code expedie (`install/bin`, `install/lib`, `install/src`) et
+  exige que chaque module externe require() soit declare dans les dependances
+  racine (ou soit un module natif Node). La derive "declare dans
+  install/package.json mais pas racine" echoue desormais au test.
+
 ## [2.58.1] - 2026-07-21
 
 ### Fixed — l'install auto en terminal gelait au controle des copies globales de skills

package/install/src/webui/api.js

@@ -123,14 +123,35 @@ const routes = {
     if (detector) {
       try {
         detectionResult = await detector.detect();
-        platforms = detectionResult.platforms
-          .filter(p => p.detected)
-          .map(p => p.name);
       } catch {
-        // Fallback to fs-based detection
+        detectionResult = null;
       }
     }
 
+    // Platform detection (Claude Code / Codex) comes from the INSTALL ENGINE —
+    // the single source of truth. The yanstaller detector looked for Claude
+    // DESKTOP's config file (~/.config/Claude/claude_desktop_config.json) and
+    // for a project-local .codex/prompts dir, so a machine with the Claude Code
+    // CLI and Codex properly installed showed "not detected" (field bug,
+    // 2026-07-21, Arch Linux). The engine checks the real machine-level facts:
+    // ~/.claude or `command -v claude`, ~/.codex or `command -v codex`.
+    try {
+      const engineDetect = (server.installEngine || require('../../lib/install-engine')).detectEnvironment();
+      platforms = [
+        ...(engineDetect.claude ? ['claude'] : []),
+        ...(engineDetect.codex ? ['codex'] : []),
+      ];
+      const enginePlatforms = [
+        { name: 'claude', detected: engineDetect.claude },
+        { name: 'codex', detected: engineDetect.codex },
+      ];
+      detectionResult = detectionResult
+        ? { ...detectionResult, platforms: enginePlatforms }
+        : { platforms: enginePlatforms };
+    } catch {
+      // engine unavailable -> keep the project-local fs fallback computed above
+    }
+
     json(res, 200, {
       version,
       installed,

package/install/src/webui/public/app.js

@@ -4,12 +4,14 @@ class ByanApp {
     this.stepHistory = [];
     this.ws = null;
     this.wsRetryDelay = 1000;
+    // Defauts valides : francais, tous les modules (l'installation AUTO pose
+    // tous les agents), plateformes remplies par la detection machine.
     this.config = {
       mode: 'auto',
       userName: '',
-      language: 'English',
+      language: 'Francais',
       platforms: [],
-      modules: ['core', 'bmm']
+      modules: ['core', 'bmm', 'bmb', 'tea', 'cis']
     };
     this.status = null;
     this.logCount = 0;
@@ -122,30 +124,30 @@ class ByanApp {
 
       let html = '';
 
-      html += this.detectionRow(true, 'Node.js', this.status.detection?.nodeVersion || process.version || 'detected');
+      html += this.detectionRow(true, 'Node.js', this.status.detection?.nodeVersion || 'detecte');
       html += this.detectionRow(
         this.status.detection?.hasGit !== false,
         'Git',
-        this.status.detection?.gitVersion || (this.status.detection?.hasGit !== false ? 'detected' : 'not found')
+        this.status.detection?.gitVersion || (this.status.detection?.hasGit !== false ? 'detecte' : 'introuvable')
       );
-      html += this.detectionRow(true, 'Operating System', this.status.detection?.os || navigator.platform);
+      html += this.detectionRow(true, 'Systeme d\'exploitation', this.status.detection?.os || navigator.platform);
 
       const platformNames = { 'claude': 'Claude Code', 'codex': 'Codex' };
       const detectedPlatforms = this.status.detection?.platforms || [];
       if (detectedPlatforms.length > 0) {
         for (const p of detectedPlatforms) {
-          html += this.detectionRow(p.detected, platformNames[p.name] || p.name, p.detected ? 'found' : 'not detected');
+          html += this.detectionRow(p.detected, platformNames[p.name] || p.name, p.detected ? 'detecte' : 'non detecte');
         }
       } else {
         for (const name of this.status.platforms || []) {
-          html += this.detectionRow(true, platformNames[name] || name, 'found');
+          html += this.detectionRow(true, platformNames[name] || name, 'detecte');
         }
       }
 
       html += this.detectionRow(
         this.status.installed,
-        'Existing BYAN installation',
-        this.status.installed ? 'found (will upgrade)' : 'clean install'
+        'Installation BYAN existante',
+        this.status.installed ? 'trouvee (sera mise a jour)' : 'installation neuve'
       );
 
       container.innerHTML = html;
@@ -153,7 +155,7 @@ class ByanApp {
 
       this.config.platforms = this.status.platforms || [];
     } catch (err) {
-      container.innerHTML = `<div class="detection-item"><div class="detection-status fail"></div><div class="detection-label">Detection failed</div><div class="detection-value">${this.escapeHtml(err.message)}</div></div>`;
+      container.innerHTML = `<div class="detection-item"><div class="detection-status fail"></div><div class="detection-label">Echec de la detection</div><div class="detection-value">${this.escapeHtml(err.message)}</div></div>`;
       nextBtn.disabled = false;
     }
   }
@@ -169,25 +171,25 @@ class ByanApp {
     document.querySelectorAll('.mode-cards .card').forEach(card => card.classList.remove('selected'));
     event.currentTarget.classList.add('selected');
 
+    // Le mode AUTO installe TOUS les agents (les 5 modules) sur les plateformes
+    // detectees, en francais — mais il demande quand meme le prenom : on ne
+    // baptise personne "User" d'office.
     if (mode === 'auto') {
-      this.config.userName = this.status?.detection?.userName || 'User';
-      this.config.language = 'English';
       this.config.modules = ['core', 'bmm', 'bmb', 'tea', 'cis'];
-      this.showPreview();
-    } else {
-      this.showConfigForm(mode);
-      this.showStep('config');
+      this.config.language = this.config.language || 'Francais';
     }
+    this.showConfigForm(mode);
+    this.showStep('config');
   }
 
   showConfigForm(mode) {
     const form = document.getElementById('config-form');
     const allModules = [
-      { id: 'core', label: 'Core (foundation)', required: true },
-      { id: 'bmm', label: 'BMM (software development)', required: false },
-      { id: 'bmb', label: 'BMB (agent builder)', required: false },
-      { id: 'tea', label: 'TEA (test architecture)', required: false },
-      { id: 'cis', label: 'CIS (creative innovation)', required: false }
+      { id: 'core', label: 'Core (fondation)', required: true },
+      { id: 'bmm', label: 'BMM (developpement logiciel)', required: false },
+      { id: 'bmb', label: 'BMB (createur d\'agents)', required: false },
+      { id: 'tea', label: 'TEA (architecture de tests)', required: false },
+      { id: 'cis', label: 'CIS (innovation creative)', required: false }
     ];
 
     const platformOptions = [
@@ -197,42 +199,54 @@ class ByanApp {
 
     let html = `
       <div class="form-group">
-        <label for="cfg-name">Your Name</label>
+        <label for="cfg-name">Comment veux-tu etre appele ?</label>
         <input id="cfg-name" type="text" value="${this.escapeHtml(this.config.userName)}" placeholder="Yan">
       </div>
       <div class="form-group">
-        <label for="cfg-project-name">Project Name</label>
+        <label for="cfg-project-name">Nom du projet</label>
         <input id="cfg-project-name" type="text" value="${this.escapeHtml(this.config.projectName || '')}" placeholder="mon-projet">
       </div>
       <div class="form-group">
-        <label for="cfg-project-dir">Project Directory</label>
+        <label for="cfg-project-dir">Repertoire du projet</label>
         <input id="cfg-project-dir" type="text" value="${this.escapeHtml(this.config.projectDir || this.status?.projectRoot || '')}" placeholder="/chemin/vers/le/projet">
-        <div class="form-hint">Defaults to the directory the wizard was launched from.</div>
+        <div class="form-hint">Par defaut : le repertoire depuis lequel l'assistant a ete lance.</div>
       </div>
       <div class="form-group">
-        <label for="cfg-lang">Communication Language</label>
+        <label for="cfg-lang">Langue de communication</label>
         <select id="cfg-lang">
-          <option value="English" ${this.config.language === 'English' ? 'selected' : ''}>English</option>
           <option value="Francais" ${this.config.language === 'Francais' ? 'selected' : ''}>Francais</option>
+          <option value="English" ${this.config.language === 'English' ? 'selected' : ''}>English</option>
         </select>
-      </div>
+      </div>`;
+
+    // En AUTO, plateformes et modules sont regles par la detection et le
+    // roster complet — pas de cases a cocher, juste l'essentiel.
+    if (mode === 'auto') {
+      const detected = (this.config.platforms || []).map(p => p === 'claude' ? 'Claude Code' : 'Codex').join(' + ') || 'aucune detectee';
+      html += `
       <div class="form-group">
-        <label>Target Platforms</label>
-        <div class="form-hint">Select the platforms you use.</div>
+        <div class="form-hint">Plateformes detectees : ${this.escapeHtml(detected)} &mdash; tous les agents seront installes.</div>
+      </div>`;
+    } else {
+      html += `
+      <div class="form-group">
+        <label>Plateformes cibles</label>
+        <div class="form-hint">Choisis les plateformes que tu utilises.</div>
         <div class="checkbox-group">`;
 
-    for (const p of platformOptions) {
-      const checked = this.config.platforms.includes(p.id) ? 'checked' : '';
-      html += `<label><input type="checkbox" name="platform" value="${p.id}" ${checked}> ${this.escapeHtml(p.label)}</label>`;
-    }
+      for (const p of platformOptions) {
+        const checked = this.config.platforms.includes(p.id) ? 'checked' : '';
+        html += `<label><input type="checkbox" name="platform" value="${p.id}" ${checked}> ${this.escapeHtml(p.label)}</label>`;
+      }
 
-    html += `</div></div>`;
+      html += `</div></div>`;
+    }
 
     if (mode === 'manual') {
       html += `
         <div class="form-group">
           <label>Modules</label>
-          <div class="form-hint">Core is always included.</div>
+          <div class="form-hint">Core est toujours inclus.</div>
           <div class="checkbox-group">`;
       for (const m of allModules) {
         const checked = m.required || this.config.modules.includes(m.id) ? 'checked' : '';
@@ -251,7 +265,7 @@ class ByanApp {
     const projNameEl = document.getElementById('cfg-project-name');
     const projDirEl = document.getElementById('cfg-project-dir');
 
-    if (nameEl) this.config.userName = nameEl.value.trim() || 'User';
+    if (nameEl) this.config.userName = nameEl.value.trim() || 'Developpeur';
     if (langEl) this.config.language = langEl.value;
     if (projNameEl) this.config.projectName = projNameEl.value.trim();
     if (projDirEl) this.config.projectDir = projDirEl.value.trim();
@@ -271,14 +285,16 @@ class ByanApp {
     this.readConfigForm();
 
     const container = document.getElementById('preview-content');
+    const allModules = this.config.modules.length >= 5;
     const rows = [
       ['Mode', this.config.mode.toUpperCase()],
-      ['User Name', this.config.userName || 'User'],
-      ['Language', this.config.language],
-      ['Platforms', this.config.platforms.join(', ') || 'auto-detect'],
+      ['Prenom', this.config.userName || 'Developpeur'],
+      ['Langue', this.config.language],
+      ['Plateformes', this.config.platforms.join(', ') || 'detection automatique'],
+      ['Agents', allModules ? 'tous (roster complet)' : `modules ${this.config.modules.join(', ')}`],
       ['Modules', this.config.modules.join(', ')],
-      ['Project Name', this.config.projectName || '(nom du dossier)'],
-      ['Project Root', this.config.projectDir || this.status?.projectRoot || '(auto)']
+      ['Nom du projet', this.config.projectName || '(nom du dossier)'],
+      ['Repertoire', this.config.projectDir || this.status?.projectRoot || '(auto)']
     ];
 
     container.innerHTML = rows.map(([k, v]) =>
@@ -290,7 +306,7 @@ class ByanApp {
 
   async confirmInstall() {
     this.showStep('progress');
-    document.getElementById('progress-title').textContent = 'Installing...';
+    document.getElementById('progress-title').textContent = 'Installation en cours...';
     this.resetProgress();
 
     try {
@@ -301,7 +317,7 @@ class ByanApp {
       });
 
       if (!res.ok) {
-        const err = await res.json().catch(() => ({ error: 'Unknown error' }));
+        const err = await res.json().catch(() => ({ error: 'Erreur inconnue' }));
         this.showComplete({ success: false, summary: { message: err.error } });
       }
     } catch (err) {
@@ -326,7 +342,7 @@ class ByanApp {
         container.innerHTML = `
           <div class="detection-item">
             <div class="detection-status ok"></div>
-            <div class="detection-label">Update available</div>
+            <div class="detection-label">Mise a jour disponible</div>
             <div class="detection-value">${this.escapeHtml(data.installed)} &#8594; ${this.escapeHtml(data.latest)}</div>
           </div>
           ${data.changes.length > 0 ? '<div class="code-block">' + data.changes.map(c => this.escapeHtml(c)).join('\n') + '</div>' : ''}`;
@@ -335,23 +351,23 @@ class ByanApp {
         container.innerHTML = `
           <div class="detection-item">
             <div class="detection-status ok"></div>
-            <div class="detection-label">Up to date</div>
+            <div class="detection-label">A jour</div>
             <div class="detection-value">v${this.escapeHtml(data.installed)}</div>
           </div>
-          <p style="color:var(--text-muted);margin-top:1rem;">Your installation is already on the latest version.</p>`;
+          <p style="color:var(--text-muted);margin-top:1rem;">Ton installation est deja sur la derniere version.</p>`;
         confirmBtn.disabled = true;
       }
 
       actionsEl.style.display = 'flex';
     } catch (err) {
-      container.innerHTML = `<div class="detection-item"><div class="detection-status fail"></div><div class="detection-label">Check failed</div><div class="detection-value">${this.escapeHtml(err.message)}</div></div>`;
+      container.innerHTML = `<div class="detection-item"><div class="detection-status fail"></div><div class="detection-label">Echec de la verification</div><div class="detection-value">${this.escapeHtml(err.message)}</div></div>`;
       actionsEl.style.display = 'flex';
     }
   }
 
   async confirmUpdate() {
     this.showStep('progress');
-    document.getElementById('progress-title').textContent = 'Updating...';
+    document.getElementById('progress-title').textContent = 'Mise a jour en cours...';
     this.resetProgress();
 
     try {
@@ -362,7 +378,7 @@ class ByanApp {
       });
 
       if (!res.ok) {
-        const err = await res.json().catch(() => ({ error: 'Unknown error' }));
+        const err = await res.json().catch(() => ({ error: 'Erreur inconnue' }));
         this.showComplete({ success: false, summary: { message: err.error } });
       }
     } catch (err) {
@@ -414,7 +430,7 @@ class ByanApp {
 
   resetProgress() {
     document.getElementById('progress-fill').style.width = '0%';
-    document.getElementById('progress-label').textContent = 'Preparing...';
+    document.getElementById('progress-label').textContent = 'Preparation...';
     document.getElementById('progress-pct').textContent = '0%';
   }
 
@@ -426,22 +442,22 @@ class ByanApp {
     if (data.success) {
       icon.innerHTML = '&#10003;';
       icon.classList.remove('error');
-      title.textContent = 'Installation Complete';
+      title.textContent = 'Installation terminee';
 
       const s = data.summary || {};
-      let html = `<p>${this.escapeHtml(s.message || 'Done')}</p>`;
-      if (s.projectRoot) html += `<p><strong>Project:</strong> <code>${this.escapeHtml(s.projectRoot)}</code></p>`;
-      if (s.mode) html += `<p><strong>Mode:</strong> ${this.escapeHtml(s.mode)}</p>`;
-      if (s.platforms && s.platforms.length) html += `<p><strong>Platforms:</strong> ${s.platforms.map(p => this.escapeHtml(p)).join(', ')}</p>`;
-      html += '<p style="margin-top:1rem;color:var(--text-muted);">You can close this window.</p>';
+      let html = `<p>${this.escapeHtml(s.message || 'Termine')}</p>`;
+      if (s.projectRoot) html += `<p><strong>Projet :</strong> <code>${this.escapeHtml(s.projectRoot)}</code></p>`;
+      if (s.mode) html += `<p><strong>Mode :</strong> ${this.escapeHtml(s.mode)}</p>`;
+      if (s.platforms && s.platforms.length) html += `<p><strong>Plateformes :</strong> ${s.platforms.map(p => this.escapeHtml(p)).join(', ')}</p>`;
+      html += '<p style="margin-top:1rem;color:var(--text-muted);">Tu peux fermer cette fenetre.</p>';
       summary.innerHTML = html;
     } else {
       icon.innerHTML = '&#10007;';
       icon.classList.add('error');
-      title.textContent = 'Installation Failed';
+      title.textContent = 'Echec de l\'installation';
 
-      const msg = data.summary?.message || 'Unknown error';
-      summary.innerHTML = `<p style="color:var(--error)">${this.escapeHtml(msg)}</p><p style="margin-top:1rem;color:var(--text-muted);">Check the logs below for details. You can try again.</p>`;
+      const msg = data.summary?.message || 'Erreur inconnue';
+      summary.innerHTML = `<p style="color:var(--error)">${this.escapeHtml(msg)}</p><p style="margin-top:1rem;color:var(--text-muted);">Consulte le journal ci-dessous pour le detail. Tu peux reessayer.</p>`;
     }
 
     this.showStep('done');

package/install/src/webui/public/index.html

@@ -1,176 +1,176 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="fr">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>BYAN - Agent Installer</title>
+  <title>BYAN - Assistant d'installation</title>
   <link rel="stylesheet" href="style.css">
 </head>
 <body>
   <header>
     <div class="header-inner">
       <h1 class="logo">BYAN</h1>
-      <p class="subtitle">Builder of YAN &mdash; Agent Installer</p>
+      <p class="subtitle">Builder of YAN &mdash; Assistant d'installation</p>
     </div>
   </header>
 
-  <nav class="wizard-steps" id="wizard-nav" aria-label="Installation steps">
+  <nav class="wizard-steps" id="wizard-nav" aria-label="Etapes d'installation">
     <ol>
-      <li class="wizard-step active" data-step="welcome"><span class="step-num">1</span><span class="step-label">Welcome</span></li>
+      <li class="wizard-step active" data-step="welcome"><span class="step-num">1</span><span class="step-label">Accueil</span></li>
       <li class="wizard-step" data-step="detection"><span class="step-num">2</span><span class="step-label">Detection</span></li>
       <li class="wizard-step" data-step="mode"><span class="step-num">3</span><span class="step-label">Mode</span></li>
-      <li class="wizard-step" data-step="config"><span class="step-num">4</span><span class="step-label">Config</span></li>
-      <li class="wizard-step" data-step="preview"><span class="step-num">5</span><span class="step-label">Preview</span></li>
-      <li class="wizard-step" data-step="progress"><span class="step-num">6</span><span class="step-label">Install</span></li>
-      <li class="wizard-step" data-step="done"><span class="step-num">7</span><span class="step-label">Done</span></li>
+      <li class="wizard-step" data-step="config"><span class="step-num">4</span><span class="step-label">Configuration</span></li>
+      <li class="wizard-step" data-step="preview"><span class="step-num">5</span><span class="step-label">Recapitulatif</span></li>
+      <li class="wizard-step" data-step="progress"><span class="step-num">6</span><span class="step-label">Installation</span></li>
+      <li class="wizard-step" data-step="done"><span class="step-num">7</span><span class="step-label">Termine</span></li>
     </ol>
   </nav>
 
   <main>
-    <!-- Step 1: Welcome -->
-    <section class="step" id="step-welcome" role="region" aria-label="Welcome">
+    <!-- Etape 1 : Accueil -->
+    <section class="step" id="step-welcome" role="region" aria-label="Accueil">
       <div class="step-content">
-        <h2>Welcome to BYAN</h2>
-        <p class="lead">Intelligent AI agent platform with multi-platform support.<br>
-          Claude Code and Codex.</p>
+        <h2>Bienvenue dans BYAN</h2>
+        <p class="lead">Plateforme d'agents IA intelligente, multi-plateforme.<br>
+          Claude Code et Codex.</p>
         <div class="feature-grid">
           <div class="feature-card">
             <div class="feature-icon" aria-hidden="true">&#9670;</div>
-            <h3>64 Quality Mantras</h3>
-            <p>Built on Merise Agile + TDD methodology with rigorous quality standards.</p>
+            <h3>71 mantras qualite</h3>
+            <p>Construit sur la methodologie Merise Agile + TDD avec des standards de qualite exigeants.</p>
           </div>
           <div class="feature-card">
             <div class="feature-icon" aria-hidden="true">&#9672;</div>
-            <h3>Multi-Platform</h3>
-            <p>Install agents across Claude Code and Codex simultaneously.</p>
+            <h3>Multi-plateforme</h3>
+            <p>Installe les agents sur Claude Code et Codex en meme temps.</p>
           </div>
           <div class="feature-card">
             <div class="feature-icon" aria-hidden="true">&#9656;</div>
-            <h3>Smart Detection</h3>
-            <p>Automatically detects your environment and recommends optimal configuration.</p>
+            <h3>Detection intelligente</h3>
+            <p>Detecte automatiquement ton environnement et propose la configuration adaptee.</p>
           </div>
         </div>
         <div class="actions">
-          <button class="btn btn-primary" onclick="app.startInstall()" aria-label="Start new installation">Install BYAN</button>
-          <button class="btn btn-secondary" onclick="app.startUpdate()" aria-label="Update existing installation">Update Existing</button>
+          <button class="btn btn-primary" onclick="app.startInstall()" aria-label="Demarrer une nouvelle installation">Installer BYAN</button>
+          <button class="btn btn-secondary" onclick="app.startUpdate()" aria-label="Mettre a jour une installation existante">Mettre a jour</button>
         </div>
       </div>
     </section>
 
-    <!-- Step 2: Detection -->
-    <section class="step hidden" id="step-detection" role="region" aria-label="Environment detection">
+    <!-- Etape 2 : Detection -->
+    <section class="step hidden" id="step-detection" role="region" aria-label="Detection de l'environnement">
       <div class="step-content">
-        <h2>Environment Detection</h2>
-        <p class="lead">Scanning your system for installed platforms and tools.</p>
+        <h2>Detection de l'environnement</h2>
+        <p class="lead">Analyse de ta machine : plateformes et outils installes.</p>
         <div id="detection-results" class="detection-grid" aria-live="polite">
-          <div class="spinner-container"><div class="spinner"></div><p>Detecting...</p></div>
+          <div class="spinner-container"><div class="spinner"></div><p>Detection en cours...</p></div>
         </div>
         <div class="actions">
-          <button class="btn btn-secondary" onclick="app.goBack()">Back</button>
-          <button class="btn btn-primary" onclick="app.showStep('mode')" id="btn-detection-next" disabled>Continue</button>
+          <button class="btn btn-secondary" onclick="app.goBack()">Retour</button>
+          <button class="btn btn-primary" onclick="app.showStep('mode')" id="btn-detection-next" disabled>Continuer</button>
         </div>
       </div>
     </section>
 
-    <!-- Step 3: Mode Selection -->
-    <section class="step hidden" id="step-mode" role="region" aria-label="Installation mode">
+    <!-- Etape 3 : Choix du mode -->
+    <section class="step hidden" id="step-mode" role="region" aria-label="Mode d'installation">
       <div class="step-content">
-        <h2>Installation Mode</h2>
-        <p class="lead">Choose how you want to install BYAN.</p>
+        <h2>Mode d'installation</h2>
+        <p class="lead">Choisis comment installer BYAN.</p>
         <div class="mode-cards">
-          <button class="card" onclick="app.selectMode('auto')" aria-label="Auto mode: quick install with smart defaults">
-            <div class="card-badge">Recommended</div>
+          <button class="card" onclick="app.selectMode('auto')" aria-label="Mode auto : installation rapide, tous les agents">
+            <div class="card-badge">Recommande</div>
             <h3>AUTO</h3>
-            <p>Quick install with smart defaults based on detected environment.</p>
+            <p>Installation rapide : tous les agents, Claude + Codex detectes, defauts intelligents. On te demande juste ton prenom.</p>
           </button>
-          <button class="card" onclick="app.selectMode('custom')" aria-label="Custom mode: guided interview">
-            <h3>CUSTOM</h3>
-            <p>Guided interview with recommendations for each option.</p>
+          <button class="card" onclick="app.selectMode('custom')" aria-label="Mode personnalise : entretien guide">
+            <h3>PERSONNALISE</h3>
+            <p>Entretien guide avec des recommandations pour chaque option.</p>
           </button>
-          <button class="card" onclick="app.selectMode('manual')" aria-label="Manual mode: choose agents individually">
-            <h3>MANUAL</h3>
-            <p>Full control. Choose every agent and platform individually.</p>
+          <button class="card" onclick="app.selectMode('manual')" aria-label="Mode manuel : choisir chaque agent individuellement">
+            <h3>MANUEL</h3>
+            <p>Controle total. Choisis chaque agent et chaque plateforme.</p>
           </button>
         </div>
         <div class="actions">
-          <button class="btn btn-secondary" onclick="app.goBack()">Back</button>
+          <button class="btn btn-secondary" onclick="app.goBack()">Retour</button>
         </div>
       </div>
     </section>
 
-    <!-- Step 4: Configuration -->
+    <!-- Etape 4 : Configuration -->
     <section class="step hidden" id="step-config" role="region" aria-label="Configuration">
       <div class="step-content">
         <h2>Configuration</h2>
         <div id="config-form" class="config-form"></div>
         <div class="actions">
-          <button class="btn btn-secondary" onclick="app.goBack()">Back</button>
-          <button class="btn btn-primary" onclick="app.showPreview()">Preview</button>
+          <button class="btn btn-secondary" onclick="app.goBack()">Retour</button>
+          <button class="btn btn-primary" onclick="app.showPreview()">Recapitulatif</button>
         </div>
       </div>
     </section>
 
-    <!-- Step 5: Preview -->
-    <section class="step hidden" id="step-preview" role="region" aria-label="Installation preview">
+    <!-- Etape 5 : Recapitulatif -->
+    <section class="step hidden" id="step-preview" role="region" aria-label="Recapitulatif de l'installation">
       <div class="step-content">
-        <h2>Installation Preview</h2>
-        <p class="lead">Review your configuration before installing.</p>
+        <h2>Recapitulatif</h2>
+        <p class="lead">Verifie ta configuration avant d'installer.</p>
         <div id="preview-content" class="preview-block"></div>
         <div class="actions">
-          <button class="btn btn-secondary" onclick="app.goBack()">Back</button>
-          <button class="btn btn-primary" onclick="app.confirmInstall()">Confirm &amp; Install</button>
+          <button class="btn btn-secondary" onclick="app.goBack()">Retour</button>
+          <button class="btn btn-primary" onclick="app.confirmInstall()">Confirmer et installer</button>
         </div>
       </div>
     </section>
 
-    <!-- Step 6: Progress -->
-    <section class="step hidden" id="step-progress" role="region" aria-label="Installation progress">
+    <!-- Etape 6 : Progression -->
+    <section class="step hidden" id="step-progress" role="region" aria-label="Progression de l'installation">
       <div class="step-content">
-        <h2 id="progress-title">Installing...</h2>
+        <h2 id="progress-title">Installation en cours...</h2>
         <div class="progress-container">
           <div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
             <div class="progress-fill" id="progress-fill"></div>
           </div>
-          <p class="progress-label" id="progress-label">Preparing...</p>
+          <p class="progress-label" id="progress-label">Preparation...</p>
           <p class="progress-pct" id="progress-pct">0%</p>
         </div>
       </div>
     </section>
 
-    <!-- Step 7: Done -->
-    <section class="step hidden" id="step-done" role="region" aria-label="Installation complete">
+    <!-- Etape 7 : Termine -->
+    <section class="step hidden" id="step-done" role="region" aria-label="Installation terminee">
       <div class="step-content">
         <div id="done-icon" class="done-icon" aria-hidden="true">&#10003;</div>
-        <h2 id="done-title">Installation Complete</h2>
+        <h2 id="done-title">Installation terminee</h2>
         <div id="done-summary" class="done-summary"></div>
         <div class="actions">
-          <button class="btn btn-primary" onclick="window.location.reload()">Start Over</button>
+          <button class="btn btn-primary" onclick="window.location.reload()">Recommencer</button>
         </div>
       </div>
     </section>
 
-    <!-- Update: Check -->
-    <section class="step hidden" id="step-update-check" role="region" aria-label="Update check">
+    <!-- Mise a jour : verification -->
+    <section class="step hidden" id="step-update-check" role="region" aria-label="Verification des mises a jour">
       <div class="step-content">
-        <h2>Checking for Updates</h2>
+        <h2>Verification des mises a jour</h2>
         <div id="update-info" aria-live="polite">
-          <div class="spinner-container"><div class="spinner"></div><p>Checking...</p></div>
+          <div class="spinner-container"><div class="spinner"></div><p>Verification...</p></div>
         </div>
         <div class="actions" id="update-check-actions" style="display:none">
-          <button class="btn btn-secondary" onclick="app.showStep('welcome')">Back</button>
-          <button class="btn btn-primary" onclick="app.confirmUpdate()" id="btn-update-confirm" disabled>Update Now</button>
+          <button class="btn btn-secondary" onclick="app.showStep('welcome')">Retour</button>
+          <button class="btn btn-primary" onclick="app.confirmUpdate()" id="btn-update-confirm" disabled>Mettre a jour</button>
         </div>
       </div>
     </section>
 
-    <!-- Update: Diff -->
-    <section class="step hidden" id="step-update-diff" role="region" aria-label="Changes preview">
+    <!-- Mise a jour : apercu des changements -->
+    <section class="step hidden" id="step-update-diff" role="region" aria-label="Apercu des changements">
       <div class="step-content">
-        <h2>Changes Preview</h2>
+        <h2>Apercu des changements</h2>
         <div id="update-diff" class="code-block"></div>
         <div class="actions">
-          <button class="btn btn-secondary" onclick="app.showStep('update-check')">Cancel</button>
-          <button class="btn btn-primary" onclick="app.confirmUpdate()">Update Now</button>
+          <button class="btn btn-secondary" onclick="app.showStep('update-check')">Annuler</button>
+          <button class="btn btn-primary" onclick="app.confirmUpdate()">Mettre a jour</button>
         </div>
       </div>
     </section>
@@ -179,7 +179,7 @@
   <footer>
     <div id="log-panel" class="log-panel">
       <button class="log-header" onclick="app.toggleLogs()" aria-expanded="false" aria-controls="log-content">
-        <span>Logs</span>
+        <span>Journal</span>
         <span class="log-badge hidden" id="log-badge">0</span>
         <span class="log-chevron" id="log-chevron" aria-hidden="true">&#9650;</span>
       </button>

package/install/src/webui/server.js

@@ -25,7 +25,10 @@ const MIME_TYPES = {
 
 class ByanWebUI {
   constructor(options = {}) {
-    this.port = options.port || 3000;
+    // ?? and not || : port 0 is a VALID value (the OS assigns a free port and
+    // the fork parent reads it back from the ready message). `0 || 3000` would
+    // silently force 3000 and crash on EADDRINUSE when 3000 is busy.
+    this.port = options.port ?? 3000;
     this.projectRoot = options.projectRoot || process.cwd();
     this.publicDir = path.join(__dirname, 'public');
     this.server = null;
@@ -330,8 +333,13 @@ class ByanWebUI {
 }
 
 if (require.main === module) {
-  const port = parseInt(process.argv[2], 10) || 3000;
-  const projectRoot = process.argv[3] || path.resolve(__dirname, '..', '..', '..');
+  // Port order: argv[2] (explicit CLI), then env PORT (the Electron fork
+  // passes PORT=0 for an OS-assigned port), then 3000. Number.isFinite and
+  // not || : 0 is a valid requested port here.
+  const argPort = parseInt(process.argv[2], 10);
+  const envPort = parseInt(process.env.PORT ?? '', 10);
+  const port = Number.isFinite(argPort) ? argPort : (Number.isFinite(envPort) ? envPort : 3000);
+  const projectRoot = process.argv[3] || process.env.BYAN_PROJECT_ROOT || path.resolve(__dirname, '..', '..', '..');
   const ui = new ByanWebUI({ port, projectRoot });
   ui.start().then(() => {
     console.log(`Project root: ${ui.projectRoot}`);

package/install/templates/_byan/mcp/byan-mcp-server/lib/native-tiers.js

@@ -93,7 +93,10 @@ export const DEEP_PREFIX = 'deep-';
 const VERIFICATION_KEYWORDS = ['verify', 'validate', 'check', 'assert', 'gate', 'lint', 'audit', 'review'];
 const ANALYSIS_KEYWORDS = ['analy', 'design', 'architect', 'assess', 'evaluate', 'strategy', 'risk', 'nfr', 'recommend', 'judge', 'score', 'coverage', 'synthes'];
 const IMPLEMENTATION_KEYWORDS = ['implement', 'build', 'write', 'generate', 'create', 'dev', 'rgr', 'refactor', 'fix', 'scaffold', 'save', 'optimize', 'aggregate', 'report', 'present', 'plan', 'map', 'select', 'subprocess', 'sub-'];
-const EXPLORATION_KEYWORDS = ['load', 'read', 'scan', 'list', 'parse', 'detect', 'discover', 'fetch', 'lookup', 'source-tree', 'mode-detection'];
+// cartograph/inventaire/recensement... : vocabulaire de cartographie de
+// l'existant (lecture + synthese), francais inclus — cas terrain byan_web ou
+// des feuilles de scan DISCOVERY non reconnues heritaient d'une session Fable 5.
+const EXPLORATION_KEYWORDS = ['load', 'read', 'scan', 'list', 'parse', 'detect', 'discover', 'fetch', 'lookup', 'source-tree', 'mode-detection', 'cartograph', 'inventaire', 'inventory', 'recensement', 'census', 'enumerate', 'survey', 'crawl'];
 
 function matchesAny(text, keywords) {
   return keywords.some((kw) => text.includes(kw));
@@ -115,6 +118,10 @@ export function classifyLeaf(leaf) {
   // (the analysis escape hatch, classified as the deep IMPLEMENTATION bucket).
   if (label.startsWith(MECHANICAL_PREFIX)) return LEAF_TYPES.MECHANICAL;
   if (label.startsWith(DEEP_PREFIX)) return LEAF_TYPES.IMPLEMENTATION;
+  // 'map:' (deux-points) = convention de cartographie de l'existant (scan) ->
+  // exploration, AVANT le mot-cle 'map' d'implementation qui sinon l'avale.
+  // 'map-' (tiret, ex. map-criteria) reste une transformation profonde.
+  if (label.startsWith('map:')) return LEAF_TYPES.EXPLORATION;
   if (matchesAny(label, VERIFICATION_KEYWORDS)) return LEAF_TYPES.VERIFICATION;
   if (matchesAny(label, ANALYSIS_KEYWORDS)) return LEAF_TYPES.ANALYSIS;
   if (matchesAny(label, IMPLEMENTATION_KEYWORDS)) return LEAF_TYPES.IMPLEMENTATION;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-byan-agent",
-  "version": "2.58.1",
+  "version": "2.59.1",
   "description": "BYAN v2.8 - Intelligent AI agent creator with ELO trust system + scientific fact-check + Hermes universal dispatcher + native Claude Code integration (hooks, skills, MCP server). Multi-platform (Claude Code, Codex). Merise Agile + TDD + 71 Mantras. ~54% LLM cost savings.",
   "main": "src/index.js",
   "bin": {
@@ -87,7 +87,8 @@
     "js-yaml": "^4.1.0",
     "ora": "^5.4.1",
     "uuid": "^13.0.0",
-    "winston": "^3.19.0"
+    "winston": "^3.19.0",
+    "ws": "^8.20.0"
   },
   "bundleDependencies": [
     "byan-platform-config"