Study inventory: vllm-project/speculators
- Schema:
fak-study-inventory-map/1 - Indexed revision:
0faffeb3bd547b4451a978d7aaf26a2f01b83d62 - Source: https://github.com/vllm-project/speculators
- Observed at: 2026-08-25T21:15:00Z
- Totals: 327 files, 69 directories, 137 runtime files, 104 tests/fixtures, 78 docs, 58757 text lines
Source Classes
| Class | Status | Evidence | Note |
|---|---|---|---|
readme_docs |
covered |
README.md docs/.nav.yml docs/README.md docs/api/index.md docs/assets/branding/speculators-icon-black.png docs/assets/branding/speculators-icon-black.svg docs/assets/branding/speculators-icon-blue.png docs/assets/branding/speculators-icon-blue.svg docs/assets/branding/speculators-icon-white-orange.png docs/assets/branding/speculators-icon-white-orange.svg docs/assets/branding/speculators-icon-white.png docs/assets/branding/speculators-icon-white.svg |
local tree evidence found |
architecture_design |
covered |
docs/assets/dflash_architecture.png docs/assets/eagle3_architecture.png docs/developer/design_docs.md |
local tree evidence found |
runtime_source |
covered |
.buildkite/gpu-tests/gpu-tests-H100.yml .buildkite/gpu-tests/gpu-tests-L4.yml .buildkite/gpu-tests/scripts/run-tests.sh .buildkite/pipeline.yml .coderabbit.yaml .github/ISSUE_TEMPLATE/100-bug-report.yml .github/ISSUE_TEMPLATE/200-RFC.yaml .github/dependabot.yml .github/mergify.yml .github/workflows/link-checks.yml .github/workflows/quality.yml .github/workflows/stale.yml |
local tree evidence found |
tests_fixtures |
covered |
tests/init.py tests/conftest.py tests/e2e/init.py tests/e2e/conftest.py tests/e2e/hs_connectors/init.py tests/e2e/hs_connectors/test_mooncake_online_training.py tests/e2e/hs_connectors/test_mooncake_roundtrip.py tests/e2e/regression/init.py tests/e2e/regression/test_eagle3_conversion_acceptance.py tests/e2e/regression/test_eagle3_offline_acceptance.py tests/e2e/regression/test_eagle3_online_acceptance.py tests/e2e/regression/test_mtp_online_acceptance.py |
local tree evidence found |
history_changelog_releases |
checked_absent |
local tree scanned and no matching path was found | |
open_closed_issues_prs_discussions |
partial |
.github/ISSUE_TEMPLATE/100-bug-report.yml .github/ISSUE_TEMPLATE/200-RFC.yaml .github/PULL_REQUEST_TEMPLATE.md |
local templates found; open/closed issue, PR, and discussion history still require GitHub or forge read-back |
roadmap_todos |
checked_absent |
local tree scanned and no matching path was found | |
license_provenance |
covered |
LICENSE hs_connectors/LICENSE hs_connectors/pyproject.toml pyproject.toml |
local tree evidence found |
fak_selfquery_witness |
external_required |
process artifact created by the study pass, not by the foreign repository tree | |
candidate_matrix |
external_required |
process artifact created by the study pass, not by the foreign repository tree | |
completeness_critic |
covered |
generated by this inventory map’s local tree walk; non-tree omissions remain named in the note | |
issue_tracking |
external_required |
process artifact created by the study pass, not by the foreign repository tree |
Subsystems
| Path | Files | Runtime | Tests | Docs | Languages | Examples |
|---|---|---|---|---|---|---|
tests |
104 | 0 | 104 | 0 | Python:104 | tests/init.py tests/conftest.py tests/e2e/init.py tests/e2e/conftest.py tests/e2e/hs_connectors/init.py tests/e2e/hs_connectors/test_mooncake_online_training.py tests/e2e/hs_connectors/test_mooncake_roundtrip.py tests/e2e/regression/init.py |
src |
90 | 89 | 0 | 0 | Python:89 | src/speculators/init.py src/speculators/main.py src/speculators/config.py src/speculators/convert/init.py src/speculators/convert/dflash/init.py src/speculators/convert/dflash/converter.py src/speculators/convert/eagle/init.py src/speculators/convert/eagle/eagle3_converter.py |
docs |
69 | 0 | 0 | 69 | Docs:34, Config:1, JavaScript:1, Python:1 | docs/.nav.yml docs/README.md docs/api/index.md docs/assets/branding/speculators-icon-black.png docs/assets/branding/speculators-icon-black.svg docs/assets/branding/speculators-icon-blue.png docs/assets/branding/speculators-icon-blue.svg docs/assets/branding/speculators-icon-white-orange.png |
. |
15 | 7 | 0 | 4 | Config:6, Docs:4, Python:1 | .coderabbit.yaml .mdformat.toml .readthedocs.yaml AGENTS.md CODE_OF_CONDUCT.md CONTRIBUTING.md LICENSE Makefile |
scripts |
14 | 13 | 0 | 1 | Python:12, Docs:1, Shell:1 | scripts/benchmark.py scripts/build_vocab_mapping.py scripts/data_generation_offline.py scripts/evaluate/evaluate.py scripts/evaluate/perf_utils.py scripts/evaluate/plot.py scripts/evaluate/prepare_speedbench.py scripts/evaluate/requirements.txt |
examples |
11 | 10 | 0 | 1 | Shell:10, Docs:1 | examples/convert/README.md examples/convert/eagle3/apply_eagle3_eagle.sh examples/convert/eagle3/apply_eagle3_llama4_maverick.sh examples/evaluate/example_qwen3_8b_dflash_humaneval.sh examples/train/dflash_qwen3_8b_sharegpt_online_5k.sh examples/train/dflash_qwen3_8b_ultrachat_online_5k_bestpractices.sh examples/train/dspark_qwen3_0_6b_sharegpt_online.sh examples/train/eagle3_llama3_8b_ultrachat_offline_5k.sh |
hs_connectors |
10 | 7 | 0 | 1 | Python:5, Config:2, Docs:1 | hs_connectors/LICENSE hs_connectors/Makefile hs_connectors/README.md hs_connectors/pyproject.toml hs_connectors/setup.py hs_connectors/src/hs_connectors/init.py hs_connectors/src/hs_connectors/mooncake_hidden_states_connector.py hs_connectors/src/hs_connectors/mooncake_store.py |
.github |
9 | 7 | 0 | 1 | Config:7, Docs:1 | .github/ISSUE_TEMPLATE/100-bug-report.yml .github/ISSUE_TEMPLATE/200-RFC.yaml .github/PULL_REQUEST_TEMPLATE.md .github/dependabot.yml .github/mergify.yml .github/workflows/link-checks.yml .github/workflows/quality.yml .github/workflows/stale.yml |
.buildkite |
4 | 4 | 0 | 0 | Config:3, Shell:1 | .buildkite/gpu-tests/gpu-tests-H100.yml .buildkite/gpu-tests/gpu-tests-L4.yml .buildkite/gpu-tests/scripts/run-tests.sh .buildkite/pipeline.yml |
.claude |
1 | 0 | 0 | 1 | Docs:1 | .claude/skills/pr-review/SKILL.md |
Skipped Directories
.git
Completeness Critic
local tree inventory walked every non-skipped regular file and grouped immediate subsystems; skipped dependency/cache/control directories: .git; classes checked absent in local tree: history_changelog_releases, roadmap_todos; still requires non-tree study artifacts: fak_selfquery_witness, candidate_matrix, issue_tracking