Skip to content

Commit 4894cfe

Browse files
docs(adr): ADR-0143 Provenance names cloud ADR-0115 as the commercial half (#31406)
<!-- claude-projects-attribution: {"github_login":"os-zhuang"} --> _Requested by **Sam** · [project thread](https://claude.ai/code/project/chan_01GsBogozeZG5sdpAARrN7HP?thread=cmsg_01GsBogozeZG5sdpAARrN7HP9bMUWfrb52HdZRM5bfopCT)_ Closes #28262 Clause-②: no Metadata-protocol: none ## 维护者速读 - **改了什么**:框架 ADR-0143 的 Provenance 一节追加一条 2026-11-08 的修订说明,写明「商业那一半」就是 cloud ADR-0115(cloud#3354 合并,提交 `d4c97b39`);文件末尾实施切片表下面再追加一句,说明最后一行(欠的那份 cloud 记录)已完成。只追加 19 行,原文一字不改。 - **为什么改**:ADR-0143 原文说商业边界「欠一份 cloud 记录,在它存在之前以维护者裁决为准」。这份记录 10-30 已经合并,框架这一侧的指针一直没补;#26768 只剩这一步。 - **风险与回滚**:纯文档,不动代码、不发布任何包。回滚即 revert 这一个提交。 - **先看**:`docs/adr/0143-outbound-connector-auth-is-open-tier.md` Provenance 下新增的引用块,重点是第二条「The record of decision」(从此商业边界以 cloud ADR-0115 为准);再看文件最后一段。 - **两分钟验证**:`git diff origin/main...HEAD --stat` 只显示这一个文件 `+19 / -0`;`pnpm check:adr-links && pnpm check:adr-symbol-anchors` 两个都通过。 - **需要你做的**:在 GitHub 上批准本 PR(`docs/adr/**` 是 Tier H 受治理面,批准前保持 draft)。 ## What changes `docs/adr/0143-outbound-connector-auth-is-open-tier.md` only, two dated amendment notes, append-only (`+19 / -0`; no existing line changes, the decision body is untouched): 1. **Provenance.** A blockquote after the paragraph that calls the commercial half "owed as a cloud-repository record". It names `cloud ADR-0115` (with a link to the file on cloud `main`), objectstack-ai/cloud#3354 and cloud commit `d4c97b39`, says in two sentences what that record decides, and says the sentence beginning "Until it exists" records the state before the 2026-10-30 merge: the commercial decision of record is now cloud ADR-0115, and the existing warning (the cloud record decides the commercial boundary) applies to it. 2. **Implementation slices.** A note under the table: the last row's record (the cloud-repository record, carried by #26702 item 1 and #26768 item 3) exists, and the slice is done. No ADR index change: the title did not move, and `check:adr-index` is green. ## Tests n/a: docs-only diff, no package touched, so no build closure, unit test or typecheck is owed. The one build was a gate prerequisite (`@objectstack/formula` and `@objectstack/lint` for `check:doc-formula-expressions`). ## Acceptance notes - **Premise, re-read on current trees.** objectstack `main` at `77a675db`: the Provenance section now runs from the heading to the warning paragraph, with the "Until it exists" sentence at the end of its second paragraph (the card's `:35-50` still holds); the owed-record row is the file's last line, 553, not 440 (later amendments moved it). cloud `main` at `88fcf157`: `docs/adr/0115-outbound-connector-auth-open-tier-commercial-boundary.md` exists, and `d4c97b394fea` (cloud#3354, merged by the maintainer 2026-10-30T01:20Z) is an ancestor of cloud `main` (`merge-base --is-ancestor` exit 0) and the only commit on `main` touching that file. Its header says "Commercial half of: framework ADR-0143", and its Provenance points back here and to #26768 item 3. Premise holds. - **How the row's status was updated.** The card asks to update the owed-record row "the same way". A blockquote cannot sit inside a table row, and editing the row would change an existing line, so the row is unchanged and a dated note directly under the table names it. If the maintainer prefers the row's cell edited instead, that is a one-line change. - **cloud ADR-0115's own status line reads `Proposed (2026-10-28)`** although the maintainer merged it; cloud ADR-0112, -0113 and -0114 read Proposed on cloud `main` too, so it looks like that repository's convention. The note states the status as read and rests "now the commercial decision of record" on ADR-0143's own rule (the record exists, and the cloud record decides the commercial boundary). Not touched here. carrier: cloud · noted, not filed. - **No line anchors.** The notes cite no `path:line` (`check:adr-symbol-anchors` refuses them in `docs/adr/**`); the line numbers above are readings for this PR only. - **#26768** waits on #28262 (its newest state comment carries `Blocked-by: #28262`); its bookkeeping is the seat's after this lands. - No changeset: `docs/adr/**` publishes nothing, so `skip-changeset` rides the create. ## Verification <details> <summary>dispatch-gates on 03c7cd6: 21 derived, 21 run, all exit 0</summary> `node scripts/pm/dispatch-gates.mjs --commands --repo objectstack-ai/objectstack` (no paths): 1 path, 19 changed lines, 21 commands. Each exit code captured before any pipe: ``` node scripts/check-adr-links.mjs :: exit 0 node scripts/check-adr-links.mjs --self-test :: exit 0 node scripts/check-closing-keyword-parity.mjs :: exit 0 node scripts/check-closing-keyword-parity.mjs --self-test :: exit 0 node scripts/check-comment-mask-corpus.mjs :: exit 0 node scripts/ci/plan-test-core-shards.mjs --self-test :: exit 0 pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0 pnpm check:adr-anchors :: exit 0 pnpm check:adr-index :: exit 0 pnpm check:adr-symbol-anchors :: exit 0 pnpm check:ci-filter-parity :: exit 0 pnpm check:closed-ceremony-text :: exit 0 pnpm check:cross-package-test-inputs :: exit 0 pnpm check:doc-authoring :: exit 0 pnpm check:driver-memory-census :: exit 0 pnpm check:gitlink-declared :: exit 0 pnpm check:nul-bytes :: exit 0 pnpm check:pm-governed-merges :: exit 0 pnpm check:pm-prior-rulings :: exit 0 pnpm check:refd-timer-probe :: exit 0 pnpm check:watch-hint-literal :: exit 0 ``` First pass: `check:doc-formula-expressions` exit 3 (prerequisite: unbuilt `@objectstack/formula`); after `os-verify-lock.sh -c 'pnpm exec turbo run build --filter=@objectstack/formula --filter=@objectstack/lint --concurrency=2'` (VERDICT command-exit 0, 5/5 tasks) it is exit 0. `dispatch-gates --ran`: "21 derived famil(ies) accounted for — 21 run, 0 NOT-MEASURED". </details> --- _Generated by [Claude Code](https://claude.ai/code/session_01QUs3Buj8styLTkDj7joVDa)_ Co-authored-by: Claude <noreply@anthropic.com>
1 parent d02c99e commit 4894cfe

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

‎docs/adr/0143-outbound-connector-auth-is-open-tier.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,21 @@ cloud-repository record with a `## Provenance` pointer back to this number. That
4848
filed by the PR that lands this file**; the cloud repository is outside its reach. Until it exists,
4949
the maintainer's ruling quoted above is the commercial decision of record.
5050

51+
> **Amended (2026-11-08, #28262) — the commercial half is cloud ADR-0115.** The cloud-repository record
52+
> the paragraph above calls owed exists: `cloud ADR-0115`,
53+
> [`docs/adr/0115-outbound-connector-auth-open-tier-commercial-boundary.md`](https://github.com/objectstack-ai/cloud/blob/main/docs/adr/0115-outbound-connector-auth-open-tier-commercial-boundary.md)
54+
> in `objectstack-ai/cloud`. The maintainer merged it on 2026-10-30 through objectstack-ai/cloud#3354, as
55+
> cloud commit `d4c97b39`. Its header names it the commercial half of this record, and its
56+
> `## Provenance` points back here and to #26768 item 3. Its own status line reads Proposed (2026-10-28).
57+
>
58+
> - **What it decides.** Open tier, with no paid gate set by cloud: the in-environment connector
59+
> credential object, outbound OAuth with its refresh and connection record, the app-credential exchange
60+
> and request signing. Commercial, as "may be charged, no delivery promised": vault / KMS backends,
61+
> BYOK, key rotation, credential access-audit export and premium hand-built connectors.
62+
> - **The record of decision.** The sentence above that begins "Until it exists" records the state before
63+
> that merge. The commercial decision of record is now cloud ADR-0115, and the warning below applies to
64+
> it. Nothing this file decides changes.
65+
5166
⚠️ Where a cloud record and this document disagree about the *commercial* boundary, the cloud record
5267
decides. What this document decides, and cloud does not, is where the **code** lives and what its
5368
contract is.
@@ -551,3 +566,7 @@ Each slice is its own card and lands after this record is accepted.
551566
| providers: MCP authorization flow, OpenAPI `securitySchemes`, REST; the `RequestSigner` seam and first signers | `domain:server` | #26702 item 6, #26710 items 3–4 |
552567
| Console Connect / Reconnect and connection status | `domain:ui` | #26702 item 7 |
553568
| the cloud-repository record ([Provenance](#provenance--read-this-before-citing-this-file)) | the commercial repository | #26702 item 1, #26768 item 3 |
569+
570+
> **Amended (2026-11-08, #28262).** The last row's record exists: cloud ADR-0115, merged on 2026-10-30
571+
> through objectstack-ai/cloud#3354 as cloud commit `d4c97b39`. That slice is done; see the 2026-11-08
572+
> note under [Provenance](#provenance--read-this-before-citing-this-file).

0 commit comments

Comments
 (0)