docs(wiki): douzième passe — touches d'envoi du chat inversées, contradictions avec les issues #24 et #28, minTopicSize figé à 3
Aucun nouveau bug applicatif filé cette passe — uniquement des
corrections de documentation, mais deux d'entre elles sont des
contradictions directes avec des bugs déjà filés lors des passes
précédentes, qui avaient survécu parce que les pages n'avaient pas été
recroisées entre elles :
- Features.md : les réglages de compression de contexte et le ratio de
compression dans RAGExplanation étaient encore présentés comme
actifs, alors que la passe 11 a établi qu'ils sont totalement
jamais câblés (issue #28) — corrigé et lié.
- RC3 Release Notes : les réglages de livre (notes, numérotation,
bibliographie) étaient listés comme une fonctionnalité RC3 sans
réserve, alors que 1.15-Books-and-Chapters.md documente depuis la
passe 9 qu'aucun n'a d'interface (issue #24) — réserve ajoutée et
lien.
- RC2 Release Notes : deux affirmations sur obsidian-vectors.db
encore séparé de brain.db à l'époque de RC2 étaient fausses même
pour ce tag précis — vérifié via `git show v1.0.0-rc.2:...` que la
fusion datait de 5 jours avant le tag.
Corrections supplémentaires :
- Keyboard Shortcuts : les touches d'envoi/retour à la ligne du chat
RAG étaient inversées (Ctrl/Cmd+Entrée envoie, Entrée simple insère
un retour à la ligne — c'était documenté à l'envers) ; la touche
Échap pour annuler n'existe pas, seul un bouton l'annule.
- Guide des templates Word : mauvais pointeur de dépannage vers le
Journal Panel (qui est le journal d'usage IA, sans rapport avec les
logs d'export).
- Corpus Analysis Guide : nombre de topics par défaut réellement 10
(pas "Auto"), taille minimale de topic figée à 3 dans le code (pas
5, sans aucune interface pour la changer).
- Tropy Integration Guide : documentation du bouton de purge de la
base des sources primaires (tropy:purge), jusqu'ici non documenté
mais correctement scopé (contrairement au bug Obsidian/brain.db).
- Brainstorm Mode Guide : liste des préfixes de verbes de lecture
incomplète dans la nouvelle section bannière MCP.
- Build and Deployment Guide : npm test tourne en mode watch par
défaut, pas "une fois" ; storage des clés API.
- ClioDeck Installation : le lanceur .desktop généré ajoute
--no-sandbox à l'AppImage, absent du lancement direct.
Quatre passes de vérification exhaustive supplémentaires n'ont rien
trouvé de nouveau dans leurs clusters respectifs (LLM & analyse au-delà
du point ci-dessus, install & build au-delà des deux points ci-dessus).
docs(wiki): onzième passe — Unlink Obsidian écrase brain.db, compression de contexte jamais câblée
Deux bugs applicatifs sérieux trouvés et filés cette passe, en changeant
de méthode sur le cluster brainstorm/intégrations (deux passes propres
consécutives, donc recherche de contradictions inter-pages et de
collisions sur des ressources partagées plutôt que répéter les mêmes
vérifications) :
- issue #27 : le bouton « Unlink » d'un carnet Obsidian supprime le
fichier .cliodeck/brain.db tout entier via fs.unlink, pas seulement
l'index du carnet — obsidianStorePath() pointe vers le même fichier
partagé que les vecteurs PDF, l'index Tropy et le journal de
recherche depuis la consolidation. Documenté dans
1.14-Obsidian-Vault-Guide.md.
- issue #28 : le système de compression de contexte RAG
(ContextCompressor.ts) n'est appelé nulle part dans le vrai chemin de
requête — retrieval-service.ts ne renseigne jamais le champ
`compression` que chat-engine.ts vérifie en aval. Tout contexte
récupéré part vers le LLM sans compression, quelle que soit sa
taille. Documenté dans 2.-Technical-Architecture.md (section
renommée « declared but dead »).
Autres corrections :
- Brainstorm Mode Guide + MCP Integration Guide : une vraie UI de
bascule par outil existe désormais (bannière MCP, classification
lecture/écriture avec opt-in explicite pour les outils d'écriture) —
la note « UI minimale » était périmée, remplacée par une section
complète.
- Keyboard Shortcuts : nuances plateforme sur F11 (plein écran) et F12
(DevTools) sur macOS, même classe de lacune que Cmd+W (passe 10).
- Logging System : dernière formulation trop large sur les DevTools et
les variables d'environnement corrigée (seul CLIODESK_DEBUG/DEBUG
ouvre les DevTools, pas CLIODESK_LOG_LEVEL ; les logs renderer
révélés n'existent de toute façon plus dans le bundle de production).
- RC2 Release Notes : le « problème connu » sur l'étape export des
recipes était factuellement faux (document_id était déjà honoré à ce
tag) — remplacé par la vraie limitation de l'époque (projectType
'article' figé), corrigée avant RC3.
- Features.md : tableau de bord statistiques a 5 onglets, pas 4 (onglet
Tags manquant).
- Installation Linux : bibliothèques système manquantes dans le
résumé (libsecret-1, libgbm) alors que présentes dans la commande
d'installation réelle.
- Build and Deployment Guide : build:all ne construit que pour la
plateforme hôte, pas toutes les plateformes ; stockage des clés API
documenté avec son repli en clair non signalé ailleurs quand le
chiffrement OS n'est pas disponible.
docs(wiki): num_ctx ne concerne que les embeddings, en-têtes MCP désynchronisés des onglets réels
- Brainstorm guide : « Adjust num_ctx in Settings → LLM » pour les
fenêtres de contexte de génération — le seul réglage num_ctx qui
existe (ollamaEmbeddingNumCtx, LLMConfigSection.tsx:358-362)
concerne les requêtes d'embedding Ollama, pas la génération. Aucun
contrôle de fenêtre de contexte pour la génération n'existe dans
l'UI aujourd'hui.
- MCP guide : les en-têtes de section (« Claude Code », « Generic
stdio client ») ne correspondaient plus aux libellés d'onglets
réels déjà corrigés ailleurs sur la même page (« Claude Code CLI »,
« Generic MCP (stdio) », common.json:1413,1415).
docs(wiki): mauvaise caractérisation d'Explore, contradiction interne sur le journal d'accès MCP
- Brainstorm guide : décrivait Explore comme les « panneaux de corpus :
bibliographie, archives, vault ». Faux — ExplorePanel.tsx a trois
onglets (Corpus Explorer, Similarity, Textometrics) ; bibliographie
et sources primaires vivent dans la barre latérale gauche, le vault
Obsidian se configure dans Settings. Cette phrase d'ouverture avait
survécu à deux passes « clean ».
- MCP Integration Guide : la page se contredisait elle-même à 90 lignes
d'écart — une section dit qu'un visualiseur dédié du journal d'accès
est « sur la feuille de route RC3 » (donc absent), une autre
affirme qu'il est déjà « agrégé dans le panneau Sécurité ». Vérifié :
aucune référence à mcp-access/MCPAccessEvent dans tout le renderer —
la seconde affirmation était fabriquée.
docs(wiki): réécrire le guide Brainstorm — contredisait son propre bandeau
La page affirmait en tête que Brainstorm et l'ancien panneau chat sont
désormais le même composant, puis développait plus bas une comparaison
« legacy vs Brainstorm » qui suppose l'existence de chat-service.ts —
supprimé de longue date. Section retirée.
Ajouts vérifiés contre BrainstormPanel.tsx :
- Les quatre onglets réels (Chat, Ideas, Board, Graph) et le tiroir
« Project context » n'étaient mentionnés nulle part ; la moitié de
l'interface du mode était absente du guide.
- context.md (racine du projet) ajouté à côté de .cliohints — les deux
couches de contexte durable, pas une seule.
- « Free mode » (Settings → Modes) retiré : ce réglage n'existe dans
aucune UI, seulement comme mécanisme interne (isFreeMode) sans
bascule utilisateur.
- Section « Limitations (RC2) » recalée : elle contredisait le bandeau
RC3 en tête de page en prétendant que l'UI restait celle d'avant
fusion.
docs: wiki à jour pour la 1.0.0-rc.3
Les 33 pages ont été confrontées au code, pas réécrites de mémoire.
Créées : « Writing a Book — Chapters Guide » (la nouveauté majeure de
cette version : manifeste, navigateur, plan, recherche d'ouvrage,
renumérotation, réglages, exports), « The Editor » (CodeMirror 6 en rendu
live, notes et citations pandoc, fidélité octet pour octet, propositions
adjudicables) et les notes de version RC3.
Corrigées, entre autres :
- Features et Technical Architecture annonçaient encore l'éditeur
Milkdown, retiré depuis ;
- trois raccourcis documentés n'existent pas (Ctrl+Shift+S, Ctrl+Shift+L,
Alt+4) et Ctrl+J n'était pas documenté — vérifié dans menu.ts ;
- « Export Presentations » ne parlait pas des présentations malgré son
titre : ni reveal.js, ni modes en ligne/hors ligne/PDF, ni Beamer ;
- Electron 28 dans deux pages, alors que le projet est en 40.9.2 ;
- le journal d'usage IA distingue désormais ses deux couches et
enregistre les adjudications de propositions.
Cinq pages anciennes (Tropy, LLM embarqués, analyse de corpus,
similarité, stratégie d'embeddings) portent un bandeau signalant qu'elles
n'ont pas été revérifiées ligne à ligne : elles ne contiennent rien de
manifestement faux, mais leur horodatage est ancien.
Aucune page supprimée. Le wiki ne contient aucune capture d'écran : rien
à refaire de ce côté.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs: RC2 wiki — Brainstorm, MCP, Archives, Obsidian + Home rewrite
Rewrites Home.md (was almost empty) as a navigable TOC and adds four new
user guides covering the features introduced by the ClioBrain fusion and
the surrounding RC2 work:
- 1.11 Brainstorm Mode — the chat mode that absorbed ClioBrain (agent
loop, `.cliohints`, source grounding, retrieval scope toggles).
- 1.12 MCP Integration — both directions: MCP clients consumed from
ClioDeck, and ClioDeck's own MCP server exposed to Claude Desktop /
Claude Code. Includes ready-to-paste snippets and the 9-tool catalog.
- 1.13 Archive Connectors — Gallica, HAL, Europeana. API key flow for
Europeana (Electron safeStorage).
- 1.14 Obsidian Vault — pointing the app at a vault folder, indexing,
use as a RAG source.
Plus 3.2 RC2 Release Notes, and the pre-RC2 release artefacts move to
`_archive/` (BETA 2 notes and the v1.0 implementation plan).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>