create-harness-btp 0.2.0 → 0.2.1

package/AI/VERSION

@@ -0,0 +1 @@
+0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # harness-btp
 
-[![version](https://img.shields.io/badge/version-v0.2.0-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.0)
+[![version](https://img.shields.io/badge/version-v0.2.1-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.1)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![platform](https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-lightgrey)](https://github.com/horangelmillan/harness-btp)
 [![agent](https://img.shields.io/badge/agent-any%20AGENTS.md--compatible-purple)](https://github.com/horangelmillan/harness-btp)
@@ -15,6 +15,7 @@ Para quien construye MVPs SAP BTP y quiere empezar cada proyecto con el mismo fl
 - [Requisitos](#requisitos)
 - [Quickstart](#quickstart)
 - [Instalación](#instalación)
+- [Instalación asistida por agente](#instalación-asistida-por-agente)
 - [Actualizar y desinstalar](#actualizar-y-desinstalar)
 - [Adaptadores opcionales](#adaptadores-opcionales)
 - [Estructura del repo](#estructura-del-repo)
@@ -54,7 +55,7 @@ El camino de 30 segundos en un proyecto nuevo. Elige tu shell:
 PowerShell (Windows):
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.0 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -62,7 +63,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash (Linux, macOS o Git Bash):
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.0 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -78,7 +79,7 @@ Descarga solo lo necesario, sin historial git:
 PowerShell:
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.0 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -86,7 +87,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.0 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -98,7 +99,7 @@ Clon superficial anclado al tag:
 PowerShell:
 
 ```powershell
-git clone --branch v0.2.0 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
+git clone --branch v0.2.1 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -106,7 +107,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-git clone --branch v0.2.0 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
+git clone --branch v0.2.1 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -116,7 +117,7 @@ rm -rf AI-tmp
 Sin descargas manuales (requiere publicar `create-harness-btp` en el registry). Igual en todos los SO:
 
 ```bash
-pnpm dlx create-harness-btp --dest .
+pnpm dlx create-harness-btp@0.2.1 --dest .
 ```
 
 ### Qué hace el instalador
@@ -131,7 +132,15 @@ Salida típica en proyecto nuevo:
 ```text
 CREATE: AI/
 CREATE: AGENTS.md
-OK: harness v0.2.0 instalado
+OK: harness v0.2.1 instalado
+```
+
+## Instalación asistida por agente
+
+Si prefieres que tu agente lo instale por ti, pégale este bloque:
+
+```text
+Pégale esto a tu agente: Instala el harness BTP versión 0.2.1 en la raíz del proyecto: 1) Lee el README del repo harness-btp (opción pnpm). 2) Ejecuta EXACTAMENTE pnpm dlx create-harness-btp@0.2.1 --dest . (sin --force salvo que AI/ ya exista y yo lo autorice; con --force verifica BACKUP primero). 3) PROHIBIDO pisar o borrar: AGENTS.md raíz existente, package.json, mta.yaml, lockfiles. 4) Verifica lo INSTALADO (no vale pnpm view): AI/VERSION debe decir 0.2.1. 5) Si migraste npm→pnpm con import+install+test en verde, borra package-lock.json. 6) Corre AI/scripts/check-prereqs y reporta faltantes. 7) Si hay placeholders por adaptar, dímelos antes de desplegar. Sin secretos en el reporte. Repórtame: comando, salida del instalador, contenido de AI/VERSION, git status y pendientes.
 ```
 
 ## Actualizar y desinstalar
@@ -141,7 +150,7 @@ OK: harness v0.2.0 instalado
 PowerShell:
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.0 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest . -Force
 Remove-Item -Recurse -Force AI-tmp
 # tu versión anterior queda en AI.bak por si quieres comparar
@@ -150,7 +159,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.0 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest . --force
 rm -rf AI-tmp
 # tu versión anterior queda en AI.bak por si quieres comparar
@@ -202,7 +211,7 @@ harness-btp/
 ├── install.ps1 / install.sh   # instaladores idempotentes (SKIP / CREATE / BACKUP / OK)
 ├── bin/                       # ejecutable de create-harness-btp (pnpm dlx)
 ├── package.json               # name create-harness-btp
-└── VERSION                    # 0.2.0
+└── VERSION                    # 0.2.1
 ```
 
 ## Cómo lo descubre el agente
@@ -223,7 +232,7 @@ Tú no configuras nada: el agente se adapta solo.
 | Líneas duplicadas en `.gitignore` | edición manual tras la fusión | el instalador fusiona sin duplicar; borra el duplicado a mano |
 | `ExecutionPolicy` bloquea `install.ps1` | política de PowerShell | `powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .` (o usa `install.sh` en Git Bash) |
 | `ABORT: opción desconocida` en `install.sh` | flag inexistente | `sh install.sh --help` lista `--dest`, `--force` |
-| `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.2.0` |
+| `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.2.1` |
 | Tu cliente no lee los agentes de `.opencode/` | layout específico de OpenCode | son un adapter opcional; el flujo está en `AI/AGENTS.md` + `AI/INICIO.md` |
 
 ## Compatibilidad
@@ -242,7 +251,7 @@ Matriz honesta cliente × SO (`verificado` = probado con evidencia; `esperado` =
 
 - Abre un issue antes que un PR si el cambio afecta reglas o scripts.
 - PRs pequeños, en español, con evidencia del comando corrido.
-- Versionado semver: los cambios se publican como tags `vX.Y.Z` (`VERSION` + `package.json` + tag git coinciden).
+- Versionado semver: los cambios se publican como tags `vX.Y.Z` (`package.json` + `VERSION` + `AI/VERSION` + tag git coinciden; el workflow lo verifica).
 
 ## Licencia
 
@@ -250,4 +259,5 @@ MIT. Haz lo que quieras con el harness; sin garantía.
 
 ## Changelog
 
+- **v0.2.1** — trazabilidad y versión visible: `AI/VERSION` viaja en el paquete, los instaladores imprimen la versión (`OK: harness vX.Y.Z…`, `BACKUP` con vieja→nueva) y el workflow exige que `package.json`, `VERSION` y `AI/VERSION` coincidan. Comandos fijados a `@0.2.1` / `#v0.2.1` / `--branch v0.2.1`.
 - **v0.2.0** — versión inicial: carpeta `AI/` parametrizada, instaladores idempotentes `install.ps1` / `install.sh`, `create-harness-btp` vía `pnpm dlx`, plantilla de puntero, docs de flujo / cf-safe / habilitación trial, plantilla de spec.

package/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

package/bin/harness-btp.js

@@ -29,22 +29,28 @@ if (!fs.existsSync(path.join(src, "AI"))) {
   console.log("ABORT: no se encontró AI/ junto al paquete");
   process.exit(1);
 }
+function readVer(p) {
+  try {
+    return fs.readFileSync(p, "utf8").split(/\r?\n/)[0].trim() || "desconocida";
+  } catch { return "desconocida"; }
+}
+const harnessVersion = readVer(path.join(src, "AI", "VERSION"));
 
 const aiDst = path.join(dest, "AI");
 if (fs.existsSync(aiDst)) {
   if (force) {
+    const oldVersion = readVer(path.join(aiDst, "VERSION"));
     const bak = path.join(dest, "AI.bak");
     fs.rmSync(bak, { recursive: true, force: true });
     fs.renameSync(aiDst, bak);
-    console.log("BACKUP: AI/ -> AI.bak");
     fs.cpSync(path.join(src, "AI"), aiDst, { recursive: true });
-    console.log("CREATE: AI/ (reinstalado con --force)");
+    console.log("BACKUP: AI/ (v" + oldVersion + ") -> AI.bak; CREATE: AI/ (v" + harnessVersion + ")");
   } else {
     console.log("SKIP: AI/ ya existe (usa --force para reinstalar con backup .bak)");
   }
 } else {
   fs.cpSync(path.join(src, "AI"), aiDst, { recursive: true });
-  console.log("CREATE: AI/");
+  console.log("CREATE: AI/ (v" + harnessVersion + ")");
 }
 
 const agentsDst = path.join(dest, "AGENTS.md");
@@ -67,4 +73,4 @@ if (missing.length === 0) {
   fs.appendFileSync(giDst, (cur.length ? "" : "") + missing.join("\n") + "\n");
   console.log("CREATE: .gitignore (+" + missing.length + " líneas)");
 }
-console.log("OK: harness instalado en " + dest + " (package.json y mta.yaml intactos)");
+console.log("OK: harness v" + harnessVersion + " instalado en " + dest + " (package.json y mta.yaml intactos)");

package/install.ps1

@@ -16,21 +16,29 @@ $TplPointer = Join-Path $Src "templates\AGENTS.pointer.md"
 
 if (-not (Test-Path $AiSrc)) { Write-Output "ABORT: no se encontró AI/ junto a install.ps1"; exit 1 }
 
+$HarnessVersion = "desconocida"
+$VersionFile = Join-Path $AiSrc "VERSION"
+if (Test-Path $VersionFile) { $HarnessVersion = ((Get-Content $VersionFile | Select-Object -First 1) + "").Trim() }
+if (-not $HarnessVersion) { $HarnessVersion = "desconocida" }
+
 $AiDst = Join-Path $Dest "AI"
 if (Test-Path $AiDst) {
   if ($Force) {
+    $OldVersion = "desconocida"
+    $DstVersionFile = Join-Path $AiDst "VERSION"
+    if (Test-Path $DstVersionFile) { $OldVersion = ((Get-Content $DstVersionFile | Select-Object -First 1) + "").Trim() }
+    if (-not $OldVersion) { $OldVersion = "desconocida" }
     $Bak = Join-Path $Dest "AI.bak"
     if (Test-Path $Bak) { Remove-Item $Bak -Recurse -Force }
     Rename-Item $AiDst "AI.bak"
-    Write-Output "BACKUP: AI/ -> AI.bak"
     Copy-Item $AiSrc $AiDst -Recurse -Force
-    Write-Output "CREATE: AI/ (reinstalado con -Force)"
+    Write-Output "BACKUP: AI/ (v$OldVersion) -> AI.bak; CREATE: AI/ (v$HarnessVersion)"
   } else {
     Write-Output "SKIP: AI/ ya existe (usa -Force para reinstalar con backup .bak)"
   }
 } else {
   Copy-Item $AiSrc $AiDst -Recurse -Force
-  Write-Output "CREATE: AI/"
+  Write-Output "CREATE: AI/ (v$HarnessVersion)"
 }
 
 $AgentsDst = Join-Path $Dest "AGENTS.md"
@@ -57,7 +65,7 @@ if (Test-Path $GiDst) {
   Write-Output "CREATE: .gitignore"
 }
 
-Write-Output "OK: harness instalado en $Dest (package.json y mta.yaml intactos)"
+Write-Output "OK: harness v$HarnessVersion instalado en $Dest (package.json y mta.yaml intactos)"
 
 # Verificación de prerrequisitos en modo aviso (no bloquea la instalación).
 try {

package/install.sh

@@ -19,17 +19,22 @@ while [ $# -gt 0 ]; do
 done
 SRC="$(cd "$(dirname "$0")" && pwd)"
 if [ ! -d "$SRC/AI" ]; then echo "ABORT: no se encontró AI/ junto a install.sh"; exit 1; fi
+HARNESS_VERSION="desconocida"
+if [ -f "$SRC/AI/VERSION" ]; then HARNESS_VERSION="$(tr -d '[:space:]' < "$SRC/AI/VERSION")"; fi
+[ -n "$HARNESS_VERSION" ] || HARNESS_VERSION="desconocida"
 
 if [ -d "$DEST/AI" ]; then
   if [ "$FORCE" -eq 1 ]; then
+    OLD_VERSION="desconocida"
+    if [ -f "$DEST/AI/VERSION" ]; then OLD_VERSION="$(tr -d '[:space:]' < "$DEST/AI/VERSION")"; fi
+    [ -n "$OLD_VERSION" ] || OLD_VERSION="desconocida"
     rm -rf "$DEST/AI.bak" && mv "$DEST/AI" "$DEST/AI.bak"
-    echo "BACKUP: AI/ -> AI.bak"
-    cp -r "$SRC/AI" "$DEST/AI" && echo "CREATE: AI/ (reinstalado con --force)"
+    cp -r "$SRC/AI" "$DEST/AI" && echo "BACKUP: AI/ (v$OLD_VERSION) -> AI.bak; CREATE: AI/ (v$HARNESS_VERSION)"
   else
     echo "SKIP: AI/ ya existe (usa --force para reinstalar con backup .bak)"
   fi
 else
-  cp -r "$SRC/AI" "$DEST/AI" && echo "CREATE: AI/"
+  cp -r "$SRC/AI" "$DEST/AI" && echo "CREATE: AI/ (v$HARNESS_VERSION)"
 fi
 
 if [ -f "$DEST/AGENTS.md" ]; then
@@ -51,7 +56,7 @@ done < "$FRAG"
 if [ "$ADDED" -eq 0 ]; then echo "SKIP: .gitignore ya contiene el fragmento"
 else echo "CREATE: .gitignore (+$ADDED líneas)"; fi
 
-echo "OK: harness instalado en $DEST (package.json y mta.yaml intactos)"
+echo "OK: harness v$HARNESS_VERSION instalado en $DEST (package.json y mta.yaml intactos)"
 
 # Verificación de prerrequisitos en modo aviso (no bloquea la instalación).
 if [ -f "$SRC/AI/scripts/check-prereqs.sh" ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-harness-btp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Instala el harness MVP SAP BTP como carpeta AI/ en cualquier proyecto",
   "keywords": ["sap-btp", "opencode", "harness", "agents", "scaffolder", "create"],
   "homepage": "https://github.com/horangelmillan/harness-btp#readme",