Update prompts, add summarizer utilities with GPL header, clean docs

Author: Ademfcan

src/codestory/core/filters/utils.py

@@ -15,9 +15,6 @@
 #  * along with this program; if not, you can contact us at support@codestory.build
 #  */
 # -----------------------------------------------------------------------------
-"""
-Summarization module for generating commit message summaries from code chunks.
-"""
 
 from codestory.core.diff.data.atomic_container import AtomicContainer
 from codestory.core.logging.utils import describe_container

src/codestory/core/semantic_analysis/summarization/prompts.py

@@ -25,9 +25,9 @@
 # Single Chunk Summary Prompts
 # -----------------------------------------------------------------------------
 
-INITIAL_SUMMARY_SYSTEM = """You are an expert developer writing Git commit messages. 
+INITIAL_SUMMARY_SYSTEM = """You are an expert developer writing Git commit messages.
 
-Given code changes with git patches and metadata (added/removed/modified symbols), write a concise commit message that describes what changed.
+Given a code change with a diff patch and optional metadata (languages, scopes, symbols), write a concise commit message.
 {message}
 Rules:
 - Single line, max 72 characters
@@ -48,23 +48,23 @@
 
 BATCHED_SUMMARY_SYSTEM = """You are an expert developer writing Git commit messages.
 
-Given a JSON array of code changes, write a commit message for each one. Each change includes git patches and metadata about added/removed/modified symbols.
+Given multiple code changes (each with diff patches and optional metadata), write one commit message per change.
 {message}
 Rules:
-- Output a JSON array of strings with one message per input change
+- Output a numbered list with one message per change
 - Each message: single line, max 72 characters, imperative mood
-- Output ONLY the JSON array, no other text
 - Match the input order exactly
 
-Example:
-Input: [{{"git_patch": "..."}}, {{"git_patch": "..."}}]
-Output: ["Add user authentication", "Update config parser"]"""
+Example output:
+1. Add user authentication
+2. Update config parser
+3. Fix memory leak in cache"""
 
 BATCHED_SUMMARY_USER = """Here are {count} code changes:
 
 {changes}
 
-Provide {count} commit messages as a JSON array:"""
+Provide {count} commit messages as a numbered list:"""
 
 
 # -----------------------------------------------------------------------------
@@ -90,20 +90,19 @@
 
 BATCHED_CLUSTER_SUMMARY_SYSTEM = """You are an expert developer writing Git commit messages.
 
-Given a JSON array where each element contains multiple related commit messages, combine each group into one cohesive commit message.
+Given multiple groups of related commit messages, combine each group into one cohesive commit message.
 {message}
 Rules:
-- Output a JSON array of strings with one message per input group
+- Output a numbered list with one message per group
 - Each message: single line, max 72 characters, imperative mood
-- Output ONLY the JSON array, no other text
 - Match the input order exactly
 
-Example:
-Input: [["Add login", "Add logout"], ["Fix parser", "Update tests"]]
-Output: ["Add authentication system", "Fix parser and update tests"]"""
+Example output:
+1. Add authentication system
+2. Fix parser and update tests"""
 
 BATCHED_CLUSTER_SUMMARY_USER = """Here are {count} groups of related commit messages:
 
 {groups}
 
-Provide {count} combined commit messages as a JSON array:"""
+Provide {count} combined commit messages as a numbered list:"""

src/codestory/core/semantic_analysis/summarization/summarizer_utils.py

@@ -1,3 +1,23 @@
+# -----------------------------------------------------------------------------
+# /*
+#  * Copyright (C) 2025 CodeStory
+#  *
+#  * This program is free software; you can redistribute it and/or modify
+#  * it under the terms of the GNU General Public License as published by
+#  * the Free Software Foundation; Version 2.
+#  *
+#  * This program is distributed in the hope that it will be useful,
+#  * but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+#  * GNU General Public License for more details.
+#  *
+#  * You should have received a copy of the GNU General Public License
+#  * along with this program; if not, you can contact us at support@codestory.build
+#  */
+# -----------------------------------------------------------------------------
+"""Utilities for preparing annotated patches from chunks for summarization."""
+
+from __future__ import annotations
 
 from typing import TYPE_CHECKING