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.
- package/CHANGELOG.md +101 -0
- package/README.md +222 -254
- package/README_CN.md +206 -243
- package/package.json +3 -2
- package/src/capture-engine.ts +26 -4
- package/src/context-composer-stable.ts +5 -1
- package/src/embedder.ts +24 -0
- package/src/env-config.ts +18 -0
- package/src/ingest.ts +225 -17
- package/src/kg-extractor.ts +17 -0
- package/src/memory-output.ts +35 -0
- package/src/pivot-apply.ts +52 -1
- package/src/pivot-evidence.ts +128 -0
- package/src/ppr-traversal.ts +25 -1
- package/src/runtime-config.ts +9 -0
- package/src/session-engine.ts +11 -4
- package/src/session-output.ts +9 -1
- package/src/session-store.ts +2 -3
- package/src/skill-promotion.ts +67 -1
- package/src/__tests__/access-tracker-novelty.test.ts +0 -324
- package/src/__tests__/activity-counter.test.ts +0 -125
- package/src/__tests__/adaptive-fidelity.test.ts +0 -102
- package/src/__tests__/admission-control.test.ts +0 -206
- package/src/__tests__/age-label.test.ts +0 -33
- package/src/__tests__/anchor-generator.test.ts +0 -67
- package/src/__tests__/api-server-security.test.ts +0 -102
- package/src/__tests__/auto-consolidation.test.ts +0 -168
- package/src/__tests__/auto-recall.test.ts +0 -131
- package/src/__tests__/babel-integration.test.ts +0 -144
- package/src/__tests__/batch-dedup.test.ts +0 -65
- package/src/__tests__/belief-history.test.ts +0 -220
- package/src/__tests__/canary-eval.test.ts +0 -114
- package/src/__tests__/capture-engine.test.ts +0 -1328
- package/src/__tests__/capture-heuristic.test.ts +0 -171
- package/src/__tests__/cascade-forget.test.ts +0 -210
- package/src/__tests__/category-min-scores.test.ts +0 -116
- package/src/__tests__/cc8-cc1-essential-context.test.ts +0 -298
- package/src/__tests__/circuit-breaker.test.ts +0 -99
- package/src/__tests__/cluster-consolidation.test.ts +0 -1236
- package/src/__tests__/confidence-metadata.test.ts +0 -125
- package/src/__tests__/confidence-tracker.test.ts +0 -261
- package/src/__tests__/conflict-advisor.test.ts +0 -206
- package/src/__tests__/conflict-escalation.test.ts +0 -149
- package/src/__tests__/conflict-lifecycle.test.ts +0 -83
- package/src/__tests__/conflict-output.test.ts +0 -85
- package/src/__tests__/conflict-store.test.ts +0 -418
- package/src/__tests__/connector-v1.test.ts +0 -181
- package/src/__tests__/consolidation-engine.test.ts +0 -520
- package/src/__tests__/constructive-retrieval.test.ts +0 -509
- package/src/__tests__/context-collapse-renderer.test.ts +0 -214
- package/src/__tests__/context-composer-pins.test.ts +0 -64
- package/src/__tests__/context-composer-task-selection.test.ts +0 -24
- package/src/__tests__/context-reconstructor.test.ts +0 -65
- package/src/__tests__/context-renderer.test.ts +0 -91
- package/src/__tests__/continuity-eval.test.ts +0 -275
- package/src/__tests__/continuity-schema.test.ts +0 -97
- package/src/__tests__/contracts.test.ts +0 -262
- package/src/__tests__/conversation-importer.test.ts +0 -692
- package/src/__tests__/core-recall-eval.test.ts +0 -235
- package/src/__tests__/core-summary.test.ts +0 -109
- package/src/__tests__/data-checkup.test.ts +0 -304
- package/src/__tests__/decay-exemption.test.ts +0 -129
- package/src/__tests__/dedup-actions.test.ts +0 -58
- package/src/__tests__/dedup-guard.test.ts +0 -39
- package/src/__tests__/deterministic-id.test.ts +0 -39
- package/src/__tests__/distill-lock.test.ts +0 -305
- package/src/__tests__/distill-session-argshape.test.ts +0 -79
- package/src/__tests__/doctor.test.ts +0 -319
- package/src/__tests__/dream-pipeline.test.ts +0 -820
- package/src/__tests__/dream-scope-isolation.test.ts +0 -386
- package/src/__tests__/dream-write-batching.test.ts +0 -211
- package/src/__tests__/drill-down.test.ts +0 -108
- package/src/__tests__/embedder.test.ts +0 -122
- package/src/__tests__/emotion-decay.test.ts +0 -46
- package/src/__tests__/emotion-detector.test.ts +0 -56
- package/src/__tests__/emotion-phase1-integration.test.ts +0 -153
- package/src/__tests__/emotion-retrieval.test.ts +0 -56
- package/src/__tests__/entity-resolver.test.ts +0 -58
- package/src/__tests__/env-config-invariant.test.ts +0 -80
- package/src/__tests__/env-config.test.ts +0 -211
- package/src/__tests__/error-signature-boost.test.ts +0 -87
- package/src/__tests__/error-signature.test.ts +0 -95
- package/src/__tests__/error-taxonomy.test.ts +0 -129
- package/src/__tests__/ethics-layer.test.ts +0 -476
- package/src/__tests__/event-segmenter.test.ts +0 -153
- package/src/__tests__/feature-flags-integration.test.ts +0 -54
- package/src/__tests__/frequency-tracker.test.ts +0 -113
- package/src/__tests__/freshness.test.ts +0 -186
- package/src/__tests__/graph-export.test.ts +0 -489
- package/src/__tests__/hotness-blend.test.ts +0 -283
- package/src/__tests__/ingest-chunking.test.ts +0 -44
- package/src/__tests__/ingest-scope-prefix.test.ts +0 -69
- package/src/__tests__/ingest.test.ts +0 -360
- package/src/__tests__/interference-detector.test.ts +0 -203
- package/src/__tests__/kg-extractor.test.ts +0 -192
- package/src/__tests__/kg-store.test.ts +0 -300
- package/src/__tests__/llm-client-pivot.test.ts +0 -628
- package/src/__tests__/llm-consolidation.test.ts +0 -226
- package/src/__tests__/maintenance-locks.test.ts +0 -197
- package/src/__tests__/mcp-efficiency.test.ts +0 -288
- package/src/__tests__/mcp-related-scopes.test.ts +0 -151
- package/src/__tests__/memory-boundaries.test.ts +0 -282
- package/src/__tests__/memory-evolution-b2-b3-e1.test.ts +0 -362
- package/src/__tests__/memory-evolution.test.ts +0 -271
- package/src/__tests__/memory-health-rebalance.test.ts +0 -144
- package/src/__tests__/memory-lint.test.ts +0 -421
- package/src/__tests__/memory-output.test.ts +0 -224
- package/src/__tests__/memory-promotion.test.ts +0 -315
- package/src/__tests__/memory-utility.test.ts +0 -256
- package/src/__tests__/migrate-dedup-ids.test.ts +0 -65
- package/src/__tests__/multi-vector.test.ts +0 -242
- package/src/__tests__/narrative-architecture.test.ts +0 -456
- package/src/__tests__/noise-filter.test.ts +0 -205
- package/src/__tests__/noise-prototype-bank.test.ts +0 -280
- package/src/__tests__/obsidian-connector.test.ts +0 -363
- package/src/__tests__/omitted-reporting.test.ts +0 -98
- package/src/__tests__/openai-contract.test.ts +0 -513
- package/src/__tests__/pending-review.test.ts +0 -77
- package/src/__tests__/pii-redact.test.ts +0 -333
- package/src/__tests__/pivot-apply.test.ts +0 -373
- package/src/__tests__/pivot-distill-supervisor.test.ts +0 -457
- package/src/__tests__/pivot-distill.test.ts +0 -1178
- package/src/__tests__/post-retrieval-filter.test.ts +0 -178
- package/src/__tests__/ppr-traversal.test.ts +0 -256
- package/src/__tests__/prediction-engine.test.ts +0 -349
- package/src/__tests__/predictive-prospective-memory.test.ts +0 -416
- package/src/__tests__/preference-guard-smoke.test.ts +0 -211
- package/src/__tests__/preference-matcher.test.ts +0 -282
- package/src/__tests__/preference-slots.test.ts +0 -205
- package/src/__tests__/promotion-distinct-sources.test.ts +0 -162
- package/src/__tests__/prospective-memory.test.ts +0 -283
- package/src/__tests__/pull-from-macbook-sync-only.test.ts +0 -679
- package/src/__tests__/query-entity-detector.test.ts +0 -171
- package/src/__tests__/query-expander-alias.test.ts +0 -146
- package/src/__tests__/query-expander.test.ts +0 -34
- package/src/__tests__/recall-gate.test.ts +0 -266
- package/src/__tests__/recall-governor.test.ts +0 -227
- package/src/__tests__/recall-mode.test.ts +0 -64
- package/src/__tests__/resolve-db-path.test.ts +0 -130
- package/src/__tests__/resolve-tier.test.ts +0 -64
- package/src/__tests__/result-synthesizer.test.ts +0 -198
- package/src/__tests__/resume-context.test.ts +0 -4898
- package/src/__tests__/retrieval-eval.test.ts +0 -163
- package/src/__tests__/retrieval-trace.test.ts +0 -213
- package/src/__tests__/retrieve-audit-revision.test.ts +0 -255
- package/src/__tests__/retriever-boundary-weight.test.ts +0 -136
- package/src/__tests__/retriever-lazy-init-dispatch.test.ts +0 -123
- package/src/__tests__/retroactive-boost.test.ts +0 -223
- package/src/__tests__/salience-scoring.test.ts +0 -106
- package/src/__tests__/scope-inventory.test.ts +0 -200
- package/src/__tests__/scope-policy.test.ts +0 -69
- package/src/__tests__/scope-suggester.test.ts +0 -80
- package/src/__tests__/session-checkpoint.test.ts +0 -291
- package/src/__tests__/session-distiller.test.ts +0 -640
- package/src/__tests__/session-gc.test.ts +0 -215
- package/src/__tests__/skill-engine.test.ts +0 -552
- package/src/__tests__/skill-promotion.test.ts +0 -654
- package/src/__tests__/skill-verifier.test.ts +0 -122
- package/src/__tests__/source-heartbeat.test.ts +0 -254
- package/src/__tests__/stable-context-length-contract.test.ts +0 -62
- package/src/__tests__/store-patch-metadata.test.ts +0 -235
- package/src/__tests__/store-read-consistency.test.ts +0 -122
- package/src/__tests__/store-schema-migration.test.ts +0 -87
- package/src/__tests__/store-scope-audit.test.ts +0 -81
- package/src/__tests__/store-upsert.test.ts +0 -201
- package/src/__tests__/supersede-chain.test.ts +0 -154
- package/src/__tests__/synthesis-contract.test.ts +0 -252
- package/src/__tests__/synthesis-promotion.test.ts +0 -369
- package/src/__tests__/temporal-parser.test.ts +0 -241
- package/src/__tests__/temporal-validity.test.ts +0 -160
- package/src/__tests__/term-registry-terminal-roster.test.ts +0 -127
- package/src/__tests__/term-registry.test.ts +0 -121
- package/src/__tests__/tool-error-surfacing.test.ts +0 -98
- package/src/__tests__/tool-output-compressor.test.ts +0 -160
- package/src/__tests__/topic-tag.test.ts +0 -113
- package/src/__tests__/trusted-memory.test.ts +0 -867
- package/src/__tests__/ui-server-security.test.ts +0 -93
- package/src/__tests__/usage-tracker.test.ts +0 -287
- package/src/__tests__/utility-weight.test.ts +0 -57
- package/src/__tests__/verbatim-self-recall.test.ts +0 -279
- package/src/__tests__/version-manager.test.ts +0 -248
- package/src/__tests__/workflow-observation-skill-outcome.test.ts +0 -352
- package/src/__tests__/workflow-observation.test.ts +0 -433
- 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
|
-
});
|