@aiwayds/dsh-topics-memory 0.14.0 → 0.16.0

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-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.**
+> **Requires dsh >= 0.1.5-rc.2** — 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.**
 
 ## Demo
 

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。
 
-> **要求 dsh >= 0.1.2-rc.1** — 本插件只跟随 dsh RC/stable 线（CI 与发版在运行时解析 latest/next 中更新的 dist-tag）。**不再支持 alpha 线。**
+> **要求 dsh >= 0.1.5-rc.2** — 本插件只跟随 dsh RC/stable 线（CI 与发版在运行时解析 latest/next 中更新的 dist-tag）。**不再支持 alpha 线。**
 
 ## 演示
 

package/lib/commands.d.ts

@@ -26,3 +26,13 @@ export type ManualConsolidate = (invocation: CommandInvocation) => Promise<Conso
 export declare const HELP: string;
 export declare function buildTopicsCommand(service: TopicsService, mutate: MutateFn, resolveAsk?: AskServiceResolver, resolveLlm?: LlmDirectoryResolver, distillNow?: ManualDistill, consolidateNow?: ManualConsolidate): CommandDefinition;
 export declare function tuningHint(stats: ReturnType<typeof aggregateStats>, threshold: number): string | undefined;
+/**
+ * Render the near-miss histogram as a two-line horizontal sparkline: tick
+ * labels over a log-scaled (count+1) strip, so a live session's 200:1 count
+ * range stays legible. Zero-count buckets inside the observed range draw as
+ * '·' to keep the score axis honest. Returns [] for empty or unparsable input.
+ */
+export declare function renderNearMissSparkline(buckets: {
+    bucket: string;
+    count: number;
+}[]): string[];

package/lib/commands.js

@@ -267,9 +267,7 @@ async function renderStats(service) {
             lines.push(`| \`${cell(t.slug)}\` | ${t.count} |`);
     }
     if (stats.nearMissHistogram.length > 0) {
-        lines.push('', 'Near-miss 分布（低于阈值或被结构门挡下）：', '', '| 分数段 | 次数 |', '| --- | --- |');
-        for (const b of stats.nearMissHistogram)
-            lines.push(`| ${cell(b.bucket)} | ${b.count} |`);
+        lines.push('', `Near-miss 分布（低于阈值 ${service.cfg.matchThreshold.toFixed(2)} 或被结构门挡下，对数刻度）：`, '', '```', ...renderNearMissSparkline(stats.nearMissHistogram), '```');
         const hint = tuningHint(stats, service.cfg.matchThreshold);
         if (hint !== undefined)
             lines.push('', `💡 ${hint}`);
@@ -286,6 +284,59 @@ export function tuningHint(stats, threshold) {
     }
     return undefined;
 }
