@aiwayds/dsh-topics-memory 0.10.0 → 0.12.0

package/lib/commands.js

@@ -86,18 +86,17 @@ function fail(text) {
 async function renderStatus(service) {
     const s = await service.store.status();
     const cfg = service.cfg;
-    const lines = [
-        `dsh-topics-memory @ ${s.root}`,
-        `  模式：${service.githubMode ? `github（${cfg.repo}）` : 'local-only'}`,
-        `  Topics：${s.topicCount}（draft ${s.byStatus.draft} / stable ${s.byStatus.stable} / deprecated ${s.byStatus.deprecated}）`,
-        `  观察积压：${s.observationsPending} 未蒸馏 / ${s.observationsTotal} 总量`,
-        `  冲突：${s.conflicts.length === 0 ? '无' : s.conflicts.join('、')}`,
-        `  损坏文件：${s.broken.length === 0 ? '无' : s.broken.join('、')}`,
-        `  git：${s.git ? `是（HEAD ${s.head?.slice(0, 10) ?? '??'}）` : '否'}`,
-        `  注入：${cfg.autoInject ? `${cfg.injectMode === 'digest' ? 'digest' : 'pointer'} 模式（topK ${cfg.topK}，预算 ${cfg.injectMode === 'digest' ? cfg.totalBudget : Math.min(cfg.totalBudget, 600)} tok，阈值 ${cfg.matchThreshold}）` : '关'}`,
-        `  去重：${cfg.injectDedup ? '开（同会话已注入的 Topic 不重注）' : '关'}`,
-        `  慢道：${cfg.qualityLane === 'off' ? '关' : cfg.qualityLane === 'always' ? `每轮（${cfg.distillProvider}/${cfg.distillModel}）` : `采样 1/3（${cfg.distillProvider}/${cfg.distillModel}）`}`,
-        `  蒸馏：${cfg.distillProvider !== '' && cfg.distillModel !== '' ? `${cfg.distillProvider}/${cfg.distillModel}，每 ${cfg.distillEveryTurns} 轮` : '未配置模型（/topics set distill-provider / distill-model）'}`,
+    const rows = [
+        ['模式', service.githubMode ? `github（${cell(cfg.repo)}）` : 'local-only'],
+        ['Topics', `${s.topicCount}（draft ${s.byStatus.draft} / stable ${s.byStatus.stable} / deprecated ${s.byStatus.deprecated}）`],
+        ['观察积压', `${s.observationsPending} 未蒸馏 / ${s.observationsTotal} 总量`],
+        ['冲突', s.conflicts.length === 0 ? '无' : s.conflicts.map((c) => cell(c)).join('、')],
+        ['损坏文件', s.broken.length === 0 ? '无' : s.broken.map((b) => cell(b)).join('、')],
+        ['git', s.git ? `是（HEAD ${s.head?.slice(0, 10) ?? '??'}）` : '否'],
+        ['注入', cfg.autoInject ? `${cfg.injectMode === 'digest' ? 'digest' : 'pointer'} 模式（topK ${cfg.topK}，预算 ${cfg.injectMode === 'digest' ? cfg.totalBudget : Math.min(cfg.totalBudget, 600)} tok，阈值 ${cfg.matchThreshold}）` : '关'],
+        ['注入去重', cfg.injectDedup ? '开（同会话已注入的 Topic 不重注）' : '关'],
+        ['慢道', cfg.qualityLane === 'off' ? '关' : cfg.qualityLane === 'always' ? `每轮（${cfg.distillProvider}/${cfg.distillModel}）` : `采样 1/3（${cfg.distillProvider}/${cfg.distillModel}）`],
+        ['蒸馏', cfg.distillProvider !== '' && cfg.distillModel !== '' ? `${cfg.distillProvider}/${cfg.distillModel}，每 ${cfg.distillEveryTurns} 轮` : '未配置模型（/topics set distill-provider / distill-model）'],
     ];
     // Last lane outcome (distill-state summary) — what "checkable via
     // /topics status" promises; absent until the first run of this bundle.
@@ -107,14 +106,20 @@ async function renderStatus(service) {
             ? `标记 ${String(lastRun.marked ?? 0)} 条观察`
             : `失败（${String(lastRun.reason ?? 'unknown')}）`;
         const gc = typeof lastRun.gcDropped === 'number' && lastRun.gcDropped > 0 ? `，GC 回收 ${lastRun.gcDropped}` : '';
-        lines.push(`  最近蒸馏：${outcome}${gc} @ ${String(lastRun.at ?? '').slice(0, 19).replace('T', ' ')}`);
+        rows.push(['最近蒸馏', `${outcome}${gc} @ ${cell(String(lastRun.at ?? '').slice(0, 19).replace('T', ' '))}`]);
     }
     if (service.sync !== undefined) {
-        lines.push(`  上次推送：${service.sync.lastPushAt ?? '从未'}`);
+        rows.push(['上次推送', cell(String(service.sync.lastPushAt ?? '从未'))]);
         if (service.sync.lastError !== '')
-            lines.push(`  同步错误：${service.sync.lastError.split('\n').at(-1)}`);
+            rows.push(['同步错误', cell(service.sync.lastError.split('\n').at(-1) ?? '')]);
     }
-    return lines.join('\n');
+    return [
+        `dsh-topics-memory @ ${s.root}`,
+        '',
+        '| 字段 | 值 |',
+        '| --- | --- |',
+        ...rows.map(([k, v]) => `| ${k} | ${v} |`),
+    ].join('\n');
 }
 /**
  * `/topics distill` — one manual distill run over the current observation pool.
@@ -151,9 +156,13 @@ async function renderStats(service) {
         return '还没有注入记录 —— 用起来之后这里会有 hit rate / top-N / near-miss 分布。';
     const lines = [
         `注入统计（最近 ${records.length} 轮）：`,
-        `  hit rate：${(stats.hitRate * 100).toFixed(1)}%（${stats.injectedRounds}/${stats.rounds} 轮注入）`,
-        `  零命中轮：${stats.zeroHitRounds}；平均命中 ${stats.avgHitsPerRound} 条/轮`,
-        `  平均预算占用：${stats.avgBudgetUtilization} tok`,
+        '',
+        '| 指标 | 值 |',
+        '| --- | --- |',
+        `| hit rate | ${(stats.hitRate * 100).toFixed(1)}%（${stats.injectedRounds}/${stats.rounds} 轮注入） |`,
+        `| 零命中轮 | ${stats.zeroHitRounds} |`,
+        `| 平均命中 | ${stats.avgHitsPerRound} 条/轮 |`,
+        `| 平均预算占用 | ${stats.avgBudgetUtilization} tok |`,
     ];
     // v4 lane split — how much of the injection traffic each lane carries.
     const slowRounds = records.filter((r) => r.lane === 'slow' || r.lane === 'mixed').length;
@@ -166,27 +175,34 @@ async function renderStats(service) {
                 .sort((a, b) => a - b);
             medianLag = `，赶上中位时延 ${(lags[Math.floor(lags.length / 2)] / 1000).toFixed(1)}s`;
         }
-        lines.push(`  慢道参与轮：${slowRounds}（快 ${(records.length - slowRounds)} / 慢或混合 ${slowRounds}${medianLag}）`);
+        lines.push(`| 慢道参与轮 | ${slowRounds}（快 ${records.length - slowRounds} / 慢或混合 ${slowRounds}${medianLag}） |`);
     }
     // Pointer open rate (v4 §4.3): topic_open calls vs pointer entries injected.
+    // Echoed hits ride the retrieval but never became pointers — excluded here.
     const opens = await service.store.readOpenRecords();
     if (opens.length > 0 || records.some((r) => r.lane !== undefined)) {
-        const entries = records.reduce((acc, r) => acc + r.hits.filter((h) => !(r.deduped ?? []).includes(h.slug)).length + (r.slow?.length ?? 0), 0);
+        const entries = records.reduce((acc, r) => acc +
+            r.hits.filter((h) => !(r.deduped ?? []).includes(h.slug) && !(r.echoed ?? []).includes(h.slug)).length +
+            (r.slow?.length ?? 0), 0);
         const rate = entries === 0 ? 0 : Math.min(1, opens.length / entries);
-        lines.push(`  指针打开率：${(rate * 100).toFixed(1)}%（${opens.length} 次 topic_open / ${entries} 条注入指针）`);
+        lines.push(`| 指针打开率 | ${(rate * 100).toFixed(1)}%（${opens.length} 次 topic_open / ${entries} 条注入指针） |`);
+    }
+    const echoedCount = records.reduce((acc, r) => acc + (r.echoed?.length ?? 0), 0);
+    if (echoedCount > 0) {
+        lines.push(`| 回声抑制 | ${echoedCount} 次（本会话蒸馏出的 topic 不回注） |`);
     }
     if (stats.topTopics.length > 0) {
-        lines.push('  Top-N 被注入 Topic：');
+        lines.push('', 'Top-N 被注入 Topic：', '', '| Slug | 注入次数 |', '| --- | --- |');
         for (const t of stats.topTopics.slice(0, 5))
-            lines.push(`    ${t.slug} ×${t.count}`);
+            lines.push(`| \`${cell(t.slug)}\` | ${t.count} |`);
     }
     if (stats.nearMissHistogram.length > 0) {
-        lines.push('  Near-miss 分布（低于阈值或被结构门挡下）：');
+        lines.push('', 'Near-miss 分布（低于阈值或被结构门挡下）：', '', '| 分数段 | 次数 |', '| --- | --- |');
         for (const b of stats.nearMissHistogram)
-            lines.push(`    ${b.bucket}: ${b.count}`);
+            lines.push(`| ${cell(b.bucket)} | ${b.count} |`);
         const hint = tuningHint(stats, service.cfg.matchThreshold);
         if (hint !== undefined)
-            lines.push(`  💡 ${hint}`);
+            lines.push('', `💡 ${hint}`);
     }
     return lines.join('\n');
 }
@@ -200,16 +216,38 @@ export function tuningHint(stats, threshold) {
     }
     return undefined;
 }
+/** /topics list caps the table at this many newest topics. */
+const LIST_LIMIT = 100;
 async function renderList(service) {
     const metas = await service.store.listTopics();
     if (metas.length === 0)
         return 'Bundle 里还没有 Topic —— 在会话里让我记点什么，或 /topics set 配置好蒸馏。';
-    const lines = [`共 ${metas.length} 个 Topic：`];
-    for (const m of metas.sort((a, b) => a.slug.localeCompare(b.slug))) {
-        lines.push(`  ${m.slug}  [${m.status}] ${m.title}${m.tags.length > 0 ? `  #${m.tags.join(' #')}` : ''}`);
+    // Newest first, capped: with a large bundle the table is for scanning
+    // recent work, not an exhaustive roster — /topics show <slug> reaches any
+    // topic the cap hides. (store.ts re-stamps generated.at on every topic
+    // write, so it IS the updated-at time; the slug tiebreak keeps same-stamp
+    // rows stable.)
+    metas.sort((a, b) => b.generatedAt.localeCompare(a.generatedAt) || a.slug.localeCompare(b.slug));
+    const shown = metas.slice(0, LIST_LIMIT);
+    const lines = [
+        `共 ${metas.length} 个 Topic（按最近更新排序）：`,
+        '',
+        '| # | Slug | 标题 | 状态 | 标签 | 更新 |',
+        '| --- | --- | --- | --- | --- | --- |',
+    ];
+    shown.forEach((m, i) => {
+        const tags = m.tags.length > 0 ? m.tags.map((t) => `#${cell(t)}`).join(' ') : '—';
+        lines.push(`| ${i + 1} | \`${cell(m.slug)}\` | ${cell(m.title)} | ${m.status} | ${tags} | ${cell(m.generatedAt.slice(0, 10))} |`);
+    });
+    if (metas.length > shown.length) {
+        lines.push('', `… 其余 ${metas.length - shown.length} 个更早的 Topic 未显示（/topics show <slug> 直达）。`);
     }
     return lines.join('\n');
 }
+/** One markdown table cell: pipes escaped, whitespace flattened. */
+function cell(text) {
+    return text.replace(/\|/g, '\\|').replace(/\s*\n\s*/g, ' ');
+}
 async function renderShow(service, slug) {
     if (slug === undefined || slug === '')
         return fail('用法：/topics show <slug>');
@@ -236,11 +274,15 @@ async function renderHistory(service, slug) {
     const { entries } = await service.history(slug, 30);
     if (entries.length === 0)
         return fail(`Topic “${slug}” 没有历史（不存在或 bundle 不是 git 仓库）`);
-    const lines = [`${slug} 的变更史（${entries.length} 条）：`];
+    const lines = [
+        `${slug} 的变更史（${entries.length} 条）：`,
+        '',
+        '| Hash | 时间 | 变更 | 当时的结论 |',
+        '| --- | --- | --- | --- |',
+    ];
     for (const e of entries) {
-        lines.push(`  ${e.hash} ${e.date.slice(0, 19).replace('T', ' ')} ${e.message}`);
-        if (e.conclusion !== undefined && e.conclusion !== '')
-            lines.push(`      └ 结论当时：${e.conclusion}`);
+        const conclusion = e.conclusion !== undefined && e.conclusion !== '' ? cell(e.conclusion) : '—';
+        lines.push(`| \`${cell(e.hash)}\` | ${cell(e.date.slice(0, 19).replace('T', ' '))} | ${cell(e.message)} | ${conclusion} |`);
     }
     return ok(lines.join('\n'));
 }
@@ -298,9 +340,14 @@ async function doSync(service, direction) {
     return fail('用法：/topics sync [pull|push]');
 }
 function renderConfig(cfg) {
-    const lines = ['当前配置：'];
+    const lines = [
+        '当前配置：',
+        '',
+        '| 配置项 | 值 |',
+        '| --- | --- |',
+    ];
     for (const key of CONFIG_KEYS) {
-        lines.push(`  ${displayKey(key)} = ${String(cfg[key])}`);
+        lines.push(`| ${displayKey(key)} | ${cell(String(cfg[key]))} |`);
     }
     return lines.join('\n');
 }

package/lib/config.d.ts

@@ -12,6 +12,11 @@ export declare const TopicsConfig: z<Schemastery.ObjectS<{
     autoInject: z<boolean, boolean>;
     /** Skip re-injecting topics already injected earlier in the same session. */
     injectDedup: z<boolean, boolean>;
+    /** 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, boolean>;
     /** Max topics injected per round (ADR 0006: ≤4). */
     topK: z<number, number>;
     /** Per-topic digest budget in tokens. */
@@ -60,6 +65,11 @@ export declare const TopicsConfig: z<Schemastery.ObjectS<{
     autoInject: z<boolean, boolean>;
     /** Skip re-injecting topics already injected earlier in the same session. */
     injectDedup: z<boolean, boolean>;
+    /** 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, boolean>;
     /** Max topics injected per round (ADR 0006: ≤4). */
     topK: z<number, number>;
     /** Per-topic digest budget in tokens. */
@@ -106,6 +116,7 @@ export type TopicsConfigValue = {
     repo: string;
     autoInject: boolean;
     injectDedup: boolean;
+    suppressEcho: boolean;
     topK: number;
     perTopicBudget: number;
     totalBudget: number;
@@ -126,7 +137,7 @@ export type TopicsConfigValue = {
     distillMaxModelCalls: number;
     pushDebounceSeconds: number;
 };
-export declare const CONFIG_KEYS: readonly ["repo", "autoInject", "injectDedup", "topK", "perTopicBudget", "totalBudget", "matchThreshold", "tagBoost", "injectMode", "qualityLane", "graphDepth", "recencyWindowDays", "autoObserve", "includeSubagents", "observationMaxChars", "distillEveryTurns", "distillOnSessionEnd", "distillProvider", "distillModel", "distillBatchSize", "distillMaxModelCalls", "pushDebounceSeconds"];
+export declare const CONFIG_KEYS: readonly ["repo", "autoInject", "injectDedup", "suppressEcho", "topK", "perTopicBudget", "totalBudget", "matchThreshold", "tagBoost", "injectMode", "qualityLane", "graphDepth", "recencyWindowDays", "autoObserve", "includeSubagents", "observationMaxChars", "distillEveryTurns", "distillOnSessionEnd", "distillProvider", "distillModel", "distillBatchSize", "distillMaxModelCalls", "pushDebounceSeconds"];
 export type ConfigKey = (typeof CONFIG_KEYS)[number];
 /** CamelCase → dash-display (topK → top-k) for command output. */
 export declare function displayKey(key: string): string;

package/lib/config.js

@@ -12,6 +12,11 @@ export const TopicsConfig = z.object({
     autoInject: z.boolean().default(true),
     /** Skip re-injecting topics already injected earlier in the same session. */
     injectDedup: z.boolean().default(true),
+    /** 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),
     /** Max topics injected per round (ADR 0006: ≤4). */
     topK: z.number().default(4),
     /** Per-topic digest budget in tokens. */
@@ -58,6 +63,7 @@ export const CONFIG_KEYS = [
     'repo',
     'autoInject',
     'injectDedup',
+    'suppressEcho',
     'topK',
     'perTopicBudget',
     'totalBudget',
@@ -93,6 +99,7 @@ export function parseConfigValue(key, raw) {
         }
         case 'autoInject':
         case 'injectDedup':
+        case 'suppressEcho':
         case 'autoObserve':
         case 'distillOnSessionEnd':
         case 'includeSubagents': {

package/lib/ilog.d.ts

@@ -51,6 +51,8 @@ export interface InjectionRecord {
     }[];
     /** Slugs blocked this round by session-level injection dedup (never assembled). */
     deduped?: string[];
+    /** Slugs blocked this round as 蒸馏回声 (distilled from this session's own turns). */
+    echoed?: string[];
     usedTokens?: number;
     /** fast = lexical pointers only; slow = async picks only; mixed = both. */
     lane?: 'fast' | 'slow' | 'mixed';

package/lib/ilog.js

@@ -24,12 +24,14 @@ export function aggregateStats(records) {
             budgetSamples += 1;
             budgetSum += r.usedTokens;
         }
-        // topTopics feeds 「Top-N 被注入 Topic」— deduped hits were NOT injected,
-        // so they must not inflate the per-slug injection counts. Retrieval-shape
-        // metrics above (hits/rounds, zero-hit rounds) keep counting raw hits.
+        // topTopics feeds 「Top-N 被注入 Topic」— deduped/echoed hits were NOT
+        // injected, so they must not inflate the per-slug injection counts.
+        // Retrieval-shape metrics above (hits/rounds, zero-hit rounds) keep
+        // counting raw hits.
         const deduped = r.deduped === undefined ? undefined : new Set(r.deduped);
+        const echoed = r.echoed === undefined ? undefined : new Set(r.echoed);
         for (const h of r.hits) {
-            if (deduped?.has(h.slug))
+            if (deduped?.has(h.slug) || echoed?.has(h.slug))
                 continue;
             topicCounts.set(h.slug, (topicCounts.get(h.slug) ?? 0) + 1);
         }

package/lib/index.js

@@ -170,6 +170,7 @@ export function apply(ctx) {
                 return;
             const cfg = cfgNow();
             const seen = cfg.injectDedup ? injectedBySession.get(sessionId) : undefined;
+            const echo = cfg.suppressEcho ? service.echoSlugsSync(sessionId) : undefined;
             // Slow-lane consumption point (v4 生命周期表): the pending produced at
             // the previous turn/end rides THIS splice — consumed or expired, the
             // slot is gone either way (消费即清; expiry surfaces in record.why).
@@ -184,7 +185,7 @@ export function apply(ctx) {
                         slowExpired = consumed.expired;
                 }
             }
-            const r = service.retrieveSync(query, sessionId, seen === undefined ? undefined : { exclude: seen }, slow, slowExpired);
+            const r = service.retrieveSync(query, sessionId, seen === undefined && echo === undefined ? undefined : { exclude: seen, echo }, slow, slowExpired);
             // Mark only what entered the context this round (hits AND slow picks →
             // dedup filter → assemble → registry mark; budget-dropped slugs stay
             // injectable).
@@ -235,6 +236,21 @@ export function apply(ctx) {
             slowLane.dispatch(sessionId, {
                 ring: observer.recentTurns(sessionId),
                 turnId: observer.turnCountOf(sessionId),
+                // The lane must not spend its rerank on slugs this session already
+                // carries (injected earlier / distilled from its own turns) — such a
+                // pick is silently swallowed at consumption and the pending dies.
+                exclude: (() => {
+                    const seen = injectedBySession.get(sessionId);
+                    const echo = cfgNow().suppressEcho ? service.echoSlugsSync(sessionId) : undefined;
+                    if (seen === undefined || seen.size === 0)
+                        return echo;
+                    if (echo === undefined || echo.size === 0)
+                        return seen;
+                    const merged = new Set(seen);
+                    for (const slug of echo)
+                        merged.add(slug);
+                    return merged;
+                })(),
             });
         }
         catch {
@@ -582,6 +598,7 @@ const DEFAULTS = {
     repo: '',
     autoInject: true,
     injectDedup: true,
+    suppressEcho: true,
     topK: 4,
     perTopicBudget: 300,
     totalBudget: 1500,

package/lib/quality.d.ts

@@ -50,6 +50,14 @@ export type ConsumeResult = {
 export interface DispatchInput {
     ring: readonly RingEntry[];
     turnId: number;
+    /**
+     * Slugs the session already carries — injected earlier this session or
+     * distilled from its own turns (echo). The candidate band drops them
+     * BEFORE the rerank: a pick the fast-lane dedup would silently swallow at
+     * consumption is a wasted aux call and a dead pending (2026-09 audit: 2 of
+     * the first 3 slow-lane outcomes died exactly this way).
+     */
+    exclude?: ReadonlySet<string>;
 }
 /** Extract the first balanced JSON object from model output (tolerates fences). */
 export declare function parseJsonObject(raw: string): Record<string, unknown>;

package/lib/quality.js

@@ -29,6 +29,8 @@ export const SAMPLED_EVERY = 3;
 const RING_CHARS = 6000;
 /** Candidate band size fed to the rerank. */
 const CANDIDATE_LIMIT = 6;
+/** Over-fetch before the exclude filter, so excluded slugs don't thin the band. */
+const CANDIDATE_OVERFETCH = 6;
 export const QUERY_BUILD_PROMPT = [
     '你是检索查询构建器。输入是最近几轮对话。任务：判断「模型此刻需要什么背景知识」，输出一个用于关键词检索的 query。',
     '只输出一个 JSON 对象，不要任何其他文字：{"needs": true, "query": "3-8 个检索词加一句意图", "ignore": ["被你忽略的内容类型"]}',
@@ -205,13 +207,16 @@ export class SlowLane {
             // candidates = threshold passers + the near-miss band beneath them.
             const band = searchTopics(query, roster, {
                 threshold: this.service.cfg.matchThreshold,
-                topK: CANDIDATE_LIMIT,
+                topK: CANDIDATE_LIMIT + CANDIDATE_OVERFETCH,
                 tagBoost: this.service.cfg.tagBoost,
                 graphDepth: 0,
                 recencyWindowDays: this.service.cfg.recencyWindowDays,
                 structuralGate: false,
             });
-            const candidates = [...band.hits, ...band.nearMisses].slice(0, CANDIDATE_LIMIT);
+            const exclude = input.exclude;
+            const candidates = [...band.hits, ...band.nearMisses]
+                .filter((c) => !exclude?.has(c.slug))
+                .slice(0, CANDIDATE_LIMIT);
             if (candidates.length === 0)
                 return;
             const bySlug = new Map(roster.map((r) => [r.slug, r]));

package/lib/service.d.ts

@@ -36,6 +36,8 @@ export interface SlowDelivery {
 }
 export declare class TopicsService {
     private cache;
+    /** mtime-keyed parse of the observations log, grouped by session. */
+    private echoCache;
     readonly store: BundleStore;
     private readonly getConfig;
     readonly sync?: Sync;
@@ -46,6 +48,16 @@ export declare class TopicsService {
     roster(): Promise<RetrievableTopic[]>;
     /** Drop the roster cache (tests, bulk external edits). */
     invalidate(): void;
+    /**
+     * Slugs distilled from THIS session's own turns — the echo set (2026-09
+     * audit finding #3: a topic distilled from in-session knowledge injected
+     * back into the same session is a lagging echo of what the model already
+     * said, occasionally stale enough to contradict the newer in-session
+     * conclusion). Provenance is durable in the observations log: each line
+     * carries `sessionId` and, once distilled, `distilledInto`. Sync read on
+     * the injection hot path, mtime-cached like the roster.
+     */
+    echoSlugsSync(sessionId: string): Set<string>;
     /**
      * Full retrieval round: search → assemble → log (ADR 0006/0007). The
      * injection record is written even for zero-hit rounds — the hit-rate
@@ -61,22 +73,28 @@ export declare class TopicsService {
      *
      * `dedup.exclude` (session-level injection dedup) filters hits AND slow
      * picks before assembly; excluded slugs are reported back as `deduped`
-     * (and logged as `record.deduped`), never packed. `included` mirrors the
-     * fast pointers that entered the context and `slowIncluded` the slow ones
-     * — only these may be marked as injected by the caller; budget-dropped
-     * slugs stay injectable later.
+     * (and logged as `record.deduped`), never packed. `dedup.echo` (蒸馏回声,
+     * v4 audit) filters the same way but reports separately as `echoed` /
+     * `record.echoed`: slugs distilled from THIS session's own turns.
+     * `included` mirrors the fast pointers that entered the context and
+     * `slowIncluded` the slow ones — only these may be marked as injected by
+     * the caller; budget-dropped slugs stay injectable later.
      *
      * `slow` (v4 §4.2) carries the consumed pending when one exists: picks are
      * packed after the fast pointers under the same budget, take log-only
      * shadow re-gate verdicts against the CURRENT query (B3: record, never
-     * block), and fill the record's lane field family.
+     * block), and fill the record's lane field family. A pick the fast lane
+     * already delivers THIS round is counted as slow-delivered (it entered the
+     * context) but not packed twice.
      */
     retrieveSync(query: string, sessionId?: string, dedup?: {
         exclude?: ReadonlySet<string>;
+        echo?: ReadonlySet<string>;
     }, slow?: SlowDelivery, slowExpired?: 'ttl' | 'turn-lag'): {
         text: string;
         outcome: SearchOutcome;
         deduped: string[];
+        echoed: string[];
         included: string[];
         slowIncluded: string[];
     };
@@ -86,7 +104,7 @@ export declare class TopicsService {
      * the store stamps it on every write, so it IS the last-updated instant).
      * Logs an open record for the pointer-open-rate stat.
      */
-    openTopic(slug: string, sessionId?: string): Promise<{
+    openTopic(rawSlug: string, sessionId?: string): Promise<{
         found: boolean;
         slug: string;
         title?: string;