dsh-trivium 0.4.17 → 0.4.19

package/README.md

@@ -46,8 +46,11 @@ Local source checkout:
 ```sh
 npm install
 node scripts/link-dsh.mjs
+npm test              # optional: runs every offline smoke script
 ```
 
+`npm test` needs no DSH host and never touches your real `~/.dsh/trivium.json` (each script gets its own temp settings file). Pass a substring to narrow it: `npm test -- p8`.
+
 Then restart `dsh web`.
 
 ## Updating
@@ -126,7 +129,7 @@ Trivium is a memory kernel, not a journal, calendar, or chat companion. It store
 - **Injection via `agent.inject()`** — not the system prompt, so `persona.complete: true` cannot silently drop the map.
 - **Recall carries paths** — every hit says which node it came from and along which edge.
 - **Failures never block the agent** — store / embedding / extract errors are logged; the main loop continues.
-- **UI follows the host language** — Settings and the Chips (memory whitelist) tab switch with DSH `locale/change` (`zh` / `en`).
+- **UI follows the host language** — Settings and the Chips (memory whitelist) tab switch with DSH `locale/change` (`zh` / `en`). Any other resolved host language — and a browser that names no registered language — falls to English, the same `FALLBACK_LOCALE` the host itself uses.
 - **First-turn map** — the short map is injected once per session. If `session-start` loses a race with the first model step, `pre-step` fills it in; it is not rewritten every step (prefix-cache friendly).
 
 ## Features
@@ -242,6 +245,10 @@ Off by default. After you turn **Chips (memory whitelist)** on in Settings, the
 
 ## Changelog
 
+**0.4.19** — Fixed the plugin's own UI rendering Simplified Chinese on an English host ([issue #2](https://github.com/QWQcool/dsh-trivium/issues/2)). The `locale` service is now reached through `ctx.inject(["locale"], …)`, so **follow host** no longer depends on composition order, and the plugin fallback is `en` — the host's own `FALLBACK_LOCALE`, and the bucket every other resolved host language lands in. The Settings card and the Chips tab only ever choose between zh and en, so a browser naming no registered language no longer gets a Chinese card. Four tools / short map / find paths unchanged.
+
+**0.4.18** — `~/.dsh/trivium.json` is now written atomically (a truncated write used to reset every switch and chip pin silently) and is owner-only on POSIX. `npm test` runs every offline smoke script with isolated settings, and `smoke-p0` pins the hybrid text-index-after-reopen invariant. Four tools / short map / find paths unchanged.
+
 **0.4.17** — Storage bump to `triviumdb@0.8.8` (engine behavior unchanged from 0.4.16). Host adaptation for `@deepseek-ai/dsh@0.1.5-rc.1`: `session.header.seedLength` was removed, so the session-layer fork cut now reads `session.inheritedEventCount`. Four tools / short map / find paths unchanged.
 
 **0.4.16** — Storage bump to `triviumdb@0.8.4`: the engine constructor now takes an options object (`{ dim }`) instead of numeric positional args, and TQL rows return string ids that the plugin coerces back to numbers. Four tools / short map / find paths unchanged.
@@ -283,6 +290,7 @@ Off by default. After you turn **Chips (memory whitelist)** on in Settings, the
 | Symptom | What to do |
 |---|---|
 | Settings has no **Trivium memory** | Confirm the **web** profile, then **restart** `dsh web` and open a workspace. Reloading the browser is not enough. |
