recallnest 2.3.0 → 2.5.4

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 (221) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/README.md +17 -31
  3. package/README_CN.md +12 -22
  4. package/assets/ui/app.js +1031 -0
  5. package/assets/ui/index.html +224 -0
  6. package/assets/ui/styles.css +781 -0
  7. package/config.json.example +4 -1
  8. package/docs/api-reference.md +1291 -0
  9. package/docs/architecture.md +168 -0
  10. package/docs/connector-spec.md +126 -0
  11. package/eval/cases-canary.json +58 -0
  12. package/eval/cases-scope-robustness.json +278 -0
  13. package/eval/cases.json +117 -20
  14. package/package.json +22 -1
  15. package/src/__tests__/access-tracker-novelty.test.ts +238 -0
  16. package/src/__tests__/activity-counter.test.ts +125 -0
  17. package/src/__tests__/adaptive-fidelity.test.ts +102 -0
  18. package/src/__tests__/admission-control.test.ts +206 -0
  19. package/src/__tests__/anchor-generator.test.ts +67 -0
  20. package/src/__tests__/auto-consolidation.test.ts +168 -0
  21. package/src/__tests__/auto-recall.test.ts +131 -0
  22. package/src/__tests__/babel-integration.test.ts +144 -0
  23. package/src/__tests__/batch-dedup.test.ts +65 -0
  24. package/src/__tests__/canary-eval.test.ts +114 -0
  25. package/src/__tests__/capture-engine.test.ts +1238 -0
  26. package/src/__tests__/capture-heuristic.test.ts +171 -0
  27. package/src/__tests__/cascade-forget.test.ts +210 -0
  28. package/src/__tests__/category-min-scores.test.ts +33 -0
  29. package/src/__tests__/cc8-cc1-essential-context.test.ts +298 -0
  30. package/src/__tests__/circuit-breaker.test.ts +99 -0
  31. package/src/__tests__/cluster-consolidation.test.ts +782 -0
  32. package/src/__tests__/confidence-metadata.test.ts +125 -0
  33. package/src/__tests__/confidence-tracker.test.ts +261 -0
  34. package/src/__tests__/conflict-advisor.test.ts +206 -0
  35. package/src/__tests__/conflict-escalation.test.ts +149 -0
  36. package/src/__tests__/conflict-lifecycle.test.ts +83 -0
  37. package/src/__tests__/conflict-output.test.ts +85 -0
  38. package/src/__tests__/conflict-store.test.ts +374 -0
  39. package/src/__tests__/connector-v1.test.ts +181 -0
  40. package/src/__tests__/consolidation-engine.test.ts +333 -0
  41. package/src/__tests__/constructive-retrieval.test.ts +509 -0
  42. package/src/__tests__/context-collapse-renderer.test.ts +214 -0
  43. package/src/__tests__/context-composer-pins.test.ts +64 -0
  44. package/src/__tests__/context-composer-task-selection.test.ts +24 -0
  45. package/src/__tests__/context-reconstructor.test.ts +65 -0
  46. package/src/__tests__/context-renderer.test.ts +91 -0
  47. package/src/__tests__/continuity-eval.test.ts +275 -0
  48. package/src/__tests__/continuity-schema.test.ts +97 -0
  49. package/src/__tests__/contracts.test.ts +216 -0
  50. package/src/__tests__/conversation-importer.test.ts +692 -0
  51. package/src/__tests__/core-recall-eval.test.ts +235 -0
  52. package/src/__tests__/core-summary.test.ts +109 -0
  53. package/src/__tests__/data-checkup.test.ts +276 -0
  54. package/src/__tests__/decay-exemption.test.ts +84 -0
  55. package/src/__tests__/dedup-actions.test.ts +58 -0
  56. package/src/__tests__/dedup-guard.test.ts +39 -0
  57. package/src/__tests__/deterministic-id.test.ts +39 -0
  58. package/src/__tests__/distill-lock.test.ts +305 -0
  59. package/src/__tests__/distill-session-argshape.test.ts +79 -0
  60. package/src/__tests__/doctor.test.ts +319 -0
  61. package/src/__tests__/dream-pipeline.test.ts +321 -0
  62. package/src/__tests__/drill-down.test.ts +108 -0
  63. package/src/__tests__/embedder.test.ts +122 -0
  64. package/src/__tests__/emotion-decay.test.ts +46 -0
  65. package/src/__tests__/emotion-detector.test.ts +56 -0
  66. package/src/__tests__/emotion-phase1-integration.test.ts +153 -0
  67. package/src/__tests__/emotion-retrieval.test.ts +56 -0
  68. package/src/__tests__/entity-resolver.test.ts +58 -0
  69. package/src/__tests__/env-config.test.ts +151 -0
  70. package/src/__tests__/error-signature-boost.test.ts +87 -0
  71. package/src/__tests__/error-signature.test.ts +95 -0
  72. package/src/__tests__/error-taxonomy.test.ts +129 -0
  73. package/src/__tests__/ethics-layer.test.ts +476 -0
  74. package/src/__tests__/event-segmenter.test.ts +153 -0
  75. package/src/__tests__/feature-flags-integration.test.ts +54 -0
  76. package/src/__tests__/frequency-tracker.test.ts +113 -0
  77. package/src/__tests__/graph-export.test.ts +489 -0
  78. package/src/__tests__/hotness-blend.test.ts +76 -0
  79. package/src/__tests__/ingest-chunking.test.ts +44 -0
  80. package/src/__tests__/ingest.test.ts +360 -0
  81. package/src/__tests__/interference-detector.test.ts +203 -0
  82. package/src/__tests__/kg-extractor.test.ts +192 -0
  83. package/src/__tests__/kg-store.test.ts +300 -0
  84. package/src/__tests__/llm-consolidation.test.ts +226 -0
  85. package/src/__tests__/maintenance-locks.test.ts +174 -0
  86. package/src/__tests__/mcp-efficiency.test.ts +288 -0
  87. package/src/__tests__/mcp-related-scopes.test.ts +151 -0
  88. package/src/__tests__/memory-boundaries.test.ts +250 -0
  89. package/src/__tests__/memory-evolution-b2-b3-e1.test.ts +345 -0
  90. package/src/__tests__/memory-evolution.test.ts +271 -0
  91. package/src/__tests__/memory-health-rebalance.test.ts +144 -0
  92. package/src/__tests__/memory-lint.test.ts +421 -0
  93. package/src/__tests__/memory-output.test.ts +215 -0
  94. package/src/__tests__/memory-promotion.test.ts +315 -0
  95. package/src/__tests__/migrate-dedup-ids.test.ts +65 -0
  96. package/src/__tests__/multi-vector.test.ts +242 -0
  97. package/src/__tests__/narrative-architecture.test.ts +456 -0
  98. package/src/__tests__/noise-filter.test.ts +205 -0
  99. package/src/__tests__/obsidian-connector.test.ts +363 -0
  100. package/src/__tests__/omitted-reporting.test.ts +98 -0
  101. package/src/__tests__/pending-review.test.ts +77 -0
  102. package/src/__tests__/pii-redact.test.ts +314 -0
  103. package/src/__tests__/post-retrieval-filter.test.ts +178 -0
  104. package/src/__tests__/ppr-traversal.test.ts +256 -0
  105. package/src/__tests__/prediction-engine.test.ts +349 -0
  106. package/src/__tests__/predictive-prospective-memory.test.ts +416 -0
  107. package/src/__tests__/preference-guard-smoke.test.ts +211 -0
  108. package/src/__tests__/preference-matcher.test.ts +230 -0
  109. package/src/__tests__/preference-slots.test.ts +205 -0
  110. package/src/__tests__/prospective-memory.test.ts +283 -0
  111. package/src/__tests__/query-entity-detector.test.ts +171 -0
  112. package/src/__tests__/query-expander-alias.test.ts +146 -0
  113. package/src/__tests__/query-expander.test.ts +34 -0
  114. package/src/__tests__/recall-governor.test.ts +227 -0
  115. package/src/__tests__/recall-mode.test.ts +64 -0
  116. package/src/__tests__/result-synthesizer.test.ts +198 -0
  117. package/src/__tests__/resume-context.test.ts +4898 -0
  118. package/src/__tests__/retrieval-trace.test.ts +213 -0
  119. package/src/__tests__/retriever-boundary-weight.test.ts +136 -0
  120. package/src/__tests__/retroactive-boost.test.ts +223 -0
  121. package/src/__tests__/salience-scoring.test.ts +106 -0
  122. package/src/__tests__/scope-inventory.test.ts +200 -0
  123. package/src/__tests__/scope-policy.test.ts +69 -0
  124. package/src/__tests__/scope-suggester.test.ts +80 -0
  125. package/src/__tests__/session-checkpoint.test.ts +291 -0
  126. package/src/__tests__/session-distiller.test.ts +640 -0
  127. package/src/__tests__/session-gc.test.ts +215 -0
  128. package/src/__tests__/skill-engine.test.ts +552 -0
  129. package/src/__tests__/skill-promotion.test.ts +601 -0
  130. package/src/__tests__/skill-verifier.test.ts +122 -0
  131. package/src/__tests__/source-heartbeat.test.ts +250 -0
  132. package/src/__tests__/store-patch-metadata.test.ts +205 -0
  133. package/src/__tests__/store-scope-audit.test.ts +81 -0
  134. package/src/__tests__/store-upsert.test.ts +184 -0
  135. package/src/__tests__/supersede-chain.test.ts +154 -0
  136. package/src/__tests__/temporal-parser.test.ts +241 -0
  137. package/src/__tests__/temporal-validity.test.ts +160 -0
  138. package/src/__tests__/term-registry.test.ts +121 -0
  139. package/src/__tests__/tool-error-surfacing.test.ts +98 -0
  140. package/src/__tests__/tool-output-compressor.test.ts +160 -0
  141. package/src/__tests__/topic-tag.test.ts +113 -0
  142. package/src/__tests__/trusted-memory.test.ts +839 -0
  143. package/src/__tests__/usage-tracker.test.ts +287 -0
  144. package/src/__tests__/version-manager.test.ts +213 -0
  145. package/src/__tests__/workflow-observation-skill-outcome.test.ts +352 -0
  146. package/src/__tests__/workflow-observation.test.ts +433 -0
  147. package/src/__tests__/write-verifier.test.ts +122 -0
  148. package/src/access-tracker.ts +38 -32
  149. package/src/activity-counter.ts +46 -18
  150. package/src/aliases.ts +133 -0
  151. package/src/api-server.ts +27 -7
  152. package/src/audit-log.ts +4 -2
  153. package/src/auto-consolidation.ts +8 -3
  154. package/src/auto-gc.ts +85 -21
  155. package/src/capture-engine.ts +54 -21
  156. package/src/cli.ts +169 -37
  157. package/src/confidence-tracker.ts +36 -18
  158. package/src/consolidation-engine.ts +109 -11
  159. package/src/context-composer.ts +8 -1
  160. package/src/data-checkup.ts +95 -6
  161. package/src/distill-lock.ts +194 -15
  162. package/src/doctor.ts +9 -2
  163. package/src/dream-pipeline.ts +118 -34
  164. package/src/env-config.ts +77 -0
  165. package/src/error-signature.ts +153 -0
  166. package/src/error-taxonomy.ts +115 -0
  167. package/src/eval.ts +251 -6
  168. package/src/idempotency.ts +8 -0
  169. package/src/ingest.ts +31 -10
  170. package/src/kg-extractor.ts +6 -2
  171. package/src/kg-store.ts +236 -44
  172. package/src/llm-consolidation.ts +2 -1
  173. package/src/mcp-server.ts +85 -1799
  174. package/src/mcp-tool-deps.ts +48 -0
  175. package/src/mcp-tools-advanced.ts +941 -0
  176. package/src/mcp-tools-core.ts +633 -0
  177. package/src/mcp-tools-governance.ts +475 -0
  178. package/src/memory-boundaries.ts +3 -1
  179. package/src/memory-evolution.ts +73 -1
  180. package/src/memory-lint.ts +183 -10
  181. package/src/memory-output.ts +114 -3
  182. package/src/memory-promotion.ts +246 -0
  183. package/src/memory-schema.ts +25 -2
  184. package/src/memory-store-port.ts +43 -0
  185. package/src/multi-vector.ts +2 -1
  186. package/src/narrative-schema.ts +2 -1
  187. package/src/noise-filter.ts +57 -6
  188. package/src/pii-detector.ts +157 -5
  189. package/src/query-expander.ts +90 -9
  190. package/src/result-synthesizer.ts +2 -1
  191. package/src/retention-policy.ts +2 -1
  192. package/src/retriever.ts +259 -139
  193. package/src/runtime-config.ts +8 -1
  194. package/src/scope-suggester.ts +113 -0
  195. package/src/session-distiller.ts +23 -2
  196. package/src/session-engine.ts +2 -1
  197. package/src/session-schema.ts +1 -0
  198. package/src/session-store.ts +5 -0
  199. package/src/skill-engine.ts +78 -0
  200. package/src/skill-promotion.ts +247 -47
  201. package/src/skill-schema.ts +16 -3
  202. package/src/skill-verifier.ts +152 -0
  203. package/src/store.ts +267 -38
  204. package/src/tool-output-compressor.ts +3 -1
  205. package/src/ui-server.ts +2 -1
  206. package/src/usage-tracker.ts +242 -0
  207. package/src/version-manager.ts +3 -2
  208. package/src/workflow-observation-engine.ts +2 -1
  209. package/src/workflow-observation-schema.ts +2 -1
  210. package/src/workflow-observation-store.ts +6 -2
  211. package/.env +0 -4
  212. package/CLAUDE.md +0 -46
  213. package/config.json +0 -55
  214. package/daily-recall.sh +0 -110
  215. package/logs/daily-recall.error.log +0 -0
  216. package/logs/daily-recall.log +0 -60
  217. package/logs/ingest-2026-04-11.log +0 -110
  218. package/logs/ingest-2026-04-12.log +0 -90
  219. package/logs/ingest-2026-04-13.log +0 -87
  220. package/logs/launchagent-stderr.log +0 -0
  221. package/logs/launchagent-stdout.log +0 -0
