create-byan-agent 2.56.0 → 2.58.2

package/CHANGELOG.md

@@ -9,6 +9,86 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- Symptome : `create-byan-agent --cli` restait bloque en chargement infini sur
+  `[6/8] Controle des copies globales de skills` quand des copies globales
+  `~/.claude/skills` divergeaient.
+- Cause : l'etape passait une question interactive (`inquirer`) au moteur, mais
+  l'install auto garde un indicateur de progression (`ora`) qui tourne pendant
+  chaque etape. La question s'affichait SOUS l'indicateur : invisible, en attente
+  d'une saisie que l'utilisateur ne voyait pas -> gel apparent.
+- Correctif : l'install automatique n'ouvre plus de question interactive. Par
+  defaut, elle SIGNALE les copies divergentes et affiche la commande de
+  synchronisation exacte, sans rien ecrire dans `~/.claude` et sans bloquer
+  (ligne rouge conservee : pas d'ecriture silencieuse dans le home). Nouveau
+  drapeau `--sync-skills` pour synchroniser sans demander (le drapeau EST le
+  consentement explicite), en approbation automatique sans prompt.
+- Nouvelle fonction pure `skillsSyncConsent` dans `install/lib/install-mode.js`,
+  testee (`install/__tests__/install-mode.test.js`) ; preuve de non-blocage des
+  deux branches (signalement seul / synchro opt-in) sur une maquette de
+  divergence.
+
+## [2.58.0] - 2026-07-21
+
+### Added — l'assistant par defaut ouvre l'app Desktop si elle est installee
+- `create-byan-agent` (sans argument) tente d'abord d'ouvrir l'app Desktop BYAN
+  dans une fenetre native ; si aucune app n'est detectee, il ouvre le meme
+  assistant dans le navigateur. Les deux visages partagent le meme serveur webui
+  — seule la fenetre change. Aucun blocage quand l'app n'est pas la.
+- Detection par emplacements d'installation concrets (electron-builder,
+  productName BYAN) : `/opt/BYAN/byan`, `/usr/bin/byan`, `/usr/local/bin/byan`
+  (Linux) ; `BYAN.app` (macOS, systeme et `~/Applications`) ; `BYAN.exe` sous
+  `Programs`/`PROGRAMFILES` (Windows). La variable `BYAN_DESKTOP_BIN` surcharge
+  pour une AppImage ou un chemin personnalise. Pas de recherche d'un `byan` nu
+  sur le PATH (trop de faux positifs).
+- `create-byan-agent web` force desormais le navigateur (echappatoire explicite,
+  ignore l'app Desktop).
+- Nouveau module pur `install/lib/desktop-app.js` (`detectDesktopApp`,
+  `candidatePaths`), injectable (platform/env/homedir/existsSync) et teste
+  (`install/__tests__/desktop-app.test.js`, 7 cas couvrant Linux/macOS/Windows,
+  l'override et le repli).
+- Note : les binaires de l'app Desktop ne sont pas encore distribues ; la
+  detection tombe donc sur le navigateur aujourd'hui, par conception. Le vrai
+  installateur (distribution des binaires) est un chantier separe a venir.
+
+## [2.57.0] - 2026-07-21
+
+### Changed — l'assistant web devient l'installation par defaut
+- `create-byan-agent` (sans argument) lance desormais l'assistant graphique dans
+  le navigateur : il demarre le serveur local (lie a `127.0.0.1`) et ouvre la
+  page d'installation. C'est l'inversion demandee — le graphique par defaut, le
+  terminal en option.
+- Les deux chemins terminal restent accessibles par drapeau :
+  - `--cli` : installation automatique en terminal, zero question (le comportement
+    qui etait le defaut en 2.56.0).
+  - `--legacy` : interview complet d'origine, question par question.
+- `create-byan-agent web` conserve son role d'alias explicite de l'action par
+  defaut ; il accepte `--port` et `--dir`.
+- Nouveau module pur `install/lib/install-mode.js` (`chooseInstallMode`) : la
+  decision de routage (web / cli / legacy) est isolee et testee
+  (`install/__tests__/install-mode.test.js`, 5 cas). `--legacy` prime sur `--cli`
+  si les deux sont passes.
+
 ## [2.56.0] - 2026-07-21
 
 ### Changed — installation refondue : un moteur, deux visages

package/README.md

@@ -76,7 +76,7 @@ Diversifier les personas elargit la surface de competence collective.
 Aucune installation préalable n'est nécessaire. Lancez simplement :
 
 ```bash
-# Crée un nouveau projet BYAN (via npx, sans installation préalable)
+# Assistant d'installation graphique dans le navigateur (par défaut)
 npx create-byan-agent
 
 # Ou installation globale
@@ -84,16 +84,32 @@ npm install -g create-byan-agent
 create-byan-agent
 ```
 
-L'installeur (Yanstaller) vous guide interactivement à travers le processus :
-
-```
-? Nom du projet : mon-projet
-? Langue de communication : Francais
-? Plateforme cible : Claude Code
-? Activer le fact-check scientifique ? [Y/n]
-? Activer le système ELO de confiance ? [Y/n]
-? Optimiser les coûts LLM automatiquement (~54% d'économies) ? [Y/n]
-```
+Par défaut, `create-byan-agent` ouvre l'assistant graphique. S'il détecte l'app
+Desktop BYAN installée, il l'ouvre dans une fenêtre native ; sinon il démarre un
+petit serveur local (lié à `127.0.0.1`) et ouvre la page d'installation dans le
+navigateur. Dans les deux cas c'est le même assistant : vous y choisissez le nom
+du projet, le répertoire et les options.
+
+Modes selon vos besoins :
+
+| Commande | Mode |
+|----------|------|
+| `create-byan-agent` | Assistant graphique : app Desktop si installée, sinon navigateur (par défaut) |
+| `create-byan-agent web` | Force l'assistant dans le navigateur (ignore l'app Desktop) |
+| `create-byan-agent --cli` | Installation automatique en terminal, zéro question (Claude+Codex, tous les agents, rtk) |
+| `create-byan-agent --cli --sync-skills` | Idem, en synchronisant sans demander les copies globales `~/.claude/skills` divergentes |
+| `create-byan-agent --legacy` | Interview complet d'origine, question par question en terminal |
+
+En mode `--cli`, si des copies globales de skills sous `~/.claude/skills`
+divergent de l'installation, l'assistant le signale et affiche la commande de
+synchronisation — sans bloquer et sans rien écrire dans votre home. Ajoutez
+`--sync-skills` pour qu'il les synchronise directement.
+
+Détection de l'app Desktop : emplacements d'installation standards par système
+(`/opt/BYAN/byan` et `/usr/bin/byan` sous Linux, `BYAN.app` sous macOS,
+`BYAN.exe` sous Windows). Pour une AppImage ou un chemin personnalisé, pointez la
+variable `BYAN_DESKTOP_BIN` sur l'exécutable. Tant que l'app Desktop n'est pas
+installée, l'assistant s'ouvre dans le navigateur — aucun blocage.
 
 ### Structure du projet après installation
 

package/install/bin/create-byan-agent-v2.js

@@ -24,6 +24,7 @@ const { setupCodexAutodelegate, DEVICE_FLOW_INSTRUCTION } = require('../lib/code
 const { setupMcpExtensions } = require('../lib/mcp-extensions');
 const { setupStagingConsent } = require('../lib/staging-consent');
 const { getLatestVersion, compareVersions } = require('../lib/utils/version-compare');
+const { chooseInstallMode, skillsSyncConsent } = require('../lib/install-mode');
 
 // Version source-of-truth is the root package.json (the one npm publishes).
 // install/package.json used to be read here, but it carries an unrelated
@@ -1910,15 +1911,16 @@ async function installAuto(options) {
   const engine = require('../lib/install-engine');
   const projectRoot = path.resolve(options.dir || process.cwd());
 
-  console.log(chalk.cyan.bold(`\n  BYAN ${BYAN_VERSION} — installation automatique`));
+  console.log(chalk.cyan.bold(`\n  BYAN ${BYAN_VERSION} — installation automatique (terminal)`));
   console.log(chalk.gray(`  Projet : ${options.name || path.basename(projectRoot)}  |  Repertoire : ${projectRoot}`));
-  console.log(chalk.gray('  (interview complete : --legacy ; assistant web : create-byan-agent web)\n'));
+  console.log(chalk.gray('  (assistant web par defaut : create-byan-agent ; interview complet : --legacy)\n'));
 
   let spinner = null;
   const isTTY = Boolean(process.stdout.isTTY);
-  const ask = isTTY
-    ? async (message) => (await inquirer.prompt([{ type: 'confirm', name: 'ok', message, default: true }])).ok
-    : null;
+  // The automatic install never opens an interactive prompt: a question drawn
+  // under the live progress spinner froze the terminal at the skills-sync step.
+  // Default is notice-only ; --sync-skills opts in to an unattended sync.
+  const ask = skillsSyncConsent(options);
 
   try {
     const result = await engine.runInstall({
@@ -1960,18 +1962,72 @@ async function installAuto(options) {
   }
 }
 
+// Default path since 2.58.0: prefer the native Desktop app when it is installed
+// (option A), otherwise fall back to the browser wizard. Both wrap the SAME
+// webui server — the only difference is the window (native shell vs browser
+// tab). When no Desktop app is found, print a one-line discovery tip and open
+// the browser without blocking. The `web` subcommand skips this and forces the
+// browser (explicit escape hatch).
+function launchDesktopOrWeb(options = {}) {
+  const { detectDesktopApp } = require('../lib/desktop-app');
+  const desktop = detectDesktopApp();
+
+  if (desktop.found) {
+    console.log(chalk.cyan.bold(`\n  BYAN ${BYAN_VERSION} — ouverture de l app Desktop\n`));
+    console.log(chalk.gray(`  ${desktop.bin}`));
+    try {
+      const { spawn } = require('child_process');
+      const child = spawn(desktop.bin, [], { detached: true, stdio: 'ignore' });
+      child.unref();
+      return;
+    } catch (error) {
+      console.log(chalk.yellow(`  Echec du lancement de l app Desktop (${error.message}) — repli navigateur.`));
+      // fall through to the browser wizard
+    }
+  } else {
+    console.log(chalk.gray('\n  Astuce : l app Desktop BYAN offre une vraie fenetre native. Une fois installee,'));
+    console.log(chalk.gray('  cette commande l ouvrira automatiquement. Pour l instant, j ouvre le navigateur.'));
+  }
+
+  launchWeb(options);
+}
+
+// The browser wizard. Starts the local HTTP + WebSocket server (bound to
+// loopback) and opens the browser — the server owns the browser launch. Used
+// as the fallback of launchDesktopOrWeb and as the explicit `web` subcommand.
+function launchWeb(options = {}) {
+  const ByanWebUI = require('../src/webui/server');
+  const port = parseInt(options.port, 10) || 3000;
+  const projectRoot = path.resolve(options.dir || process.cwd());
+
+  console.log(chalk.cyan.bold(`\n  BYAN ${BYAN_VERSION} — assistant d installation (navigateur)\n`));
+  const server = new ByanWebUI({ port, projectRoot });
+  server.start();
+  console.log(chalk.green(`  Interface ouverte sur http://localhost:${port}`));
+  console.log(chalk.gray(`  Repertoire projet : ${projectRoot}`));
+  console.log(chalk.gray('  Installation en terminal : create-byan-agent --cli   |   Ctrl+C pour arreter\n'));
+}
+
 // CLI Program
 program
   .name('create-byan-agent')
-  .description('Install BYAN v2.2.0 - Builder of YAN with Model Selector and multi-platform support')
+  .description('Install BYAN - Builder of YAN. Default: graphical web wizard. --cli for the terminal install.')
   .version(BYAN_VERSION)
   .option('--skip-version-check', 'Bypass the npm freshness guard (not recommended)')
+  .option('--cli', 'Installation automatique en terminal (au lieu de l assistant web par defaut)')
+  .option('-p, --port <port>', 'Port de l assistant web (defaut : 3000)', '3000')
   .option('--name <name>', 'Nom du projet (defaut : nom du dossier)')
   .option('--dir <dir>', 'Repertoire d installation (defaut : dossier courant)')
-  .option('--no-launch', 'Ne pas lancer Claude Code en fin d installation')
-  .option('--no-rtk', 'Ne pas installer rtk automatiquement')
+  .option('--no-launch', 'Ne pas lancer Claude Code en fin d installation (mode --cli)')
+  .option('--no-rtk', 'Ne pas installer rtk automatiquement (mode --cli)')
+  .option('--sync-skills', 'Mode --cli : synchroniser sans demander les copies globales ~/.claude/skills divergentes')
   .option('--legacy', 'Interview complete d origine (l ancien parcours a questions)')
-  .action(async (options) => (options.legacy ? install(options) : installAuto(options)));
+  .action(async (options) => {
+    const mode = chooseInstallMode(options);
+    if (mode === 'legacy') return install(options);
+    if (mode === 'cli') return installAuto(options);
+    return launchDesktopOrWeb(options);
+  });
 
 // Update Command (Yanstaller v3)
 program
@@ -2148,20 +2204,13 @@ program
     }
   });
 
+// Explicit alias for the default action — same graphical wizard, kept for
+// discoverability and backward compatibility with `create-byan-agent web`.
 program
   .command('web')
-  .description('Launch BYAN WebUI installer in the browser')
+  .description('Launch BYAN WebUI installer in the browser (same as the default action)')
   .option('-p, --port <port>', 'Port number', '3000')
-  .action(async (options) => {
-    const ByanWebUI = require('../src/webui/server');
-    const port = parseInt(options.port, 10);
-    const projectRoot = process.cwd();
-
-    console.log(chalk.cyan.bold('\n  BYAN WebUI\n'));
-    const server = new ByanWebUI({ port, projectRoot });
-    server.start();
-    console.log(chalk.green(`  Server running at http://localhost:${port}`));
-    console.log(chalk.gray('  Press Ctrl+C to stop\n'));
-  });
+  .option('--dir <dir>', 'Repertoire d installation (defaut : dossier courant)')
+  .action(async (options) => launchWeb(options));
 
 program.parse(process.argv);

package/install/lib/desktop-app.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const path = require('path');
+
+// Detection of an installed BYAN Desktop app (Electron, packaged by
+// electron-builder). productName is "BYAN", appId fr.acadenice.byan. We match
+// CONCRETE executables at the install locations electron-builder produces per
+// OS — NOT a bare `byan` on PATH, which would false-positive on any unrelated
+// binary of that name. The AppImage build has no fixed install path, so it is
+// covered by the BYAN_DESKTOP_BIN override (the user points at their AppImage).
+//
+// Pure and injectable: platform / env / homedir / existsSync are all overridable
+// so the detection is unit-testable without touching the real filesystem.
+
+function candidatePaths(platform, env, homedir) {
+  const out = [];
+
+  // Build the TARGET platform's paths, not the host's — so detection is correct
+  // and unit-testable regardless of the OS the check runs on.
+  const p = platform === 'win32' ? path.win32 : path.posix;
+
+  // Explicit override always wins (AppImage users, custom install prefixes).
+  if (env.BYAN_DESKTOP_BIN) out.push(env.BYAN_DESKTOP_BIN);
+
+  if (platform === 'darwin') {
+    out.push('/Applications/BYAN.app/Contents/MacOS/BYAN');
+    out.push(p.join(homedir, 'Applications', 'BYAN.app', 'Contents', 'MacOS', 'BYAN'));
+  } else if (platform === 'win32') {
+    if (env.LOCALAPPDATA) out.push(p.join(env.LOCALAPPDATA, 'Programs', 'BYAN', 'BYAN.exe'));
+    if (env.PROGRAMFILES) out.push(p.join(env.PROGRAMFILES, 'BYAN', 'BYAN.exe'));
+  } else {
+    // Linux deb/rpm: electron-builder installs to /opt/<productName> and drops
+    // a symlink /usr/bin/<executableName> (productName lowercased -> byan).
+    out.push('/opt/BYAN/byan');
+    out.push('/usr/bin/byan');
+    out.push('/usr/local/bin/byan');
+  }
+
+  return out;
+}
+
+function detectDesktopApp(opts = {}) {
+  const platform = opts.platform || process.platform;
+  const env = opts.env || process.env;
+  const homedir = opts.homedir || require('os').homedir();
+  const existsSync = opts.existsSync || require('fs').existsSync;
+
+  for (const candidate of candidatePaths(platform, env, homedir)) {
+    if (candidate && existsSync(candidate)) {
+      const source = env.BYAN_DESKTOP_BIN === candidate ? 'env' : 'path';
+      return { found: true, bin: candidate, source };
+    }
+  }
+
+  return { found: false, bin: null, source: null };
+}
+
+module.exports = { detectDesktopApp, candidatePaths };

package/install/lib/install-mode.js

@@ -0,0 +1,37 @@
+'use strict';
+
+// Since 2.57.0 the default install experience is the graphical web wizard
+// (create-byan-agent, which starts the local server and opens the browser).
+// Two terminal escape hatches stay reachable by flag:
+//   --cli    -> the zero-question automatic terminal install (installAuto)
+//   --legacy -> the original question-by-question interview (install)
+// --legacy wins over --cli when both are passed: it is the more explicit,
+// older path, so an operator who typed it means it.
+function chooseInstallMode(options = {}) {
+  if (options && options.legacy) return 'legacy';
+  if (options && options.cli) return 'cli';
+  return 'web';
+}
+
+// Global-skills consent for the AUTOMATIC terminal install (installAuto).
+//
+// Field bug (2026-07-21): the auto install froze at "[6/8] Controle des copies
+// globales de skills". Root cause — the engine's skills-sync step was handed an
+// inquirer prompt as its `ask`, but installAuto keeps an ora progress spinner
+// spinning during every step. The prompt was drawn UNDER the live spinner:
+// invisible, waiting on input the user could not see -> apparent infinite load.
+//
+// The fix is a rule, not spinner choreography: the automatic install NEVER opens
+// an interactive prompt. Two non-interactive behaviours only:
+//   - default        -> null : the engine notices the divergence and prints the
+//                        exact sync command, writes nothing in ~/.claude, does
+//                        not block (keeps the "no silent home write" red line).
+//   - --sync-skills  -> an unattended auto-approve (resolves true, no inquirer):
+//                        the flag itself is the explicit consent, so the engine
+//                        syncs the stale global copies without a prompt.
+function skillsSyncConsent(options = {}) {
+  if (options && options.syncSkills) return async () => true;
+  return null;
+}
+
+module.exports = { chooseInstallMode, skillsSyncConsent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-byan-agent",
-  "version": "2.56.0",
+  "version": "2.58.2",
   "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"