@aria-cli/tools 1.0.9 → 1.0.11

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 (241) hide show
  1. package/package.json +9 -5
  2. package/src/__tests__/web-fetch-download.test.ts +0 -433
  3. package/src/__tests__/web-tools.test.ts +0 -619
  4. package/src/ask-user-interaction.ts +0 -33
  5. package/src/cache/web-cache.ts +0 -110
  6. package/src/definitions/arion.ts +0 -118
  7. package/src/definitions/browser/browser.ts +0 -502
  8. package/src/definitions/browser/index.ts +0 -5
  9. package/src/definitions/browser/pw-downloads.ts +0 -142
  10. package/src/definitions/browser/pw-interactions.ts +0 -282
  11. package/src/definitions/browser/pw-responses.ts +0 -98
  12. package/src/definitions/browser/pw-session.ts +0 -405
  13. package/src/definitions/browser/pw-shared.ts +0 -85
  14. package/src/definitions/browser/pw-snapshot.ts +0 -383
  15. package/src/definitions/browser/pw-state.ts +0 -101
  16. package/src/definitions/browser/types.ts +0 -203
  17. package/src/definitions/code-intelligence.ts +0 -526
  18. package/src/definitions/core.ts +0 -118
  19. package/src/definitions/delegation.ts +0 -567
  20. package/src/definitions/deploy.ts +0 -73
  21. package/src/definitions/filesystem.ts +0 -217
  22. package/src/definitions/frg.ts +0 -67
  23. package/src/definitions/index.ts +0 -28
  24. package/src/definitions/memory.ts +0 -150
  25. package/src/definitions/messaging.ts +0 -734
  26. package/src/definitions/meta.ts +0 -392
  27. package/src/definitions/network.ts +0 -179
  28. package/src/definitions/outlook.ts +0 -318
  29. package/src/definitions/patch/apply-patch.ts +0 -235
  30. package/src/definitions/patch/fuzzy-match.ts +0 -217
  31. package/src/definitions/patch/index.ts +0 -1
  32. package/src/definitions/patch/patch-parser.ts +0 -297
  33. package/src/definitions/patch/sandbox-paths.ts +0 -129
  34. package/src/definitions/process/index.ts +0 -5
  35. package/src/definitions/process/process-registry.ts +0 -303
  36. package/src/definitions/process/process.ts +0 -456
  37. package/src/definitions/process/pty-keys.ts +0 -298
  38. package/src/definitions/process/session-slug.ts +0 -147
  39. package/src/definitions/quip.ts +0 -225
  40. package/src/definitions/search.ts +0 -67
  41. package/src/definitions/session-history.ts +0 -79
  42. package/src/definitions/shell.ts +0 -202
  43. package/src/definitions/slack.ts +0 -211
  44. package/src/definitions/web.ts +0 -119
  45. package/src/executors/apply-patch.ts +0 -1035
  46. package/src/executors/arion.ts +0 -199
  47. package/src/executors/code-intelligence.ts +0 -1179
  48. package/src/executors/deploy.ts +0 -1066
  49. package/src/executors/filesystem.ts +0 -1428
  50. package/src/executors/frg-freshness.ts +0 -743
  51. package/src/executors/frg.ts +0 -394
  52. package/src/executors/index.ts +0 -280
  53. package/src/executors/learning-meta.ts +0 -1367
  54. package/src/executors/lsp-client.ts +0 -355
  55. package/src/executors/memory.ts +0 -978
  56. package/src/executors/meta.ts +0 -293
  57. package/src/executors/process-registry.ts +0 -570
  58. package/src/executors/pty-session-store.ts +0 -43
  59. package/src/executors/pty.ts +0 -342
  60. package/src/executors/restart.ts +0 -133
  61. package/src/executors/search-freshness.ts +0 -249
  62. package/src/executors/search-types.ts +0 -98
  63. package/src/executors/search.ts +0 -89
  64. package/src/executors/self-diagnose.ts +0 -552
  65. package/src/executors/session-history.ts +0 -435
  66. package/src/executors/shell-safety.ts +0 -519
  67. package/src/executors/shell.ts +0 -1243
  68. package/src/executors/utils.ts +0 -40
  69. package/src/executors/web.ts +0 -786
  70. package/src/extraction/content-extraction.ts +0 -281
  71. package/src/extraction/index.ts +0 -5
  72. package/src/headless-control-contract.ts +0 -1149
  73. package/src/index.ts +0 -788
  74. package/src/local-control-http-auth.ts +0 -2
  75. package/src/mcp/client.ts +0 -218
  76. package/src/mcp/connection.ts +0 -568
  77. package/src/mcp/index.ts +0 -11
  78. package/src/mcp/jsonrpc.ts +0 -195
  79. package/src/mcp/types.ts +0 -199
  80. package/src/network-control-adapter.ts +0 -88
  81. package/src/network-runtime/address-types.ts +0 -218
  82. package/src/network-runtime/db-owner-fencing.ts +0 -91
  83. package/src/network-runtime/delivery-receipts.ts +0 -372
  84. package/src/network-runtime/direct-endpoint-authority.ts +0 -35
  85. package/src/network-runtime/index.ts +0 -316
  86. package/src/network-runtime/local-control-contract.ts +0 -784
  87. package/src/network-runtime/node-store-contract.ts +0 -46
  88. package/src/network-runtime/pair-route-contract.ts +0 -97
  89. package/src/network-runtime/peer-capabilities.ts +0 -48
  90. package/src/network-runtime/peer-principal-ref.ts +0 -20
  91. package/src/network-runtime/peer-state-machine.ts +0 -160
  92. package/src/network-runtime/protocol-schemas.ts +0 -265
  93. package/src/network-runtime/runtime-bootstrap-contract.ts +0 -83
  94. package/src/outlook/desktop-session.ts +0 -409
  95. package/src/policy.ts +0 -171
  96. package/src/providers/brave.ts +0 -80
  97. package/src/providers/duckduckgo.ts +0 -199
  98. package/src/providers/exa.ts +0 -85
  99. package/src/providers/firecrawl.ts +0 -77
  100. package/src/providers/index.ts +0 -8
  101. package/src/providers/jina.ts +0 -70
  102. package/src/providers/router.ts +0 -121
  103. package/src/providers/search-provider.ts +0 -74
  104. package/src/providers/tavily.ts +0 -74
  105. package/src/quip/desktop-session.ts +0 -435
  106. package/src/registry/index.ts +0 -1
  107. package/src/registry/registry.ts +0 -905
  108. package/src/runtime-socket-local-control-client.ts +0 -632
  109. package/src/security/dns-normalization.ts +0 -34
  110. package/src/security/dns-pinning.ts +0 -138
  111. package/src/security/external-content.ts +0 -129
  112. package/src/security/ssrf.ts +0 -207
  113. package/src/slack/desktop-session.ts +0 -493
  114. package/src/tool-factory.ts +0 -91
  115. package/src/types.ts +0 -1341
  116. package/src/utils/retry.ts +0 -163
  117. package/src/utils/safe-parse-json.ts +0 -176
  118. package/src/utils/url.ts +0 -20
  119. package/tests/benchmarks/registry.bench.ts +0 -57
  120. package/tests/cache/web-cache.test.ts +0 -147
  121. package/tests/critical-integration.test.ts +0 -1465
  122. package/tests/definitions/apply-patch.test.ts +0 -586
  123. package/tests/definitions/browser.test.ts +0 -495
  124. package/tests/definitions/delegation-pause-resume.test.ts +0 -758
  125. package/tests/definitions/execution.test.ts +0 -671
  126. package/tests/definitions/messaging-inbox-scope.test.ts +0 -229
  127. package/tests/definitions/messaging.test.ts +0 -1468
  128. package/tests/definitions/outlook.test.ts +0 -30
  129. package/tests/definitions/process.test.ts +0 -469
  130. package/tests/definitions/slack.test.ts +0 -28
  131. package/tests/definitions/tool-inventory.test.ts +0 -218
  132. package/tests/e2e/delegation-quest-orchestration.e2e.test.ts +0 -433
  133. package/tests/e2e/memory-tool-discovery-contract.e2e.test.ts +0 -81
  134. package/tests/executors/apply-patch.test.ts +0 -538
  135. package/tests/executors/arion.test.ts +0 -309
  136. package/tests/executors/conversation-primitives.test.ts +0 -250
  137. package/tests/executors/deploy.test.ts +0 -746
  138. package/tests/executors/filesystem-tools.test.ts +0 -357
  139. package/tests/executors/filesystem.test.ts +0 -959
  140. package/tests/executors/frg-freshness.test.ts +0 -136
  141. package/tests/executors/frg-merge.test.ts +0 -70
  142. package/tests/executors/frg-session-content.test.ts +0 -40
  143. package/tests/executors/frg.test.ts +0 -56
  144. package/tests/executors/memory-bugfixes.test.ts +0 -257
  145. package/tests/executors/memory-real-memoria.integration.test.ts +0 -316
  146. package/tests/executors/memory.test.ts +0 -853
  147. package/tests/executors/meta-tools.test.ts +0 -411
  148. package/tests/executors/meta.test.ts +0 -683
  149. package/tests/executors/path-containment.test.ts +0 -51
  150. package/tests/executors/process-registry.test.ts +0 -505
  151. package/tests/executors/pty.test.ts +0 -664
  152. package/tests/executors/quest-security.test.ts +0 -249
  153. package/tests/executors/read-file-media.test.ts +0 -230
  154. package/tests/executors/recall-knowledge-schema.test.ts +0 -209
  155. package/tests/executors/recall-tags.test.ts +0 -278
  156. package/tests/executors/remember-null-safety.contract.test.ts +0 -41
  157. package/tests/executors/restart.test.ts +0 -67
  158. package/tests/executors/search-unified.test.ts +0 -381
  159. package/tests/executors/session-history.test.ts +0 -340
  160. package/tests/executors/session-transcript.test.ts +0 -561
  161. package/tests/executors/shell-abort.test.ts +0 -416
  162. package/tests/executors/shell-env-blocklist.test.ts +0 -648
  163. package/tests/executors/shell-env-process.test.ts +0 -245
  164. package/tests/executors/shell-process-registry.test.ts +0 -334
  165. package/tests/executors/shell-tools.test.ts +0 -393
  166. package/tests/executors/shell.test.ts +0 -690
  167. package/tests/executors/web-abort-vs-timeout.test.ts +0 -213
  168. package/tests/executors/web-integration.test.ts +0 -633
  169. package/tests/executors/web-symlink.test.ts +0 -18
  170. package/tests/executors/web.test.ts +0 -1400
  171. package/tests/executors/write-stdin.test.ts +0 -145
  172. package/tests/extraction/content-extraction.test.ts +0 -153
  173. package/tests/guards/tools-default-test-lane.integration.test.ts +0 -21
  174. package/tests/guards/tools-package-test-commands.e2e.test.ts +0 -43
  175. package/tests/guards/tools-test-lane-manifest.contract.test.ts +0 -76
  176. package/tests/guards/tools-vitest-workspace-alias.contract.test.ts +0 -63
  177. package/tests/helpers/async-waits.ts +0 -53
  178. package/tests/integration/headless-control-contract.integration.test.ts +0 -153
  179. package/tests/integration/memory-tool-schema-parity.integration.test.ts +0 -67
  180. package/tests/integration/meta-tools-round-trip.integration.test.ts +0 -506
  181. package/tests/integration/quest-round-trip.test.ts +0 -303
  182. package/tests/integration/registry-executor-flow.test.ts +0 -85
  183. package/tests/integration.test.ts +0 -177
  184. package/tests/loading-tier.test.ts +0 -126
  185. package/tests/mcp/client-reconnect.test.ts +0 -267
  186. package/tests/mcp/connection.test.ts +0 -846
  187. package/tests/mcp/injectable-logger.test.ts +0 -83
  188. package/tests/mcp/jsonrpc.test.ts +0 -109
  189. package/tests/mcp/lifecycle.test.ts +0 -879
  190. package/tests/network-runtime/address-types.contract.test.ts +0 -143
  191. package/tests/network-runtime/continuity-bind-schema.contract.test.ts +0 -203
  192. package/tests/network-runtime/local-control-contract.test.ts +0 -869
  193. package/tests/network-runtime/local-control-invite-token.contract.test.ts +0 -146
  194. package/tests/network-runtime/node-store-contract.test.ts +0 -11
  195. package/tests/network-runtime/pair-protocol-nodeid.contract.test.ts +0 -15
  196. package/tests/network-runtime/peer-state-machine.contract.test.ts +0 -148
  197. package/tests/network-runtime/protocol-schemas.contract.test.ts +0 -512
  198. package/tests/network-runtime/relay-pending-nodeid.contract.test.ts +0 -62
  199. package/tests/network-runtime/runtime-bootstrap-contract.test.ts +0 -227
  200. package/tests/network-runtime/runtime-socket-local-control-client.test.ts +0 -621
  201. package/tests/network-runtime/wait-for-message-script.test.ts +0 -288
  202. package/tests/parallel.test.ts +0 -71
  203. package/tests/policy.test.ts +0 -184
  204. package/tests/print-default-test-lane.ts +0 -14
  205. package/tests/print-test-lane-manifest.ts +0 -22
  206. package/tests/providers/brave.test.ts +0 -159
  207. package/tests/providers/duckduckgo.test.ts +0 -207
  208. package/tests/providers/exa.test.ts +0 -175
  209. package/tests/providers/firecrawl.test.ts +0 -168
  210. package/tests/providers/jina.test.ts +0 -144
  211. package/tests/providers/router.test.ts +0 -328
  212. package/tests/providers/tavily.test.ts +0 -165
  213. package/tests/registry/discovery.test.ts +0 -154
  214. package/tests/registry/injectable-logger.test.ts +0 -230
  215. package/tests/registry/input-validation.test.ts +0 -361
  216. package/tests/registry/interface-completeness.test.ts +0 -85
  217. package/tests/registry/mcp-integration.test.ts +0 -103
  218. package/tests/registry/mcp-read-only-hint.test.ts +0 -60
  219. package/tests/registry/memoria-discovery.test.ts +0 -390
  220. package/tests/registry/nested-validation.test.ts +0 -283
  221. package/tests/registry/pseudo-tool-filtering.test.ts +0 -258
  222. package/tests/registry/registration-lifecycle.test.ts +0 -133
  223. package/tests/registry-validation.test.ts +0 -424
  224. package/tests/registry.test.ts +0 -460
  225. package/tests/security/dns-pinning.test.ts +0 -162
  226. package/tests/security/external-content.test.ts +0 -144
  227. package/tests/security/ssrf.test.ts +0 -118
  228. package/tests/shell-safety-integration.test.ts +0 -32
  229. package/tests/shell-safety.test.ts +0 -365
  230. package/tests/slack/desktop-session.test.ts +0 -50
  231. package/tests/test-lane-manifest.ts +0 -440
  232. package/tests/test-utils.ts +0 -27
  233. package/tests/tool-factory.test.ts +0 -188
  234. package/tests/utils/retry.test.ts +0 -231
  235. package/tests/utils/url.test.ts +0 -63
  236. package/tsconfig.cjs.json +0 -24
  237. package/tsconfig.json +0 -12
  238. package/vitest.config.ts +0 -55
  239. package/vitest.e2e.config.ts +0 -24
  240. package/vitest.integration.config.ts +0 -24
  241. package/vitest.native.config.ts +0 -24
