@morningljn/mnemo 0.1.2 → 0.1.4

package/README.md

@@ -15,6 +15,8 @@ AI coding assistants forget everything between sessions. `CLAUDE.md` stores stat
 mnemo gives your AI assistant a **searchable, structured memory layer** that persists across sessions:
 
 - **Search by meaning** — FTS5 full-text search + Jaccard reranking + bilingual expansion
+- **Session warmup** — MCP Resources auto-inject top facts at session start, zero tool calls
+- **Query refinement** — strips action words and noise tokens before memory search
 - **Trust scoring** — facts gain or lose trust over time based on feedback and decay
 - **Entity graph** — automatic entity extraction with multi-hop relationship queries
 - **Contradiction detection** — finds conflicting facts and demotes the older one
@@ -24,7 +26,7 @@ mnemo gives your AI assistant a **searchable, structured memory layer** that per
 
 ```bash
 # Install
-npm install -g @artljn/mnemo
+npm install -g @morningljn/mnemo
 
 # One-command setup (register MCP + write rules + set permissions)
 mnemo-init
@@ -49,15 +51,26 @@ claude mcp add mnemo -- mnemo
 
 You have mnemo memory tools (fact_store / fact_feedback). Rules:
 
-## Rule 1: Search before answering
-After receiving a user message, call `fact_store(action="search", query="<keywords from user message>")`.
-Extract keywords from the user's actual message — do NOT use a fixed template.
+## Rule 1: Session warmup (automatic)
+mnemo MCP Resources auto-inject global memory into system context at session start.
+You do NOT need to call fact_store(search) for high-frequency memories.
 
-## Rule 2: Write on request
+## Rule 2: On-demand search
+Only call fact_store(action="search") when:
+- User message involves personal preferences/habits/tool choices not covered by warmup
+- User explicitly queries memory ("what did I say before", "per my habits")
+- Technical decisions need user preference confirmation
+
+Do NOT trigger search for:
+- Pure operations ("run tests", "git commit")
+- General tech questions ("how to use Promise")
+- Code review/explanation requests
+
+## Rule 3: Write on request
 When user says "remember", call `fact_store(action="add", content="...", category="...")`.
 Search first to avoid duplicates. Categories: identity / coding_style / tool_pref / workflow / general.
 
-## Rule 3: Feedback
+## Rule 4: Feedback
 When a memory was useful, call `fact_feedback(action="helpful", fact_id=...)`.
 ```
 
@@ -115,21 +128,37 @@ Rate a fact after use. Good facts rise, bad facts decay.
 | `helpful` | +0.05 trust |
 | `unhelpful` | -0.10 trust |
 
+## MCP Resources
+
+mnemo exposes 5 global category resources for **zero-cost session warmup**:
+
+| Resource URI | Description |
+|-------------|-------------|
+| `mnemo://global/identity` | Identity facts (top 10 by trust) |
+| `mnemo://global/coding_style` | Coding style preferences |
+| `mnemo://global/tool_pref` | Tool preferences |
+| `mnemo://global/workflow` | Workflow preferences |
+| `mnemo://global/general` | General facts |
+
+MCP clients (Claude Code, Codex) automatically fetch these resources at session start, injecting memory into system context without any tool calls. This eliminates the need for "search every message" patterns.
+
 ## Architecture
 
 ```
 ┌───────────────────┐   stdio    ┌────────────┐   SQLite    ┌─────────────────────┐
 │   MCP Client      │◄─────────►│  mnemo     │◄───────────►│ ~/.mnemo/facts.db   │
 │ (Claude / Codex)  │   JSON    │  server    │             │                     │
-└───────────────────┘           └─────┬──────┘             │ Tables:             │
-                                      │                    │   facts             │
-                               ┌──────┴──────┐             │   entities          │
-                               │             │             │   fact_entities     │
-                               │  Retriever  │  Security   │ Indexes:            │
-                               │  (search,   │  (PII scan, │   facts_fts (FTS5)  │
-                               │   probe,    │   injection │   idx_facts_trust   │
-                               │   reason)   │   detection)│   idx_facts_category│
-                               └─────────────┘             └─────────────────────┘
+│                   │           └─────┬──────┘             │ Tables:             │
+│  Auto-fetch:      │                 │                    │   facts             │
+│  mnemo://global/* │      ┌──────────┼──────────┐         │   entities          │
+│  (session warmup) │      │          │          │         │   fact_entities     │
+└───────────────────┘      │          │          │         │ Indexes:            │
+                           │          │          │         │   facts_fts (FTS5)  │
+                     Resources   Retriever   Security       │   idx_facts_trust   │
+                     (warmup,   (search,    (PII scan,     │   idx_facts_category│
+                      cache)     probe,     injection      └─────────────────────┘
+                                 reason)    detection)
+                                └──────────────────┘
 ```
 
 ## Categories

