create-harness-btp 0.2.3 → 0.2.5

package/AI/VERSION

@@ -1 +1 @@
-0.2.3
+0.2.5

package/README.md

@@ -1,6 +1,6 @@
 # harness-btp
 
-[![version](https://img.shields.io/badge/version-v0.2.3-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.3)
+[![version](https://img.shields.io/badge/version-v0.2.5-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.5)
 [![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)
@@ -55,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.3 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.5 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -63,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.3 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.5 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -79,7 +79,7 @@ Descarga solo lo necesario, sin historial git:
 PowerShell:
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.5 AI-tmp -- AI-tmp
 powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
 Remove-Item -Recurse -Force AI-tmp
 ```
@@ -87,7 +87,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.5 AI-tmp -- AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -99,7 +99,7 @@ Clon superficial anclado al tag:
 PowerShell:
 
 ```powershell
-git clone --branch v0.2.3 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
+git clone --branch v0.2.5 --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
 ```
@@ -107,7 +107,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-git clone --branch v0.2.3 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
+git clone --branch v0.2.5 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
 sh AI-tmp/install.sh --dest .
 rm -rf AI-tmp
 ```
@@ -117,13 +117,14 @@ 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@0.2.3 --dest .
+pnpm dlx create-harness-btp@0.2.5 --dest .
 ```
 
 ### Qué hace el instalador
 
 - `CREATE: AI/` o `SKIP: AI/ ya existe` (solo lo reemplaza con `-Force` / `--force`, con backup a `AI.bak`).
 - `CREATE: AGENTS.md` o `SKIP: AGENTS.md ya existe` (tu `AGENTS.md` propio se conserva; con `-Force` / `--force` se respalda a `AGENTS.md.bak`).
+- Fusiona `.opencode/` raíz desde `AI/.opencode/` (`agents` + `commands` + `skills`, lo que OpenCode descubre en la raíz del proyecto): sin fuerza solo copia los archivos que falten (`SKIP: .opencode/<ruta> ya existe` por cada uno conservado y `CREATE: .opencode/ (+N archivos)`); con `-Force` / `--force` respalda `.opencode/` a `.opencode.bak` (`BACKUP: .opencode/ -> .opencode.bak`) y copia todo.
 - Fusiona `.gitignore`: añade las líneas que falten, sin duplicar ni borrar las tuyas.
 - **No toca** `package.json` ni `mta.yaml` de tu proyecto, nunca.
 
@@ -132,27 +133,19 @@ Salida típica en proyecto nuevo:
 ```text
 CREATE: AI/
 CREATE: AGENTS.md
-OK: harness v0.2.3 instalado
+CREATE: .opencode/ (+17 archivos)
+OK: harness v0.2.5 instalado
 ```
 
 ## Instalación asistida por agente
 
-Si prefieres que tu agente lo haga todo (clonar + instalar), pégale este bloque. Solo crea la carpeta vacía y vincúlala a tu cliente; rellena lo de [CORCHETES]:
+Si prefieres que tu agente lo haga todo (clonar + instalar), pégale esta línea. Solo crea la carpeta vacía y vincúlala a tu cliente:
 
 ```text
-Déjame el proyecto listo en [RUTA-CARPETA] con el harness BTP instalado. Repo a usar: [URL-del-repo o VACÍO si la carpeta ya es un proyecto existente].
-1) Si te di URL y la carpeta está vacía: clónalo ahí dentro con git clone --depth 1 [URL] . Si la carpeta ya tiene un proyecto, no borres ni muevas nada: trabaja sobre ella.
-2) Lee https://github.com/horangelmillan/harness-btp (README, opción pnpm) y ejecuta el comando pnpm dlx EXACTO con la versión que ahí se indique, sin cambiarle la versión (sin --force salvo que AI/ ya exista y yo lo autorice; con --force verifica la línea BACKUP primero).
-3) PROHIBIDO pisar o borrar: AGENTS.md raíz si ya existe, package.json, mta.yaml, lockfiles.
-4) Verifica lo INSTALADO, no lo publicado (no vale pnpm view ni npm view): el archivo AI/VERSION debe decir exactamente la versión del comando que ejecutaste. Si no coincide, dilo y detente.
-5) Si migraste npm→pnpm (import + install + test en verde), borra package-lock.json.
-6) Corre AI/scripts/check-prereqs (modo aviso) y reporta faltantes.
-7) Si AI/AGENTS.md trae placeholders por adaptar, dímelos antes de desplegar.
-8) Cierre limpio: no dejes servidores ni observadores corriendo — detén lo que hayas iniciado y verifica que no queden procesos parados en la carpeta; nunca intentes borrar una carpeta con procesos dentro, repórtamelos.
-Sin secretos en el reporte. Repórtame: comando ejecutado, salida del instalador, contenido de AI/VERSION, git status y qué quedó pendiente.
+Déjame este proyecto listo con el harness BTP: lee https://raw.githubusercontent.com/horangelmillan/harness-btp/main/prompts/setup.md y síguelo al pie de la letra. Si te falta un dato (p. ej. la URL del repo a clonar), pregúntamelo antes de suponer.
 ```
 
-Vale para proyecto nuevo (con URL), existente, Windows/Linux/macOS y cualquier cliente que lea este README.
+Vale para proyecto nuevo (con URL), existente, Windows/Linux/macOS y cualquier cliente que lea este README. El archivo `prompts/setup.md` vive versionado con el harness: siempre está al día sin que cambies tu línea.
 
 ## Actualizar y desinstalar
 
@@ -161,7 +154,7 @@ Vale para proyecto nuevo (con URL), existente, Windows/Linux/macOS y cualquier c
 PowerShell:
 
 ```powershell
-npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.5 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
@@ -170,7 +163,7 @@ Remove-Item -Recurse -Force AI-tmp
 bash:
 
 ```bash
-npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
+npx -p degit degit horangelmillan/harness-btp#v0.2.5 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
@@ -222,7 +215,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.3
+└── VERSION                    # 0.2.5
 ```
 
 ## Cómo lo descubre el agente
@@ -239,11 +232,12 @@ Tú no configuras nada: el agente se adapta solo.
 | Problema | Causa | Comando |
 |---|---|---|
 | `SKIP: AI/ ya existe` y quería actualizar | reinstalación sin fuerza conserva lo existente | repite con `-Force` (`.ps1`) o `--force` (`.sh`); guarda `AI.bak` |
+| No aparece `orchestrator` / no existe `/flow` | fusión a `.opencode/` raíz ausente (OpenCode solo descubre `.opencode/` en la raíz del proyecto, no `AI/.opencode/`) | reinstala sin fuerza (copia solo faltantes) o copia `AI/.opencode/` a `.opencode/` en la raíz sin pisar archivos propios |
 | Mi `AGENTS.md` propio desapareció | se instaló con fuerza | recupera `AGENTS.md.bak` |
 | 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.3` |
+| `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.2.5` |
 | 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` |
 | No se deja borrar la carpeta del proyecto ("Carpeta en uso") | procesos huérfanos parados dentro (shells/MCPs de una sesión ya cerrada) | resmon → CPU → Identificadores asociados → busca la carpeta y termina solo esos PIDs; nunca fueron del instalador (solo copia archivos y termina) |
 
@@ -271,6 +265,8 @@ MIT. Haz lo que quieras con el harness; sin garantía.
 
 ## Changelog
 
