forgegit 1.5.7 → 1.5.9

package/.forge/config.cmd

@@ -1,15 +1,230 @@
-REM ============================================================
-REM   forge-git / config.cmd
-REM   Configuration - edit these values to customize
-REM   Called from init.cmd via: call config.cmd
-REM ============================================================
-
-set "FG_VERSION=1.5.6"
-set "TAG_INITIAL=v1.0.0"
-set "TAG_MESSAGE=Primera version estable"
-set "BRANCH_MAIN=main"
-set "COMMIT_MESSAGE=chore: initial commit"
-
-REM --- Exclusions for subir.cmd (robocopy) ---
-set "EXCLUDE_DIRS=.git versiones old_versions backup backups node_modules __pycache__ venv .venv env dist build out cache .cache .parcel-cache .vite .vscode .idea"
-set "EXCLUDE_FILES=*.log *.tmp *.bak *.orig Thumbs.db .DS_Store"
+# GRIDLOOCK Visual Engine — v0 (Rescate de Ideas)
+
+Documento de rescate del 2026-09-17. Captura las ideas clave de la
+conversacion con Gemini sobre visuales para sets de musica electronica
+y el problema de la memoria humana al disenar sistemas complejos.
+
+---
+
+## 1. PROBLEMA ORIGINAL
+
+- Sets de 36 tracks ≈ 36 cortometrajes.
+- Visuales de VJ tradicionales no representan lo que la musica expresa.
+- Hacer un video unico por track con IA es inviable (costo, consistencia).
+- Marca: GRIDLOOCK.
+- Objetivo: una imagen o miniatura que represente cada estado emocional
+  del set, NO cada track individual.
+
+### Ejes emocionales del set
+
+- PASADO:
+  - ancla_nostalgia: objeto especifico que ya no esta
+  - ancla_melancolia: bruma, caminar sin rumbo
+- PRESENTE:
+  - eje_nostalgia: el eco que aun flota pero no duele
+  - eje_melancolia: memoria colectiva procesandose en el beat
+  - eje_neutral: presencia pura, aqui y ahora sin carga
+- FUTURO:
+  - proyeccion_tunel: euforia, velocidad frontal, liberacion
+
+---
+
+## 2. SISTEMA DE FACTORES VISUALES
+
+### Factores iniciales
+
+| # | Factor | Opciones / Variables |
+|---|--------|----------------------|
+| 1 | Universalidad del Entorno | No-lugares (distritos financieros, tuneles, concreto, cristal) vs. entornos locales (Lima, bodegas, mototaxis) |
+| 2 | Fase Temporal | Sunrise, Sun, Sunset, Sundown, Night |
+| 3 | Perspectiva Psicologica | Seguimiento posterior / avatar, CCTV, silueta extrema, perfil introspectivo |
+| 4 | Direccion de Movimiento | Viaje (avanzando) vs. estatico (perfil/lateral) |
+| 5 | Lenguaje Corporal / Pose | Pose House, cruce de pies, brazos en suspension, caminata ritmica |
+| 6 | Dinamicas Humanas | Aislamiento absoluto, pareja, amigos, grupos dispersos, solo en multitud, osmosis social |
+| 7 | Vestimenta | Neutra/global (hoodie, beanie, jeans, mochila) vs. ajustes por subgenero |
+| 8 | Decoracion / Instalacion efimera | Parlantes, truss metalico, ground-stack, instalacion tactica |
+| 9 | Camara / Angulo | POV, seguimiento, picado, cenital, lateral |
+| 10 | Clima exterior | Lluvia, neblina, seco |
+| 11 | Cinematica de poses | Como se mueve el cuerpo segun el estado emocional |
+| 12 | Densidad humana | Solitario, grupos, masa, multitud |
+
+### Regla de separacion de responsabilidades
+
+- Factor 1: lienzo espacial (donde estamos)
+- Factor 6: quienes estan ahi
+- Factor 7: como se instalo la rave
+- Factor 8: como se mira
+
+NO se mezclan. Cada factor es independiente.
+
+---
+
+## 3. ARQUITECTURA DEL GENERADOR
+
+### Estructura JSON/YAML por factor
+
+Cada opcion dentro de un factor debe tener:
+
+- metadata
+- locked_core_prompt: prompt base inmutable
+- evolution_ideas[]: mejoras positivas
+- exclusions[]: errores que la IA no debe cometer
+
+### Dos niveles
+
+- GLOBAL: ideas/exclusiones que aplican a todo el factor
+- LOCAL: ideas/exclusiones especificas de una opcion
+
+### Conceptos clave
+
+- IDEAS ADITIVAS: mejoran sin romper la regla
+- EXCLUSIONES: prohiben errores tipicos de la IA
+- DESVIOS / OVERRIDES: excepciones explicitas a una regla global
+  (ej. "quiero que se parezca a Lima" aunque el factor sea universalidad)
+
+### Flujo
+
+1. Seleccionas opciones de cada factor
+2. El ensamblador compila un prompt maestro
+3. Ese prompt se le entrega a la IA generadora de imagenes
+
+---
+
+## 4. PROBLEMA DE LA MEMORIA HUMANA
+
+### El problema
+
+- La mente opera con ALTA ENTROPIA y SALTOS DE CONTEXTO
+- La memoria de trabajo se desborda (metafora del vaso con pelotitas)
+- Se pierde el hilo, se olvidan terminos tecnicos
+- Se depende de Ctrl+F para recuperar conceptos
+- La redundancia linguistica existe porque la memoria es limitada
+- Los terminos abstractos no tienen anclaje sensorial (no se huelen, no se ven, no se tocan), por eso se olvidan mas rapido
+
+### Ecuacion de sobrecarga
+
+    O = max(0, m - v - W)
+
+Donde:
+- O = sobrecarga
+- m = elementos mentales necesarios
+- v = elementos visibles en la interfaz
+- W = limite biologico de la memoria de trabajo
+
+Conclusion: necesitas externalizar memoria en una interfaz visual/persistente.
+
+---
+
+## 5. PROPUESTAS DE SOLUCION
+
+### HCI / UI Cognitiva
+
+- State Rail: panel persistente con parametros activos
+- Semantic Zoom y Ghost Layers: capas que muestran dependencias sin saturar
+- Scaffolded Friction: obligar al usuario a clasificar sus ideas en tiempo real
+- Reactive DAG: grafo aciclico dirigido para evitar bucles y permitir time-travel
+- SQLite WAL + @ts-check: persistencia local y validacion tipada
+- Neuroergonomia: adaptar la UI segun fatiga (adenosina, HRV, TEPR)
+
+### Mnemotecnia
+
+- Cubo-personaje: cubos 3x3 hasta 32x32 con patrones zigzag
+- Indexacion espaciotemporal 4D: ano, mes, dia, hora + colores y vectores
+- Sistemas narrativos: ano = personaje, mes = accion, dia = item, hora = ambiente
+- Simbolos ASCII, rotaciones, angulos, eliminacion de conectores gramaticales
+- Voice-to-node: dictado continuo, segmentacion semantica, nodos automaticos
+
+### Prompt de investigacion avanzada
+
+Ver archivos:
+- Investigacion HCI Alta Entropia.docx
+- Investigacion Arquitectura UI Cognitiva.docx
+
+---
+
+## 6. INVESTIGACIONES REALIZADAS
+
+### Investigacion 1: HCI Alta Entropia
+
+- Memoria de trabajo: 4-7 elementos simultaneos
+- State Rail, Semantic Zoom, Ghost Layers
+- Scaffolded Friction: NXS-SLICER de ideas
+- Grafos aciclicos dirigidos (DAG)
+- SQLite WAL, @ts-check, AST JSON
+
+### Investigacion 2: Arquitectura UI Cognitiva
+
+- Ecuacion de sobrecarga
+- Efecto cerradura de UIs conversacionales
+- Externalizacion dinamica (Orality, StepWrite)
+- Decodificacion restringida por gramatica (AST, JSON)
+- Neuroergonomia (TEPR, HRV)
+- Modulos: Ingesta Restringida, Gestor de Estado Topologico,
+  Bucle de Supervision Activa, Auditor Metacognitivo
+
+---
+
+## 7. PROYECTOS ANTIGUOS RELACIONADOS
+
+- Mnemotecnia Cubo-Personaje (motor grafico mental)
+- Diccionario de simbolos / compresion de lenguaje
+- Memoria virtual / mnemotecnia infinita
+
+---
+
+## 8. PROXIMOS PASOS (cuando se retome)
+
+### Corto plazo
+
+- Definir el primer factor de forma completa (JSON con metadata,
+  locked_core_prompt, evolution_ideas, exclusions)
+- Probar el ensamblaje manual en una IA generadora
+- Validar que la miniatura resultante represente el estado emocional
+
+### Medio plazo
+
+- Definir los 12 factores en JSON
+- Implementar el ensamblador (script local, sin IA en tiempo real)
+- Probar el flujo completo con un set real
+
+### Largo plazo
+
+- Resolver el primer pilar (memoria/externalizacion cognitiva)
+- Interfaz de captura de voz con segmentacion semantica
+- Integracion de mnemotecnia visual
+
+---
+
+## 9. FILOSOFIA DEL PROYECTO
+
+- La tecnica es el lenguaje, no el fin
+- La curaduria es narrativa temporal y emocional
+- El sistema debe permitir creatividad sin perderse en el caos
+- La redundancia es un sintoma de memoria limitada
+- La solucion no es "pensar menos", es "externalizar mejor"
+
+---
+
+## 10. LINKS Y REFERENCIAS
+
+- Investigacion HCI Alta Entropia.docx
+- Investigacion Arquitectura UI Cognitiva.docx
+- Mnemotecnia Cubo-Personaje (motor grafico mental)
+- ULTRA TOKEN JSON
+- Arquitectura De Ensamblaje De Prompts.docx
+
+---
+
+## NOTAS FINALES
+
+Este documento es un rescate de ideas del 2026-09-17.
+No es la version final. Es un snapshot para no olvidar.
+
+Cuando retomes el proyecto, empeza por el Factor 1 y el Factor 6.
+Son los pilares de todo el sistema.
+
+La investigacion cognitiva (primer pilar) queda pendiente.
+No es urgente. El motor visual se puede construir sin ella.
+
+Regla de oro: SIEMPRE separacion de responsabilidades.
+Cada factor hace una sola cosa. Nada mas.

