feat: Complete implementation of all YAML configurations (v0.0.5)

- Implemented complete parsing and validation of all YAML configuration options
- Added support for nested configuration values (agents.behavior.*)
- Added configuration validation (types, ranges, valid values)
- Fixed all GitHub URLs to use correct repository name (CodeReviewGuardian)
- Added AGENTS_CONFIG.md to Composer package files
- Updated README with Current Status section
- Enhanced script output to show all configuration values
- Updated CHANGELOG and UPGRADING documentation
- All configurations now parsed, validated, displayed and applied correctly

Author: HecFranco

.github/workflows/release.yml

@@ -3,20 +3,20 @@ name: Create Release
 on:
   push:
     tags:
-      - 'v*'  # Se dispara cuando se sube un tag que empieza con 'v'
+      - 'v*'  # Triggers when a tag starting with 'v' is pushed
 
 jobs:
   release:
     name: Create GitHub Release
     runs-on: ubuntu-latest
     permissions:
-      contents: write  # Necesario para crear releases
+      contents: write  # Required to create releases
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
         with:
-          fetch-depth: 0  # Necesario para obtener el historial completo y el mensaje del tag
+          fetch-depth: 0  # Required to get full history and tag message
 
       - name: Get tag name
         id: tag
@@ -26,12 +26,12 @@ jobs:
         id: tag_message
         run: |
           TAG_NAME=${GITHUB_REF#refs/tags/}
-          # Obtener el mensaje del tag anotado, o usar el nombre del tag si no hay mensaje
+          # Get annotated tag message, or use tag name if no message
           TAG_MESSAGE=$(git tag -l --format='%(contents)' "$TAG_NAME" 2>/dev/null || echo "")
           if [ -z "$TAG_MESSAGE" ]; then
             TAG_MESSAGE="Release $TAG_NAME"
           fi
-          # Preservar saltos de línea usando heredoc (no se necesita escape)
+          # Preserve newlines using heredoc (no escaping needed)
           {
             echo "MESSAGE<<EOF"
             echo "$TAG_MESSAGE"
@@ -42,23 +42,64 @@ jobs:
         id: version
         run: |
           TAG_NAME=${GITHUB_REF#refs/tags/}
-          # Remover el prefijo 'v' si existe
+          # Remove 'v' prefix if exists
           VERSION=${TAG_NAME#v}
           echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
 
+      - name: Get previous tag
+        id: previous_tag
+        run: |
+          TAG_NAME=${GITHUB_REF#refs/tags/}
+          # Get the previous tag (excluding the current one)
+          PREVIOUS_TAG=$(git tag -l 'v*' | sort -V | grep -B1 "^$TAG_NAME$" | grep -v "^$TAG_NAME$" | tail -1 || echo "")
+          if [ -z "$PREVIOUS_TAG" ]; then
+            # If no previous tag found, use the first commit
+            PREVIOUS_TAG=$(git rev-list --max-parents=0 HEAD 2>/dev/null || echo "")
+          fi
+          echo "PREVIOUS_TAG=$PREVIOUS_TAG" >> $GITHUB_OUTPUT
+          echo "Previous tag: $PREVIOUS_TAG"
+
+      - name: Get commits between tags
+        id: commits
+        run: |
+          TAG_NAME=${GITHUB_REF#refs/tags/}
+          PREVIOUS_TAG="${{ steps.previous_tag.outputs.PREVIOUS_TAG }}"
+          
+          if [ -n "$PREVIOUS_TAG" ]; then
+            # Get commits between previous tag and current tag
+            COMMITS=$(git log --pretty=format:"- %s (%h)" "$PREVIOUS_TAG..$TAG_NAME" 2>/dev/null || echo "")
+            if [ -n "$COMMITS" ]; then
+              echo "HAS_COMMITS=true" >> $GITHUB_OUTPUT
+              {
+                echo "COMMITS<<EOF"
+                echo "$COMMITS"
+                echo "EOF"
+              } >> $GITHUB_OUTPUT
+              echo "Found $(echo "$COMMITS" | wc -l) commits between $PREVIOUS_TAG and $TAG_NAME"
+            else
+              echo "HAS_COMMITS=false" >> $GITHUB_OUTPUT
+              echo "No commits found between $PREVIOUS_TAG and $TAG_NAME"
+            fi
+          else
+            echo "HAS_COMMITS=false" >> $GITHUB_OUTPUT
+            echo "No previous tag found, skipping commits"
+          fi
+
       - name: Get changelog entry
         id: changelog
         run: |
           VERSION="${{ steps.version.outputs.VERSION }}"
           CHANGELOG_FILE="docs/CHANGELOG.md"
-          
+
           if [ -f "$CHANGELOG_FILE" ]; then
-            # Buscar la sección del changelog para esta versión
-            # Busca líneas que empiecen con ## seguido de la versión (con o sin v)
-            CHANGELOG_ENTRY=$(awk "/^## \[?$VERSION\]?/ {flag=1; next} /^## \[?[0-9]/ {flag=0} flag" "$CHANGELOG_FILE" 2>/dev/null || echo "")
-            
+            # Search changelog section for this version
+            # Match patterns like: ## [0.0.4] or ## 0.0.4
+            # Escape dots in version for regex
+            VERSION_ESCAPED=$(echo "$VERSION" | sed 's/\./\\./g')
+            CHANGELOG_ENTRY=$(awk "/^## \[$VERSION_ESCAPED\]/ {flag=1; next} /^## \[?[0-9]/ {flag=0} flag" "$CHANGELOG_FILE" 2>/dev/null || echo "")
+
             if [ -n "$CHANGELOG_ENTRY" ]; then
-              # Preservar saltos de línea usando heredoc (no se necesita escape)
+              # Preserve newlines using heredoc (no escaping needed)
               echo "HAS_CHANGELOG=true" >> $GITHUB_OUTPUT
               {
                 echo "ENTRY<<EOF"
@@ -67,26 +108,165 @@ jobs:
               } >> $GITHUB_OUTPUT
             else
               echo "HAS_CHANGELOG=false" >> $GITHUB_OUTPUT
+              echo "Warning: No changelog entry found for version $VERSION" >&2
             fi
           else
             echo "HAS_CHANGELOG=false" >> $GITHUB_OUTPUT
+            echo "Warning: CHANGELOG file not found at $CHANGELOG_FILE" >&2
           fi
 
+      - name: Check if release exists and update if needed
+        id: check-existing
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const tagName = '${{ steps.tag.outputs.TAG_NAME }}';
+
+            try {
+              const { data: releases } = await github.rest.repos.listReleases({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                per_page: 100
+              });
+
+              const existingRelease = releases.find(r => r.tag_name === tagName);
+
+              if (existingRelease) {
+                const hasChangelog = (existingRelease.body || '').includes('## Changelog');
+                core.setOutput('exists', 'true');
+                core.setOutput('release_id', existingRelease.id.toString());
+                core.setOutput('has_changelog', hasChangelog ? 'true' : 'false');
+                console.log('Release ' + tagName + ' already exists (ID: ' + existingRelease.id + '), has changelog: ' + hasChangelog);
+              } else {
+                core.setOutput('exists', 'false');
+                console.log('Release ' + tagName + ' does not exist, will create new one');
+              }
+            } catch (error) {
+              console.log('Error checking existing releases:', error.message);
+              core.setOutput('exists', 'false');
+            }
+
+      - name: Update existing release
+        if: steps.check-existing.outputs.exists == 'true'
+        uses: actions/github-script@v7
+        env:
+          TAG_NAME: ${{ steps.tag.outputs.TAG_NAME }}
+          TAG_MESSAGE: ${{ steps.tag_message.outputs.MESSAGE }}
+          CHANGELOG_ENTRY: ${{ steps.changelog.outputs.ENTRY }}
+          COMMITS: ${{ steps.commits.outputs.COMMITS }}
+          HAS_CHANGELOG: ${{ steps.changelog.outputs.HAS_CHANGELOG }}
+          HAS_COMMITS: ${{ steps.commits.outputs.HAS_COMMITS }}
+          RELEASE_ID: ${{ steps.check-existing.outputs.release_id }}
+        with:
+          script: |
+            const releaseId = parseInt(process.env.RELEASE_ID);
+            const tagName = process.env.TAG_NAME;
+            const tagMessage = process.env.TAG_MESSAGE || '';
+            const changelogEntry = process.env.CHANGELOG_ENTRY || '';
+            const commits = process.env.COMMITS || '';
+            const hasChangelog = process.env.HAS_CHANGELOG === 'true';
+            const hasCommits = process.env.HAS_COMMITS === 'true';
+            const isPrerelease = tagName.includes('-alpha') || tagName.includes('-beta') || tagName.includes('-rc');
+
+            // Build release body - include tag message, changelog, and commits
+            let releaseBody = tagMessage;
+            
+            if (hasChangelog && changelogEntry) {
+              releaseBody += '\n\n## Changelog\n\n' + changelogEntry;
+              console.log('📝 Changelog entry found (' + changelogEntry.split('\n').length + ' lines)');
+            } else {
+              console.log('⚠️  No changelog entry found for version ' + tagName);
+            }
+            
+            if (hasCommits && commits) {
+              releaseBody += '\n\n## Commits\n\n' + commits;
+              console.log('📝 Commits found (' + commits.split('\n').length + ' commits)');
+            } else {
+              console.log('ℹ️  No commits found between tags');
+            }
+
+            try {
+              await github.rest.repos.updateRelease({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                release_id: releaseId,
+                body: releaseBody,
+                prerelease: isPrerelease,
+                make_latest: !isPrerelease  // Mark as latest if not prerelease
+              });
+              if (hasChangelog && changelogEntry) {
+                console.log('✅ Updated release ' + tagName + ' with complete changelog');
+              } else {
+                console.log('✅ Updated release ' + tagName + ' (no changelog available)');
+              }
+
+              // Verify latest status
+              if (!isPrerelease) {
+                console.log('✅ Release ' + tagName + ' marked as latest (make_latest: true)');
+              }
+            } catch (error) {
+              console.error('❌ Error updating release ' + tagName + ':', error.message);
+              throw error;
+            }
+
       - name: Create Release
-        uses: softprops/action-gh-release@v2
+        if: steps.check-existing.outputs.exists != 'true'
+        uses: actions/github-script@v7
+        env:
+          TAG_NAME: ${{ steps.tag.outputs.TAG_NAME }}
+          TAG_MESSAGE: ${{ steps.tag_message.outputs.MESSAGE }}
+          CHANGELOG_ENTRY: ${{ steps.changelog.outputs.ENTRY }}
+          COMMITS: ${{ steps.commits.outputs.COMMITS }}
+          HAS_CHANGELOG: ${{ steps.changelog.outputs.HAS_CHANGELOG }}
+          HAS_COMMITS: ${{ steps.commits.outputs.HAS_COMMITS }}
         with:
-          tag_name: ${{ steps.tag.outputs.TAG_NAME }}
-          name: Release ${{ steps.tag.outputs.TAG_NAME }}
-          body: |
-            ${{ steps.tag_message.outputs.MESSAGE }}
-            ${{ steps.changelog.outputs.HAS_CHANGELOG == 'true' && format('
-
-## Changelog
-
-{0}', steps.changelog.outputs.ENTRY) || '' }}
-          draft: false
-          prerelease: ${{ contains(steps.tag.outputs.TAG_NAME, '-alpha') || contains(steps.tag.outputs.TAG_NAME, '-beta') || contains(steps.tag.outputs.TAG_NAME, '-rc') }}
-          generate_release_notes: true  # GitHub generará notas automáticas basadas en los commits
+          script: |
+            const tagName = process.env.TAG_NAME;
+            const tagMessage = process.env.TAG_MESSAGE || '';
+            const changelogEntry = process.env.CHANGELOG_ENTRY || '';
+            const commits = process.env.COMMITS || '';
+            const hasChangelog = process.env.HAS_CHANGELOG === 'true';
+            const hasCommits = process.env.HAS_COMMITS === 'true';
+            const isPrerelease = tagName.includes('-alpha') || tagName.includes('-beta') || tagName.includes('-rc');
+
+            // Build release body - include tag message, changelog, and commits
+            let releaseBody = tagMessage;
+            
+            if (hasChangelog && changelogEntry) {
+              releaseBody += '\n\n## Changelog\n\n' + changelogEntry;
+              console.log('📝 Changelog entry found (' + changelogEntry.split('\n').length + ' lines), will include in release body');
+            } else {
+              console.log('⚠️  No changelog entry found for version ' + tagName);
+            }
+            
+            if (hasCommits && commits) {
+              releaseBody += '\n\n## Commits\n\n' + commits;
+              console.log('📝 Commits found (' + commits.split('\n').length + ' commits), will include in release body');
+            } else {
+              console.log('ℹ️  No commits found between tags');
+            }
+
+            try {
+              const { data: release } = await github.rest.repos.createRelease({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                tag_name: tagName,
+                name: 'Release ' + tagName,
+                body: releaseBody,
+                draft: false,
+                prerelease: isPrerelease,
+                make_latest: !isPrerelease,  // Explicitly mark as latest if not prerelease
+                generate_release_notes: false  // Don't generate auto notes, we have our own changelog
+              });
+              if (hasChangelog && changelogEntry) {
+                console.log('✅ Created release ' + tagName + ' with complete changelog' + (!isPrerelease ? ' (marked as latest)' : ''));
+              } else {
+                console.log('✅ Created release ' + tagName + ' (no changelog available)' + (!isPrerelease ? ' (marked as latest)' : ''));
+              }
+            } catch (error) {
+              console.error('❌ Error creating release ' + tagName + ':', error.message);
+              throw error;
+            }
 
 # Maintainer: Héctor Franco Aceituno (@HecFranco)
 # Organization: nowo-tech (https://github.com/nowo-tech)