@lmzhen/dsh-evolution-state 0.3.83 → 0.4.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.
Files changed (2) hide show
  1. package/README.md +13 -15
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -1,26 +1,24 @@
1
1
  # @lmzhen/dsh-evolution-state
2
2
 
3
- Provider-selection surface for durable curator and review state records
3
+ Durable evolution state consumer: it owns no medium and performs no IO — a provider registered in
4
+ `ctx.evolutionStateStorage` does.
4
5
 
5
- ## Model Experience
6
+ ## Model surface
6
7
 
7
- ### Indirect model surface
8
+ - **Model-visible:** nothing of its own: the rows that read this state own the injection.
9
+ - **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".
10
+ - **Mount it?** yes — the `evolution-state` row, in `evolution-host`/`evolution-all`/one-click `evolution-preset` (all pin `provider: json`).
8
11
 
9
- #### What the model sees
12
+ ## Configuration
10
13
 
11
- `@lmzhen/dsh-evolution-state` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
14
+ - `provider` (`''` default, or `json` / `domain`): pins the provider for every operation; empty = first registered wins.
12
15
 
13
- #### Token effect
16
+ ## Known limitations
14
17
 
15
- Zero direct token effect from this package; consumers add any model-visible tokens.
16
-
17
- #### KV Cache effect
18
-
19
- Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
20
-
21
- ## Known Limitations and Deferred Work
18
+ - An empty pin with two providers mounted resolves by REGISTRATION ORDER (one warn per ambiguous period): enabling the domain row in an overlay rebinds every operation to an empty medium while the state on disk under the other provider becomes invisible (`/evolution pending` empty, approve misses).
22
19
 
20
+ **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).
23
21
 
24
- - No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
22
+ ## Notes and history
25
23
 
26
- **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).
24
+ - `provider` pins the registry to one provider name; a pinned name is checked at mount once any provider has registered (S-07).
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@lmzhen/dsh-evolution-state",
3
3
  "description": "Durable evolution state consumer over pluggable storage providers (community build)",
4
- "version": "0.3.83",
4
+ "version": "0.4.0",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -30,9 +30,9 @@
30
30
  },
31
31
  "peerDependencies": {
32
32
  "@deepseek-ai/cordis": "^4.0.1",
33
- "@lmzhen/dsh-evolution-state-storage": "^0.3.83"
33
+ "@lmzhen/dsh-evolution-state-storage": "^0.4.0"
34
34
  },
35
35
  "devDependencies": {
36
- "@lmzhen/dsh-evolution-state-storage": "^0.3.83"
36
+ "@lmzhen/dsh-evolution-state-storage": "^0.4.0"
37
37
  }
38
38
  }