bv v0.21.0

Features

• defer_until is honored everywhere (#191): beads with a future
  defer_until are now withheld from every ready surface — --recipe actionable, triage top picks, track/label picks, --robot-next
  claimability (with an explicit "deferred until" reason), and the execution
  plan. Past-dated and absent defer_until behave as before, and the field
  loads on JSONL and both SQLite schema paths.

Performance

• --robot-insights per-entry disk cache (v3 layout) (#192): the cached
  path could be slower than --no-cache because cache validation walked the
  entire .beads/ tree per lookup and the single-file cache decoded and
  rewrote every entry of every repo on each hit. Validation now stats only
  top-level .beads/ entries, and the cache is a per-entry layout with atomic
  rename writes, lock-free single-entry reads, mtime-based pruning, and
  corrupt/foreign-entry reaping. The legacy single-file cache is retired.

Fixes

• Robot mode no longer silently drops invalid issues (#190): issues
  failing validation (e.g. updated_at < created_at) and JSONL parse drops
  are surfaced in a load_stats block on every hand-rolled robot JSON
  surface, so absence is distinguishable from "nothing to do". An
  end-to-end test pins the inverted-timestamp case.

Install / Upgrade

curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/beads_viewer/main/install.sh | bash
# or, from an existing install:
bv --update

Full Changelog: v0.20.0...v0.21.0

bv v0.20.0

Features

• --id-pattern (#188): custom bead-ID regex for trackers whose IDs lack a
  numeric suffix, so correlation works with non-standard ID schemes out of the
  box.

Fixes

• bd embedded Dolt workspaces are first-class (#189): the loader now treats
  bd's embedded Dolt workspace layout as a real datasource instead of falling
  through to an unhelpful error; robot-mode surfaces work against Dolt-backed
  beads databases.
• Actionable bd-export error message: failures during bd export now say
  what went wrong and what to do about it, instead of a bare error.

Tests

• Pinned regression coverage for the #188 and #189 behaviors.

bv v0.19.0

Features

• --robot-triage --brief (#183): compact triage output mode for agents that
  only need the headline recommendations, not the full analysis payload.
• Comments in Pages export (#187): the static Pages export now renders bead
  comment threads, so exported boards carry the full discussion context.

Fixes

• Robot-surface agreement / agent-safety (#184): --robot-file-hotspots,
  --robot-file-beads, and --robot-impact disagreed for the same path
  (3 vs 0 vs "safe to proceed"). File-touching bead counts are now unified
  across all three surfaces — no more false "safe to proceed" verdicts
  steering agents into files with open beads.
• Theme override completion: reliable --theme light|dark selection for
  light terminals (bv-128).
• Fail-closed robot-next claims: --robot-next claimability no longer
  fails open (bd-ifoh3.3).
• Export memory (#182): history blobs stream with bounded memory; caches
  enabled off-robot.
• Gitignore hygiene (#179): prefers .git/info/exclude and adds a
  BV_NO_GITIGNORE opt-out.
• Viewer: routes host-rewritten clean paths and guards double WASM init on
  direct graph entry.

Changelog

• 584a14b feat(cli): add bv upgrade subcommand for self-update (#177)
• 33f5440 fix(agent-blurb): generate current Beads workflow guidance
• 380f180 fix(export): prune orphaned chunk files when an export shrinks (#175)
• 011f76e fix(ui): type lowercase q into label-filter picker instead of quitting (#176)
• 44a8e8d release(version): bump hardcoded fallback to v0.18.0

Full Changelog: v0.17.0...v0.17.1

Changes since v0.16.4

550fb23 chore(release): v0.17.0 — robot-path perf overhaul, fixes, dep refresh
38d093a feat(ui): left-click to focus panel and select row (bv-162)
8dcf388 fix(perf-review-2): negative-index panic + per-commit cache self-wipe
8eb099e test: probe custom JSON codec for pointer historyArtifact cache entries
10c9c24 fix(perf-review): 6 bugs found in fresh-eyes review of the optimization passes
02af07f skill-loop: pass 14 complete; full suite green (e2e incl), all gates clean
017f6ac docs(perf): final scenario matrix after pass 14 (co-commit incremental)
d033a18 skill-loop: mark pass-14 verification tasks done
2831c57 test(perf): date-stable golden normalizer (day-count fields) + pass-14 tracker
5c483de docs(perf): record pass 14 co-commit incremental cache in hotspot table
7e8a6bd perf(correlation): persistent per-commit co-commit cache; new-commit path skips co-commit git log (#161)
f42388e perf(docs): record cold-path passes 11-13 scenario matrix
609912f perf(correlation): content-addressed per-commit extraction cache
f2383c5 perf(correlation): goccy for parseBeadJSON (drop stdlib checkValid pass)
d02f5cb perf(correlation): split cache so bead edits don't bust HEAD-only extraction
6e121b2 skill-loop: extend with cold-path passes 11-13 (user-approved)
bb91105 perf(docs): record final 10-pass A/B results (orig vs final)
ff1bc91 perf(loader): size-gated morsel-driven parallel JSONL parse
d44ae38 skill-loop: record pass 9
a38697b perf(analysis): compute data hash once per robot invocation

Performance release: a profile-driven overhaul of the agent-facing robot path makes repeat --robot-* calls roughly 25× faster (warm triage ~2.3 s → ~0.09 s) and cuts git subprocesses from ~340 to 3 — all while keeping output byte-identical (verified by golden and differential tests). Also bundles the correctness fixes and a fresh-eyes bug-review pass found during the optimization work, plus a routine dependency refresh.

Added

• TUI: left-click now focuses a panel and selects the row under the cursor, with precise geometry inversion for split and single-column list views (drags and out-of-range clicks are ignored) (bv-162).

Performance — Robot Path (--robot-triage / --robot-next / --robot-plan / --robot-insights)

• Correlation (the dominant former hotspot): replaced ~2 git show per commit with 2 batched git log calls; extract bead lifecycle via deduped --raw blob snapshots instead of git log -p; added a persistent correlation result cache keyed on HEAD + beads-hash + opts so repeat calls skip git extraction entirely. Cold-path: split the cache so working-tree bead edits no longer bust the HEAD-only extraction, and added content-addressed per-commit event and co-commit caches keyed by immutable commit SHA, so advancing HEAD only processes the new commits (#160, #161).
• Analysis disk cache: no longer rewrites the whole cache file on a read-hit; switched to goccy/go-json streaming codec; adopted a columnar struct-of-arrays on-disk shape (v2, ~44 % smaller).
• Loader / datasource: parse issues.jsonl once on the robot path (fused load + validation via a typed probe), memoize the data hash per invocation, and added a size-gated (≥ 4 MiB) parallel JSONL parse for large stores.

Fixed

• triage: exclude unblocked parent-child rollup edges from blocked_by (#158).
• watch: coalesce --watch-export with adaptive backoff and skip exports via the canonical content + dependency hash (#159).
• Fresh-eyes review (output-preserving): restored commit BeadIDs dropped from the HEAD artifact cache; rejected a fresher empty/non-issue JSONL from shadowing the real issues.jsonl; fixed parallel-parser ParseStats merge and an off-by-one max-capacity line boundary; stopped a transient git failure from poisoning the co-commit cache; fixed a possible readBlobs deadlock on a cat-file parse error; fixed a negative-index panic and a per-commit cache self-wipe.

Dependencies

• Updated 7 direct dependencies (git.sr.ht/~sbinet/gg, mattn/go-runewidth, golang.org/x/{image,sync,sys,term}, modernc.org/sqlite) and re-vendored canonically. See UPGRADE_LOG.md.

Changelog

• d07839c fix(release): install GoReleaser v2 so the version:2 config publishes

Patch release focused on updater correctness, release artifact reliability, and hardening fixes found during fresh-eyes review passes.

Updater & Versioning

• Ignore update notices whose release tag is equal to or older than the running version, including tags with stray whitespace.
• Clear stale in-session update banners when a later update check resolves to the current version.
• Label the footer badge as Update vX.Y.Z so it is not confused with the running bv --version value.
• Avoid redundant update checks after a recent successful check.
• Accept stable release archive names in the updater.

Build & Release

• Align release archive aliases and publish Linux, macOS, and Windows assets with checksums.
• Keep GoReleaser snapshot builds from double-prefixing versions as vvX.Y.Z-next.
• Update the Homebrew tap formula to 0.16.2.

Robustness

• Preserve completed history searches and coalesce queued background refreshes in the TUI.
• Harden correlation, datasource, export, hooks, search, and analysis edge cases from recent review passes.

Patch release focused on updater correctness, release artifact reliability, and hardening fixes found during fresh-eyes review passes.

Updater & Versioning

• Ignore update notices whose release tag is equal to or older than the running version, including tags with stray whitespace.
• Clear stale in-session update banners when a later update check resolves to the current version.
• Label the footer badge as Update vX.Y.Z so it is not confused with the running bv --version value.
• Avoid redundant update checks after a recent successful check.
• Accept stable release archive names in the updater.

Build & Release

• Align GoReleaser archive names with README latest/download aliases, publish Windows as a zip archive, and update the GoReleaser config to v2 syntax.
• Keep direct download aliases reproducible and version-aliased.
• Keep GoReleaser snapshot builds from double-prefixing versions as vvX.Y.Z-next.

Tests

• Harden background worker tests by waiting on worker state instead of fixed sleeps.

Robustness

• Preserve completed history searches and coalesce queued background refreshes in the TUI.
• Resolve historical --as-of dates from commit history and filter stale data sources by true newest time.
• Harden correlation batch-stat locking, git stream progress callbacks, EOF handling, temporal author filters, and tombstone lifecycle classification.
• Safely pair agent blurb removal markers.
• Recover stale unreadable instance locks.

Search, Hooks, Analysis & Export

• Score all bead statuses in hybrid search mode.
• Reject malformed hook timeout values.
• Normalize loaded feedback data for analysis.
• Escape interactive graph HTML, validate Cloudflare project names, keep Cloudflare suggestions nonempty, and fail stale or zero-issue deployment verification.
• Avoid shell browser launchers on Windows and strengthen GitHub deployment helper behavior before force-with-lease pushes.

Patch release focused on dependency freshness, reproducible vendored builds, and release metadata cleanup.

Highlights

• Updated Go module and vendored dependencies, including modernc.org/sqlite 1.50.1, fsnotify 1.10.1, pgregory.net/rapid 1.3.0, current golang.org/x/* packages, goldmark 1.8.2, chroma 2.24.1, and terminal-width/runtime helpers.
• Verified the local /dp/toon-go dependency is already at the latest local commit used by go.mod.
• Updated Rust/WASM lockfiles and moved bv-graph-wasm to getrandom 0.4 with the wasm_js feature.
• Bumped fallback, Nix, README, and changelog release metadata to v0.16.1.
• Kept transient .beads/.write.lock files ignored and out of release commits.
• Restricted ACFS notification workflow triggers to main.

Distribution

• Built and published via DSR because the GitHub Actions release queue was throttled.
• GitHub release assets include Linux amd64/arm64, macOS amd64/arm64, Windows amd64 zip/tar.gz/exe variants, SHA256SUMS, checksums.txt, and per-asset .sha256 sidecars.
• Homebrew tap Dicklesworthstone/homebrew-tap updated to 0.16.1.
• Scoop bucket Dicklesworthstone/scoop-bucket updated to 0.16.1.

Full diff: v0.16.0...v0.16.1

Patch release focused on dependency freshness, vendored reproducibility, and release metadata cleanup.

Dependencies

• Update Go module and vendored dependencies, including modernc.org/sqlite 1.50.1, fsnotify 1.10.1, pgregory.net/rapid 1.3.0, golang.org/x/* packages, goldmark 1.8.2, chroma 2.24.1, and terminal-width/runtime helpers.
• Verify the local /dp/toon-go dependency is already at the latest local commit used by go.mod.
• Update Rust/WASM lockfiles and move bv-graph-wasm to getrandom 0.4 with the wasm_js feature.

Build & Release

• Refresh fallback, Nix, README latest-download aliases, and changelog release metadata for v0.16.1.
• Restrict ACFS notification workflow triggers to main.
• Keep transient .beads/.write.lock files ignored and out of release commits.

Release focused on robot registry hardening, scoped graph/search workflows, static export improvements, and broad robustness fixes.

Features

• Phase-three robot registry with immutable snapshots and cache hardening.
• --robot-triage scoping via --graph-root subgraphs.
• Hybrid graph-aware ranking for static export search.
• Heatmap controls, dynamic force layout, improved graph navigation, and mobile help.
• JSONL reader and IssueReader interface for more flexible data loading.
• Smart terminal editor dispatch via O key for opening beads in $EDITOR (550f3bd)

Robustness

• Suppress spurious robot-mode success banners that polluted JSON consumers.
• Harden metrics cache singleflight behavior, worker snapshot publication, and concurrent status reads.
• Guard truncate() against negative/small max values and nil process handles (816f9c3)
• Guard against negative strings.Repeat and normalize whitespace status (a0a35ee)
• Preserve issue deep-links during cold load filter sync (81a1983)

Export & Graph

• Include downstream dependents in root-focused graph BFS.
• Pin graph node side panels reliably on click and add explicit open/close controls.
• Preserve explicit pages source files and safely confine preview file serving.
• Keep preview paths and status validation safe.

Robot Mode

• Add agent capability manifest and executable/canonical command forms.
• Align robot schema/envelope contracts across search, history, alerts, label, graph, burndown, forecast, diff, and recipe outputs.
• Respect claimability in triage top picks and publish safer command examples.

Data Source & Loader

• Load minimal SQLite schemas, honor explicit beads database files, and safely escape SQLite DSN paths.
• Accept legacy dependency field names and UUIDv7 comment IDs.
• Recognize SQLite database path extensions and handle canonical beads history paths.

Correlation & Search

• Preserve explicit history paths in caches and aggregate directory file references.
• Stop streaming git output after parse errors.
• Harden hybrid weights, short-query boosts, and vector index access.

UI & Workflow

• YAML frontmatter: single-pass unescape, escape all fields, fix body whitespace and labels handling (7a481b0, 90aa46e, c0f670b)

Patch release fixing Cloudflare Pages deployment on headless servers.

Deployment Fixes

• Check all wrangler config paths and handle refresh tokens (cf001ba)

Patch release for a wrangler auth hang discovered immediately after v0.15.0.

Deployment Fixes

• Fix wrangler auth check hanging on headless servers (4cc8635)

Major release focused on br/beads-rs compatibility, expanded status types, security hardening, and POSIX-compliant CLI flags.

Compatibility & Data Source

• Read labels from separate labels table for br/beads-rs SQLite compatibility (19437c4)
• Add --db flag and BEADS_DB env var for configuring database path (#125) (b56ddae)
• Migrate from Go flag to pflag for POSIX double-dash options (064b3d0)
• Complete bd-to-br command migration across all source and tests (f9ba482, 6bce598)

Status & Display

• Add color mappings for deferred, draft, pinned, hooked, review, and tombstone statuses (42d69f7, ce542b3)
• Improve footer text contrast across terminal themes (#128) (271cb10)
• Color-profile-aware styling for Solarized and 16-color terminals (cbbcb1f)
• Use terminal default background to prevent ANSI color mismap (#101) (2599cce)

Security

• Scope GitHub token to github.com domains to prevent credential leaking on redirects (ccd23d0)
• Trim whitespace from GitHub token env vars to prevent 401 errors (a148823)
• Add GITHUB_TOKEN support for self-update (#116, #117) (2ff6cab)

Board View

• Correct column width calculation to prevent line rendering glitch (#114) (08eb523)
• Allow board columns to shrink below 12 chars on very narrow terminals (e50be8a)
• Correct detail panel box drawing (2ff6cab)

Robot Mode & Agent Support

• Add --agents-* CLI flags for AGENTS.md blurb management (8e9c656)
• Normalize robot output envelope across all commands (23172a1)
• Apply recipe filtering before robot modes (dc6bfab)
• Upgrade agent blurb to v2 (ce542b3)

Version Detection

• Multi-source version detection with graceful fallback; filter pseudo-versions and dirty builds (ede65f2, 1bb3c27)
• Validate ldflags injection to prevent empty version output (#126) (087af33)

Triage & Analysis

• Transitive parent-blocked check in GetActionableIssues (b14e9c4)
• Invalidate robot triage disk cache when .beads/ directory changes (#127) (9464db4)
• Deep mtime scan via WalkDir for cache invalidation (d1e8233)

Deployment

• Add GitHub Pages and Cloudflare deployment support for static export (e60384b)
• Auto release notes CI workflow (#99) (2599cce)

License

• Update license to MIT with OpenAI/Anthropic Rider (81c2b94)

Expanded robot-mode CLI with additional machine-readable outputs.

Robot Mode

• Expand robot-mode commands with enhanced outputs and wizard support (ae2e2e7, 15e72df, 65f2708)

Security and reliability fixes for the static HTML export.

Security & Export

• XSS-escape title in HTML export, wrap errors, improve OPFS cache cleanup (005a220)
• Ensure SHA-256 hash is always computed for OPFS cache invalidation (d263a78)

Cache-busting fix for GitHub Pages deployments.

Export

• Add cache-busting to HTML <script> tags for GitHub Pages (fcf1b7f)

Prevent stale data on GitHub Pages updates.

Export

• Add cache-busting query strings to prevent stale data after updates (5cfd94a)

Major release introducing smart multi-source data detection, TOON format, live-reload preview, resizable split panes, and the --robot-docs / --robot-schema commands.

Data Sources

• Smart multi-source data detection: auto-detect JSONL, SQLite, and .beads/ directories (#88) (2016b25, af5499b)
• Prefer beads.jsonl over issues.jsonl for backward compatibility (87f36d7)
• Watch all repos in workspace mode (closes #79) (ac11e35)

TOON Output Format

• Add --format json|toon for token-optimized output in robot mode (4f5f032)
• Add --stats for bv robot output (ebfeb6f)

Robot Mode

• Add --robot-docs for machine-readable documentation (0c9f6a3)
• Add --robot-schema for JSON Schema output (9213bc5)
• Consistent RobotEnvelope wrapper across all robot commands (e6609dd)

Live Preview

• Live-reload via SSE for instant browser refresh during --preview (4b6a095)
• Fix Content-Length handling for SSE script injection (9a72ba7)
• Fix HTTP 408 timeout on large GitHub Pages pushes (a9594bf)

TUI

• Resizable split view panes (acf7568)
• Add y shortcut to copy bead ID in list view (a9ff252)
• Reset list cursor before filter refresh to prevent panic (3a1cde5)
• Preserve triage data across reloads (6aa9fbf)

Analysis & Triage

• Priority scoring for bead analysis and task triage (da11317)
• Compact adjacency graph for analysis performance (e16ee9b)
• Staleness analysis in robot-triage using git history (157c3c7)
• Support for review status (5fc1a70)
• Group tracks by topological depth instead of connected components (319b45e)

Installation

• Default install to ~/.local/bin to avoid requiring root (32785d4)

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)