VERIFICATION.md
2,491 bytes
| 1 | # VERIFICATION: VoiceTask |
|---|---|
| 2 | |
| 3 | ## Automated gate |
| 4 | |
| 5 | From the repository root: |
| 6 | |
| 7 | ``` |
| 8 | npm run check |
| 9 | ``` |
| 10 | |
| 11 | This must complete typechecking, all tests, and the production build with exit code 0. Tests use mock providers, require no API keys or network, and must work on Windows, macOS, and Linux without external archive tools. |
| 12 | |
| 13 | ## Definition of done |
| 14 | |
| 15 | 1. Every checkbox in `spec/TASKS.md` is checked. |
| 16 | 2. `npm run check` exits 0 after a clean `npm install`. |
| 17 | 3. The T12 smoke test covers a full session through generation. |
| 18 | 4. Export tests prove that the zip contains all six required files and that HEAD reports readiness. |
| 19 | 5. `BLOCKED.md` has no unanswered entry that prevents a required feature. |
| 20 | 6. `git diff --check` reports no whitespace errors. |
| 21 | |
| 22 | ## Human smoke check |
| 23 | |
| 24 | 0. With no `.env` present, run `npm run dev` and confirm the server starts, the home screen asks for setup, and choosing the demo starts an interview without a restart. |
| 25 | 1. Run `npm run demo` and open the printed URL in current Chrome or Edge. |
| 26 | 2. Confirm the home screen explains the three-part flow, local storage, and the source-backed result before the form. |
| 27 | 3. Create a session with a temporary target folder. |
| 28 | 4. Click `Start talking`, grant microphone access, speak, then click `Send recording`. Confirm one answer is added. |
| 29 | 5. Hold Space while speaking and release it. Confirm one answer is added and no second recording starts. |
| 30 | 6. Type an answer. Confirm the topic counts and each topic status update in plain text. |
| 31 | 7. Finish early, accept the open-topic confirmation, and create the build brief. |
| 32 | 8. Confirm the primary zip download, handoff copy, file disclosure, and optional recommendation action appear. |
| 33 | 9. Refresh the completed session and confirm the zip download is still available. |
| 34 | 10. Open the zip and confirm `SPEC.md`, `PLAN.md`, `TASKS.md`, `VERIFICATION.md`, `HANDOFF.md`, and `sources.json` are present. |
| 35 | 11. Check the home, interview, and completion screens at a narrow and wide browser width. Confirm focus is visible when using Tab and motion stops when reduced motion is enabled. |
| 36 | |
| 37 | ## Optional real-provider check |
| 38 | |
| 39 | With real keys entered on the setup screen or selected by `npm run setup`, run `npm run dev`. Record one sentence and confirm it is transcribed, then confirm the next question is relevant. This check can call paid provider APIs and is not part of automated verification. |
| 40 | |
| 41 | ## Per-task verification |
| 42 | |
| 43 | Each task in `spec/TASKS.md` has its own verification line. Run it before checking that task off. |
| 44 | |