Skip to content

Commit 4e49bbd

Browse files
committed
docs(fix[release]): Keep leads release-only
why: Trunk now reserves version-led changelog summaries for release cuts. Feature branches should contribute only scoped deliverable sections. what: - Remove the unreleased a36 summary while retaining both deliverables. - Move the identity ADR link into its deliverable and guard the rule.
1 parent d05d14e commit 4e49bbd

2 files changed

Lines changed: 6 additions & 11 deletions

File tree

CHANGES

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -42,13 +42,6 @@ $ uvx --from 'agentgrep' --prerelease allow python
4242

4343
<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
4444

45-
agentgrep 0.1.0a36 ships consistent record handles across search and one
46-
pi-like slash-command surface across both TUI layouts. Content, stored-turn,
47-
and thread handles now agree across terminal, JSON, HUD, and MCP surfaces,
48-
while the HUD and grep-log share commands without Textual's global palette.
49-
See the {ref}`deterministic record identity contract
50-
<adr-deterministic-record-identity>`.
51-
5245
### What's new
5346

5447
#### Consistent record handles across search (#80)
@@ -68,7 +61,8 @@ Canonical handles sit alongside them for durable comparison.
6861
Stores with missing occurrence or thread topology report null values instead
6962
of inventing relationships from filenames or timestamps. That conservative
7063
contract gives bookmarks, export, and similarity features a common foundation
71-
without making them depend on one another.
64+
without making them depend on one another. See the {ref}`deterministic record
65+
identity contract <adr-deterministic-record-identity>`.
7266

7367
#### Predictable TUI commands and focus (#111)
7468

tests/test_identity_docs.py

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,7 @@ def test_identity_adr_keeps_refs_and_privacy_boundaries_positive() -> None:
201201

202202

203203
def test_unreleased_changelog_discloses_identity_and_tui_deliverables() -> None:
204-
"""The release section describes both product-level outcomes."""
204+
"""The unreleased section lists both outcomes without a release summary."""
205205
changes = _read_text("CHANGES")
206206
release_match = re.search(
207207
r"^## agentgrep (?P<version>\d+\.\d+\.\d+\w*) \(Yet to be released\)\n"
@@ -210,16 +210,17 @@ def test_unreleased_changelog_discloses_identity_and_tui_deliverables() -> None:
210210
flags=re.MULTILINE | re.DOTALL,
211211
)
212212
assert release_match is not None
213-
version = release_match.group("version")
214213
release = release_match.group("body")
215214
identity_heading = "#### Consistent record handles across search (#80)"
216215
tui_heading = "#### Predictable TUI commands and focus (#111)"
216+
end_marker = "<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->"
217217

218218
assert release.count(identity_heading) == 1
219219
assert changes.count(identity_heading) == 1
220220
assert release.count(tui_heading) == 1
221221
assert changes.count(tui_heading) == 1
222-
assert re.search(rf"agentgrep {re.escape(version)} ships [^.]+\.", release)
222+
assert end_marker in release
223+
assert release.split(end_marker, maxsplit=1)[1].lstrip().startswith("### ")
223224
assert "### What's new" in release
224225
assert "adr-deterministic-record-identity" in release
225226
assert "repeated content" in release

0 commit comments

Comments
 (0)