package/MANUAL.md

@@ -17,12 +17,27 @@ Requisitos: Windows 10/11, Node.js 18+, Git 2.30+
     forge
 
 El proyecto queda con Git, .gitignore, README.md, commit inicial,
-tag v1.0.0 y 7 helpers en .forge/commands/.
+tag v1.0.0 y 8 helpers en .forge/commands/.
+
+## Uso en un proyecto existente
+
+Si el proyecto ya tiene forgeGit instalado:
+
+    cd ruta\del\proyecto
+    forge <comando>
+
+El comando global detecta el forge.cmd local y delega automaticamente.
 
 ## Comandos disponibles
 
 | Comando | Descripcion |
 |---------|-------------|
+| forge | Instala forgeGit en la carpeta actual |
+| forge update | Actualiza .forge/ desde el kit global |
+| forge version | Muestra la version instalada |
+| forge help | Ayuda completa |
+| forge init | Re-bootstrap (idempotente) |
+| forge init --force | Regenerar todo |
 | forge save | Commit de cambios |
 | forge push | Push a GitHub |
 | forge log | Ver commits recientes |
@@ -30,7 +45,6 @@ tag v1.0.0 y 7 helpers en .forge/commands/.
 | forge audit | Generar reporte diff |
 | forge open | Abrir en VS Code |
 | forge serve | Servidor de desarrollo (auto-detect) |
-| forge help | Ayuda completa |
 
 ## Estructura del proyecto
 
@@ -39,7 +53,7 @@ tag v1.0.0 y 7 helpers en .forge/commands/.
     |-- .forge/
     |   |-- init.cmd       Bootstrap
     |   |-- config.cmd     Configuracion
-    |   |-- commands/      7 helpers
+    |   |-- commands/      8 helpers
     |   |-- lib/           Modulos internos
     |   |-- templates/     Fuentes .tpl
     |   +-- serve-static.js
@@ -47,17 +61,212 @@ tag v1.0.0 y 7 helpers en .forge/commands/.
     |-- audits/            Reportes diff
     +-- (tus archivos)
 
+## Los 8 helpers
+
+| Helper | Descripcion |
+|--------|-------------|
+| save.cmd | Commit local de cambios |
+| push.cmd | Push a GitHub |
+| snapshots.cmd | Crear/restaurar snapshots |
+| historial.cmd | Ver commits recientes |
+| auditar.cmd | Generar reporte diff |
+| abrir.cmd | Abrir en VS Code |
+| serve.cmd | Servidor de desarrollo (auto-detect) |
+| init.cmd | Re-bootstrap (idempotente) |
+
 ## Actualizar
 
     npm install -g forgegit@latest
+    cd ruta\del\proyecto
     forge update
 
