Para el próximo agente / la próxima sesión (incluido el Claude Code de la Pi): léeme primero, junto con
CLAUDE.md(brief permanente) ygit log --oneline -20. Este archivo resume la sesión larga en que se reconstruyó y endureció el proyecto tras perder la SD; los detalles técnicos viven enCLAUDE.md,INSTALL.mdy los mensajes de commit.
La microSD de la Raspberry Pi 4 murió y se perdieron ~3 días de trabajo
local no subido. Se reconstruyó y mejoró todo desde el repo. El código
está en main, todo con CI verde. La Pi nueva ya tiene SD; el próximo
paso real es el bring-up del hardware (ver INSTALL.md).
"Local para lo que protege, cloud para lo que encanta." Seguridad,
privacidad y resiliencia offline corren SIEMPRE local (detector de crisis
determinístico, SQLCipher, frases curadas pre-generadas, whisper.cpp de
fallback). Conversación y voz usan APIs cloud como primarias — la calidad
conversacional es el producto y un modelo local en Pi 4 la degradaría.
El SER local (emoción en audio) está diferido hasta tener datos de
campo; sus dependencias (torch/transformers) NO están en requirements.
requirements.txt es solo un puntero a requirements-pi-lite.txt.
- Instalación limpia (Fase 5) — deps faltantes en
requirements-pi-lite.txt(openai, Pillow, luma.oled, google-cloud-texttospeech); unidades systemd convertidas en plantillas (__RAKO_USER__/__RAKO_DIR__) +scripts/install_systemd.sh;INSTALL.mdde cero a funcionando. - Docs profesionales — README reescrito, HARDWARE/PRODUCTION_PLAN al día.
- Pipeline de voz unificado —
orchestrator/turn_session.py(TurnSession) es el pipeline compartido porRunLoopy el loop del botón (scripts/button_conversation.py): memoria, triage, persistencia con gate de privacidad, comando "recuerda que" con veto de crisis primero.FallbackTTS(degradación en runtime). - Backups —
rako-backup(snapshot cifrado con rotación) +rako-restore(restauración validada) + timer diario systemd. - Seguridad crítica — alerta REAL al contacto de confianza vía
WhatsApp con consentimiento (
channels/whatsapp/crisis_notifier.py); migraciones de BD versionadas (db/migrations.py); voz de crisis offline (rako-pregen-tts+voice/tts_cache.py); trigger de inactividad post-angustia ahora ACTIVO (datos vivos desdeorchestrator/context.py). - Calidad/operación — pisos de cobertura por archivo; 110 evals de
conversación (
test_conversation_quality.py);docs/CLINICAL_REVIEW.md; job de stress semanal en CI. - Refactor + latencia —
whatsapp/service.pypartido (807→343) en módulos por dominio; TTS por oraciones + streaming real (ElevenLabs/streama mpg123); sinónimos de "recuerda que". - Features finales — STT offline (whisper.cpp,
voice/stt_local.py); monitor proactivo (orchestrator/proactive.py+ comandoproactive-check+ timer opt-in); aprendizaje de preferencias opt-in (orchestrator/preferences.py— Rako pregunta antes de guardar). - Derivación a bienestar en AMBOS canales — el triage graduado
(
safety/triage.py) corre por voz y por WhatsApp: derivación cálida a la unidad configurada o redirección clínica, solo texto curado.
Estado de tests: ~990 tests, cobertura ≥95% global + pisos por archivo,
gate de seguridad dedicado (scripts/checks.py safety). Todos verdes.
- Revisión clínica:
docs/CLINICAL_REVIEW.md(14 ítems). El más importante antes de usar con una persona real. - WhatsApp Cloud producción: aprobar plantillas con Meta + webhook público.
- Firebase: decidir conectar o eliminar (recomendación: eliminar salvo que Flutter necesite push).
- Wake word: cuenta Picovoice + entrenar "Oye Rako" (.ppn).
- Bring-up:
setup_pi.sh→rako-doctor→checks.py safety→rako-pregen-tts→rako-chat. VerINSTALL.md. - ReSpeaker: overlay conocido-bueno + calibración de audio en
HARDWARE.md;rako-fix-audio-bootsi el mic no aparece. - STT offline (opcional): compilar whisper.cpp, apuntar
WHISPER_CPP_BIN/WHISPER_CPP_MODELen.env. - Timers opt-in:
install_systemd.sh rako-proactive. - LEDs: bloqueados por conflicto GPIO18/I2S del ReSpeaker — elegir pin/controlador alternativo antes de cablear el anillo.
- Botón de pánico físico dedicado (el del ReSpeaker es conversación).
- Respaldar
SQLITE_ENCRYPTION_KEYaparte: sin ella los backups son irrecuperables. - Producción (
RAKO_ENV != dev) aborta si la base no está cifrada. - Rako y rako-chat declaran
Conflicts=entre sí (compiten por botón/audio). - No editar copy de crisis/derivación sin registrar la revisión en
docs/CLINICAL_REVIEW.md.
- Sesión web (claude.ai/code): cambios sobre el repo remoto; pushea a
main. La Pi hacegit pull. - Claude Code en la Pi: todo lo que toca hardware real; commitea y pushea sus arreglos para que la sesión web los vea.
- Se sincronizan por git.