palabre 0.9.0 → 0.10.0

package/dist/index.js

@@ -1,29 +1,41 @@
 #!/usr/bin/env node
-import { assertRunnableConfig, configExists, createConfigFromDiscovery, DEFAULT_CONFIG_PATH, GLOBAL_CONFIG_PATH, loadConfig, resolveDefaultConfigPath, resolveOutputDir, setOllamaBaseUrl, 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 { buildContextScan } from "./contextScan.js";
-import { discoverLocalTools } from "./discovery.js";
+import { discoverLocalTools, discoverLocalToolsForConfig } from "./discovery.js";
 import { runDoctor } from "./doctor.js";
 import { AdapterError, formatAdapterError } from "./errors.js";
 import { runConfigWizard } from "./configWizard.js";
 import { createTranslator, DEFAULT_LANGUAGE, parseLanguage, resolveLanguage } from "./i18n.js";
-import { DEFAULT_TURNS, parseTurnsFlag, turnsOrDefault, validateTurns } from "./limits.js";
+import { DEFAULT_TURNS, parseTurnsFlag, turnsOrDefault } from "./limits.js";
 import { formatAgentPrompt } from "./prompt.js";
 import { runNewWizard } from "./new.js";
-import { listAgentsWithAvailability, listPresetNames, listPresetsWithAvailability, resolvePreset } from "./presets.js";
+import { listPresetNames, resolvePreset } from "./presets.js";
 import { listHistoryEntries } from "./history.js";
 import { createConsoleRenderer } from "./renderers/console.js";
 import { createNdjsonRenderer } from "./renderers/ndjson.js";
-import { createTuiRenderer, promptTuiAgentsWizard, promptTuiConfigCommand, promptTuiHomeTopic, promptTuiRolesWizard, renderTuiConfig, renderTuiHelp, renderTuiHistory, renderTuiHome, renderTuiUpdate } from "./renderers/tui.js";
+import { createTuiRenderer, promptTuiHomeTopic, renderTuiHelp, renderTuiHistory, renderTuiHome, renderTuiUpdate } from "./renderers/tui.js";
 import { MAX_ASK_AGENTS, runAsk, runDebate } from "./orchestrator.js";
 import { writeDebateMarkdown } from "./output.js";
-import { applySourceUpdate, formatUpdateInstructions, getUpdateInfo } from "./update.js";
-import { createSessionContext } from "./session.js";
+import { formatUpdateInstructions, getUpdateInfo } from "./update.js";
 import { getStringListFlag, parseArgs } from "./args.js";
-import { askAgentSeedsForMode, clearTuiRunOverrides } from "./tuiState.js";
-import { detectedAgentNames, detectionForCommand, isRetiredAgentName } from "./agentRegistry.js";
-import { configuredOllamaTargets, DEFAULT_OLLAMA_BASE_URL, normalizeOllamaBaseUrl, OllamaUrlError, resolveOllamaBaseUrl } from "./ollamaUrl.js";
+import { clearTuiRunOverrides } from "./tuiState.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";
+import { runHistoryCommand } from "./commands/history.js";
+import { runInitCommand } from "./commands/init.js";
+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 { 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);
@@ -65,42 +77,11 @@ async function main() {
         return;
     }
     if (parsed.command === "update") {
-        const info = await getUpdateInfo(await getPackageVersion());
-        const updateConfigPath = optionalString(parsed.flags.config) ?? await resolveDefaultConfigPath();
-        const updateConfig = await configExists(updateConfigPath)
-            ? await loadConfig(updateConfigPath)
-            : undefined;
-        const updateLanguage = resolveLanguage({
-            explicitLanguage: optionalString(parsed.flags.language),
-            configLanguage: updateConfig?.language
-        });
-        const updateMessages = createTranslator(updateLanguage);
-        if (parsed.flags.apply) {
-            await applySourceUpdate(info, updateMessages);
-            console.log(updateMessages.update.upToDate);
-            return;
-        }
-        console.log(formatUpdateInstructions(info, updateMessages));
+        await runUpdateCommand(parsed.flags);
         return;
     }
     if (parsed.command === "init" || parsed.command === "setup") {
-        const initConfigPath = optionalString(parsed.flags.config) ?? (parsed.flags.local ? DEFAULT_CONFIG_PATH : GLOBAL_CONFIG_PATH);
-        if (await configExists(initConfigPath)) {
-            console.log(startupMessages.init.configExists(initConfigPath));
-            return;
-        }
-        const discovery = await discoverLocalTools({
-            ollamaUrl: optionalString(parsed.flags["ollama-url"])
-        });
-        const config = createConfigFromDiscovery(discovery);
-        config.language = resolveLanguage({
-            explicitLanguage: optionalString(parsed.flags.language),
-            configLanguage: config.language
-        });
-        const initMessages = createTranslator(config.language);
-        await writeExampleConfig(initConfigPath, config);
-        console.log(initMessages.init.configCreated(initConfigPath));
-        printInitDiscovery(discovery, config, initMessages);
+        await runInitCommand(parsed.flags);
         return;
     }
     const configPath = optionalString(parsed.flags.config) ?? await resolveDefaultConfigPath();
@@ -115,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;
@@ -138,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([
@@ -283,35 +280,15 @@ async function main() {
         if (!topic) {
             throw new Error(messages.common.topicRequired);
         }
-        const mode = parseModeFlag(optionalString(parsed.flags.mode) ?? config.defaults?.mode, messages);
-        const explicitAskAgents = getStringListFlag(parsed.flags.agents);
-        const askAgentSeeds = askAgentSeedsForMode(mode, explicitAskAgents, config.defaults?.askAgents);
-        const agentA = resolveAgentName("agent A", parsed.flags["agent-a"], preset?.agentA, askAgentSeeds[0] ?? config.defaults?.agentA, messages);
-        const agentB = resolveAgentName("agent B", parsed.flags["agent-b"], preset?.agentB, askAgentSeeds[1] ?? askAgentSeeds[0] ?? config.defaults?.agentB, messages);
-        const askAgents = mode === "ask" ? resolveAskAgents(explicitAskAgents, config.defaults?.askAgents, [agentA, agentB], messages) : undefined;
-        const options = {
-            mode,
+        const options = resolveRunOptions({
+            flags: parsed.flags,
+            config,
             language,
             topic,
-            agentA,
-            agentB,
-            askAgents,
-            turns: parseTurnsFlag(parsed.flags.turns, config.defaults?.turns ?? DEFAULT_TURNS, "--turns", messages),
-            session: createSessionContext(),
             files: context.files,
-            modelA: optionalString(parsed.flags["model-a"]),
-            modelB: optionalString(parsed.flags["model-b"]),
-            ollamaUrl: optionalString(parsed.flags["ollama-url"])
-                ? normalizeOllamaBaseUrl(optionalString(parsed.flags["ollama-url"]))
-                : undefined,
-            pullModels: Boolean(parsed.flags["pull-models"]),
-            summaryAgent: resolveSummaryAgentOption(parsed.flags["summary-agent"], config.defaults, mode),
-            summaryModel: optionalString(parsed.flags["summary-model"]),
-            summaryEnabled: !parsed.flags["no-summary"],
-            earlyStopOnAgreement: !parsed.flags["no-early-stop"],
-            plainOutput: Boolean(parsed.flags.plain || parsed.flags.terminal),
+            preset,
             signal: debateAbortSignal()
-        };
+        }, messages);
         if (parsed.flags["show-prompt"]) {
             printContextWarnings(context.warnings, messages);
             printPromptPreview(config, options, language, messages);
@@ -332,7 +309,7 @@ async function main() {
         if (!stayInTuiAfterSession) {
             return;
         }
-        tuiMode = mode;
+        tuiMode = options.mode;
         for (;;) {
             const nextInput = await promptTuiHomeTopic(tuiMode, messages, { notice: tuiNotice });
             tuiNotice = undefined;
@@ -353,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 = () => {
@@ -364,39 +342,6 @@ function debateAbortSignal() {
     process.once("SIGTERM", abort);
     return controller.signal;
 }
-/**
- * Exécute la commande `agents` : charge la config et affiche les agents déclarés avec leur état de détection.
- * @param flags - Flags parsés depuis la ligne de commande.
- */
-async function runAgentsCommand(flags) {
-    const configPath = optionalString(flags.config) ?? await resolveDefaultConfigPath();
-    if (!(await configExists(configPath))) {
-        const messages = createTranslator(resolveLanguage({ explicitLanguage: optionalString(flags.language) }));
-        throw new Error(messages.agents.noConfig);
-    }
-    const config = await loadConfig(configPath);
-    const language = resolveLanguage({
-        explicitLanguage: optionalString(flags.language),
-        configLanguage: config.language
-    });
-    const messages = createTranslator(language);
-    const discovery = await discoverLocalToolsForConfig(config, optionalString(flags["ollama-url"]));
-    if (flags.json) {
-        const fallbackAskAgents = [config.defaults?.agentA, config.defaults?.agentB]
-            .filter((name) => typeof name === "string" && !isRetiredAgentName(name));
-        process.stdout.write(JSON.stringify({
-            v: 1,
-            agents: listAgentsWithAvailability(config, discovery, messages),
-            defaults: {
-                askAgents: config.defaults?.askAgents?.length
-                    ? config.defaults.askAgents.filter((name) => !isRetiredAgentName(name))
-                    : fallbackAskAgents
-            }
-        }) + "\n");
-        return;
-    }
-    printAgents(configPath, config, discovery, messages);
-}
 /**
  * Exécute la commande `config` : wizard interactif ou mise à jour directe des paramètres par défaut.
  * @param flags - Flags parsés depuis la ligne de commande.
@@ -406,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;
     }
@@ -417,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"]);
@@ -436,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));
@@ -505,395 +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 runTuiConfigLoop(configPath, config, messages, initialMode) {
-    let mode = initialMode;
-    let notice;
-    let currentMessages = messages;
-    let changedRunDefaults = false;
-    for (;;) {
-        renderTuiConfig(config, configPath, mode, currentMessages, { message: notice });
-        notice = undefined;
-        const input = await promptTuiConfigCommand(mode, currentMessages);
-        if (input.kind === "quit") {
-            return { mode, quit: true, changedRunDefaults };
-        }
-        if (input.kind === "back") {
-            return { mode, quit: false, changedRunDefaults };
-        }
-        if (input.kind === "unknown") {
-            notice = input.message;
-            continue;
-        }
-        if (input.kind === "mode") {
-            mode = mode === "ask" ? "debate" : "ask";
-            config.defaults = { ...(config.defaults ?? {}), mode };
-            await writeExampleConfig(configPath, config);
-            changedRunDefaults = true;
-            notice = mode === "ask" ? currentMessages.tui.askDefaultMode : currentMessages.tui.debateDefaultMode;
-            continue;
-        }
-        if (input.kind === "default-mode") {
-            config.defaults = { ...(config.defaults ?? {}), mode };
-            await writeExampleConfig(configPath, config);
-            changedRunDefaults = true;
-            notice = mode === "ask" ? currentMessages.tui.askDefaultMode : currentMessages.tui.debateDefaultMode;
-            continue;
-        }
-        if (input.kind === "interface") {
-            config.defaults = { ...(config.defaults ?? {}), interface: input.interfaceName };
-            await writeExampleConfig(configPath, config);
-            notice = currentMessages.tui.interfaceDefault(input.interfaceName);
-            continue;
-        }
-        if (input.kind === "language") {
-            config.language = parseLanguage(input.language, "--language");
-            await writeExampleConfig(configPath, config);
-            currentMessages = createTranslator(config.language ?? DEFAULT_LANGUAGE);
-            notice = currentMessages.tui.languageUpdated(input.language);
-            continue;
-        }
-        if (input.kind === "agents") {
-            try {
-                const agentsInput = input.agents.length > 0
-                    ? { kind: "agents", agents: input.agents }
-                    : await promptTuiAgentsWizard(config, mode, currentMessages);
-                if (agentsInput.kind === "quit") {
-                    return { mode, quit: true, changedRunDefaults };
-                }
-                if (agentsInput.kind === "back" || agentsInput.agents.length === 0) {
-                    notice = currentMessages.tui.agentsUnchanged;
-                    continue;
-                }
-                if (mode === "ask") {
-                    const agents = normalizeTuiAskAgents(config, agentsInput.agents, currentMessages);
-                    config.defaults = { ...(config.defaults ?? {}), askAgents: agents };
-                    await writeExampleConfig(configPath, config);
-                    changedRunDefaults = true;
-                    notice = currentMessages.tui.askAgentsUpdated(agents.join(", "));
-                }
-                else {
-                    const [agentA, agentB] = normalizeTuiDebateAgents(config, agentsInput.agents, currentMessages);
-                    config.defaults = { ...(config.defaults ?? {}), agentA, agentB };
-                    await writeExampleConfig(configPath, config);
-                    changedRunDefaults = true;
-                    notice = currentMessages.tui.debateAgentsUpdated(`${agentA} <-> ${agentB}`);
-                }
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-        if (input.kind === "roles") {
-            try {
-                const rolesInput = input.roles.length > 0
-                    ? { kind: "roles", roles: input.roles }
-                    : await promptTuiRolesWizard(config, mode, currentMessages);
-                if (rolesInput.kind === "quit") {
-                    return { mode, quit: true, changedRunDefaults };
-                }
-                if (rolesInput.kind === "back" || rolesInput.roles.length === 0) {
-                    notice = currentMessages.tui.rolesUnchanged;
-                    continue;
-                }
-                notice = applyTuiRoles(config, mode, rolesInput.roles, currentMessages);
-                await writeExampleConfig(configPath, config);
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-        if (input.kind === "turns") {
-            if (mode === "ask") {
-                notice = currentMessages.tui.askTurnsNotice;
-                continue;
-            }
-            try {
-                validateTurns(input.turns, "--turns", currentMessages);
-                config.defaults = { ...(config.defaults ?? {}), turns: input.turns };
-                await writeExampleConfig(configPath, config);
-                changedRunDefaults = true;
-                notice = currentMessages.tui.turnsUpdated(input.turns);
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-        if (input.kind === "summary") {
-            try {
-                const nextDefaults = { ...(config.defaults ?? {}) };
-                if (input.agent !== undefined) {
-                    assertKnownAgent(config, input.agent, mode === "ask" ? "defaults.askSummaryAgent" : "defaults.summaryAgent", currentMessages);
-                }
-                if (mode === "ask") {
-                    if (input.agent === undefined) {
-                        delete nextDefaults.askSummaryAgent;
-                        notice = currentMessages.tui.askSummaryFallback;
-                    }
-                    else {
-                        nextDefaults.askSummaryAgent = input.agent;
-                        notice = currentMessages.tui.askSummaryAgent(input.agent);
-                    }
-                }
-                else if (input.agent === undefined) {
-                    delete nextDefaults.summaryAgent;
-                    notice = currentMessages.tui.debateSummaryFallback;
-                }
-                else {
-                    nextDefaults.summaryAgent = input.agent;
-                    notice = currentMessages.tui.debateSummaryAgent(input.agent);
-                }
-                config.defaults = nextDefaults;
-                await writeExampleConfig(configPath, config);
-                changedRunDefaults = true;
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-        if (input.kind === "ollama-info") {
-            try {
-                notice = await formatTuiOllamaInfo(config, currentMessages);
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-        if (input.kind === "ollama-url") {
-            try {
-                notice = await setTuiOllamaUrl(configPath, config, input.url, currentMessages);
-                changedRunDefaults = true;
-            }
-            catch (error) {
-                notice = formatRuntimeError(error, currentMessages);
-            }
-            continue;
-        }
-        if (input.kind === "ollama-model") {
-            try {
-                notice = await setTuiOllamaModel(configPath, config, input.model, currentMessages);
-                changedRunDefaults = true;
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-        if (input.kind === "ollama-sync") {
-            try {
-                notice = await syncTuiOllamaModel(configPath, config, currentMessages);
-                changedRunDefaults = true;
-            }
-            catch (error) {
-                notice = error instanceof Error ? error.message : String(error);
-            }
-            continue;
-        }
-    }
-}
-async function setTuiOllamaUrl(configPath, config, value, messages) {
-    if (!Object.values(config.agents).some((agent) => agent.type === "ollama")) {
-        throw new Error(messages.config.ollamaModelNoAgent);
-    }
-    const normalized = isDefaultOllamaUrl(value)
-        ? DEFAULT_OLLAMA_BASE_URL
-        : normalizeOllamaBaseUrl(value);
-    const effective = resolveOllamaBaseUrl({ configUrl: normalized });
-    setOllamaBaseUrl(config, normalized);
-    await writeExampleConfig(configPath, config);
-    return messages.tui.ollamaUrlUpdated(normalized, effective);
-}
-function isDefaultOllamaUrl(value) {
-    return ["default", "defaut", "défaut", "local", "localhost"].includes(value.trim().toLowerCase());
-}
-async function formatTuiOllamaInfo(config, messages) {
-    const discovery = await discoverLocalToolsForConfig(config);
-    const agent = config.agents["ollama-local"];
-    if (agent?.type !== "ollama") {
-        throw new Error(messages.config.ollamaModelNoAgent);
-    }
-    if (!discovery.ollama.available) {
-        return messages.tui.ollamaUnavailable(discovery.ollama.baseUrl);
-    }
-    const installed = discovery.ollama.models.length > 0
-        ? discovery.ollama.models.join(", ")
-        : messages.config.ollamaModelNoInstalledModels;
-    const api = `${discovery.ollama.baseUrl}`;
-    return messages.tui.ollamaInfo(agent.model, installed, api);
-}
-async function setTuiOllamaModel(configPath, config, model, messages) {
-    const trimmed = model.trim();
-    if (!trimmed) {
-        throw new Error(messages.tui.ollamaModelUsage);
-    }
-    const discovery = await discoverLocalToolsForConfig(config);
-    const agent = config.agents["ollama-local"];
-    if (agent?.type !== "ollama") {
-        throw new Error(messages.config.ollamaModelNoAgent);
-    }
-    if (!discovery.ollama.models.includes(trimmed)) {
-        throw new Error(messages.config.ollamaModelUnavailable(trimmed));
-    }
-    const result = setOllamaModel(config, trimmed);
-    await writeExampleConfig(configPath, config);
-    return result
-        ? messages.config.ollamaModelUpdated(configPath, result.previousModel, result.nextModel)
-        : messages.config.ollamaModelNoChange(configPath, agent.model);
-}
-async function syncTuiOllamaModel(configPath, config, messages) {
-    const discovery = await discoverLocalToolsForConfig(config);
-    const agent = config.agents["ollama-local"];
-    if (agent?.type !== "ollama") {
-        throw new Error(messages.config.ollamaModelNoAgent);
-    }
-    if (discovery.ollama.models.length === 0) {
-        throw new Error(messages.config.ollamaModelNoInstalledModels);
-    }
-    const result = syncOllamaModel(config, discovery);
-    if (!result) {
-        return messages.config.ollamaModelNoChange(configPath, agent.model);
-    }
-    await writeExampleConfig(configPath, config);
-    return messages.config.ollamaModelUpdated(configPath, result.previousModel, result.nextModel);
-}
-async function syncInteractiveDetectedAgents(configPath, config) {
-    const discovery = await discoverLocalToolsForConfig(config);
-    const result = syncDetectedAgentsDetailed(config, discovery);
-    if (result.changed) {
-        await writeExampleConfig(configPath, config);
-    }
-    return {
-        addedAgents: result.addedAgents
-    };
-}
-function normalizeTuiDebateAgents(config, agents, messages) {
-    const unique = agents.map((agent) => agent.trim()).filter((agent, index, list) => agent && list.indexOf(agent) === index);
-    if (unique.length !== 2) {
-        throw new Error(messages.tui.debateAgentsUsage);
-    }
-    assertKnownAgent(config, unique[0], "defaults.agentA", messages);
-    assertKnownAgent(config, unique[1], "defaults.agentB", messages);
-    return [unique[0], unique[1]];
-}
-function normalizeTuiAskAgents(config, agents, messages) {
-    const unique = agents.map((agent) => agent.trim()).filter((agent, index, list) => agent && list.indexOf(agent) === index);
-    if (unique.length === 0) {
-        throw new Error(messages.tui.askAgentsUsage);
-    }
-    if (unique.length > MAX_ASK_AGENTS) {
-        throw new Error(messages.common.tooManyAskAgents(MAX_ASK_AGENTS));
-    }
-    unique.forEach((agent) => assertKnownAgent(config, agent, "defaults.askAgents", messages));
-    return unique;
-}
-async function runTuiAgentsWizard(configPath, config, messages, mode, inlineAgents = []) {
-    try {
-        const agentsInput = inlineAgents.length > 0
-            ? { kind: "agents", agents: inlineAgents }
-            : await promptTuiAgentsWizard(config, mode, messages);
-        if (agentsInput.kind === "quit") {
-            return { quit: true, changedRunDefaults: false };
-        }
-        if (agentsInput.kind === "back" || agentsInput.agents.length === 0) {
-            return { quit: false, changedRunDefaults: false };
-        }
-        const notice = applyTuiAgents(config, mode, agentsInput.agents, messages);
-        await writeExampleConfig(configPath, config);
-        return { notice, quit: false, changedRunDefaults: true };
-    }
-    catch (error) {
-        return { notice: messages.tui.agentsError(error instanceof Error ? error.message : String(error)), quit: false, changedRunDefaults: false };
-    }
-}
-async function runTuiRolesWizard(configPath, config, messages, mode, inlineRoles = []) {
-    try {
-        const rolesInput = inlineRoles.length > 0
-            ? { kind: "roles", roles: inlineRoles }
-            : await promptTuiRolesWizard(config, mode, messages);
-        if (rolesInput.kind === "quit") {
-            return { quit: true };
-        }
-        if (rolesInput.kind === "back" || rolesInput.roles.length === 0) {
-            return { quit: false };
-        }
-        const notice = applyTuiRoles(config, mode, rolesInput.roles, messages);
-        await writeExampleConfig(configPath, config);
-        return { notice, quit: false };
-    }
-    catch (error) {
-        return { notice: messages.tui.rolesError(error instanceof Error ? error.message : String(error)), quit: false };
-    }
-}
-function applyTuiAgents(config, mode, agentNames, messages) {
-    if (mode === "ask") {
-        const agents = normalizeTuiAskAgents(config, agentNames, messages);
-        config.defaults = { ...(config.defaults ?? {}), askAgents: agents };
-        return messages.tui.askAgentsUpdated(agents.join(", "));
-    }
-    const [agentA, agentB] = normalizeTuiDebateAgents(config, agentNames, messages);
-    config.defaults = { ...(config.defaults ?? {}), agentA, agentB };
-    return messages.tui.debateAgentsUpdated(`${agentA} <-> ${agentB}`);
-}
-function applyTuiRoles(config, mode, roleNames, messages) {
-    const agents = activeAgentsForMode(config, mode);
-    if (agents.length === 0) {
-        throw new Error(mode === "ask" ? messages.tui.noAskAgentsConfigured : messages.tui.noDebateAgentsConfigured);
-    }
-    const roles = normalizeTuiRoles(roleNames, agents, mode, messages);
-    agents.forEach((agent, index) => {
-        config.agents[agent].role = roles[index];
-    });
-    return mode === "ask"
-        ? messages.tui.askRolesUpdated(roles.join(", "))
-        : messages.tui.debateRolesUpdated(roles.join(" <-> "));
-}
-function activeAgentsForMode(config, mode) {
-    const defaults = config.defaults ?? {};
-    if (mode === "ask") {
-        if (defaults.askAgents && defaults.askAgents.length > 0) {
-            return defaults.askAgents.filter((agent) => Boolean(config.agents[agent]));
-        }
-        return [defaults.agentA, defaults.agentB].filter((agent) => Boolean(agent && config.agents[agent]));
-    }
-    return [defaults.agentA, defaults.agentB].filter((agent) => Boolean(agent && config.agents[agent]));
-}
-function normalizeTuiRoles(roleNames, agents, mode, messages) {
-    const roles = roleNames.map((role) => role.trim().toLowerCase()).filter(Boolean);
-    const expectedCount = agents.length;
-    if (roles.length < expectedCount) {
-        const agentLabel = mode === "ask"
-            ? agents.join(", ")
-            : agents.join(" <-> ");
-        throw new Error(messages.tui.rolesCountError(roles.length, expectedCount, agentLabel));
-    }
-    return roles.slice(0, expectedCount).map((role) => {
-        if (isAgentRole(role)) {
-            return role;
-        }
-        throw new Error(messages.tui.unknownRole(role, VALID_AGENT_ROLES.join(", ")));
-    });
-}
-function isAgentRole(value) {
-    return VALID_AGENT_ROLES.includes(value);
-}
-const VALID_AGENT_ROLES = ["implementer", "reviewer", "architect", "scout", "critic", "summarizer"];
-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;
@@ -910,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) {
@@ -928,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"];
@@ -947,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));
 }
 /**
@@ -965,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())
@@ -988,60 +579,6 @@ function assertKnownAgent(config, agentName, fieldName, messages) {
         throw new Error(messages.common.unknownAgentForField(fieldName, agentName, Object.keys(config.agents).join(", ")));
     }
 }
-/**
- * Résout le nom d'un agent selon la priorité : flag CLI > preset > défaut config.
- * Lève une erreur si aucune source ne fournit de valeur.
- * @param label - Libellé humain utilisé dans le message d'erreur (ex. "agent A").
- * @param explicitValue - Valeur passée via flag CLI.
- * @param presetValue - Valeur issue du preset sélectionné.
- * @param defaultValue - Valeur issue des défauts de la config.
- * @returns Nom de l'agent résolu.
- */
-function resolveAgentName(label, explicitValue, presetValue, defaultValue, messages) {
-    const resolved = optionalString(explicitValue) ?? presetValue ?? defaultValue;
-    if (!resolved) {
-        throw new Error(messages.common.noAgentDefined(label));
-    }
-    return resolved;
-}
-function resolveSummaryAgentOption(explicitValue, defaults, mode) {
-    const explicit = optionalString(explicitValue);
-    if (explicit) {
-        return explicit;
-    }
-    if (mode === "ask") {
-        return defaults?.askSummaryAgent ?? defaults?.summaryAgent;
-    }
-    return defaults?.summaryAgent;
-}
-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"));
-}
-function resolveAskAgents(explicitAgents, defaultAgents, fallbackAgents, messages) {
-    const selected = explicitAgents.length > 0
-        ? explicitAgents
-        : defaultAgents && defaultAgents.length > 0 ? defaultAgents : fallbackAgents;
-    const unique = selected.filter((agent, index) => agent.trim() && selected.indexOf(agent) === index);
-    if (unique.length > MAX_ASK_AGENTS) {
-        throw new Error(messages.common.tooManyAskAgents(MAX_ASK_AGENTS));
-    }
-    return unique;
-}
 /**
  * Affiche un aperçu du prompt du premier tour sans appeler aucun agent (flag `--show-prompt`).
  * @param config - Config chargée.
@@ -1071,29 +608,13 @@ function printPromptPreview(config, options, language, messages) {
     console.log(messages.preview.agent(previewAgent, agentConfig.role));
     console.log(messages.preview.peer(peerName));
     console.log(messages.preview.pullModels(options.pullModels));
-    console.log(messages.preview.summary(options.summaryEnabled ? previewSummaryAgent(options) : messages.preview.disabled));
+    console.log(messages.preview.summary(options.summaryEnabled ? options.summaryAgent : messages.preview.disabled));
     console.log(messages.preview.interfaceLanguage(language));
     console.log("");
     console.log(prompt);
     console.log("");
     console.log(options.mode === "ask" ? messages.preview.askNote : messages.preview.note);
 }
-function previewSummaryAgent(options) {
-    if (options.summaryAgent) {
-        return options.summaryAgent;
-    }
-    if (options.mode === "ask" && options.askAgents && options.askAgents.length > 0) {
-        return options.askAgents[options.askAgents.length - 1] ?? options.agentB;
-    }
-    return options.agentB;
-}
-/**
- * Extrait une chaîne non vide depuis une valeur de flag, ou renvoie `undefined`.
- * @param value - Valeur brute issue du parseur de flags.
- */
-function optionalString(value) {
-    return typeof value === "string" && value.trim() ? value : undefined;
-}
 /**
  * Pré-lit seulement `--language`/`--lang` dans les arguments bruts pour localiser
  * les erreurs qui peuvent survenir avant le parsing complet ou le chargement de config.
@@ -1144,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);
@@ -1161,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
@@ -1171,98 +695,6 @@ function shouldOpenTuiHome(parsed) {
         && parsed.flags.plain !== true
         && parsed.flags.terminal !== true;
 }
-/** Lance la discovery avec la même adresse Ollama effective que la config et les overrides globaux. */
-async function discoverLocalToolsForConfig(config, ollamaUrl) {
-    return discoverLocalTools({
-        ollamaUrl,
-        ollamaTargets: configuredOllamaTargets(config)
-    });
-}
-/**
- * Exécute la commande `palabre presets` en sortie humaine ou JSON versionné.
- */
-async function runPresetsCommand(flags) {
-    const configPath = optionalString(flags.config) ?? await resolveDefaultConfigPath();
-    const ollamaUrl = optionalString(flags["ollama-url"]);
-    const config = await configExists(configPath)
-        ? await loadConfig(configPath)
-        : undefined;
-    const discovery = config
-        ? await discoverLocalToolsForConfig(config, ollamaUrl)
-        : await discoverLocalTools({ ollamaUrl });
-    const resolvedConfig = config ?? createConfigFromDiscovery(discovery);
-    const language = resolveLanguage({
-        explicitLanguage: optionalString(flags.language),
-        configLanguage: resolvedConfig.language
-    });
-    const messages = createTranslator(language);
-    const presets = listPresetsWithAvailability(resolvedConfig, discovery, messages);
-    if (flags.json) {
-        process.stdout.write(JSON.stringify({ v: 1, presets }) + "\n");
-        return;
-    }
-    console.log(messages.presets.title);
-    console.log("");
-    for (const preset of presets) {
-        const status = preset.available
-            ? messages.presets.available
-            : messages.presets.unavailable(preset.unavailableReasons.join("; "));
-        console.log(`  ${preset.name.padEnd(20)} ${preset.agentA} <-> ${preset.agentB}  ${status}`);
-    }
-    console.log("");
-    console.log(messages.presets.total(presets.length));
-}
-async function runHistoryCommand(flags) {
-    const configPath = optionalString(flags.config) ?? await resolveDefaultConfigPath();
-    const config = await configExists(configPath)
-        ? await loadConfig(configPath)
-        : undefined;
-    const language = resolveLanguage({
-        explicitLanguage: optionalString(flags.language),
-        configLanguage: config?.language
-    });
-    const messages = createTranslator(language);
-    const entries = await listHistoryEntries(resolveOutputDir(config?.outputDir));
-    if (flags.json) {
-        process.stdout.write(JSON.stringify({ v: 1, history: entries }) + "\n");
-        return;
-    }
-    console.log(messages.tui.historyTitle);
-    console.log("");
-    if (entries.length === 0) {
-        console.log(messages.tui.historyEmpty);
-        return;
-    }
-    for (const entry of entries) {
-        console.log(`- ${entry.date || entry.fileName} | ${entry.mode} | ${entry.topic}`);
-        console.log(`  ${entry.path}`);
-    }
-}
-async function runContextCommand(flags, positionals) {
-    const language = resolveLanguage({ explicitLanguage: optionalString(flags.language) });
-    const messages = createTranslator(language);
-    const subcommand = positionals[0] ?? "scan";
-    if (subcommand !== "scan") {
-        throw new Error(messages.common.unknownCommand(`context ${subcommand}`, "context scan"));
-    }
-    const paths = positionals.slice(1);
-    const result = await buildContextScan(paths, process.cwd(), messages);
-    const folders = result.items.filter((item) => item.kind === "folder");
-    const files = result.items.filter((item) => item.kind === "file");
-    if (flags.json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
-    }
-    for (const folder of folders) {
-        console.log(`[folder] ${folder.path}`);
-    }
-    for (const file of files) {
-        console.log(`[file] ${file.path} (${file.sizeBytes} bytes)`);
-    }
-    for (const warning of result.warnings) {
-        console.error(`${messages.renderers.warningPrefix} ${warning}`);
-    }
-}
 /**
  * Écrit les avertissements de contexte sur `stderr`.
  * @param warnings - Messages d'avertissement issus du chargement des fichiers de contexte.
@@ -1272,157 +704,16 @@ function printContextWarnings(warnings, messages) {
         process.stderr.write(`${messages.renderers.warningPrefix} ${warning}\n`);
     }
 }
-/**
- * Ajoute dans `config.agents` les agents détectés localement mais absents de la config.
- * Mute `config` directement ; l'appelant est responsable de persister la config.
- * @param config - Config Palabre à compléter.
- * @param discovery - Résultat de la découverte locale des outils.
- * @returns Noms des agents nouvellement ajoutés.
- */
-/**
- * Affiche la liste des agents déclarés avec leur type, rôle, état de détection et défauts.
- * @param configPath - Chemin du fichier de config (affiché en en-tête).
- * @param config - Config Palabre chargée.
- * @param discovery - Résultat de la découverte locale des outils.
- */
-function printAgents(configPath, config, discovery, messages) {
-    const entries = Object.entries(config.agents)
-        .filter(([name]) => !isRetiredAgentName(name))
-        .sort(([left], [right]) => left.localeCompare(right));
-    console.log(messages.agents.config(configPath));
-    console.log("");
-    console.log(messages.agents.title);
-    for (const [name, agentConfig] of entries) {
-        const status = formatAgentDetection(name, agentConfig, discovery, messages);
-        const defaults = formatAgentDefaults(name, config, messages);
-        const details = formatAgentDetails(agentConfig, messages);
-        const suffix = defaults ? ` | ${defaults}` : "";
-        console.log(`- ${name.padEnd(13)} ${`${agentConfig.type}/${agentConfig.role}`.padEnd(18)} ${status}${suffix}`);
-        if (details) {
-            console.log(`  ${details}`);
-        }
-    }
-    console.log("");
-    console.log(messages.agents.defaults(config.defaults?.agentA ?? messages.agents.none, config.defaults?.agentB ?? messages.agents.none, turnsOrDefault(config.defaults?.turns), config.defaults?.summaryAgent ?? messages.agents.summaryAgentB, config.defaults?.askSummaryAgent));
-}
-/**
- * Renvoie un libellé indiquant si l'agent est agent A, agent B ou agent de synthèse par défaut.
- * @param name - Nom de l'agent.
- * @param config - Config Palabre contenant les défauts.
- */
-function formatAgentDefaults(name, config, messages) {
-    const labels = [];
-    if (config.defaults?.agentA === name)
-        labels.push(messages.agents.defaultAgentA);
-    if (config.defaults?.agentB === name)
-        labels.push(messages.agents.defaultAgentB);
-    if (config.defaults?.summaryAgent === name)
-        labels.push(messages.agents.defaultSummary);
-    if (config.defaults?.askSummaryAgent === name)
-        labels.push(messages.agents.defaultAskSummary);
-    return labels.join(", ");
-}
-/**
- * Renvoie une ligne de détails pour un agent : commande CLI ou modèle Ollama.
- * @param agentConfig - Configuration de l'agent.
- */
-function formatAgentDetails(agentConfig, messages) {
-    if (agentConfig.type === "ollama") {
-        return messages.agents.model(agentConfig.model);
-    }
-    return messages.agents.command(agentConfig.command, agentConfig.model);
-}
-/**
- * Renvoie le statut de détection d'un agent sous forme de chaîne lisible.
- * Pour Ollama, vérifie la disponibilité du serveur et la présence du modèle.
- * @param name - Nom de l'agent dans la config.
- * @param agentConfig - Configuration de l'agent.
- * @param discovery - Résultat de la découverte locale des outils.
- */
-function formatAgentDetection(name, agentConfig, discovery, messages) {
-    if (agentConfig.type === "ollama") {
-        if (!discovery.ollama.available) {
-            return discovery.ollama.commandAvailable ? messages.agents.ollamaUnreachable : messages.agents.ollamaNotDetected;
-        }
-        return discovery.ollama.models.includes(agentConfig.model)
-            ? messages.agents.detected()
-            : messages.agents.missingModel(agentConfig.model);
-    }
-    const detection = cliDetectionForAgent(name, agentConfig, discovery);
-    return detection.available ? messages.agents.detected(detection.command) : messages.agents.notDetected;
-}
-/**
- * Résout l'entrée de détection correspondant à un agent CLI.
- * Renvoie un objet `{ available: true }` pour les agents CLI non reconnus (considérés disponibles).
- * @param name - Nom de l'agent dans la config.
- * @param agentConfig - Configuration de l'agent.
- * @param discovery - Résultat de la découverte locale des outils.
- */
-function cliDetectionForAgent(name, agentConfig, discovery) {
-    const command = agentConfig.type === "cli" || agentConfig.type === "cli-pty" ? agentConfig.command : name;
-    return detectionForCommand(command, discovery) ?? { available: true, command };
-}
-/**
- * Affiche le récapitulatif de détection locale après `palabre init`.
- * @param discovery - Résultat de la découverte locale des outils.
- * @param config - Config générée à partir de la découverte.
- */
-function printInitDiscovery(discovery, config, messages) {
-    console.log("");
-    console.log(messages.init.localDetectionTitle);
-    console.log(`- Codex CLI: ${formatCommandDetection(discovery.codex, messages)}`);
-    console.log(`- Claude CLI: ${formatCommandDetection(discovery.claude, messages)}`);
-    console.log(`- Antigravity CLI: ${formatCommandDetection(discovery.antigravity, messages)}`);
-    console.log(`- OpenCode CLI: ${formatCommandDetection(discovery.opencode, messages)}`);
-    console.log(`- Mistral Vibe CLI: ${formatCommandDetection(discovery.vibe, messages)}`);
-    console.log(`- Ollama API: ${formatOllamaDetection(discovery.ollama, messages)}`);
-    console.log("");
-    console.log(config.defaults?.agentA && config.defaults.agentB
-        ? messages.init.defaults(config.defaults.agentA, config.defaults.agentB)
-        : messages.init.noDefaultPair(formatDetectedAgentSummary(discovery, config.language ?? DEFAULT_LANGUAGE)));
-    console.log(messages.init.languageHint(config.language ?? DEFAULT_LANGUAGE));
-}
-function formatDetectedAgentSummary(discovery, language) {
-    const names = detectedAgentNames(discovery);
-    if (names.length === 0) {
-        return language === "en" ? "no agent detected" : "aucun agent détecté";
-    }
-    if (names.length === 1) {
-        return language === "en"
-            ? `only one agent detected (${names[0]})`
-            : `un seul agent détecté (${names[0]})`;
-    }
-    return language === "en"
-        ? `no usable pair detected among ${names.join(", ")}`
-        : `aucune paire utilisable détectée parmi ${names.join(", ")}`;
-}
-/**
- * Formate le statut de détection d'un outil CLI (disponible ou non).
- * @param detection - Résultat de détection d'un outil CLI.
- */
-function formatCommandDetection(detection, messages) {
-    return detection.available
-        ? messages.init.commandDetected(detection.command)
-        : messages.init.commandMissing;
-}
-/**
- * Formate le statut de détection d'Ollama : commande absente, serveur injoignable ou modèles disponibles.
- * @param detection - Résultat de détection d'Ollama.
- */
-function formatOllamaDetection(detection, messages) {
-    if (!detection.available) {
-        return detection.commandAvailable
-            ? messages.init.ollamaServerUnreachable(detection.baseUrl)
-            : messages.init.ollamaMissing;
-    }
-    const modelCount = detection.models.length;
-    return messages.init.ollamaDetected(modelCount);
-}
 /** Affiche le texte d'aide complet sur `stdout`. */
 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;
@@ -1450,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);
 }
@@ -1470,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) });