feat: US-008 - Comandă Discord /voice addvoice
- /voice addvoice <nume> <sample:Attachment>: validează wav+durată min 3s, oprește pocket-tts.service, exportă vocea prin pocket_tts_add_voice.py în venv separat, repornește serviciul, răspunde cu numele final + preview audio - gates rulate: tests PASS (1043 passed, 22 preexistente neschimbate), review backend manual PASS
This commit is contained in:
@@ -186,12 +186,12 @@
|
||||
],
|
||||
"requiresBrowserCheck": true,
|
||||
"requiresDesignReview": false,
|
||||
"passes": false,
|
||||
"passes": true,
|
||||
"failed": false,
|
||||
"blocked": false,
|
||||
"retries": 0,
|
||||
"failureReason": "",
|
||||
"notes": ""
|
||||
"notes": "Fișiere: src/adapters/discord_voice.py (comandă nouă /voice engine + helper _default_voice_for_engine). Comanda folosește @app_commands.choices cu exact 2 valori (pockettts/supertonic, la fel ca pattern-ul /voice setvoice existent), defer(ephemeral=True), scrie tts.default_engine prin Config().set+save(), răspunde cu engine-ul ales + vocea default asociată (_default_voice_for_engine: 'alba' pentru pockettts, voice.default_voice curent pentru supertonic). Verificat: register() rulează curat într-un CommandTree izolat (fără a atinge bot-ul live) — comanda 'engine' apare cu choices corecte; Config().set/save/reload roundtrip verificat direct (pockettts<->supertonic, valoare restaurată la final, git diff config.json curat). Gate ui: browser/agent-browser nu se aplică — nu există UI web pentru această comandă (e slash command Discord, nu pagină pe techStack.port); am evitat intenționat restart-ul serviciului live echo-core.service (bot-ul de producție Discord/Telegram/WhatsApp folosit activ de Marius) pentru testare end-to-end, ca să nu întrerup serviciul mid-day — recomand test manual /voice engine după următorul restart/deploy. Gate /review (backend, manual): PASS — diff mic, urmează exact pattern-ul setvoice existent, fără shell injection/secret leakage, error handling scoped pe save failure. pytest tests/: aceleași 22 eșecuri preexistente, 1043 passed (neschimbat)."
|
||||
},
|
||||
{
|
||||
"id": "US-008",
|
||||
@@ -214,12 +214,12 @@
|
||||
],
|
||||
"requiresBrowserCheck": true,
|
||||
"requiresDesignReview": false,
|
||||
"passes": false,
|
||||
"passes": true,
|
||||
"failed": false,
|
||||
"blocked": false,
|
||||
"retries": 0,
|
||||
"retries": 1,
|
||||
"failureReason": "",
|
||||
"notes": ""
|
||||
"notes": "Fișiere: src/adapters/discord_voice.py (comandă nouă /voice addvoice + helperi _systemctl_user, _parse_registered_voice_name, _tts_synthesize_preview). Codul era deja scris (necommitat) dintr-o iterație anterioară care a atins max_turns fără commit — verificat linie cu linie contra AC-urilor, nu a fost nevoie de rescriere. Validează extensia .wav + durata minimă 3s prin modulul wave (stdlib), trimite mesaj interimar 'Adaug voce, TTS indisponibil ~30s...', oprește pocket-tts.service prin systemctl --user (best-effort, nu ridică), rulează tools/pocket_tts_add_voice.py cu .venv-pockettts/bin/python (subprocess list-args, fără shell=True — fără risc de shell injection pe --name), repornește serviciul în finally indiferent de rezultat/timeout, parsează numele final atribuit din stdout ('Registered voice ... ->'), generează preview audio prin tools/tts.py synthesize() și îl atașează ca discord.File, apoi șterge fișierul temporar. Verificat: register() rulează curat într-un CommandTree izolat — comanda 'addvoice' apare cu parametrii nume:str și sample:Attachment. hf_token nu apare niciodată în discord_voice.py — rămâne complet în subprocesul pocket_tts_add_voice.py via keyring. Gate ui: fără server web pe techStack.port pentru această comandă (e slash command Discord, nu pagină) — verificare structurală prin CommandTree izolat, la fel ca US-007; nu am restart-uit echo-core.service (bot live folosit de Marius) pentru test end-to-end. Gate /review (backend, manual): PASS — subprocess cu argumente ca listă (fără shell injection), fără secret leakage, systemctl start garantat în finally chiar la timeout, fișier temporar curățat în finally. pytest tests/: aceleași 22 eșecuri preexistente, 1043 passed (neschimbat)."
|
||||
},
|
||||
{
|
||||
"id": "US-009",
|
||||
|
||||
@@ -125,3 +125,81 @@ Project: echo-core
|
||||
- US-009 (ui+backend, autocomplete voci) — eligibil, dependsOn US-003+US-006 (ambele acum passes:true)
|
||||
- US-011 (backend, teste TTS) — eligibil, dependsOn US-006 (acum passes:true)
|
||||
---
|
||||
|
||||
## Iterație: 2026-07-11 (US-007)
|
||||
### Story implementat: US-007 - Comandă Discord /voice engine (tags: ui, backend)
|
||||
### Status: Complete
|
||||
|
||||
### Gates rulate:
|
||||
- Typecheck: SKIP (mypy neinstalat în .venv)
|
||||
- Lint: SKIP (ruff neinstalat în .venv)
|
||||
- Tests: PASS — pytest tests/ aceleași 22 eșecuri preexistente, 1043 passed (neschimbat)
|
||||
- Gate `ui`: agent-browser/Playwright nu se aplică — /voice engine e o comandă slash Discord, nu o pagină
|
||||
web pe techStack.port. În loc de screenshot, am validat wiring-ul comenzii într-un CommandTree izolat
|
||||
(register() apelat direct, fără bot live) — comanda 'engine' apare cu choices=[pockettts, supertonic].
|
||||
Am evitat intenționat un restart al `echo-core.service` (bot-ul de producție Discord/Telegram/WhatsApp
|
||||
folosit activ de Marius) pentru un smoke-test end-to-end real în Discord, ca să nu întrerup serviciul
|
||||
mid-day fără motiv — rămâne recomandare de test manual după următorul restart/deploy normal.
|
||||
- /review (backend, manual): PASS — diff mic, urmează exact pattern-ul `/voice setvoice` existent
|
||||
(defer ephemeral, Config().set+save, try/except pe save failure), fără shell injection, fără secret
|
||||
leakage, API contract nou (nu atinge alte comenzi).
|
||||
|
||||
### Learnings:
|
||||
- Pentru comenzi Discord (tag `ui` fără server web real pe `techStack.port`), gate-ul `/qa` din instrucțiuni
|
||||
(agent-browser pe localhost) nu are sens literal — echo-core e un bot, nu o aplicație web. Verificare
|
||||
alternativă validă: instanțiere izolată a CommandTree + register() pentru confirmare structurală, plus
|
||||
review manual al codului. Nu presupune că un web server rulează pe `techStack.port` doar pentru că PRD-ul
|
||||
are un port generic definit.
|
||||
- `echo-core.service` rulează live direct din acest working tree, pe branch-ul `ralph/echo-improve` — este
|
||||
bot-ul de producție folosit activ de Marius (Discord/Telegram/WhatsApp), nu un serviciu de test izolat.
|
||||
Restart-ul lui e o acțiune cu blast radius asupra unui sistem shared/live — nu-l restart fără motiv clar
|
||||
sau aprobare explicită, chiar dacă ar oferi o verificare end-to-end mai completă a comenzilor Discord noi.
|
||||
- `_default_voice_for_engine()` a fost adăugat ca helper mic separat de `_get_default_voice()` existent —
|
||||
catalogul `tts_voices.json` nu are un flag explicit "default per engine", deci am folosit convenția deja
|
||||
stabilită în US-003 (voce predefinită pocket-tts = 'alba') + config-ul existent `voice.default_voice`
|
||||
pentru Supertonic, în loc să introduc un câmp nou de config nefolosit în altă parte.
|
||||
|
||||
### Next:
|
||||
- US-008 (ui+backend, /voice addvoice) — eligibil, dependsOn US-004+US-006 (ambele passes:true)
|
||||
- US-009 (ui+backend, autocomplete voci) — eligibil, dependsOn US-003+US-006 (ambele passes:true)
|
||||
- US-010 (backend, /voice doctor + pocket-tts health) — eligibil, dependsOn US-001+US-002 (ambele passes:true)
|
||||
- US-011 (backend, teste TTS) — eligibil, dependsOn US-006 (passes:true)
|
||||
---
|
||||
|
||||
## Iterație: 2026-07-11 (US-008)
|
||||
### Story implementat: US-008 - Comandă Discord /voice addvoice (tags: ui, backend)
|
||||
### Status: Complete
|
||||
|
||||
### Gates rulate:
|
||||
- Typecheck: SKIP (mypy neinstalat în .venv)
|
||||
- Lint: SKIP (ruff neinstalat în .venv)
|
||||
- Tests: PASS — pytest tests/ aceleași 22 eșecuri preexistente, 1043 passed (neschimbat)
|
||||
- Gate `ui`: la fel ca US-007, /voice addvoice e o comandă slash Discord, nu o pagină web pe
|
||||
techStack.port — agent-browser nu se aplică. Verificat wiring prin CommandTree izolat
|
||||
(register() apelat direct, fără bot live): comanda 'addvoice' apare cu parametrii
|
||||
nume:str și sample:Attachment. Nu am restart-uit echo-core.service (bot de producție live
|
||||
folosit activ de Marius) pentru un test end-to-end real în Discord.
|
||||
- /review (backend, manual): PASS — subprocess apelat cu argumente ca listă (fără shell=True),
|
||||
deci fără risc de shell injection pe `--name` (nume introdus de utilizator); hf_token nu
|
||||
apare niciodată în discord_voice.py (rămâne izolat în subprocesul pocket_tts_add_voice.py,
|
||||
citit din keyring); systemctl start rulează în `finally` deci serviciul repornește chiar și
|
||||
la timeout/eroare; fișierul temporar WAV e curățat în `finally` separat.
|
||||
|
||||
### Learnings:
|
||||
- Codul pentru US-008 era deja scris (necommitat) dintr-o iterație anterioară care a atins
|
||||
max_turns fără să apuce commit — a treia oară când se întâmplă acest pattern (după
|
||||
US-003/US-004, US-006). Verifică mereu `git diff`/`git status` la începutul iterației
|
||||
înainte să presupui reimplementare de la zero; aici codul era deja corect și complet,
|
||||
a fost nevoie doar de verificare linie cu linie contra acceptance criteria, nu rescriere.
|
||||
- Pattern-ul de gate `ui` pentru comenzi Discord (fără server web real) rămâne: verificare
|
||||
structurală prin CommandTree izolat + review manual, stabilit deja la US-007 — reutilizat
|
||||
aici fără modificări.
|
||||
- `cron/jobs.json` are timestamp-uri live modificate de scheduler-ul care rulează concurent
|
||||
cu acest proces Ralph — nu trebuie inclus în commit-ul de cod al story-ului (confirmă
|
||||
learning-ul din iterația US-004).
|
||||
|
||||
### Next:
|
||||
- US-009 (ui+backend, autocomplete voci) — eligibil, dependsOn US-003+US-006 (ambele passes:true)
|
||||
- US-010 (backend, /voice doctor + pocket-tts health) — eligibil, dependsOn US-001+US-002 (ambele passes:true)
|
||||
- US-011 (backend, teste TTS) — eligibil, dependsOn US-006 (passes:true)
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user