forgegit 1.5.6 → 1.5.8

package/.forge/config.cmd

@@ -4,7 +4,7 @@ REM   Configuration - edit these values to customize
 REM   Called from init.cmd via: call config.cmd
 REM ============================================================
 
-set "FG_VERSION=1.5.6"
+set "FG_VERSION=1.5.8"
 set "TAG_INITIAL=v1.0.0"
 set "TAG_MESSAGE=Primera version estable"
 set "BRANCH_MAIN=main"

package/MANUAL.md

@@ -1,3 +1,8 @@
+# 📄 `MANUAL.md` — Código Completo (v1.5.8)
+
+**En VS Code, abrí `MANUAL.md`, `Ctrl+A` → Suprimir → Pegá esto:**
+
+```markdown
 # forgeGit - Manual de uso
 
 Guia completa de instalacion, uso y mantenimiento.
@@ -17,12 +22,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 +50,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 +58,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 +66,216 @@ 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
+```
+```
+
+**Guardá con `Ctrl+S`.**
+
+---

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
@@ -85,15 +86,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 +104,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 +116,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

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.6",
+    "version": "1.5.8",
     "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,14 +6,21 @@ REM --- FORGE_HOME desde tools/bin/ ---
 for %%I in ("%~dp0..\..") do set "FORGE_HOME=%%~fI"
 set "TARGET=%CD%"
 
-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
+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" (
+    call "%TARGET%\forge.cmd" %*
+    exit /b %ERRORLEVEL%
+)
+
 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 ---