@aiwayds/dsh-topics-memory 0.7.0 → 0.8.1

package/README.md

@@ -4,7 +4,7 @@ English | [中文](README.zh.md)
 
 A dsh plugin: maintains "working topic memory" as an [OKF (Open Knowledge Format v0.2)](https://github.com/GoogleCloudPlatform/open-knowledge-format) knowledge bundle, persisted in a local git repository (optionally synced to a private GitHub repo), with conclusions traceable through git history, sessions automatically observed and distilled into knowledge, and relevant topics injected to the model before every turn.
 
-> **Requires dsh >= 0.1.2-alpha.4** (adapted to the dsh 0.1.2-alpha.4 settings namespace and LLM seam; the rc line is no longer supported).
+> **Requires dsh >= 0.1.2-rc.1** — this plugin targets the dsh RC/stable line only (CI and releases resolve the newest of the `latest`/`next` dist-tags at runtime). **The alpha line is no longer supported.**
 
 ## The problem it solves
 
@@ -58,6 +58,24 @@ First thing after installing: run `/topics onboard`. The bundle lives at `~/.dsh
 
 0.6.0 renames the plugin: `@aiwayds/dsh-llmwiki-memory` → `@aiwayds/dsh-topics-memory`, the `/wiki` command family → `/topics`, and the settings namespace `llmwiki` → `topics`. Install the new package (and remove the old one from your profile) — on first start the plugin migrates everything automatically: the data directory `~/.dsh/llmwiki` is renamed to `~/.dsh/topics`, and user-tuned values in the old `llmwiki` settings namespace are copied into `topics`. No manual steps; if a migration step fails the plugin falls back to the old locations and keeps working.
 
+## Uninstall
+
+Remove the plugin from a profile:
+
+```sh
+dsh plugin --profile <name> remove @aiwayds/dsh-topics-memory
+```
+
+The host reconciles the profile automatically: the `dsh.profile.bundles` entry is spliced and the patch layer is dropped.
+
+What stays on disk (kept on purpose — this is your memory):
+
+- `~/.dsh/topics/` — the whole topic bundle: topic markdown, `meta/`, and the embedded `.git` repo (the full history; it may carry an `origin` remote — GitHub sync stops with the plugin). To archive the bundle elsewhere, copy or clone this directory as-is.
+- `~/.dsh/settings.yaml` `topics:` section — user overrides. Reinstalling silently reactivates sync including any configured `repo`; delete the section first if you want a clean start.
+- The legacy `llmwiki:` settings section left by the 0.5.x → 0.6.x migration is never auto-deleted; remove it by hand once nothing needs it.
+
+Purge everything: back up `~/.dsh/topics` first, then `rm -rf ~/.dsh/topics`.
+
 ## Configuration
 
 First-time setup belongs to `/topics onboard`; day-to-day tuning is `/topics set <key> <value>` (writes the `topics` namespace in `settings.yaml`, effective from the next session). All keys and defaults:

package/README.zh.md

@@ -4,7 +4,7 @@
 
 一个 dsh 插件：把「工作 topic 记忆」维护成 [OKF 标准（Open Knowledge Format v0.2）](https://github.com/GoogleCloudPlatform/open-knowledge-format)的知识 bundle，持久化在本地 git 仓库（可选同步到 GitHub 私有仓库），利用 git 历史提供结论可追溯性，自动观察会话沉淀知识，并在每轮对话前向模型注入相关 Topic。
 
-> **Requires dsh >= 0.1.2-alpha.4**（适配 dsh 0.1.2-alpha.4 的 settings 命名空间与 LLM seam；不再兼容 rc 线宿主）。
+> **要求 dsh >= 0.1.2-rc.1** — 本插件只跟随 dsh RC/stable 线（CI 与发版在运行时解析 latest/next 中更新的 dist-tag）。**不再支持 alpha 线。**
 
 ## 它解决什么问题
 
@@ -58,6 +58,24 @@ Bundle 默认在 `~/.dsh/topics/`（`$DSH_TOPICS_HOME` 可覆盖）。装好后
 2. 跑 `/topics onboard`，在 ask-user 面板里走完 模式 / 仓库 / 蒸馏模型 / 注入档位 / 自动观察 五个决定——末步确认才写入；
 3. 正常干活：相关结论每轮自动注入；说「记住…」让模型 `topic_save`；`/topics status` 看健康，`/topics stats` 看注入命中。
 
+## 卸载
+
+从 profile 移除插件：
+
+```sh
+dsh plugin --profile <name> remove @aiwayds/dsh-topics-memory
+```
+
+宿主会自动收敛：`dsh.profile.bundles` 条目被移除，patch 层随包消失。
+
+以下内容有意保留在磁盘上（这是你的记忆本体）：
+
+- `~/.dsh/topics/` —— 整个话题包：话题 markdown、`meta/`、以及内嵌的 `.git` 仓库（完整历史；可能带有 `origin` 远端 —— GitHub 同步随插件停止）。要异地归档就原样拷贝/克隆这个目录。
+- `~/.dsh/settings.yaml` 的 `topics:` 段 —— 用户覆盖项。注意：重装会静默恢复同步（包括已配置的 `repo`）；想干净重来就先删这一段。
+- 0.5.x → 0.6.x 迁移留下的 `llmwiki:` 旧设置段不会被自动删除；确认无用后手动移除。
+
+彻底清除：先备份 `~/.dsh/topics`，再 `rm -rf ~/.dsh/topics`。
+
 ## 配置
 
 首次配置交给 `/topics onboard`；日常微调用 `/topics set <key> <value>`（写 `settings.yaml` 的 `topics` namespace，下次会话启动生效）。全部键与默认值：

package/lib/index.js

@@ -470,8 +470,11 @@ export function apply(ctx) {
                 observer.onSessionEvent('dispose', 'agent/disposed', undefined);
             }
             sync.dispose();
-            void sync.commitMeta().then(() => sync.flush()).catch(() => undefined);
-            return settleBounded(exitDistill, EXIT_DISTILL_TIMEOUT_MS);
+            // The exit flush (final meta commit + ledger flush) rides the SAME
+            // bounded window as the exit distill — fire-and-forget here loses the
+            // exit race that window was built to win.
+            const exitFlush = sync.commitMeta().then(() => sync.flush()).catch(() => undefined);
+            return settleBounded(exitDistill === undefined ? exitFlush : Promise.allSettled([exitDistill, exitFlush]), EXIT_DISTILL_TIMEOUT_MS);
         };
     }, 'topics: lifecycle');
     // ---- /topics command (optional peer) ----

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "dsh-plugin: OKF v0.2 topic memory for dsh - local-first git-tracked bundle, hot-path LLM-free injection, two-stage observer with background distill",
   "type": "module",
   "main": "lib/index.js",
@@ -38,16 +38,17 @@
     "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/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": "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/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",
+    "smoke": "node scripts/smoke-boot.mjs"
   },
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-commands": ">=0.1.2-alpha.4",
-    "@deepseek-ai/dsh-util-values": ">=0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-util-values": ">=0.1.2-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "peerDependenciesMeta": {
@@ -75,21 +76,21 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-attachment": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-brand": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-code-runtime": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-commands": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-invariants": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-llm": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-scope": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-session": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-timeout": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-tools": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-user-approval": "0.1.2-alpha.4",
-    "@deepseek-ai/dsh-util-values": "0.1.2-alpha.4",
+    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-attachment": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-brand": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-code-runtime": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.1.2-rc.1",
     "@deepseek-ai/schemastery": "3.18.2",
     "@types/node": "^22.19.0",
     "typescript": "^5.9.2"

package/src/index.ts

@@ -535,8 +535,14 @@ export function apply(ctx: Context): void {
           observer.onSessionEvent('dispose', 'agent/disposed', undefined)
         }
         sync.dispose()
-        void sync.commitMeta().then(() => sync.flush()).catch(() => undefined)
-        return settleBounded(exitDistill, EXIT_DISTILL_TIMEOUT_MS)
+        // The exit flush (final meta commit + ledger flush) rides the SAME
+        // bounded window as the exit distill — fire-and-forget here loses the
+        // exit race that window was built to win.
+        const exitFlush = sync.commitMeta().then(() => sync.flush()).catch(() => undefined)
+        return settleBounded(
+          exitDistill === undefined ? exitFlush : Promise.allSettled([exitDistill, exitFlush]),
+          EXIT_DISTILL_TIMEOUT_MS,
+        )
       }
     },
     'topics: lifecycle',