package/README_zh.md

@@ -24,7 +24,7 @@ mnemo 为你的 AI 助手提供**可搜索、结构化的记忆层**，跨会话
 
 ```bash
 # 安装
-npm install -g @artljn/mnemo
+npm install -g @morningljn/mnemo
 
 # 一键配置（注册 MCP + 写入规则 + 设置权限）
 mnemo-init

package/dist/cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Query result cache for mnemo-mcp.
+ * Process-local Map with TTL. Cleared on write operations.
+ */
+import type { ScoredFact } from './types.js';
+export declare class QueryCache {
+    private cache;
+    private ttlMs;
+    constructor(ttlMs?: number);
+    makeKey(params: {
+        action: string;
+        query?: string;
+        entity?: string;
+        entities?: string[];
+        category?: string;
+        minTrust?: number;
+        limit?: number;
+    }): string;
+    get(key: string): ScoredFact[] | null;
+    set(key: string, results: ScoredFact[]): void;
+    clear(): void;
+    size(): number;
+}

package/dist/cache.js

@@ -0,0 +1,44 @@
+/**
+ * Query result cache for mnemo-mcp.
+ * Process-local Map with TTL. Cleared on write operations.
+ */
+const DEFAULT_TTL_MS = 60_000;
+export class QueryCache {
+    cache = new Map();
+    ttlMs;
+    constructor(ttlMs = DEFAULT_TTL_MS) {
+        this.ttlMs = ttlMs;
+    }
+    makeKey(params) {
+        const parts = [
+            params.action,
+            params.query ?? '',
+            params.entity ?? '',
+            params.entities?.join(',') ?? '',
+            params.category ?? '',
+            String(params.minTrust ?? ''),
+            String(params.limit ?? ''),
+        ];
+        return parts.join('|');
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > this.ttlMs) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.results;
+    }
+    set(key, results) {
+        this.cache.set(key, { results, timestamp: Date.now() });
+    }
+    clear() {
+        this.cache.clear();
+    }
+    size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,cAAc,GAAG,MAAM,CAAA;AAE7B,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;IACrC,KAAK,CAAQ;IAErB,YAAY,KAAK,GAAG,cAAc;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,OAAO,CAAC,MAQP;QACC,MAAM,KAAK,GAAG;YACZ,MAAM,CAAC,MAAM;YACb,MAAM,CAAC,KAAK,IAAI,EAAE;YAClB,MAAM,CAAC,MAAM,IAAI,EAAE;YACnB,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;YAChC,MAAM,CAAC,QAAQ,IAAI,EAAE;YACrB,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;SAC3B,CAAA;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAA;IACtB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,OAAqB;QACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/init.js

@@ -19,19 +19,27 @@ const MEMORY_RULES = `
 
 你有 mnemo 记忆工具（fact_store / fact_feedback），必须按以下规则使用：
 
-## 规则 1：搜索记忆（每次回复前）
-收到用户消息后，你必须先调用 \`fact_store(action="search", query="<用户消息的关键词>")\` 检索相关记忆。
-query 必须从用户消息中提取关键词，不要用固定模板。例如：
-- 用户说"我叫什么" → query="姓名 名字 叫什么"
-- 用户说"我喜欢什么语言" → query="编程语言 偏好 喜欢"
-搜索后根据结果自然回复，不要说"根据记忆"。
+## 规则 1：会话预热（自动）
+会话启动时，mnemo-mcp 的 MCP Resource 会自动注入全局记忆到 system context。
+你不需要主动调用 fact_store(search) 来获取高频记忆。
 
-## 规则 2：写入记忆
+## 规则 2：按需补充查询
+仅在以下情况调用 \`fact_store(action="search")\`：
+- 用户消息涉及个人偏好/习惯/工具选择且预热中未覆盖
+- 用户明确查询记忆（"我之前说过什么""按我的习惯"）
+- 技术选型时需要确认用户偏好
+
+不触发查询的情况：
+- 纯操作指令（"运行测试""git commit"）
+- 通用技术问题（"Promise 怎么用"）
+- 代码审查/解释请求
+
+## 规则 3：写入记忆
 用户说"记住"、"记下来"时，调用 \`fact_store(action="add", content="...", category="...")\`。
 - 先 search 检查是否已有相似事实，有则 update
 - category：identity / coding_style / tool_pref / workflow / general
 
-## 规则 3：反馈强化
+## 规则 4：反馈强化
 成功使用某条记忆时，调用 \`fact_feedback(action="helpful", fact_id=...)\`。
 `;
 const MCP_TOOLS = [

package/dist/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/dist/metrics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Performance metrics for mnemo-mcp.
+ * Tracks query timing, cache hit/miss, and retrieval paths.
+ * Only active when MNEMO_DEBUG=1.
+ */
+export interface QueryMetrics {
+    action: string;
+    durationMs: number;
+    resultCount: number;
+    cacheHit: boolean;
+    retrievalPath?: string;
+}
+export declare class PerfMetrics {
+    private enabled;
+    private totalQueries;
+    private cacheHits;
+    private cacheMisses;
+    private totalMissTimeMs;
+    constructor();
+    isEnabled(): boolean;
+    record(metrics: QueryMetrics): void;
+    getStats(): {
+        totalQueries: number;
+        cacheHits: number;
+        cacheMisses: number;
+        hitRatio: number;
+        avgQueryTime: number;
+        totalTimeSaved: number;
+    };
+    logStats(): void;
+}

package/dist/metrics.js

@@ -0,0 +1,57 @@
+/**
+ * Performance metrics for mnemo-mcp.
+ * Tracks query timing, cache hit/miss, and retrieval paths.
+ * Only active when MNEMO_DEBUG=1.
+ */
+export class PerfMetrics {
+    enabled;
+    totalQueries = 0;
+    cacheHits = 0;
+    cacheMisses = 0;
+    totalMissTimeMs = 0;
+    constructor() {
+        this.enabled = process.env.MNEMO_DEBUG === '1';
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    record(metrics) {
+        if (!this.enabled)
+            return;
+        this.totalQueries++;
+        if (metrics.cacheHit) {
+            this.cacheHits++;
+        }
+        else {
+            this.cacheMisses++;
+            this.totalMissTimeMs += metrics.durationMs;
+        }
+        const hitRatio = this.totalQueries > 0 ? (this.cacheHits / this.totalQueries * 100).toFixed(1) : '0.0';
+        const path = metrics.retrievalPath ? ` [${metrics.retrievalPath}]` : '';
+        console.error(`[mnemo:debug] ${metrics.action} | ${metrics.cacheHit ? 'HIT' : 'MISS'} | ` +
+            `${metrics.durationMs.toFixed(2)}ms | ${metrics.resultCount} results | ` +
+            `hit_ratio=${hitRatio}%${path}`);
+    }
+    getStats() {
+        const hitRatio = this.totalQueries > 0 ? this.cacheHits / this.totalQueries : 0;
+        const avgQueryTime = this.cacheMisses > 0 ? this.totalMissTimeMs / this.cacheMisses : 0;
+        const totalTimeSaved = this.cacheHits * avgQueryTime;
+        return {
+            totalQueries: this.totalQueries,
+            cacheHits: this.cacheHits,
+            cacheMisses: this.cacheMisses,
+            hitRatio,
+            avgQueryTime,
+            totalTimeSaved,
+        };
+    }
+    logStats() {
+        if (!this.enabled)
+            return;
+        const stats = this.getStats();
+        console.error(`[mnemo:debug] stats | total=${stats.totalQueries} hits=${stats.cacheHits} ` +
+            `misses=${stats.cacheMisses} hit_ratio=${(stats.hitRatio * 100).toFixed(1)}% ` +
+            `avg_time=${stats.avgQueryTime.toFixed(2)}ms saved=${stats.totalTimeSaved.toFixed(2)}ms`);
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,OAAO,WAAW;IACd,OAAO,CAAS;IAChB,YAAY,GAAG,CAAC,CAAA;IAChB,SAAS,GAAG,CAAC,CAAA;IACb,WAAW,GAAG,CAAC,CAAA;IACf,eAAe,GAAG,CAAC,CAAA;IAE3B;QACE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,CAAA;IAChD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,MAAM,CAAC,OAAqB;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEzB,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,SAAS,EAAE,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,EAAE,CAAA;YAClB,IAAI,CAAC,eAAe,IAAI,OAAO,CAAC,UAAU,CAAA;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QACtG,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QACvE,OAAO,CAAC,KAAK,CACX,iBAAiB,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK;YAC3E,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,WAAW,aAAa;YACxE,aAAa,QAAQ,IAAI,IAAI,EAAE,CAChC,CAAA;IACH,CAAC;IAED,QAAQ;QAQN,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/E,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;QACvF,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,GAAG,YAAY,CAAA;QAEpD,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ;YACR,YAAY;YACZ,cAAc;SACf,CAAA;IACH,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC7B,OAAO,CAAC,KAAK,CACX,+BAA+B,KAAK,CAAC,YAAY,SAAS,KAAK,CAAC,SAAS,GAAG;YAC5E,UAAU,KAAK,CAAC,WAAW,cAAc,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAC9E,YAAY,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACzF,CAAA;IACH,CAAC;CACF"}

package/dist/refine.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Query refinement: strip noise tokens from user messages before memory search.
+ * Pure function — no side effects, no DB access.
+ */
+export interface RefineResult {
+    query: string | null;
+    tokens: string[];
+    entityTokens: string[];
+}
+/**
+ * Refine a raw user message into memory-searchable keywords.
+ * Returns null if the message is a pure operation command with no memory relevance.
+ */
+export declare function refineQuery(raw: string): RefineResult | null;

package/dist/refine.js

@@ -0,0 +1,115 @@
+/**
+ * Query refinement: strip noise tokens from user messages before memory search.
+ * Pure function — no side effects, no DB access.
+ */
+// Action words / helper phrases to strip (Chinese)
+const ACTION_WORDS = [
+    '帮我看看', '能不能帮我', '给我看看',
+    '帮我', '看看', '看一下', '做一下', '能不能', '为什么', '怎么',
+    '是什么', '如何', '请', '麻烦', '可以', '给我',
+    '给我做', '给我写', '给我查', '给我找', '给我说', '给我讲',
+    '告诉我', '跟我说', '跟我讲', '给我解释', '给我说明', '给我介绍',
+    '运行', '执行', '启动', '停止', '创建', '删除', '修改', '更新', '查看',
+    '检查', '测试', '提交', '推送', '拉取', '合并', '切换', '重置', '重构',
+    '运行测试', '创建文件',
+];
+// Common CLI commands / low-signal English tokens to filter
+const NOISE_WORDS = new Set([
+    'git', 'npm', 'npx', 'yarn', 'pnpm', 'status', 'log', 'diff', 'add',
+    'commit', 'push', 'pull', 'merge', 'checkout', 'branch', 'stash',
+    'install', 'build', 'run', 'start', 'stop', 'test', 'lint', 'format',
+]);
+// Sort by length descending so longer phrases match first during replacement
+const ACTION_WORDS_SORTED = [...ACTION_WORDS].sort((a, b) => b.length - a.length);
+const ACTION_WORDS_SET = new Set(ACTION_WORDS);
+// Reuse existing stop words from retriever
+const CN_STOP_WORDS = new Set([
+    '的', '了', '是', '在', '有', '和', '就', '不', '人', '都',
+    '一', '个', '上', '也', '很', '到', '说', '要', '去', '你',
+    '会', '着', '没', '看', '好', '自', '这', '他', '她', '它',
+    '那', '些', '用', '对', '下', '为', '从', '被', '把', '能',
+    '可', '以', '所', '而', '又', '与', '但', '或', '等', '中',
+    '大', '小', '多', '少', '其', '之', '做', '让', '给', '已',
+    '还', '来', '地', '得', '过', '时', '里', '后', '前', '当',
+]);
+/**
+ * Refine a raw user message into memory-searchable keywords.
+ * Returns null if the message is a pure operation command with no memory relevance.
+ */
+export function refineQuery(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    // Extract high-signal tokens first: quoted content, book titles, capitalized phrases
+    const entityTokens = [];
+    // Chinese quotes: 「深色主题」 or "深色主题" or '深色主题'
+    for (const m of trimmed.matchAll(/[「""'']([^「""''」]{2,20})[」""'']/g)) {
+        entityTokens.push(m[1]);
+    }
+    // Book titles: 《记忆系统》
+    for (const m of trimmed.matchAll(/《([^》]+)》/g)) {
+        entityTokens.push(m[1]);
+    }
+    // Capitalized English phrases: "TypeScript", "Visual Studio Code"
+    for (const m of trimmed.matchAll(/\b([A-Z][a-zA-Z]*(?:\s+[A-Z][a-zA-Z]*)+)\b/g)) {
+        entityTokens.push(m[1]);
+    }
+    // Tokenize: split by spaces and Chinese character boundaries
+    const tokens = [];
+    const parts = trimmed.split(/\s+/);
+    for (const part of parts) {
+        // English words
+        for (const word of part.match(/[a-zA-Z0-9_\-.]+/g) ?? []) {
+            if (word.length >= 2)
+                tokens.push(word);
+        }
+        // For Chinese: strip action words first, then extract remaining chars
+        let cnText = part.replace(/[\u4e00-\u9fff]+/g, (seg) => {
+            let result = seg;
+            for (const aw of ACTION_WORDS_SORTED) {
+                result = result.replaceAll(aw, '');
+            }
+            return result;
+        });
+        const cnChars = cnText.match(/[\u4e00-\u9fff]/g) ?? [];
+        for (const c of cnChars) {
+            if (!CN_STOP_WORDS.has(c))
+                tokens.push(c);
+        }
+        // Chinese 2-grams for better matching
+        for (let i = 0; i < cnChars.length - 1; i++) {
+            const bigram = cnChars[i] + cnChars[i + 1];
+            tokens.push(bigram);
+        }
+    }
+    // Filter stop words, noise, and short tokens
+    const filtered = tokens.filter(t => {
+        if (ACTION_WORDS_SET.has(t))
+            return false;
+        if (CN_STOP_WORDS.has(t))
+            return false;
+        if (NOISE_WORDS.has(t.toLowerCase()))
+            return false;
+        if (t.length < 2)
+            return false;
+        return true;
+    });
+    // Deduplicate while preserving order
+    const seen = new Set();
+    const deduped = [];
+    for (const t of filtered) {
+        if (!seen.has(t)) {
+            seen.add(t);
+            deduped.push(t);
+        }
+    }
+    // If nothing left after filtering, check if we have entity tokens
+    if (deduped.length === 0 && entityTokens.length === 0) {
+        return null;
+    }
+    // Combine: entity tokens first (higher signal), then deduped tokens
+    const allTokens = [...entityTokens, ...deduped.filter(t => !entityTokens.includes(t))];
+    const query = allTokens.join(' ');
+    return { query, tokens: deduped, entityTokens };
+}
+//# sourceMappingURL=refine.js.map

package/dist/refine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine.js","sourceRoot":"","sources":["../src/refine.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MCP Resource manager for mnemo-mcp.
+ * Exposes per-category memory summaries as MCP Resources for session warmup injection.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MemoryStore } from './store.js';
+import type { FactCategory } from './types.js';
+export interface ResourceFact {
+    fact_id: number;
+    content: string;
+    trust_score: number;
+}
+export declare class ResourceManager {
+    private store;
+    private cache;
+    constructor(store: MemoryStore);
+    /** Register all category resources with the MCP server */
+    registerResources(server: McpServer): void;
+    /** Read handler for a specific category */
+    private readCategory;
+    /** Get facts for a category — with caching */
+    getFacts(category: FactCategory): ResourceFact[];
+    /** Invalidate all caches — call after any write operation */
+    invalidate(): void;
+    /** Get cache entry count for debugging */
+    cacheSize(): number;
+}

package/dist/resources.js

@@ -0,0 +1,56 @@
+/**
+ * MCP Resource manager for mnemo-mcp.
+ * Exposes per-category memory summaries as MCP Resources for session warmup injection.
+ */
+const CATEGORIES = ['identity', 'coding_style', 'tool_pref', 'workflow', 'general'];
+const RESOURCE_LIMIT = 10;
+export class ResourceManager {
+    store;
+    cache = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    /** Register all category resources with the MCP server */
+    registerResources(server) {
+        for (const category of CATEGORIES) {
+            const uri = `mnemo://global/${category}`;
+            server.registerResource(`mnemo-global-${category}`, uri, {
+                description: `${category} category global facts (top ${RESOURCE_LIMIT} by trust)`,
+                mimeType: 'application/json',
+            }, async () => this.readCategory(category));
+        }
+    }
+    /** Read handler for a specific category */
+    readCategory(category) {
+        const facts = this.getFacts(category);
+        return {
+            contents: [{
+                    uri: `mnemo://global/${category}`,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(facts, null, 2),
+                }],
+        };
+    }
+    /** Get facts for a category — with caching */
+    getFacts(category) {
+        const cached = this.cache.get(category);
+        if (cached)
+            return cached;
+        const facts = this.store.listFacts(category, 0.0, RESOURCE_LIMIT).map(f => ({
+            fact_id: f.factId,
+            content: f.content,
+            trust_score: f.trustScore,
+        }));
+        this.cache.set(category, facts);
+        return facts;
+    }
+    /** Invalidate all caches — call after any write operation */
+    invalidate() {
+        this.cache.clear();
+    }
+    /** Get cache entry count for debugging */
+    cacheSize() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,GAAmB,CAAC,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;AACnG,MAAM,cAAc,GAAG,EAAE,CAAA;AAQzB,MAAM,OAAO,eAAe;IAIhB;IAHF,KAAK,GAAG,IAAI,GAAG,EAAgC,CAAA;IAEvD,YACU,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IACzB,CAAC;IAEJ,0DAA0D;IAC1D,iBAAiB,CAAC,MAAiB;QACjC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,kBAAkB,QAAQ,EAAE,CAAA;YACxC,MAAM,CAAC,gBAAgB,CACrB,gBAAgB,QAAQ,EAAE,EAC1B,GAAG,EACH;gBACE,WAAW,EAAE,GAAG,QAAQ,+BAA+B,cAAc,YAAY;gBACjF,QAAQ,EAAE,kBAAkB;aAC7B,EACD,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CACxC,CAAA;QACH,CAAC;IACH,CAAC;IAED,2CAA2C;IACnC,YAAY,CAAC,QAAsB;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACrC,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,kBAAkB,QAAQ,EAAE;oBACjC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC,CAAC;SACH,CAAA;IACH,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,QAAsB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,UAAU;SAC1B,CAAC,CAAC,CAAA;QAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC/B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,6DAA6D;IAC7D,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED,0CAA0C;IAC1C,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;CACF"}

package/dist/retriever.d.ts

@@ -8,26 +8,38 @@
  */
 import type { ScoredFact, Contradiction, SearchOptions, ContradictOptions, RetrieverOptions } from './types.js';
 import { MemoryStore } from './store.js';
+import { QueryCache } from './cache.js';
+import { PerfMetrics } from './metrics.js';
 export declare class FactRetriever {
     private store;
     private db;
     private ftsWeight;
     private jaccardWeight;
     private halfLifeDays;
+    /** 查询缓存（60s TTL，进程内 Map） */
+    private cache;
+    /** 性能指标（MNEMO_DEBUG=1 时生效） */
+    private metrics;
     /** category → 高频 tag 集合（从事实库自动学习，惰性初始化） */
     private _categoryTagMap;
     /** 中英术语对列表（从事实库自动学习，惰性初始化） */
     private _cnEnPairs;
     constructor(store: MemoryStore, options?: RetrieverOptions);
+    /** 获取缓存实例（供 server.ts 写操作时调用 cache.clear()） */
+    getCache(): QueryCache;
+    /** 获取性能指标实例（供调试接口使用） */
+    getMetrics(): PerfMetrics;
     /** 主搜索：FTS5 → LIKE → 字符交叉 → 分类推断 → Jaccard → 信任评分 → 时间衰减 */
-    search(query: string, options?: SearchOptions): ScoredFact[];
+    search(query: string, options?: SearchOptions & {
+        skipRefine?: boolean;
+    }): ScoredFact[];
     /** 实体探测：查询某实体关联的所有事实 */
     probe(entity: string, options?: SearchOptions): ScoredFact[];
     /** 实体关联：查找与某实体共享上下文的其他事实 */
     related(entity: string, options?: SearchOptions): ScoredFact[];
     /** 多实体推理：查找同时关联多个实体的事实 */
     reason(entities: string[], options?: SearchOptions): ScoredFact[];
-    /** 矛盾检测：实体重叠 + 内容差异 */
+    /** 矛盾检测：实体重叠 + 内容差异（仅指标，不缓存 — 返回类型不同） */
     contradict(options?: ContradictOptions): Contradiction[];
     /** Stage 1: FTS5 候选集 */
     private ftsCandidates;