dsh-test-drive 0.1.0
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.
- package/CHANGELOG.md +19 -0
- package/LICENSE +201 -0
- package/README.es.md +229 -0
- package/README.hi.md +229 -0
- package/README.md +229 -0
- package/README.pt.md +229 -0
- package/README.zh.md +229 -0
- package/SECURITY.md +55 -0
- package/THIRD_PARTY_NOTICES.md +15 -0
- package/cordis.patch.yml +45 -0
- package/lib/index.js +1920 -0
- package/lib/types/batch.d.ts +50 -0
- package/lib/types/batch.d.ts.map +1 -0
- package/lib/types/command.d.ts +22 -0
- package/lib/types/command.d.ts.map +1 -0
- package/lib/types/config.d.ts +109 -0
- package/lib/types/config.d.ts.map +1 -0
- package/lib/types/domain.d.ts +133 -0
- package/lib/types/domain.d.ts.map +1 -0
- package/lib/types/drive.d.ts +65 -0
- package/lib/types/drive.d.ts.map +1 -0
- package/lib/types/driver.d.ts +153 -0
- package/lib/types/driver.d.ts.map +1 -0
- package/lib/types/index.d.ts +49 -0
- package/lib/types/index.d.ts.map +1 -0
- package/lib/types/report.d.ts +18 -0
- package/lib/types/report.d.ts.map +1 -0
- package/lib/types/result.d.ts +254 -0
- package/lib/types/result.d.ts.map +1 -0
- package/lib/types/sanitize.d.ts +58 -0
- package/lib/types/sanitize.d.ts.map +1 -0
- package/lib/types/tools.d.ts +34 -0
- package/lib/types/tools.d.ts.map +1 -0
- package/lib/types/version.d.ts +8 -0
- package/lib/types/version.d.ts.map +1 -0
- package/lib/types/workspace.d.ts +103 -0
- package/lib/types/workspace.d.ts.map +1 -0
- package/package.json +146 -0
package/README.hi.md
ADDED
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# ЁЯзк dsh-test-drive
|
|
4
|
+
|
|
5
|
+
**DeepSeek Harness рдкреНрд▓рдЧрдЗрди рдХреЗ рд▓рд┐рдП рдкреГрдердХ рдЗрдВрд╕реНрдЯреЙрд▓-рдФрд░-рд╕реНрдореЛрдХ рдкрд░реАрдХреНрд╖рдгред**
|
|
6
|
+
|
|
7
|
+
*рдПрдХ рдбрд┐рд╕реНрдкреЛрдЬрд╝реЗрдмрд▓ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдореЗрдВ рдЗрдВрд╕реНрдЯреЙрд▓, рд╕реНрдореЛрдХ, рд╕рддреНрдпрд╛рдкрди рдФрд░ рд╕рдлрд╝рд╛рдИ рдХрд░реЗрдВ тАФ рдЖрдкрдХрд╛ рдЕрд╕рд▓реА `~/.dsh` рдЕрдЫреВрддрд╛ рд░рд╣рддрд╛ рд╣реИред*
|
|
8
|
+
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-test-drive/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-test-drive/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
16
|
+
|
|
17
|
+
[English](README.md) ┬╖ [чоАф╜Уф╕нцЦЗ](README.zh.md) ┬╖ [Espa├▒ol](README.es.md) ┬╖ [Portugu├кs](README.pt.md) ┬╖ [рд╣рд┐рдиреНрджреА](README.hi.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Compatibility (рд╕рдВрдЧрддрддрд╛)
|
|
24
|
+
|
|
25
|
+
| рдШрдЯрдХ | рд╕рдВрд╕реНрдХрд░рдг |
|
|
26
|
+
|---|---|
|
|
27
|
+
| DeepSeek Harness | `0.1.0-rc.6` (peer рдирд┐рд░реНрднрд░рддрд╛рдПрдБ рдкрд┐рди рдХреА рдЧрдИрдВ) |
|
|
28
|
+
| Node.js | `^22.19.0 \|\| >=24.0.0` |
|
|
29
|
+
| рдкреИрдХреЗрдЬ рдкреНрд░рдмрдВрдзрдХ | `pnpm@11.7.0` |
|
|
30
|
+
| рдкреНрд▓реЗрдЯрдлрд╝реЙрд░реНрдо | Windows / macOS / Linux (рдХреЗрд╡рд▓ host рдкреНрд▓рдЧрдЗрди) |
|
|
31
|
+
| рдмрд╛рд╣рд░реА рдЙрдкрдХрд░рдг | PATH рдкрд░ `dsh` CLI (рд╕реНрд╡рддрдГ-рдкрд╣рдЪрд╛рди, npm shim рдкрд╛рд░реНрд╕ рдХрд┐рдП рдЬрд╛рддреЗ рд╣реИрдВ), PATH рдкрд░ `pnpm` |
|
|
32
|
+
|
|
33
|
+
## What you get (рдЖрдкрдХреЛ рдХреНрдпрд╛ рдорд┐рд▓рддрд╛ рд╣реИ)
|
|
34
|
+
|
|
35
|
+
- `test_drive` рдЙрдкрдХрд░рдг тАФ рдПрдХ рд▓рдХреНрд╖реНрдп рдХреЛ рдкреВрд░реА рдкрд╛рдЗрдкрд▓рд╛рдЗрди рд╕реЗ рдЧреБрдЬрд╝рд╛рд░рддрд╛ рд╣реИ: `dsh plugin add` тЖТ `--dump-config` рдкреИрдЪ рдЬрд╛рдБрдЪ тЖТ рд╣реЗрдбрд▓реЗрд╕ рдмреВрдЯ рд╕реНрдореЛрдХ (FAILED рдорд╛рд░реНрдХрд░ рд╕реНрдХреИрди + рд╡реИрдХрд▓реНрдкрд┐рдХ рдПрдХ-рд╡рд╛рдХреНрдп рдХрд╛рд░реНрдп) тЖТ `dsh plugin remove` тЖТ рдХреНрд╡рд╛рд░рдВрдЯреАрди рд╕рдлрд╝рд╛рдИред рд╕рдВрд░рдЪрд┐рдд рд░рд┐рдХреЙрд░реНрдб рд╕рдордХрд╛рд▓рд┐рдХ рд░реВрдк рд╕реЗ рд▓реМрдЯрд╛рддрд╛ рд╣реИ, рдпрд╛ `background: true` рдкрд░ `{ kind: 'background', jobId }`ред
|
|
36
|
+
- `/testdrive` рдХрдорд╛рдВрдб тАФ рд╕реНрдкреЗрд╕/рдХреЙрдорд╛ рд╕реЗ рдЕрд▓рдЧ рдХрд┐рдП рдЧрдП рд▓рдХреНрд╖реНрдпреЛрдВ рдХреА рд╕реВрдЪреА рдХреЛ `ctx.jobs` рдкрд░ `drive-batch` рдкреГрд╖реНрдарднреВрдорд┐ рдХрд╛рд░реНрдп рдХреЗ рд░реВрдк рдореЗрдВ рдЪрд▓рд╛рдХрд░ рдореИрдЯреНрд░рд┐рдХреНрд╕ рд░рд┐рдкреЛрд░реНрдЯ (JSON + Markdown) рдмрдирд╛рддрд╛ рд╣реИред
|
|
37
|
+
- `drive_report` рдЙрдкрдХрд░рдг тАФ рдХрд┐рд╕реА рднреА рд░рди (`tdr_...`), рдореИрдЯреНрд░рд┐рдХреНрд╕ (`tdm_...`) рдпрд╛ рдирд╡реАрдирддрдо рдореИрдЯреНрд░рд┐рдХреНрд╕ рдХреЛ рд▓рд╛рддрд╛ рд╣реИ; Markdown рдореЗрдВ рдкреНрд░рд╕реНрддреБрдд рд╣реЛрддрд╛ рд╣реИред
|
|
38
|
+
- рд╕рдВрд░рдЪрд┐рдд рдкрд░рд┐рдгрд╛рдо тАФ рд╣рд░ рд░рд┐рдХреЙрд░реНрдб рдореЗрдВ рд╡рд┐рднреЗрджрдХ `schema: "dsh-test-drive/v1"` рдФрд░ рдкреНрд░рдердо-рд╢реНрд░реЗрдгреА рдлрд╝реАрд▓реНрдб рд╣реЛрддреЗ рд╣реИрдВ: `stages.install.status` (`pass`/`fail`), `stages.smoke.status` (`pass`/`fail`/`boot-ok`/`skipped`), рдкреНрд░рддрд┐-рдЪрд░рдг `durationMs`, рд╕реИрдирд┐рдЯрд╛рдЗрдЬрд╝ рдХрд┐рдП рдЧрдП `summary`/`outputTail`, рдФрд░ рд╕рдордЧреНрд░ `verdict` (`pass`/`fail`/`partial`/`unknown`)ред рдпрд╣реА рдорд╢реАрди-рдкрдардиреАрдп рдЕрдиреБрдмрдВрдз рд╣реИ рдЬрд┐рд╕реЗ рд╕реНрдХреЛрд░рд┐рдВрдЧ рдкрд╛рдЗрдкрд▓рд╛рдЗрдиреЗрдВ (dsh-score) рдЙрдкрднреЛрдЧ рдХрд░рддреА рд╣реИрдВред
|
|
39
|
+
- рдирд┐рд░реНрдорд╛рдг рд╕реЗ рд╕реБрд░рдХреНрд╖рд╛ тАФ рд╣рд░ рдЕрд╕реНрдерд╛рдпреА рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛ рдЗрд╕ рдкреНрд▓рдЧрдЗрди рджреНрд╡рд╛рд░рд╛ рд╕рдорд░реНрдкрд┐рдд рдЙрдкрд╕рд░реНрдЧ `dsh-test-drive-` рдХреЗ рддрд╣рдд рдмрдирд╛рдИ рдЬрд╛рддреА рд╣реИ, рдПрдХ рд╕рдХреНрд░рд┐рдп рд╕реНрд╡рд╛рдорд┐рддреНрд╡ рд░рдЬрд┐рд╕реНрдЯреНрд░реА рдореЗрдВ рджрд░реНрдЬ рд╣реЛрддреА рд╣реИ, рдФрд░ рдХреЗрд╡рд▓ dry-run тЖТ рдХреНрд╡рд╛рд░рдВрдЯреАрди-рдирд╛рдорд╛рдВрддрд░рдг тЖТ рд╣рдЯрд╛рдиреЗ рдХреА рд╕реАрдврд╝реА рд╕реЗ рд╣рдЯрд╛рдИ рдЬрд╛рддреА рд╣реИред рд╣реЛрд╕реНрдЯ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдХрднреА рдкрдврд╝реА рдпрд╛ рд▓рд┐рдЦреА рдирд╣реАрдВ рдЬрд╛рддреАред
|
|
40
|
+
|
|
41
|
+
## Quick start (рддреНрд╡рд░рд┐рдд рд╢реБрд░реБрдЖрдд)
|
|
42
|
+
|
|
43
|
+
### git рдЪреИрдирд▓
|
|
44
|
+
|
|
45
|
+
```sh
|
|
46
|
+
dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
рдкрд╣рд▓рд╛ `add` рд╡рд┐рдлрд▓ рд╣реЛрддрд╛ рд╣реИ рдХреНрдпреЛрдВрдХрд┐ pnpm рдкреИрдХреЗрдЬ рдХреА `prepare` рдмрд┐рд▓реНрдб рд░реЛрдХрддрд╛ рд╣реИ; pnpm рджреНрд╡рд╛рд░рд╛ рдЫрд╛рдкреА рдЧрдИ рд╕рдЯреАрдХ рдХреБрдВрдЬреА рдХреЛ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдХреЗ `pnpm-workspace.yaml` рдореЗрдВ рдХреЙрдкреА рдХрд░реЗрдВ рдФрд░ рдлрд┐рд░ рдЪрд▓рд╛рдПрдБ:
|
|
50
|
+
|
|
51
|
+
```yaml
|
|
52
|
+
allowBuilds:
|
|
53
|
+
'dsh-test-drive': true
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### npm рдЪреИрдирд▓
|
|
57
|
+
|
|
58
|
+
```sh
|
|
59
|
+
dsh plugin --profile web add dsh-test-drive
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
рдкрд╣рд▓реЗ рд╕реЗ рдмрдиреЗ рдкреИрдХреЗрдЬреЛрдВ рдХреЛ рдмрд┐рд▓реНрдб рдЕрдиреБрдорддрд┐ рдХреА рдЖрд╡рд╢реНрдпрдХрддрд╛ рдирд╣реАрдВ рд╣реЛрддреАред рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдкреБрдирдГ рдЖрд░рдВрдн рдХрд░реЗрдВ, рдлрд┐рд░ рд╕рддреНрд░ рд╕реЗ `test_drive` / `/testdrive` рдЙрдкрдпреЛрдЧ рдХрд░реЗрдВред
|
|
63
|
+
|
|
64
|
+
## Install & uninstall (рдЗрдВрд╕реНрдЯреЙрд▓ рдФрд░ рдЕрдирдЗрдВрд╕реНрдЯреЙрд▓)
|
|
65
|
+
|
|
66
|
+
```sh
|
|
67
|
+
dsh plugin --profile web add dsh-test-drive # рдЗрдВрд╕реНрдЯреЙрд▓ (npm) тАФ рдпрд╛ рдКрдкрд░ рд╡рд╛рд▓рд╛ git рд░реВрдк
|
|
68
|
+
dsh plugin --profile web remove dsh-test-drive # рдЕрдирдЗрдВрд╕реНрдЯреЙрд▓
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Configuration (рд╡рд┐рдиреНрдпрд╛рд╕)
|
|
72
|
+
|
|
73
|
+
рд╕рднреА рдХреБрдВрдЬрд┐рдпрд╛рдБ рд╡реИрдХрд▓реНрдкрд┐рдХ рд╣реИрдВ (рдбрд┐рдлрд╝реЙрд▓реНрдЯ рджрд┐рдЦрд╛рдП рдЧрдП); рдЕрдорд╛рдиреНрдп рдорд╛рди рд▓реЛрдб рдХреЗ рд╕рдордп рдЬрд╝реЛрд░ рд╕реЗ рд╡рд┐рдлрд▓ рд╣реЛрддреЗ рд╣реИрдВред
|
|
74
|
+
|
|
75
|
+
| рдХреБрдВрдЬреА | рдбрд┐рдлрд╝реЙрд▓реНрдЯ | рд╡рд┐рд╡рд░рдг |
|
|
76
|
+
|---|---|---|
|
|
77
|
+
| `profileName` | `headless` | рд╣рд░ рдбрд┐рд╕реНрдкреЛрдЬрд╝реЗрдмрд▓ DSH_HOME рдореЗрдВ рдЖрд░рдВрдн рдХрд┐рдпрд╛ рдЬрд╛рдиреЗ рд╡рд╛рд▓рд╛ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдЯреЗрдореНрдкрд▓реЗрдЯ (base + headless рдмрдВрдбрд▓)ред |
|
|
78
|
+
| `dshBin` | `""` | dsh рдирд┐рд╖реНрдкрд╛рджрдирдпреЛрдЧреНрдп рдХреЗ рд▓рд┐рдП рдирд┐рд░рдкреЗрдХреНрд╖ рдкрде рдУрд╡рд░рд░рд╛рдЗрдб; рдЦрд╛рд▓реА = PATH рдкрд░ `dsh` рд╕реНрд╡рддрдГ-рдкрд╣рдЪрд╛рдиред |
|
|
79
|
+
| `headlessTask` | `"Reply with exactly: ok"` | рдмреВрдЯ-рд╕реНрдореЛрдХ рдЪрд░рдг рдХрд╛ рдПрдХ-рд╡рд╛рдХреНрдп рдХрд╛рд░реНрдп; рдЦрд╛рд▓реА = рдЪрд░рдг рдЫреЛрдбрд╝реЗрдВред |
|
|
80
|
+
| `forwardEnv` | `[]` | рдкрд░реАрдХреНрд╖рдг-рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдЙрдк-рдкреНрд░рдХреНрд░рд┐рдпрд╛рдУрдВ рдореЗрдВ рднреЗрдЬреЗ рдЬрд╛рдиреЗ рд╡рд╛рд▓реЗ рдкрд░реНрдпрд╛рд╡рд░рдг рдЪрд░реЛрдВ рдХреЗ **рдирд╛рдо** (рдорд╛рди рдХрднреА рдирд╣реАрдВ)ред |
|
|
81
|
+
| `allowBuilds` | `true` | рдкрд░реАрдХреНрд╖рдг рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдореЗрдВ рдЕрд╡рд░реБрджреНрдз git `prepare` рдмрд┐рд▓реНрдб рдХреЛ рдЕрдиреБрдорддрд┐ рджреЗрдВ рдФрд░ рдЗрдВрд╕реНрдЯреЙрд▓ рдПрдХ рдмрд╛рд░ рдкреБрдирдГ рдкреНрд░рдпрд╛рд╕ рдХрд░реЗрдВред |
|
|
82
|
+
| `installTimeoutMs` | `600000` | `dsh plugin add` рдЪрд░рдг рдХреА рд╕рдордп-рд╕реАрдорд╛ред |
|
|
83
|
+
| `configTimeoutMs` | `60000` | `--dump-config` рдЪрд░рдг рдХреА рд╕рдордп-рд╕реАрдорд╛ред |
|
|
84
|
+
| `smokeTimeoutMs` | `300000` | рд╣реЗрдбрд▓реЗрд╕ рдмреВрдЯ-рд╕реНрдореЛрдХ рдЪрд░рдг рдХреА рд╕рдордп-рд╕реАрдорд╛ред |
|
|
85
|
+
| `uninstallTimeoutMs` | `120000` | `dsh plugin remove` рдЪрд░рдг рдХреА рд╕рдордп-рд╕реАрдорд╛ред |
|
|
86
|
+
| `outputTailBytes` | `8000` | рдкреНрд░рддрд┐ рдЪрд░рдг рджрд░реНрдЬ рд╕реИрдирд┐рдЯрд╛рдЗрдЬрд╝реНрдб рдЖрдЙрдЯрдкреБрдЯ рдЯреЗрд▓ рдХреА рд╕реАрдорд╛ред |
|
|
87
|
+
| `keepTempDirs` | `false` | рд╡рд┐рдлрд▓рддрд╛ рдкрд░ рдлрд╝реЙрд░реЗрдВрд╕рд┐рдХ рд╣реЗрддреБ рдЕрд╕реНрдерд╛рдпреА рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛рдПрдБ рд░рдЦреЗрдВ (рд╕реНрд╡рд╛рдорд┐рддреНрд╡ рдЫреЛрдбрд╝рд╛ рдЬрд╛рддрд╛ рд╣реИ; рдЖрдк рд╕рд╛рдлрд╝ рдХрд░реЗрдВ)ред |
|
|
88
|
+
| `maxBatchTargets` | `20` | `/testdrive` рдмреИрдЪ рд╕реАрдорд╛ред |
|
|
89
|
+
| `batchConcurrency` | `1` | рдмреИрдЪ рд╕рдорд╛рдирд╛рдВрддрд░рддрд╛ (рдХреНрд░рдорд┐рдХ pnpm-рд╕реНрдЯреЛрд░ рд╡рд┐рд╡рд╛рдж рд╕реЗ рдмрдЪрд╛рддрд╛ рд╣реИ)ред |
|
|
90
|
+
|
|
91
|
+
## Tools & surfaces (рдЙрдкрдХрд░рдг рдФрд░ рд╕рддрд╣реЗрдВ)
|
|
92
|
+
|
|
93
|
+
### `test_drive`
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
test_drive(target: string, headlessTask?: string, background?: boolean)
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
- `target` тАФ git рд╕реНрдкреЗрдХ (`github:owner/repo#sha`, `git+https://...`), npm рдирд╛рдо, рд╕реНрдерд╛рдиреАрдп рдкрде рдпрд╛ `.tgz` рдЯрд╛рд░рдмреЙрд▓ред
|
|
100
|
+
- рдкреВрд░рд╛ рд╕рдВрд░рдЪрд┐рдд рд░рд┐рдХреЙрд░реНрдб рд▓реМрдЯрд╛рддрд╛ рд╣реИ; рдирдореВрдирд╛ рдиреАрдЪреЗред
|
|
101
|
+
- `background: true` рдПрдХ `drive-batch` рдХрд╛рд░реНрдп рдЖрд░рдВрдн рдХрд░ рдЙрд╕рдХрд╛ id рд▓реМрдЯрд╛рддрд╛ рд╣реИред
|
|
102
|
+
|
|
103
|
+
### `/testdrive <рд▓рдХреНрд╖реНрдп...>`
|
|
104
|
+
|
|
105
|
+
рдПрдХ рдкреГрд╖реНрдарднреВрдорд┐ рдмреИрдЪ рдХрд╛рд░реНрдп рдЖрд░рдВрдн рдХрд░рддрд╛ рд╣реИ; рдкреНрд░рдЧрддрд┐ рдХрд╛рд░реНрдп рдЖрдЙрдЯрдкреБрдЯ рд╕реЗ рдкреНрд░рд╡рд╛рд╣рд┐рдд рд╣реЛрддреА рд╣реИ, рдФрд░ рдЕрдВрддрд┐рдо рдкрдВрдХреНрддрд┐ `drive_report` рдХреЗ рд▓рд┐рдП рдореИрдЯреНрд░рд┐рдХреНрд╕ id рдмрддрд╛рддреА рд╣реИред
|
|
106
|
+
|
|
107
|
+
### `drive_report(id?)`
|
|
108
|
+
|
|
109
|
+
рдПрдХ рд░рди рд░рд┐рдХреЙрд░реНрдб (`tdr_...`), рдореИрдЯреНрд░рд┐рдХреНрд╕ (`tdm_...`), рдпрд╛ тАФ рдмрд┐рдирд╛ id тАФ рдирд╡реАрдирддрдо рдореИрдЯреНрд░рд┐рдХреНрд╕ рд▓реМрдЯрд╛рддрд╛ рд╣реИред
|
|
110
|
+
|
|
111
|
+
### рд╕рдВрд░рдЪрд┐рдд рдкрд░рд┐рдгрд╛рдо рдирдореВрдирд╛
|
|
112
|
+
|
|
113
|
+
```json
|
|
114
|
+
{
|
|
115
|
+
"schema": "dsh-test-drive/v1",
|
|
116
|
+
"run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
|
|
117
|
+
"finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
|
|
118
|
+
"harnessVersion": "0.1.0-rc.6", "pluginVersion": "0.1.0",
|
|
119
|
+
"platform": "win32", "node": "v22.22.3" },
|
|
120
|
+
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
|
|
121
|
+
"resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
|
|
122
|
+
"hasBundleManifest": true } },
|
|
123
|
+
"isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
|
|
124
|
+
"hostHomeTouched": false },
|
|
125
|
+
"stages": {
|
|
126
|
+
"install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
|
|
127
|
+
"summary": "install ok after allowBuilds allowance", "outputTail": "",
|
|
128
|
+
"allowBuildsNeeded": true },
|
|
129
|
+
"config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
|
|
130
|
+
"summary": "dump ok (exit 0)", "outputTail": "",
|
|
131
|
+
"patchEffective": true, "layers": ["dsh-click"] },
|
|
132
|
+
"smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
|
|
133
|
+
"summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
|
|
134
|
+
"outputTail": "", "bootFailed": false, "taskCompleted": false },
|
|
135
|
+
"uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
|
|
136
|
+
"summary": "remove ok (exit 0)", "outputTail": "" },
|
|
137
|
+
"cleanup": { "status": "pass", "quarantined": true, "removed": true,
|
|
138
|
+
"summary": "owned temp root quarantined and removed" }
|
|
139
|
+
},
|
|
140
|
+
"verdict": "pass",
|
|
141
|
+
"verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
|
|
142
|
+
}
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
рдирд┐рд░реНрдгрдп рдирд┐рдпрдо: рдЗрдВрд╕реНрдЯреЙрд▓ рд╡рд┐рдлрд▓рддрд╛ рдпрд╛ рдмреВрдЯ рд╡рд┐рдлрд▓рддрд╛ (`smoke.fail`) тЗТ `fail`; рдЗрдВрд╕реНрдЯреЙрд▓ рдкрд╛рд╕ + рдкреИрдЪ рдкреНрд░рднрд╛рд╡реА + рд╕рд╛рдлрд╝ рдмреВрдЯ (`pass`/`boot-ok`) + рдЕрдирдЗрдВрд╕реНрдЯреЙрд▓ рдкрд╛рд╕ тЗТ `pass`; рдЗрдВрд╕реНрдЯреЙрд▓ рд╣реБрдЖ рдкрд░ рдмрд╛рдж рдХреА рдХреЛрдИ рдкреБрд╖реНрдЯрд┐ рдЕрдзреВрд░реА тЗТ `partial`; рдЕрдиреНрдпрдерд╛ тЗТ `unknown`ред
|
|
146
|
+
|
|
147
|
+
## Permissions & data (рдЕрдиреБрдорддрд┐рдпрд╛рдБ рдФрд░ рдбреЗрдЯрд╛)
|
|
148
|
+
|
|
149
|
+
- рдХреЗрд╡рд▓ рд╕рд╛рд░реНрд╡рдЬрдирд┐рдХ рд╕реЗрд╡рд╛рдПрдБ рдЙрдкрднреЛрдЧ рд╣реЛрддреА рд╣реИрдВ: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`ред
|
|
150
|
+
- рд░рд┐рдкреЛрд░реНрдЯреЗрдВ `test_drive` рд╕реНрдЯреЛрд░реЗрдЬ-рдбреЛрдореЗрди (рддрд╛рд▓рд┐рдХрд╛рдПрдБ `runs`, `matrices`; рдирд╡реАрдирддрдо-рдореИрдЯреНрд░рд┐рдХреНрд╕ рд╕рдВрдХреЗрддрдХ) рдореЗрдВ рд░рд╣рддреА рд╣реИрдВред рдЬрдм рд╕рдВрд░рдЪрдирд╛ рдореЗрдВ `storageDomain` рдирд╣реАрдВ рд╣реИ (рдЬреИрд╕реЗ рдЖрдзрд┐рдХрд╛рд░рд┐рдХ рд╣реЗрдбрд▓реЗрд╕ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓), рдЙрдкрдХрд░рдг рдЪрд▓рддреЗ рд░рд╣рддреЗ рд╣реИрдВ рдФрд░ рд░рд┐рдкреЛрд░реНрдЯ рд╕реНрдерд╛рдпрд┐рддреНрд╡ рдХрд╛рд░рдг рд╕рд╣рд┐рдд рдЕрдХреНрд╖рдо рд╣реЛрддрд╛ рд╣реИред
|
|
151
|
+
- рдЙрдк-рдкреНрд░рдХреНрд░рд┐рдпрд╛рдУрдВ рдХреЛ **рдХреНрд░реЗрдбреЗрдВрд╢рд┐рдпрд▓-рд░рд╣рд┐рдд** рд╡рд╛рддрд╛рд╡рд░рдг рдорд┐рд▓рддрд╛ рд╣реИ: рд╣реЛрд╕реНрдЯ рд░рд╣рд╕реНрдп рддрдм рддрдХ рдкрд░реАрдХреНрд╖рд┐рдд рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдореЗрдВ рдирд╣реАрдВ рдкрд╣реБрдБрдЪрддреЗ рдЬрдм рддрдХ рдЖрдк рдЙрдиреНрд╣реЗрдВ `forwardEnv` рдореЗрдВ рдирд╛рдо рди рджреЗрдВред рдорд╛рди рдХрднреА рд▓реЙрдЧ рдирд╣реАрдВ рд╣реЛрддреЗред
|
|
152
|
+
- рд╕рднреА рд░рд┐рдкреЛрд░реНрдЯ/рд▓реЙрдЧ рд╕реНрдЯреНрд░рд┐рдВрдЧ рд╢реБрджреНрдз рд╕реИрдирд┐рдЯрд╛рдЗрдЬрд╝рд░ рд╕реЗ рдЧреБрдЬрд╝рд░рддреА рд╣реИрдВ: рдЯреЛрдХрди рдЕрдХреНрд╖рд░, URL рдХреНрд░реЗрдбреЗрдВрд╢рд┐рдпрд▓ рдФрд░ bearer рд╣реЗрдбрд░ рд░рд┐рдбреИрдХреНрдЯ рд╣реЛрддреЗ рд╣реИрдВ, рдЕрд╕реНрдерд╛рдпреА рд░реВрдЯ рдкрде `<testdrive-temp>` рд╕реЗ рдмрджрд▓реЗ рдЬрд╛рддреЗ рд╣реИрдВ, рдЯреЗрд▓ рдмрд╛рдЗрдЯ-рд╕реАрдорд┐рдд рд╣реЛрддреА рд╣реИрдВред
|
|
153
|
+
|
|
154
|
+
## Security boundaries (рд╕реБрд░рдХреНрд╖рд╛ рд╕реАрдорд╛рдПрдБ)
|
|
155
|
+
|
|
156
|
+
- **рдкреГрдердХреНрдХрд░рдгред** рд╣рд░ рдкрд░реАрдХреНрд╖рдг OS рдЕрд╕реНрдерд╛рдпреА рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛ рдХреЗ рдЕрдВрджрд░ рдирдИ `mkdtemp` рд░реВрдЯ рдореЗрдВ рдЪрд▓рддрд╛ рд╣реИ: рдбрд┐рд╕реНрдкреЛрдЬрд╝реЗрдмрд▓ `DSH_HOME`, рдбрд┐рд╕реНрдкреЛрдЬрд╝реЗрдмрд▓ рдХрд╛рд░реНрдп рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛, рдФрд░ рдкреБрдирд░реНрдирд┐рд░реНрджреЗрд╢рд┐рдд pnpm рд╕реНрдЯреЛрд░ред рдкрд░реАрдХреНрд╖рд┐рдд рдкреНрд▓рдЧрдЗрди рдХрд╛ рдХреЛрдб рдХреЗрд╡рд▓ рдЙрд╕реА рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдореЗрдВ рдЪрд▓рддрд╛ рд╣реИ; рдЖрдкрдХреА рд╣реЛрд╕реНрдЯ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рдЕрдЫреВрддреА рд░рд╣рддреА рд╣реИред
|
|
157
|
+
- **рд╕реНрд╡рд╛рдорд┐рддреНрд╡ред** рдПрдХ рд╕рдХреНрд░рд┐рдп рд░рдЬрд┐рд╕реНрдЯреНрд░реА рдЗрд╕ рдЗрдВрд╕реНрдЯреЗрдВрд╕ рдХреА рдмрдирд╛рдИ рд╣рд░ рд░реВрдЯ рдХреЛ рджрд░реНрдЬ рдХрд░рддреА рд╣реИред рд╕рдлрд╝рд╛рдИ рдХрд┐рд╕реА рднреА рдРрд╕реЗ рдкрде рдХреЛ рдЕрд╕реНрд╡реАрдХрд╛рд░ рдХрд░рддреА рд╣реИ рдЬреЛ `dsh-test-drive-` рдЙрдкрд╕рд░реНрдЧ рдХреЗ рд╕рд╛рде OS рдЕрд╕реНрдерд╛рдпреА рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛ рдХрд╛ рдкрдВрдЬреАрдХреГрдд рдкреНрд░рддреНрдпрдХреНрд╖ рдЙрдк-рдирд┐рд░реНрджреЗрд╢ рди рд╣реЛ тАФ рдХреЛрдИ `%TEMP%` рд╕рдлрд╝рд╛рдИ рдирд╣реАрдВ, рдХреЛрдИ рдкрд░рд╛рдпрд╛ рдЙрдкрд╕рд░реНрдЧ рдирд╣реАрдВ, рдХреЛрдИ рдЕрд╕рд▓реА рд╣реЛрдо рдкрде рдирд╣реАрдВред
|
|
158
|
+
- **рд╕рдлрд╝рд╛рдИ рдХреА рд╕реАрдврд╝реАред** рдХрд┐рд╕реА рднреА рдкрд░рд┐рд╡рд░реНрддрди рд╕реЗ рдкрд╣рд▓реЗ рдкреВрд░реА dry-run рдпреЛрдЬрдирд╛ рд▓реЙрдЧ рд╣реЛрддреА рд╣реИ (рдирд┐рд░рдкреЗрдХреНрд╖ рдкрде)ред рд╣рдЯрд╛рдирд╛ рдкрд╣рд▓реЗ рд░реВрдЯ рдХреЛ `dsh-test-drive-quarantine-<ts>` рдирд╛рдо рд╕реЗ рдХреНрд╡рд╛рд░рдВрдЯреАрди рдХрд░рддрд╛ рд╣реИ, рд╕рддреНрдпрд╛рдкрди рдХрд░рддрд╛ рд╣реИ, рдлрд┐рд░ рд╣рдЯрд╛рддрд╛ рд╣реИ; рд╡рд┐рдлрд▓рддрд╛ рдкрд░ рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛ рдХреНрд╡рд╛рд░рдВрдЯреАрди рд░рд╣рддреА рд╣реИ рдФрд░ рд╕реВрдЪрд┐рдд рд╣реЛрддреА рд╣реИ тАФ рдХрднреА рдЪреБрдкрдЪрд╛рдк рдирд╣реАрдВ рдЫреЛрдбрд╝реА рдЬрд╛рддреАред рд╕рдлрд╝рд╛рдИ рд╕рдлрд▓рддрд╛, рд╡рд┐рдлрд▓рддрд╛, рд╕рдордп-рд╕рдорд╛рдкреНрддрд┐ рдФрд░ рд░рджреНрджреАрдХрд░рдг рдХреЗ рд╣рд░ рд░рд╛рд╕реНрддреЗ рдореЗрдВ `finally` рдореЗрдВ рдЪрд▓рддреА рд╣реИ, рдФрд░ рдкреНрд▓рдЧрдЗрди рд╣рдЯрдиреЗ рдкрд░ рдлрд┐рд░ рдЪрд▓рддреА рд╣реИред
|
|
159
|
+
- **`allowBuilds` рдПрдХ рд╡рд╛рд╕реНрддрд╡рд┐рдХ рдЕрдиреБрдорддрд┐ рд╣реИред** git рдкреИрдХреЗрдЬ рдХреА `prepare` рдмрд┐рд▓реНрдб рдХреА рдЕрдиреБрдорддрд┐ рдЗрдВрд╕реНрдЯреЙрд▓ рдХреЗ рд╕рдордп рдЙрд╕ рдкреИрдХреЗрдЬ рдХрд╛ рдХреЛрдб рдЪрд▓рд╛рдирд╛ рд╣реИред рдЕрдиреБрдорддрд┐ рдХреЗрд╡рд▓ рдбрд┐рд╕реНрдкреЛрдЬрд╝реЗрдмрд▓ рдкреНрд░реЛрдлрд╝рд╛рдЗрд▓ рддрдХ рд╕реАрдорд┐рдд рд╣реИ, рдлрд┐рд░ рднреА рдХреЗрд╡рд▓ рднрд░реЛрд╕реЗрдордВрдж рд▓рдХреНрд╖реНрдпреЛрдВ рдХрд╛ рдкрд░реАрдХреНрд╖рдг рдХрд░реЗрдВ рдФрд░ commit рдкрд┐рди рдХрд░реЗрдВред
|
|
160
|
+
- **рд╣реЗрдбрд▓реЗрд╕ рд╕реНрдореЛрдХ рдбрд┐рдлрд╝реЙрд▓реНрдЯ рд░реВрдк рд╕реЗ рдХреБрдВрдЬреА-рд░рд╣рд┐рдд рд╣реИред** рдмреВрдЯ рдЬрд╛рдБрдЪ рдХреЛ рдХреНрд░реЗрдбреЗрдВрд╢рд┐рдпрд▓ рдирд╣реАрдВ рдЪрд╛рд╣рд┐рдП; рдПрдХ-рд╡рд╛рдХреНрдп рдХрд╛рд░реНрдп рдкреВрд░рд╛ рдХрд░рдиреЗ рдХреЛ рдЪрд╛рд╣рд┐рдПред рдХреНрд░реЗрдбреЗрдВрд╢рд┐рдпрд▓ рд╕реНрдкрд╖реНрдЯ рд░реВрдк рд╕реЗ рднреЗрдЬреЗрдВ (`forwardEnv`) рдФрд░ рдЙрдиреНрд╣реЗрдВ рдХрднреА рд▓реЙрдЧ рди рдХрд░реЗрдВред
|
|
161
|
+
|
|
162
|
+
## Known limitations (рдЬреНрдЮрд╛рдд рд╕реАрдорд╛рдПрдБ)
|
|
163
|
+
|
|
164
|
+
- рд░рдЬрд┐рд╕реНрдЯреНрд░реА/git рд▓рдХреНрд╖реНрдп рдЗрдВрд╕реНрдЯреЙрд▓ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП рдЙрдк-рдкреНрд░рдХреНрд░рд┐рдпрд╛ `dsh`/pnpm рдХреЛ рдиреЗрдЯрд╡рд░реНрдХ рдЪрд╛рд╣рд┐рдПред
|
|
165
|
+
- рд╕реНрдореЛрдХ рдХрд╛рд░реНрдп рдХреЛ `pass` рддрдХ рдкрд╣реБрдБрдЪрдиреЗ рдХреЗ рд▓рд┐рдП рдореЙрдбрд▓ рдХреНрд░реЗрдбреЗрдВрд╢рд┐рдпрд▓ рдЪрд╛рд╣рд┐рдП; рдмрд┐рдирд╛ рдЙрдирдХреЗ рдпрд╣ рдИрдорд╛рдирджрд╛рд░ `boot-ok` рджрд░реНрдЬ рдХрд░рддрд╛ рд╣реИред
|
|
166
|
+
- `storageDomain` рд░рд╣рд┐рдд рд╕рдВрд░рдЪрдирд╛рдУрдВ рдореЗрдВ рд░рд┐рдкреЛрд░реНрдЯреЗрдВ рд╕реНрдерд╛рдпреА рдирд╣реАрдВ рд╣реЛрддреАрдВ (`drive_report` рдИрдорд╛рдирджрд╛рд░реА рд╕реЗ рд╡рд┐рдлрд▓ рд╣реЛрддрд╛ рд╣реИ)ред
|
|
167
|
+
- `dsh` PATH рдкрд░ рдорд┐рд▓рдирд╛ рдЪрд╛рд╣рд┐рдП (рдпрд╛ `dshBin` рд╕реЗрдЯ рдХрд░реЗрдВ); Windows рдкрд░ npm рдХрд╛ `.cmd`/`.bat` shim рд╕реНрд╡рддрдГ рдкрд╛рд░реНрд╕ рд╣реЛрддрд╛ рд╣реИ, рдХреЗрд╡рд▓ `.ps1` рдорд┐рд▓рдиреЗ рдкрд░ `dshBin` рдорд╛рдБрдЧрд╛ рдЬрд╛рддрд╛ рд╣реИред
|
|
168
|
+
- рдмреИрдЪ рдбрд┐рдлрд╝реЙрд▓реНрдЯ рд░реВрдк рд╕реЗ рдХреНрд░рдорд┐рдХ рдЪрд▓рддреЗ рд╣реИрдВ; `batchConcurrency` рдмрдврд╝рд╛рдиреЗ рд╕реЗ рдХреЗрд╡рд▓ pnpm-рд╕реНрдЯреЛрд░ рдбрд┐рд╕реНрдХ рд╡рд┐рд╡рд╛рдж рдкреНрд░рднрд╛рд╡рд┐рдд рд╣реЛрддрд╛ рд╣реИ, рд╢реБрджреНрдзрддрд╛ рдирд╣реАрдВред
|
|
169
|
+
|
|
170
|
+
## Development (рд╡рд┐рдХрд╛рд╕)
|
|
171
|
+
|
|
172
|
+
```sh
|
|
173
|
+
pnpm install
|
|
174
|
+
pnpm run typecheck && pnpm run typecheck:ci && pnpm test
|
|
175
|
+
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
- `typecheck` рд╕реНрдерд╛рдиреАрдп harness рдЪреЗрдХрдЖрдЙрдЯ рд╕реЗ `@deepseek-ai/*` рд╣рд▓ рдХрд░рддрд╛ рд╣реИ; `typecheck:ci` рдкреНрд░рдХрд╛рд╢рд┐рдд `0.1.0-rc.6` рдкреНрд░рдХрд╛рд░реЛрдВ рд╕реЗ рдЬрд╛рдБрдЪрддрд╛ рд╣реИред
|
|
179
|
+
- рдкрд░реАрдХреНрд╖рдг рд╡рд╛рд╕реНрддрд╡рд┐рдХ `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/рд╕реНрдЯреЛрд░реЗрдЬ рд╕реНрдЯреИрдХ рдФрд░ рдПрдХ рд╕реНрдХреНрд░рд┐рдкреНрдЯреЗрдб subprocess рдкреНрд░рджрд╛рддрд╛ рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рддреЗ рд╣реИрдВред
|
|
180
|
+
- рд╡рд╛рд╕реНрддрд╡рд┐рдХ-CLI рдПрдВрдб-рдЯреВ-рдПрдВрдб (рдиреЗрдЯрд╡рд░реНрдХ + PATH рдкрд░ `dsh` рдЖрд╡рд╢реНрдпрдХ): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` тАФ рдЗрд╕реА рдкреИрдХреЗрдЬ рдХреЗ рдЪреЗрдХрдЖрдЙрдЯ рдХреЛ рд╡рд╛рд╕реНрддрд╡рд┐рдХ рдЗрдВрд╕реНрдЯреЙрд▓-рд╕реНрдореЛрдХ рд▓реВрдк рд╕реЗ рдкрд░рдЦрддрд╛ рд╣реИред
|
|
181
|
+
- рд░рд┐рд▓реАрдЬрд╝: `node scripts/release.mjs <x.y.z>` (рд╕рдВрд╕реНрдХрд░рдг рдмрдврд╝рд╛рддрд╛, CHANGELOG рдореБрд╣рд░ рд▓рдЧрд╛рддрд╛, рджреНрд╡рд╛рд░ рдлрд┐рд░ рдЪрд▓рд╛рддрд╛, commit + tag; рдХрднреА push рдирд╣реАрдВ)ред
|
|
182
|
+
|
|
183
|
+
## Topics
|
|
184
|
+
|
|
185
|
+
`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
|
|
186
|
+
|
|
187
|
+
## Contributors (рдпреЛрдЧрджрд╛рдирдХрд░реНрддрд╛)
|
|
188
|
+
|
|
189
|
+
[PerryLink](https://github.com/PerryLink) тАФ рдбрд┐рдЬрд╝рд╛рдЗрди рдФрд░ рдХрд╛рд░реНрдпрд╛рдиреНрд╡рдпрдиред
|
|
190
|
+
|
|
191
|
+
## PerryLink DSH Plugin Family
|
|
192
|
+
|
|
193
|
+
рдпрд╣ рдкреНрд░реЛрдЬреЗрдХреНрдЯ [PerryLink](https://github.com/PerryLink) рджреНрд╡рд╛рд░рд╛ рдЕрдиреБрд░рдХреНрд╖рд┐рдд [29 DeepSeek Harness рдкреНрд▓рдЧрдЗрдиреЛрдВ](https://github.com/PerryLink) рдореЗрдВ рд╕реЗ рдПрдХ рд╣реИред рдЕрдЧрд░ рдпрд╣ рдЖрдкрдХреА рдорджрдж рдХрд░рддрд╛ рд╣реИ, рддреЛ рдмрд╛рдХреА рднреА рдХрд░реЗрдВрдЧреЗ:
|
|
194
|
+
|
|
195
|
+
| Plugin | One-liner |
|
|
196
|
+
|---|---|
|
|
197
|
+
| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | рдЕрдиреБрдореЛрджрди рд╢реНрд░реГрдВрдЦрд▓рд╛ рдкрд░ рджреВрд╕рд░реЗ рдореЙрдбрд▓ рд╕реЗ рд╕реНрд╡рддрдГ-рд╕рдореАрдХреНрд╖рд╛, рдбрд┐рдлрд╝реЙрд▓реНрдЯ рд░реВрдк рд╕реЗ рдЕрд╕рдлрд▓-рдмрдВрдж |
|
|
198
|
+
| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Web UI рд╕рд╛рдЗрдбрдмрд╛рд░, рд╕рдВрджреЗрд╢ рдФрд░ рд░реБрдХрд╛рд╡рдЯ рдХреЗ рд╕рд╛рде рд╕реНрдерд╛рдпреА рдкреГрд╖реНрдарднреВрдорд┐ рдЪрд╛рдЗрд▓реНрдб рдПрдЬреЗрдВрдЯ |
|
|
199
|
+
| [dsh-budget](https://github.com/PerryLink/dsh-budget) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рд▓рд╛рдЧрдд рдкреНрд░рд╢рд╛рд╕рди: рдмрдЬрдЯ, рдХрд╛рд░реНрдмрди рдФрд░ рд╡рд┐рд▓рдВрдмрддрд╛ рдПрдХ рдкреИрдирд▓ рдореЗрдВред |
|
|
200
|
+
| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-рд╕рдорддреБрд▓реНрдп: рд╕реНрдиреИрдкрд╢реЙрдЯ, рд╕рддреНрд░ рдлреЛрд░реНрдХ, рдПрдХ-рдмрд╛рд░ рдкреБрдирд░реНрд╕реНрдерд╛рдкрди |
|
|
201
|
+
| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Claude Code рд╕рддреНрд░, рд╕реНрдореГрддрд┐, skills рдФрд░ CLAUDE.md рдХреЛ DSH рдореЗрдВ рд╕реНрдерд╛рдирд╛рдВрддрд░рд┐рдд рдХрд░реЗрдВ |
|
|
202
|
+
| [dsh-click](https://github.com/PerryLink/dsh-click) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рдХреНрд░реЙрд╕-рдкреНрд▓реЗрдЯрдлрд╝реЙрд░реНрдо рдиреЗрдЯрд┐рд╡ рдбреЗрд╕реНрдХрдЯреЙрдк рдирд┐рдпрдВрддреНрд░рдг тАФ Windows рдкрд╣рд▓реЗред |
|
|
203
|
+
| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web рдХрдВрдкреЛрдЬрд╝рд░ рдХреЗ рд▓рд┐рдП рдЯрд░реНрдорд┐рдирд▓-рд╢реИрд▓реА рдЗрдирдкреБрдЯ рдЗрддрд┐рд╣рд╛рд╕: рддреАрд░, Ctrl+R рдЦреЛрдЬ |
|
|
204
|
+
| [dsh-defend](https://github.com/PerryLink/dsh-defend) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рдкреНрд░реЙрдореНрдкреНрдЯ-рдЗрдВрдЬреЗрдХреНрд╢рди, рдЬреЗрд▓рдмреНрд░реЗрдХ рдФрд░ рд╕реАрдХреНрд░реЗрдЯ-рд▓реАрдХ рд░рдХреНрд╖рд╛ред |
|
|
205
|
+
| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | рдЗрдВрдЬреАрдирд┐рдпрд░рд┐рдВрдЧ-рдЕрдиреБрд╢рд╛рд╕рди рдЧрд╛рд░реНрдб: рдЖрд╡рд╢реНрдпрдХрддрд╛рдПрдБ рдкреВрдЫрддрд╛рдЫ, рдкрд░реАрдХреНрд╖рдг рджреНрд╡рд╛рд░, рд╡рд┐рд░реЛрдзреА рд╕рдореАрдХреНрд╖рд╛ |
|
|
206
|
+
| [dsh-draw](https://github.com/PerryLink/dsh-draw) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рдПрдХреАрдХреГрдд рд╕реНрдереИрддрд┐рдХ-рдЫрд╡рд┐ рдирд┐рд░реНрдорд╛рдг рд░реВрдЯрд┐рдВрдЧред |
|
|
207
|
+
| [dsh-fast](https://github.com/PerryLink/dsh-fast) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рдХреЗрд╡рд▓-рдкрдарди рдкреНрд░рджрд░реНрд╢рди рдирд┐рджрд╛рдиред |
|
|
208
|
+
| [dsh-github](https://github.com/PerryLink/dsh-github) | DSH рдХреЗ рд▓рд┐рдП GitHub PR/issues рдПрдХреАрдХрд░рдг, рд╣рд░ рд▓реЗрдЦрди рдЕрдиреБрдореЛрджрди-рджреНрд╡рд╛рд░рд┐рдд |
|
|
209
|
+
| [dsh-library](https://github.com/PerryLink/dsh-library) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рд╕реНрдерд╛рдиреАрдп рджрд╕реНрддрд╛рд╡реЗрдЬрд╝ рдЬреНрдЮрд╛рдирдХреЛрд╢ред |
|
|
210
|
+
| [dsh-local-ai](https://github.com/PerryLink/dsh-local-ai) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рд╕реНрдерд╛рдиреАрдп-рдореЙрдбрд▓ (Ollama) рдПрдХреАрдХрд░рдгред |
|
|
211
|
+
| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | рднрд╛рд╖рд╛ рд╕рд░реНрд╡рд░реЛрдВ рдкрд░ LSP рдирд┐рджрд╛рди, рдлрд╝реЙрд░реНрдореЗрдЯрд┐рдВрдЧ, рдкреВрд░реНрдгрддрд╛, рдХреЛрдб рдХреНрд░рд┐рдпрд╛рдПрдБ рдФрд░ рдирд╛рдо рдмрджрд▓рдирд╛ |
|
|
212
|
+
| [dsh-mask](https://github.com/PerryLink/dsh-mask) | DeepSeek Harness рдХреЗ рд▓рд┐рдП PII рдорд╛рд╕реНрдХрд┐рдВрдЧ рдорд┐рдбрд▓рд╡реЗрдпрд░ тАФ рдореЙрдбрд▓ рддрдХ рдкрд╣реБрдБрдЪрдиреЗ рд╕реЗ рдкрд╣рд▓реЗ рд╡реНрдпрдХреНрддрд┐рдЧрдд рдбреЗрдЯрд╛ рдЕрдирд╛рдо рдХрд░рддрд╛ рд╣реИ, рдкреНрд░рджрд░реНрд╢рди рдкрд░рдд рдкрд░ рдмрд╣рд╛рд▓ рдХрд░рддрд╛ рд╣реИред |
|
|
213
|
+
| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | рдХреЗрд╡рд▓-рдкрдарди MCP рд░рдирдЯрд╛рдЗрдо рдкреИрдирд▓: /mcp рдХрдорд╛рдВрдб + рд╕реНрдерд┐рддрд┐, рдЯреВрд▓ рдФрд░ рддреНрд░реБрдЯрд┐рдпреЛрдВ рд╡рд╛рд▓рд╛ рд╕реЗрдЯрд┐рдВрдЧ рдЯреИрдм |
|
|
214
|
+
| [dsh-memento](https://github.com/PerryLink/dsh-memento) | рдЕрдиреБрдореЛрджрди-рджреНрд╡рд╛рд░рд┐рдд рдХреНрд░реЙрд╕-рд╕рддреНрд░ рд╕реНрдореГрддрд┐: ctx.memory seam + SQLite + memory рдЯреВрд▓ |
|
|
215
|
+
| [dsh-observe](https://github.com/PerryLink/dsh-observe) | DeepSeek Harness рдХреЗ рд▓рд┐рдП OpenTelemetry рдФрд░ Langfuse рдЕрд╡рд▓реЛрдХрдиреАрдпрддрд╛ рдирд┐рд░реНрдпрд╛рддрдХред |
|
|
216
|
+
| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles-рд╕рдорддреБрд▓реНрдп рд░рдирдЯрд╛рдЗрдо рд╢реИрд▓реА рд╕реНрд╡рд┐рдЪрд┐рдВрдЧ |
|
|
217
|
+
| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-рд╢реИрд▓реА рдШреЛрд╖рдгрд╛рддреНрдордХ allow/deny/ask рдЕрдиреБрдорддрд┐ рдирд┐рдпрдо, рдСрдбрд┐рдЯ рдХреЗ рд╕рд╛рде |
|
|
218
|
+
| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | рдорд╛рдБрдЧ-рдкрд░ рдПрдЬреЗрдВрдЯ рд╕реНрдХрд┐рд▓ рдХреЗ рд░реВрдк рдореЗрдВ рдкреНрд▓рдЧрдЗрди-рд╡рд┐рдХрд╛рд╕ рдЬреНрдЮрд╛рдирдХреЛрд╢ |
|
|
219
|
+
| [dsh-score](https://github.com/PerryLink/dsh-score) | DeepSeek Harness рдкреНрд▓рдЧрдЗрдиреЛрдВ рдХреЗ рд▓рд┐рдП рдмрд╣реБ-рдЖрдпрд╛рдореА рдЧреБрдгрд╡рддреНрддрд╛ рд╕реНрдХреЛрд░рд┐рдВрдЧред |
|
|
220
|
+
| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Web рд╕рд╛рдЗрдбрдмрд╛рд░ рдореЗрдВ рд╕рддреНрд░ рдкрд┐рди рдХрд░реЗрдВ, рд╕реНрдерд╛рдпреА рдХреНрд░рдо рдХреЗ рд╕рд╛рде |
|
|
221
|
+
| [dsh-session-sync](https://github.com/PerryLink/dsh-session-sync) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рдХреНрд░реЙрд╕-рдбрд┐рд╡рд╛рдЗрд╕ рд╕рддреНрд░ рд╕рд┐рдВрдХ тАФ рдЖрдкрдХреЗ рд╕рддреНрд░ рд╕реНрдЯреЛрд░ рдХрд╛ рдПрдХ рд╕рдорд░реНрдкрд┐рдд git рдорд┐рд░рд░ред |
|
|
222
|
+
| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | рд╕реБрд░рдХреНрд╖рд╛-рдСрдбрд┐рдЯ рд╕реНрдХрд┐рд▓ рдкреИрдХ: рд╕реАрдХреНрд░реЗрдЯ рд╕реНрдХреИрди, рдирд┐рд░реНрднрд░рддрд╛ рдФрд░ рдЖрдкреВрд░реНрддрд┐-рд╢реНрд░реГрдВрдЦрд▓рд╛ рд╕рдореАрдХреНрд╖рд╛ |
|
|
223
|
+
| [dsh-talk](https://github.com/PerryLink/dsh-talk) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рдЖрд╡рд╛рдЬрд╝-рдкреНрд░рдердо рд╕рддреНрд░ рд▓реВрдк: рдмреЛрд▓реЗрдВ рдФрд░ рдЙрддреНрддрд░ рд╕реБрдиреЗрдВред |
|
|
224
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | DeepSeek Harness рдкреНрд▓рдЧрдЗрдиреЛрдВ рдХреЗ рд▓рд┐рдП рдкреГрдердХ рдЗрдВрд╕реНрдЯреЙрд▓-рдФрд░-рд╕реНрдореЛрдХ рдкрд░реАрдХреНрд╖рдгред |
|
|
225
|
+
| [dsh-translate](https://github.com/PerryLink/dsh-translate) | DeepSeek Harness рдХреЗ рд▓рд┐рдП рд╡реЗрдВрдбрд░ рдкреИрд░рд╛рдореАрдЯрд░ рдЕрдиреБрд╡рд╛рдж рдФрд░ рдирд┐рдпрддрд╛рддреНрдордХ JSON рдорд░рдореНрдорддред |
|
|
226
|
+
|
|
227
|
+
## License (рд▓рд╛рдЗрд╕реЗрдВрд╕)
|
|
228
|
+
|
|
229
|
+
[Apache-2.0](LICENSE)
|
package/README.md
ADDED
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# ЁЯзк dsh-test-drive
|
|
4
|
+
|
|
5
|
+
**Isolated install-and-smoke test drives for DeepSeek Harness plugins.**
|
|
6
|
+
|
|
7
|
+
*Install, smoke, verify, and clean up in a throwaway profile тАФ your real `~/.dsh` stays untouched.*
|
|
8
|
+
|
|
9
|
+
[](LICENSE)
|
|
10
|
+
[](https://github.com/topics/dsh-plugin)
|
|
11
|
+
[](#)
|
|
12
|
+
[](https://github.com/PerryLink/dsh-test-drive/actions)
|
|
13
|
+
[](https://github.com/PerryLink/dsh-test-drive/releases)
|
|
14
|
+
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
15
|
+
[](https://www.npmjs.com/package/dsh-test-drive)
|
|
16
|
+
|
|
17
|
+
[English](README.md) ┬╖ [чоАф╜Уф╕нцЦЗ](README.zh.md) ┬╖ [Espa├▒ol](README.es.md) ┬╖ [Portugu├кs](README.pt.md) ┬╖ [рд╣рд┐рдиреНрджреА](README.hi.md)
|
|
18
|
+
|
|
19
|
+
</div>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Compatibility
|
|
24
|
+
|
|
25
|
+
| Component | Version |
|
|
26
|
+
|---|---|
|
|
27
|
+
| DeepSeek Harness | `0.1.0-rc.6` (peer dependencies pinned) |
|
|
28
|
+
| Node.js | `^22.19.0 \|\| >=24.0.0` |
|
|
29
|
+
| Package manager | `pnpm@11.7.0` |
|
|
30
|
+
| Platform | Windows / macOS / Linux (host-only plugin) |
|
|
31
|
+
| External tools | `dsh` CLI on PATH (auto-detected, npm shims parsed), `pnpm` on PATH |
|
|
32
|
+
|
|
33
|
+
## What you get
|
|
34
|
+
|
|
35
|
+
- `test_drive` tool тАФ one target through the complete pipeline: `dsh plugin add` тЖТ `--dump-config` patch check тЖТ headless boot smoke (FAILED-marker scan + optional one-shot task) тЖТ `dsh plugin remove` тЖТ quarantined cleanup. Returns the structured record synchronously, or `{ kind: 'background', jobId }` with `background: true`.
|
|
36
|
+
- `/testdrive` command тАФ batch drive of a whitespace/comma-separated target list as a `drive-batch` background job over `ctx.jobs`, producing a matrix report (JSON + Markdown).
|
|
37
|
+
- `drive_report` tool тАФ fetch any stored run (`tdr_...`), matrix (`tdm_...`), or the latest matrix; rendered as Markdown.
|
|
38
|
+
- Structured results тАФ every record carries the discriminator `schema: "dsh-test-drive/v1"` with first-class fields: `stages.install.status` (`pass`/`fail`), `stages.smoke.status` (`pass`/`fail`/`boot-ok`/`skipped`), per-stage `durationMs`, sanitized `summary`/`outputTail`, and an overall `verdict` (`pass`/`fail`/`partial`/`unknown`). This is the machine-readable contract downstream scorers (dsh-score) consume.
|
|
39
|
+
- Safety by construction тАФ every temp directory is created by this plugin under a dedicated `dsh-test-drive-` prefix, tracked in a live ownership registry, and removed only through a dry-run тЖТ quarantine-rename тЖТ delete ladder. The host profile is never read or written.
|
|
40
|
+
|
|
41
|
+
## Quick start
|
|
42
|
+
|
|
43
|
+
### Git channel
|
|
44
|
+
|
|
45
|
+
```sh
|
|
46
|
+
dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The first `add` fails because pnpm blocks the package's `prepare` build; copy the exact key pnpm printed into the profile's `pnpm-workspace.yaml` and re-run:
|
|
50
|
+
|
|
51
|
+
```yaml
|
|
52
|
+
allowBuilds:
|
|
53
|
+
'dsh-test-drive': true
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### npm channel
|
|
57
|
+
|
|
58
|
+
```sh
|
|
59
|
+
dsh plugin --profile web add dsh-test-drive
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Prebuilt packages need no build allowance. Restart the profile, then use `test_drive` / `/testdrive` from a session.
|
|
63
|
+
|
|
64
|
+
## Install & uninstall
|
|
65
|
+
|
|
66
|
+
```sh
|
|
67
|
+
dsh plugin --profile web add dsh-test-drive # install (npm) тАФ or the git form above
|
|
68
|
+
dsh plugin --profile web remove dsh-test-drive # uninstall
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Configuration
|
|
72
|
+
|
|
73
|
+
All keys are optional (defaults shown); invalid values fail loudly at load.
|
|
74
|
+
|
|
75
|
+
| Key | Default | Description |
|
|
76
|
+
|---|---|---|
|
|
77
|
+
| `profileName` | `headless` | Profile template initialized inside each throwaway DSH_HOME (base + headless bundles). |
|
|
78
|
+
| `dshBin` | `""` | Absolute dsh executable override; empty auto-detects `dsh` on PATH. |
|
|
79
|
+
| `headlessTask` | `"Reply with exactly: ok"` | One-shot task for the boot-smoke stage; empty skips the stage. |
|
|
80
|
+
| `forwardEnv` | `[]` | Environment VARIABLE NAMES (never values) forwarded into test-profile child processes. |
|
|
81
|
+
| `allowBuilds` | `true` | Allowlist a blocked git `prepare` build in the test profile and retry the install once. |
|
|
82
|
+
| `installTimeoutMs` | `600000` | `dsh plugin add` stage deadline. |
|
|
83
|
+
| `configTimeoutMs` | `60000` | `--dump-config` stage deadline. |
|
|
84
|
+
| `smokeTimeoutMs` | `300000` | Headless boot-smoke stage deadline. |
|
|
85
|
+
| `uninstallTimeoutMs` | `120000` | `dsh plugin remove` stage deadline. |
|
|
86
|
+
| `outputTailBytes` | `8000` | Cap on the sanitized output tail recorded per stage. |
|
|
87
|
+
| `keepTempDirs` | `false` | Keep temp dirs on failure for forensics (ownership is dropped; you clean up). |
|
|
88
|
+
| `maxBatchTargets` | `20` | `/testdrive` batch cap. |
|
|
89
|
+
| `batchConcurrency` | `1` | Batch concurrency (serial avoids pnpm-store contention). |
|
|
90
|
+
|
|
91
|
+
## Tools & surfaces
|
|
92
|
+
|
|
93
|
+
### `test_drive`
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
test_drive(target: string, headlessTask?: string, background?: boolean)
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
- `target` тАФ git spec (`github:owner/repo#sha`, `git+https://...`), npm name, local path, or `.tgz` tarball.
|
|
100
|
+
- Returns the full structured record; see the sample below.
|
|
101
|
+
- `background: true` starts a `drive-batch` job and returns its id.
|
|
102
|
+
|
|
103
|
+
### `/testdrive <targets...>`
|
|
104
|
+
|
|
105
|
+
Starts one background batch job; progress streams through the job output, and the final line names the matrix id for `drive_report`.
|
|
106
|
+
|
|
107
|
+
### `drive_report(id?)`
|
|
108
|
+
|
|
109
|
+
Returns a run record (`tdr_...`), a matrix (`tdm_...`), or тАФ with no id тАФ the latest matrix.
|
|
110
|
+
|
|
111
|
+
### Structured result sample
|
|
112
|
+
|
|
113
|
+
```json
|
|
114
|
+
{
|
|
115
|
+
"schema": "dsh-test-drive/v1",
|
|
116
|
+
"run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
|
|
117
|
+
"finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
|
|
118
|
+
"harnessVersion": "0.1.0-rc.6", "pluginVersion": "0.1.0",
|
|
119
|
+
"platform": "win32", "node": "v22.22.3" },
|
|
120
|
+
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
|
|
121
|
+
"resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
|
|
122
|
+
"hasBundleManifest": true } },
|
|
123
|
+
"isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
|
|
124
|
+
"hostHomeTouched": false },
|
|
125
|
+
"stages": {
|
|
126
|
+
"install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
|
|
127
|
+
"summary": "install ok after allowBuilds allowance", "outputTail": "",
|
|
128
|
+
"allowBuildsNeeded": true },
|
|
129
|
+
"config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
|
|
130
|
+
"summary": "dump ok (exit 0)", "outputTail": "",
|
|
131
|
+
"patchEffective": true, "layers": ["dsh-click"] },
|
|
132
|
+
"smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
|
|
133
|
+
"summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
|
|
134
|
+
"outputTail": "", "bootFailed": false, "taskCompleted": false },
|
|
135
|
+
"uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
|
|
136
|
+
"summary": "remove ok (exit 0)", "outputTail": "" },
|
|
137
|
+
"cleanup": { "status": "pass", "quarantined": true, "removed": true,
|
|
138
|
+
"summary": "owned temp root quarantined and removed" }
|
|
139
|
+
},
|
|
140
|
+
"verdict": "pass",
|
|
141
|
+
"verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
|
|
142
|
+
}
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
Verdict rules: install failure or boot failure (`smoke.fail`) тЗТ `fail`; install pass + patch effective + clean boot (`pass`/`boot-ok`) + uninstall pass тЗТ `pass`; anything installed but missing a later assurance тЗТ `partial`; otherwise `unknown`.
|
|
146
|
+
|
|
147
|
+
## Permissions & data
|
|
148
|
+
|
|
149
|
+
- Only public services are consumed: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`.
|
|
150
|
+
- Reports are stored in the `test_drive` storage-domain (tables `runs`, `matrices`; latest-matrix pointer). When the composition has no `storageDomain` (e.g. the shipped headless profile), tools still work and report persistence is disabled with a logged reason.
|
|
151
|
+
- Child processes inherit a credential-scrubbed environment: host secrets never reach a tested profile unless you explicitly name them in `forwardEnv`. Values are never logged.
|
|
152
|
+
- All report/log strings pass through pure sanitizers: token literals, URL credentials, and bearer headers are redacted, temp-root paths are replaced with `<testdrive-temp>`, and tails are byte-capped.
|
|
153
|
+
|
|
154
|
+
## Security boundaries
|
|
155
|
+
|
|
156
|
+
- **Isolation.** Each drive runs inside a fresh `mkdtemp` root under the OS temp dir: a throwaway `DSH_HOME`, a throwaway working directory, and a redirected pnpm store. The tested plugin's code only ever runs in that profile; your host profile is untouched.
|
|
157
|
+
- **Ownership.** A live registry records every root this plugin instance creates. Cleanup refuses anything that is not a registered direct child of the OS temp dir carrying the `dsh-test-drive-` prefix тАФ no `%TEMP%` sweeps, no foreign prefixes, no real-home paths.
|
|
158
|
+
- **Cleanup ladder.** Before any mutation the full dry-run plan is logged (absolute paths). Removal renames the root into a `dsh-test-drive-quarantine-<ts>` directory first, verifies, then deletes; failures leave the directory quarantined and reported, never silently dropped. Cleanup runs in a `finally` on success, failure, timeout, and abort, and again on plugin teardown.
|
|
159
|
+
- **`allowBuilds` is a real permission.** Allowing a git package's `prepare` build executes that package's code at install time. The allowance is scoped to the throwaway profile only, but only test targets you trust, and pin commits.
|
|
160
|
+
- **Headless smoke is keyless by default.** The boot check needs no credentials; completing the one-shot task does. Forward credentials explicitly (`forwardEnv`) and never log them.
|
|
161
|
+
|
|
162
|
+
## Known limitations
|
|
163
|
+
|
|
164
|
+
- Installing registry/git targets requires network access from the child `dsh`/pnpm processes.
|
|
165
|
+
- The smoke task needs model credentials to reach `pass`; without them it reports the honest `boot-ok`.
|
|
166
|
+
- In compositions without `storageDomain`, reports are not persisted (`drive_report` fails honestly).
|
|
167
|
+
- `dsh` must be locatable on PATH (or set `dshBin`); on Windows the npm `.cmd`/`.bat` shim is parsed automatically, a bare `.ps1` resolution asks for `dshBin`.
|
|
168
|
+
- Batches default to serial execution; raising `batchConcurrency` shares the pnpm-store disk, not correctness.
|
|
169
|
+
|
|
170
|
+
## Development
|
|
171
|
+
|
|
172
|
+
```sh
|
|
173
|
+
pnpm install
|
|
174
|
+
pnpm run typecheck && pnpm run typecheck:ci && pnpm test
|
|
175
|
+
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
- `typecheck` resolves `@deepseek-ai/*` through the local harness checkout; `typecheck:ci` checks against the published `0.1.0-rc.6` types.
|
|
179
|
+
- Tests use the real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage stack with a scripted subprocess provider.
|
|
180
|
+
- Real-CLI end-to-end (requires network + `dsh` on PATH): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` тАФ drives this package's own checkout through the real install-smoke loop.
|
|
181
|
+
- Release: `node scripts/release.mjs <x.y.z>` (bumps, stamps CHANGELOG, re-runs the gate, commits + tags; never pushes).
|
|
182
|
+
|
|
183
|
+
## Topics
|
|
184
|
+
|
|
185
|
+
`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
|
|
186
|
+
|
|
187
|
+
## Contributors
|
|
188
|
+
|
|
189
|
+
[PerryLink](https://github.com/PerryLink) тАФ design and implementation.
|
|
190
|
+
|
|
191
|
+
## PerryLink DSH Plugin Family
|
|
192
|
+
|
|
193
|
+
This project is one of the [29 DeepSeek Harness plugins](https://github.com/PerryLink) maintained by [PerryLink](https://github.com/PerryLink). If this one helps you, the others likely will too:
|
|
194
|
+
|
|
195
|
+
| Plugin | One-liner |
|
|
196
|
+
|---|---|
|
|
197
|
+
| [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | Second-model auto-review on the approval chain, fail-closed by default |
|
|
198
|
+
| [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | Durable background child agents with a Web UI sidebar, messaging and interrupt |
|
|
199
|
+
| [dsh-budget](https://github.com/PerryLink/dsh-budget) | Cost governance for DeepSeek Harness: budgets, carbon, and latency in one panel. |
|
|
200
|
+
| [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | Claude Code /rewind-equivalent: snapshots, session forks, one-shot restore |
|
|
201
|
+
| [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | Migrate Claude Code sessions, memory, skills and CLAUDE.md into DSH |
|
|
202
|
+
| [dsh-click](https://github.com/PerryLink/dsh-click) | Cross-platform native desktop control for DeepSeek Harness тАФ Windows first. |
|
|
203
|
+
| [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Terminal-style input history for the web composer: arrows, Ctrl+R search |
|
|
204
|
+
| [dsh-defend](https://github.com/PerryLink/dsh-defend) | Prompt-injection, jailbreak, and secret-leak defense for DeepSeek Harness. |
|
|
205
|
+
| [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | Engineering-discipline guard: requirements grill, test gates, adversary review |
|
|
206
|
+
| [dsh-draw](https://github.com/PerryLink/dsh-draw) | Unified static-image generation routing for DeepSeek Harness. |
|
|
207
|
+
| [dsh-fast](https://github.com/PerryLink/dsh-fast) | Read-only performance diagnostics for DeepSeek Harness. |
|
|
208
|
+
| [dsh-github](https://github.com/PerryLink/dsh-github) | GitHub PR/issues integration for DSH, every write gated by approval |
|
|
209
|
+
| [dsh-library](https://github.com/PerryLink/dsh-library) | Local document knowledge base for DeepSeek Harness. |
|
|
210
|
+
| [dsh-local-ai](https://github.com/PerryLink/dsh-local-ai) | Local-model (Ollama) integration for DeepSeek Harness. |
|
|
211
|
+
| [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | LSP diagnostics, formatting, completion, code actions and rename over language servers |
|
|
212
|
+
| [dsh-mask](https://github.com/PerryLink/dsh-mask) | PII masking middleware for DeepSeek Harness тАФ anonymize personal data before it reaches the model, restore it at the display layer. |
|
|
213
|
+
| [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | Read-only MCP runtime panel: /mcp command + Settings tab with status, tools and errors |
|
|
214
|
+
| [dsh-memento](https://github.com/PerryLink/dsh-memento) | Approval-gated cross-session memory: ctx.memory seam + SQLite + memory tool |
|
|
215
|
+
| [dsh-observe](https://github.com/PerryLink/dsh-observe) | OpenTelemetry and Langfuse observability exporter for DeepSeek Harness. |
|
|
216
|
+
| [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | Claude Code outputStyles-equivalent runtime style switching |
|
|
217
|
+
| [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code-style declarative allow/deny/ask permission rules with audit |
|
|
218
|
+
| [dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide) | Plugin-development knowledge base as an on-demand agent skill |
|
|
219
|
+
| [dsh-score](https://github.com/PerryLink/dsh-score) | Multi-dimensional quality scoring for DeepSeek Harness plugins. |
|
|
220
|
+
| [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | Pin sessions in the Web sidebar with durable ordering |
|
|
221
|
+
| [dsh-session-sync](https://github.com/PerryLink/dsh-session-sync) | Cross-device session sync for DeepSeek Harness тАФ a dedicated git mirror of your session store. |
|
|
222
|
+
| [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | Security-audit skill pack: secret scan, dependency and supply-chain review |
|
|
223
|
+
| [dsh-talk](https://github.com/PerryLink/dsh-talk) | Voice-first session loop for DeepSeek Harness: talk to it, hear it answer. |
|
|
224
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | Isolated install-and-smoke test drives for DeepSeek Harness plugins. |
|
|
225
|
+
| [dsh-translate](https://github.com/PerryLink/dsh-translate) | Vendor parameter translation and deterministic JSON repair for DeepSeek Harness. |
|
|
226
|
+
|
|
227
|
+
## License
|
|
228
|
+
|
|
229
|
+
[Apache-2.0](LICENSE)
|