forgegit 1.2.0

package/tools/bin/forge.cmd

@@ -0,0 +1,141 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+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
+
+REM --- Default: install ---
+goto :install
+
+REM ============================================================
+REM   HELP
+REM ============================================================
+:help
+echo.
+echo   ============================================
+echo    forgeGit - Ayuda
+echo   ============================================
+echo.
+echo   USO:
+echo     forge               Instala forgeGit en la carpeta actual
+echo     forge update        Actualiza templates/core del kit
+echo     forge help          Esta ayuda
+echo.
+echo   QUE HACE:
+echo     - Copia init.cmd, config.cmd, lib/, templates/
+echo     - Ejecuta init.cmd automaticamente
+echo     - Deja el proyecto con 7 helpers listos
+echo.
+goto :end
+
+REM ============================================================
+REM   INSTALL
+REM ============================================================
+:install
+if /i "%TARGET%"=="%FORGE_HOME%" (
+    echo.
+    echo   [!] Estas dentro del kit forgeGit.
+    echo   [!] Ve a un proyecto nuevo y ejecuta: forge
+    echo.
+    exit /b 1
+)
+
+echo.
+echo   ============================================
+echo    forgeGit - Instalando en:
+echo    %TARGET%
+echo   ============================================
+echo.
+
+REM --- Safety: detectar instalacion previa ---
+if exist "%TARGET%\init.cmd" (
+    echo   [!] Ya existe init.cmd en este proyecto.
+    echo   [!] Puede ser de un forgeGit anterior.
+    echo.
+    set "CONFIRM="
+    set /p "CONFIRM=  Sobrescribir? [S/n]: "
+    if /i "!CONFIRM!"=="n" (
+        echo   Cancelado.
+        exit /b 0
+    )
+    echo.
+)
+
+if not exist "%TARGET%\lib" mkdir "%TARGET%\lib"
+if not exist "%TARGET%\templates" mkdir "%TARGET%\templates"
+
+copy /Y "%FORGE_HOME%\init.cmd"   "%TARGET%\" >nul
+copy /Y "%FORGE_HOME%\config.cmd" "%TARGET%\" >nul
+copy /Y "%FORGE_HOME%\lib\*.cmd"  "%TARGET%\lib\" >nul
+copy /Y "%FORGE_HOME%\templates\*.tpl" "%TARGET%\templates\" >nul
+
+echo   Archivos copiados desde forgeGit.
+echo.
+
+cd /d "%TARGET%"
+call "%TARGET%\init.cmd"
+
+goto :end
+
+REM ============================================================
+REM   UPDATE
+REM ============================================================
+:update
+if /i "%TARGET%"=="%FORGE_HOME%" (
+    echo.
+    echo   [!] Estas dentro del kit forgeGit.
+    echo   [!] No hay nada que actualizar aqui.
+    echo.
+    exit /b 1
+)
+
+if not exist "%TARGET%\init.cmd" (
+    echo.
+    echo   [X] Este proyecto no tiene forgeGit instalado.
+    echo       Ejecuta primero: forge
+    echo.
+    exit /b 1
+)
+
+echo.
+echo   ============================================
+echo    forgeGit - Actualizando
+echo    %TARGET%
+echo   ============================================
+echo.
+
+echo   Actualizando core (init.cmd, config.cmd)...
+copy /Y "%FORGE_HOME%\init.cmd"   "%TARGET%\" >nul
+copy /Y "%FORGE_HOME%\config.cmd" "%TARGET%\" >nul
+
+echo   Actualizando lib/...
+if not exist "%TARGET%\lib" mkdir "%TARGET%\lib"
+robocopy "%FORGE_HOME%\lib" "%TARGET%\lib" /E /NFL /NDL /NJH /NJS /NC /NS /NP >nul
+
+echo   Actualizando templates/...
+if not exist "%TARGET%\templates" mkdir "%TARGET%\templates"
+robocopy "%FORGE_HOME%\templates" "%TARGET%\templates" /E /NFL /NDL /NJH /NJS /NC /NS /NP >nul
+
+echo.
+echo   [OK] Actualizado.
+echo.
+echo   Nota: los helpers (guardar, subir, etc.) NO se
+echo         regeneran automaticamente.
+echo.
+echo   Para regenerarlos:
+echo     init.cmd --force
+echo.
+
+goto :end
+
+:end
+endlocal
+exit /b 0

package/tools/install.cmd

@@ -0,0 +1,141 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0"
+
+echo.
+echo   ============================================
+echo    forgeGit - Instalación (MODO SEGURO)
+echo   ============================================
+echo.
+
+for %%I in ("%~dp0..") do set "FORGE_HOME=%%~fI"
+set "BIN=%FORGE_HOME%\tools\bin"
+
+REM --- Verificar bin\forge.cmd ---
+if not exist "%BIN%\forge.cmd" (
+    echo   [X] No se encontro: %BIN%\forge.cmd
+    pause
+    exit /b 1
+)
+
+REM --- 1. Backup del PATH ---
+if not exist "backups" mkdir "backups"
+for /f %%i in ('powershell -NoProfile -Command "Get-Date -Format yyyy-MM-dd_HHmmss"') do set "TS=%%i"
+set "BACKUP=%CD%\backups\PATH_backup_%TS%.txt"
+
+echo   [1/6] Backup del PATH de usuario...
+powershell -NoProfile -Command ^
+    "$old = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($null -eq $old) { $old = '' };" ^
+    "[System.IO.File]::WriteAllText('%BACKUP%', $old, [System.Text.UTF8Encoding]::new($false));" ^
+    "Write-Host '  [OK] Backup guardado.';" ^
+    "Write-Host ('  Tamano: ' + $old.Length + ' caracteres');"
+echo.
+
+REM --- 2. Verificar que no este ya ---
+powershell -NoProfile -Command ^
+    "$old = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($null -eq $old) { $old = '' };" ^
+    "if ($old -like '*%BIN%*') { exit 0 } else { exit 1 }"
+
+if not errorlevel 1 (
+    echo   [2/6] Ya estaba instalado. Nada que hacer.
+    pause
+    exit /b 0
+)
+echo   [2/6] No estaba en el PATH. Continuando...
+echo.
+
+REM --- 3. Preview de los cambios ---
+echo   [3/6] Vista previa del cambio:
+echo.
+echo     PATH actual:
+powershell -NoProfile -Command ^
+    "$old = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($null -eq $old) { $old = '' };" ^
+    "$parts = $old -split ';' | Where-Object { $_ -ne '' };" ^
+    "Write-Host ('    ' + $parts.Count + ' entradas');"
+echo.
+echo     Se agregara:
+echo       %BIN%
+echo.
+set "CONFIRM="
+set /p "CONFIRM=  Continuar? [S/n]: "
+if /i "!CONFIRM!"=="n" (
+    echo   Cancelado.
+    pause
+    exit /b 0
+)
+echo.
+
+REM --- 4. Aplicar cambio con API (sin setx - sin limite 1024) ---
+echo   [4/6] Aplicando cambio...
+powershell -NoProfile -Command ^
+    "$old = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($null -eq $old) { $old = '' };" ^
+    "$new = if ($old -eq '') { '%BIN%' } else { $old + ';%BIN%' };" ^
+    "$oldCount = ($old -split ';' | Where-Object { $_ -ne '' }).Count;" ^
+    "$newCount = ($new -split ';' | Where-Object { $_ -ne '' }).Count;" ^
+    "if ($newCount -ne ($oldCount + 1)) {" ^
+    "    Write-Host '  [X] Validacion fallo (count no cambio).';" ^
+    "    exit 1;" ^
+    "}" ^
+    "[Environment]::SetEnvironmentVariable('Path', $new, 'User');" ^
+    "Write-Host '  [OK] PATH actualizado.';"
+
+if errorlevel 1 (
+    echo   [X] Fallo. Restaurando backup...
+    powershell -NoProfile -Command ^
+        "$content = [System.IO.File]::ReadAllText('%BACKUP%');" ^
+        "[Environment]::SetEnvironmentVariable('Path', $content, 'User');" ^
+        "Write-Host '  [OK] Restaurado.';"
+    pause
+    exit /b 1
+)
+echo.
+
+REM --- 5. Verificar el cambio ---
+echo   [5/6] Verificando...
+timeout /t 1 /nobreak >nul
+powershell -NoProfile -Command ^
+    "$new = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($new -like '*%BIN%*') {" ^
+    "    Write-Host '  [OK] forgeGit esta en el PATH.';" ^
+    "} else {" ^
+    "    Write-Host '  [X] No aparece. Restaurando...';" ^
+    "    $content = [System.IO.File]::ReadAllText('%BACKUP%');" ^
+    "    [Environment]::SetEnvironmentVariable('Path', $content, 'User');" ^
+    "    Write-Host '  [OK] Restaurado.';" ^
+    "    exit 1;" ^
+    "}"
+
+if errorlevel 1 (
+    pause
+    exit /b 1
+)
+echo.
+
+REM --- 6. Instrucciones ---
+echo   [6/6] Instalacion completada
+echo.
+echo   ============================================
+echo    Instalación exitosa
+echo   ============================================
+echo.
+echo   Cierra esta ventana y abre una NUEVA terminal.
+echo.
+echo   Uso:
+echo     cd C:\MiProyecto
+echo     forge
+echo.
+echo   Restaurar PATH anterior:
+echo     tools\restore.cmd
+echo.
+echo   Backup: %BACKUP%
+echo.
+
+pause
+endlocal
+exit /b 0

package/tools/pack.cmd

@@ -0,0 +1,57 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0"
+
+echo.
+echo   ============================================
+echo    Pack - Distribucion limpia
+echo   ============================================
+echo.
+
+set "ROOT=%~dp0.."
+set "DIST=%~dp0..\..\forgeGit-dist"
+set "OUT=%DIST%\forgeGit"
+
+REM --- Limpiar destino previo ---
+if exist "%DIST%" rmdir /s /q "%DIST%"
+
+mkdir "%OUT%"
+mkdir "%OUT%\lib"
+mkdir "%OUT%\templates"
+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
+
+echo   Copiando modulos internos...
+copy /Y "%ROOT%\lib\*.cmd" "%OUT%\lib\" >nul
+
+echo   Copiando templates...
+copy /Y "%ROOT%\templates\*.tpl" "%OUT%\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...
+copy /Y "%ROOT%\tests\*.cmd" "%OUT%\tests\" >nul
+
+echo.
+echo   ============================================
+echo    Distribucion creada en:
+echo    %OUT%
+echo   ============================================
+echo.
+echo   Contenido:
+echo.
+dir /b /s "%OUT%"
+echo.
+
+endlocal
+exit /b 0

package/tools/release.cmd

@@ -0,0 +1,53 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0"
+
+echo.
+echo   ============================================
+echo    Release - Empaquetar y comprimir
+echo   ============================================
+echo.
+
+REM --- 1. Pack ---
+call "%~dp0pack.cmd"
+
+REM --- 2. Leer version ---
+call "%~dp0..\config.cmd"
+set "ZIP=%~dp0..\..\forgeGit-v%FG_VERSION%.zip"
+
+REM --- 3. Comprimir ---
+echo   Comprimiendo v%FG_VERSION%...
+if exist "%ZIP%" del "%ZIP%" >nul 2>nul
+
+cd /d "%~dp0..\..\forgeGit-dist"
+powershell -NoProfile -Command "Compress-Archive -Path 'forgeGit' -DestinationPath '%ZIP%' -Force"
+
+if not exist "%ZIP%" (
+    echo   [X] Fallo al comprimir
+    pause
+    exit /b 1
+)
+
+for %%f in ("%ZIP%") do set "SIZE=%%~zf"
+
+echo.
+echo   ============================================
+echo    Release listo:
+echo    %ZIP%
+echo    Tamano: !SIZE! bytes
+echo   ============================================
+echo.
+echo   Siguiente:
+echo     1. Se abre GitHub Releases en tu navegador
+echo     2. Tag: v%FG_VERSION%
+echo     3. Attach: forgeGit-v%FG_VERSION%.zip
+echo     4. Publish
+echo.
+
+REM --- 4. Abrir navegador ---
+start "" "https://github.com/vloitz/forgeGit/releases/new"
+
+endlocal
+exit /b 0

package/tools/restore.cmd

@@ -0,0 +1,71 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0"
+
+echo.
+echo   ============================================
+echo    forgeGit - Restaurar PATH
+echo   ============================================
+echo.
+
+if not exist "backups" (
+    echo   [X] No hay carpeta backups\
+    pause
+    exit /b 1
+)
+
+echo   Backups disponibles:
+echo.
+set "IDX=0"
+for /f "delims=" %%F in ('dir /b /o-n "backups\PATH_backup_*.txt" 2^>nul') do (
+    echo     [!IDX!] %%F
+    set "BK_!IDX!=%%F"
+    set /a IDX+=1
+)
+
+if !IDX! EQU 0 (
+    echo   (vacio)
+    pause
+    exit /b 1
+)
+
+echo.
+set "SEL="
+set /p "SEL=  Numero a restaurar [0-!IDX!-1]: "
+if "!SEL!"=="" (
+    echo   Cancelado.
+    pause
+    exit /b 0
+)
+
+set "TARGET=!BK_%SEL%!"
+if "!TARGET!"=="" (
+    echo   [X] Numero invalido.
+    pause
+    exit /b 1
+)
+
+echo.
+echo   Restaurando: !TARGET!
+echo.
+set "CONFIRM="
+set /p "CONFIRM=  Escribe SI para confirmar: "
+if /i not "!CONFIRM!"=="SI" (
+    echo   Cancelado.
+    pause
+    exit /b 0
+)
+
+powershell -NoProfile -Command ^
+    "$content = [System.IO.File]::ReadAllText('backups\!TARGET!');" ^
+    "[Environment]::SetEnvironmentVariable('Path', $content, 'User');" ^
+    "Write-Host '  [OK] PATH restaurado.';"
+
+echo.
+echo   Cierra la terminal para aplicar los cambios.
+echo.
+pause
+endlocal
+exit /b 0

package/tools/uninstall.cmd

@@ -0,0 +1,54 @@
+@echo off
+setlocal EnableDelayedExpansion
+chcp 65001 >nul 2>nul
+
+cd /d "%~dp0"
+
+echo.
+echo   ============================================
+echo    forgeGit - Desinstalación (MODO SEGURO)
+echo   ============================================
+echo.
+
+for %%I in ("%~dp0..") do set "FORGE_HOME=%%~fI"
+set "BIN=%FORGE_HOME%\tools\bin"
+
+REM --- Backup ---
+if not exist "backups" mkdir "backups"
+for /f %%i in ('powershell -NoProfile -Command "Get-Date -Format yyyy-MM-dd_HHmmss"') do set "TS=%%i"
+set "BACKUP=%CD%\backups\PATH_backup_%TS%.txt"
+
+echo   [1/2] Backup del PATH actual...
+powershell -NoProfile -Command ^
+    "$old = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($null -eq $old) { $old = '' };" ^
+    "[System.IO.File]::WriteAllText('%BACKUP%', $old, [System.Text.UTF8Encoding]::new($false));" ^
+    "Write-Host '  [OK] Backup: %BACKUP%';"
+echo.
+
+echo   [2/2] Quitando forgeGit del PATH...
+powershell -NoProfile -Command ^
+    "$old = [Environment]::GetEnvironmentVariable('Path', 'User');" ^
+    "if ($null -eq $old) { $old = '' };" ^
+    "$parts = $old -split ';' | Where-Object { $_ -ne '%BIN%' -and $_ -ne '' };" ^
+    "$new = $parts -join ';';" ^
+    "$oldCount = ($old -split ';' | Where-Object { $_ -ne '' }).Count;" ^
+    "$newCount = ($new -split ';' | Where-Object { $_ -ne '' }).Count;" ^
+    "if ($newCount -eq ($oldCount - 1)) {" ^
+    "    setx PATH $new >nul;" ^
+    "    Write-Host '  [OK] Removido.';" ^
+    "} elseif ($newCount -eq $oldCount) {" ^
+    "    Write-Host '  [!] No estaba en el PATH.';" ^
+    "} else {" ^
+    "    Write-Host '  [X] Validacion fallo. Sin cambios.';" ^
+    "    exit 1;" ^
+    "}"
+
+echo.
+echo   Backup guardado en: %BACKUP%
+echo.
+echo   Cierra la terminal para aplicar.
+echo.
+pause
+endlocal
+exit /b 0