nexus/.planning/phases/36-voice-pipeline-foundation/36-VALIDATION.md
2026-04-04 03:55:49 +00:00

2.9 KiB

phase slug status nyquist_compliant wave_0_complete created
36 voice-pipeline-foundation draft false false 2026-04-04

Phase 36 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.


Test Infrastructure

Property Value
Framework vitest
Config file server/vitest.config.ts
Quick run command pnpm --filter server test -- --run
Full suite command pnpm --filter server test -- --run
Estimated runtime ~15 seconds

Sampling Rate

  • After every task commit: Run pnpm --filter server test -- --run
  • After every plan wave: Run pnpm --filter server test -- --run
  • Before /gsd:verify-work: Full suite must be green
  • Max feedback latency: 15 seconds

Per-Task Verification Map

Task ID Plan Wave Requirement Test Type Automated Command File Exists Status
36-01-01 01 0 VPIPE-04 unit pnpm --filter server test -- --run voice-pipeline W0 pending
36-01-02 01 1 VPIPE-01 unit pnpm --filter server test -- --run voice-pipeline W0 pending
36-01-03 01 1 VPIPE-02 unit pnpm --filter server test -- --run voice-pipeline W0 pending
36-02-01 02 1 VPIPE-05 unit pnpm --filter server test -- --run voice-pipeline W0 pending
36-02-02 02 1 VPIPE-06 unit pnpm --filter server test -- --run voice-pipeline W0 pending
36-03-01 03 2 VPIPE-03 integration pnpm --filter server test -- --run voice W0 pending

Status: pending · green · red · ⚠️ flaky


Wave 0 Requirements

  • server/src/services/__tests__/voice-pipeline.test.ts — stubs for VPIPE-01, VPIPE-02, VPIPE-04
  • server/src/routes/__tests__/voice.test.ts — stubs for VPIPE-03, VPIPE-05, VPIPE-06

If none: "Existing infrastructure covers all phase requirements."


Manual-Only Verifications

Behavior Requirement Why Manual Test Instructions
Audio quality equal across WebM/OGG inputs VPIPE-04 Perceptual quality comparison Record same phrase via browser and Telegram, compare transcription text
Voice-optimized prose sounds natural when read aloud VPIPE-05 Subjective speech quality Read TTS-optimized output aloud, check for markdown artifacts

Validation Sign-Off

  • All tasks have <automated> verify or Wave 0 dependencies
  • Sampling continuity: no 3 consecutive tasks without automated verify
  • Wave 0 covers all MISSING references
  • No watch-mode flags
  • Feedback latency < 15s
  • nyquist_compliant: true set in frontmatter

Approval: pending