Skip to content

Changelog

All notable changes to the Hibiscus project will be documented in this file.

[v0.12.0] - Knowledge Base Robustness Overhaul

Major Features

  • Status Dashboard: Implemented a comprehensive UI dashboard tracking indexing health, chunk counts, schema versions, errors, and skipped files.
  • Repair UX: Added explicit controls to rebuild or clear the knowledge base index directly from the user interface.
  • Backend Metadata Extraction: The indexer now automatically parses Markdown files for wiki-links, tags, and YAML frontmatter aliases natively.
  • Workspace Exclusions: Added support for .hibiscusignore to explicitly prevent specific directories and files from being indexed.

Search & Query Upgrades

  • Phrase Parsing: Implemented strict exact-phrase matching and dynamic boosting via quoted search queries.
  • Topic Filtering: Allowed intersection-based topic filtering directly inside the TF-IDF query engine.
  • Line Navigation: Search results now include precise start_line and end_line metadata, allowing the editor to auto-scroll directly to the extracted chunk.

Architecture Improvements

  • Storage Hardening: Migrated to sha2 (SHA-256) for deterministic, cross-platform file content hashing.
  • Large File Bypassing: Added an implicit 10MB file ceiling constraint to the indexer queue to strictly prevent application out-of-memory errors.
  • Mutex Write Locks: Synchronized background indexing state writes within KnowledgeState using lock semantics to prevent data races.
  • Schema Tracking: Incremented metadata formats to schema version 2 to manage extended location properties and graph resolution files gracefully.

[v0.11.3] - Icon System Overhaul

  • Added theme-aware icon wrapper system (withThemeVariant)
  • Refactored icon architecture for composability
  • Fixed binary file handling (read_binary_file)
  • Bumped version across configs

[v0.11.1] - Editor Stability & Graph System

Major Features

  • Knowledge Graph System: Implemented a comprehensive graph-based knowledge management system with full-screen force-directed visualization
  • Wiki-Link Support: Added [[note-name]] syntax for creating bidirectional links between notes
  • Backlinks Panel: Real-time display of notes that link to the current document
  • Interactive Graph Visualization: Click-to-navigate nodes, zoom/pan controls, and degree-based node sizing
  • Full-Screen Graph View: Toggle between editor and graph visualization with Ctrl+G

Documentation & UX

  • Comprehensive Documentation: Added detailed user guides and architecture documentation for the knowledge graph system
  • Drag-and-Drop File Support: Enhanced file handling with drag-and-drop support in editor and tab bar
  • Binary File Rendering: Added support for PDF and DOCX file viewing in the editor
  • Improved Binary File Handling: Better rendering and integration for non-text file formats

Critical Bug Fixes

  • Editor Corruption Bug: FINALLY resolved the persistent editor corruption issue by ensuring Monaco editor is never unmounted during React runtime
  • Monaco Stability: Made Monaco (editorView) persistent throughout application lifecycle
  • State Management: Fixed React lifecycle issues causing editor content loss

Architecture Improvements

  • Knowledge Index Core: Implemented incremental parsing and indexing system with O(1) lookups
  • Graph Builder: Created efficient graph data structure with deduplication and name-based link resolution
  • Performance Optimization: Canvas-based rendering for smooth graph interaction with large knowledge bases
  • Theme Integration: Full CSS variable integration for consistent theming across graph components

Technical Details

  • Force-Directed Layout: D3-based physics simulation with custom tuning for optimal node positioning
  • Incremental Updates: Single-file re-parsing without full knowledge base rebuild
  • Memory Management: Efficient Map-based data structures with version tracking for memoization
  • Cross-Platform: Robust path handling and file type detection

Documentation Additions

  • Knowledge Graph Guide: Comprehensive user documentation covering link creation, navigation, and best practices
  • Architecture Documentation: Technical deep-dive into data structures, algorithms, and integration patterns
  • API Reference: Updated with new knowledge system commands and hooks

[v0.11.0] - Knowledge Graph Integration

Major Features

  • Knowledge Graph Visualization: Implemented full-screen force-directed graph view for visualizing note relationships and connections
  • Graph Toggle Functionality: Added seamless switching between editor and graph view modes with keyboard shortcut support
  • Knowledge System Integration: Connected the knowledge indexing system with interactive graph visualization components
  • Backlinks Visualization: Integrated backlinks panel with graph view for comprehensive relationship mapping

Architecture Improvements

  • Full-Screen Graph Layout: Redesigned application layout to support full-screen graph mode replacing editor view
  • Graph Data Pipeline: Created efficient data flow from knowledge index to graph visualization
  • Theme Integration: Extended theme system to support graph visualization components
  • Performance Optimization: Optimized graph rendering for smooth interaction with large knowledge bases

Technical Details

  • react-force-graph-2d: Integrated force-directed graph library for visualization
  • Canvas Rendering: Hardware-accelerated rendering for smooth graph performance
  • Interactive Controls: Click-to-navigate, zoom, pan, and node dragging capabilities
  • Responsive Design: Graph view adapts to window resizing and layout changes

[v0.10.1] - Icon System Refactor

New Features

  • Griddy Icons System: Replaced all inline SVG icons with centralized icon definitions from icon.ts
  • Icon Handler Integration: Incorporated griddy icons as the primary icon handling system throughout the application
  • Placeholder Icon Updates: Changed placeholder emoji icons to use consistent griddy icon definitions
  • Icon Standardization: Unified icon appearance and behavior across all UI components

Improvements

  • Maintainability: Centralized icon definitions for easier maintenance and updates
  • Performance: Reduced bundle size by eliminating duplicate inline SVG definitions
  • Consistency: Ensured consistent icon styling and behavior across the application
  • Developer Experience: Simplified icon usage through centralized icon library

Technical Details

  • Icon Architecture: Implemented centralized icon management with type-safe icon definitions
  • SVG Optimization: Optimized SVG definitions for better rendering performance
  • Theme Integration: Icons now properly integrate with theme system for consistent coloring
  • Component Updates: Updated all components to use centralized icon system

[v0.10.0] - Multi-File Editor & Tab Bar

Major Features

  • Multi-File Editor: Implemented support for editing multiple files simultaneously with session persistence
  • Tab Bar Interface: Added scrollable tab bar with active state indication and close actions
  • Session Persistence Layer: Created robust session management for editor state and file history
  • File Movement Operations: Added backend support for moving files and folders with workspace awareness

User Interface Enhancements

  • Tab Bar Functionality: Scrollable tabs with active highlighting, close buttons, and overflow handling
  • Multi-File State: O(1) file lookup performance for seamless tab switching
  • Session Management: Automatic restoration of open files and editor states on application restart
  • Visual Feedback: Enhanced visual states for tab interactions and file operations

File Operations

  • Drag-and-Drop Support: Implemented drag-and-drop functionality for file and folder movement in tree view
  • Visual Interaction States: Added comprehensive visual feedback for drag-and-drop operations
  • Move Command Backend: Added Tauri move_node command for file system operations
  • Workspace Integration: Session-aware workspace handling for file movements

Architecture Improvements

  • Editor State Management: Redesigned editor state to support multiple concurrent files
  • File Lookup Optimization: Implemented O(1) file path lookup for instant tab switching
  • Session Storage: Created persistent session layer for editor state recovery
  • Component Integration: Seamlessly integrated tab bar and multi-file editor into application layout

Documentation

  • Multi-File Documentation: Added comprehensive documentation for the new tabbed editor component
  • API Updates: Updated API documentation to include new file movement commands
  • User Guide: Enhanced user documentation with multi-file editing workflows

[v0.9.4] - Search Navigation & UX Improvements

New Features

  • Click-to-Open Search Results: Search results are now clickable and open files at the exact location (with line highlighting when available)
  • Keyboard Navigation: Added Tab/Shift+Tab navigation between search results with automatic file opening
  • Enhanced Topics Dropdown: Topics section is now expandable/collapsible with smooth animations

Improvements

  • File Path Normalization: Fixed double backslash issues in file paths using proper path normalization
  • Line Number Extraction: Enhanced line number extraction to support multiple chunk_id formats (file:123, file#123, file@123, file_123)
  • Visual Feedback: Added selection highlighting and hover states for better UX
  • Debug Support: Added comprehensive logging for troubleshooting search interactions

Bug Fixes

  • Path Handling: Fixed file path duplication bugs using Tauri path API
  • Navigation State: Proper state management for search result selection and cycling
  • CSS Styling: Consistent theme integration for all search components

Technical Details

  • Search Integration: Search panel now fully integrated into right panel structure
  • Navigation Flow: Tab cycles through results → auto-opens selected file → Shift+Tab cycles backward
  • Accessibility: Full keyboard support with proper focus management and ARIA attributes
  • Performance: Optimized state management with proper cleanup and updates

[v0.9.0] - Advanced Knowledge System (Phase 2)

New Features

  • PDF & DOCX Document Support: Extended the parsing system to handle PDF files using pdf-extract and DOCX files via zip+quick-xml streaming. Both parsers implement the existing Parser trait and include robust error handling for corrupt files.
  • TF-IDF Scored Search Index: Implemented a sophisticated scoring system alongside the existing keyword index. Uses the formula score = ln(1 + tf) * ln(total_chunks / df) with precomputed scores for zero query-time calculation. Automatically filters common words appearing in >50% of chunks.
  • Intelligent Topic Grouping: Added automatic topic extraction that groups chunks by heading text. Identical headings create the same topic, empty headings become "General", and small topics (<2 chunks) merge into "Miscellaneous". Uses BTreeMap for deterministic ordering.
  • Advanced Query Engine: Enhanced search with multiple matching strategies - exact match (score + 0.5), prefix match (score * 0.2), and fuzzy match with edit distance 1 (score * 0.1). Supports multi-word queries with accumulated scoring and pagination (max 100 results).
  • High-Performance LRU Cache: Implemented dual in-memory caches - query cache (128 entries) and chunk cache (256 entries). Uses VecDeque for better CPU cache locality than HashMap+LinkedList. All-or-nothing cache invalidation on file changes.
  • Extended Backend API: Added new Tauri commands including search_chunks for ranked search with fuzzy/prefix support, and get_topics for topic retrieval. Enhanced existing commands with caching support.

Architecture Improvements

  • Phase 1 Compatibility: Maintains full backward compatibility - Phase 1 commands and storage remain untouched. Phase 2 extends via parallel data structures without breaking existing functionality.
  • Memory-Optimized Parsing: DOCX parsing uses streaming XML to avoid loading entire documents into memory. PDF parsing extracts full text then splits on double newlines for pragmatic content separation.
  • Deterministic Performance: Topic grouping uses BTreeMap and sorted chunk IDs for consistent results. Query processing includes early exit after 500 candidates per term to prevent performance degradation.
  • Robust File Handling: Added large file guard (10MB threshold) that skips files at queue level before parsing begins. All parsers include proper error handling with IoError fallback for corrupt files.

Storage Updates

  • New Storage Files: Added topics.json for topic mappings and scored_index.json for TF-IDF data alongside existing Phase 1 storage.
  • Enhanced Storage Layout: Updated .hibiscus/knowledge/ structure to support both Phase 1 and Phase 2 data without migration requirements.
  • Optimized Index Structure: Scored index caps at 200 chunk references per keyword to prevent memory bloat while maintaining search quality.

Testing & Quality

  • Comprehensive Test Coverage: Added 46 total tests with 10 new tests covering cache (4), indexer (1), query (4), and topics (1) modules.
  • Performance Validation: Confirmed LRU cache outperforms HashMap+LinkedList for small cache sizes through CPU cache locality benefits.
  • Error Resilience: All new parsers include comprehensive error handling with graceful degradation for corrupted or malformed files.

[v0.8.0] - Knowledge Indexing System (Phase 1)

New Features

  • Knowledge Indexing Pipeline: Implemented a local-first, incremental knowledge indexing system that watches workspace files (.md, .txt) and processes them via a debounced async queue.
  • Worker Pool & Debounced Batching: Added a background worker task with bounded concurrency and debounced batching for efficient per-file processing without blocking the main runtime.
  • Trait-Based Parser System: Introduced a flexible parsing architecture including a MarkdownParser for heading-based splits and a TxtParser for paragraph-based splits.
  • Context-Aware Chunker: Implemented an intelligent chunking engine that splits parsed sections into 200-500 word bounds while preserving heading context and using deterministic IDs.
  • Incremental Keyword Indexing: Added a hash-based incremental keyword index that supports stopword filtering and normalization for rapid text retrieval.
  • Robust Storage Layer: Built an optimized disk I/O layer utilizing buffered reads/writes, streaming file hashes, and individual chunk file storage to minimize memory footprint.
  • Query APIs: Exposed new Tauri commands (search_knowledge, get_chunk, rebuild_knowledge_index) for frontend integration with the knowledge system.

Architecture

  • State Management: Integrated Arc<KnowledgeState> as a managed state within Tauri, properly spawning the worker during the setup hook to ensure safe cross-thread operations.
  • Watcher Integration: Extended the existing watch_workspace to seamlessly accept KnowledgeState and securely forward filesystem events to the new knowledge queue.
  • Asynchronous Processing: Integrated essential Tokio features (rt, rt-multi-thread, time, macros) into the Cargo manifest to safely support native async routines.

Bug Fixes

  • Threading Panic: Replaced tokio runtime thread spawning with Tauri's native async runtime handling to prevent main thread panics when no existing tokio runtime was detected.
  • Macro Export Issues: Updated the module root to accurately re-export the Tauri-facing API to prevent macro resolution bugs associated with tauri::command.
  • Code Consolidation: Delegated all custom shared data types into a single unified file for cleaner dependency management across the workspace.

[v0.7.2]

  • Bugfix: Removed unused Open function causing typescript errors (lol)

[v0.7.1]

  • Bugfix: Fixed bg selection and text selection inconsistency wherein the selection text was stuck at a bright red despite theme changes

[v0.7.0] - New Item Modal System

New Features

  • Production-Grade Modal System: Implemented a Notion × VS Code hybrid modal for creating new files and folders, replacing browser-native prompt() calls with a custom React component.
  • Enhanced File Creation Workflow: Added comprehensive input validation, duplicate prevention, and smooth animations for new file/folder creation.
  • Keyboard Shortcuts: Implemented Ctrl+N (new file) and Ctrl+Shift+N (new folder) keyboard shortcuts for improved productivity.
  • Modal Design System: Created a reusable modal component with backdrop blur, smooth animations, and responsive design using theme CSS variables.

Architecture Improvements

  • Controller-Driven Design: Maintained clean separation between UI and business logic - modal handles presentation, controllers handle filesystem operations.
  • State Management: Implemented proper modal state management with controlled components and callback patterns.
  • Input Validation: Added comprehensive filename validation including invalid character checks and duplicate detection.
  • Accessibility: Included proper ARIA attributes, keyboard navigation (Enter/Escape), and focus management.

Breaking Changes

  • Removed Browser Prompts: Eliminated all prompt() usage in favor of the new modal system for desktop-appropriate UI patterns.
  • Updated File Menu Handlers: File menu actions now use modal-based input instead of browser dialogs.

Technical Details

  • NewItemModal Component: New reusable modal at src/components/Modals/NewItemModal.tsx with TypeScript interfaces for mode support.
  • CSS Styling: Dedicated stylesheet with Notion-inspired design using theme variables and smooth animations.
  • Integration Points: Updated App.tsx with modal state management and keyboard shortcut listeners.
  • Validation Logic: Added duplicate name checking against existing workspace items.

[v0.6.1]

  • bugfix: fixed incorrect link redirection for help -> documentation
  • minor fix: removed excessive emojis from right bar

[v0.6.0] - Study Tools System

🎨 New Features

  • Study Context & Focus Mode: Global state context managing active tools and distraction-free learning. Toggle Focus Mode (Ctrl+Shift+F) to hide the left sidebar and focus entirely on the editor/study tools.
  • Settings System: Instant-save application preferences modal (Ctrl+,) handling general defaults and Pomodoro timer intervals, scaling instantly across both local storage (hot path) and backend filesystem persistence.
  • Pomodoro Timer: Native deep integration handling full work/break/long-break lifecycles perfectly. Built with a clean interface inside the right side-panel and a minimal ring widget attached natively to the bottom status bar.
  • Study Statistics: Activity tracking system logging deep focus sessions building into dynamic streak-counters, timeline history data, and a 100% native SVG bar graph rendering natively inside the application without relying on external bloat.
  • Flashcards System: A deck manager allowing question/answer creations with smooth 3D CSS flip animations natively driven alongside seamless keyboard integrations (Space, Arrows, Shuffle). Currently acts as a foundational block anticipating AI note synthesis features locally.
  • Notes Synthesis: Document combination utility capable of fusing multiple Markdown or text files recursively into structured unified documents. Anticipates future deep docx/pdf local integrations natively.
  • Refactored Right Panel: Implemented RightPanelContainer routing between dynamic sub-panels seamlessly (Calendar vs Study Modes) allowing complete customization over how you allocate your workspace view.

Architecture

  • Flexible Data Store: Introduced a generalized study.rs generic backend trait allowing robust read/save behaviors seamlessly handling isolated tool datasets (stats.json, flashcards.json, settings.json) independently.
  • Hook-Driven Capabilities: Encapsulated state machines inside pure functional hooks natively (usePomodoro, useFlashcards, useStudyStats) allowing un-coupled logic implementation seamlessly testable offline natively.

[v0.5.0] - Theme System Overhaul

Breaking Changes

  • ThemeContext API rewrite: useTheme() now returns { activeThemeName, themes, setTheme, saveUserTheme, deleteUserTheme, duplicateTheme, isThemeEditorOpen, setThemeEditorOpen, refreshThemes, workspaceRoot } instead of the previous { theme, setTheme, customThemes, applyCustomTheme }.
  • ThemeProvider now accepts an optional workspaceRoot prop and has been moved from main.tsx into App.tsx.
  • editorConfig.ts: Removed registerHibiscusThemes() — themes are now managed exclusively by the dynamic CSS adapter.
  • Deleted monacoStudyConfig.ts — was dead code duplicating editorConfig.ts.

New Features

  • JSON Theme System: Themes are defined as JSON with full token overrides (--bg, --text, --editor-keyword, etc.), stored in .hibiscus/themes/<name>.json.
  • Theme Editor UI: In-app modal with color pickers for Core, Editor, and Semantic token groups. Instant live preview via direct CSS variable manipulation.
  • Theme Registry (themeRegistry.ts): Centralized frontend theme management with applyTheme(), safeApplyTheme(), validateTheme(), mergeWithDefaults(), and JSON serialization.
  • Theme Defaults (themeDefaults.ts): Preset themes (midnight, dawn, forest) as static JSON objects with all tokens defined. Presets are read-only; duplicate to edit.
  • Export/Import (themeIO.ts): Export themes as downloadable .hibiscus-theme.json files; import and validate JSON theme files.
  • Backend Persistence: Three new Tauri commands — save_theme, load_themes, delete_theme — for persisting user themes to .hibiscus/themes/*.json.
  • Theme Selector Improvements: Status bar dropdown now shows Preset and Custom sections, active checkmark, and action buttons for "Edit Theme..." and "Import Theme...".
  • TitleBar Integration: View menu now includes "Theme..." action to open the Theme Editor.

🐛 Bug Fixes

  • Fixed invalid CSS: Editor-specific tokens (--editor-fg, --editor-keyword, etc.) were declared outside any CSS selector (bare properties between :root closing brace and [data-theme] blocks). Browsers silently ignored them. Moved inside :root with per-theme overrides.
  • Fixed runtime crash: editorThemeAdapter.ts called strip() but the function was named stripHash(). Caused ReferenceError at runtime.
  • Fixed Monaco theme reference: Editor config referenced hibiscus-soft theme which was never registered before editor creation. Changed to hibiscus-dynamic (the CSS-adapter-defined theme).
  • Fixed Monaco not updating on theme switch: setTheme() previously only changed data-theme attribute but never re-triggered applyEditorThemeFromCSS(). Monaco now syncs on every theme change.
  • Fixed Monaco background transparency conflict: EditorView.css had background-color: transparent !important overriding the dynamic theme adapter's editor.background setting. Removed the !important override.
  • Fixed dead code: Removed unused imports of getStudyEditorOptions and registerHibiscusThemes from EditorView.tsx.

🏗️ Architecture

  • Editor theme adapter rewritten with intelligent light/dark base theme detection (luminance calculation instead of hardcoded hex comparison), comprehensive fallback chains for all CSS variables, and new token support (--editor-line-highlight, --editor-cursor).
  • Strict separation maintained: Editor behavior/config remains fixed and non-editable; theme system is fully user-editable. Frontend owns all theme logic; backend provides persistence only.

[v0.4.9]

  • Maintenance: Internal dependency updates and stability improvements.

[v0.4.8]

  • Docs: Comprehensive MkDocs hierarchy populated containing project architecture, endpoints, and tutorial guides.

[v0.4.7]

  • Bug Fix: Fixed controlled monaco text editor wiping recent key typing when an older queued React state echo occurred due to async lifecycle desyncs. The editor rendering dependency is now purely driven by an internal fileVersion which respects the user's keystrokes.

[v0.4.6]

  • Automation: Created scripts/hibiscus.cjs terminal helper script encapsulating dev, build, test, docs, and bump functions.

[v0.4.5]

  • CI/CD: Added complete Matrix testing pipeline using GitHub Actions to automatically lint, test, and package builds on Linux, Windows, and macOS for every tagged release.

[v0.4.4]

  • Performance: Improved FS Watcher handling by accumulating file modification events cleanly within HashSet debouncers.
  • Performance: Memoized hierarchical TreeView and TreeNode components preventing render storms on active workspace layouts natively.

[v0.4.3]

  • Feature: Implemented automated rotating backup archives (backup.rs) caching older iterations of workspace.json and calendar.json internally into .hibiscus/backups.

[v0.4.2]

  • Feature: Appended automatic configuration state migrations migration.rs natively into standard system loading handlers solving breaking config changes between product variations.

[v0.4.1]

  • Feature: Universal hotkeys mapped globally across editor spaces using useKeyboardShortcuts hooks interacting visually via an accessible ShortcutOverlay cheat sheet dialog.

[v0.4.0]

  • Feature: Redone style tokens mapped out globally leveraging local CSS definitions allowing fast non-blocking changes via the built-in ThemeSelector toggle implementing Midnight, Dawn, and Forest defaults visually.