claude-mem-lite 2.28.2 → 2.30.0

package/synonyms.mjs

@@ -71,6 +71,43 @@ export const SYNONYM_PAIRS = [
   ['debug', 'troubleshoot'],
   ['error', 'failure'],
   ['migrate', 'migration'],
+  // ─── Concurrency & Async ───
+  ['promise', 'async'],
+  ['callback', 'handler'],
+  ['deadlock', 'race condition'],
+  ['mutex', 'lock'],
+  ['semaphore', 'lock'],
+  ['concurrent', 'parallel'],
+  ['thread', 'worker'],
+  ['await', 'async'],
+  // ─── Type System ───
+  ['interface', 'type'],
+  ['generic', 'generics'],
+  ['typedef', 'type'],
+  ['enum', 'enumeration'],
+  // ─── Testing ───
+  ['mock', 'stub'],
+  ['mock', 'fake'],
+  ['fixture', 'testdata'],
+  ['assert', 'assertion'],
+  ['jest', 'vitest'],
+  ['pytest', 'unittest'],
+  ['cypress', 'playwright'],
+  // ─── Networking ───
+  ['http', 'request'],
+  ['rest', 'api'],
+  ['grpc', 'rpc'],
+  ['timeout', 'deadline'],
+  ['retry', 'backoff'],
+  ['cors', 'cross origin'],
+  ['ssl', 'tls'],
+  ['throttle', 'rate limit'],
+  // ─── Build Tools ───
+  ['webpack', 'bundler'],
+  ['vite', 'bundler'],
+  ['rollup', 'bundler'],
+  ['esbuild', 'bundler'],
+  ['transpile', 'compile'],
   // ─── CJK ↔ EN cross-language synonyms ───
   // Authentication & Authorization
   ['认证', 'auth'], ['认证', 'authentication'], ['登录', 'login'], ['登录', 'auth'],
@@ -108,6 +145,16 @@ export const SYNONYM_PAIRS = [
   ['钩子', 'hook'], ['回调', 'callback'],
   ['异步', 'async'], ['同步', 'sync'],
   ['并发', 'concurrent'], ['线程', 'thread'],
+  ['竞态', 'race condition'], ['死锁', 'deadlock'], ['互斥', 'mutex'],
+  ['协程', 'coroutine'], ['事件循环', 'event loop'],
+  ['泛型', 'generic'], ['枚举', 'enum'],
+  ['断言', 'assert'], ['单元测试', 'unit test'], ['集成测试', 'integration test'],
+  ['模拟测试', 'mock'], ['测试覆盖', 'coverage'],
+  ['错误处理', 'error handling'], ['异常捕获', 'try catch'], ['堆栈跟踪', 'stack trace'],
+  ['容错', 'fault tolerance'],
+  ['跨域', 'cors'], ['限流', 'rate limit'], ['熔断', 'circuit breaker'],
+  ['负载均衡', 'load balancing'], ['心跳', 'heartbeat'],
+  ['请求', 'request'], ['失败', 'failure'], ['覆盖率', 'coverage'],
   // Performance
   ['性能', 'performance'], ['性能', 'perf'],
   ['内存', 'memory'], ['泄漏', 'leak'],
@@ -140,6 +187,23 @@ export const SYNONYM_PAIRS = [
   ['安装', 'install'], ['导入', 'import'],
   ['导出', 'export'], ['状态', 'state'],
   ['系统', 'system'], ['算法', 'algorithm'],
+  // Common dev terms (mined from real usage data)
+  ['文件', 'file'], ['代码', 'code'],
+  ['执行', 'execute'], ['执行', 'run'],
+  ['调用', 'call'], ['调用', 'invoke'],
+  ['运行', 'run'], ['运行', 'execute'],
+  ['检查', 'check'], ['检查', 'inspect'],
+  ['分析', 'analyze'], ['分析', 'analysis'],
+  ['项目', 'project'], ['流程', 'workflow'],
+  ['更新', 'update'], ['提示', 'prompt'],
+  ['查找', 'find'], ['记录', 'record'],
+  ['记录', 'log'], ['校验', 'validate'],
+  ['计算', 'compute'], ['计算', 'calculate'],
+  ['单元', 'unit'], ['资源', 'resource'],
+  ['问题', 'issue'], ['问题', 'problem'],
+  ['历史', 'history'], ['描述', 'description'],
+  ['推荐', 'recommend'], ['建议', 'suggestion'],
+  ['智能', 'smart'], ['智能', 'intelligent'],
 ];
 
 // ─── Bidirectional SYNONYM_MAP (case-insensitive) ──────────────────────────────
@@ -168,11 +232,25 @@ export const CJK_COMPOUNDS = new Set([
   '认证', '授权', '加密', '解密', '序列', '并发', '异步', '同步', '线程', '进程',
   '容器', '集群', '服务器', '中间件', '网关', '负载', '监控', '日志', '告警',
   '前端', '后端', '全栈', '响应式', '路由', '状态', '渲染', '样式', '布局',
+  '代码', '文件', '项目', '资源', '单元', '智能',
+  // concurrency & async (extended)
+  '竞态', '死锁', '互斥', '协程', '回调', '事件循环',
+  // type system
+  '泛型', '枚举', '联合类型', '类型推断', '类型守卫', '接口定义',
+  // testing (extended)
+  '单元测试', '集成测试', '端到端', '测试覆盖', '覆盖率', '模拟测试', '断言',
+  // error handling (extended)
+  '错误处理', '异常捕获', '堆栈跟踪', '错误码', '容错', '失败', '请求',
+  // networking
+  '跨域', '限流', '熔断', '负载均衡', '心跳',
   // actions
   '修复', '重构', '优化', '升级', '安装', '卸载', '导入', '导出', '上传', '下载',
   '提交', '推送', '合并', '发布', '上线', '回退', '审查', '审核', '评审',
+  '执行', '调用', '运行', '检查', '分析', '查找', '计算', '校验', '更新', '描述',
   // errors/issues
-  '报错', '崩溃', '泄露', '溢出', '死锁', '超时', '中断', '异常', '故障',
+  '报错', '崩溃', '泄露', '溢出', '超时', '中断', '异常', '故障',
+  // general (tokenization only — keeps CJK segmentation clean)
+  '问题', '使用', '继续', '推荐', '建议', '历史', '记录', '中文', '提示', '流程',
   // architecture
   '架构', '设计', '方案', '规划', '文档', '注释', '版本', '分支', '依赖',
   '性能', '安全', '漏洞', '补丁', '系统', '算法',

package/tool-schemas.mjs

@@ -41,6 +41,7 @@ export const memSearchSchema = {
   limit: coerceInt.pipe(z.number().int().min(1).max(100)).optional().describe('Max results (default 20)'),
   offset: coerceInt.pipe(z.number().int().min(0)).optional().describe('Offset for pagination'),
   sort: z.enum(['relevance', 'time', 'importance']).optional().describe('Sort order: relevance (default, BM25), time (newest first), importance (highest first)'),
+  include_noise: z.boolean().optional().describe('Include hook-llm fallback titles ("Modified X", "Worked on X", raw error logs) — hidden by default as they have ~3% access rate'),
 };
 
 export const memRecentSchema = {
@@ -74,6 +75,7 @@ export const memSaveSchema = {
   project: z.string().optional().describe('Project name (default: inferred from CWD)'),
   importance: coerceInt.pipe(z.number().int().min(1).max(3)).optional().describe('Importance level: 1=routine, 2=notable, 3=critical (default: 2 for explicit saves)'),
   files: z.array(z.string()).optional().describe('File paths associated with this observation'),
+  lesson_learned: z.string().max(500).optional().describe('Key lesson or takeaway (for bugfix: root cause & fix; for decision: rationale)'),
 };
 
 export const memStatsSchema = {
@@ -87,6 +89,15 @@ export const memCompressSchema = {
   project: z.string().optional().describe('Filter by project'),
 };
 
+export const memOptimizeSchema = {
+  action: z.enum(['preview', 'run', 'run_all']).optional().default('preview')
+    .describe('preview=scan candidates, run=execute with limits, run_all=bypass gates'),
+  tasks: z.array(z.enum(['re-enrich', 'normalize', 'cluster-merge', 'smart-compress'])).optional()
+    .describe('Which optimization tasks to run (default: all)'),
+  max_items: coerceInt.pipe(z.number().int().min(1).max(100)).optional().default(15)
+    .describe('Maximum LLM calls across all tasks (default: 15)'),
+};
+
 export const memMaintainSchema = {
   action: z.enum(['scan', 'execute']).describe('scan=analyze candidates, execute=apply changes'),
   operations: z.array(z.enum(['dedup', 'decay', 'cleanup', 'boost', 'purge_stale', 'rebuild_vectors'])).optional()

package/utils.mjs

@@ -8,8 +8,8 @@ import { execSync } from 'child_process';
 // ─── Re-exports from extracted modules ──────────────────────────────────────
 // Backward compatibility: all consumers import from utils.mjs
 
-export { DECAY_HALF_LIFE_BY_TYPE, DEFAULT_DECAY_HALF_LIFE_MS, OBS_BM25, SESS_BM25, TYPE_DECAY_CASE, TYPE_QUALITY_CASE, OBS_FTS_COLUMNS } from './scoring-sql.mjs';
-export { cjkBigrams, extractCjkSynonymTokens, extractCjkKeywords, SYNONYM_MAP, expandToken, sanitizeFtsQuery, relaxFtsQueryToOr, FTS_STOP_WORDS, CJK_COMPOUNDS } from './nlp.mjs';
+export { DECAY_HALF_LIFE_BY_TYPE, DEFAULT_DECAY_HALF_LIFE_MS, OBS_BM25, SESS_BM25, TYPE_DECAY_CASE, TYPE_QUALITY_CASE, OBS_FTS_COLUMNS, notLowSignalTitleClause } from './scoring-sql.mjs';
+export { cjkBigrams, extractCjkSynonymTokens, extractCjkKeywords, extractCjkLikePatterns, SYNONYM_MAP, expandToken, sanitizeFtsQuery, relaxFtsQueryToOr, FTS_STOP_WORDS, CJK_COMPOUNDS } from './nlp.mjs';
 export { resolveProject, _resetProjectCache } from './project-utils.mjs';
 export { scrubSecrets, SECRET_PATTERNS } from './secret-scrub.mjs';
 export { truncate, typeIcon, fmtDate, fmtTime, isoWeekKey } from './format-utils.mjs';
@@ -89,7 +89,13 @@ export function clampImportance(val) {
 export const EDIT_TOOLS = new Set(['Edit', 'Write', 'NotebookEdit']);
 
 // Low-signal degraded title patterns — shared by hook-llm.mjs (dedup + importance cap) and hook-handoff.mjs (decision filter)
-export const LOW_SIGNAL_TITLE = /^(Error (while working|in)|Error: |Modified |Worked on |Reviewed \d+ files:|# |node |npm |npx |\(no description\)|\(error\)$)/;
+// Two top-level alternatives:
+//   1. ^(prefix1|prefix2|...) — title starts with one of the hook-llm fallback prefixes
+//   2. \(error\)$              — title ends with '(error)' (Bug #2 fix: previously this was
+//      inside the prefix group with a meaningless $, so only the exact title '(error)' matched.
+//      Tool-fragment titles like 'gh release list ... (error)' leaked through.)
+// Keep in sync with notLowSignalTitleClause() in scoring-sql.mjs.
+export const LOW_SIGNAL_TITLE = /^(Error (while working|in)|Error: |Modified |Worked on |Reviewed \d+ files:|# |node |npm |npx |\(no description\))|\(error\)$/;
 
 export function computeRuleImportance(episode) {
   let importance = 1;

package/commands/recall.md

@@ -1,9 +0,0 @@
----
-description: "Recall past observations for a file before editing. Use when: about to edit a file, investigating a file with past issues, or before refactoring to check for past lessons"
-argument-hint: <file_path>
----
-
-## File Memory
-!`claude-mem-lite recall $ARGUMENTS 2>/dev/null || echo "No history found"`
-
-Consider these past observations before making changes.

package/commands/recent.md

@@ -1,7 +0,0 @@
----
-description: "Show recent memory observations. Use when: checking what happened recently, reviewing session progress, or verifying recent changes were captured"
-argument-hint: [count]
----
-
-## Recent Observations
-!`claude-mem-lite recent $ARGUMENTS 2>/dev/null || echo "No observations"`

package/commands/search.md

@@ -1,9 +0,0 @@
----
-description: "Search memory for past bugfixes, decisions, discoveries. Use when: encountering a familiar error, investigating a module before changes, or looking for prior solutions to a similar problem"
-argument-hint: <query>
----
-
-## Memory Search
-!`claude-mem-lite search $ARGUMENTS 2>/dev/null || echo "No results found"`
-
-Use `claude-mem-lite get <id>` via Bash for full details on any result.

package/commands/timeline.md

@@ -1,7 +0,0 @@
----
-description: "Browse memory timeline around an observation. Use when: exploring what happened before/after a specific event, understanding the sequence of changes that led to a bug, or reviewing chronological context"
-argument-hint: <observation_id>
----
-
-## Timeline
-!`claude-mem-lite timeline --anchor $ARGUMENTS 2>/dev/null || echo "Not found"`