Skip to content

docs: reposition ObjectStack vs ObjectOS + retire 'ObjectOS' as the control-layer name - #2955

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

docs: reposition ObjectStack vs ObjectOS + retire 'ObjectOS' as the control-layer name#2955
os-zhuang merged 6 commits into
mainfrom
claude/objectstack-official-docker-boic56

Conversation

@os-zhuang

@os-zhuangos-zhuang commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

背景

品牌战略调整:ObjectStack 是面向开发商的开源品牌(协议 + 工具链 + 生产 runtime),ObjectOS 是面向最终用户组织的官方商业运行环境(Cloud & Enterprise,不再提供免费/社区版)。本 PR 把 framework 仓库的对外表述与此对齐,共三部分:定位改写、功能层商业提及清理、协议层命名退役。

变更内容

1. 定位改写(README / LICENSING)

  • README:顶部双行定位图(builders vs end users);os start / 官方镜像即可完整上生产;移除 4 处社区版 objectos 仓库链接,改链 docs.objectos.ai;权限审计执行主体纠正为 runtime。
  • LICENSING.md:本仓库含构建/运行/自托管全部能力,Apache-2.0,无 dev/prod 功能门;ObjectOS 各版本为商业产品。
  • 品牌统一:ObjectStack CloudObjectOS Cloud(current 页面;历史 release notes 不动)。

2. 功能层商业提及清理(纪律:产品层保留边界声明,功能层零商业细节)

  • Turso/libsql 改为「不支持」;OS_CLUSTER_DRIVER 的「redis 属 EE」说法本身过时(@objectstack/service-cluster-redis 是本仓库开源包),已纠正;
  • AI 文档区系统性清理(9 个文件):删除私有 cloud 仓库 ADR 链接(公众 404)、@objectstack/service-ai 包名/构造函数/闭源文件名;边界陈述保留(schema 开源、产品内 chat runtime 属 ObjectOS、开源路径 @objectstack/mcp BYO-AI)。

3. 协议层命名退役:ObjectOS 层 → Kernel

ObjectOS 既是商业产品名又是开源控制层名,是永久性语义冲突。退役后格局:ObjectQL(数据,保留——真实开源查询语言)/ Kernel(控制,新名)/ ObjectUI(视图,保留——独立开源仓库);Object* 前缀只留给真实产品/技术。

  • README(删除消歧注——冲突消失后不再需要)、ARCHITECTURE、concepts/architecture、protocol 索引卡、protocol/diagram、glossary(含正式迁移说明)、implementation-status 等 ~15 个文件;
  • protocol/objectos/ 落地页改题为 "Kernel: The System Protocol",行为叙述页主语改为 ObjectStack;目录/URL 迁移到 protocol/kernel/ 留待后续(需配重定向);
  • skills 与 spec prompts 同步。

验证

  • 全量 grep:手写文档中 ObjectOS 仅剩产品用法(Cloud/Enterprise/产品边界)与 glossary 迁移说明;cloud / Enterpriseservice-ai、私有 ADR 链接、ObjectStack Cloud 清零(references/ 自动生成目录与历史 release notes 除外)。
  • ASCII 架构图对齐已手工校正(architecture.mdx、protocol/objectos/index.mdx、knowledge.mdx)。
  • 纯文档/文案改动,无包代码变更,不含 changeset。

后续(不在本 PR)

  • 重新生成 docs/screenshots/layers.png(alt 文本已更新,截图本体仍写 ObjectOS 层);
  • packages/spec 源码 TSDoc/字符串中 ~43 处 ObjectOS(供给自动生成的 references/ 文档),需连带重新生成;
  • content/docs/protocol/objectos/protocol/kernel/ 目录迁移 + 重定向;
  • 配套 PR:cloud#834、objectui#2510。

备注

🤖 Generated with Claude Code

https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG

…ectOS (commercial runtime environment)
- README: ObjectStack ships its own production runtime (os start / the
official Docker image ghcr.io/objectstack-ai/objectstack) — building,
running, and self-hosting your own apps is fully open source. ObjectOS
is the separate commercial runtime environment for end-user
organizations (Cloud & Enterprise). Drop links to the community
objectos repo; disambiguate the ObjectOS protocol layer from the
ObjectOS product.
- LICENSING: spell out that the production runtime and Docker image
definition are Apache-2.0 with no dev/prod feature gate; ObjectOS
editions are commercial and live outside this repo.
- docs: unify the hosted-product brand 'ObjectStack Cloud' → 'ObjectOS
Cloud' on current pages (historical release notes left untouched).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
@vercel

vercelBot commented Jul 15, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJul 15, 2026 9:45am

Request Review

