notes/CHANGELOG.md

# Changelog

All notable changes to Graph Notes will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).

## [1.5.0] — 2026-03-11

### Added
- **Graph View Upgrade** — Complete rewrite using `@blinksgg/canvas` v3.0 with virtualized rendering
- **Note Graph Nodes** — Custom node type showing title, tag pills, link count badge, and cluster color
- **Cluster Group Nodes** — Collapsible `GroupNode` containers grouping related notes by community detection
- **Minimap** — Canvas overview with draggable viewport for large vault navigation
- **Layout Switcher** — Force-directed, tree, and grid layouts with animated transitions
- **Graph Search & Spotlight** — Type-to-search with non-matching nodes dimmed and camera fit-to-bounds
- **Edge Labels** — Wikilink context displayed on graph edges
- **MiniGraph Upgrade** — Sidebar preview upgraded to canvas v3.0

### Changed
- `@blinksgg/canvas` updated to v3.0 from `gg-antifragile` repository
- `WhiteboardView` migrated to new `CanvasProvider` API
- `GraphView` reduced from 336 to ~120 lines

## [1.4.0] — 2026-03-11

### Added
- **Content Checksums (SHA-256)** — Per-note hashing with on-demand vault-wide verification against stored checksums
- **Vault Integrity Scanner** — Deep scan for truncated files, leftover `~tmp` files, orphaned `.graph-notes/` entries, and non-UTF-8 encoding issues
- **Automatic Backup Snapshots** — Vault-level `.zip` snapshots in `.graph-notes/backups/` with auto-pruning of old snapshots
- **Write-Ahead Log (WAL)** — Crash recovery via operation journal in `.graph-notes/wal.log` with startup replay
- **Conflict Detection** — mtime-based external modification check before writes; conflict banner with overwrite/discard options
- **Frontmatter Schema Validation** — Inline warnings for unclosed `---` delimiters, duplicate keys, and invalid date formats
- **Orphan Attachment Cleanup** — Scan `_attachments/` for files not referenced by any note, with bulk delete
- **File Operation Audit Log** — Append-only log of all create/update/delete/rename operations with timestamps

### Changed
- Sidebar: added 🛡️ Integrity Report action
- Command Palette: added Verify Vault, Create Backup, Audit Log commands
- StatusBar: integrity badge showing checksum status
- Editor: conflict banner + frontmatter validation warnings

### Dependencies
- Added `sha2` (Rust) for content hashing

## [1.0.0] — 2026-03-09

### 🎉 First Stable Release

Graph Notes reaches 1.0 — a local-first, graph-based note-taking app built with Tauri, React, and Rust.

### Hardened
- **Atomic writes** — all file saves use write→fsync→rename→fsync-parent to prevent corruption on crash/power loss
- **Path validation** — `safe_vault_path()` applied to all 20 file-access commands, preventing directory traversal
- **Filename sanitization** — `safe_name()` rejects path separators in workspace, canvas, and attachment names
- **Note-switch save race** — debounced save now captures note path at call time, preventing old content from being written to wrong note
- **Save pipeline consistency** — slash command insert and image paste now route through the standard debounced save with `domToMarkdown()`
- **Git error handling** — `git_status`, `git_commit`, `git_init` now check exit codes and surface stderr on failure
- **Silent error swallowing** — fixed 2 `let _ = fs::write()` sites to propagate errors
- **Panic prevention** — replaced `unwrap()` with `unwrap_or_default()` on fallible `file_name()` calls
- **Export safety** — `export_vault_zip` skips in-progress `~tmp` atomic write files
- **Regex performance** — all 10 per-call `Regex::new()` migrated to `LazyLock` statics

### Fixed
- **Rust compilation** — resolved duplicate `dirs_config_path()` definition and removed reference to unlinked `dirs` crate
- **Content Security Policy** — replaced `null` CSP with a proper baseline policy allowing local resources and Google Fonts
- **Canvas dependency** — updated `@blinksgg/canvas` to correct local file path

### Removed
- **Dead code** — removed unused `cache.rs` module (196 lines) that was never compiled (no `mod cache;` declaration, missing `notify` crate dependency)

### Changed
- **README** — replaced Vite template boilerplate with comprehensive project documentation
- **.gitignore** — added `src-tauri/target/` and `vault/` exclusions
- **Version** — bumped from 0.9.0 → 1.0.0 across `package.json`, `Cargo.toml`, and `tauri.conf.json`

## [0.9.0] — 2026-03-09

### Added
- **Import/Export Hub** — Export vault as ZIP, import .md folders from Obsidian/Notion
- **Keyboard Shortcuts Editor** — View, rebind, persist all keyboard shortcuts
- **Graph Analytics** — Stats dashboard with orphan detection, most-connected notes, link density
- **Note Pinning** — Pin notes to sidebar top, persisted to `.graph-notes/pinned.json`

### Changed
- Sidebar: added 📊 Analytics action
- Command Palette: added Graph Analytics, Import/Export, Keyboard Shortcuts commands
- Backend: added `export_vault_zip`, `import_folder`, `save_shortcuts`, `load_shortcuts`, `get_pinned`, `set_pinned`

### Dependencies
- Added `zip` crate (Rust)

## [0.8.0] — 2026-03-09

### Added
- **Outline Sidebar** — Collapsible heading tree (H1–H6) with click-to-scroll and active heading tracking
- **Timeline View** — Chronological note cards grouped by date with 7d/30d/1y filters
- **Document Statistics** — Status bar with word count, characters, lines, reading time, heading count
- **Markdown Table Editor** — Visual table grid with click-to-edit cells, add/remove rows/columns, Tab navigation
- **Random Note** — 🎲 Discover random notes from sidebar or command palette
- **Link Suggestions** — Backend `suggest_links` for wikilink auto-completion

### Changed
- Sidebar: added 📅 Timeline and 🎲 Random Note actions
- Command Palette: added Timeline, Random Note commands
- Backend: added `suggest_links`, `list_notes_by_date`, `random_note` commands

### Dependencies
- Added `rand` crate (Rust)

## [0.7.0] — 2026-03-09

### Added
- **Canvas Whiteboard** — Freeform visual thinking surface powered by `@blinksgg/canvas` with card/text nodes, drag, zoom, save/load
- **Database Views** — Notion-style table/gallery/list views from frontmatter properties with sort/filter
- **Backlink Context** — Paragraph-level excerpts around wikilink mentions in backlinks panel
- **Dataview Queries** — Inline ` ```dataview TABLE ... SORT ... ``` ` blocks rendering live query tables
- **Git Sync** — commit/push/pull panel with status indicator, changed file list, repo initialization

### Changed
- **GraphView rewritten** using `@blinksgg/canvas` (replaces custom HTML5 Canvas force simulation)
- Sidebar: added Database, Whiteboard quick actions
- Command Palette: added Database View, New Whiteboard, Git Sync commands
- Backlinks now use backend `get_backlink_context` for paragraph excerpts

### Dependencies
- Added `@blinksgg/canvas`, `jotai`, `graphology`, `d3-force`

## [0.6.0] — 2026-03-09

### Added
- **Tabbed Editor** — Multi-note tab bar with drag-reorder, close buttons, active tab highlighting
- **Note Refactoring** — Extract selection to new note (replaces with wikilink), merge notes (appends + updates links)
- **Encrypted Notes** — AES-256-GCM password protection with Argon2 key derivation, lock/unlock button in editor
- **Spaced Repetition Flashcards** — Study mode from `?? question :: answer ??` syntax, SM-2 scheduling, difficulty ratings
- **Heading Folding** — Fold state persistence per note via `.graph-notes/folds.json`
- **Custom CSS Snippets** — Live-preview CSS editor, persisted in `~/.config/graph-notes/custom.css`
- **Workspace Layouts** — Save/restore window arrangements in `.graph-notes/workspaces/`
- **Embeddable Widgets** — `{{progress:N}}` progress bars, `{{counter:N}}` badges, `{{toggle:on/off}}` indicators

### Changed
- Editor supports right-click context menu for refactoring operations
- Command Palette extended with Flashcards, Custom CSS, and Save Workspace
- Sidebar quick actions include Flashcards
- Custom CSS loaded on mount via `useCustomCssInit` hook

### Dependencies
- Added `aes-gcm`, `argon2`, `rand`, `base64` for encryption

## [0.5.0] — 2026-03-08

### Added
- **Kanban Board** — Visual task board from `- [ ]` / `- [/]` / `- [x]` items across vault, with drag-and-drop between Todo/In Progress/Done columns
- **Focus / Zen Mode** — Distraction-free writing (`⌘⇧F`): hides sidebar, breadcrumbs, meta, centers content at max 720px
- **Note Version History** — Auto-snapshots every 5 min, timeline sidebar with inline diff viewer (add/remove highlighting)
- **PDF Export** — Print-styled export via browser print dialog with clean typography
- **Global Search & Replace** — Find/replace text across vault with dry-run preview before applying (`⌘H`)
- **Local Backlink Graph** — Mini force-directed canvas in preview showing current note's 1-hop link connections
- **Writing Goals** — Per-note word count targets with gradient progress bar (red→yellow→green)
- **Syntax-Highlighted Code Blocks** — highlight.js with 8 languages, copy-to-clipboard button, dark theme

### Changed
- Editor supports focus mode (hides chrome, centers content)
- Command Palette extended with Kanban, Focus Mode, Search & Replace, Export as PDF
- Sidebar quick actions include Kanban Board
- Auto-snapshot on save (throttled to 1 per 5 min)

### Dependencies
- Added `highlight.js` for syntax highlighting

## [0.4.0] — 2026-03-08

