@dotdrelle/wiki-manager 0.15.34 → 0.15.38

package/src/shell/repl.js

@@ -9,12 +9,13 @@ import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
 import { buildAgentSystemPrompt, formatLlmUnavailableMessage, isOrchestrationBypassTool } from '../agent/graph.js';
 import { handleSlashCommand, rawCommandAgentPrompt } from '../commands/slash.js';
-import { serviceDescription, serviceNames as composeServiceNames } from '../core/compose.js';
+import { serviceChoices as composeServiceChoices, serviceDescription } from '../core/compose.js';
 import { extractActivity, parseJsonText, sessionActivities } from '../core/activity.js';
 import { syncActivitiesToPlan } from '../core/plan.js';
 import { buildLlmTools, callMcpTool, formatMcpToolResult, parseToolCallName, resolveToolCallName } from '../core/mcp.js';
 import { runBoundedToolLoop } from '../core/toolLoop.js';
 import { createAgentEvent, dispatchAgentEvent } from '../core/agentEvents.js';
+import { togglableAgentNames } from '../core/agentsCompose.js';
 import { listSkills } from '../core/skills.js';
 import { listWikircProfiles } from '../core/wikirc.js';
 import { listWorkspaces } from '../core/workspaces.js';
@@ -78,7 +79,7 @@ const COMMAND_COMPLETION_DESCRIPTIONS = {
   '/stop': 'Stop one service or the workspace service set.',
   '/logs': 'Show recent logs for a service.',
   '/mcp': 'Inspect or call workspace MCP servers.',
-  '/connector': 'List connectors or authorize one — /connector auth <connector>.',
+  '/connector': 'List connectors, or authorize one with all its rights — /connector auth google.',
   '/wiki': 'Run llm-wiki commands for the active workspace.',
   '/skills': 'List workspace skills.',
   '/upload': 'Upload a document — /upload <path>',
@@ -168,11 +169,34 @@ export function conversationKey(session) {
   return session.workspace || GLOBAL_CONVERSATION_KEY;
 }
 
+/**
+ * Horodate un message au moment où il entre dans la conversation.
+ *
+ * Posé sur le `push` du tableau plutôt qu'aux trente-deux endroits qui créent
+ * un message : un seul de ces endroits oublié, et la ligne perdrait son heure
+ * sans que rien ne le signale. Un message qui porte déjà `at` — rejoué depuis
+ * l'historique, par exemple — garde le sien.
+ */
+function stampConversation(messages) {
+  if (messages.__stamped) return messages;
+  Object.defineProperty(messages, '__stamped', { value: true });
+  const push = messages.push.bind(messages);
+  Object.defineProperty(messages, 'push', {
+    value: (...entries) =>
+      push(...entries.map((entry) =>
+        entry && typeof entry === 'object' && entry.at === undefined
+          ? Object.assign(entry, { at: Date.now() })
+          : entry,
+      )),
+  });
+  return messages;
+}
+
 export function conversationMessages(session) {
   const key = conversationKey(session);
   session.conversations ??= { [GLOBAL_CONVERSATION_KEY]: [] };
   session.conversations[key] ??= [];
-  return session.conversations[key];
+  return stampConversation(session.conversations[key]);
 }
 
 // Ordered from verifiable to hopeful. Mirrors tui.tsx's clipboardCommands():
@@ -256,8 +280,19 @@ function wikircProfileNames(session) {
     : [];
 }
 
-function serviceNames() {
-  return composeServiceNames();
+function serviceChoices() {
+  return composeServiceChoices();
+}
+
+/**
+ * Agents proposés un par un, en plus du raccourci `agents`.
+ *
+ * Seulement ceux derrière un drapeau de profil. Lister tous les agents avait
+ * rallongé la liste de quatre entrées, dont `mailer` qui n'existe même pas tant
+ * que l'opérateur ne l'a pas décommenté dans son override.
+ */
+function togglableAgents() {
+  return togglableAgentNames();
 }
 
 function skillNames(session) {
@@ -282,6 +317,11 @@ function completionValuesFor(parts, inputBuffer, session) {
   if (command === '/mcp' && parts[1] === 'call' && tokenIndex === 3) return mcpToolNames(session, parts[2]);
   if (command === '/connector' && tokenIndex === 1) return ['auth', 'list'];
   if (command === '/connector' && previousToken === 'auth') return ['google'];
+  // Pas de complétion des droits après le connecteur. `/connector auth google`
+  // demande déjà tout ce que l'agent sait faire, en une autorisation : proposer
+  // une liste laissait croire qu'il fallait choisir, et transformait une
+  // commande à taper d'un trait en menu à trois entrées. Les droits restent
+  // saisissables un par un pour restreindre, et le libellé de /connector le dit.
   if (command === '/upload' && tokenIndex === 1) return ['convert'];
   if (command === '/upload' && parts[1] === 'convert' && tokenIndex === 2) return ['pending'];
   if (command === '/uploads' && tokenIndex === 1) return ['clean', 'list'];
@@ -301,9 +341,11 @@ function completionValuesFor(parts, inputBuffer, session) {
   if (command === '/wiki' && tokenIndex === 1) return ['run'];
   if (command === '/skills' && tokenIndex === 1) return ['edit', 'list', 'run', 'show'];
   if (command === '/skills' && ['edit', 'run', 'show'].includes(previousToken ?? '')) return skillNames(session);
-  if (command === '/start' && tokenIndex === 1) return ['all', 'agents', 'services', ...serviceNames()];
-  if (command === '/stop' && tokenIndex === 1) return ['agents', ...serviceNames()];
-  if (command === '/logs' && tokenIndex === 1) return serviceNames();
+  // Vocabulaire de l'opérateur uniquement : `serviceChoices()` écarte les noms
+  // Compose bruts que les alias désignent déjà. Ils restent tapables.
+  if (command === '/start' && tokenIndex === 1) return ['all', 'agents', 'services', ...serviceChoices(), ...togglableAgents()];
+  if (command === '/stop' && tokenIndex === 1) return ['all', 'agents', 'services', ...serviceChoices(), ...togglableAgents()];
+  if (command === '/logs' && tokenIndex === 1) return ['all', ...serviceChoices()];
   return [];
 }
 
@@ -533,12 +575,19 @@ export function completionDescription(value, parts) {
   if (subcommand) return subcommand;
   if (command === '/use') return 'Load this workspace.';
   if (command === '/start') {
-    if (value === 'all') return 'Start the workspace services AND the external agents.';
-    if (value === 'agents' || value === 'agent') return 'Start the external agents only.';
-    if (value === 'services') return 'Start the workspace services only.';
+    if (value === 'all') return 'Everything: workspace services AND external agents.';
+    if (value === 'agents' || value === 'agent') return 'External agents only (CME, documents, connectors…).';
+    if (value === 'services') return 'Workspace services only, without the external agents.';
+    if (togglableAgents().includes(value)) return `Start only the ${value} agent, leaving the other agents as they are.`;
     return serviceDescription(value) ?? 'Start this Docker Compose service.';
   }
-  if (command === '/stop') return serviceDescription(value) ?? 'Stop this Docker Compose service.';
+  if (command === '/stop') {
+    if (value === 'all') return 'Everything: workspace services AND external agents.';
+    if (value === 'agents' || value === 'agent') return 'External agents only.';
+    if (value === 'services') return 'Workspace services only.';
+    if (togglableAgents().includes(value)) return `Stop only the ${value} agent, leaving the other agents running.`;
+    return serviceDescription(value) ?? 'Stop this Docker Compose service.';
+  }
   if (command === '/logs') return serviceDescription(value) ?? 'Show logs for this Docker Compose service.';
   if (command === '/workspace') {
     if (parts[1] === 'delete' && value === '--confirm') return 'Confirm workspace deletion.';

package/src/shell/repl.test.js

@@ -31,28 +31,50 @@ test('ShellUI inserts StyledText as a child instead of stringifying it through c
   assert.match(source, /<text[^>]*>\{styledSegments\(line\.segments\)\}<\/text>/);
 });
 
-test('ShellUI renders the user header full-width before constraining only its body', async () => {
+test('every message line carries its speaker gutter, and no full-width rule', async () => {
   const source = await readFile(new URL('./LeftPane.tsx', import.meta.url), 'utf8');
-  const headerBranch = source.indexOf("line.copyContent !== undefined ? (");
-  const userBodyBranch = source.indexOf("line.role === 'user' && line.userBubbleWidth ? (", headerBranch);
-  assert.ok(headerBranch >= 0 && userBodyBranch > headerBranch);
-  assert.match(source, /const userBubbleWidth = message\.role === 'user'/);
-  assert.match(source, /Math\.floor\(columns \* 0\.6\)/);
-  assert.doesNotMatch(source, /Math\.floor\(columns \* 0\.5\)/);
-  assert.match(source.slice(userBodyBranch), /width=\{line\.userBubbleWidth\}/);
-  assert.match(source.slice(userBodyBranch), /justifyContent="flex-start"/);
-  assert.doesNotMatch(source.slice(userBodyBranch, source.indexOf(') : line.status ?', userBodyBranch)), /#12263A/);
-  assert.doesNotMatch(source, /messageHeaderSegments\(message\.role, contentColumns\)/);
-  assert.match(source, /messageHeaderSegments\(message\.role, columns\)/);
+  // Le filet pleine largeur ouvrait chaque message : l'élément le plus encré de
+  // l'écran, répété à chaque tour, et qui séparait au lieu de grouper. La
+  // gouttière dit la même chose — à qui est le tour, où le bloc commence et où
+  // il finit — pour un caractère par ligne.
+  assert.match(source, /const GUTTER = '▌ ';/);
+  assert.match(source, /function withGutter\(/);
+  assert.match(source, /renderedBody\.map\(\(line\) => withGutter\(line, message\.role\)\)/);
+  assert.doesNotMatch(source, /'─'\.repeat\(rightLength\)/);
+
+  // La bulle alignée à droite repliait les messages utilisateur à 60 % de la
+  // largeur : phrases coupées en plein milieu, et deux colonnes de lecture
+  // selon le locuteur.
+  assert.doesNotMatch(source, /userBubbleWidth\s*=/);
+  assert.doesNotMatch(source, /Math\.floor\(columns \* 0\.6\)/);
+  assert.match(source, /const contentColumns = Math\.max\(12, columns - GUTTER\.length\)/);
 });
 
-test('ShellUI exposes copy without a reply or redo action', async () => {
+test('the header carries the clock and the copy action, pushed to the right edge', async () => {
   const source = await readFile(new URL('./LeftPane.tsx', import.meta.url), 'utf8');
-  assert.match(source, /const COPY_BTN = ' \[ copy \]';/);
+  assert.match(source, /const COPY_BTN = '  copy';/);
+  assert.match(source, /messageHeaderSegments\(message\.role, columns, message\.at\)/);
+  // Le remplissage pousse `copy` au bord droit au lieu de le coller au libellé.
+  assert.match(source, /const pad = Math\.max\(1, columns - used - COPY_BTN\.length\)/);
   assert.doesNotMatch(source, /\[\s*(?:reply|redo)\s*\]/i);
   assert.doesNotMatch(source, /onRedo|redoContent|redoIndex|REDO_BTN/);
 });
 
+test('a message is stamped once, when it enters the conversation', async () => {
+  const { conversationMessages } = await import('./repl.js');
+  const session = { workspace: null };
+  const messages = conversationMessages(session);
+  // Posé sur le `push` du tableau : trente-deux endroits créent un message, et
+  // un seul oublié perdrait son heure sans que rien ne le signale.
+  messages.push({ role: 'user', content: 'bonjour' });
+  assert.ok(Number.isFinite(messages[0].at));
+  // Un message qui porte déjà son heure garde la sienne.
+  messages.push({ role: 'donna', content: 'rejoué', at: 42 });
+  assert.equal(messages[1].at, 42);
+  // Et le tableau n'est instrumenté qu'une fois.
+  assert.equal(conversationMessages(session), messages);
+});
+
 test('redo translates the local thread index into a runtime conversation index', async () => {
   const session = await readFile(new URL('./useSession.ts', import.meta.url), 'utf8');
   const redo = session.slice(
@@ -559,7 +581,10 @@ test('/agent <question> submits one runtime request and remains in chat mode', a
     assert.equal(session.chatMode, true);
     assert.equal(result.oneShotAgent, true);
     assert.equal(result.runtimeOutcome.kind, 'accepted');
-    assert.deepEqual(conversationMessages(session), [{ role: 'user', content: 'lance ingestion', _pending: true }]);
+    assert.deepEqual(
+      conversationMessages(session).map(({ at, ...rest }) => rest),
+      [{ role: 'user', content: 'lance ingestion', _pending: true }],
+    );
   } finally {
     restore();
   }
@@ -658,10 +683,14 @@ test('agent mode without runtime records a visible error instead of falling back
   const message = recordRuntimeUnavailableAgentInput(session, 'salut', { error: 'port 7788 already in use' });
 
   assert.equal(message, '⚠ Runtime indisponible : port 7788 already in use — /agent désactivé, /chat reste possible');
-  assert.deepEqual(conversationMessages(session), [
-    { role: 'user', content: 'salut' },
-    { role: 'command', content: message },
-  ]);
+  // `at` est posé à l'insertion : on compare le reste.
+  assert.deepEqual(
+    conversationMessages(session).map(({ at, ...rest }) => rest),
+    [
+      { role: 'user', content: 'salut' },
+      { role: 'command', content: message },
+    ],
+  );
 });
 
 test('runtime status exposes the disconnected reason', () => {

package/src/shell/setupWizardDiscovery.test.js

@@ -0,0 +1,48 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const source = readFileSync(
+  fileURLToPath(new URL('./SetupWizard.tsx', import.meta.url)),
+  'utf8',
+);
+
+test('model discovery never blocks a wizard step', () => {
+  // La régression d'origine : `await discoverModels()` sur l'étape clé API
+  // gelait l'écran pendant tout le délai réseau, sans rien afficher.
+  assert.doesNotMatch(source, /await\s+(start|discover)\w*[Dd]iscover\w*\(/);
+  assert.doesNotMatch(source, /await\s+fetch(Models|GatewayCatalog)\(/);
+  assert.match(source, /startDiscovery\(\{ \.\.\.llm\(\), apiKey: value \}\);\s*\n\s*return navigate\('llm-model'\)/);
+});
+
+test('a late answer cannot overwrite a newer discovery', () => {
+  assert.match(source, /discoveryRun \+= 1;/);
+  assert.match(source, /if \(run !== discoveryRun\) return;/);
+});
+
+test('the gateway flat list is shown before the typed catalog', () => {
+  assert.match(source, /onPartial:/);
+  assert.match(source, /Refining chat\/embedding\/rerank types/);
+});
+
+test('the discovery panel reports state, endpoint and transport', () => {
+  for (const fragment of [
+    'Reading the model catalog',
+    'Model catalog unavailable',
+    'Cause: ',
+    'Transport: ',
+    'transportSummary()',
+    'model(s) available',
+  ]) {
+    assert.ok(source.includes(fragment), `discovery panel must show: ${fragment}`);
+  }
+});
+
+test('the wizard fills the terminal instead of a fixed narrow box', () => {
+  const width = source.match(/const dialogWidth = \(\) => ([^;]+);/);
+  const height = source.match(/const dialogHeight = \(\) => ([^;]+);/);
+  assert.ok(width && height);
+  assert.match(width[1], /Math\.min\(1\d\d,/);
+  assert.match(height[1], /Math\.min\([34]\d,/);
+});

package/src/shell/setupWizardPlaceholders.test.js

@@ -22,11 +22,22 @@ test('the wizard treats scaffolded config values as unset', { skip: !existsSync(
   // Cross-repo guard: if the scaffold ever ships a different fake endpoint or
   // secret, the wizard would prefill it as a real answer and a skipped step
   // would write it to the operator's config.
+  // `embeddingModel` et `rerankerModel` ont ete ajoutes ici apres coup : ils
+  // etaient les seuls champs du scaffold a porter une valeur d'apparence reelle
+  // (`BAAI/bge-m3`), que le wizard preremplissait donc comme une reponse
+  // choisie — et qui filtrait le catalogue sur zero resultat des que le serveur
+  // nommait le meme modele autrement.
   const placeholders = [
-    ...scaffold.matchAll(/^\s*(baseUrl|apiKey|model):\s*(\S+)\s*$/gm),
+    ...scaffold.matchAll(/^\s*(baseUrl|apiKey|model|embeddingModel|rerankerModel):\s*(\S+)\s*$/gm),
   ].map(([, key, value]) => [key, value]);
 
-  assert.ok(placeholders.length >= 4, 'expected the scaffold to declare endpoints and secrets');
+  assert.ok(placeholders.length >= 6, 'expected the scaffold to declare endpoints, secrets and models');
+  for (const key of ['embeddingModel', 'rerankerModel']) {
+    assert.ok(
+      placeholders.some(([name]) => name === key),
+      `the scaffold must declare ${key} so this guard covers it`,
+    );
+  }
   for (const [key, value] of placeholders) {
     assert.match(value, regex, `scaffolded ${key}=${value} must be recognised as a placeholder`);
   }
@@ -41,6 +52,8 @@ test('preloading a profile filters placeholders out of every prefilled field', (
     'model: configuredValue(config.llm.model)',
     'baseUrl: configuredValue(config.retrieval.vector.baseUrl)',
     'apiKey: configuredValue(config.retrieval.vector.apiKey)',
+    'embeddingModel: configuredValue(config.retrieval.vector.embeddingModel)',
+    'rerankerModel: configuredValue(config.retrieval.vector.rerankerModel)',
   ]) {
     assert.ok(source.includes(field), `preloadWikirc must filter ${field}`);
   }

package/src/shell/setupWizardSuggestions.test.js

@@ -7,8 +7,31 @@ const source = readFileSync(new URL('./SetupWizard.tsx', import.meta.url), 'utf8
 test('the model steps feed the discovered catalog into the filter', () => {
   // Trois étapes doivent porter des suggestions : modèle LLM, embeddings,
   // reranker. Sans elles, le filtre n'a rien a filtrer.
-  const occurrences = source.match(/suggestions: discovered/g) ?? [];
+  const occurrences = source.match(/\.\.\.suggestionField\(/g) ?? [];
   assert.equal(occurrences.length, 3);
+  assert.match(source, /suggestions: discovered/);
+});
+
+test('no model is preselected when a catalog was discovered', () => {
+  // Preremplir avec le premier modele decouvert filtrait la liste sur
+  // lui-meme : neuf entrees sur dix devenaient invisibles.
+  assert.match(source, /prefill: usable \?\? \(discovered\.length === 0 \? example : ''\)/);
+  assert.doesNotMatch(source, /prefill: [^\n]*discovered\[0\]/);
+});
+
+test('a configured model absent from the catalog is not prefilled', () => {
+  // Le `BAAI/bge-m3` du scaffold face a un serveur qui nomme le meme modele
+  // `bge-m3` : preremplir filtrait la liste sur zero resultat, et l'ecran
+  // affichait « No match » devant dix modeles disponibles.
+  assert.match(source, /discovered\.length === 0 \|\| discovered\.includes\(configured\)/);
+  assert.match(source, /is not in this catalog — pick one below/);
+});
+
+test('the list is navigable with the arrows and confirmed in two steps', () => {
+  assert.match(source, /keyName === 'down' \|\| keyName === 'up'/);
+  assert.match(source, /if \(hovered && \(isEnter \|\| keyName === 'tab'\)\)/);
+  // Le premier Enter depose la valeur, il ne valide pas l'etape.
+  assert.match(source, /setInput\(hovered\);\s*\n\s*setHighlight\(-1\);\s*\n\s*return;/);
 });
 
 test('the typed value always wins over the suggestion list', () => {
@@ -20,5 +43,16 @@ test('the typed value always wins over the suggestion list', () => {
 
 test('suggestions are filtered by the current input, not shown raw', () => {
   assert.match(source, /all\.filter\(\(item\) => item\.toLowerCase\(\)\.includes\(needle\)\)/);
-  assert.match(source, /matches\.slice\(0, SUGGESTION_ROWS\)/);
+  // Fenetre glissante : la liste defile au lieu de s'arreter aux premieres
+  // entrees, sinon un catalogue de 200 modeles reste inatteignable.
+  assert.match(source, /matches\.slice\(offset, offset \+ SUGGESTION_ROWS\)/);
+});
+
+test('the language typed by the operator is the one displayed back', () => {
+  // Sans ce setLanguage, le recapitulatif affichait la langue lue dans le
+  // scaffold a la creation du workspace, pas celle qui vient d'etre saisie.
+  assert.match(
+    source,
+    /writeLanguageConfig\([^)]*\);\s*(\n\s*\/\/[^\n]*)*\n\s*setLanguage\(lang\);/,
+  );
 });

package/src/shell/wrapText.js

@@ -0,0 +1,57 @@
+/**
+ * Découpe un texte en lignes tenant dans la largeur d'une boîte TUI.
+ *
+ * Le wizard rendait chaque libellé, note ou erreur dans un `<text height={1}>` :
+ * au delà de la largeur du dialogue le texte était coupé net, sans ellipse ni
+ * indice. Les phrases les plus utiles — la note d'une étape, la cause d'une
+ * erreur de connexion — sont les plus longues, donc les plus tronquées.
+ *
+ * Le module est volontairement en JavaScript pur, hors du composant : c'est ce
+ * qui le rend testable sans transpiler du JSX.
+ *
+ * @param {string} text texte à découper ; les `\n` explicites sont respectés.
+ * @param {number} width largeur utile en colonnes.
+ * @param {number} maxLines nombre de lignes maximum ; la dernière est
+ *   marquée d'une ellipse quand il reste du texte, pour que la troncature
+ *   restante soit au moins visible.
+ * @returns {string[]}
+ */
+export function wrapText(text, width, maxLines = 6) {
+  const safeWidth = Math.max(8, Math.floor(width) || 8);
+  const lines = [];
+  for (const paragraph of String(text ?? '').split('\n')) {
+    if (paragraph.trim() === '') {
+      lines.push('');
+      continue;
+    }
+    let current = '';
+    for (const word of paragraph.split(/\s+/).filter(Boolean)) {
+      // Un mot plus long que la boîte — une URL, un chemin, un nom de modèle
+      // qualifié — est coupé plutôt que de déborder : mieux vaut le lire en
+      // deux morceaux que pas du tout.
+      if (word.length > safeWidth) {
+        if (current) {
+          lines.push(current);
+          current = '';
+        }
+        for (let i = 0; i < word.length; i += safeWidth) {
+          lines.push(word.slice(i, i + safeWidth));
+        }
+        current = lines.pop() ?? '';
+        continue;
+      }
+      if (!current) current = word;
+      else if (current.length + 1 + word.length <= safeWidth) current += ` ${word}`;
+      else {
+        lines.push(current);
+        current = word;
+      }
+    }
+    if (current) lines.push(current);
+  }
+  if (lines.length <= maxLines) return lines;
+  const kept = lines.slice(0, maxLines);
+  const last = kept[maxLines - 1] ?? '';
+  kept[maxLines - 1] = `${last.slice(0, Math.max(1, safeWidth - 1))}…`;
+  return kept;
+}

package/src/shell/wrapText.test.js

@@ -0,0 +1,48 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { wrapText } from './wrapText.js';
+
+test('wraps on word boundaries within the given width', () => {
+  const lines = wrapText('Required: an agentic model with tool calling support.', 20);
+  assert.ok(lines.length > 1);
+  for (const line of lines) assert.ok(line.length <= 20, `too wide: ${line}`);
+  assert.equal(lines.join(' '), 'Required: an agentic model with tool calling support.');
+});
+
+test('keeps explicit line breaks', () => {
+  assert.deepEqual(wrapText('one\ntwo', 40), ['one', 'two']);
+});
+
+test('splits a word longer than the box instead of letting it overflow', () => {
+  const lines = wrapText('https://gateway.internal.example.com/v1/models', 16);
+  for (const line of lines) assert.ok(line.length <= 16, `too wide: ${line}`);
+  assert.equal(lines.join(''), 'https://gateway.internal.example.com/v1/models');
+});
+
+test('marks the truncation instead of cutting silently', () => {
+  const lines = wrapText('a b c d e f g h i j k l m n o p', 4, 2);
+  assert.equal(lines.length, 2);
+  assert.ok(lines[1].endsWith('…'));
+});
+
+test('a short text is returned untouched', () => {
+  assert.deepEqual(wrapText('API key', 40), ['API key']);
+});
+
+test('the wizard renders every prose field through wrapText', () => {
+  const source = readFileSync(
+    fileURLToPath(new URL('./SetupWizard.tsx', import.meta.url)),
+    'utf8',
+  );
+  // Garde-fou : un `<text height={1}>` autour d'un libellé, d'une note ou
+  // d'une erreur réintroduirait la troncature silencieuse.
+  for (const call of [
+    'wrapText((step() as any).message ?? (step() as any).label, textWidth(), 5)',
+    'wrapText((step() as any).note, textWidth(), 4)',
+    'wrapText(message(), textWidth(), 5)',
+  ]) {
+    assert.ok(source.includes(call), `missing wrapped render: ${call}`);
+  }
+});