Product-level boundary statements (README/LICENSING) stay; feature-level
docs now state open-source behavior only, without advertising what the
commercial distribution contains:
- drivers/environment-variables: 'libsql:// (Turso) is not supported' —
drop the commercial-distribution packaging details.
- environment-variables OS_CLUSTER_DRIVER: the claim that non-memory
cluster drivers 'ship in the EE distribution' was also outdated —
@objectstack/service-cluster-redis is an open, npm-published sibling
package in this repo (kernel/cluster Phase 3 ✅). Point to it instead.
- implementation-status: drop the internal cloud ADR citation; keep the
open-boundary explanation (schemas open, BYO-AI via @objectstack/mcp).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
…roduct boundary
Same rule as the previous commit, applied to the AI docs area where the
pattern was systemic (agents, index, actions-as-tools, knowledge-rag,
natural-language-queries, protocol/knowledge, environment-variables):
- Brand: 'cloud / Enterprise tier/distribution/runtime' → ObjectOS.
- Drop links/citations to the private cloud repo's ADR-0025 (404 for the
public) and @objectstack/service-ai packaging internals, including the
AIServicePlugin constructor walkthrough — commercial runtime config now
points to the ObjectOS docs instead.
- Boundary statements themselves stay: schemas/authoring open, in-product
chat runtime ships in ObjectOS, open path is @objectstack/mcp (BYO-AI).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
Remaining 'Cloud / Enterprise' callouts and @objectstack/service-ai
internals (approval-queue plugin config, chat-route internals, the
implementation-status AI matrix listing closed-source file names, the
knowledge-protocol diagram box) now state the ObjectOS product boundary
only, pointing to the ObjectOS docs for its configuration.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
…'Kernel'
ObjectOS now exclusively names the commercial runtime environment, so
using it as the open spec's control-layer brand was a permanent naming
collision (papered over by a disambiguation note until now).
- Layer naming: ObjectQL (data) / Kernel (control) / ObjectUI (view).
ObjectQL and ObjectUI stay — they name real open technologies; only
the layer-brand use of ObjectOS is retired.
- README: layer list + layers alt-text; drop the now-unneeded naming
note. ARCHITECTURE.md: layer diagram/table.
- concepts/architecture.mdx, protocol/index card, protocol/diagram,
glossary (with an explicit migration note), implementation-status,
permissions/automation/plugins/getting-started prose: layer actor
renamed to Kernel / ObjectStack runtime as fits.
- protocol/objectos/ pages: landing page retitled 'Kernel: The System
Protocol'; behavior narratives now use ObjectStack as the actor.
Directory/URL rename to protocol/kernel deferred (needs redirects).
- skills/objectstack-platform + spec prompts aligned.
Follow-ups (not in this PR): regenerate docs/screenshots/layers.png;
sweep the ~43 ObjectOS mentions in packages/spec source TSDoc/strings
(feeds the auto-generated references/ docs); move
content/docs/protocol/objectos/ → protocol/kernel/ with redirects.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
@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.

@os-zhuangos-zhuang changed the title docs: reposition ObjectStack (open-source framework + runtime) vs ObjectOS (commercial runtime environment)docs: reposition ObjectStack vs ObjectOS + retire 'ObjectOS' as the control-layer nameJul 15, 2026
packages/spec publishes prompts/ in the npm package, so the layer-naming
alignment there is a published-content change.
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 11:54
@os-zhuang
os-zhuang merged commit c5e68b2 into mainJul 15, 2026
17 checks passed
@os-zhuang
os-zhuang deleted the claude/objectstack-official-docker-boic56 branch July 15, 2026 11:54
os-zhuang added a commit that referenced this pull request Jul 15, 2026
…me retirement) (#2960)
* docs: migrate protocol/objectos → protocol/kernel (URL-level layer-name retirement)
Completes the ObjectOS layer-name retirement (#2955) at the URL level:
- content/docs/protocol/objectos/ → content/docs/protocol/kernel/
(11 pages, git mv — history preserved)
- permanent redirect /docs/protocol/objectos/:path* → /docs/protocol/kernel/:path*
added to the redirects table (folder-moves section)
- all in-content links rewritten (protocol index/cards, objectui index,
automation, api, kernel, concepts/architecture, plugins, package READMEs);
historical audit docs left as-is — the redirect covers them
- protocol/meta.json: objectos → kernel
Verified: turbo build --filter=@objectstack/docs green (4m08s); zero
remaining protocol/objectos references outside the redirects table.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
* chore: rebase role-word baseline for protocol/objectos → protocol/kernel move
The guard keys its baseline by path; git mv made the 3 baselined
occurrences show up as 'new' under kernel/ and 'gone' under objectos/.
Occurrence counts are unchanged (6 total).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
---------
Co-authored-by: Claude <noreply@anthropic.com>
os-zhuang added a commit that referenced this pull request Jul 15, 2026
…rnel naming (#2963)
* refactor(spec): retire 'ObjectOS' from the spec's public surface — Kernel 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
* fix(spec): keep ObjectOSKernel as an interface extension; commit api-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
---------
Co-authored-by: Claude <noreply@anthropic.com>
os-zhuang added a commit that referenced this pull request Jul 15, 2026
…ectOS' (#2966)
- layers.svg: middle box title ObjectOS → Kernel; heading 'three
protocol layers' → 'three layers' (matches the merged README wording).
- layers.png: re-rendered from the SVG at the original 1760x821 via
headless Chromium (Playwright, viewport 1200x560 @ 1.4667x device
scale). Font rendering uses the Linux fallback of the SVG's system
font stack; layout and colors are unchanged.
Closes the last visual 'ObjectOS layer' remnant from #2955.
Claude-Session: https://claude.ai/code/session_0162o68e5w3bpUBEVRQboUGG
Co-authored-by: Claude <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/ltooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-zhuang@claude