docs(wiki): commandes d'installation reparees — les noms d'assets ont change en rc.4
Les guides donnaient des commandes `wget` avec les URL de rc.3. Bumper le
seul numero de version ne suffisait pas : les fichiers publies portent
desormais un prefixe de plateforme (`Linux.AppImage.-.`, `Mac.Silicon.-.`),
si bien qu'une URL construite a l'ancienne rend un 404. C'est exactement ce
sur quoi un nouvel utilisateur bute, et rien dans la page ne le lui dirait.
Les trois URL de telechargement du wiki sont verifiees : elles repondent en
200. Un commentaire dans chaque bloc explique le prefixe, pour que la
prochaine mise a jour ne refasse pas l'erreur.
Tailles d'installeurs mesurees sur les fichiers reellement publies, plutot
que reconduites : 262 Mo (AppImage), 158 Mo (deb), 263 et 268 Mo (DMG
Silicon et Intel).
En-tetes `**Version**` des neuf pages concernees passes en 1.0.0-rc.4.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(wiki): RC4 — notes de version, et 23 defauts documentes qui n'existent plus
Le wiki citait 23 issues comme ouvertes. Toutes sont fermees : chaque
« voir issue #N » decrivait donc un defaut corrige, et le wiki decrivait
une application qui n'existe plus.
Nouvelles notes de version (3.4), sur le modele des RC3 : orientees
utilisateur, ordonnees par ce qu'on perdait ou voyait de faux plutot que
par famille technique. La section 1 s'ouvre sur les deux defauts qui
retiraient du texte d'un livre exporte, parce que c'est ce qu'un auteur
doit lire en premier.
Dix-huit pages corrigees. Le plus souvent, un long paragraphe decrivant un
bug verifie dans le code est remplace par sa resolution — d'ou un diff qui
retire plus de lignes qu'il n'en ajoute. Les affirmations les plus
trompeuses etaient :
- les reglages d'ouvrage « n'ont aucune UI » (ils en ont une depuis la RC4)
- l'export Word d'un livre cite « sort vide » (corrige)
- le corpus manuscrit sans interface (elle existe)
- le compresseur de contexte « jamais appele » (cable, et ses trois
distorsions corrigees)
- `embeddingProvider` sans controle (section Embeddings)
- le filtre par collection absent, le bouton OCR manuel injoignable, le
toggle des noeuds auteurs desactive en dur
Home annonce la RC4 ; Features passe en 1.0.0-rc.4 et gagne deux sections
— corpus manuscrit et accessibilite — qui n'avaient nulle part ou vivre.
Les limitations connues des notes RC4 sont argumentees, pas subies :
pdfjs-dist renvoie a #77, et le mode de detection seule de l'inspecteur
explique pourquoi une source primaire contenant des imperatifs ne doit pas
etre tronquee.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(wiki): quinzième passe — course Zotero inter-projets, watcher Tropy orphelin, BibTeX perd les entrées sans auteur
Six nouveaux bugs applicatifs réels trouvés et filés cette passe, la
plupart via un angle « que se passe-t-il si on change de projet pendant
une opération en cours » appliqué systématiquement à chaque intégration :
- issue #33 (le plus sérieux) : une synchronisation Zotero relit le
vectorStore du projet ACTUELLEMENT ouvert après son await réseau, pas
celui qui a démarré la synchronisation — changer de projet pendant
une synchronisation en cours écrit les collections du projet A dans
le projet B. Corruption de données inter-projets réelle, pas juste
une fuite ou un glitch d'affichage.
- issue #34 : TropyService.init() remplace this.watcher sans jamais
appeler .unwatch() sur l'ancien (contrairement au registre LLM juste
à côté, qui a son disposePreviousRegistry() explicite) — un watcher
orphelin peut déclencher une resynchronisation du mauvais projet.
- issue #35 : le canal de progression d'indexation Obsidian
(fusion:vault:progress) ne porte aucun identifiant de projet —
affichage seulement, aucune corruption de données puisque l'écriture
elle-même reste bien scopée.
- issue #31 : l'événement d'expiration d'une proposition IA lors d'un
changement de chapitre est journalisé sous le chemin du chapitre
qu'on vient de rejoindre, pas celui qu'on quitte — la destruction de
la vue CodeMirror se produit après que le store ait déjà basculé son
filePath.
- issue #32 : l'import BibTeX rejette silencieusement toute entrée sans
champ author (pas de repli sur editor), perdant les volumes collectifs
et travaux anonymes courants en bibliographie historique — seul un
console.warn, aucun signal côté interface.
- issue #36 : npm run lint échoue immédiatement, aucune configuration
ESLint n'existe dans le dépôt (déjà su et documenté dans le
commentaire du workflow CI, mais jamais remonté dans le wiki ni
retiré du script).
Autre trouvaille notable (pass fusionné après un traçage de bout en
bout du pipeline Tropy) : l'ordre de priorité des transcriptions était
mal documenté depuis le début (notes Tropy > transcription externe
type Transkribus > OCR — pas « notes > OCR > manuel » comme l'affirmait
une version antérieure), et le chunking des sources primaires est en
réalité figé en taille fixe (DocumentChunker), jamais le chunker
adaptatif utilisé par les PDF — corrigé sur Technical Architecture.
Cluster meta & notes de version entièrement converti en lecture vide
cette passe : Ethics.md a enfin eu sa première lecture véritablement
approfondie (aucune affirmation factuelle vérifiable trouvée, page
confirmée inerte plutôt que simplement non examinée) et un nouvel
échantillon de notes de version RC2/RC3 vérifié contre les tags git
réels a tenu sans exception.
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): lier les quatre bugs applicatifs trouvés en passe 8 à leurs issues GitHub
Ces quatre lacunes avaient été corrigées dans le wiki mais jamais
signalées comme bugs réels de l'application — corrigé :
- issue #20 : la resynchronisation Zotero efface silencieusement la
collection associée
- issue #21 : le filtrage par collection existe côté backend
(Similarity Finder et Tropy) mais n'a aucune UI
- issue #22 : les nœuds auteur du graphe de connaissances sont
entièrement implémentés mais désactivés en dur
- issue #23 : la relance manuelle d'OCR par source existe dans le
store Tropy mais n'est déclenchable depuis aucun composant
Au passage, la description de la « transcription manuelle » a été
précisée : ce n'est pas une saisie au clavier, mais une relance OCR
par source (performOCR → updateTranscription(..., 'manual')).
docs(wiki): venv Python répète l'erreur manuelle/automatique, diagramme de session clarifié
- Corpus Analysis Guide : « Installation automatique au premier usage »
pour l'environnement Python — même erreur déjà corrigée sur le guide
macOS (topic-modeling-handlers.ts:3 : gestion manuelle explicite),
jamais propagée ici.
- Journal and History : le diagramme « Structure » ne montre que des
échanges question/réponse, en tension avec la ligne « Total events »
juste en dessous qui précise (depuis la passe 4) que les opérations
de document, PDF et les décisions de proposition comptent aussi.
Légende ajoutée pour éviter la contradiction de lecture.
docs(wiki): nœud auteur désactivé en dur, libellé de bouton et action de dépannage inexistants
- « Auteur (si activé) » comme type de nœud du graphe : includeAuthorNodes
est câblé à false aux deux points d'appel (useCorpusData.ts:78,122) —
aucun moyen de l'activer depuis l'interface, contrairement à ce que
"(si activé)" laissait entendre.
- Libellé de bouton corrigé : « Analyser les topics », pas « Analyser
les thèmes » (common.json:705, fr et en).
- Dépannage : « Reconstruisez l'index (Paramètres → Base de données) »
— la section s'appelle Actions, pas Base de données, et surtout
aucune action de reconstruction n'existe : seule la purge complète
est disponible.
docs(wiki): troisième passe — un indicateur d'UI fantôme et deux erreurs sur le corpus
- Embedded LLM Guide : la section « Indicateur de provider » décrivait
un badge affichant le provider actif dans le chat (Ollama (gemma2:2b),
qwen2.5-0.5b (embarqué), etc.). N'existe nulle part : aucune occurrence
de « Aucun LLM disponible » dans tout le renderer, ProviderState
jamais importé côté renderer, le seul état apparenté
(AssistantChat.tsx) sert uniquement à taguer le journal, jamais
affiché en JSX. Section retirée entièrement.
- Corpus Analysis Guide : bascule « Afficher les communautés » fabriquée
— CorpusGraphSection.tsx colore par communauté sans aucun réglage
pour l'activer/désactiver. Seuil de dépannage du topic modeling
corrigé : le plancher réellement imposé par le service est 5
documents (min_length=5, main.py), pas 20 — 20-30 reste une
recommandation de fiabilité, pas une limite technique.
docs(wiki): deuxième passe — corriger une erreur dans ma propre réécriture, et un vrai manque d'UI
**Erreur dans ma propre correction précédente** :
- Guide des LLM embarqués : j'avais écrit que embeddingProvider se
règle « dans Paramètres → LLM » au même titre que generationProvider.
Faux — vérifié frais : grep sur tout src/renderer/ pour
"embeddingProvider" ne retourne aucun fichier ; RAGSettingsPanel.tsx
n'écrit jamais que generationProvider ; EmbeddedLLMSection.tsx ne
contient aucune occurrence du mot "embedding". Le moteur sait faire
des embeddings embarqués, mais rien dans l'interface ne permet de
les sélectionner ou de télécharger le modèle — seule l'édition
manuelle du fichier de configuration le permet aujourd'hui. Corrigé
à quatre endroits de la page, et signalé comme un vrai manque produit
en issue #18 (https://github.com/cliodeck/cliodeck-app/issues/18),
pas seulement un défaut de documentation.
**Erreur dans ma réécriture du guide Word Templates** : le découpage en
trois routes d'export était faux. Vérifié frais dans word-export.ts —
mergeWithTemplate() (fusion par {placeholders}) ne dépend que de
templatePath, pas du tout de useEnginePipeline. Il n'y a que deux
mécanismes réels : pandoc+reference-doc (styles, uniquement si
bibliographie + pandoc + moteur de citation non demandé), et
native+docxtemplater (placeholders, dans tous les autres cas — y
compris bibliographie + moteur de citation demandé, que ma première
version traitait à tort comme une troisième route « à base de styles »).
**Erreurs ratées par la première passe** :
- Corpus Analysis Guide : langue par défaut du topic modeling annoncée
« Français », en réalité « multilingual » (main.py:54-56,
useCorpusData.ts:145).
- Journal and History : une « icône History dans le panneau de chat »
fabriquée — AssistantChat.tsx n'a aucune référence à l'historique ;
le vrai composant de navigation (ChatHistoryView.tsx) ne vit que dans
le panneau Journal. Reformulé pour dire que c'est la même donnée,
pas une fonctionnalité séparée.
- Technical Architecture : la section Primary Sources (Tropy) décrivait
encore un vector store autonome (sources.db/sources.hnsw) alors que
PrimarySourcesVectorStore utilise le brain.db partagé depuis la
fusion — contradiction interne avec la section Key Architecture Files
déjà corrigée sur cette même page. L'étape « Dense Search » appelait
encore ollamaClient.generateEmbedding(), contredisant l'étape
Embedding Generation juste au-dessus, déjà corrigée elle aussi.
- Obsidian Vault Guide : « alongside the other workspace databases
(vectors.db, primary-sources.db) » — ces deux noms sont pré-fusion,
le vrai voisin est brain.db.
docs(wiki): corriger la centralité, l'export et la navigation du corpus
- Centralité du graphe : la page annonçait betweenness centrality ;
KnowledgeGraphBuilder.ts calcule explicitement le degré total (liens
entrants + sortants), jamais de betweenness.
- Export : marqué « fonctionnalité à venir » alors qu'il est livré —
corpus-exporters.ts expose topics en JSON/CSV/Markdown et graphe en
GEXF (pas JSON comme l'ancien tableau le disait), via des boutons
dédiés dans l'explorateur, pas un menu contextuel. Aucun export
Timeline ou Statistiques n'existe, contrairement à ce que le tableau
laissait entendre.
- Navigation : il n'y a pas d'icône Corpus dans une barre latérale ;
l'explorateur de corpus est l'onglet « Corpus Explorer » du mode
Explore (barre de modes Explore / Brainstorm / Write / Export).
docs: seconde passe du wiki — vérifications, traductions, parcours débutant
La relecture adverse a rattrapé, entre autres, une erreur introduite par
la première passe : le guide des LLM embarqués affirmait désormais que
ClioDeck pouvait produire ses embeddings sans Ollama, au motif que le
catalogue propose un modèle embarqué et que le réglage existe. En traçant
l'appel jusqu'au registre de providers, il n'y a aucune branche
embarquée : le réglage ne change rien. La page dit maintenant la vérité,
écart entre catalogue et câblage compris.
Autres rattrapages :
- vingt liens vers l'ancien dépôt inactinique/cliodeck, dans sept pages
dont les deux guides d'installation ;
- la page journal décrivait .cliodeck/history.db et un dossier
conversations/, vestiges d'avant la fusion : tout vit dans brain.db ;
- six pages en français dans un wiki anglophone, et non deux comme la
première passe l'avait cru — les deux nommées sont traduites, quatre
restent ;
- quatre imprécisions dans les pages créées à la première passe (plan
derrière un dépliant, libellés réels des boutons, troncature de la
recherche, message d'un fichier manquant).
Créé : 1.0-Getting-Started, qui comblait le trou entre « installer » et
« écrire » — rien n'expliquait comment créer un projet ni ce que le choix
du type implique.
Les cinq pages laissées sous bandeau à la première passe ont été reprises
ligne à ligne : une était fausse, quatre exactes. Plus aucun bandeau.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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>
first commit after move from inactinique