pitchfast/backlog/tasks/task-46 - Add-Convex-specialist-fan-out-audit-pipeline.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	priority	ordinal
TASK-46	Add Convex specialist fan-out audit pipeline	Done		2026-06-08 09:04	2026-06-10 19:27			high	48000

Description

Implement an evidence-first specialist fan-out/fan-in audit generation pipeline in Convex so audits produce verified, reviewable findings before German copy and publication.

Acceptance Criteria

• #1 Specialist audit stages run after evidence collection and before German copy
• #2 Specialist findings include typed evidence refs and unsupported claims are rejected
• #3 Verified findings are persisted separately and surfaced on audit detail pages
• #4 Quality review blocks when either model QA or German copy guard fails
• #5 Skill summaries use real registry purpose or instructions
• #6 Schema, evidence, action-source, persistence, quality gate, and UI tests pass

Implementation Plan

1. Add RED tests for specialist schemas, evidence IDs, action ordering, persistence, QA gates, and UI rendering
2. Implement schema validators and evidence ledger helpers
3. Add auditFindings persistence and detail query joins
4. Wire specialist fan-out stages and evidence verifier before German copy
5. Make qualityReview model invalid state blocking and improve skill summaries
6. Update audit detail UI to render findings with evidence chips
7. Run focused tests, typecheck, and full test suite where feasible

Implementation Notes

RED: pnpm exec tsc -p tsconfig.test.json fails because AuditEvidenceInput has no evidenceLedger and lib/ai/schemas exports no specialist/verifier schemas yet. This is the expected missing-feature failure.

GREEN: Focused audit fan-out/source/UI tests passed 67/67. Full pnpm test passed 384/384. Implemented specialist fan-out stages, evidence ledger, auditFindings persistence, blocking model+guard QA, real skill summaries, and findings-first audit detail UI.

Final Summary

Closed per explicit user request while switching project tracking to pitchfast.