feat(2397): add AI-generated "What's New" for release notes by ycanales · Pull Request #2417 · boostorg/website-v2

ycanales · 2026-05-11T18:29:18Z

Issue: #2397

Summary & Context

Adds an AI-generated "What's New" summary to the v3 Boost release detail page (issue #2397). Version model, and gated behind an admin-controlled approval flag.

Changes

Model + migration (versions/models.py, versions/migrations/0027_*.py)

Adds whats_new, whats_new_html, whats_new_approved, whats_new_generated_at fields to Version.
Adds whats_new_items cached property that parses the LLM's markdown bullets into {title, description} dicts for the v3 highlights card.

Celery pipeline (versions/tasks.py)

generate_whats_new task calls OpenRouter (gpt-oss-120b) with a fixed-rubric system prompt (max 5 bullets: new libraries, performance, dependencies, security & reliability, DX). Retries 3× on OpenAIError.
save_whats_new writes the markdown + rendered HTML back, leaving whats_new_approved untouched (publish stays manual).
dispatch_whats_new(version_pk) chains the two for a single version.

Auto-dispatch on import (versions/releases.py)

After store_release_notes_for_version succeeds, queue dispatch_whats_new if the version has no summary yet.

Management command (versions/management/commands/generate_whats_new.py)

--all-missing, --version , --force, --dry-run for backfill/regeneration.
--validate --limit N runs the prompt synchronously against recent versions and prints output (no DB writes) — satisfies the acceptance criterion to review the prompt against ≥10 past releases before sign-off.

Other

Admin: add fieldset, filter, and approve/regenerate actions. save_model re-renders whats_new_html from whats_new markdown on edit.
Added render_whats_new_markdown in core.htmlhelper.
Updated tests and docs.

Test plan

Seed some release notes (Version and RenderedContent objects)
- Run this helper script:
- docker compose exec -T web ./manage.py shell < scripts/seed_whats_new_qa.py
- If it runs successfully, it will output the generate_whats_new command:
- To run that you need an OpenRouter API key, you can create a free account or I can share my key, no problem.
- docker compose exec web ./manage.py generate_whats_new --version=boost-1-89-0 --force
- You'll be able to see the generated text going into the "What's New" section of the version (http://localhost:8000/admin/versions/version/)

Importing release notes for a version with empty whats_new queues and completes the task
Admin Regenerate action clears + repopulates fields and resets approval
Detail page hides the section until whats_new_approved=True
Migration applies cleanly on a fresh DB

‼️ Risks & Considerations ‼️

Drafts are never public until an admin clicks Approve — the view double-checks whats_new_approved.
Requires OPENROUTER_API_KEY; without it tasks retry 3× then give up (logged).
Do we want to connect to the VersionDetail view and related template in this PR?
Added approval process, do we want this or should they be automatically visible once generated?

Screenshots

Command

Celery

Self-review Checklist

Tag at least one team member from each team to review this PR
Link this PR to the related GitHub Project ticket

julioest

Really nice work on this! The approval gate, parser tolerance for LLM output drift, and the --validate flag are all great decisions.

I left one inline comment regarding the markdown rendering. Pre-approving! ✅

herzog0

I'm still reviewing as it's a very dense PR, but I figured I should start with these two comments

ycanales · 2026-05-13T22:19:55Z

@herzog0 I agree it would more consistent if we reset the approval, thanks for the suggestion! Adjusted.

ycanales · 2026-05-15T20:51:29Z

As per the feedback from today's demo, emojis are no longer used:

2026-05-15 16:49:48 2026-05-15 20:49:48 [INFO] trace.py:128 - Task versions.tasks.generate_whats_new[5feccf36-0e0e-49ed-9bdd-3f43834bb00b] succeeded in 11.917692756047472s: '- **New libraries** – Introduced Bloom filters library, expanding probabilistic data structures support.  
2026-05-15 16:49:48 - **Performance improvements** – Added allocator constructors, timer heap reserve, and metadata optimizations for faster, lower‑memory operations.  
2026-05-15 16:49:48 - **Dependencies** – Provided optional build targets, removed unnecessary headers, and introduced BOOST_LOG_WITHOUT_ASIO to eliminate Asio dependency.  
2026-05-15 16:49:48 - **Security & reliability** – Integrated TSAN instrumentation, fixed ASAN warnings, and resolved high‑CPU and parsing bugs across libraries.  
2026-05-15 16:49:48 - **Developer experience** – Added C++20 module support, constexpr enhancements, and [[noreturn]] attributes for clearer compile‑time behavior.'

Admin view:

julhoang

Hi @ycanales , this is awesome work!! I love the wide range of command options for testing and covering different cases.

I've left a couple of suggestions inline. Besides those, I'm wondering whether we need the whats_new_html field at all. My understanding is that it gives admin users a friendly preview in the admin panel but isn't actually consumed by the website – the card component will be reading from whats_new_items, right?

If that's the case, I think we should show whats_new_items in Django Admin instead, since that's the true output served to the website. While testing, I removed the bold label from the "New Libraries" item, and the HTML field still rendered that list item – but it failed the regex in whats_new_items and wasn't parsed. An admin editor seeing this would be confused about why the website doesn't match the whats_new_html preview. So, I think we should drop whats_new_html and surface whats_new_items directly. Does that sound reasonable to you?

herzog0

Just a couple of nits, but this is working really great!!! Thanks a ton @ycanales.

herzog0 · 2026-05-20T15:27:27Z

+    response = client.chat.completions.create(model=WHATS_NEW_MODEL, messages=messages)
+    try:
+        content = response.choices[0].message.content
+    except (AttributeError, IndexError) as e:
+        logger.error("generate_whats_new_response_error", error=str(e))
+        return None


Maybe we should include the .create() call in the try/catch to log the error, and then re-throw is its an instance of OpenAIError? (te leverage the autoretry_for option)

Good call, I've adjusted the try/except to cover the API call.

julhoang

This is really awesome work! Thanks so much for all the updates @ycanales ! 🎉

kattyode

QA Approved

ycanales linked an issue May 11, 2026 that may be closed by this pull request

Downloads Page: Automate "What's New" Section Generation #2397

Open

ycanales requested review from herzog0, jlchilders11, julhoang and julioest May 11, 2026 18:30

julioest approved these changes May 13, 2026

View reviewed changes

Comment thread core/htmlhelper.py Outdated

herzog0 reviewed May 13, 2026

View reviewed changes

Comment thread versions/management/commands/generate_whats_new.py Outdated

Comment thread versions/tasks.py

julhoang requested changes May 19, 2026

View reviewed changes

Comment thread versions/management/commands/generate_whats_new.py Outdated

Comment thread versions/tasks.py

Comment thread versions/management/commands/generate_whats_new.py Outdated

Comment thread versions/models.py Outdated

herzog0 approved these changes May 20, 2026

View reviewed changes

ycanales requested a review from julhoang May 20, 2026 17:02

julhoang approved these changes May 20, 2026

View reviewed changes

Comment thread docs/commands.md Outdated

julhoang reviewed May 20, 2026

View reviewed changes

Comment thread versions/management/commands/generate_whats_new.py Outdated

ycanales added 6 commits May 20, 2026 18:11

feat(2397): add AI-generated "What's New" for release notes

802c2d1

fix(2397): add bleach to clean markdown

98e6a91

feat(2397): add helper script for seeding Versions and RenderedContents

5f2783d

fix(2397): reset approval state when updating what's new

2cb9045

feat(2397): no emojis

57252e4

feat(2397): address PR feedback

7883d28

ycanales force-pushed the cy/2397-whatsnew branch from 0239b38 to 7883d28 Compare May 20, 2026 22:14

feat(2397): update docs and improve error messages

4b617a0

kattyode reviewed May 22, 2026

View reviewed changes

Conversation

ycanales commented May 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue: #2397

Summary & Context

Changes

Model + migration (versions/models.py, versions/migrations/0027_*.py)

Celery pipeline (versions/tasks.py)

Auto-dispatch on import (versions/releases.py)

Management command (versions/management/commands/generate_whats_new.py)

Other

Test plan

‼️ Risks & Considerations ‼️

Screenshots

Command

Celery

Self-review Checklist

Uh oh!

julioest left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

herzog0 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ycanales commented May 13, 2026

Uh oh!

ycanales commented May 15, 2026

Uh oh!

julhoang left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

herzog0 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

herzog0 May 20, 2026

Choose a reason for hiding this comment

Uh oh!

ycanales May 20, 2026

Choose a reason for hiding this comment

Uh oh!

julhoang left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

kattyode left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

ycanales commented May 11, 2026 •

edited

Loading