dsh-test-drive 0.3.25 → 0.3.26

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 (46) hide show
  1. package/CHANGELOG.md +0 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +548 -0
  4. package/README.es.md +548 -0
  5. package/README.hi.md +548 -0
  6. package/README.md +337 -229
  7. package/README.pt.md +548 -0
  8. package/SECURITY.md +0 -0
  9. package/THIRD_PARTY_NOTICES.md +0 -0
  10. package/cordis.patch.yml +0 -0
  11. package/lib/index.js +1 -1
  12. package/lib/types/batch.d.ts +0 -0
  13. package/lib/types/batch.d.ts.map +0 -0
  14. package/lib/types/capability.d.ts +0 -0
  15. package/lib/types/capability.d.ts.map +0 -0
  16. package/lib/types/command.d.ts +0 -0
  17. package/lib/types/command.d.ts.map +0 -0
  18. package/lib/types/config.d.ts +0 -0
  19. package/lib/types/config.d.ts.map +0 -0
  20. package/lib/types/domain.d.ts +0 -0
  21. package/lib/types/domain.d.ts.map +0 -0
  22. package/lib/types/drive.d.ts +0 -0
  23. package/lib/types/drive.d.ts.map +0 -0
  24. package/lib/types/driver.d.ts +0 -0
  25. package/lib/types/driver.d.ts.map +0 -0
  26. package/lib/types/index.d.ts +0 -0
  27. package/lib/types/index.d.ts.map +0 -0
  28. package/lib/types/report.d.ts +0 -0
  29. package/lib/types/report.d.ts.map +0 -0
  30. package/lib/types/result.d.ts +0 -0
  31. package/lib/types/result.d.ts.map +0 -0
  32. package/lib/types/sanitize.d.ts +0 -0
  33. package/lib/types/sanitize.d.ts.map +0 -0
  34. package/lib/types/session-log.d.ts +0 -0
  35. package/lib/types/session-log.d.ts.map +0 -0
  36. package/lib/types/tools.d.ts +0 -0
  37. package/lib/types/tools.d.ts.map +0 -0
  38. package/lib/types/version.d.ts +1 -1
  39. package/lib/types/version.d.ts.map +0 -0
  40. package/lib/types/workspace.d.ts +0 -0
  41. package/lib/types/workspace.d.ts.map +0 -0
  42. package/package.json +46 -24
  43. package/README-es.md +0 -418
  44. package/README-hi.md +0 -418
  45. package/README-pt.md +0 -418
  46. package/README-zh.md +0 -417
File without changes
File without changes
@@ -4,5 +4,5 @@
4
4
  * The structured report records it as `run.pluginVersion`.
5
5
  * @module dsh-test-drive/version
6
6
  */
7
- export declare const VERSION = "0.3.25";
7
+ export declare const VERSION = "0.3.26";
8
8
  //# sourceMappingURL=version.d.ts.map
File without changes
File without changes
File without changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-test-drive",
3
- "version": "0.3.25",
3
+ "version": "0.3.26",
4
4
  "description": "Isolated install-and-smoke test drives for DeepSeek Harness plugins: installs a repo or npm package into a throwaway DSH_HOME profile, verifies the bundle patch layer and boot logs, records a structured pass/fail result matrix (JSON/Markdown) for scoring pipelines, and quarantines every temp directory it owns",
5
5
  "repository": {
6
6
  "type": "git",
@@ -29,15 +29,37 @@
29
29
  "THIRD_PARTY_NOTICES.md",
30
30
  "SECURITY.md",
31
31
  "README.md",
32
- "README-zh.md",
33
- "README-es.md",
34
- "README-pt.md",
35
- "README-hi.md",
32
+ "README.en.md",
33
+ "README.es.md",
34
+ "README.pt.md",
35
+ "README.hi.md",
36
36
  "LICENSE"
37
37
  ],
38
38
  "dsh": {
39
39
  "bundle": {
40
40
  "patch": "./cordis.patch.yml"
41
+ },
42
+ "capabilities": [
43
+ "fs:read",
44
+ "fs:write",
45
+ "subprocess",
46
+ "tools:register"
47
+ ],
48
+ "labels": [],
49
+ "standards": {
50
+ "schema": "dsh-levels/1",
51
+ "entry": {
52
+ "status": "not-run",
53
+ "evidence": null
54
+ },
55
+ "flow": {
56
+ "status": "not-run",
57
+ "evidence": null
58
+ },
59
+ "boost": {
60
+ "status": "not-measured",
61
+ "evidence": null
62
+ }
41
63
  }
42
64
  },
43
65
  "dshWorkshop": {
@@ -115,29 +137,29 @@
115
137
  "@deepseek-ai/schemastery": "^3.18.5"
116
138
  },
117
139
  "dependencies": {
118
- "zod": "4.4.3"
140
+ "zod": "4.6.6"
119
141
  },
120
142
  "devDependencies": {
121
143
  "@deepseek-ai/cordis": "^4.1.0",
122
144
  "@deepseek-ai/cordis-plugin-include": "^1.1.0",
123
145
  "@deepseek-ai/cordis-plugin-loader": "^1.1.0",
124
- "@deepseek-ai/dsh-agent": "0.2.2-rc.1",
125
- "@deepseek-ai/dsh-attachment": "0.2.2-rc.1",
126
- "@deepseek-ai/dsh-commands": "0.2.2-rc.1",
127
- "@deepseek-ai/dsh-jobs": "0.2.2-rc.1",
128
- "@deepseek-ai/dsh-jobs-local": "0.2.2-rc.1",
129
- "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
130
- "@deepseek-ai/dsh-package-manifest": "0.2.2-rc.1",
131
- "@deepseek-ai/dsh-session": "0.2.2-rc.1",
132
- "@deepseek-ai/dsh-session-projection": "0.2.2-rc.1",
133
- "@deepseek-ai/dsh-storage": "0.2.2-rc.1",
134
- "@deepseek-ai/dsh-storage-domain": "0.2.2-rc.1",
135
- "@deepseek-ai/dsh-subprocess": "0.2.2-rc.1",
136
- "@deepseek-ai/dsh-subprocess-local": "0.2.2-rc.1",
137
- "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.1",
138
- "@deepseek-ai/dsh-tool-executor-native": "0.2.2-rc.1",
139
- "@deepseek-ai/dsh-tools": "0.2.2-rc.1",
140
- "@deepseek-ai/dsh-working-directory": "0.2.2-rc.1",
146
+ "@deepseek-ai/dsh-agent": "0.2.2-rc.3",
147
+ "@deepseek-ai/dsh-attachment": "0.2.2-rc.3",
148
+ "@deepseek-ai/dsh-commands": "0.2.2-rc.3",
149
+ "@deepseek-ai/dsh-jobs": "0.2.2-rc.3",
150
+ "@deepseek-ai/dsh-jobs-local": "0.2.2-rc.3",
151
+ "@deepseek-ai/dsh-llm": "0.2.2-rc.3",
152
+ "@deepseek-ai/dsh-package-manifest": "0.2.2-rc.3",
153
+ "@deepseek-ai/dsh-session": "0.2.2-rc.3",
154
+ "@deepseek-ai/dsh-session-projection": "0.2.2-rc.3",
155
+ "@deepseek-ai/dsh-storage": "0.2.2-rc.3",
156
+ "@deepseek-ai/dsh-storage-domain": "0.2.2-rc.3",
157
+ "@deepseek-ai/dsh-subprocess": "0.2.2-rc.3",
158
+ "@deepseek-ai/dsh-subprocess-local": "0.2.2-rc.3",
159
+ "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.3",
160
+ "@deepseek-ai/dsh-tool-executor-native": "0.2.2-rc.3",
161
+ "@deepseek-ai/dsh-tools": "0.2.2-rc.3",
162
+ "@deepseek-ai/dsh-working-directory": "0.2.2-rc.3",
141
163
  "@deepseek-ai/schemastery": "~3.19.0",
142
164
  "@types/node": "^22.20.5",
143
165
  "@vitest/coverage-v8": "3.2.7",
@@ -145,7 +167,7 @@
145
167
  "tsdown": "^0.23.1",
146
168
  "typescript": "^5.9.0",
147
169
  "vitest": "^3.2.0",
148
- "zod": "4.4.3"
170
+ "zod": "4.6.6"
149
171
  },
150
172
  "scripts": {
151
173
  "build": "node scripts/prepare.mjs",
package/README-es.md DELETED
@@ -1,418 +0,0 @@
1
- <div align="center">
2
-
3
- # 🧪 dsh-test-drive
4
- - **Canal 1024 store**: `npm i -g dsh1024` una vez, luego `dsh1024 plugin --profile web add dsh-test-drive` (cuenta para el ranking de instalaciones de [deepseek1024.com](https://deepseek1024.com)).
5
-
6
- **Pruebas de instalación y arranque aisladas para complementos de DeepSeek Harness.**
7
-
8
- *Instala, prueba, verifica y limpia en un perfil desechable — tu `~/.dsh` real permanece intacto.*
9
-
10
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
11
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
12
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
13
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-test-drive.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
14
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
15
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
16
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-test-drive/actions)
17
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-test-drive?label=version)](https://github.com/PerryLink/dsh-test-drive/releases)
18
- [![npm version](https://img.shields.io/npm/v/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
19
- [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
20
-
21
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
-
23
- ```sh
24
- dsh plugin --profile <name> add dsh-test-drive
25
- ```
26
-
27
-
28
- </div>
29
-
30
- ---
31
-
32
-
33
- **📖 Base de conocimiento del ecosistema** — datos medidos, no marketing: [guía de desarrollo · datos de selección · criterios de mantenimiento](https://perrylink.github.io/dsh-plugin-guide/).
34
-
35
- <!-- star-cta -->
36
- ## Install & uninstall (Instalación y desinstalación)
37
-
38
- ```sh
39
- dsh plugin --profile web add dsh-test-drive # instalar (npm) — o la forma git de arriba
40
- dsh plugin --profile web remove dsh-test-drive # desinstalar
41
- ```
42
-
43
- ## ⭐ 如果它帮到了你
44
-
45
- Este plugin forma parte de la [familia de plugins DSH](https://github.com/PerryLink) (más de 40, todos Apache-2.0). Si te resulta útil, **dale una estrella**: no desbloquea nada, pero ayuda a que la siguiente persona lo encuentre antes.
46
-
47
- *English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
48
-
49
- ## What is dsh-test-drive?
50
-
51
- Pruebas de instalación y arranque aisladas para complementos de DeepSeek Harness.
52
-
53
- Instala, prueba, verifica y limpia en un perfil desechable — tu `~/.dsh` real permanece intacto.
54
-
55
- ![Diagrama de flujo de dsh-test-drive: pregunta → fuentes selladas → informe.](docs/assets/dsh-test-drive-flow.svg)
56
-
57
- *Resumen del flujo: pregunta → fuentes selladas → informe. Los ejemplos siguientes usan la superficie de comandos real.*
58
-
59
-
60
- *La misma ejecución, animada.*
61
-
62
- ## Compatibility (Compatibilidad)
63
-
64
- | Componente | Versión |
65
- |---|---|
66
- | DeepSeek Harness | **`dsh-v0.2.1-alpha.1`** (etiqueta de GitHub, verificado el 2026-09-11: cadena completa de puertas + smoke de instalación de perfil). Líneas de dependencia npm `0.1.2-rc.1` y `0.1.7-rc.2` (dependencias entre pares `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0`). |
67
- | Node.js | `^22.19.0 \|\| >=24.0.0` |
68
- | Gestor de paquetes | `pnpm@11.7.0` |
69
- | Plataforma | Windows / macOS / Linux (complemento solo host) |
70
- | Herramientas externas | CLI `dsh` en PATH (autodetección, shims de npm analizados), `pnpm` en PATH |
71
-
72
- ## What you get (Qué obtienes)
73
-
74
- - Herramienta `test_drive` — un objetivo por el flujo completo: `dsh plugin add` → verificación del parche con `--dump-config` → arranque headless (escaneo de marcadores FAILED + tarea opcional de una frase) → aserción de capacidad opcional → `dsh plugin remove` → limpieza en cuarentena. Devuelve el registro estructurado de forma síncrona, o `{ kind: 'background', jobId }` con `background: true`.
75
- - Comando `/testdrive` — lote de objetivos separados por espacios/comas como tarea en segundo plano `drive-batch` sobre `ctx.jobs`, produciendo un informe matricial (JSON + Markdown).
76
- - Herramienta `drive_report` — recupera cualquier ejecución (`tdr_...`), matriz (`tdm_...`) o la última matriz; se renderiza en Markdown.
77
- - Aserción de capacidad — más allá de “arrancó y salió”: la etapa opcional `capability` hace que el agente llame a la herramienta nombrada (o ejecute `/command`) y verifica que el registro durable de sesión contenga la invocación y que la salida observada contenga `expect`. Un arranque limpio es solo una prueba de humo; `observed` demuestra que una capacidad con nombre realmente funciona.
78
- - Resultados estructurados — cada registro lleva el discriminador `schema: "dsh-test-drive/v1"` con campos de primera clase: `stages.install.status` (`pass`/`fail`), `stages.smoke.status` (`pass`/`fail`/`boot-ok`/`skipped`), `durationMs` por etapa, `summary`/`outputTail` saneados y un `verdict` global (`pass`/`fail`/`partial`/`unknown`). Este es el contrato legible por máquina que consumen los puntuadores (dsh-score).
79
- - Seguridad por construcción — cada directorio temporal lo crea este complemento bajo un prefijo dedicado `dsh-test-drive-`, se registra en un registro de propiedad activo y solo se elimina mediante la escalera dry-run → renombrado a cuarentena → borrado. El perfil del host nunca se lee ni se escribe.
80
-
81
- ## Quick start (Inicio rápido)
82
-
83
- ### Canal git
84
-
85
- ```sh
86
- dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
87
- ```
88
-
89
- El primer `add` falla porque pnpm bloquea la compilación `prepare` del paquete; copia la clave exacta que pnpm imprimió en el `pnpm-workspace.yaml` del perfil y vuelve a ejecutar:
90
-
91
- ```yaml
92
- allowBuilds:
93
- 'dsh-test-drive': true
94
- ```
95
-
96
- ### Canal npm
97
-
98
- ```sh
99
- dsh plugin --profile web add dsh-test-drive
100
- ```
101
-
102
- Los paquetes precompilados no necesitan permiso de compilación. Reinicia el perfil y usa `test_drive` / `/testdrive` desde una sesión.
103
-
104
- ## DSH Desktop no es un host de prueba compatible
105
-
106
- `test_drive` necesita un CLI `dsh` capaz de iniciar un **segundo** proceso headless de DSH.
107
- El lanzador `dsh.CMD` de DSH Desktop solo permite `dsh plugin …`, `--dump-config` y
108
- `--version`; por política rechaza un segundo arranque headless. Configura `config.dshBin`
109
- con un CLI `dsh` instalado por npm/pnpm (o Node + entrada JS de dsh). El error ahora lo dice
110
- explícitamente en lugar de “cannot parse npm shim”.
111
-
112
- ## Configuration (Configuración)
113
-
114
- Todas las claves son opcionales (se muestran los valores por defecto); los valores inválidos fallan ruidosamente al cargar.
115
-
116
- | Clave | Por defecto | Descripción |
117
- |---|---|---|
118
- | `profileName` | `headless` | Plantilla de perfil inicializada dentro de cada DSH_HOME desechable (bundles base + headless). |
119
- | `dshBin` | `""` | Ruta absoluta que reemplaza al ejecutable dsh; vacío autodetecta `dsh` en PATH. |
120
- | `headlessTask` | `"Reply with exactly: ok"` | Tarea de una frase para la etapa de arranque; vacío omite la etapa. |
121
- | `forwardEnv` | `[]` | NOMBRES de variables de entorno (nunca valores) reenviados a los procesos hijos del perfil de prueba. |
122
- | `allowBuilds` | `true` | Permite una compilación `prepare` de git bloqueada en el perfil de prueba y reintenta la instalación una vez. |
123
- | `installTimeoutMs` | `600000` | Plazo de la etapa `dsh plugin add`. |
124
- | `configTimeoutMs` | `60000` | Plazo de la etapa `--dump-config`. |
125
- | `smokeTimeoutMs` | `300000` | Plazo de la etapa de arranque headless. |
126
- | `capabilityTimeoutMs` | `300000` | Plazo de la tarea de aserción de capacidad.
127
- | `capability.enabled` | `false` | Ejecuta la etapa de aserción de capacidad (registrado → invocado → observado).
128
- | `capability.kind` | `tool` | Qué afirmar: `tool` o `command`.
129
- | `capability.name` | `""` | Nombre de herramienta o comando (sin la `/` inicial).
130
- | `capability.args` | `""` | Texto de invocación: argumentos de herramienta (estilo JSON) o palabras del comando.
131
- | `capability.expect` | `""` | Literal esperado en la salida observada (subcadena sin distinción de mayúsculas).
132
- | `uninstallTimeoutMs` | `120000` | Plazo de la etapa `dsh plugin remove`. |
133
- | `outputTailBytes` | `8000` | Límite de la cola de salida saneada registrada por etapa. |
134
- | `keepTempDirs` | `false` | Conserva los directorios temporales ante fallos para análisis forense (se abandona la propiedad; tú limpias). |
135
- | `maxBatchTargets` | `20` | Límite de lote de `/testdrive`. |
136
- | `batchConcurrency` | `1` | Concurrencia del lote (en serie evita contención del almacén pnpm). |
137
-
138
- ## Tools & surfaces (Herramientas y superficies)
139
-
140
- ### `test_drive`
141
-
142
- ```
143
- test_drive(target: string, headlessTask?: string, background?: boolean,
144
- capability?: { kind: 'tool' | 'command', name: string,
145
- args: string, expect: string })
146
- ```
147
-
148
- - `target` — especificación git (`github:owner/repo#sha`, `git+https://...`), nombre npm, ruta local o tarball `.tgz`.
149
- - `capability` — aserción posterior al arranque: el agente llama a `name` (herramienta) con `args` o ejecuta `/name` (comando); la etapa lee el registro durable de sesión y exige que la salida observada contenga `expect`. Requiere `DEEPSEEK_API_KEY` (entorno del host o `forwardEnv`); sin ella, la etapa queda `skipped`, nunca falla.
150
- - Devuelve el registro estructurado completo; ejemplo más abajo.
151
- - `background: true` inicia una tarea `drive-batch` y devuelve su id.
152
-
153
- ### `/testdrive <objetivos...>`
154
-
155
- Inicia una tarea por lotes en segundo plano; el progreso fluye por la salida de la tarea y la última línea nombra el id de matriz para `drive_report`.
156
-
157
- ### `drive_report(id?)`
158
-
159
- Devuelve un registro de ejecución (`tdr_...`), una matriz (`tdm_...`) o — sin id — la última matriz.
160
-
161
- ### Ejemplo de resultado estructurado
162
-
163
- ```json
164
- {
165
- "schema": "dsh-test-drive/v1",
166
- "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
167
- "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
168
- "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.10",
169
- "platform": "win32", "node": "v22.22.3" },
170
- "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
171
- "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
172
- "hasBundleManifest": true } },
173
- "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
174
- "hostHomeTouched": false },
175
- "stages": {
176
- "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
177
- "summary": "install ok after allowBuilds allowance", "outputTail": "",
178
- "allowBuildsNeeded": true },
179
- "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
180
- "summary": "dump ok (exit 0)", "outputTail": "",
181
- "patchEffective": true, "layers": ["dsh-click"] },
182
- "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
183
- "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
184
- "outputTail": "", "bootFailed": false, "taskCompleted": false },
185
- "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
186
- "summary": "tool \"plugin_vet\" called and its result contains the expectation",
187
- "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
188
- "expectMatched": true,
189
- "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
190
- "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
191
- "summary": "remove ok (exit 0)", "outputTail": "" },
192
- "cleanup": { "status": "pass", "quarantined": true, "removed": true,
193
- "summary": "owned temp root quarantined and removed" }
194
- },
195
- "verdict": "pass",
196
- "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
197
- }
198
- ```
199
-
200
- Reglas de veredicto: fallo de instalación, de arranque (`smoke.fail`) o una etapa de capacidad que llegó a `not-registered`/`failed` ⇒ `fail`; instalación aprobada + parche efectivo + arranque limpio (`pass`/`boot-ok`) + desinstalación aprobada ⇒ `pass` (con nota de capacidad cuando `observed`); instalado pero sin alguna garantía posterior ⇒ `partial`; en otro caso ⇒ `unknown`.
201
-
202
- ## CI (GitHub Actions)
203
-
204
- El repositorio incluye un [`action.yml`](action.yml) composite reutilizable con `uses:` en cualquier repositorio de plugins: impulsa el objetivo en un perfil desechable y emite el par de informes que CI consume — Markdown (comentario de PR) y JUnit XML (verificación de estado). Entradas `target` (obligatorio)/`headless-task`/`dsh-version`; salidas `markdown`/`junit`/`verdict`. El drive no requiere clave; solo la aserción de capacidad necesita `DEEPSEEK_API_KEY` y queda `skipped` (nunca falla) sin ella.
205
-
206
- ## Permissions & data (Permisos y datos)
207
-
208
- - Solo se consumen servicios públicos: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`.
209
- - Los informes se guardan en el dominio de almacenamiento `test_drive` (tablas `runs`, `matrices`; puntero de última matriz). Si la composición no tiene `storageDomain` (p. ej. el perfil headless oficial), las herramientas siguen funcionando y la persistencia se desactiva con motivo registrado.
210
- - Los procesos hijos heredan un entorno **sin credenciales**: los secretos del host nunca llegan al perfil probado salvo que los nombres explícitamente en `forwardEnv`. Los valores nunca se registran.
211
- - Todas las cadenas de informes/registros pasan por saneadores puros: literales de token, credenciales en URL y cabeceras bearer se redactan, las rutas raíz temporales se sustituyen por `<testdrive-temp>` y las colas se limitan por bytes.
212
-
213
- ## Security boundaries (Límites de seguridad)
214
-
215
- - **Aislamiento.** Cada prueba se ejecuta dentro de una raíz `mkdtemp` nueva bajo el directorio temporal del SO: un `DSH_HOME` desechable, un directorio de trabajo desechable y un almacén pnpm redirigido. El código del complemento probado solo se ejecuta en ese perfil; tu perfil del host queda intacto.
216
- - **Propiedad.** Un registro activo guarda cada raíz creada por esta instancia. La limpieza rechaza cualquier ruta que no sea hija directa registrada del directorio temporal del SO con el prefijo `dsh-test-drive-` — sin barridos de `%TEMP%`, sin prefijos ajenos, sin rutas del hogar real.
217
- - **Escalera de limpieza.** Antes de cualquier mutación se registra el plan dry-run completo (rutas absolutas). El borrado primero renombra la raíz a un directorio `dsh-test-drive-quarantine-<ts>`, verifica y luego elimina; los fallos dejan el directorio en cuarentena y se informan, nunca se descartan en silencio. La limpieza se ejecuta en un `finally` ante éxito, fallo, timeout y aborto, y de nuevo al desmontar el complemento.
218
- - **`allowBuilds` es un permiso real.** Permitir la compilación `prepare` de un paquete git ejecuta el código de ese paquete en el momento de la instalación. El permiso se limita al perfil desechable, pero prueba solo objetivos de confianza y fija commits.
219
- - **El arranque headless es sin clave por defecto.** La comprobación de arranque no necesita credenciales; completar la tarea sí. Reenvía credenciales explícitamente (`forwardEnv`) y nunca las registres.
220
-
221
- ## Known limitations (Limitaciones conocidas)
222
-
223
- - Instalar objetivos de registro/git requiere acceso a red desde los procesos `dsh`/pnpm hijos.
224
- - La tarea de arranque necesita credenciales del modelo para llegar a `pass`; sin ellas informa el honesto `boot-ok`.
225
- - En composiciones sin `storageDomain` los informes no se persisten (`drive_report` falla honestamente).
226
- - `dsh` debe poder localizarse en PATH (o configura `dshBin`); en Windows el shim `.cmd`/`.bat` de npm se analiza automáticamente; una resolución `.ps1` pide `dshBin`.
227
- - Los lotes se ejecutan en serie por defecto; subir `batchConcurrency` solo afecta a la contención de disco del almacén pnpm, no a la corrección.
228
-
229
- ## Development (Desarrollo)
230
-
231
- ```sh
232
- pnpm install
233
- pnpm run typecheck && pnpm run typecheck:ci && pnpm test
234
- pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
235
- ```
236
-
237
- - `typecheck` resuelve `@deepseek-ai/*` a través del checkout local del harness; `typecheck:ci` comprueba contra los tipos publicados `0.1.7-rc.2`.
238
- - Las pruebas usan la pila real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/almacenamiento con un proveedor de subprocesos guionizado.
239
- - End-to-end con CLI real (requiere red + `dsh` en PATH): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` — prueba el checkout de este propio paquete por el bucle real de instalación y arranque.
240
- - Lanzamiento: `node scripts/release.mjs <x.y.z>` (sube versión, sella CHANGELOG, repite la puerta, commit + tag; nunca hace push).
241
-
242
- ## Topics
243
-
244
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
245
-
246
- ## Contributors (Contribuidores)
247
-
248
- [PerryLink](https://github.com/PerryLink) — diseño e implementación.
249
-
250
- ## PerryLink DSH Plugin Family
251
-
252
- Este proyecto forma parte de la familia de plugins de DeepSeek Harness de [PerryLink](https://github.com/PerryLink). El registro permanece plegado abajo para que cada README conserve una primera pantalla corta; expándelo para ver cada fila y su estado.
253
-
254
- <details>
255
- <summary>Expandir todos los plugins</summary>
256
-
257
- | Plugin | Estado |
258
- |---|---|
259
- | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
260
- | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
261
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
262
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | |
263
- | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
264
- | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
265
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | |
266
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
267
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
268
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
269
- | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
270
- | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
271
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
272
- | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
273
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
274
- | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
275
- | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
276
- | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
277
- | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
278
- | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
279
- | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
280
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
281
- | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
282
- | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
283
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
284
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
285
- | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
286
- | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
287
- | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
288
- | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
289
- | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
290
- | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
291
- | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
292
- | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
293
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
294
- | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
295
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
296
- | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
297
- | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
298
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
299
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
300
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
301
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
302
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
303
- | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
304
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
305
- | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
306
- | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
307
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
308
- | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
309
- | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
310
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
311
- | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
312
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
313
- | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
314
- | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
315
- | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
316
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
317
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
318
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
319
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
320
- | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
321
- | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
322
- | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
323
- | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
324
- | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
325
- | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
326
- | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
327
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
328
- | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
329
- | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
330
- | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
331
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
332
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
333
- | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
334
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
335
- | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
336
- | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
337
- | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
338
- | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
339
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
340
- | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
341
- | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
342
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
343
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
344
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
345
- | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
346
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver el README del repositorio |
347
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver el README del repositorio |
348
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver el README del repositorio |
349
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver el README del repositorio |
350
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver el README del repositorio |
351
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRADO — ver el README del repositorio |
352
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO — ver el README del repositorio |
353
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO — ver el README del repositorio |
354
-
355
- </details>
356
-
357
- ## License (Licencia)
358
-
359
- [Apache-2.0](LICENSE)
360
-
361
- ### Instalar desde el mercado de DSH Desktop
362
-
363
- Todos los plugins de PerryLink pueden explorarse en el mercado integrado de DSH Desktop: **Market → Sources → add source → pegar** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ seleccionarlo**. La instalación sigue pasando por la verificación de identidad npm del mercado y tu confirmación.
364
-
365
- ### Ejemplos
366
-
367
- Son los puntos de entrada reales; instala y llama a uno.
368
-
369
- #### Ejemplo detallado
370
-
371
- **Comando**
372
-
373
- ~~~sh
374
- test_drive({ target: "dsh-click" })
375
- ~~~
376
-
377
- **Salida**
378
-
379
- ~~~text
380
- # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
381
-
382
- - Target: `dsh-click` (npm)
383
- - Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
384
- - Installed: dsh-click@0.2.0
385
- - Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched
386
-
387
- | Stage | Result | Exit | Duration | Summary |
388
- |---|---|---|---|---|
389
- | install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
390
- | config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
391
- | smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
392
- | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
393
- | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
394
- | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
395
- ~~~
396
-
397
- *Observado en `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
398
-
399
- #### Rama de fallo
400
-
401
- **Entrada**
402
-
403
- ~~~text
404
- {"target":" "}
405
- ~~~
406
-
407
- **Salida**
408
-
409
- ~~~text
410
- isError=true; error.message=dsh-test-drive: target must be a non-empty string
411
- ~~~
412
-
413
- *Observado en `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
414
-
415
- #### Ejemplos breves
416
-
417
-
418
-