How vishwanath-06/speak-to-repo works
Speak-to-Repo turns recorded design reviews and live voice overrides into repository-grounded architecture diagrams, patches, and ADRs. Its main workflow harvests repository symbols to bias speech recognition, indexes source and timestamped meeting segments, retrieves relevant material for compilation, and presents or records the resulting artifacts. The live studio and event-sourced CLI are separate entry points into that workflow. The README documents several studio behaviors beyond the sampled excerpts; edges for those are cited to the README, while unsampled implementation details are not inferred.
Main entry points: demo_studio.py Live Studio · gemma_indexer.py Vector Indexer · cordis_session_runner.py Session Runner · repo_compiler.py Artifact Compiler
Components 16
Review Ingestion
- Voice Ingest
workers/whistle_ingest.py - AST Symbols
workers/ast_extractor.py - Timed Transcript
storage/transcripts
Repository Grounding
- Vector Indexer
workers/gemma_indexer.py - Gemma Embedder
workers/gemma_indexer.py - LanceDB Index
- Target Repository
Compilation
- Artifact Compiler
workers/repo_compiler.py - Mermaid Topology
workers/repo_compiler.py - Unified Git Patch
scripts/demo_studio.py - Compiled ADR
storage/compiled_docs
User Interfaces
- Live Studio
scripts/demo_studio.py - Session Runner
scripts/cordis_session_runner.py - Session Events
storage/sessions/session_events.jsonl
Other components
- Engineer
- Browser User
Connections 20
- Engineer → Live Studio: uses
README.md - Engineer → Session Runner: starts session
README.md - Live Studio → Voice Ingest: transcribes override
README.md - Voice Ingest → AST Symbols: harvests keywords
workers/whistle_ingest.py - Voice Ingest → Timed Transcript: writes segments
workers/whistle_ingest.py - Target Repository → Vector Indexer: indexes source
README.md - Timed Transcript → Vector Indexer: indexes segments
README.md - Vector Indexer → Gemma Embedder: embeds records
workers/gemma_indexer.py - Gemma Embedder → LanceDB Index: writes vectors
README.md - Live Studio → Vector Indexer: queries index
README.md - Artifact Compiler → Vector Indexer: retrieves matches
workers/repo_compiler.py - Artifact Compiler → Target Repository: reads source context
workers/repo_compiler.py - Artifact Compiler → Mermaid Topology: renders topology
workers/repo_compiler.py - Live Studio → Unified Git Patch: compiles override
README.md - Live Studio → Compiled ADR: presents ADR
README.md - Session Runner → Voice Ingest: runs ingest
scripts/cordis_session_runner.py - Session Runner → Vector Indexer: runs indexing
scripts/cordis_session_runner.py - Session Runner → Artifact Compiler: runs compilation
scripts/cordis_session_runner.py - Session Runner → Session Events: appends events
scripts/cordis_session_runner.py - Browser User → Live Studio: opens studio
README.md