recallnest 3.0.0 → 4.0.0

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 (246) hide show
  1. package/CHANGELOG.md +304 -0
  2. package/README.md +251 -258
  3. package/README_CN.md +226 -247
  4. package/assets/ui/app.js +6 -1
  5. package/bin/recallnest.mjs +20 -37
  6. package/docs/api-reference.md +8 -0
  7. package/docs/architecture.md +18 -13
  8. package/eval/cases-canary.json +107 -9
  9. package/integrations/examples/claude-agent-sdk/memory-agent.ts +2 -0
  10. package/integrations/examples/langchain/memory-chain.py +4 -0
  11. package/integrations/examples/openai-agents-sdk/memory-agent.py +4 -0
  12. package/package.json +12 -3
  13. package/src/activity-counter.ts +1 -0
  14. package/src/adaptive-retrieval.ts +23 -0
  15. package/src/api-server.ts +13 -11
  16. package/src/asset-sync.ts +26 -2
  17. package/src/audit-log.ts +2 -0
  18. package/src/auto-gc.ts +4 -3
  19. package/src/belief-history.ts +137 -31
  20. package/src/capture-engine.ts +459 -71
  21. package/src/cascade-forget.ts +7 -3
  22. package/src/checkpoint-mirror.ts +417 -0
  23. package/src/cli.ts +574 -54
  24. package/src/conflict-engine.ts +43 -15
  25. package/src/consolidation-engine.ts +24 -3
  26. package/src/context-collapse-renderer.ts +8 -1
  27. package/src/context-composer-stable.ts +5 -1
  28. package/src/context-composer.ts +11 -2
  29. package/src/distill-lock.ts +246 -74
  30. package/src/dream-pipeline.ts +3 -1
  31. package/src/embedder.ts +24 -0
  32. package/src/env-config.ts +136 -0
  33. package/src/flock.ts +97 -0
  34. package/src/forget-engine.ts +342 -58
  35. package/src/gateway-server.ts +4 -0
  36. package/src/ingest-plan.ts +56 -0
  37. package/src/ingest.ts +294 -121
  38. package/src/kg-contradiction.ts +753 -0
  39. package/src/kg-extractor.ts +17 -0
  40. package/src/kg-store.ts +1 -1
  41. package/src/known-item-eval.ts +455 -0
  42. package/src/llm-client.ts +13 -26
  43. package/src/llm-consolidation.ts +2 -2
  44. package/src/mcp-tool-deps.ts +6 -0
  45. package/src/mcp-tools-advanced.ts +80 -45
  46. package/src/mcp-tools-core.ts +23 -17
  47. package/src/mcp-tools-governance.ts +13 -7
  48. package/src/memory-assets.ts +144 -8
  49. package/src/memory-boundaries.ts +19 -0
  50. package/src/memory-evolution.ts +9 -0
  51. package/src/memory-lint.ts +1 -1
  52. package/src/memory-output.ts +311 -14
  53. package/src/memory-reconcile.ts +1437 -0
  54. package/src/memory-schema.ts +11 -0
  55. package/src/memory-store-port.ts +1 -0
  56. package/src/minis-archive.ts +151 -0
  57. package/src/noise-filter.ts +15 -2
  58. package/src/pii-detector.ts +31 -1
  59. package/src/pivot-apply.ts +55 -5
  60. package/src/pivot-evidence.ts +128 -0
  61. package/src/ppr-traversal.ts +25 -1
  62. package/src/preference-matcher.ts +40 -28
  63. package/src/prospective-memory.ts +7 -4
  64. package/src/retriever.ts +297 -57
  65. package/src/retroactive-boost.ts +3 -2
  66. package/src/runtime-config.ts +15 -1
  67. package/src/scope-policy.ts +1 -0
  68. package/src/session-distiller.ts +6 -2
  69. package/src/session-engine.ts +11 -4
  70. package/src/session-output.ts +20 -1
  71. package/src/session-schema.ts +5 -2
  72. package/src/session-store.ts +59 -12
  73. package/src/skill-promotion.ts +67 -1
  74. package/src/store-receipts.ts +109 -0
  75. package/src/store-write-budget.ts +37 -0
  76. package/src/store.ts +298 -57
  77. package/src/text-fingerprint.ts +25 -0
  78. package/src/trigger-store.ts +443 -0
  79. package/src/ui-server.ts +22 -21
  80. package/src/version-manager.ts +19 -5
  81. package/src/write-verifier.ts +16 -11
  82. package/src/__tests__/access-tracker-novelty.test.ts +0 -324
  83. package/src/__tests__/activity-counter.test.ts +0 -125
  84. package/src/__tests__/adaptive-fidelity.test.ts +0 -102
  85. package/src/__tests__/admission-control.test.ts +0 -206
  86. package/src/__tests__/age-label.test.ts +0 -33
  87. package/src/__tests__/anchor-generator.test.ts +0 -67
  88. package/src/__tests__/api-server-security.test.ts +0 -102
  89. package/src/__tests__/auto-consolidation.test.ts +0 -168
  90. package/src/__tests__/auto-recall.test.ts +0 -131
  91. package/src/__tests__/babel-integration.test.ts +0 -144
  92. package/src/__tests__/batch-dedup.test.ts +0 -65
  93. package/src/__tests__/belief-history.test.ts +0 -220
  94. package/src/__tests__/canary-eval.test.ts +0 -114
  95. package/src/__tests__/capture-engine.test.ts +0 -1328
  96. package/src/__tests__/capture-heuristic.test.ts +0 -171
  97. package/src/__tests__/cascade-forget.test.ts +0 -210
  98. package/src/__tests__/category-min-scores.test.ts +0 -116
  99. package/src/__tests__/cc8-cc1-essential-context.test.ts +0 -298
  100. package/src/__tests__/circuit-breaker.test.ts +0 -99
  101. package/src/__tests__/cluster-consolidation.test.ts +0 -1236
  102. package/src/__tests__/confidence-metadata.test.ts +0 -125
  103. package/src/__tests__/confidence-tracker.test.ts +0 -261
  104. package/src/__tests__/conflict-advisor.test.ts +0 -206
  105. package/src/__tests__/conflict-escalation.test.ts +0 -149
  106. package/src/__tests__/conflict-lifecycle.test.ts +0 -83
  107. package/src/__tests__/conflict-output.test.ts +0 -85
  108. package/src/__tests__/conflict-store.test.ts +0 -418
  109. package/src/__tests__/connector-v1.test.ts +0 -181
  110. package/src/__tests__/consolidation-engine.test.ts +0 -520
  111. package/src/__tests__/constructive-retrieval.test.ts +0 -509
  112. package/src/__tests__/context-collapse-renderer.test.ts +0 -214
  113. package/src/__tests__/context-composer-pins.test.ts +0 -64
  114. package/src/__tests__/context-composer-task-selection.test.ts +0 -24
  115. package/src/__tests__/context-reconstructor.test.ts +0 -65
  116. package/src/__tests__/context-renderer.test.ts +0 -91
  117. package/src/__tests__/continuity-eval.test.ts +0 -275
  118. package/src/__tests__/continuity-schema.test.ts +0 -97
  119. package/src/__tests__/contracts.test.ts +0 -262
  120. package/src/__tests__/conversation-importer.test.ts +0 -692
  121. package/src/__tests__/core-recall-eval.test.ts +0 -235
  122. package/src/__tests__/core-summary.test.ts +0 -109
  123. package/src/__tests__/data-checkup.test.ts +0 -304
  124. package/src/__tests__/decay-exemption.test.ts +0 -129
  125. package/src/__tests__/dedup-actions.test.ts +0 -58
  126. package/src/__tests__/dedup-guard.test.ts +0 -39
  127. package/src/__tests__/deterministic-id.test.ts +0 -39
  128. package/src/__tests__/distill-lock.test.ts +0 -305
  129. package/src/__tests__/distill-session-argshape.test.ts +0 -79
  130. package/src/__tests__/doctor.test.ts +0 -319
  131. package/src/__tests__/dream-pipeline.test.ts +0 -820
  132. package/src/__tests__/dream-scope-isolation.test.ts +0 -386
  133. package/src/__tests__/dream-write-batching.test.ts +0 -211
  134. package/src/__tests__/drill-down.test.ts +0 -108
  135. package/src/__tests__/embedder.test.ts +0 -122
  136. package/src/__tests__/emotion-decay.test.ts +0 -46
  137. package/src/__tests__/emotion-detector.test.ts +0 -56
  138. package/src/__tests__/emotion-phase1-integration.test.ts +0 -153
  139. package/src/__tests__/emotion-retrieval.test.ts +0 -56
  140. package/src/__tests__/entity-resolver.test.ts +0 -58
  141. package/src/__tests__/env-config-invariant.test.ts +0 -80
  142. package/src/__tests__/env-config.test.ts +0 -211
  143. package/src/__tests__/error-signature-boost.test.ts +0 -87
  144. package/src/__tests__/error-signature.test.ts +0 -95
  145. package/src/__tests__/error-taxonomy.test.ts +0 -129
  146. package/src/__tests__/ethics-layer.test.ts +0 -476
  147. package/src/__tests__/event-segmenter.test.ts +0 -153
  148. package/src/__tests__/feature-flags-integration.test.ts +0 -54
  149. package/src/__tests__/frequency-tracker.test.ts +0 -113
  150. package/src/__tests__/freshness.test.ts +0 -186
  151. package/src/__tests__/graph-export.test.ts +0 -489
  152. package/src/__tests__/hotness-blend.test.ts +0 -283
  153. package/src/__tests__/ingest-chunking.test.ts +0 -44
  154. package/src/__tests__/ingest-scope-prefix.test.ts +0 -69
  155. package/src/__tests__/ingest.test.ts +0 -360
  156. package/src/__tests__/interference-detector.test.ts +0 -203
  157. package/src/__tests__/kg-extractor.test.ts +0 -192
  158. package/src/__tests__/kg-store.test.ts +0 -300
  159. package/src/__tests__/llm-client-pivot.test.ts +0 -628
  160. package/src/__tests__/llm-consolidation.test.ts +0 -226
  161. package/src/__tests__/maintenance-locks.test.ts +0 -197
  162. package/src/__tests__/mcp-efficiency.test.ts +0 -288
  163. package/src/__tests__/mcp-related-scopes.test.ts +0 -151
  164. package/src/__tests__/memory-boundaries.test.ts +0 -282
  165. package/src/__tests__/memory-evolution-b2-b3-e1.test.ts +0 -362
  166. package/src/__tests__/memory-evolution.test.ts +0 -271
  167. package/src/__tests__/memory-health-rebalance.test.ts +0 -144
  168. package/src/__tests__/memory-lint.test.ts +0 -421
  169. package/src/__tests__/memory-output.test.ts +0 -224
  170. package/src/__tests__/memory-promotion.test.ts +0 -315
  171. package/src/__tests__/memory-utility.test.ts +0 -256
  172. package/src/__tests__/migrate-dedup-ids.test.ts +0 -65
  173. package/src/__tests__/multi-vector.test.ts +0 -242
  174. package/src/__tests__/narrative-architecture.test.ts +0 -456
  175. package/src/__tests__/noise-filter.test.ts +0 -205
  176. package/src/__tests__/noise-prototype-bank.test.ts +0 -280
  177. package/src/__tests__/obsidian-connector.test.ts +0 -363
  178. package/src/__tests__/omitted-reporting.test.ts +0 -98
  179. package/src/__tests__/openai-contract.test.ts +0 -513
  180. package/src/__tests__/pending-review.test.ts +0 -77
  181. package/src/__tests__/pii-redact.test.ts +0 -333
  182. package/src/__tests__/pivot-apply.test.ts +0 -373
  183. package/src/__tests__/pivot-distill-supervisor.test.ts +0 -457
  184. package/src/__tests__/pivot-distill.test.ts +0 -1178
  185. package/src/__tests__/post-retrieval-filter.test.ts +0 -178
  186. package/src/__tests__/ppr-traversal.test.ts +0 -256
  187. package/src/__tests__/prediction-engine.test.ts +0 -349
  188. package/src/__tests__/predictive-prospective-memory.test.ts +0 -416
  189. package/src/__tests__/preference-guard-smoke.test.ts +0 -211
  190. package/src/__tests__/preference-matcher.test.ts +0 -282
  191. package/src/__tests__/preference-slots.test.ts +0 -205
  192. package/src/__tests__/promotion-distinct-sources.test.ts +0 -162
  193. package/src/__tests__/prospective-memory.test.ts +0 -283
  194. package/src/__tests__/pull-from-macbook-sync-only.test.ts +0 -679
  195. package/src/__tests__/query-entity-detector.test.ts +0 -171
  196. package/src/__tests__/query-expander-alias.test.ts +0 -146
  197. package/src/__tests__/query-expander.test.ts +0 -34
  198. package/src/__tests__/recall-gate.test.ts +0 -266
  199. package/src/__tests__/recall-governor.test.ts +0 -227
  200. package/src/__tests__/recall-mode.test.ts +0 -64
  201. package/src/__tests__/resolve-db-path.test.ts +0 -130
  202. package/src/__tests__/resolve-tier.test.ts +0 -64
  203. package/src/__tests__/result-synthesizer.test.ts +0 -198
  204. package/src/__tests__/resume-context.test.ts +0 -4898
  205. package/src/__tests__/retrieval-eval.test.ts +0 -163
  206. package/src/__tests__/retrieval-trace.test.ts +0 -213
  207. package/src/__tests__/retrieve-audit-revision.test.ts +0 -255
  208. package/src/__tests__/retriever-boundary-weight.test.ts +0 -136
  209. package/src/__tests__/retriever-lazy-init-dispatch.test.ts +0 -123
  210. package/src/__tests__/retroactive-boost.test.ts +0 -223
  211. package/src/__tests__/salience-scoring.test.ts +0 -106
  212. package/src/__tests__/scope-inventory.test.ts +0 -200
  213. package/src/__tests__/scope-policy.test.ts +0 -69
  214. package/src/__tests__/scope-suggester.test.ts +0 -80
  215. package/src/__tests__/session-checkpoint.test.ts +0 -291
  216. package/src/__tests__/session-distiller.test.ts +0 -640
  217. package/src/__tests__/session-gc.test.ts +0 -215
  218. package/src/__tests__/skill-engine.test.ts +0 -552
  219. package/src/__tests__/skill-promotion.test.ts +0 -654
  220. package/src/__tests__/skill-verifier.test.ts +0 -122
  221. package/src/__tests__/source-heartbeat.test.ts +0 -254
  222. package/src/__tests__/stable-context-length-contract.test.ts +0 -62
  223. package/src/__tests__/store-patch-metadata.test.ts +0 -235
  224. package/src/__tests__/store-read-consistency.test.ts +0 -122
  225. package/src/__tests__/store-schema-migration.test.ts +0 -87
  226. package/src/__tests__/store-scope-audit.test.ts +0 -81
  227. package/src/__tests__/store-upsert.test.ts +0 -201
  228. package/src/__tests__/supersede-chain.test.ts +0 -154
  229. package/src/__tests__/synthesis-contract.test.ts +0 -252
  230. package/src/__tests__/synthesis-promotion.test.ts +0 -369
  231. package/src/__tests__/temporal-parser.test.ts +0 -241
  232. package/src/__tests__/temporal-validity.test.ts +0 -160
  233. package/src/__tests__/term-registry-terminal-roster.test.ts +0 -127
  234. package/src/__tests__/term-registry.test.ts +0 -121
  235. package/src/__tests__/tool-error-surfacing.test.ts +0 -98
  236. package/src/__tests__/tool-output-compressor.test.ts +0 -160
  237. package/src/__tests__/topic-tag.test.ts +0 -113
  238. package/src/__tests__/trusted-memory.test.ts +0 -867
  239. package/src/__tests__/ui-server-security.test.ts +0 -93
  240. package/src/__tests__/usage-tracker.test.ts +0 -287
  241. package/src/__tests__/utility-weight.test.ts +0 -57
  242. package/src/__tests__/verbatim-self-recall.test.ts +0 -279
  243. package/src/__tests__/version-manager.test.ts +0 -248
  244. package/src/__tests__/workflow-observation-skill-outcome.test.ts +0 -352
  245. package/src/__tests__/workflow-observation.test.ts +0 -433
  246. package/src/__tests__/write-verifier.test.ts +0 -122
