Fix: Improve output formatting and release instructions

- Fix output formatting by sanitizing markdown code fences
- Improve text wrapping and display in formatter
- Add regex-based markdown cleanup in parser
- Enhance release instructions with better installation guide
- Prepare for v0.1.1 patch release

🤖 Generated with [Claude Code](https://claude.ai/code)

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

Author: barckcode

.github/workflows/releases.yml

@@ -34,14 +34,17 @@ jobs:
 
             **macOS/Linux:**
             ```bash
-            # Download the binary for your platform
-            curl -LO https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/kubectl-ai-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
+            # Detect platform
+            OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+            ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/;s/arm64/arm64/')
 
-            # Make it executable
-            chmod +x kubectl-ai-*
+            # Download and extract the tarball
+            curl -LO "https://github.com/helmcode/kubectl-ai/releases/download/${{ github.ref_name }}/kubectl-ai-${OS}-${ARCH}.tar.gz"
+            tar -xzf kubectl-ai-${OS}-${ARCH}.tar.gz
 
-            # Move to your PATH
-            sudo mv kubectl-ai-* /usr/local/bin/kubectl-ai
+            # Make it executable and move to your PATH
+            chmod +x kubectl-ai-${OS}-${ARCH}
+            sudo mv kubectl-ai-${OS}-${ARCH} /usr/local/bin/kubectl-ai
             ```
 
             **Windows:**

pkg/formatter/output.go

@@ -3,6 +3,7 @@ package formatter
 import (
 	"encoding/json"
 	"fmt"
+	"regexp"
 	"strings"
 
 	"github.com/fatih/color"
@@ -88,15 +89,15 @@ func displayHuman(analysis *model.Analysis) {
 			}
 
 			if suggestion.Explanation != "" {
-				fmt.Printf("      Why: %s\n", suggestion.Explanation)
+				fmt.Println(wrapText("Why: "+sanitizeText(suggestion.Explanation), 80, "      "))
 			}
 			fmt.Println()
 		}
 	}
 
 	if analysis.FullAnalysis != "" {
 		white.Println("📄 DETAILED ANALYSIS:")
-		fmt.Println(wrapText(analysis.FullAnalysis, 80, "   "))
+		fmt.Println(wrapText(sanitizeText(analysis.FullAnalysis), 80, "   "))
 		fmt.Println()
 	}
 	fmt.Println(strings.Repeat("─", 80))
@@ -146,6 +147,13 @@ func getPriorityIcon(priority string) string {
 	}
 }
 
+// sanitizeText removes markdown code fences to keep output clean
+func sanitizeText(text string) string {
+    // Remove ```json, ```yaml, ``` and matching closing fences
+    re := regexp.MustCompile("```[a-zA-Z]*\n|```")
+    return re.ReplaceAllString(text, "")
+}
+
 func wrapText(text string, width int, indent string) string {
 	var result strings.Builder
 	lines := strings.Split(text, "\n")

pkg/parser/debug.go

@@ -1,12 +1,19 @@
 package parser
 
-import "encoding/json"
+import (
+    "encoding/json"
+    "regexp"
+    "strings"
+)
 
 import "github.com/helmcode/kubectl-ai/pkg/model"
 
 func ParseDebugResponse(raw string, problem string) (*model.Analysis, error) {
+    // Remove markdown code fences if present
+    cleaned := stripFences(raw)
+
     var analysis model.Analysis
-    if err := json.Unmarshal([]byte(raw), &analysis); err != nil {
+    if err := json.Unmarshal([]byte(cleaned), &analysis); err != nil {
         // Fallback – could not parse JSON, embed entire text.
         analysis = model.Analysis{
             Problem:   problem,
@@ -28,5 +35,11 @@ func ParseDebugResponse(raw string, problem string) (*model.Analysis, error) {
     if analysis.Problem == "" {
         analysis.Problem = problem
     }
-    return &analysis, nil
+        return &analysis, nil
+}
+
+// stripFences removes markdown code fences such as ```json ... ``` so JSON can be parsed
+func stripFences(text string) string {
+    re := regexp.MustCompile("```[a-zA-Z]*\n|```")
+    return strings.TrimSpace(re.ReplaceAllString(text, ""))
 }