Skip to content

RFC-0036: 补齐 roadmap 全节点设计与验收映射 - #207

Draft
eric8810 wants to merge 1 commit into
masterfrom
docs/rfc-0036-positioning-and-layered-architecture
Draft

eric8810 wants to merge 1 commit into
masterfrom
docs/rfc-0036-positioning-and-layered-architecture

Conversation

@eric8810

@eric8810 eric8810 commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

增补现有 RFC-0036,逐项覆盖 0.6→1.0 的 68 个节点,补齐 A/E 清理、替代关系、延期条件与发布验收。

状态与依赖

不新增路线图;#200 已记录方向的编号/正文/替代关系仍需修订,原版本日期不在本 PR 调整。

本 PR 属于完整 roadmap RFC 批次。整批已完成节点覆盖与跨文档契约复核,再按主题分别提交 Draft。各 PR 均独立基于 master,不叠加其他未合并文档。设计齐备不表示运行时实现或验收已完成。

验证

  • 文档编号、代码围栏、相对链接、空白检查通过
  • 本 PR 仅修改 rfc/0036-positioning-and-layered-architecture.md
  • 本地未运行构建、运行时测试、性能实测或真实 provider 探测;CI 状态以本 PR 当前 head 的检查结果为准

同批设计(均独立基于 master)

cunninghamcard-bit pushed a commit that referenced this pull request Oct 3, 2026
…xAI/HF chat extension

Two wording fixes so the design matches the RFC-0036 §12.2 replacement
list proposed in #207:

- §0.7 and the ROADMAP 0.8 note no longer leave "old exports coexist one
  minor" to a later decision: the full-chain cutover has no coexistence
  period, and the old symbols replaced when the ops ABI arrives are
  removed on that cutover gate (RFC-0039), so the promise is withdrawn
  rather than deferred.
- §3.3 and the rejected-finding row S4-7 state what the implementation
  does with xAI / Hugging Face Chat Completions: the V4 entry points only
  offer Responses, and the existing Chat Completions model stays as an
  explicit `chat_completions(id)` extension outside the `Provider`
  trait, registered as a product difference.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_01WGwanvo9WLU9HWD7sRR8TS
eric8810 added a commit that referenced this pull request Oct 3, 2026
* docs: full-chain AI SDK alignment design and impact map

Implementation design under RFC-0036 (positioning and layered
architecture), placed in docs/ rather than rfc/: it does not take an RFC
number and does not re-decide direction. Compared with the earlier RFC
draft of the same content:

- Header states the document's relation to RFC-0036 and how it takes
  effect (on merge; later changes edit the file). No "Accepted" status.
- §0.7 lists, item by item, which ROADMAP / RFC-0036 commitments the
  design keeps, adjusts or postpones: L2 choice (AI SDK V4 shape, survey
  RFC withdrawn), the one-shot breaking switch versus the old-ABI
  coexistence promise, ops protocol / stdio / L0 passthrough (kept,
  after the switch), B track, #174/#175 auth, #167/#179 replay, #185.
  ROADMAP.md and the positioning RFC carry notes pointing at that table
  where their wording is adjusted.
- §0.4 Q4, D18, §6.4 and §10 now agree: host callbacks are postponed in
  every language, including the Node TSFN / Python GIL bridges.
- Part II's two open items are written as conclusions (no
  aimux-protocol crate; JSON adaptation rules adopted), and the
  impact-map §6.4 questions each carry the section that settles them.
- docs/README.md indexes both files; links are relative to docs/.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_01WGwanvo9WLU9HWD7sRR8TS

* docs: drop the ABI coexistence promise after the cutover; record the xAI/HF chat extension

Two wording fixes so the design matches the RFC-0036 §12.2 replacement
list proposed in #207:

- §0.7 and the ROADMAP 0.8 note no longer leave "old exports coexist one
  minor" to a later decision: the full-chain cutover has no coexistence
  period, and the old symbols replaced when the ops ABI arrives are
  removed on that cutover gate (RFC-0039), so the promise is withdrawn
  rather than deferred.
- §3.3 and the rejected-finding row S4-7 state what the implementation
  does with xAI / Hugging Face Chat Completions: the V4 entry points only
  offer Responses, and the existing Chat Completions model stays as an
  explicit `chat_completions(id)` extension outside the `Provider`
  trait, registered as a product difference.

Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_01WGwanvo9WLU9HWD7sRR8TS

* docs: address review findings on the alignment design

- complete the truncated §6.4-14 ruling in the impact map (pull-style
  streaming ABI: not this round, stays with the async C ABI deferral)
- annotate S5-1/S5-2 with the main-doc rulings (no 2→3 migration table,
  no rebuild_provider; live replay is registry + target-ref driven)
- mark the Part II ts-rs advice as overruled by §0.5/§6.5 inline
- convert 7 markdown links into the local-only aisdk-review checkout
  to AI:/A: code refs (reference/ is gitignored; links 404 for others)
- note the local-only reference baseline in the evidence convention
- annotate the 0.6 B1+C2 ROADMAP row (B1 reshaped, C2 shim cancelled)
- flatten nested-paren annotations in ROADMAP #185 rows
- drop the duplicate H1 title in the impact map; bump the revision date

---------

Co-authored-by: chenhaonan <[email protected]>
Co-authored-by: Claude Fable 5.1 <[email protected]>
Co-authored-by: eric8810 <[email protected]>

This branch has not been deployed

No deployments
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