Skip to content

kb init(afd-plugin): skeleton - #268

Merged
tzhouam merged 1 commit into
mainfrom
kb/init-afd-plugin-skeleton
Sep 30, 2026
Merged

tzhouam merged 1 commit into
mainfrom
kb/init-afd-plugin-skeleton

Conversation

@tzhouam

@tzhouam tzhouam commented Sep 30, 2026

Copy link
Copy Markdown
Collaborator

kb init stage skeleton for afd-plugin (vllm-project/afd-plugin).

  • Upstream pin: 9cae2d2ddaae7e1752fc12ead577d59540b17f27
  • Knowledge base: 1d84a91fe9446476dc29664a6f3eebfcf8778b67
  • Model spend (accounted): $14.76

Human-merged. Rules were screened by the docs redundancy filter, checked at the pin, and given an advisory verdict; fail rules are already removed.

rule page verdict
AFD-I1 repos/afd-plugin/rules-init.md unsure
AFD-I2 repos/afd-plugin/rules-init.md pass
AFD-I3 repos/afd-plugin/rules-init.md pass
AFD-I4 repos/afd-plugin/rules-init.md pass
AFD-I5 repos/afd-plugin/components/compatibility/rules.md pass
AFD-I6 repos/afd-plugin/components/compatibility/rules.md unsure
AFD-I7 repos/afd-plugin/rules-init.md unsure
AFD-I8 repos/afd-plugin/rules-init.md pass
AFD-I9 repos/afd-plugin/rules-init.md unsure
AFD-I10 repos/afd-plugin/rules-init.md pass
AFD-I11 repos/afd-plugin/rules-init.md pass
AFD-I12 repos/afd-plugin/rules-init.md unsure
AFD-I13 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md pass
AFD-I14 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md pass
AFD-I16 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md pass
AFD-I17 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md unsure
AFD-I18 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md pass
AFD-I19 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md pass
AFD-I23 repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md unsure

Seeds (adapted, provenance only here):

  • repos/vllm-omni/rebase/upstream-api-drift.md @ 1d84a91fe944 → repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md (AFD-I13, AFD-I14, AFD-I15, AFD-I16, AFD-I17, AFD-I18, AFD-I19, AFD-I20, AFD-I21, AFD-I22, AFD-I23)
