gemstone-nexus · Phase 6

Decisions

Architecture and product decisions from DecisionLog.

idphasecategorydecisionmade_bycreated_atrationalealternatives
1phase-3-portarchitectureGemStone sovereign inference: Ollama default (GPU); Gemini only in development modeagent2026-07-21 17:31:30Protocol Alpha-W western-origin stack. Voice via Whisper STT + Piper TTS. Audio transport only — never persisted. All interactions logged to AgentSessionLog, RawCapture, and DecisionLog in the standalone GemStone ledger.
2phase-3-portarchitectureGemStone conversational voice: always-on wake phrase listening after opt-in, barge-in during TTS, sovereign Piper TTS defaultagent2026-07-21 17:31:30Wake phrase 'Hey Gemstone' (configurable via GEMSTONE_WAKE_PHRASES). Primary STT: Web Speech API continuous on HTTPS. Fallback: Whisper + VAD chunks. Barge-in stops Piper playback and aborts chat stream. Voices listed at /mcp/gemstone/voice/voices. Cloud TTS only in development mode with explicit toggle. Wake events logged to RawCapture and AgentSessionLog.
3phase-3-portarchitectureGemStone dev mode: Gemini voice TTS + general Q&A interim strategyagent2026-07-21 17:31:30When GEMSTONE_INFERENCE_MODE=development (UI Dev toggle): chat uses Gemini with general-purpose Q&A allowed; voice output uses gemini-2.5-flash-preview-tts via generativelanguage generateContent (GEMINI_API_KEY). Whisper STT unchanged. Sovereign mode unchanged: Ollama + Piper, ledger-grounded only.
4phase-3-portarchitectureDev External real-time data via Google Search groundingagent2026-07-21 17:31:30When GEMSTONE_INFERENCE_MODE=development, GEMSTONE_DEV_GENERAL_QA=true, and GEMSTONE_DEV_REALTIME_DATA=true, GemStone chat and voice use Gemini google_search grounding for current events, live facts, and web information. Grounding sources are logged to AgentSessionLog.ledger_queries. Sovereign mode never enables external real-time sources — ledger-grounded Ollama only.
5phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-21 21:04:17Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
6phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-21 21:29:33Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
7phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-21 21:49:18Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
8phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 00:15:29Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
9phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 00:29:58Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
10phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 14:29:46Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
11phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 15:26:41Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
12phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 15:45:03Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
13phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 17:00:30Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
14phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-22 18:15:53Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
15phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-23 13:32:18Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
16phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-23 16:12:45Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
17phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-23 16:28:06Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
18phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-07-23 16:34:30Development: Gemini chat + natural voice TTS + general Q&A. Whisper STT unchanged.
19phase-3-portarchitectureGemStone inference mode switched: development → sovereignhuman2026-11-12 13:42:53Sovereign: Ollama + Piper TTS; ledger-grounded answers only.
20phase-3-portarchitectureGemStone inference mode switched: sovereign → developmenthuman2026-11-12 13:45:31Development: Gemini chat + Live conversation; Whisper turns use fast local TTS.