github.com/Dicklesworthstone/beads_viewer

Major release adding Homebrew/Scoop package distribution, SQLite comment export, watch mode, buffer pooling performance optimizations, and comprehensive agent-friendliness improvements.

Distribution

• GoReleaser auto-publishing to Homebrew and Scoop (09db3df)
• Claude Code SKILL.md for automatic capability discovery (3d393e0)

Export & Data

• Add comments to SQLite export (#52) and watch mode for continuous export (#55) (2324e61)
• Support all 8 beads status types; filter blocked items from robot-next (c1c5c40)
• XSS prevention, JSON encoding, and preview validation (a1e4ca3)
• Orphan detection, O(1) cycle lookup, and case-insensitive labels (cba2f3f)
• IssueFilter callback and status normalization in loader (c0e3582)
• Unified tombstone/closed status handling (a80a75c)
• Deterministic data hash computation for cache invalidation (ea25629)

Performance

• Comprehensive Round 2 optimizations for robot-triage latency (47adaeb)
• Buffer pooling for Brandes' algorithm (44c10c2)
• Memoize GetActionableIssues via TriageContext (127176b)
• topk utility package for performance-critical sorting (1cbdb9c)
• Integrate topk into vector search (8ec02df)

Robot Mode

• Performance metrics package and --robot-metrics command (af868af)
• TTY guard to prevent control sequence leakage in robot mode (c7e2cfe)

Platform Support

• Windows compatibility for atomic file operations (fe79efa)

Build

• Vendor all Go dependencies for reproducible builds (fdd2f75)

---

Reliability and concurrency improvements, introducing multi-instance coordination and background workers.

Concurrency

• Multi-instance awareness and coordination to prevent conflicts (8bf8118)
• Phase 1 background worker infrastructure with snapshot dedup (cd31623, 0b67acd)
• Async Phase 2 analysis notification (bb5c4bc)
• Prevent race conditions and panics in BackgroundWorker lifecycle (160ff93, 2e47a0a)
• Fix TOCTOU race condition in stale lock takeover (b544a31)

Security

• Prevent shell injection in editor file path (9cd383b)

Compatibility

• AdaptiveColor for light terminal mode support (761f4fb)
• Accept any non-empty IssueType for Gastown compatibility (f3cba6e)
• Windows installation support via PowerShell script (3d48d7a)

Testing

• Comprehensive fuzz testing for JSONL parser (3b0ed00)

---

Major release introducing the Tree View, tutorial system, cass (coding agent session search) integration, three-pane history layout, and AGENTS.md auto-injection.

Tree View

• Full file tree view with cursor-follows-viewport scrolling (7cae563, f514f95, e3ad293)
• Tree state persistence on expand/collapse (f54da8b, 8355e48)
• Scroll position indicator and windowed viewport rendering (a1b5e7c)
• Integrated with main app model (33a8618)

Tutorial System

• Multi-page tutorial with Glamour markdown rendering (187c022, 091a597)
• Beautiful UI layout and chrome (e218e97)
• Content: Introduction, Core Concepts, Views & Navigation, Advanced Features, Real-World Workflows (d8a055d, e3297fc, 3df90f1, 0a4d0de, 9573362)
• Tutorial progress persistence (9f5e51b)
• Space key entry point and CapsLock trigger detection (49fc7a9, 689455b)

Cass (Coding Agent Session Search) Integration

• Detection and health checking for local cass instances (beca14b)
• Search interface with safety wrappers and LRU result caching (24b4594, 5fddade)
• Session Preview Modal via V key (04c640a)
• Status bar session indicator (8c18b66)

History View Enhancements

• Adaptive three-pane layout (f374d48)
• Git-centric view mode (04dde17)
• Timeline visualization panel (b51608c)
• File-centric drill-down (f975c29)
• Lifecycle events display in detail pane (9ba1348)
• Search and filter infrastructure (6d2f89d)
• Statistics header bar with badges (7c56a35)
• View mode toggle animation (db435cf)
• Keyboard navigation improvements (37bf83e)
• Enhanced commit detail pane with rich display (358280e)

AGENTS.md Management

• Auto-detect and inject bv blurbs into project AGENTS.md files (35e5298, 4de28ca)
• Legacy blurb detection and migration support (f68d307)
• Prompt modal component and preference storage (61e1068, e123584)
• Atomic file operations for safe updates (738eebf)

Board View

• Detail panel with Tab toggle (22e55ae)
• Rich card content with improved info density (6753569)
• Visual dependency indicators with color-coded borders (f9c754f)
• Swimlane grouping modes (0c23321)
• Filter keys (o/c/r) in board view (60dabe2)
• Inline card expansion (966f513)
• Column statistics in headers (053999d)
• Smart empty column handling (b827f64)

Correlation & Impact Analysis

• Impact network graph for bead correlation (7729029)
• Related work discovery (1c92d8f)
• Temporal causality analysis (a941fbd)
• File co-change pattern detection (9b58387)
• Orphan commit detection with smart heuristics (8a01220)
• Change impact analysis for agents (25fe4e5)
• Correlation confidence audit (f279882)
• Blocker chain visualization and --robot-blocker-chain command (b18a1cf)
• File-bead reverse index for history view (382a90f)

Context Help

• Context-specific help system (c0e83e1)
• Context detection system (021e044)

Export & Viewer

• Pure-Go SQLite with built-in FTS5 support (replaces CGO dependency) (eda80f0)
• Vendor all CDN dependencies for offline use (0fe11cd)
• Auto-add .bv to .gitignore (6921e11)

UI Polish

• Redesign flow matrix as interactive dashboard (3381324)
• Scrollable detail panel with viewport in Insights (b9bdc71)
• Enhanced label picker with count-based sorting (9983300)

---

Documentation and TUI corrections, plus Nix flake for reproducible builds.

TUI

• Correct Board view context help -- L jumps to last column, not label picker (122a08a)
• Fix keyboard shortcut inconsistencies in help/tutorial (c125906)
• Restore focus to label picker and time travel input after help (1769970)
• Multiple TUI fixes for focus, detail view, and design field (686fad4)

Self-Update

• TUI update modal with false-positive prevention for dev builds (8b8bc01, da0abad)
• Handle restore-from-backup error in update flow (8f64e9c)

Build

• Add Nix flake for reproducible builds and development (ceb993a)
• Change Version from const to var for ldflags support (8b08c46)

---

Embed viewer assets in binary for self-contained --pages export.

Export

• Embed viewer assets in binary so --pages export works without external files (d537ba5)

Analysis

• Use normalizedFiles length in correlation ImpactAnalysis (1c4c0fb)

---

Enhanced static HTML viewer with mobile support.

Static HTML Viewer

• Arrow key navigation, enhanced heatmap, and mobile help modal (5a8c94c)

---

Major release introducing hybrid search with graph-aware ranking across both the TUI and static export.

Hybrid Search

• Core types with weighted scoring model (7956d47)
• Metrics cache and query-adaptive weight adjustment (4cbd453)
• CLI hybrid search integration and search configuration (87981a0)
• Graph-aware ranking in static export with optional WASM scorer (8ba75d8, 61a93f7)

TUI Fixes

• Escape key properly closes label picker before quit confirm (bff5876)
• Clear isHistoryView when switching to other views (04299d6)

---

Rapid patch release fixing E2E test compatibility on Linux.

Testing

• Support Linux script command syntax for TUI E2E tests (ebfdcf0)

---

Escape key fix in label picker.

TUI

• Escape key now properly closes label picker before triggering quit confirm (bff5876)

---

Mobile-responsive static export and native lipgloss tutorial components.

Static HTML Export

• Mobile-responsive UI and advanced graph metrics (53da0ca)

TUI

• Replace ASCII art tutorial with native lipgloss component system (6fe88ed)

---

Heatmap mode, dynamic force graph layout, and overhauled detail pane typography in the static export.

Static HTML Export

• Heatmap mode with gold glow hover highlighting (63d43dd)
• Integrate heatmap controls and switch to dynamic force layout (5ea0df6)
• Overhaul detail pane UI and add prose typography system (d570f02)
• Pre-computed graph layout and detail pane for pages export (a0d7169)

Robustness

• Add nil checks in sqlite_export.go to prevent panics (bdc7527)
• Fix deadlock in FeedbackData weight retrieval methods (13c3c6a)
• Add 100ms ready timeout to prevent startup hang (2b72b34)

---

Test hardening and coverage improvements; no user-facing feature changes.

Testing & CI

• Coverage gates and Codecov wiring (e9f795e)
• Broaden UI edge coverage, harden robot CLI flags, expand recipe filter/sort tests (8e5efd4, 70bd854, 477825d)
• Extend analysis cache/graph and hooks loader coverage (5783560)
• Add hook loader/executor edge cases (missing file, empty cmd, timeout) (60b33bc)
• Deflake git loader cache expiry timing (9fc5f9c)

Analysis

• Support unbounded track IDs in execution plan (443162e)
• Refresh insights panel when toggled (f531f4e)

---

Module path correction after the v0.10.0 rename.

Build

• Update module path and bump version to v0.10.1 (ad84b1b)
• Resolve syntax error in diff.go and correct README install URL (eca1623)

---

Build fix release; no functional changes beyond test coverage.

---

Checkpoint release preserving in-progress work; no major user-facing changes.

---