PARA Project — Unmapped Vespa Modules & Anchor File Harvest
Time-bounded PARA project (para: project) to systematically map the remaining top-level modules under vespa/ that are not covered in vespa/Code-map.md, using the parallel lease batches generated by tools/garden/analyze_garden.py.
Project Scope & Priority Waves
- Wave A — Transport & RPC Substrate (
fnet,jrt,messagebus):- Map C++
fnettransport framing and Java/C++jrtRPC invocation used by config subscriptions and scatter-gather search dispatch.
- Map C++
- Wave B — Streaming Search & Summaries (
vsm,searchsummary,linguistics):- Contrast
vsm(Vespa Streaming Matcher over raw storage buckets) against indexedprotonmatching (proton-lid-space-and-attribute-vectors).
- Contrast
- Wave C — Cloud/Security & Observability (
flags,metrics-proxy,security-utils):- Document feature flag distribution and Prometheus/OpenTelemetry metrics aggregation.
Exit Criteria (Archive Trigger)
- Raise top-level
vespa/module citation coverage above 35% in garden-health with0unreciprocated edges (INV-003), then move this plan tocontent/archives/(para: archive).