Phase 1 foundation: Tauri shell, Python sidecar, SQLite database

Tauri v2 + Svelte + TypeScript frontend:
- App shell with workspace layout (waveform, transcript, speakers, AI chat)
- Placeholder components for all major UI areas
- Typed stores (project, transcript, playback, AI)
- TypeScript interfaces matching the database schema
- Tauri bridge service with typed invoke wrappers
- svelte-check passes with 0 errors

Rust backend:
- Tauri v2 app entry point with command registration
- SQLite database layer (rusqlite with bundled SQLite)
  - Full schema: projects, media_files, speakers, segments, words,
    ai_outputs, annotations (with indexes)
  - Model structs with serde serialization
  - CRUD queries for projects, speakers, segments, words
  - Segment text editing preserves original text
  - Schema versioning for future migrations
  - 6 tests passing
- Command stubs for project, transcribe, export, AI, settings, system
- App state management

Python sidecar:
- JSON-line IPC protocol (stdin/stdout)
- Message types: IPCMessage, progress, error, ready
- Handler registry with routing and error handling
- Ping/pong handler for connectivity testing
- Service stubs: transcribe, diarize, pipeline, AI, export
- Provider stubs: local (llama-server), OpenAI, Anthropic, LiteLLM
- Hardware detection stubs
- 14 tests passing, ruff clean

Also adds:
- Testing strategy document (docs/TESTING.md)
- Validation script (scripts/validate.sh)
- Updated .gitignore for Svelte, Rust, Python artifacts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

python/tests/test_handlers.py

@@ -0,0 +1,43 @@
+"""Tests for message handler routing."""
+
+from voice_to_notes.ipc.handlers import HandlerRegistry, ping_handler
+from voice_to_notes.ipc.messages import IPCMessage
+
+
+def test_ping_handler():
+    msg = IPCMessage(id="req-1", type="ping", payload={"hello": "world"})
+    response = ping_handler(msg)
+    assert response.type == "pong"
+    assert response.id == "req-1"
+    assert response.payload["echo"] == {"hello": "world"}
+
+
+def test_registry_routes_to_handler():
+    registry = HandlerRegistry()
+    registry.register("ping", ping_handler)
+    msg = IPCMessage(id="req-1", type="ping", payload={})
+    response = registry.handle(msg)
+    assert response is not None
+    assert response.type == "pong"
+
+
+def test_registry_unknown_type():
+    registry = HandlerRegistry()
+    msg = IPCMessage(id="req-1", type="nonexistent", payload={})
+    response = registry.handle(msg)
+    assert response is not None
+    assert response.type == "error"
+    assert response.payload["code"] == "unknown_type"
+
+
+def test_registry_handler_exception():
+    def bad_handler(msg: IPCMessage) -> IPCMessage:
+        raise ValueError("something broke")
+
+    registry = HandlerRegistry()
+    registry.register("bad", bad_handler)
+    msg = IPCMessage(id="req-1", type="bad", payload={})
+    response = registry.handle(msg)
+    assert response is not None
+    assert response.type == "error"
+    assert response.payload["code"] == "handler_error"

python/tests/test_messages.py

@@ -0,0 +1,50 @@
+"""Tests for IPC message types."""
+
+from voice_to_notes.ipc.messages import (
+    IPCMessage,
+    error_message,
+    progress_message,
+    ready_message,
+)
+
+
+def test_ipc_message_to_dict():
+    msg = IPCMessage(id="req-1", type="ping", payload={"key": "value"})
+    d = msg.to_dict()
+    assert d == {"id": "req-1", "type": "ping", "payload": {"key": "value"}}
+
+
+def test_ipc_message_from_dict():
+    data = {"id": "req-1", "type": "ping", "payload": {"key": "value"}}
+    msg = IPCMessage.from_dict(data)
+    assert msg.id == "req-1"
+    assert msg.type == "ping"
+    assert msg.payload == {"key": "value"}
+
+
+def test_ipc_message_from_dict_missing_fields():
+    msg = IPCMessage.from_dict({})
+    assert msg.id == ""
+    assert msg.type == ""
+    assert msg.payload == {}
+
+
+def test_progress_message():
+    msg = progress_message("req-1", 50, "transcribing", "Processing...")
+    assert msg.type == "progress"
+    assert msg.payload["percent"] == 50
+    assert msg.payload["stage"] == "transcribing"
+
+
+def test_error_message():
+    msg = error_message("req-1", "not_found", "File not found")
+    assert msg.type == "error"
+    assert msg.payload["code"] == "not_found"
+    assert msg.payload["message"] == "File not found"
+
+
+def test_ready_message():
+    msg = ready_message()
+    assert msg.type == "ready"
+    assert msg.id == "system"
+    assert "version" in msg.payload

python/tests/test_protocol.py

@@ -0,0 +1,38 @@
+"""Tests for IPC protocol JSON-line encoding/decoding."""
+
+import io
+import json
+
+from voice_to_notes.ipc.messages import IPCMessage
+from voice_to_notes.ipc.protocol import read_message, write_message
+
+
+def test_write_message(capsys):
+    msg = IPCMessage(id="req-1", type="pong", payload={"ok": True})
+    write_message(msg)
+    captured = capsys.readouterr()
+    parsed = json.loads(captured.out.strip())
+    assert parsed["id"] == "req-1"
+    assert parsed["type"] == "pong"
+    assert parsed["payload"]["ok"] is True
+
+
+def test_read_message(monkeypatch):
+    line = json.dumps({"id": "req-1", "type": "ping", "payload": {}}) + "\n"
+    monkeypatch.setattr("sys.stdin", io.StringIO(line))
+    msg = read_message()
+    assert msg is not None
+    assert msg.id == "req-1"
+    assert msg.type == "ping"
+
+
+def test_read_message_eof(monkeypatch):
+    monkeypatch.setattr("sys.stdin", io.StringIO(""))
+    msg = read_message()
+    assert msg is None
+
+
+def test_read_message_invalid_json(monkeypatch):
+    monkeypatch.setattr("sys.stdin", io.StringIO("not json\n"))
+    msg = read_message()
+    assert msg is None