recallnest 3.0.0 → 3.0.1

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 (184) hide show
  1. package/CHANGELOG.md +101 -0
  2. package/README.md +222 -254
  3. package/README_CN.md +206 -243
  4. package/package.json +3 -2
  5. package/src/capture-engine.ts +26 -4
  6. package/src/context-composer-stable.ts +5 -1
  7. package/src/embedder.ts +24 -0
  8. package/src/env-config.ts +18 -0
  9. package/src/ingest.ts +225 -17
  10. package/src/kg-extractor.ts +17 -0
  11. package/src/memory-output.ts +35 -0
  12. package/src/pivot-apply.ts +52 -1
  13. package/src/pivot-evidence.ts +128 -0
  14. package/src/ppr-traversal.ts +25 -1
  15. package/src/runtime-config.ts +9 -0
  16. package/src/session-engine.ts +11 -4
  17. package/src/session-output.ts +9 -1
  18. package/src/session-store.ts +2 -3
  19. package/src/skill-promotion.ts +67 -1
  20. package/src/__tests__/access-tracker-novelty.test.ts +0 -324
  21. package/src/__tests__/activity-counter.test.ts +0 -125
  22. package/src/__tests__/adaptive-fidelity.test.ts +0 -102
  23. package/src/__tests__/admission-control.test.ts +0 -206
  24. package/src/__tests__/age-label.test.ts +0 -33
  25. package/src/__tests__/anchor-generator.test.ts +0 -67
  26. package/src/__tests__/api-server-security.test.ts +0 -102
  27. package/src/__tests__/auto-consolidation.test.ts +0 -168
  28. package/src/__tests__/auto-recall.test.ts +0 -131
  29. package/src/__tests__/babel-integration.test.ts +0 -144
  30. package/src/__tests__/batch-dedup.test.ts +0 -65
  31. package/src/__tests__/belief-history.test.ts +0 -220
  32. package/src/__tests__/canary-eval.test.ts +0 -114
  33. package/src/__tests__/capture-engine.test.ts +0 -1328
  34. package/src/__tests__/capture-heuristic.test.ts +0 -171
  35. package/src/__tests__/cascade-forget.test.ts +0 -210
  36. package/src/__tests__/category-min-scores.test.ts +0 -116
  37. package/src/__tests__/cc8-cc1-essential-context.test.ts +0 -298
  38. package/src/__tests__/circuit-breaker.test.ts +0 -99
  39. package/src/__tests__/cluster-consolidation.test.ts +0 -1236
  40. package/src/__tests__/confidence-metadata.test.ts +0 -125
  41. package/src/__tests__/confidence-tracker.test.ts +0 -261
  42. package/src/__tests__/conflict-advisor.test.ts +0 -206
  43. package/src/__tests__/conflict-escalation.test.ts +0 -149
  44. package/src/__tests__/conflict-lifecycle.test.ts +0 -83
  45. package/src/__tests__/conflict-output.test.ts +0 -85
  46. package/src/__tests__/conflict-store.test.ts +0 -418
  47. package/src/__tests__/connector-v1.test.ts +0 -181
  48. package/src/__tests__/consolidation-engine.test.ts +0 -520
  49. package/src/__tests__/constructive-retrieval.test.ts +0 -509
  50. package/src/__tests__/context-collapse-renderer.test.ts +0 -214
  51. package/src/__tests__/context-composer-pins.test.ts +0 -64
  52. package/src/__tests__/context-composer-task-selection.test.ts +0 -24
  53. package/src/__tests__/context-reconstructor.test.ts +0 -65
  54. package/src/__tests__/context-renderer.test.ts +0 -91
  55. package/src/__tests__/continuity-eval.test.ts +0 -275
  56. package/src/__tests__/continuity-schema.test.ts +0 -97
  57. package/src/__tests__/contracts.test.ts +0 -262
  58. package/src/__tests__/conversation-importer.test.ts +0 -692
  59. package/src/__tests__/core-recall-eval.test.ts +0 -235
  60. package/src/__tests__/core-summary.test.ts +0 -109
  61. package/src/__tests__/data-checkup.test.ts +0 -304
  62. package/src/__tests__/decay-exemption.test.ts +0 -129
  63. package/src/__tests__/dedup-actions.test.ts +0 -58
  64. package/src/__tests__/dedup-guard.test.ts +0 -39
  65. package/src/__tests__/deterministic-id.test.ts +0 -39
  66. package/src/__tests__/distill-lock.test.ts +0 -305
  67. package/src/__tests__/distill-session-argshape.test.ts +0 -79
  68. package/src/__tests__/doctor.test.ts +0 -319
  69. package/src/__tests__/dream-pipeline.test.ts +0 -820
  70. package/src/__tests__/dream-scope-isolation.test.ts +0 -386
  71. package/src/__tests__/dream-write-batching.test.ts +0 -211
  72. package/src/__tests__/drill-down.test.ts +0 -108
  73. package/src/__tests__/embedder.test.ts +0 -122
  74. package/src/__tests__/emotion-decay.test.ts +0 -46
  75. package/src/__tests__/emotion-detector.test.ts +0 -56
  76. package/src/__tests__/emotion-phase1-integration.test.ts +0 -153
  77. package/src/__tests__/emotion-retrieval.test.ts +0 -56
  78. package/src/__tests__/entity-resolver.test.ts +0 -58
  79. package/src/__tests__/env-config-invariant.test.ts +0 -80
  80. package/src/__tests__/env-config.test.ts +0 -211
  81. package/src/__tests__/error-signature-boost.test.ts +0 -87
  82. package/src/__tests__/error-signature.test.ts +0 -95
  83. package/src/__tests__/error-taxonomy.test.ts +0 -129
  84. package/src/__tests__/ethics-layer.test.ts +0 -476
  85. package/src/__tests__/event-segmenter.test.ts +0 -153
  86. package/src/__tests__/feature-flags-integration.test.ts +0 -54
  87. package/src/__tests__/frequency-tracker.test.ts +0 -113
  88. package/src/__tests__/freshness.test.ts +0 -186
  89. package/src/__tests__/graph-export.test.ts +0 -489
  90. package/src/__tests__/hotness-blend.test.ts +0 -283
  91. package/src/__tests__/ingest-chunking.test.ts +0 -44
  92. package/src/__tests__/ingest-scope-prefix.test.ts +0 -69
  93. package/src/__tests__/ingest.test.ts +0 -360
  94. package/src/__tests__/interference-detector.test.ts +0 -203
  95. package/src/__tests__/kg-extractor.test.ts +0 -192
  96. package/src/__tests__/kg-store.test.ts +0 -300
  97. package/src/__tests__/llm-client-pivot.test.ts +0 -628
  98. package/src/__tests__/llm-consolidation.test.ts +0 -226
  99. package/src/__tests__/maintenance-locks.test.ts +0 -197
  100. package/src/__tests__/mcp-efficiency.test.ts +0 -288
  101. package/src/__tests__/mcp-related-scopes.test.ts +0 -151
  102. package/src/__tests__/memory-boundaries.test.ts +0 -282
  103. package/src/__tests__/memory-evolution-b2-b3-e1.test.ts +0 -362
  104. package/src/__tests__/memory-evolution.test.ts +0 -271
  105. package/src/__tests__/memory-health-rebalance.test.ts +0 -144
  106. package/src/__tests__/memory-lint.test.ts +0 -421
  107. package/src/__tests__/memory-output.test.ts +0 -224
  108. package/src/__tests__/memory-promotion.test.ts +0 -315
  109. package/src/__tests__/memory-utility.test.ts +0 -256
  110. package/src/__tests__/migrate-dedup-ids.test.ts +0 -65
  111. package/src/__tests__/multi-vector.test.ts +0 -242
  112. package/src/__tests__/narrative-architecture.test.ts +0 -456
  113. package/src/__tests__/noise-filter.test.ts +0 -205
  114. package/src/__tests__/noise-prototype-bank.test.ts +0 -280
  115. package/src/__tests__/obsidian-connector.test.ts +0 -363
  116. package/src/__tests__/omitted-reporting.test.ts +0 -98
  117. package/src/__tests__/openai-contract.test.ts +0 -513
  118. package/src/__tests__/pending-review.test.ts +0 -77
  119. package/src/__tests__/pii-redact.test.ts +0 -333
  120. package/src/__tests__/pivot-apply.test.ts +0 -373
  121. package/src/__tests__/pivot-distill-supervisor.test.ts +0 -457
  122. package/src/__tests__/pivot-distill.test.ts +0 -1178
  123. package/src/__tests__/post-retrieval-filter.test.ts +0 -178
  124. package/src/__tests__/ppr-traversal.test.ts +0 -256
  125. package/src/__tests__/prediction-engine.test.ts +0 -349
  126. package/src/__tests__/predictive-prospective-memory.test.ts +0 -416
  127. package/src/__tests__/preference-guard-smoke.test.ts +0 -211
  128. package/src/__tests__/preference-matcher.test.ts +0 -282
  129. package/src/__tests__/preference-slots.test.ts +0 -205
  130. package/src/__tests__/promotion-distinct-sources.test.ts +0 -162
  131. package/src/__tests__/prospective-memory.test.ts +0 -283
  132. package/src/__tests__/pull-from-macbook-sync-only.test.ts +0 -679
  133. package/src/__tests__/query-entity-detector.test.ts +0 -171
  134. package/src/__tests__/query-expander-alias.test.ts +0 -146
  135. package/src/__tests__/query-expander.test.ts +0 -34
  136. package/src/__tests__/recall-gate.test.ts +0 -266
  137. package/src/__tests__/recall-governor.test.ts +0 -227
  138. package/src/__tests__/recall-mode.test.ts +0 -64
  139. package/src/__tests__/resolve-db-path.test.ts +0 -130
  140. package/src/__tests__/resolve-tier.test.ts +0 -64
  141. package/src/__tests__/result-synthesizer.test.ts +0 -198
  142. package/src/__tests__/resume-context.test.ts +0 -4898
  143. package/src/__tests__/retrieval-eval.test.ts +0 -163
  144. package/src/__tests__/retrieval-trace.test.ts +0 -213
  145. package/src/__tests__/retrieve-audit-revision.test.ts +0 -255
  146. package/src/__tests__/retriever-boundary-weight.test.ts +0 -136
  147. package/src/__tests__/retriever-lazy-init-dispatch.test.ts +0 -123
  148. package/src/__tests__/retroactive-boost.test.ts +0 -223
  149. package/src/__tests__/salience-scoring.test.ts +0 -106
  150. package/src/__tests__/scope-inventory.test.ts +0 -200
  151. package/src/__tests__/scope-policy.test.ts +0 -69
  152. package/src/__tests__/scope-suggester.test.ts +0 -80
  153. package/src/__tests__/session-checkpoint.test.ts +0 -291
  154. package/src/__tests__/session-distiller.test.ts +0 -640
  155. package/src/__tests__/session-gc.test.ts +0 -215
  156. package/src/__tests__/skill-engine.test.ts +0 -552
  157. package/src/__tests__/skill-promotion.test.ts +0 -654
  158. package/src/__tests__/skill-verifier.test.ts +0 -122
  159. package/src/__tests__/source-heartbeat.test.ts +0 -254
  160. package/src/__tests__/stable-context-length-contract.test.ts +0 -62
  161. package/src/__tests__/store-patch-metadata.test.ts +0 -235
  162. package/src/__tests__/store-read-consistency.test.ts +0 -122
  163. package/src/__tests__/store-schema-migration.test.ts +0 -87
  164. package/src/__tests__/store-scope-audit.test.ts +0 -81
  165. package/src/__tests__/store-upsert.test.ts +0 -201
  166. package/src/__tests__/supersede-chain.test.ts +0 -154
  167. package/src/__tests__/synthesis-contract.test.ts +0 -252
  168. package/src/__tests__/synthesis-promotion.test.ts +0 -369
  169. package/src/__tests__/temporal-parser.test.ts +0 -241
  170. package/src/__tests__/temporal-validity.test.ts +0 -160
  171. package/src/__tests__/term-registry-terminal-roster.test.ts +0 -127
  172. package/src/__tests__/term-registry.test.ts +0 -121
  173. package/src/__tests__/tool-error-surfacing.test.ts +0 -98
  174. package/src/__tests__/tool-output-compressor.test.ts +0 -160
  175. package/src/__tests__/topic-tag.test.ts +0 -113
  176. package/src/__tests__/trusted-memory.test.ts +0 -867
  177. package/src/__tests__/ui-server-security.test.ts +0 -93
  178. package/src/__tests__/usage-tracker.test.ts +0 -287
  179. package/src/__tests__/utility-weight.test.ts +0 -57
  180. package/src/__tests__/verbatim-self-recall.test.ts +0 -279
  181. package/src/__tests__/version-manager.test.ts +0 -248
  182. package/src/__tests__/workflow-observation-skill-outcome.test.ts +0 -352
  183. package/src/__tests__/workflow-observation.test.ts +0 -433
  184. 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
- });