feat(spec): IHttpServer 软扩展与未匹配语义成文 (#3607) - #3628
Merged
Merged
Conversation
…mantics (#3607) ADR-0076 OQ#10's follow-up: res.write/end (SSE streaming contract), getPort() (real bound port incl. listen(0)), and 404/405 semantics (shared not-found body; Allow header on method mismatch) move from "observed cross-adapter parity" to formal interface contract, with the conformance assertions now citing the spec JSDoc. Optional members + feature-detect guidance — zero behavior change; both adapters already conform (full forced build + conformance 41 green; api-surface unchanged). Closes #3607. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
github-actions
Bot
added
documentation
Contributor
📓 Docs Drift CheckThis PR changes 2 package(s): 105 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
OQ#10 尾巴收口（加性小活，非 breaking）
三个两适配器已实现、此前仅靠 conformance 套件经验锁定的行为升格为接口正式契约：
IHttpResponse.write/end（SSE/分块流）：首次 write 即 flush 头、不得缓冲到 end、提供 write 必须提供 end；消费方 feature-detect 缺席回退 buffered send。IHttpServer.getPort()：listen()后返回真实绑定端口（含listen(0)临时端口）。Allow头。新适配器必须过 conformance 套件。conformance 断言注释从"观察到的一致性"升级为契约引用（指向 spec JSDoc）。
验证
全仓 forced build 绿；conformance 41 断言绿（两适配器零代码变化即满足）；api-surface 重生成零 diff（optional 成员不改导出清单）。
Closes #3607。
🤖 Generated with Claude Code