Analysis: Vespa AI Multi-Repository Workspace Structure and Dependency Graph

This document analyzes the structural boundaries, inter-repository dependencies, and component topology across all 11 active repositories in the <workspace> workspace.

1. Scope and Inventory

The workspace comprises 11 functional repositories and supporting metadata:

Repository	Primary Languages	Architectural Role	Core Entry Points
vespa	C++20, Java	Engine core: jDisc container, proton content, configserver	jdisc_core, searchcore, configserver
system-test	Ruby, SD, Java	Distributed DRb multi-node cluster verification harness	bin/, lib/drb_endpoint.rb, tests/
sample-apps	SD, Python, Java	27 reference architectures (RAG, ColPali, ColBERT)	rag-blueprint, colbert, colpali
documentation	HTML, Markdown	Canonical technical documentation and grammar definitions	en/, _grammars/
pyvespa	Python	Client SDK: application lifecycle, deployment, and evaluation	vespa/package.py, application.py
vespa-search	JavaScript/React	Interactive web UI for query testing and exploration	src/App/
vespa-3rdparty-deps	RPM Spec, Diff	Distribution patches for external C++ runtimes	abseil-cpp, onnxruntime, highway
docker-image-dev	Shell, Dockerfile	Container images for local deployment and CI	build/almalinux-8/, build/almalinux-9/
skills	Markdown, Python	Agent task skills and evaluation fixtures	skills/*/SKILL.md (7 skills)
vespa-ann-benchmark	C++, Python	HNSW and vector indexing throughput benchmarks	ann_benchmark/src/vespa/ann_benchmark/
yodelr-coding-challenge	Java, Python, C++	Educational reference implementations	Yodelr.java, yodelr.py

2. Structural Findings and Signals

1. Circular Dependency Hotspots: Static analysis in .openlore/analysis/SUMMARY.md identifies 823 package-level circular dependencies inside vespa, predominantly in cluster controller coordination (FleetController.java <-> DatabaseHandler.java).
2. Schema and Contract Synchronization: Schema definitions (.sd) are shared between vespa/config-model, sample-apps/, and documentation/_grammars/, requiring systematic validation to prevent syntactic divergence.

3. Governance Integration

This analysis establishes the baseline for the multi-repo review campaign tracked in project-vespa-ai-full-workspace-review-campaign and verified by tools/garden/review_runner.py.