create-harness-btp 0.2.4 → 0.3.0

package/install.ps1

@@ -1,12 +1,18 @@
 <# Instalador del harness BTP (idempotente, PowerShell 5.1).
-   Uso: .\install.ps1 [-Dest "."] [-Force]
+   Uso: .\install.ps1 [-Dest "."] [-Force] [-Client auto]
    - Copia AI/ al proyecto destino (SKIP si ya existe; con -Force hace backup a AI.bak).
+   - Fusiona el árbol del cliente agéntico desde AI/clients/<cliente>/ en la raíz
+     (solo faltantes; con -Force hace backup a <dir>.bak):
+     -Client auto (defecto): detecta por huellas (CLAUDE.md|.claude→claude,
+     .cursor→cursor, .github→copilot, opencode.json*|.opencode→opencode;
+     sin huellas→opencode) | all: todos | lista explícita (p. ej. claude,copilot).
    - 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. #>
 param(
   [string]$Dest = ".",
-  [switch]$Force
+  [switch]$Force,
+  $Client = "auto"
 )
 
 $ErrorActionPreference = "Stop"
@@ -49,6 +55,83 @@ if (Test-Path $AgentsDst) {
   Write-Output "CREATE: AGENTS.md (puntero a AI/AGENTS.md)"
 }
 
+$ClientsSrc = Join-Path $AiSrc "clients"
+
+function Get-ClientList($Spec, $DestDir) {
+  $s = (($Spec -join ",") + "").Trim().ToLower()
+  if ($s -eq "auto") {
+    $d = @()
+    if ((Test-Path (Join-Path $DestDir "CLAUDE.md")) -or (Test-Path (Join-Path $DestDir ".claude"))) { $d += "claude" }
+    if (Test-Path (Join-Path $DestDir ".cursor")) { $d += "cursor" }
+    if (Test-Path (Join-Path $DestDir ".github")) { $d += "copilot" }
+    $opHints = @(Get-ChildItem $DestDir -Filter "opencode.json*" -File -ErrorAction SilentlyContinue)
+    if (($opHints.Count -gt 0) -or (Test-Path (Join-Path $DestDir ".opencode"))) { $d += "opencode" }
+    if ($d.Count -eq 0) { $d = @("opencode") }
+    return $d
+  }
+  if ($s -eq "all") { return @("opencode", "claude", "cursor", "copilot") }
+  $list = @($s -split "," | ForEach-Object { $_.Trim().ToLower() } | Where-Object { $_ -ne "" })
+  $known = @("opencode", "claude", "cursor", "copilot", "aider")
+  foreach ($c in $list) {
+    if ($known -notcontains $c) { Write-Host "ABORT: cliente desconocido '$c' (usa auto|all|opencode,claude,cursor,copilot,aider)"; exit 1 }
+  }
+  if ($list.Count -eq 0) { Write-Host "ABORT: -Client vacío (usa auto|all|opencode,claude,cursor,copilot,aider)"; exit 1 }
+  return $list
+}
+
+function Merge-Tree($TreeSrc, $TreeDst, $Label) {
+  if (-not (Test-Path $TreeSrc)) { Write-Output "AVISO: no existe $TreeSrc (regenera con node scripts/render-clients.js)"; return }
+  $BakLabel = $Label.TrimEnd("/") + ".bak"
+  if ($Force) {
+    if (Test-Path $TreeDst) {
+      $Bak = "$TreeDst.bak"
+      if (Test-Path $Bak) { Remove-Item $Bak -Recurse -Force }
+      Rename-Item $TreeDst ([IO.Path]::GetFileName($Bak))
+      Write-Output "BACKUP: $Label -> $BakLabel"
+    }
+    Copy-Item $TreeSrc $TreeDst -Recurse -Force
+    $TreeCount = @(Get-ChildItem $TreeDst -Recurse -File).Count
+    Write-Output ("CREATE: {0} (+{1} archivos)" -f $Label, $TreeCount)
+  } else {
+    $TreeCount = 0
+    $TreeFiles = @(Get-ChildItem $TreeSrc -Recurse -File)
+    foreach ($f in $TreeFiles) {
+      $rel = $f.FullName.Substring($TreeSrc.Length + 1)
+      $tgt = Join-Path $TreeDst $rel
+      if (Test-Path $tgt) {
+        Write-Output ("SKIP: {0}{1} ya existe" -f $Label, ($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
+        $TreeCount++
+      }
+    }
+    Write-Output ("CREATE: {0} (+{1} archivos)" -f $Label, $TreeCount)
+  }
+}
+
+$SelectedClients = @(Get-ClientList $Client $Dest)
+if ((($Client -join ",") + "").Trim().ToLower() -eq "auto") {
+  Write-Output ("CLIENT: auto -> {0}" -f ($SelectedClients -join ","))
+}
+foreach ($c in $SelectedClients) {
+  if ($c -eq "opencode") {
+    Merge-Tree (Join-Path $ClientsSrc "opencode") (Join-Path $Dest ".opencode") ".opencode/"
+  } elseif ($c -eq "claude") {
+    Merge-Tree (Join-Path $ClientsSrc "claude") (Join-Path $Dest ".claude") ".claude/"
+  } elseif ($c -eq "cursor") {
+    Merge-Tree (Join-Path $ClientsSrc "cursor\commands") (Join-Path $Dest ".cursor\commands") ".cursor/commands/"
+    Merge-Tree (Join-Path $ClientsSrc "cursor\skills") (Join-Path $Dest ".agents\skills") ".agents/skills/"
+  } elseif ($c -eq "copilot") {
+    Merge-Tree (Join-Path $ClientsSrc "copilot\agents") (Join-Path $Dest ".github\agents") ".github/agents/"
+    Merge-Tree (Join-Path $ClientsSrc "copilot\skills") (Join-Path $Dest ".github\skills") ".github/skills/"
+    Merge-Tree (Join-Path $ClientsSrc "copilot\prompts") (Join-Path $Dest ".github\prompts") ".github/prompts/"
+  } elseif ($c -eq "aider") {
+    Write-Output "SKIP: aider usa AGENTS.md raiz (nada que fusionar)"
+  }
+}
+
 $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

@@ -1,18 +1,26 @@
 #!/bin/sh
 # Instalador del harness BTP (idempotente, POSIX sh).
-# Uso: ./install.sh [--dest <dir>] [--force] [--help]
+# Uso: ./install.sh [--dest <dir>] [--force] [--client auto|all|opencode,claude,...] [--help]
 # Sin secretos. No toca package.json ni mta.yaml del proyecto.
+# Fusiona el árbol del cliente agéntico desde AI/clients/<cliente>/ en la raíz
+# (solo faltantes; con --force hace backup a <dir>.bak).
+# --client auto (defecto): detecta por huellas (CLAUDE.md|.claude→claude,
+# .cursor→cursor, .github→copilot, opencode.json*|.opencode→opencode;
+# sin huellas→opencode). all: todos. Lista explícita: esos.
 DEST="."
 FORCE=0
+CLIENT="auto"
 while [ $# -gt 0 ]; do
   case "$1" in
     --dest) DEST="$2"; shift 2 ;;
     --force) FORCE=1; shift ;;
+    --client) CLIENT="$2"; shift 2 ;;
     -h|--help)
-      echo "Uso: ./install.sh [--dest <dir>] [--force] [--help]"
-      echo "  --dest <dir>  proyecto destino (por defecto: .)"
-      echo "  --force       reinstala AI/ con backup a AI.bak"
-      echo "  -h, --help    muestra esta ayuda"
+      echo "Uso: ./install.sh [--dest <dir>] [--force] [--client <clientes>] [--help]"
+      echo "  --dest <dir>    proyecto destino (por defecto: .)"
+      echo "  --force         reinstala AI/ con backup a AI.bak"
+      echo "  --client <list> auto (defecto) | all | opencode,claude,cursor,copilot,aider"
+      echo "  -h, --help      muestra esta ayuda"
       exit 0 ;;
     *) echo "ABORT: opción desconocida $1 (usa --help)"; exit 1 ;;
   esac
@@ -43,6 +51,88 @@ else
   cp "$SRC/templates/AGENTS.pointer.md" "$DEST/AGENTS.md" && echo "CREATE: AGENTS.md (puntero a AI/AGENTS.md)"
 fi
 
+# Fusion idempotente de un arbol: merge_tree <origen> <destino> <etiqueta>
+# (etiqueta p. ej. ".opencode/"; el backup va a <destino>.bak).
+merge_tree() {
+  MT_SRC="$1"; MT_DST="$2"; MT_LABEL="$3"
+  if [ ! -d "$MT_SRC" ]; then echo "AVISO: no existe $MT_SRC (regenera con node scripts/render-clients.js)"; return 0; fi
+  MT_BAKLABEL="$(printf '%s' "$MT_LABEL" | sed 's:/$::').bak"
+  if [ "$FORCE" -eq 1 ]; then
+    if [ -d "$MT_DST" ]; then
+      rm -rf "$MT_DST.bak" && mv "$MT_DST" "$MT_DST.bak"
+      echo "BACKUP: $MT_LABEL -> $MT_BAKLABEL"
+    fi
+    mkdir -p "$(dirname "$MT_DST")"
+    cp -r "$MT_SRC" "$MT_DST" && MT_COUNT=$(find "$MT_DST" -type f | wc -l) && echo "CREATE: $MT_LABEL (+$MT_COUNT archivos)"
+  else
+    MT_COUNT=0
+    MT_LIST="${TMPDIR:-/tmp}/harness-mt-$$.tmp"
+    find "$MT_SRC" -type f -print > "$MT_LIST"
+    while IFS= read -r MT_FILE; do
+      MT_REL=${MT_FILE#"$MT_SRC"/}
+      if [ -f "$MT_DST/$MT_REL" ]; then
+        echo "SKIP: $MT_LABEL$MT_REL ya existe"
+      else
+        mkdir -p "$(dirname "$MT_DST/$MT_REL")"
+        cp "$MT_FILE" "$MT_DST/$MT_REL"
+        MT_COUNT=$((MT_COUNT + 1))
+      fi
+    done < "$MT_LIST"
+    rm -f "$MT_LIST"
+    echo "CREATE: $MT_LABEL (+$MT_COUNT archivos)"
+  fi
+}
+
+# Resuelve la lista de clientes: detecta huellas en auto, valida explícitos.
+resolve_clients() {
+  case "$CLIENT" in
+    auto)
+      RC_LIST=""
+      { [ -f "$DEST/CLAUDE.md" ] || [ -d "$DEST/.claude" ]; } && RC_LIST="$RC_LIST claude"
+      [ -d "$DEST/.cursor" ] && RC_LIST="$RC_LIST cursor"
+      [ -d "$DEST/.github" ] && RC_LIST="$RC_LIST copilot"
+      if ls "$DEST"/opencode.json* >/dev/null 2>&1 || [ -d "$DEST/.opencode" ]; then RC_LIST="$RC_LIST opencode"; fi
+      [ -z "$RC_LIST" ] && RC_LIST=" opencode"
+      echo "CLIENT: auto -> $(printf '%s' "$RC_LIST" | tr ' ' ',' | sed 's/^,//')" >&2
+      printf '%s' "$RC_LIST"
+      ;;
+    all) printf ' opencode claude cursor copilot' ;;
+    *)
+      RC_OUT=""
+      RC_REST="$CLIENT,"
+      while [ -n "$RC_REST" ]; do
+        RC_ONE=${RC_REST%%,*}; RC_REST=${RC_REST#*,}
+        RC_ONE=$(printf '%s' "$RC_ONE" | tr 'A-Z' 'a-z' | tr -d ' ')
+        [ -z "$RC_ONE" ] && continue
+        case "$RC_ONE" in
+          opencode|claude|cursor|copilot|aider) RC_OUT="$RC_OUT $RC_ONE" ;;
+          *) echo "ABORT: cliente desconocido '$RC_ONE' (usa auto|all|opencode,claude,cursor,copilot,aider)" >&2; exit 1 ;;
+        esac
+      done
+      [ -z "$RC_OUT" ] && { echo "ABORT: --client vacío (usa auto|all|opencode,claude,cursor,copilot,aider)" >&2; exit 1; }
+      printf '%s' "$RC_OUT"
+      ;;
+  esac
+}
+
+CLIENTS_SRC="$SRC/AI/clients"
+RC_RESOLVED=$(resolve_clients); RC_STATUS=$?
+if [ "$RC_STATUS" -ne 0 ]; then exit "$RC_STATUS"; fi
+for C in $RC_RESOLVED; do
+  case "$C" in
+    opencode) merge_tree "$CLIENTS_SRC/opencode" "$DEST/.opencode" ".opencode/" ;;
+    claude) merge_tree "$CLIENTS_SRC/claude" "$DEST/.claude" ".claude/" ;;
+    cursor)
+      merge_tree "$CLIENTS_SRC/cursor/commands" "$DEST/.cursor/commands" ".cursor/commands/"
+      merge_tree "$CLIENTS_SRC/cursor/skills" "$DEST/.agents/skills" ".agents/skills/" ;;
+    copilot)
+      merge_tree "$CLIENTS_SRC/copilot/agents" "$DEST/.github/agents" ".github/agents/"
+      merge_tree "$CLIENTS_SRC/copilot/skills" "$DEST/.github/skills" ".github/skills/"
+      merge_tree "$CLIENTS_SRC/copilot/prompts" "$DEST/.github/prompts" ".github/prompts/" ;;
+    aider) echo "SKIP: aider usa AGENTS.md raiz (nada que fusionar)" ;;
+  esac
+done
+
 FRAG="$SRC/AI/.gitignore.fragment"
 touch "$DEST/.gitignore"
 ADDED=0

package/package.json

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