TalkiTS — Monorepo

Repositorio unificado de TalkiTS (dictado STT desktop, Electron) y la infraestructura de desarrollo local.

Carpeta	Contenido
TalkPy/	App Electron TalkiTS v0.1.1 (código productivo)
Docs/	Roadmaps, ingeniería, QA
DevFiles/	CheckTool (5 checks), ProbeTool, scripts dev

---

Quick Start

git clone https://github.com/jaminsmoke/TalkPy.git
cd TalkPy
# Dependencias: orquestador + app
npm install
npm install --prefix TalkPy
# Calidad completa (lint, types, build, test, coverage) — 5 checks
npm run check
# Desarrollo Electron
npm run dev:electron --prefix TalkPy
# equivalente: cd TalkPy && npm run dev:electron

Variables de entorno del proxy (.env en TalkPy/):

# Proxy speech + streaming enabled by default; opt out with:# TALKITS_PROXY_SPEECH=0 (whisper rolling only)# TALKITS_PROXY_STREAM=0 (no live streaming to dialog)

---

Scripts (raíz)

Script	Descripción
npm run check	Pipeline 5/5 (CheckTool)
npm run check:fast	Igual, fail-fast
npm run clean	Limpia out/, coverage/, etc. en app
npm run kill:dev	Mata Vite/Electron huérfanos
npm run probe	ProbeTool (Whisper, sidecar, rutas)
npm run audit:co-location	Audit tests co-localizados vs ESLint

Scripts de la app (build, test, dev:electron, empaquetado): ver TalkPy/README.md.

---

Estructura

TalkPy/ ← raíz git única (este repo — no hay .git anidado)
├── TalkPy/ ← app Electron (subcarpeta, no repo separado)
├── Docs/
├── DevFiles/
├── package.json ← orquestador dev-infra
├── TalkPy.code-workspace ← una sola carpeta raíz
└── README.md ← este archivo

Nota: Clona solo https://github.com/jaminsmoke/TalkPy.git. No existe un segundo repositorio dentro de TalkPy/TalkPy/.

---

Documentación

• Roadmap activo: Docs/Roadmaps/README.md · Docs/Roadmaps/v.0.1.1/ROADMAP.md
• Consolidación repo: Docs/Roadmaps/v.0.1.1/ROADMAP-5-REPO-CONSOLIDATION.md
• Recuperación desktop: Docs/Engineering/DESKTOP-RECOVERY.md

---

CI

GitHub Actions (.github/workflows/ci.yml): lint, typecheck, build y test:coverage en TalkPy/.
Detalle CI vs CheckTool local: Docs/Engineering/CI.md.