docs: Fix ANSI escape sequences in pack CLI leaking into documentation (#891) (#940)

The get_pack_commands.go generator uses cobra/doc.GenMarkdownTreeCustom to produce markdown from the pack command tree. Some pack commands include ANSI color codes in their description strings (e.g.
\x1b[94m...\x1b[0m) to improve terminal --help readability. These codes were passing through the generator unmodified and appearing as noise in the rendered documentation.

Added a post-generation step that walks the output directory and strips SGR ANSI escape sequences (\x1b\[[0-9;]*m) from all generated .md files. This is the appropriate place to handle the conversion
— the generator is the boundary between terminal output and markdown, and stripping color codes there keeps the fix localized without affecting the upstream CLI's terminal experience.

Signed-off-by: Lorenzo Campanella <enzocampanella98@gmail.com>

Author: lcampanella98

tools/get_pack_commands.go

@@ -7,13 +7,16 @@ import (
 	"os"
 	"path"
 	"path/filepath"
+	"regexp"
 	"strings"
 
 	"github.com/buildpacks/pack/cmd"
 	"github.com/buildpacks/pack/pkg/logging"
 	"github.com/spf13/cobra/doc"
 )
 
+var ansiEscape = regexp.MustCompile(`\x1b\[[0-9;]*m`)
+
 const (
 	cliDir     = "/docs/for-platform-operators/how-to/integrate-ci/pack/cli/"
 	outputPath = "../content" + cliDir
@@ -64,6 +67,27 @@ func main() {
 	if err != nil {
 		log.Fatal(err)
 	}
+
+	if err := stripANSIFromDir(outputPath); err != nil {
+		log.Fatal(err)
+	}
+}
+
+func stripANSIFromDir(dir string) error {
+	return filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
+		if err != nil || info.IsDir() || filepath.Ext(path) != ".md" {
+			return err
+		}
+		data, err := os.ReadFile(path)
+		if err != nil {
+			return err
+		}
+		cleaned := ansiEscape.ReplaceAll(data, nil)
+		if len(cleaned) == len(data) {
+			return nil
+		}
+		return os.WriteFile(path, cleaned, info.Mode())
+	})
 }
 
 type packLogger struct {