Skip to content

Commit 3b31a5f

Browse files
author
jobordu
committed
Add DIST-01 requirement: @next dist-tag SHALL never fall behind @latest
Formalizes the dist-tag alignment invariant implemented in 0.41.14 as an official requirement (DIST-01) in the requirements envelope. The invariant is already enforced by release.yml CI and publish.sh.
1 parent bc70886 commit 3b31a5f

1 file changed

Lines changed: 16 additions & 3 deletions

File tree

.planning/formal/requirements.json

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"aggregated_at": "2026-04-04T19:46:11.442Z",
3-
"content_hash": "8629ecf5241a7562",
2+
"aggregated_at": "2026-04-06T11:52:32.757Z",
3+
"content_hash": "2df7f9c75c6fc3ba",
44
"requirements": [
55
{
66
"id": "ACT-01",
@@ -1433,6 +1433,19 @@
14331433
"milestone": "quick-374"
14341434
}
14351435
},
1436+
{
1437+
"id": "DIST-01",
1438+
"text": "The npm `@next` dist-tag SHALL never point to a version older than `@latest`. After every stable publish to `@latest`, the `@next` dist-tag MUST be aligned to the same or a newer version.",
1439+
"category": "Release & Distribution",
1440+
"tier": "user",
1441+
"phase": "unknown",
1442+
"status": "Complete",
1443+
"provenance": {
1444+
"source_file": "manual",
1445+
"milestone": "v0.41"
1446+
},
1447+
"background": "Implemented in 0.41.14. Automated in release.yml (CI), publish.sh (manual publish), and documented in CLAUDE.md. Prevents stale prerelease tags from confusing consumers who install via @next."
1448+
},
14361449
{
14371450
"id": "DRIFT-01",
14381451
"text": "`check-trace-schema-drift.cjs` detects schema drift and emits `check-results.ndjson`",
@@ -6116,5 +6129,5 @@
61166129
"schema_version": "1",
61176130
"source": ".planning/REQUIREMENTS.md",
61186131
"last_sync": "2026-03-31T09:45:23.686Z",
6119-
"frozen_at": "2026-04-04T19:46:11.443Z"
6132+
"frozen_at": "2026-04-06T11:52:32.757Z"
61206133
}

0 commit comments

Comments
 (0)