docs(spec,kernel): the dev-plugin protocol header stops lying (#4149); services-checklist accuracy pass - #4151
Merged
Conversation
…ed stub design (#4149) The module header claimed the kernel bootstraps every subsystem with in-memory or stub implementations — the design ADR-0115 just retired — and implied @objectstack/plugin-dev consumes this schema. It never did: the shipped plugin reads its own DevPluginOptions, and none of the declared surfaces (presets, fixtures, dev-tools dashboard, per-service strategies, simulated latency) exist. The header now says exactly that and points at #4149, the enforce-or-remove evaluation for the whole declared-but-unconsumed family. Generated reference doc regenerated (gen:schema && gen:docs); all eight spec artifact gates pass. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BEM82RNKyyyTNPYHK1VJJS
…corrections (#4093 follow-up) Scoped docs-accuracy-audit run (audit + adversarial verify, 10/10 confirmed, zero verifier repairs): metadata protocol methods 7→8 (deleteMetaItem), the DB-persistence gap row now says MetadataPlugin shipped, the discovery example carries the builders' real message strings, /storage is no longer listed as a dispatcher domain (#4087 retired the bridge; service-storage mounts its own routes), the driver infrastructure table names the shipped driver packages instead of TBD, the analytics in-memory note describes the actual strategy wiring, the ai entry records the #3718 contract deletion as done rather than pending, and the queue row stops advertising BullMQ/Redis adapters nobody ships. Five residual items were deliberately left (roadmap content and aggregate counts covered by the page's own out-of-date banner) and are listed in the PR. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BEM82RNKyyyTNPYHK1VJJS
|
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 1 package(s): 106 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:
|
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BEM82RNKyyyTNPYHK1VJJS
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
2 participants
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.
#4093 系列的收尾两项（维护者指定的第 2、3 项），docs-only。
1. spec 侧 dev-plugin 协议描述（第 2 项）
packages/spec/src/kernel/dev-plugin.zod.ts的文件头此前声称"kernel 用 in-memory 或 stub 实现启动所有子系统"——正是 ADR-0115 刚整体退役的设计。修正为如实描述：declared, not implemented —— 真实的@objectstack/plugin-dev消费自己的DevPluginOptions，从不 import 这个 schema，声明面（preset / fixtures / dev-tools 仪表盘 / 按服务策略 / 模拟延迟）无一实现，strategy: 'stub'描述的行为已被平台裁决退役。核实中发现整族 schema 零消费者（仅生成物与 spec 自测），按 PD #10 另立 #4149（ADR-0049 enforce-or-remove 评估，倾向整族退役）——本 PR 只修描述并指向该 issue，不扩面。生成文档已重生成（
gen:schema && gen:docs），spec 八个工件 gate 全过。2. services-checklist.mdx 全面校对（第 3 项）
用
docs-accuracy-audit工作流定向跑这一份（audit → 对抗性复核；10 处修复全部确认、零复核修正、MDX build-safe）。修复均有 file:line 证据：metadata协议方法 7→8（deleteMetaItem实存）；DB 持久化 gap 行改为"已由MetadataPlugin落地"；/storage不再列为 dispatcher 域（dispatcher 的 /storage/upload 用 upload(file, {request}) 调用契约里的 upload(key, data, options?) —— 对任何实现都会 TypeError #4087/fix(runtime,hono,plugin-dev): 退役 dispatcher 的 /storage bridge —— 它从来没按契约调用过 storage (#4087) #4112 已退役该 bridge，service-storage自挂/api/v1/storage）；driver-sql/driver-mongodb/driver-sqlite-wasm；ai条目把 The SDK's entireainamespace is dead, and the entire real AI surface is unreachable from the SDK — the two sets are disjoint #3718 的契约删除记为已完成而非待办；queue行不再宣传未发布的 BullMQ/Redis 适配器。残留 5 项（复核者按最小编辑原则刻意保留，页面顶部"历史状态"横幅已覆盖）：ai 概览行与其小节的计数内部不一致（契约已删）；"Last Updated" 聚合计数未重算；基础设施表的 file-storage/search 驱动清单可能是愿景；discovery 示例两条目省略
handlerReady（简写示意）；"Recommended Development Phases" 命名了不存在的插件包（路线图内容）。这一页的根治是横幅里已写明的"重新生成"，不在本次范围。验证
🤖 Generated with Claude Code
https://claude.ai/code/session_01BEM82RNKyyyTNPYHK1VJJS
Generated by Claude Code