@aiwayds/dsh-topics-memory 0.17.1 → 0.18.1

package/lib/legacy-import.js

@@ -0,0 +1,224 @@
+/**
+ * One-time legacy settings import for the 0.1.5 → 0.1.7 upgrade: the dsh
+ * 0.1.7 host renames the old `~/.dsh/settings.yaml` to
+ * `settings.yaml.imported` and imports its sections as profile patches keyed
+ * by "section name = entry id". This plugin's old section was named `topics`,
+ * NOT `dsh-topics-memory` — the host's one-shot import silently drops it.
+ * This module recovers it once:
+ *
+ *   1. read `<home>/settings.yaml.imported` (preferred) →
+ *      `<home>/settings.yaml` (fallback);
+ *   2. flat-parse the `topics:` section (scalars only, conservative);
+ *   3. keep keys whose legacy value differs from the current effective value;
+ *   4. `settings.update('dsh-topics-memory', patch)` → on success write the
+ *      audit marker `<home>/storages/dsh-topics-memory/legacy-import.json`;
+ *      on failure warn and write nothing (the next boot retries);
+ *   5. marker present → the whole migration is skipped (idempotent — a
+ *      later manual edit of the imported file must not resurrect old values).
+ *
+ * A marker is written for EVERY settled outcome (imported / no-op /
+ * no-legacy / no-section) so this runs at most once per home. Never throws
+ * into the caller beyond what the apply()-side catch contains: plugin
+ * activation must not depend on this.
+ *
+ * @module legacy-import
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Profile entry id the recovered values are written to. */
+export const ENTRY_ID = 'dsh-topics-memory';
+/** Legacy top-level section name in the old settings.yaml. */
+export const LEGACY_SECTION = 'topics';
+/** Storage dir name for the audit marker (repo dir name, host convention). */
+export const STORAGE_DIR_NAME = 'dsh-topics-memory';
+/** Legacy keys worth recovering, mapped 1:1 onto Config keys of the same name. */
+export const LEGACY_KEYS = ['repo', 'distillProvider', 'distillModel', 'topK', 'totalBudget', 'autoObserve'];
+/** Candidates in priority order: the host's renamed document first. */
+export function legacySettingsCandidates(home) {
+    return [join(home, 'settings.yaml.imported'), join(home, 'settings.yaml')];
+}
+/** Audit marker path: `<home>/storages/<dir>/legacy-import.json`. */
+export function legacyMarkerPath(home) {
+    return join(home, 'storages', STORAGE_DIR_NAME, 'legacy-import.json');
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** A fully quoted scalar: balanced matching quote pair. */
+function isQuoted(s) {
+    return s.length >= 2 && ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'")));
+}
+function unquote(s) {
+    const inner = s.slice(1, -1);
+    // Double quotes: unescape \" and \\; single quotes: '' is a literal '.
+    if (s.startsWith('"'))
+        return inner.replaceAll('\\"', '"').replaceAll('\\\\', '\\');
+    return inner.replaceAll("''", "'");
+}
+/**
+ * Scalar inference for one flat `key: value` value. Quoted values are
+ * unquoted (mirroring src/yaml.ts); a single-line quoted flow-JSON value
+ * (`'["a","b"]'`) is JSON-parsed after unquoting — a malformed one stays a
+ * string. Unquoted flow collections are kept as strings (conservative:
+ * this is not a full YAML parser). Empty never reaches here (the line
+ * parser skips value-less keys — they open a nested block).
+ */
+export function inferScalar(raw) {
+    const s = raw.trim();
+    if (isQuoted(s)) {
+        const inner = unquote(s);
+        const t = inner.trim();
+        if (t.startsWith('[') || t.startsWith('{')) {
+            try {
+                return JSON.parse(t);
+            }
+            catch {
+                // not JSON after all — keep the unquoted string
+            }
+        }
+        return inner;
+    }
+    if (s === 'true' || s === 'True' || s === 'TRUE')
+        return true;
+    if (s === 'false' || s === 'False' || s === 'FALSE')
+        return false;
+    if (/^-?\d+$/.test(s) || /^-?\d+\.\d+$/.test(s))
+        return Number(s);
+    return s;
+}
+/**
+ * Flat section parser: locate the top-level `section:` line and collect its
+ * DIRECT children (`key: value` at one common indent) until the next
+ * top-level key. Deliberately conservative — NOT a YAML parser:
+ * - `key:` with an empty value (opens a nested map/sequence) is skipped, and
+ *   the deeper lines under it never match the child indent, so folded values
+ *   are skipped whole;
+ * - lines at any other indent are ignored;
+ * - an inline value on the header line itself (`section: x`) is not a flat
+ *   map → `{}`.
+ * Pure function — tests run it against literal strings.
+ */
+export function parseFlatSection(raw, section) {
+    const lines = raw.split('\n').map((l) => l.replace(/\r$/, ''));
+    const header = new RegExp(`^${escapeRegExp(section)}:(.*)$`);
+    const start = lines.findIndex((l) => header.test(l));
+    if (start < 0)
+        return {};
+    // An inline header value means the section is not a block map of children.
+    if (lines[start].replace(header, '$1').trim() !== '')
+        return {};
+    const out = {};
+    let childIndent;
+    for (let i = start + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trim() === '' || line.trimStart().startsWith('#'))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        if (indent === 0)
+            break; // next top-level key — section over
+        if (childIndent === undefined)
+            childIndent = indent;
+        if (indent !== childIndent)
+            continue; // nested block content — skipped
+        const match = /^([^\s:][^:]*):(?:[ \t]+(.*))?$/.exec(line.trim());
+        if (match === null)
+            continue; // not a `key: value` line — skipped
+        if (match[2] === undefined || match[2].trim() === '')
+            continue; // opens a nested block
+        out[match[1].trim()] = inferScalar(match[2]);
+    }
+    return out;
+}
+/**
+ * Run the one-time import. Resolves with the outcome; only throws on truly
+ * unexpected I/O errors (the apply()-side catch contains those). The marker
+ * is written for every settled outcome EXCEPT the retry-worthy failures
+ * (`no-settings`, `update-failed`) — those must re-run at the next boot.
+ */
+export async function runLegacySettingsImport(input) {
+    const skipped = {};
+    const imported = {};
+    const warn = (message) => {
+        try {
+            input.logger?.warn?.(message);
+        }
+        catch {
+            // contained — a broken logger must not break the import
+        }
+    };
+    const info = (message) => {
+        try {
+            input.logger?.info?.(message);
+        }
+        catch {
+            // contained
+        }
+    };
+    const markerPath = legacyMarkerPath(input.home);
+    if (existsSync(markerPath))
+        return { outcome: 'marker-exists', imported, skipped };
+    // A settings seam that cannot accept the patch is a retry-worthy state:
+    // return WITHOUT reading/marking, so a host that mounts the service later
+    // (and a test harness pointing at a real home) neither imports nor writes.
+    const settings = input.settings;
+    if (settings === undefined || typeof settings.update !== 'function') {
+        return { outcome: 'no-settings', imported, skipped };
+    }
+    // Locate the legacy document.
+    const source = legacySettingsCandidates(input.home).find((p) => existsSync(p));
+    if (source === undefined) {
+        writeMarker(markerPath, { at: new Date().toISOString(), outcome: 'no-legacy', source: undefined, imported, skipped });
+        return { outcome: 'no-legacy', imported, skipped };
+    }
+    const section = parseFlatSection(readFileSync(source, 'utf8'), LEGACY_SECTION);
+    // The marker records the source BASENAME: the marker lives inside the same
+    // home, so the directory part is implied.
+    const sourceName = source.slice(source.lastIndexOf('/') + 1);
+    const present = Object.keys(section);
+    if (present.length === 0) {
+        writeMarker(markerPath, { at: new Date().toISOString(), outcome: 'no-section', source: sourceName, imported, skipped });
+        return { outcome: 'no-section', imported, skipped };
+    }
+    // Key-level rule: import only when the legacy value differs from the
+    // current effective value; keys this plugin does not know are recorded and
+    // left alone (an unknown key would be rejected by the host's schema).
+    for (const key of present) {
+        if (!LEGACY_KEYS.includes(key)) {
+            skipped[key] = 'unknown-key';
+            continue;
+        }
+        const legacyValue = section[key];
+        if (legacyValue === input.getCurrent(key))
+            skipped[key] = 'equal';
+        else
+            imported[key] = legacyValue;
+    }
+    if (Object.keys(imported).length === 0) {
+        writeMarker(markerPath, { at: new Date().toISOString(), outcome: 'no-op', source: sourceName, imported, skipped });
+        info(`${ENTRY_ID}: legacy settings import (${LEGACY_SECTION} → ${ENTRY_ID}): nothing to import (all values equal or unknown)`);
+        return { outcome: 'no-op', imported, skipped };
+    }
+    try {
+        await settings.update(ENTRY_ID, imported);
+    }
+    catch (error) {
+        // No marker: the next boot retries the import.
+        warn(`${ENTRY_ID}: legacy settings import failed (will retry next boot): ${error instanceof Error ? error.message : String(error)}`);
+        return { outcome: 'update-failed', imported, skipped };
+    }
+    writeMarker(markerPath, { at: new Date().toISOString(), outcome: 'imported', source: sourceName, imported, skipped });
+    info(`${ENTRY_ID}: legacy settings import (${LEGACY_SECTION} → ${ENTRY_ID}): ${Object.keys(imported).join(', ')}`);
+    return { outcome: 'imported', imported, skipped };
+}
+/** Persist the audit marker; a failed write leaves no marker (harmless — the
+ *  next boot re-runs and converges, every step after the marker check is
+ *  idempotent). */
+function writeMarker(path, marker) {
+    try {
+        mkdirSync(join(path, '..'), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(marker, null, 2)}\n`);
+    }
+    catch {
+        // contained — see above
+    }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-topics-memory",
+    "description": "Quality-first topic memory: each topic keeps the question, conclusion, impact and dependencies in a local git-traced OKF bundle."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "dsh-topics-memory",
+    "description": "质量优先的主题记忆：每个主题留存问题、结论、影响与依赖，落在本地 git 追踪的 OKF 包里，注入零 LLM 开销。"
+  }
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "description": "dsh-plugin: quality-first topic memory for dsh — a topic keeps the starting question, conclusion, impact and dependencies, not the process; local-first git-traced OKF bundle, budgeted LLM-free injection",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
+  "icon": "./icon.svg",
   "license": "MIT",
   "keywords": [
     "dsh",
@@ -33,25 +34,27 @@
     "lib",
     "cordis.patch.yml",
     "src",
-    "skills"
+    "skills",
+    "icon.svg",
+    "locale/*.json"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc --noEmit -p tsconfig.json",
     "pretest": "tsc -p tsconfig.json",
-    "test": "node --test test/yaml.test.mjs test/okf.test.mjs test/retrieval.test.mjs test/digest.test.mjs test/ilog.test.mjs test/store.test.mjs test/paths.test.mjs test/git.test.mjs test/sync.test.mjs test/tools.test.mjs test/dedup.test.mjs test/commands.test.mjs test/onboard.test.mjs test/delegation.test.mjs test/observer.test.mjs test/distill.test.mjs test/consolidate.test.mjs test/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/settings-migration.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.test.mjs test/fast-lane.test.mjs",
+    "test": "node --test test/yaml.test.mjs test/okf.test.mjs test/retrieval.test.mjs test/digest.test.mjs test/ilog.test.mjs test/store.test.mjs test/paths.test.mjs test/git.test.mjs test/sync.test.mjs test/tools.test.mjs test/dedup.test.mjs test/commands.test.mjs test/onboard.test.mjs test/delegation.test.mjs test/observer.test.mjs test/distill.test.mjs test/consolidate.test.mjs test/viz.test.mjs test/corpus.test.mjs test/llm-scope.test.mjs test/quality.test.mjs test/replay-gate.test.mjs test/depends-repair.test.mjs test/skill.test.mjs test/fast-lane.test.mjs test/legacy-import.test.mjs",
     "smoke": "node scripts/smoke-boot.mjs"
   },
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": ">=0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": ">=0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/dsh-tools": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-commands": ">=0.1.7-rc.1",
+    "@deepseek-ai/dsh-util-values": ">=0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -81,23 +84,23 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-code-runtime": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-scope": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-skill": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-user-approval": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-brand": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-commands": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-skill": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22.19.0",
     "typescript": "^5.9.2"
   }

package/skills/dsh-topics-memory-config/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dsh-topics-memory-config
-description: "dsh 记忆插件（@aiwayds/dsh-topics-memory）使用与配置指南。凡涉及 dsh 记忆/话题库/GitHub 同步/蒸馏/整理，或要配置 topics 段时先读本指南：settings.yaml 顶层 `topics:` 段全部键（repo/autoInject/topK/注入预算/蒸馏/整理/观察/图游走等）、/topics 命令族（onboard/status/distill/consolidate/stats/list/show/history/graph/sync/config/set）、首次配置 ask_user_question 向导（local-only 或绑 GitHub 仓、蒸馏模型路由、注入档位、自动观察）、注入形态 pointer/digest、legacy llmwiki 段自动迁移。触发词：topics、记忆、topic、蒸馏、distill、整理、consolidate、合并重复、deprecatedTtl、usageBoost、使用加成、autoInject、记忆库、llmwiki、include-subagents。"
+description: "dsh 记忆插件（@aiwayds/dsh-topics-memory）使用与配置指南。凡涉及 dsh 记忆/话题库/GitHub 同步/蒸馏/整理，或要配置 topics 时先读本指南：设置页 `dsh-topics-memory` 条目全部键（repo/autoInject/topK/注入预算/蒸馏/整理/观察/图游走等）、/topics 命令族（onboard/status/distill/consolidate/stats/list/show/history/graph/sync/config/set）、首次配置 ask_user_question 向导（local-only 或绑 GitHub 仓、蒸馏模型路由、注入档位、自动观察）、注入形态 pointer/digest。触发词：topics、记忆、topic、蒸馏、distill、整理、consolidate、合并重复、deprecatedTtl、usageBoost、使用加成、autoInject、记忆库、include-subagents。"
 ---
 
 # dsh-topics-memory 使用指南（工作记忆 / 蒸馏 / 注入）
@@ -9,9 +9,9 @@ description: "dsh 记忆插件（@aiwayds/dsh-topics-memory）使用与配置指
 > 可选同步 GitHub 私有仓跨机共享。记忆是编辑出来的不是攒出来的——一个 topic 只记四件事
 > （起始问题、结论、影响、依赖），过程属于 session，结束就随它去。
 
-## 配置入口（settings.yaml 顶层 `topics:` 段）
+## 配置入口（设置页 `dsh-topics-memory` 条目）
 
-在 `~/.dsh/settings.yaml` 写顶层 `topics:` 段（只写非默认值即可）：
+0.1.7+ 宿主在设置页编辑 `dsh-topics-memory` 条目（全部字段免重启热更）；`/topics set` 写同一处，profile patch 持久化：
 
 | 键 | 默认 | 作用 |
 |---|---|---|
@@ -95,6 +95,6 @@ GitHub 模式凭据走 `$GITHUB_TOKEN` 或已登录的 gh CLI（`gh auth status`
 4. **GitHub 同步**：repo 须形如 owner/name；推送有 push-debounce-seconds 去抖；退出只做
    本地 commit 不等网络，推迟的 push 由下次启动 pull 后补推；rebase 冲突的 topic 降权标记，
    `/topics status` 可查。
-5. **旧版 llmwiki 段自动迁移**：0.5.x 的 `llmwiki:` 设置段与 `~/.dsh/llmwiki` 数据目录在
-   首次启动时自动迁移到 `topics` / `~/.dsh/topics`，无需手工；旧插件还在运行时会警告跳过
-   （防双载脑裂），先从 profile 移除旧包。
+5. **旧版数据目录迁移**：0.5.x 的 `~/.dsh/llmwiki` 数据目录在首次启动时自动迁移到
+   `~/.dsh/topics`，无需手工。旧版 `llmwiki:` 设置段不再自动迁移（0.1.7 宿主一次性导入
+   settings.yaml 后改名 settings.yaml.imported）；如有残留旧值，在设置页手工搬入。

package/src/config.ts

@@ -9,71 +9,71 @@ import z from '@deepseek-ai/schemastery'
 
 export const TopicsConfig = z.object({
   /** GitHub repo `owner/name`; empty = local-only mode (ADR 0008). */
-  repo: z.string().default(''),
+  repo: z.string().default('').volatile(),
   /** Master switch for per-turn injection. */
-  autoInject: z.boolean().default(true),
+  autoInject: z.boolean().default(true).volatile(),
   /** Skip re-injecting topics already injected earlier in the same session. */
-  injectDedup: z.boolean().default(true),
+  injectDedup: z.boolean().default(true).volatile(),
   /** Skip re-injecting topics distilled from the CURRENT session's own turns
    *  (蒸馏回声): the conversation already carries that knowledge, so a
    *  pointer is a stale echo at best (2026-09 audit: 3 of 6 useless rounds).
    *  Provenance rides the observations log (sessionId → distilledInto). */
-  suppressEcho: z.boolean().default(true),
+  suppressEcho: z.boolean().default(true).volatile(),
   /** Max topics injected per round (ADR 0006: ≤4). */
-  topK: z.number().default(4),
+  topK: z.number().default(4).volatile(),
   /** Per-topic digest budget in tokens. */
-  perTopicBudget: z.number().default(300),
+  perTopicBudget: z.number().default(300).volatile(),
   /** Total injection budget in tokens. */
-  totalBudget: z.number().default(1500),
+  totalBudget: z.number().default(1500).volatile(),
   /** Retrieval score threshold — tune via /topics stats near-miss evidence. */
-  matchThreshold: z.number().default(0.3),
+  matchThreshold: z.number().default(0.3).volatile(),
   /** Additive boost per tag hit (v4: total cap = this value, was ×3). */
-  tagBoost: z.number().default(0.15),
+  tagBoost: z.number().default(0.15).volatile(),
   /** Injection shape: pointer (default, ≤600 tok) keeps the legacy digest view. */
-  injectMode: z.string().default('pointer'),
+  injectMode: z.string().default('pointer').volatile(),
   /** Slow quality lane (v4 §4.2): off | sampled (1/3 of turns) | always. */
-  qualityLane: z.string().default('sampled'),
+  qualityLane: z.string().default('sampled').volatile(),
   /** depends-graph expansion depth (0 disables). */
-  graphDepth: z.number().default(2),
+  graphDepth: z.number().default(2).volatile(),
   /** Days within which a topic counts as recent (+0.2). */
-  recencyWindowDays: z.number().default(7),
+  recencyWindowDays: z.number().default(7).volatile(),
   /** Capture each turn's user/assistant text as raw observations (M2). */
-  autoObserve: z.boolean().default(true),
+  autoObserve: z.boolean().default(true).volatile(),
   /** Whether injection and observation also engage delegated subagent sessions (ADR 0011).
    *  v4 default flipped to false: one-shot subagent turns diluted the pool.
    *  The slow quality lane never runs for subagents either way (hard guard). */
-  includeSubagents: z.boolean().default(false),
+  includeSubagents: z.boolean().default(false).volatile(),
   /** Max auto-captured chars per side (user/assistant) per turn. */
-  observationMaxChars: z.number().default(2000),
+  observationMaxChars: z.number().default(2000).volatile(),
   /** Background distill cadence: every N turns of a long session. */
-  distillEveryTurns: z.number().default(5),
+  distillEveryTurns: z.number().default(5).volatile(),
   /** Distill once when a session ends. */
-  distillOnSessionEnd: z.boolean().default(true),
+  distillOnSessionEnd: z.boolean().default(true).volatile(),
   /** Distill lane model route; both must be set, else distill stays idle. */
-  distillProvider: z.string().default(''),
-  distillModel: z.string().default(''),
+  distillProvider: z.string().default('').volatile(),
+  distillModel: z.string().default('').volatile(),
   /** Observations per distill model call; auto-halves on output-limit failures (floor 5). */
-  distillBatchSize: z.number().default(40),
+  distillBatchSize: z.number().default(40).volatile(),
   /** Max model calls per distill run — successful batches keep their marks (partial progress).
    *  Default 8: with the batch loop, one run then drains ~30-40 observations
    *  instead of ~10, which is what makes a real backlog actually shrink. */
-  distillMaxModelCalls: z.number().default(8),
+  distillMaxModelCalls: z.number().default(8).volatile(),
   /** Consolidation lane (整理) cadence: how often a session start may run the
    *  LLM gardener over the EXISTING pool (merge near-duplicates, promote
    *  settled drafts, deprecate superseded, refresh metadata). Reuses the
    *  distill model route; off disables the lane entirely. */
-  consolidateCadence: z.string().default('daily'),
+  consolidateCadence: z.string().default('daily').volatile(),
   /** Deprecated topics older than this many days are dropped at session start
    *  (local TTL sweep, no model; each drop is its own git commit, so history
    *  stays recoverable on the remote). 0 disables the sweep. */
-  deprecatedTtlDays: z.number().default(15),
+  deprecatedTtlDays: z.number().default(15).volatile(),
   /** UsageBoost (ADR 0015): behavioral bonus for topics injected/opened in
    *  the last 30 days, folded into the gate score — capped at 0.2 and never
    *  granted to zero-lexical candidates; the structural gate still applies.
    *  0 = off. */
-  usageBoost: z.number().default(0.15),
+  usageBoost: z.number().default(0.15).volatile(),
   /** Debounced push delay in GitHub mode. */
-  pushDebounceSeconds: z.number().default(45),
+  pushDebounceSeconds: z.number().default(45).volatile(),
 })
 
 export type TopicsConfigValue = {

package/src/distill.ts

@@ -13,6 +13,20 @@
 import * as okf from './okf.ts'
 import type { TopicsService } from './service.ts'
 
+// dsh 0.1.7 removed the shared catch-all 'plugin' message-source kind:
+// MessageSourceMap is now a merge-extensible sum type and every producer
+// declares its own kind in its own module (dsh-skill: 'skill-invocation',
+// dsh-agent: 'model-selection', …). This plugin's distill call therefore
+// registers 'topics-memory' — consumers fall through unknown kinds by
+// contract, so hosts without the augmentation still render the message.
+declare module '@deepseek-ai/dsh-llm' {
+  interface MessageSourceMap {
+    /** Producer context contributed by the dsh-topics-memory plugin. */
+    'topics-memory': { kind: 'topics-memory' }
+  }
+}
+
+
 export interface ModelRequest {
   system: string
   user: string
@@ -838,7 +852,7 @@ export function defaultModelCaller(
     const messages = [
       createUserMessage({
         content: [{ type: 'text', text: req.user }],
-        source: { kind: 'plugin', plugin: 'dsh-topics-memory' },
+        source: { kind: 'topics-memory' },
       }),
     ]
     const options = deepFreeze({