Project Plan: Full Workspace Review and Audit Campaign
This project establishes the phased campaign to review, verify, and document all projects, subsystems, and cross-repo contracts across the <workspace> workspace using the pi-review-kit deterministic engine.
1. Objectives and Scope
- Phase 1 (Round R1): Foundation baseline reviews:
- Code subsystem review of core jDisc container, Proton searchcore, and cluster controller.
- Cross-repo contract review across
pyvespa,sample-apps,skills, anddocumentation. - Knowledge garden note and topology verification.
- Phase 2 (Round R2): Deep harvest of unmapped
vespamodules identified in analysis-vespa-code-map-module-coverage and project-unmapped-vespa-modules-harvest. - Phase 3 (Round R3): Continuous verification through CI integration and addressedness auditing.
2. Review Profile Mapping
| Profile Name | Target Scope | Key Verification Criteria |
|---|---|---|
garden-code-subsystem-review | vespa (C++ & Java core) | Concurrency, memory bounds, RCU generation safety |
garden-cross-repo-contract-review | pyvespa, sample-apps, skills | Schema synchronization, HTTP/2 Document v1 parity |
garden-docs-and-skills-review | documentation, skills | Example correctness, grammar accuracy, eval fixtures |
garden-note-review | garden/content/** | Link reciprocity, source coverage (>=3), style honesty |
garden-revision-response-review | Finding sweeps | Addressedness verification and regression prevention |
3. Deliverables
- Governed markdown reports in
reviews/REV-<ROUND>-<NN>-<slug>.md. - Structured verdict JSON sidecars in
ledgers/reviews/. - Verified evidence dossiers in
ledgers/review-evidence/.