{ "schema": "fak-study-inventory-map/1", "repository": "SemiAnalysisAI/InferenceX", "url": "https://github.com/SemiAnalysisAI/InferenceX", "indexed_revision": "0b0138fd7de0a6f927f9769b19d594d01f586107", "observed_at": "2026-08-25T00:00:00Z", "totals": { "files": 1280, "directories": 212, "bytes": 12641816, "runtime_files": 1145, "test_files": 34, "docs_files": 84, "text_lines": 361845 }, "source_classes": [ { "class": "readme_docs", "status": "covered", "evidence": [ ".github/workflows/README.md", "README.md", "benchmarks/llm-d/README.md", "benchmarks/multi_node/llm-d/README.md", "benchmarks/single_node/agentic/README.md", "docs/DOCUMENTATION_PLAN.md", "docs/DOCUMENTATION_PLAN_zh.md", "docs/PR_REVIEW_CHECKLIST.md", "docs/PR_REVIEW_CHECKLIST_zh.md", "docs/agent-guide.md", "docs/agent-guide_zh.md", "docs/architecture.md" ], "note": "local tree evidence found" }, { "class": "architecture_design", "status": "covered", "evidence": [ "docs/architecture.md", "docs/architecture_zh.md" ], "note": "local tree evidence found" }, { "class": "runtime_source", "status": "covered", "evidence": [ ".agents/skills/debug-agentx-runs/agents/openai.yaml", ".claude/mcp/__init__.py", ".claude/mcp/mcp_utils.py", ".claude/mcp/server.py", ".github/dependabot.yml", ".github/workflows/benchmark-multinode-tmpl.yml", ".github/workflows/benchmark-tmpl.yml", ".github/workflows/claude-pr-review.yml", ".github/workflows/claude.yml", ".github/workflows/codeowner-signoff-verify.yml", ".github/workflows/collect-evals.yml", ".github/workflows/collect-results.yml" ], "note": "local tree evidence found" }, { "class": "tests_fixtures", "status": "covered", "evidence": [ "experimental/CollectiveX/tests/test_backends.py", "experimental/CollectiveX/tests/test_chain.py", "experimental/CollectiveX/tests/test_matrix.py", "experimental/CollectiveX/tests/test_measurement.py", "experimental/CollectiveX/tests/test_runtime.py", "runners/test_slurm_utils.py", "utils/agentic/aggregation/test_power_adapter.py", "utils/agentic/aggregation/test_power_lifecycle.py", "utils/agentic/aggregation/test_process_agentic_result.py", "utils/agentic/aggregation/test_server_log_metrics.py", "utils/agentic/datasets/test_build_weka_hf_dataset.py", "utils/agentic/validation/test_validate_agentic_result.py" ], "note": "local tree evidence found" }, { "class": "history_changelog_releases", "status": "covered", "evidence": [ ".github/workflows/test-changelog-gate.yml", "perf-changelog.yaml", "utils/changelog_gate_tests/test_prepare_perf_changelog_merge.py", "utils/changelog_gate_tests/test_validate_perf_changelog.py", "utils/prepare_perf_changelog_merge.py", "utils/process_changelog.py", "utils/test_process_changelog.py", "utils/validate_perf_changelog.py" ], "note": "local tree evidence found" }, { "class": "open_closed_issues_prs_discussions", "status": "partial", "evidence": [ ".github/ISSUE_TEMPLATE/bug_report.md", ".github/ISSUE_TEMPLATE/feature_request.md", ".github/PULL_REQUEST_TEMPLATE/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", "experimental/operatorx/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": "benchmarks", "files": 731, "directories": 141, "bytes": 3311687, "runtime_files": 723, "test_files": 0, "docs_files": 4, "text_lines": 102676, "languages": [ { "language": "Config", "files": 478 }, { "language": "Shell", "files": 244 }, { "language": "Docs", "files": 4 }, { "language": "Python", "files": 1 } ], "example_paths": [ "benchmarks/benchmark_lib.sh", "benchmarks/llm-d/Dockerfile", "benchmarks/llm-d/README.md", "benchmarks/llm-d/envoy.yaml", "benchmarks/llm-d/epp-config.yaml", "benchmarks/llm-d/extract-binaries.sh", "benchmarks/multi_node/agentic/dsv4_fp4_mi355x_sglang-disagg.sh", "benchmarks/multi_node/agentic/glm5.1_fp8_b200_tilert-disagg.sh" ], "source_classes": [ "readme_docs", "runtime_source" ] }, { "path": "experimental", "files": 304, "directories": 32, "bytes": 5206584, "runtime_files": 280, "test_files": 5, "docs_files": 15, "text_lines": 163623, "languages": [ { "language": "Config", "files": 182 }, { "language": "Python", "files": 87 }, { "language": "Shell", "files": 16 }, { "language": "Docs", "files": 15 } ], "example_paths": [ "experimental/CollectiveX/README.md", "experimental/CollectiveX/bandwidth.py", "experimental/CollectiveX/bench/ep_backend.py", "experimental/CollectiveX/bench/ep_deepep_v2.py", "experimental/CollectiveX/bench/ep_flashinfer.py", "experimental/CollectiveX/bench/ep_harness.py", "experimental/CollectiveX/bench/ep_mori.py", "experimental/CollectiveX/bench/ep_nccl.py" ], "source_classes": [ "license_provenance", "readme_docs", "runtime_source", "tests_fixtures" ] }, { "path": "utils", "files": 97, "directories": 16, "bytes": 1539723, "runtime_files": 62, "test_files": 28, "docs_files": 4, "text_lines": 37590, "languages": [ { "language": "Python", "files": 83 }, { "language": "Config", "files": 4 }, { "language": "Docs", "files": 4 }, { "language": "Shell", "files": 3 } ], "example_paths": [ "utils/agentic/__init__.py", "utils/agentic/aggregation/__init__.py", "utils/agentic/aggregation/aggregation_common.py", "utils/agentic/aggregation/backends/__init__.py", "utils/agentic/aggregation/backends/atom.py", "utils/agentic/aggregation/backends/base.py", "utils/agentic/aggregation/backends/dynamo_vllm.py", "utils/agentic/aggregation/backends/sglang.py" ], "source_classes": [ "history_changelog_releases", "runtime_source", "tests_fixtures" ] }, { "path": ".github", "files": 30, "directories": 3, "bytes": 324562, "runtime_files": 23, "test_files": 0, "docs_files": 6, "text_lines": 6657, "languages": [ { "language": "Config", "files": 23 }, { "language": "Docs", "files": 6 } ], "example_paths": [ ".github/AGENT_OPERATIONS.md", ".github/ISSUE_TEMPLATE/bug_report.md", ".github/ISSUE_TEMPLATE/feature_request.md", ".github/PULL_REQUEST_TEMPLATE/pull_request_template.md", ".github/codeowner-signoff-verify-prompt.md", ".github/dependabot.yml", ".github/workflows/README.md", ".github/workflows/benchmark-multinode-tmpl.yml" ], "source_classes": [ "history_changelog_releases", "open_closed_issues_prs_discussions", "readme_docs", "runtime_source" ] }, { "path": "docs", "files": 30, "directories": 1, "bytes": 482367, "runtime_files": 0, "test_files": 0, "docs_files": 30, "text_lines": 6512, "languages": [ { "language": "Docs", "files": 29 } ], "example_paths": [ "docs/DOCUMENTATION_PLAN.md", "docs/DOCUMENTATION_PLAN_zh.md", "docs/PR_REVIEW_CHECKLIST.md", "docs/PR_REVIEW_CHECKLIST_zh.md", "docs/agent-guide.md", "docs/agent-guide_zh.md", "docs/architecture.md", "docs/architecture_zh.md" ], "source_classes": [ "architecture_design", "readme_docs" ] }, { "path": "runners", "files": 25, "directories": 1, "bytes": 225132, "runtime_files": 24, "test_files": 1, "docs_files": 0, "text_lines": 5185, "languages": [ { "language": "Shell", "files": 20 }, { "language": "Python", "files": 5 } ], "example_paths": [ "runners/inject_synthetic_acceptance.py", "runners/launch_b200-cw.sh", "runners/launch_b200-dgxc-slurm.sh", "runners/launch_b200-dgxc.sh", "runners/launch_b200-nb.sh", "runners/launch_b200-nscale-slurm.sh", "runners/launch_b300-nv.sh", "runners/launch_gb200-nv.sh" ], "source_classes": [ "runtime_source", "tests_fixtures" ] }, { "path": "configs", "files": 19, "directories": 1, "bytes": 906857, "runtime_files": 18, "test_files": 0, "docs_files": 1, "text_lines": 29034, "languages": [ { "language": "Config", "files": 18 }, { "language": "Docs", "files": 1 } ], "example_paths": [ "configs/CONFIGS.md", "configs/amd-master.yaml", "configs/ci-priority.yaml", "configs/deprecated/amd-1k1k-master.yaml", "configs/deprecated/amd-glm5-glm5.1-master.yaml", "configs/deprecated/amd-gptoss-master.yaml", "configs/deprecated/amd-kimik2.5-8k1k-master.yaml", "configs/deprecated/amd-minimaxm2.5-m2.7-master.yaml" ], "source_classes": [ "runtime_source" ] }, { "path": ".claude", "files": 16, "directories": 3, "bytes": 98663, "runtime_files": 3, "test_files": 0, "docs_files": 11, "text_lines": 2263, "languages": [ { "language": "Docs", "files": 11 }, { "language": "Python", "files": 3 } ], "example_paths": [ ".claude/commands/add-model-hardware.md", ".claude/commands/clean-amd-mi355-runner-root-files.md", ".claude/commands/debug-mi300-enroot-pyxis.md", ".claude/commands/find-mergeable-claude-prs.md", ".claude/commands/fix-klaud-cron-prs.md", ".claude/commands/klaud-pr-status-html.md", ".claude/commands/list-claude-pr-status.md", ".claude/commands/merge-prs.md" ], "source_classes": [ "runtime_source" ] }, { "path": ".", "files": 14, "directories": 10, "bytes": 494959, "runtime_files": 2, "test_files": 0, "docs_files": 9, "text_lines": 7389, "languages": [ { "language": "Docs", "files": 9 }, { "language": "Config", "files": 2 } ], "example_paths": [ ".mcp.json", "AGENTS.md", "CLAUDE.md", "CONTRIBUTING.md", "CONTRIBUTING_zh.md", "KLAUD_DEBUG.md", "LICENSE", "MODELS.md" ], "source_classes": [ "history_changelog_releases", "license_provenance", "readme_docs", "runtime_source" ] }, { "path": "golden_al_distribution", "files": 11, "directories": 0, "bytes": 31872, "runtime_files": 9, "test_files": 0, "docs_files": 2, "text_lines": 518, "languages": [ { "language": "Config", "files": 9 }, { "language": "Docs", "files": 2 } ], "example_paths": [ "golden_al_distribution/README.md", "golden_al_distribution/README_zh.md", "golden_al_distribution/dsv4-pro-0813-dspark.yaml", "golden_al_distribution/dsv4_mtp.yaml", "golden_al_distribution/glm5.2_mtp.yaml", "golden_al_distribution/kimik2.5_eagle3.yaml", "golden_al_distribution/kimik3_dspark.yaml", "golden_al_distribution/kimik3_dspark_probabilistic_sample_method_block_rejection_sample_method.yaml" ], "source_classes": [ "readme_docs", "runtime_source" ] }, { "path": ".agents", "files": 3, "directories": 4, "bytes": 19410, "runtime_files": 1, "test_files": 0, "docs_files": 2, "text_lines": 398, "languages": [ { "language": "Docs", "files": 2 }, { "language": "Config", "files": 1 } ], "example_paths": [ ".agents/skills/debug-agentx-runs/SKILL.md", ".agents/skills/debug-agentx-runs/agents/openai.yaml", ".agents/skills/debug-runs/SKILL.md" ], "source_classes": [ "runtime_source" ] } ], "skipped_dirs": [ ".git" ], "completeness_critic": "exhaustive local tree map plus pinned-cutoff GitHub issue, pull-request, discussion, release, history, roadmap/TODO, and license/provenance read-back; candidate-specific fak self-query, adjudication, and issue tracking are recorded under non_tree_study; skipped dependency/cache/control directories: .git", "non_tree_study": { "observed_at": "2026-08-25", "source_cutoff": { "revision": "0b0138fd7de0a6f927f9769b19d594d01f586107", "commit_timestamp": "2026-08-24T03:33:43Z" }, "github_surface": { "issues": { "total": 389, "open": 103, "closed": 286 }, "pull_requests": { "total": 2299, "open": 52, "closed": 2247, "merged": 1520 }, "discussions": { "total": 4, "open": 4, "closed": 0, "answered": 0 }, "releases": { "total": 1, "latest": "tilert-v0.1.5.post2-inferencex.1", "published_at": "2026-08-19T02:43:15Z" }, "method": "GitHub issue and pull-request surfaces paged to exhaustion, plus complete REST discussions and releases; retained records created no later than the pinned commit timestamp." }, "history_and_roadmap": { "evidence": [ "git log through 0b0138fd7de0a6f927f9769b19d594d01f586107", "https://github.com/SemiAnalysisAI/InferenceX/releases/tag/tilert-v0.1.5.post2-inferencex.1", "repository-wide TODO/roadmap search at the pinned tree" ], "note": "Commit history and the sole release were audited. No canonical ROADMAP file exists; prospective work is distributed across TODOs, open issues, and pull requests." }, "license_provenance": { "evidence": [ "LICENSE", "NOTICE", "README.md#license", "experimental/TileRT/LICENSE" ], "note": "The root project declares Apache-2.0 and carries NOTICE/provenance material; vendored or experimental subtrees retain their own notices and licenses." }, "self_query_axes": [ { "axis": "benchmark_accounting", "query": "fak capabilities benchmark serving metrics receipt time to first token inter token latency power energy quality", "fak_surface": "benchmark receipts, cache/token attribution, and claim gates", "verdict": "owned_plus_open_followons" }, { "axis": "artifact_lineage", "query": "fak capabilities artifact reuse ingestion integrity benchmark lineage source revision", "fak_surface": "captured artifacts, module revisions, and benchmark authority", "verdict": "owned" }, { "axis": "agentic_lifecycle", "query": "fak capabilities agentic continuous inference client server lifecycle judge task success", "fak_surface": "agenticbench, trajectories, session control, and routing", "verdict": "owned_plus_open_followons" } ], "candidate_matrix": [ { "candidate": "scope-versioned measured-power receipts", "source": [ "README.md#power-measurement", "docs/power-measurement.md" ], "alternative": "FAK benchmark receipts and authority", "disposition": "already_tracked", "reason": "Applicable provenance and workload-window binding remain owned by open issue #8773." }, { "candidate": "client/server lifecycle join for agentic workloads", "source": [ "benchmarks/multi_node/agentic/", "runners/agentx_client.py", "runners/agentx_server.py" ], "alternative": "FAK agenticbench receipts", "disposition": "already_tracked", "reason": "Applicable cross-boundary phase correlation remains owned by open issue #8774." }, { "candidate": "quality-constrained full-response interactivity", "source": [ "docs/metrics.md", "runners/agentx_client.py" ], "alternative": "FAK quality and latency gates", "disposition": "already_tracked", "reason": "Applicable judged-completion latency remains owned by open issue #8775." }, { "candidate": "external serving/runtime implementation", "source": [ "experimental/", "benchmarks/" ], "alternative": "FAK-native inference engine", "disposition": "reject", "reason": "Useful only as benchmark/reference evidence; adopting it would violate FAK native-inference ownership." }, { "candidate": "artifact reuse and ingestion-integrity conventions", "source": [ "README.md", "utils/", "docs/" ], "alternative": "FAK captured evidence, benchmark authority, and revisioned artifacts", "disposition": "already_owned", "reason": "The refreshed tree found no distinct primitive beyond the controls recorded in the existing study note." } ], "issue_tracking": { "study_issue": "https://github.com/anthony-chaudhary/fak/issues/9003", "filed_borrows": [ "https://github.com/anthony-chaudhary/fak/issues/8773", "https://github.com/anthony-chaudhary/fak/issues/8774", "https://github.com/anthony-chaudhary/fak/issues/8775" ], "reason": "The exhaustive refresh produced no novel unowned borrow; applicable findings remain deduplicated to existing open follow-ons." } } }