Skip to content

refactor(spec): retire 'ObjectOS' from the spec's public surface — Kernel naming - #2963

Merged
os-zhuang merged 2 commits into
mainfrom
claude/objectstack-official-docker-boic56-spec-sweep
Jul 15, 2026
Merged

refactor(spec): retire 'ObjectOS' from the spec's public surface — Kernel naming#2963
os-zhuang merged 2 commits into
mainfrom
claude/objectstack-official-docker-boic56-spec-sweep

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

背景

#2955 在文档层退役了「ObjectOS」协议层命名;本 PR 完成 packages/spec 源码内的收尾(P1 技术债第 2/3 项,配套 #2960)。

变更内容

公开 API 改名(带废弃别名,保留一个发布周期,不破坏下游)

  • ObjectOSCapabilitiesSchemaKernelCapabilitiesSchema
  • ObjectOSCapabilities(type)→ KernelCapabilities
  • ObjectOSKernel(interface)→ IKernel(PluginContext.os 类型同步;I 前缀对齐 IMetadataService/IDataEngine 惯例)
  • 别名恒等性有回归测试;全 monorepo grep 确认 spec 之外零使用,风险面为零。

文案层(TSDoc/注释/describe 串)

  • 层主语统一为「the ObjectStack runtime」/「Kernel」(plugin 契约、constants、environment-artifact 等);
  • Cloud 域的产品用法刻意保留(ObjectOS CloudRegister → Instant ObjectOS、app-store)——那是产品事实,非层命名;
  • 测试夹具 discovery name: 'ObjectOS''ObjectStack'

references/ 重新生成

  • system/environment-artifact.mdx 属本次变更;
  • ⚠️ 重生成同时暴露出 7 个文件的既存漂移(ADR-0091 D3 delegatable、ADR-0095 D2 posture、security explain 链、data/ui import 列表、新增 security/misc)——刻意未纳入本 PR,该漂移属于当初改 spec 未重生成的提交,建议单独跑一次全量 gen:docs 提交(或由 docs-drift 流程认领)。

Changeset

  • @objectstack/spec: minor,含 FROM → TO 迁移说明(schema 形状与 JSON 输出零变化)。

验证

  • tsc --noEmit 干净;vitest stack.test + api/protocol.test 113/113 通过;
  • 别名恒等断言纳入测试;
  • 残留 grep:spec 内 ObjectOS 仅剩废弃别名 TSDoc 与 Cloud 域产品用法(CHANGELOG/审计报告历史记录不动)。

🤖 Generated with Claude Code

https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG


Generated by Claude Code

…rnel naming

Completes the layer-name retirement (#2955) inside packages/spec:

- Public API renames with deprecated aliases (kept one release):
  ObjectOSCapabilitiesSchema → KernelCapabilitiesSchema,
  ObjectOSCapabilities → KernelCapabilities,
  ObjectOSKernel → IKernel (PluginContext.os now typed IKernel).
  Alias identity is regression-tested.
- TSDoc/comments: layer-actor wording now 'the ObjectStack runtime' /
  'Kernel' (plugin contract, constants, environment-artifact). Product
  usages in the Cloud domain (ObjectOS Cloud, 'Register → Instant
  ObjectOS', app-store) are deliberately unchanged.
- Test fixtures: discovery-response name fixture 'ObjectOS' → 'ObjectStack'.
- references/: regenerated; only system/environment-artifact.mdx is from
  this change. The regen also surfaced 7 files of pre-existing drift
  (ADR-0091/0095 era) which are deliberately NOT included here — that
  drift belongs to the changes that caused it.
- Changeset: minor, with FROM → TO migration notes.

Verified: spec tsc --noEmit clean; vitest stack.test + api/protocol.test
113/113 green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
@vercel

vercel Bot commented Jul 15, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jul 15, 2026 2:04pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation protocol:system tests tooling size/m labels Jul 15, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

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

97 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/troubleshooting.mdx (via @objectstack/spec)
  • content/docs/getting-started/build-with-claude-code.mdx (via @objectstack/spec)
  • content/docs/getting-started/cli.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/validating-metadata.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/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/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/knowledge.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/config-resolution.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/i18n-standard.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/lifecycle.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/plugin-spec.mdx (via @objectstack/spec)
  • content/docs/protocol/objectos/runtime-capabilities.mdx (via @objectstack/spec)
  • content/docs/protocol/objectql/index.mdx (via packages/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/v9.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/setup-app.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.

…surface snapshot

The api-surface guard flagged interface→type as a removal (breaking).
ObjectOSKernel is now '/** @deprecated */ interface ObjectOSKernel
extends IKernel {}' — declaration merging and interface identity are
preserved, so the surface records additions only:
+ KernelCapabilitiesSchema (const), + KernelCapabilities (type),
+ IKernel (interface). check:api-surface green after a full dist build.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
@os-zhuang
os-zhuang marked this pull request as ready for review July 15, 2026 14:43
@os-zhuang
os-zhuang merged commit 6c114c0 into main Jul 15, 2026
17 checks passed
@os-zhuang
os-zhuang deleted the claude/objectstack-official-docker-boic56-spec-sweep branch July 15, 2026 14:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation protocol:system size/m tests tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants