@modusensus/dsh-mneme 0.7.10 → 0.7.11

package/.github/workflows/test.yml

@@ -1,32 +0,0 @@
-name: Test
-
-on:
-  push:
-    branches: [master, main]
-  pull_request:
-    branches: [master, main]
-  workflow_dispatch:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [24]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-      - name: Install dependencies
-        working-directory: dsh-mneme
-        run: npm ci
-      - name: Run tests
-        working-directory: dsh-mneme
-        run: npm run test:coverage
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4
-        with:
-          token: ${{ secrets.CODECOV_TOKEN }}
-          files: dsh-mneme/coverage/lcov.info
-          fail_ci_if_error: false

package/CHANGELOG.md

@@ -1,91 +0,0 @@
-# Changelog
-
-> **完整版本历史见 [dsh-mneme/CHANGELOG.md](dsh-mneme/CHANGELOG.md)**（正式版本正源，0.3.8 → 0.7.9）。以下为仓库早期开发记录（0.1.0–0.2.x，2026-08-13~14，已归档）。
-
-All notable changes to dsh-mneme are documented here.
-
-## [Unreleased]
-
-- **诚实审计修复（v0.2.7，F-03）**
-  - autoDream 决策无变更且 summary 为空时，不再误报 ok:true——新增 `noop` 状态（ok:false，baseline 不刷新），避免空跑循环
-  - 有变更但 summary 缺失 → `degraded`（ok:true 但如实标记 summary 缺失）
-  - parseReceipt 支持 ok/noop/degraded/reconcile/failed
-  - 测试 259 → **263**
-
-- **社区贡献 · 嵌入式面板 UI 改进（PR #2，@Liuxin4950）**
-  - 记忆面板与设置面板的嵌入模式（settings.section 插槽）不再复用弹窗面板样式（去掉 boxShadow / background / borderRadius / padding），改为全宽平铺渲染，消除 DSH 设置页内多余的悬浮卡片与阴影
-  - 弹窗（portal）模式保持原有面板样式不变；新增回归测试锁定 embedded 分支不携带 modal chrome
-
-- **安全审计修复（v0.2.5）**
-  - 并发安全：CAS 冲突守卫——过期快照不再覆盖并发写入（防丢更新）
-  - 事务化决策应用：merge/archive 原子提交，receipt 反映已提交子步骤，部分提交 = reconcile（绝不虚报 ok）
-  - 压测硬断言：lost-update 与多步原子性失败即非零退出（`npm run stress`）
-  - 运行时人工编辑三方合并（three-way），不再静默覆盖
-  - 新增 `memory_archive` 工具（第 7 个模型工具）+ `memory_list include_archived`，归档可恢复
-  - reranker 改为 opt-in：`rerankEnabled=false`、`rerankProvider=none` 默认（裸装不加载 onnxruntime）
-  - npm `files` 纳入 scripts/test，tarball 内可直接跑压测
-  - 测试 236 → **258**（+22）
-
-- **安全加固（v0.2.4）**：API 鉴权 `apiToken`（写操作与密钥端点要求 Bearer 校验）+ `apiKey` 掩码回传 + timing-safe token 比对
-
-- **审查修复补丁（v0.2.3）**
-  - failure 记录增加 `before` JSON 快照（title/content/importance 变更可追溯，不只 content）
-  - vector-index `rebuildIndex` guard 改为检查 `embedSingle`（修复 embed/embedSingle 不一致导致的静默跳过）
-
-- **流水线补全（v0.2.2）**
-  - reflection 修复：failure 记录检查 title/importance 变化（不只 content）；支持 query 上下文（memory_update 加 `reason` 参数）；update 校验失败不污染 claimed；`failure_memories` 清理（`deleteOldFailures` + 启动自动清理 90 天前）
-  - 专项测试补全：`vector-index.test.js`（modelHash 漂移/重建/增量）+ `service-search.test.js`（hybrid/auto/rerank 端到端）
-  - api.js `/search` 的 mode 参数文档化
-  - 测试 212 → **233**
-
-- **反思更新（v0.2.1）**：`update` 决策 + 失败追踪
-  - autoDream 新增 `update` 决策类型：修正单条记忆的过时/错误内容（单 id、必须实际变化、非 summary、24h 保护、每次 ≤2）
-  - 审计记录 update 的 `_before` 快照；update 后向量索引同步
-  - `failure_memories` 表：记录用户纠正（user_correction）+ 查询/统计接口
-  - 配置：`reflectionUpdateEnabled` / `reflectionFailureTracking` / `reflectionUpdateMaxPerRun` / `reflectionUpdateMinAgeHours`
-
-- **Semantic 升级（v0.2.0-semantic）**：完全离线语义记忆引擎
-  - 本地 Embedding：`embedProvider: local`（ONNX bge-small-zh-v1.5，transformers.js/onnxruntime）或 `ollama`；原 `openai` 外部 API 保留为默认，向后兼容
-  - 向量索引层：`vector_meta` 模型指纹追踪 + 索引统计（`/api/dsh-mneme/semantic`）
-  - Rerank 精排：`rerankEnabled`（bge-reranker-base cross-encoder），召回后精排 Top-K，失败自动跳过
-  - 混合搜索：`memory_search` 新增 `mode: hybrid`（向量优先 + 关键词补位）；`auto` 保持关键词优先 + 向量补位
-  - autoDream 语义增强：K-Means 聚类预分组（k-means++）、`[潜在冲突]` 向量相似度标记、整理后向量索引重建
-  - 模型下载：断点续传 + 缓存（transformers.js 内置）；`.npmrc` 跳过 onnxruntime CUDA 下载避免安装失败
-  - 文档：`docs/SEMANTIC.md` / `docs/LOCAL_MODEL.md` / `docs/MIGRATION.md` + 基准脚本 `benchmark-embed` / `benchmark-rerank`
-- autoDream 裁决审计：每次运行写入 `dream_runs`（输入快照 sha256 digest + 完整输入快照 + LLM 决策清单 + 逐 id 去向 + receipt `dsh-mneme:run:<id>:<status>:<hash>:<count>:<applied>`），可离线回放、定位静默错误
-- 幂等决策应用：merge / conflict 重复应用无累积副作用（来源注释不重复追加），防并发/重放下的重复合并
-- 三轴线压测 `npm run stress`：长会话检索（Recall@k、陈旧残留率）/ 冲突裁决（可重放仲裁集）/ 多 Agent 并发（丢更新、重复合并、事务/崩溃恢复）
-
-## [0.1.6] - 2026-08-14
-
-- Vector (semantic) search via OpenAI-compatible embeddings endpoint, with automatic fallback to LIKE keyword search on failure
-- Web GUI memory panel: browse by type, full-text + semantic search
-
-## [0.1.5] - 2026-08-14
-
-- autoDream consolidation refinements: conflict resolution with source tracking, fail-safe decision validation
-
-## [0.1.4] - 2026-08-14
-
-- User settings: profile + behavior rules injected every turn
-- Custom slash commands (register, route to agent)
-
-## [0.1.3] - 2026-08-14
-
-- autoDream background consolidation: dedup / merge / archive / conflict resolution
-
-## [0.1.2] - 2026-08-14
-
-- Session summarization: auto-distill preferences / decisions / lessons at session end
-- Web panel improvements
-
-## [0.1.1] - 2026-08-13
-
-- Memory tools: memory_save / memory_search / memory_list / memory_update / memory_delete / memory_forget
-- Markdown mirror sync (human-editable, manual edits take priority)
-
-## [0.1.0] - 2026-08-13
-
-- Initial release: cross-session memory for DeepSeek Harness
-- SQLite store (node:sqlite, zero native deps) + human-editable Markdown mirror
-- Auto-injection of relevant memories at session start

package/CONTRIBUTING.md

@@ -1,293 +0,0 @@
-# Contributing
-
-> **English** | [中文](#贡献指南)
-
----
-
-## Prerequisites
-
-- **Node.js 24+** (CI runs on Node 24)
-- **npm** (the repo uses npm; CI installs with `npm ci`)
-- **git** (on Windows, watch LF/CRLF: the repo is LF-normalized and git converts automatically)
-
----
-
-## Repository Layout
-
-The repository root is the publishing manifest; the actual plugin code lives in the `dsh-mneme/` subdirectory:
-
-```
-dsh-mneme-1/
-├── package.json          # npm publishing manifest (main → dsh-mneme/lib/index.js)
-├── README.md / CHANGELOG.md / SECURITY.md
-└── dsh-mneme/            # the plugin itself
-    ├── src/              # source (ESM) — all feature work happens here
-    ├── lib/              # build output; DSH actually loads lib/index.js
-    ├── scripts/          # sync-lib.js, check-sync.js, e2e-dsh.js, stress-dsh.js, benchmark-*
-    ├── test/             # node:test test suite
-    ├── docs/             # SEMANTIC / SLEEP / ENTITIES / MIGRATION deep-dives
-    ├── package.json      # plugin metadata and scripts
-    └── cordis.patch.yml  # DSH injection patch
-```
-
-**Key convention: `src/` is the single source of truth; `lib/` is build output.**
-
-- Write code only in `src/`, then run `npm run sync` to mirror changes into `lib/`.
-- **Never edit `lib/` by hand** — the next sync overwrites it.
-- Publish from the **repo root**: root `prepack` runs `scripts/check-sync.js`, which asserts `src/` ↔ `lib/` match file-for-file and fails the publish on any drift (issue #65). So run `npm run sync` (in `dsh-mneme/`) and commit the `lib/` changes **before** publishing.
-
----
-
-## Local Development
-
-```bash
-# 1. Install dependencies (inside dsh-mneme/)
-cd dsh-mneme
-npm ci
-
-# 2. After editing files under src/, mirror to lib/
-npm run sync
-
-# 3. Run the tests
-npm test              # node --test test/*.test.js
-npm run test:coverage # c8 coverage
-```
-
-Common scripts (all run under `dsh-mneme/`):
-
-| Command | Description |
-|---------|-------------|
-| `npm test` | Full unit/integration suite |
-| `npm run test:coverage` | Tests + c8 coverage (used by CI) |
-| `npm run e2e` | End-to-end smoke test (scripts/e2e-dsh.js) |
-| `npm run stress` | Three-axis stress test (scripts/stress-dsh.js) |
-| `npm run sync` | src/ → lib/ mirror |
-
----
-
-## Testing Conventions
-
-- Tests use Node's built-in **`node:test` + `node:assert/strict`**; no third-party test framework.
-- New features require corresponding tests; **changing core logic (e.g. model routing, decision validation) must update the affected test assertions** so the suite stays green before committing.
-- Test files live in `test/`, named `*.test.js`; shared mocks go in `test/helpers/` (e.g. `dream-mock.js`).
-- Known environment dependency: a few cases in `reranker.test.js` need `@huggingface/transformers` (locally this one case fails without the package; it is unrelated to repo logic and CI installs it and passes).
-- The published artifact is covered too: `test/lib-smoke.test.js` imports from `lib/` and asserts `src/` ↔ `lib/` are file-for-file identical (issue #65 regression guard).
-
----
-
-## Code Style & Engineering Conventions
-
-- **ESM**: the repo is `"type": "module"`; everything uses `import`/`export`.
-- **Comments in Chinese**, biased toward "why" — core logic, config options, and fail-safe branches must explain their intent.
-- **Fail-safe is a hard rule**: local failures in any background LLM path (autoDream / sleep / autoTag / summarization) must skip or degrade, **never** block the main flow (write, recall, injection).
-- **Config is defined centrally with schemastery in `src/config.js`** (`z.object` + `.default(...)`); new options must keep docs and default-value semantics in sync.
-- **Audit honesty**: a run's status (ok / noop / degraded / reconcile / failed) must reflect what actually committed — never a fake ok.
-
----
-
-## Commits & Branches
-
-- Commit messages follow **Conventional Commits**:
-
-  ```
-  fix(dream): reject cross-type merge as a whole batch (Issue #26)
-  feat(tag): add tag-weighted recall
-  docs: expand the SEMANTIC doc
-  release: v0.6.9 ...
-  ```
-
-- Run `npm test` before committing and confirm green (note any environment-only known exceptions in the commit message).
-- **Small fixes**: can push straight to `main` (this is the project's workflow).
-- **Larger features / breaking changes**: open an Issue first to state the motivation and design, then submit a PR — the PR triggers CI (Node 24 + full suite + Codecov).
-- Release operations (version bumps, tags, Releases, npm publish) are performed by maintainers — see the next section.
-
----
-
-## Scope: Platform Adaptation & Wrapper PRs
-
-DSH upstream is still in developer preview — APIs and service interfaces change frequently. Until DSH reaches a stable release (RC or GA), **PRs that adapt dsh-mneme to secondary platforms or wrap it into other hosts are not a priority** and are reviewed with extra caution:
-
-- Desktop shells (e.g. a Tauri/Electron wrapper around `dsh web`)
-- Standalone CLI packaging
-- Ports/wrappers of dsh-mneme into other plugin ecosystems
-
-These tend to bind against unstable upstream APIs: a single upstream change can break them, and the maintenance burden falls back on this project. The currently supported platform is the **Web Profile** (`dsh web`).
-
-Exceptions: if a contributor is willing to **own long-term maintenance** (track upstream changes and fix breakage), open a Discussion first to scope the work — maintainers will evaluate and review the PR.
-
-Bug-fix PRs for existing desktop compatibility issues are still welcome.
-
----
-
-## Release Process (Maintainers)
-
-Versioning follows semantic versioning (`MAJOR.MINOR.PATCH`). Full flow:
-
-1. **Update CHANGELOG**: add a version entry (`## [X.Y.Z] - date`, split into 「修复 / 新增 / 测试」) at the top of `dsh-mneme/CHANGELOG.md`; update the root `CHANGELOG.md` if it tracks the same.
-2. **Bump version**: change `version` in `dsh-mneme/package.json` and `package-lock.json`; the root `package.json` is synced automatically by the `prepublishOnly` hook — no manual edit.
-3. **Full test pass**: `npm test` must be green.
-4. **Commit and push**: commit → `git push origin main` → `git tag vX.Y.Z` → `git push origin vX.Y.Z`.
-5. **Create a GitHub Release**: title `vX.Y.Z`, body referencing the matching CHANGELOG entry (review before publishing).
-6. **Publish to npm**: run `npm publish` from the **repository root** (`prepublishOnly` copies the version from `dsh-mneme/package.json` into the root `package.json`; `prepack` runs `scripts/check-sync.js` and fails if `src/` ↔ `lib/` drifted — ensure `npm run sync` + commit ran first).
-
----
-
-## Contact
-
-- **General questions & contributions**: [GitHub Discussions](https://github.com/modusensus/dsh-mneme/discussions) or `work@modusensus.space`
-- **Security vulnerabilities**: report privately via [SECURITY.md](SECURITY.md) — never open a public issue for vulnerabilities
-
----
-
-## Miscellaneous
-
-- Security issues go through [SECURITY.md](SECURITY.md) or a GitHub Security Advisory — never paste sensitive info into a public Issue.
-- Be respectful and constructive; PRs touching data integrity, security, or behavior must include reproduction steps and regression evidence.
-
----
-
-# 贡献指南
-
-> **中文** | [English](#contributing)
-
----
-
-## 环境要求
-
-- **Node.js 24+**（CI 在 node 24 上运行）
-- **npm**（仓库使用 npm，CI 用 `npm ci`）
-- **git**（Windows 下注意 LF/CRLF：仓库以 LF 为准，git 会自动转换）
-
----
-
-## 代码库布局
-
-仓库根目录是发布清单，实际插件代码在 `dsh-mneme/` 子目录：
-
-```
-dsh-mneme-1/
-├── package.json          # npm 包发布清单（main 指向 dsh-mneme/lib/index.js）
-├── README.md / CHANGELOG.md / SECURITY.md
-└── dsh-mneme/            # 插件本体
-    ├── src/              # 源码（ESM），所有功能都在这里开发
-    ├── lib/              # 构建产物，DSH 实际加载的是 lib/index.js
-    ├── scripts/          # sync-lib.js、check-sync.js、e2e-dsh.js、stress-dsh.js、benchmark-*
-    ├── test/             # node:test 测试
-    ├── docs/             # SEMANTIC / SLEEP / ENTITIES / MIGRATION 等专题文档
-    ├── package.json      # 插件包元数据与 scripts
-    └── cordis.patch.yml  # DSH 注入补丁
-```
-
-**关键约定：`src/` 是唯一的事实来源，`lib/` 是构建产物。**
-
-- 所有代码改动只写 `src/`，改完必须运行 `npm run sync` 同步到 `lib/`。
-- **不要手工编辑 `lib/`**——下次 sync 会覆盖你的改动。
-- 发布在**仓库根**执行：root `prepack` 会跑 `scripts/check-sync.js`，逐文件断言 `src/` ↔ `lib/` 一致，有漂移直接发布失败（issue #65 教训）。所以发布前务必先在 `dsh-mneme/` 里跑 `npm run sync` 并把 `lib/` 改动一起提交。
-
----
-
-## 本地开发
-
-```bash
-# 1. 安装依赖（在 dsh-mneme/ 目录内）
-cd dsh-mneme
-npm ci
-
-# 2. 修改 src/ 下的文件后，同步到 lib/
-npm run sync
-
-# 3. 跑测试
-npm test              # node --test test/*.test.js
-npm run test:coverage # c8 覆盖率
-```
-
-常用脚本（均在 `dsh-mneme/` 下）：
-
-| 命令 | 说明 |
-|------|------|
-| `npm test` | 全量单元/集成测试 |
-| `npm run test:coverage` | 测试 + c8 覆盖率（CI 使用） |
-| `npm run e2e` | 端到端冒烟（scripts/e2e-dsh.js） |
-| `npm run stress` | 三轴线压测（scripts/stress-dsh.js） |
-| `npm run sync` | src/ → lib/ 同步 |
-
----
-
-## 测试约定
-
-- 测试框架为 Node 内置 **`node:test` + `node:assert/strict`**，不引入第三方测试库。
-- 新增功能必须有对应测试；**修改核心逻辑（如模型路由、决策校验）时必须同步更新受影响用例的断言**，保证全量测试通过后提交。
-- 测试文件放在 `test/`，命名 `*.test.js`；共享 mock 放 `test/helpers/`（如 `dream-mock.js`）。
-- 已知环境依赖：`reranker.test.js` 的个别用例需要 `@huggingface/transformers`（本地未安装该包时这 1 例会失败，与本仓库逻辑无关，CI 会正常安装并通过）。
-- 发布产物也被覆盖：`test/lib-smoke.test.js` 从 `lib/` 直接导入复跑关键用例，并断言 src↔lib 逐文件一致（issue #65 防再犯）。
-
----
-
-## 代码风格与工程约定
-
-- **ESM**：仓库 `"type": "module"`，全部使用 `import`/`export`。
-- **注释用中文**，且偏向"解释为什么"——核心逻辑、配置项、fail-safe 分支都要求写清意图。
-- **fail-safe 是硬性约定**：所有后台 LLM 链路（autoDream / sleep / autoTag / 摘要）中的局部失败只能跳过或降级，**绝不能**阻断主流程（写入、检索、注入）。
-- **配置项统一用 schemastery 定义在 `src/config.js`**（`z.object` + `.default(...)`），新增配置记得同步文档与默认值语义。
-- **审计诚实性**：任何 run 的状态（ok / noop / degraded / reconcile / failed）必须反映真实提交结果，绝不虚报。
-
----
-
-## 提交与分支
-
-- 提交信息遵循 **Conventional Commits**：
-
-  ```
-  fix(dream): 修复跨类型 merge 整单拒绝（Issue #26）
-  feat(tag): 新增标签加权召回
-  docs: 补充 SEMANTIC 文档
-  release: v0.6.9 ...
-  ```
-
-- 提交前跑一遍 `npm test` 确认全绿（环境相关的已知例外需在提交说明里注明）。
-- **小改动 / 修复**：可直推 `main`（本项目采用此工作流）。
-- **较大功能 / 破坏性改动**：建议先开 Issue 说明动机与方案，再通过 PR 提交，PR 会触发 CI 校验（node 24 + 全量测试 + Codecov）。
-- 发布相关操作（改版本号、打 tag、发 Release、npm publish）由维护者执行，详见下节。
-
----
-
-## 范围：平台适配与封装 PR
-
-DSH 上游仍处于 developer preview 阶段，API 与服务接口变动频繁。在 DSH 稳定（RC 或正式版）之前，以下方向的 PR **不作为优先项**，且会以额外谨慎的态度审查：
-
-- 桌面端适配（例如基于 `dsh web` 的 Tauri/Electron 桌面壳）
-- 独立 CLI 封装
-- 把 dsh-mneme 移植/封装到其他插件体系
-
-这类 PR 往往绑定不稳定的上游接口——上游一次变动就可能使其失效，而维护责任会落到本项目头上。当前唯一受支持的平台是 **Web Profile**（`dsh web`）。
-
-例外：如果贡献者愿意**承担长期维护**（跟进上游变更并修复 break），请先开 Discussion 沟通范围，维护者会评估并 review 该 PR。
-
-针对现有 desktop 兼容问题的 **bug 修复 PR 依然欢迎**。
-
----
-
-## 发布流程（维护者）
-
-版本号遵循语义化版本（`MAJOR.MINOR.PATCH`）。完整流程：
-
-1. **更新 CHANGELOG**：在 `dsh-mneme/CHANGELOG.md` 顶部新增版本条目（`## [X.Y.Z] - 日期`，分「修复 / 新增 / 测试」小节），根目录 `CHANGELOG.md` 如涉及同步更新。
-2. **更新版本号**：改 `dsh-mneme/package.json` 的 `version` 与 `package-lock.json`；根目录 `package.json` 由 `prepublishOnly` 钩子自动同步，无需手改。
-3. **全量测试**：`npm test` 确认通过。
-4. **提交并推送**：commit → `git push origin main` → `git tag vX.Y.Z` → `git push origin vX.Y.Z`。
-5. **创建 GitHub Release**：标题为 `vX.Y.Z`，正文引用 CHANGELOG 对应条目（发布前需人工过目）。
-6. **发布 npm**：在**仓库根目录**执行 `npm publish`（`prepublishOnly` 会自动把 `dsh-mneme/package.json` 的版本号写入根 `package.json`，`prepack` 会跑 `scripts/check-sync.js` 校验 src↔lib 一致性，漂移则发布失败——发布前须先 `npm run sync` 并提交 `lib/` 改动）。
-
----
-
-## 联系方式
-
-- **一般问题与贡献咨询**：[GitHub Discussions](https://github.com/modusensus/dsh-mneme/discussions) 或 `work@modusensus.space`
-- **安全漏洞**：请通过 [SECURITY.md](SECURITY.md) 私有提交，不要在公开 Issue 中提交漏洞
-
----
-
-## 其他
-
-- 安全问题请走 [SECURITY.md](SECURITY.md) 或 GitHub Security Advisory，不要在公开 Issue 贴敏感信息。
-- 保持礼貌与建设性；涉及数据损坏 / 安全 / 破坏性改动的 PR 需附复现步骤与回归证据。