docs(adr): propose ADR-0018 Ploeg releases on its own schedule behind a tested contract version #183

Merged

ryangr0 merged 1 commit from ryangr0/adr-ploeg-independent-releases into development 2026-10-03 12:22:53 +00:00 AGit

Conversation 0 Commits 1 Files changed 3 +160

ryangr0 commented 2026-10-03 12:20:24 +00:00

Owner

Copy link

The owner allowed Ploeg to release independently on 2026-10-03 and asked
what happens with incompatibility. ADR-0018 proposes to supersede ADR-0004's
single version: Ploeg and Vloer get their own release trains, Ploeg's
operator API carries a MAJOR.MINOR contract version (a /version route and a
Ploeg-Contract header), and Vloer declares the range it supports. Outside
that range, Vloer shows a blocking banner and makes no managed calls.
Contract changes are expand and contract, with a proposed 60-day
deprecation window. A cross-version qualification of real Ploeg and real
Vloer gates releases. An unfold-v bundle pins a qualified pair, and the
joint draft barrier from #146 moves to that bundle. The ADR lists five
owner questions and eight follow-up tickets. No code changes.

Proposed, not accepted. Five owner questions are marked in the ADR (banner vs refuse to start, deprecation window, automatic bundles, Vloer's own train, contract scope). On acceptance it supersedes ADR-0004 and eight follow-up tickets get filed.

Verified with mise run verify on the pinned toolchain (all gates passed).

Ticket: https://vikunja.webgrip.dev/tasks/1756

🤖 Generated with Claude Code

The owner allowed Ploeg to release independently on 2026-10-03 and asked what happens with incompatibility. ADR-0018 proposes to supersede ADR-0004's single version: Ploeg and Vloer get their own release trains, Ploeg's operator API carries a MAJOR.MINOR contract version (a /version route and a Ploeg-Contract header), and Vloer declares the range it supports. Outside that range, Vloer shows a blocking banner and makes no managed calls. Contract changes are expand and contract, with a proposed 60-day deprecation window. A cross-version qualification of real Ploeg and real Vloer gates releases. An unfold-v bundle pins a qualified pair, and the joint draft barrier from #146 moves to that bundle. The ADR lists five owner questions and eight follow-up tickets. No code changes. Proposed, not accepted. Five owner questions are marked in the ADR (banner vs refuse to start, deprecation window, automatic bundles, Vloer's own train, contract scope). On acceptance it supersedes ADR-0004 and eight follow-up tickets get filed. Verified with `mise run verify` on the pinned toolchain (all gates passed). Ticket: https://vikunja.webgrip.dev/tasks/1756 🤖 Generated with [Claude Code](https://claude.com/claude-code)

ryangr0 added 1 commit 2026-10-03 12:20:26 +00:00

docs(adr): propose ADR-0018 Ploeg releases on its own schedule behind a tested contract version ... 883985c025

The owner allowed Ploeg to release independently on 2026-10-03 and asked
what happens with incompatibility. ADR-0018 proposes to supersede ADR-0004's
single version: Ploeg and Vloer get their own release trains, Ploeg's
operator API carries a MAJOR.MINOR contract version (a /version route and a
Ploeg-Contract header), and Vloer declares the range it supports. Outside
that range, Vloer shows a blocking banner and makes no managed calls.
Contract changes are expand and contract, with a proposed 60-day
deprecation window. A cross-version qualification of real Ploeg and real
Vloer gates releases. An unfold-v bundle pins a qualified pair, and the
joint draft barrier from #146 moves to that bundle. The ADR lists five
owner questions and eight follow-up tickets. No code changes.

VIK-1756

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

ryangr0 merged commit 0abd6906f0 into development 2026-10-03 12:22:53 +00:00

ryangr0 referenced this pull request from a commit 2026-10-03 12:22:54 +00:00

Merge pull request 'docs(adr): propose ADR-0018 Ploeg releases on its own schedule behind a tested contract version' (#183) from ryangr0/adr-ploeg-independent-releases into development

ryangr0 referenced this pull request 2026-10-03 12:44:37 +00:00

fix(release): record release floors and refuse versions at or below them #197

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

webgrip/unfold!183

No description provided.