@@ -1,171 +0,0 @@
1
- import { describe, expect, it } from "bun:test";
2
- import { detectEntitiesSync, detectEntities } from "../query-entity-detector.js";
3
-
4
- // ============================================================================
5
- // Sync detection (no KG validation)
6
- // ============================================================================
7
-
8
- describe("detectEntitiesSync", () => {
9
- describe("English entity extraction", () => {
10
- it("extracts capitalized names", () => {
11
- const result = detectEntitiesSync("What does Alice use?");
12
- expect(result.entities).toContain("Alice");
13
- });
14
-
15
- it("extracts multi-word capitalized names", () => {
16
- const result = detectEntitiesSync("Tell me about Claude Code");
17
- expect(result.entities).toContain("Claude Code");
18
- });
19
-
20
- it("extracts CamelCase identifiers (normalized to title case)", () => {
21
- const result = detectEntitiesSync("How does RecallNest work?");
22
- // normalizeEntity applies title case: RecallNest -> Recallnest
23
- expect(result.entities).toContain("Recallnest");
24
- });
25
-
26
- it("extracts quoted strings (normalized to title case)", () => {
27
- const result = detectEntitiesSync('Search for "LanceDB" docs');
28
- expect(result.entities).toContain("Lancedb");
29
- });
30
-
31
- it("extracts backtick-quoted strings (normalized to title case)", () => {
32
- const result = detectEntitiesSync("What is `OpenAI` embedding?");
33
- expect(result.entities).toContain("Openai");
34
- });
35
-
36
- it("skips stop words even when capitalized", () => {
37
- const result = detectEntitiesSync("The quick brown fox");
38
- // "The" should be filtered as stop word
39
- expect(result.entities).not.toContain("The");
40
- });
41
-
42
- it("deduplicates entities (case-insensitive)", () => {
43
- const result = detectEntitiesSync('Alice uses "alice" tool');
44
- // Should have only one Alice entry
45
- const aliceCount = result.entities.filter(e => e.toLowerCase() === "alice").length;
46
- expect(aliceCount).toBe(1);
47
- });
48
-
49
- it("returns empty for queries without entities", () => {
50
- const result = detectEntitiesSync("what happened yesterday?");
51
- expect(result.entities.length).toBe(0);
52
- });
53
- });
54
-
55
- describe("multi-hop detection — English", () => {
56
- it("detects possessive friend pattern", () => {
57
- const result = detectEntitiesSync("Alice's friends");
58
- expect(result.isMultiHop).toBe(true);
59
- expect(result.hopPredicate).toBe("friend_of");
60
- });
61
-
62
- it("detects 'friend of' pattern", () => {
63
- const result = detectEntitiesSync("friends of Bob");
64
- expect(result.isMultiHop).toBe(true);
65
- expect(result.hopPredicate).toBe("friend_of");
66
- });
67
-
68
- it("detects 'what does X use' pattern", () => {
69
- const result = detectEntitiesSync("what does Alice use?");
70
- expect(result.isMultiHop).toBe(true);
71
- expect(result.hopPredicate).toBe("uses");
72
- });
73
-
74
- it("detects 'who created' pattern", () => {
75
- const result = detectEntitiesSync("who created RecallNest?");
76
- expect(result.isMultiHop).toBe(true);
77
- expect(result.hopPredicate).toBe("created_by");
78
- });
79
-
80
- it("detects 'who manages' pattern", () => {
81
- const result = detectEntitiesSync("who manages the team?");
82
- expect(result.isMultiHop).toBe(true);
83
- expect(result.hopPredicate).toBe("manages");
84
- });
85
-
86
- it("detects 'X depends on' pattern", () => {
87
- const result = detectEntitiesSync("what depends on LanceDB?");
88
- expect(result.isMultiHop).toBe(true);
89
- expect(result.hopPredicate).toBe("depends_on");
90
- });
91
-
92
- it("returns isMultiHop=false for simple queries", () => {
93
- const result = detectEntitiesSync("Tell me about Python");
94
- expect(result.isMultiHop).toBe(false);
95
- expect(result.hopPredicate).toBeUndefined();
96
- });
97
- });
98
-
99
- describe("multi-hop detection — Chinese", () => {
100
- it("detects 的朋友 pattern", () => {
101
- const result = detectEntitiesSync("Alice的朋友有谁?");
102
- expect(result.isMultiHop).toBe(true);
103
- expect(result.hopPredicate).toBe("friend_of");
104
- });
105
-
106
- it("detects 谁和X一起 pattern", () => {
107
- const result = detectEntitiesSync("谁和Bob一起工作?");
108
- expect(result.isMultiHop).toBe(true);
109
- expect(result.hopPredicate).toBe("works_with");
110
- });
111
-
112
- it("detects 谁创建了 pattern", () => {
113
- const result = detectEntitiesSync("谁创建了RecallNest?");
114
- expect(result.isMultiHop).toBe(true);
115
- expect(result.hopPredicate).toBe("created_by");
116
- });
117
-
118
- it("detects 依赖什么 pattern", () => {
119
- const result = detectEntitiesSync("RecallNest依赖什么?");
120
- expect(result.isMultiHop).toBe(true);
121
- expect(result.hopPredicate).toBe("depends_on");
122
- });
123
- });
124
- });
125
-
126
- // ============================================================================
127
- // Async detection with KG validation
128
- // ============================================================================
129
-
130
- describe("detectEntities (async with mock KG)", () => {
131
- function createMockKGStore(knownEntities: string[]) {
132
- return {
133
- async getAllEntities() {
134
- return knownEntities;
135
- },
136
- } as any;
137
- }
138
-
139
- it("validates entities against KG", async () => {
140
- const kgStore = createMockKGStore(["Alice", "Python", "LanceDB"]);
141
- const result = await detectEntities("Alice uses Python and React", kgStore);
142
-
143
- // Alice and Python are in KG, React is not
144
- expect(result.entities).toContain("Alice");
145
- expect(result.entities).toContain("Python");
146
- expect(result.entities).not.toContain("React");
147
- });
148
-
149
- it("falls back to heuristic when KG validates nothing", async () => {
150
- const kgStore = createMockKGStore([]); // empty KG
151
- const result = await detectEntities("Alice uses Python", kgStore);
152
-
153
- // Should fall back to heuristic candidates
154
- expect(result.entities).toContain("Alice");
155
- expect(result.entities).toContain("Python");
156
- });
157
-
158
- it("preserves KG canonical casing", async () => {
159
- const kgStore = createMockKGStore(["alice"]); // lowercase in KG
160
- const result = await detectEntities("Tell me about Alice", kgStore);
161
-
162
- // Should use KG's casing
163
- expect(result.entities).toContain("alice");
164
- });
165
-
166
- it("works without KG store", async () => {
167
- const result = await detectEntities("Alice uses Python");
168
- expect(result.entities).toContain("Alice");
169
- expect(result.entities).toContain("Python");
170
- });
171
- });
@@ -1,146 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from "bun:test";
2
- import { expandQuery, setAliasMapPath, resetAliasMapCache, upsertUserAlias, removeUserAlias, listUserAliases, explainUserAliases } from "../query-expander.js";
3
- import { expandQueryWithAliases, ALIAS_QUERY_MAX_LENGTH } from "../aliases.js";
4
- import { writeFileSync, unlinkSync, existsSync, mkdirSync } from "fs";
5
- import { join } from "path";
6
-
7
- const TEST_DIR = join(import.meta.dir, "../../.test-data");
8
- const TEST_ALIAS = join(TEST_DIR, "test-alias-map.json");
9
-
10
- function cleanup() {
11
- try { if (existsSync(TEST_ALIAS)) unlinkSync(TEST_ALIAS); } catch {}
12
- }
13
-
14
- describe("expandQuery with alias-map", () => {
15
- beforeEach(() => {
16
- if (!existsSync(TEST_DIR)) mkdirSync(TEST_DIR, { recursive: true });
17
- cleanup();
18
- resetAliasMapCache();
19
- });
20
- afterEach(() => {
21
- cleanup();
22
- resetAliasMapCache();
23
- });
24
-
25
- it("expands short query using alias-map", () => {
26
- writeFileSync(TEST_ALIAS, JSON.stringify([
27
- { trigger: "轮巡", expansions: ["仓库", "patrol", "repo", "每日检查"] },
28
- ]));
29
- setAliasMapPath(TEST_ALIAS);
30
-
31
- const expanded = expandQuery("轮巡");
32
- expect(expanded).toContain("轮巡");
33
- expect(expanded).toContain("仓库");
34
- expect(expanded).toContain("patrol");
35
- });
36
-
37
- it("does not expand when trigger not matched", () => {
38
- writeFileSync(TEST_ALIAS, JSON.stringify([
39
- { trigger: "轮巡", expansions: ["仓库", "patrol"] },
40
- ]));
41
- setAliasMapPath(TEST_ALIAS);
42
-
43
- const expanded = expandQuery("部署");
44
- // "部署" matches built-in synonym map, but should NOT match alias "轮巡"
45
- expect(expanded).not.toContain("patrol");
46
- });
47
-
48
- it("works with empty alias-map file", () => {
49
- writeFileSync(TEST_ALIAS, "[]");
50
- setAliasMapPath(TEST_ALIAS);
51
-
52
- const result = expandQuery("轮巡");
53
- // Should still work (only built-in synonyms)
54
- expect(result).toContain("轮巡");
55
- });
56
-
57
- it("works with missing alias-map file", () => {
58
- setAliasMapPath(join(TEST_DIR, "nonexistent.json"));
59
-
60
- const result = expandQuery("轮巡");
61
- expect(result).toContain("轮巡");
62
- });
63
-
64
- it("skips expansion terms already in query", () => {
65
- writeFileSync(TEST_ALIAS, JSON.stringify([
66
- { trigger: "轮巡", expansions: ["轮巡", "仓库", "patrol"] },
67
- ]));
68
- setAliasMapPath(TEST_ALIAS);
69
-
70
- const expanded = expandQuery("轮巡仓库");
71
- // "仓库" already in query, should not be duplicated
72
- const occurrences = expanded.split("仓库").length - 1;
73
- expect(occurrences).toBe(1);
74
- });
75
-
76
- it("respects MAX_EXPANSION_TERMS cap", () => {
77
- writeFileSync(TEST_ALIAS, JSON.stringify([
78
- {
79
- trigger: "测试",
80
- expansions: ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j"],
81
- },
82
- ]));
83
- setAliasMapPath(TEST_ALIAS);
84
-
85
- const expanded = expandQuery("测试");
86
- // Built-in synonyms + alias expansions, but capped at MAX_EXPANSION_TERMS (5)
87
- const addedTerms = expanded.replace("测试", "").trim().split(/\s+/);
88
- expect(addedTerms.length).toBeLessThanOrEqual(5);
89
- });
90
- });
91
-
92
- describe("manage_alias backend (P1-B)", () => {
93
- beforeEach(() => {
94
- if (!existsSync(TEST_DIR)) mkdirSync(TEST_DIR, { recursive: true });
95
- cleanup();
96
- setAliasMapPath(TEST_ALIAS);
97
- resetAliasMapCache();
98
- });
99
- afterEach(() => {
100
- cleanup();
101
- resetAliasMapCache();
102
- });
103
-
104
- it("upserts, lists, expands, and removes a user alias", () => {
105
- const added = upsertUserAlias("我的桥", ["telegram-ai-bridge", "tg-bridge-channel"]);
106
- expect(added.ok).toBe(true);
107
- expect(listUserAliases()).toHaveLength(1);
108
-
109
- // 写完即生效(缓存失效),BM25 通道扩展可见
110
- const expanded = expandQuery("我的桥怎么挂了");
111
- expect(expanded).toContain("telegram-ai-bridge");
112
-
113
- // update 路径
114
- const updated = upsertUserAlias("我的桥", ["telegram-ai-bridge"]);
115
- expect(updated.ok && updated.action === "updated").toBe(true);
116
- expect(listUserAliases()[0].expansions).toEqual(["telegram-ai-bridge"]);
117
-
118
- expect(explainUserAliases("我的桥呢")).toHaveLength(1);
119
- expect(removeUserAlias("我的桥")).toBe(true);
120
- expect(removeUserAlias("我的桥")).toBe(false);
121
- expect(listUserAliases()).toHaveLength(0);
122
- });
123
-
124
- it("rejects invalid rules with reasons", () => {
125
- const tooShort = upsertUserAlias("桥", ["x-bridge"]);
126
- expect(tooShort.ok).toBe(false);
127
-
128
- const tooMany = upsertUserAlias("我的桥", ["a1", "a2", "a3", "a4", "a5", "a6", "a7", "a8", "a9"]);
129
- expect(tooMany.ok).toBe(false);
130
-
131
- const selfRef = upsertUserAlias("我的桥", ["我的桥"]);
132
- expect(selfRef.ok).toBe(false);
133
-
134
- const empty = upsertUserAlias("我的桥", [" "]);
135
- expect(empty.ok).toBe(false);
136
- });
137
- });
138
-
139
- describe("expandQueryWithAliases length gate (P1-B)", () => {
140
- it("skips expansion for queries beyond ALIAS_QUERY_MAX_LENGTH", () => {
141
- const longQuery = "我的记忆项目".padEnd(ALIAS_QUERY_MAX_LENGTH + 10, "字");
142
- expect(expandQueryWithAliases(longQuery)).toBe(longQuery);
143
- // 短 query 照常扩展
144
- expect(expandQueryWithAliases("我的记忆项目")).toContain("recallnest");
145
- });
146
- });
@@ -1,34 +0,0 @@
1
- import { describe, it, expect } from "bun:test";
2
- import { expandQuery } from "../query-expander.js";
3
-
4
- describe("expandQuery", () => {
5
- it("expands colloquial Chinese to technical terms", () => {
6
- const result = expandQuery("bot 突然挂了");
7
- expect(result).toContain("崩溃");
8
- expect(result).toContain("crash");
9
- expect(result).toContain("挂了");
10
- });
11
-
12
- it("expands fuzzy feeling queries", () => {
13
- const result = expandQuery("AI 到底有没有感受");
14
- expect(result).toContain("意识");
15
- expect(result).toContain("consciousness");
16
- expect(result).toContain("感受");
17
- });
18
-
19
- it("preserves original query terms", () => {
20
- const result = expandQuery("配图风格");
21
- expect(result).toContain("配图");
22
- expect(result).toContain("风格");
23
- });
24
-
25
- it("returns original for already-precise queries", () => {
26
- const result = expandQuery("JINA_API_KEY");
27
- expect(result).toBe("JINA_API_KEY");
28
- });
29
-
30
- it("handles empty/short queries", () => {
31
- expect(expandQuery("")).toBe("");
32
- expect(expandQuery("hi")).toBe("hi");
33
- });
34
- });
@@ -1,266 +0,0 @@
1
- import { afterEach, describe, expect, it } from "bun:test";
2
- import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
3
- import { tmpdir } from "node:os";
4
- import { join } from "node:path";
5
-
6
- import { runAutoRecall } from "../auto-recall.js";
7
- import {
8
- RECALL_GATE_SHADOW_FILE,
9
- classifyRecallGate,
10
- resolveRecallGateMode,
11
- type RecallGateDecision,
12
- } from "../recall-gate.js";
13
- import type { RetrievalContext, RetrievalResult } from "../retriever.js";
14
-
15
- const savedGateEnv = process.env.RECALLNEST_RECALL_GATE;
16
- const savedDataDirEnv = process.env.RECALLNEST_DATA_DIR;
17
- const cleanupPaths: string[] = [];
18
-
19
- afterEach(() => {
20
- if (savedGateEnv === undefined) delete process.env.RECALLNEST_RECALL_GATE;
21
- else process.env.RECALLNEST_RECALL_GATE = savedGateEnv;
22
- if (savedDataDirEnv === undefined) delete process.env.RECALLNEST_DATA_DIR;
23
- else process.env.RECALLNEST_DATA_DIR = savedDataDirEnv;
24
- while (cleanupPaths.length > 0) {
25
- const target = cleanupPaths.pop();
26
- if (target) rmSync(target, { recursive: true, force: true });
27
- }
28
- });
29
-
30
- function tempDataDir(): string {
31
- const dir = mkdtempSync(join(tmpdir(), "recallnest-gate-"));
32
- cleanupPaths.push(dir);
33
- process.env.RECALLNEST_DATA_DIR = dir;
34
- return dir;
35
- }
36
-
37
- function expectDecision(message: string, decision: RecallGateDecision, ruleId?: string) {
38
- const verdict = classifyRecallGate(message);
39
- expect(`${message} → ${verdict.decision}`).toBe(`${message} → ${decision}`);
40
- if (ruleId) expect(verdict.ruleId).toBe(ruleId);
41
- }
42
-
43
- describe("classifyRecallGate — verdict matrix", () => {
44
- it("force cues win over every short-text rule", () => {
45
- expectDecision("可以按上次方案做", "full-recall", "force:memory-cue-zh");
46
- expectDecision("记得我说过什么吗", "full-recall");
47
- expectDecision("我的偏好是什么", "full-recall");
48
- expectDecision("do you remember my setup?", "full-recall", "force:memory-cue-en");
49
- expectDecision("what did we discussed last time", "full-recall");
50
- // Force cue inside an otherwise long message still labels full-recall.
51
- const long = `${"背景介绍。".repeat(20)}上次的结论是什么?`;
52
- expectDecision(long, "full-recall");
53
- });
54
-
55
- it("whole-message acks skip; acks with real content pass", () => {
56
- expectDecision("好的", "skip-all", "skip:ack");
57
- expectDecision("好的吧。", "skip-all");
58
- expectDecision("嗯嗯", "skip-all");
59
- expectDecision("OK", "skip-all");
60
- expectDecision("Thanks!", "skip-all");
61
- expectDecision("好的 谢谢", "skip-all");
62
- expectDecision("收到了哈", "skip-all");
63
- expectDecision("好的,先跑测试再说", "pass");
64
- expectDecision("可以先做项1", "pass");
65
- });
66
-
67
- it("continuity nudges are resume-only; nudge + content passes", () => {
68
- expectDecision("继续", "resume-only", "resume:continuity");
69
- expectDecision("继续吧", "resume-only");
70
- expectDecision("接着来", "resume-only");
71
- expectDecision("下一步", "resume-only");
72
- expectDecision("开始", "resume-only");
73
- expectDecision("开始吧", "resume-only");
74
- expectDecision("continue", "resume-only");
75
- expectDecision("接着改 auto-recall 的闸", "pass");
76
- // "继续讨论上次的方案" carries a force cue → full-recall, not resume-only.
77
- expectDecision("继续讨论上次的方案", "full-recall");
78
- });
79
-
80
- it("bare CLI invocations skip; CLI words inside prose pass", () => {
81
- expectDecision("git push", "skip-all", "skip:cli");
82
- expectDecision("npm test", "skip-all");
83
- expectDecision("bun test src/__tests__/recall-gate.test.ts", "skip-all");
84
- expectDecision("git", "skip-all");
85
- expectDecision("git 为什么失败", "pass");
86
- expectDecision("why does npm test hang?", "pass");
87
- expectDecision("测试之前讨论的方案", "full-recall"); // force cue, not cli
88
- });
89
-
90
- it("slash commands and heartbeats skip", () => {
91
- expectDecision("/compact", "skip-all", "skip:slash");
92
- expectDecision("/goal 写个爬虫", "skip-all");
93
- expectDecision("HEARTBEAT_OK", "skip-all", "skip:heartbeat");
94
- });
95
-
96
- it("pure emoji skips; bare digits/#/* are NOT emoji", () => {
97
- expectDecision("👍", "skip-all", "skip:emoji");
98
- expectDecision("👍👍 🎉", "skip-all");
99
- expectDecision("🇸🇬", "skip-all");
100
- expectDecision("42", "pass");
101
- expectDecision("#1", "pass");
102
- expectDecision("*", "pass");
103
- });
104
-
105
- it("greetings skip as whole messages only", () => {
106
- expectDecision("你好", "skip-all", "skip:greeting");
107
- expectDecision("早", "skip-all");
108
- expectDecision("hello", "skip-all");
109
- expectDecision("在吗", "skip-all");
110
- expectDecision("你好,帮我查一下部署状态", "pass");
111
- });
112
-
113
- it("long messages without force cues always pass", () => {
114
- const long = "这条消息足够长,描述了一个具体的问题背景和期望的处理方式,值得走完整的检索管线来补上下文。".repeat(2);
115
- expect(long.length).toBeGreaterThan(80);
116
- expectDecision(long, "pass", "pass:long");
117
- });
118
-
119
- it("empty input degrades to skip:empty", () => {
120
- expectDecision(" ", "skip-all", "skip:empty");
121
- });
122
- });
123
-
124
- describe("resolveRecallGateMode", () => {
125
- it("defaults to observe; parses enforce/off; junk falls back to observe", () => {
126
- expect(resolveRecallGateMode({})).toBe("observe");
127
- expect(resolveRecallGateMode({ RECALLNEST_RECALL_GATE: "enforce" })).toBe("enforce");
128
- expect(resolveRecallGateMode({ RECALLNEST_RECALL_GATE: "OFF" })).toBe("off");
129
- expect(resolveRecallGateMode({ RECALLNEST_RECALL_GATE: "banana" })).toBe("observe");
130
- });
131
- });
132
-
133
- // --- integration through runAutoRecall ---
134
-
135
- function buildResult(id: string, text: string): RetrievalResult {
136
- return {
137
- entry: {
138
- id,
139
- text,
140
- vector: [],
141
- category: "events",
142
- scope: "project:gate",
143
- importance: 0.8,
144
- timestamp: Date.parse("2026-07-01T00:00:00.000Z"),
145
- metadata: "{}",
146
- },
147
- score: 0.9,
148
- sources: { fused: { score: 0.9 } },
149
- };
150
- }
151
-
152
- function makeDeps() {
153
- const calls: RetrievalContext[] = [];
154
- return {
155
- calls,
156
- deps: {
157
- retriever: {
158
- async retrieve(context: RetrievalContext): Promise<RetrievalResult[]> {
159
- calls.push(context);
160
- if (!context.category) return [buildResult("hit-1", "focused hit")];
161
- return [];
162
- },
163
- },
164
- checkpointStore: { async getLatest() { return null; } },
165
- listPins: () => [],
166
- },
167
- };
168
- }
169
-
170
- describe("runAutoRecall × recall gate", () => {
171
- it("observe mode leaves behavior unchanged and appends a shadow entry", async () => {
172
- const dir = tempDataDir();
173
- const { deps, calls } = makeDeps();
174
-
175
- const response = await runAutoRecall(deps, {
176
- message: "好的",
177
- scope: "project:gate",
178
- operation: "test:gate-observe",
179
- env: { RECALLNEST_RECALL_GATE: "observe" } as NodeJS.ProcessEnv,
180
- });
181
-
182
- // Unchanged behavior: full resume+search pipeline still ran.
183
- expect(response.mode).toBe("resume+search");
184
- expect(calls.length).toBeGreaterThan(0);
185
- expect(response.results.length).toBe(1);
186
-
187
- const shadowPath = join(dir, RECALL_GATE_SHADOW_FILE);
188
- expect(existsSync(shadowPath)).toBe(true);
189
- const entry = JSON.parse(readFileSync(shadowPath, "utf8").trim().split("\n")[0] ?? "{}");
190
- expect(entry.decision).toBe("skip-all");
191
- expect(entry.ruleId).toBe("skip:ack");
192
- expect(entry.mode).toBe("observe");
193
- expect(entry.msgLen).toBe(2);
194
- expect(entry.source).toBe("test:gate-observe");
195
- expect(JSON.stringify(entry)).not.toContain("好的"); // never log message text
196
- });
197
-
198
- it("enforce + skip-all short-circuits before any retriever call", async () => {
199
- tempDataDir();
200
- const { deps, calls } = makeDeps();
201
-
202
- const response = await runAutoRecall(deps, {
203
- message: "👍",
204
- scope: "project:gate",
205
- operation: "test:gate-enforce-skip",
206
- env: { RECALLNEST_RECALL_GATE: "enforce" } as NodeJS.ProcessEnv,
207
- });
208
-
209
- expect(response.mode).toBe("resume-only");
210
- expect(response.results.length).toBe(0);
211
- expect(response.searchSkippedReason).toContain("skip-all");
212
- expect(response.searchSkippedReason).toContain("skip:emoji");
213
- expect(calls.length).toBe(0); // neither compose nor focused search hit the retriever
214
- });
215
-
216
- it("enforce + resume-only keeps resume context but skips the focused search", async () => {
217
- tempDataDir();
218
- const { deps, calls } = makeDeps();
219
-
220
- const response = await runAutoRecall(deps, {
221
- message: "继续",
222
- scope: "project:gate",
223
- operation: "test:gate-enforce-resume",
224
- env: { RECALLNEST_RECALL_GATE: "enforce" } as NodeJS.ProcessEnv,
225
- });
226
-
227
- expect(response.mode).toBe("resume-only");
228
- expect(response.results.length).toBe(0);
229
- expect(response.searchSkippedReason).toContain("resume-only");
230
- // Resume composition ran (retriever called with categories), but no
231
- // focused search (which would be the category-less call).
232
- const focusedCalls = calls.filter((c) => !c.category);
233
- expect(focusedCalls.length).toBe(0);
234
- expect(calls.length).toBeGreaterThan(0);
235
- });
236
-
237
- it("enforce mode leaves normal content untouched", async () => {
238
- tempDataDir();
239
- const { deps } = makeDeps();
240
-
241
- const response = await runAutoRecall(deps, {
242
- message: "帮我看看 retriever 的打分逻辑有没有问题",
243
- scope: "project:gate",
244
- operation: "test:gate-enforce-pass",
245
- env: { RECALLNEST_RECALL_GATE: "enforce" } as NodeJS.ProcessEnv,
246
- });
247
-
248
- expect(response.mode).toBe("resume+search");
249
- expect(response.results.length).toBe(1);
250
- });
251
-
252
- it("off mode computes nothing and writes no shadow log", async () => {
253
- const dir = tempDataDir();
254
- const { deps } = makeDeps();
255
-
256
- const response = await runAutoRecall(deps, {
257
- message: "好的",
258
- scope: "project:gate",
259
- operation: "test:gate-off",
260
- env: { RECALLNEST_RECALL_GATE: "off" } as NodeJS.ProcessEnv,
261
- });
262
-
263
- expect(response.mode).toBe("resume+search");
264
- expect(existsSync(join(dir, RECALL_GATE_SHADOW_FILE))).toBe(false);
265
- });
266
- });