cognitive-core 0.1.2 → 0.2.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 (528) hide show
  1. package/.claude/settings.json +111 -2
  2. package/.sessionlog/settings.json +4 -0
  3. package/CLAUDE.md +233 -0
  4. package/README.md +370 -54
  5. package/dist/atlas.d.ts +10 -10
  6. package/dist/atlas.d.ts.map +1 -1
  7. package/dist/atlas.js +79 -48
  8. package/dist/atlas.js.map +1 -1
  9. package/dist/bin/cli-utils.d.ts +37 -0
  10. package/dist/bin/cli-utils.d.ts.map +1 -0
  11. package/dist/bin/cli-utils.js +176 -0
  12. package/dist/bin/cli-utils.js.map +1 -0
  13. package/dist/bin/cognitive-core.d.ts +2 -12
  14. package/dist/bin/cognitive-core.d.ts.map +1 -1
  15. package/dist/bin/cognitive-core.js +76 -351
  16. package/dist/bin/cognitive-core.js.map +1 -1
  17. package/dist/bin/commands/kb.d.ts +6 -0
  18. package/dist/bin/commands/kb.d.ts.map +1 -0
  19. package/dist/bin/commands/kb.js +240 -0
  20. package/dist/bin/commands/kb.js.map +1 -0
  21. package/dist/bin/commands/learn.d.ts +6 -0
  22. package/dist/bin/commands/learn.d.ts.map +1 -0
  23. package/dist/bin/commands/learn.js +91 -0
  24. package/dist/bin/commands/learn.js.map +1 -0
  25. package/dist/bin/commands/legacy.d.ts +12 -0
  26. package/dist/bin/commands/legacy.d.ts.map +1 -0
  27. package/dist/bin/commands/legacy.js +142 -0
  28. package/dist/bin/commands/legacy.js.map +1 -0
  29. package/dist/bin/commands/run.d.ts +3 -0
  30. package/dist/bin/commands/run.d.ts.map +1 -0
  31. package/dist/bin/commands/run.js +99 -0
  32. package/dist/bin/commands/run.js.map +1 -0
  33. package/dist/bin/commands/sessions.d.ts +9 -0
  34. package/dist/bin/commands/sessions.d.ts.map +1 -0
  35. package/dist/bin/commands/sessions.js +183 -0
  36. package/dist/bin/commands/sessions.js.map +1 -0
  37. package/dist/bin/commands/skills.d.ts +6 -0
  38. package/dist/bin/commands/skills.d.ts.map +1 -0
  39. package/dist/bin/commands/skills.js +135 -0
  40. package/dist/bin/commands/skills.js.map +1 -0
  41. package/dist/embeddings/index.d.ts +1 -0
  42. package/dist/embeddings/index.d.ts.map +1 -1
  43. package/dist/embeddings/index.js +2 -0
  44. package/dist/embeddings/index.js.map +1 -1
  45. package/dist/embeddings/inverted-index.d.ts +47 -0
  46. package/dist/embeddings/inverted-index.d.ts.map +1 -0
  47. package/dist/embeddings/inverted-index.js +122 -0
  48. package/dist/embeddings/inverted-index.js.map +1 -0
  49. package/dist/embeddings/manager.d.ts +3 -1
  50. package/dist/embeddings/manager.d.ts.map +1 -1
  51. package/dist/embeddings/manager.js +12 -7
  52. package/dist/embeddings/manager.js.map +1 -1
  53. package/dist/embeddings/vector-store.d.ts +7 -3
  54. package/dist/embeddings/vector-store.d.ts.map +1 -1
  55. package/dist/embeddings/vector-store.js +22 -6
  56. package/dist/embeddings/vector-store.js.map +1 -1
  57. package/dist/factory.d.ts +11 -12
  58. package/dist/factory.d.ts.map +1 -1
  59. package/dist/factory.js +20 -7
  60. package/dist/factory.js.map +1 -1
  61. package/dist/index.d.ts +8 -7
  62. package/dist/index.d.ts.map +1 -1
  63. package/dist/index.js +42 -6
  64. package/dist/index.js.map +1 -1
  65. package/dist/learning/analyzer.d.ts.map +1 -1
  66. package/dist/learning/analyzer.js +17 -35
  67. package/dist/learning/analyzer.js.map +1 -1
  68. package/dist/learning/energy-evaluator.d.ts +128 -0
  69. package/dist/learning/energy-evaluator.d.ts.map +1 -0
  70. package/dist/learning/energy-evaluator.js +175 -0
  71. package/dist/learning/energy-evaluator.js.map +1 -0
  72. package/dist/learning/healing-orchestrator.d.ts +182 -0
  73. package/dist/learning/healing-orchestrator.d.ts.map +1 -0
  74. package/dist/learning/healing-orchestrator.js +250 -0
  75. package/dist/learning/healing-orchestrator.js.map +1 -0
  76. package/dist/learning/index.d.ts +7 -2
  77. package/dist/learning/index.d.ts.map +1 -1
  78. package/dist/learning/index.js +13 -2
  79. package/dist/learning/index.js.map +1 -1
  80. package/dist/learning/instant-loop.d.ts +87 -0
  81. package/dist/learning/instant-loop.d.ts.map +1 -0
  82. package/dist/learning/instant-loop.js +264 -0
  83. package/dist/learning/instant-loop.js.map +1 -0
  84. package/dist/learning/loop-coordinator.d.ts +61 -0
  85. package/dist/learning/loop-coordinator.d.ts.map +1 -0
  86. package/dist/learning/loop-coordinator.js +96 -0
  87. package/dist/learning/loop-coordinator.js.map +1 -0
  88. package/dist/learning/maintenance-scheduler.d.ts +141 -0
  89. package/dist/learning/maintenance-scheduler.d.ts.map +1 -0
  90. package/dist/learning/maintenance-scheduler.js +186 -0
  91. package/dist/learning/maintenance-scheduler.js.map +1 -0
  92. package/dist/learning/meta-learner.d.ts.map +1 -1
  93. package/dist/learning/meta-learner.js +4 -21
  94. package/dist/learning/meta-learner.js.map +1 -1
  95. package/dist/learning/pipeline.d.ts +31 -4
  96. package/dist/learning/pipeline.d.ts.map +1 -1
  97. package/dist/learning/pipeline.js +64 -12
  98. package/dist/learning/pipeline.js.map +1 -1
  99. package/dist/learning/reflexion-generator.d.ts +64 -0
  100. package/dist/learning/reflexion-generator.d.ts.map +1 -0
  101. package/dist/learning/reflexion-generator.js +194 -0
  102. package/dist/learning/reflexion-generator.js.map +1 -0
  103. package/dist/learning/trajectory-sources/entire.d.ts +8 -5
  104. package/dist/learning/trajectory-sources/entire.d.ts.map +1 -1
  105. package/dist/learning/trajectory-sources/entire.js +13 -6
  106. package/dist/learning/trajectory-sources/entire.js.map +1 -1
  107. package/dist/learning/trajectory-sources/index.d.ts +1 -1
  108. package/dist/learning/trajectory-sources/index.d.ts.map +1 -1
  109. package/dist/learning/trajectory-sources/index.js +1 -1
  110. package/dist/learning/trajectory-sources/index.js.map +1 -1
  111. package/dist/learning/trajectory-sources/pipeline.d.ts +4 -4
  112. package/dist/learning/trajectory-sources/pipeline.d.ts.map +1 -1
  113. package/dist/learning/trajectory-sources/pipeline.js +2 -2
  114. package/dist/learning/trajectory-sources/pipeline.js.map +1 -1
  115. package/dist/learning/unified-pipeline.d.ts +311 -0
  116. package/dist/learning/unified-pipeline.d.ts.map +1 -0
  117. package/dist/learning/unified-pipeline.js +844 -0
  118. package/dist/learning/unified-pipeline.js.map +1 -0
  119. package/dist/memory/candidate-retrieval.d.ts +43 -0
  120. package/dist/memory/candidate-retrieval.d.ts.map +1 -0
  121. package/dist/memory/candidate-retrieval.js +43 -0
  122. package/dist/memory/candidate-retrieval.js.map +1 -0
  123. package/dist/memory/causal-store.d.ts +97 -0
  124. package/dist/memory/causal-store.d.ts.map +1 -0
  125. package/dist/memory/causal-store.js +209 -0
  126. package/dist/memory/causal-store.js.map +1 -0
  127. package/dist/memory/coherence.d.ts +71 -0
  128. package/dist/memory/coherence.d.ts.map +1 -0
  129. package/dist/memory/coherence.js +176 -0
  130. package/dist/memory/coherence.js.map +1 -0
  131. package/dist/memory/experience.d.ts +39 -6
  132. package/dist/memory/experience.d.ts.map +1 -1
  133. package/dist/memory/experience.js +193 -49
  134. package/dist/memory/experience.js.map +1 -1
  135. package/dist/memory/index.d.ts +7 -0
  136. package/dist/memory/index.d.ts.map +1 -1
  137. package/dist/memory/index.js +12 -0
  138. package/dist/memory/index.js.map +1 -1
  139. package/dist/memory/knowledge-bank.d.ts +14 -0
  140. package/dist/memory/knowledge-bank.d.ts.map +1 -1
  141. package/dist/memory/knowledge-bank.js +45 -0
  142. package/dist/memory/knowledge-bank.js.map +1 -1
  143. package/dist/memory/meta.d.ts +7 -8
  144. package/dist/memory/meta.d.ts.map +1 -1
  145. package/dist/memory/meta.js +73 -79
  146. package/dist/memory/meta.js.map +1 -1
  147. package/dist/memory/playbook.d.ts +26 -9
  148. package/dist/memory/playbook.d.ts.map +1 -1
  149. package/dist/memory/playbook.js +198 -74
  150. package/dist/memory/playbook.js.map +1 -1
  151. package/dist/memory/reasoning-bank.d.ts +130 -0
  152. package/dist/memory/reasoning-bank.d.ts.map +1 -0
  153. package/dist/memory/reasoning-bank.js +342 -0
  154. package/dist/memory/reasoning-bank.js.map +1 -0
  155. package/dist/memory/reflexion.d.ts +59 -0
  156. package/dist/memory/reflexion.d.ts.map +1 -0
  157. package/dist/memory/reflexion.js +96 -0
  158. package/dist/memory/reflexion.js.map +1 -0
  159. package/dist/memory/system.d.ts +7 -2
  160. package/dist/memory/system.d.ts.map +1 -1
  161. package/dist/memory/system.js +19 -7
  162. package/dist/memory/system.js.map +1 -1
  163. package/dist/memory/temporal-compressor.d.ts +126 -0
  164. package/dist/memory/temporal-compressor.d.ts.map +1 -0
  165. package/dist/memory/temporal-compressor.js +335 -0
  166. package/dist/memory/temporal-compressor.js.map +1 -0
  167. package/dist/persistence/index.d.ts +11 -0
  168. package/dist/persistence/index.d.ts.map +1 -0
  169. package/dist/persistence/index.js +11 -0
  170. package/dist/persistence/index.js.map +1 -0
  171. package/dist/persistence/migrator.d.ts +40 -0
  172. package/dist/persistence/migrator.d.ts.map +1 -0
  173. package/dist/persistence/migrator.js +238 -0
  174. package/dist/persistence/migrator.js.map +1 -0
  175. package/dist/persistence/serializers.d.ts +45 -0
  176. package/dist/persistence/serializers.d.ts.map +1 -0
  177. package/dist/persistence/serializers.js +80 -0
  178. package/dist/persistence/serializers.js.map +1 -0
  179. package/dist/persistence/sqlite-persistence.d.ts +228 -0
  180. package/dist/persistence/sqlite-persistence.d.ts.map +1 -0
  181. package/dist/persistence/sqlite-persistence.js +588 -0
  182. package/dist/persistence/sqlite-persistence.js.map +1 -0
  183. package/dist/runtime/flows/learning.d.ts +10 -12
  184. package/dist/runtime/flows/learning.d.ts.map +1 -1
  185. package/dist/runtime/flows/learning.js +10 -23
  186. package/dist/runtime/flows/learning.js.map +1 -1
  187. package/dist/search/index.d.ts +1 -0
  188. package/dist/search/index.d.ts.map +1 -1
  189. package/dist/search/index.js +2 -0
  190. package/dist/search/index.js.map +1 -1
  191. package/dist/search/moe-gate.d.ts +124 -0
  192. package/dist/search/moe-gate.d.ts.map +1 -0
  193. package/dist/search/moe-gate.js +234 -0
  194. package/dist/search/moe-gate.js.map +1 -0
  195. package/dist/search/router.d.ts +32 -2
  196. package/dist/search/router.d.ts.map +1 -1
  197. package/dist/search/router.js +87 -4
  198. package/dist/search/router.js.map +1 -1
  199. package/dist/session-bank/git-reader.d.ts +9 -4
  200. package/dist/session-bank/git-reader.d.ts.map +1 -1
  201. package/dist/session-bank/git-reader.js +22 -15
  202. package/dist/session-bank/git-reader.js.map +1 -1
  203. package/dist/session-bank/index.d.ts +2 -2
  204. package/dist/session-bank/index.d.ts.map +1 -1
  205. package/dist/session-bank/index.js +2 -2
  206. package/dist/session-bank/index.js.map +1 -1
  207. package/dist/session-bank/parser.d.ts +16 -5
  208. package/dist/session-bank/parser.d.ts.map +1 -1
  209. package/dist/session-bank/parser.js +187 -80
  210. package/dist/session-bank/parser.js.map +1 -1
  211. package/dist/session-bank/session-bank.d.ts +5 -0
  212. package/dist/session-bank/session-bank.d.ts.map +1 -1
  213. package/dist/session-bank/session-bank.js +30 -9
  214. package/dist/session-bank/session-bank.js.map +1 -1
  215. package/dist/session-bank/types.d.ts +4 -1
  216. package/dist/session-bank/types.d.ts.map +1 -1
  217. package/dist/session-bank/types.js +3 -3
  218. package/dist/session-bank/types.js.map +1 -1
  219. package/dist/surfacing/skill-publisher.d.ts.map +1 -1
  220. package/dist/surfacing/skill-publisher.js +15 -43
  221. package/dist/surfacing/skill-publisher.js.map +1 -1
  222. package/dist/surfacing/sqlite-storage-adapter.d.ts.map +1 -1
  223. package/dist/surfacing/sqlite-storage-adapter.js +13 -21
  224. package/dist/surfacing/sqlite-storage-adapter.js.map +1 -1
  225. package/dist/types/config.d.ts +100 -0
  226. package/dist/types/config.d.ts.map +1 -1
  227. package/dist/types/config.js +27 -0
  228. package/dist/types/config.js.map +1 -1
  229. package/dist/types/index.d.ts +2 -2
  230. package/dist/types/index.d.ts.map +1 -1
  231. package/dist/types/index.js +1 -1
  232. package/dist/types/index.js.map +1 -1
  233. package/dist/types/memory.d.ts +52 -0
  234. package/dist/types/memory.d.ts.map +1 -1
  235. package/dist/types/memory.js +13 -0
  236. package/dist/types/memory.js.map +1 -1
  237. package/dist/types/playbook.d.ts +4 -0
  238. package/dist/types/playbook.d.ts.map +1 -1
  239. package/dist/types/playbook.js.map +1 -1
  240. package/dist/utils/error-classifier.d.ts +30 -0
  241. package/dist/utils/error-classifier.d.ts.map +1 -0
  242. package/dist/utils/error-classifier.js +85 -0
  243. package/dist/utils/error-classifier.js.map +1 -0
  244. package/dist/utils/index.d.ts +3 -0
  245. package/dist/utils/index.d.ts.map +1 -1
  246. package/dist/utils/index.js +3 -0
  247. package/dist/utils/index.js.map +1 -1
  248. package/dist/utils/partitioned-store.d.ts +93 -0
  249. package/dist/utils/partitioned-store.d.ts.map +1 -0
  250. package/dist/utils/partitioned-store.js +251 -0
  251. package/dist/utils/partitioned-store.js.map +1 -0
  252. package/dist/utils/trajectory-helpers.d.ts +39 -0
  253. package/dist/utils/trajectory-helpers.d.ts.map +1 -0
  254. package/dist/utils/trajectory-helpers.js +57 -0
  255. package/dist/utils/trajectory-helpers.js.map +1 -0
  256. package/dist/workspace/efficacy-toolkit.d.ts +164 -0
  257. package/dist/workspace/efficacy-toolkit.d.ts.map +1 -0
  258. package/dist/workspace/efficacy-toolkit.js +281 -0
  259. package/dist/workspace/efficacy-toolkit.js.map +1 -0
  260. package/dist/workspace/index.d.ts +2 -1
  261. package/dist/workspace/index.d.ts.map +1 -1
  262. package/dist/workspace/index.js +3 -1
  263. package/dist/workspace/index.js.map +1 -1
  264. package/dist/workspace/runner.d.ts +3 -4
  265. package/dist/workspace/runner.d.ts.map +1 -1
  266. package/dist/workspace/runner.js.map +1 -1
  267. package/dist/workspace/templates/index.d.ts +3 -0
  268. package/dist/workspace/templates/index.d.ts.map +1 -1
  269. package/dist/workspace/templates/index.js +6 -0
  270. package/dist/workspace/templates/index.js.map +1 -1
  271. package/dist/workspace/templates/playbook-decay-detection.d.ts +46 -0
  272. package/dist/workspace/templates/playbook-decay-detection.d.ts.map +1 -0
  273. package/dist/workspace/templates/playbook-decay-detection.js +197 -0
  274. package/dist/workspace/templates/playbook-decay-detection.js.map +1 -0
  275. package/dist/workspace/templates/playbook-efficacy-audit.d.ts +46 -0
  276. package/dist/workspace/templates/playbook-efficacy-audit.d.ts.map +1 -0
  277. package/dist/workspace/templates/playbook-efficacy-audit.js +160 -0
  278. package/dist/workspace/templates/playbook-efficacy-audit.js.map +1 -0
  279. package/dist/workspace/templates/playbook-lifecycle-review.d.ts +51 -0
  280. package/dist/workspace/templates/playbook-lifecycle-review.d.ts.map +1 -0
  281. package/dist/workspace/templates/playbook-lifecycle-review.js +187 -0
  282. package/dist/workspace/templates/playbook-lifecycle-review.js.map +1 -0
  283. package/dist/workspace/types.d.ts +9 -2
  284. package/dist/workspace/types.d.ts.map +1 -1
  285. package/dist/workspace/types.js.map +1 -1
  286. package/package.json +12 -4
  287. package/references/sessionlog/.husky/pre-commit +1 -0
  288. package/references/sessionlog/.lintstagedrc.json +4 -0
  289. package/references/sessionlog/.prettierignore +4 -0
  290. package/references/sessionlog/.prettierrc.json +11 -0
  291. package/references/sessionlog/LICENSE +21 -0
  292. package/references/sessionlog/README.md +453 -0
  293. package/references/sessionlog/eslint.config.js +58 -0
  294. package/references/sessionlog/package-lock.json +3672 -0
  295. package/references/sessionlog/package.json +65 -0
  296. package/references/sessionlog/src/__tests__/agent-hooks.test.ts +570 -0
  297. package/references/sessionlog/src/__tests__/agent-registry.test.ts +127 -0
  298. package/references/sessionlog/src/__tests__/claude-code-hooks.test.ts +225 -0
  299. package/references/sessionlog/src/__tests__/claude-generator.test.ts +46 -0
  300. package/references/sessionlog/src/__tests__/commit-msg.test.ts +86 -0
  301. package/references/sessionlog/src/__tests__/cursor-agent.test.ts +224 -0
  302. package/references/sessionlog/src/__tests__/e2e-live.test.ts +890 -0
  303. package/references/sessionlog/src/__tests__/event-log.test.ts +183 -0
  304. package/references/sessionlog/src/__tests__/flush-sentinel.test.ts +105 -0
  305. package/references/sessionlog/src/__tests__/gemini-agent.test.ts +375 -0
  306. package/references/sessionlog/src/__tests__/git-hooks.test.ts +78 -0
  307. package/references/sessionlog/src/__tests__/hook-managers.test.ts +121 -0
  308. package/references/sessionlog/src/__tests__/lifecycle-tasks.test.ts +759 -0
  309. package/references/sessionlog/src/__tests__/opencode-agent.test.ts +338 -0
  310. package/references/sessionlog/src/__tests__/redaction.test.ts +136 -0
  311. package/references/sessionlog/src/__tests__/session-repo.test.ts +353 -0
  312. package/references/sessionlog/src/__tests__/session-store.test.ts +166 -0
  313. package/references/sessionlog/src/__tests__/setup-ccweb.test.ts +466 -0
  314. package/references/sessionlog/src/__tests__/skill-live.test.ts +461 -0
  315. package/references/sessionlog/src/__tests__/summarize.test.ts +348 -0
  316. package/references/sessionlog/src/__tests__/task-plan-e2e.test.ts +610 -0
  317. package/references/sessionlog/src/__tests__/task-plan-live.test.ts +632 -0
  318. package/references/sessionlog/src/__tests__/transcript-timestamp.test.ts +121 -0
  319. package/references/sessionlog/src/__tests__/types.test.ts +166 -0
  320. package/references/sessionlog/src/__tests__/utils.test.ts +333 -0
  321. package/references/sessionlog/src/__tests__/validation.test.ts +103 -0
  322. package/references/sessionlog/src/__tests__/worktree.test.ts +57 -0
  323. package/references/sessionlog/src/agent/agents/claude-code.ts +1089 -0
  324. package/references/sessionlog/src/agent/agents/cursor.ts +361 -0
  325. package/references/sessionlog/src/agent/agents/gemini-cli.ts +632 -0
  326. package/references/sessionlog/src/agent/agents/opencode.ts +540 -0
  327. package/references/sessionlog/src/agent/registry.ts +143 -0
  328. package/references/sessionlog/src/agent/session-types.ts +113 -0
  329. package/references/sessionlog/src/agent/types.ts +220 -0
  330. package/references/sessionlog/src/cli.ts +597 -0
  331. package/references/sessionlog/src/commands/clean.ts +133 -0
  332. package/references/sessionlog/src/commands/disable.ts +84 -0
  333. package/references/sessionlog/src/commands/doctor.ts +145 -0
  334. package/references/sessionlog/src/commands/enable.ts +202 -0
  335. package/references/sessionlog/src/commands/explain.ts +261 -0
  336. package/references/sessionlog/src/commands/reset.ts +105 -0
  337. package/references/sessionlog/src/commands/resume.ts +180 -0
  338. package/references/sessionlog/src/commands/rewind.ts +195 -0
  339. package/references/sessionlog/src/commands/setup-ccweb.ts +275 -0
  340. package/references/sessionlog/src/commands/status.ts +172 -0
  341. package/references/sessionlog/src/config.ts +165 -0
  342. package/references/sessionlog/src/events/event-log.ts +126 -0
  343. package/references/sessionlog/src/git-operations.ts +558 -0
  344. package/references/sessionlog/src/hooks/git-hooks.ts +165 -0
  345. package/references/sessionlog/src/hooks/lifecycle.ts +391 -0
  346. package/references/sessionlog/src/index.ts +650 -0
  347. package/references/sessionlog/src/security/redaction.ts +283 -0
  348. package/references/sessionlog/src/session/state-machine.ts +452 -0
  349. package/references/sessionlog/src/store/checkpoint-store.ts +509 -0
  350. package/references/sessionlog/src/store/native-store.ts +173 -0
  351. package/references/sessionlog/src/store/provider-types.ts +99 -0
  352. package/references/sessionlog/src/store/session-store.ts +266 -0
  353. package/references/sessionlog/src/strategy/attribution.ts +296 -0
  354. package/references/sessionlog/src/strategy/common.ts +207 -0
  355. package/references/sessionlog/src/strategy/content-overlap.ts +228 -0
  356. package/references/sessionlog/src/strategy/manual-commit.ts +988 -0
  357. package/references/sessionlog/src/strategy/types.ts +279 -0
  358. package/references/sessionlog/src/summarize/claude-generator.ts +115 -0
  359. package/references/sessionlog/src/summarize/summarize.ts +432 -0
  360. package/references/sessionlog/src/types.ts +508 -0
  361. package/references/sessionlog/src/utils/chunk-files.ts +49 -0
  362. package/references/sessionlog/src/utils/commit-message.ts +65 -0
  363. package/references/sessionlog/src/utils/detect-agent.ts +36 -0
  364. package/references/sessionlog/src/utils/hook-managers.ts +125 -0
  365. package/references/sessionlog/src/utils/ide-tags.ts +32 -0
  366. package/references/sessionlog/src/utils/paths.ts +79 -0
  367. package/references/sessionlog/src/utils/preview-rewind.ts +80 -0
  368. package/references/sessionlog/src/utils/rewind-conflict.ts +121 -0
  369. package/references/sessionlog/src/utils/shadow-branch.ts +109 -0
  370. package/references/sessionlog/src/utils/string-utils.ts +46 -0
  371. package/references/sessionlog/src/utils/todo-extract.ts +188 -0
  372. package/references/sessionlog/src/utils/trailers.ts +187 -0
  373. package/references/sessionlog/src/utils/transcript-parse.ts +177 -0
  374. package/references/sessionlog/src/utils/transcript-timestamp.ts +59 -0
  375. package/references/sessionlog/src/utils/tree-ops.ts +219 -0
  376. package/references/sessionlog/src/utils/tty.ts +72 -0
  377. package/references/sessionlog/src/utils/validation.ts +65 -0
  378. package/references/sessionlog/src/utils/worktree.ts +58 -0
  379. package/references/sessionlog/src/wire-types.ts +59 -0
  380. package/references/sessionlog/templates/setup-env.sh +153 -0
  381. package/references/sessionlog/tsconfig.json +18 -0
  382. package/references/sessionlog/vitest.config.ts +12 -0
  383. package/references/skill-tree/.sudocode/issues.jsonl +8 -0
  384. package/references/skill-tree/.sudocode/specs.jsonl +2 -0
  385. package/references/skill-tree/CLAUDE.md +56 -80
  386. package/references/skill-tree/README.md +188 -140
  387. package/references/skill-tree/examples/basic-usage.ts +95 -121
  388. package/references/skill-tree/package-lock.json +369 -26
  389. package/references/skill-tree/package.json +1 -1
  390. package/src/atlas.ts +97 -67
  391. package/src/bin/cli-utils.ts +220 -0
  392. package/src/bin/cognitive-core.ts +84 -392
  393. package/src/bin/commands/kb.ts +266 -0
  394. package/src/bin/commands/learn.ts +100 -0
  395. package/src/bin/commands/legacy.ts +182 -0
  396. package/src/bin/commands/run.ts +113 -0
  397. package/src/bin/commands/sessions.ts +221 -0
  398. package/src/bin/commands/skills.ts +146 -0
  399. package/src/embeddings/index.ts +3 -0
  400. package/src/embeddings/inverted-index.ts +134 -0
  401. package/src/embeddings/manager.ts +13 -8
  402. package/src/embeddings/vector-store.ts +21 -9
  403. package/src/factory.ts +33 -16
  404. package/src/index.ts +136 -9
  405. package/src/learning/analyzer.ts +21 -37
  406. package/src/learning/energy-evaluator.ts +282 -0
  407. package/src/learning/healing-orchestrator.ts +383 -0
  408. package/src/learning/index.ts +66 -9
  409. package/src/learning/instant-loop.ts +357 -0
  410. package/src/learning/maintenance-scheduler.ts +271 -0
  411. package/src/learning/meta-learner.ts +5 -23
  412. package/src/learning/reflexion-generator.ts +273 -0
  413. package/src/learning/trajectory-sources/entire.ts +24 -13
  414. package/src/learning/trajectory-sources/index.ts +2 -2
  415. package/src/learning/trajectory-sources/pipeline.ts +5 -5
  416. package/src/learning/unified-pipeline.ts +1191 -0
  417. package/src/memory/candidate-retrieval.ts +72 -0
  418. package/src/memory/causal-store.ts +273 -0
  419. package/src/memory/coherence.ts +252 -0
  420. package/src/memory/experience.ts +217 -50
  421. package/src/memory/index.ts +43 -0
  422. package/src/memory/knowledge-bank.ts +57 -0
  423. package/src/memory/meta.ts +78 -96
  424. package/src/memory/playbook.ts +239 -75
  425. package/src/memory/reasoning-bank.ts +458 -0
  426. package/src/memory/reflexion.ts +122 -0
  427. package/src/memory/system.ts +21 -5
  428. package/src/memory/temporal-compressor.ts +409 -0
  429. package/src/persistence/index.ts +37 -0
  430. package/src/persistence/migrator.ts +298 -0
  431. package/src/persistence/serializers.ts +79 -0
  432. package/src/persistence/sqlite-persistence.ts +925 -0
  433. package/src/runtime/flows/learning.ts +25 -42
  434. package/src/search/index.ts +10 -0
  435. package/src/search/moe-gate.ts +304 -0
  436. package/src/search/router.ts +111 -4
  437. package/src/session-bank/git-reader.ts +29 -19
  438. package/src/session-bank/index.ts +4 -2
  439. package/src/session-bank/parser.ts +280 -98
  440. package/src/session-bank/session-bank.ts +33 -12
  441. package/src/session-bank/types.ts +8 -5
  442. package/src/surfacing/skill-publisher.ts +17 -49
  443. package/src/surfacing/sqlite-storage-adapter.ts +16 -32
  444. package/src/types/config.ts +30 -0
  445. package/src/types/index.ts +3 -0
  446. package/src/types/memory.ts +30 -0
  447. package/src/types/playbook.ts +4 -0
  448. package/src/utils/error-classifier.ts +113 -0
  449. package/src/utils/index.ts +18 -0
  450. package/src/utils/partitioned-store.ts +299 -0
  451. package/src/utils/trajectory-helpers.ts +79 -0
  452. package/src/workspace/efficacy-toolkit.ts +496 -0
  453. package/src/workspace/index.ts +29 -0
  454. package/src/workspace/runner.ts +3 -3
  455. package/src/workspace/templates/index.ts +24 -0
  456. package/src/workspace/templates/playbook-decay-detection.ts +272 -0
  457. package/src/workspace/templates/playbook-efficacy-audit.ts +246 -0
  458. package/src/workspace/templates/playbook-lifecycle-review.ts +274 -0
  459. package/src/workspace/types.ts +10 -2
  460. package/tests/embeddings/inverted-index.test.ts +138 -0
  461. package/tests/feature-toggles.test.ts +275 -0
  462. package/tests/fixtures/behavioral-trajectories.ts +210 -0
  463. package/tests/gap-fixes.test.ts +17 -4
  464. package/tests/integration/cli-e2e.test.ts +621 -0
  465. package/tests/integration/e2e.test.ts +6 -5
  466. package/tests/integration/entire-e2e.test.ts +314 -125
  467. package/tests/integration/persistence-e2e.test.ts +741 -0
  468. package/tests/integration/phase-e2e.test.ts +1143 -0
  469. package/tests/integration/pipeline-data-correctness.test.ts +794 -0
  470. package/tests/integration/session-bank.test.ts +20 -14
  471. package/tests/integration/sessionlog-e2e.test.ts +329 -0
  472. package/tests/integration/unified-pipeline-e2e.test.ts +634 -0
  473. package/tests/learning/analyzer.test.ts +1 -1
  474. package/tests/learning/energy-evaluator.test.ts +180 -0
  475. package/tests/learning/entire-trajectory-source.test.ts +25 -25
  476. package/tests/learning/healing-orchestrator.test.ts +269 -0
  477. package/tests/learning/instant-loop.test.ts +243 -0
  478. package/tests/learning/maintenance-scheduler.test.ts +191 -0
  479. package/tests/learning/meta-learner.test.ts +418 -0
  480. package/tests/learning/pipeline-memory-updates.test.ts +721 -0
  481. package/tests/learning/reflexion-generator.test.ts +411 -0
  482. package/tests/learning/trajectory-sources.test.ts +12 -4
  483. package/tests/learning/unified-pipeline-efficacy.test.ts +232 -0
  484. package/tests/learning/unified-pipeline.test.ts +322 -0
  485. package/tests/mcp/playbook-server.test.ts +6 -1
  486. package/tests/memory/candidate-retrieval.test.ts +167 -0
  487. package/tests/memory/causal-store.test.ts +276 -0
  488. package/tests/memory/coherence.test.ts +232 -0
  489. package/tests/memory/experience.test.ts +8 -3
  490. package/tests/memory/meta.test.ts +399 -0
  491. package/tests/memory/playbook.test.ts +307 -1
  492. package/tests/memory/provenance.test.ts +11 -2
  493. package/tests/memory/reasoning-bank.test.ts +239 -0
  494. package/tests/memory/reflexion.test.ts +166 -0
  495. package/tests/memory/skill-exporter.test.ts +6 -1
  496. package/tests/memory/system.test.ts +6 -1
  497. package/tests/memory/temporal-compressor.test.ts +318 -0
  498. package/tests/persistence/migrator.test.ts +1009 -0
  499. package/tests/persistence/sqlite-persistence.test.ts +635 -0
  500. package/tests/runtime/agent-manager.test.ts +6 -1
  501. package/tests/runtime/delegate.test.ts +6 -1
  502. package/tests/search/evaluator.test.ts +257 -0
  503. package/tests/search/moe-gate.test.ts +250 -0
  504. package/tests/search/refinement-loop.test.ts +11 -2
  505. package/tests/search/router.test.ts +81 -2
  506. package/tests/search/verification-runner.test.ts +357 -0
  507. package/tests/session-bank/fixtures/sessionlog-root-metadata.json +16 -0
  508. package/tests/session-bank/fixtures/sessionlog-session/full.jsonl +6 -0
  509. package/tests/session-bank/fixtures/sessionlog-session/metadata.json +55 -0
  510. package/tests/session-bank/git-reader.test.ts +13 -13
  511. package/tests/session-bank/parser.test.ts +135 -3
  512. package/tests/session-bank/session-bank.test.ts +1 -1
  513. package/tests/surfacing/skill-library.test.ts +6 -1
  514. package/tests/surfacing/skill-publisher.test.ts +24 -58
  515. package/tests/surfacing/sqlite-storage-adapter.test.ts +11 -23
  516. package/tests/utils/error-classifier.test.ts +149 -0
  517. package/tests/utils/partitioned-store.test.ts +230 -0
  518. package/tests/utils/trajectory-helpers.test.ts +163 -0
  519. package/tests/workspace/efficacy-toolkit.test.ts +404 -0
  520. package/tests/workspace/full-flow.test.ts +10 -4
  521. package/tests/workspace/runner.test.ts +10 -4
  522. package/tests/workspace/templates/playbook-efficacy.test.ts +377 -0
  523. package/docs/DESIGN-workspace-migration.md +0 -1079
  524. package/docs/PLAN-agentic-workspace-implementation.md +0 -717
  525. package/docs/PLAN-graph-migration.md +0 -299
  526. package/docs/PLAN-session-bank-implementation.md +0 -474
  527. package/src/learning/pipeline.ts +0 -323
  528. package/tests/learning/pipeline.test.ts +0 -176