@@ -1,853 +0,0 @@
1
- /**
2
- * @aria/tools - Memory executor tests
3
- */
4
-
5
- import { describe, it, expect, beforeEach, vi } from "vitest";
6
- import type { ToolContext } from "../../src/types.js";
7
- import {
8
- executeRemember,
9
- executeRecall,
10
- executeForget,
11
- executeDiscover,
12
- executeReflect,
13
- } from "../../src/executors/memory.js";
14
-
15
- // Mock Memoria interface matching @aria/memoria
16
- interface MockMemory {
17
- id: string;
18
- content: string;
19
- importance: number;
20
- metadata?: Record<string, unknown>;
21
- }
22
-
23
- interface MockKnowledge {
24
- id: string;
25
- name: string;
26
- description: string;
27
- tags: string[];
28
- source?: { type: string; [key: string]: unknown };
29
- }
30
-
31
- // Helper to create a mock Memoria instance
32
- const createMockMemoria = () => ({
33
- remember: vi.fn(),
34
- recall: vi.fn(),
35
- recallTools: vi.fn(),
36
- rememberSkill: vi.fn().mockResolvedValue("skill-id"),
37
- recallSkills: vi.fn().mockResolvedValue([]),
38
- getSkill: vi.fn().mockResolvedValue(null),
39
- recordSkillExecution: vi
40
- .fn()
41
- .mockResolvedValue({ id: "exec-1", skillId: "s1", success: true, timestamp: new Date() }),
42
- deleteMemory: vi.fn(),
43
- });
44
-
45
- // Helper to create a mock router
46
- const createMockRouter = () => ({
47
- chat: vi.fn().mockResolvedValue({ content: "{}" }),
48
- });
49
-
50
- // Helper to create a context with mock Memoria
51
- const createContext = (
52
- workingDir: string,
53
- memoria?: ReturnType<typeof createMockMemoria>,
54
- overrides?: Partial<ToolContext>,
55
- ): ToolContext => ({
56
- workingDir,
57
- memoria,
58
- env: {},
59
- confirm: async () => true,
60
- ...overrides,
61
- });
62
-
63
- describe("Memory Executors", () => {
64
- let mockMemoria: ReturnType<typeof createMockMemoria>;
65
- let ctx: ToolContext;
66
-
67
- beforeEach(() => {
68
- mockMemoria = createMockMemoria();
69
- mockMemoria.recallTools.mockResolvedValue([]);
70
- mockMemoria.recallSkills.mockResolvedValue([]);
71
- ctx = createContext("/test/dir", mockMemoria);
72
- });
73
-
74
- describe("executeRemember", () => {
75
- it("should store content in memoria with id returned", async () => {
76
- const mockResult: MockMemory = {
77
- id: "mem-123",
78
- content: "Test content to remember",
79
- importance: 0.8,
80
- };
81
- mockMemoria.remember.mockResolvedValue(mockResult);
82
-
83
- const result = await executeRemember({ content: "Test content to remember" }, ctx);
84
-
85
- expect(result.success).toBe(true);
86
- expect(result.data).toEqual({ id: "mem-123" });
87
- expect(mockMemoria.remember).toHaveBeenCalledWith("Test content to remember", {});
88
- });
89
-
90
- it("should pass importance when provided", async () => {
91
- const mockResult: MockMemory = {
92
- id: "mem-789",
93
- content: "Important content",
94
- importance: 0.95,
95
- };
96
- mockMemoria.remember.mockResolvedValue(mockResult);
97
-
98
- const result = await executeRemember({ content: "Important content", importance: 0.95 }, ctx);
99
-
100
- expect(result.success).toBe(true);
101
- expect(mockMemoria.remember).toHaveBeenCalledWith("Important content", {
102
- importance: 0.95,
103
- });
104
- });
105
-
106
- it("should return error when memoria is not available", async () => {
107
- const ctxNoMemoria = createContext("/test/dir");
108
-
109
- const result = await executeRemember({ content: "Test content" }, ctxNoMemoria);
110
-
111
- expect(result.success).toBe(false);
112
- expect(result.message).toContain("Memoria");
113
- });
114
-
115
- it("should return error when content is empty", async () => {
116
- const result = await executeRemember({ content: "" }, ctx);
117
-
118
- expect(result.success).toBe(false);
119
- expect(result.message).toContain("content");
120
- });
121
-
122
- it("should return error when importance is below 0.0", async () => {
123
- const result = await executeRemember({ content: "Test content", importance: -0.1 }, ctx);
124
-
125
- expect(result.success).toBe(false);
126
- expect(result.message).toContain("importance must be between 0.0 and 1.0");
127
- });
128
-
129
- it("should return error when importance is above 1.0", async () => {
130
- const result = await executeRemember({ content: "Test content", importance: 1.5 }, ctx);
131
-
132
- expect(result.success).toBe(false);
133
- expect(result.message).toContain("importance must be between 0.0 and 1.0");
134
- });
135
-
136
- it("should accept importance at boundary values (0.0 and 1.0)", async () => {
137
- const mockResult: MockMemory = {
138
- id: "mem-boundary",
139
- content: "Boundary test",
140
- importance: 0.0,
141
- };
142
- mockMemoria.remember.mockResolvedValue(mockResult);
143
-
144
- // Test 0.0
145
- const result0 = await executeRemember({ content: "Boundary test", importance: 0.0 }, ctx);
146
- expect(result0.success).toBe(true);
147
-
148
- // Test 1.0
149
- mockResult.importance = 1.0;
150
- const result1 = await executeRemember({ content: "Boundary test", importance: 1.0 }, ctx);
151
- expect(result1.success).toBe(true);
152
- });
153
-
154
- it("should return error when importance is NaN", async () => {
155
- const result = await executeRemember({ content: "Test content", importance: NaN }, ctx);
156
-
157
- expect(result.success).toBe(false);
158
- expect(result.message).toContain("importance must be a finite number");
159
- });
160
-
161
- it("should return error when importance is Infinity", async () => {
162
- const result = await executeRemember({ content: "Test content", importance: Infinity }, ctx);
163
-
164
- expect(result.success).toBe(false);
165
- expect(result.message).toContain("importance must be a finite number");
166
- });
167
-
168
- it("should handle memoria errors gracefully", async () => {
169
- mockMemoria.remember.mockRejectedValue(new Error("Database error"));
170
-
171
- const result = await executeRemember({ content: "Test content" }, ctx);
172
-
173
- expect(result.success).toBe(false);
174
- expect(result.message).toContain("Database error");
175
- });
176
- });
177
-
178
- describe("executeRecall", () => {
179
- it("should query memories by search query", async () => {
180
- const mockMemories: MockMemory[] = [
181
- { id: "mem-1", content: "First memory", importance: 0.8 },
182
- { id: "mem-2", content: "Second memory", importance: 0.7 },
183
- ];
184
- mockMemoria.recall.mockResolvedValue({ memories: mockMemories });
185
-
186
- const result = await executeRecall({ query: "search term" }, ctx);
187
-
188
- expect(result.success).toBe(true);
189
- expect(result.data).toMatchObject({
190
- memories: mockMemories,
191
- count: 2,
192
- });
193
- expect(mockMemoria.recall).toHaveBeenCalledWith(
194
- "search term",
195
- expect.objectContaining({ limit: 10 }),
196
- );
197
- });
198
-
199
- it("should respect limit parameter", async () => {
200
- const mockMemories: MockMemory[] = [{ id: "mem-1", content: "Memory", importance: 0.8 }];
201
- mockMemoria.recall.mockResolvedValue({ memories: mockMemories });
202
-
203
- const result = await executeRecall({ query: "search", limit: 5 }, ctx);
204
-
205
- expect(result.success).toBe(true);
206
- expect(mockMemoria.recall).toHaveBeenCalledWith(
207
- "search",
208
- expect.objectContaining({ limit: 5 }),
209
- );
210
- });
211
-
212
- it("should return empty array when no memories found", async () => {
213
- mockMemoria.recall.mockResolvedValue({ memories: [] });
214
-
215
- const result = await executeRecall({ query: "nonexistent" }, ctx);
216
-
217
- expect(result.success).toBe(true);
218
- expect(result.data).toMatchObject({
219
- memories: [],
220
- count: 0,
221
- });
222
- });
223
-
224
- it("should return error when memoria is not available", async () => {
225
- const ctxNoMemoria = createContext("/test/dir");
226
-
227
- const result = await executeRecall({ query: "search" }, ctxNoMemoria);
228
-
229
- expect(result.success).toBe(false);
230
- expect(result.message).toContain("Memoria");
231
- });
232
-
233
- it("should return error when query is empty", async () => {
234
- const result = await executeRecall({ query: "" }, ctx);
235
-
236
- expect(result.success).toBe(false);
237
- expect(result.message).toContain("query");
238
- });
239
-
240
- it("should handle memoria errors gracefully", async () => {
241
- mockMemoria.recall.mockRejectedValue(new Error("Search failed"));
242
-
243
- const result = await executeRecall({ query: "test" }, ctx);
244
-
245
- expect(result.success).toBe(false);
246
- expect(result.message).toContain("Search failed");
247
- });
248
- });
249
-
250
- describe("executeForget", () => {
251
- it("should delete memory by ID", async () => {
252
- mockMemoria.deleteMemory.mockResolvedValue(true);
253
-
254
- const result = await executeForget({ id: "mem-123" }, ctx);
255
-
256
- expect(result.success).toBe(true);
257
- expect(result.data).toEqual({ deleted: true, id: "mem-123" });
258
- expect(mockMemoria.deleteMemory).toHaveBeenCalledWith("mem-123");
259
- });
260
-
261
- it("should return success false when memory not found", async () => {
262
- mockMemoria.deleteMemory.mockResolvedValue(false);
263
-
264
- const result = await executeForget({ id: "nonexistent" }, ctx);
265
-
266
- expect(result.success).toBe(false);
267
- });
268
-
269
- it("should return error when memoria is not available", async () => {
270
- const ctxNoMemoria = createContext("/test/dir");
271
-
272
- const result = await executeForget({ id: "mem-123" }, ctxNoMemoria);
273
-
274
- expect(result.success).toBe(false);
275
- expect(result.message).toContain("Memoria");
276
- });
277
-
278
- it("should return error when id is empty", async () => {
279
- const result = await executeForget({ id: "" }, ctx);
280
-
281
- expect(result.success).toBe(false);
282
- expect(result.message).toContain("id");
283
- });
284
-
285
- it("should handle memoria errors gracefully", async () => {
286
- mockMemoria.deleteMemory.mockRejectedValue(new Error("Delete failed"));
287
-
288
- const result = await executeForget({ id: "mem-123" }, ctx);
289
-
290
- expect(result.success).toBe(false);
291
- expect(result.message).toContain("Delete failed");
292
- });
293
- });
294
-
295
- describe("executeDiscover", () => {
296
- it("should query recallTools and return insights", async () => {
297
- const mockKnowledge: MockKnowledge[] = [
298
- {
299
- id: "k-1",
300
- name: "Tool usage pattern",
301
- description: "Common pattern for file operations",
302
- tags: ["files", "operations"],
303
- },
304
- {
305
- id: "k-2",
306
- name: "Related skill",
307
- description: "A skill for automation",
308
- tags: ["automation"],
309
- },
310
- ];
311
- mockMemoria.recallTools.mockResolvedValue(mockKnowledge);
312
-
313
- const result = await executeDiscover({ topic: "file operations" }, ctx);
314
-
315
- expect(result.success).toBe(true);
316
- expect(result.data).toMatchObject({
317
- tools: mockKnowledge,
318
- toolCount: 2,
319
- skillCount: 0,
320
- });
321
- expect(mockMemoria.recallTools).toHaveBeenCalledWith({
322
- query: "file operations",
323
- limit: 10,
324
- });
325
- expect(mockMemoria.recallSkills).toHaveBeenCalledWith({
326
- query: "file operations",
327
- limit: 10,
328
- });
329
- });
330
-
331
- it("should respect limit parameter", async () => {
332
- const result = await executeDiscover({ topic: "topic", limit: 5 }, ctx);
333
-
334
- expect(result.success).toBe(true);
335
- expect(mockMemoria.recallTools).toHaveBeenCalledWith({
336
- query: "topic",
337
- limit: 5,
338
- });
339
- expect(mockMemoria.recallSkills).toHaveBeenCalledWith({
340
- query: "topic",
341
- limit: 5,
342
- });
343
- });
344
-
345
- it("should merge recallSkills results when kind is omitted", async () => {
346
- mockMemoria.recallTools.mockResolvedValue([
347
- {
348
- id: "tool-1",
349
- name: "read_file",
350
- description: "Read file contents",
351
- tags: [],
352
- },
353
- ]);
354
- mockMemoria.recallSkills.mockResolvedValue([
355
- {
356
- id: "skill-1",
357
- name: "Deploy app",
358
- description: "Deploy workflow",
359
- content: "Task: deploy app",
360
- toolIds: ["bash", "grep"],
361
- triggers: [{ type: "keyword", pattern: "deploy", confidence: 0.8 }],
362
- source: { type: "auto-learned", sequenceId: "seq-1" },
363
- importance: 0.7,
364
- confidence: 0.8,
365
- createdAt: new Date("2026-01-01T00:00:00Z"),
366
- updatedAt: new Date("2026-01-01T00:00:00Z"),
367
- accessedAt: new Date("2026-01-01T00:00:00Z"),
368
- accessCount: 0,
369
- },
370
- ]);
371
-
372
- const result = await executeDiscover({ topic: "deploy app", limit: 5 }, ctx);
373
- expect(result.success).toBe(true);
374
- const data = result.data as {
375
- tools: Array<{ id: string }>;
376
- skills: Array<{ id: string }>;
377
- toolCount: number;
378
- skillCount: number;
379
- };
380
- expect(data.toolCount + data.skillCount).toBe(2);
381
- expect(data.skills.some((item) => item.id === "skill-1")).toBe(true);
382
- expect(data.tools.some((item) => item.id === "tool-1")).toBe(true);
383
- });
384
-
385
- it("should filter by kind when provided", async () => {
386
- mockMemoria.recallSkills.mockResolvedValue([]);
387
-
388
- const result = await executeDiscover({ topic: "topic" }, ctx);
389
-
390
- expect(result.success).toBe(true);
391
- expect(mockMemoria.recallSkills).toHaveBeenCalledWith({
392
- query: "topic",
393
- limit: 10,
394
- });
395
- expect(mockMemoria.recallTools).not.toHaveBeenCalledWith(
396
- expect.objectContaining({ kind: "skill" }),
397
- );
398
- });
399
-
400
- it("should return empty insights when no knowledge found", async () => {
401
- const result = await executeDiscover({ topic: "unknown topic" }, ctx);
402
-
403
- expect(result.success).toBe(true);
404
- expect(result.data).toMatchObject({
405
- tools: [],
406
- skills: [],
407
- toolCount: 0,
408
- skillCount: 0,
409
- });
410
- });
411
-
412
- it("should return error when memoria is not available", async () => {
413
- const ctxNoMemoria = createContext("/test/dir");
414
-
415
- const result = await executeDiscover({ topic: "test" }, ctxNoMemoria);
416
-
417
- expect(result.success).toBe(false);
418
- expect(result.message).toContain("Memoria");
419
- });
420
-
421
- it("should return error when topic is empty", async () => {
422
- const result = await executeDiscover({ topic: "" }, ctx);
423
-
424
- expect(result.success).toBe(false);
425
- expect(result.message).toContain("topic");
426
- });
427
-
428
- it("should degrade gracefully when one recall source errors", async () => {
429
- mockMemoria.recallTools.mockRejectedValue(new Error("Knowledge query failed"));
430
- mockMemoria.recallSkills.mockResolvedValue([]);
431
-
432
- const result = await executeDiscover({ topic: "test" }, ctx);
433
-
434
- expect(result.success).toBe(true);
435
- expect(result.data).toMatchObject({
436
- tools: [],
437
- skills: [],
438
- toolCount: 0,
439
- skillCount: 0,
440
- });
441
- });
442
-
443
- it("should fail when both recall sources error", async () => {
444
- mockMemoria.recallTools.mockRejectedValue(new Error("Tools query failed"));
445
- mockMemoria.recallSkills.mockRejectedValue(new Error("Skills query failed"));
446
-
447
- const result = await executeDiscover({ topic: "test" }, ctx);
448
-
449
- expect(result.success).toBe(false);
450
- expect(result.message).toContain("Tools query failed");
451
- expect(result.message).toContain("Skills query failed");
452
- });
453
-
454
- it("should generate insights summary from knowledge", async () => {
455
- const mockKnowledge: MockKnowledge[] = [
456
- {
457
- id: "k-1",
458
- name: "Git workflow",
459
- description: "How to work with git branching",
460
- tags: ["git", "workflow"],
461
- },
462
- ];
463
- mockMemoria.recallTools.mockResolvedValue(mockKnowledge);
464
-
465
- const result = await executeDiscover({ topic: "git" }, ctx);
466
-
467
- expect(result.success).toBe(true);
468
- const data = result.data as { insights: string[] };
469
- expect(data.insights).toBeDefined();
470
- expect(Array.isArray(data.insights)).toBe(true);
471
- });
472
-
473
- it("should preserve migrated assistant_inferred skill entries", async () => {
474
- const migratedKnowledge: MockKnowledge[] = [
475
- {
476
- id: "migrated-skill-1",
477
- name: "legacy deployment skill",
478
- description: "Migrated from synthetic memory backfill",
479
- tags: ["migration"],
480
- source: { type: "assistant_inferred" },
481
- },
482
- ];
483
- mockMemoria.recallTools.mockResolvedValue(migratedKnowledge);
484
-
485
- const result = await executeDiscover({ topic: "legacy deployment" }, ctx);
486
-
487
- expect(result.success).toBe(true);
488
- const data = result.data as {
489
- tools: Array<{ source?: { type: string } }>;
490
- };
491
- expect(data.tools[0]?.source?.type).toBe("assistant_inferred");
492
- });
493
- });
494
-
495
- describe("executeReflect", () => {
496
- // ---- Input validation ----
497
-
498
- it("should return error when summary is empty", async () => {
499
- const result = await executeReflect({ summary: "" }, ctx);
500
-
501
- expect(result.success).toBe(false);
502
- expect(result.message).toContain("summary is required and cannot be empty");
503
- });
504
-
505
- it("should return error when summary is only whitespace", async () => {
506
- const result = await executeReflect({ summary: " " }, ctx);
507
-
508
- expect(result.success).toBe(false);
509
- expect(result.message).toContain("summary is required and cannot be empty");
510
- });
511
-
512
- it("should return error when memoria is not available", async () => {
513
- const ctxNoMemoria = createContext("/test/dir", undefined, {
514
- router: createMockRouter() as any,
515
- });
516
-
517
- const result = await executeReflect({ summary: "test summary" }, ctxNoMemoria);
518
-
519
- expect(result.success).toBe(false);
520
- expect(result.message).toContain("Memoria");
521
- });
522
-
523
- it("should return error when router is not available", async () => {
524
- // ctx has memoria but no router
525
- const result = await executeReflect({ summary: "test summary" }, ctx);
526
-
527
- expect(result.success).toBe(false);
528
- expect(result.message).toContain("Router");
529
- });
530
-
531
- it("should return cancelled when abortSignal is aborted", async () => {
532
- const controller = new AbortController();
533
- controller.abort();
534
-
535
- const ctxAborted = createContext("/test/dir", mockMemoria, {
536
- router: createMockRouter() as any,
537
- abortSignal: controller.signal,
538
- });
539
-
540
- const result = await executeReflect({ summary: "test summary" }, ctxAborted);
541
-
542
- expect(result.success).toBe(false);
543
- expect(result.message).toContain("cancelled");
544
- });
545
-
546
- // ---- Happy path - learned something ----
547
-
548
- it("should store observation in beliefs network when learnedAboutSelf=true", async () => {
549
- const mockRouter = createMockRouter();
550
- mockRouter.chat.mockResolvedValue({
551
- content:
552
- '{"learnedAboutSelf": true, "observation": "I struggle with regex edge cases", "skillCandidate": null}',
553
- });
554
-
555
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
556
- router: mockRouter as any,
557
- });
558
-
559
- const result = await executeReflect({ summary: "Fixed a regex bug" }, ctxWithRouter);
560
-
561
- expect(result.success).toBe(true);
562
- const data = result.data as any;
563
- expect(data.learned).toBe(true);
564
- expect(data.observation).toBe("I struggle with regex edge cases");
565
- expect(mockMemoria.remember).toHaveBeenCalledWith("I struggle with regex edge cases", {
566
- network: "beliefs",
567
- importance: 0.6,
568
- source: "system",
569
- });
570
- });
571
-
572
- it("should include skillCandidate in output when present", async () => {
573
- const mockRouter = createMockRouter();
574
- mockRouter.chat.mockResolvedValue({
575
- content: JSON.stringify({
576
- learnedAboutSelf: true,
577
- observation: "I can orchestrate multi-file refactors",
578
- skillCandidate: {
579
- name: "multi-file-refactor",
580
- level: "advanced",
581
- description: "Coordinated refactoring across multiple files",
582
- },
583
- }),
584
- });
585
-
586
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
587
- router: mockRouter as any,
588
- });
589
-
590
- const result = await executeReflect(
591
- { summary: "Refactored 5 files in a single pass" },
592
- ctxWithRouter,
593
- );
594
-
595
- expect(result.success).toBe(true);
596
- const data = result.data as any;
597
- expect(data.learned).toBe(true);
598
- expect(data.skillCandidate).toEqual({
599
- name: "multi-file-refactor",
600
- level: "advanced",
601
- description: "Coordinated refactoring across multiple files",
602
- });
603
- });
604
-
605
- // ---- Happy path - no learning ----
606
-
607
- it("should return learned=false when learnedAboutSelf=false", async () => {
608
- const mockRouter = createMockRouter();
609
- mockRouter.chat.mockResolvedValue({
610
- content: '{"learnedAboutSelf": false, "observation": null, "skillCandidate": null}',
611
- });
612
-
613
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
614
- router: mockRouter as any,
615
- });
616
-
617
- const result = await executeReflect({ summary: "Routine code edit" }, ctxWithRouter);
618
-
619
- expect(result.success).toBe(true);
620
- const data = result.data as any;
621
- expect(data.learned).toBe(false);
622
- expect(data.observation).toBeNull();
623
- expect(mockMemoria.remember).not.toHaveBeenCalled();
624
- });
625
-
626
- it("should return learned=false when observation is null", async () => {
627
- const mockRouter = createMockRouter();
628
- mockRouter.chat.mockResolvedValue({
629
- content: '{"learnedAboutSelf": true, "observation": null, "skillCandidate": null}',
630
- });
631
-
632
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
633
- router: mockRouter as any,
634
- });
635
-
636
- const result = await executeReflect({ summary: "Nothing notable" }, ctxWithRouter);
637
-
638
- expect(result.success).toBe(true);
639
- const data = result.data as any;
640
- expect(data.learned).toBe(false);
641
- expect(data.observation).toBeNull();
642
- // learnedAboutSelf=true but observation=null => should NOT store
643
- expect(mockMemoria.remember).not.toHaveBeenCalled();
644
- });
645
-
646
- // ---- LLM response parsing (CLAUDE.md "Mocks Must Match Reality") ----
647
-
648
- it("should handle plain text response (no JSON)", async () => {
649
- const mockRouter = createMockRouter();
650
- mockRouter.chat.mockResolvedValue({
651
- content: "I think the answer is yes, I learned something today.",
652
- });
653
-
654
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
655
- router: mockRouter as any,
656
- });
657
-
658
- const result = await executeReflect({ summary: "Some conversation" }, ctxWithRouter);
659
-
660
- expect(result.success).toBe(true);
661
- const data = result.data as any;
662
- expect(data.learned).toBe(false);
663
- expect(data.observation).toBeNull();
664
- });
665
-
666
- it("should handle truncated JSON response", async () => {
667
- const mockRouter = createMockRouter();
668
- mockRouter.chat.mockResolvedValue({
669
- content: '{"learnedAboutSelf": true, "observa',
670
- });
671
-
672
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
673
- router: mockRouter as any,
674
- });
675
-
676
- const result = await executeReflect({ summary: "Truncated" }, ctxWithRouter);
677
-
678
- expect(result.success).toBe(true);
679
- const data = result.data as any;
680
- expect(data.learned).toBe(false);
681
- expect(data.observation).toBeNull();
682
- });
683
-
684
- it("should handle empty string response", async () => {
685
- const mockRouter = createMockRouter();
686
- mockRouter.chat.mockResolvedValue({ content: "" });
687
-
688
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
689
- router: mockRouter as any,
690
- });
691
-
692
- const result = await executeReflect({ summary: "Empty response" }, ctxWithRouter);
693
-
694
- expect(result.success).toBe(true);
695
- const data = result.data as any;
696
- expect(data.learned).toBe(false);
697
- expect(data.observation).toBeNull();
698
- });
699
-
700
- it("should handle JSON with missing fields (schema drift)", async () => {
701
- const mockRouter = createMockRouter();
702
- // Missing required 'learnedAboutSelf' field
703
- mockRouter.chat.mockResolvedValue({
704
- content: '{"observation": "something", "extra": true}',
705
- });
706
-
707
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
708
- router: mockRouter as any,
709
- });
710
-
711
- const result = await executeReflect({ summary: "Schema drift" }, ctxWithRouter);
712
-
713
- expect(result.success).toBe(true);
714
- const data = result.data as any;
715
- expect(data.learned).toBe(false);
716
- expect(data.observation).toBeNull();
717
- });
718
-
719
- it("should handle JSON with extra/unexpected fields", async () => {
720
- const mockRouter = createMockRouter();
721
- mockRouter.chat.mockResolvedValue({
722
- content: JSON.stringify({
723
- learnedAboutSelf: true,
724
- observation: "I work best with small functions",
725
- skillCandidate: null,
726
- unexpectedField: "should be stripped by Zod",
727
- confidence: 0.95,
728
- }),
729
- });
730
-
731
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
732
- router: mockRouter as any,
733
- });
734
-
735
- const result = await executeReflect({ summary: "Extra fields" }, ctxWithRouter);
736
-
737
- expect(result.success).toBe(true);
738
- const data = result.data as any;
739
- expect(data.learned).toBe(true);
740
- expect(data.observation).toBe("I work best with small functions");
741
- // Extra fields should not appear in output
742
- expect(data).not.toHaveProperty("unexpectedField");
743
- expect(data).not.toHaveProperty("confidence");
744
- });
745
-
746
- it("should handle JSON wrapped in markdown code fence", async () => {
747
- const mockRouter = createMockRouter();
748
- mockRouter.chat.mockResolvedValue({
749
- content:
750
- 'Here is my analysis:\n```json\n{"learnedAboutSelf": true, "observation": "I need to check types more carefully", "skillCandidate": null}\n```',
751
- });
752
-
753
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
754
- router: mockRouter as any,
755
- });
756
-
757
- const result = await executeReflect({ summary: "Code fence response" }, ctxWithRouter);
758
-
759
- expect(result.success).toBe(true);
760
- const data = result.data as any;
761
- expect(data.learned).toBe(true);
762
- expect(data.observation).toBe("I need to check types more carefully");
763
- });
764
-
765
- it("should parse the valid final JSON object when an earlier JSON snippet has wrong schema", async () => {
766
- const mockRouter = createMockRouter();
767
- mockRouter.chat.mockResolvedValue({
768
- content: `Draft example:
769
- {"learnedAboutSelf":"unknown","observation":null}
770
-
771
- Final answer:
772
- {"learnedAboutSelf":true,"observation":"I should verify assumptions before coding","skillCandidate":null}`,
773
- });
774
-
775
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
776
- router: mockRouter as any,
777
- });
778
-
779
- const result = await executeReflect({ summary: "Schema selection" }, ctxWithRouter);
780
-
781
- expect(result.success).toBe(true);
782
- const data = result.data as any;
783
- expect(data.learned).toBe(true);
784
- expect(data.observation).toBe("I should verify assumptions before coding");
785
- expect(mockMemoria.remember).toHaveBeenCalledWith(
786
- "I should verify assumptions before coding",
787
- expect.any(Object),
788
- );
789
- });
790
-
791
- // ---- Error propagation ----
792
-
793
- it("should handle router.chat errors gracefully", async () => {
794
- const mockRouter = createMockRouter();
795
- mockRouter.chat.mockRejectedValue(new Error("Rate limit exceeded"));
796
-
797
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
798
- router: mockRouter as any,
799
- });
800
-
801
- const result = await executeReflect({ summary: "Will fail" }, ctxWithRouter);
802
-
803
- expect(result.success).toBe(false);
804
- expect(result.message).toContain("Rate limit exceeded");
805
- });
806
-
807
- it("should handle memoria.remember errors gracefully", async () => {
808
- const mockRouter = createMockRouter();
809
- mockRouter.chat.mockResolvedValue({
810
- content:
811
- '{"learnedAboutSelf": true, "observation": "Something learned", "skillCandidate": null}',
812
- });
813
-
814
- const failingMemoria = createMockMemoria();
815
- failingMemoria.remember.mockRejectedValue(new Error("SQLite write failed"));
816
-
817
- const ctxWithRouter = createContext("/test/dir", failingMemoria, {
818
- router: mockRouter as any,
819
- });
820
-
821
- const result = await executeReflect({ summary: "Memory will fail" }, ctxWithRouter);
822
-
823
- expect(result.success).toBe(false);
824
- expect(result.message).toContain("SQLite write failed");
825
- });
826
-
827
- // ---- Verify correct router call ----
828
-
829
- it("should call router.chat with correct messages, temperature, and tier", async () => {
830
- const mockRouter = createMockRouter();
831
- mockRouter.chat.mockResolvedValue({
832
- content: '{"learnedAboutSelf": false, "observation": null, "skillCandidate": null}',
833
- });
834
-
835
- const ctxWithRouter = createContext("/test/dir", mockMemoria, {
836
- router: mockRouter as any,
837
- });
838
-
839
- await executeReflect({ summary: "Test conversation summary" }, ctxWithRouter);
840
-
841
- expect(mockRouter.chat).toHaveBeenCalledTimes(1);
842
- const callArgs = mockRouter.chat.mock.calls[0][0];
843
- expect(callArgs.temperature).toBe(0.3);
844
- expect(callArgs.tier).toBe("fast");
845
- expect(callArgs.messages).toHaveLength(2);
846
- expect(callArgs.messages[0].role).toBe("system");
847
- expect(callArgs.messages[0].content).toContain("reflecting");
848
- expect(callArgs.messages[1].role).toBe("user");
849
- expect(callArgs.messages[1].content).toContain("Test conversation summary");
850
- expect(callArgs.messages[1].content).toContain("learnedAboutSelf");
851
- });
852
- });
853
- });