@lmzhen/dsh-skill-usage 0.32.4 → 0.32.6
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/README.md +8 -22
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -1,28 +1,14 @@
|
|
|
1
1
|
# @lmzhen/dsh-skill-usage
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
`record(name, kind)` is the write API; reads are observed from `session/event`
|
|
5
|
-
`tool/call` records of the `skill` tool and bump `view` on EXISTING records only — a read never
|
|
6
|
-
mints one.
|
|
3
|
+
Usage telemetry service for skill authorship and demand. It records use/view/patch counters, archive state, support-file reads, and feedback-owned quality fields for curator and health calculations.
|
|
7
4
|
|
|
8
|
-
|
|
5
|
+
Session dispatch observation counts a successfully settled skill read once and excludes review-leg traffic. Reads of unknown skills do not create usage records; creation/authorship paths must seed the record first. The first observed library read also attempts to append an observation-window event to the evolution timeline.
|
|
9
6
|
|
|
10
|
-
|
|
11
|
-
- **Prompt prefix / KV cache:** unchanged by this package: family-level rules single-sourced in `packages/README.md` §"Model-visible prompt prefix and the KV cache".
|
|
12
|
-
- **Mount it?** yes — the `skill-usage` row (`sessionScoped: true`), `evolution-host`/`evolution-all`/one-click `evolution-preset`; consumed by `evolution-feedback` and `tool-skill-manage`.
|
|
13
|
-
|
|
14
|
-
## Configuration
|
|
15
|
-
|
|
16
|
-
- `root` (default `''`): skills-tree root.
|
|
17
|
-
- `eventsHome`: the event timeline's home; `''` means `DSH_HOME` / `~/.dsh`.
|
|
18
|
-
- `sessionScoped` (default `false`): act only on sessions carrying the family's model tools (the bundles set it).
|
|
19
|
-
|
|
20
|
-
## Known limitations
|
|
21
|
-
|
|
22
|
-
- No known durable consumer gaps; runtime contracts are covered by package and boundary tests.
|
|
23
|
-
|
|
24
|
-
**Runtime invariant:** No companion is published. The platform auto-assembles nothing and the family mounts no `<pkg>/invariant` cordis row, so a companion here would never execute (v37 S2.1 / I-3).
|
|
25
|
-
|
|
26
|
-
## Notes and history
|
|
7
|
+
## Configuration and limits
|
|
27
8
|
|
|
9
|
+
- `root`: skill tree and usage sidecar root; empty uses the shared default.
|
|
10
|
+
- `eventsHome`: event timeline home; empty uses the normal evolution root.
|
|
11
|
+
- `sessionScoped`: when true, observe only sessions carrying the family model rows; shipped bundles set the appropriate scope.
|
|
12
|
+
- `supportReadToolNames`: file-reading tools whose successful calls can be attributed to support files.
|
|
28
13
|
|
|
14
|
+
Telemetry persistence and the observation-window timeline append are best effort and logged on failure. There is no direct command or panel; consumers read `report()` or the resulting curator/health views.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lmzhen/dsh-skill-usage",
|
|
3
3
|
"description": "Skill usage telemetry service (community build)",
|
|
4
|
-
"version": "0.32.
|
|
4
|
+
"version": "0.32.6",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -27,17 +27,17 @@
|
|
|
27
27
|
"license": "MIT",
|
|
28
28
|
"dependencies": {
|
|
29
29
|
"@deepseek-ai/schemastery": "^3.18.5",
|
|
30
|
-
"@lmzhen/dsh-evolution-core": "^0.32.
|
|
30
|
+
"@lmzhen/dsh-evolution-core": "^0.32.6"
|
|
31
31
|
},
|
|
32
32
|
"peerDependencies": {
|
|
33
33
|
"@deepseek-ai/cordis": "^4.0.5",
|
|
34
34
|
"@deepseek-ai/dsh-session": "^0.2.1-rc.2",
|
|
35
|
-
"@lmzhen/dsh-evolution-io": "^0.32.
|
|
35
|
+
"@lmzhen/dsh-evolution-io": "^0.32.6"
|
|
36
36
|
},
|
|
37
37
|
"devDependencies": {
|
|
38
38
|
"@deepseek-ai/dsh-session": "^0.2.1-rc.2",
|
|
39
|
-
"@lmzhen/dsh-evolution-core": "^0.32.
|
|
40
|
-
"@lmzhen/dsh-evolution-io": "^0.32.
|
|
39
|
+
"@lmzhen/dsh-evolution-core": "^0.32.6",
|
|
40
|
+
"@lmzhen/dsh-evolution-io": "^0.32.6"
|
|
41
41
|
},
|
|
42
42
|
"engines": {
|
|
43
43
|
"dsh": ">=0.2.1-rc.2 <0.2.2-0"
|