{
  "schema": "fak-study-inventory-map/1",
  "repository": "vllm-project/speculators",
  "url": "https://github.com/vllm-project/speculators",
  "indexed_revision": "0faffeb3bd547b4451a978d7aaf26a2f01b83d62",
  "observed_at": "2026-08-25T21:15:00Z",
  "totals": {
    "files": 327,
    "directories": 69,
    "bytes": 8016659,
    "runtime_files": 137,
    "test_files": 104,
    "docs_files": 78,
    "text_lines": 58757
  },
  "source_classes": [
    {
      "class": "readme_docs",
      "status": "covered",
      "evidence": [
        "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"
      ],
      "note": "local tree evidence found"
    },
    {
      "class": "architecture_design",
      "status": "covered",
      "evidence": [
        "docs/assets/dflash_architecture.png",
        "docs/assets/eagle3_architecture.png",
        "docs/developer/design_docs.md"
      ],
      "note": "local tree evidence found"
    },
    {
      "class": "runtime_source",
      "status": "covered",
      "evidence": [
        ".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"
      ],
      "note": "local tree evidence found"
    },
    {
      "class": "tests_fixtures",
      "status": "covered",
      "evidence": [
        "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"
      ],
      "note": "local tree evidence found"
    },
    {
      "class": "history_changelog_releases",
      "status": "checked_absent",
      "note": "local tree scanned and no matching path was found"
    },
    {
      "class": "open_closed_issues_prs_discussions",
      "status": "partial",
      "evidence": [
        ".github/ISSUE_TEMPLATE/100-bug-report.yml",
        ".github/ISSUE_TEMPLATE/200-RFC.yaml",
        ".github/PULL_REQUEST_TEMPLATE.md"
      ],
      "note": "local templates found; open/closed issue, PR, and discussion history still require GitHub or forge read-back"
    },
    {
      "class": "roadmap_todos",
      "status": "checked_absent",
      "note": "local tree scanned and no matching path was found"
    },
    {
      "class": "license_provenance",
      "status": "covered",
      "evidence": [
        "LICENSE",
        "hs_connectors/LICENSE",
        "hs_connectors/pyproject.toml",
        "pyproject.toml"
      ],
      "note": "local tree evidence found"
    },
    {
      "class": "fak_selfquery_witness",
      "status": "external_required",
      "note": "process artifact created by the study pass, not by the foreign repository tree"
    },
    {
      "class": "candidate_matrix",
      "status": "external_required",
      "note": "process artifact created by the study pass, not by the foreign repository tree"
    },
    {
      "class": "completeness_critic",
      "status": "covered",
      "note": "generated by this inventory map's local tree walk; non-tree omissions remain named in the note"
    },
    {
      "class": "issue_tracking",
      "status": "external_required",
      "note": "process artifact created by the study pass, not by the foreign repository tree"
    }
  ],
  "subsystems": [
    {
      "path": "tests",
      "files": 104,
      "directories": 18,
      "bytes": 602912,
      "runtime_files": 0,
      "test_files": 104,
      "docs_files": 0,
      "text_lines": 17274,
      "languages": [
        {
          "language": "Python",
          "files": 104
        }
      ],
      "example_paths": [
        "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"
      ],
      "source_classes": [
        "tests_fixtures"
      ]
    },
    {
      "path": "src",
      "files": 90,
      "directories": 17,
      "bytes": 574708,
      "runtime_files": 89,
      "test_files": 0,
      "docs_files": 0,
      "text_lines": 15489,
      "languages": [
        {
          "language": "Python",
          "files": 89
        }
      ],
      "example_paths": [
        "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"
      ],
      "source_classes": [
        "runtime_source"
      ]
    },
    {
      "path": "docs",
      "files": 69,
      "directories": 11,
      "bytes": 6445382,
      "runtime_files": 0,
      "test_files": 0,
      "docs_files": 69,
      "text_lines": 15963,
      "languages": [
        {
          "language": "Docs",
          "files": 34
        },
        {
          "language": "Config",
          "files": 1
        },
        {
          "language": "JavaScript",
          "files": 1
        },
        {
          "language": "Python",
          "files": 1
        }
      ],
      "example_paths": [
        "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"
      ],
      "source_classes": [
        "architecture_design",
        "readme_docs"
      ]
    },
    {
      "path": ".",
      "files": 15,
      "directories": 9,
      "bytes": 74677,
      "runtime_files": 7,
      "test_files": 0,
      "docs_files": 4,
      "text_lines": 1382,
      "languages": [
        {
          "language": "Config",
          "files": 6
        },
        {
          "language": "Docs",
          "files": 4
        },
        {
          "language": "Python",
          "files": 1
        }
      ],
      "example_paths": [
        ".coderabbit.yaml",
        ".mdformat.toml",
        ".readthedocs.yaml",
        "AGENTS.md",
        "CODE_OF_CONDUCT.md",
        "CONTRIBUTING.md",
        "LICENSE",
        "Makefile"
      ],
      "source_classes": [
        "license_provenance",
        "readme_docs",
        "runtime_source"
      ]
    },
    {
      "path": "scripts",
      "files": 14,
      "directories": 2,
      "bytes": 189475,
      "runtime_files": 13,
      "test_files": 0,
      "docs_files": 1,
      "text_lines": 5588,
      "languages": [
        {
          "language": "Python",
          "files": 12
        },
        {
          "language": "Docs",
          "files": 1
        },
        {
          "language": "Shell",
          "files": 1
        }
      ],
      "example_paths": [
        "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"
      ],
      "source_classes": [
        "runtime_source"
      ]
    },
    {
      "path": "examples",
      "files": 11,
      "directories": 4,
      "bytes": 30676,
      "runtime_files": 10,
      "test_files": 0,
      "docs_files": 1,
      "text_lines": 886,
      "languages": [
        {
          "language": "Shell",
          "files": 10
        },
        {
          "language": "Docs",
          "files": 1
        }
      ],
      "example_paths": [
        "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"
      ],
      "source_classes": [
        "readme_docs",
        "runtime_source"
      ]
    },
    {
      "path": "hs_connectors",
      "files": 10,
      "directories": 2,
      "bytes": 56206,
      "runtime_files": 7,
      "test_files": 0,
      "docs_files": 1,
      "text_lines": 1213,
      "languages": [
        {
          "language": "Python",
          "files": 5
        },
        {
          "language": "Config",
          "files": 2
        },
        {
          "language": "Docs",
          "files": 1
        }
      ],
      "example_paths": [
        "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"
      ],
      "source_classes": [
        "license_provenance",
        "readme_docs",
        "runtime_source"
      ]
    },
    {
      "path": ".github",
      "files": 9,
      "directories": 2,
      "bytes": 16373,
      "runtime_files": 7,
      "test_files": 0,
      "docs_files": 1,
      "text_lines": 444,
      "languages": [
        {
          "language": "Config",
          "files": 7
        },
        {
          "language": "Docs",
          "files": 1
        }
      ],
      "example_paths": [
        ".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"
      ],
      "source_classes": [
        "open_closed_issues_prs_discussions",
        "runtime_source"
      ]
    },
    {
      "path": ".buildkite",
      "files": 4,
      "directories": 2,
      "bytes": 10515,
      "runtime_files": 4,
      "test_files": 0,
      "docs_files": 0,
      "text_lines": 316,
      "languages": [
        {
          "language": "Config",
          "files": 3
        },
        {
          "language": "Shell",
          "files": 1
        }
      ],
      "example_paths": [
        ".buildkite/gpu-tests/gpu-tests-H100.yml",
        ".buildkite/gpu-tests/gpu-tests-L4.yml",
        ".buildkite/gpu-tests/scripts/run-tests.sh",
        ".buildkite/pipeline.yml"
      ],
      "source_classes": [
        "runtime_source"
      ]
    },
    {
      "path": ".claude",
      "files": 1,
      "directories": 2,
      "bytes": 15735,
      "runtime_files": 0,
      "test_files": 0,
      "docs_files": 1,
      "text_lines": 202,
      "languages": [
        {
          "language": "Docs",
          "files": 1
        }
      ],
      "example_paths": [
        ".claude/skills/pr-review/SKILL.md"
      ]
    }
  ],
  "skipped_dirs": [
    ".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"
}