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): deuxième passe — Features.md, Home.md, RC3, Similarity Finder
- RC3 notes : « Branch: release/v1.0.0-rc.3 » — cette branche a été
fusionnée puis supprimée du remote, comme son équivalent déjà corrigé
sur la page RC2. Remplacé par « Tag: v1.0.0-rc.3 ».
- Features.md : trois chiffres/faits faux, vérifiés frais.
- Modèle Ollama par défaut annoncé gemma2:2b ; le vrai défaut du code
est llama3.2 (cliodeck-config-adapter.ts:138,240), gemma2:2b n'est
qu'une recommandation.
- Cache d'embeddings de requête : 500 entrées/60min annoncées, contre
2000/10min réels (retrieval-service.ts:68).
- Liste des providers cloud incomplète (Claude/OpenAI seulement) —
Mistral et Gemini sont deux providers de premier rang au même
titre, absents de la liste.
- Pointeur mort vers « les fichiers de documentation de chaque
fonctionnalité » : 7 des 8 pages FEATURE_* ont été supprimées cette
session, remplacé par un renvoi vers Home.md et la seule page
restante.
- Home.md : la section « Feature notes » ne contenait plus qu'une seule
entrée après les suppressions — repliée dans « Working with the
corpus », à côté du guide qu'elle complète.
- FEATURE_SIMILARITY_FINDER.md : deux imprécisions supplémentaires.
- Le cache est verrouillé au niveau du document entier (hash document
+ hash vectorstore + options), pas segment par segment comme le
schéma le suggérait ; expire aussi après 24h et se réinvalide sur
changement de granularity/maxResults/similarityThreshold — aucun
des deux n'était documenté.
- La section d'interprétation des scores (>0.8 / 0.5-0.8 / <0.5)
ne s'applique qu'avec useReranking désactivé. Par défaut (activé),
rerankWithLLM remplace le score par un rang synthétique
(1.0/0.8/0.6/0.4/0.2 pour 5 candidats) — vérifié
similarity-service.ts:754. Le nombre affiché par défaut n'est donc
pas une similarité sémantique.
docs(wiki): retirer 9 pages obsolètes, confrontées au code réel
Chaque suppression a été vérifiée contre le code de cliodeck-app, pas
supposée :
- FEATURE_ZOTERO_SYNC.md, FEATURE_TAGS_METADATA.md,
FEATURE_BIBLIOGRAPHY_STATS.md, FEATURE_BIBTEX_EXPORT.md : notes
d'ingénierie ponctuelles (BETA 3.1, janvier 2026) redondantes avec ce
que Features.md et les guides numérotés couvrent déjà.
- FEATURE_UNIFIED_BIBLIOGRAPHY.md : décrit une disposition de panneau
(PDFs/Corpus dans le panneau de droite) remplacée par la
restructuration en quatre modes — Corpus vit maintenant dans le mode
Explore, pas dans le panneau de droite.
- FEATURE_EMBEDDING_STRATEGY.md : documente une classe OllamaClient.ts
qui n'existe plus dans le dépôt. Le réglage qu'elle décrit
(embeddingStrategy) est mort dans l'app elle-même, pas seulement dans
le wiki — signalé séparément en issue.
- FEATURE_ORPHAN_PDF_CLEANUP.md : la fonctionnalité existe toujours
(backend/services/OrphanPDFDetector.ts), mais la page n'apporte rien
au-delà du résumé déjà présent dans Features.md.
- 2.2-i18n-Migration-Report.md : rapport de migration ponctuel, migration
terminée et vérifiée (les 19 clés citées existent déjà), deux des cinq
fichiers qu'il cible n'existent plus sous ce nom.
- 2.4-Word-Export-Implementation-with-Template-Support.md : journal
d'implémentation de la PR d'origine (janvier 2026), pas de la
documentation ; cite une ligne de code qui contient aujourd'hui tout
autre chose.
Home.md mis à jour : les liens vers les 9 pages supprimées retirés, la
section « Feature notes » réduite à Similarity Finder (seule page du
lot qui sera corrigée, pas supprimée).
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>
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>
first commit after move from inactinique