+| Settings card / Chips tab shows Chinese on an English host | Fixed in 0.4.19 ([issue #2](https://github.com/QWQcool/dsh-trivium/issues/2)). On an older build pick **Settings → Trivium memory → Settings → Plugin language → English**; that is stored in `~/.dsh/trivium.json` and a page reload is enough (no host restart). |
 | Title bar has no **Chips** | Turn on **Chips (memory whitelist)** in Settings (it saves as soon as you toggle). Switch back to the conversation; the tab should appear without restarting. |
 | Injection / extract / embedding / chip tab changes have no effect | Chip / extract / recall toggles save immediately. Embedding URL still uses **Save**. Restart `dsh web` only if the settings page itself is missing. |
 | Session layer shows only a **Next** box | Expected when the nested session layer is on. Boxes follow DSH compaction; a long session is not the same as already compacted (auto-compact is around 80% of the window). To split: `/compact` in the conversation, or **Create checkpoint** (plot only, does not compact the window). Older sessions can use **Update checkpoints** to backfill past compaction / forks. |
@@ -300,7 +308,7 @@ Local source checkout: `npm install`, then `node scripts/link-dsh.mjs`, then res
 ## Release info
 
 - GitHub: https://github.com/QWQcool/dsh-trivium
-- npm: [`dsh-trivium@0.4.17`](https://www.npmjs.com/package/dsh-trivium)
+- npm: [`dsh-trivium@0.4.19`](https://www.npmjs.com/package/dsh-trivium)
 - Tested host: `@deepseek-ai/dsh@0.1.5-rc.1` (also `0.1.1-rc.2` / `0.1.0-rc.8`)
 - License: MIT (depends on [TriviumDB](https://github.com/YoKONCy/TriviumDB), Apache-2.0)
 

package/README.zh-CN.md

@@ -44,8 +44,11 @@ clone / `git pull` 后若 jsonl 变了会自动导回。设置里 **Git 旁路**
 ```sh
 npm install
 node scripts/link-dsh.mjs
+npm test              # 可选：跑全部离线 smoke
 ```
 
+`npm test` 不需要 DSH 宿主，也不会碰你真实的 `~/.dsh/trivium.json`（每个脚本用独立的临时设置文件）。想只跑一部分就传子串：`npm test -- p8`。
+
 然后重启 `dsh web`。
 
 ## 更新
@@ -122,7 +125,7 @@ Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按**节点
 - **注入走 `agent.inject()`** — 不写 system prompt，避免 `persona.complete: true` 把地图静默丢掉。
 - **召回带路径** — 每条命中都说明从哪个节点、沿哪条边过来。
 - **失败不挡主循环** — 存储 / embedding / 抽取出错只记日志，Agent 继续。
-- **界面跟随宿主语言** — 设置页和「芯片」标签随 DSH `locale/change` 切换（`zh` / `en`），也可在配置设置里锁定。
+- **界面跟随宿主语言** — 设置页和「芯片」标签随 DSH `locale/change` 切换（`zh` / `en`），也可在配置设置里锁定。其它已解析的宿主语言、以及浏览器未命名任何注册语言的情况，一律回落英文（与宿主自己的 `FALLBACK_LOCALE` 一致）。
 - **首轮短地图** — 每个会话只注入一次。若 `session-start` 和第一步赛跑输了，`pre-step` 会补上；不会每步重写（前缀缓存友好）。
 
 ## 功能
@@ -238,6 +241,10 @@ Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按**节点
 
 ## 更新说明
 
+**0.4.19** — 修复插件自身界面在英文宿主上渲染成简体中文（[issue #2](https://github.com/QWQcool/dsh-trivium/issues/2)）。`locale` 服务改经 `ctx.inject(["locale"], …)` 获取，「跟随宿主」不再依赖插件组合顺序；兜底语言改为 `en`——与宿主自己的 `FALLBACK_LOCALE` 一致，也是其它已解析宿主语言的归宿。设置卡与芯片标签只在 zh / en 之间选择，浏览器未命名任何注册语言时不再给出中文卡。四工具 / 短地图 / find 路径不变。
+
+**0.4.18** — `~/.dsh/trivium.json` 改为原子写（此前写到一半被杀会让所有开关和芯片钉选静默回默认），POSIX 下权限收紧为仅属主可读。新增 `npm test` 聚合入口（每个脚本用独立临时设置文件），`smoke-p0` 新增「重开后 hybrid 文本索引仍可用」的断言。四工具 / 短地图 / find 路径行为不变。
+
 **0.4.17** — 存储升到 `triviumdb@0.8.8`（引擎行为相对 0.4.16 不变）。适配宿主 `@deepseek-ai/dsh@0.1.5-rc.1`：`session.header.seedLength` 被移除，会话层 fork 切点改读 `session.inheritedEventCount`。四工具 / 短地图 / find 路径不变。
 
 **0.4.16** — 存储升到 `triviumdb@0.8.4`：引擎构造函数改为 options 对象（`{ dim }`），不再收数字位置参数；TQL 行 id 变字符串，插件内部归一为数字。四工具 / 短地图 / find 路径不变。
@@ -279,6 +286,7 @@ Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按**节点
 | 现象 | 处理 |
 |---|---|
 | 设置里没有「Trivium 记忆」 | 确认装的是 web profile，然后**重启** `dsh web`，再打开一个工作区。只刷新浏览器不够。 |
+| 英文宿主下设置卡 / 芯片标签显示中文 | 0.4.19 已修（[issue #2](https://github.com/QWQcool/dsh-trivium/issues/2)）。旧版本可在 **设置 → Trivium 记忆 → 配置设置 → 插件语言 → English** 手动选一次，会写进 `~/.dsh/trivium.json`，刷新页面即可，不用重启宿主。 |
 | 标题栏没有「芯片」 | 在设置里打开「芯片（记忆白名单）」（拨一下就会保存）。切回对话页，标签应立刻出现，不用重启。 |
 | 改了注入 / 抽取 / embedding / 芯片开关没生效 | 芯片 / 抽取 / 注入拨一下即保存。Embedding URL 仍要点「保存设置」。只有设置页本身没出现时才重启 `dsh web`。 |
 | 会话层只有一个「后续」方框 | 正常（在会话层已打开时）。方框跟 DSH 压缩走，会话长不等于已经压过（默认约窗口 80% 才自动压）。要分段：对话里 `/compact`，或点「生成检查点」（只切图，不压窗口）。旧会话可点「更新检查点」补已经发生过的压缩 / 分叉。 |
@@ -296,7 +304,7 @@ Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按**节点
 ## 发布信息
 
 - GitHub: https://github.com/QWQcool/dsh-trivium
-- npm: [`dsh-trivium@0.4.17`](https://www.npmjs.com/package/dsh-trivium)
+- npm: [`dsh-trivium@0.4.19`](https://www.npmjs.com/package/dsh-trivium)
 - 测试宿主：`@deepseek-ai/dsh@0.1.5-rc.1`（兼 `0.1.1-rc.2` / `0.1.0-rc.8`）
 - License: MIT（依赖 [TriviumDB](https://github.com/YoKONCy/TriviumDB) 为 Apache-2.0）
 

package/lib/atomic.js

@@ -0,0 +1,42 @@
+/**
+ * Atomic text write: write a sibling temp file, then rename over the target.
+ *
+ * `writeFileSync(file, ...)` truncates in place, so a crash (or a kill) between
+ * truncate and write leaves a half-written file. For the settings file that
+ * means `readUiSettings()` silently returns `{}` and every switch / chip pin
+ * resets. A rename is atomic on the same volume, so readers see either the old
+ * file or the new one, never a truncated one.
+ */
+import { mkdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+/**
+ * @param file  absolute target path
+ * @param text  UTF-8 payload
+ * @param mode  optional POSIX mode (ignored on Windows). Applied to the temp
+ *              file, which the rename then promotes to the target.
+ * @returns the target path
+ */
+export function atomicWriteFile(file, text, { mode } = {}) {
+  mkdirSync(dirname(file), { recursive: true });
+  const tmp = `${file}.tmp`;
+  // Drop a stale temp first so `mode` is actually applied on creation.
+  try {
+    unlinkSync(tmp);
+  } catch {
+    // nothing stale to remove
+  }
+  writeFileSync(tmp, text, mode === undefined ? "utf8" : { encoding: "utf8", mode });
+  try {
+    renameSync(tmp, file);
+  } catch {
+    // Windows cannot always rename over an existing file; clear and retry.
+    try {
+      unlinkSync(file);
+    } catch {
+      // destination may not exist yet
+    }
+    renameSync(tmp, file);
+  }
+  return file;
+}

package/lib/client.js

@@ -324,25 +324,32 @@ window.__ModuleLoader__.load({
       },
     };
 
-    let uiLocale = "zh";
+    // Aligned with the host's own `FALLBACK_LOCALE` in
+    // `@deepseek-ai/dsh-client-locale`: English is both what DSH opens with when
+    // the browser names no registered language and the dictionary consulted after
+    // a miss, because that reader is the least likely to read Chinese. The plugin
+    // ships zh/en dictionaries only, so any other resolved host language is
+    // English here as well — never Chinese.
+    const FALLBACK_UI_LOCALE = "en";
+
+    let uiLocale = FALLBACK_UI_LOCALE;
     let hostLocale = "";
     let pluginLocalePref = "host";
     const localeListeners = new Set();
 
     function normalizeLocale(value) {
       const s = String(value || "").toLowerCase();
-      if (s.startsWith("en")) return "en";
-      if (s.startsWith("zh")) return "zh";
-      return "";
+      if (!s) return "";
+      return s.startsWith("zh") ? "zh" : FALLBACK_UI_LOCALE;
     }
 
     function resolvedUiLocale() {
       if (pluginLocalePref === "zh" || pluginLocalePref === "en") return pluginLocalePref;
-      return hostLocale || "zh";
+      return hostLocale || FALLBACK_UI_LOCALE;
     }
 
     function setUiLocale(next) {
-      const loc = normalizeLocale(next) || "zh";
+      const loc = normalizeLocale(next) || FALLBACK_UI_LOCALE;
       if (loc === uiLocale) return;
       uiLocale = loc;
       localeListeners.forEach((fn) => {
@@ -3313,15 +3320,26 @@ window.__ModuleLoader__.load({
       );
     }
 
-    function apply(ctx) {
-      workspacesList = ctx.workspaces?.list || null;
-      const sessions = ctx.sessions;
+    /** Read the host locale service when it is reachable. Never throws. */
+    function readHostLocaleFrom(hostCtx) {
       try {
-        const snap = ctx.locale && typeof ctx.locale.getLocale === "function" ? ctx.locale.getLocale() : null;
-        if (snap && snap.active) setHostLocale(snap.active);
+        const svc = hostCtx && hostCtx.locale;
+        const snap = svc && typeof svc.getLocale === "function" ? svc.getLocale() : null;
+        if (snap && snap.active) {
+          setHostLocale(snap.active);
+          return true;
+        }
+        return false;
       } catch {
         // host may not expose locale
+        return false;
       }
+    }
+
+    function apply(ctx) {
+      workspacesList = ctx.workspaces?.list || null;
+      const sessions = ctx.sessions;
+      readHostLocaleFrom(ctx);
       try {
         ctx.on("locale/change", (snap) => {
           if (snap && snap.active) setHostLocale(snap.active);
@@ -3329,6 +3347,18 @@ window.__ModuleLoader__.load({
       } catch {
         // ignore
       }
+      // The locale service is provided by its own plugin during boot, so it can
+      // arrive after this plugin applied, and an undeclared service is not a
+      // supported `ctx` property read. `ctx.inject` starts the callback once the
+      // dependency exists, so "follow host" no longer depends on composition
+      // order. Same pattern as `ctx.inject(["webServer"], …)` in lib/index.js.
+      try {
+        if (typeof ctx.inject === "function") {
+          ctx.inject(["locale"], (localeCtx) => readHostLocaleFrom(localeCtx));
+        }
+      } catch {
+        // host may not support injection
+      }
       ctx.slots.inject(
         "settings.section",
         () =>
@@ -3351,6 +3381,19 @@ window.__ModuleLoader__.load({
 
     exports.apply = apply;
     exports.inject = ["slots", "sessions", "workspaces"];
+    // Test-only probe over the locale resolution above (no behaviour of its own).
+    // The client module system resolves package-name specifiers only, so this
+    // choice cannot live in a separate requireable file; scripts/smoke-p13.mjs
+    // loads this bundle with a stubbed __ModuleLoader__/require and reads these.
+    exports.__locale = {
+      FALLBACK_UI_LOCALE,
+      normalizeLocale,
+      resolvedUiLocale,
+      setHostLocale,
+      setPluginLocalePref,
+      readHostLocaleFrom,
+      snapshot: () => ({ uiLocale, hostLocale, pluginLocalePref }),
+    };
     return module.exports;
   },
 });

package/lib/index.js

@@ -454,10 +454,12 @@ export function apply(ctx, config = {}) {
             extra.push(
               createUserMessage({
                 content: [{ type: "text", text: pin.text }],
+                // No `form`: "pins" was never in DSH's ContextForm union, so the
+                // client already rendered it as undeclared (opaque) context.
+                // Omitting the field is the documented default for that.
                 source: {
                   kind: "plugin",
                   plugin: "dsh-trivium",
-                  form: "pins",
                 },
               }),
             );

package/lib/settings.js

@@ -1,10 +1,14 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
-import { dirname, join, relative, resolve, sep } from "node:path";
+import { join, relative, resolve, sep } from "node:path";
+import { atomicWriteFile } from "./atomic.js";
 import { looksHttpUrl } from "./embed.js";
 
 export const SETTINGS_FILE = join(homedir(), ".dsh", "trivium.json");
 
+/** This file can hold an embedding API key; keep it owner-only. No-op on Windows. */
+const SETTINGS_FILE_MODE = 0o600;
+
 /** Tests may set DSH_TRIVIUM_SETTINGS to a temp file so we never touch the live home config. */
 export function settingsFilePath() {
   const override = String(process.env.DSH_TRIVIUM_SETTINGS || "").trim();
@@ -12,9 +16,9 @@ export function settingsFilePath() {
 }
 
 function persistSettings(next) {
-  const file = settingsFilePath();
-  mkdirSync(dirname(file), { recursive: true });
-  writeFileSync(file, JSON.stringify(next, null, 2), "utf8");
+  // Atomic: a truncated settings file would make readUiSettings() return {}
+  // and silently reset every switch / chip pin.
+  atomicWriteFile(settingsFilePath(), JSON.stringify(next, null, 2), { mode: SETTINGS_FILE_MODE });
   return next;
 }
 

package/lib/sidecar.js

@@ -1,8 +1,9 @@
 /** Git-friendly JSONL sidecar next to trivium.tdb. No embeddings, episodes, or chip pins. */
 
 import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { existsSync, readFileSync, unlinkSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { atomicWriteFile } from "./atomic.js";
 import { BUSINESS_EDGES } from "./schema.js";
 import {
   gitSidecarEnabledOf,
@@ -196,22 +197,6 @@ function readSidecarFile(cwd) {
   }
 }
 
-function atomicWrite(file, text) {
-  mkdirSync(dirname(file), { recursive: true });
-  const tmp = `${file}.tmp`;
-  writeFileSync(tmp, text, "utf8");
-  try {
-    renameSync(tmp, file);
-  } catch {
-    try {
-      unlinkSync(file);
-    } catch {
-      // dest may not exist
-    }
-    renameSync(tmp, file);
-  }
-}
-
 function rememberHash(cwd, hash) {
   const key = resolve(cwd);
   memoryHash.set(key, hash);
@@ -293,7 +278,7 @@ export function writeSidecarNow(cwd, db, { force = false } = {}) {
   if (!force && hash === knownHash(cwd) && existsSync(file)) {
     return { path: file, hash, wrote: false };
   }
-  atomicWrite(file, text);
+  atomicWriteFile(file, text);
   rememberHash(cwd, hash);
   return { path: file, hash, wrote: true };
 }

package/lib/store.js

@@ -124,6 +124,11 @@ export async function openWorkspaceDb(cwd) {
     // indexes may already exist
   }
   ensureWorkspaceRoot(db, cwd);
+  // Do NOT remove. triviumdb opens with `loadTextIndex: false` by default, so
+  // the persisted BM25 sidecar is not loaded and `searchHybrid`'s text channel
+  // returns nothing after a reopen until the index is rebuilt here. `searchNodes`
+  // cannot paper over the loss: its keyword fallback still scores, so a
+  // regression is silent at the tool level. scripts/smoke-p0.mjs pins this.
   rebuildTextIndex(db);
   dbs.set(key, db);
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-trivium",
-  "version": "0.4.17",
+  "version": "0.4.19",
   "description": "In-process graph memory for DeepSeek Harness, backed by TriviumDB.",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,7 @@
     }
   },
   "scripts": {
+    "test": "node scripts/run-all.mjs",
     "link-dsh": "node scripts/link-dsh.mjs",
     "smoke-p0": "node scripts/smoke-p0.mjs",
     "smoke-p1": "node scripts/smoke-p1.mjs",
@@ -41,9 +42,11 @@
     "smoke-p6": "node scripts/smoke-p6.mjs",
     "smoke-p7": "node scripts/smoke-p7.mjs",
     "smoke-p8": "node scripts/smoke-p8.mjs",
+    "smoke-p9": "node scripts/smoke-p9.mjs",
     "smoke-p10": "node scripts/smoke-p10.mjs",
     "smoke-p11": "node scripts/smoke-p11.mjs",
     "smoke-p12": "node scripts/smoke-p12.mjs",
+    "smoke-p13": "node scripts/smoke-p13.mjs",
     "preuninstall": "node ./lib/purge.js",
     "verify-live-p2": "node scripts/verify-live-p2.mjs"
   },