Story 2451: AI-Assisted Description for Link Posts type

.pre-commit-config.yaml

@@ -1,14 +1,17 @@
 default_language_version:
   python: python3.13
 
-exclude: .*migrations\/.*|static\/img\/.*|static\/animations\/.*|static\/js\/boost-gecko\/.*|kube\/boost\/templates\/.*\.yaml
+# Generated esbuild outputs (see `build:wysiwyg` / `build:fuse` in package.json)
+# are excluded because trailing-whitespace / EOL hooks would corrupt minified
+# string and regex content inside them.
+exclude: .*migrations\/.*|static\/img\/.*|static\/animations\/.*|static\/js\/boost-gecko\/.*|kube\/boost\/templates\/.*\.yaml|static\/js\/v3\/wysiwyg-editor\.js|static\/js\/v3\/fuse\.min\.js
 
 repos:
   - repo: https://github.com/adamchainz/django-upgrade
     rev: "1.27.0"
     hooks:
       - id: django-upgrade
-        args: [--target-version, "5.2"]   # Replace with Django version
+        args: [--target-version, "5.2"] # Replace with Django version
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
     hooks:
@@ -20,7 +23,7 @@ repos:
       - id: trailing-whitespace
         exclude: ^core/tests/content/boost_release[a-zA-Z_]+.html
   - repo: https://github.com/ambv/black
-    rev: 24.10.0
+    rev: 26.1.0
     hooks:
       - id: black
   - repo: https://github.com/charliermarsh/ruff-pre-commit

ak/views.py

@@ -17,7 +17,6 @@
 from testimonials.models import Testimonial
 from core.mock_data import SharedResources
 
-
 logger = structlog.get_logger()
 
 

config/settings.py

@@ -655,6 +655,8 @@
 BOOST_BRANCHES = ["master", "develop"]
 OPENROUTER_URL = "https://openrouter.ai/api/v1"
 OPENROUTER_API_KEY = env("OPENROUTER_API_KEY")
+SUMMARIZATION_MODEL = env("SUMMARIZATION_MODEL", default="gpt-oss-120b")
+WHATS_NEW_MODEL = env("WHATS_NEW_MODEL", default="gpt-oss-120b")
 
 ALGOLIA = {
     "app_id": env("ALGOLIA_APP_ID", None),

config/urls.py

@@ -53,7 +53,11 @@
     CommitEmailResendView,
 )
 from news.feeds import AtomNewsFeed, RSSNewsFeed
-from news.views import V3AllTypesCreateView
+from news.views import (
+    V3AllTypesCreateView,
+    generate_description,
+    generate_link_description,
+)
 from users.views import (
     CurrentUserAPIView,
     CurrentUserProfileView,
@@ -271,6 +275,16 @@
         ),
         path("news/", include("news.urls")),
         path("v3/news/add/", V3AllTypesCreateView.as_view(), name="v3-news-create"),
