feat: add Go extract_script_description function

Funcion Go pura del dominio shell que extrae la descripcion de un script Bash parseando el header del archivo. Busca comentarios con formato estandar y retorna la primera linea de descripcion encontrada. Util para indexar scripts automaticamente.
2026-04-12 13:54:48 +02:00
parent ab7317b0c0
commit 93ef4b8010
2 changed files with 94 additions and 0 deletions
@@ -0,0 +1,46 @@
+---
+name: extract_script_description
+kind: function
+lang: go
+domain: shell
+version: "1.0.0"
+purity: impure
+signature: "func ExtractScriptDescription(scriptPath string) string"
+description: "Parsea un archivo de script y extrae la primera linea de comentario util como descripcion. Salta shebangs y lineas vacias. Si no encuentra descripcion, usa el nombre del archivo."
+tags: [shell, script, description, parse, comment, metadata]
+uses_functions: []
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [bufio, os, path/filepath, strings]
+params:
+  - name: scriptPath
+    desc: "ruta al archivo de script (.sh, .ps1, .bat)"
+output: "descripcion extraida del primer comentario, o nombre del archivo humanizado"
+tested: false
+tests: []
+test_file_path: ""
+file_path: "functions/shell/extract_script_description.go"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
+source_license: "MIT"
+source_file: "launcher/middleware/reader.go"
+---
+
+## Ejemplo
+
+```go
+// Dado un script con:
+// #!/bin/bash
+// # Analisis completo de DNS para un dominio
+desc := shell.ExtractScriptDescription("/path/to/analisis_dns.sh")
+// desc == "Analisis completo de DNS para un dominio"
+
+// Sin comentario util
+desc2 := shell.ExtractScriptDescription("/path/to/instalar_go.sh")
+// desc2 == "instalar go" (fallback del nombre)
+```
+
+## Notas
+
+Busca en las primeras 5 lineas. Remueve prefijos comunes como "Script:", "Descripción:", "Description:" del comentario. Si el archivo no existe o no tiene comentarios utiles, genera una descripcion a partir del nombre del archivo reemplazando underscores por espacios.