@@ -0,0 +1,635 @@
1
+ /**
2
+ * Tests for SqlitePersistence — unified SQLite database.
3
+ *
4
+ * Uses :memory: databases (via tmp directories) for isolation.
5
+ */
6
+
7
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
8
+ import { mkdtempSync, rmSync } from 'node:fs';
9
+ import { join } from 'node:path';
10
+ import { tmpdir } from 'node:os';
11
+ import { SqlitePersistence, createSqlitePersistence } from '../../src/persistence/sqlite-persistence.js';
12
+ import type { Experience } from '../../src/types/memory.js';
13
+ import type { Playbook } from '../../src/types/playbook.js';
14
+ import type { ReflexionEpisode } from '../../src/types/memory.js';
15
+ import type { MetaObservation, MetaStrategy } from '../../src/types/meta.js';
16
+
17
+ // ============================================================================
18
+ // Test data factories
19
+ // ============================================================================
20
+
21
+ function createTestExperience(overrides: Partial<Experience> = {}): Experience {
22
+ return {
23
+ id: 'exp-1',
24
+ taskInput: 'Fix the login bug',
25
+ solutionOutput: 'Updated auth middleware',
26
+ feedback: 'Works well',
27
+ success: true,
28
+ domain: 'code',
29
+ trajectoryId: 'traj-1',
30
+ usageCount: 0,
31
+ accessScore: 0,
32
+ retrievalCount: 0,
33
+ tier: 'hot',
34
+ metadata: {},
35
+ createdAt: new Date('2024-01-01'),
36
+ ...overrides,
37
+ };
38
+ }
39
+
40
+ function createTestPlaybook(overrides: Partial<Playbook> = {}): Playbook {
41
+ return {
42
+ id: 'pb-1',
43
+ name: 'Error Handling Strategy',
44
+ applicability: {
45
+ situations: ['error handling'],
46
+ triggers: ['try-catch needed'],
47
+ antiPatterns: ['silent catch'],
48
+ domains: ['code'],
49
+ },
50
+ guidance: {
51
+ strategy: 'Use structured error handling',
52
+ tactics: ['validate inputs', 'log errors'],
53
+ },
54
+ verification: {
55
+ successIndicators: ['no unhandled errors'],
56
+ failureIndicators: ['silent failures'],
57
+ },
58
+ evolution: {
59
+ version: '1.0.0',
60
+ createdFrom: ['traj-1'],
61
+ failures: [],
62
+ refinements: [],
63
+ successCount: 3,
64
+ failureCount: 1,
65
+ },
66
+ confidence: 0.75,
67
+ complexity: 'moderate',
68
+ estimatedEffort: 3,
69
+ createdAt: new Date('2024-01-01'),
70
+ updatedAt: new Date('2024-01-02'),
71
+ ...overrides,
72
+ };
73
+ }
74
+
75
+ function createTestReflexion(overrides: Partial<ReflexionEpisode> = {}): ReflexionEpisode {
76
+ return {
77
+ id: 'ref-1',
78
+ trajectoryId: 'traj-1',
79
+ taskSummary: 'Fixed auth bug',
80
+ outcome: 'success',
81
+ selfCritique: 'Could have been faster',
82
+ keyInsights: ['check middleware first'],
83
+ strategyAssessment: 'good approach',
84
+ suggestedPlaybookUpdates: [],
85
+ domain: 'code',
86
+ createdAt: new Date('2024-01-01'),
87
+ ...overrides,
88
+ };
89
+ }
90
+
91
+ function createTestMetaObservation(overrides: Partial<MetaObservation> = {}): MetaObservation {
92
+ return {
93
+ id: 'obs-1',
94
+ trajectoryId: 'traj-1',
95
+ routing: { decision: 'adapt', confidence: 0.8, reasoning: 'similar past experience' },
96
+ memoryUsage: { experiencesRetrieved: 3, playbooksApplied: ['pb-1'], retrievalQuality: 'helpful' },
97
+ execution: { decompositionUsed: false, refinementIterations: 1, backtrackingOccurred: false, toolsUsed: ['grep'] },
98
+ outcome: { success: true, quality: 'good', effortActual: 5, effortEstimate: 8 },
99
+ lessons: { whatWorked: ['experience retrieval'], whatFailed: [], suggestions: [] },
100
+ timestamp: new Date('2024-01-01'),
101
+ ...overrides,
102
+ };
103
+ }
104
+
105
+ function createTestMetaStrategy(overrides: Partial<MetaStrategy> = {}): MetaStrategy {
106
+ return {
107
+ id: 'strat-1',
108
+ name: 'Experience-heavy retrieval',
109
+ condition: { taskCharacteristics: ['familiar domain'], memoryState: ['many experiences'] },
110
+ adjustment: {
111
+ routingBias: { adapt: 0.2 },
112
+ retrievalModification: 'expand query',
113
+ executionHint: 'prefer decomposition',
114
+ },
115
+ applicationCount: 5,
116
+ successRate: 0.8,
117
+ createdAt: new Date('2024-01-01'),
118
+ updatedAt: new Date('2024-01-02'),
119
+ ...overrides,
120
+ };
121
+ }
122
+
123
+ // ============================================================================
124
+ // Tests
125
+ // ============================================================================
126
+
127
+ describe('SqlitePersistence', () => {
128
+ let persistence: SqlitePersistence;
129
+ let tmpDir: string;
130
+
131
+ beforeEach(async () => {
132
+ tmpDir = mkdtempSync(join(tmpdir(), 'atlas-test-'));
133
+ persistence = createSqlitePersistence({ baseDir: tmpDir });
134
+ await persistence.init();
135
+ });
136
+
137
+ afterEach(() => {
138
+ persistence.close();
139
+ rmSync(tmpDir, { recursive: true, force: true });
140
+ });
141
+
142
+ // --------------------------------------------------------------------------
143
+ // Init & lifecycle
144
+ // --------------------------------------------------------------------------
145
+
146
+ describe('initialization', () => {
147
+ it('should create the database file', () => {
148
+ expect(persistence.isInitialized).toBe(true);
149
+ });
150
+
151
+ it('should be idempotent (calling init twice is safe)', async () => {
152
+ await persistence.init();
153
+ expect(persistence.isInitialized).toBe(true);
154
+ });
155
+
156
+ it('should report dbPath', () => {
157
+ expect(persistence.dbPath).toContain('cognitive-core.db');
158
+ });
159
+ });
160
+
161
+ // --------------------------------------------------------------------------
162
+ // Schema version
163
+ // --------------------------------------------------------------------------
164
+
165
+ describe('schema version', () => {
166
+ it('should default to 0 when no version set', () => {
167
+ expect(persistence.getSchemaVersion()).toBe(0);
168
+ });
169
+
170
+ it('should track schema versions', () => {
171
+ persistence.setSchemaVersion(1);
172
+ expect(persistence.getSchemaVersion()).toBe(1);
173
+
174
+ persistence.setSchemaVersion(2);
175
+ expect(persistence.getSchemaVersion()).toBe(2);
176
+ });
177
+ });
178
+
179
+ // --------------------------------------------------------------------------
180
+ // Experiences CRUD
181
+ // --------------------------------------------------------------------------
182
+
183
+ describe('experiences', () => {
184
+ it('should insert and retrieve an experience', () => {
185
+ const exp = createTestExperience();
186
+ persistence.insertExperience(exp);
187
+
188
+ const row = persistence.getExperience('exp-1');
189
+ expect(row).toBeDefined();
190
+ expect(row!.id).toBe('exp-1');
191
+ expect(row!.task_input).toBe('Fix the login bug');
192
+ expect(row!.success).toBe(1); // boolean → integer
193
+ expect(row!.domain).toBe('code');
194
+ expect(row!.tier).toBe('hot');
195
+ });
196
+
197
+ it('should return undefined for missing experience', () => {
198
+ expect(persistence.getExperience('nonexistent')).toBeUndefined();
199
+ });
200
+
201
+ it('should get all experiences', () => {
202
+ persistence.insertExperience(createTestExperience({ id: 'exp-1' }));
203
+ persistence.insertExperience(createTestExperience({ id: 'exp-2', domain: 'data' }));
204
+
205
+ const all = persistence.getAllExperiences();
206
+ expect(all).toHaveLength(2);
207
+ });
208
+
209
+ it('should filter by domain', () => {
210
+ persistence.insertExperience(createTestExperience({ id: 'exp-1', domain: 'code' }));
211
+ persistence.insertExperience(createTestExperience({ id: 'exp-2', domain: 'data' }));
212
+
213
+ const codeExps = persistence.getExperiencesByDomain('code');
214
+ expect(codeExps).toHaveLength(1);
215
+ expect(codeExps[0].id).toBe('exp-1');
216
+ });
217
+
218
+ it('should filter by trajectory', () => {
219
+ persistence.insertExperience(createTestExperience({ id: 'exp-1', trajectoryId: 'traj-1' }));
220
+ persistence.insertExperience(createTestExperience({ id: 'exp-2', trajectoryId: 'traj-2' }));
221
+
222
+ const results = persistence.getExperiencesByTrajectory('traj-1');
223
+ expect(results).toHaveLength(1);
224
+ });
225
+
226
+ it('should get experience IDs for inverted index', () => {
227
+ persistence.insertExperience(createTestExperience({ id: 'exp-1' }));
228
+ persistence.insertExperience(createTestExperience({ id: 'exp-2' }));
229
+
230
+ const ids = persistence.getExperienceIds();
231
+ expect(ids).toHaveLength(2);
232
+ expect(ids[0]).toHaveProperty('id');
233
+ expect(ids[0]).toHaveProperty('task_input');
234
+ });
235
+
236
+ it('should update an experience', () => {
237
+ persistence.insertExperience(createTestExperience());
238
+
239
+ persistence.updateExperience('exp-1', { usageCount: 5, tier: 'warm' });
240
+
241
+ const row = persistence.getExperience('exp-1');
242
+ expect(row!.usage_count).toBe(5);
243
+ expect(row!.tier).toBe('warm');
244
+ });
245
+
246
+ it('should delete an experience', () => {
247
+ persistence.insertExperience(createTestExperience());
248
+ expect(persistence.deleteExperience('exp-1')).toBe(true);
249
+ expect(persistence.getExperience('exp-1')).toBeUndefined();
250
+ });
251
+
252
+ it('should return false when deleting nonexistent', () => {
253
+ expect(persistence.deleteExperience('nonexistent')).toBe(false);
254
+ });
255
+
256
+ it('should count experiences', () => {
257
+ expect(persistence.getExperienceCount()).toBe(0);
258
+ persistence.insertExperience(createTestExperience());
259
+ expect(persistence.getExperienceCount()).toBe(1);
260
+ });
261
+
262
+ it('should handle embedding round-trip', () => {
263
+ const embedding = [0.1, 0.2, 0.3, 0.4];
264
+ persistence.insertExperience(createTestExperience({ embedding }));
265
+
266
+ const row = persistence.getExperience('exp-1');
267
+ expect(row!.embedding).toBeDefined();
268
+ expect(row!.embedding).toBeInstanceOf(Buffer);
269
+ });
270
+
271
+ it('should bulk delete with WHERE clause', () => {
272
+ persistence.insertExperience(createTestExperience({ id: 'exp-1', tier: 'cold' as 'hot' | 'warm' | 'cold' }));
273
+ persistence.insertExperience(createTestExperience({ id: 'exp-2', tier: 'hot' }));
274
+
275
+ const deleted = persistence.deleteExperiencesWhere('tier = ?', ['cold']);
276
+ expect(deleted).toBe(1);
277
+ expect(persistence.getExperienceCount()).toBe(1);
278
+ });
279
+ });
280
+
281
+ // --------------------------------------------------------------------------
282
+ // Playbooks CRUD
283
+ // --------------------------------------------------------------------------
284
+
285
+ describe('playbooks', () => {
286
+ it('should insert and retrieve a playbook', () => {
287
+ const pb = createTestPlaybook();
288
+ persistence.insertPlaybook(pb);
289
+
290
+ const row = persistence.getPlaybook('pb-1');
291
+ expect(row).toBeDefined();
292
+ expect(row!.name).toBe('Error Handling Strategy');
293
+ expect(row!.confidence).toBe(0.75);
294
+ expect(row!.primary_domain).toBe('code');
295
+ });
296
+
297
+ it('should get all playbooks', () => {
298
+ persistence.insertPlaybook(createTestPlaybook({ id: 'pb-1' }));
299
+ persistence.insertPlaybook(createTestPlaybook({ id: 'pb-2', name: 'Another' }));
300
+
301
+ expect(persistence.getAllPlaybooks()).toHaveLength(2);
302
+ });
303
+
304
+ it('should filter by domain', () => {
305
+ persistence.insertPlaybook(createTestPlaybook({ id: 'pb-1' }));
306
+ persistence.insertPlaybook(createTestPlaybook({
307
+ id: 'pb-2',
308
+ applicability: { situations: [], triggers: [], antiPatterns: [], domains: ['data'] },
309
+ }));
310
+
311
+ const codePlaybooks = persistence.getPlaybooksByDomain('code');
312
+ expect(codePlaybooks).toHaveLength(1);
313
+ });
314
+
315
+ it('should update a playbook', () => {
316
+ persistence.insertPlaybook(createTestPlaybook());
317
+
318
+ persistence.updatePlaybook('pb-1', { confidence: 0.9, complexity: 'simple' });
319
+
320
+ const row = persistence.getPlaybook('pb-1');
321
+ expect(row!.confidence).toBe(0.9);
322
+ expect(row!.complexity).toBe('simple');
323
+ });
324
+
325
+ it('should delete a playbook', () => {
326
+ persistence.insertPlaybook(createTestPlaybook());
327
+ expect(persistence.deletePlaybook('pb-1')).toBe(true);
328
+ expect(persistence.getPlaybook('pb-1')).toBeUndefined();
329
+ });
330
+
331
+ it('should count playbooks', () => {
332
+ expect(persistence.getPlaybookCount()).toBe(0);
333
+ persistence.insertPlaybook(createTestPlaybook());
334
+ expect(persistence.getPlaybookCount()).toBe(1);
335
+ });
336
+
337
+ it('should snapshot playbook versions', () => {
338
+ persistence.insertPlaybook(createTestPlaybook());
339
+ persistence.snapshotPlaybookVersion('pb-1', '1.0.0', 'Initial version');
340
+
341
+ const versions = persistence.getPlaybookVersions('pb-1');
342
+ expect(versions).toHaveLength(1);
343
+ expect(versions[0].version).toBe('1.0.0');
344
+ expect(versions[0].changelog).toBe('Initial version');
345
+
346
+ // Snapshot should contain valid JSON of the playbook
347
+ const snapshot = JSON.parse(versions[0].playbook_snapshot);
348
+ expect(snapshot.name).toBe('Error Handling Strategy');
349
+ });
350
+
351
+ it('should store JSON fields correctly', () => {
352
+ persistence.insertPlaybook(createTestPlaybook());
353
+ const row = persistence.getPlaybook('pb-1');
354
+
355
+ const applicability = JSON.parse(row!.applicability);
356
+ expect(applicability.situations).toContain('error handling');
357
+
358
+ const guidance = JSON.parse(row!.guidance);
359
+ expect(guidance.strategy).toBe('Use structured error handling');
360
+ });
361
+ });
362
+
363
+ // --------------------------------------------------------------------------
364
+ // Reflexion Episodes CRUD
365
+ // --------------------------------------------------------------------------
366
+
367
+ describe('reflexion episodes', () => {
368
+ it('should insert and retrieve a reflexion episode', () => {
369
+ persistence.insertReflexionEpisode(createTestReflexion());
370
+
371
+ const row = persistence.getReflexionEpisode('ref-1');
372
+ expect(row).toBeDefined();
373
+ expect(row!.outcome).toBe('success');
374
+ expect(row!.domain).toBe('code');
375
+ });
376
+
377
+ it('should filter by domain and outcome', () => {
378
+ persistence.insertReflexionEpisode(createTestReflexion({ id: 'ref-1', domain: 'code', outcome: 'success' }));
379
+ persistence.insertReflexionEpisode(createTestReflexion({ id: 'ref-2', domain: 'code', outcome: 'failure' }));
380
+ persistence.insertReflexionEpisode(createTestReflexion({ id: 'ref-3', domain: 'data', outcome: 'success' }));
381
+
382
+ const codeSuccess = persistence.getReflexionEpisodes({ domain: 'code', outcome: 'success' });
383
+ expect(codeSuccess).toHaveLength(1);
384
+ expect(codeSuccess[0].id).toBe('ref-1');
385
+ });
386
+
387
+ it('should respect limit', () => {
388
+ for (let i = 0; i < 5; i++) {
389
+ persistence.insertReflexionEpisode(createTestReflexion({
390
+ id: `ref-${i}`,
391
+ createdAt: new Date(2024, 0, i + 1),
392
+ }));
393
+ }
394
+
395
+ const limited = persistence.getReflexionEpisodes({ limit: 3 });
396
+ expect(limited).toHaveLength(3);
397
+ });
398
+
399
+ it('should get by trajectory', () => {
400
+ persistence.insertReflexionEpisode(createTestReflexion({ id: 'ref-1', trajectoryId: 'traj-1' }));
401
+ persistence.insertReflexionEpisode(createTestReflexion({ id: 'ref-2', trajectoryId: 'traj-2' }));
402
+
403
+ const results = persistence.getReflexionByTrajectory('traj-1');
404
+ expect(results).toHaveLength(1);
405
+ });
406
+ });
407
+
408
+ // --------------------------------------------------------------------------
409
+ // Causal Edges CRUD
410
+ // --------------------------------------------------------------------------
411
+
412
+ describe('causal edges', () => {
413
+ it('should insert and retrieve a causal edge', () => {
414
+ persistence.insertCausalEdge({
415
+ id: 'edge-1',
416
+ cause: 'missing validation',
417
+ effect: 'runtime error',
418
+ confidence: 0.9,
419
+ domain: 'code',
420
+ sourceTrajectoryIds: ['traj-1'],
421
+ observedCount: 3,
422
+ createdAt: new Date('2024-01-01'),
423
+ updatedAt: new Date('2024-01-02'),
424
+ });
425
+
426
+ const row = persistence.getCausalEdge('edge-1');
427
+ expect(row).toBeDefined();
428
+ expect(row!.cause).toBe('missing validation');
429
+ expect(row!.confidence).toBe(0.9);
430
+ expect(JSON.parse(row!.source_trajectory_ids)).toEqual(['traj-1']);
431
+ });
432
+
433
+ it('should get all and filter by domain', () => {
434
+ persistence.insertCausalEdge({
435
+ id: 'edge-1', cause: 'a', effect: 'b', confidence: 0.5,
436
+ domain: 'code', sourceTrajectoryIds: [], observedCount: 1,
437
+ createdAt: new Date(), updatedAt: new Date(),
438
+ });
439
+ persistence.insertCausalEdge({
440
+ id: 'edge-2', cause: 'c', effect: 'd', confidence: 0.5,
441
+ domain: 'data', sourceTrajectoryIds: [], observedCount: 1,
442
+ createdAt: new Date(), updatedAt: new Date(),
443
+ });
444
+
445
+ expect(persistence.getAllCausalEdges()).toHaveLength(2);
446
+ expect(persistence.getCausalEdgesByDomain('code')).toHaveLength(1);
447
+ });
448
+
449
+ it('should update a causal edge', () => {
450
+ persistence.insertCausalEdge({
451
+ id: 'edge-1', cause: 'a', effect: 'b', confidence: 0.5,
452
+ domain: 'code', sourceTrajectoryIds: [], observedCount: 1,
453
+ createdAt: new Date(), updatedAt: new Date(),
454
+ });
455
+
456
+ persistence.updateCausalEdge('edge-1', { confidence: 0.9, observedCount: 5 });
457
+
458
+ const row = persistence.getCausalEdge('edge-1');
459
+ expect(row!.confidence).toBe(0.9);
460
+ expect(row!.observed_count).toBe(5);
461
+ });
462
+ });
463
+
464
+ // --------------------------------------------------------------------------
465
+ // Meta Observations CRUD
466
+ // --------------------------------------------------------------------------
467
+
468
+ describe('meta observations', () => {
469
+ it('should insert and retrieve a meta observation', () => {
470
+ persistence.insertMetaObservation(createTestMetaObservation());
471
+
472
+ const row = persistence.getMetaObservation('obs-1');
473
+ expect(row).toBeDefined();
474
+ expect(row!.routing_decision).toBe('adapt');
475
+ expect(row!.outcome_success).toBe(1);
476
+ });
477
+
478
+ it('should filter by routing decision', () => {
479
+ persistence.insertMetaObservation(createTestMetaObservation({ id: 'obs-1' }));
480
+ persistence.insertMetaObservation(createTestMetaObservation({
481
+ id: 'obs-2',
482
+ routing: { decision: 'direct', confidence: 0.5, reasoning: 'test' },
483
+ }));
484
+
485
+ const adaptObs = persistence.getMetaObservationsByRouting('adapt');
486
+ expect(adaptObs).toHaveLength(1);
487
+ });
488
+
489
+ it('should aggregate routing effectiveness', () => {
490
+ persistence.insertMetaObservation(createTestMetaObservation({
491
+ id: 'obs-1',
492
+ routing: { decision: 'adapt', confidence: 0.8, reasoning: '' },
493
+ outcome: { success: true, quality: 'good', effortActual: 5, effortEstimate: 5 },
494
+ }));
495
+ persistence.insertMetaObservation(createTestMetaObservation({
496
+ id: 'obs-2',
497
+ routing: { decision: 'adapt', confidence: 0.7, reasoning: '' },
498
+ outcome: { success: false, quality: 'poor', effortActual: 10, effortEstimate: 5 },
499
+ }));
500
+ persistence.insertMetaObservation(createTestMetaObservation({
501
+ id: 'obs-3',
502
+ routing: { decision: 'direct', confidence: 0.9, reasoning: '' },
503
+ outcome: { success: true, quality: 'excellent', effortActual: 2, effortEstimate: 3 },
504
+ }));
505
+
506
+ const agg = persistence.aggregateRoutingEffectiveness();
507
+ expect(agg['adapt']).toEqual({ total: 2, successful: 1 });
508
+ expect(agg['direct']).toEqual({ total: 1, successful: 1 });
509
+ });
510
+
511
+ it('should delete observations before cutoff', () => {
512
+ persistence.insertMetaObservation(createTestMetaObservation({
513
+ id: 'obs-old',
514
+ timestamp: new Date('2023-01-01'),
515
+ }));
516
+ persistence.insertMetaObservation(createTestMetaObservation({
517
+ id: 'obs-new',
518
+ timestamp: new Date('2024-06-01'),
519
+ }));
520
+
521
+ const deleted = persistence.deleteMetaObservationsBefore(new Date('2024-01-01'));
522
+ expect(deleted).toBe(1);
523
+ expect(persistence.getMetaObservationCount()).toBe(1);
524
+ });
525
+ });
526
+
527
+ // --------------------------------------------------------------------------
528
+ // Meta Strategies CRUD
529
+ // --------------------------------------------------------------------------
530
+
531
+ describe('meta strategies', () => {
532
+ it('should insert and retrieve a meta strategy', () => {
533
+ persistence.insertMetaStrategy(createTestMetaStrategy());
534
+
535
+ const row = persistence.getMetaStrategy('strat-1');
536
+ expect(row).toBeDefined();
537
+ expect(row!.name).toBe('Experience-heavy retrieval');
538
+ expect(row!.success_rate).toBe(0.8);
539
+ });
540
+
541
+ it('should get by name', () => {
542
+ persistence.insertMetaStrategy(createTestMetaStrategy());
543
+
544
+ const row = persistence.getMetaStrategyByName('Experience-heavy retrieval');
545
+ expect(row).toBeDefined();
546
+ });
547
+
548
+ it('should update a meta strategy', () => {
549
+ persistence.insertMetaStrategy(createTestMetaStrategy());
550
+
551
+ persistence.updateMetaStrategy('strat-1', { applicationCount: 10, successRate: 0.9 });
552
+
553
+ const row = persistence.getMetaStrategy('strat-1');
554
+ expect(row!.application_count).toBe(10);
555
+ expect(row!.success_rate).toBe(0.9);
556
+ });
557
+
558
+ it('should delete a meta strategy', () => {
559
+ persistence.insertMetaStrategy(createTestMetaStrategy());
560
+ expect(persistence.deleteMetaStrategy('strat-1')).toBe(true);
561
+ expect(persistence.getMetaStrategy('strat-1')).toBeUndefined();
562
+ });
563
+ });
564
+
565
+ // --------------------------------------------------------------------------
566
+ // System State (key-value)
567
+ // --------------------------------------------------------------------------
568
+
569
+ describe('system state', () => {
570
+ it('should store and retrieve typed state', () => {
571
+ persistence.setSystemState('moe_gate', { weights: [0.1, 0.2, 0.7] });
572
+
573
+ const state = persistence.getSystemState<{ weights: number[] }>('moe_gate');
574
+ expect(state).toBeDefined();
575
+ expect(state!.weights).toEqual([0.1, 0.2, 0.7]);
576
+ });
577
+
578
+ it('should return undefined for missing key', () => {
579
+ expect(persistence.getSystemState('nonexistent')).toBeUndefined();
580
+ });
581
+
582
+ it('should overwrite existing state', () => {
583
+ persistence.setSystemState('counter', 1);
584
+ persistence.setSystemState('counter', 2);
585
+
586
+ expect(persistence.getSystemState<number>('counter')).toBe(2);
587
+ });
588
+
589
+ it('should delete state', () => {
590
+ persistence.setSystemState('temp', 'value');
591
+ expect(persistence.deleteSystemState('temp')).toBe(true);
592
+ expect(persistence.getSystemState('temp')).toBeUndefined();
593
+ });
594
+ });
595
+
596
+ // --------------------------------------------------------------------------
597
+ // Transactions
598
+ // --------------------------------------------------------------------------
599
+
600
+ describe('transactions', () => {
601
+ it('should commit batch inserts atomically', () => {
602
+ persistence.transaction(() => {
603
+ for (let i = 0; i < 10; i++) {
604
+ persistence.insertExperience(createTestExperience({ id: `exp-${i}` }));
605
+ }
606
+ });
607
+
608
+ expect(persistence.getExperienceCount()).toBe(10);
609
+ });
610
+
611
+ it('should roll back on error', () => {
612
+ try {
613
+ persistence.transaction(() => {
614
+ persistence.insertExperience(createTestExperience({ id: 'exp-1' }));
615
+ throw new Error('Simulated failure');
616
+ });
617
+ } catch {
618
+ // Expected
619
+ }
620
+
621
+ expect(persistence.getExperienceCount()).toBe(0);
622
+ });
623
+ });
624
+
625
+ // --------------------------------------------------------------------------
626
+ // Factory
627
+ // --------------------------------------------------------------------------
628
+
629
+ describe('factory', () => {
630
+ it('should create persistence with default config', () => {
631
+ const p = createSqlitePersistence({ baseDir: tmpDir });
632
+ expect(p).toBeInstanceOf(SqlitePersistence);
633
+ });
634
+ });
635
+ });
@@ -8,16 +8,20 @@ import type { AgentSession, ToolCall, AgentMessage } from '../../src/runtime/typ
8
8
  import { mkdtemp, rm } from 'node:fs/promises';
