create-harness-btp 0.1.1 → 0.2.0

package/AI/scripts/check-docs.ps1

@@ -0,0 +1,78 @@
+<# Verificación de fuentes oficiales del harness BTP (PowerShell 5.1).
+   Uso:
+     powershell -ExecutionPolicy Bypass -File AI/scripts/check-docs.ps1
+   - Comprueba cada URL de AI/docs/fuentes-oficiales.md con UN solo intento
+     HTTP GET (timeout 15 s, sin reintentos ni bucles).
+   - Emite OK / ROTO / PENDIENTE por fuente + fecha.
+   - OK: HTTP 2xx-3xx. ROTO: HTTP 4xx-5xx confirmado. PENDIENTE: sin respuesta
+     (timeout/DNS; avisa pero no falla: re-verificar y actualizar la fecha).
+   - exit 1 si alguna fuente REQUERIDA está ROTA. exit 0 en otro caso.
+   - Cero secretos: solo peticiones GET anónimas, sin credenciales. #>
+
+$ErrorActionPreference = "Continue"
+$Fecha = (Get-Date).ToString("yyyy-MM-dd")
+$FallosReq = 0
+
+function Test-Doc {
+  param([string]$Nombre, [string]$Url, [string]$Nivel)
+  try {
+    $r = Invoke-WebRequest -Uri $Url -UseBasicParsing -TimeoutSec 15 -MaximumRedirection 5
+    $code = [int]$r.StatusCode
+    if ($code -ge 200 -and $code -lt 400) {
+      Write-Output ("{0} | OK | {1} | {2}" -f $Nombre, $Fecha, $Url)
+    } else {
+      Write-Output ("{0} | ROTO (HTTP {1}) | {2} | {3}" -f $Nombre, $code, $Fecha, $Url)
+      if ($Nivel -eq "REQ") { $script:FallosReq++ }
+    }
+  } catch {
+    $resp = $_.Exception.Response
+    if ($resp -ne $null) {
+      try { $code = [int]$resp.StatusCode } catch { $code = 0 }
+      # .NET Framework (PS 5.1) no sigue HTTP 308 automáticamente aunque se pida
+      # -MaximumRedirection: se sigue la redirección UNA sola vez, sin bucles.
+      if ($code -eq 308) {
+        try {
+          $loc = $resp.Headers["Location"]
+          if ($loc -notmatch "^https?://") {
+            $base = ([System.Uri]$Url).GetLeftPart([System.UriPartial]::Authority)
+            $loc = $base + $loc
+          }
+          $r2 = Invoke-WebRequest -Uri $loc -UseBasicParsing -TimeoutSec 15 -MaximumRedirection 5
+          $code2 = [int]$r2.StatusCode
+          if ($code2 -ge 200 -and $code2 -lt 400) {
+            Write-Output ("{0} | OK (redirige HTTP 308 a {1}) | {2} | {3}" -f $Nombre, $loc, $Fecha, $Url)
+          } else {
+            Write-Output ("{0} | ROTO (HTTP {1} tras 308) | {2} | {3}" -f $Nombre, $code2, $Fecha, $Url)
+            if ($Nivel -eq "REQ") { $script:FallosReq++ }
+          }
+        } catch {
+          Write-Output ("{0} | PENDIENTE (308 sin destino legible) | {1} | {2}" -f $Nombre, $Fecha, $Url)
+        }
+      } else {
+        Write-Output ("{0} | ROTO (HTTP {1}) | {2} | {3}" -f $Nombre, $code, $Fecha, $Url)
+        if ($Nivel -eq "REQ") { $script:FallosReq++ }
+      }
+    } else {
+      Write-Output ("{0} | PENDIENTE (sin respuesta: timeout/DNS) | {1} | {2}" -f $Nombre, $Fecha, $Url)
+    }
+  }
+}
+
+Write-Output ""
+Write-Output ("Fuentes oficiales del harness BTP ({0})" -f $Fecha)
+Test-Doc "cf-cli" "https://docs.cloudfoundry.org/cf-cli/install-go-cli.html" "REQ"
+Test-Doc "mbt" "https://github.com/SAP/cloud-mta-build-tool" "REQ"
+Test-Doc "cap" "https://cap.cloud.sap/docs/get-started/" "REQ"
+Test-Doc "ui5-cli" "https://ui5.github.io/cli/" "REQ"
+Test-Doc "opencode" "https://docs.opencode.ai/docs" "REQ"
+Test-Doc "npm-trusted-publishers" "https://docs.npmjs.com/trusted-publishers/" "REQ"
+Test-Doc "op-1password" "https://developer.1password.com/docs/cli/get-started/" "OPT"
+Write-Output ""
+
+if ($FallosReq -gt 0) {
+  Write-Output ("RESULTADO: {0} fuente(s) REQUERIDA(s) ROTA(s). Revisa AI/docs/fuentes-oficiales.md y actualiza la fecha tras corregir." -f $FallosReq)
+  exit 1
+} else {
+  Write-Output "RESULTADO: ninguna fuente REQUERIDA rota. Actualiza la columna de fecha en AI/docs/fuentes-oficiales.md."
+  exit 0
+}

package/AI/scripts/check-docs.sh

@@ -0,0 +1,42 @@
+#!/bin/sh
+# Verificación de fuentes oficiales del harness BTP (POSIX sh).
+# Uso: sh AI/scripts/check-docs.sh
+# - Comprueba cada URL de AI/docs/fuentes-oficiales.md con UN solo intento
+#   HTTP GET (timeout 15 s, --retry 0, sin reintentos ni bucles).
+# - Emite OK / ROTO / PENDIENTE por fuente + fecha.
+# - OK: HTTP 2xx-3xx. ROTO: HTTP 4xx-5xx confirmado. PENDIENTE: sin respuesta
+#   (timeout/DNS; avisa pero no falla: re-verificar y actualizar la fecha).
+# - exit 1 si alguna fuente REQUERIDA está ROTA. exit 0 en otro caso.
+# - Cero secretos: solo peticiones GET anónimas, sin credenciales.
+FECHA=$(date +%F)
+FALLOS_REQ=0
+# check_doc <nombre> <url> <nivel>: un solo intento, sin bucles.
+check_doc() {
+  _code=$(curl -s -o /dev/null -w "%{http_code}" -L --max-time 15 --retry 0 "$2" 2>/dev/null)
+  _rc=$?
+  if [ $_rc -ne 0 ]; then
+    echo "$1 | PENDIENTE (sin respuesta: timeout/DNS) | $FECHA | $2"
+  elif [ "$_code" -ge 200 ] && [ "$_code" -lt 400 ]; then
+    echo "$1 | OK | $FECHA | $2"
+  else
+    echo "$1 | ROTO (HTTP $_code) | $FECHA | $2"
+    if [ "$3" = "REQ" ]; then FALLOS_REQ=$((FALLOS_REQ + 1)); fi
+  fi
+}
+echo ""
+echo "Fuentes oficiales del harness BTP ($FECHA)"
+check_doc "cf-cli" "https://docs.cloudfoundry.org/cf-cli/install-go-cli.html" "REQ"
+check_doc "mbt" "https://github.com/SAP/cloud-mta-build-tool" "REQ"
+check_doc "cap" "https://cap.cloud.sap/docs/get-started/" "REQ"
+check_doc "ui5-cli" "https://ui5.github.io/cli/" "REQ"
+check_doc "opencode" "https://docs.opencode.ai/docs" "REQ"
+check_doc "npm-trusted-publishers" "https://docs.npmjs.com/trusted-publishers/" "REQ"
+check_doc "op-1password" "https://developer.1password.com/docs/cli/get-started/" "OPT"
+echo ""
+if [ "$FALLOS_REQ" -gt 0 ]; then
+  echo "RESULTADO: $FALLOS_REQ fuente(s) REQUERIDA(s) ROTA(s). Revisa AI/docs/fuentes-oficiales.md y actualiza la fecha tras corregir."
+  exit 1
+else
+  echo "RESULTADO: ninguna fuente REQUERIDA rota. Actualiza la columna de fecha en AI/docs/fuentes-oficiales.md."
+  exit 0
+fi

package/AI/scripts/check-prereqs.ps1

@@ -0,0 +1,129 @@
+<# Verificación de prerrequisitos del harness BTP (PowerShell 5.1).
+   Uso:
+     powershell -ExecutionPolicy Bypass -File AI/scripts/check-prereqs.ps1 [-WarnOnly] [-NeedMtar] [-NeedJava] [-NeedCds] [-NeedGh] [-NeedOp]
+   - Sin parámetros: comprueba REQUERIDO siempre + OPCIONAL como aviso.
+   - -NeedMtar/-NeedJava/-NeedCds/-NeedGh/-NeedOp: promocionan ese opcional a
+     REQUERIDO (usar cuando la spec del MVP lo exija).
+   - -WarnOnly: nunca falla (exit 0); lo usan install.ps1/install.sh al final.
+   NUNCA imprime secretos: solo ejecuta "<comando> --version" y cuenta archivos.
+   REQUERIDO faltante -> exit 1 (salvo -WarnOnly). Solo opcionales -> exit 0. #>
+param(
+  [switch]$WarnOnly,
+  [switch]$NeedMtar,
+  [switch]$NeedJava,
+  [switch]$NeedCds,
+  [switch]$NeedGh,
+  [switch]$NeedOp
+)
+
+$ErrorActionPreference = "Continue"
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$HarnessRoot = Split-Path -Parent (Split-Path -Parent $ScriptDir)
+
+$rows = New-Object System.Collections.ArrayList
+function Add-Row($tool, $need, $level, $state, $detail, $url) {
+  [void]$rows.Add([pscustomobject]@{
+    Herramienta = $tool; NecesariaPara = $need; Nivel = $level
+    Estado = $state; Detalle = $detail; Instalacion = $url
+  })
+}
+
+function Test-Tool($name, $versionArgs) {
+  try {
+    $cmd = Get-Command $name -ErrorAction Stop
+    try {
+      $out = & $cmd.Source @versionArgs 2>&1 | Select-Object -First 1
+      if ($out) { $out = "$out".Trim() } else { $out = "instalado" }
+    } catch { $out = "instalado (version no legible)" }
+    return @{ Found = $true; Detail = $out }
+  } catch { return @{ Found = $false; Detail = "no encontrado en PATH" } }
+}
+
+# --- REQUERIDO siempre ---
+$r = Test-Tool "git" @("--version")
+Add-Row "git" "control de versiones del MVP" "REQ" $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://git-scm.com/downloads"
+
+$node = Test-Tool "node" @("--version")
+$nodeOk = $false
+if ($node.Found) {
+  try {
+    $m = [regex]::Match($node.Detail, "v?(\d+)\.")
+    if ($m.Success -and [int]$m.Groups[1].Value -ge 18) { $nodeOk = $true }
+    else { $node.Detail = "$($node.Detail) (se requiere Node 18+)" }
+  } catch { $node.Detail = "$($node.Detail) (no se pudo verificar major >= 18)" }
+}
+Add-Row "node 18+" "CAP, UI5, mbt, scripts del harness" "REQ" $(if ($nodeOk) { "OK" } else { "FALTA" }) $node.Detail "https://nodejs.org/"
+
+$r = Test-Tool "cf" @("--version")
+$cfState = if ($r.Found) { "OK" } else { "FALTA" }
+if ($r.Found -and ($r.Detail -notmatch "(?i)cf version|cloudfoundry")) {
+  $r.Detail = "$($r.Detail) (AVISO: no parece el CLI de Cloud Foundry; si 'cf' es otra herramienta, define un alias al CLI real)"
+  $cfState = "FALTA"
+}
+Add-Row "cf" "despliegues y lecturas Cloud Foundry" "REQ" $cfState $r.Detail "https://docs.cloudfoundry.org/cf-cli/install-go-cli.html"
+
+$agentsOk = (Test-Path (Join-Path $HarnessRoot "AI\AGENTS.md")) -and ((Test-Path (Join-Path $HarnessRoot "AGENTS.md")) -or (Test-Path (Join-Path $HarnessRoot "templates\AGENTS.pointer.md")))
+Add-Row "cliente agentico" "leer AGENTS.md y orquestar el flujo" "REQ" $(if ($agentsOk) { "OK" } else { "FALTA" }) $(if ($agentsOk) { "AGENTS.md + AI/AGENTS.md presentes; verifica que tu cliente los lea" } else { "falta AGENTS.md o AI/AGENTS.md (reinstala con install.ps1)" }) "https://docs.opencode.ai/ (o tu cliente agéntico)"
+
+# --- OPCIONAL según MVP (promocionable con -Need*) ---
+function Opt-Level($flag) { if ($flag) { "REQ" } else { "OPT" } }
+
+$r = Test-Tool "mbt" @("--version")
+Add-Row "mbt" "construir MTAR (solo si el MVP lo exige)" (Opt-Level $NeedMtar) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://github.com/SAP/cloud-mta-build-tool"
+
+$r = Test-Tool "make" @("--version")
+Add-Row "make" "requerido por mbt en el SO" $(if ($NeedMtar) { "REQ" } else { "OPT" }) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://www.gnu.org/software/make/"
+
+$r = Test-Tool "java" @("-version")
+Add-Row "java" "builds MTA Java (solo si la spec los pide)" (Opt-Level $NeedJava) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://adoptium.net/"
+
+$r = Test-Tool "cds" @("--version")
+if (-not $r.Found) { $r.Detail = "no global; valido via npx -p @sap/cds-dk (solo si la spec exige CAP)" }
+Add-Row "cds" "proyectos CAP (solo si la spec lo exige)" (Opt-Level $NeedCds) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://cap.cloud.sap/docs/get-started/"
+
+$r = Test-Tool "ui5" @("--version")
+Add-Row "ui5" "proyectos UI5/Fiori (solo si la spec lo exige)" $(if ($NeedCds) { "REQ" } else { "OPT" }) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://ui5.github.io/cli/"
+
+$r = Test-Tool "gh" @("--version")
+Add-Row "gh" "repo remoto/PR (solo si la spec pide remoto)" (Opt-Level $NeedGh) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://cli.github.com/"
+
+$r = Test-Tool "op" @("--version")
+Add-Row "op (1Password)" "secretos de equipo (solo si el equipo lo adopta)" (Opt-Level $NeedOp) $(if ($r.Found) { "OK" } else { "FALTA" }) $r.Detail "https://developer.1password.com/docs/cli/get-started/"
+
+# --- Harness: skills, agentes, fragmento MCP (presencia de archivos) ---
+$skills = @()
+$skillsDir = Join-Path $HarnessRoot "AI\.opencode\skills"
+if (Test-Path $skillsDir) { $skills = Get-ChildItem $skillsDir -Directory | Where-Object { Test-Path (Join-Path $_.FullName "SKILL.md") } }
+Add-Row "skills" "capacidades del harness (cf-cli, mta-build, ...)" "OPT" $(if ($skills.Count -gt 0) { "OK" } else { "FALTA" }) "$($skills.Count) skills con SKILL.md" "(vienen con AI/; reinstala con install.ps1 si FALTA)"
+
+$agents = @()
+$agentsDir = Join-Path $HarnessRoot "AI\.opencode\agents"
+if (Test-Path $agentsDir) { $agents = Get-ChildItem $agentsDir -Filter "*.md" }
+Add-Row "agents" "orquestador y especialistas" "OPT" $(if ($agents.Count -gt 0) { "OK" } else { "FALTA" }) "$($agents.Count) agentes .md" "(vienen con AI/; reinstala con install.ps1 si FALTA)"
+
+$frag = Test-Path (Join-Path $HarnessRoot "AI\opencode.fragment.jsonc")
+Add-Row "fragmento MCP" "plantilla MCP del proyecto destino" "OPT" $(if ($frag) { "OK" } else { "FALTA" }) $(if ($frag) { "AI/opencode.fragment.jsonc presente" } else { "no encontrado" }) "(viene con AI/; reinstala con install.ps1 si FALTA)"
+
+# --- Tabla ---
+Write-Output ""
+Write-Output "Prerrequisitos del harness BTP (harness: $HarnessRoot)"
+Write-Output ("{0,-14} | {1,-42} | {2,-5} | {3,-6} | {4}" -f "Herramienta", "Necesaria para", "Nivel", "Estado", "Detalle / Instalacion")
+$rows | ForEach-Object {
+  Write-Output ("{0,-14} | {1,-42} | {2,-5} | {3,-6} | {4} [{5}]" -f $_.Herramienta, $_.NecesariaPara, $_.Nivel, $_.Estado, $_.Detalle, $_.Instalacion)
+}
+Write-Output ""
+Write-Output "NOTA MCPs (no detectables desde shell): tu cliente agentico debe tener configurados"
+Write-Output "sus propios MCPs: context7, codebase-memory, github, playwright, eslint, chrome-devtools."
+Write-Output "Detalle y docs oficiales: AI/docs/prerequisitos.md"
+
+$reqMissing = @($rows | Where-Object { $_.Nivel -eq "REQ" -and $_.Estado -eq "FALTA" })
+$optMissing = @($rows | Where-Object { $_.Nivel -eq "OPT" -and $_.Estado -eq "FALTA" })
+if ($reqMissing.Count -gt 0) {
+  Write-Output ("RESULTADO: FALTAN {0} REQUERIDOS ({1}). Instala y re-ejecuta este script." -f $reqMissing.Count, (($reqMissing | ForEach-Object { $_.Herramienta }) -join ", "))
+  if ($WarnOnly) { exit 0 } else { exit 1 }
+} else {
+  if ($optMissing.Count -gt 0) {
+    Write-Output ("RESULTADO: OK en requeridos. Avisos opcionales ({0}): {1}." -f $optMissing.Count, (($optMissing | ForEach-Object { $_.Herramienta }) -join ", "))
+  } else { Write-Output "RESULTADO: todo OK (requeridos + opcionales presentes)." }
+  exit 0
+}

package/AI/scripts/check-prereqs.sh

@@ -0,0 +1,136 @@
+#!/bin/sh
+# Verificación de prerrequisitos del harness BTP (POSIX sh).
+# Uso: ./check-prereqs.sh [--warn-only] [--need-mtar] [--need-java] [--need-cds] [--need-gh] [--need-op]
+# --need-*: promociona ese opcional a REQUERIDO (cuando la spec del MVP lo exija).
+# --warn-only: nunca falla (exit 0); lo usan install.ps1/install.sh al final.
+# NUNCA imprime secretos: solo ejecuta "<comando> --version" y cuenta archivos.
+# REQUERIDO faltante -> exit 1 (salvo --warn-only). Solo opcionales -> exit 0.
+WARN_ONLY=0; NEED_MTAR=0; NEED_JAVA=0; NEED_CDS=0; NEED_GH=0; NEED_OP=0
+for a in "$@"; do
+  case "$a" in
+    --warn-only) WARN_ONLY=1 ;;
+    --need-mtar) NEED_MTAR=1 ;;
+    --need-java) NEED_JAVA=1 ;;
+    --need-cds) NEED_CDS=1 ;;
+    --need-gh) NEED_GH=1 ;;
+    --need-op) NEED_OP=1 ;;
+    *) echo "ABORT: opción desconocida $a"; exit 1 ;;
+  esac
+done
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+HARNESS_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+N_REQ_MISSING=""; N_OPT_MISSING=0; OPT_NAMES=""
+row() { printf '%-14s | %-42s | %-5s | %-6s | %s [%s]\n' "$1" "$2" "$3" "$4" "$5" "$6"; }
+record() {
+  # record <nivel> <estado> <nombre>
+  if [ "$1" = "REQ" ] && [ "$2" = "FALTA" ]; then
+    if [ -z "$N_REQ_MISSING" ]; then N_REQ_MISSING="$3"; else N_REQ_MISSING="$N_REQ_MISSING, $3"; fi
+  elif [ "$1" = "OPT" ] && [ "$2" = "FALTA" ]; then
+    N_OPT_MISSING=$((N_OPT_MISSING + 1))
+    if [ -z "$OPT_NAMES" ]; then OPT_NAMES="$3"; else OPT_NAMES="$OPT_NAMES, $3"; fi
+  fi
+}
+check_cmd() {
+  # check_cmd <nombre> <args...>: imprime "versión" o "no encontrado en PATH"
+  name="$1"; shift
+  if command -v "$name" >/dev/null 2>&1; then
+    v=$("$name" "$@" 2>&1 | head -n 1)
+    [ -z "$v" ] && v="instalado"
+    printf '%s' "$v"
+    return 0
+  fi
+  printf 'no encontrado en PATH'
+  return 1
+}
+opt_level() { if [ "$1" -eq 1 ]; then printf 'REQ'; else printf 'OPT'; fi; }
+
+echo ""
+echo "Prerrequisitos del harness BTP (harness: $HARNESS_ROOT)"
+printf '%-14s | %-42s | %-5s | %-6s | %s\n' "Herramienta" "Necesaria para" "Nivel" "Estado" "Detalle / Instalacion"
+
+if v=$(check_cmd git --version); then S=OK; else S=FALTA; fi
+row "git" "control de versiones del MVP" "REQ" "$S" "$v" "https://git-scm.com/downloads"; record REQ "$S" git
+
+if v=$(check_cmd node --version); then
+  major=$(printf '%s' "$v" | sed -n 's/^v\?\([0-9][0-9]*\).*/\1/p')
+  if [ -n "$major" ] && [ "$major" -ge 18 ]; then S=OK; else S=FALTA; v="$v (se requiere Node 18+)"; fi
+else S=FALTA; fi
+row "node 18+" "CAP, UI5, mbt, scripts del harness" "REQ" "$S" "$v" "https://nodejs.org/"; record REQ "$S" "node 18+"
+
+if v=$(check_cmd cf --version); then
+  case "$v" in *[Cc][Ff]*version*|*[Cc]loud*[Ff]oundry*) S=OK ;; *) S=FALTA; v="$v (AVISO: no parece el CLI de Cloud Foundry; si 'cf' es otra herramienta, define un alias al CLI real)" ;; esac
+else S=FALTA; fi
+row "cf" "despliegues y lecturas Cloud Foundry" "REQ" "$S" "$v" "https://docs.cloudfoundry.org/cf-cli/install-go-cli.html"; record REQ "$S" cf
+
+if [ -f "$HARNESS_ROOT/AI/AGENTS.md" ] && { [ -f "$HARNESS_ROOT/AGENTS.md" ] || [ -f "$HARNESS_ROOT/templates/AGENTS.pointer.md" ]; }; then
+  S=OK; v="AGENTS.md + AI/AGENTS.md presentes; verifica que tu cliente los lea"
+else
+  S=FALTA; v="falta AGENTS.md o AI/AGENTS.md (reinstala con install.sh)"
+fi
+row "cliente agentico" "leer AGENTS.md y orquestar el flujo" "REQ" "$S" "$v" "https://docs.opencode.ai/ (o tu cliente agéntico)"; record REQ "$S" "cliente agentico"
+
+LVL=$(opt_level $NEED_MTAR)
+if v=$(check_cmd mbt --version); then S=OK; else S=FALTA; fi
+row "mbt" "construir MTAR (solo si el MVP lo exige)" "$LVL" "$S" "$v" "https://github.com/SAP/cloud-mta-build-tool"; record "$LVL" "$S" mbt
+
+if [ "$NEED_MTAR" -eq 1 ]; then LVL=REQ; else LVL=OPT; fi
+if v=$(check_cmd make --version); then S=OK; else S=FALTA; fi
+row "make" "requerido por mbt" "$LVL" "$S" "$v" "https://www.gnu.org/software/make/"; record "$LVL" "$S" make
+
+LVL=$(opt_level $NEED_JAVA)
+if v=$(check_cmd java -version); then S=OK; else S=FALTA; fi
+row "java" "builds MTA Java (solo si la spec los pide)" "$LVL" "$S" "$v" "https://adoptium.net/"; record "$LVL" "$S" java
+
+LVL=$(opt_level $NEED_CDS)
+if v=$(check_cmd cds --version); then S=OK; else S=FALTA; v="no global; valido via npx -p @sap/cds-dk (solo si la spec exige CAP)"; fi
+row "cds" "proyectos CAP (solo si la spec lo exige)" "$LVL" "$S" "$v" "https://cap.cloud.sap/docs/get-started/"; record "$LVL" "$S" cds
+
+if [ "$NEED_CDS" -eq 1 ]; then LVL=REQ; else LVL=OPT; fi
+if v=$(check_cmd ui5 --version); then S=OK; else S=FALTA; fi
+row "ui5" "proyectos UI5/Fiori (solo si la spec lo exige)" "$LVL" "$S" "$v" "https://ui5.github.io/cli/"; record "$LVL" "$S" ui5
+
+LVL=$(opt_level $NEED_GH)
+if v=$(check_cmd gh --version); then S=OK; else S=FALTA; fi
+row "gh" "repo remoto/PR (solo si la spec pide remoto)" "$LVL" "$S" "$v" "https://cli.github.com/"; record "$LVL" "$S" gh
+
+LVL=$(opt_level $NEED_OP)
+if v=$(check_cmd op --version); then S=OK; else S=FALTA; fi
+row "op (1Password)" "secretos de equipo (solo si el equipo lo adopta)" "$LVL" "$S" "$v" "https://developer.1password.com/docs/cli/get-started/"; record "$LVL" "$S" "op (1Password)"
+
+NSKILLS=0
+if [ -d "$HARNESS_ROOT/AI/.opencode/skills" ]; then
+  for d in "$HARNESS_ROOT"/AI/.opencode/skills/*/; do
+    [ -f "${d}SKILL.md" ] && NSKILLS=$((NSKILLS + 1))
+  done
+fi
+if [ "$NSKILLS" -gt 0 ]; then S=OK; else S=FALTA; fi
+row "skills" "capacidades del harness (cf-cli, mta-build, ...)" "OPT" "$S" "$NSKILLS skills con SKILL.md" "(vienen con AI/; reinstala con install.sh si FALTA)"; record OPT "$S" skills
+
+NAGENTS=0
+if [ -d "$HARNESS_ROOT/AI/.opencode/agents" ]; then
+  # shellcheck disable=SC2012
+  NAGENTS=$(ls "$HARNESS_ROOT"/AI/.opencode/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
+fi
+if [ "$NAGENTS" -gt 0 ]; then S=OK; else S=FALTA; fi
+row "agents" "orquestador y especialistas" "OPT" "$S" "$NAGENTS agentes .md" "(vienen con AI/; reinstala con install.sh si FALTA)"; record OPT "$S" agents
+
+if [ -f "$HARNESS_ROOT/AI/opencode.fragment.jsonc" ]; then S=OK; v="AI/opencode.fragment.jsonc presente"; else S=FALTA; v="no encontrado"; fi
+row "fragmento MCP" "plantilla MCP del proyecto destino" "OPT" "$S" "$v" "(viene con AI/; reinstala con install.sh si FALTA)"; record OPT "$S" "fragmento MCP"
+
+echo ""
+echo "NOTA MCPs (no detectables desde shell): tu cliente agéntico debe tener configurados"
+echo "sus propios MCPs: context7, codebase-memory, github, playwright, eslint, chrome-devtools."
+echo "Detalle y docs oficiales: AI/docs/prerequisitos.md"
+
+if [ -n "$N_REQ_MISSING" ]; then
+  echo "RESULTADO: FALTAN REQUERIDOS ($N_REQ_MISSING). Instala y re-ejecuta este script."
+  if [ "$WARN_ONLY" -eq 1 ]; then exit 0; else exit 1; fi
+else
+  if [ "$N_OPT_MISSING" -gt 0 ]; then
+    echo "RESULTADO: OK en requeridos. Avisos opcionales ($N_OPT_MISSING): $OPT_NAMES."
+  else
+    echo "RESULTADO: todo OK (requeridos + opcionales presentes)."
+  fi
+  exit 0
+fi

package/AI/scripts/provision-espacio.template.ps1

@@ -6,7 +6,7 @@
    faltan -> asigna rol solo si falta. Emite SKIP: si existe, CREATE: si crea.
    Allowlist cerrada: target, spaces, space-users, services, marketplace,
    create-space, create-service, set-space-role.
-   PROHIBIDO: delete-*, unbind-*, purge-*, restage-*. Usa sap_cf (nunca cf).
+   PROHIBIDO: delete-*, unbind-*, purge-*, restage-*. Usa cf.
    Cero secretos en repo: solo nombres. #>
 param(
   [string]$Space = "TODO(<paisaje>)",
@@ -17,7 +17,7 @@ param(
 $ErrorActionPreference = "Stop"
 
 function Target-Ok {
-  $t = & sap_cf target 2>&1 | Out-String
+  $t = & cf target 2>&1 | Out-String
   if ($t -notmatch [regex]::Escape($ExpectedApi)) { Write-Output "ABORT: endpoint no coincide (esperado $ExpectedApi)"; return $false }
   if ($t -notmatch [regex]::Escape($ExpectedOrg)) { Write-Output "ABORT: org no coincide (esperada $ExpectedOrg)"; return $false }
   return $true
@@ -26,19 +26,19 @@ function Target-Ok {
 if (-not (Target-Ok)) { exit 1 }
 
 # 1. Espacio: crear solo si falta
-$spaces = & sap_cf spaces 2>&1 | Out-String
+$spaces = & cf spaces 2>&1 | Out-String
 if ($spaces -match "(?m)^\s*$([regex]::Escape($Space))\s*$") {
   Write-Output "SKIP: space $Space ya existe"
 } else {
-  & sap_cf create-space $Space
+  & cf create-space $Space
   Write-Output "CREATE: space $Space"
 }
-& sap_cf target -s $Space | Out-Null
+& cf target -s $Space | Out-Null
 
 # 2. Guardia de marketplace: aborta antes de crear si falta un offering
 # TODO: lista los offerings requeridos, p. ej. @("xsuaa", "destination")
 $RequiredOfferings = @()
-$market = & sap_cf marketplace 2>&1 | Out-String
+$market = & cf marketplace 2>&1 | Out-String
 foreach ($o in $RequiredOfferings) {
   if ($market -notmatch [regex]::Escape($o)) {
     Write-Output "ABORT: offering $o no disponible en marketplace"
@@ -49,12 +49,12 @@ foreach ($o in $RequiredOfferings) {
 # 3. Instancias: crear solo si faltan
 # TODO: anadir una entrada por instancia: @{ Name="TODO"; Offering="TODO"; Plan="TODO" }
 $Instances = @()
-$services = & sap_cf services 2>&1 | Out-String
+$services = & cf services 2>&1 | Out-String
 foreach ($i in $Instances) {
   if ($services -match [regex]::Escape($i.Name)) {
     Write-Output ("SKIP: service {0} ya existe" -f $i.Name)
   } else {
-    & sap_cf create-service $i.Offering $i.Plan $i.Name
+    & cf create-service $i.Offering $i.Plan $i.Name
     Write-Output ("CREATE: service {0}" -f $i.Name)
   }
 }
@@ -62,11 +62,11 @@ foreach ($i in $Instances) {
 # 4. Rol: asignar solo si falta
 # TODO: fijar usuario, p. ej. $User = "TODO"
 $User = "TODO"
-$users = & sap_cf space-users $ExpectedOrg $Space 2>&1 | Out-String
+$users = & cf space-users $ExpectedOrg $Space 2>&1 | Out-String
 if ($users -match [regex]::Escape($User)) {
   Write-Output "SKIP: rol de $User ya asignado"
 } else {
-  & sap_cf set-space-role $User $ExpectedOrg $Space SpaceDeveloper
+  & cf set-space-role $User $ExpectedOrg $Space SpaceDeveloper
   Write-Output "CREATE: rol SpaceDeveloper para $User"
 }