Dropped rules
  • AFD-I15: advisory judge: fail {"faithful": "The claim that these seams are absent from the patch inventory is too broad: the inventory explicitly lists the CUDA DBO Attention metadata workaround (compatibility_and_patches.md:L82). The other described seams are supported by compatibility_and_patches.md:L138-L149.", "non_contradic
  • AFD-I20: advisory judge: fail {"faithful": "提案称 README 的两节都要求设置 VLLM_USE_V2_MODEL_RUNNER=0,但所给 Known gaps 证据只声明 V2 不受支持;设置命令仅见 README L180–L185,且该处只明确谈 GPU。见 README L65–L68、L180–L185。其余 V2 约束与测试证据见 attention_runtime.md L139–L162、ffn_runtime.md L129–L148、e2e_testing.md L105–L111。", "non_contradictory": "与 AFD-I7、AFD-I8 关于 V2 配对
  • AFD-I21: advisory judge: fail {"faithful": "规则要求核对 FFN runner 接口并称其“返回空的 KV-cache spec”,但所引证据明确说返回该 spec 的是两个 worker;runner 负责将 KV-cache 初始化设为 no-op(ffn_runtime.md:L115-L118)。", "non_contradictory": "与 AFD-I15 的上游 seam 升级审计要求一致;所引平台设计也确认 CUDA FFN 使用插件自有的最小 runner(execution_platforms.md:L77-L83、L132-L139)。", "actionable": "升级时对照
  • AFD-I22: advisory judge: fail {"faithful": "The proposed rule says to update the run-e2e skill only when commands, variables, or the default suite change. The cited adding-a-case guidance also requires an update when prerequisites change (docs/design/module/e2e_testing.md:L190-L199). Its claims about stable IDs, exact node ID se

Needs human edit:

  • repos/afd-plugin/rules.md is a briefing doc (knowledge.briefing_docs, rendered under a hard cap): init writes its rules to repos/afd-plugin/rules-init.md instead
  • repos/afd-plugin/_index.md: new entries were appended as a list; move them into the page's table if you prefer its style
  • review_routes (adapter PR): {prefix: uv.lock, owner: plugin-boundary, doc: repos/afd-plugin/components/plugin-boundary/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/config/, owner: plugin-boundary, doc: repos/afd-plugin/components/plugin-boundary/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/package/test_package.py, owner: plugin-boundary, doc: repos/afd-plugin/components/plugin-boundary/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/test_envs.py, owner: plugin-boundary, doc: repos/afd-plugin/components/plugin-boundary/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_runtime_classpaths.py, owner: plugin-boundary, doc: repos/afd-plugin/components/plugin-boundary/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/plugin_boundary.md, owner: plugin-boundary, doc: repos/afd-plugin/components/plugin-boundary/_index.md}
  • review_routes (adapter PR): {prefix: afd_plugin/v1/worker/attention_metadata.py, owner: attention-runtime, doc: repos/afd-plugin/components/attention-runtime/_index.md}
  • review_routes (adapter PR): {prefix: afd_plugin/v1/worker/attention_model_runner_v2.py, owner: attention-runtime, doc: repos/afd-plugin/components/attention-runtime/_index.md}
  • review_routes (adapter PR): {prefix: afd_plugin/v1/worker/npu/attention_model_runner_v2.py, owner: attention-runtime, doc: repos/afd-plugin/components/attention-runtime/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_attention_model_runner.py, owner: attention-runtime, doc: repos/afd-plugin/components/attention-runtime/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_model_runner_v2.py, owner: attention-runtime, doc: repos/afd-plugin/components/attention-runtime/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/attention_runtime.md, owner: attention-runtime, doc: repos/afd-plugin/components/attention-runtime/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_ffn_model_runner.py, owner: ffn-runtime, doc: repos/afd-plugin/components/ffn-runtime/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/ffn_runtime.md, owner: ffn-runtime, doc: repos/afd-plugin/components/ffn-runtime/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/connectors/, owner: connectors, doc: repos/afd-plugin/components/connectors/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/distributed/, owner: connectors, doc: repos/afd-plugin/components/connectors/_index.md}
  • review_routes (adapter PR): {prefix: docs/gpu/, owner: connectors, doc: repos/afd-plugin/components/connectors/_index.md}
  • review_routes (adapter PR): {prefix: docs/npu/CAM_P2P_CONNECTOR_USER_GUIDE.md, owner: connectors, doc: repos/afd-plugin/components/connectors/_index.md}
  • review_routes (adapter PR): {prefix: docs/npu/CAM_ASYNC_CONNECTOR_USER_GUIDE.md, owner: connectors, doc: repos/afd-plugin/components/connectors/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/connector_contracts.md, owner: connectors, doc: repos/afd-plugin/components/connectors/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/model_executor/, owner: model-integration, doc: repos/afd-plugin/components/model-integration/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/model_integration.md, owner: model-integration, doc: repos/afd-plugin/components/model-integration/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/compat/test_profiler.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/compat/test_ascend_ops.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/compat/npu/test_profiler.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/package/test_ascend_build_files.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_cuda_graph.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_dbo.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_npu_mla_graph.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_npu_device_contract.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/v1/worker/test_npu_runtime.py, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: docs/npu/CAM_ASYNC_ROUTED_OPS.md, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/execution_platforms.md, owner: execution-platforms, doc: repos/afd-plugin/components/execution-platforms/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/compat/patches/, owner: compatibility, doc: repos/afd-plugin/components/compatibility/_index.md}
  • review_routes (adapter PR): {prefix: tests/unit/compat/test_runtime.py, owner: compatibility, doc: repos/afd-plugin/components/compatibility/_index.md}
  • review_routes (adapter PR): {prefix: docs/design/module/compatibility_and_patches.md, owner: compatibility, doc: repos/afd-plugin/components/compatibility/_index.md}
  • review_routes (adapter PR): {prefix: tests/e2e/, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: tests/conftest.py, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: tests/unit/test_e2e_runner.py, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: tests/unit/test_e2e_process_utils.py, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: tests/unit/test_dsv4_e2e.py, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .agents/skills/run-e2e/, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .buildkite/, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .github/, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: docker/, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: docs/design/module/e2e_testing.md, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: docs/npu/TESTING.md, owner: e2e-ci, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: AGENTS.md, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: CLAUDE.md, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .agents/, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .claude/, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .pre-commit-config.yaml, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .markdownlint.yaml, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .gitattributes, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: .lfsconfig, owner: repo-rules, doc: repos/afd-plugin/rules.md}
  • review_routes (adapter PR): {prefix: README.md, owner: docs-recipes, doc: repos/afd-plugin/architecture.md}
  • review_routes (adapter PR): {prefix: docs/, owner: docs-recipes, doc: repos/afd-plugin/architecture.md}
  • review_routes (adapter PR): {prefix: recipe/, owner: docs-recipes, doc: repos/afd-plugin/architecture.md}
  • no route reaches repos/afd-plugin/architecture.md: add a review_routes entry pointing at it (adapter PR)
  • no route reaches repos/afd-plugin/components/compatibility/architecture.md: add a review_routes entry pointing at it (adapter PR)
  • no route reaches repos/afd-plugin/components/plugin-boundary/architecture.md: add a review_routes entry pointing at it (adapter PR)
  • no route reaches repos/afd-plugin/rules-init.md: add a review_routes entry pointing at it (adapter PR)
  • no route reaches repos/afd-plugin/rules-seed-vllm-omni-rebase-upstream-api-drift.md: add a review_routes entry pointing at it (adapter PR)
  • no route reaches repos/afd-plugin/rules.md: add a review_routes entry pointing at it (adapter PR)

Notes:

  • routes come from the adapter manifest (review_routes): kb init writes no _routes.yaml; entries it lacks are suggested on the checklist

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-30T18:38:53.379080Z c20683b PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c20683b8c3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +47 to +48
- [AFD plugin 仓库规则](rules-init.md)
- [上游 API 漂移与兼容边界(afd-plugin)](rules-seed-vllm-omni-rebase-upstream-api-drift.md)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Route the generated rules through their actual owners

For Direct reviews of connector or compatibility changes, adapters/afd_plugin/manifest.yaml routes to the corresponding component page and the briefing includes only rules.md plus _index.md; _review_knowledge() never returns either of these newly linked pages. Consequently constraints such as AFD-I1–I3/I10 and AFD-I13–I23 are absent from the review context for precisely the files they govern. Split or merge them into the nearest routed component rules.md pages, rather than relying on links from the repository index.

AGENTS.md reference: AGENTS.md:L12-L17

Useful? React with 👍 / 👎.

Comment on lines +12 to +18
## AFD-I13 — vLLM 目标版本写在多处,注册期只告警:改 pin 时所有守卫要一起改

- 目标版本 `0.26.0` 同时写在三类位置:`pyproject.toml` 的 `vllm` extra(`vllm==0.26.0`)、`afd_plugin/compat/vllm.py` 的版本检查、README 与设计文档里的支持声明。PR 改了其中一处,其余位置必须跟着改。版本守卫有变化时,还要补 package 兼容测试 `tests/unit/package/test_package.py`。
- 插件注册调用版本检查时用的是 `strict=False`,版本不匹配只打 warning,然后继续运行。因此“新版本上插件能注册”或“单测能通过”都不算支持证据。在签名不同的上游上跑通的单测,也不算兼容证据。
- `config_validation.py` 和 `async_dp_forward_context.py` 放行三种情况:目标版本、dev 版本、缺失版本元数据。
- `async_dp_engine.py` 的一般 async 绑定沿用 target/dev 守卫,但其中复制的 coordinator 只在版本恰好是 `0.26.0` 时生效。更新的 dev 版本会保留原生 coordinator。
- 所以 bump pin 的 PR 必须显式更新这个 exact 守卫及其测试。否则 async-DP Attention 的行为会悄悄变掉,而且不会报错。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Merge duplicate AFD rules instead of assigning parallel IDs

AFD-I13 repeats the version-pin, strict=False, and exact coordinator-guard requirements added simultaneously under AFD-I5; the same page also duplicates AFD-I4 as I18 and AFD-I11 as I23. Keeping synonymous constraints under separate IDs and pages lets later edits or review coverage disagree about which copy is authoritative. Fold each rule's unique details into the existing owner rule before adding another ID.

AGENTS.md reference: AGENTS.md:L7-L11

Useful? React with 👍 / 👎.

@tzhouam
tzhouam merged commit ba95ae7 into main Sep 30, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant