@kira905/dsh-memory-toolkit 0.0.0-stage → 0.1.1

package/README.en.md

@@ -0,0 +1,110 @@
+# dsh-memory-toolkit
+
+**Memory-side tooling for DSH (DeepSeek Harness).** A standalone vector memory engine, a read-only
+memory-database audit toolkit, a self-maintained fork of the local memory plugin, and a tiny
+persona ↔ memory audit.
+
+All four pieces come from one self-hosted workflow, split out so they can be used together or on their own:
+**the engine decides what to remember and how to find it again; the toolkit makes it visible and
+fixable; the plugin wires it into a session.**
+
+---
+
+## 1. What's inside
+
+| Directory | What it is | Form |
+|---|---|---|
+| [`memory-engine/`](./memory-engine/README.md) | Memory engine (offline layer): standalone vector store · incremental sync · hash-rotation fallback sweep · hybrid recall (vector + FTS5 + RRF) · document index · startup self-check · local encoding bridge | plain Node ESM + `node:sqlite` |
+| [`memory-db-tools/`](./memory-db-tools/README.md) | Memory database toolkit: read-only export / six-way audit analysis / structure probe / feature-word probe / persona overlap / board-ledger probe / zero-write proof / new-session briefing | a set of standalone CLIs |
+| [`dsh-memory-local/`](./dsh-memory-local/README.md) | Local memory plugin: a self-maintained fork of upstream `dsh-memory` (cross-session memory + recall prompt section + pointer injection), with build / idempotent deploy / one-command rollback / post-deploy self-check | DSH plugin |
+| [`persona-memory-audit.mjs`](./persona-memory-audit.mjs) | Persona ↔ memory audit: pins down "persona body size" and "memory visibility" and reports red past thresholds | single-file CLI |
+| [`lib/`](./lib) | Zero-dependency shared bits (argument allow-list / HTTP liveness judgement / zstd frames / session file names / pitfall scoring) | pure modules |
+
+## 2. Requirements
+
+- **Node.js ≥ 22** (built-in `node:sqlite`, ESM)
+- Windows / Linux / macOS. Every default path is derived from **environment variables or the current
+  working directory** — there are no hard-coded machine paths in this repo
+- Local vector encoding in `memory-engine/` additionally needs `@huggingface/transformers` (optional)
+
+## 3. Install
+
+```bash
+git clone https://github.com/kira905/dsh-memory-toolkit.git
+cd dsh-memory-toolkit
+npm install          # the root package has no runtime dependencies
+```
+
+For local ONNX vector encoding (optional):
+
+```bash
+cd memory-engine
+npm install          # pulls @huggingface/transformers (large, 300+ MB)
+```
+
+You can skip it entirely: the engine also supports an HTTP encoding bridge and a pure FTS5 fallback path.
+
+## 4. Quick start
+
+```bash
+# ① Toolkit usage and options (zero side effects)
+node memory-db-tools/audit-export.mjs --help
+
+# ② Persona ↔ memory audit (read-only)
+node persona-memory-audit.mjs --help
+
+# ③ New-session briefing (read-only)
+node memory-db-tools/list-memory-summary.mjs --help
+
+# ④ Engine startup self-check (run npm install inside memory-engine/ first)
+cd memory-engine && node cli/selfcheck.mjs --json
+```
+
+A typical **quarterly memory audit** (read-only; artifacts go where you point them):
+
+```bash
+node memory-db-tools/audit-export.mjs --out ./_audit/memories.json
+node memory-db-tools/audit-analyze.mjs --in ./_audit/memories.json --out ./_audit
+node memory-db-tools/audit-struct-probe.mjs --in ./_audit/memories.json
+node memory-db-tools/audit-verify-unchanged.mjs --baseline ./_audit/memories.json --expect-unchanged
+```
+
+## 5. Integration points with DSH
+
+This repo runs **without** DSH, but three seams are deliberate:
+
+| Seam | Notes |
+|---|---|
+| `DSH_HOME` (default `~/.dsh`) | Memory DB (`memory/memory.db`), vector store (`memory-vectors/`), presets (`.agent-presets/`) and profile overrides (`profiles/<profile>/cordis.patch.yml`) are all derived from it |
+| Deployment shape of `dsh-memory-local/` | The plugin **occupies the upstream slot** `profiles/<profile>/node_modules/dsh-memory` (no new package name, no profile rewiring); in `cordis.patch.yml`, `insert.name` must stay `dsh-memory` |
+| Environment injection | `MEMORY_ENGINE_*` (db / vectors / model / batch / recall), `DOC_INDEX_*` (document index scope), `DSH_ARCHIVE` (backup root), `DSH_PROD_ROOTS` (production-tree gate) |
+
+## 6. Data and safety
+
+- **Read-only on the memory DB**: the engine and every `audit-*` tool open `memory.db` with
+  `readOnly: true`; the only write surfaces are the standalone vector store and output directories you pass in.
+- **No telemetry, no exfiltration**; the only outbound calls are the LLM / embedding endpoints you enable yourself.
+- **Credentials are read from environment variables or a local config file only**; no secrets are present in the code.
+- **Production write gate**: restore / rollback style scripts refuse to touch a production tree unless
+  `--allow-production` is given (`--dry-run` is read-only and always allowed).
+
+## 7. License
+
+**AGPL-3.0** (GNU Affero General Public License v3.0) — full text in [LICENSE](./LICENSE).
+
+Free to use and modify for personal, educational and open-source projects. For **closed-source or
+commercial** use (where AGPL's copyleft does not apply) please open an issue in
+[Issues](https://github.com/kira905/dsh-memory-toolkit/issues) to obtain a **commercial license**.
+
+> **Subtree exception**: `dsh-memory-local/` is a fork of upstream `dsh-memory` (MIT) and that subtree
+> **keeps the upstream MIT license** (see its `package.json` `license` field and `FORK-BASE.json`).
+> Everything else is original work, released under AGPL-3.0 + commercial licensing.
+
+## 8. Related repositories
+
+- [`dsh-butler-archive`](https://github.com/kira905/dsh-butler-archive) — DSH autonomous-ops butler (archived)
+- [`dsh-session-toolkit`](https://github.com/kira905/dsh-session-toolkit) — session titles / session hygiene
+- [`dsh-ecosystem-panel`](https://github.com/kira905/dsh-ecosystem-panel) — ecosystem panel
+- [`dsh-firstaid`](https://github.com/kira905/dsh-firstaid) — first-aid / rollback drills
+
+Each companion repo is independent in scope, versioning and licensing.

package/README.md

@@ -1,3 +1,103 @@
-# Temporary Holding Version
+# dsh-memory-toolkit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**DSH（DeepSeek Harness）生态的记忆面工具集** —— 一个独立向量记忆引擎、一套记忆库只读体检工具链、
+一个自持 fork 的本地记忆插件，以及一个 persona ↔ 记忆体检小工具。
+
+四件东西原本是同一套自用工作流的不同切面，抽出来独立成仓，可以单独用，也可以拼起来用：
+**引擎负责"记什么、怎么找回来"，工具链负责"看得见、改得动"，插件负责"接进会话"。**
+
+---
+
+## 一、里面有什么
+
+| 目录 | 是什么 | 形态 |
+|---|---|---|
+| [`memory-engine/`](./memory-engine/README.md) | 记忆引擎（离线层）：独立矢量库 · 增量同步 · 兜底 hash 轮转 · 混合召回（向量 + FTS5 + RRF） · 文档索引 · 启动自检 · 本地编码桥 | 纯 Node ESM + `node:sqlite` |
+| [`memory-db-tools/`](./memory-db-tools/README.md) | 记忆库工具集：只读导出 / 六项体检分析 / 结构探针 / 特征词探针 / 与 persona 的重合度 / 看板账本只读探针 / 零改动自证 / 新会话开工简报 | 一组独立 CLI |
+| [`dsh-memory-local/`](./dsh-memory-local/README.md) | 本地记忆插件：上游 `dsh-memory` 的自持 fork（跨会话持久记忆 + 召回提示段 + 指针注入链），带构建 / 幂等部署 / 一键回滚 / 部署后自检 | DSH 插件 |
+| [`persona-memory-audit.mjs`](./persona-memory-audit.mjs) | persona ↔ 记忆体检：把「persona 正文体积」与「记忆可见率」两项指标固定下来，超阈值即报红 | 单文件 CLI |
+| [`lib/`](./lib) | 四件共用的无依赖小件（参数白名单 / HTTP 存活判据 / zstd 帧解析 / 会话文件名 / 坑库打分） | 纯函数模块 |
+
+## 二、环境要求
+
+- **Node.js ≥ 22**（用到内置 `node:sqlite`，以及 ESM 顶层能力）
+- 平台：Windows / Linux / macOS 均可；路径默认值一律从**环境变量或当前工作目录**推导，不含任何写死的机器路径
+- `memory-engine/` 的**本地向量编码**额外需要 `@huggingface/transformers`（可选，见下）
+
+## 三、安装
+
+```bash
+git clone https://github.com/kira905/dsh-memory-toolkit.git
+cd dsh-memory-toolkit
+npm install          # 本仓根包零运行时依赖，此步只装元数据
+```
+
+要跑**本地向量编码**（`memory-engine` 的 ONNX 路径），再装它自己的依赖：
+
+```bash
+cd memory-engine
+npm install          # 会拉 @huggingface/transformers（较大，约 300+ MB）
+```
+
+不想装这个依赖也可以：引擎的召回支持**HTTP 编码桥**（见下），以及纯 FTS5 的降级路径。
+
+## 四、快速开始（命令可直接照抄）
+
+```bash
+# ① 体检工具链的用法与参数（零副作用，先看再跑）
+node memory-db-tools/audit-export.mjs --help
+
+# ② persona ↔ 记忆体检（只读；读 $DSH_HOME 下的 persona 与记忆库）
+node persona-memory-audit.mjs --help
+
+# ③ 新会话开工简报（只读：设备行 + 记忆清单 + pinned 全文）
+node memory-db-tools/list-memory-summary.mjs --help
+
+# ④ 记忆引擎的启动自检（需要先在 memory-engine/ 内 npm install）
+cd memory-engine && node cli/selfcheck.mjs --json
+```
+
+一次典型的**季度记忆库体检**（全部只读，产物落你指定的目录）：
+
+```bash
+node memory-db-tools/audit-export.mjs --out ./_audit/memories.json
+node memory-db-tools/audit-analyze.mjs --in ./_audit/memories.json --out ./_audit
+node memory-db-tools/audit-struct-probe.mjs --in ./_audit/memories.json
+node memory-db-tools/audit-verify-unchanged.mjs --baseline ./_audit/memories.json --expect-unchanged
+```
+
+## 五、与 DSH 的集成点
+
+本仓**不依赖 DSH 才能运行**，但下面三处是刻意的接缝：
+
+| 接缝 | 说明 |
+|---|---|
+| `DSH_HOME`（缺省 `~/.dsh`） | 记忆库（`memory/memory.db`）、向量库（`memory-vectors/`）、preset（`.agent-presets/`）、profile 覆盖（`profiles/<profile>/cordis.patch.yml`）一律从它推导 |
+| `dsh-memory-local/` 的部署形态 | 插件**占用上游包槽位** `profiles/<profile>/node_modules/dsh-memory`（不新增包名、不改 profile wiring），`cordis.patch.yml` 的 `insert.name` 必须保持 `dsh-memory` |
+| 环境变量注入 | `MEMORY_ENGINE_*`（库/向量/模型/批大小/召回参数）、`DOC_INDEX_*`（文档索引扫描面）、`DSH_ARCHIVE`（备份落点）、`DSH_PROD_ROOTS`（生产树放行闸） |
+
+## 六、数据与安全
+
+- **对记忆库只读**：引擎与全套 `audit-*` 工具打开 `memory.db` 一律 `readOnly: true`；唯一的写口是独立向量库与你自己指定的输出目录。
+- **不收集、不外发**：没有任何遥测；唯一的外部网络调用是你主动启用的 LLM/编码端点。
+- **凭据只从环境变量或本地配置文件读**，代码里没有、也不会写任何密钥。
+- **生产写闸**：还原 / 回滚类脚本动到生产树前必须显式 `--allow-production`，否则拒跑（`--dry-run` 是只读档，不受限）。
+
+## 七、许可
+
+**AGPL-3.0**（GNU Affero General Public License v3.0），全文见 [LICENSE](./LICENSE)。
+
+个人、学习、开源项目可自由使用与修改。若要在**闭源**或**商业场景**中使用（AGPL 的传染条款不适用），
+请在 [Issues](https://github.com/kira905/dsh-memory-toolkit/issues) 开一条说明用途，获取**商业授权**。
+
+> **子树例外**：`dsh-memory-local/` 是上游 `dsh-memory`（MIT）的 fork，
+> 该子树**保持上游 MIT 许可**（见其 `package.json` 的 `license` 字段与 `FORK-BASE.json`）；
+> 其余目录（引擎、工具链、共用件）为本项目原创，按 AGPL-3.0 + 商业授权双许可发布。
+
+## 八、相关仓
+
+- [`dsh-butler-archive`](https://github.com/kira905/dsh-butler-archive) —— DSH 大管家（自主运维机制）归档仓
+- [`dsh-session-toolkit`](https://github.com/kira905/dsh-session-toolkit) —— 会话标题 / 会话治理
+- [`dsh-ecosystem-panel`](https://github.com/kira905/dsh-ecosystem-panel) —— 生态面板
+- [`dsh-firstaid`](https://github.com/kira905/dsh-firstaid) —— 急救台 / 回滚演练
+- 同属 DSH 生态的伴生组件各自独立仓、独立版本、许可各自独立。

package/dsh-memory-local/FORK-BASE.json

@@ -0,0 +1,24 @@
+{
+  "forkName": "dsh-memory-local",
+  "upstream": {
+    "name": "dsh-memory",
+    "version": "0.1.0",
+    "license": "MIT"
+  },
+  "source": {
+    "dir": "<DSH_HOME>/profiles/web/node_modules/dsh-memory",
+    "file": "lib/index.js",
+    "sha256": "494ca272f674918f5acfcf32327c164c6eba26fa08fc28bef50e085754c6f28c",
+    "bytes": 14224,
+    "lines": 421,
+    "dtsSha256": "471db6217fe4fc2ccc602a021efbc70f5a6490bd5d0c1e94123300d63e4dedf0",
+    "patchSha256": "1d34ead2d421cecce0d448131dc33e9223d2bcea3597d74d30911fe6ad1e7e99"
+  },
+  "forkedAt": "2026-09-20T16:15:20.970Z",
+  "note": [
+    "源码权威 = 本仓 tools/dsh-memory-local/src/；官方 lib/index.js 是 fork 的字节基线。",
+    "npm 分发包不含 TypeScript 源，故本 fork 以官方编译产物为源码基线，构建 = 语法校验 + 拷贝 + 指纹。",
+    "cordis.patch.yml 逐字节沿用上游：其 insert name 必须保持 `dsh-memory`，",
+    "因为 profile 的 bundle 名、patch insert name、.package-map.json 全部按该槽位解析（见 README §3）。"
+  ]
+}

package/dsh-memory-local/README.md

@@ -0,0 +1,113 @@
+# dsh-memory-local
+
+自持 fork：官方 `dsh-memory` 插件（跨会话持久记忆 + `memory:recall` 提示段），加一层自研的指针注入链。
+本包是记忆引擎的**插件侧载体**：把独立向量库的记忆接进会话提示面。
+
+
+> **首发范围**：源码自持 → 构建 → 幂等部署 → 一键回滚 → 部署后自检，以及 L2 模块登记。
+> 指针注入逻辑见 `src/injector.mjs`（与骨架同批交付）。
+
+---
+
+## 1. fork 基点（FORK-BASE.json 为机器可读版本）
+
+| 项 | 值 |
+|---|---|
+| 上游包 | `dsh-memory@0.1.0`（npm dist · MIT） |
+| 基点文件 | `lib/index.js` —— 421 行（逐字节 sha256 记在 `FORK-BASE.json` 的 `source.sha256`） |
+| 上游来源（只读） | `<DSH_HOME>/profiles/<profile>/node_modules/dsh-memory/` |
+| fork 时间 | 2026-09-21 |
+
+
+上游 npm 包**只发布编译产物**（`lib/`，无 TypeScript 源，也不含 `src/`），所以本 fork 的
+「源码」= 官方 `lib/index.js` 逐字节 + 一段 `FORK NOTICE` 头注；构建不是编译，而是
+**语法校验 + 拷贝 + 指纹**（见 §3）。
+
+## 2. 与官方的差异（当前 = 只有头注）
+
+| 文件 | 差异 |
+|---|---|
+| `src/index.js` | 上游文件逐字节 + 顶部 19 行 `FORK NOTICE`。**函数体、工具定义、配置项一字未改**（`Compare-Object` 差异行 = 19，全部落在头注内） |
+| `src/index.d.ts` | 逐字节同上游 |
+| `cordis.patch.yml` | **逐字节同上游** —— 其中 `insert.name` 必须保持 `dsh-memory`（见 §4） |
+| `package.json` | `name` → `dsh-memory-local`、`private: true`、**`dependencies` 置空**（零第三方依赖；`@deepseek-ai/schemastery` / `@deepseek-ai/dsh-tools` 由宿主主包的闭包在部署位置提供）、`scripts` 换成 build/test/deploy/verify |
+| `src/injector.mjs` | fork 自研（指针注入链；上游没有这个文件）。**2026-10-09**：`visibleInjections()` 取事件面改「**新面优先 + 老线回落**」—— 主包 0.1.5-rc.2 起 `Session.events` 已移除，只能用 `eventAt(seq)`；老线（≤0.1.4 的 `session.events`）回落保留，两面都没则安全返回 `{count:0}`。⚠️ 主包 0.1.6 会再弃用 `seq`/`eventAt`/`snapshotEvents` ⇒ 升级时此处须再复测。回滚：`node rollback-injector-fix.mjs --target <home> --allow-production`（默认 dry-run） |
+
+**零第三方依赖判据**：`package.json` 的 `dependencies` 为空对象；运行期只 import
+`@deepseek-ai/schemastery`、`@deepseek-ai/dsh-tools`（宿主主包自带）与 node 内置模块
+（`node:fs` / `node:path` / `node:sqlite`）。
+
+## 3. 目录与命令
+
+```
+dsh-memory-local/
+├─ src/index.js            自持源码（官方基点 + FORK NOTICE）
+├─ src/index.d.ts
+├─ lib/                    构建产物（deploy 只搬这一层 + cordis.patch.yml + package.json）
+├─ cordis.patch.yml        bundle patch（逐字节同上游）
+├─ FORK-BASE.json          fork 基点元数据（上游 sha / 行数 / 来源 / 口径说明）
+├─ build.mjs               构建：断言基点 → node --check → 拷进 lib/ → 写 lib/.build-info.json
+├─ deploy.mjs              幂等部署进 <DSH_HOME>/profiles/<profile>/node_modules/dsh-memory
+├─ restore.mjs             原子还原上游原物（含 --self-test 沙箱演练 / --dry-run / --list）
+├─ verify-after-restart.mjs 部署后自检（只读）
+└─ test/
+   ├─ probe-entity.mjs     部署位置加载探针：三工具 + memory:recall 段 + 真跑 write/search/forget
+   └─ regression.mjs       上游 vs fork「同输入同输出」逐步骤对照（行为一致判据）
+```
+
+```powershell
+node build.mjs                                  # 构建（--check 只校验不写 lib/）
+node build.mjs --check
+
+# 部署（--target 必填；目标是本机默认 home = 生产，须显式 --allow-production）
+node deploy.mjs --target <隔离实例的 DSH_HOME>
+
+# 自检（可带实例端口与日志文件）
+node verify-after-restart.mjs --target <隔离实例的 DSH_HOME> --port <实例端口> --log-file <实例日志>
+
+# 回滚（原子还原上游原物；先演练再动真）
+node restore.mjs --self-test
+node restore.mjs --target <隔离实例的 DSH_HOME> --dry-run
+node restore.mjs --target <隔离实例的 DSH_HOME>
+
+# 行为回归（fork 侧默认取隔离实例实体）
+node test/regression.mjs
+```
+
+## 4. 部署形态：为什么占「上游槽位」
+
+profile 的 `package.json`（`dsh.profile.bundles` 含 `dsh-memory`）、`node_modules/.package-map.json`
+（`dsh-memory → ./dsh-memory`）与 bundle patch 的 `insert.name` **三处都按 `dsh-memory` 解析**。
+因此部署**不新增包名、不改 profile wiring**，而是**原地替换 `node_modules/dsh-memory` 实体**：
+
+* 实体里的 `package.json` 写成**部署态**：`name` = `dsh-memory`、`version` = 上游版本（与 profile
+  的 `dependencies` 声明一致），另加 `fork` 段记录真身（`dsh-memory-local@…`）、基点 sha、产物 sha、
+  部署来源与时间 —— 自检与人工都据此判别「这是 fork 版」；
+* `cordis.patch.yml` 的 `insert.name` 保持 `dsh-memory`（若改成 `dsh-memory-local`，
+  解析会去找不存在的 `node_modules/dsh-memory-local`）。
+
+副作用：`deploy.mjs` **不写** profile `package.json`、**不写** `.package-map.json`、**不重启**任何 DSH。
+
+## 5. 备份与回滚
+
+* 首次替换时，`deploy.mjs` 把上游原物**整份**归档到 `$DSH_ARCHIVE`（缺省 `<cwd>/_archive`）下：
+  `_archive\g24-s2a-memory-deploy-<stamp>\official-entity\` + `OFFICIAL-ENTITY.json`（逐文件 sha 清单）；
+* 之后重复 deploy 只追加 `DEPLOY-INFO-<stamp>.json`，**不覆盖**那份上游原物；
+* `restore.mjs` 的还原源 = 上述目录（导出路径见 `--list`），
+  还原前先把当前 fork 实体快照到 `_archive\g24-s2a-memory-prerestore-<stamp>\entity-before-restore\`
+  （还原动作自己也可被回看/再回滚），然后 `stage → 核 sha → 交换 → 复核`。
+
+## 6. 上游合并流程（将来升 `dsh-memory` 时）
+
+1. 取新版上游实体（另一份 npm 安装目录，或 `npm pack dsh-memory@<ver>` 解包）；
+2. 重跑骨架步骤，让 `src/index.js` 重新等于「新版 + FORK NOTICE」（`FORK-BASE.json` 更新基点 sha）；
+3. 用 `git diff --no-index <上游新 lib/index.js> <旧 src/index.js 去掉头注>` 的形式看**自己的本地改动**
+   （本地改动一律以 `FORK-EDIT(<date>):` 行注留在 `src/`，便于三方合并）；
+4. `node build.mjs` → `node test/regression.mjs`（对照物换成新版上游实体）→ 隔离实例 `deploy.mjs` → `verify-after-restart.mjs`；
+5. 全绿才谈上生产；任一环红了就 `restore.mjs` 回滚到官方原物。
+
+## 7. 边界（本卡红线）
+
+* 只做**隔离面**（独立 `DSH_HOME` + 非生产端口）；生产实例的端口与生产 `profiles` 实体**一律不碰**；
+* 不写 `memory.db`、不挂 tickd job、不改 `butler-autonomy.json`；
+* `deploy.mjs` / `restore.mjs` 都**不重启 DSH**（要重启一律走 P0 闸门）。

package/dsh-memory-local/build.mjs

@@ -0,0 +1,101 @@
+/**
+ * build.mjs —— dsh-memory-local 的构建步骤（零依赖，node 原生）。
+ *
+ * 上游 npm 包只发布编译后的 JS（无 TypeScript 源），所以本 fork 的「源码」就是
+ * `src/index.js`（= 官方 lib/index.js + FORK NOTICE 头注）。构建因此是：
+ *
+ *   1) 断言 src/ 齐全、FORK NOTICE 在位、与 FORK-BASE.json 的基点一致；
+ *   2) `node --check` 对每个 JS 源码做语法校验（解析失败即拒绝产出）；
+ *   3) 把 src/* 拷进 lib/（运行时实体目录，deploy.mjs 只搬 lib/ + cordis.patch.yml + package.json）；
+ *   4) 写 lib/.build-info.json —— 源码 sha / 产物 sha / 基点 sha / 构建时间 / node 版本，
+ *      供 verify-after-restart.mjs 做「版本与 sha 对齐」断言。
+ *
+ * 幂等：产物字节一致时不重写文件（只刷新指纹文件）。
+ * 退出码：0 = 成功 / 1 = 构建失败（源缺失、语法错、基点不符）。
+ *
+ * 用法：node build.mjs [--check]      （--check = 只校验不写 lib/，可当 CI 用）
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import crypto from 'node:crypto'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const srcDir = path.join(here, 'src')
+const libDir = path.join(here, 'lib')
+const checkOnly = process.argv.includes('--check')
+
+const sha256 = (buf) => crypto.createHash('sha256').update(buf).digest('hex')
+const rel = (p) => path.relative(here, p).replaceAll('\\', '/')
+
+function fail(message) {
+  console.error(`[build] FAIL ${message}`)
+  process.exit(1)
+}
+
+// 1) 源与基点 -----------------------------------------------------------------
+const forkBaseFile = path.join(here, 'FORK-BASE.json')
+if (!fs.existsSync(forkBaseFile)) fail('FORK-BASE.json missing (run the fork skeleton step first)')
+const forkBase = JSON.parse(fs.readFileSync(forkBaseFile, 'utf8'))
+const entry = path.join(srcDir, 'index.js')
+if (!fs.existsSync(entry)) fail('src/index.js missing')
+const srcText = fs.readFileSync(entry, 'utf8')
+if (!srcText.startsWith('/**\n * FORK NOTICE')) fail('src/index.js is missing the FORK NOTICE header')
+if (!srcText.includes(forkBase.source.sha256)) fail('FORK NOTICE carries a base sha256 that does not match FORK-BASE.json')
+
+// 2) 语法校验 -----------------------------------------------------------------
+const sources = fs.readdirSync(srcDir).filter((n) => /\.(mjs|cjs|js)$/.test(n)).sort()
+for (const name of sources) {
+  const full = path.join(srcDir, name)
+  const r = spawnSync(process.execPath, ['--check', full], { encoding: 'utf8' })
+  if (r.status !== 0) fail(`node --check failed for ${rel(full)}\n${(r.stderr ?? '').trim()}`)
+}
+console.log(`[build] syntax ok: ${sources.length} source file(s) -> ${sources.join(', ')}`)
+
+// 3) 产出 ---------------------------------------------------------------------
+// ⚠️ U3(2026-09-22)：宿主适配层副本**不进 build 产出** —— 它由 tools\sync-host-adapter.mjs 生成，
+//    `src/` 与 `lib/` 各持一份、头部带各自的 target 标识（字节必然不同）。若 build 把 src 那份拷进
+//    `lib/`，lib 副本的头会变成 src 的 target ⇒ R5 立刻报 header-only-diff（lib 目标是同步器独占的）。
+//    语法校验仍照跑（上面的 sources 未变），只有"拷贝"这一步跳过。
+const GENERATED_BY_SYNC = new Set(['host-adapter.js'])
+if (!fs.existsSync(path.join(libDir, 'host-adapter.js'))) {
+  fail('lib/host-adapter.js missing — 先跑宿主侧的 sync-host-adapter.mjs 生成（否则部署会 Cannot find module）')
+}
+const artifacts = sources.filter((name) => !GENERATED_BY_SYNC.has(name)).map((name) => ({
+  name,
+  from: path.join(srcDir, name),
+  to: path.join(libDir, name),
+}))
+// 类型声明随源码走（官方包 exports 的 types 指向它）
+const dts = path.join(srcDir, 'index.d.ts')
+if (fs.existsSync(dts)) artifacts.push({ name: 'index.d.ts', from: dts, to: path.join(libDir, 'index.d.ts') })
+
+if (checkOnly) {
+  console.log('[build] --check: lib/ not written')
+  process.exit(0)
+}
+fs.mkdirSync(libDir, { recursive: true })
+
+const info = {
+  package: 'dsh-memory-local',
+  builtAt: new Date().toISOString(),
+  node: process.version,
+  forkBase: {
+    upstream: `${forkBase.upstream.name}@${forkBase.upstream.version}`,
+    sha256: forkBase.source.sha256,
+    lines: forkBase.source.lines,
+  },
+  artifacts: [],
+}
+for (const a of artifacts) {
+  const buf = fs.readFileSync(a.from)
+  const srcSha = sha256(buf)
+  let wrote = 'written'
+  if (fs.existsSync(a.to) && sha256(fs.readFileSync(a.to)) === srcSha) wrote = 'unchanged'
+  else fs.writeFileSync(a.to, buf)
+  info.artifacts.push({ file: rel(a.to), src: rel(a.from), bytes: buf.length, sha256: srcSha, state: wrote })
+  console.log(`[build] ${wrote.padEnd(9)} ${rel(a.to)}  ${buf.length} bytes  ${srcSha.slice(0, 16)}`)
+}
+fs.writeFileSync(path.join(libDir, '.build-info.json'), `${JSON.stringify(info, null, 2)}\n`, 'utf8')
+console.log(`[build] ok — base ${info.forkBase.upstream} sha256=${info.forkBase.sha256.slice(0, 16)}…`)

package/dsh-memory-local/cordis.patch.yml

@@ -0,0 +1,20 @@
+# The dsh-memory bundle patch: one row inserted over whatever layers came
+# before it. A patch replaces the targeted row's whole `config`, so a profile
+# overriding this row must restate every key it wants to keep.
+#
+# `path` has no code-side default on purpose — a durable store of user facts
+# must not land in whatever directory the harness happened to start in. The
+# deployment value lives here, beside the row, resolved through the loader's
+# `dshHomePath` so every profile on this machine shares one memory file.
+
+- insert:
+    - id: memory
+      name: dsh-memory
+      config:
+        path: !!js dshHomePath('memory/memory.db')
+        promptRecentCount: 10
+        promptMaxChars: 2000
+        maxTextChars: 2000
+        searchLimitDefault: 10
+        searchLimitMax: 50
+        promptOrder: 50