Release candidate 1

CHANGELOG - Since v1.0.0-beta.1

🎨 Editor & UI Improvements

• Milkdown Editor: Replaced Monaco Editor with Milkdown WYSIWYG editor
• Footnotes Management: Better footnotes handling in Milkdown
• WYSIWYG/Raw Markdown Toggle: Added functionality to switch between WYSIWYG and raw markdown modes
• Design Harmonization: Improved overall design consistency
• Theme System:
  • Replaced density system with light/dark/auto theme system
  • Added time-based automatic theme switching (6:00 AM to 8:00 PM)
  • Fixed light theme CSS bugs in Milkdown

📚 Zotero Integration

• Zotero Sync: Complete Zotero synchronization implementation
• Collections Support: Added Zotero collections and groups support
• RAG with Collections: Use Zotero collections to refine RAG searches
• PDF Detection & Download:
• Detect PDFs available in Zotero (📎 badge display)
• Multi-PDF selection dialog when multiple PDFs available
• Batch download all missing PDFs button
• Automatic indexing after download
• Bibliography Features:
• Tags support
• Bug fixes for bibliography display
• Citations enriched with Zotero attachment metadata

🔍 Tropy Integration

• Full Tropy Support: Added .tropy file support
• Tropy Sync: Complete integration with Tropy for primary sources management

🧠 RAG & Search Improvements

• Graph RAG + NER (Named Entity Recognition):
• Entity extraction (PERSON, LOCATION, DATE, ORGANIZATION, EVENT)
• Entity normalization and deduplication
• Entity-based search boosting
• Entity relations graph
• Note: NER later disabled due to performance issues
• OCR Pipeline: Added OCR support for PDFs (converts PDF to images for text extraction)
• Context Windows: Support for model context windows

Speed Optimizations:

• Chunking and embeddings optimization
• Overall RAG speed improvements
• Removed unused test code
• Vector Store Improvements: Enhanced vector store implementation
• Similarity Engine: Added article/PDF similarity engine with documentation

🐛 Bug Fixes

• Embedding Sources: Fixed embeddings sources bug
• Similarity Bugs: Corrected similarity calculation issues
• TopN Bug: Fixed topN results bug
• Loop Bug: Resolved infinite loop issue
• Re-indexation: Fixed documents being re-indexed unnecessarily
• PDF Extraction: Resolved PDF extraction problems
• Model Download Issues:
• Corrected file sizes (469 MB for 0.5B, 1066 MB for 1.5B)
• Added backpressure handling for downloads
• Better error handling and logging
• BERTopic Installation: Fixed installation bugs
• TypeScript Errors: Various TypeScript corrections

💬 Chatbot Improvements

• Error Handling: Better error messages for Ollama fetch failures
• Error Explanations: More detailed error explanations for users
• Milkdown Integration: Chatbot improvements with Milkdown

⚙️ Configuration & Settings

• Re-indexation Warnings: Enhanced warnings for embedding model changes
• Recommended Models: Added list of recommended embedding models (nomic, mxbai, all-minilm)
• Topic Modelling UI: Fixed status display (now shows "Installed"/"Not installed")
• Relative Paths: Switched to relative paths in project.json files

🖥️ Project Management

• Open in Finder: Added button to open project folder in system file manager
• Project Opening Progress: Added progress indicator when opening projects

🏷️ Branding

• ClioDesk → ClioDeck: Renamed entire project from ClioDesk to ClioDeck
• Updated all URLs, configuration, directories, variables
• Updated window title and About dialogs
• Fixed desktop installation scripts

📖 Documentation

• README Updates: Multiple improvements and clarifications
• Wiki: Moved markdown documentation files to wiki
• Translations: Updated EN/FR translations throughout

---

Note: Beta 2 (v1.0.0-beta.2) was released during this period with many of these features.

v1.0.0-beta.2

ClioDeck 1.0.0-beta.2 - Major Zotero sync, bibliography stats, Milkdo…

ClioDeck v1.0.0-beta.1

First Beta Release 🎉

ClioDeck is a multi-platform desktop application to assist historians in writing, with RAG (Retrieval-Augmented Generation) and Zotero integration.

Highlights

• Writing Assistant for Historians: Efficiently search bibliographic data and query digitized sources (PDFs) via RAG
• Zotero Integration: Complete bibliography management with merge/replace modes
• Advanced Search: HNSW + BM25 hybrid search (16x faster than baseline)
• Internationalization: Full support for French, English, and German (667+ translation keys)
• Word Export: Export to .docx with custom .dotx template support
• Cross-Platform: macOS (Intel & Apple Silicon) and Linux support

Platform Support

• macOS: Intel (x64) and Apple Silicon (arm64)
• Linux: AppImage and Debian packages (amd64)

Installation

macOS

Download the appropriate DMG file for your architecture:

• Intel Macs: ClioDeck-1.0.0-beta.1.dmg
• Apple Silicon Macs: ClioDeck-1.0.0-beta.1-arm64.dmg

Linux

• AppImage: ClioDeck-1.0.0-beta.1.AppImage (universal, works on most distributions)
• Debian/Ubuntu: cliodeck_1.0.0-beta.1_amd64.deb

Notes

This is a beta release. Developer tools remain enabled for debugging purposes.

License: GPLv3