Skip to content

History / 1.15 Books and Chapters

Revisions

  • 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>

    @inactinique inactinique committed Jul 26, 2026
  • 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.

    @inactinique inactinique committed Jul 24, 2026
  • docs(wiki): quatorzième passe — brain.db sans busy_timeout, course export/renumérotation, affirmation de confidentialité incomplète Deux nouveaux bugs applicatifs réels trouvés et filés cette passe : - issue #29 : aucune des quatre classes qui écrivent dans le brain.db partagé (VectorStore, PrimarySourcesVectorStore, HistoryManager, ObsidianVaultStore) ne définit de busy_timeout — seul le module Obsidian active le mode WAL. Le journal.db séparé a déjà ce correctif exact (WAL + busy_timeout=3000, avec un commentaire explicite sur l'écriture concurrente) mais il n'a jamais été appliqué au fichier partagé, qui a pourtant plus d'écrivains concurrents. Documenté dans les guides Obsidian et Tropy. - issue #30 : la renumérotation des notes à l'échelle du livre écrit chapitre par chapitre sur le disque sans verrou — un export déclenché pendant la boucle peut assembler un manuscrit à moitié renuméroté, silencieusement. Le rollback en cas d'échec protège contre les échecs internes de l'opération, pas contre une lecture concurrente par l'export. Documenté dans Books-and-Chapters. Autres corrections : - Build and Deployment Guide : l'affirmation de confidentialité « aucune donnée envoyée sauf Zotero » se contredisait avec la phrase juste au-dessus mentionnant les fournisseurs cloud — réécrite pour lister les trois catégories réelles de sortie de données optionnelle (Zotero, fournisseur LLM cloud, connecteurs d'archives). - Technical Architecture : traçage complet d'un scénario de bout en bout (PDF de 200 pages → indexation → récupération Brainstorm) a révélé un mécanisme jamais documenté en 13 passes — l'extraction PDF tourne dans un processus enfant Node système isolé (contournement d'un crash pdfjs-dist), avec un timeout de 120s, une file d'attente séquentielle globale (un PDF à la fois, jamais en parallèle), et une exigence de binaire Node système séparé d'Electron. Documentation aussi d'un second filet de sécurité (EMBED_CHAR_CAP=6000 caractères dans PdfIndexer.ts, indépendant de la troncature côté Ollama). - Features.md : la bascule automatique Ollama→embarqué est en réalité asymétrique entre génération (toujours) et embeddings (seulement si les dimensions correspondent) — précision ajoutée, déjà documentée ailleurs mais pas ici. - Logging System : la table « comportement par défaut » laissait penser à un mécanisme unique de filtrage alors que celui du renderer n'est jamais réellement actif (aucun `process` global) — précision ajoutée après trois passes de corrections successives sur cette même page qui n'avaient jamais été reconciliées entre elles. Meta & notes de version : une seule correction mineure de cohérence interne sur Logging System, rien d'autre trouvé sur les notes de version elles-mêmes malgré la recherche de contradictions avec les pages actuelles.

    @inactinique inactinique committed Jul 24, 2026
  • docs(wiki): neuvième passe — les réglages livre n'ont aucune UI, un bouton Test Connection qui n'existe pas pour Ollama - Books-and-Chapters : les quatre réglages livre (style de notes, numérotation, bibliographie, numérotation des chapitres) sont présentés comme configurables alors qu'aucun n'a de chemin d'interface — grep exhaustif : noteStyle n'apparaît que dans un fichier de test, bookSettings. n'est lu nulle part côté renderer sauf en lecture seule dans EditorPanel.tsx:169, ProjectPanel.tsx n'expose que le sélecteur de type de projet. Seul un projet.json modifié à la main permettrait de changer ces réglages — jamais mentionné comme possible. Plus large et plus impactant que les précédentes lacunes « capacité sans UI » vu le rôle central de la fonctionnalité livre. Filé en issue #24. - Guides Linux et macOS : « Click Test Connection to validate » dans la configuration LLM/Ollama — ce bouton n'existe que pour Zotero (ZoteroConfigSection.tsx). Le seul contrôle réel du panneau LLM est le bouton de rafraîchissement des modèles (icône 🔄). - Coût environnemental : preuve supplémentaire trouvée (recherche + vérification directe d'une source citée) que la littérature publiée sur le coût carbone de l'inférence LLM s'exprime généralement en grammes voire en milligrammes, pas en kilogrammes — une requête ChatGPT complète est couramment citée autour de 4 g CO2. Cela va à l'encontre de l'indice directionnel précédent (qui supposait que les chiffres à l'échelle du kg étaient probablement voulus). Aucune source précise n'a pu être retrouvée pour le taux exact de cette page dans un sens ou l'autre — l'encart reformulé pour présenter les deux indices contradictoires honnêtement, sans trancher.

    @inactinique inactinique committed Jul 24, 2026
  • docs(wiki): l'export Word d'un livre est cassé dans le cas courant, pas juste "peu fiable" En creusant pourquoi {content} ne recevait pas le manuscrit assemblé sur la route pandoc (déjà noté), la trace complète du code a révélé un vrai bug applicatif, pas seulement une nuance documentaire : - WordExportModal.tsx:167 envoie un content vide pour un livre — l'assemblage se fait censément côté main. - word-export.ts:643-646 retourne immédiatement vers exportWithPandoc() dès que bibliographie + pandoc + pas de moteur de citation (le cas le plus courant pour un livre avec citations). - assembleManuscript() n'a qu'UN SEUL point d'appel dans tout le fichier (ligne 667), à l'intérieur du chemin natif — inatteignable depuis la branche pandoc qui vient de renvoyer. - exportWithPandoc() n'a aucune référence à manuscript/assembleManuscript et écrit options.content (vide) tel quel dans le fichier d'entrée pandoc (lignes 503-505). Pandoc réussit silencieusement sur un contenu vide : le .docx produit a une page de titre et aucun texte de chapitre. - pdf-export.ts fait ça correctement (assemblage inconditionnel avant tout branchement bibliographie) — la route Word/pandoc est l'anomalie. Signalé en issue #19 (bug applicatif réel, pas seulement un problème de doc). Trois pages corrigées pour refléter la vraie gravité : - 1.3-Guide-for-Using-Word-Templates.md : l'avertissement portait uniquement sur {content} via un template ; élargi pour dire que l'export sans template est tout autant affecté. - 1.15-Books-and-Chapters.md : « Word produces one section per chapter » était affirmé sans réserve — précisé que ça casse justement dans le cas bibliographie + pandoc + pas de moteur de citation. - 1.10-Export-Presentations.md : pointeur ajouté vers la mise en garde, en précisant que le PDF n'est pas affecté. Au passage, lien mort corrigé sur 1.4-Keyboard-Shortcuts.md : README.md n'existe pas dans ce dépôt wiki.

    @inactinique inactinique committed Jul 24, 2026
  • 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>

    @inactinique inactinique committed Jul 20, 2026
  • 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>

    @inactinique inactinique committed Jul 20, 2026