@lmzhen/dsh-evolution-commands 0.3.83 → 0.4.0

package/README.md

@@ -1,51 +1,28 @@
 # @lmzhen/dsh-evolution-commands
 
-Human commands for the evolution family
+Human commands for the evolution family: it registers the `/evolution …` command surface
+and its help text, and drives the other rows from a command. It adds no automatic
+background behaviour of its own.
 
-## Command reference
-
-The full `/evolution` subcommand table is single-sourced in the family
-README's **Command reference** section (`packages/README.md` in the source
-repository; it is named here instead of linked because a repo-relative
-markdown link out of this package would be dead inside the npm published
-tree). It is rendered from the subcommand registry (`src/registry.ts`, the same
-single source as the `/evolution` input-declaration hint and the
-bare-command help output), and `tests/registry.spec.ts` (T-WD2) pins that
-rendered table byte-for-byte. This package README cites that home instead
-of restating the table (doc-facts rule N19: never copy a fact across docs).
-
-## Model Experience
-
-### Indirect model surface
-
-#### What the model sees
-
-`@lmzhen/dsh-evolution-commands` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
+## Model surface
 
-#### Token effect
+- **Model-visible:** one direct token — the `/evolution learn` injection — the full learning guidance is injected as a user message in this session; everything else adds no tokens.
+- **Prompt prefix / KV cache:** independent of request-prefix construction — it does not alter the assembled prompt or tool list; family rules: `packages/README.md` §"Model-visible prompt prefix and the KV cache".
+- **Mount it?** yes — the `evolution-commands` row, carried by the `evolution-host`, `evolution-all` and `evolution-preset` bundles.
 
-P2-22 (v11) correction: this package's **only** direct model-visible token is the
-`/evolution learn` injection — the full learning guidance is injected as a user
-message in this session. Everything else adds no tokens; consumers add their own.
-The injection goes through the agent's waking primitive (`followup`, falling back
-to `inject` when the host lacks it), **called on the agent instance**: the
-platform's `Agent.followup` is a prototype method (`this.send(...)`), so a
-detached reference throws and queues nothing (0.3.73 fix; the same shape is
-pinned by rule N13b in `packages/scripts/verify-arch-guards.mjs`, which masks comments and string literals before matching and self-tests its detector at startup).
-
-#### KV Cache effect
-
-Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
+## Command reference
 
-## Known Limitations and Deferred Work
+The full `/evolution` subcommand table is single-sourced in the family README's **Command reference** section (`packages/README.md` in the source repository; it is named here instead of linked because a repo-relative markdown link out of this package would be dead inside the npm published tree). It is rendered from the subcommand registry (`src/registry.ts`, the same single source as the `/evolution` input-declaration hint and the bare-command help output), and `tests/registry.spec.ts` (T-WD2) pins that rendered table byte-for-byte.
 
+## Known limitations
 
 - No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
-- **① variant form: the `/evolution …` command face is visible in every session**
-  (accepted, not fixed — 0.3.78). Commands are registered in scope layers, and the
-  family registers once on the host plane, so a session on a platform original
-  preset still lists the management-only subcommands even though no automatic
-  family behaviour reaches it. The difference and its reasoning are single-sourced
-  in `INSTALL.md` ("Known difference").
+- **① variant form: the `/evolution …` command face is visible in every session** (accepted, not fixed). Commands are registered in scope layers, and the family registers once on the host plane, so a session on a platform original preset still lists the management-only subcommands even though no automatic family behaviour reaches it. The difference and its reasoning are single-sourced in `INSTALL.md` ("Known difference").
 
 **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
+
+- P2-22 (v11) correction: this package's **only** direct model-visible token is the `/evolution learn` injection — the full learning guidance is injected as a user message in this session.
+- **① variant form: the `/evolution …` command face is visible in every session** (accepted, not fixed: 0.3.78).
+- The injection goes through the agent's waking primitive (`followup`, falling back to `inject` when the host lacks it), **called on the agent instance**: the platform's `Agent.followup` is a prototype method (`this.send(...)`), so a detached reference throws and queues nothing (0.3.73 fix; the same shape is pinned by rule N13b in `packages/scripts/verify-arch-guards.mjs`, which masks comments and string literals before matching and self-tests its detector at startup).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-commands",
   "description": "Human commands for the evolution family (/evolution pending|curator|maintain|doctor) (community build)",
-  "version": "0.3.83",
+  "version": "0.4.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,12 +27,12 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-approval": "^0.3.83",
-    "@lmzhen/dsh-evolution-core": "^0.3.83",
-    "@lmzhen/dsh-evolution-maintenance": "^0.3.83"
+    "@lmzhen/dsh-evolution-approval": "^0.4.0",
+    "@lmzhen/dsh-evolution-core": "^0.4.0",
+    "@lmzhen/dsh-evolution-maintenance": "^0.4.0"
   },
   "optionalDependencies": {
-    "@lmzhen/dsh-evolution-agent-preset": "^0.3.83"
+    "@lmzhen/dsh-evolution-agent-preset": "^0.4.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",