release: v3.1.0 — Bijou (M13)

Interactive vault dashboard, animated progress bars, manifest
inspector, history timeline, encryption info cards, and chunk
heatmaps. New --quiet flag and GIT_CAS_PASSPHRASE env var.

Author: flyingrobots

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] — Bijou (2026-02-27)
+
+### Added
+- **Interactive vault dashboard** (`git cas vault dashboard`) — TEA-based TUI with split-pane layout, manifest detail view, keyboard navigation (`j`/`k`/`Enter`/`/`), and real-time filtering.
+- **Manifest inspector** (`git cas inspect <tree-oid>`) — renders manifest details with chunk table, encryption info, and compression badges.
+- **Progress bars** for `store` and `restore` operations — animated progress with throughput reporting, auto-disabled in non-TTY environments.
+- **History timeline** (`git cas vault history --pretty`) — color-coded, paginated timeline view of vault commit history.
+- **Encryption info card** (`git cas vault info --encryption`) — detailed KDF parameters and encryption configuration display.
+- **Chunk heatmap** — chunk-size distribution grid with colored legend, displayed in manifest detail views.
+- `--quiet` / `-q` flag to suppress all progress output.
+- `GIT_CAS_PASSPHRASE` environment variable — alternative to `--vault-passphrase` flag for passphrase-based encryption.
+- New runtime dependencies: `@flyingrobots/bijou`, `@flyingrobots/bijou-node`, `@flyingrobots/bijou-tui`.
+
+### Fixed
+- CLI `restore` now uses the canonical `readManifest` path instead of duplicating manifest resolution logic.
+- Progress trackers wrapped in `try`/`finally` to prevent event listener leaks when `storeFile` or `restoreFile` throws.
+- Dashboard filter and error lines clamped to pane width to prevent wrapping artifacts in narrow terminals.
+- Dashboard differentiates entry vs manifest load errors — a single manifest preload failure no longer sets global error state.
+- Dashboard clamps cursor position after applying filter on entry load.
+- Passphrase resolution uses nullish coalescing for correct falsy-value handling.
+- Locale-agnostic number formatting in encryption card tests.
+- Consolidated duplicated restore flag validation into `validateRestoreFlags()`.
+- Eliminated `vi.mock('node:fs')` pattern in progress tests for Bun Docker compatibility.
+
 ## [3.0.0] — Vault (2026-02-08)
 
 ### Added

README.md

@@ -44,11 +44,15 @@ We use the object database.
 
 See [CHANGELOG.md](./CHANGELOG.md) for the full list of changes.
 
-## What's new in v3.0.0
+## What's new in v3.1.0
 
-**Vault** — GC-safe ref-based storage. A single Git ref (`refs/cas/vault`) indexes all stored assets by slug, so `git gc` can no longer silently discard your data. Initialize with `vault init`, store with `--tree`, restore by `--slug`.
+**Interactive vault dashboard** — `git cas vault dashboard` launches a full TUI with split-pane layout, manifest detail view, keyboard navigation, and real-time filtering. Browse entries, inspect chunks, and view encryption status without memorizing CLI flags.
 
-**CLI breaking change** — `git cas restore` no longer takes a positional `<tree-oid>` argument. Use `--oid <tree-oid>` or `--slug <slug>` instead.
+**Progress bars** — `store` and `restore` now show animated progress with throughput reporting. Suppress with `--quiet`.
+
+**Pretty history** — `git cas vault history --pretty` renders a color-coded, paginated timeline of vault commits.
+
+**Inspect command** — `git cas inspect <tree-oid>` renders manifest details with chunk table, encryption info, and compression badges.
 
 See [CHANGELOG.md](./CHANGELOG.md) for the full list of changes.
 

ROADMAP.md

@@ -190,7 +190,7 @@ Return and throw semantics for every public method (current and planned).
 | v3.0.0  | M10       | Hydra    | Content-defined chunking | |
 | v3.1.0  | M11       | Locksmith | Multi-recipient encryption | |
 | v3.2.0  | M12       | Carousel | Key rotation | |
-| v3.3.0  | M13       | Bijou    | TUI dashboard & progress | |
+| v3.1.0  | M13       | Bijou    | TUI dashboard & progress | ✅ |
 
 ---
 
@@ -208,7 +208,7 @@ Shine    (v2.2.0)       │                          │
            │     (CDC benchmarks)
            │
            v
-    M13 Bijou (v3.3.0)
+    M13 Bijou (v3.1.0) ✅
     (TUI dashboard & progress)
 ```
 
@@ -225,7 +225,7 @@ Shine    (v2.2.0)       │                          │
 | M10| Hydra         | Content-defined chunking   | v3.0.0  | 4     | ~690   | ~22h  |
 | M11| Locksmith     | Multi-recipient encryption | v3.1.0  | 4     | ~580   | ~20h  |
 | M12| Carousel      | Key rotation               | v3.2.0  | 4     | ~400   | ~13h  |
-| M13| Bijou         | TUI dashboard & progress   | v3.3.0  | 6     | ~650   | ~20h  |
+| M13| Bijou         | TUI dashboard & progress   | v3.1.0  | 6     | ~650   | ~20h  |
 |    | **Total**     |                            |         | **26**| **~2,870** | **~89h** |
 
 ---
@@ -1714,7 +1714,7 @@ If that's what you want, nothing else does it. If it's not, the right tool proba
 
 ---
 
-# M13 — Bijou (v3.3.0)
+# M13 — Bijou (v3.1.0) ✅
 **Theme:** Beautiful terminal UI powered by `@flyingrobots/bijou`. Replace silent CLI operations with animated progress, and add an interactive vault dashboard for exploring stored assets. Depends on M9 Cockpit for the `--quiet` flag and event wiring foundation.
 
 ---

bin/git-cas.js

@@ -14,7 +14,7 @@ import { renderHeatmap } from './ui/heatmap.js';
 program
   .name('git-cas')
   .description('Content Addressable Storage backed by Git')
-  .version('3.0.0')
+  .version('3.1.0')
   .option('-q, --quiet', 'Suppress progress output');
 
 /**

jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-cas",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "exports": {
     ".": "./index.js",
     "./service": "./src/domain/services/CasService.js",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-cas",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Content-addressed storage backed by Git's object database, with optional encryption and pluggable codecs",
   "type": "module",
   "main": "index.js",