+        path(
+            "v3/news/generate-description/",
+            generate_description,
+            name="v3-news-generate-description",
+        ),
+        path(
+            "v3/news/generate-link-description/",
+            generate_link_description,
+            name="v3-news-generate-link-description",
+        ),
         path(
             "people/detail/",
             TemplateView.as_view(template_name="boost/people_detail.html"),

core/context_processors.py

@@ -9,7 +9,6 @@
 from versions.converters import BoostVersionSlugConverter
 from versions.models import Version
 
-
 _BOOST_VERSION_SLUG_ROUTE_TOKEN = (
     f"<{BoostVersionSlugConverter.URL_TYPE_NAME}:version_slug>"
 )

core/tests/test_managers.py

@@ -8,7 +8,6 @@
 
 from ..models import RenderedContent
 
-
 TEST_CACHES = {
     "static_content": {
         "BACKEND": "django.core.cache.backends.locmem.LocMemCache",

core/tests/test_tasks.py

@@ -9,7 +9,6 @@
     clear_rendered_content_cache_by_content_type,
 )
 
-
 TEST_CACHES = {
     "static_content": {
         "BACKEND": "django.core.cache.backends.locmem.LocMemCache",

core/views.py

@@ -1954,8 +1954,7 @@ def get_context_data(self, **kwargs):
         ]
         context["markdown_data"] = {
             "title": "Markdown Block",
-            "markdown": dedent(
-                """
+            "markdown": dedent("""
 
             ######Insert anything Required
 
@@ -1965,8 +1964,7 @@ def get_context_data(self, **kwargs):
             * list
 
             Or **bold** and *italics* and whatever it needs to be formatted or [use links](https://www.example.com)!
-            """
-            ),
+            """),
             "button_url": "#",
             "button_label": "Optional CTA Button",
             "button_style": "primary",

frontend/wysiwyg-editor.js

@@ -891,11 +891,49 @@ export const initWysiwyg = (textareaId) => {
     form.addEventListener("submit", syncTextarea, true);
   }
 
+  // ── Bridge to the host page (e.g. the create-post Alpine form) ──────────
+  // Emit content + plain-text char count on every change so the page can drive
+  // a char counter, a Saving/Saved indicator, and localStorage persistence.
+  // `programmatic: true` flags updates the user didn't make (initial load /
+  // restore) so the page can skip the "Saving" animation and not re-persist.
+  const currentValue = () =>
+    state.mode === "markdown"
+      ? state.markdownText
+      : turndown.turndown(editor.getHTML());
+  const dispatchState = (programmatic) => {
+    editorEl.dispatchEvent(
+      new CustomEvent("wysiwyg-update", {
+        detail: {
+          id: textareaId,
+          characters: editor.state.doc.textContent.length,
+          value: currentValue(),
+          programmatic: !!programmatic,
+        },
+        bubbles: true,
+      }),
+    );
+  };
+  editor.on("update", () => dispatchState(false));
+
+  // Let the host push a saved draft back into the editor (restore).
+  const onSetContent = (e) => {
+    if (!e.detail || e.detail.id !== textareaId) return;
+    const md = e.detail.value || "";
+    editor.commands.setContent(md ? parseMarkdownSafe(md) : "");
+    dispatchState(true);
+  };
+  window.addEventListener("wysiwyg-set-content", onSetContent);
+
+  // Initial state (deferred a frame so the host's listener is attached).
+  dispatchState(true);
+  requestAnimationFrame(() => dispatchState(true));
+
   editorInstances.set(textareaId, {
     editor,
     cleanup: () => {
       document.removeEventListener("click", handleDocClick);
       if (form) form.removeEventListener("submit", syncTextarea, true);
+      window.removeEventListener("wysiwyg-set-content", onSetContent);
     },
   });
   return editor;

gunicorn.conf.py

@@ -3,7 +3,6 @@
 import os
 from psycogreen.gevent import patch_psycopg  # use this if you use gevent workers
 
-
 BASE_DIR = os.environ["H"] if os.environ.get("H", None) else "/code"
 
 accesslog = "-"

libraries/admin.py

@@ -57,7 +57,6 @@
 )
 from .utils import generate_release_report_filename
 
-
 logger = structlog.get_logger()
 
 
@@ -277,7 +276,7 @@ def generate_report(self):
         # NOTE TO FUTURE DEVS: remember to account for the fact that a report
         #  configuration may not match with a real version in frequent cases where
         #  reports are generated before the release version has been created.
-        (report_before_release, prior_version, version) = determine_versions(
+        report_before_release, prior_version, version = determine_versions(
             report_configuration.version
         )
 

libraries/forms.py

@@ -290,7 +290,7 @@ def get_stats(self, base_uri: str = None):
         # NOTE TO FUTURE DEVS: remember to account for the fact that a report
         #  configuration may not match with a real version in frequent cases where
         #  reports are generated before the release version has been created.
-        (report_before_release, prior_version, version) = determine_versions(
+        report_before_release, prior_version, version = determine_versions(
             report_configuration.version
         )
 
@@ -368,21 +368,19 @@ def core_batchable(x):
         git_graph_data = get_git_graph_data(prior_version, version)
         download = get_download_links(version, base_uri)
         ### completed task handling ###
-        (mailinglist_contributor_release_count, mailinglist_contributor_new_count) = (
+        mailinglist_contributor_release_count, mailinglist_contributor_new_count = (
             mailing_list_contributors_task.get()
         )
-        (mailinglist_post_stats, total_mailinglist_count) = (
-            mailing_list_stats_task.get()
-        )
-        (commit_contributors_release_count, commit_contributors_new_count) = (
+        mailinglist_post_stats, total_mailinglist_count = mailing_list_stats_task.get()
+        commit_contributors_release_count, commit_contributors_new_count = (
             commit_contributors_task.get()
         )
         (
             mailinglist_words,
             mailinglist_wordcloud_base64,
             mailinglist_wordcloud_top_words,
         ) = mailinglist_wordcloud_task.get()
-        (search_wordcloud_base64, search_wordcloud_top_words, search_stats) = (
+        search_wordcloud_base64, search_wordcloud_top_words, search_stats = (
             search_wordcloud_task.get()
         )
         global_contributors_new_count = new_contributors_count_task.get()
@@ -441,7 +439,7 @@ def generate_context(
         # NOTE TO FUTURE DEVS: remember to account for the fact that a report
         #  configuration may not match with a real version in frequent cases where
         #  reports are generated before the release version has been created.
-        (report_before_release, prior_version, version) = determine_versions(
+        report_before_release, prior_version, version = determine_versions(
             report_configuration.version
         )
 

libraries/tests/fixtures.py

@@ -256,14 +256,12 @@ def github_action_boostdep_output_artifact():
     A shortened example of the content in the artifact output by the
     dependency_report.yaml action
     """
-    return dedent(
-        """\
+    return dedent("""\
         Dependencies for version boost-1.33.0
         Dependencies for version boost-1.34.0
         Dependencies for version boost-1.35.0
         algorithm -> concept_check config detail logic numeric~conversion
         Dependencies for version boost-1.85.0
         algorithm -> array assert bind concept_check config core
         numeric~conversion -> array
-        callable_traits ->"""
-    )
+        callable_traits ->""")

libraries/tests/test_commands.py

@@ -3,7 +3,6 @@
 from django.contrib.auth import get_user_model
 from django.core.management import call_command
 
-
 User = get_user_model()
 
 

libraries/tests/test_tasks.py

@@ -21,14 +21,12 @@ def test_get_and_store_library_version_documentation_urls_for_version(
     version = library_version.version
     library = library_version.library
     library_name = library.name.lower()
-    mock_s3_response = {
-        "content": f"""
+    mock_s3_response = {"content": f"""
         <h2>Libraries Listed <a name="Alphabetically">Alphabetically</a></h2>
         <ul>
             <li><a href="{library_name}/index.html">{library_name}</a></li>
         </ul>
-    """
-    }
+    """}
 
     # Mock the get_content_from_s3 function to return the mock S3 response
     mock_s3_client.get_object.return_value = mock_s3_response

mailing_list/management/commands/sync_mailinglist_stats.py

@@ -113,15 +113,13 @@ def bulk_create(rows):
     columns = ["email", "name"]
     # Uses a named cursor to use a serverside postgres cursor
     with conn.cursor(name="commitauthor_sync") as cursor:
-        cursor.execute(
-            """
+        cursor.execute("""
                 SELECT
                     LOWER(sender_id) AS email
                     , (ARRAY_AGG(distinct(sender_name)))[1] as name
                 FROM hyperkitty_email
                 GROUP BY LOWER(sender_id);
-            """
-        )
+            """)
         rows = []
         for i, data in enumerate(cursor):
             row = {x: data[j] for j, x in enumerate(columns)}

mailing_list/tasks.py

@@ -5,7 +5,6 @@
 
 from config.celery import app
 
-
 logger = structlog.getLogger(__name__)
 
 

marketing/tests.py

@@ -43,7 +43,7 @@ def test_qrc_falls_back_to_remote_addr_when_no_xff(tp):
     tp.response_302(res)
     assert res["Location"] == "/library/latest/algorithm/"
 
-    (_, kwargs) = post_mock.call_args
+    _, kwargs = post_mock.call_args
     headers = kwargs["headers"]
     assert headers["X-Forwarded-For"] == "127.0.0.1"  # Django test client default
 

news/acl.py

@@ -4,7 +4,6 @@
 from django.contrib.auth import get_user_model
 from django.db.models import Q
 
-
 User = get_user_model()
 
 

news/constants.py

@@ -1,3 +1,6 @@
 NEWS_APPROVAL_SALT = "news-approval"
 MAGIC_LINK_EXPIRATION = 3600 * 24  # 24h
 CONTENT_SUMMARIZATION_THRESHOLD = 1000  # characters
+# Target length for the AI-generated Description. Kept under the 1000-char field
+# cap so the model has some leeway and the result fits without truncation.
+DESCRIPTION_SUMMARY_MAX_LENGTH = 900  # characters

news/forms.py

@@ -22,13 +22,13 @@ def save(self, *args, commit=True, **kwargs):
 class BlogPostForm(EntryForm):
     class Meta:
         model = BlogPost
-        fields = ["title", "publish_at", "content", "image"]
+        fields = ["title", "publish_at", "content", "summary", "image"]
 
 
 class LinkForm(EntryForm):
     class Meta:
         model = Link
-        fields = ["title", "publish_at", "external_url", "image"]
+        fields = ["title", "publish_at", "external_url", "summary", "image"]
 
     # Holding on this as it's a new feature Issue #437
     # def save(self, *args, commit=True, **kwargs):
@@ -43,7 +43,7 @@ class Meta:
 class NewsForm(EntryForm):
     class Meta:
         model = News
-        fields = ["title", "publish_at", "content", "image"]
+        fields = ["title", "publish_at", "content", "summary", "image"]
 
 
 class PollForm(EntryForm):