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-zhuang os-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

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 9:45am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/s labels Jul 15, 2026
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
@github-actions github-actions Bot added size/m and removed size/s labels Jul 15, 2026
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-zhuang os-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 name Jul 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 main Jul 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 free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/l tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants