create-harness-btp 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/AI/VERSION +1 -1
  2. package/README.md +29 -15
  3. package/VERSION +1 -1
  4. package/package.json +1 -1
package/AI/VERSION CHANGED
@@ -1 +1 @@
1
- 0.2.1
1
+ 0.2.3
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # harness-btp
2
2
 
3
- [![version](https://img.shields.io/badge/version-v0.2.1-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.1)
3
+ [![version](https://img.shields.io/badge/version-v0.2.3-blue)](https://github.com/horangelmillan/harness-btp/releases/tag/v0.2.3)
4
4
  [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
5
5
  [![platform](https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-lightgrey)](https://github.com/horangelmillan/harness-btp)
6
6
  [![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:
55
55
  PowerShell (Windows):
56
56
 
57
57
  ```powershell
58
- npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
58
+ npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
59
59
  powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
60
60
  Remove-Item -Recurse -Force AI-tmp
61
61
  ```
@@ -63,7 +63,7 @@ Remove-Item -Recurse -Force AI-tmp
63
63
  bash (Linux, macOS o Git Bash):
64
64
 
65
65
  ```bash
66
- npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
66
+ npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
67
67
  sh AI-tmp/install.sh --dest .
68
68
  rm -rf AI-tmp
69
69
  ```
@@ -79,7 +79,7 @@ Descarga solo lo necesario, sin historial git:
79
79
  PowerShell:
80
80
 
81
81
  ```powershell
82
- npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
82
+ npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
83
83
  powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
84
84
  Remove-Item -Recurse -Force AI-tmp
85
85
  ```
@@ -87,7 +87,7 @@ Remove-Item -Recurse -Force AI-tmp
87
87
  bash:
88
88
 
89
89
  ```bash
90
- npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
90
+ npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
91
91
  sh AI-tmp/install.sh --dest .
92
92
  rm -rf AI-tmp
93
93
  ```
@@ -99,7 +99,7 @@ Clon superficial anclado al tag:
99
99
  PowerShell:
100
100
 
101
101
  ```powershell
102
- git clone --branch v0.2.1 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
102
+ git clone --branch v0.2.3 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
103
103
  powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .
104
104
  Remove-Item -Recurse -Force AI-tmp
105
105
  ```
@@ -107,7 +107,7 @@ Remove-Item -Recurse -Force AI-tmp
107
107
  bash:
108
108
 
109
109
  ```bash
110
- git clone --branch v0.2.1 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
110
+ git clone --branch v0.2.3 --depth 1 https://github.com/horangelmillan/harness-btp AI-tmp
111
111
  sh AI-tmp/install.sh --dest .
112
112
  rm -rf AI-tmp
113
113
  ```
@@ -117,7 +117,7 @@ rm -rf AI-tmp
117
117
  Sin descargas manuales (requiere publicar `create-harness-btp` en el registry). Igual en todos los SO:
118
118
 
119
119
  ```bash
120
- pnpm dlx create-harness-btp@0.2.1 --dest .
120
+ pnpm dlx create-harness-btp@0.2.3 --dest .
121
121
  ```
122
122
 
123
123
  ### Qué hace el instalador
@@ -132,17 +132,28 @@ Salida típica en proyecto nuevo:
132
132
  ```text
133
133
  CREATE: AI/
134
134
  CREATE: AGENTS.md
135
- OK: harness v0.2.1 instalado
135
+ OK: harness v0.2.3 instalado
136
136
  ```
137
137
 
138
138
  ## Instalación asistida por agente
139
139
 
140
- Si prefieres que tu agente lo instale por ti, pégale este bloque:
140
+ 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]:
141
141
 
142
142
  ```text
143
- 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.
143
+ 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].
144
+ 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.
145
+ 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).
146
+ 3) PROHIBIDO pisar o borrar: AGENTS.md raíz si ya existe, package.json, mta.yaml, lockfiles.
147
+ 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.
148
+ 5) Si migraste npm→pnpm (import + install + test en verde), borra package-lock.json.
149
+ 6) Corre AI/scripts/check-prereqs (modo aviso) y reporta faltantes.
150
+ 7) Si AI/AGENTS.md trae placeholders por adaptar, dímelos antes de desplegar.
151
+ 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.
152
+ Sin secretos en el reporte. Repórtame: comando ejecutado, salida del instalador, contenido de AI/VERSION, git status y qué quedó pendiente.
144
153
  ```
145
154
 
155
+ Vale para proyecto nuevo (con URL), existente, Windows/Linux/macOS y cualquier cliente que lea este README.
156
+
146
157
  ## Actualizar y desinstalar
147
158
 
148
159
  **Actualizar:** repite el mismo comando de instalación contra el tag nuevo. Sin `-Force` / `--force` lo existente se conserva (`SKIP:`); con fuerza se reemplaza con backup:
@@ -150,7 +161,7 @@ Pégale esto a tu agente: Instala el harness BTP versión 0.2.1 en la raíz del
150
161
  PowerShell:
151
162
 
152
163
  ```powershell
153
- npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
164
+ npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
154
165
  powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest . -Force
155
166
  Remove-Item -Recurse -Force AI-tmp
156
167
  # tu versión anterior queda en AI.bak por si quieres comparar
@@ -159,7 +170,7 @@ Remove-Item -Recurse -Force AI-tmp
159
170
  bash:
160
171
 
161
172
  ```bash
162
- npx -p degit degit horangelmillan/harness-btp#v0.2.1 AI-tmp -- AI-tmp
173
+ npx -p degit degit horangelmillan/harness-btp#v0.2.3 AI-tmp -- AI-tmp
163
174
  sh AI-tmp/install.sh --dest . --force
164
175
  rm -rf AI-tmp
165
176
  # tu versión anterior queda en AI.bak por si quieres comparar
@@ -211,7 +222,7 @@ harness-btp/
211
222
  ├── install.ps1 / install.sh # instaladores idempotentes (SKIP / CREATE / BACKUP / OK)
212
223
  ├── bin/ # ejecutable de create-harness-btp (pnpm dlx)
213
224
  ├── package.json # name create-harness-btp
214
- └── VERSION # 0.2.1
225
+ └── VERSION # 0.2.3
215
226
  ```
216
227
 
217
228
  ## Cómo lo descubre el agente
@@ -232,8 +243,9 @@ Tú no configuras nada: el agente se adapta solo.
232
243
  | Líneas duplicadas en `.gitignore` | edición manual tras la fusión | el instalador fusiona sin duplicar; borra el duplicado a mano |
233
244
  | `ExecutionPolicy` bloquea `install.ps1` | política de PowerShell | `powershell -ExecutionPolicy Bypass -File AI-tmp/install.ps1 -Dest .` (o usa `install.sh` en Git Bash) |
234
245
  | `ABORT: opción desconocida` en `install.sh` | flag inexistente | `sh install.sh --help` lista `--dest`, `--force` |
235
- | `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.2.1` |
246
+ | `degit` falla sin Node | `degit` corre sobre Node 18+ | instala Node o usa `git clone --branch v0.2.3` |
236
247
  | 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` |
248
+ | 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) |
237
249
 
238
250
  ## Compatibilidad
239
251
 
@@ -259,5 +271,7 @@ MIT. Haz lo que quieras con el harness; sin garantía.
259
271
 
260
272
  ## Changelog
261
273
 
274
+ - **v0.2.3** — prompt universal todo-en-uno: clona + instala con la versión que indique el README (nunca caduca), verifica AI/VERSION instalado.
275
+ - **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).
262
276
  - **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`.
263
277
  - **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 CHANGED
@@ -1 +1 @@
1
- 0.2.1
1
+ 0.2.3
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-harness-btp",
3
- "version": "0.2.1",
3
+ "version": "0.2.3",
4
4
  "description": "Instala el harness MVP SAP BTP como carpeta AI/ en cualquier proyecto",
5
5
  "keywords": ["sap-btp", "opencode", "harness", "agents", "scaffolder", "create"],
6
6
  "homepage": "https://github.com/horangelmillan/harness-btp#readme",