memorix 1.4.3 → 1.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +20 -6
  3. package/README.zh-CN.md +16 -3
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +539 -233
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +72 -15
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +34 -0
  16. package/dist/sdk.js +71 -14
  17. package/dist/types.d.ts +1 -1
  18. package/dist/vector-backfill-runner.js +9 -7
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
  20. package/docs/API_REFERENCE.md +9 -5
  21. package/docs/CONFIGURATION.md +15 -5
  22. package/docs/DESIGN_DECISIONS.md +357 -357
  23. package/docs/DEVELOPMENT.md +2 -2
  24. package/docs/INTEGRATIONS.md +9 -2
  25. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
  26. package/docs/MEMCODE.md +1 -1
  27. package/docs/MODULES.md +1 -1
  28. package/docs/README.md +1 -1
  29. package/docs/SETUP.md +12 -4
  30. package/docs/hooks-architecture.md +2 -1
  31. package/llms-full.txt +7 -6
  32. package/llms.txt +2 -2
  33. package/package.json +1 -1
  34. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  35. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  36. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  37. package/plugins/copilot/memorix/plugin.json +1 -1
  38. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  39. package/plugins/omp/memorix/package.json +1 -1
  40. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  41. package/plugins/pi/memorix/package.json +1 -1
  42. package/server.json +2 -2
  43. package/src/audit/index.ts +156 -156
  44. package/src/cli/commands/agent-integrations.ts +7 -1
  45. package/src/cli/commands/audit-list.ts +89 -89
  46. package/src/cli/commands/formation.ts +48 -48
  47. package/src/cli/commands/git-hook-install.ts +111 -111
  48. package/src/cli/commands/handoff.ts +54 -54
  49. package/src/cli/commands/hooks-install.ts +2 -0
  50. package/src/cli/commands/hooks-preview.ts +5 -0
  51. package/src/cli/commands/hooks-status.ts +63 -63
  52. package/src/cli/commands/ingest.ts +44 -44
  53. package/src/cli/commands/integrate-shared.ts +15 -15
  54. package/src/cli/commands/integrate.ts +2 -0
  55. package/src/cli/commands/lock.ts +82 -82
  56. package/src/cli/commands/media-image.ts +27 -0
  57. package/src/cli/commands/media.ts +8 -1
  58. package/src/cli/commands/memory.ts +44 -34
  59. package/src/cli/commands/message.ts +104 -104
  60. package/src/cli/commands/operator-shared.ts +62 -18
  61. package/src/cli/commands/poll.ts +58 -58
  62. package/src/cli/commands/purge-all-memory.ts +85 -85
  63. package/src/cli/commands/purge-project-memory.ts +83 -83
  64. package/src/cli/commands/reasoning.ts +118 -118
  65. package/src/cli/commands/setup.ts +57 -2
  66. package/src/cli/commands/skills.ts +114 -114
  67. package/src/cli/commands/task.ts +167 -167
  68. package/src/cli/commands/transfer.ts +47 -47
  69. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  70. package/src/cli/commands/uninstall.ts +20 -0
  71. package/src/cli/tui/ChatView.tsx +234 -234
  72. package/src/cli/tui/CommandBar.tsx +312 -312
  73. package/src/cli/tui/ContextRail.tsx +118 -118
  74. package/src/cli/tui/HeaderBar.tsx +72 -72
  75. package/src/cli/tui/LogoBanner.tsx +51 -51
  76. package/src/cli/tui/Sidebar.tsx +179 -179
  77. package/src/cli/tui/index.ts +41 -41
  78. package/src/cli/tui/markdown-render.tsx +371 -371
  79. package/src/cli/tui/use-mouse.ts +157 -157
  80. package/src/cli/tui/useNavigation.ts +56 -56
  81. package/src/cli/version.ts +7 -7
  82. package/src/cli/workbench.ts +1 -1
  83. package/src/dashboard/project-classification.ts +64 -64
  84. package/src/git/hooks-path.ts +85 -85
  85. package/src/hooks/installers/index.ts +43 -2
  86. package/src/hooks/pattern-detector.ts +173 -173
  87. package/src/hooks/significance-filter.ts +250 -250
  88. package/src/hooks/types.ts +2 -0
  89. package/src/integrations/registry.ts +9 -0
  90. package/src/llm/memory-manager.ts +328 -328
  91. package/src/llm/provider.ts +885 -885
  92. package/src/llm/quality.ts +248 -248
  93. package/src/media/minimax.ts +9 -1
  94. package/src/memory/attribution-guard.ts +249 -249
  95. package/src/memory/disclosure-policy.ts +135 -135
  96. package/src/memory/entity-extractor.ts +197 -197
  97. package/src/memory/formation/evaluate.ts +217 -217
  98. package/src/memory/formation/extract.ts +361 -361
  99. package/src/memory/formation/index.ts +417 -417
  100. package/src/memory/formation/resolve.ts +344 -344
  101. package/src/memory/formation/types.ts +315 -315
  102. package/src/memory/freshness.ts +122 -122
  103. package/src/memory/graph.ts +197 -197
  104. package/src/memory/refs.ts +94 -94
  105. package/src/memory/secret-filter.ts +79 -79
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/types.ts +77 -77
  116. package/src/orchestrate/capability-router.ts +284 -284
  117. package/src/orchestrate/context-compact.ts +188 -188
  118. package/src/orchestrate/cost-tracker.ts +219 -219
  119. package/src/orchestrate/error-recovery.ts +191 -191
  120. package/src/orchestrate/evidence.ts +140 -140
  121. package/src/orchestrate/ledger.ts +110 -110
  122. package/src/orchestrate/memorix-bridge.ts +343 -343
  123. package/src/orchestrate/output-budget.ts +80 -80
  124. package/src/orchestrate/permission.ts +152 -152
  125. package/src/orchestrate/pipeline-trace.ts +131 -131
  126. package/src/orchestrate/prompt-builder.ts +155 -155
  127. package/src/orchestrate/ring-buffer.ts +37 -37
  128. package/src/orchestrate/task-graph.ts +389 -389
  129. package/src/project/aliases.ts +374 -374
  130. package/src/rules/adapters/trae.ts +56 -56
  131. package/src/rules/syncer.ts +235 -235
  132. package/src/search/query-expansion.ts +52 -52
  133. package/src/server/formation-timeout.ts +27 -27
  134. package/src/server.ts +23 -1
  135. package/src/skills/mini-skills.ts +386 -386
  136. package/src/store/chat-store.ts +119 -119
  137. package/src/store/graph-store.ts +249 -249
  138. package/src/store/mini-skill-store.ts +349 -349
  139. package/src/store/persistence-json.ts +212 -212
  140. package/src/store/persistence.ts +291 -291
  141. package/src/store/project-affinity.ts +195 -195
  142. package/src/team/event-bus.ts +76 -76
  143. package/src/team/file-locks.ts +173 -173
  144. package/src/team/handoff.ts +161 -161
  145. package/src/team/messages.ts +203 -203
  146. package/src/team/poll.ts +132 -132
  147. package/src/team/tasks.ts +211 -211
  148. package/src/types.ts +1 -1
  149. package/src/workspace/mcp-adapters/codex.ts +191 -191
  150. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  151. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  152. package/src/workspace/mcp-adapters/dsh.ts +147 -0
  153. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  154. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  155. package/src/workspace/mcp-adapters/trae.ts +134 -134
  156. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  157. package/src/workspace/sanitizer.ts +60 -60
  158. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -1,250 +1,250 @@