+## Actualizar el kit y un proyecto
+
+Actualizar el kit global:
+
+    npm install -g forgegit@latest
+
+Actualizar un proyecto especifico:
+
+    cd ruta\del\proyecto
+    forge update
+
+Esto copia forge.cmd y .forge/ desde el kit global al proyecto,
+sin tocar tus archivos ni los helpers pre-generados.
+
+## Desinstalar
+
+    npm uninstall -g forgegit
+
+## Filosofia
+
+- **Idempotente**: seguro de ejecutar multiples veces
+- **Modular**: templates en archivos .tpl
+- **Portable**: funciona en cualquier carpeta Windows
+- **Configurable**: editar .forge/config.cmd
+- **Autodocumentado**: salida de terminal con colores
+
 ## Links
 
 - Repo: https://github.com/vloitz/forgeGit
 - npm: https://www.npmjs.com/package/forgegit
 - Releases: https://github.com/vloitz/forgeGit/releases
+- Workflow IA: WORKFLOW.md
+- Roadmap: FUTURE.md
 
 ## Licencia
 
-MIT
+MIT
+```
+
+**Guardá con `Ctrl+S`.**
+
+---
+
+## 🎬 Fix 5 — `README.md`
+
+**En VS Code, abrí `README.md`.**
+
+**`Ctrl+H`** para Buscar/Reemplazar.
+
+### Reemplazo 1 — Versión
+
+**Buscar:**
+```
+- Version: 1.2.2
+```
+
+**Reemplazar:**
+```
+- Version: 1.5.8
+```
+
+### Reemplazo 2 — Tests
+
+**Buscar:**
+```
+- Tests: 14/14 passing
+```
+
+**Reemplazar:**
+```
+- Tests: 16/16 passing
+```
+
+### Reemplazo 3 — Estructura del proyecto
+
+**Buscar exactamente:**
+```
+forgeGit/
+├── init.cmd              Entry point (14 steps)
+├── config.cmd            Configuration values
+├── MANUAL.md             Full user manual
+├── FUTURE.md             Roadmap / ideas
+├── lib/                  Internal modules
+│   ├── ui.cmd            Terminal UI helpers
+│   ├── git-ops.cmd       Git operations
+│   └── templates.cmd     Template renderer
+├── templates/            Source templates (.tpl)
+├── tools/                Author tools
+│   ├── install.cmd       Install forge globally
+│   ├── uninstall.cmd     Uninstall forge
+│   ├── restore.cmd       Restore PATH from backup
+│   ├── pack.cmd          Build clean distribution
+│   ├── release.cmd       Build ZIP + open GitHub
+│   └── bin/forge.cmd     Global command
+└── tests/                Automated tests (14/14)
+```
+
+**Reemplazarlo exactamente por:**
+```
+forgeGit/
+├── forge.cmd             Menu + CLI (unico .cmd visible)
+├── .forge/               Infraestructura oculta
+│   ├── init.cmd          Bootstrap (17 pasos)
+│   ├── config.cmd        Configuration values
+│   ├── lib/              Internal modules
+│   ├── templates/        Source templates (.tpl)
+│   ├── commands/         8 helpers generados
+│   └── serve-static.js   Servidor Node
+├── MANUAL.md             Full user manual
+├── WORKFLOW.md           AI workflow rules
+├── README.md             This file
+├── tools/                Author tools
+│   ├── install.cmd       Install forge globally
+│   ├── uninstall.cmd     Uninstall forge
+│   ├── restore.cmd       Restore PATH from backup
+│   ├── pack.cmd          Build clean distribution
+│   ├── release.cmd       Build ZIP + open GitHub
+│   └── bin/forge.cmd     Global command
+└── tests/                Automated tests (16/16)
+```
+
+### Reemplazo 4 — Los 7 helpers
+
+**Buscar exactamente:**
+```
+## The 7 helpers
+
+| File | Purpose |
+|------|---------|
+| `guardar.cmd` | Commit changes locally |
+| `subir.cmd` | Push to GitHub |
+| `snapshots.cmd` | Create/restore full project snapshots |
+| `historial.cmd` | View recent commits |
+| `auditar.cmd` | Generate diff reports (for AI review) |
+| `abrir.cmd` | Open project in VS Code |
+| `init.cmd` | Re-bootstrap (idempotent) |
+```
+
+**Reemplazarlo exactamente por:**
+```
+## The 8 helpers
+
+| File | Purpose |
+|------|---------|
+| `save.cmd` | Commit changes locally |
+| `push.cmd` | Push to GitHub |
+| `snapshots.cmd` | Create/restore full project snapshots |
+| `historial.cmd` | View recent commits |
+| `auditar.cmd` | Generate diff reports (for AI review) |
+| `abrir.cmd` | Open project in VS Code |
+| `serve.cmd` | Dev server (auto-detect stack) |
+| `init.cmd` | Re-bootstrap (idempotent) |
+```
+
+### Reemplazo 5 — What it does
+
+**Buscar exactamente:**
+```
+- Generates 7 helper commands in the project
+```
+
+**Reemplazarlo exactamente por:**
+```
+- Generates 8 helper commands in `.forge/commands/`
+```
+
+### Reemplazo 6 — Global commands (sección)
+
+**Buscar exactamente:**
+```
+## Global commands
+
+```cmd
+forge           Bootstrap current directory
+forge update    Sync templates from kit
+forge help      Show help
+```
+```
+
+**Reemplazarlo exactamente por:**
+```
+## Global commands
+
+```cmd
+forge           Bootstrap current directory
+forge update    Sync .forge/ from kit
+forge version   Show version
+forge help      Show help
+```
+```

package/README.md

@@ -26,18 +26,19 @@ Running `forge` in an empty folder:
 - Creates a universal `.gitignore` (covers Node, Python, Rust, Go)
 - Generates an adaptive `README.md`
 - Creates initial commit + tag `v1.0.0`
-- Generates 7 helper commands in the project
+- Generates 8 helper commands in `.forge/commands/`
 
-## The 7 helpers
+## The 8 helpers
 
 | File | Purpose |
 |------|---------|
-| `guardar.cmd` | Commit changes locally |
-| `subir.cmd` | Push to GitHub |
+| `save.cmd` | Commit changes locally |
+| `push.cmd` | Push to GitHub |
 | `snapshots.cmd` | Create/restore full project snapshots |
 | `historial.cmd` | View recent commits |
 | `auditar.cmd` | Generate diff reports (for AI review) |
 | `abrir.cmd` | Open project in VS Code |
+| `serve.cmd` | Dev server (auto-detect stack) |
 | `init.cmd` | Re-bootstrap (idempotent) |
 
 ## Install
@@ -68,7 +69,8 @@ The folder becomes a fully configured Git repository with helpers.
 
 ```cmd
 forge           Bootstrap current directory
-forge update    Sync templates from kit
+forge update    Sync .forge/ from kit
+forge version   Show version
 forge help      Show help
 ```
 
@@ -85,15 +87,17 @@ forge help      Show help
 
 ```
 forgeGit/
-├── init.cmd              Entry point (14 steps)
-├── config.cmd            Configuration values
+├── forge.cmd             Menu + CLI (unico .cmd visible)
+├── .forge/               Infraestructura oculta
+│   ├── init.cmd          Bootstrap (17 pasos)
+│   ├── config.cmd        Configuration values
+│   ├── lib/              Internal modules
+│   ├── templates/        Source templates (.tpl)
+│   ├── commands/         8 helpers generados
+│   └── serve-static.js   Servidor Node
 ├── MANUAL.md             Full user manual
-├── FUTURE.md             Roadmap / ideas
-├── lib/                  Internal modules
-│   ├── ui.cmd            Terminal UI helpers
-│   ├── git-ops.cmd       Git operations
-│   └── templates.cmd     Template renderer
-├── templates/            Source templates (.tpl)
+├── WORKFLOW.md           AI workflow rules
+├── README.md             This file
 ├── tools/                Author tools
 │   ├── install.cmd       Install forge globally
 │   ├── uninstall.cmd     Uninstall forge
@@ -101,7 +105,7 @@ forgeGit/
 │   ├── pack.cmd          Build clean distribution
 │   ├── release.cmd       Build ZIP + open GitHub
 │   └── bin/forge.cmd     Global command
-└── tests/                Automated tests (14/14)
+└── tests/                Automated tests (16/16)
 ```
 
 ## Requirements
@@ -113,9 +117,9 @@ forgeGit/
 
 ## Status
 
-- Version: 1.2.2
+- Version: 1.5.8
 - Published: npm + GitHub Release
-- Tests: 14/14 passing
+- Tests: 16/16 passing
 - Platform: Windows only (Linux/Mac planned as Node.js CLI)
 
 ## Roadmap
@@ -132,4 +136,5 @@ cross-platform Node.js CLI (zero friction, no .cmd files in projects).
 
 ## License
 
-MIT
+MIT
+```

