recallnest 2.6.1 → 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 (207) hide show
  1. package/CHANGELOG.md +292 -0
  2. package/README.md +280 -195
  3. package/README_CN.md +266 -199
  4. package/config.json.example +8 -1
  5. package/docs/api-reference.md +1 -1
  6. package/integrations/README.md +1 -1
  7. package/integrations/agy/README.md +73 -0
  8. package/integrations/agy/setup.sh +75 -0
  9. package/integrations/setup-all.sh +1 -1
  10. package/package.json +7 -5
  11. package/src/access-tracker.ts +10 -1
  12. package/src/activity-counter.ts +69 -11
  13. package/src/age-label.ts +29 -0
  14. package/src/audit-log.ts +35 -0
  15. package/src/auto-gc.ts +97 -30
  16. package/src/capture-engine.ts +26 -4
  17. package/src/cli.ts +224 -10
  18. package/src/consolidation-engine.ts +317 -123
  19. package/src/context-composer-stable.ts +5 -1
  20. package/src/data-checkup.ts +17 -3
  21. package/src/dream-pipeline.ts +90 -12
  22. package/src/embedder.ts +44 -5
  23. package/src/env-config.ts +71 -0
  24. package/src/forget-engine.ts +8 -2
  25. package/src/gateway-server.ts +272 -0
  26. package/src/ingest.ts +248 -22
  27. package/src/kg-extractor.ts +17 -0
  28. package/src/llm-client.ts +86 -25
  29. package/src/mcp-server.ts +2 -1
  30. package/src/mcp-tools-advanced.ts +7 -2
  31. package/src/mcp-tools-core.ts +11 -1
  32. package/src/mcp-tools-governance.ts +45 -3
  33. package/src/memory-evolution.ts +16 -0
  34. package/src/memory-output.ts +47 -8
  35. package/src/memory-promotion.ts +280 -0
  36. package/src/memory-store-port.ts +32 -3
  37. package/src/memory-utility.ts +314 -0
  38. package/src/pivot-apply.ts +52 -1
  39. package/src/pivot-evidence.ts +128 -0
  40. package/src/ppr-traversal.ts +25 -1
  41. package/src/recall-ledger.ts +76 -0
  42. package/src/retriever.ts +82 -9
  43. package/src/runtime-config.ts +9 -0
  44. package/src/scope-policy.ts +22 -1
  45. package/src/session-engine.ts +11 -4
  46. package/src/session-output.ts +13 -4
  47. package/src/session-store.ts +2 -3
  48. package/src/skill-promotion.ts +218 -1
  49. package/src/store.ts +231 -71
  50. package/src/synthesis-contract.ts +286 -0
  51. package/src/version-manager.ts +83 -0
  52. package/src/workflow-observation-schema.ts +26 -0
  53. package/integrations/gemini-cli/README.md +0 -57
  54. package/integrations/gemini-cli/setup.sh +0 -64
  55. package/src/__tests__/access-tracker-novelty.test.ts +0 -304
  56. package/src/__tests__/activity-counter.test.ts +0 -125
  57. package/src/__tests__/adaptive-fidelity.test.ts +0 -102
  58. package/src/__tests__/admission-control.test.ts +0 -206
  59. package/src/__tests__/anchor-generator.test.ts +0 -67
  60. package/src/__tests__/api-server-security.test.ts +0 -102
  61. package/src/__tests__/auto-consolidation.test.ts +0 -168
  62. package/src/__tests__/auto-recall.test.ts +0 -131
  63. package/src/__tests__/babel-integration.test.ts +0 -144
  64. package/src/__tests__/batch-dedup.test.ts +0 -65
  65. package/src/__tests__/belief-history.test.ts +0 -220
  66. package/src/__tests__/canary-eval.test.ts +0 -114
  67. package/src/__tests__/capture-engine.test.ts +0 -1328
  68. package/src/__tests__/capture-heuristic.test.ts +0 -171
  69. package/src/__tests__/cascade-forget.test.ts +0 -210
  70. package/src/__tests__/category-min-scores.test.ts +0 -116
  71. package/src/__tests__/cc8-cc1-essential-context.test.ts +0 -298
  72. package/src/__tests__/circuit-breaker.test.ts +0 -99
  73. package/src/__tests__/cluster-consolidation.test.ts +0 -945
  74. package/src/__tests__/confidence-metadata.test.ts +0 -125
  75. package/src/__tests__/confidence-tracker.test.ts +0 -261
  76. package/src/__tests__/conflict-advisor.test.ts +0 -206
  77. package/src/__tests__/conflict-escalation.test.ts +0 -149
  78. package/src/__tests__/conflict-lifecycle.test.ts +0 -83
  79. package/src/__tests__/conflict-output.test.ts +0 -85
  80. package/src/__tests__/conflict-store.test.ts +0 -418
  81. package/src/__tests__/connector-v1.test.ts +0 -181
  82. package/src/__tests__/consolidation-engine.test.ts +0 -430
  83. package/src/__tests__/constructive-retrieval.test.ts +0 -509
  84. package/src/__tests__/context-collapse-renderer.test.ts +0 -214
  85. package/src/__tests__/context-composer-pins.test.ts +0 -64
  86. package/src/__tests__/context-composer-task-selection.test.ts +0 -24
  87. package/src/__tests__/context-reconstructor.test.ts +0 -65
  88. package/src/__tests__/context-renderer.test.ts +0 -91
  89. package/src/__tests__/continuity-eval.test.ts +0 -275
  90. package/src/__tests__/continuity-schema.test.ts +0 -97
  91. package/src/__tests__/contracts.test.ts +0 -262
  92. package/src/__tests__/conversation-importer.test.ts +0 -692
  93. package/src/__tests__/core-recall-eval.test.ts +0 -235
  94. package/src/__tests__/core-summary.test.ts +0 -109
  95. package/src/__tests__/data-checkup.test.ts +0 -276
  96. package/src/__tests__/decay-exemption.test.ts +0 -129
  97. package/src/__tests__/dedup-actions.test.ts +0 -58
  98. package/src/__tests__/dedup-guard.test.ts +0 -39
  99. package/src/__tests__/deterministic-id.test.ts +0 -39
  100. package/src/__tests__/distill-lock.test.ts +0 -305
  101. package/src/__tests__/distill-session-argshape.test.ts +0 -79
  102. package/src/__tests__/doctor.test.ts +0 -319
  103. package/src/__tests__/dream-pipeline.test.ts +0 -780
  104. package/src/__tests__/drill-down.test.ts +0 -108
  105. package/src/__tests__/embedder.test.ts +0 -122
  106. package/src/__tests__/emotion-decay.test.ts +0 -46
  107. package/src/__tests__/emotion-detector.test.ts +0 -56
  108. package/src/__tests__/emotion-phase1-integration.test.ts +0 -153
  109. package/src/__tests__/emotion-retrieval.test.ts +0 -56
  110. package/src/__tests__/entity-resolver.test.ts +0 -58
  111. package/src/__tests__/env-config.test.ts +0 -151
  112. package/src/__tests__/error-signature-boost.test.ts +0 -87
  113. package/src/__tests__/error-signature.test.ts +0 -95
  114. package/src/__tests__/error-taxonomy.test.ts +0 -129
  115. package/src/__tests__/ethics-layer.test.ts +0 -476
  116. package/src/__tests__/event-segmenter.test.ts +0 -153
  117. package/src/__tests__/feature-flags-integration.test.ts +0 -54
  118. package/src/__tests__/frequency-tracker.test.ts +0 -113
  119. package/src/__tests__/freshness.test.ts +0 -186
  120. package/src/__tests__/graph-export.test.ts +0 -489
  121. package/src/__tests__/hotness-blend.test.ts +0 -283
  122. package/src/__tests__/ingest-chunking.test.ts +0 -44
  123. package/src/__tests__/ingest.test.ts +0 -360
  124. package/src/__tests__/interference-detector.test.ts +0 -203
  125. package/src/__tests__/kg-extractor.test.ts +0 -192
  126. package/src/__tests__/kg-store.test.ts +0 -300
  127. package/src/__tests__/llm-client-pivot.test.ts +0 -628
  128. package/src/__tests__/llm-consolidation.test.ts +0 -226
  129. package/src/__tests__/maintenance-locks.test.ts +0 -189
  130. package/src/__tests__/mcp-efficiency.test.ts +0 -288
  131. package/src/__tests__/mcp-related-scopes.test.ts +0 -151
  132. package/src/__tests__/memory-boundaries.test.ts +0 -282
  133. package/src/__tests__/memory-evolution-b2-b3-e1.test.ts +0 -345
  134. package/src/__tests__/memory-evolution.test.ts +0 -271
  135. package/src/__tests__/memory-health-rebalance.test.ts +0 -144
  136. package/src/__tests__/memory-lint.test.ts +0 -421
  137. package/src/__tests__/memory-output.test.ts +0 -215
  138. package/src/__tests__/memory-promotion.test.ts +0 -315
  139. package/src/__tests__/migrate-dedup-ids.test.ts +0 -65
  140. package/src/__tests__/multi-vector.test.ts +0 -242
  141. package/src/__tests__/narrative-architecture.test.ts +0 -456
  142. package/src/__tests__/noise-filter.test.ts +0 -205
  143. package/src/__tests__/noise-prototype-bank.test.ts +0 -280
  144. package/src/__tests__/obsidian-connector.test.ts +0 -363
  145. package/src/__tests__/omitted-reporting.test.ts +0 -98
  146. package/src/__tests__/pending-review.test.ts +0 -77
  147. package/src/__tests__/pii-redact.test.ts +0 -333
  148. package/src/__tests__/pivot-apply.test.ts +0 -373
  149. package/src/__tests__/pivot-distill-supervisor.test.ts +0 -457
  150. package/src/__tests__/pivot-distill.test.ts +0 -1178
  151. package/src/__tests__/post-retrieval-filter.test.ts +0 -178
  152. package/src/__tests__/ppr-traversal.test.ts +0 -256
  153. package/src/__tests__/prediction-engine.test.ts +0 -349
  154. package/src/__tests__/predictive-prospective-memory.test.ts +0 -416
  155. package/src/__tests__/preference-guard-smoke.test.ts +0 -211
  156. package/src/__tests__/preference-matcher.test.ts +0 -282
  157. package/src/__tests__/preference-slots.test.ts +0 -205
  158. package/src/__tests__/prospective-memory.test.ts +0 -283
  159. package/src/__tests__/pull-from-macbook-sync-only.test.ts +0 -679
  160. package/src/__tests__/query-entity-detector.test.ts +0 -171
  161. package/src/__tests__/query-expander-alias.test.ts +0 -146
  162. package/src/__tests__/query-expander.test.ts +0 -34
  163. package/src/__tests__/recall-gate.test.ts +0 -266
  164. package/src/__tests__/recall-governor.test.ts +0 -227
  165. package/src/__tests__/recall-mode.test.ts +0 -64
  166. package/src/__tests__/resolve-db-path.test.ts +0 -130
  167. package/src/__tests__/resolve-tier.test.ts +0 -64
  168. package/src/__tests__/result-synthesizer.test.ts +0 -198
  169. package/src/__tests__/resume-context.test.ts +0 -4898
  170. package/src/__tests__/retrieval-eval.test.ts +0 -163
  171. package/src/__tests__/retrieval-trace.test.ts +0 -213
  172. package/src/__tests__/retriever-boundary-weight.test.ts +0 -136
  173. package/src/__tests__/retriever-lazy-init-dispatch.test.ts +0 -123
  174. package/src/__tests__/retroactive-boost.test.ts +0 -223
  175. package/src/__tests__/salience-scoring.test.ts +0 -106
  176. package/src/__tests__/scope-inventory.test.ts +0 -200
  177. package/src/__tests__/scope-policy.test.ts +0 -69
  178. package/src/__tests__/scope-suggester.test.ts +0 -80
  179. package/src/__tests__/session-checkpoint.test.ts +0 -291
  180. package/src/__tests__/session-distiller.test.ts +0 -640
  181. package/src/__tests__/session-gc.test.ts +0 -215
  182. package/src/__tests__/skill-engine.test.ts +0 -552
  183. package/src/__tests__/skill-promotion.test.ts +0 -654
  184. package/src/__tests__/skill-verifier.test.ts +0 -122
  185. package/src/__tests__/source-heartbeat.test.ts +0 -250
  186. package/src/__tests__/stable-context-length-contract.test.ts +0 -62
  187. package/src/__tests__/store-patch-metadata.test.ts +0 -205
  188. package/src/__tests__/store-read-consistency.test.ts +0 -122
  189. package/src/__tests__/store-schema-migration.test.ts +0 -87
  190. package/src/__tests__/store-scope-audit.test.ts +0 -81
  191. package/src/__tests__/store-upsert.test.ts +0 -201
  192. package/src/__tests__/supersede-chain.test.ts +0 -154
  193. package/src/__tests__/temporal-parser.test.ts +0 -241
  194. package/src/__tests__/temporal-validity.test.ts +0 -160
  195. package/src/__tests__/term-registry-terminal-roster.test.ts +0 -127
  196. package/src/__tests__/term-registry.test.ts +0 -121
  197. package/src/__tests__/tool-error-surfacing.test.ts +0 -98
  198. package/src/__tests__/tool-output-compressor.test.ts +0 -160
  199. package/src/__tests__/topic-tag.test.ts +0 -113
  200. package/src/__tests__/trusted-memory.test.ts +0 -839
  201. package/src/__tests__/ui-server-security.test.ts +0 -93
  202. package/src/__tests__/usage-tracker.test.ts +0 -287
  203. package/src/__tests__/version-manager.test.ts +0 -213
  204. package/src/__tests__/workflow-observation-skill-outcome.test.ts +0 -352
  205. package/src/__tests__/workflow-observation.test.ts +0 -433
  206. package/src/__tests__/write-verifier.test.ts +0 -122
  207. /package/integrations/{gemini-cli/gemini-md-snippet.md → agy/agy-md-snippet.md} +0 -0
@@ -1,283 +0,0 @@
1
- /**
2
- * Tests for Tier 3.4: Prospective Memory (Conditional Trigger Reminders)
3
- *
4
- * Validates:
5
- * 1. setReminder creates a properly structured memory entry
6
- * 2. checkTriggers finds matching pending reminders
7
- * 3. checkTriggers ignores fired/expired reminders
8
- * 4. fireReminder marks the reminder as fired
9
- * 5. formatReminders produces readable output
10
- * 6. Trigger matching uses keyword logic
11
- * 7. Expiration is handled correctly
12
- */
13
- import { describe, expect, it } from "bun:test";
14
- import {
15
- setReminder,
16
- checkTriggers,
17
- fireReminder,
18
- formatReminders,
19
- } from "../prospective-memory.js";
20
- import type { MemoryEntry, MemorySearchResult } from "../store.js";
21
-
22
- // ---------------------------------------------------------------------------
23
- // Helpers
24
- // ---------------------------------------------------------------------------
25
-
26
- function createMockStore() {
27
- const data = new Map<string, MemoryEntry>();
28
- let idCounter = 0;
29
-
30
- return {
31
- data,
32
- async store(entry: Omit<MemoryEntry, "id" | "timestamp">) {
33
- const id = `reminder-${++idCounter}`;
34
- const full: MemoryEntry = {
35
- ...entry,
36
- id,
37
- timestamp: Date.now(),
38
- } as MemoryEntry;
39
- data.set(id, full);
40
- return full;
41
- },
42
- async vectorSearch(
43
- _vector: number[],
44
- _limit: number,
45
- _minScore: number,
46
- _scopeFilter?: string[],
47
- ): Promise<MemorySearchResult[]> {
48
- return [...data.values()].map(e => ({ entry: e, score: 0.8 }));
49
- },
50
- async getById(id: string) {
51
- return data.get(id) ?? null;
52
- },
53
- async update(id: string, upd: { metadata?: string; text?: string }, _scope?: string[]) {
54
- const entry = data.get(id);
55
- if (!entry) return null;
56
- if (upd.metadata) entry.metadata = upd.metadata;
57
- if (upd.text) entry.text = upd.text;
58
- return entry;
59
- },
60
- };
61
- }
62
-
63
- function createMockEmbedder() {
64
- return {
65
- async embedPassage(_text: string) {
66
- return [0.1, 0.2, 0.3];
67
- },
68
- async embedBatchPassage(texts: string[]) {
69
- return texts.map(() => [0.1, 0.2, 0.3]);
70
- },
71
- };
72
- }
73
-
74
- // ---------------------------------------------------------------------------
75
- // setReminder
76
- // ---------------------------------------------------------------------------
77
-
78
- describe("setReminder", () => {
79
- it("creates a reminder with prospective metadata", async () => {
80
- const store = createMockStore();
81
- const embedder = createMockEmbedder();
82
-
83
- const entry = await setReminder(store as any, embedder as any, {
84
- trigger: "deployment",
85
- action: "Check the monitoring dashboard after deploy",
86
- scope: "project:test",
87
- });
88
-
89
- expect(entry.id).toBeTruthy();
90
- expect(entry.category).toBe("patterns");
91
- expect(entry.text).toContain("Reminder");
92
- expect(entry.text).toContain("deployment");
93
-
94
- const meta = JSON.parse(entry.metadata);
95
- expect(meta.prospective.trigger).toBe("deployment");
96
- expect(meta.prospective.action).toBe("Check the monitoring dashboard after deploy");
97
- expect(meta.prospective.status).toBe("pending");
98
- });
99
-
100
- it("creates a reminder with expiration", async () => {
101
- const store = createMockStore();
102
- const embedder = createMockEmbedder();
103
-
104
- const entry = await setReminder(store as any, embedder as any, {
105
- trigger: "release",
106
- action: "Update changelog",
107
- scope: "project:test",
108
- expiresInDays: 7,
109
- });
110
-
111
- const meta = JSON.parse(entry.metadata);
112
- expect(meta.prospective.expiresAt).toBeTruthy();
113
- // Should expire roughly 7 days from now
114
- const expiresAt = new Date(meta.prospective.expiresAt).getTime();
115
- const now = Date.now();
116
- const sevenDays = 7 * 86_400_000;
117
- expect(expiresAt - now).toBeGreaterThan(sevenDays - 60_000);
118
- expect(expiresAt - now).toBeLessThan(sevenDays + 60_000);
119
- });
120
- });
121
-
122
- // ---------------------------------------------------------------------------
123
- // checkTriggers
124
- // ---------------------------------------------------------------------------
125
-
126
- describe("checkTriggers", () => {
127
- it("finds matching pending reminders", async () => {
128
- const store = createMockStore();
129
- const embedder = createMockEmbedder();
130
-
131
- await setReminder(store as any, embedder as any, {
132
- trigger: "deployment",
133
- action: "Check monitoring",
134
- scope: "project:test",
135
- });
136
-
137
- const reminders = await checkTriggers(
138
- store as any,
139
- embedder as any,
140
- "We need to do a deployment today",
141
- );
142
-
143
- expect(reminders.length).toBe(1);
144
- expect(reminders[0].action).toBe("Check monitoring");
145
- });
146
-
147
- it("ignores non-matching queries", async () => {
148
- const store = createMockStore();
149
- const embedder = createMockEmbedder();
150
-
151
- await setReminder(store as any, embedder as any, {
152
- trigger: "deployment",
153
- action: "Check monitoring",
154
- scope: "project:test",
155
- });
156
-
157
- const reminders = await checkTriggers(
158
- store as any,
159
- embedder as any,
160
- "Let me review the code changes",
161
- );
162
-
163
- expect(reminders.length).toBe(0);
164
- });
165
-
166
- it("ignores fired reminders", async () => {
167
- const store = createMockStore();
168
- const embedder = createMockEmbedder();
169
-
170
- const entry = await setReminder(store as any, embedder as any, {
171
- trigger: "deployment",
172
- action: "Check monitoring",
173
- scope: "project:test",
174
- });
175
-
176
- // Fire the reminder
177
- await fireReminder(store as any, entry.id);
178
-
179
- const reminders = await checkTriggers(
180
- store as any,
181
- embedder as any,
182
- "deployment is happening",
183
- );
184
-
185
- expect(reminders.length).toBe(0);
186
- });
187
-
188
- it("handles expired reminders", async () => {
189
- const store = createMockStore();
190
- const embedder = createMockEmbedder();
191
-
192
- // Create a reminder that's already expired
193
- const entry = await setReminder(store as any, embedder as any, {
194
- trigger: "something",
195
- action: "do something",
196
- scope: "project:test",
197
- });
198
-
199
- // Manually set expiresAt to past
200
- const meta = JSON.parse(entry.metadata);
201
- meta.prospective.expiresAt = "2020-01-01T00:00:00Z";
202
- entry.metadata = JSON.stringify(meta);
203
-
204
- const reminders = await checkTriggers(
205
- store as any,
206
- embedder as any,
207
- "something came up",
208
- );
209
-
210
- expect(reminders.length).toBe(0);
211
- // Should be marked as expired
212
- const updated = JSON.parse(entry.metadata);
213
- expect(updated.prospective.status).toBe("expired");
214
- });
215
- });
216
-
217
- // ---------------------------------------------------------------------------
218
- // fireReminder
219
- // ---------------------------------------------------------------------------
220
-
221
- describe("fireReminder", () => {
222
- it("marks reminder as fired and returns action", async () => {
223
- const store = createMockStore();
224
- const embedder = createMockEmbedder();
225
-
226
- const entry = await setReminder(store as any, embedder as any, {
227
- trigger: "test",
228
- action: "do the thing",
229
- scope: "project:test",
230
- });
231
-
232
- const action = await fireReminder(store as any, entry.id);
233
-
234
- expect(action).toBe("do the thing");
235
- const meta = JSON.parse(store.data.get(entry.id)!.metadata);
236
- expect(meta.prospective.status).toBe("fired");
237
- expect(meta.prospective.firedAt).toBeTruthy();
238
- });
239
-
240
- it("returns null for non-existent entry", async () => {
241
- const store = createMockStore();
242
- const action = await fireReminder(store as any, "nonexistent");
243
- expect(action).toBeNull();
244
- });
245
-
246
- it("returns null for already-fired reminder", async () => {
247
- const store = createMockStore();
248
- const embedder = createMockEmbedder();
249
-
250
- const entry = await setReminder(store as any, embedder as any, {
251
- trigger: "test",
252
- action: "do it",
253
- scope: "project:test",
254
- });
255
-
256
- await fireReminder(store as any, entry.id);
257
- const secondFire = await fireReminder(store as any, entry.id);
258
-
259
- expect(secondFire).toBeNull();
260
- });
261
- });
262
-
263
- // ---------------------------------------------------------------------------
264
- // formatReminders
265
- // ---------------------------------------------------------------------------
266
-
267
- describe("formatReminders", () => {
268
- it("formats reminders for context injection", () => {
269
- const formatted = formatReminders([
270
- { entryId: "r1", trigger: "deploy", action: "Check monitoring after deploy" },
271
- { entryId: "r2", trigger: "meeting", action: "Bring up the budget issue" },
272
- ]);
273
-
274
- expect(formatted.length).toBe(2);
275
- expect(formatted[0]).toContain("deploy");
276
- expect(formatted[0]).toContain("Check monitoring after deploy");
277
- expect(formatted[1]).toContain("meeting");
278
- });
279
-
280
- it("handles empty array", () => {
281
- expect(formatReminders([])).toEqual([]);
282
- });
283
- });