@lmzhen/dsh-memory-files 0.32.4 → 0.32.6

package/README.md

@@ -1,33 +1,17 @@
 # @lmzhen/dsh-memory-files
 
-Local layered memory provider: registers the `files` provider into `ctx.memory` over the IO seam.
+Default layered memory provider backed by `MEMORY.md` and `USER.md`. It registers as `files` and publishes the effective memory-budget view used by diagnostics.
 
-## Model surface
+`root` defaults to `$DSH_HOME/memories`. The store enforces its character budget on the final result and refuses overflow rather than silently truncating an entry. Batch writes are serialized within the provider; cross-process safety still depends on the selected IO backend.
 
-- **Model-visible:** nothing of its own: `tool-memory` owns the tool and the injection.
-- **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 `memory-files` provider row, in `evolution-host`/`evolution-all`/one-click `evolution-preset`.
+## Budgets and defaults
 
-## Configuration
+- `memoryChars`: fallback default 2,200 characters for `MEMORY.md`.
+- `userChars`: fallback default 1,375 characters for `USER.md`.
+- `addDatePrefix`: default `false`.
+- `maxConsolidationFailures`: default 3 failures before the model is told to stop retrying.
+- `providerName`: default `files`.
 
-- `providerName` (default `files`): the registered name.
-- `memoryCharLimit` / `userCharLimit` (`2200` / `1375`) the budget the STORE enforces per target.
-  Deprecated names (G0/S0.3): the canonical ids are the policy row's `memoryChars` /
-  `userChars` (what the review planner reads). The two sides are not
-  auto-synchronised — `/evolution doctor` reports the divergence (`budgetIssues`).
-  Reading the legacy names still works; writing them is refused. Removal was planned for 0.7.0 and is deferred:
-  both aliases still ship, so no later version is claimed here.
-- `root`: directory override; `''` means `$DSH_HOME/memories`.
-- `addDatePrefix` / `maxConsolidationFailures` (`false` / `3`) date prefixes on entries; consolidation failures one turn tolerates.
-- `threatExemptLabels` (default `[]`): benign threat labels for the MEMORY store (per-site rule in `evolution-threat`).
+An explicit row/user value wins. Otherwise an already mounted evolution-policy budget takes precedence over the package fallback. The row budget controls what the store enforces; the policy budget controls what review plans against, so an explicit mismatch is warned about and surfaced by doctor.
 
-## Known limitations
-
-- **The memory budget is configured in two places.** `memoryCharLimit`/`userCharLimit` (this package) is what the STORE enforces; `evolution-policy`'s `memoryChars`/`userChars` is what the review pipeline PLANS against. An unset limit follows the mounted policy, an explicit value wins, a contradiction warns once at load; `/evolution doctor` re-checks the pair at run time.
-- Nothing selects this provider implicitly: with `memory.provider` empty the FIRST registered provider serves every read/write: set the pin or row order decides.
-
-**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
-
-- `memory.provider` pins the registry to one name (V27 G6.3), and with the pin empty the FIRST registered provider serves every read/write: so with two providers mounted, set the pin or the choice is row order.
+`memoryCharLimit` and `userCharLimit` remain readable deprecated aliases of `memoryChars` and `userChars`; writes to the old names are refused (G0/S0.3). `threatExemptLabels` is deployment security configuration and defaults to empty.

package/lib/index.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
 import { resolve } from "node:path";
 import z from "@deepseek-ai/schemastery";
-import { DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_USER_CHAR_LIMIT, MemoryStore, clampOnce, evolutionIoAdapter, liveBool, makeSerialQueue, paramRowId, payloadText, unwrapLive, userSetKeys } from "@lmzhen/dsh-evolution-core";
+import { DEFAULT_CONSOLIDATION_FAILURES, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_USER_CHAR_LIMIT, MemoryStore, clampOnce, evolutionIoAdapter, liveBool, makeSerialQueue, paramRowId, payloadText, registerOwnerSettings, unwrapLive, userSetKeys } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Local layered memory provider for `ctx.memory`.
@@ -21,6 +21,7 @@ const Config = z.object({
 	threatExemptLabels: z.array(z.string()).default([])
 });
 function apply(ctx, rawConfig = {}) {
+	registerOwnerSettings(ctx, "memory-files", Config);
 	ctx.inject(["settings"], (injected) => {
 		const settings = injected.settings;
 		if (typeof settings?.configure !== "function") return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-memory-files",
   "description": "Local layered memory provider (community build)",
-  "version": "0.32.4",
+  "version": "0.32.6",
   "publishConfig": {
     "access": "public"
   },
@@ -27,17 +27,17 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-core": "^0.32.4"
+    "@lmzhen/dsh-evolution-core": "^0.32.6"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
-    "@lmzhen/dsh-evolution-io": "^0.32.4",
-    "@lmzhen/dsh-memory": "^0.32.4"
+    "@lmzhen/dsh-evolution-io": "^0.32.6",
+    "@lmzhen/dsh-memory": "^0.32.6"
   },
   "devDependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.32.4",
-    "@lmzhen/dsh-evolution-io": "^0.32.4",
-    "@lmzhen/dsh-memory": "^0.32.4"
+    "@lmzhen/dsh-evolution-core": "^0.32.6",
+    "@lmzhen/dsh-evolution-io": "^0.32.6",
+    "@lmzhen/dsh-memory": "^0.32.6"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"