1
- /**
2
- * Significance Filter
3
- *
4
- * Determines if content is significant enough to be stored as memory.
5
- * Inspired by Cipher's isSignificantKnowledge() — filters out trivial content
6
- * while preserving technical knowledge, decisions, and problem-solving.
7
- *
8
- * Performance: O(n) regex matching, ~0.1-0.5ms per call.
9
- * No external dependencies, pure TypeScript.
10
- */
11
-
12
- // ─── Skip Patterns (content that should NOT be stored) ───
13
-
14
- const SKIP_PATTERNS: RegExp[] = [
15
- // Personal information and identity (privacy)
16
- /\b(my name|user['']?s? name|find my name|who am i|what['']?s my name)\b/i,
17
- /\b(password|secret|api[_-]?key|access[_-]?token|private[_-]?key)\b/i,
18
-
19
- // Simple greetings and social interactions
20
- /^(user:|assistant:)?\s*(hello|hi|hey|good morning|good afternoon|good evening|thanks|thank you|please|sorry|excuse me|bye|goodbye|你好|谢谢|再见)\b/i,
21
-
22
- // Generic status messages
23
- /^(task completed|operation successful|processing|loading|waiting|done|finished|ready|完成|成功|处理中)\b/i,
24
-
25
- // Simple yes/no or acknowledgment responses
26
- /^(user:|assistant:)?\s*(yes|no|ok|okay|sure|fine|great|good|right|correct|wrong|true|false|是|否|好的|对|错)\s*[.!?]?\s*$/i,
27
-
28
- // Tool results with no meaningful content
29
- /^(memorix_search|memorix_store|memorix_detail):\s*(found|completed|no results|error|stored)/i,
30
-
31
- // Empty or whitespace-only
32
- /^\s*$/,
33
-
34
- // Very short content (less than 10 chars after trimming)
35
- /^.{0,9}$/,
36
- ];
37
-
38
- // ─── Technical Patterns (content that SHOULD be stored) ───
39
-
40
- const TECHNICAL_PATTERNS: RegExp[] = [
41
- // Programming concepts and patterns
42
- /\b(function|method|class|interface|module|library|framework|algorithm|data structure|design pattern)\b/i,
43
- /\b(variable|constant|parameter|argument|return|async|await|promise|callback|closure|scope)\b/i,
44
- /\b(loop|iteration|recursion|condition|exception|error handling|debugging|testing|optimization)\b/i,
45
-
46
- // Code elements and syntax
47
- /\b(import|export|require|include|package|dependency|api|endpoint|request|response)\b/i,
48
- /\b(database|query|sql|nosql|schema|table|index|transaction|orm|migration)\b/i,
49
- /\b(git|version control|commit|merge|branch|pull request|repository|deployment)\b/i,
50
-
51
- // Technical implementations
52
- /\b(implements?|extends?|inherits?|overrides?|polymorphism|encapsulation|abstraction)\b/i,
53
- /\b(sort|search|filter|map|reduce|transform|parse|serialize|encrypt|decrypt)\b/i,
54
- /\b(authentication|authorization|security|validation|sanitization|middleware)\b/i,
55
-
56
- // Code blocks and technical syntax
57
- /```[\s\S]*```/,
58
- /`[^`]+`/,
59
-
60
- // Package managers and build tools
61
- /\b(npm|yarn|pnpm|pip|composer|cargo|go get|mvn|gradle|webpack|vite|rollup|tsup)\b/i,
62
-
63
- // File and system operations
64
- /\b(file|directory|path|config|environment|server|client|host|port|url|http|https|ssl|tls)\b/i,
65
- /\b(dockerfile|docker|container|kubernetes|cloud|aws|azure|gcp|ci\/cd|pipeline)\b/i,
66
-
67
- // Programming languages and technologies
68
- /\b(javascript|typescript|python|java|c\+\+|c#|rust|go|php|ruby|swift|kotlin|scala)\b/i,
69
- /\b(react|vue|angular|node|express|django|flask|spring|rails|laravel|fastapi|nextjs)\b/i,
70
- /\b(html|css|scss|sass|tailwind|bootstrap)\b/i,
71
-
72
- // Error messages and debugging
73
- /\b(error|exception|traceback|stack trace|compilation|syntax error|runtime error|bug|fix)\b/i,
74
- /(TypeError|ReferenceError|SyntaxError|RangeError|URIError|EvalError|AggregateError)/,
75
-
76
- // Technical explanations and problem-solving
77
- /\b(solution|approach|implementation|technique|strategy|pattern|best practice|optimization)\b/i,
78
- /\b(performance|scalability|maintainability|refactoring|code review|documentation)\b/i,
79
-
80
- // Decision and architecture keywords
81
- /\b(decision|chose|选择|决定|architecture|设计|trade-?off|权衡|因为|because|reason|原因)\b/i,
82
-
83
- // Chinese technical terms (no word boundary - Chinese doesn't use spaces)
84
- /(函数|方法|类|接口|模块|框架|算法|数据结构|设计模式|变量|常量|参数|返回|异步|回调|闭包|作用域)/,
85
- /(循环|迭代|递归|条件|异常|错误处理|调试|测试|优化|导入|导出|依赖|接口|端点|请求|响应)/,
86
- /(数据库|查询|表|索引|事务|迁移|版本控制|提交|合并|分支|部署|实现|继承|重写|多态|封装|抽象)/,
87
- ];
88
-
89
- // ─── Code-like Patterns ───
90
-
91
- const CODE_PATTERNS: RegExp[] = [
92
- /[{}[\]()]/, // Brackets and parentheses
93
- /[=><!&|]{2}/, // Double operators (==, !=, &&, ||, etc.)
94
- /\w+\.\w+\(/, // Method calls (obj.method()
95
- /\w+\s*=\s*\w+/, // Assignment
96
- /\/\*[\s\S]*?\*\/|\/\/.*$/m, // Comments
97
- /\$[a-zA-Z_][a-zA-Z0-9_]*/, // Shell/PHP variables
98
- /@\w+/, // Decorators/annotations
99
- ];
100
-
101
- // ─── Technical Words (for density calculation) ───
102
-
103
- const TECHNICAL_WORDS = new Set([
104
- 'api', 'sdk', 'cli', 'gui', 'ui', 'ux', 'ide', 'editor', 'compiler', 'interpreter',
105
- 'runtime', 'virtual', 'machine', 'container', 'image', 'build', 'deploy', 'release',
106
- 'version', 'update', 'patch', 'bug', 'feature', 'enhancement', 'issue', 'ticket',
107
- 'workflow', 'process', 'pipeline', 'automation', 'script', 'batch', 'cron', 'job',
108
- 'service', 'microservice', 'monolith', 'architecture', 'pattern', 'design', 'system',
109
- 'network', 'protocol', 'tcp', 'udp', 'http', 'https', 'ssl', 'tls', 'dns', 'cdn',
110
- 'cache', 'redis', 'memcached', 'session', 'cookie', 'token', 'jwt', 'oauth', 'auth',
111
- 'encrypt', 'decrypt', 'hash', 'salt', 'key', 'certificate', 'binary', 'buffer',
112
- 'json', 'xml', 'yaml', 'toml', 'csv', 'markdown', 'html', 'css', 'regex', 'parser',
113
- 'lexer', 'ast', 'ir', 'bytecode', 'jit', 'gc', 'heap', 'stack', 'memory', 'cpu',
114
- 'thread', 'process', 'async', 'sync', 'concurrent', 'parallel', 'mutex', 'lock',
115
- 'semaphore', 'deadlock', 'race', 'condition', 'atomic', 'volatile', 'immutable',
116
- ]);
117
-
118
- // ─── Main Filter Function ───
119
-
120
- export interface SignificanceResult {
121
- /** Whether the content is significant enough to store */
122
- isSignificant: boolean;
123
- /** Reason for the decision (for debugging/logging) */
124
- reason: string;
125
- /** Confidence score 0-1 (higher = more confident in decision) */
126
- confidence: number;
127
- }
128
-
129
- /**
130
- * Determine if content is significant enough to be stored as memory.
131
- *
132
- * @param content - The text content to evaluate
133
- * @returns SignificanceResult with decision, reason, and confidence
134
- */
135
- export function isSignificantKnowledge(content: string): SignificanceResult {
136
- if (!content || typeof content !== 'string') {
137
- return { isSignificant: false, reason: 'empty_content', confidence: 1.0 };
138
- }
139
-
140
- const text = content.trim();
141
- const textLower = text.toLowerCase();
142
-
143
- // ─── Phase 1: Skip patterns (fast rejection) ───
144
- for (const pattern of SKIP_PATTERNS) {
145
- if (pattern.test(text)) {
146
- return { isSignificant: false, reason: 'skip_pattern', confidence: 0.9 };
147
- }
148
- }
149
-
150
- // ─── Phase 2: Technical patterns (fast acceptance) ───
151
- for (const pattern of TECHNICAL_PATTERNS) {
152
- if (pattern.test(text)) {
153
- return { isSignificant: true, reason: 'technical_pattern', confidence: 0.85 };
154
- }
155
- }
156
-
157
- // ─── Phase 3: Code-like patterns ───
158
- let codePatternMatches = 0;
159
- for (const pattern of CODE_PATTERNS) {
160
- if (pattern.test(text)) {
161
- codePatternMatches++;
162
- }
163
- }
164
- if (codePatternMatches >= 2) {
165
- return { isSignificant: true, reason: 'code_patterns', confidence: 0.75 };
166
- }
167
-
168
- // ─── Phase 4: Technical word density ───
169
- const words = textLower.split(/\s+/).filter(w => w.length > 1);
170
- if (words.length > 5) {
171
- const technicalWordCount = words.filter(word =>
172
- TECHNICAL_WORDS.has(word.replace(/[^\w]/g, ''))
173
- ).length;
174
- const density = technicalWordCount / words.length;
175
-
176
- if (density > 0.15) {
177
- return { isSignificant: true, reason: 'high_technical_density', confidence: 0.7 };
178
- }
179
- if (density > 0.08 && words.length > 20) {
180
- return { isSignificant: true, reason: 'moderate_technical_density', confidence: 0.6 };
181
- }
182
- }
183
-
184
- // ─── Phase 5: Length-based heuristic ───
185
- // Longer content is more likely to be significant
186
- if (text.length > 200) {
187
- return { isSignificant: true, reason: 'substantial_length', confidence: 0.5 };
188
- }
189
-
190
- // ─── Default: not significant ───
191
- return { isSignificant: false, reason: 'no_technical_indicators', confidence: 0.6 };
192
- }
193
-
194
- /**
195
- * Check if content is a retrieved/search result that shouldn't be re-stored.
196
- * Prevents memory pollution from search results being stored as new memories.
197
- */
198
- export function isRetrievedResult(content: string): boolean {
199
- if (!content || typeof content !== 'string') return false;
200
- const text = content.toLowerCase();
201
-
202
- const retrievedPatterns = [
203
- /^(memorix_search|memorix_detail|memorix_timeline|search_nodes|read_graph):/i,
204
- /^(retrieved|result|results|found|matches|nodes|edges|search completed):/i,
205
- /^(observation #\d+|stored observation|memory #\d+)/i,
206
- /^(id:|timestamp:|similarity:|source:|type:)/i,
207
- /^(totalresults:|searchtime:|tokens:)/i,
208
- ];
209
-
210
- for (const pattern of retrievedPatterns) {
211
- if (pattern.test(text)) {
212
- return true;
213
- }
214
- }
215
-
216
- return false;
217
- }
218
-
219
- /**
220
- * Quick check for trivial commands that should never be stored.
221
- * Faster than full isSignificantKnowledge for common cases.
222
- */
223
- export function isTrivialCommand(command: string): boolean {
224
- if (!command || typeof command !== 'string') return true;
225
-
226
- const trivialPatterns = [
227
- /^(ls|dir|cd|pwd|echo|cat|type|head|tail|wc|which|where|whoami)(\s|$)/i,
228
- /^(Get-Content|Test-Path|Get-Item|Get-ChildItem|Set-Location|Write-Host)(\s|$)/i,
229
- /^(git\s+(status|log|diff|show|branch|remote|stash\s+list))(\s|$)/i,
230
- /^(npm\s+(list|ls|view|info|outdated))(\s|$)/i,
231
- /^(pip\s+(list|show|freeze)|python\s+--?version|node\s+--?version)(\s|$)/i,
232
- /^(env|printenv|set|export)(\s|$)/i,
233
- /^(clear|cls|exit|quit)(\s|$)/i,
234
- ];
235
-
236
- const cmd = command.trim();
237
-
238
- for (const pattern of trivialPatterns) {
239
- if (pattern.test(cmd)) {
240
- return true;
241
- }
242
- }
243
-
244
- // Self-referential: inspecting memorix's own data files
245
- if (/\.memorix[/\\]|observations\.json|memorix.*data/i.test(cmd)) {
246
- return true;
247
- }
248
-
249
- return false;
250
- }
1
+ /**
2
+ * Significance Filter
3
+ *
4
+ * Determines if content is significant enough to be stored as memory.
5
+ * Inspired by Cipher's isSignificantKnowledge() — filters out trivial content
6
+ * while preserving technical knowledge, decisions, and problem-solving.
7
+ *
8
+ * Performance: O(n) regex matching, ~0.1-0.5ms per call.
9
+ * No external dependencies, pure TypeScript.
10
+ */
11
+
12
+ // ─── Skip Patterns (content that should NOT be stored) ───
13
+
14
+ const SKIP_PATTERNS: RegExp[] = [
15
+ // Personal information and identity (privacy)
16
+ /\b(my name|user['']?s? name|find my name|who am i|what['']?s my name)\b/i,
17
+ /\b(password|secret|api[_-]?key|access[_-]?token|private[_-]?key)\b/i,
18
+
19
+ // Simple greetings and social interactions
20
+ /^(user:|assistant:)?\s*(hello|hi|hey|good morning|good afternoon|good evening|thanks|thank you|please|sorry|excuse me|bye|goodbye|你好|谢谢|再见)\b/i,
21
+
22
+ // Generic status messages
23
+ /^(task completed|operation successful|processing|loading|waiting|done|finished|ready|完成|成功|处理中)\b/i,
24
+
25
+ // Simple yes/no or acknowledgment responses
26
+ /^(user:|assistant:)?\s*(yes|no|ok|okay|sure|fine|great|good|right|correct|wrong|true|false|是|否|好的|对|错)\s*[.!?]?\s*$/i,
27
+
28
+ // Tool results with no meaningful content
29
+ /^(memorix_search|memorix_store|memorix_detail):\s*(found|completed|no results|error|stored)/i,
30
+
31
+ // Empty or whitespace-only
32
+ /^\s*$/,
33
+
34
+ // Very short content (less than 10 chars after trimming)
35
+ /^.{0,9}$/,
36
+ ];
37
+
38
+ // ─── Technical Patterns (content that SHOULD be stored) ───
39
+
40
+ const TECHNICAL_PATTERNS: RegExp[] = [
41
+ // Programming concepts and patterns
42
+ /\b(function|method|class|interface|module|library|framework|algorithm|data structure|design pattern)\b/i,
43
+ /\b(variable|constant|parameter|argument|return|async|await|promise|callback|closure|scope)\b/i,
44
+ /\b(loop|iteration|recursion|condition|exception|error handling|debugging|testing|optimization)\b/i,
45
+
46
+ // Code elements and syntax
47
+ /\b(import|export|require|include|package|dependency|api|endpoint|request|response)\b/i,
48
+ /\b(database|query|sql|nosql|schema|table|index|transaction|orm|migration)\b/i,
49
+ /\b(git|version control|commit|merge|branch|pull request|repository|deployment)\b/i,
50
+
51
+ // Technical implementations
52
+ /\b(implements?|extends?|inherits?|overrides?|polymorphism|encapsulation|abstraction)\b/i,
53
+ /\b(sort|search|filter|map|reduce|transform|parse|serialize|encrypt|decrypt)\b/i,
54
+ /\b(authentication|authorization|security|validation|sanitization|middleware)\b/i,
55
+
56
+ // Code blocks and technical syntax
57
+ /```[\s\S]*```/,
58
+ /`[^`]+`/,
59
+
60
+ // Package managers and build tools
61
+ /\b(npm|yarn|pnpm|pip|composer|cargo|go get|mvn|gradle|webpack|vite|rollup|tsup)\b/i,
62
+
63
+ // File and system operations
64
+ /\b(file|directory|path|config|environment|server|client|host|port|url|http|https|ssl|tls)\b/i,
65
+ /\b(dockerfile|docker|container|kubernetes|cloud|aws|azure|gcp|ci\/cd|pipeline)\b/i,
66
+
67
+ // Programming languages and technologies
68
+ /\b(javascript|typescript|python|java|c\+\+|c#|rust|go|php|ruby|swift|kotlin|scala)\b/i,
69
+ /\b(react|vue|angular|node|express|django|flask|spring|rails|laravel|fastapi|nextjs)\b/i,
70
+ /\b(html|css|scss|sass|tailwind|bootstrap)\b/i,
71
+
72
+ // Error messages and debugging
73
+ /\b(error|exception|traceback|stack trace|compilation|syntax error|runtime error|bug|fix)\b/i,
74
+ /(TypeError|ReferenceError|SyntaxError|RangeError|URIError|EvalError|AggregateError)/,
75
+
76
+ // Technical explanations and problem-solving
77
+ /\b(solution|approach|implementation|technique|strategy|pattern|best practice|optimization)\b/i,
78
+ /\b(performance|scalability|maintainability|refactoring|code review|documentation)\b/i,
79
+
80
+ // Decision and architecture keywords
81
+ /\b(decision|chose|选择|决定|architecture|设计|trade-?off|权衡|因为|because|reason|原因)\b/i,
82
+
83
+ // Chinese technical terms (no word boundary - Chinese doesn't use spaces)
84
+ /(函数|方法|类|接口|模块|框架|算法|数据结构|设计模式|变量|常量|参数|返回|异步|回调|闭包|作用域)/,
85
+ /(循环|迭代|递归|条件|异常|错误处理|调试|测试|优化|导入|导出|依赖|接口|端点|请求|响应)/,
86
+ /(数据库|查询|表|索引|事务|迁移|版本控制|提交|合并|分支|部署|实现|继承|重写|多态|封装|抽象)/,
87
+ ];
88
+
89
+ // ─── Code-like Patterns ───
90
+
91
+ const CODE_PATTERNS: RegExp[] = [
92
+ /[{}[\]()]/, // Brackets and parentheses
93
+ /[=><!&|]{2}/, // Double operators (==, !=, &&, ||, etc.)
94
+ /\w+\.\w+\(/, // Method calls (obj.method()
95
+ /\w+\s*=\s*\w+/, // Assignment
96
+ /\/\*[\s\S]*?\*\/|\/\/.*$/m, // Comments
97
+ /\$[a-zA-Z_][a-zA-Z0-9_]*/, // Shell/PHP variables
98
+ /@\w+/, // Decorators/annotations
99
+ ];
100
+
101
+ // ─── Technical Words (for density calculation) ───
102
+
103
+ const TECHNICAL_WORDS = new Set([
104
+ 'api', 'sdk', 'cli', 'gui', 'ui', 'ux', 'ide', 'editor', 'compiler', 'interpreter',
105
+ 'runtime', 'virtual', 'machine', 'container', 'image', 'build', 'deploy', 'release',
106
+ 'version', 'update', 'patch', 'bug', 'feature', 'enhancement', 'issue', 'ticket',
107
+ 'workflow', 'process', 'pipeline', 'automation', 'script', 'batch', 'cron', 'job',
108
+ 'service', 'microservice', 'monolith', 'architecture', 'pattern', 'design', 'system',
109
+ 'network', 'protocol', 'tcp', 'udp', 'http', 'https', 'ssl', 'tls', 'dns', 'cdn',
110
+ 'cache', 'redis', 'memcached', 'session', 'cookie', 'token', 'jwt', 'oauth', 'auth',
111
+ 'encrypt', 'decrypt', 'hash', 'salt', 'key', 'certificate', 'binary', 'buffer',
112
+ 'json', 'xml', 'yaml', 'toml', 'csv', 'markdown', 'html', 'css', 'regex', 'parser',
113
+ 'lexer', 'ast', 'ir', 'bytecode', 'jit', 'gc', 'heap', 'stack', 'memory', 'cpu',
114
+ 'thread', 'process', 'async', 'sync', 'concurrent', 'parallel', 'mutex', 'lock',
115
+ 'semaphore', 'deadlock', 'race', 'condition', 'atomic', 'volatile', 'immutable',
116
+ ]);
117
+
118
+ // ─── Main Filter Function ───
119
+
120
+ export interface SignificanceResult {
121
+ /** Whether the content is significant enough to store */
122
+ isSignificant: boolean;
123
+ /** Reason for the decision (for debugging/logging) */
124
+ reason: string;
125
+ /** Confidence score 0-1 (higher = more confident in decision) */
126
+ confidence: number;
127
+ }
128
+
129
+ /**
130
+ * Determine if content is significant enough to be stored as memory.
131
+ *
132
+ * @param content - The text content to evaluate
133
+ * @returns SignificanceResult with decision, reason, and confidence
134
+ */
135
+ export function isSignificantKnowledge(content: string): SignificanceResult {
136
+ if (!content || typeof content !== 'string') {
137
+ return { isSignificant: false, reason: 'empty_content', confidence: 1.0 };
138
+ }
139
+
140
+ const text = content.trim();
141
+ const textLower = text.toLowerCase();
142
+
143
+ // ─── Phase 1: Skip patterns (fast rejection) ───
144
+ for (const pattern of SKIP_PATTERNS) {
145
+ if (pattern.test(text)) {
146
+ return { isSignificant: false, reason: 'skip_pattern', confidence: 0.9 };
147
+ }
148
+ }
149
+
150
+ // ─── Phase 2: Technical patterns (fast acceptance) ───
151
+ for (const pattern of TECHNICAL_PATTERNS) {
152
+ if (pattern.test(text)) {
153
+ return { isSignificant: true, reason: 'technical_pattern', confidence: 0.85 };
154
+ }
155
+ }
156
+
157
+ // ─── Phase 3: Code-like patterns ───
158
+ let codePatternMatches = 0;
159
+ for (const pattern of CODE_PATTERNS) {
160
+ if (pattern.test(text)) {
161
+ codePatternMatches++;
162
+ }
163
+ }
164
+ if (codePatternMatches >= 2) {
165
+ return { isSignificant: true, reason: 'code_patterns', confidence: 0.75 };
166
+ }
167
+
168
+ // ─── Phase 4: Technical word density ───
169
+ const words = textLower.split(/\s+/).filter(w => w.length > 1);
170
+ if (words.length > 5) {
171
+ const technicalWordCount = words.filter(word =>
172
+ TECHNICAL_WORDS.has(word.replace(/[^\w]/g, ''))
173
+ ).length;
174
+ const density = technicalWordCount / words.length;
175
+
176
+ if (density > 0.15) {
177
+ return { isSignificant: true, reason: 'high_technical_density', confidence: 0.7 };
178
+ }
179
+ if (density > 0.08 && words.length > 20) {
180
+ return { isSignificant: true, reason: 'moderate_technical_density', confidence: 0.6 };
181
+ }
182
+ }
183
+
184
+ // ─── Phase 5: Length-based heuristic ───
185
+ // Longer content is more likely to be significant
186
+ if (text.length > 200) {
187
+ return { isSignificant: true, reason: 'substantial_length', confidence: 0.5 };
188
+ }
189
+
190
+ // ─── Default: not significant ───
191
+ return { isSignificant: false, reason: 'no_technical_indicators', confidence: 0.6 };
192
+ }
193
+
194
+ /**
195
+ * Check if content is a retrieved/search result that shouldn't be re-stored.
196
+ * Prevents memory pollution from search results being stored as new memories.
197
+ */
198
+ export function isRetrievedResult(content: string): boolean {
199
+ if (!content || typeof content !== 'string') return false;
200
+ const text = content.toLowerCase();
201
+
202
+ const retrievedPatterns = [
203
+ /^(memorix_search|memorix_detail|memorix_timeline|search_nodes|read_graph):/i,
204
+ /^(retrieved|result|results|found|matches|nodes|edges|search completed):/i,
205
+ /^(observation #\d+|stored observation|memory #\d+)/i,
206
+ /^(id:|timestamp:|similarity:|source:|type:)/i,
207
+ /^(totalresults:|searchtime:|tokens:)/i,
208
+ ];
209
+
210
+ for (const pattern of retrievedPatterns) {
211
+ if (pattern.test(text)) {
212
+ return true;
213
+ }
214
+ }
215
+
216
+ return false;
217
+ }
218
+
219
+ /**
220
+ * Quick check for trivial commands that should never be stored.
221
+ * Faster than full isSignificantKnowledge for common cases.
222
+ */
223
+ export function isTrivialCommand(command: string): boolean {
224
+ if (!command || typeof command !== 'string') return true;
225
+
226
+ const trivialPatterns = [
227
+ /^(ls|dir|cd|pwd|echo|cat|type|head|tail|wc|which|where|whoami)(\s|$)/i,
228
+ /^(Get-Content|Test-Path|Get-Item|Get-ChildItem|Set-Location|Write-Host)(\s|$)/i,
229
+ /^(git\s+(status|log|diff|show|branch|remote|stash\s+list))(\s|$)/i,
230
+ /^(npm\s+(list|ls|view|info|outdated))(\s|$)/i,
231
+ /^(pip\s+(list|show|freeze)|python\s+--?version|node\s+--?version)(\s|$)/i,
232
+ /^(env|printenv|set|export)(\s|$)/i,
233
+ /^(clear|cls|exit|quit)(\s|$)/i,
234
+ ];
235
+
236
+ const cmd = command.trim();
237
+
238
+ for (const pattern of trivialPatterns) {
239
+ if (pattern.test(cmd)) {
240
+ return true;
241
+ }
242
+ }
243
+
244
+ // Self-referential: inspecting memorix's own data files
245
+ if (/\.memorix[/\\]|observations\.json|memorix.*data/i.test(cmd)) {
246
+ return true;
247
+ }
248
+
249
+ return false;
250
+ }
@@ -41,6 +41,7 @@ export type AgentName =
41
41
  | 'hermes'
42
42
  | 'opencode'
43
43
  | 'trae'
44
+ | 'dsh'
44
45
  | 'pi'
45
46
  | 'omp';
46
47
 
@@ -61,6 +62,7 @@ export const AGENT_SUPPORT_TIER: Record<AgentName, SupportTier> = {
61
62
  hermes: 'community',
62
63
  opencode: 'community',
63
64
  trae: 'community',
65
+ dsh: 'community',
64
66
  pi: 'community',
65
67
  omp: 'community',
66
68
  antigravity: 'community',
@@ -150,6 +150,15 @@ export const MEMORIX_INTEGRATIONS: MemorixIntegration[] = [
150
150
  install: 'memorix setup --agent trae',
151
151
  surfaces: ['MCP', 'rules'],
152
152
  },
153
+ {
154
+ agent: 'dsh',
155
+ name: 'DeepSeek Harness',
156
+ entry: 'official-config',
157
+ status: 'ready',
158
+ install: 'memorix setup --agent dsh',
159
+ surfaces: ['MCP', 'AGENTS.md', 'skills'],
160
+ note: 'DeepSeek Harness support writes a @deepseek-ai/dsh-mcp-client row into $DSH_HOME/cordis.patch.yml (default ~/.dsh/cordis.patch.yml), guidance into the harness AGENTS.md, and skills under $DSH_HOME/skills.',
161
+ },
153
162
  {
154
163
  agent: 'memcode',
155
164
  name: 'memcode',