Skip to content

docs(adr): ADR-0059 — third-party backward-compatibility validation gates (#2035)#2098

Merged
xuyushun441-sys merged 1 commit into
mainfrom
spec/validation-strategy-doc
Jun 21, 2026
Merged

docs(adr): ADR-0059 — third-party backward-compatibility validation gates (#2035)#2098
xuyushun441-sys merged 1 commit into
mainfrom
spec/validation-strategy-doc

Conversation

@xuyushun441-sys

Copy link
Copy Markdown
Contributor

Central, authoritative write-up of the third-party validation strategy built this cycle (#2088 / #2089 / #2092 / #2093 / #2095 / #2097) — recommendation #3 from the #2035 follow-up discussion.

What it documents

  • Why in-repo consumers can't witness backward compatibility — they (examples, @objectstack/dogfood, the platform apps) co-evolve with the spec in the same commit, so a break for a lagging third party (hotcrm) is invisible until release.
  • The six gates and each one's job — author-time factories + lint guard, load-time objectstack validate, the depth fixture, the breadth snapshot, and the pre-publish live-hotcrm smoke.
  • The freeze contract (§4) — a change that requires editing the fixtures, or removes a snapshot entry, is by definition a breaking change: bump major, don't edit-to-pass. This is what makes the witnesses real.
  • Formalizes objectstack validate as the third party's authoritative self-gate.

Follows the ADR-0054 house style (it's the direct neighbour — prove-it-runs for the authorable surface; this is the backward-compat dimension). ADR-only, no code, intra-links verified.

🤖 Generated with Claude Code

…ates (#2035)

Documents the layered strategy built across #2088/#2089/#2092/#2093/#2095/#2097
in one authoritative place: why in-repo consumers can't witness backward compat
(they co-evolve with the spec), the six gates and each one's job, and — crucially
— the FREEZE CONTRACT: a change that requires editing the fixtures or removing a
snapshot entry is by definition breaking (bump major), never a mechanical
test-update. Also formalizes `objectstack validate` as the third party's
authoritative self-gate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 21, 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 Jun 21, 2026 6:46am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/m and removed documentation Improvements or additions to documentation labels Jun 21, 2026
@xuyushun441-sys
xuyushun441-sys merged commit 4557a17 into main Jun 21, 2026
15 checks passed
@xuyushun441-sys
xuyushun441-sys deleted the spec/validation-strategy-doc branch June 21, 2026 06:49
os-zhuang added a commit that referenced this pull request Jun 29, 2026
fix(metadata-admin): drop policy client-validator (PolicySchema removed in spec 11.2.0) (#2098)

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants