feat: Dossier Desktop — Tauri app with embedded Next.js UI

[ruvnet]

Summary

• Adds a Rust/Tauri 2.x desktop application that wraps the real Dossier Next.js UI into a native window
• Tauri binary spawns the Next.js standalone server on startup, waits for TCP readiness, then navigates the webview to http://127.0.0.1:{port}
• Includes pure-Rust HNSW vector index (wyr-ruvector), WYR preference-learning game engine (wyr-core), and RVF binary format inspector
• 17 Tauri IPC commands: 6 WYR game, 9 Dossier DB CRUD, 1 RVF inspector, 1 HNSW stats
• Rust SQLite adapter (rusqlite bundled) compatible with Dossier's existing schema
• 10 passing tests, 0 clippy warnings
• Windows release binary: ~10MB, NSIS installer: ~2.5MB

Closes #3

Architecture

The Tauri shell acts as a lightweight native wrapper:

1. Startup: Shows splash screen → finds node + .next/standalone/server.js → spawns server → polls port readiness
2. Ready: Navigates webview to http://127.0.0.1:{port} — loads the full Dossier React UI with all components, API routes, and AI orchestration
3. Shutdown: Kills the Node.js server process on window close

Tauri Binary (Rust)
├── wyr-ruvector  — HNSW vector index (cosine similarity, KNN search)
├── wyr-core      — WYR game engine (16 questions, 8 categories, EMA profiles)
└── wyr-app       — Tauri shell
    ├── Next.js server launcher (spawn, port discovery, TCP poll)
    ├── Dossier DB adapter (rusqlite, 7 tables, full CRUD)
    ├── RVF inspector (24 segment types, 64-byte aligned)
    └── 17 Tauri IPC commands

Platform Build Targets

Platform	Binary	Installer	Status
Windows x64	wyr-app.exe (~10MB)	NSIS .exe (~2.5MB)	Tested
Windows ARM64	wyr-app.exe	NSIS .exe	Needs cross-compile
macOS x64	Dossier Desktop.app	.dmg	Needs macOS CI
macOS ARM64	Dossier Desktop.app	.dmg	Needs macOS CI
Linux x64	dossier-desktop	.deb / .AppImage	Needs Linux CI

Build Instructions

# Prerequisites: Rust stable, Node.js v18+, pnpm
# On Windows: RUSTUP_TOOLCHAIN=stable-x86_64-pc-windows-msvc

# 1. Build the Next.js standalone app
pnpm install && pnpm run build

# 2. Build & run the Tauri desktop app
cd wyr && cargo run --package wyr-app

# 3. Run tests (10 passing)
cd wyr && cargo test

# 4. Clippy (0 warnings)
cd wyr && cargo clippy

# 5. Release build with installer
cd wyr/wyr-app && cargo tauri build

Key Files

File	Lines	Description
wyr/wyr-app/src/lib.rs	270	Tauri setup: spawn Next.js, navigate webview
wyr/wyr-app/src/commands.rs	215	17 Tauri IPC commands
wyr/wyr-app/src/dossier_db.rs	328	Rust SQLite adapter (CRUD)
wyr/wyr-app/src/rvf_inspector.rs	177	RVF binary parser (24 segment types)
wyr/wyr-app/src/schema.sql	70	Dossier-compatible SQLite schema
wyr/wyr-ruvector/src/hnsw.rs	266	Full HNSW graph index
wyr/wyr-ruvector/src/vector.rs	79	Vector type + arithmetic
wyr/wyr-ruvector/src/similarity.rs	54	Cosine similarity, Euclidean distance
wyr/wyr-core/src/engine.rs	94	GameEngine (next_question, answer)
wyr/wyr-core/src/question.rs	120	16 seed questions, 8 categories
wyr/wyr-core/src/preference.rs	119	EMA profiles, HNSW answer history

Test Results

running 10 tests
test wyr_ruvector::vector::tests::test_vector_new ............. ok
test wyr_ruvector::vector::tests::test_vector_normalize ....... ok
test wyr_ruvector::vector::tests::test_vector_add_scale ....... ok
test wyr_ruvector::similarity::tests::test_cosine_identical ... ok
test wyr_ruvector::similarity::tests::test_cosine_orthogonal .. ok
test wyr_ruvector::similarity::tests::test_cosine_opposite .... ok
test wyr_ruvector::similarity::tests::test_euclidean .......... ok
test wyr_ruvector::hnsw::tests::test_insert_and_len .......... ok
test wyr_ruvector::hnsw::tests::test_search .................. ok
test wyr_ruvector::hnsw::tests::test_get_vector .............. ok

test result: ok. 10 passed; 0 failed; 0 ignored
cargo clippy: 0 warnings

Test plan

• cargo test — 10 tests pass (vector, similarity, HNSW, game engine)
• cargo clippy — 0 warnings
• cargo build --release — builds successfully on Windows x64
• App launches, splash screen shows, Next.js server starts on port 3000
• Webview navigates to Dossier UI after server readiness
• Next.js standalone server responds with HTTP 307 (redirect to default project)
• macOS build (requires macOS CI runner)
• Linux build (requires Linux CI runner)
• Windows ARM64 cross-compile
• Tauri bundle installer (cargo tauri build)

🤖 Generated with claude-flow

[vercel]

@rwliebs is attempting to deploy a commit to the richardliebrecht-gmailcom's projects Team on Vercel.

A member of the Team first needs to authorize it.