docs: Linux x86_64 est publie, la documentation le disait encore impossible
Les binaires x86_64 sont desormais attaches a la rc.4. Toute la
documentation affirmait « arm64 only — build from source on x86_64 »,
ce qui envoyait un utilisateur de PC compiler l'application pour rien.
Les guides donnent la substitution (`-x86_64` -> `-arm64`) plutot qu'une
seconde serie d'URLs : deux jeux de commandes a maintenir, c'est un jeu
qui finira perime. Ils commencent par `uname -m`, parce que le mauvais
fichier se telecharge parfaitement avant de refuser de demarrer — panne
d'autant plus deroutante que rien n'a echoue.
Le guide de construction gagne la raison du piege, qui n'etait ecrite
nulle part : electron-builder n'inscrit l'architecture dans le nom que
lorsqu'elle n'est pas x64, et la cible `linux` de package.json n'en
declare aucune, donc elle herite de la machine de build. C'est ainsi
qu'un Mac a produit des binaires arm64 dont le nom ne disait rien. D'ou
la consigne : lire l'en-tete ELF, jamais le nom du fichier.
Les tailles sont remesurees sur les six assets publies, avec l'ecart
x86_64 explique — `node-llama-cpp` embarque CUDA et Vulkan sur cette
architecture seulement. C'est un arbitrage, pas un defaut : ces
binaires servent a qui a une carte NVIDIA, et pesent pour les autres.
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): 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): la vérification Ollama se déclenche à l'ouverture des Paramètres, pas au lancement
Les quatre pages d'installation/build répétaient la même inexactitude,
copiée telle quelle d'une page à l'autre : « au premier lancement,
ClioDeck vérifie la connexion Ollama ». Vérifié dans ConfigPanel.tsx —
le déclencheur réel est un useEffect qui se déclenche au montage du
panneau Paramètres (handleRefreshModels), pas au démarrage de
l'application. Un utilisateur qui n'ouvre jamais les Paramètres ne
déclenche jamais cette vérification. Confirmé qu'aucune vérification
équivalente n'existe au niveau du démarrage (App.tsx, main/index.ts).
docs(wiki): troisième passe — deux pages n'avaient pas été recroisées avec le correctif de l'issue #18
- 1.-ClioDeck-Installation.md affirmait pouvoir télécharger le modèle
d'embeddings embarqué depuis Settings → LLM — contredit directement
la correction apportée à 1.7-Embedded-LLM-Guide.md lors de la
deuxième passe (aucune UI n'expose embeddingProvider, voir issue #18).
La page n'avait simplement pas été recroisée avec ce correctif.
- 2.1-Build-and-Deployment-Guide.md contenait deux contradictions
internes au même document :
- L'arborescence « Build Structure » listait encore des noms de
fichiers 1.0.0 sans suffixe et un ClioDeck Setup 1.0.0.exe, à 40
lignes de la section « User Installation » déjà corrigée qui dit
l'inverse (arm64 uniquement pour Linux, aucune build Windows
publiée).
- « Security and Privacy → Local Data » disait encore « LLM and
models: local Ollama », contredisant la section Technical Stack en
haut de la même page, déjà réécrite en deuxième passe pour décrire
les six providers.
Les deux corrigées ; au passage, CLIODESK_DEBUG/CLIODESK_LOG_LEVEL
ajoutées à la liste des variables d'environnement runtime, absentes
alors que la page renvoie vers le guide de logging qui les documente.
docs(wiki): deuxième passe — corriger vectors.db, une régression de numérotation, et deux erreurs de sécurité factuelle
Cette repasse adversariale a trouvé des erreurs que la première n'avait
pas vues, y compris deux que j'ai moi-même introduites en corrigeant
autre chose.
**Régression introduite par mes propres corrections précédentes** :
- Les arborescences de projet réécrites dans les guides Linux/macOS
citaient `vectors.db` comme fichier d'index PDF. Vérifié frais contre
backend/core/workspace/layout.ts:67 — le nom réel est `brain.db`,
store partagé (PDF + Tropy + historique) depuis la fusion. `vectors.db`
n'est qu'un nom pré-fusion, uniquement pertinent pour la migration
d'anciens projets. Corrigé dans 1.-ClioDeck-Installation.md,
1.1-Linux, 1.2-macOS, et 2.1-Build-and-Deployment-Guide.md (cette
dernière portait la même erreur, présente avant mes modifications).
- Numérotation cassée dans « Option B: Installation from Source »
(Linux et macOS) : la suppression d'une étape lors de ma correction
precedente avait laissé un saut 3 → 5 sans renuméroter. Corrigé dans
les deux fichiers.
**Erreurs à impact utilisateur réel, ratées par la première passe** :
- Obsidian Vault Guide : la page affirmait qu'« Unlink » laisse l'index
en place et qu'un re-lien le réutilise. Vérifié contre
fusion-handlers.ts:619-631 — le handler fait `fs.unlink(dbPath)`,
l'index est bien supprimé ; se relier déclenche une reconstruction
complète. Un utilisateur suivant l'ancienne description perdrait du
temps à croire son index intact. Champ TITLE → TITRE corrigé au
passage (vérifié fusion-chat-service.ts:838).
- Tropy Integration Guide : un raccourci clavier Ctrl+Shift+S pour la
synchronisation n'existe nulle part (grep sur menu.ts et les
composants PrimarySources, aucune occurrence) — retiré. La page
décrivait aussi les embeddings comme figés sur nomic-embed-text ;
tropy-service.ts:98 utilise le provider configuré, comme partout
ailleurs dans l'app. Chemins de stockage corrigés vers brain.db +
primary-hnsw.index (vérifiés dans PrimarySourcesVectorStore.ts:125-126).
- MCP Integration Guide : la troncature des réponses (4000 caractères,
2000 pour Gallica/HAL) n'était pas documentée alors qu'elle est
visible dans les réglages de l'app elle-même ; ajoutée. Libellés des
onglets alignés sur l'UI réelle (« Claude Code CLI », « Generic MCP
(stdio) »).
Build-and-Deployment-Guide.md : la section « User Installation » citait
encore des noms de fichiers 1.0.0 sans suffixe arm64, alors que les
guides Linux/macOS avaient déjà été corrigés dans le même sens la
première fois — incohérence entre pages, maintenant alignée.
docs(wiki): aligner la page d'installation générique sur le vrai flux de build
- mxbai-embed-large présenté comme repli automatique si nomic est
indisponible : aucun mécanisme de ce genre n'existe, ce sont deux
choix indépendants.
- gemma2:2b recommandé sans réserve sur les outils — ajoutée, avec les
modèles tool-capable de la liste blanche Ollama.
- Ajout d'un chemin entièrement hors ligne sans Ollama : les deux
petits modèles embarqués (génération + embeddings), déjà documentés
dans 1.7 après sa propre correction.
- ./scripts/install-desktop.sh : n'est pas embarqué dans l'AppImage
publiée, seulement utilisable depuis un clone du dépôt.
- npx electron-rebuild -f (deux occurrences) → npm run rebuild:native,
le vrai flux du dépôt.
- Linux : précision que la release courante est arm64 uniquement.
- Nettoyage mineur : cd cliodeck → cd cliodeck-app, suppression d'un
chemin de logs qui n'existe pas.
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>
first commit after move from inactinique