dsh-memento 0.3.0 → 0.3.1

package/ARCHITECTURE.md

@@ -138,3 +138,4 @@ memory 工具(add)
 ## 配置面（无硬编码 tunable）
 
 全部字段可 cordis.yml 覆盖，schema 见 `index.mjs` 的 `Config`；完整字段表（`enabled` / `dbPath` / `budgets` / `writePolicy` / `writePolicies` / `language` / `snapshotOrder` / `maxEntriesPerQuery` / `commandListLimit` / `commandAuditLimit` / `recall.*` / `panelEntriesLimit` / `panelAuditLimit` / `auditRetentionDays` / `proposals.*`）以 README 配置表为准，本文件不再逐项复制以免漂移。非法值加载期响亮失败。
+- **harness 主目录回退（0.3.1）**：`dbPath` 为空或相对路径时，基准目录取 `$DSH_HOME`；`dsh web` 启动不会把官方 `resolveDshHome()` 解析出的主目录写回 `process.env.DSH_HOME`，因此未导出时回退 `~/.dsh`（与官方回退同语义）——否则默认 Windows 配置会在真实 boot 时整体崩溃（issue #1）。`lib/` 零 DSH 依赖的红线不允许 import `@deepseek-ai/dsh-home-paths`，用 `os.homedir()` 复刻同一回退。

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-08-15
+
+### Fixed
+
+- Boot crash on default Windows setups (reported in [issue #1](https://github.com/PerryLink/dsh-memento/issues/1)): `dsh web` does not write the harness's resolved home back to `process.env.DSH_HOME`, so `resolveDbPath` threw `MISSING_DSH_HOME` and failed the whole profile load. It now falls back to `~/.dsh` — the same documented fallback as the official harness (`resolveDshHome()`), replicated with `os.homedir()` to keep `lib/` zero-DSH-dependency. Relative `dbPath` values resolve against the same fallback home.
+- Removed the now-unreachable `MISSING_DSH_HOME` error code.
+
 ## [0.3.0] - 2026-08-15
 
 ### Added
@@ -20,6 +27,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `proposalDecide` now resolves and updates inside one transaction: concurrent approve/dismiss races settle first-writer-wins instead of double-deciding.
 - `/memory proposals approve` no longer masks a successful write when the proposal was concurrently decided elsewhere.
 - Release workflow is now idempotent: it skips `npm publish` when the tag's version is already on npm, so re-pushing an old tag cannot fail a run.
+- Cross-platform test fix: the `resolveDbPath` absolute-path sample now matches the platform's `path.isAbsolute` semantics (a Windows drive path is relative on POSIX) — CI is green on all three platforms instead of red on Linux/macOS.
 
 ### Changed
 

package/README.es.md

@@ -81,7 +81,7 @@ Cada campo es un `Config` de Schemastery validado; los valores inválidos fallan
 | Campo | Valor por defecto | Significado |
 | --- | --- | --- |
 | `enabled` | `true` | `false` elimina por completo el servicio, las herramientas, la instantánea, el comando, el panel y el contestador (sin estados a medias) |
-| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | absoluto, o relativo a `$DSH_HOME` |
+| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | absoluto, o relativo a `$DSH_HOME`; si `$DSH_HOME` no está exportado (el valor por defecto en Windows — `dsh web` no devuelve el home resuelto al entorno), ambos caen a `~/.dsh` |
 | `budgets.user.userGlobal` / `budgets.user.workspace` | `2000` / `2000` | presupuesto estricto de caracteres por capa de la pista de usuario |
 | `budgets.agent.userGlobal` / `budgets.agent.workspace` | `4000` / `4000` | presupuesto estricto de caracteres por capa de la pista de agente |
 | `writePolicy` | `'ask'` | `'ask'` = aprobación del usuario; `'auto'` = dejar pasar (se registra el origen de la aprobación); `'off'` = rechazar. Invisible para el modelo |
@@ -150,7 +150,7 @@ El nombre es **`dsh-memento`** (publicado en npm y GitHub). No `dsh-recall` (con
 
 ```sh
 npm install
-npm test                # node --test: 112 tests — budget, unique-substring, gate policy, store, snapshot, mock-ctx integration (S2/S3 invariants), V2 command/recall/panel/import
+npm test                # node --test: 115 tests — budget, unique-substring, gate policy, store, snapshot, mock-ctx integration (S2/S3 invariants), V2 command/recall/panel/import
 npm run typecheck       # puerta tsc --checkJs sobre index.mjs / lib / scripts
 npm run check:coverage  # puerta de cobertura de líneas: lib ≥90 %, index.mjs ≥85 %, todos ≥90 %
 npm run check:readmes   # puerta de coherencia de los cinco README

package/README.hi.md

@@ -81,7 +81,7 @@ dsh plugin --profile <name> remove dsh-memento       # uninstall: DB + session l
 | फ़ील्ड | डिफ़ॉल्ट | अर्थ |
 | --- | --- | --- |
 | `enabled` | `true` | `false` सेवा, टूल, स्नैपशॉट, कमांड, पैनल और उत्तरदाता को पूरी तरह हटा देता है (कोई अधूरी स्थिति नहीं) |
-| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | निरपेक्ष, या `$DSH_HOME` के सापेक्ष |
+| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | निरपेक्ष, या `$DSH_HOME` के सापेक्ष; जब `$DSH_HOME` निर्यातित नहीं है (Windows डिफ़ॉल्ट — `dsh web` resolved home को env में वापस नहीं लिखता), दोनों `~/.dsh` पर गिरते हैं |
 | `budgets.user.userGlobal` / `budgets.user.workspace` | `2000` / `2000` | user ट्रैक की हर लेयर का कठोर वर्ण बजट |
 | `budgets.agent.userGlobal` / `budgets.agent.workspace` | `4000` / `4000` | agent ट्रैक की हर लेयर का कठोर वर्ण बजट |
 | `writePolicy` | `'ask'` | `'ask'` = उपयोगकर्ता अनुमोदन; `'auto'` = अनुमति दें (अनुमोदन स्रोत रिकॉर्ड किया गया); `'off'` = अस्वीकार करें। मॉडल-अदृश्य |
@@ -150,7 +150,7 @@ dsh-memento Claude Code, Codex या Hermes का पोर्ट नहीं
 
 ```sh
 npm install
-npm test                # node --test: 112 tests — budget, unique-substring, gate policy, store, snapshot, mock-ctx integration (S2/S3 invariants), V2 command/recall/panel/import
+npm test                # node --test: 115 tests — budget, unique-substring, gate policy, store, snapshot, mock-ctx integration (S2/S3 invariants), V2 command/recall/panel/import
 npm run typecheck       # index.mjs / lib / scripts पर tsc --checkJs द्वार
 npm run check:coverage  # लाइन-कवरेज द्वार: lib ≥90%, index.mjs ≥85%, सभी ≥90%
 npm run check:readmes   # पाँच-भाषा README संगति द्वार

package/README.md

@@ -81,7 +81,7 @@ Every field is a validated Schemastery `Config`; invalid values fail loudly at l
 | Field | Default | Meaning |
 | --- | --- | --- |
 | `enabled` | `true` | `false` removes the service, tools, snapshot, command, panel, and answerer entirely (no half-state) |
-| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | absolute, or relative to `$DSH_HOME` |
+| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | absolute, or relative to `$DSH_HOME`; when `$DSH_HOME` is not exported (the Windows default — `dsh web` does not write the resolved home back to the env), both fall back to `~/.dsh` |
 | `budgets.user.userGlobal` / `budgets.user.workspace` | `2000` / `2000` | hard char budget per layer of the user track |
 | `budgets.agent.userGlobal` / `budgets.agent.workspace` | `4000` / `4000` | hard char budget per layer of the agent track |
 | `writePolicy` | `'ask'` | `'ask'` = user approval; `'auto'` = allow through (approval source recorded); `'off'` = reject. Model-invisible |
@@ -150,7 +150,7 @@ The name is **`dsh-memento`** (published on npm and GitHub). Not `dsh-recall` (c
 
 ```sh
 npm install
-npm test                # node --test: 112 tests — budget, unique-substring, gate policy, store, snapshot, mock-ctx integration (S2/S3 invariants), V2 command/recall/panel/import
+npm test                # node --test: 115 tests — budget, unique-substring, gate policy, store, snapshot, mock-ctx integration (S2/S3 invariants), V2 command/recall/panel/import
 npm run typecheck       # tsc --checkJs gate over index.mjs / lib / scripts
 npm run check:coverage  # line-coverage gate: lib ≥90%, index.mjs ≥85%, all files ≥90%
 npm run check:readmes   # five-language README consistency gate

package/README.pt.md

@@ -81,7 +81,7 @@ Todo campo é um `Config` Schemastery validado; valores inválidos falham ruidos
 | Campo | Padrão | Significado |
 | --- | --- | --- |
 | `enabled` | `true` | `false` remove o serviço, as ferramentas, o snapshot, o comando, o painel e o answerer por completo (sem estado parcial) |
-| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | absoluto, ou relativo a `$DSH_HOME` |
+| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | absoluto, ou relativo a `$DSH_HOME`; quando `$DSH_HOME` não é exportado (o padrão no Windows — `dsh web` não devolve o home resolvido ao ambiente), ambos caem para `~/.dsh` |
 | `budgets.user.userGlobal` / `budgets.user.workspace` | `2000` / `2000` | orçamento rígido de caracteres por camada da trilha user |
 | `budgets.agent.userGlobal` / `budgets.agent.workspace` | `4000` / `4000` | orçamento rígido de caracteres por camada da trilha agent |
 | `writePolicy` | `'ask'` | `'ask'` = aprovação do usuário; `'auto'` = permite passar (fonte da aprovação registrada); `'off'` = rejeita. Invisível ao modelo |
@@ -150,7 +150,7 @@ O nome é **`dsh-memento`** (publicado no npm e no GitHub). Não `dsh-recall` (c
 
 ```sh
 npm install
-npm test                # node --test: 112 testes — orçamento, substring única, política do portão, armazenamento, snapshot, integração com mock-ctx (invariantes S2/S3), comando/recuperação/painel/importação V2
+npm test                # node --test: 115 testes — orçamento, substring única, política do portão, armazenamento, snapshot, integração com mock-ctx (invariantes S2/S3), comando/recuperação/painel/importação V2
 npm run typecheck       # portão tsc --checkJs sobre index.mjs / lib / scripts
 npm run check:coverage  # portão de cobertura de linhas: lib ≥90%, index.mjs ≥85%, todos ≥90%
 npm run check:readmes   # portão de coerência dos cinco README

package/README.zh.md

@@ -81,7 +81,7 @@ dsh plugin --profile <name> remove dsh-memento       # 卸载：库与会话日
 | 字段 | 默认 | 含义 |
 | --- | --- | --- |
 | `enabled` | `true` | `false` 时服务/工具/快照/命令/面板/answerer 整体消失（不留半残状态） |
-| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | 绝对路径，或相对 `$DSH_HOME` |
+| `dbPath` | `''` → `$DSH_HOME/dsh-memento/memory.db` | 绝对路径，或相对 `$DSH_HOME`；`$DSH_HOME` 未导出时（Windows 默认——`dsh web` 不会把解析出的主目录写回环境变量）两者都回退 `~/.dsh` |
 | `budgets.user.userGlobal` / `budgets.user.workspace` | `2000` / `2000` | user 轨每层硬字符预算 |
 | `budgets.agent.userGlobal` / `budgets.agent.workspace` | `4000` / `4000` | agent 轨每层硬字符预算 |
 | `writePolicy` | `'ask'` | `'ask'`=用户审批；`'auto'`=放行但记录审批来源；`'off'`=拒绝。模型不可见 |
@@ -150,7 +150,7 @@ dsh-memento 不是 Claude Code、Codex 或 Hermes 的移植版——但它的设
 
 ```sh
 npm install
-npm test                # node --test：112 个测试——预算、唯一子串、审批策略、store、快照、mock ctx 集成（S2/S3 不变量）、V2 命令/召回/面板/导入
+npm test                # node --test：115 个测试——预算、唯一子串、审批策略、store、快照、mock ctx 集成（S2/S3 不变量）、V2 命令/召回/面板/导入
 npm run typecheck       # tsc --checkJs 类型检查门（index.mjs / lib / scripts）
 npm run check:coverage  # 行覆盖率门：lib ≥90%、index.mjs ≥85%、全部 ≥90%
 npm run check:readmes   # 五语 README 一致性门

package/lib/constants.mjs

@@ -51,7 +51,6 @@ export const ERROR_CODES = {
   PROPOSAL_NOT_FOUND: 'PROPOSAL_NOT_FOUND',
   STORE_CORRUPT: 'STORE_CORRUPT',
   STORE_UNSUPPORTED_VERSION: 'STORE_UNSUPPORTED_VERSION',
-  MISSING_DSH_HOME: 'MISSING_DSH_HOME',
 }
 
 /** 会话事件名（SessionEventMap 声明合并的词汇表；运行时按已知类型自适应派发）。 */

package/lib/store.mjs

@@ -10,6 +10,7 @@
 
 import { DatabaseSync } from 'node:sqlite'
 import { mkdirSync, chmodSync, existsSync } from 'node:fs'
+import { homedir } from 'node:os'
 import path from 'node:path'
 import { randomUUID } from 'node:crypto'
 import { SCHEMA_VERSION, DEFAULT_DB_NAME, TRACKS, SCOPES, ERROR_CODES, MAX_QUERY_LIMIT } from './constants.mjs'
@@ -135,24 +136,21 @@ export function chmodOwned(dbPath, io = {}) {
 /**
  * 解析记忆库绝对路径。
  * - 显式绝对路径：原样规范化。
- * - 显式相对路径：相对 $DSH_HOME（有则），否则相对进程 cwd。
- * - 空值：$DSH_HOME/dsh-memento/memory.db；$DSH_HOME 缺失时响亮失败（S5）。
+ * - 显式相对路径：相对 harness 主目录（$DSH_HOME；未导出时回退 ~/.dsh）。
+ * - 空值：<harness 主目录>/dsh-memento/memory.db。
+ * $DSH_HOME 未导出时回退 ~/.dsh——与官方 harness 的 resolveDshHome() 文档化回退
+ * 同语义。dsh 启动不会把解析出的主目录写回 process.env.DSH_HOME，插件自己兜底
+ * 才能避免默认 Windows 配置在真实 boot 时整体崩溃（issue #1）。
  * @param {string} [dbPath] - Config.dbPath。
  * @param {string|undefined} [dshHome] - 环境 $DSH_HOME（测试注入）。
  * @returns {string} 绝对路径。
  */
 export function resolveDbPath(dbPath, dshHome = process.env.DSH_HOME) {
+  const home = typeof dshHome === 'string' && dshHome.length > 0 ? dshHome : path.join(homedir(), '.dsh')
   if (dbPath) {
-    const base = dshHome ?? process.cwd()
-    return path.isAbsolute(dbPath) ? path.normalize(dbPath) : path.resolve(base, dbPath)
+    return path.isAbsolute(dbPath) ? path.normalize(dbPath) : path.resolve(home, dbPath)
   }
-  if (!dshHome) {
-    throw new StoreError(
-      ERROR_CODES.MISSING_DSH_HOME,
-      'dbPath is not configured and $DSH_HOME is not set; run under dsh or set dbPath explicitly',
-    )
-  }
-  return path.join(dshHome, 'dsh-memento', DEFAULT_DB_NAME)
+  return path.join(home, 'dsh-memento', DEFAULT_DB_NAME)
 }
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-memento",
   "description": "Bounded, layered, approval-gated, auditable cross-session memory for DeepSeek Harness — a capability seam (ctx.memory service + local SQLite provider + memory tool + frozen snapshot injection), not another memory warehouse",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "main": "./index.mjs",
   "types": "./types.d.ts",