Skip to content

Commit 0a594eb

Browse files
committed
docs(adr): ADR-0145 rework — step 2 reads a pre-merge ui tombstone's R on the group's clock; regenerate the ADR index
Applying-the-rule step 2 gains one clause: the objectui clone yields the introducing commit and its date, and R is read per D2 (the first @objectstack/spec release cut at or after that date, a .0.0 cut counting in the major before it), never the @object-ui/types tag the clone's `git tag --contains` names; D2's parenthesis now spells the same reading. docs/adr/README.md is regenerated with scripts/adr-index.mjs: the 0145 row reads Accepted, and the 0035 row catches up with its amendment. Claude-Session: https://claude.ai/code/session_01QSeKYmhU5KEj1nukYhp1Tg Co-authored-by: Claude <noreply@anthropic.com>
1 parent 2d14a9c commit 0a594eb

2 files changed

Lines changed: 14 additions & 10 deletions

File tree

‎docs/adr/0145-ui-deprecation-tombstones-retire-on-the-spec-window.md‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -86,9 +86,10 @@ Spelled on ADR-0087's clock, with **R** the protocol major the retirement belong
8686
application batch takes it.
8787
- **The tombstone names a ui-only retirement** (an objectui or ui card, no spec key behind it): the same window runs
8888
from the ui's own retirement, on the fixed group's clock (D1): R is read off the first `@objectstack/spec` release tag
89-
whose tree carries the tombstone's introducing commit (for a commit the ui merge did not import, the first cut after
90-
its date — step 2), on the convention the bullets above use: first carried by a major's `.0.0` cut counts in the major
91-
before it. ⛔ Never off `@object-ui/types`' own tags: a major's first tag there need not be a `.0.0` cut.
89+
whose tree carries the tombstone's introducing commit (for a commit the ui merge did not import, the first
90+
`@objectstack/spec` release cut at or after its date — step 2), on the convention the bullets above use: first carried
91+
by a major's `.0.0` cut counts in the major before it. ⛔ Never off `@object-ui/types`' own tags: a major's first tag
92+
there need not be a `.0.0` cut.
9293
> **Amended 2026-10-28 (#27291) — the ui-only clock reads the group's tags.** Was: "R is the major of the first
9394
> `@object-ui/types` release tag (or the first release of the package that publishes the `.d.ts`) whose tree carries
9495
> the tombstone, on the same convention: first carried by a major's `.0.0` cut counts in the major before it."
@@ -150,9 +151,12 @@ what it could not date. ⛔ No count is written here: the population moves, and
150151
2. **Date.** Per member, find the commit that introduced the tombstone with `git log -S'<the member line>' --reverse`
151152
on a **full** clone, then the first release tag that contains it (`git tag --contains`). The ui tree's history before
152153
the ui merge was not imported into this repository: a tombstone older than the merge is dated on a full clone of
153-
`objectstack-ai/objectui`, whose `@object-ui/types@*` tags carry that era. On a shallow clone the reading is refused,
154-
⛔ never read as "no history" (`git rev-parse --is-shallow-repository`, with a control leg of known age). For a
155-
tombstone that names a spec retirement, read R from the spec (D2), not from the ui commit.
154+
`objectstack-ai/objectui`, whose `@object-ui/types@*` tags carry that era — that clone gives the introducing commit
155+
and its date, and R is then read on the group's clock (D2): the first `@objectstack/spec` release cut at or after
156+
that date, a `.0.0` cut counting in the major before it, ⛔ never the `@object-ui/types` tag the clone's
157+
`git tag --contains` names. On a shallow clone the reading is refused, ⛔ never read as "no history"
158+
(`git rev-parse --is-shallow-repository`, with a control leg of known age). For a tombstone that names a spec
159+
retirement, read R from the spec (D2), not from the ui commit.
156160
3. **Judge.** Due ⇔ the current major (D1) ≥ R + 2 and D3 does not hold the key. Report three lists — due, held by
157161
D3 (with the container), undated — and remove only the first.
158162
4. **Remove and re-pin.** Delete the member, its JSDoc and its zod twin together (D3); move any test that pins

‎docs/adr/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@
1717

1818
| Status | Records |
1919
|---|---|
20-
| Accepted | 126 |
21-
| Proposed | 5 |
20+
| Accepted | 127 |
21+
| Proposed | 4 |
2222
| Superseded | 4 |
2323
| Draft | 3 |
2424
| Deferred | 2 |
@@ -105,7 +105,7 @@ A bare `ADR-0006` names the decision; its current text is [0006-project-environm
105105
| [ADR-0032](./0032-unified-expression-layer.md) | Expression layer for an AI-authored platform — validate-by-default, schema-aware, one CEL language, no silent… | Accepted — implemented; designer builders pending (objectui) (proposed 202… | 2026-06-02 | — | — |
106106
| [ADR-0033](./0033-ai-assisted-metadata-authoring.md) | AI-assisted metadata authoring — one agent brain, draft-gated review, type-agnostic apply, open-core boundary | Accepted — 2026-06-02 | 2026-06-02 | — | cloud ADR-0025 |
107107
| [ADR-0034](./0034-transactional-writes-and-ambient-transaction.md) | Robust multi-write transactions (ambient transaction context) | Accepted — implemented (v8.0.0) (calibrated 2026-06-12) | 2026-06-12 | — | — |
108-
| [ADR-0035](./0035-config-driven-master-detail.md) | Config-driven master-detail (declare on the relationship, forms derive) | Accepted | — | — | — |
108+
| [ADR-0035](./0035-config-driven-master-detail.md) | Config-driven master-detail (declare on the relationship, forms derive) | Accepted — · Amended (2026-10-28, #27069, maintainer rulings on that card:… | 2026-10-28 | — | — |
109109
| [ADR-0036](./0036-app-as-rest-api-and-mcp-server.md) | Every app is a REST API + an MCP server — make it visible and connectable after build | Accepted — framework implemented; cloud surfacing pending (proposed 2026-0… | 2026-06-06 | — | — |
110110
| [ADR-0037](./0037-live-canvas-draft-preview.md) | Live Canvas — draft-overlay live preview while you build | Accepted — 2026-06-10 — all four phases implemented: `previewDrafts` reads… | 2026-06-10 | — | — |
111111
| [ADR-0038](./0038-build-verification-loop.md) | Build Verification Loop — the agent builds, verifies, and corrects itself | Accepted — 2026-10-28 (ruled on objectstack#26553, ADR batch 2; proposed 2… | 2026-10-28 | — | cloud ADR-0025 |
@@ -211,7 +211,7 @@ A bare `ADR-0006` names the decision; its current text is [0006-project-environm
211211
| [ADR-0141](./0141-inter-app-dependency-declared-checked-before-install.md) | An app may depend on another installed app — declared in `manifest.dependencies`, checked once before install… | Proposed — 2026-10-25; first draft 2026-10-24. `docs/adr/` is Tier H (Prim… | 2026-10-25 | — | — |
212212
| [ADR-0142](./0142-ownership-queue-membership-claim-and-assignment-rules.md) | An ownership queue is a platform primitive — a queue entity, membership through the existing recipient kinds,… | Proposed — 2026-10-25 · Amended (2026-10-28, ruling `6457475657` on #25769… | 2026-10-25 | — | — |
213213
| [ADR-0143](./0143-outbound-connector-auth-is-open-tier.md) | Outbound connector auth is open tier — OAuth2 grants, vendor app-credential exchange and request signing in o… | Accepted — 2026-10-28. Proposed 2026-10-27 (#26833, which also landed the… | 2026-10-28 | — | — |
214-
| [ADR-0145](./0145-ui-deprecation-tombstones-retire-on-the-spec-window.md) | A `?: never` tombstone on the ui authoring face retires on the spec's own window — one major after the retire… | Proposed — 2026-10-28. `docs/adr/` is Tier H (Prime Directive #14): this r… | 2026-10-28 | — | — |
214+
| [ADR-0145](./0145-ui-deprecation-tombstones-retire-on-the-spec-window.md) | A `?: never` tombstone on the ui authoring face retires on the spec's own window — one major after the retire… | Accepted — 2026-10-28, #27251 · Amended (2026-10-28, #27291 — one clause e… | 2026-10-28 | — | — |
215215

216216
## ObjectUI registry — `ui/docs/adr/` (`ui-` prefix)
217217

0 commit comments

Comments
 (0)