From 9b02e850788d074f08cc734b205eb3a3f62467e9 Mon Sep 17 00:00:00 2001
From: selman koc <64414348+skoc10@users.noreply.github.com>
Date: Fri, 6 Feb 2026 16:56:50 +0300
Subject: [PATCH] Refactor AI notes handling and version mapping extraction

Updated the AI response handling and improved raw notes cleaning process. Enhanced version mapping table extraction and file writing to preserve all content.
---
 .github/workflows/update-studio-docs.yml | 54 ++++++++++++++++++------
 1 file changed, 42 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/update-studio-docs.yml b/.github/workflows/update-studio-docs.yml
index b8c092e52e..d84181ae70 100644
--- a/.github/workflows/update-studio-docs.yml
+++ b/.github/workflows/update-studio-docs.yml
@@ -197,20 +197,38 @@ jobs:
             echo "✅ Using AI-formatted release notes"
             echo "$AI_RESPONSE" > .tmp/final-notes.txt
           else
-            echo "⚠️ AI unavailable - using raw release notes with basic formatting"
+            echo "⚠️ AI unavailable - using raw release notes with cleaning"
             
-            # Use environment variable for raw notes
+            # Clean and format raw notes
             echo "$RAW_NOTES" | while IFS= read -r line; do
               # Skip empty lines
-              if [ -z "$line" ]; then
-                continue
-              fi
+              [ -z "$line" ] && continue
+              
+              # Skip GitHub PR metadata lines
+              [[ "$line" =~ ^(Full\ Changelog|\*\*Full\ Changelog) ]] && continue
+              
+              # Clean GitHub username mentions (@username -> username)
+              line=$(echo "$line" | sed 's/@\([a-zA-Z0-9_-]*\)/\1/g')
+              
+              # Clean GitHub PR/issue links - extract just the description
+              line=$(echo "$line" | sed 's#in https://github.com/[^[:space:]]*##g')
+              line=$(echo "$line" | sed 's#by [a-zA-Z0-9_-]* in##g')
+              
+              # Clean extra "by username" mentions
+              line=$(echo "$line" | sed 's/by [a-zA-Z0-9_-]*$//g')
+              
+              # Trim whitespace
+              line=$(echo "$line" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+              
+              # Skip if line is now empty
+              [ -z "$line" ] && continue
               
               # Add bullet if not present
-              if [[ ! "$line" =~ ^[[:space:]]*- ]]; then
+              if [[ ! "$line" =~ ^[[:space:]]*[-*] ]]; then
                 echo "- $line"
               else
-                echo "$line"
+                # Normalize to dash
+                echo "$line" | sed 's/^[[:space:]]*\*/- /'
               fi
             done > .tmp/final-notes.txt
           fi
@@ -368,18 +386,27 @@ jobs:
 
           # Find table start (skip SEO and headers)
           table_start = 0
+          table_end = 0
           for i, line in enumerate(lines):
               if line.strip().startswith('|') and '**ABP Studio Version**' in line:
                   table_start = i
+              elif table_start > 0 and line.strip() and not line.strip().startswith('|'):
+                  table_end = i
                   break
 
           if table_start == 0:
               print("❌ Could not find version mapping table")
               exit(1)
 
-          # Extract header + separator + data rows
-          header_lines = lines[:table_start+2]  # Keep everything before data rows
-          data_rows = [l for l in lines[table_start+2:] if l.strip().startswith('|')]
+          # If no end found, table goes to end of file
+          if table_end == 0:
+              table_end = len(lines)
+
+          # Extract sections
+          before_table = lines[:table_start]  # Everything before table
+          table_header = lines[table_start:table_start+2]  # Header + separator
+          data_rows = [l for l in lines[table_start+2:table_end] if l.strip().startswith('|')]  # Data rows
+          after_table = lines[table_end:]  # Everything after table
 
           new_rows = []
           handled = False
@@ -459,9 +486,12 @@ jobs:
               new_rows.insert(0, new_row)
               print(f"✅ Added new mapping: {studio_ver} -> {abp_ver}")
 
-          # Write updated file
+          # Write updated file - preserve ALL content
           with open(file_path, 'w') as f:
-              f.writelines(header_lines + new_rows)
+              f.writelines(before_table)  # SEO, title, intro text
+              f.writelines(table_header)  # Table header
+              f.writelines(new_rows)      # Updated data rows
+              f.writelines(after_table)   # Content after table (preview section, etc.)
 
           print("MAPPING_UPDATED=true")
           PYTHON_EOF