+const SPARK_LEVELS = '▁▂▃▄▅▆▇█';
+const SPARK_EMPTY = '·';
+/** Columns per histogram bucket; 2 keeps a 25-bucket range at 50 cols so the
+ *  TUI renders both lines without wrapping. */
+const SPARK_COLS_PER_BUCKET = 2;
+/** Axis tick every 0.30 score units. */
+const SPARK_TICK_STEP = 0.3;
+/** Bucket width of the histogram built by nmBucket() in ilog.ts. */
+const SPARK_BUCKET_WIDTH = 0.05;
+/**
+ * Render the near-miss histogram as a two-line horizontal sparkline: tick
+ * labels over a log-scaled (count+1) strip, so a live session's 200:1 count
+ * range stays legible. Zero-count buckets inside the observed range draw as
+ * '·' to keep the score axis honest. Returns [] for empty or unparsable input.
+ */
+export function renderNearMissSparkline(buckets) {
+    const starts = buckets.map((b) => Number(b.bucket.split('–')[0]));
+    if (buckets.length === 0 || starts.some((s) => Number.isNaN(s)))
+        return [];
+    const first = Math.min(...starts);
+    const last = Math.max(...starts);
+    const n = Math.round((last - first) / SPARK_BUCKET_WIDTH) + 1;
+    const counts = new Array(n).fill(0);
+    for (let i = 0; i < buckets.length; i++) {
+        counts[Math.round((starts[i] - first) / SPARK_BUCKET_WIDTH)] += buckets[i].count;
+    }
+    const max = Math.max(...counts);
+    const denom = Math.log10(max + 1);
+    const strip = counts
+        .map((c) => (c === 0 || denom === 0 ? SPARK_EMPTY : SPARK_LEVELS[Math.round((Math.log10(c + 1) / denom) * (SPARK_LEVELS.length - 1))]))
+        .map((ch) => ch.repeat(SPARK_COLS_PER_BUCKET))
+        .join('');
+    const width = n * SPARK_COLS_PER_BUCKET;
+    const line = new Array(width).fill(' ');
+    const used = new Array(width).fill(false);
+    const put = (at, label) => {
+        if (at < 0 || at + label.length > width)
+            return;
+        if (used.slice(at, at + label.length).some(Boolean))
+            return;
+        for (let k = 0; k < label.length; k++) {
+            line[at + k] = label[k];
+            used[at + k] = true;
+        }
+    };
+    for (let i = 0;; i += Math.round(SPARK_TICK_STEP / SPARK_BUCKET_WIDTH)) {
+        if (i > 0 && i >= n - 2)
+            break;
+        put(i * SPARK_COLS_PER_BUCKET, (first + i * SPARK_BUCKET_WIDTH).toFixed(2));
+    }
+    put(width - 4, (first + n * SPARK_BUCKET_WIDTH).toFixed(2));
+    return [line.join('').replace(/ +$/, ''), strip];
+}
 /** /topics list caps the table at this many newest topics. */
 const LIST_LIMIT = 100;
 async function renderList(service) {

package/lib/observer.js

@@ -79,10 +79,12 @@ export class Observer {
                 state.assistantText = '';
                 return;
             }
-            case 'assistant/chunk': {
-                const chunk = data.chunk;
-                if (chunk?.type === 'text-delta' && typeof chunk.text === 'string')
-                    state.assistantText += chunk.text;
+            case 'assistant/message': {
+                // dsh 0.1.5-rc.1: streaming `assistant/chunk` events are gone — the
+                // settlement carries the committed message. Accumulate each round's
+                // text; turn/end reads the whole turn's transcript. Failed attempts
+                // (`assistant/attempt`) never reached the user, so they are skipped.
+                state.assistantText += textOf(data);
                 return;
             }
             case 'turn/end': {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwayds/dsh-topics-memory",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "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",
@@ -45,12 +45,12 @@
   "dependencies": {},
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@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-skill": ">=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/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"
   },
   "peerDependenciesMeta": {
@@ -81,22 +81,22 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@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-skill": "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/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",
     "@types/node": "^22.19.0",
     "typescript": "^5.9.2"

package/src/commands.ts

@@ -306,8 +306,14 @@ async function renderStats(service: TopicsService): Promise<string> {
     for (const t of stats.topTopics.slice(0, 5)) lines.push(`| \`${cell(t.slug)}\` | ${t.count} |`)
   }
   if (stats.nearMissHistogram.length > 0) {
-    lines.push('', 'Near-miss 分布（低于阈值或被结构门挡下）：', '', '| 分数段 | 次数 |', '| --- | --- |')
-    for (const b of stats.nearMissHistogram) lines.push(`| ${cell(b.bucket)} | ${b.count} |`)
+    lines.push(
+      '',
+      `Near-miss 分布（低于阈值 ${service.cfg.matchThreshold.toFixed(2)} 或被结构门挡下，对数刻度）：`,
+      '',
+      '```',
+      ...renderNearMissSparkline(stats.nearMissHistogram),
+      '```',
+    )
     const hint = tuningHint(stats, service.cfg.matchThreshold)
     if (hint !== undefined) lines.push('', `💡 ${hint}`)
   }
@@ -325,6 +331,57 @@ export function tuningHint(stats: ReturnType<typeof aggregateStats>, threshold:
   return undefined
 }
 
+const SPARK_LEVELS = '▁▂▃▄▅▆▇█'
+const SPARK_EMPTY = '·'
+/** Columns per histogram bucket; 2 keeps a 25-bucket range at 50 cols so the
+ *  TUI renders both lines without wrapping. */
+const SPARK_COLS_PER_BUCKET = 2
+/** Axis tick every 0.30 score units. */
+const SPARK_TICK_STEP = 0.3
+/** Bucket width of the histogram built by nmBucket() in ilog.ts. */
+const SPARK_BUCKET_WIDTH = 0.05
+
+/**
+ * Render the near-miss histogram as a two-line horizontal sparkline: tick
+ * labels over a log-scaled (count+1) strip, so a live session's 200:1 count
+ * range stays legible. Zero-count buckets inside the observed range draw as
+ * '·' to keep the score axis honest. Returns [] for empty or unparsable input.
+ */
+export function renderNearMissSparkline(buckets: { bucket: string; count: number }[]): string[] {
+  const starts = buckets.map((b) => Number(b.bucket.split('–')[0]))
+  if (buckets.length === 0 || starts.some((s) => Number.isNaN(s))) return []
+  const first = Math.min(...starts)
+  const last = Math.max(...starts)
+  const n = Math.round((last - first) / SPARK_BUCKET_WIDTH) + 1
+  const counts = new Array<number>(n).fill(0)
+  for (let i = 0; i < buckets.length; i++) {
+    counts[Math.round((starts[i] - first) / SPARK_BUCKET_WIDTH)] += buckets[i].count
+  }
+  const max = Math.max(...counts)
+  const denom = Math.log10(max + 1)
+  const strip = counts
+    .map((c) => (c === 0 || denom === 0 ? SPARK_EMPTY : SPARK_LEVELS[Math.round((Math.log10(c + 1) / denom) * (SPARK_LEVELS.length - 1))]))
+    .map((ch) => ch.repeat(SPARK_COLS_PER_BUCKET))
+    .join('')
+  const width = n * SPARK_COLS_PER_BUCKET
+  const line = new Array<string>(width).fill(' ')
+  const used = new Array<boolean>(width).fill(false)
+  const put = (at: number, label: string) => {
+    if (at < 0 || at + label.length > width) return
+    if (used.slice(at, at + label.length).some(Boolean)) return
+    for (let k = 0; k < label.length; k++) {
+      line[at + k] = label[k]
+      used[at + k] = true
+    }
+  }
+  for (let i = 0; ; i += Math.round(SPARK_TICK_STEP / SPARK_BUCKET_WIDTH)) {
+    if (i > 0 && i >= n - 2) break
+    put(i * SPARK_COLS_PER_BUCKET, (first + i * SPARK_BUCKET_WIDTH).toFixed(2))
+  }
+  put(width - 4, (first + n * SPARK_BUCKET_WIDTH).toFixed(2))
+  return [line.join('').replace(/ +$/, ''), strip]
+}
+
 /** /topics list caps the table at this many newest topics. */
 const LIST_LIMIT = 100
 

package/src/observer.ts

@@ -111,9 +111,12 @@ export class Observer {
         state.assistantText = ''
         return
       }
-      case 'assistant/chunk': {
-        const chunk = (data as { chunk?: { type?: string; text?: string } }).chunk
-        if (chunk?.type === 'text-delta' && typeof chunk.text === 'string') state.assistantText += chunk.text
+      case 'assistant/message': {
+        // dsh 0.1.5-rc.1: streaming `assistant/chunk` events are gone — the
+        // settlement carries the committed message. Accumulate each round's
+        // text; turn/end reads the whole turn's transcript. Failed attempts
+        // (`assistant/attempt`) never reached the user, so they are skipped.
+        state.assistantText += textOf(data as UserMessageLike)
         return
       }
       case 'turn/end': {