forgegit 1.2.2 → 1.4.0

package/MANUAL.md

@@ -1,68 +1,61 @@
-cd "E:\MASTER\Proyectos\2026\Toolkit\Sys\forgeGit"
-
-$content = @'
-============================================================
-  forgeGit - MANUAL PERSONAL
-============================================================
-
-INSTALAR EN PC NUEVA (una sola vez)
-------------------------------------------------------------
-  npm install -g forgegit
-
-
-USAR EN UN PROYECTO NUEVO
-------------------------------------------------------------
-  cd ruta\del\proyecto
-  forge
-
-  Listo. El proyecto queda con Git + 7 helpers.
-
-
-COMANDOS DEL DIA A DIA
-------------------------------------------------------------
-  guardar.cmd     Commit cambios
-  subir.cmd       Push a GitHub
-  snapshots.cmd   Crear/restaurar copia de seguridad
-  historial.cmd   Ver commits recientes
-  auditar.cmd     Generar reporte diff
-  abrir.cmd       Abrir en VS Code
-  init.cmd        Re-bootstrap (raro, solo si rompes algo)
-
-
-ACTUALIZAR EL KIT (cuando hay version nueva)
-------------------------------------------------------------
-  npm install -g forgegit@latest
-
-  En cada proyecto existente:
-  forge update
-
-
-PUBLICAR NUEVA VERSION DEL KIT (yo, autor)
-------------------------------------------------------------
-  cd E:\MASTER\Proyectos\2026\Toolkit\Sys\forgeGit
-
-  1. Editar config.cmd y subir version (ej: 1.2.0 -> 1.3.0)
-  2. guardar.cmd      (mensaje: release 1.3.0)
-  3. subir.cmd
-  4. npm publish
-  5. tools\pack.cmd   (regenera dist)
-  6. git tag -a v1.3.0 -m "Version 1.3.0"
-  7. git push origin --tags
-  8. Subir ZIP a GitHub Releases
-
-
-LINKS UTILES
-------------------------------------------------------------
-  Repo:      https://github.com/vloitz/forgeGit
-  npm:       https://www.npmjs.com/package/forgegit
-  Releases:  https://github.com/vloitz/forgeGit/releases
-
-============================================================
-'@
-
-$utf8 = New-Object System.Text.UTF8Encoding($false)
-[System.IO.File]::WriteAllText("$PWD\MANUAL.txt", $content, $utf8)
-
-Write-Host "  [OK] MANUAL.txt creado" -ForegroundColor Green
-Write-Host ""
-Get-Item "MANUAL.txt" | Select-Object Name, Length
+# forgeGit - Manual de uso
+
+Guia completa de instalacion, uso y mantenimiento.
+
+## Instalacion
+
+    npm install -g forgegit
+
+O descarga el ZIP desde:
+https://github.com/vloitz/forgeGit/releases/latest
+
+Requisitos: Windows 10/11, Node.js 18+, Git 2.30+
+
+## Uso en un proyecto nuevo
+
+    cd ruta\del\proyecto
+    forge
+
+El proyecto queda con Git, .gitignore, README.md, commit inicial,
+tag v1.0.0 y 7 helpers en .forge/commands/.
+
+## Comandos disponibles
+
+| Comando | Descripcion |
+|---------|-------------|
+| 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 serve | Servidor de desarrollo (auto-detect) |
+| forge help | Ayuda completa |
+
+## Estructura del proyecto
+
+    MiProyecto/
+    ├── forge.cmd          Menu + CLI
+    ├── init.cmd           Bootstrap
+    ├── config.cmd         Configuracion
+    ├── .forge/
+    │   ├── commands/      6 helpers
+    │   ├── lib/           Modulos internos
+    │   ├── templates/     Fuentes .tpl
+    │   └── serve-static.js
+    └── (tus archivos)
+
+## Actualizar
+
+    npm install -g forgegit@latest
+    forge update
+
+## Links
+
+- Repo: https://github.com/vloitz/forgeGit
+- npm: https://www.npmjs.com/package/forgegit
+- Releases: https://github.com/vloitz/forgeGit/releases
+
+## Licencia
+
+MIT

package/README.md

@@ -1,26 +1,130 @@
-# forgeGit
-
-Proyecto inicializado con `init.cmd`.
-
-## Comandos
-
-### Esenciales
-- `init.cmd` — Bootstrap (una vez por proyecto)
-- `abrir.cmd` — Abrir en VS Code
-
-### Trabajo diario
-- `guardar.cmd` — Commit de cambios
-- `subir.cmd` — Push a GitHub
-- `historial.cmd` — Ver commits recientes
-
-### Ocasionales
-- `snapshots.cmd` — Crear/restaurar copias
-- `auditar.cmd` — Generar reporte diff
-
-### Internos (no ejecutar)
-- `config.cmd`, `lib/`, `templates/`
-
----
-
-Generado por forge-git v1.2.0 
- 
+# forgeGit
+
+Universal Git bootstrap kit for Windows.
+
+## What it is
+
+forgeGit is a small toolkit that eliminates the repetitive setup work
+of starting a new Git project. Instead of manually copying `.gitignore`,
+creating a README, making the first commit, and tagging a version,
+you run one command and the project is ready.
+
+Born from a real annoyance: copying the same 6 files into every new
+project, over and over, for years.
+
+## What it does
+
+Running `forge` in an empty folder:
+
+- Initializes a Git repository
+- Sets `main` as default branch
+- 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
+
+## 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) |
+
+## Install
+
+### Option A - npm (recommended)
+
+```cmd
+npm install -g forgegit
+```
+
+### Option B - GitHub Release
+
+Download the ZIP from:
+https://github.com/vloitz/forgeGit/releases/latest
+
+Extract anywhere. Run `tools\install.cmd` once.
+
+## Usage
+
+```cmd
+cd any\project\folder
+forge
+```
+
+The folder becomes a fully configured Git repository with helpers.
+
+## Global commands
+
+```cmd
+forge           Bootstrap current directory
+forge update    Sync templates from kit
+forge help      Show help
+```
+
+## Philosophy
+
+- **Idempotent**: safe to run multiple times, never overwrites user files
+- **Modular**: templates live in .tpl files, separated from logic
+- **Portable**: works in any Windows folder, any project type
+- **Configurable**: edit `config.cmd`, not the logic
+- **Self-documenting**: generates colored terminal output
+- **Batteries included**: snapshots, audit reports, tests
+
+## Structure
+
+```
+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)
+```
+
+## Requirements
+
+- Windows 10 or 11
+- Node.js 18+
+- Git 2.30+
+- VS Code CLI (optional, for `abrir.cmd`)
+
+## Status
+
+- Version: 1.2.2
+- Published: npm + GitHub Release
+- Tests: 14/14 passing
+- Platform: Windows only (Linux/Mac planned as Node.js CLI)
+
+## Roadmap
+
+See [FUTURE.md](FUTURE.md) for the plan to convert this into a
+cross-platform Node.js CLI (zero friction, no .cmd files in projects).
+
+## Links
+
+- Repository: https://github.com/vloitz/forgeGit
+- npm: https://www.npmjs.com/package/forgegit
+- Releases: https://github.com/vloitz/forgeGit/releases
+- Manual: [MANUAL.md](MANUAL.md)
+
+## License
+
+MIT

package/config.cmd

@@ -1,15 +1,15 @@
-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.2.0"
-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"
+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.4.0"
+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"