9
9
  import { join } from 'node:path';
10
10
  import { tmpdir } from 'node:os';
11
+ import { createSqlitePersistence } from '../../src/persistence/index.js';
11
12
 
12
13
  describe('AgentManager', () => {
13
14
  let tempDir: string;
14
15
  let memory: MemorySystem;
15
16
  let manager: AgentManager;
16
17
  let mockBackend: MockBackend;
18
+ let persistence: any;
17
19
 
18
20
  beforeEach(async () => {
19
21
  tempDir = await mkdtemp(join(tmpdir(), 'agent-manager-test-'));
20
- memory = createMemorySystem(tempDir);
22
+ persistence = createSqlitePersistence({ baseDir: tempDir });
23
+ await persistence.init();
24
+ memory = createMemorySystem(persistence, tempDir);
21
25
  await memory.init();
22
26
 
23
27
  manager = createAgentManager(memory);
@@ -31,6 +35,7 @@ describe('AgentManager', () => {
31
35
 
32
36
  afterEach(async () => {
33
37
  await memory.close();
38
+ persistence.close();
34
39
  await rm(tempDir, { recursive: true, force: true });
35
40
  });
36
41
 
@@ -15,15 +15,19 @@ import type { MemorySystem } from '../../src/memory/system.js';
15
15
  import { mkdtemp, rm } from 'node:fs/promises';
16
16
  import { join } from 'node:path';
17
17
  import { tmpdir } from 'node:os';
18
+ import { createSqlitePersistence } from '../../src/persistence/index.js';
18
19
 
19
20
  describe('AgentDelegate', () => {
20
21
  let tempDir: string;
21
22
  let memory: MemorySystem;
22
23
  let mockBackend: MockBackend;
24
+ let persistence: any;
23
25
 
24
26
  beforeEach(async () => {
25
27
  tempDir = await mkdtemp(join(tmpdir(), 'delegate-test-'));
26
- memory = createMemorySystem(tempDir);
28
+ persistence = createSqlitePersistence({ baseDir: tempDir });
29
+ await persistence.init();
30
+ memory = createMemorySystem(persistence, tempDir);
27
31
  mockBackend = createMockBackend({
28
32
  success: true,
29
33
  result: 'Mock result',
@@ -33,6 +37,7 @@ describe('AgentDelegate', () => {
33
37
  });
34
38
 
35
39
  afterEach(async () => {
40
+ persistence.close();
36
41
  await rm(tempDir, { recursive: true, force: true });
37
42
  });
38
43