Skip to content

docs(cloud): Cloud organization pages, hierarchy visibility, MCP on Cloud, AI Builder (#344) - #373

Merged
zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-52h6aa
Oct 28, 2026
Merged

zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-52h6aa

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Requested by Sam · project thread

Closes #344

维护者速读

新增侧栏分组 Cloud Organization(位于 Configure 与 Deploy 之间),共 8 页:组织与成员、环境、套餐与 AI seats、AI credits 与限额、存储与限额、域名、应用(含 Deploy from the CLI)、Cloud Connection。同时合入三处:configure/mcp.mdx 增加 "On ObjectOS Cloud" 一节,新增 configure/permissions/hierarchy-visibility.mdx,重写 build/ai-builder.mdx。editions/compare.mdx 的 n/d 单元格已全部填实。所有限额都引自 cloud 代码(main a32c80c)或 docs/design/pricing.md,并注明裁决 issue;cloud 的 content/docs/ 只作参考。用户页里没有内部成本、策略或运维变量(cloud AGENTS.md〈文档两分〉)。

需要维护者拍板的两点见下文 Open questions:一是 Free 的记录/字段级安全在代码里没有套餐门槛,但对比页写的是 "—";二是 Business 的 SSO 已声明但尚未实现。

What changed

Page Editions Source of facts
cloud/organization.mdx cloud service-tenant team/sys-organization pages; slug 4–30, 90-day rename window; roles owner/admin/delegated_admin/member/external
cloud/environments.mdx cloud sys-environment object + pricing.md §Environments; dev envs paid-only, 2 + 1 per AI seat, DEV_ENV_PLAN_LOCKED (cloud#1252); 7-day idle archive (dev only); retention 7/30/90/365, manual archive ≥ 30; downgrade not retroactive (cloud#2253); restore refused on Free (cloud#2204)
cloud/plans-and-seats.mdx cloud pricing.md §Seat classes; Team $24 / $20 annual per AI seat (cloud#3202); Business negotiated
cloud/ai-credits-and-limits.mdx cloud, enterprise one pool, rolling 7-day budget + rolling 5-hour pace (cloud#2059); credits lift the 7-day window only; 429 codes AI_DESIGN_QUOTA_EXHAUSTED / AI_ALLOWANCE_EXHAUSTED
cloud/storage-and-limits.mdx cloud 1 GB / 20 GB per environment, STORAGE_LIMIT_REACHED, 80% warning; MCP 20/min + 1,000/UTC day on Free, 120/min on paid (cloud#3203); drafts 500 and authoring writes 200/2,000 (cloud#3303)
cloud/domains.mdx cloud TXT _objectos-challenge.<host>, states Pending Verification → Verified → Provisioning Certificate → Active / Failed / Suspended; suspended on downgrade (cloud#1087, cloud#2136)
cloud/apps.mdx cloud install / check for updates / PERMISSION_RECONSENT_REQUIRED / publish to registry; Deploy from the CLI (os cloud login → os build → os package publish → install, all-or-nothing --install)
cloud/cloud-connection.mdx community, cloud, enterprise one-time code approval, Connected Runtimes Rename / Revoke / Remove; links objectstack.ai's server-side page
configure/mcp.mdx (unchanged) new "On ObjectOS Cloud" section: off by default per environment (cloud#1248), turn on/off, connect, limits, troubleshooting
configure/permissions/hierarchy-visibility.mdx cloud, enterprise unit / unit_and_below / own_and_reports, position-first anchoring, cross-organization manager refusal
build/ai-builder.mdx (unchanged) rewritten: Builder (build) vs Assistant (ask), manage_metadata / studio.access gate, plan → approve → drafts → verify → publish, tool tables, pending actions (owner-only, cloud#2587), /api/v1/ai/agents/ask/chat
editions/compare.mdx — n/d cells filled; storage per environment; dev environment counts; Team MCP number; legend removed
start/cloud.mdx — links into the new pages

Locale: English only. build/ai-builder.zh-Hans.mdx and its generated zh-Hant sibling are removed because the rewrite reverses capability claims; the other changed pages keep their stale siblings.

Verification

Gate Result
gen-zh-hant --check (after rebase on cb852c2) 96 files match
check-doc-samples 105 pass
type-check (frontmatter) 290 pages valid
turbo build pass (font-download warnings are network-only)
check-positioning / check-locale-surface / check-search-locales / check-translations / check-translation-ownership pass
turbo test pass
Playwright, 13 pages at 1440 and 390 px all 200, no horizontal scroll, no console errors; sidebar group renders between Configure and Deploy

Open questions

  1. Free and record/field-level security. editions/compare.mdx shows "—" for Free, but cloud code has no plan gate on RLS/FLS. Left unchanged here; a maintainer should rule whether the page or the code is right.
  2. Business SSO. The license page lists SSO for Business, but per pricing.md the only enforced Business differences are approvals and 90-day retention. SSO on Business is declared but not built.

Findings (not changed here)

  • docs/design/pricing.md §AI and the card still say "per-seat monthly + daily burst". The code uses a rolling 7-day budget and a rolling 5-hour pace (cloud#2059). The pages follow the code, so pricing.md has drifted.
  • Product copy uses sales@objectos.ai, but the site uses sales@objectstack.ai.
  • The Cloud sign-up URL is left to www.objectos.ai#215.
  • The MCP daily authoring-write count only starts biting after objectstack#26464 lands. The page states the limit, not when it took effect.
  • Team's 120/min comes from cloud#3203 and pricing.md. The console billing page omits the number because it can be tuned operationally.
  • Routing comment 6444185051 asks for the claim on objectstack#9831 (the docs seat hot-file queue) to be named before landing. Left for the seat to handle.

Landing unblocks cloud#3330 (delete cloud content/docs/).

🤖 Generated with Claude Code

https://claude.ai/code/session_01QUs3Bu7XzSYFj6zUysqDjS

…loud, AI Builder (#344)

Adds the Cloud Organization section: organization and members,
environments, plans and AI seats, AI credits and limits, storage and
limits, domains, apps (with Deploy from the CLI), and cloud connection.
Folds in the configure/mcp Cloud half, a new hierarchy-visibility page,
and a rewritten AI Builder page (two agents, plan-approve-draft-publish,
tool tables, pending actions). Fills the n/d cells on editions/compare.

Every limit is quoted from cloud code at a32c80c or docs/design/pricing.md
with its ruling issue. The AI Builder rewrite reverses capability claims,
so its zh-Hans and zh-Hant siblings are removed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QUs3Bu7XzSYFj6zUysqDjS
@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

Seat review · repo:cloud#2 (objectstack-ai/objectstack#24145) · 2026-10-28T01:04Z · ACCEPT at 04a0d4f

CI is green: build, Node floor, Ownership & freshness.

Spot-read against cloud main a32c80c:

  • cloud/ai-credits-and-limits.mdx states the two rolling windows (7 days, 5 hours) that cloud#2059 ruled, with the 429 codes and the refusal copy. It does not use the stale 「monthly + daily burst」 wording still in cloud docs/design/pricing.md; that drift is the cloud seat's to fix, not this PR's.
  • Allowance sizes are not published (Public Preview).
  • The MCP-on-own-model note matches cloud#3203.
  • editions: is present on every new page.

The dev's two open questions stay with the maintainer and do not block landing, because the pages as written state what the code does:

  • compare.mdx shows Free 「—」 for RLS/FLS while cloud code has no plan gate.
  • Business SSO is declared but not built.

Landing: requested from the repo:docs.objectos.ai#1 seat's hot-file queue on objectstack-ai/objectstack#9831. When it lands it unblocks cloud#3330.


Generated by Claude Code

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

Seat record · landing · 2026-10-28T08:25Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

This landing answers repo:cloud#2's request on objectstack#9831 (2026-10-28T01:05Z). The content review is that seat's ACCEPT, comment 6457870008, at head 04a0d4f. This seat checked only the docs-side surface:

  • Merge. Base cb852c2. git merge-tree against today's main (020075b) is clean, and mergeable_state is clean. Check-runs at 04a0d4f: build success · Node floor success · Ownership & freshness success. The merge group re-runs them on today's main.
  • Locale siblings (AGENTS.md rule 3). build/ai-builder is rewritten, and its zh-Hans and zh-Hant siblings are deleted in this PR, which is correct for a page whose claims change. editions/compare fills the n/d cells and adds "per environment", configure/mcp adds a section, and start/cloud re-points two links. None of the three reverses a claim, so their siblings stay and will show as stale. Refreshing them is a follow-up translation card. They do not block this PR.
  • Hot files. The root meta.json, cloud/**, configure/permissions/meta.json. No PR in flight on this lane touches them.

Tier none. The PR goes through the merge queue on the maintainer's standing go-ahead (2026-10-27 22:29Z), serially: the lane has nothing else in flight.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

3 participants