Skip to content

docs(build): say the CI publish-and-install step is all-or-nothing - #382

Merged
zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-75x3by
Oct 29, 2026
Merged

zhuangjianguo merged 1 commit into
mainfrom
claude/project-thread-75x3by

Conversation

@zhuangjianguo

Copy link
Copy Markdown
Collaborator

Requested by Steedos · project thread
Fixes #377
Clause-②: no
Metadata-protocol: none

维护者速读

  • 改了什么:build/packages 的「CI shortcut」提示补一句:os package publish --env <id> --install 是全有或全无的,安装被拒时什么都不会发布,不留版本,命令以非零退出,流水线能看到失败。
  • 为什么改:cloud 仓删除 getting-started/deploy.mdx(cloud#3344)后,这一行为在用户文档里无处可查。
  • 风险与回滚:仅改一页英文文案,不动代码与译文;回滚即 revert 本 PR。
  • 先看:content/docs/build/packages.mdx 第 153–159 行。
  • 两分钟验证:打开 /docs/build/packages,Installing 一节的 CI shortcut 引用块末尾出现新句。
  • 需要你做的:无,席位落地。

What changes

File Change
content/docs/build/packages.mdx The "CI shortcut" note under ## Installing gains one sentence: "The step is all-or-nothing: if the install is refused, nothing is published — no version is stored and the command exits non-zero, so the pipeline sees the failure." Nothing else on the page changes.

The fact comes from the card: the publish-and-install route is all-or-nothing since cloud#2465, pinned by cloud packages/service-cloud/test/publish-install-all-or-nothing.test.ts. This account cannot read objectstack-ai/cloud, so the citation is the card's, not re-read here.

Tests

Content-only diff; no test files change. Local gates on 8c101ed: turbo run type-check, build and test green; check-translations passed; check-translation-output --files passed (85 pre-existing findings, none in this diff); check-translation-ownership 0 translation artifacts; gen-zh-hant --check clean; check-doc-samples, check-positioning, check-locale-surface and check-search-locales green. Rendered with next start at /docs/build/packages on desktop (1280) and mobile (390): the note reads as above.

Acceptance notes

  • Locale siblings untouched. An added sentence, not a reversed capability (AGENTS.md, Translation workflow step 3), so packages.zh-Hans.mdx and its generated zh-Hant twin go stale and the seat's translation routine refreshes them.

Generated by Claude Code

A refused install publishes nothing: no version is stored and the
command exits non-zero, so a pipeline sees the failure.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QsR2jQwak4m4H1Ta2cvPgZ
@zhuangjianguo zhuangjianguo self-assigned this Oct 29, 2026
@objectstack-fleet

Copy link
Copy Markdown
Contributor

席位核对 · ACCEPT · 2026-10-29T04:31Z · session_01QsR2jTaZ2GeyfjANMwstiw · seat repo:docs.objectos.ai#1

  1. Shape. Draft PR against main 1fccedb, head 8c101ed. One file, content/docs/build/packages.mdx, +3. The body says Fixes #377. Claim 6487920212, branch claude/project-thread-75x3by. The change stays within the claimed surface.
  2. Content. The "CI shortcut" note gains one sentence: the step is all-or-nothing, a refused install publishes nothing, no version is stored, and the command exits non-zero. This matches the card's facts (cloud#2465, pinned by publish-install-all-or-nothing.test.ts), and nothing else on the page changes.
  3. Locale siblings. This adds a sentence and reverses no claim, so build/packages.zh-Hans and zh-Hant stay and go stale. The seat's translation routine (Run the zh-Hans translation pass as a routine (on merge to main touching English pages, or weekly), stamped with --stamp, so coverage converges without a hand-run pass #379) refreshes them on its next run.
  4. Gates. Check-runs at 8c101ed: build success · Node floor success · Ownership & freshness success. The dev's local battery is green, and the page renders on desktop and mobile.
  5. Landing. Tier none. Through the merge queue under the maintainer's standing go-ahead, serially. This is the only card 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

2 participants