dsh-score 0.2.27 → 0.2.29
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 +12 -2
- package/README.en.md +525 -0
- package/README.es.md +525 -0
- package/README.hi.md +525 -0
- package/README.md +290 -194
- package/README.pt.md +525 -0
- package/lib/index.js +1 -1
- package/lib/types/version.d.ts +1 -1
- package/package.json +37 -34
- package/README-es.md +0 -398
- package/README-hi.md +0 -421
- package/README-pt.md +0 -398
- package/README-zh.md +0 -408
package/CHANGELOG.md
CHANGED
|
@@ -1,10 +1,18 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## [0.2.
|
|
3
|
+
## [0.2.28] - 2026-11-05
|
|
4
4
|
|
|
5
5
|
### Changed
|
|
6
6
|
|
|
7
|
-
-
|
|
7
|
+
- **Align the dev/test line with the harness `0.2.2-rc.1` release.** Every `@deepseek-ai/dsh-*` devDependency moves from `0.2.1-rc.2` to `0.2.2-rc.1`; the vendor family follows the host's pins (`@deepseek-ai/cordis` `^4.1.0`, `cordis-plugin-include` / `cordis-plugin-loader` `^1.1.0`, `@deepseek-ai/schemastery` `~3.19.0`), and the peer `engines.dsh` timeline gains `>=0.2.2-0 <0.3.0`. `engines.node` becomes `^22.19.0 || >=24.9.0`.
|
|
8
|
+
- **Add two devDependencies the `0.2.2` runtime contracts now require:** `@deepseek-ai/dsh-session-projection` (the `AgentRegistry` statically injects `sessionProjections` and awaits its `register()`) and `@deepseek-ai/dsh-tool-executor-native` (`tools.execute` delegates to an injected executor).
|
|
9
|
+
|
|
10
|
+
### Fixed
|
|
11
|
+
|
|
12
|
+
- **Mount the projection registry and the native tool executor in the test harness.** `SessionProjectionRegistry` now comes before `AgentRegistry`, and `NativeToolExecutor` after `ToolRuntime`, matching the host's own composition order.
|
|
13
|
+
- **Drive tools through the `0.2.2` batch contract.** Test call sites now call `ctx.tools.execute({ calls: [{ type: 'tool-call', id, name, arguments }], signal, agent })` and read `batch.results[0]?.result`, replacing the removed single-call `{ callId, name, arguments }` shape.
|
|
14
|
+
- **Implement `KvUnit.deleteRecords(table, keys)` in the memory test backend.** `0.2.2` widened `KvUnit` with the batched delete; the double had only `deleteRecord`.
|
|
15
|
+
- **Keep the five READMEs on the new `engines.dsh` range** so `check:readmes` stays green.
|
|
8
16
|
|
|
9
17
|
## [0.2.26] - 2026-10-24
|
|
10
18
|
|
|
@@ -75,6 +83,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
75
83
|
|
|
76
84
|
## [Unreleased]
|
|
77
85
|
|
|
86
|
+
## [0.2.29] - 2026-11-18
|
|
87
|
+
|
|
78
88
|
## [0.2.18] - 2026-10-04
|
|
79
89
|
|
|
80
90
|
undefined
|
package/README.en.md
ADDED
|
@@ -0,0 +1,525 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-score-hero-en-dark.webp">
|
|
5
|
+
<img src="docs/assets/dsh-score-hero-en-light.webp" width="100%" alt="dsh-score hero: the plugin name and value lines on the left; on the right, a real score card - the install row is no-evidence and drops out of the divisor, the other four dimensions carry their score and weight, the weighted total is 88/100 at grade B, and the footer marks local, on-demand, read-only probes">
|
|
6
|
+
</picture>
|
|
7
|
+
|
|
8
|
+
# dsh-score
|
|
9
|
+
|
|
10
|
+
**Turn any repository or npm package into a five-dimension quality scorecard with evidence links — install, maintenance, docs, security, compliance, every point traceable.**
|
|
11
|
+
|
|
12
|
+
A local scorer for DeepSeek Harness: it collects evidence with `dsh-v0.2.2-rc.4`(2026-11-18);`gh api` and `npm view` only — it never installs, builds, or runs the target — and records `no-evidence` instead of inventing a number.
|
|
13
|
+
|
|
14
|
+
[Install](#three-step-setup) · [Configuration](#configuration) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
15
|
+
|
|
16
|
+
[](LICENSE)
|
|
17
|
+
[](#compatibility)
|
|
18
|
+
[](https://www.npmjs.com/package/dsh-score)
|
|
19
|
+
[](https://github.com/PerryLink/dsh-score/actions/workflows/ci.yml)
|
|
20
|
+
[](#compatibility)
|
|
21
|
+
|
|
22
|
+
[](https://github.com/PerryLink/dsh-score/stargazers)
|
|
23
|
+
[](https://www.npmjs.com/package/dsh-score)
|
|
24
|
+
[](https://dshfind.com/plugins/PerryLink/dsh-score?ref=badge)
|
|
25
|
+
[](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-score)
|
|
26
|
+
[](https://dsh.market/)
|
|
27
|
+
[](https://gitee.com/perrylink/dsh-score)
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
dsh plugin --profile <name> add dsh-score
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
</div>
|
|
34
|
+
|
|
35
|
+
<sub>Community plugin, not affiliated with DeepSeek. Canonical repository: <https://github.com/PerryLink/dsh-score> (Gitee is a mirror).</sub>
|
|
36
|
+
|
|
37
|
+
## What it is
|
|
38
|
+
|
|
39
|
+
`dsh-v0.2.2-rc.4`(2026-11-18);`dsh-score` is a local quality scorer for DeepSeek Harness: give it a GitHub repository or an npm package and it runs the five dimensions — install success, maintenance, documentation, security, and compliance — then returns a structured score card (`schema: "dsh-score/v1"`) or a JSON + Markdown leaderboard. Every conclusion comes from real `gh`/`npm` output and every piece of evidence carries `source`, sanitized `detail`, and `observedAt`; a dimension that gathers no evidence reports `no-evidence` (score 0, excluded from the weighted total) instead of a guessed number. Scoring is on demand only — nothing is installed, built, or executed. This plugin is the local on-demand scorer; the public evidence layer lives in [`dsh-attention-index`](https://github.com/PerryLink/dsh-attention-index).
|
|
40
|
+
|
|
41
|
+
<picture>
|
|
42
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-score-flow-v5-dark.svg">
|
|
43
|
+
<img src="docs/assets/dsh-score-flow-v5-light.svg" width="100%" alt="dsh-score structure: three intake channels on top (seven read-only gh api calls, npm view --json, and the reserved test_drive domain) feed evidence[]; below them the five-dimension bench whose column width is the weight (install 25 / maintenance 20 / documentation 20 / security 20 / compliance 15), with install hollow at 0 and removed from the divisor; the weight rail shows 100 to 75, the total plate computes 6615 / 75 = 88 at grade B, and three outputs close the figure: the sc_ score card, the lb_ leaderboard, and score_badge">
|
|
44
|
+
</picture>
|
|
45
|
+
|
|
46
|
+
## Three-step setup
|
|
47
|
+
|
|
48
|
+
1. **Install** (pick one channel):
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
# git channel (latest main; equivalent to git+https://github.com/PerryLink/dsh-score.git)
|
|
52
|
+
dsh plugin --profile web add github:PerryLink/dsh-score#<commit-sha>
|
|
53
|
+
# npm channel (published releases)
|
|
54
|
+
dsh plugin --profile web add dsh-score
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
The first `add` through the git channel 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:
|
|
58
|
+
|
|
59
|
+
```yaml
|
|
60
|
+
allowBuilds:
|
|
61
|
+
'dsh-score': true
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Prebuilt packages from the npm channel need no build allowance.
|
|
65
|
+
|
|
66
|
+
2. **Minimal config** (the defaults work; add keys only to change thresholds or weights):
|
|
67
|
+
|
|
68
|
+
```yaml
|
|
69
|
+
- insert:
|
|
70
|
+
- id: score
|
|
71
|
+
name: dsh-score
|
|
72
|
+
config:
|
|
73
|
+
weights:
|
|
74
|
+
install: 25
|
|
75
|
+
maintenance: 20
|
|
76
|
+
documentation: 20
|
|
77
|
+
security: 20
|
|
78
|
+
compliance: 15
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
3. **Verify it mounts**:
|
|
82
|
+
|
|
83
|
+
```sh
|
|
84
|
+
dsh --profile web --dump-config | grep -A2 'id: score'
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
> /score owner/repo
|
|
89
|
+
[1/1] owner/repo → B (88/100, healthy (weighted total 88/100))
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
*Observed from `src/batch.ts:70`*
|
|
93
|
+
|
|
94
|
+
**Uninstall**: `dsh plugin --profile web remove dsh-score` (or remove the row from the profile patch).
|
|
95
|
+
|
|
96
|
+
> `dsh-score` does not bundle the storage stack. When the composition has no `storageDomain`, the tools still work and score persistence is disabled with a logged reason; the published `dsh-base` bundle mounts storage-domain from `0.1.2-rc.1` on (verified against the `0.1.2-rc.1` and `0.1.5-alpha.1` tarballs), so persistence is active on the published line.
|
|
97
|
+
|
|
98
|
+
## Core capabilities
|
|
99
|
+
|
|
100
|
+
`dsh-score` compresses "can it be installed, is it maintained, are the docs complete, is it secure, does it comply" into one reviewable score card:
|
|
101
|
+
|
|
102
|
+
- **Five dimensions** — install success `25`, maintenance `20`, documentation `20`, security `20`, compliance `15` (weights configurable; defaults sum to 100).
|
|
103
|
+
- **Evidence discipline** — every dimension records its audit links (`source`, sanitized `detail`, `observedAt`); a dimension without evidence reports `no-evidence` (score 0, excluded from the weighted total) and never a fabricated number.
|
|
104
|
+
- **Structured results** — every record carries `schema: "dsh-score/v1"` with first-class fields; this is the machine-readable contract downstream tooling consumes.
|
|
105
|
+
- **Batch leaderboard** — `/score` hands a target list to a `score-batch` job over `ctx.jobs`, producing a JSON + Markdown leaderboard snapshot.
|
|
106
|
+
- **Cache and refresh** — score cards are cached per target (24 hours by default); `refresh: true` bypasses the cache and re-gathers evidence.
|
|
107
|
+
- **Embeddable badge** — `score_badge` returns a shields.io badge (endpoint / SVG / Markdown) plus the five-dimension JSON, and the total badge drops straight into any README.
|
|
108
|
+
|
|
109
|
+
```text
|
|
110
|
+
target ──gh api / npm view──▶ five dimensions of evidence ──weighted──▶ score card dsh-score/v1 ──▶ leaderboard lb_...
|
|
111
|
+
│
|
|
112
|
+
└─ no evidence → no-evidence (score 0, excluded)
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Tools & results
|
|
116
|
+
|
|
117
|
+
### Tool surface
|
|
118
|
+
|
|
119
|
+
| Entry | Type | Notes |
|
|
120
|
+
|---|---|---|
|
|
121
|
+
| `score` | tool | Scores one target through the five dimensions; `refresh: true` bypasses the cache, `background: true` starts a `score-batch` job |
|
|
122
|
+
| `/score <targets...>` | command | Scores a whitespace/comma-separated target list; progress streams through the job output and the final line names the `lb_...` for `score_report` |
|
|
123
|
+
| `score_report` | tool | Fetches a score card (`sc_...`), a leaderboard (`lb_...`), or — with no id — the latest leaderboard |
|
|
124
|
+
| `score_badge` | tool | Generates a shields.io badge and the five-dimension JSON for a target or a stored score card |
|
|
125
|
+
| `score-batch` | background job | The batch job over `ctx.jobs`; it scores serially and writes the leaderboard snapshot |
|
|
126
|
+
|
|
127
|
+
### Tool parameters
|
|
128
|
+
|
|
129
|
+
```
|
|
130
|
+
score(target: string, refresh?: boolean, background?: boolean)
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
- `target` — a GitHub repository (`github:owner/repo`, `owner/repo`, a git/https URL) or an npm package name.
|
|
134
|
+
- `refresh: true` — bypass the score cache and re-gather evidence.
|
|
135
|
+
- `background: true` — start a `score-batch` job and return its id.
|
|
136
|
+
|
|
137
|
+
`score_report(id?)` returns a score card (`sc_...`), a leaderboard (`lb_...`), or — with no id — the latest leaderboard.
|
|
138
|
+
|
|
139
|
+
`score_badge(target? | id?, refresh?)`:
|
|
140
|
+
|
|
141
|
+
- `target` — score a GitHub repo or npm package through the cache and badge it; mutually exclusive with `id`.
|
|
142
|
+
- `id` — badge a stored score card (`sc_...`) without re-scoring.
|
|
143
|
+
- `refresh: true` — bypass the score cache (only applies to `target`).
|
|
144
|
+
|
|
145
|
+
### Score card example
|
|
146
|
+
|
|
147
|
+
These are the plugin's real entry points; install once, then call one.
|
|
148
|
+
|
|
149
|
+
**Command**:
|
|
150
|
+
|
|
151
|
+
~~~sh
|
|
152
|
+
score({ target: "owner/repo" })
|
|
153
|
+
~~~
|
|
154
|
+
|
|
155
|
+
**Output**:
|
|
156
|
+
|
|
157
|
+
~~~text
|
|
158
|
+
# Score sc_65e817eec8cd71ed
|
|
159
|
+
|
|
160
|
+
- Target: `owner/repo` (repo)
|
|
161
|
+
- Grade: **B** — total 88/100
|
|
162
|
+
- Verdict: healthy (weighted total 88/100)
|
|
163
|
+
|
|
164
|
+
| Dimension | Status | Score | Weight | Summary |
|
|
165
|
+
|---|---|---|---|---|
|
|
166
|
+
| Install success | ⬜ no-evidence | 0 | 25 | no dsh-test-drive result recorded for this target (install success unmeasured) |
|
|
167
|
+
| Maintenance | ✅ pass | 100 | 20 | active (2026-08-15T00:00:00.000Z; 0 open issues) |
|
|
168
|
+
| Documentation | 🟠 warn | 70 | 20 | 1/4 language READMEs + CHANGELOG + SECURITY |
|
|
169
|
+
| Security | ✅ pass | 100 | 20 | license MIT |
|
|
170
|
+
| Protocol compliance | ✅ pass | 81 | 15 | dsh.bundle.patch declared |
|
|
171
|
+
~~~
|
|
172
|
+
|
|
173
|
+
*Observed from `README.md:141-149,169-191; tests/tools.spec.ts:64-65; tests/score.spec.ts:50-55; src/report.ts:40-53`*
|
|
174
|
+
|
|
175
|
+
**Failure branch** — input:
|
|
176
|
+
|
|
177
|
+
~~~text
|
|
178
|
+
{"id":"sc_nope"}
|
|
179
|
+
~~~
|
|
180
|
+
|
|
181
|
+
Output:
|
|
182
|
+
|
|
183
|
+
~~~text
|
|
184
|
+
isError=true; error.message=dsh-score: no score recorded with id sc_nope
|
|
185
|
+
~~~
|
|
186
|
+
|
|
187
|
+
*Observed from `plugins/dsh-score/src/tools.ts:351-354 (throw); plugins/dsh-score/tests/tools.spec.ts:95-99 (unknown id); plugins/dsh-score/README.md:179-181 (score_report); exercised through plugins/dsh-score/tests/harness.ts`*
|
|
188
|
+
|
|
189
|
+
**Brief examples**: `score({ target: "owner/dsh-click" })` · `score_report("sc_65e817eec8cd71ed")` · `score_badge("owner/dsh-click")`
|
|
190
|
+
|
|
191
|
+
### Structured result
|
|
192
|
+
|
|
193
|
+
```json
|
|
194
|
+
{
|
|
195
|
+
"schema": "dsh-score/v1",
|
|
196
|
+
"scoreId": "sc_8f1c2e4a9b3d7f01",
|
|
197
|
+
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123" },
|
|
198
|
+
"scoredAt": "2026-08-16T00:00:00.000Z",
|
|
199
|
+
"durationMs": 3210,
|
|
200
|
+
"pluginVersion": "0.2.22",
|
|
201
|
+
"dimensions": {
|
|
202
|
+
"install": { "dimension": "install", "status": "no-evidence", "score": 0, "weight": 25,
|
|
203
|
+
"summary": "no dsh-test-drive result recorded for this target (install success unmeasured)",
|
|
204
|
+
"evidence": [{ "source": "test-drive", "detail": "no test-drive record found in the test_drive domain", "observedAt": "2026-08-16T00:00:00.000Z" }] },
|
|
205
|
+
"maintenance": { "dimension": "maintenance", "status": "pass", "score": 100, "weight": 20,
|
|
206
|
+
"summary": "active (2026-08-10T00:00:00Z; 0 open issues)",
|
|
207
|
+
"evidence": [{ "source": "gh-api", "detail": "last activity 2026-08-10T00:00:00Z", "observedAt": "2026-08-16T00:00:00.000Z" }] }
|
|
208
|
+
},
|
|
209
|
+
"total": 88,
|
|
210
|
+
"grade": "B",
|
|
211
|
+
"verdict": "healthy (weighted total 88/100)"
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
Scoring: the total is a weighted average over the dimensions that gathered evidence (no-evidence dimensions are excluded and renormalized); `A` ≥ 90, `B` ≥ 75, `C` ≥ 60, `D` ≥ 40, else `F`, and `N/A` when nothing had evidence.
|
|
216
|
+
|
|
217
|
+
### Badge & five-dimension JSON
|
|
218
|
+
|
|
219
|
+
`score_badge` generates an embeddable README badge and the five-dimension JSON for one scored target. The badge comes in three forms derived from the same card: **endpoint** (a documented shields.io static URL, zero self-hosting), **SVG** (a self-contained shields.io flat-style SVG, `badge.svg` field / `renderScoreBadge`, for offline or self-hosted READMEs), and **Markdown** (the embed snippet combining both).
|
|
220
|
+
|
|
221
|
+
Embed the total badge:
|
|
222
|
+
|
|
223
|
+
```markdown
|
|
224
|
+

|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
The same call returns the compact JSON API envelope (`schema: "dsh-score/badge/v1"`):
|
|
228
|
+
|
|
229
|
+
```json
|
|
230
|
+
{
|
|
231
|
+
"schema": "dsh-score/badge/v1",
|
|
232
|
+
"target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123" },
|
|
233
|
+
"scoredAt": "2026-08-16T00:00:00.000Z",
|
|
234
|
+
"total": 84,
|
|
235
|
+
"grade": "B",
|
|
236
|
+
"dimensions": {
|
|
237
|
+
"install": { "label": "install", "status": "no-evidence", "score": 0, "weight": 25, "summary": "no dsh-test-drive result recorded" },
|
|
238
|
+
"maintenance": { "label": "maintenance", "status": "pass", "score": 90, "weight": 20, "summary": "active (0 open issues)" },
|
|
239
|
+
"documentation": { "label": "docs", "status": "pass", "score": 85, "weight": 20, "summary": "README + CHANGELOG + SECURITY" },
|
|
240
|
+
"security": { "label": "security", "status": "warn", "score": 60, "weight": 20, "summary": "permissive license" },
|
|
241
|
+
"compliance": { "label": "compliance", "status": "pass", "score": 100, "weight": 15, "summary": "dsh.bundle.patch + dsh-plugin topic" }
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
A `no-evidence` dimension keeps its honest status and score 0 — the badge and JSON never fabricate a number.
|
|
247
|
+
|
|
248
|
+
## Configuration
|
|
249
|
+
|
|
250
|
+
All keys are optional (defaults shown); invalid values fail loudly at load.
|
|
251
|
+
|
|
252
|
+
Most-used keys:
|
|
253
|
+
|
|
254
|
+
| Key | Default | Meaning |
|
|
255
|
+
|---|---|---|
|
|
256
|
+
| `probeTimeoutMs` | `60000` | Deadline for one `gh`/`npm` probe command (ms) |
|
|
257
|
+
| `outputTailBytes` | `8000` | Cap on the sanitized output tail recorded per probe (bytes) |
|
|
258
|
+
| `cacheMaxAgeMs` | `86400000` | How long a cached score card is reused before re-scoring (0 disables the cache) |
|
|
259
|
+
| `staleCommitWarnDays` | `90` | Commit/publish age at which maintenance drops to `warn` |
|
|
260
|
+
| `staleCommitFailDays` | `365` | Commit/publish age at which maintenance drops to `fail` |
|
|
261
|
+
| `maxBatchTargets` | `20` | `/score` batch target cap |
|
|
262
|
+
| `batchConcurrency` | `1` | Batch concurrency (serial by default, avoiding API-rate contention) |
|
|
263
|
+
| `weights` | `{install:25, maintenance:20, documentation:20, security:20, compliance:15}` | Per-dimension weights (each 0–100; at least one must be > 0) |
|
|
264
|
+
|
|
265
|
+
<details>
|
|
266
|
+
<summary>Full configuration table (10 keys)</summary>
|
|
267
|
+
|
|
268
|
+
| Key | Default | Meaning |
|
|
269
|
+
|---|---|---|
|
|
270
|
+
| `probeTimeoutMs` | `60000` | Deadline for one `gh`/`npm` probe command (ms) |
|
|
271
|
+
| `outputTailBytes` | `8000` | Cap on the sanitized output tail recorded per probe (bytes) |
|
|
272
|
+
| `cacheMaxAgeMs` | `86400000` | How long a cached score card is reused before re-scoring (0 disables the cache) |
|
|
273
|
+
| `staleCommitWarnDays` | `90` | Commit/publish age at which maintenance drops to `warn` |
|
|
274
|
+
| `staleCommitFailDays` | `365` | Commit/publish age at which maintenance drops to `fail` |
|
|
275
|
+
| `staleIssueWarnDays` | `30` | Oldest-open-issue age (response proxy) at which maintenance drops to `warn` |
|
|
276
|
+
| `staleIssueFailDays` | `180` | Oldest-open-issue age at which maintenance drops to `fail` |
|
|
277
|
+
| `maxBatchTargets` | `20` | `/score` batch target cap |
|
|
278
|
+
| `batchConcurrency` | `1` | Batch concurrency (serial by default, avoiding API-rate contention) |
|
|
279
|
+
| `weights` | `{install:25, maintenance:20, documentation:20, security:20, compliance:15}` | Per-dimension weights (each 0–100; at least one must be > 0) |
|
|
280
|
+
|
|
281
|
+
</details>
|
|
282
|
+
|
|
283
|
+
Example override in your profile patch:
|
|
284
|
+
|
|
285
|
+
```yaml
|
|
286
|
+
- insert:
|
|
287
|
+
- id: score
|
|
288
|
+
name: dsh-score
|
|
289
|
+
config:
|
|
290
|
+
cacheMaxAgeMs: 0
|
|
291
|
+
maxBatchTargets: 10
|
|
292
|
+
weights:
|
|
293
|
+
install: 25
|
|
294
|
+
maintenance: 20
|
|
295
|
+
documentation: 20
|
|
296
|
+
security: 20
|
|
297
|
+
compliance: 15
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
## FAQ
|
|
301
|
+
|
|
302
|
+
<details>
|
|
303
|
+
<summary>Where do score cards and leaderboards live? Are they lost without storage?</summary>
|
|
304
|
+
|
|
305
|
+
Score cards and leaderboards are stored in the `score` storage domain (tables `scores`, `leaderboards`, plus the latest-leaderboard pointer). When the composition has no `storageDomain` (a headless profile older than the base bundle's storage rows, for example), the tools still work but score persistence is disabled with a logged reason. The published `dsh-base` bundle mounts storage-domain from `0.1.2-rc.1` on (verified against the `0.1.2-rc.1` and `0.1.5-alpha.1` tarballs), so persistence is active on the published line.
|
|
306
|
+
|
|
307
|
+
</details>
|
|
308
|
+
|
|
309
|
+
<details>
|
|
310
|
+
<summary>When evidence is missing, does it just make up a score?</summary>
|
|
311
|
+
|
|
312
|
+
No. A failed probe, unparsable output, or a target with no resolvable GitHub repository makes that dimension report `no-evidence` (score 0, excluded from the weighted total and renormalized); when nothing has evidence the total is `N/A`. A `no-evidence` dimension also carries the failure reason (`exit N`, `timeout`, the redacted stderr tail, or `invalid JSON`) instead of an invented number.
|
|
313
|
+
|
|
314
|
+
</details>
|
|
315
|
+
|
|
316
|
+
<details>
|
|
317
|
+
<summary>Does it install, build, or run the target package?</summary>
|
|
318
|
+
|
|
319
|
+
No. The pipeline runs only the read-only `gh api` and `npm view` commands — it never installs, builds, or executes the target. Every CLI invocation is an argv array, never shell-interpreted, and the `owner`/`repo` segments are validated against a restricted character set before they reach an endpoint.
|
|
320
|
+
|
|
321
|
+
</details>
|
|
322
|
+
|
|
323
|
+
<details>
|
|
324
|
+
<summary>Can credentials leak into reports or logs?</summary>
|
|
325
|
+
|
|
326
|
+
No. Child processes inherit the provider's credential-scrubbed environment and `gh` reads its own credential store; no environment value is ever logged. All report/log strings pass through pure sanitizers: token literals, URL credentials, and bearer headers are redacted, and output tails are byte-capped.
|
|
327
|
+
|
|
328
|
+
</details>
|
|
329
|
+
|
|
330
|
+
<details>
|
|
331
|
+
<summary>How expensive is scoring? Will it hit GitHub API rate limits?</summary>
|
|
332
|
+
|
|
333
|
+
Score cards are cached per target (`cacheMaxAgeMs` = 24 hours by default), so repeat lookups do not re-gather evidence; use `refresh: true` or set the cache age to 0 when you need fresh data. `/score` defaults to `batchConcurrency: 1` (serial) to avoid concurrent probes competing for API quota, and a single probe waits at most `probeTimeoutMs` (60 seconds by default).
|
|
334
|
+
|
|
335
|
+
</details>
|
|
336
|
+
|
|
337
|
+
## Security boundaries
|
|
338
|
+
|
|
339
|
+
- **No code execution.** The pipeline runs `gh api` and `npm view` only; it never installs, builds, or runs a target.
|
|
340
|
+
- **Argv-only subprocesses.** Every CLI invocation is an argv array, never shell-interpreted; repo owner/repo segments are validated against a restricted character set before use in an endpoint.
|
|
341
|
+
- **Evidence discipline.** No score is fabricated: a probe that fails or returns unparsable output yields `no-evidence`, never a number.
|
|
342
|
+
- **Detection vs redaction.** Secret-leak and malicious-install-script detection share the same pure regexes as redaction; both are unit-tested against extreme inputs.
|
|
343
|
+
|
|
344
|
+
## Permissions & data
|
|
345
|
+
|
|
346
|
+
- **Permissions**: only public services are consumed — `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`; the plugin provides no Cordis service key.
|
|
347
|
+
- **Data**: score cards and leaderboards live in the `score` storage domain (tables `scores`, `leaderboards`, plus the latest-leaderboard pointer). Without `storageDomain` the tools still work and persistence is disabled with a logged reason.
|
|
348
|
+
- **Environment**: child processes inherit the provider's credential-scrubbed environment; `gh` reads its own credential store. No environment value is ever logged, and every report/log string passes through pure sanitizers with byte-capped tails.
|
|
349
|
+
|
|
350
|
+
## Known limitations
|
|
351
|
+
|
|
352
|
+
- Repository probes require `gh` to be authenticated and network access to GitHub; npm probes require `npm` and registry access.
|
|
353
|
+
- A target without a resolvable GitHub repository cannot be inspected for documentation, security, or compliance (those dimensions report `no-evidence`).
|
|
354
|
+
- Install success depends on `dsh-test-drive` being mounted and having recorded the target; otherwise it is honestly `no-evidence`.
|
|
355
|
+
- The maintenance "issue response" signal is a proxy (oldest open issue age), not a direct response-time measurement.
|
|
356
|
+
- Score results are cached per target; use `refresh: true` (or wait past `cacheMaxAgeMs`) to force re-scoring.
|
|
357
|
+
|
|
358
|
+
## Interoperability with other DSH plugins
|
|
359
|
+
|
|
360
|
+
`dsh-score` only exposes its own scoring surface and never takes over another plugin's lane:
|
|
361
|
+
|
|
362
|
+
- **Self-contained tool surface.** It registers exactly three tools (`score`, `score_report`, `score_badge`) and one command (`/score`), all through `ctx.effect`, so stop/hot-reload removes them.
|
|
363
|
+
- **No service key.** `inject` declares only `tools`, `commands`, `subprocess`, and `jobs`; `storageDomain` is read optionally through `ctx.get` and never required.
|
|
364
|
+
- **No client lane.** It registers no client slot key and no `webServer` route prefix.
|
|
365
|
+
- **No patch-layer collision.** The bundle patch only `insert`s its own row (`id: score`); it never overrides a built-in row's `config`.
|
|
366
|
+
- **No global mutation.** It does not patch prototypes, rewrite `process.env`, or replace the global fetch dispatcher.
|
|
367
|
+
- **No shared-event listeners.** It registers no waterfall listener (including `agent/pre-step`), so it takes no part in event-chain ordering and cannot short-circuit another plugin's chain.
|
|
368
|
+
|
|
369
|
+
Static evidence: the `dsh-plugin-doctor` verification badge is driven by this repository's CI output (see "Ecosystem & quality").
|
|
370
|
+
|
|
371
|
+
## Compatibility
|
|
372
|
+
|
|
373
|
+
| Component | Version |
|
|
374
|
+
|---|---|
|
|
375
|
+
| DeepSeek Harness | **`dsh-v0.2.2-rc.4`** (GitHub tag). The `engines.dsh` gate is `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`; dev/test pins and the `typecheck:ci` ruler measure `0.2.2-rc.1`. The `ctx.jobs` seam uses the `SessionId` contract. |
|
|
376
|
+
| Node.js | `^22.19.0 \|\| >=24.9.0` |
|
|
377
|
+
| Package manager | `pnpm@11.7.0` |
|
|
378
|
+
| Platform | Windows / macOS / Linux (host-only plugin) |
|
|
379
|
+
| External tools | `gh` CLI on PATH (authenticated for API reads), `npm` CLI on PATH |
|
|
380
|
+
|
|
381
|
+
## Ecosystem & quality
|
|
382
|
+
|
|
383
|
+
- [Gitee mirror](https://gitee.com/perrylink/dsh-score) (sync mirror; GitHub is canonical)
|
|
384
|
+
- [dshfind plugin page](https://dshfind.com/plugins/PerryLink/dsh-score) (installs and ranking)
|
|
385
|
+
- [OpenSSF Scorecard report](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-score) (driven by [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml))
|
|
386
|
+
- [dsh-plugin-doctor verification report](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章) (badge source)
|
|
387
|
+
- [DSH Market](https://dsh.market/) (listed)
|
|
388
|
+
- **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-score` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking)
|
|
389
|
+
- [Ecosystem knowledge base](https://perrylink.github.io/dsh-plugin-guide/) — measured data, not marketing: plugin development guide · plugin-selection data · maintenance criteria
|
|
390
|
+
|
|
391
|
+
## Development
|
|
392
|
+
|
|
393
|
+
```sh
|
|
394
|
+
pnpm install # node ^22.19 || >=24.9
|
|
395
|
+
pnpm run typecheck && pnpm run typecheck:ci && pnpm test # local checkout face + published-line face + vitest
|
|
396
|
+
pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
|
|
397
|
+
pnpm run check:readmes # five-language README consistency
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
- `typecheck` resolves `@deepseek-ai/*` through the local harness checkout; `typecheck:ci` checks against the published `0.2.2-rc.1` types.
|
|
401
|
+
- Tests use the real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/storage stack with a scripted subprocess provider.
|
|
402
|
+
- Real-CLI scoring (requires `gh`/`npm` on PATH and `gh` authenticated): invoke `score` from a mounted profile.
|
|
403
|
+
- Release: `node scripts/release.mjs <x.y.z>` (bumps, stamps CHANGELOG, re-runs the gate, commits + tags; never pushes).
|
|
404
|
+
- The README images are generated programmatically by [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Pillow for the hero banner, hand-written SVG for the structure diagram) and are safe to re-run; the older single-skin flow diagram and demo images stay in `docs/assets/` for external deep links, while the READMEs reference only the new hero and flow-v5 structure diagram, each in light and dark.
|
|
405
|
+
|
|
406
|
+
Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-scoring`, `quality-score`, `leaderboard`, `supply-chain`
|
|
407
|
+
|
|
408
|
+
## Family & thanks
|
|
409
|
+
|
|
410
|
+
This project is part of the DeepSeek Harness plugin family from [PerryLink](https://github.com/PerryLink) (all Apache-2.0). If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
411
|
+
|
|
412
|
+
- [@PerryLink](https://github.com/PerryLink) — creator and maintainer: the five-dimension pipeline, the `gh`/`npm` evidence probes, the structured `dsh-score/v1` contract, the `/score` batch job, the badge, and the five-language docs.
|
|
413
|
+
|
|
414
|
+
<details>
|
|
415
|
+
<summary>Expand all plugins</summary>
|
|
416
|
+
|
|
417
|
+
| Plugin | Status |
|
|
418
|
+
|---|---|
|
|
419
|
+
| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
|
|
420
|
+
| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
|
|
421
|
+
| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
|
|
422
|
+
| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
|
|
423
|
+
| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
|
|
424
|
+
| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
|
|
425
|
+
| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
|
|
426
|
+
| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
|
|
427
|
+
| **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
|
|
428
|
+
| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
|
|
429
|
+
| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
|
|
430
|
+
| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
|
|
431
|
+
| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 FROZEN — see the repo README |
|
|
432
|
+
| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
|
|
433
|
+
| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
|
|
434
|
+
| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
|
|
435
|
+
| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
|
|
436
|
+
| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
|
|
437
|
+
| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
|
|
438
|
+
| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
|
|
439
|
+
| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
|
|
440
|
+
| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
|
|
441
|
+
| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
|
|
442
|
+
| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
|
|
443
|
+
| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
|
|
444
|
+
| **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
|
|
445
|
+
| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
|
|
446
|
+
| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
|
|
447
|
+
| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
|
|
448
|
+
| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
|
|
449
|
+
| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
|
|
450
|
+
| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
|
|
451
|
+
| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
|
|
452
|
+
| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
|
|
453
|
+
| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
|
|
454
|
+
| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
|
|
455
|
+
| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
|
|
456
|
+
| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
|
|
457
|
+
| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
|
|
458
|
+
| **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
|
|
459
|
+
| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
|
|
460
|
+
| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
|
|
461
|
+
| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
|
|
462
|
+
| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
|
|
463
|
+
| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
|
|
464
|
+
| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 FROZEN — see the repo README |
|
|
465
|
+
| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
|
|
466
|
+
| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
|
|
467
|
+
| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
|
|
468
|
+
| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
|
|
469
|
+
| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
|
|
470
|
+
| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
|
|
471
|
+
| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
|
|
472
|
+
| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
|
|
473
|
+
| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
|
|
474
|
+
| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
|
|
475
|
+
| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
|
|
476
|
+
| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 RETIRED (repo archived) |
|
|
477
|
+
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
|
|
478
|
+
| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 RETIRED (repo archived) |
|
|
479
|
+
| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 RETIRED (repo archived) |
|
|
480
|
+
| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
|
|
481
|
+
| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
|
|
482
|
+
| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
|
|
483
|
+
| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
|
|
484
|
+
| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
|
|
485
|
+
| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
|
|
486
|
+
| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
|
|
487
|
+
| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
|
|
488
|
+
| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
|
|
489
|
+
| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
|
|
490
|
+
| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
|
|
491
|
+
| **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 FROZEN — see the repo README |
|
|
492
|
+
| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
|
|
493
|
+
| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
|
|
494
|
+
| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
|
|
495
|
+
| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
|
|
496
|
+
| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
|
|
497
|
+
| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
|
|
498
|
+
| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
|
|
499
|
+
| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
|
|
500
|
+
| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
|
|
501
|
+
| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
|
|
502
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
|
|
503
|
+
| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 RETIRED (repo archived) |
|
|
504
|
+
| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
|
|
505
|
+
| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
|
|
506
|
+
| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 FROZEN — see the repo README |
|
|
507
|
+
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 FROZEN — see the repo README |
|
|
508
|
+
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 FROZEN — see the repo README |
|
|
509
|
+
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 FROZEN — see the repo README |
|
|
510
|
+
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 FROZEN — see the repo README |
|
|
511
|
+
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRED (repo archived) |
|
|
512
|
+
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED (repo archived) |
|
|
513
|
+
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED (repo archived) |
|
|
514
|
+
|
|
515
|
+
</details>
|
|
516
|
+
|
|
517
|
+
## HCB compatibility input
|
|
518
|
+
|
|
519
|
+
The host compatibility matrix and the ENTRY/FLOW/BOOST tracks are published in [HCB](https://github.com/PerryLink/dsh-hcb); this README does not maintain a second host-version matrix.
|
|
520
|
+
|
|
521
|
+
## License
|
|
522
|
+
|
|
523
|
+
[LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-score contributors
|
|
524
|
+
|
|
525
|
+
<p align="center"><sub>Apache-2.0 · Community plugin, not affiliated with DeepSeek.</sub></p>
|