Skip to content

docs: anchor L1 weight demand against the checkpoint in performance-ceiling-analysis - #351

Open
fake0fan wants to merge 3 commits into
InferMatrixLab:mainfrom
fake0fan:docs/ceiling-checkpoint-anchor
Open

fake0fan wants to merge 3 commits into
InferMatrixLab:mainfrom
fake0fan:docs/ceiling-checkpoint-anchor

Conversation

@fake0fan

@fake0fan fake0fan commented Nov 4, 2026 •

Copy link
Copy Markdown

Refs #348 (the issue's acceptance owner decides closure; a merged PR does not satisfy the goal by itself).

Rebased onto current main (663f3b32) after the branch's original base went 77 commits stale. main's two added paper sources under this owner (Mooncake, FlexGen) and its added limitations are preserved; this PR appends beside them.

What this changes

methods/performance-ceiling-analysis L1 divides a count by a rated peak and never revisits the model, so an error in the count reaches the floor unchallenged and no later roofline step re-examines it. The skill had no procedure for checking the demand side: safetensors appeared nowhere under this owner, while the loading mechanics already live in weight-loading-optimization and a byte-level weight inventory already exists as an artifact pattern under repositories/h3-c/.

This adds the missing prerequisite and records the reviewed external source it is derived from.

File Change
methods/performance-ceiling-analysis/SKILL.md Two-gate prerequisite in Evidence to inspect first; a third known L1 limitation; a section linking the reviewed external implementation
.../references/huggingarch-checkpoint-anchor.md New. Procedure, scope limits, the two-threshold rule, the archived ablation study, and what the source does not establish
.../references/huggingarch-source-identity.json New. Typed source record: pinned commit, per-file git blob + sha256 + bytes, per-file inspection scope
.../metadata.json Sixth source entry, two provenance readsets, one limitation, extended verification note
docs/reference-matrix.md One §2 row
docs/skill-coverage.md Regenerated by tools/build_skill_coverage.py
src/inferrsi/data/repo_packs/inferrsi/knowledge/** (80 files) Regenerated by tools/build_skill_index.py at the content commit; only the performance-ceiling-analysis record changes beyond the source pin

The two gates

  1. Bidirectional per-tensor join. Every checkpoint header tensor must be claimed by exactly one analytical leaf and agree in physical element count, and every name the analysis stores must exist in the header. Both residuals are reported. A byte total is a checksum on that join, never the primary gate — a sum catches a wrong width but not two submodules swapped with the same total. Compare bytes rather than elements wherever precision is mixed.
  2. Per-rank weight ledger. The join needs no parallelism layout, so passing it certifies nothing about per-device bytes. Any per-device or per-degree figure additionally needs every stored weight to have a declared layout per stored axis and a format that gives it a width.

The blind spot is stated rather than implied: the anchor covers the weight traffic term only. A sliding-window and a global attention with identical head dimensions have byte-identical weights, so KV growth and boundedness are unanchored by it.

Provenance discipline

  • Source pinned at one full commit; per-file git blob, sha256, bytes and inspection scope recorded (read in full / selected sections / hashed but not inspected / retained but not cited).
  • Claims in the reference document are marked [code] where verified against source files at that commit and [doc] where only the project's documentation states them.
  • The source repository has a single squashed commit created four weeks after its companion blog post, so the post's figures are not attributable to it. The post is recorded as a partially read live URL with no snapshot.
  • Two figures circulating from that post — a measured-corpus row count with model and library counts, and a rate of agent self-approval under ablation — are not present in the inspected repository documents and are recorded as unverified with an explicit instruction not to cite them as source facts.
  • What the source does not establish is recorded as explicitly as what it does: no end-to-end validation of predicted against measured serving performance within the inspected scope, and unmeasured collectives upstream.
  • locally_verified stays false; empirical_validation stays not_run. No measurement, benchmark or performance claim is made or implied.

Out of scope

Deliberately excluded, per #348: the bound model proposed in #303 (this is a prerequisite check, not a bound, and does not depend on #303 being accepted); the Class A/Class B vocabulary of #303 — note the cited source uses Class A–Class E for an unrelated verification-rule taxonomy, and the reference document flags that collision; importing or vendoring any measured kernel corpus; any new skill ID or skill-index.json change.

CI state at this head

The skill index is regenerated. The rebase had dropped the index refresh, so the packaged records still pinned the previous main snapshot. That broke four test_frozen_offline_pilot cases, two tests/test_skill_index.py tests and the clean-wheel SKILL.md hash check. Commit 1694a0b5 regenerates it:

python tools/build_skill_index.py --source-revision 75afe47c07e337e9592010cb67b079777515fd08
python tools/build_skill_index.py --source-revision 75afe47c07e337e9592010cb67b079777515fd08 --check

All 79 records move their source pin from 7aa3344b… to 75afe47c…. Only common/skills/performance-ceiling-analysis.json changes beyond the pin: its two new reference files, updated hashes and the HuggingArch source entry. ascend/skills/torch-npu.json changes only its pin. No generated card was hand-edited.

The authoring environment has git 2.34.1, which lacks --no-lazy-fetch. The generator ran through a local wrapper that drops only that flag. This clone has no promisor remote, so no lazy fetch could occur and the hashed git blob bytes are unaffected. CI reruns the same checks with its own git.

Local verification at this head on Python 3.11:

  • ruff check src tests tools passes.
  • tests/test_skill_index.py and tests/test_collect_selection.py pass.
  • The clean-wheel tests/check_installed.py smoke passes.
  • tools/build_skill_coverage.py --check passes; the coverage view needed no change.
  • The full suite's remaining local failures are identical on an unmodified checkout of the previous head. They come from this environment: skill-eval snapshot tests require git ≥ 2.45, and some scripts need a python executable that is not on PATH. The regeneration removes the six index failures and adds none.

The knowledge-model policy still needs an exception approval. See the declaration below. The exception scope now also lists the 80 regenerated records, because src/inferrsi/data/repo_packs/**/knowledge/** is a protected path.

Knowledge author declaration

{
  "schema_version": 1,
  "head_sha": "1694a0b558c78f3920dc4f8667fee3b7c3b11c61",
  "human_only": false,
  "material_ai_authors": [
    {
      "tool": "Claude Code",
      "model_id": "claude-opus-5",
      "effort": "unknown",
      "role": "author"
    },
    {
      "tool": "Claude Code",
      "model_id": "claude-opus-5-5",
      "effort": "unknown",
      "role": "author"
    }
  ],
  "exception": {
    "paths": [
      "docs/reference-matrix.md",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/README.md",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-aclgraph-capture-replay.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-device-health.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-distributed-parallel.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-graph-mode.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-model-adaptation.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-operator-profiling.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-operator-tuning.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-optimization-casebook.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-performance-analysis.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-video-diffusion-optimization.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascendc-tiling-design.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/cann-attribution-overlap.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/torch-npu.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/torchnpu-device-memory-lifecycle.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/torchnpu-pinned-host-memory-lifecycle.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/assess-serving-preemption.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/assess-split-backward-schedule.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-fixed-workload-claim.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-h3-metal-fasth3-semantics.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-h3-runtime-residency.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-llama-runtime-state.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-recurrent-kv-finalization.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-sd-cpp-residency.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-sglang-diffusion-lifetimes.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-vllm-kv-lifetimes.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/bound-windowed-attention-replay.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/budget-speculative-verification.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/calibrate-serving-simulation.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/cgroup-resource-controls.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/checkpoint-recovery-consistency.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/choose-parallel-training-plan.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/cite-check-downstream-pr.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/claim-contract.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/comfy-ui.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/competitor-scan.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/dcp-async-save-performance.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/dense-performance-evidence.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/diagnose-vllm-admission-pressure.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/diffusers-invocation-state.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/draft-acceptance-issue.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/dwarfstar.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/evaluate-elastic-serving-placement.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/generation-cache-lifecycle.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/host-memory-management.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/host-overhead-optimization.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/husky.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/inference-benchmark-design.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/inference-optimization-casebook.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/kernel-writing-guide.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/kv-tier-management.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/lazy-evaluation-stream-lifetimes.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/lily.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/lithos-metal.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/local-dream.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/mistral-rs.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/mlc-llm.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/mlx-swift-lm.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/npu-skill-factory.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/optimization-search-policy.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/os-process-placement.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/performance-ceiling-analysis.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/plan-activation-residency.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/project-maya.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/pytorch.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/repository-evolution-analysis.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/rsi-evidence.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/skill-evolution-playbook.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/splash.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/storage-io-measurement.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/training-input-pipeline.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/training-resource-budget.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/video-diffusion-optimization.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/vllm-metal.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/weight-loading-optimization.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/audit-afd-p2p-exchanges.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/audit-flare-session-lifecycle.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/diagnose-attention-bottlenecks.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/host-overhead-profiling.json",
      "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/reason-hopper-kernels.json",
      "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/SKILL.md",
      "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/metadata.json",
      "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/references/huggingarch-checkpoint-anchor.md",
      "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/references/huggingarch-source-identity.json"
    ],
    "reason": "Material authors are claude-opus-5 (content commit) and claude-opus-5-5 (regenerated skill index). claude-opus-5 is not in the trusted allowlist, and neither author's effort setting is readable by the agent, so both efforts are declared unknown; attribution is declared truthfully rather than mapped onto an approved identity. Content is documentation and reference material only: one prerequisite procedure, one external source record with per-file digests and inspection scope, and one reference-matrix row. The 80 records under src/inferrsi/data/repo_packs/inferrsi/knowledge are tools/build_skill_index.py output at the content commit; apart from the performance-ceiling-analysis record they change only the source pin. No skill ID, registry entry, numeric gate, threshold or verdict changes; locally_verified stays false and empirical_validation stays not_run."
  }
}

The declared model identity and effort are not in the trusted allowlist, so this requests an exception under docs/knowledge-model-policy.md. Attribution is truthful and is not mapped onto an approved identity to obtain a green status. The exception needs a top-level knowledge-policy-approval comment from an authorized independent owner; the PR opener cannot grant it, and new commits require renewed approval.

docs/skill-coverage.md is outside protected_paths and so is not in the exception scope.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Nov 4, 2026 •

Copy link
Copy Markdown

Skill evaluation

PLANNED: not executed; there are no task outcomes yet.
No approval, model efficacy or current-head test result is implied.

  • Next: run the pinned source/index --check below at head 1694a0b558c78f3920dc4f8667fee3b7c3b11c61.
  • Task selection: no supported automatic comparison; choose a relevant source/content check and disposition uncovered claims.
  • Selected comparisons: 0 · Estimated task calls: 0. Uncovered/unsupported changes: 86; Canonical library paths: 4; Generated projection paths: 80; Other paths: 2. These are paths, not independent claims.
  • Return: command, input/source pin, exit status, outputs/failures and untested claims for independent verified/refuted/unverified disposition.
Author verification steps (nonpaid; not yet run)
  1. Bind the checkout. Run git rev-parse HEAD; it must equal 1694a0b558c78f3920dc4f8667fee3b7c3b11c61. If it differs, obtain a current plan; do not reuse old results.
  2. Check source/index consistency. At that PR checkout, using the reviewed repository tool and its documented development dependencies, run:
python tools/build_skill_index.py --source-revision 75afe47c07e337e9592010cb67b079777515fd08 --check

The declared source pin matches this head's canonical library bytes. The command has not run: retain its exit code and full drift/success output. It checks the generated projection, not claim truth or skill efficacy.
No supported automatic comparison is selected. Review the canonical changes and explain which claims need evidence, are unaffected, or remain unverified; do not treat generated records as separate behavioral claims.
Uncovered scope by location: Canonical library paths: 4; Generated projection paths: 80; Other paths: 2. Path counts are not claim counts; no metadata-only conclusion is inferred.
3. Return evidence for independent review: head, check/task/source pin, command, environment, exit status, outputs/failures and untested claims. Label scripted controls. Request each claim's disposition: verified, refuted or unverified; this plan proves neither model provenance nor benefit.
Check recipes and evidence limits

Evidence and logs · Retention: 30 days.
Retained artifacts are verifiable only before Unix time 1796380844 while the linked artifact is available. Expired evidence is unverified.

Plan bindings, budget, frozen exam and advisory details

Advisory: obtain missing evidence

Retained evidence availability: planned / unexecuted. No approval or merge authorization is issued.
Applicable only while these revisions and inputs match the current PR.
Paid execution requires trusted label authorization and cumulative PR reservation. Unknown accounting blocks new paid calls; planning is not execution.
Pipeline evidence only; offline fixed outputs do not establish skill efficacy.
Unchanged-correct is valid neutral evidence, not incremental benefit.
Content/source review and authorship admission remain separate.
Trusted regrading checks retained answers, not model/hardware provenance or a hostile executor; this is not an efficacy certification.

  • Retained evidence is planned / unexecuted.
  • No supported comparison cases were selected.
  • Uncovered/unsupported scope needs a case or explicit reviewer disposition.
    Plan SHA-256: a3f74fbe894d62666e5dbdec2c99f9f8632f177130004a5e39597adc268ce091
    Base: 663f3b327998526a13aa31e72ad729025c18983c · Head: 1694a0b558c78f3920dc4f8667fee3b7c3b11c61
    Trusted implementation: 9dded7adac0ac835f6a73493309399e328a43ab2

Model/settings: {"effort":"not_applicable","name":"claude-opus-5-5"}
Budget: {"comparisons":0,"estimated_calls":0,"limits_per_comparison":{"campaign_seconds":600,"max_task_calls":2,"repeats":1,"timeout_seconds":180,"token_stop_new_trials":200000},"provider_config_sha256":"b28d80f8194fbe0f5a9f01515efb24b218979fd45f702776560da276f4b30d04","reservation":null}

Skill Comparison Cases Estimated calls

Automatic execution / cumulative PR budget:

{"reason":"Trusted configuration or pricing missing, invalid or expired","remaining_usd":"unknown","reserved_or_unresolved_usd":"unknown","spent_or_legacy_usd":"unknown","state":"blocked"}

Projection check selection (not an executed result):

{"declared_in":"src/inferrsi/data/repo_packs/inferrsi/knowledge/README.md","source_revision":"75afe47c07e337e9592010cb67b079777515fd08","status":"ready"}

Provider/settings: {"client":{"api_version":"2023-06-01","endpoint":"https://yibuapi.com/v1/messages","kind":"anthropic-messages-full-context-v1","max_output_tokens":4096,"max_read_bytes":32768,"max_request_bytes":262144,"max_requests":1,"max_tool_calls":12,"provider":"yibuapi"},"limits":{"token_stop_new_trials":200000},"model":{"effort":"not_applicable","name":"claude-opus-5-5"},"pricing":{"currency":"USD","expires_at":1793271228,"group":"default","max_input_tokens":1000000,"model":"claude-opus-5-5","rate_evidence":"https://github.com/InferMatrixLab/InferRSI/issues/215#issuecomment-6467531341","rates":{"cache_read":"0.4","cache_write":"10","input":"8","output":"40"},"request_fee":"0","unit":"per_million_tokens"},"spend_limit":{"amount":"200","currency":"USD"}}

Uncovered / unsupported paths (86)
  • uncovered: "docs/reference-matrix.md"
  • uncovered: "docs/skill-coverage.md"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/README.md"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-aclgraph-capture-replay.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-device-health.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-distributed-parallel.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-graph-mode.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-model-adaptation.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-operator-profiling.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-operator-tuning.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-optimization-casebook.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-performance-analysis.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascend-video-diffusion-optimization.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/ascendc-tiling-design.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/cann-attribution-overlap.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/torch-npu.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/torchnpu-device-memory-lifecycle.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/ascend/skills/torchnpu-pinned-host-memory-lifecycle.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/assess-serving-preemption.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/assess-split-backward-schedule.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-fixed-workload-claim.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-h3-metal-fasth3-semantics.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-h3-runtime-residency.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-llama-runtime-state.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-recurrent-kv-finalization.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-sd-cpp-residency.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-sglang-diffusion-lifetimes.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/audit-vllm-kv-lifetimes.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/bound-windowed-attention-replay.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/budget-speculative-verification.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/calibrate-serving-simulation.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/cgroup-resource-controls.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/checkpoint-recovery-consistency.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/choose-parallel-training-plan.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/cite-check-downstream-pr.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/claim-contract.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/comfy-ui.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/competitor-scan.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/dcp-async-save-performance.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/dense-performance-evidence.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/diagnose-vllm-admission-pressure.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/diffusers-invocation-state.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/draft-acceptance-issue.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/dwarfstar.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/evaluate-elastic-serving-placement.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/generation-cache-lifecycle.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/host-memory-management.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/host-overhead-optimization.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/husky.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/inference-benchmark-design.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/inference-optimization-casebook.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/kernel-writing-guide.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/kv-tier-management.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/lazy-evaluation-stream-lifetimes.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/lily.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/lithos-metal.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/local-dream.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/mistral-rs.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/mlc-llm.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/mlx-swift-lm.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/npu-skill-factory.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/optimization-search-policy.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/os-process-placement.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/performance-ceiling-analysis.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/plan-activation-residency.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/project-maya.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/pytorch.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/repository-evolution-analysis.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/rsi-evidence.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/skill-evolution-playbook.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/splash.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/storage-io-measurement.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/training-input-pipeline.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/training-resource-budget.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/video-diffusion-optimization.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/vllm-metal.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/common/skills/weight-loading-optimization.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/audit-afd-p2p-exchanges.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/audit-flare-session-lifecycle.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/diagnose-attention-bottlenecks.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/host-overhead-profiling.json"
  • uncovered: "src/inferrsi/data/repo_packs/inferrsi/knowledge/cuda/skills/reason-hopper-kernels.json"
  • uncovered: "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/SKILL.md"
  • uncovered: "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/metadata.json"
  • uncovered: "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/references/huggingarch-checkpoint-anchor.md"
  • uncovered: "src/inferrsi/data/skill_library/methods/performance-ceiling-analysis/references/huggingarch-source-identity.json"

`methods/performance-ceiling-analysis` L1 divides a count by a rated peak and
never revisits the model, so an error in the count reaches the floor
unchallenged and no later roofline step re-examines it. The skill had no
procedure for checking the demand side; `safetensors` appeared nowhere under
this owner while the loading mechanics already lived next door.

Add a two-gate prerequisite: the bidirectional per-tensor checkpoint join, and
the separate per-rank weight ledger. The first needs no parallelism layout, so
passing it certifies nothing about per-device bytes, and the distinction is
stated rather than implied. State the blind spot too: the anchor covers the
weight traffic term only, since a windowed and a global attention with equal
head dimensions have byte-identical weights.

Record the reviewed external source it derives from at a pinned commit, with
per-file git blob and sha256 digests and per-file inspection scope.
Documentation claims and source-verified claims are marked separately. Carry
the source's two-threshold rule, which grants rejection authority only to a
rated-peak bound and not to a per-operation roofline, and its archived
guard-ablation study with the source's own limitations intact.

What the source does not establish is recorded as explicitly as what it does:
no end-to-end validation of predicted against measured serving performance
within the inspected scope, unmeasured collectives upstream, and companion-blog
corpus figures that the repository documents do not state and that must not be
cited. `locally_verified` stays false; `empirical_validation` stays not_run.

Refs: InferMatrixLab#348

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Copy link
Copy Markdown
Collaborator

Review of the full PR (new PR, no earlier review of mine): base 663f3b327998526a13aa31e72ad729025c18983c … head b5b7dda6959c92e730fe78fad66e6948d5951cb6 (commits 741c2ec2 content + b5b7dda6 generated refresh).

Not approving yet; the content itself is careful (both gates, the weight-only scope limit and the "does not establish" list read well, and I checked that the 60+ generated records outside performance-ceiling-analysis change only the ca201c99… → 741c2ec2… pin). The items below need to be resolved or answered first.

Blocking / needs action

  1. declarations check is failing at this head (job). The PR declaration names model_id: "claude-opus-5" with effort: "unknown", while .github/knowledge-model-policy.json on main only admits claude-opus-5-5 (and the GPT-6 models) with effort xhigh/max. So every protected path lands in exception and needs approval from the policy approval owner. Please either correct the declaration if the actual model/effort was an admitted one, or request the exception approval explicitly — as is, the PR cannot satisfy the policy.
  2. Source pin will be orphaned on squash merge (src/inferrsi/data/repo_packs/inferrsi/knowledge/README.md L18 and L33, plus every regenerated record). 741c2ec2… is a branch-only commit; after a squash merge, python tools/build_skill_index.py --source-revision 741c2ec2… --check and all record URLs point at a commit that is not on main. You raised this yourself in the PR body; I think it needs a decision before merge (merge commit / rebase-merge, or a post-merge regeneration step that a maintainer owns), rather than being left open.

Provenance questions (please confirm or downgrade the marker)

  1. references/huggingarch-checkpoint-anchor.md — several claims are tagged [code] but the identity file's inspection scope seems narrower than the claim:
    • Gate 1 "join on the full tensor name … the analysis side composes its names from declared root, stack and module segments [code]" (around L28–38), while _matching.py is recorded as "Matching internals not traced".
    • "Row refused at ingest (HTTP 422) [code]" in the two-threshold table (around L97): the inspected file is kernel_bench/emit.py (gate function + constant, "row construction not traced"). Which inspected file shows the 422 ingest refusal? If it is in the upload/backend path that was not inspected, this should be [doc].
    • "The repository carries 16 provider environment files … [code]" (around L180): which file/listing supports this? If it comes from the tree listing, please say so in the identity method.
  2. The blog-sourced "2× long-context prefill baseline error" figure: the identity file says sections from 3.7 onward were only reached via a generated summary. Please state which section the figure comes from; if it is ≥3.7 it is second-hand and I would drop it rather than carry it even as "unverified".

Minor

  1. metadata.json note says "Single-commit repository created 2026-11-03", while the identity file records commit_date: 2026-11-04T02:24:14Z (repo created 2026-11-03T16:33Z). Both are true, but please phrase it so the date in metadata isn't read as the commit date.
  2. The provenance_readsets list was also re-sorted (case-sensitive order); fine, just mention it in the PR body so the diff isn't mistaken for removals.

Not verified by me: the HuggingArch file hashes/blobs, and the PR's local ruff/pytest results (53 pre-existing failures). I'll re-review on the next push.

Copy link
Copy Markdown
Collaborator

Incremental review b5b7dda6..18c9a16c, checked against my previous review. The branch was rebased: content commit 741c2ec2 (on 0b19c5c3) became 75afe47c (on 663f3b32), and the generated commit is now 18c9a16c (chore: refresh skill coverage view). Not approving yet.

What changed: I compared the per-file patches of 741c2ec2 and 75afe47c for the 5 substantive files; apart from hunk offsets and rebase context in metadata.json (the FlexGen/Mooncake entries from main), the content is identical. The generated commit now only touches docs/skill-coverage.md (input digest plus one row); the PR is down to 6 files, from the 69 regenerated records described in the PR body.

New at this head

  1. full-check (3.10, 3.11) and installed-package (3.10, 3.11) now fail. I read the full-check 3.11 log (6 failed, 3538 passed); I did not inspect the installed-package logs. tests/test_collect_selection.py::test_frozen_offline_pilot (4 cases) reports package:inferrsi.common.skills.performance_ceiling_analysis as index_unavailable / "Stale packaged skill projection; rebuild with build_skill_index.py", and tests/test_skill_index.py::test_complete_index_retains_metadata_states_and_unknown_license and ::test_generated_index_matches_current_sources_without_historical_git_objects fail too. My read is that the rebase dropped the skill-index regeneration and only the coverage view was refreshed, but please verify: rerun python tools/build_skill_index.py --source-revision <rev> and commit the result (or explain the intended state), and update the PR body's "Generated — 69 files" line to match.

Still open from last round (no change in this delta)

  1. declarations still fails (job): "Missing, invalid or stale knowledge author declaration". The declaration still needs to name an admitted model/effort, or get an explicit exception approval.
  2. Source pin on squash merge: whatever revision the regenerated index is pinned to (previously 741c2ec2, now presumably 75afe47c) is branch-only and will be orphaned by a squash merge. This still needs a merge-strategy or post-merge regeneration decision.
  3. [code] vs [doc] markers in references/huggingarch-checkpoint-anchor.md (Gate 1 name composition vs _matching.py "not traced"; the HTTP 422 ingest refusal; the "16 provider environment files"), and the "2× long-context prefill baseline error" figure's section: unchanged, questions as before.
  4. Minor: metadata.json "created 2026-11-03" vs commit_date wording, and mentioning the provenance_readsets re-sort in the PR body.

Static review of the delta plus the hosted CI logs; I did not run anything locally.

@Dong1017 Dong1017 added the area:knowledge Knowledge line: packs, skill library, knowledge admission label Nov 4, 2026 — with ChatGPT Codex Connector
The rebase kept only the coverage-view refresh, so the packaged records
still pinned the previous main snapshot and the performance-ceiling-analysis
projection was stale. Regenerate with
`build_skill_index.py --source-revision 75afe47`.
Apart from that skill's record, every record changes only its source pin.

Agent-assisted-by: Claude Code / claude-opus-5-5 (author)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Chenguang Zheng <zhengcg0505@gmail.com>

Copy link
Copy Markdown
Collaborator

Incremental review 18c9a16c..1694a0b5 (one new commit, 1694a0b5 "chore: regenerate skill index at the content commit"), checked against my previous review and the updated PR body. Not approving yet.

Fixed in this delta

  1. Stale skill index (my item 1 last round). I checked all 80 changed files under src/inferrsi/data/repo_packs/inferrsi/knowledge/: 79 change only the source pin 7aa3344b… → 75afe47c… (README L18 and L32 included), and common/skills/performance-ceiling-analysis.json additionally gains the two new references/huggingarch-* paths and hashes, the HuggingArch source entry, the extended verification note and the new limitation, all consistent with the canonical metadata.json. installed-package (3.10/3.11) is now green. full-check (3.10/3.11) was still running when I looked, so I can't yet confirm the six test_collect_selection / test_skill_index failures are gone; please confirm once it finishes.

Still open

  1. declarations still fails at this head (job). The declaration now truthfully lists claude-opus-5 / claude-opus-5-5 with effort unknown and requests an exception with the 80 regenerated records in scope, which is the right way to handle it. It still needs a knowledge-policy-approval comment from an authorized independent owner, and that approval must be renewed after any further push, so it's best requested after the last commit.
  2. Source pin on squash merge. The regenerated records and knowledge/README.md (L18, L32) are now pinned to 75afe47c, which is still a branch-only commit and would be orphaned by a squash merge. A merge-strategy decision (merge or rebase-merge) or a maintainer-owned post-merge regeneration step is still needed.
  3. [code] vs [doc] markers in references/huggingarch-checkpoint-anchor.md (Gate 1 name composition vs _matching.py "not traced", the HTTP 422 ingest refusal, the "16 provider environment files") and the section for the "2× long-context prefill baseline error" figure. This delta doesn't touch that file, so the questions from last round still stand.
  4. Minor: the metadata.json "created 2026-11-03" vs commit_date wording. Also, the regenerated performance-ceiling-analysis.json re-sorts provenance_readsets (uppercase INTEGRATION_NOTES.md/README.md/STATIC_CHECKS.md before cases/…), and the PR body's "only … changes beyond the source pin" description doesn't mention that.

Static review of the delta plus hosted CI status. I didn't run anything locally.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:knowledge Knowledge line: packs, skill library, knowledge admission

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants