forgegit 1.4.0 → 1.4.1

package/.forge/templates/gitignore.tpl

@@ -0,0 +1,78 @@
+# ==== Sistema operativo ====
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+*.lnk
+.DS_Store
+
+# ==== Editor / IDE ====
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# ==== Node.js ====
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+
+# ==== Python ====
+__pycache__/
+*.py[cod]
+.Python
+venv/
+.venv/
+env/
+.env
+
+# ==== Rust ====
+target/
+Cargo.lock
+
+# ==== Go ====
+*.test
+*.out
+
+# ==== Build / dist ====
+dist/
+build/
+out/
+.cache/
+.parcel-cache/
+.vite/
+
+# ==== Modelos / cache IA ====
+*.onnx
+*.bin
+*.wasm
+*.pb
+models/
+cache/
+.huggingface/
+
+# ==== Backups manuales ====
+versiones/
+old_versions/
+backup/
+backups/
+
+# ==== Reportes de auditoria ====
+audits/
+
+# ==== Temporales ====
+*.log
+*.tmp
+*.bak
+*.orig
+
+# ==== Capturas ====
+screenshots/
+capturas/
+test-output/

package/.forge/templates/historial.cmd.tpl

@@ -0,0 +1,85 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0..\.."
+
+REM --- Colores ANSI ---
+for /F %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"
+if "!ESC!"=="" (
+    set "C_CY=" & set "C_BC=" & set "C_GR=" & set "C_YE="
+    set "C_RE=" & set "C_GY=" & set "C_WH=" & set "C_RS="
+) else (
+    set "C_CY=!ESC![36m"  & set "C_BC=!ESC![96m"
+    set "C_GR=!ESC![32m"  & set "C_YE=!ESC![33m"
+    set "C_RE=!ESC![31m"  & set "C_GY=!ESC![90m"
+    set "C_WH=!ESC![97m"  & set "C_RS=!ESC![0m"
+)
+
+echo.
+echo   !C_CY!============================================!C_RS!
+echo   !C_BC! HISTORIAL!C_RS! !C_GY!- Vista rapida del proyecto!C_RS!
+echo   !C_CY!============================================!C_RS!
+echo.
+
+REM --- COMMITS ---
+if not exist ".git" (
+    echo   !C_RE![X]!C_RS! Sin repositorio Git.
+    goto :tags
+)
+
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+echo   !C_BC! ULTIMOS 20 COMMITS!C_RS!
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+echo   !C_GY! IDX    FECHA                 HASH      MENSAJE!C_RS!
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+
+git log -n 20 --date=format:"%%Y-%%m-%%d %%H:%%M:%%S" --pretty=format:"%%h %%ad %%s" > "%TEMP%\fgh_log.txt" 2>nul
+
+set "IDX=0"
+for /f "delims=" %%L in ('type "%TEMP%\fgh_log.txt"') do (
+    set "LINE=%%L"
+    set "HASH=!LINE:~0,7!"
+    set "DT=!LINE:~8,19!"
+    set "MSG=!LINE:~28!"
+    echo   !C_YE![!IDX!]!C_RS! !C_GY!!DT!!C_RS!  !C_YE!!HASH!!C_RS!  !C_WH!!MSG!!C_RS!
+    set /a IDX+=1
+)
+del "%TEMP%\fgh_log.txt" >nul 2>nul
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+echo.
+
+:tags
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+echo   !C_BC! TAGS!C_RS!
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+if exist ".git" git tag -l
+echo.
+
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+echo   !C_BC! SNAPSHOTS!C_RS!
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+if exist "versiones" goto :show_snaps
+echo   !C_GY!sin snapshots!C_RS!
+goto :end_snaps
+
+:show_snaps
+dir /b /o-n "versiones" 2>nul
+
+:end_snaps
+echo   !C_CY!-------------------------------------------------------------!C_RS!
+echo.
+
+call :shell_if_double_click
+endlocal
+exit /b 0
+
+:shell_if_double_click
+if "%NO_PAUSE%"=="1" goto :eof
+echo %cmdcmdline% | find /i "%~nx0" >nul
+if errorlevel 1 goto :eof
+echo.
+echo   !C_GY!Sesion interactiva. Escribe 'exit' para cerrar.!C_RS!
+echo.
+cmd /k
+goto :eof

package/.forge/templates/push.cmd.tpl

@@ -0,0 +1,97 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0..\.."
+
+REM --- Colores ANSI (con fallback) ---
+for /F %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"
+if "!ESC!"=="" (
+    set "C_CY=" & set "C_BC=" & set "C_GR=" & set "C_YE="
+    set "C_RE=" & set "C_GY=" & set "C_WH=" & set "C_RS="
+) else (
+    set "C_CY=!ESC![36m"  & set "C_BC=!ESC![96m"
+    set "C_GR=!ESC![32m"  & set "C_YE=!ESC![33m"
+    set "C_RE=!ESC![31m"  & set "C_GY=!ESC![90m"
+    set "C_WH=!ESC![97m"  & set "C_RS=!ESC![0m"
+)
+
+echo.
+echo   !C_CY!============================================!C_RS!
+echo   !C_BC! PUSH!C_RS! !C_GY!- Push a GitHub!C_RS!
+echo   !C_CY!============================================!C_RS!
+echo.
+
+if not exist ".git" (
+    echo   !C_RE![X]!C_RS! No hay repositorio Git. Ejecuta: !C_WH!init.cmd!C_RS!
+    call :shell_if_double_click
+    exit /b 1
+)
+
+git diff --cached --quiet
+set "STAGED=!ERRORLEVEL!"
+git diff --quiet
+set "UNSTAGED=!ERRORLEVEL!"
+
+if !STAGED! NEQ 0 goto :has_changes
+if !UNSTAGED! NEQ 0 goto :has_changes
+goto :check_remote
+
+:has_changes
+echo   !C_YE![!]!C_RS! Hay cambios sin commitear.
+echo.
+set "SAVE="
+set /p "SAVE=  !C_BC!Guardar cambios primero?!C_RS! !C_GY![S/n]!C_RS!: "
+if /i "!SAVE!"=="n" goto :check_remote
+echo.
+set "SKIP_HISTORIAL=1"
+set "NO_PAUSE=1"
+call "guardar.cmd"
+set "SKIP_HISTORIAL="
+set "NO_PAUSE="
+echo.
+
+:check_remote
+git remote get-url origin >nul 2>nul
+if errorlevel 1 (
+    echo   !C_RE![X]!C_RS! No hay remote 'origin' configurado.
+    echo.
+    echo   !C_GY!Para vincular tu repo a GitHub:!C_RS!
+    echo.
+    echo     !C_WH!git remote add origin https://github.com/TU-USUARIO/TU-REPO.git!C_RS!
+    echo.
+    call :shell_if_double_click
+    exit /b 1
+)
+
+echo   !C_GY!Subiendo a GitHub...!C_RS!
+echo.
+
+git push -u origin main --follow-tags
+set "RC=!ERRORLEVEL!"
+
+echo.
+if !RC! EQU 0 (
+    echo   !C_GR![OK]!C_RS! Push completado
+) else (
+    echo   !C_RE![ERROR]!C_RS! Push fallo con codigo !RC!
+)
+echo.
+
+set "NO_PAUSE=1"
+call "%~dp0historial.cmd"
+set "NO_PAUSE="
+
+call :shell_if_double_click
+endlocal
+exit /b 0
+
+:shell_if_double_click
+if "%NO_PAUSE%"=="1" goto :eof
+echo %cmdcmdline% | find /i "%~nx0" >nul
+if errorlevel 1 goto :eof
+echo.
+echo   !C_GY!Sesion interactiva. Escribe 'exit' para cerrar.!C_RS!
+echo.
+cmd /k
+goto :eof

package/.forge/templates/readme.md.tpl

@@ -0,0 +1,34 @@
+# {{PROJECT_NAME}}
+
+Proyecto inicializado con `forge.cmd`.
+
+## Estructura
+
+- `forge.cmd` - Menu interactivo + CLI
+- `.forge/` - Infraestructura (helpers, templates, lib)
+
+## Comandos
+
+### CLI directo
+
+    forge           Menu interactivo
+    forge save      Commit de cambios
+    forge push      Push a GitHub
+    forge log       Ver commits recientes
+    forge snap      Crear/restaurar snapshots
+    forge audit     Generar reporte diff
+    forge open      Abrir en VS Code
+    forge help      Ayuda completa
+
+### Helper scripts en .forge/commands/
+
+- save.cmd - Commit
+- push.cmd - Push a GitHub
+- snapshots.cmd - Backups
+- historial.cmd - Log
+- auditar.cmd - Reportes
+- abrir.cmd - VS Code
+
+---
+
+Generado por forge-git v{{FG_VERSION}}

package/.forge/templates/save.cmd.tpl

@@ -0,0 +1,73 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0..\.."
+
+for /F %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"
+if "!ESC!"=="" (
+    set "C_CY=" & set "C_BC=" & set "C_GR=" & set "C_YE="
+    set "C_RE=" & set "C_GY=" & set "C_WH=" & set "C_RS="
+) else (
+    set "C_CY=!ESC![36m"  & set "C_BC=!ESC![96m"
+    set "C_GR=!ESC![32m"  & set "C_YE=!ESC![33m"
+    set "C_RE=!ESC![31m"  & set "C_GY=!ESC![90m"
+    set "C_WH=!ESC![97m"  & set "C_RS=!ESC![0m"
+)
+
+if not exist ".git" (
+    echo   !C_RE![X]!C_RS! No hay repositorio Git. Ejecuta: !C_WH!init.cmd!C_RS!
+    exit /b 1
+)
+
+git add -A >nul 2>nul
+git diff --cached --quiet
+if not errorlevel 1 (
+    echo   !C_GY!Sin cambios para SAVE.!C_RS!
+    exit /b 0
+)
+
+echo.
+echo   !C_CY!------------------------------------------------------------!C_RS!
+echo   !C_BC! SAVE!C_RS! !C_GY!- Commit local!C_RS!
+echo   !C_CY!------------------------------------------------------------!C_RS!
+echo.
+echo   !C_GY!Archivos a SAVE:!C_RS!
+git diff --cached --name-only | findstr /n "^"
+echo.
+echo   !C_GY!Evita usar: " # : + / , en el mensaje!C_RS!
+echo.
+echo   !C_BC!Mensaje del commit!C_RS! !C_GY![Enter = Sin definir]!C_RS!
+set "MSG="
+set /p MSG=
+if "!MSG!"=="" set "MSG=Sin definir"
+
+git commit -q -m "!MSG!"
+if errorlevel 1 (
+    echo.
+    echo   !C_RE![X]!C_RS! Commit fallo. Revisa el mensaje.
+    exit /b 1
+)
+echo.
+echo   !C_GR![OK]!C_RS! Commit: !C_WH!!MSG!!C_RS!
+echo.
+
+if "%SKIP_HISTORIAL%"=="1" goto :skip_hist
+set "NO_PAUSE=1"
+call "%~dp0historial.cmd"
+set "NO_PAUSE="
+:skip_hist
+
+call :shell_if_double_click
+endlocal
+exit /b 0
+
+:shell_if_double_click
+if "%NO_PAUSE%"=="1" goto :eof
+echo %cmdcmdline% | find /i "%~nx0" >nul
+if errorlevel 1 goto :eof
+echo.
+echo   !C_GY!Sesion interactiva. Escribe 'exit' para cerrar.!C_RS!
+echo.
+cmd /k
+goto :eof

package/.forge/templates/serve-static.js

@@ -0,0 +1,86 @@
+// serve-static.js - Minimal static file server (no dependencies)
+// Usage: node serve-static.js [port] [root]
+
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+
+const PORT = parseInt(process.argv[2] || '8080', 10);
+const ROOT = path.resolve(process.argv[3] || process.cwd());
+
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.htm':  'text/html; charset=utf-8',
+    '.js':   'application/javascript; charset=utf-8',
+    '.mjs':  'application/javascript; charset=utf-8',
+    '.css':  'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.xml':  'application/xml; charset=utf-8',
+    '.txt':  'text/plain; charset=utf-8',
+    '.md':   'text/markdown; charset=utf-8',
+    '.png':  'image/png',
+    '.jpg':  'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif':  'image/gif',
+    '.svg':  'image/svg+xml',
+    '.webp': 'image/webp',
+    '.ico':  'image/x-icon',
+    '.wasm': 'application/wasm',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf':  'font/ttf',
+    '.mp4':  'video/mp4',
+    '.webm': 'video/webm',
+    '.mp3':  'audio/mpeg',
+    '.wav':  'audio/wav'
+};
+
+const server = http.createServer((req, res) => {
+    let urlPath;
+    try {
+        urlPath = decodeURIComponent(req.url.split('?')[0]);
+    } catch (e) {
+        res.writeHead(400); res.end('400 Bad Request'); return;
+    }
+
+    if (urlPath === '/') urlPath = '/index.html';
+
+    const filePath = path.resolve(path.join(ROOT, urlPath));
+
+    // Bloqueo de path traversal
+    if (!filePath.startsWith(ROOT)) {
+        res.writeHead(403); res.end('403 Forbidden'); return;
+    }
+
+    fs.readFile(filePath, (err, data) => {
+        if (err) {
+            res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+            res.end('404 Not Found: ' + urlPath);
+            return;
+        }
+        const ext = path.extname(filePath).toLowerCase();
+        res.writeHead(200, {
+            'Content-Type': MIME[ext] || 'application/octet-stream',
+            'Cache-Control': 'no-cache'
+        });
+        res.end(data);
+    });
+});
+
+server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+        console.error('[ERROR] Port ' + PORT + ' is already in use.');
+        process.exit(1);
+    }
+    console.error('[ERROR] ' + err.message);
+    process.exit(1);
+});
+
+server.listen(PORT, '127.0.0.1', () => {
+    console.log('');
+    console.log('  Serving ' + ROOT);
+    console.log('  -> http://localhost:' + PORT + '/');
+    console.log('');
+    console.log('  Press Ctrl+C to stop');
+    console.log('');
+});

package/.forge/templates/serve.cmd.tpl

@@ -0,0 +1,209 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0..\.."
+
+REM --- Colores ANSI ---
+for /F %%a in ('echo prompt $E ^| cmd') do set "ESC=%%a"
+if "!ESC!"=="" (
+    set "C_CY=" & set "C_BC=" & set "C_GR=" & set "C_YE="
+    set "C_RE=" & set "C_GY=" & set "C_WH=" & set "C_RS="
+) else (
+    set "C_CY=!ESC![36m"  & set "C_BC=!ESC![96m"
+    set "C_GR=!ESC![32m"  & set "C_YE=!ESC![33m"
+    set "C_RE=!ESC![31m"  & set "C_GY=!ESC![90m"
+    set "C_WH=!ESC![97m"  & set "C_RS=!ESC![0m"
+)
+
+echo.
+echo   !C_CY!============================================!C_RS!
+echo   !C_BC! SERVE!C_RS! !C_GY!- Iniciar servidor de desarrollo!C_RS!
+echo   !C_CY!============================================!C_RS!
+echo.
+
+REM ============================================================
+REM   DETECCION DE STACK
+REM ============================================================
+set "STACK="
+set "CMD="
+set "NEEDS_PYTHON=0"
+set "NEEDS_NODE=0"
+set "PORT="
+
+REM --- Node.js: package.json ---
+if exist "package.json" (
+    findstr /C:"\"dev\"" package.json >nul 2>nul
+    if not errorlevel 1 (
+        set "STACK=Node.js (npm run dev)"
+        set "CMD=npm run dev"
+        set "NEEDS_NODE=1"
+        goto :detected
+    )
+    findstr /C:"\"start\"" package.json >nul 2>nul
+    if not errorlevel 1 (
+        set "STACK=Node.js (npm start)"
+        set "CMD=npm start"
+        set "NEEDS_NODE=1"
+        goto :detected
+    )
+)
+
+REM --- Django ---
+if exist "manage.py" (
+    set "STACK=Django"
+    set "NEEDS_PYTHON=1"
+    call :find_free_port 8000
+    set "CMD=python manage.py runserver !PORT!"
+    goto :detected
+)
+
+REM --- Python simple ---
+if exist "app.py" (
+    set "STACK=Python (app.py)"
+    set "NEEDS_PYTHON=1"
+    set "CMD=python app.py"
+    goto :detected
+)
+if exist "main.py" (
+    set "STACK=Python (main.py)"
+    set "NEEDS_PYTHON=1"
+    set "CMD=python main.py"
+    goto :detected
+)
+
+REM --- Node.js simple (server.js) ---
+if exist "server.js" (
+    set "STACK=Node.js (server.js)"
+    set "NEEDS_NODE=1"
+    set "CMD=node server.js"
+    goto :detected
+)
+
+REM --- Rust ---
+if exist "Cargo.toml" (
+    set "STACK=Rust (cargo)"
+    set "CMD=cargo run"
+    goto :detected
+)
+
+REM --- Go ---
+if exist "go.mod" (
+    set "STACK=Go"
+    set "CMD=go run ."
+    goto :detected
+)
+
+REM --- Docker Compose ---
+if exist "docker-compose.yml" (
+    set "STACK=Docker Compose"
+    set "CMD=docker-compose up"
+    goto :detected
+)
+if exist "docker-compose.yaml" (
+    set "STACK=Docker Compose"
+    set "CMD=docker-compose up"
+    goto :detected
+)
+
+REM --- HTML estatico: NODE primero, PYTHON fallback ---
+if exist "index.html" (
+    call :find_free_port 8080
+    where node >nul 2>nul
+    if not errorlevel 1 (
+        set "STACK=HTML estatico (Node.js)"
+        set "NEEDS_NODE=1"
+        set "CMD=node .forge\serve-static.js !PORT!"
+        goto :detected
+    )
+    where python >nul 2>nul
+    if not errorlevel 1 (
+        set "STACK=HTML estatico (Python)"
+        set "NEEDS_PYTHON=1"
+        set "CMD=python -m http.server !PORT!"
+        goto :detected
+    )
+    echo   !C_RE![X]!C_RS! No hay Node.js ni Python para servir HTML.
+    echo   !C_GY!Instala Node.js: https://nodejs.org!C_RS!
+    echo   !C_GY!O Python:        https://python.org!C_RS!
+    pause
+    goto :end
+)
+
+REM --- No detectado ---
+echo   !C_YE![!]!C_RS! No se detecto stack automaticamente.
+echo.
+echo   !C_GY!Archivos buscados:!C_RS!
+echo     - package.json         Node.js
+echo     - manage.py            Django
+echo     - app.py / main.py     Flask / FastAPI
+echo     - server.js            Node.js simple
+echo     - Cargo.toml           Rust
+echo     - go.mod               Go
+echo     - docker-compose.yml   Docker
+echo     - index.html           HTML estatico
+echo.
+pause
+goto :end
+
+:detected
+REM --- Verificar dependencias ---
+if "!NEEDS_PYTHON!"=="1" (
+    where python >nul 2>nul
+    if errorlevel 1 (
+        echo   !C_RE![X]!C_RS! Python no esta instalado.
+        echo   !C_GY!Descarga: https://python.org!C_RS!
+        pause
+        goto :end
+    )
+)
+if "!NEEDS_NODE!"=="1" (
+    where node >nul 2>nul
+    if errorlevel 1 (
+        echo   !C_RE![X]!C_RS! Node.js no esta instalado.
+        echo   !C_GY!Descarga: https://nodejs.org!C_RS!
+        pause
+        goto :end
+    )
+)
+
+REM --- Mostrar info ---
+echo   !C_CY!-!C_RS! !C_GY!Stack:!C_RS!   !C_WH!!STACK!!C_RS!
+if not "!PORT!"=="" echo   !C_CY!-!C_RS! !C_GY!Puerto:!C_RS!  !C_WH!!PORT!!C_RS!
+echo   !C_CY!-!C_RS! !C_GY!Comando:!C_RS! !C_WH!!CMD!!C_RS!
+echo.
+
+REM --- Confirmar ---
+set "CONFIRM="
+set /p "CONFIRM=  !C_BC!Ejecutar servidor?!C_RS! !C_GY![S/n]!C_RS!: "
+if /i "!CONFIRM!"=="n" goto :end
+
+echo.
+echo   !C_GR!Iniciando servidor...!C_RS!
+echo   !C_GY!Ctrl+C para detener!C_RS!
+echo.
+
+REM --- Ejecutar ---
+!CMD!
+
+goto :end
+
+:end
+endlocal
+exit /b 0
+
+REM ============================================================
+REM   :find_free_port  - Encuentra puerto libre desde %1
+REM   Prueba %1, %1+1, ... hasta %1+20
+REM ============================================================
+:find_free_port
+set "PORT=%~1"
+set /a "MAX=%~1 + 20"
+:fp_loop
+netstat -an 2>nul | findstr ":!PORT! " >nul 2>nul
+if errorlevel 1 goto :fp_found
+set /a PORT+=1
+if !PORT! LEQ !MAX! goto :fp_loop
+set "PORT=%~1"
+:fp_found
+goto :eof