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,610 @@
1
+ /**
2
+ * End-to-end tests for Task & Plan Mode content capture
3
+ *
4
+ * Tests the full pipeline: hook event parsing → lifecycle dispatch → session state on disk.
5
+ * Uses a real git repo and real session/checkpoint stores.
6
+ */
7
+
8
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
9
+ import * as fs from 'node:fs';
10
+ import * as path from 'node:path';
11
+ import * as os from 'node:os';
12
+ import { execFileSync } from 'node:child_process';
13
+ import { createClaudeCodeAgent } from '../agent/agents/claude-code.js';
14
+ import { createLifecycleHandler } from '../hooks/lifecycle.js';
15
+ import { createSessionStore } from '../store/session-store.js';
16
+ import { createCheckpointStore } from '../store/checkpoint-store.js';
17
+ import { EventType, type Event } from '../types.js';
18
+
19
+ // ============================================================================
20
+ // Helpers
21
+ // ============================================================================
22
+
23
+ function initRepo(dir: string): void {
24
+ execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' });
25
+ execFileSync('git', ['config', 'user.email', 'test@test.com'], { cwd: dir, stdio: 'pipe' });
26
+ execFileSync('git', ['config', 'user.name', 'Test'], { cwd: dir, stdio: 'pipe' });
27
+ fs.writeFileSync(path.join(dir, 'README.md'), '# Test');
28
+ execFileSync('git', ['add', '.'], { cwd: dir, stdio: 'pipe' });
29
+ execFileSync('git', ['commit', '-m', 'initial'], { cwd: dir, stdio: 'pipe' });
30
+ }
31
+
32
+ function makeEvent(overrides: Partial<Event> & { type: EventType }): Event {
33
+ return {
34
+ sessionID: 'e2e-session',
35
+ sessionRef: '/path/to/transcript.jsonl',
36
+ timestamp: new Date(),
37
+ ...overrides,
38
+ };
39
+ }
40
+
41
+ // ============================================================================
42
+ // Tests
43
+ // ============================================================================
44
+
45
+ describe('Task & Plan Mode — E2E', () => {
46
+ let tmpDir: string;
47
+ let agent: ReturnType<typeof createClaudeCodeAgent>;
48
+
49
+ beforeEach(() => {
50
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'sessionlog-e2e-'));
51
+ initRepo(tmpDir);
52
+ agent = createClaudeCodeAgent();
53
+ });
54
+
55
+ afterEach(() => {
56
+ fs.rmSync(tmpDir, { recursive: true, force: true });
57
+ });
58
+
59
+ describe('Full task lifecycle with content', () => {
60
+ it('should persist task description through create → update → session state on disk', async () => {
61
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
62
+ fs.mkdirSync(sessionsDir, { recursive: true });
63
+
64
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
65
+ const checkpointStore = createCheckpointStore(tmpDir);
66
+ const lifecycle = createLifecycleHandler({
67
+ sessionStore,
68
+ checkpointStore,
69
+ cwd: tmpDir,
70
+ });
71
+
72
+ // 1. Start a session
73
+ await lifecycle.dispatch(
74
+ agent,
75
+ makeEvent({
76
+ type: EventType.SessionStart,
77
+ }),
78
+ );
79
+
80
+ // Verify session exists
81
+ let state = await sessionStore.load('e2e-session');
82
+ expect(state).not.toBeNull();
83
+ expect(state!.phase).toBe('idle');
84
+
85
+ // 2. Create a task with description
86
+ const taskCreateStdin = JSON.stringify({
87
+ session_id: 'e2e-session',
88
+ transcript_path: '/path/to/transcript.jsonl',
89
+ tool_use_id: 'tu-create-1',
90
+ tool_input: {
91
+ subject: 'Implement OAuth login flow',
92
+ description:
93
+ 'Add OAuth2 support with Google and GitHub providers. Include token refresh logic and session management.',
94
+ activeForm: 'Implementing OAuth login flow',
95
+ },
96
+ tool_response: {
97
+ taskId: '42',
98
+ },
99
+ });
100
+
101
+ const createEvent = agent.parseHookEvent('post-task-create', taskCreateStdin);
102
+ expect(createEvent).not.toBeNull();
103
+ await lifecycle.dispatch(agent, createEvent!);
104
+
105
+ // Verify task with description persisted
106
+ state = await sessionStore.load('e2e-session');
107
+ expect(state!.tasks).toBeDefined();
108
+ expect(state!.tasks!['42']).toBeDefined();
109
+ expect(state!.tasks!['42'].subject).toBe('Implement OAuth login flow');
110
+ expect(state!.tasks!['42'].description).toBe(
111
+ 'Add OAuth2 support with Google and GitHub providers. Include token refresh logic and session management.',
112
+ );
113
+ expect(state!.tasks!['42'].status).toBe('pending');
114
+ expect(state!.tasks!['42'].activeForm).toBe('Implementing OAuth login flow');
115
+
116
+ // 3. Update the task to in_progress
117
+ const taskUpdateStdin = JSON.stringify({
118
+ session_id: 'e2e-session',
119
+ transcript_path: '/path/to/transcript.jsonl',
120
+ tool_use_id: 'tu-update-1',
121
+ tool_input: {
122
+ taskId: '42',
123
+ status: 'in_progress',
124
+ },
125
+ });
126
+
127
+ const updateEvent = agent.parseHookEvent('post-task-update', taskUpdateStdin);
128
+ expect(updateEvent).not.toBeNull();
129
+ await lifecycle.dispatch(agent, updateEvent!);
130
+
131
+ state = await sessionStore.load('e2e-session');
132
+ expect(state!.tasks!['42'].status).toBe('in_progress');
133
+ // Description should be preserved from create
134
+ expect(state!.tasks!['42'].description).toBe(
135
+ 'Add OAuth2 support with Google and GitHub providers. Include token refresh logic and session management.',
136
+ );
137
+
138
+ // 4. Complete the task with updated description
139
+ const taskCompleteStdin = JSON.stringify({
140
+ session_id: 'e2e-session',
141
+ transcript_path: '/path/to/transcript.jsonl',
142
+ tool_use_id: 'tu-update-2',
143
+ tool_input: {
144
+ taskId: '42',
145
+ status: 'completed',
146
+ description:
147
+ 'Implemented OAuth2 with Google and GitHub. Added token refresh and session management. Tests passing.',
148
+ },
149
+ });
150
+
151
+ const completeEvent = agent.parseHookEvent('post-task-update', taskCompleteStdin);
152
+ await lifecycle.dispatch(agent, completeEvent!);
153
+
154
+ state = await sessionStore.load('e2e-session');
155
+ expect(state!.tasks!['42'].status).toBe('completed');
156
+ expect(state!.tasks!['42'].description).toBe(
157
+ 'Implemented OAuth2 with Google and GitHub. Added token refresh and session management. Tests passing.',
158
+ );
159
+
160
+ // 5. Verify the data is actually on disk by reading the JSON file directly
161
+ const sessionFile = path.join(sessionsDir, 'e2e-session.json');
162
+ expect(fs.existsSync(sessionFile)).toBe(true);
163
+ const rawJSON = JSON.parse(fs.readFileSync(sessionFile, 'utf-8'));
164
+ expect(rawJSON.tasks['42'].description).toBe(
165
+ 'Implemented OAuth2 with Google and GitHub. Added token refresh and session management. Tests passing.',
166
+ );
167
+ });
168
+ });
169
+
170
+ describe('Full plan mode lifecycle with content', () => {
171
+ it('should persist plan file content through enter → exit → session state on disk', async () => {
172
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
173
+ fs.mkdirSync(sessionsDir, { recursive: true });
174
+
175
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
176
+ const checkpointStore = createCheckpointStore(tmpDir);
177
+ const lifecycle = createLifecycleHandler({
178
+ sessionStore,
179
+ checkpointStore,
180
+ cwd: tmpDir,
181
+ });
182
+
183
+ // 1. Start a session
184
+ await lifecycle.dispatch(
185
+ agent,
186
+ makeEvent({
187
+ type: EventType.SessionStart,
188
+ }),
189
+ );
190
+
191
+ // 2. Enter plan mode
192
+ const enterStdin = JSON.stringify({
193
+ session_id: 'e2e-session',
194
+ transcript_path: '/path/to/transcript.jsonl',
195
+ });
196
+ const enterEvent = agent.parseHookEvent('post-plan-enter', enterStdin);
197
+ expect(enterEvent).not.toBeNull();
198
+ await lifecycle.dispatch(agent, enterEvent!);
199
+
200
+ let state = await sessionStore.load('e2e-session');
201
+ expect(state!.inPlanMode).toBe(true);
202
+ expect(state!.planModeEntries).toBe(1);
203
+
204
+ // 3. Create a real plan file on disk
205
+ const planDir = path.join(tmpDir, '.claude', 'plans');
206
+ fs.mkdirSync(planDir, { recursive: true });
207
+ const planFilePath = path.join(planDir, 'my-feature-plan.md');
208
+ const planContent = `# Feature Plan: Add Dark Mode
209
+
210
+ ## Context
211
+ Users have requested a dark mode theme for the application.
212
+
213
+ ## Changes
214
+ 1. Add CSS custom properties for theming
215
+ 2. Create ThemeProvider component
216
+ 3. Add toggle in settings
217
+
218
+ ## Verification
219
+ - Visual regression tests pass
220
+ - Toggle persists across sessions
221
+ `;
222
+ fs.writeFileSync(planFilePath, planContent);
223
+
224
+ // 4. Exit plan mode with the plan file path in tool_response
225
+ const exitStdin = JSON.stringify({
226
+ session_id: 'e2e-session',
227
+ transcript_path: '/path/to/transcript.jsonl',
228
+ tool_input: {
229
+ allowedPrompts: [{ tool: 'Bash', prompt: 'run tests' }],
230
+ },
231
+ tool_response: {
232
+ planFilePath: planFilePath,
233
+ },
234
+ });
235
+ const exitEvent = agent.parseHookEvent('post-plan-exit', exitStdin);
236
+ expect(exitEvent).not.toBeNull();
237
+ expect(exitEvent!.planFilePath).toBe(planFilePath);
238
+
239
+ await lifecycle.dispatch(agent, exitEvent!);
240
+
241
+ // 5. Verify session state has plan content
242
+ state = await sessionStore.load('e2e-session');
243
+ expect(state!.inPlanMode).toBe(false);
244
+ expect(state!.planModeEntries).toBe(1);
245
+ expect(state!.planEntries).toHaveLength(1);
246
+ // Path is normalized to CWD-relative since plan file is inside tmpDir
247
+ const expectedRelPath = path.relative(tmpDir, planFilePath);
248
+ expect(state!.planEntries![0].filePath).toBe(expectedRelPath);
249
+ expect(state!.planEntries![0].content).toBe(planContent);
250
+ expect(state!.planEntries![0].exitedAt).toBeDefined();
251
+
252
+ // 6. Verify it's actually on disk
253
+ const sessionFile = path.join(sessionsDir, 'e2e-session.json');
254
+ const rawJSON = JSON.parse(fs.readFileSync(sessionFile, 'utf-8'));
255
+ expect(rawJSON.planEntries).toHaveLength(1);
256
+ expect(rawJSON.planEntries[0].filePath).toBe(expectedRelPath);
257
+ expect(rawJSON.planEntries[0].content).toBe(planContent);
258
+ });
259
+
260
+ it('should handle plan file path from string response message', async () => {
261
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
262
+ fs.mkdirSync(sessionsDir, { recursive: true });
263
+
264
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
265
+ const checkpointStore = createCheckpointStore(tmpDir);
266
+ const lifecycle = createLifecycleHandler({
267
+ sessionStore,
268
+ checkpointStore,
269
+ cwd: tmpDir,
270
+ });
271
+
272
+ await lifecycle.dispatch(
273
+ agent,
274
+ makeEvent({
275
+ type: EventType.SessionStart,
276
+ }),
277
+ );
278
+
279
+ await lifecycle.dispatch(
280
+ agent,
281
+ makeEvent({
282
+ type: EventType.PlanModeEnter,
283
+ }),
284
+ );
285
+
286
+ // Create a plan file
287
+ const planDir = path.join(tmpDir, '.claude', 'plans');
288
+ fs.mkdirSync(planDir, { recursive: true });
289
+ const planFilePath = path.join(planDir, 'string-response-plan.md');
290
+ fs.writeFileSync(planFilePath, '# Simple plan\nDo the thing.');
291
+
292
+ // tool_response is a string message (not an object)
293
+ const exitStdin = JSON.stringify({
294
+ session_id: 'e2e-session',
295
+ transcript_path: '/path/to/transcript.jsonl',
296
+ tool_input: {},
297
+ tool_response: `Your plan has been saved to: ${planFilePath}`,
298
+ });
299
+ const exitEvent = agent.parseHookEvent('post-plan-exit', exitStdin);
300
+ expect(exitEvent!.planFilePath).toBe(planFilePath);
301
+
302
+ await lifecycle.dispatch(agent, exitEvent!);
303
+
304
+ const state = await sessionStore.load('e2e-session');
305
+ // Path normalized to CWD-relative since plan file is inside tmpDir
306
+ expect(state!.planEntries![0].filePath).toBe(path.relative(tmpDir, planFilePath));
307
+ expect(state!.planEntries![0].content).toBe('# Simple plan\nDo the thing.');
308
+ });
309
+
310
+ it('should gracefully handle missing plan file', async () => {
311
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
312
+ fs.mkdirSync(sessionsDir, { recursive: true });
313
+
314
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
315
+ const checkpointStore = createCheckpointStore(tmpDir);
316
+ const lifecycle = createLifecycleHandler({
317
+ sessionStore,
318
+ checkpointStore,
319
+ cwd: tmpDir,
320
+ });
321
+
322
+ await lifecycle.dispatch(
323
+ agent,
324
+ makeEvent({
325
+ type: EventType.SessionStart,
326
+ }),
327
+ );
328
+
329
+ await lifecycle.dispatch(
330
+ agent,
331
+ makeEvent({
332
+ type: EventType.PlanModeEnter,
333
+ }),
334
+ );
335
+
336
+ // Exit with a plan file path that doesn't exist
337
+ const exitStdin = JSON.stringify({
338
+ session_id: 'e2e-session',
339
+ transcript_path: '/path/to/transcript.jsonl',
340
+ tool_input: {},
341
+ tool_response: {
342
+ planFilePath: '/nonexistent/plan.md',
343
+ },
344
+ });
345
+ const exitEvent = agent.parseHookEvent('post-plan-exit', exitStdin);
346
+ await lifecycle.dispatch(agent, exitEvent!);
347
+
348
+ const state = await sessionStore.load('e2e-session');
349
+ expect(state!.inPlanMode).toBe(false);
350
+ expect(state!.planEntries![0].filePath).toBe('/nonexistent/plan.md');
351
+ expect(state!.planEntries![0].content).toBeUndefined();
352
+ });
353
+ });
354
+
355
+ describe('Combined task + plan mode flow', () => {
356
+ it('should track tasks and plan mode together in the same session', async () => {
357
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
358
+ fs.mkdirSync(sessionsDir, { recursive: true });
359
+
360
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
361
+ const checkpointStore = createCheckpointStore(tmpDir);
362
+ const lifecycle = createLifecycleHandler({
363
+ sessionStore,
364
+ checkpointStore,
365
+ cwd: tmpDir,
366
+ });
367
+
368
+ // Start session
369
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.SessionStart }));
370
+
371
+ // Enter plan mode
372
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.PlanModeEnter }));
373
+
374
+ // Exit plan mode (no plan file for simplicity)
375
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.PlanModeExit }));
376
+
377
+ // Create multiple tasks
378
+ for (const [id, subject, desc] of [
379
+ ['1', 'Set up project structure', 'Create directories and config files'],
380
+ ['2', 'Implement core logic', 'Write the main business logic module'],
381
+ ['3', 'Add tests', 'Write unit and integration tests'],
382
+ ] as const) {
383
+ const stdin = JSON.stringify({
384
+ session_id: 'e2e-session',
385
+ transcript_path: '/path/to/transcript.jsonl',
386
+ tool_use_id: `tu-${id}`,
387
+ tool_input: { subject, description: desc },
388
+ tool_response: { taskId: id },
389
+ });
390
+ const event = agent.parseHookEvent('post-task-create', stdin);
391
+ await lifecycle.dispatch(agent, event!);
392
+ }
393
+
394
+ // Update task 1 to completed
395
+ const updateStdin = JSON.stringify({
396
+ session_id: 'e2e-session',
397
+ transcript_path: '/path/to/transcript.jsonl',
398
+ tool_use_id: 'tu-update',
399
+ tool_input: { taskId: '1', status: 'completed' },
400
+ });
401
+ const updateEvent = agent.parseHookEvent('post-task-update', updateStdin);
402
+ await lifecycle.dispatch(agent, updateEvent!);
403
+
404
+ // Verify final state
405
+ const state = await sessionStore.load('e2e-session');
406
+
407
+ // Plan mode tracking
408
+ expect(state!.inPlanMode).toBe(false);
409
+ expect(state!.planModeEntries).toBe(1);
410
+
411
+ // Task tracking with descriptions
412
+ expect(Object.keys(state!.tasks!)).toHaveLength(3);
413
+ expect(state!.tasks!['1'].status).toBe('completed');
414
+ expect(state!.tasks!['1'].description).toBe('Create directories and config files');
415
+ expect(state!.tasks!['2'].status).toBe('pending');
416
+ expect(state!.tasks!['2'].description).toBe('Write the main business logic module');
417
+ expect(state!.tasks!['3'].status).toBe('pending');
418
+ expect(state!.tasks!['3'].description).toBe('Write unit and integration tests');
419
+ });
420
+ });
421
+
422
+ describe('CLI stdin parsing → lifecycle dispatch', () => {
423
+ it('should parse real Claude Code hook JSON and produce correct events', () => {
424
+ // Simulate exactly what Claude Code sends via PostToolUse hook for TaskCreate
425
+ const hookPayload = {
426
+ session_id: 'abc-123-def',
427
+ transcript_path: '/Users/user/.claude/projects/proj/transcript.jsonl',
428
+ tool_use_id: 'toolu_01ABC',
429
+ tool_input: {
430
+ subject: 'Fix authentication bug in login flow',
431
+ description:
432
+ 'The login form fails when passwords contain special characters like & and <. Need to properly escape user input before sending to the auth API.',
433
+ activeForm: 'Fixing authentication bug',
434
+ },
435
+ tool_response: {
436
+ taskId: '7',
437
+ },
438
+ };
439
+
440
+ const event = agent.parseHookEvent('post-task-create', JSON.stringify(hookPayload));
441
+ expect(event).not.toBeNull();
442
+ expect(event!.type).toBe(EventType.TaskCreate);
443
+ expect(event!.sessionID).toBe('abc-123-def');
444
+ expect(event!.taskID).toBe('7');
445
+ expect(event!.taskSubject).toBe('Fix authentication bug in login flow');
446
+ expect(event!.taskDescription).toBe(
447
+ 'The login form fails when passwords contain special characters like & and <. Need to properly escape user input before sending to the auth API.',
448
+ );
449
+ expect(event!.taskActiveForm).toBe('Fixing authentication bug');
450
+ expect(event!.toolUseID).toBe('toolu_01ABC');
451
+ });
452
+
453
+ it('should parse real Claude Code hook JSON for ExitPlanMode with plan file', () => {
454
+ const hookPayload = {
455
+ session_id: 'abc-123-def',
456
+ transcript_path: '/Users/user/.claude/projects/proj/transcript.jsonl',
457
+ tool_use_id: 'toolu_02XYZ',
458
+ tool_input: {
459
+ allowedPrompts: [
460
+ { tool: 'Bash', prompt: 'run tests' },
461
+ { tool: 'Bash', prompt: 'install dependencies' },
462
+ ],
463
+ },
464
+ tool_response: {
465
+ planFilePath: '/Users/user/.claude/plans/my-feature.md',
466
+ },
467
+ };
468
+
469
+ const event = agent.parseHookEvent('post-plan-exit', JSON.stringify(hookPayload));
470
+ expect(event).not.toBeNull();
471
+ expect(event!.type).toBe(EventType.PlanModeExit);
472
+ expect(event!.planFilePath).toBe('/Users/user/.claude/plans/my-feature.md');
473
+ expect(event!.planAllowedPrompts).toHaveLength(2);
474
+ });
475
+
476
+ it('should parse real Claude Code hook JSON for Skill use', () => {
477
+ const hookPayload = {
478
+ session_id: 'abc-123-def',
479
+ transcript_path: '/Users/user/.claude/projects/proj/transcript.jsonl',
480
+ tool_use_id: 'toolu_03SKL',
481
+ tool_input: {
482
+ skill: 'commit',
483
+ args: '-m "Fix bug"',
484
+ },
485
+ tool_response: 'Skill executed successfully',
486
+ };
487
+
488
+ const event = agent.parseHookEvent('post-skill', JSON.stringify(hookPayload));
489
+ expect(event).not.toBeNull();
490
+ expect(event!.type).toBe(EventType.SkillUse);
491
+ expect(event!.sessionID).toBe('abc-123-def');
492
+ expect(event!.skillName).toBe('commit');
493
+ expect(event!.skillArgs).toBe('-m "Fix bug"');
494
+ expect(event!.toolUseID).toBe('toolu_03SKL');
495
+ });
496
+ });
497
+
498
+ describe('Skill usage tracking', () => {
499
+ it('should persist skill usage through lifecycle to session state on disk', async () => {
500
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
501
+ fs.mkdirSync(sessionsDir, { recursive: true });
502
+
503
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
504
+ const checkpointStore = createCheckpointStore(tmpDir);
505
+ const lifecycle = createLifecycleHandler({
506
+ sessionStore,
507
+ checkpointStore,
508
+ cwd: tmpDir,
509
+ });
510
+
511
+ // 1. Start a session
512
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.SessionStart }));
513
+
514
+ // 2. Use a skill
515
+ const skillStdin = JSON.stringify({
516
+ session_id: 'e2e-session',
517
+ transcript_path: '/path/to/transcript.jsonl',
518
+ tool_use_id: 'tu-skill-1',
519
+ tool_input: {
520
+ skill: 'commit',
521
+ args: '-m "Add feature"',
522
+ },
523
+ tool_response: 'Committed successfully',
524
+ });
525
+
526
+ const skillEvent = agent.parseHookEvent('post-skill', skillStdin);
527
+ expect(skillEvent).not.toBeNull();
528
+ await lifecycle.dispatch(agent, skillEvent!);
529
+
530
+ // 3. Use another skill (no args)
531
+ const skillStdin2 = JSON.stringify({
532
+ session_id: 'e2e-session',
533
+ transcript_path: '/path/to/transcript.jsonl',
534
+ tool_use_id: 'tu-skill-2',
535
+ tool_input: {
536
+ skill: 'review-pr',
537
+ },
538
+ tool_response: 'Review complete',
539
+ });
540
+
541
+ const skillEvent2 = agent.parseHookEvent('post-skill', skillStdin2);
542
+ await lifecycle.dispatch(agent, skillEvent2!);
543
+
544
+ // 4. Verify session state
545
+ const state = await sessionStore.load('e2e-session');
546
+ expect(state!.skillsUsed).toBeDefined();
547
+ expect(state!.skillsUsed).toHaveLength(2);
548
+ expect(state!.skillsUsed![0].name).toBe('commit');
549
+ expect(state!.skillsUsed![0].args).toBe('-m "Add feature"');
550
+ expect(state!.skillsUsed![0].usedAt).toBeDefined();
551
+ expect(state!.skillsUsed![1].name).toBe('review-pr');
552
+ expect(state!.skillsUsed![1].args).toBeUndefined();
553
+
554
+ // 5. Verify it's actually on disk
555
+ const sessionFile = path.join(sessionsDir, 'e2e-session.json');
556
+ const rawJSON = JSON.parse(fs.readFileSync(sessionFile, 'utf-8'));
557
+ expect(rawJSON.skillsUsed).toHaveLength(2);
558
+ expect(rawJSON.skillsUsed[0].name).toBe('commit');
559
+ expect(rawJSON.skillsUsed[1].name).toBe('review-pr');
560
+ });
561
+
562
+ it('should track skills alongside tasks and plan mode', async () => {
563
+ const sessionsDir = path.join(tmpDir, '.git', 'sessionlog-sessions');
564
+ fs.mkdirSync(sessionsDir, { recursive: true });
565
+
566
+ const sessionStore = createSessionStore(tmpDir, sessionsDir);
567
+ const checkpointStore = createCheckpointStore(tmpDir);
568
+ const lifecycle = createLifecycleHandler({
569
+ sessionStore,
570
+ checkpointStore,
571
+ cwd: tmpDir,
572
+ });
573
+
574
+ // Start session
575
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.SessionStart }));
576
+
577
+ // Use a skill
578
+ const skillStdin = JSON.stringify({
579
+ session_id: 'e2e-session',
580
+ transcript_path: '/path/to/transcript.jsonl',
581
+ tool_use_id: 'tu-skill-1',
582
+ tool_input: { skill: 'frontend-design' },
583
+ });
584
+ const skillEvent = agent.parseHookEvent('post-skill', skillStdin);
585
+ await lifecycle.dispatch(agent, skillEvent!);
586
+
587
+ // Enter and exit plan mode
588
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.PlanModeEnter }));
589
+ await lifecycle.dispatch(agent, makeEvent({ type: EventType.PlanModeExit }));
590
+
591
+ // Create a task
592
+ const taskStdin = JSON.stringify({
593
+ session_id: 'e2e-session',
594
+ transcript_path: '/path/to/transcript.jsonl',
595
+ tool_use_id: 'tu-task-1',
596
+ tool_input: { subject: 'Build UI', description: 'Build the frontend' },
597
+ tool_response: { taskId: '1' },
598
+ });
599
+ const taskEvent = agent.parseHookEvent('post-task-create', taskStdin);
600
+ await lifecycle.dispatch(agent, taskEvent!);
601
+
602
+ // Verify all three are tracked together
603
+ const state = await sessionStore.load('e2e-session');
604
+ expect(state!.skillsUsed).toHaveLength(1);
605
+ expect(state!.skillsUsed![0].name).toBe('frontend-design');
606
+ expect(state!.planModeEntries).toBe(1);
607
+ expect(Object.keys(state!.tasks!)).toHaveLength(1);
608
+ });
609
+ });
610
+ });