Fold SPEC/maven/ROADMAP into DESIGN.md and drop the stale session logs
15 root markdown files, ~4,900 lines against ~33,000 lines of Go, with at least three pairs contradicting each other. When five documents describe the architecture, the code becomes the only trustworthy one — which defeats the point of having them. That drift is why the resident-model question had four incompatible answers. SPEC.md, maven.md and ROADMAP.md are deduped into DESIGN.md rather than concatenated, with a "Superseded" section carrying eight retired decisions and what replaced each: classifier-owns-the-route (the cascade is still the live path, but as a stopgap, not a design to extend), faster-whisper/vosk/silero, the small-model phrasing claim, sqlcipher, the Kotlin/Spring sketches, obsidian->chroma, script deployment, and FloorEnrollment. Superseded material is kept and marked rather than deleted, so it cannot read as current. SESSION-05/06-07-2026.md and PLANS.md are removed outright — git history holds them, and both were verified tracked before deletion. Go doc comments citing the deleted files are repointed to the equivalent DESIGN.md sections. Several asserted designs that were already retired, so the claims are corrected and not just relinked: stt.go named faster-whisper as production (it is whisper.cpp), tts.go named silero (it is piper), intent.go still described the classifier as owning the route, and stale vosk/chroma vocabulary is replaced. ECOSYSTEM-SPEC.md references are deliberately untouched — that is a different document, and a naive grep for SPEC.md matches it. Root markdown drops from 4,880 to ~3,700 lines. The review's ~1,500 target is not reachable while keeping the files it also said to keep — those alone are 2,553 lines — so trimming further needs a separate decision on MAVEN_ECOSYSTEM_ARCHITECTURE.md and PROGRESS.md. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01X5JApcrCRVGmqrxnhynSik
This commit is contained in:
+10
-11
@@ -9,23 +9,22 @@
|
||||
// audio bytes for a tiny bit of variation per utterance; the *content*
|
||||
// of the audio doesn't matter, only the wire shape round-trips.
|
||||
//
|
||||
// - Remote: dials a worker module process at a unix socket (cmd/mavsttd
|
||||
// today; a faster-whisper / vosk-backed process when models land). The
|
||||
// swap is one constructor change at the daemon seam; the boundary is the
|
||||
// same.
|
||||
// - Remote: dials a worker module process at a unix socket (cmd/mavsttd,
|
||||
// whisper.cpp-backed). The swap is one constructor change at the daemon
|
||||
// seam; the boundary is the same.
|
||||
//
|
||||
// The Daemon picks the implementation from config. With no models on disk,
|
||||
// it wires Stub (the audio path is "live" end to end, the transcribe step
|
||||
// returns a canned string the router + action path operate on); with a
|
||||
// worker socket configured, it wires Remote.
|
||||
//
|
||||
// Per spec (maven.md § stt/tts): faster-whisper small/int8 is the production
|
||||
// stt; vosk-ru runs on the client (wake-word + stage-0 grammar), not here.
|
||||
// The server-side stt module is the heavy multilingual path; vosk's
|
||||
// stage-0 grammar hits the router directly via the client's stage-0 surface
|
||||
// and never crosses this seam — that path is post-MVP (the client doesn't
|
||||
// exist yet). Today's Remote + Stub both return plain text the router
|
||||
// classifies.
|
||||
// Per DESIGN.md § Voice pipeline (STT / TTS): whisper.cpp (CGo, Vulkan) in
|
||||
// cmd/mavsttd is the production stt — the older faster-whisper/vosk picks are
|
||||
// retired (DESIGN.md § Superseded, "named STT/TTS model picks"). The
|
||||
// server-side stt module is the heavy multilingual path; the client's
|
||||
// wake-word + stage-0 command grammar (cmd/mavwaked) hits the router directly
|
||||
// and never crosses this seam. Today's Remote + Stub both return plain text
|
||||
// the router classifies.
|
||||
package stt
|
||||
|
||||
import (
|
||||
|
||||
Reference in New Issue
Block a user