package/assets/ui/index.html ADDED
@@ -0,0 +1,224 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>RecallNest</title>
7
+ <link rel="stylesheet" href="/ui/styles.css" />
8
+ </head>
9
+ <body>
10
+ <div class="page-shell">
11
+ <header class="hero">
12
+ <div>
13
+ <p class="eyebrow">RecallNest</p>
14
+ <h1>Shared memory layer workbench.</h1>
15
+ <p class="subtitle">Search, distill, pin, import, skills.</p>
16
+ </div>
17
+ <div class="hero-badge">
18
+ <span>38 MCP Tools</span>
19
+ <span>6-Channel Hybrid</span>
20
+ <span>KG + PPR</span>
21
+ <span>1168 Tests</span>
22
+ </div>
23
+ </header>
24
+
25
+ <section class="brand-strip">
26
+ <button class="brand-card quick-card" data-quick-action="search">
27
+ <strong>Search</strong>
28
+ <span>hybrid recall</span>
29
+ </button>
30
+ <button class="brand-card quick-card" data-quick-action="distill">
31
+ <strong>Distill</strong>
32
+ <span>build a briefing</span>
33
+ </button>
34
+ <button class="brand-card quick-card" data-quick-action="skills">
35
+ <strong>Skills</strong>
36
+ <span>executable patterns</span>
37
+ </button>
38
+ <button class="brand-card quick-card" data-quick-action="pin">
39
+ <strong>Pin</strong>
40
+ <span>jump to pin flow</span>
41
+ </button>
42
+ </section>
43
+
44
+ <main class="workspace">
45
+ <section id="dashboardView" class="dashboard-view card">
46
+ <div class="section-head">
47
+ <h2>Memory Dashboard</h2>
48
+ <button id="refreshDashboard" class="ghost-button">Refresh</button>
49
+ </div>
50
+
51
+ <div class="dash-stats-row" id="dashStatsRow">
52
+ <div class="stat-card">
53
+ <span class="stat-value" id="dashTotal">-</span>
54
+ <span class="stat-label">Total Memories</span>
55
+ </div>
56
+ <div class="stat-card">
57
+ <span class="stat-value" id="dashHealth">-</span>
58
+ <span class="stat-label">Health Score</span>
59
+ </div>
60
+ <div class="stat-card">
61
+ <span class="stat-value" id="dashWeek">-</span>
62
+ <span class="stat-label">This Week</span>
63
+ </div>
64
+ <div class="stat-card">
65
+ <span class="stat-value" id="dashMonth">-</span>
66
+ <span class="stat-label">This Month</span>
67
+ </div>
68
+ </div>
69
+
70
+ <div class="dash-grid">
71
+ <div class="dash-panel">
72
+ <h3>Category Distribution</h3>
73
+ <div id="dashCategoryBars" class="category-bars"></div>
74
+ </div>
75
+ <div class="dash-panel">
76
+ <h3>Lint Summary</h3>
77
+ <div id="dashLintSummary" class="lint-summary">Loading...</div>
78
+ </div>
79
+ </div>
80
+
81
+ <div class="dash-panel full-width">
82
+ <h3>Stale Memories <span id="dashStaleCount" class="badge">0</span></h3>
83
+ <div id="dashStaleList" class="stale-list">Loading...</div>
84
+ </div>
85
+ </section>
86
+
87
+ <section class="control-panel card is-hidden" id="searchView">
88
+ <div class="section-head">
89
+ <h2>Query Console</h2>
90
+ <button id="statsButton" class="ghost-button">Refresh Stats</button>
91
+ </div>
92
+
93
+ <div class="view-switch" id="viewSwitch">
94
+ <button class="view-tab is-active" data-view="dashboard">Dashboard</button>
95
+ <button class="view-tab" data-view="search">Search</button>
96
+ <button class="view-tab" data-view="skills">Skills</button>
97
+ <button class="view-tab" data-view="pins">Assets</button>
98
+ <button class="view-tab" data-view="exports">Exports</button>
99
+ </div>
100
+
101
+ <label class="field">
102
+ <span>Query</span>
103
+ <textarea id="queryInput" rows="4" placeholder="telegram bridge, OpenClaw memory, writing style..."></textarea>
104
+ </label>
105
+
106
+ <div class="grid two-up">
107
+ <label class="field">
108
+ <span>Profile</span>
109
+ <select id="profileInput">
110
+ <option value="default">default</option>
111
+ <option value="writing">writing</option>
112
+ <option value="debug">debug</option>
113
+ <option value="fact-check">fact-check</option>
114
+ </select>
115
+ </label>
116
+ <label class="field">
117
+ <span>Scope</span>
118
+ <input id="scopeInput" type="text" placeholder="cc / codex / gemini / memory / asset" />
119
+ </label>
120
+ </div>
121
+
122
+ <div class="grid three-up">
123
+ <label class="field">
124
+ <span>Topic Tag</span>
125
+ <select id="topicTagInput">
126
+ <option value="">all topics</option>
127
+ <option value="auth">auth</option>
128
+ <option value="deploy">deploy</option>
129
+ <option value="infra">infra</option>
130
+ <option value="testing">testing</option>
131
+ <option value="database">database</option>
132
+ <option value="api">api</option>
133
+ <option value="ui">ui</option>
134
+ <option value="perf">perf</option>
135
+ <option value="security">security</option>
136
+ <option value="memory">memory</option>
137
+ <option value="mcp">mcp</option>
138
+ <option value="llm">llm</option>
139
+ <option value="config">config</option>
140
+ <option value="data">data</option>
141
+ <option value="docs">docs</option>
142
+ </select>
143
+ </label>
144
+ <label class="field">
145
+ <span>Limit</span>
146
+ <input id="limitInput" type="number" value="5" min="1" max="20" />
147
+ </label>
148
+ <label class="field">
149
+ <span>Export Format</span>
150
+ <select id="formatInput">
151
+ <option value="md">md</option>
152
+ <option value="json">json</option>
153
+ </select>
154
+ </label>
155
+ </div>
156
+
157
+ <div class="action-row">
158
+ <button data-mode="search" class="action-button primary">Search</button>
159
+ <button data-mode="explain" class="action-button">Explain</button>
160
+ <button data-mode="distill" class="action-button">Distill</button>
161
+ <button id="briefButton" class="action-button">Brief</button>
162
+ <button id="exportButton" class="action-button accent">Export</button>
163
+ </div>
164
+
165
+ <p id="statusLine" class="status-line">Ready.</p>
166
+ </section>
167
+
168
+ <section class="result-panel card is-hidden" id="resultView">
169
+ <div class="section-head">
170
+ <h2 id="resultTitle">Result Surface</h2>
171
+ <button id="reloadPinsButton" class="ghost-button">Load Assets</button>
172
+ </div>
173
+ <div id="viewToolbar" class="view-toolbar is-hidden">
174
+ <input id="viewFilterInput" type="text" placeholder="Filter current view..." />
175
+ <div id="assetTagBar" class="tag-bar is-hidden"></div>
176
+ <div id="assetOpsBar" class="ops-bar is-hidden">
177
+ <span id="dirtyBriefCount" class="ops-copy">Dirty briefs: 0</span>
178
+ <button id="cleanDirtyBriefsButton" class="ghost-button">Archive Dirty Briefs</button>
179
+ </div>
180
+ </div>
181
+ <div id="resultMeta" class="result-meta">Run a query to populate structured cards.</div>
182
+ <div id="artifactBar" class="artifact-bar"></div>
183
+ <div id="resultCards" class="result-cards"></div>
184
+ </section>
185
+
186
+ <section class="side-panel card is-hidden" id="sideView">
187
+ <div class="section-head">
188
+ <h2>Recall Actions</h2>
189
+ </div>
190
+
191
+ <label class="field">
192
+ <span>Memory ID</span>
193
+ <input id="pinMemoryId" type="text" placeholder="Click a result card or paste a short ID" />
194
+ </label>
195
+ <label class="field">
196
+ <span>Optional Title</span>
197
+ <input id="pinTitle" type="text" placeholder="Leave blank to auto-title" />
198
+ </label>
199
+ <button id="pinButton" class="action-button primary full-width">Pin Selected Memory</button>
200
+
201
+ <div class="section-head compact">
202
+ <h3>Trace Output</h3>
203
+ <button id="toggleTraceButton" class="ghost-button">Expand</button>
204
+ </div>
205
+ <pre id="resultOutput" class="mini-output tall is-collapsed">Run a search to see the raw trace.</pre>
206
+
207
+ <div class="section-head compact">
208
+ <h3>Index Stats</h3>
209
+ <button id="toggleStatsButton" class="ghost-button">Expand</button>
210
+ </div>
211
+ <pre id="statsOutput" class="mini-output is-collapsed">Loading stats...</pre>
212
+
213
+ <div class="section-head compact">
214
+ <h3>Memory Assets</h3>
215
+ <button id="togglePinsButton" class="ghost-button">Expand</button>
216
+ </div>
217
+ <pre id="pinsOutput" class="mini-output is-collapsed">No assets loaded yet.</pre>
218
+ </section>
219
+ </main>
220
+ </div>
221
+
222
+ <script type="module" src="/ui/app.js"></script>
223
+ </body>
224
+ </html>