Skip to content

refactor(spec)!: remove the Dev Mode Plugin Protocol family — declared, never implemented, taught the retired stub design (#4149) - #4155

Merged
os-zhuang merged 1 commit into
mainfrom
claude/plugin-dev-stub-slots-eval-hqjox1
Jul 30, 2026
Merged

refactor(spec)!: remove the Dev Mode Plugin Protocol family — declared, never implemented, taught the retired stub design (#4149)#4155
os-zhuang merged 1 commit into
mainfrom
claude/plugin-dev-stub-slots-eval-hqjox1

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Closes#4149。按 ADR-0049 enforce-or-remove 执行,remove 路线,遵循 spec-property-retirement playbook。

删什么、为什么

DevPluginConfigSchema / DevServiceOverrideSchema / DevFixtureConfigSchema / DevToolsConfigSchema / DevPluginPreset 整族从 @objectstack/spec/kernel 移除:

  • 零消费者plugin-dev 读自己的 DevPluginOptions,从未 import 这族;仓库内仅生成物与其自身 shape 测试引用。
  • 无加载路径解析:核实修正 issue 里的一处表述 —— stack.devPlugins存在,但接受 ManifestSchema | string(插件清单/名字),与这族 config 无关,家族仍是彻底孤儿。
  • 词汇表与平台裁决相抵strategy: 'stub' 教的正是 ADR-0115 刚退役的填槽设计。

路线选择(playbook §2 第三叉)

刻意不做 tombstone、不做 ADR-0087 conversion:无人能收到 prescription(没有任何地方可以 author 这些键),也没有可供 os migrate meta 改写的源 —— DynamicLoadingConfig 先例(#3950)。基线在同一 PR 内果断删除:

  • json-schema.manifest.json 减五个 kernel/Dev* 条目(manifest ratchet 的指定动作);
  • authorable-surface.json 减 22 行 kernel/Dev*(无人能 author → 无 [RETIRED] 标记,gate (a) 同 PR 刻意消行);
  • api-surface.json 重生成(五个导出离开公共面);
  • 生成参考页由 gen:docs 移除(references/kernel/dev-plugin.mdx + index/meta 同步);
  • v17 release notes「Dead spec clusters removed」表加行(FeatureFlagSchema 同型先例);
  • liveness ledger 无涉(只按元数据类型记账,这从来不是);
  • kernel/index.ts 留 house-style 注释(feature.zod 先例)说明去向;
  • breaking changeset 带 FROM→TO("删 import,无可迁移之物;本地开发配置用 DevPluginOptions");RC pre-mode 下 major 豁免 no-major guard。

验证

  • spec build 绿;11 个 spec gate 全 PASS(liveness / empty-state / authorable-surface / docs / api-surface / spec-changes / upgrade-guide / skill-refs / skill-docs / skill-examples / react-blocks);
  • spec 测试 7072/7072
  • 全仓 grep:除 kernel/index.ts 的解释注释外无任何残留引用;
  • check:i18n 在本环境对未改动的 checkout 同样失败(extract 工具链不可用),与本 PR 无关 —— 以 CI 为准。

🤖 Generated with Claude Code

https://claude.ai/code/session_01BEM82RNKyyyTNPYHK1VJJS


Generated by Claude Code

…d, never implemented, taught the retired stub design (#4149)
DevPluginConfigSchema, DevServiceOverrideSchema, DevFixtureConfigSchema,
DevToolsConfigSchema and DevPluginPreset leave @objectstack/spec/kernel
outright. Zero consumers (plugin-dev reads its own DevPluginOptions and
never imported them; only the generated artifacts and the family's own
shape test referenced them), no load path parsed them
(stack.devPlugins takes ManifestSchema | string, not this config), and
the strategy:'stub' vocabulary recommended exactly the design ADR-0115
retired.
Deliberately NO tombstone and NO ADR-0087 conversion: a prescription
nobody can receive is noise, and there is no authored source for
os migrate meta to rewrite — the DynamicLoadingConfig precedent
(#3950). Baselines dropped in the same PR: json-schema.manifest.json
minus five kernel/Dev* entries, authorable-surface.json minus 22
kernel/Dev* lines, api-surface.json regenerated, the generated
reference page removed by gen:docs, and the v17 dead-clusters table
extended. No liveness-ledger entries existed.
Verified: spec build green, all eleven spec gates PASS (liveness,
empty-state, authorable-surface, docs, api-surface, spec-changes,
upgrade-guide, skill-refs, skill-docs, skill-examples, react-blocks),
spec tests 7072/7072. check:i18n fails identically on an untouched
checkout (extract tooling unavailable in this environment) — not
caused here; CI carries the real gate.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BEM82RNKyyyTNPYHK1VJJS
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectstackIgnoredIgnoredJul 30, 2026 12:54pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation tests tooling size/l labels Jul 30, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 1 package(s): @objectstack/spec.

106 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/ai/agents.mdx(via @objectstack/spec)
  • content/docs/ai/skills-reference.mdx(via @objectstack/spec)
  • content/docs/ai/skills.mdx(via @objectstack/spec)
  • content/docs/api/client-sdk.mdx(via @objectstack/spec)
  • content/docs/api/environment-routing.mdx(via @objectstack/spec)
  • content/docs/api/error-catalog.mdx(via @objectstack/spec)
  • content/docs/api/error-handling-client.mdx(via @objectstack/spec)
  • content/docs/api/error-handling-server.mdx(via @objectstack/spec)
  • content/docs/api/index.mdx(via @objectstack/spec)
  • content/docs/automation/approvals.mdx(via packages/spec)
  • content/docs/automation/flows.mdx(via @objectstack/spec)
  • content/docs/automation/hook-bodies.mdx(via packages/spec)
  • content/docs/automation/hooks.mdx(via @objectstack/spec)
  • content/docs/automation/index.mdx(via @objectstack/spec)
  • content/docs/automation/webhooks.mdx(via @objectstack/spec)
  • content/docs/automation/workflows.mdx(via @objectstack/spec)
  • content/docs/concepts/architecture.mdx(via @objectstack/spec)
  • content/docs/concepts/design-principles.mdx(via packages/spec)
  • content/docs/concepts/index.mdx(via @objectstack/spec)
  • content/docs/concepts/metadata-driven.mdx(via @objectstack/spec)
  • content/docs/concepts/metadata-lifecycle.mdx(via packages/spec)
  • content/docs/concepts/north-star.mdx(via packages/spec)
  • content/docs/data-modeling/analytics.mdx(via @objectstack/spec)
  • content/docs/data-modeling/drivers.mdx(via @objectstack/spec)
  • content/docs/data-modeling/external-datasources.mdx(via @objectstack/spec)
  • content/docs/data-modeling/field-types.mdx(via @objectstack/spec)
  • content/docs/data-modeling/fields.mdx(via @objectstack/spec)
  • content/docs/data-modeling/formulas.mdx(via @objectstack/spec)
  • content/docs/data-modeling/index.mdx(via @objectstack/spec)
  • content/docs/data-modeling/objects.mdx(via @objectstack/spec)
  • content/docs/data-modeling/queries.mdx(via @objectstack/spec)
  • content/docs/data-modeling/schema-design.mdx(via @objectstack/spec)
  • content/docs/data-modeling/seed-data.mdx(via @objectstack/spec)
  • content/docs/data-modeling/validation-rules.mdx(via @objectstack/spec)
  • content/docs/data-modeling/validation.mdx(via @objectstack/spec)
  • content/docs/deployment/cli.mdx(via @objectstack/spec)
  • content/docs/deployment/troubleshooting.mdx(via @objectstack/spec)
  • content/docs/deployment/validating-metadata.mdx(via @objectstack/spec)
  • content/docs/getting-started/build-with-claude-code.mdx(via @objectstack/spec)
  • content/docs/getting-started/common-patterns.mdx(via @objectstack/spec)
  • content/docs/getting-started/examples.mdx(via @objectstack/spec)
  • content/docs/getting-started/quick-reference.mdx(via @objectstack/spec)
  • content/docs/getting-started/quick-start.mdx(via @objectstack/spec)
  • content/docs/getting-started/your-first-project.mdx(via @objectstack/spec)
  • content/docs/kernel/cluster.mdx(via @objectstack/spec)
  • content/docs/kernel/contracts/auth-service.mdx(via packages/spec)
  • content/docs/kernel/contracts/cache-service.mdx(via packages/spec)
  • content/docs/kernel/contracts/data-engine.mdx(via @objectstack/spec)
  • content/docs/kernel/contracts/index.mdx(via @objectstack/spec)
  • content/docs/kernel/contracts/metadata-service.mdx(via packages/spec)
  • content/docs/kernel/contracts/storage-service.mdx(via packages/spec)
  • content/docs/kernel/index.mdx(via packages/spec)
  • content/docs/kernel/runtime-services/email-service.mdx(via packages/spec)
  • content/docs/kernel/runtime-services/index.mdx(via packages/spec)
  • content/docs/kernel/runtime-services/queue-service.mdx(via packages/spec)
  • content/docs/kernel/runtime-services/sharing-service.mdx(via packages/spec)
  • content/docs/kernel/runtime-services/sms-service.mdx(via packages/spec)
  • content/docs/kernel/runtime-services/storage-service.mdx(via packages/spec)
  • content/docs/kernel/services-checklist.mdx(via @objectstack/spec)
  • content/docs/kernel/services.mdx(via @objectstack/spec)
  • content/docs/permissions/authorization.mdx(via @objectstack/spec)
  • content/docs/permissions/permission-sets.mdx(via @objectstack/spec)
  • content/docs/permissions/permissions-matrix.mdx(via @objectstack/spec)
  • content/docs/permissions/positions.mdx(via @objectstack/spec)
  • content/docs/permissions/rls.mdx(via @objectstack/spec)
  • content/docs/permissions/sharing-rules.mdx(via @objectstack/spec)
  • content/docs/plugins/adding-a-metadata-type.mdx(via @objectstack/spec)
  • content/docs/plugins/development.mdx(via @objectstack/spec)
  • content/docs/plugins/index.mdx(via @objectstack/spec)
  • content/docs/plugins/packages.mdx(via @objectstack/spec)
  • content/docs/protocol/backward-compatibility.mdx(via @objectstack/spec)
  • content/docs/protocol/diagram.mdx(via packages/spec)
  • content/docs/protocol/kernel/config-resolution.mdx(via @objectstack/spec)
  • content/docs/protocol/kernel/i18n-standard.mdx(via @objectstack/spec)
  • content/docs/protocol/kernel/index.mdx(via @objectstack/spec)
  • content/docs/protocol/kernel/lifecycle.mdx(via @objectstack/spec)
  • content/docs/protocol/kernel/plugin-spec.mdx(via @objectstack/spec)
  • content/docs/protocol/kernel/runtime-capabilities.mdx(via @objectstack/spec)
  • content/docs/protocol/knowledge.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/index.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/query-syntax.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/schema.mdx(via @objectstack/spec)
  • content/docs/protocol/objectql/security.mdx(via packages/spec)
  • content/docs/protocol/objectql/state-machine.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/actions.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/concept.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/index.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/layout-dsl.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/record-alert.mdx(via @objectstack/spec)
  • content/docs/protocol/objectui/widget-contract.mdx(via @objectstack/spec)
  • content/docs/releases/implementation-status.mdx(via @objectstack/spec)
  • content/docs/releases/index.mdx(via @objectstack/spec)
  • content/docs/releases/v12.mdx(via @objectstack/spec)
  • content/docs/releases/v13.mdx(via @objectstack/spec)
  • content/docs/releases/v16.mdx(via @objectstack/spec)
  • content/docs/releases/v17.mdx(via @objectstack/spec)
  • content/docs/releases/v9.mdx(via @objectstack/spec)
  • content/docs/ui/actions.mdx(via @objectstack/spec)
  • content/docs/ui/create-vs-edit-form.mdx(via @objectstack/spec)
  • content/docs/ui/dashboards.mdx(via @objectstack/spec)
  • content/docs/ui/forms.mdx(via @objectstack/spec)
  • content/docs/ui/index.mdx(via @objectstack/spec)
  • content/docs/ui/public-data-collection.mdx(via @objectstack/spec)
  • content/docs/ui/setup-app.mdx(via @objectstack/spec)
  • content/docs/ui/translations.mdx(via @objectstack/spec)
  • content/docs/ui/views.mdx(via @objectstack/spec)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

@os-zhuang
os-zhuang marked this pull request as ready for review July 30, 2026 13:17
@os-zhuang
os-zhuang merged commit 217e2e6 into mainJul 30, 2026
18 checks passed
@os-zhuang
os-zhuang deleted the claude/plugin-dev-stub-slots-eval-hqjox1 branch July 30, 2026 13:17
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/lteststooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

spec 的 kernel/dev-plugin.zod.ts 声明了一套 plugin-dev 从未实现的 Dev Mode 协议 —— 零消费者,待 enforce-or-remove 评估

2 participants

@os-zhuang@claude