feat: add bash shell utility functions

12 funciones Bash del dominio shell: utilidades de scripting (bash_log,
bash_colors, bash_check_deps, bash_confirm, bash_handle_error, bash_safe_run),
manipulacion de texto (convert_text_case), estructura de proyectos
(create_project_structure), y operaciones git (git_clean_branches,
git_log_visual, git_push_all_remotes, git_repo_status). Cada una con su
.sh y .md de frontmatter.

bash/functions/shell/bash_safe_run.md

@@ -0,0 +1,52 @@
+---
+name: bash_safe_run
+kind: function
+lang: bash
+domain: shell
+version: "1.0.0"
+purity: impure
+signature: "safe_run(cmd: string, [error_code: string], [error_desc: string]) -> void; setup_error_trap() -> void; error_trap_handler(exit_code: int, line_number: int) -> void"
+description: "Ejecuta comandos con manejo de errores integrado. Incluye trap handler que captura fallos con numero de linea y codigo de salida."
+tags: [bash, safe, run, error, trap, handler]
+uses_functions: [bash_log_bash_shell]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: []
+params:
+  - name: cmd
+    desc: "comando a ejecutar via eval"
+  - name: error_code
+    desc: "codigo identificador del error en caso de fallo; default COMMAND_FAILED"
+  - name: error_desc
+    desc: "descripcion del error a mostrar; default 'El comando fallo: CMD'"
+output: "exit code 0 si el comando tuvo exito; exit code 1 con mensaje de error formateado si fallo"
+tested: false
+tests: []
+test_file_path: ""
+file_path: "bash/functions/shell/bash_safe_run.sh"
+source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
+source_license: "MIT"
+source_file: "scripts/lib/common.sh"
+---
+
+## Ejemplo
+
+```bash
+source bash/functions/shell/bash_safe_run.sh
+bash_log_init
+setup_error_trap
+
+safe_run "go build ./..." "BUILD_FAILED" "La compilacion fallo"
+safe_run "docker compose up -d" "DOCKER_FAILED" "No se pudo iniciar Docker Compose"
+safe_run "npm install" "NPM_FAILED"
+```
+
+## Notas
+
+`safe_run` usa `eval` internamente para ejecutar el comando, lo que permite pasar comandos con pipes y redirecciones como string. Usar con precaucion en entornos con input no confiable.
+
+`setup_error_trap` instala un trap `ERR` que llama a `error_trap_handler` automaticamente en cualquier comando fallido del script, mostrando numero de linea y codigo de salida.
+
+`error_trap_handler` no llama a `exit` — el caller decide si continuar o abortar. Muestra la ruta al log para debugging.