package/WORKFLOW.md

@@ -30,6 +30,103 @@ Toda instruccion para modificar codigo DEBE ser:
 2. Ubicacion exacta (busca / reemplaza / pega debajo)
 3. Sin ambiguedad
 
+---
+
+## Regla crítica: bloques VERBATIM
+
+### El problema
+
+La IA tiende a "limpiar" visualmente el código antes de darlo como
+bloque de búsqueda: quita líneas en blanco, normaliza espacios,
+reindenta. El humano busca ese bloque en VS Code con Ctrl+H y NO LO
+ENCUENTRA, porque el código real tiene 1 línea en blanco de más, o
+un espacio extra, o una indentación distinta.
+
+El humano pierde tiempo reportando el bloque actual, la IA da otro
+bloque "corregido" que también falla, y el ciclo se repite.
+
+### La regla
+
+Cuando la IA va a dar un bloque de búsqueda (Ctrl+H), DEBE usar el
+código EXACTO que el humano pegó en el chat, copiado carácter por
+carácter, incluyendo:
+
+- Líneas en blanco en su posición exacta
+- Indentación exacta (2 espacios, 4 espacios, tabs)
+- Espacios antes de llaves, después de comas, etc.
+- Saltos de línea donde estén
+- Comentarios tal cual
+
+La IA NO debe:
+- Quitar líneas en blanco "para que quede más limpio"
+- Reindentar "para que quede más legible"
+- Normalizar espacios "para que sea consistente"
+- Resumir el bloque si es largo
+- Omitir partes con "..." o "// resto igual"
+
+### Protocolo
+
+1. El humano pega en el chat la función o bloque completo (Ctrl+A
+   dentro del bloque, Ctrl+C, pegar en chat).
+
+2. La IA copia ese bloque VERBATIM en su respuesta, cambia SOLO
+   las líneas que hay que cambiar, y lo devuelve.
+
+3. Si la IA necesita modificar 3 líneas de 40, las otras 37 van
+   IDÉNTICAS, carácter por carácter, incluidas líneas en blanco
+   entre bloques lógicos.
+
+### Ejemplo de lo prohibido
+
+Humano pega:
+
+    function foo() {
+      const x = 1;
+
+      if (x) {
+        return true;
+      }
+    }
+
+IA responde (MAL, quitó línea en blanco):
+
+    Busca exactamente:
+    function foo() {
+      const x = 1;
+      if (x) {
+        return true;
+      }
+    }
+
+IA responde (BIEN, verbatim):
+
+    Busca exactamente:
+    function foo() {
+      const x = 1;
+
+      if (x) {
+        return true;
+      }
+    }
+
+### Si el bloque no matchea
+
+Si el humano reporta "busqué X, NO EXISTE, el código actual tiene Y":
+
+- La IA NO debe reescribir el bloque "adivinando" el formato.
+- La IA DEBE pedirle al humano que pegue el bloque actual completo.
+- La IA DEBE devolver el bloque nuevo usando ESE pegado como base,
+  verbatim.
+
+### Por qué esto importa
+
+El propósito de forgeGit es que los cambios sean trazables y
+reversibles. Si la IA formatea distinto, el bloque no matchea, el
+cambio se aplica a mano, se cometen typos, y la trazabilidad se
+pierde. Verbatim garantiza que busca/reemplaza funcione siempre.
+
+---
+
 ### Formato obligatorio para REEMPLAZAR
 
     Busca exactamente este codigo:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "forgegit",
