Skip to content

Stop stamping changelog watermark without showing notes (CL-5475) - #449

Merged
TheGreatAxios merged 1 commit into
mainfrom
cl-5475-dead-whats-new-path-still-stamps-the-changelog-watermark
Aug 10, 2026
Merged

Stop stamping changelog watermark without showing notes (CL-5475)#449
TheGreatAxios merged 1 commit into
mainfrom
cl-5475-dead-whats-new-path-still-stamps-the-changelog-watermark

Conversation

@TheGreatAxios

Copy link
Copy Markdown
Collaborator

Summary

  • CL-5475: upgrade release notes were stamped via lastChangelogVersion without ever rendering on the OpenTUI path (dead whatsNewMarkdown).
  • Prefer the smaller correct fix: stop stamping unless notes were actually shown. First-install still stamps quietly.
  • Extract pure stampVersionAfterStartup(decision, notesShown) so policy is unit-tested and a future surface can flip notesShown to true.

Approach

Stop stamping (not restore surface). The former Ink whats-new banner is gone; stamping without display permanently swallowed notes. /changelog remains available on demand.

Test plan

  • bun test src/changelog/index.test.ts
  • bun run typecheck
  • bun run test (4481 pass)
  • New cases under stampVersionAfterStartup:
    • first_install always stamps
    • upgrade stamps only when notes were shown (CL-5475)
    • current never stamps

Closes CL-5475

The OpenTUI path computed whatsNewMarkdown and stamped lastChangelogVersion
as a side effect, but never rendered the notes — upgrades were permanently
marked seen without display. Stamp first-install only; upgrade stamps only
when notesShown is true (currently false until a surface returns).
@linear-code

linear-code Bot commented Aug 10, 2026

Copy link
Copy Markdown

CL-5475

@TheGreatAxios
TheGreatAxios merged commit 8fa81bd into main Aug 10, 2026
2 checks passed
@TheGreatAxios
TheGreatAxios deleted the cl-5475-dead-whats-new-path-still-stamps-the-changelog-watermark branch August 10, 2026 02:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant