@lmzhen/dsh-evolution-maintenance 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 +27 -26
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,30 +1,31 @@
1
1
  # @lmzhen/dsh-evolution-maintenance
2
2
 
3
- Skill-library drift-scanning determinism surface for the maintenance subagent
4
- (design 011 — the maintenance-subagent design paper, archived in git history).
5
-
6
- - `snapshotFromLibrary` — assemble a plain skill snapshot from a SkillLibrary-like reader.
7
- - `renderFacts` — canonical `MECHANICAL_FACTS` block (version + joint signature + redaction).
8
-
9
- Signal computation lives in `@lmzhen/dsh-evolution-core` (`drift-signals`); this
10
- package owns assembly and rendering only.
11
-
12
- ## Known Limitations and Deferred Work
13
-
14
- - Phase 1-2 expose no service beyond the command surface: the chain
15
- (commands → scan → render → subagent → validate) is wired through
16
- `/evolution maintain`; orchestration lives in this package.
17
- - `maintenance_probe` (read-only deep-dive tool, host-mounted via
18
- `evolution-maintenance-tools`) is available to maintenance subagents only
19
- through the orchestrate `toolFilter` allow-list; it is globally visible to
20
- every session as a read-only query (same exposure tier as the `skill`
21
- tool — never a write path). V10 (F-02): orchestrate soft-probes the tools
22
- registry before spawning and degrades the filter to `skill`-only (declared
23
- in the subagent prompt) when the tool row is not mounted, instead of failing
24
- the spawn; an explicit `toolAllow` option bypasses the probe.
25
- - The model-visible template (`MAINTAIN_PROMPT`) and the subagent output
26
- instruction (`MAINTAIN_OUTPUT_INSTRUCTION`, V10 F-16) ship in `evolution-core`
27
- `PROMPT_BUNDLE`; the joint-signature mismatch protocol is honored by
28
- `renderFacts` callers, not by this package alone.
3
+ Skill-library drift-scanning determinism surface for the maintenance subagent: it assembles the
4
+ skill snapshot, renders the mechanical-facts block and runs the scan → subagent → validate
5
+ chain behind `/evolution maintain` (`evolution-core` `drift-signals`).
6
+
7
+ - `snapshotFromLibrary`: assemble a plain skill snapshot from a SkillLibrary-like reader.
8
+ - `renderFacts`: canonical `MECHANICAL_FACTS` block (version + joint signature + redaction).
9
+
10
+ ## Model surface
11
+
12
+ - **Model-visible:** the read-only `maintenance_probe` tool schema (`evolution-maintenance/tools`), mounted for every session.
13
+ - **Prompt prefix / KV cache:** no system-prompt section of its own; family-level rules: `packages/README.md` §"Model-visible prompt prefix and the KV cache".
14
+ - **Mount it?** yes — the `evolution-maintenance/tools` row (host/all/preset); the orchestration is consumed by `evolution-commands` (`/evolution maintain`).
15
+
16
+ ## Known limitations
17
+
18
+ - Phase 1-2 expose no service beyond the command surface: the chain (scan → render → subagent → validate) is wired through `/evolution maintain`.
19
+ - **Plan validation is instance-granular (§3 completeness).** Notes stay id-level: one mention explains away every instance of that id.
20
+ - **A budget-capped dedup scan is reported, never silently shortened.**
21
+ - `maintenance_probe` is readable by every session; maintenance subagents reach it through the orchestrate `toolFilter` allow-list.
22
+ - The model-visible template (`MAINTAIN_PROMPT`) and the subagent output instruction (`MAINTAIN_OUTPUT_INSTRUCTION`, V10 F-16) ship in `evolution-core` `PROMPT_BUNDLE`; the joint-signature mismatch protocol is honored by `renderFacts` callers, not by this package alone.
29
23
 
30
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
27
+
28
+ - (design 011: the maintenance-subagent design paper, archived in git history).
29
+ - The facts block renders one line per skill, so ONE signal id can be `over` on several skills: every `over` instance (`skill::id`; a library-level signal renders once and keeps the bare id) must be covered by plan evidence or named in a note, so a plan that advises one skill no longer zero-explains the same signal on its siblings (P2-4, 0.3.83).
30
+ - `maintenance_probe` appends "note: dedup scan truncated at the pair-comparison budget; groups may be incomplete" and the `dedup_group` signal value carries the same qualification (P2-8, 0.3.83).
31
+ - V10 (F-02): orchestrate soft-probes the tools registry before spawning and degrades the filter to `skill`-only (declared in the subagent prompt) when the tool row is not mounted, instead of failing the spawn; an explicit `toolAllow` option bypasses the probe.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@lmzhen/dsh-evolution-maintenance",
3
3
  "description": "Deterministic maintenance-scan surface: skill-library snapshot assembly, drift signals and mechanical-facts rendering (design 011) (community build)",
4
- "version": "0.3.83",
4
+ "version": "0.4.0",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -31,7 +31,7 @@
31
31
  "license": "MIT",
32
32
  "dependencies": {
33
33
  "@deepseek-ai/schemastery": "^3.18.1",
34
- "@lmzhen/dsh-evolution-core": "^0.3.83"
34
+ "@lmzhen/dsh-evolution-core": "^0.4.0"
35
35
  },
36
36
  "peerDependencies": {
37
37
  "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",