### Added
- **Frontmatter & Properties Panel** — YAML `---` fenced metadata with inline key-value editor (collapsible panel below breadcrumbs)
- **Table of Contents** — Auto-generated outline from headings, shown alongside preview mode with active heading highlight
- **Mermaid Diagram Rendering** — Fenced `mermaid` code blocks render as SVG diagrams in preview mode (lazy-loaded)
- **Image & Attachment Support** — Paste images from clipboard, stored in `_attachments/` directory with `![](path)` markdown
- **Slash Commands** — Type `/` at line start to open inline formatting menu (14 commands: headings, lists, code blocks, mermaid, tables)
- **Calendar View** — Visual month grid for daily notes with dot indicators, "Today" button, and click-to-create
- **Theme Picker** — 5 built-in themes (Dark Purple, Dark Emerald, Dark Ocean, Dark Rose, Light) with live preview, persisted
- **Export to HTML** — Export current note as styled standalone HTML file

### Changed
- Editor now includes PropertiesPanel, TableOfContents sidebar, and SlashMenu
- Command Palette extended with Calendar, Theme, and Export HTML commands
- Sidebar quick actions include Calendar View
- Added `⌘T` keyboard shortcut for Theme Picker

### Dependencies
- Added `mermaid` for diagram rendering

## [0.3.0] — 2026-03-08

### Added
- **Split Editor** — Open two notes side by side with a draggable divider (right-click → "Open in split")
- **Wikilink Hover Preview** — Hover over `[[wikilinks]]` to see a floating preview card with note content and link count
- **Note Transclusion** — `![[note-name]]` embeds the content of another note inline, with recursive depth limiting (3 levels)
- **Vault Switcher** — Click sidebar brand to switch between recent vaults or open a new folder
- **Drag & Drop File Organization** — Drag notes between folders in the sidebar file tree
- **Breadcrumb Navigation** — Path breadcrumbs shown above the editor for nested notes
- **Note Templates** — Create notes from templates in `_templates/` directory via Command Palette (supports `{{title}}` and `{{date}}` variables)
- **Recent Notes** — Last 5 recently opened notes shown in the sidebar
- **Favorites** — Pin notes as favorites (right-click → "Favorite"), persisted per vault in `.graph-notes/favorites.json`
- **Open in Split Pane** — Right-click context menu option to open a note in a side-by-side view

### Changed
- Note view now uses `SplitView` component, supporting both single-pane and dual-pane editing
- Context menu expanded with "Favorite" and "Open in split" actions, plus visual divider
- Command Palette shows template commands when available
- `LinkPreview` component renders as a global overlay for all hover previews

## [0.2.0] — 2026-03-08

### Added
- **Full-Text Search** — Vault-wide content search in the sidebar (debounced, with context snippets and result ranking)
- **Command Palette** — `⌘K` / `Ctrl+K` opens a fuzzy search palette for notes, commands, and content
- **Keyboard Shortcuts** — `⌘N` new note, `⌘G` graph view, `⌘D` daily note, `⌘E` toggle edit/preview, `⌘\` toggle sidebar
- **Note Rename** — Right-click context menu on notes in sidebar for inline rename with automatic wikilink updates across vault
- **Note Delete** — Right-click context menu with confirmation dialog; navigates away if active note deleted
- **Tags System** — `#tag` extraction from notes, sidebar tags section with click-to-filter, emerald-colored tag pills in editor
- **Graph Filtering** — Filter bar to highlight matching nodes, focus mode (1-hop neighborhood), orphan node toggle
- **Inline Markdown Styling** — Headings (`# ## ###`) render at proper sizes in edit mode, `**bold**`, `*italic*`, `` `code` `` styled inline
- **List Continuation** — Pressing Enter after `- item` auto-inserts bullet on next line
- **Tab Indent/Outdent** — Tab and Shift+Tab for list item indentation
- **Collapsible Sidebar** — Toggle sidebar visibility with `⌘\`

### Changed
- Edit/Preview mode is now global (shared via context), toggled with `⌘E` from anywhere
- Search input shows `⌘K` hint for command palette discovery

## [0.1.0] — 2026-03-07

### Added
- **Tauri v2 Desktop App** — Local-first note-taking with full filesystem access via `tauri-plugin-fs`
- **Contenteditable Editor** — Rich inline editing with `[[wikilink]]` token chips (compact pills that unwrap on backspace/delete)
- **Wikilink Autocomplete** — Type `[[` to fuzzy-search and link notes; creates new notes if no match found
- **Force-Directed Graph View** — Canvas-based visualization with semantic zoom (circles → rounded-rect cards with note previews)
- **Graph Interactions** — Single-click animates zoom to node, double-click opens note, drag to reposition nodes
- **shadcn-Inspired Design System** — Zinc-based neutrals, purple accent gradients, focus rings, spring transitions
- **Sidebar** — Recursive file tree with search, collapsible folders, active-state indicators, note count badge
- **Backlinks Panel** — Lists all notes linking to current page with highlighted context snippets
- **Markdown Preview** — Toggle between edit and rendered preview modes with inline wikilink rendering
- **Daily Notes** — Auto-generated daily journal entries accessible from sidebar shortcut
- **Auto-Save** — Debounced 500ms save on every keystroke
- **Custom Scrollbars** — Minimal 5px scrollbars matching the dark theme