@lmzhen/dsh-skill-usage 0.3.83 → 0.4.1

package/README.md

@@ -1,34 +1,28 @@
 # @lmzhen/dsh-skill-usage
 
-Skill usage telemetry service
+Skill usage telemetry: the `use`/`view`/`patch` counters behind the skill tree's usage records.
+`record(name, kind)` is the write API; reads are observed from `session/event`
+`tool/call` records of the `skill` tool and bump `view` on EXISTING records only — a read never
+mints one.
 
-## Telemetry sources
+## Model surface
 
-`record(name, kind)` is the write API (`use` / `view` / `patch`). Reads are
-observed automatically: the service listens for `session/event` `tool/call`
-records of the read tool (`skill`) and bumps `view` on EXISTING records only —
-an arbitrary read never mints a usage record (records are authored by skill
-creation, patching, or curator seeding).
+- **Model-visible:** nothing of its own: the counter readers own it.
+- **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".
+- **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`.
 
-## Model Experience
+## Configuration
 
-### Indirect model surface
+- `root` (default `''`): skills-tree root.
+- `eventsHome`: the event timeline's home; `''` means `DSH_HOME` / `~/.dsh`.
+- `sessionScoped` (default `false`): act only on sessions carrying the family's model tools (the bundles set it).
 
-#### What the model sees
+## Known limitations
 
-`@lmzhen/dsh-skill-usage` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
+- No known durable consumer gaps; runtime contracts are covered by package and boundary tests.
 
-#### Token effect
-
-Zero direct token effect from this package; consumers add any model-visible tokens.
-
-#### KV Cache effect
-
-Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
-
-## Known Limitations and Deferred Work
+**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).
 
+## Notes and history
 
-- No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
 
-**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).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-skill-usage",
   "description": "Skill usage telemetry service (community build)",
-  "version": "0.3.83",
+  "version": "0.4.1",
   "publishConfig": {
     "access": "public"
   },
@@ -27,16 +27,16 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.83"
+    "@lmzhen/dsh-evolution-core": "^0.4.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.3.83"
+    "@lmzhen/dsh-evolution-io": "^0.4.1"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.3.83",
-    "@lmzhen/dsh-evolution-io": "^0.3.83"
+    "@lmzhen/dsh-evolution-core": "^0.4.1",
+    "@lmzhen/dsh-evolution-io": "^0.4.1"
   }
 }