+- **v0.2.5** — fusión a `.opencode/` raíz: el instalador sincroniza `AI/.opencode/` (agents + commands + skills) en `.opencode/` del proyecto para que OpenCode descubra `orchestrator` y `/flow` (SKIP sin fuerza, `.opencode.bak` con fuerza); `prompts/setup.md` verifica adopción y fusiona el fragmento MCP.
+- **v0.2.4** — estilo Neon: una línea que lee `prompts/setup.md` (versionado, siempre al día) en vez de un bloque que caduca.
 - **v0.2.3** — prompt universal todo-en-uno: clona + instala con la versión que indique el README (nunca caduca), verifica AI/VERSION instalado.
 - **v0.2.2** — anti-huérfanos: bloque de agente con regla de cierre limpio (no dejar servidores corriendo, no borrar carpetas con procesos dentro) + troubleshooting de carpeta bloqueada (resmon → Identificadores asociados).
 - **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`.

package/VERSION

@@ -1 +1 @@
-0.2.3
+0.2.5

package/bin/harness-btp.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 // harness-btp init --dest <dir> [--force] [--ref <tag>]
-// Copia AI/, crea AGENTS.md puntero y fusiona .gitignore. Sin secretos.
+// Copia AI/, crea AGENTS.md puntero, fusiona AI/.opencode/ en .opencode/
+// raíz (solo faltantes; con --force hace backup a .opencode.bak) y fusiona .gitignore. Sin secretos.
 // No toca package.json ni mta.yaml del proyecto.
 const fs = require("fs");
 const path = require("path");
@@ -61,6 +62,43 @@ if (fs.existsSync(agentsDst)) {
   console.log("CREATE: AGENTS.md (puntero a AI/AGENTS.md)");
 }
 
+const opSrc = path.join(src, "AI", ".opencode");
+const opDst = path.join(dest, ".opencode");
+function listFilesRec(dir, base) {
+  let out = [];
+  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, e.name);
+    if (e.isDirectory()) out = out.concat(listFilesRec(p, base));
+    else out.push(path.relative(base, p));
+  }
+  return out;
+}
+if (fs.existsSync(opSrc)) {
+  if (force) {
+    if (fs.existsSync(opDst)) {
+      const opBak = path.join(dest, ".opencode.bak");
+      fs.rmSync(opBak, { recursive: true, force: true });
+      fs.renameSync(opDst, opBak);
+      console.log("BACKUP: .opencode/ -> .opencode.bak");
+    }
+    fs.cpSync(opSrc, opDst, { recursive: true });
+    console.log("CREATE: .opencode/ (+" + listFilesRec(opDst, opDst).length + " archivos)");
+  } else {
+    let opCount = 0;
+    for (const rel of listFilesRec(opSrc, opSrc)) {
+      const tgt = path.join(opDst, rel);
+      if (fs.existsSync(tgt)) {
+        console.log("SKIP: .opencode/" + rel.split(path.sep).join("/") + " ya existe");
+      } else {
+        fs.mkdirSync(path.dirname(tgt), { recursive: true });
+        fs.copyFileSync(path.join(opSrc, rel), tgt);
+        opCount++;
+      }
+    }
+    console.log("CREATE: .opencode/ (+" + opCount + " archivos)");
+  }
+}
+
 const frag = fs.readFileSync(path.join(src, "AI", ".gitignore.fragment"), "utf8")
   .split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
 let cur = [];

package/install.ps1

@@ -1,6 +1,7 @@
 <# Instalador del harness BTP (idempotente, PowerShell 5.1).
    Uso: .\install.ps1 [-Dest "."] [-Force]
    - Copia AI/ al proyecto destino (SKIP si ya existe; con -Force hace backup a AI.bak).
+   - Fusiona AI/.opencode/{agents,commands,skills} en .opencode/ raíz (solo faltantes; con -Force hace backup a .opencode.bak).
    - Crea AGENTS.md raíz desde la plantilla solo si no existe.
    - Fusiona .gitignore con las líneas del fragmento (solo agrega faltantes).
    - NO toca package.json ni mta.yaml del proyecto. Sin secretos. #>
@@ -49,6 +50,38 @@ if (Test-Path $AgentsDst) {
   Write-Output "CREATE: AGENTS.md (puntero a AI/AGENTS.md)"
 }
 
+$OpSrc = Join-Path $AiSrc ".opencode"
+$OpDst = Join-Path $Dest ".opencode"
+if (Test-Path $OpSrc) {
+  if ($Force) {
+    if (Test-Path $OpDst) {
+      $OpBak = Join-Path $Dest ".opencode.bak"
+      if (Test-Path $OpBak) { Remove-Item $OpBak -Recurse -Force }
+      Rename-Item $OpDst ".opencode.bak"
+      Write-Output "BACKUP: .opencode/ -> .opencode.bak"
+    }
+    Copy-Item $OpSrc $OpDst -Recurse -Force
+    $OpCount = @(Get-ChildItem $OpDst -Recurse -File).Count
+    Write-Output ("CREATE: .opencode/ (+{0} archivos)" -f $OpCount)
+  } else {
+    $OpCount = 0
+    $OpFiles = @(Get-ChildItem $OpSrc -Recurse -File)
+    foreach ($f in $OpFiles) {
+      $rel = $f.FullName.Substring($OpSrc.Length + 1)
+      $tgt = Join-Path $OpDst $rel
+      if (Test-Path $tgt) {
+        Write-Output ("SKIP: .opencode/{0} ya existe" -f ($rel -replace "\\","/"))
+      } else {
+        $tgtDir = Split-Path -Parent $tgt
+        if (-not (Test-Path $tgtDir)) { New-Item $tgtDir -ItemType Directory -Force | Out-Null }
+        Copy-Item $f.FullName $tgt -Force
+        $OpCount++
+      }
+    }
+    Write-Output ("CREATE: .opencode/ (+{0} archivos)" -f $OpCount)
+  }
+}
+
 $Frag = Join-Path $AiSrc ".gitignore.fragment"
 $GiDst = Join-Path $Dest ".gitignore"
 $lines = Get-Content $Frag | Where-Object { $_.Trim() -ne "" -and -not $_.Trim().StartsWith("#") }

package/install.sh

@@ -2,6 +2,8 @@
 # Instalador del harness BTP (idempotente, POSIX sh).
 # Uso: ./install.sh [--dest <dir>] [--force] [--help]
 # Sin secretos. No toca package.json ni mta.yaml del proyecto.
+# Fusiona AI/.opencode/{agents,commands,skills} en .opencode/ raíz
+# (solo faltantes; con --force hace backup a .opencode.bak).
 DEST="."
 FORCE=0
 while [ $# -gt 0 ]; do
@@ -43,6 +45,34 @@ else
   cp "$SRC/templates/AGENTS.pointer.md" "$DEST/AGENTS.md" && echo "CREATE: AGENTS.md (puntero a AI/AGENTS.md)"
 fi
 
+OP_SRC="$SRC/AI/.opencode"
+OP_DST="$DEST/.opencode"
+if [ -d "$OP_SRC" ]; then
+  if [ "$FORCE" -eq 1 ]; then
+    if [ -d "$OP_DST" ]; then
+      rm -rf "$DEST/.opencode.bak" && mv "$DEST/.opencode" "$DEST/.opencode.bak"
+      echo "BACKUP: .opencode/ -> .opencode.bak"
+    fi
+    cp -r "$OP_SRC" "$OP_DST" && OP_COUNT=$(find "$OP_DST" -type f | wc -l) && echo "CREATE: .opencode/ (+$OP_COUNT archivos)"
+  else
+    OP_COUNT=0
+    OP_LIST="${TMPDIR:-/tmp}/harness-opcount-$$.tmp"
+    find "$OP_SRC" -type f -print > "$OP_LIST"
+    while IFS= read -r OP_FILE; do
+      OP_REL=${OP_FILE#"$OP_SRC"/}
+      if [ -f "$OP_DST/$OP_REL" ]; then
+        echo "SKIP: .opencode/$OP_REL ya existe"
+      else
+        mkdir -p "$(dirname "$OP_DST/$OP_REL")"
+        cp "$OP_FILE" "$OP_DST/$OP_REL"
+        OP_COUNT=$((OP_COUNT + 1))
+      fi
+    done < "$OP_LIST"
+    rm -f "$OP_LIST"
+    echo "CREATE: .opencode/ (+$OP_COUNT archivos)"
+  fi
+fi
+
 FRAG="$SRC/AI/.gitignore.fragment"
 touch "$DEST/.gitignore"
 ADDED=0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-harness-btp",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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",