-    "version": "1.5.7",
+    "version": "1.5.9",
     "description": "Universal Git bootstrap kit for Windows",
     "bin": {
         "forge": "./tools/bin/forge.cmd"

package/tests/test.cmd

@@ -4,7 +4,7 @@ chcp 65001 >nul 2>nul
 
 echo.
 echo   ============================================
-echo    forgeGit - Tests
+echo    forgeGit - Tests v1.5.8
 echo   ============================================
 echo.
 
@@ -25,47 +25,55 @@ echo   [TEST 1] Ejecutando forge...
 call "%FORGE_HOME%\tools\bin\forge.cmd" < nul >nul 2>nul
 
 REM Check archivos core
-if exist "init.cmd" (
-    echo     [OK] init.cmd creado
+if exist "forge.cmd" (
+    echo     [OK] forge.cmd creado
     set /a PASS+=1
 ) else (
-    echo     [X] init.cmd NO creado
+    echo     [X] forge.cmd NO creado
     set /a FAIL+=1
 )
 
-if exist "config.cmd" (
-    echo     [OK] config.cmd creado
+if exist ".forge\init.cmd" (
+    echo     [OK] .forge\init.cmd presente
     set /a PASS+=1
 ) else (
-    echo     [X] config.cmd NO creado
+    echo     [X] .forge\init.cmd NO presente
+    set /a FAIL+=1
+)
+
+if exist ".forge\config.cmd" (
+    echo     [OK] .forge\config.cmd presente
+    set /a PASS+=1
+) else (
+    echo     [X] .forge\config.cmd NO presente
     set /a FAIL+=1
 )
 
 REM Check 7 helpers
-for %%F in (guardar subir snapshots historial abrir auditar) do (
-    if exist "%%F.cmd" (
-        echo     [OK] %%F.cmd creado
+for %%F in (save push snapshots historial abrir auditar serve) do (
+    if exist ".forge\commands\%%F.cmd" (
+        echo     [OK] .forge\commands\%%F.cmd creado
         set /a PASS+=1
     ) else (
-        echo     [X] %%F.cmd NO creado
+        echo     [X] .forge\commands\%%F.cmd NO creado
         set /a FAIL+=1
     )
 )
 
 REM Check carpetas
-if exist "lib\ui.cmd" (
-    echo     [OK] lib\ui.cmd presente
+if exist ".forge\lib\ui.cmd" (
+    echo     [OK] .forge\lib\ui.cmd presente
     set /a PASS+=1
 ) else (
-    echo     [X] lib\ui.cmd NO presente
+    echo     [X] .forge\lib\ui.cmd NO presente
     set /a FAIL+=1
 )
 
-if exist "templates\abrir.cmd.tpl" (
-    echo     [OK] templates\abrir.cmd.tpl presente
+if exist ".forge\templates\abrir.cmd.tpl" (
+    echo     [OK] .forge\templates\abrir.cmd.tpl presente
     set /a PASS+=1
 ) else (
-    echo     [X] templates\abrir.cmd.tpl NO presente
+    echo     [X] .forge\templates\abrir.cmd.tpl NO presente
     set /a FAIL+=1
 )
 
@@ -95,29 +103,28 @@ echo.
 echo   [TEST 2] Ejecutando forge update...
 call "%FORGE_HOME%\tools\bin\forge.cmd" update < nul >nul 2>nul
 
-if exist "init.cmd" (
-    echo     [OK] init.cmd sigue presente
+if exist "forge.cmd" (
+    echo     [OK] forge.cmd sigue presente
     set /a PASS+=1
 ) else (
-    echo     [X] init.cmd desaparecio
+    echo     [X] forge.cmd desaparecio
     set /a FAIL+=1
 )
 
-REM ============================================================
-REM   TEST 3: forge detecta instalacion previa
-REM ============================================================
-echo.
-echo   [TEST 3] Ejecutando forge de nuevo (sin confirmar)...
-echo n | call "%FORGE_HOME%\tools\bin\forge.cmd" >nul 2>nul
-
-if exist "init.cmd" (
-    echo     [OK] init.cmd intacto tras cancelacion
+if exist ".forge\init.cmd" (
+    echo     [OK] .forge\init.cmd sigue presente
     set /a PASS+=1
 ) else (
-    echo     [X] init.cmd se corrompio
+    echo     [X] .forge\init.cmd desaparecio
     set /a FAIL+=1
 )
 
+REM ============================================================
+REM   TEST 3: omitido (delegacion interactiva no automatizable)
+REM ============================================================
+echo.
+echo   [TEST 3] Omitido (test manual requerido)
+
 REM ============================================================
 REM   CLEANUP
 REM ============================================================

package/tools/bin/forge.cmd

@@ -6,6 +6,14 @@ REM --- FORGE_HOME desde tools/bin/ ---
 for %%I in ("%~dp0..\..") do set "FORGE_HOME=%%~fI"
 set "TARGET=%CD%"
 
+REM --- Subcomandos propios del global (NO delegar) ---
+if /i "%~1"=="update"    goto :update
+if /i "%~1"=="help"      goto :help
+if /i "%~1"=="--help"    goto :help
+if /i "%~1"=="-h"        goto :help
+if /i "%~1"=="version"   goto :version
+if /i "%~1"=="--version" goto :version
+
 REM --- Deteccion de proyecto local ---
 REM Si existe forge.cmd en el directorio actual, delegar a el
 if exist "%TARGET%\forge.cmd" (
@@ -13,14 +21,6 @@ if exist "%TARGET%\forge.cmd" (
     exit /b %ERRORLEVEL%
 )
 
-REM --- Subcomandos ---
-if /i "%~1"=="update"  goto :update
-if /i "%~1"=="help"    goto :help
-if /i "%~1"=="--help"  goto :help
-if /i "%~1"=="-h"      goto :help
-if /i "%~1"=="version" goto :version
-if /i "%~1"=="--version" goto :version
-
 goto :install
 
 :version

package/tools/pack.cmd

@@ -6,7 +6,7 @@ cd /d "%~dp0"
 
 echo.
 echo   ============================================
-echo    Pack - Distribucion limpia
+echo    Pack - Distribucion limpia (v1.5.8)
 echo   ============================================
 echo.
 
@@ -18,28 +18,37 @@ REM --- Limpiar destino previo ---
 if exist "%DIST%" rmdir /s /q "%DIST%"
 
 mkdir "%OUT%"
-mkdir "%OUT%\lib"
-mkdir "%OUT%\templates"
+mkdir "%OUT%\.forge"
+mkdir "%OUT%\.forge\lib"
+mkdir "%OUT%\.forge\templates"
+mkdir "%OUT%\.forge\commands"
 mkdir "%OUT%\tools"
 mkdir "%OUT%\tools\bin"
 mkdir "%OUT%\tests"
 
 echo   Copiando archivos core...
-copy /Y "%ROOT%\init.cmd"   "%OUT%\" >nul
-copy /Y "%ROOT%\config.cmd" "%OUT%\" >nul
-copy /Y "%ROOT%\README.md"  "%OUT%\" >nul
+copy /Y "%ROOT%\forge.cmd"   "%OUT%\" >nul
+copy /Y "%ROOT%\README.md"   "%OUT%\" >nul
+copy /Y "%ROOT%\MANUAL.md"   "%OUT%\" >nul
+copy /Y "%ROOT%\WORKFLOW.md" "%OUT%\" >nul
 
-echo   Copiando modulos internos...
-copy /Y "%ROOT%\lib\*.cmd" "%OUT%\lib\" >nul
+echo   Copiando .forge/...
+copy /Y "%ROOT%\.forge\init.cmd"        "%OUT%\.forge\" >nul
+copy /Y "%ROOT%\.forge\config.cmd"      "%OUT%\.forge\" >nul
+copy /Y "%ROOT%\.forge\serve-static.js" "%OUT%\.forge\" >nul
 
-echo   Copiando templates...
-copy /Y "%ROOT%\templates\*.tpl" "%OUT%\templates\" >nul
+echo   Copiando .forge/lib/...
+copy /Y "%ROOT%\.forge\lib\*.cmd" "%OUT%\.forge\lib\" >nul
 
-echo   Copiando tools...
+echo   Copiando .forge/templates/...
+copy /Y "%ROOT%\.forge\templates\*.tpl" "%OUT%\.forge\templates\" >nul
+copy /Y "%ROOT%\.forge\templates\serve-static.js" "%OUT%\.forge\templates\" >nul
+
+echo   Copiando tools/...
 copy /Y "%ROOT%\tools\*.cmd" "%OUT%\tools\" >nul
 copy /Y "%ROOT%\tools\bin\*.cmd" "%OUT%\tools\bin\" >nul
 
-echo   Copiando tests...
+echo   Copiando tests/...
 copy /Y "%ROOT%\tests\*.cmd" "%OUT%\tests\" >nul
 
 echo.

package/tools/release.cmd

@@ -6,15 +6,15 @@ cd /d "%~dp0"
 
 echo.
 echo   ============================================
-echo    Release - Empaquetar y comprimir
+echo    Release - Empaquetar y comprimir (v1.5.8)
 echo   ============================================
 echo.
 
 REM --- 1. Pack ---
 call "%~dp0pack.cmd"
 
-REM --- 2. Leer version ---
-call "%~dp0..\config.cmd"
+REM --- 2. Leer version desde .forge/config.cmd ---
+call "%~dp0..\.forge\config.cmd"
 set "ZIP=%~dp0..\..\forgeGit-v%FG_VERSION%.zip"
 
 REM --- 3. Comprimir ---