palabre 0.9.1 → 0.10.0

package/dist/commands/shared.js

@@ -1,4 +1,8 @@
-/** Extrait une chaîne non vide depuis une valeur de flag. */
+/**
+ * Extrait une chaîne non vide depuis une valeur de flag.
+ * @param value - Valeur brute produite par le parseur CLI.
+ * @returns La chaîne non vide, sinon `undefined`.
+ */
 export function optionalString(value) {
     return typeof value === "string" && value.trim() ? value : undefined;
 }

package/dist/commands/update.js

@@ -1,9 +1,14 @@
+/** @file Commande de diagnostic et application des mises a jour Palabre. */
 import { configExists, loadConfig, resolveDefaultConfigPath } from "../config.js";
 import { createTranslator, resolveLanguage } from "../i18n.js";
 import { applySourceUpdate, formatUpdateInstructions, getUpdateInfo } from "../update.js";
 import { getPackageVersion } from "../version.js";
 import { optionalString } from "./shared.js";
-/** Exécute `palabre update`, avec application explicite pour un checkout source. */
+/**
+ * Affiche les instructions de mise à jour ou applique le workflow d'un checkout source.
+ * @param flags - Flags de config, langue et application explicite.
+ * @returns Une promesse résolue après affichage ou mise à jour.
+ */
 export async function runUpdateCommand(flags) {
     const info = await getUpdateInfo(await getPackageVersion());
     const configPath = optionalString(flags.config) ?? await resolveDefaultConfigPath();

package/dist/config.js

@@ -1,3 +1,4 @@
+/** @file Chargement, génération et validation de la config Palabre, ainsi que la synchronisation des agents/modèles Ollama détectés. */
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
@@ -234,6 +235,10 @@ function migrateVibePlanAgent(config) {
 function isLegacyVibePlanArgs(args) {
     return JSON.stringify(args) === JSON.stringify(["--output", "text", "--agent", "plan", "--trust", "--prompt"]);
 }
+/**
+ * Variante de `syncDetectedAgents` qui indique aussi si la config a changé,
+ * même quand aucun agent n'a été ajouté (ex. migration d'arguments legacy).
+ */
 export function syncDetectedAgentsDetailed(config, discovery) {
     const before = JSON.stringify(config.agents);
     const addedAgents = syncDetectedAgents(config, discovery);
@@ -243,6 +248,12 @@ export function syncDetectedAgentsDetailed(config, discovery) {
         changed
     };
 }
+/**
+ * Bascule le modèle de l'agent `ollama-local` vers un modèle installé si celui configuré
+ * ne l'est pas. Mute `config` directement.
+ * @returns `undefined` si l'agent n'est pas de type `ollama`, si aucun modèle n'est installé,
+ * ou si le modèle configuré est déjà installé.
+ */
 export function syncOllamaModel(config, discovery) {
     const agent = config.agents["ollama-local"];
     if (agent?.type !== "ollama" || discovery.ollama.models.length === 0) {
@@ -258,6 +269,11 @@ export function syncOllamaModel(config, discovery) {
         nextModel: agent.model
     };
 }
+/**
+ * Force le modèle de l'agent `ollama-local` à `model`, sans vérifier qu'il est installé.
+ * Mute `config` directement.
+ * @returns `undefined` si l'agent n'est pas de type `ollama`.
+ */
 export function setOllamaModel(config, model) {
     const agent = config.agents["ollama-local"];
     if (agent?.type !== "ollama") {
@@ -279,7 +295,7 @@ export function setOllamaBaseUrl(config, baseUrl) {
     return agents.length;
 }
 /** Écrit `config` sérialisé en JSON dans `configPath`. Crée le répertoire parent si nécessaire. */
-export async function writeExampleConfig(configPath = DEFAULT_CONFIG_PATH, config = exampleConfig) {
+export async function writeConfig(configPath = DEFAULT_CONFIG_PATH, config = exampleConfig) {
     const resolved = path.resolve(configPath);
     await mkdir(path.dirname(resolved), { recursive: true });
     await writeFile(resolved, `${JSON.stringify(config, null, 2)}\n`, "utf8");

package/dist/configWizard.js

@@ -1,6 +1,7 @@
+/** @file Wizard interactif `palabre config` (sans sous-commande) pour éditer les defaults au clavier. */
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
-import { syncDetectedAgents, writeExampleConfig } from "./config.js";
+import { syncDetectedAgents, writeConfig } from "./config.js";
 import { discoverLocalTools } from "./discovery.js";
 import { DEFAULT_TURNS, MAX_TURNS, turnsOrDefault, validateTurns } from "./limits.js";
 /**
@@ -36,7 +37,7 @@ export async function runConfigWizard(configPath, config, messages) {
         }
         if (action === "2") {
             delete config.defaults;
-            await writeExampleConfig(configPath, config);
+            await writeConfig(configPath, config);
             console.log(messages.config.wizardCleared(configPath));
             return;
         }
@@ -47,7 +48,7 @@ export async function runConfigWizard(configPath, config, messages) {
                 console.log(messages.config.syncNoMissing(configPath));
                 return;
             }
-            await writeExampleConfig(configPath, config);
+            await writeConfig(configPath, config);
             console.log(messages.config.syncAdded(configPath, addedAgents.join(", ")));
             return;
         }
@@ -75,7 +76,7 @@ export async function runConfigWizard(configPath, config, messages) {
         else {
             delete config.defaults.summaryAgent;
         }
-        await writeExampleConfig(configPath, config);
+        await writeConfig(configPath, config);
         console.log(messages.config.wizardDefaultsSet(configPath, formatDefaults(config.defaults, messages)));
     }
     finally {

package/dist/context.js

@@ -1,3 +1,4 @@
+/** @file Chargement du contexte projet : `--files` strict et `--context` tolérant avec règles `.gitignore` simplifiées. */
 import { readdir, readFile, stat } from "node:fs/promises";
 import path from "node:path";
 import { createTranslator } from "./i18n.js";

package/dist/contextScan.js

@@ -1,11 +1,12 @@
+/** @file Contrat JSON v1 de `palabre context scan --json`, consommé par les intégrations. */
 import path from "node:path";
 import { loadProjectInputs } from "./context.js";
 import { createTranslator } from "./i18n.js";
 /**
- * Builds the machine-readable context preview used by integrations.
+ * Construit l'aperçu de contexte lisible par une machine, utilisé par les intégrations.
  *
- * The scan intentionally reuses the same tolerant loader as `--context`, so
- * the returned files are the files Palabre would actually inject into a debate.
+ * Le scan réutilise volontairement le même chargeur tolérant que `--context`, afin que
+ * les fichiers renvoyés soient exactement ceux que Palabre injecterait dans un débat.
  */
 export async function buildContextScan(scanPaths, cwd = process.cwd(), messages = createTranslator("fr")) {
     const effectiveScanPaths = scanPaths.length > 0 ? scanPaths : ["."];

package/dist/discovery.js

@@ -1,3 +1,4 @@
+/** @file Détection locale des CLIs agents et d'Ollama, utilisée par `init`, `doctor`, `presets` et l'accueil TUI. */
 import { access } from "node:fs/promises";
 import path from "node:path";
 import { executableExtensions } from "./exec.js";

package/dist/doctor.js

@@ -1,3 +1,4 @@
+/** @file Diagnostic `palabre doctor` : vérifie config, agents détectés et connectivité Ollama. */
 import path from "node:path";
 import { stat } from "node:fs/promises";
 import { configExists, loadConfig, resolveDefaultConfigPath, resolveOutputDir } from "./config.js";

package/dist/errors.js

@@ -20,3 +20,7 @@ export function formatAdapterError(error, messages = createTranslator("fr")) {
     const hint = messages.adapterErrors.hint(error.kind);
     return hint ? `${error.message}\n${messages.adapterErrors.suggestionPrefix}: ${hint}` : error.message;
 }
+/** Construit l'`AdapterError` standard d'annulation utilisateur, partagée par tous les adapters. */
+export function cancelledError(adapterName) {
+    return new AdapterError("cancelled", adapterName, `${adapterName} cancelled by user.`);
+}

package/dist/exec.js

@@ -1,3 +1,4 @@
+/** @file Résolution d'extensions exécutables partagée entre discovery et l'adapter PTY. */
 import path from "node:path";
 /**
  * Extensions exécutables candidates pour résoudre une commande dans le PATH.

package/dist/history.js

@@ -1,6 +1,12 @@
+/** @file Liste les exports Markdown récents en reparsant leur table de métadonnées, pour `palabre history` et la TUI. */
 import { readdir, readFile, stat } from "node:fs/promises";
 import path from "node:path";
+/** Limite de lecture par fichier : la table de métadonnées est toujours en tête de l'export. */
 const maxHeaderBytes = 12_000;
+/**
+ * Liste les exports les plus récents d'un dossier de sortie, triés par date de modification.
+ * Silencieux si `outputDir` est absent ou inaccessible : retourne `[]` sans lever.
+ */
 export async function listHistoryEntries(outputDir, limit = 10) {
     const resolved = path.resolve(outputDir);
     let entries;
@@ -19,6 +25,7 @@ export async function listHistoryEntries(outputDir, limit = 10) {
         .sort((left, right) => right.mtimeMs - left.mtimeMs)
         .slice(0, limit);
 }
+/** Lit et parse un fichier d'export. Retourne `undefined` sur toute erreur filesystem/parsing plutôt que de lever. */
 async function readHistoryFile(filePath) {
     try {
         const [metadata, raw] = await Promise.all([
@@ -44,6 +51,7 @@ async function readHistoryFile(filePath) {
         return undefined;
     }
 }
+/** Formate le compteur `x/y` adapté au mode, en tolérant les clés FR/EN de la table de métadonnées. */
 function countFromTable(mode, table) {
     if (mode === "ask") {
         const received = table["Reponses recues"] ?? table["Received responses"];
@@ -54,6 +62,7 @@ function countFromTable(mode, table) {
     const requested = table["Tours demandes"] ?? table["Requested turns"];
     return played && requested ? `${played}/${requested}` : played ?? requested ?? "";
 }
+/** Extrait les paires clé/valeur de la table Markdown `| Champ | Valeur |` générée par l'export. */
 function parseMetadataTable(markdown) {
     const fields = {};
     const lines = markdown.split(/\r?\n/);
@@ -75,6 +84,7 @@ function stripMarkdown(value) {
         .replace(/`/g, "")
         .trim();
 }
+/** Reconstruit un sujet lisible depuis le nom de fichier quand la table de métadonnées ne l'indique pas. */
 function topicFromFileName(fileName) {
     return fileName
         .replace(/^palabre-/, "")

package/dist/i18n.js

@@ -1,5 +1,7 @@
 import { createTranslator } from "./messages/index.js";
+/** Langue utilisée quand aucune source explicite (flag, env, config) n'en fournit une valide. */
 export const DEFAULT_LANGUAGE = "fr";
+/** Langues acceptées par `parseLanguage`/`resolveLanguage`. */
 export const SUPPORTED_LANGUAGES = ["fr", "en"];
 /**
  * Valide une langue Palabre.

package/dist/index.js

@@ -1,5 +1,11 @@
 #!/usr/bin/env node
-import { assertRunnableConfig, configExists, createConfigFromDiscovery, loadConfig, resolveDefaultConfigPath, resolveOutputDir, setOllamaModel, syncDetectedAgentsDetailed, syncOllamaModel, writeExampleConfig } from "./config.js";
+/**
+ * @file Point d'entrée CLI de Palabre : parsing des arguments, dispatch vers les
+ * commandes leaf (`agents`, `presets`, `history`, `context`, `update`, `init`, `config`),
+ * résolution de la config/langue, boucle TUI d'accueil et lancement d'un débat ou d'une
+ * requête `ask` via l'orchestrateur.
+ */
+import { assertRunnableConfig, configExists, createConfigFromDiscovery, loadConfig, resolveDefaultConfigPath, resolveOutputDir, setOllamaModel, syncDetectedAgentsDetailed, syncOllamaModel, writeConfig } from "./config.js";
 import { loadProjectInputs } from "./context.js";
 import { discoverLocalTools, discoverLocalToolsForConfig } from "./discovery.js";
 import { runDoctor } from "./doctor.js";
@@ -19,7 +25,7 @@ import { writeDebateMarkdown } from "./output.js";
 import { formatUpdateInstructions, getUpdateInfo } from "./update.js";
 import { getStringListFlag, parseArgs } from "./args.js";
 import { clearTuiRunOverrides } from "./tuiState.js";
-import { OllamaUrlError } from "./ollamaUrl.js";
+import { formatOllamaUrlError, OllamaUrlError } from "./ollamaUrl.js";
 import { compareSemver, getLatestPackageVersion, getPackageVersion } from "./version.js";
 import { runAgentsCommand } from "./commands/agents.js";
 import { runContextCommand } from "./commands/context.js";
@@ -29,7 +35,7 @@ import { runPresetsCommand } from "./commands/presets.js";
 import { runUpdateCommand } from "./commands/update.js";
 import { optionalString } from "./commands/shared.js";
 import { runTuiAgentsWizard, runTuiConfigLoop, runTuiRolesWizard, syncInteractiveDetectedAgents } from "./tuiController.js";
-import { resolveRunOptions } from "./runOptions.js";
+import { parseInterfaceFlag, parseModeFlag, resolveRunOptions } from "./runOptions.js";
 /** Point d'entrée principal du CLI Palabre. Dispatche vers la commande appropriée selon les arguments. */
 async function main() {
     const rawArgs = process.argv.slice(2);
@@ -90,7 +96,7 @@ async function main() {
             configLanguage: config.language
         });
         const messages = createTranslator(config.language);
-        await writeExampleConfig(configPath, config);
+        await writeConfig(configPath, config);
         if (!shouldOpenTuiHome(parsed)) {
             console.log(messages.init.editConfigThenRerun(configPath));
             return;
@@ -113,78 +119,94 @@ async function main() {
     let tuiVersion = "";
     let tuiLatestVersion;
     const handleTuiHomeInput = async (tuiInput) => {
-        if (!tuiInput) {
-            return "quit";
-        }
-        if (tuiInput.kind === "help") {
-            renderTuiHelp(messages);
-            const nextInput = await promptTuiHomeTopic(tuiMode, messages);
-            return handleTuiHomeInput(nextInput);
-        }
-        if (tuiInput.kind === "history") {
-            renderTuiHistory(await listHistoryEntries(resolveOutputDir(config.outputDir)), messages);
-            const nextInput = await promptTuiHomeTopic(tuiMode, messages);
-            return handleTuiHomeInput(nextInput);
-        }
-        if (tuiInput.kind === "update") {
-            const info = await getUpdateInfo(tuiVersion);
-            renderTuiUpdate(formatUpdateInstructions(info, messages), messages);
-            const nextInput = await promptTuiHomeTopic(tuiMode, messages);
-            return handleTuiHomeInput(nextInput);
-        }
-        if (tuiInput.kind === "home") {
-            return "continue";
-        }
-        if (tuiInput.kind === "roles") {
-            const result = await runTuiRolesWizard(configPath, config, messages, tuiMode, tuiInput.roles);
-            if (result.quit)
-                return "quit";
-            tuiNotice = result.notice;
-            return "continue";
-        }
-        if (tuiInput.kind === "agents") {
-            const result = await runTuiAgentsWizard(configPath, config, messages, tuiMode, tuiInput.agents);
-            if (result.quit)
-                return "quit";
-            tuiNotice = result.notice;
-            resetTuiRunOverridesOnNextTopic ||= Boolean(result.changedRunDefaults);
-            return "continue";
-        }
-        if (tuiInput.kind === "mode") {
-            tuiMode = tuiInput.mode;
-            return "continue";
-        }
-        if (tuiInput.kind === "config") {
-            const result = await runTuiConfigLoop(configPath, config, messages, tuiMode);
-            if (result.quit)
+        let input = tuiInput;
+        // Les vues informatives (/help, /history, /update) réaffichent le prompt d'accueil
+        // puis reprennent le traitement avec la nouvelle saisie, d'où la boucle.
+        for (;;) {
+            if (!input) {
                 return "quit";
-            tuiMode = result.mode;
-            resetTuiRunOverridesOnNextTopic ||= result.changedRunDefaults;
-            language = resolveLanguage({ explicitLanguage: optionalString(parsed.flags.language), configLanguage: config.language });
-            messages = createTranslator(language);
-            return "continue";
-        }
-        if (tuiInput.kind === "new") {
-            parsed.command = "new";
-            parsed.commandExplicit = true;
-            delete parsed.flags.topic;
-            return "run";
-        }
-        if (tuiInput.kind === "retry") {
-            if (!optionalString(parsed.flags.topic)) {
-                tuiNotice = messages.tui.retryUnavailable;
+            }
+            if (input.kind === "help") {
+                renderTuiHelp(messages);
+                input = await promptTuiHomeTopic(tuiMode, messages);
+                continue;
+            }
+            if (input.kind === "history") {
+                renderTuiHistory(await listHistoryEntries(resolveOutputDir(config.outputDir)), messages);
+                input = await promptTuiHomeTopic(tuiMode, messages);
+                continue;
+            }
+            if (input.kind === "update") {
+                const info = await getUpdateInfo(tuiVersion);
+                renderTuiUpdate(formatUpdateInstructions(info, messages), messages);
+                input = await promptTuiHomeTopic(tuiMode, messages);
+                continue;
+            }
+            if (input.kind === "home") {
                 return "continue";
             }
-            return "retry";
-        }
-        parsed.command = "";
-        parsed.commandExplicit = false;
-        if (hasCompletedTuiSession || resetTuiRunOverridesOnNextTopic) {
-            clearTuiRunOverrides(parsed.flags);
-            resetTuiRunOverridesOnNextTopic = false;
+            if (input.kind === "roles") {
+                const result = await runTuiRolesWizard(configPath, config, messages, tuiMode, input.roles);
+                if (result.quit)
+                    return "quit";
+                tuiNotice = result.notice;
+                return "continue";
+            }
+            if (input.kind === "agents") {
+                const result = await runTuiAgentsWizard(configPath, config, messages, tuiMode, input.agents);
+                if (result.quit)
+                    return "quit";
+                tuiNotice = result.notice;
+                resetTuiRunOverridesOnNextTopic ||= Boolean(result.changedRunDefaults);
+                return "continue";
+            }
+            if (input.kind === "mode") {
+                tuiMode = input.mode;
+                return "continue";
+            }
+            if (input.kind === "config") {
+                const result = await runTuiConfigLoop(configPath, config, messages, tuiMode);
+                if (result.quit)
+                    return "quit";
+                tuiMode = result.mode;
+                resetTuiRunOverridesOnNextTopic ||= result.changedRunDefaults;
+                language = resolveLanguage({ explicitLanguage: optionalString(parsed.flags.language), configLanguage: config.language });
+                messages = createTranslator(language);
+                return "continue";
+            }
+            if (input.kind === "new") {
+                parsed.command = "new";
+                parsed.commandExplicit = true;
+                delete parsed.flags.topic;
+                return "run";
+            }
+            if (input.kind === "retry") {
+                if (!optionalString(parsed.flags.topic)) {
+                    tuiNotice = messages.tui.retryUnavailable;
+                    return "continue";
+                }
+                return "retry";
+            }
+            if (!input.topic) {
+                // Saisie réduite à des flags inline (ex. "--context src") : re-prompter au lieu de sortir en erreur.
+                tuiNotice = messages.common.topicRequired;
+                return "continue";
+            }
+            parsed.command = "";
+            parsed.commandExplicit = false;
+            if (hasCompletedTuiSession || resetTuiRunOverridesOnNextTopic) {
+                clearTuiRunOverrides(parsed.flags);
+                resetTuiRunOverridesOnNextTopic = false;
+            }
+            parsed.flags.topic = input.topic;
+            if (input.files && input.files.length > 0) {
+                parsed.flags.files = input.files;
+            }
+            if (input.context && input.context.length > 0) {
+                parsed.flags.context = input.context;
+            }
+            return "run";
         }
-        parsed.flags.topic = tuiInput.topic;
-        return "run";
     };
     if (shouldOpenTuiHome(parsed)) {
         const [syncResult, currentVersion, latestVersion] = await Promise.all([
@@ -308,6 +330,7 @@ async function main() {
         }
     }
 }
+/** Construit un signal d'annulation déclenché sur `SIGINT`/`SIGTERM` pour interrompre un débat en cours. */
 function debateAbortSignal() {
     const controller = new AbortController();
     const abort = () => {
@@ -328,7 +351,7 @@ async function runConfigCommand(flags) {
     const explicitLanguage = optionalString(flags.language);
     if (!(await configExists(configPath))) {
         const messages = createTranslator(resolveLanguage({ explicitLanguage }));
-        await writeExampleConfig(configPath);
+        await writeConfig(configPath);
         console.log(messages.config.createdForConfig(configPath));
         return;
     }
@@ -339,7 +362,7 @@ async function runConfigCommand(flags) {
     });
     const messages = createTranslator(language);
     if (flags["ollama-models"]) {
-        await runOllamaModelsCommand(config, Boolean(flags.json));
+        await runOllamaModelsCommand(config, Boolean(flags.json), messages);
         return;
     }
     const setOllamaModelValue = optionalString(flags["set-ollama-model"]);
@@ -358,7 +381,7 @@ async function runConfigCommand(flags) {
             console.log(messages.config.syncNoMissing(configPath));
             return;
         }
-        await writeExampleConfig(configPath, config);
+        await writeConfig(configPath, config);
         console.log(result.addedAgents.length > 0
             ? messages.config.syncAdded(configPath, result.addedAgents.join(", "))
             : messages.config.syncRefreshed(configPath));
@@ -427,19 +450,25 @@ async function runConfigCommand(flags) {
         if (changesDefaults) {
             config.defaults = nextDefaults;
         }
-        await writeExampleConfig(configPath, config);
+        await writeConfig(configPath, config);
         console.log(messages.config.updated(configPath, formatDefaultsForMessage(config.defaults ?? {}, messages), config.language ?? DEFAULT_LANGUAGE));
         return;
     }
     if (flags["clear-defaults"]) {
         delete config.defaults;
-        await writeExampleConfig(configPath, config);
+        await writeConfig(configPath, config);
         console.log(messages.config.cleared(configPath));
         return;
     }
     await runConfigWizard(configPath, config, messages);
 }
-async function runOllamaModelsCommand(config, json) {
+/**
+ * Affiche l'état de l'agent Ollama local (modèle courant, disponibilité de l'API, modèles installés).
+ * @param config - Config chargée.
+ * @param json - Si `true`, affiche le résultat en JSON plutôt qu'en texte lisible.
+ * @param messages - Dictionnaire localisé pour la sortie texte.
+ */
+async function runOllamaModelsCommand(config, json, messages) {
     const discovery = await discoverLocalToolsForConfig(config);
     const agent = config.agents["ollama-local"];
     const currentModel = agent?.type === "ollama" ? agent.model : null;
@@ -456,10 +485,16 @@ async function runOllamaModelsCommand(config, json) {
         console.log(JSON.stringify(payload, null, 2));
         return;
     }
-    console.log(`ollama-local: ${currentModel ?? "(non configuré)"}`);
-    console.log(`Ollama API: ${discovery.ollama.available ? "joignable" : "indisponible"} (${discovery.ollama.baseUrl})`);
-    console.log(`Modèles installés: ${discovery.ollama.models.length > 0 ? discovery.ollama.models.join(", ") : "(aucun)"}`);
+    console.log(messages.config.ollamaModelsCurrent(currentModel));
+    console.log(messages.config.ollamaModelsApi(discovery.ollama.available, discovery.ollama.baseUrl));
+    console.log(messages.config.ollamaModelsInstalled(discovery.ollama.models));
 }
+/**
+ * Change le modèle configuré pour l'agent `ollama-local` après vérification qu'il est bien installé.
+ * @param configPath - Chemin du fichier de config à mettre à jour.
+ * @param config - Config chargée.
+ * @param model - Nom du modèle Ollama à définir.
+ */
 async function runSetOllamaModelCommand(configPath, config, model, messages) {
     const trimmed = model.trim();
     if (!trimmed) {
@@ -474,11 +509,16 @@ async function runSetOllamaModelCommand(configPath, config, model, messages) {
         throw new Error(messages.config.ollamaModelUnavailable(trimmed));
     }
     const result = setOllamaModel(config, trimmed);
-    await writeExampleConfig(configPath, config);
+    await writeConfig(configPath, config);
     console.log(result
         ? messages.config.ollamaModelUpdated(configPath, result.previousModel, result.nextModel)
         : messages.config.ollamaModelNoChange(configPath, agent.model));
 }
+/**
+ * Aligne automatiquement le modèle de l'agent `ollama-local` sur un modèle réellement installé.
+ * @param configPath - Chemin du fichier de config à mettre à jour.
+ * @param config - Config chargée.
+ */
 async function runSyncOllamaModelCommand(configPath, config, messages) {
     const discovery = await discoverLocalToolsForConfig(config);
     const agent = config.agents["ollama-local"];
@@ -493,7 +533,7 @@ async function runSyncOllamaModelCommand(configPath, config, messages) {
         console.log(messages.config.ollamaModelNoChange(configPath, agent.model));
         return;
     }
-    await writeExampleConfig(configPath, config);
+    await writeConfig(configPath, config);
     console.log(messages.config.ollamaModelUpdated(configPath, result.previousModel, result.nextModel));
 }
 /**
@@ -511,6 +551,11 @@ function isNoneValue(value) {
 function formatDefaultsForMessage(defaults, messages) {
     return messages.config.defaultsSummary(defaults.agentA, defaults.agentB, turnsOrDefault(defaults.turns), defaults.summaryAgent, defaults.askSummaryAgent, defaults.mode, defaults.askAgents, defaults.interface);
 }
+/**
+ * Déduplique et valide une liste d'agents `ask` fournie via `--ask-agents`.
+ * @param agents - Noms d'agents bruts, éventuellement en doublon.
+ * @throws Si la liste dépasse `MAX_ASK_AGENTS` ou référence un agent inconnu de la config.
+ */
 function normalizeAskAgentsForConfig(config, agents, messages) {
     const unique = agents
         .map((agent) => agent.trim())
@@ -534,24 +579,6 @@ function assertKnownAgent(config, agentName, fieldName, messages) {
         throw new Error(messages.common.unknownAgentForField(fieldName, agentName, Object.keys(config.agents).join(", ")));
     }
 }
-function parseModeFlag(value, messages) {
-    if (!value) {
-        return "debate";
-    }
-    if (value === "debate" || value === "ask") {
-        return value;
-    }
-    throw new Error(messages.common.unknownMode(value, "debate, ask"));
-}
-function parseInterfaceFlag(value, messages) {
-    if (!value) {
-        return "tui";
-    }
-    if (value === "tui" || value === "terminal") {
-        return value;
-    }
-    throw new Error(messages.common.unknownMode(value, "tui, terminal"));
-}
 /**
  * Affiche un aperçu du prompt du premier tour sans appeler aucun agent (flag `--show-prompt`).
  * @param config - Config chargée.
@@ -638,14 +665,12 @@ function createRendererFromFlags(flags, plainOutputFallback, defaultInterface, m
     if (flags.json) {
         return createNdjsonRenderer();
     }
-    if (flags.tui) {
-        return createTuiRenderer(messages);
-    }
-    if (flags.terminal || flags.plain || plainOutputFallback || defaultInterface === "terminal") {
-        return createConsoleRenderer(true, messages);
-    }
     return createAutoRenderer(flags, plainOutputFallback, defaultInterface, messages);
 }
+/**
+ * Choix du renderer par défaut (`--renderer auto`) : TUI si les flags/config le demandent
+ * ou si stdout est un TTY, rendu console plain sinon.
+ */
 function createAutoRenderer(flags, plainOutputFallback, defaultInterface, messages) {
     if (flags.tui) {
         return createTuiRenderer(messages);
@@ -655,6 +680,11 @@ function createAutoRenderer(flags, plainOutputFallback, defaultInterface, messag
     }
     return process.stdout.isTTY ? createTuiRenderer(messages) : createConsoleRenderer(true, messages);
 }
+/**
+ * Détermine si l'accueil TUI doit s'ouvrir : commande `run` implicite, sans sujet, preset
+ * ni flag de rendu déjà fourni. Toute intention explicite de lancer directement un débat
+ * (topic, `--renderer`, `--json`, `--plain`, `--terminal`) désactive l'accueil.
+ */
 function shouldOpenTuiHome(parsed) {
     return parsed.command === "run"
         && !parsed.commandExplicit
@@ -679,6 +709,11 @@ function printHelp(messages, command) {
     const commandHelp = command ? messages.help.renderCommand(command) : undefined;
     console.log(commandHelp ?? messages.help.render(listPresetNames().join(", ")));
 }
+/**
+ * Résout la commande cible pour l'aide contextuelle (`palabre <cmd> --help`), en normalisant
+ * les alias (`agent` -> `agents`, `preset` -> `presets`, `setup` -> `init`).
+ * @returns `undefined` pour `help`/`run`, qui utilisent l'aide générale.
+ */
 function commandHelpTarget(parsed) {
     if (parsed.command === "help" || parsed.command === "run") {
         return undefined;
@@ -706,16 +741,16 @@ async function resolveCommandMessages(flags) {
     }
     return createTranslator(resolveLanguage({ explicitLanguage, configLanguage }));
 }
+/**
+ * Formate une erreur non gérée remontée jusqu'au point d'entrée en message lisible,
+ * en spécialisant `AdapterError` et `OllamaUrlError` pour rester actionnable.
+ */
 function formatRuntimeError(error, messages) {
     if (error instanceof AdapterError) {
         return formatAdapterError(error, messages);
     }
     if (error instanceof OllamaUrlError) {
-        if (error.kind === "empty")
-            return messages.common.ollamaUrlEmpty;
-        if (error.kind === "protocol")
-            return messages.common.ollamaUrlProtocol(error.protocol ?? "");
-        return messages.common.ollamaUrlInvalid(error.value);
+        return formatOllamaUrlError(error, messages);
     }
     return error instanceof Error ? error.message : String(error);
 }
@@ -726,6 +761,10 @@ main().catch((error) => {
     console.error(`${messages.common.errorPrefix}: ${message}`);
     process.exitCode = 1;
 });
+/**
+ * Variante de `findRawLanguageFlag` + `resolveLanguage` qui ne peut pas lever, utilisée dans
+ * le gestionnaire d'erreur global où la config n'est pas forcément chargée.
+ */
 function safeStartupLanguage(args) {
     try {
         return resolveLanguage({ explicitLanguage: findRawLanguageFlag(args) });

package/dist/limits.js

@@ -1,6 +1,10 @@
+/** @file Limites produit sur le nombre de tours et d'agents `ask`, et parsing/validation de `--turns`. */
 import { createTranslator } from "./i18n.js";
+/** Nombre de tours par défaut quand `--turns` n'est pas fourni. */
 export const DEFAULT_TURNS = 4;
+/** Nombre maximal d'agents acceptés par `--agents` en mode `ask`. */
 export const MAX_ASK_AGENTS = 4;
+/** Borne haute produit pour `--turns`, au-delà considérée comme une erreur d'utilisation. */
 export const MAX_TURNS = 20;
 /** Convertit `value` en nombre et valide la plage [1, `MAX_TURNS`]. Lève une erreur si invalide. */
 export function parseTurns(value, label = "--turns", messages = createTranslator("fr")) {