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

  1. 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, and documentation.
    • Knowledge garden note and topology verification.
  2. Phase 2 (Round R2): Deep harvest of unmapped vespa modules identified in analysis-vespa-code-map-module-coverage and project-unmapped-vespa-modules-harvest.
  3. Phase 3 (Round R3): Continuous verification through CI integration and addressedness auditing.

2. Review Profile Mapping

Profile NameTarget ScopeKey Verification Criteria
garden-code-subsystem-reviewvespa (C++ & Java core)Concurrency, memory bounds, RCU generation safety
garden-cross-repo-contract-reviewpyvespa, sample-apps, skillsSchema synchronization, HTTP/2 Document v1 parity
garden-docs-and-skills-reviewdocumentation, skillsExample correctness, grammar accuracy, eval fixtures
garden-note-reviewgarden/content/**Link reciprocity, source coverage (>=3), style honesty
garden-revision-response-reviewFinding sweepsAddressedness 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/.