Skip to content

Commit 853998d

Browse files
docs: triage v040 release truth wording
Closes F-01 by marking superseded v0.3.1 wording as historical and keeping current release guidance aligned on v0.4.0.
1 parent 789ccb9 commit 853998d

3 files changed

Lines changed: 15 additions & 16 deletions

File tree

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ This project has a published GitHub Release line, but no stable support or API g
66

77
## [Unreleased]
88

9+
- Triaged superseded v0.3.1 release-target wording before the v0.4.0 release train.
910
- Add non-UTF-8 error-contract coverage for `dedupe` and `conflicts`.
1011

1112
### Added

docs/PRE-V0.4.0-INTERNAL-READINESS-AUDIT.md

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ Current main includes post-v0.3.0 functionality, including dedupe and conflicts.
106106

107107
### RB-02: final release evidence is missing
108108

109-
Status: open.
109+
Status: closed by docs/triage-v040-release-truth-wording.
110110

111111
The v0.4.0 release still needs exact release evidence, including:
112112

@@ -135,17 +135,13 @@ Before release/prepare-v040, the external audit package must include the core so
135135
Severity: medium.
136136
Status: open.
137137

138-
The stale-truth scan still finds older v0.3.1 and v0.2.x wording in historical docs, changelog entries, and product-strategy material. Some of this is legitimate historical release evidence and should not be rewritten. Some wording may still read like current guidance and should be triaged before the final v0.4.0 release package.
139-
140-
Required follow-up:
141-
142-
- identify which older references are intentionally historical;
143-
- update any current-guidance wording that still says the next work is v0.3.1 or a patch release;
144-
- avoid rewriting historical release notes unless the current truth boundary is genuinely unclear.
138+
The stale-truth scan found older v0.3.1 and v0.2.x wording in historical docs, changelog entries, and product-strategy material. The v0.3.1 wording that could read like current guidance in docs/V0.3.0-POST-RELEASE-AUDIT.md was triaged and marked as superseded historical planning. Historical v0.2.x release evidence remains intentionally unchanged.
145139

146-
Suggested phase:
140+
Resolution:
147141

148-
- docs/triage-v040-release-truth-wording
142+
- v0.3.1 wording in the v0.3.0 post-release audit is now explicitly labeled as superseded historical planning;
143+
- current release guidance remains v0.4.0;
144+
- historical v0.2.x release evidence is retained and not rewritten.
149145

150146
## Deferred non-blockers
151147

docs/V0.3.0-POST-RELEASE-AUDIT.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,15 @@ The README repository layout lists:
3535

3636
The file does not exist in v0.3.0. The doctor command is implemented in src/agent_rules_kit/cli.py.
3737

38-
Decision: fix the README layout in the v0.3.1 maintenance cycle. Do not refactor doctor into a separate module unless a later phase explicitly decides that the command has grown enough to justify it.
38+
Historical decision at v0.3.0 close: fix the README layout in the then-planned v0.3.1 maintenance cycle. Current status: that target was superseded by the v0.4.0 release train after dedupe and conflicts were added to main. Do not refactor doctor into a separate module unless a later phase explicitly decides that the command has grown enough to justify it.
3939

4040
### P1 — Threat model review drift
4141

4242
docs/THREAT-MODEL.md still says it was reviewed for the published v0.2.0 release line and post-v0.2.0 main state.
4343

4444
v0.3.0 added the public doctor, budget, and explain command surface. These commands remain local and read-only, but the threat model should explicitly say it was reviewed for v0.3.0 and should mention the v0.3.0 command surface.
4545

46-
Decision: update the threat model in the v0.3.1 maintenance cycle before adding new product features.
46+
Historical decision at v0.3.0 close: update the threat model in the then-planned v0.3.1 maintenance cycle before adding new product features. Current status: that target was superseded by the v0.4.0 release train and later current-main hardening phases.
4747

4848
### P2 — CI compatibility coverage
4949

@@ -67,11 +67,13 @@ Decision: evaluate these areas in separate phases. Do not enable noisy or sensit
6767

6868
doctor and budget are console-only in v0.3.0.
6969

70-
Decision: keep v0.3.1 focused on maintenance hardening. Plan JSON output for doctor and budget in a later feature release.
70+
Historical decision at v0.3.0 close: keep the then-planned v0.3.1 cycle focused on maintenance hardening. Current status: the next eligible public release target is now v0.4.0 because current main includes dedupe and conflicts. JSON output for doctor and budget remains deferred to a later feature release.
7171

72-
## v0.3.1 maintenance target
72+
## Superseded v0.3.1 maintenance target
7373

74-
The next patch release should focus on maintenance hardening:
74+
This section is retained as historical post-v0.3.0 planning evidence. It is no longer current release guidance. The next eligible public release target is v0.4.0, not v0.3.1, because current main includes the new dedupe and conflicts command surfaces.
75+
76+
The then-planned patch release was expected to focus on maintenance hardening:
7577

7678
- record this post-release audit;
7779
- sync README layout with the real source tree;
@@ -85,4 +87,4 @@ The next patch release should focus on maintenance hardening:
8587

8688
v0.3.0 remains published and should not be modified.
8789

88-
The next development cycle should start with v0.3.1 maintenance hardening before any v0.4.0 product features.
90+
Historical note: the next development cycle was originally expected to start with v0.3.1 maintenance hardening before any v0.4.0 product features. This was superseded by the current v0.4.0 release train after dedupe and conflicts landed on main.

0 commit comments

Comments
 (0)