fix: scope argument-hint injection to YAML frontmatter only

Addresses Copilot review: the awk/regex matched description: anywhere
in the file. Now both bash and PowerShell track frontmatter boundaries
(--- delimiters) and only inject argument-hint after the first
description: inside the frontmatter block.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Quratulain-bilal

.github/workflows/scripts/create-release-packages.ps1

@@ -169,7 +169,28 @@ function Generate-Commands {
                 default         { '' }
             }
             if (-not [string]::IsNullOrEmpty($hint)) {
-                $body = $body -replace '(?m)^(description:.*)$', "`$1`nargument-hint: $hint"
+                # Scope injection to YAML frontmatter only (between first pair of ---)
+                $bodyLines = $body -split "`n"
+                $resultLines = @()
+                $fmDashCount = 0
+                $inFm = $false
+                $hintInjected = $false
+                foreach ($ln in $bodyLines) {
+                    if ($ln -match '^---$') {
+                        $resultLines += $ln
+                        $fmDashCount++
+                        $inFm = ($fmDashCount -eq 1)
+                        continue
+                    }
+                    if ($inFm -and -not $hintInjected -and $ln -match '^description:') {
+                        $resultLines += $ln
+                        $resultLines += "argument-hint: $hint"
+                        $hintInjected = $true
+                        continue
+                    }
+                    $resultLines += $ln
+                }
+                $body = $resultLines -join "`n"
             }
         }
 

.github/workflows/scripts/create-release-packages.sh

@@ -121,7 +121,14 @@ generate_commands() {
       esac
       if [[ -n "$hint" ]]; then
         body=$(printf '%s\n' "$body" | awk -v hint="$hint" '
-          /^description:/ { print; print "argument-hint: " hint; next }
+          /^---$/ {
+            print
+            if (++dash_count == 1) { in_fm = 1 } else { in_fm = 0 }
+            next
+          }
+          in_fm && !injected && /^description:/ {
+            print; print "argument-hint: " hint; injected = 1; next
+          }
           { print }
         ')
       fi