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.
This commit is contained in:
2026-04-12 13:54:15 +02:00
parent 61c9042392
commit 61d8460149
24 changed files with 1522 additions and 0 deletions
@@ -0,0 +1,44 @@
---
name: create_project_structure
kind: function
lang: bash
domain: shell
version: "1.0.0"
purity: impure
signature: "create_project_structure(project_name: string) -> void"
description: "Crea la estructura de directorios estándar de un proyecto funcional en el directorio indicado: database (attachments, data, models), dist (desktop/mobile/docker), docker, docs, frontend, logs, notebooks, robots, scripts, src (application/core/middleware con tests y tipos)."
tags: [bash, project, structure, scaffold, init]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
- name: project_name
desc: "nombre del proyecto o ruta destino donde crear la estructura (requerido)"
output: "crea los directorios a stdout con conteo final; exit code 1 si no se proporciona nombre"
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/shell/create_project_structure.sh"
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
source_license: "MIT"
source_file: "scripts/linux/inicializar_repos/functional_structure.sh"
---
## Ejemplo
```bash
source bash/functions/shell/create_project_structure.sh
# Crear estructura en un directorio nuevo
create_project_structure mi-proyecto
# Usar una ruta
create_project_structure /home/user/projects/nuevo-proyecto
```
## Notas
Crea 68 directorios organizados en la estructura funcional de DevLauncher. La estructura separa claramente application (orquestación), core (lógica pura) y middleware (efectos/I/O) bajo `src/`. No crea archivos, solo directorios. Idempotente: si los directorios ya existen, no falla.