@alan512/experienceengine 0.1.2 → 0.2.0

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 (642) hide show
  1. package/.claude-plugin/marketplace.json +0 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.env.example +0 -0
  4. package/.mcp.json +4 -8
  5. package/LICENSE +21 -0
  6. package/README.md +288 -95
  7. package/README.zh-CN.md +316 -65
  8. package/dist/adapters/claude-code/event-store.d.ts +0 -0
  9. package/dist/adapters/claude-code/event-store.js +0 -0
  10. package/dist/adapters/claude-code/event-store.js.map +0 -0
  11. package/dist/adapters/claude-code/hook-normalizer.d.ts +0 -0
  12. package/dist/adapters/claude-code/hook-normalizer.js +0 -0
  13. package/dist/adapters/claude-code/hook-normalizer.js.map +0 -0
  14. package/dist/adapters/claude-code/runtime-projection.d.ts +0 -0
  15. package/dist/adapters/claude-code/runtime-projection.js +0 -0
  16. package/dist/adapters/claude-code/runtime-projection.js.map +0 -0
  17. package/dist/adapters/claude-code/session-store.d.ts +1 -0
  18. package/dist/adapters/claude-code/session-store.js +24 -1
  19. package/dist/adapters/claude-code/session-store.js.map +1 -1
  20. package/dist/adapters/codex/action-registry.d.ts +84 -0
  21. package/dist/adapters/codex/action-registry.js +277 -0
  22. package/dist/adapters/codex/action-registry.js.map +1 -0
  23. package/dist/adapters/codex/broker-tools.d.ts +114 -0
  24. package/dist/adapters/codex/broker-tools.js +130 -0
  25. package/dist/adapters/codex/broker-tools.js.map +1 -0
  26. package/dist/adapters/codex/instruction-template.d.ts +3 -0
  27. package/dist/adapters/codex/instruction-template.js +12 -0
  28. package/dist/adapters/codex/instruction-template.js.map +1 -0
  29. package/dist/adapters/codex/mcp-server.d.ts +59 -41
  30. package/dist/adapters/codex/mcp-server.js +177 -728
  31. package/dist/adapters/codex/mcp-server.js.map +1 -1
  32. package/dist/analyzer/candidate-signals.d.ts +3 -1
  33. package/dist/analyzer/candidate-signals.js +159 -0
  34. package/dist/analyzer/candidate-signals.js.map +1 -1
  35. package/dist/analyzer/experience-analyzer.d.ts +0 -0
  36. package/dist/analyzer/experience-analyzer.js +0 -0
  37. package/dist/analyzer/experience-analyzer.js.map +0 -0
  38. package/dist/analyzer/extraction-evidence.d.ts +0 -0
  39. package/dist/analyzer/extraction-evidence.js +0 -0
  40. package/dist/analyzer/extraction-evidence.js.map +0 -0
  41. package/dist/analyzer/llm-learning-gate.d.ts +12 -1
  42. package/dist/analyzer/llm-learning-gate.js +672 -16
  43. package/dist/analyzer/llm-learning-gate.js.map +1 -1
  44. package/dist/analyzer/node-deduper.d.ts +0 -0
  45. package/dist/analyzer/node-deduper.js +0 -0
  46. package/dist/analyzer/node-deduper.js.map +0 -0
  47. package/dist/analyzer/node-normalizer.d.ts +0 -0
  48. package/dist/analyzer/node-normalizer.js +0 -0
  49. package/dist/analyzer/node-normalizer.js.map +0 -0
  50. package/dist/analyzer/storage-gate.d.ts +0 -0
  51. package/dist/analyzer/storage-gate.js +0 -0
  52. package/dist/analyzer/storage-gate.js.map +0 -0
  53. package/dist/analyzer/strategy-extractor.d.ts +0 -0
  54. package/dist/analyzer/strategy-extractor.js +0 -0
  55. package/dist/analyzer/strategy-extractor.js.map +0 -0
  56. package/dist/analyzer/warning-extractor.d.ts +0 -0
  57. package/dist/analyzer/warning-extractor.js +0 -0
  58. package/dist/analyzer/warning-extractor.js.map +0 -0
  59. package/dist/cli/commands/backup.d.ts +0 -0
  60. package/dist/cli/commands/backup.js +0 -0
  61. package/dist/cli/commands/backup.js.map +0 -0
  62. package/dist/cli/commands/claude-hook.d.ts +0 -0
  63. package/dist/cli/commands/claude-hook.js +23 -7
  64. package/dist/cli/commands/claude-hook.js.map +1 -1
  65. package/dist/cli/commands/codex-mcp-server.d.ts +0 -0
  66. package/dist/cli/commands/codex-mcp-server.js +0 -0
  67. package/dist/cli/commands/codex-mcp-server.js.map +0 -0
  68. package/dist/cli/commands/codex.d.ts +60 -0
  69. package/dist/cli/commands/codex.js +188 -0
  70. package/dist/cli/commands/codex.js.map +1 -0
  71. package/dist/cli/commands/config.d.ts +0 -0
  72. package/dist/cli/commands/config.js +88 -2
  73. package/dist/cli/commands/config.js.map +1 -1
  74. package/dist/cli/commands/cool.d.ts +0 -0
  75. package/dist/cli/commands/cool.js +0 -0
  76. package/dist/cli/commands/cool.js.map +0 -0
  77. package/dist/cli/commands/disable.d.ts +0 -0
  78. package/dist/cli/commands/disable.js +0 -0
  79. package/dist/cli/commands/disable.js.map +0 -0
  80. package/dist/cli/commands/doctor.d.ts +4 -28
  81. package/dist/cli/commands/doctor.js +156 -68
  82. package/dist/cli/commands/doctor.js.map +1 -1
  83. package/dist/cli/commands/enable.d.ts +0 -0
  84. package/dist/cli/commands/enable.js +0 -0
  85. package/dist/cli/commands/enable.js.map +0 -0
  86. package/dist/cli/commands/evaluate.d.ts +9 -3
  87. package/dist/cli/commands/evaluate.js +31 -5
  88. package/dist/cli/commands/evaluate.js.map +1 -1
  89. package/dist/cli/commands/export.d.ts +0 -0
  90. package/dist/cli/commands/export.js +0 -0
  91. package/dist/cli/commands/export.js.map +0 -0
  92. package/dist/cli/commands/feedback.d.ts +0 -0
  93. package/dist/cli/commands/feedback.js +4 -0
  94. package/dist/cli/commands/feedback.js.map +1 -1
  95. package/dist/cli/commands/import.d.ts +0 -0
  96. package/dist/cli/commands/import.js +0 -0
  97. package/dist/cli/commands/import.js.map +0 -0
  98. package/dist/cli/commands/init.d.ts +28 -0
  99. package/dist/cli/commands/init.js +432 -0
  100. package/dist/cli/commands/init.js.map +1 -0
  101. package/dist/cli/commands/inspect.d.ts +0 -0
  102. package/dist/cli/commands/inspect.js +271 -37
  103. package/dist/cli/commands/inspect.js.map +1 -1
  104. package/dist/cli/commands/install.d.ts +0 -0
  105. package/dist/cli/commands/install.js +9 -0
  106. package/dist/cli/commands/install.js.map +1 -1
  107. package/dist/cli/commands/maintenance.d.ts +0 -0
  108. package/dist/cli/commands/maintenance.js +1 -1
  109. package/dist/cli/commands/maintenance.js.map +1 -1
  110. package/dist/cli/commands/mcp-server.d.ts +0 -0
  111. package/dist/cli/commands/mcp-server.js +4 -0
  112. package/dist/cli/commands/mcp-server.js.map +1 -1
  113. package/dist/cli/commands/models.d.ts +0 -0
  114. package/dist/cli/commands/models.js +0 -0
  115. package/dist/cli/commands/models.js.map +0 -0
  116. package/dist/cli/commands/repair.d.ts +0 -0
  117. package/dist/cli/commands/repair.js +3 -3
  118. package/dist/cli/commands/repair.js.map +1 -1
  119. package/dist/cli/commands/retire.d.ts +0 -0
  120. package/dist/cli/commands/retire.js +0 -0
  121. package/dist/cli/commands/retire.js.map +0 -0
  122. package/dist/cli/commands/rollback.d.ts +0 -0
  123. package/dist/cli/commands/rollback.js +0 -0
  124. package/dist/cli/commands/rollback.js.map +0 -0
  125. package/dist/cli/commands/stats.d.ts +0 -0
  126. package/dist/cli/commands/stats.js +0 -0
  127. package/dist/cli/commands/stats.js.map +0 -0
  128. package/dist/cli/commands/status.d.ts +0 -0
  129. package/dist/cli/commands/status.js +89 -7
  130. package/dist/cli/commands/status.js.map +1 -1
  131. package/dist/cli/commands/upgrade.d.ts +0 -0
  132. package/dist/cli/commands/upgrade.js +0 -0
  133. package/dist/cli/commands/upgrade.js.map +0 -0
  134. package/dist/cli/dispatch.d.ts +0 -0
  135. package/dist/cli/dispatch.js +36 -9
  136. package/dist/cli/dispatch.js.map +1 -1
  137. package/dist/cli/index.d.ts +0 -0
  138. package/dist/cli/index.js.map +0 -0
  139. package/dist/cli/state-model.d.ts +14 -0
  140. package/dist/cli/state-model.js +23 -0
  141. package/dist/cli/state-model.js.map +1 -0
  142. package/dist/config/config-schema.d.ts +209 -0
  143. package/dist/config/config-schema.js +168 -1
  144. package/dist/config/config-schema.js.map +1 -1
  145. package/dist/config/default-config.d.ts +0 -0
  146. package/dist/config/default-config.js +22 -1
  147. package/dist/config/default-config.js.map +1 -1
  148. package/dist/config/load-config.d.ts +0 -0
  149. package/dist/config/load-config.js +91 -2
  150. package/dist/config/load-config.js.map +1 -1
  151. package/dist/config/path-resolver.d.ts +0 -1
  152. package/dist/config/path-resolver.js +0 -2
  153. package/dist/config/path-resolver.js.map +1 -1
  154. package/dist/config/runtime-env.d.ts +8 -0
  155. package/dist/config/runtime-env.js +14 -0
  156. package/dist/config/runtime-env.js.map +1 -0
  157. package/dist/config/secrets-store.d.ts +15 -0
  158. package/dist/config/secrets-store.js +56 -0
  159. package/dist/config/secrets-store.js.map +1 -0
  160. package/dist/config/settings-store.d.ts +29 -0
  161. package/dist/config/settings-store.js +55 -0
  162. package/dist/config/settings-store.js.map +1 -1
  163. package/dist/controller/candidate-retriever.d.ts +49 -2
  164. package/dist/controller/candidate-retriever.js +258 -125
  165. package/dist/controller/candidate-retriever.js.map +1 -1
  166. package/dist/controller/injection-renderer.d.ts +0 -0
  167. package/dist/controller/injection-renderer.js +52 -1
  168. package/dist/controller/injection-renderer.js.map +1 -1
  169. package/dist/controller/injection-scorecard.d.ts +2 -2
  170. package/dist/controller/injection-scorecard.js +47 -1
  171. package/dist/controller/injection-scorecard.js.map +1 -1
  172. package/dist/controller/inline-notice.d.ts +0 -0
  173. package/dist/controller/inline-notice.js +0 -0
  174. package/dist/controller/inline-notice.js.map +0 -0
  175. package/dist/controller/intervention-controller.d.ts +3 -2
  176. package/dist/controller/intervention-controller.js +339 -17
  177. package/dist/controller/intervention-controller.js.map +1 -1
  178. package/dist/controller/lexical-retriever.d.ts +14 -0
  179. package/dist/controller/lexical-retriever.js +117 -0
  180. package/dist/controller/lexical-retriever.js.map +1 -0
  181. package/dist/controller/model-reranker.d.ts +20 -0
  182. package/dist/controller/model-reranker.js +187 -0
  183. package/dist/controller/model-reranker.js.map +1 -0
  184. package/dist/controller/node-ranker.d.ts +0 -0
  185. package/dist/controller/node-ranker.js +1 -0
  186. package/dist/controller/node-ranker.js.map +1 -1
  187. package/dist/controller/policy-enricher.d.ts +10 -0
  188. package/dist/controller/policy-enricher.js +186 -0
  189. package/dist/controller/policy-enricher.js.map +1 -0
  190. package/dist/controller/query-rewrite.d.ts +8 -0
  191. package/dist/controller/query-rewrite.js +69 -0
  192. package/dist/controller/query-rewrite.js.map +1 -0
  193. package/dist/controller/retrieval-context.d.ts +3 -0
  194. package/dist/controller/retrieval-context.js +37 -0
  195. package/dist/controller/retrieval-context.js.map +1 -0
  196. package/dist/controller/second-opinion-gate.d.ts +41 -0
  197. package/dist/controller/second-opinion-gate.js +225 -0
  198. package/dist/controller/second-opinion-gate.js.map +1 -0
  199. package/dist/controller/trigger-evaluator.d.ts +27 -2
  200. package/dist/controller/trigger-evaluator.js +63 -3
  201. package/dist/controller/trigger-evaluator.js.map +1 -1
  202. package/dist/distillation/errors.d.ts +0 -0
  203. package/dist/distillation/errors.js +0 -0
  204. package/dist/distillation/errors.js.map +0 -0
  205. package/dist/distillation/experience-family.d.ts +4 -0
  206. package/dist/distillation/experience-family.js +14 -0
  207. package/dist/distillation/experience-family.js.map +1 -0
  208. package/dist/distillation/host-llm.d.ts +1 -0
  209. package/dist/distillation/host-llm.js +5 -1
  210. package/dist/distillation/host-llm.js.map +1 -1
  211. package/dist/distillation/llm-distiller.d.ts +0 -0
  212. package/dist/distillation/llm-distiller.js +4 -0
  213. package/dist/distillation/llm-distiller.js.map +1 -1
  214. package/dist/distillation/merge-decider.d.ts +0 -0
  215. package/dist/distillation/merge-decider.js +4 -0
  216. package/dist/distillation/merge-decider.js.map +1 -1
  217. package/dist/distillation/model-catalog.d.ts +0 -0
  218. package/dist/distillation/model-catalog.js +0 -0
  219. package/dist/distillation/model-catalog.js.map +0 -0
  220. package/dist/distillation/prompt-contract.d.ts +1 -1
  221. package/dist/distillation/prompt-contract.js +6 -1
  222. package/dist/distillation/prompt-contract.js.map +1 -1
  223. package/dist/distillation/providers/anthropic.d.ts +0 -0
  224. package/dist/distillation/providers/anthropic.js +0 -0
  225. package/dist/distillation/providers/anthropic.js.map +0 -0
  226. package/dist/distillation/providers/azure-openai.d.ts +0 -0
  227. package/dist/distillation/providers/azure-openai.js +0 -0
  228. package/dist/distillation/providers/azure-openai.js.map +0 -0
  229. package/dist/distillation/providers/baidu-qianfan.d.ts +0 -0
  230. package/dist/distillation/providers/baidu-qianfan.js +0 -0
  231. package/dist/distillation/providers/baidu-qianfan.js.map +0 -0
  232. package/dist/distillation/providers/bedrock.d.ts +0 -0
  233. package/dist/distillation/providers/bedrock.js +0 -0
  234. package/dist/distillation/providers/bedrock.js.map +0 -0
  235. package/dist/distillation/providers/dashscope.d.ts +0 -0
  236. package/dist/distillation/providers/dashscope.js +0 -0
  237. package/dist/distillation/providers/dashscope.js.map +0 -0
  238. package/dist/distillation/providers/deepseek.d.ts +0 -0
  239. package/dist/distillation/providers/deepseek.js +0 -0
  240. package/dist/distillation/providers/deepseek.js.map +0 -0
  241. package/dist/distillation/providers/gemini.d.ts +0 -0
  242. package/dist/distillation/providers/gemini.js +5 -1
  243. package/dist/distillation/providers/gemini.js.map +1 -1
  244. package/dist/distillation/providers/google-adc.d.ts +0 -0
  245. package/dist/distillation/providers/google-adc.js +0 -0
  246. package/dist/distillation/providers/google-adc.js.map +0 -0
  247. package/dist/distillation/providers/minimax.d.ts +0 -0
  248. package/dist/distillation/providers/minimax.js +0 -0
  249. package/dist/distillation/providers/minimax.js.map +0 -0
  250. package/dist/distillation/providers/moonshot.d.ts +0 -0
  251. package/dist/distillation/providers/moonshot.js +0 -0
  252. package/dist/distillation/providers/moonshot.js.map +0 -0
  253. package/dist/distillation/providers/openai-compatible-factory.d.ts +0 -0
  254. package/dist/distillation/providers/openai-compatible-factory.js +0 -0
  255. package/dist/distillation/providers/openai-compatible-factory.js.map +0 -0
  256. package/dist/distillation/providers/openai-compatible.d.ts +0 -0
  257. package/dist/distillation/providers/openai-compatible.js +0 -0
  258. package/dist/distillation/providers/openai-compatible.js.map +0 -0
  259. package/dist/distillation/providers/openai.d.ts +0 -0
  260. package/dist/distillation/providers/openai.js +0 -0
  261. package/dist/distillation/providers/openai.js.map +0 -0
  262. package/dist/distillation/providers/openrouter.d.ts +0 -0
  263. package/dist/distillation/providers/openrouter.js +0 -0
  264. package/dist/distillation/providers/openrouter.js.map +0 -0
  265. package/dist/distillation/providers/registry.d.ts +0 -0
  266. package/dist/distillation/providers/registry.js +0 -0
  267. package/dist/distillation/providers/registry.js.map +0 -0
  268. package/dist/distillation/providers/siliconflow.d.ts +0 -0
  269. package/dist/distillation/providers/siliconflow.js +0 -0
  270. package/dist/distillation/providers/siliconflow.js.map +0 -0
  271. package/dist/distillation/providers/tencent-hunyuan.d.ts +0 -0
  272. package/dist/distillation/providers/tencent-hunyuan.js +0 -0
  273. package/dist/distillation/providers/tencent-hunyuan.js.map +0 -0
  274. package/dist/distillation/providers/types.d.ts +0 -0
  275. package/dist/distillation/providers/types.js +0 -0
  276. package/dist/distillation/providers/types.js.map +0 -0
  277. package/dist/distillation/providers/volcengine-ark.d.ts +0 -0
  278. package/dist/distillation/providers/volcengine-ark.js +0 -0
  279. package/dist/distillation/providers/volcengine-ark.js.map +0 -0
  280. package/dist/distillation/providers/zhipu.d.ts +0 -0
  281. package/dist/distillation/providers/zhipu.js +0 -0
  282. package/dist/distillation/providers/zhipu.js.map +0 -0
  283. package/dist/distillation/queue-worker.d.ts +0 -0
  284. package/dist/distillation/queue-worker.js +78 -9
  285. package/dist/distillation/queue-worker.js.map +1 -1
  286. package/dist/distillation/types.d.ts +0 -0
  287. package/dist/distillation/types.js +0 -0
  288. package/dist/distillation/types.js.map +0 -0
  289. package/dist/evaluation/benchmark-report.d.ts +0 -0
  290. package/dist/evaluation/benchmark-report.js +0 -0
  291. package/dist/evaluation/benchmark-report.js.map +0 -0
  292. package/dist/evaluation/benchmark-summary.d.ts +0 -0
  293. package/dist/evaluation/benchmark-summary.js +0 -0
  294. package/dist/evaluation/benchmark-summary.js.map +0 -0
  295. package/dist/evaluation/codex-lifecycle-validation.d.ts +60 -0
  296. package/dist/evaluation/codex-lifecycle-validation.js +233 -0
  297. package/dist/evaluation/codex-lifecycle-validation.js.map +1 -0
  298. package/dist/evaluation/hybrid-phase1-rollout-summary.d.ts +63 -0
  299. package/dist/evaluation/hybrid-phase1-rollout-summary.js +108 -0
  300. package/dist/evaluation/hybrid-phase1-rollout-summary.js.map +1 -0
  301. package/dist/evaluation/hybrid-phase3-gate-metrics.d.ts +26 -0
  302. package/dist/evaluation/hybrid-phase3-gate-metrics.js +23 -0
  303. package/dist/evaluation/hybrid-phase3-gate-metrics.js.map +1 -0
  304. package/dist/evaluation/openclaw-baseline.d.ts +8 -0
  305. package/dist/evaluation/openclaw-baseline.js +27 -0
  306. package/dist/evaluation/openclaw-baseline.js.map +1 -1
  307. package/dist/evaluation/openclaw-scenarios.d.ts +0 -0
  308. package/dist/evaluation/openclaw-scenarios.js +0 -0
  309. package/dist/evaluation/openclaw-scenarios.js.map +0 -0
  310. package/dist/experience-management/governance-observability.d.ts +13 -0
  311. package/dist/experience-management/governance-observability.js +37 -0
  312. package/dist/experience-management/governance-observability.js.map +1 -0
  313. package/dist/experience-management/node-lifecycle-governance.d.ts +8 -0
  314. package/dist/experience-management/node-lifecycle-governance.js +80 -0
  315. package/dist/experience-management/node-lifecycle-governance.js.map +1 -0
  316. package/dist/experience-management/task-management-signals.d.ts +29 -0
  317. package/dist/experience-management/task-management-signals.js +148 -0
  318. package/dist/experience-management/task-management-signals.js.map +1 -0
  319. package/dist/feedback/automatic-attribution.d.ts +0 -0
  320. package/dist/feedback/automatic-attribution.js +0 -0
  321. package/dist/feedback/automatic-attribution.js.map +0 -0
  322. package/dist/feedback/feedback-manager.d.ts +4 -1
  323. package/dist/feedback/feedback-manager.js +11 -22
  324. package/dist/feedback/feedback-manager.js.map +1 -1
  325. package/dist/feedback/harm-detector.d.ts +0 -0
  326. package/dist/feedback/harm-detector.js +0 -0
  327. package/dist/feedback/harm-detector.js.map +0 -0
  328. package/dist/feedback/state-transition.d.ts +6 -1
  329. package/dist/feedback/state-transition.js +14 -2
  330. package/dist/feedback/state-transition.js.map +1 -1
  331. package/dist/feedback/stats-updater.d.ts +0 -0
  332. package/dist/feedback/stats-updater.js +0 -0
  333. package/dist/feedback/stats-updater.js.map +0 -0
  334. package/dist/hybrid/capsule-builder.d.ts +23 -0
  335. package/dist/hybrid/capsule-builder.js +114 -0
  336. package/dist/hybrid/capsule-builder.js.map +1 -0
  337. package/dist/hybrid/explain-provider-client.d.ts +19 -0
  338. package/dist/hybrid/explain-provider-client.js +34 -0
  339. package/dist/hybrid/explain-provider-client.js.map +1 -0
  340. package/dist/hybrid/postmortem-provider-client.d.ts +19 -0
  341. package/dist/hybrid/postmortem-provider-client.js +34 -0
  342. package/dist/hybrid/postmortem-provider-client.js.map +1 -0
  343. package/dist/hybrid/rollout.d.ts +9 -0
  344. package/dist/hybrid/rollout.js +49 -0
  345. package/dist/hybrid/rollout.js.map +1 -0
  346. package/dist/hybrid/router.d.ts +4 -0
  347. package/dist/hybrid/router.js +62 -0
  348. package/dist/hybrid/router.js.map +1 -0
  349. package/dist/hybrid/types.d.ts +140 -0
  350. package/dist/{compiler → hybrid}/types.js +0 -0
  351. package/dist/{packs → hybrid}/types.js.map +1 -1
  352. package/dist/hybrid/validators.d.ts +5 -0
  353. package/dist/hybrid/validators.js +94 -0
  354. package/dist/hybrid/validators.js.map +1 -0
  355. package/dist/hybrid/worker-client.d.ts +61 -0
  356. package/dist/hybrid/worker-client.js +196 -0
  357. package/dist/hybrid/worker-client.js.map +1 -0
  358. package/dist/hybrid/workers/explain-decision-llm.d.ts +8 -0
  359. package/dist/hybrid/workers/explain-decision-llm.js +152 -0
  360. package/dist/hybrid/workers/explain-decision-llm.js.map +1 -0
  361. package/dist/hybrid/workers/explain-decision.d.ts +2 -0
  362. package/dist/hybrid/workers/explain-decision.js +40 -0
  363. package/dist/hybrid/workers/explain-decision.js.map +1 -0
  364. package/dist/hybrid/workers/postmortem-review-llm.d.ts +8 -0
  365. package/dist/hybrid/workers/postmortem-review-llm.js +398 -0
  366. package/dist/hybrid/workers/postmortem-review-llm.js.map +1 -0
  367. package/dist/hybrid/workers/postmortem-review.d.ts +2 -0
  368. package/dist/hybrid/workers/postmortem-review.js +66 -0
  369. package/dist/hybrid/workers/postmortem-review.js.map +1 -0
  370. package/dist/index.d.ts +0 -0
  371. package/dist/index.js +0 -0
  372. package/dist/index.js.map +0 -0
  373. package/dist/input/context-summary-adapter.d.ts +0 -0
  374. package/dist/input/context-summary-adapter.js +0 -0
  375. package/dist/input/context-summary-adapter.js.map +0 -0
  376. package/dist/input/input-adapter.d.ts +0 -0
  377. package/dist/input/input-adapter.js +2 -1
  378. package/dist/input/input-adapter.js.map +1 -1
  379. package/dist/input/outcome-resolver.d.ts +0 -0
  380. package/dist/input/outcome-resolver.js +5 -5
  381. package/dist/input/outcome-resolver.js.map +1 -1
  382. package/dist/input/scope-resolver.d.ts +0 -0
  383. package/dist/input/scope-resolver.js +0 -0
  384. package/dist/input/scope-resolver.js.map +0 -0
  385. package/dist/input/tasktype-resolver.d.ts +0 -0
  386. package/dist/input/tasktype-resolver.js +2 -0
  387. package/dist/input/tasktype-resolver.js.map +1 -1
  388. package/dist/input/tool-event-significance.d.ts +5 -0
  389. package/dist/input/tool-event-significance.js +7 -0
  390. package/dist/input/tool-event-significance.js.map +1 -0
  391. package/dist/install/claude-cli.d.ts +0 -0
  392. package/dist/install/claude-cli.js +0 -0
  393. package/dist/install/claude-cli.js.map +0 -0
  394. package/dist/install/claude-code-doctor.d.ts +8 -2
  395. package/dist/install/claude-code-doctor.js +54 -9
  396. package/dist/install/claude-code-doctor.js.map +1 -1
  397. package/dist/install/claude-code-installer.d.ts +0 -0
  398. package/dist/install/claude-code-installer.js +50 -1
  399. package/dist/install/claude-code-installer.js.map +1 -1
  400. package/dist/install/claude-marketplace-state.d.ts +14 -0
  401. package/dist/install/claude-marketplace-state.js +47 -0
  402. package/dist/install/claude-marketplace-state.js.map +1 -0
  403. package/dist/install/claude-runtime-target.d.ts +0 -0
  404. package/dist/install/claude-runtime-target.js +0 -0
  405. package/dist/install/claude-runtime-target.js.map +0 -0
  406. package/dist/install/codex-cli.d.ts +15 -0
  407. package/dist/install/codex-cli.js +55 -3
  408. package/dist/install/codex-cli.js.map +1 -1
  409. package/dist/install/codex-installer.d.ts +18 -0
  410. package/dist/install/codex-installer.js +91 -1
  411. package/dist/install/codex-installer.js.map +1 -1
  412. package/dist/install/codex-runtime-target.d.ts +0 -0
  413. package/dist/install/codex-runtime-target.js +0 -0
  414. package/dist/install/codex-runtime-target.js.map +0 -0
  415. package/dist/install/host-detection.d.ts +0 -0
  416. package/dist/install/host-detection.js +0 -0
  417. package/dist/install/host-detection.js.map +0 -0
  418. package/dist/install/openclaw-cli.d.ts +11 -0
  419. package/dist/install/openclaw-cli.js +0 -0
  420. package/dist/install/openclaw-cli.js.map +1 -1
  421. package/dist/install/openclaw-installer.d.ts +12 -0
  422. package/dist/install/openclaw-installer.js +198 -31
  423. package/dist/install/openclaw-installer.js.map +1 -1
  424. package/dist/install/public-install.d.ts +14 -4
  425. package/dist/install/public-install.js +20 -7
  426. package/dist/install/public-install.js.map +1 -1
  427. package/dist/install/registry-health.d.ts +0 -0
  428. package/dist/install/registry-health.js +0 -0
  429. package/dist/install/registry-health.js.map +0 -0
  430. package/dist/interaction/operational-actions-service.d.ts +0 -0
  431. package/dist/interaction/operational-actions-service.js +0 -0
  432. package/dist/interaction/operational-actions-service.js.map +0 -0
  433. package/dist/interaction/operational-service.d.ts +0 -0
  434. package/dist/interaction/operational-service.js +0 -0
  435. package/dist/interaction/operational-service.js.map +0 -0
  436. package/dist/interaction/repo-summary.d.ts +3 -17
  437. package/dist/interaction/repo-summary.js +10 -27
  438. package/dist/interaction/repo-summary.js.map +1 -1
  439. package/dist/interaction/service.d.ts +59 -95
  440. package/dist/interaction/service.js +505 -266
  441. package/dist/interaction/service.js.map +1 -1
  442. package/dist/interaction/state-artifact-service.d.ts +0 -0
  443. package/dist/interaction/state-artifact-service.js +0 -0
  444. package/dist/interaction/state-artifact-service.js.map +0 -0
  445. package/dist/maintenance/claude-validate-print.d.ts +0 -0
  446. package/dist/maintenance/claude-validate-print.js +0 -0
  447. package/dist/maintenance/claude-validate-print.js.map +0 -0
  448. package/dist/maintenance/embedding-smoke.d.ts +0 -0
  449. package/dist/maintenance/embedding-smoke.js +0 -0
  450. package/dist/maintenance/embedding-smoke.js.map +0 -0
  451. package/dist/maintenance/redistill-rule-nodes.d.ts +0 -0
  452. package/dist/maintenance/redistill-rule-nodes.js +0 -0
  453. package/dist/maintenance/redistill-rule-nodes.js.map +0 -0
  454. package/dist/maintenance/scope-merge.d.ts +0 -1
  455. package/dist/maintenance/scope-merge.js +0 -20
  456. package/dist/maintenance/scope-merge.js.map +1 -1
  457. package/dist/maintenance/warning-variant-cleanup.d.ts +0 -0
  458. package/dist/maintenance/warning-variant-cleanup.js +0 -0
  459. package/dist/maintenance/warning-variant-cleanup.js.map +0 -0
  460. package/dist/plugin/fixture-sanitizer.d.ts +0 -0
  461. package/dist/plugin/fixture-sanitizer.js +0 -0
  462. package/dist/plugin/fixture-sanitizer.js.map +0 -0
  463. package/dist/plugin/hooks/before-prompt-build.d.ts +1 -0
  464. package/dist/plugin/hooks/before-prompt-build.js +4 -1
  465. package/dist/plugin/hooks/before-prompt-build.js.map +1 -1
  466. package/dist/plugin/hooks/message-sent.d.ts +0 -0
  467. package/dist/plugin/hooks/message-sent.js +0 -0
  468. package/dist/plugin/hooks/message-sent.js.map +0 -0
  469. package/dist/plugin/hooks/tool-result-persist.d.ts +0 -0
  470. package/dist/plugin/hooks/tool-result-persist.js +0 -0
  471. package/dist/plugin/hooks/tool-result-persist.js.map +0 -0
  472. package/dist/plugin/openclaw-install-state.d.ts +39 -0
  473. package/dist/plugin/openclaw-install-state.js +24 -0
  474. package/dist/plugin/openclaw-install-state.js.map +1 -0
  475. package/dist/plugin/openclaw-plugin.d.ts +148 -0
  476. package/dist/plugin/openclaw-plugin.js +98 -7
  477. package/dist/plugin/openclaw-plugin.js.map +1 -1
  478. package/dist/plugin/openclaw-routine-interaction.d.ts +7 -0
  479. package/dist/plugin/openclaw-routine-interaction.js +301 -0
  480. package/dist/plugin/openclaw-routine-interaction.js.map +1 -0
  481. package/dist/plugin/openclaw-runtime-defaults.d.ts +16 -0
  482. package/dist/plugin/openclaw-runtime-defaults.js +16 -0
  483. package/dist/plugin/openclaw-runtime-defaults.js.map +1 -0
  484. package/dist/plugin/runtime-capture.d.ts +0 -0
  485. package/dist/plugin/runtime-capture.js +0 -0
  486. package/dist/plugin/runtime-capture.js.map +0 -0
  487. package/dist/plugin/runtime-helpers.d.ts +0 -0
  488. package/dist/plugin/runtime-helpers.js +0 -0
  489. package/dist/plugin/runtime-helpers.js.map +0 -0
  490. package/dist/runtime/service.d.ts +33 -6
  491. package/dist/runtime/service.js +427 -50
  492. package/dist/runtime/service.js.map +1 -1
  493. package/dist/store/logs/jsonl-logger.d.ts +0 -0
  494. package/dist/store/logs/jsonl-logger.js +0 -0
  495. package/dist/store/logs/jsonl-logger.js.map +0 -0
  496. package/dist/store/sqlite/db.d.ts +0 -0
  497. package/dist/store/sqlite/db.js +37 -0
  498. package/dist/store/sqlite/db.js.map +1 -1
  499. package/dist/store/sqlite/migrations.d.ts +0 -0
  500. package/dist/store/sqlite/migrations.js +0 -0
  501. package/dist/store/sqlite/migrations.js.map +0 -0
  502. package/dist/store/sqlite/repositories/candidate-repo.d.ts +0 -0
  503. package/dist/store/sqlite/repositories/candidate-repo.js +8 -2
  504. package/dist/store/sqlite/repositories/candidate-repo.js.map +1 -1
  505. package/dist/store/sqlite/repositories/distillation-job-repo.d.ts +0 -0
  506. package/dist/store/sqlite/repositories/distillation-job-repo.js +0 -0
  507. package/dist/store/sqlite/repositories/distillation-job-repo.js.map +0 -0
  508. package/dist/store/sqlite/repositories/hybrid-invocation-trace-repo.d.ts +11 -0
  509. package/dist/store/sqlite/repositories/hybrid-invocation-trace-repo.js +76 -0
  510. package/dist/store/sqlite/repositories/hybrid-invocation-trace-repo.js.map +1 -0
  511. package/dist/store/sqlite/repositories/hybrid-review-artifact-repo.d.ts +11 -0
  512. package/dist/store/sqlite/repositories/hybrid-review-artifact-repo.js +73 -0
  513. package/dist/store/sqlite/repositories/hybrid-review-artifact-repo.js.map +1 -0
  514. package/dist/store/sqlite/repositories/injection-repo.d.ts +1 -0
  515. package/dist/store/sqlite/repositories/injection-repo.js +11 -0
  516. package/dist/store/sqlite/repositories/injection-repo.js.map +1 -1
  517. package/dist/store/sqlite/repositories/input-record-repo.d.ts +3 -0
  518. package/dist/store/sqlite/repositories/input-record-repo.js +35 -0
  519. package/dist/store/sqlite/repositories/input-record-repo.js.map +1 -1
  520. package/dist/store/sqlite/repositories/node-repo.d.ts +3 -0
  521. package/dist/store/sqlite/repositories/node-repo.js +62 -8
  522. package/dist/store/sqlite/repositories/node-repo.js.map +1 -1
  523. package/dist/store/sqlite/repositories/outcome-record-repo.d.ts +0 -0
  524. package/dist/store/sqlite/repositories/outcome-record-repo.js +0 -0
  525. package/dist/store/sqlite/repositories/outcome-record-repo.js.map +0 -0
  526. package/dist/store/sqlite/repositories/review-event-repo.d.ts +0 -0
  527. package/dist/store/sqlite/repositories/review-event-repo.js +0 -0
  528. package/dist/store/sqlite/repositories/review-event-repo.js.map +0 -0
  529. package/dist/store/sqlite/repositories/scope-repo.d.ts +0 -0
  530. package/dist/store/sqlite/repositories/scope-repo.js +0 -0
  531. package/dist/store/sqlite/repositories/scope-repo.js.map +0 -0
  532. package/dist/store/sqlite/repositories/stats-repo.d.ts +0 -0
  533. package/dist/store/sqlite/repositories/stats-repo.js +0 -0
  534. package/dist/store/sqlite/repositories/stats-repo.js.map +0 -0
  535. package/dist/store/sqlite/repositories/task-run-repo.d.ts +2 -0
  536. package/dist/store/sqlite/repositories/task-run-repo.js +18 -2
  537. package/dist/store/sqlite/repositories/task-run-repo.js.map +1 -1
  538. package/dist/store/sqlite/schema.sql +49 -49
  539. package/dist/store/vector/api-embedding-provider.d.ts +2 -0
  540. package/dist/store/vector/api-embedding-provider.js +23 -19
  541. package/dist/store/vector/api-embedding-provider.js.map +1 -1
  542. package/dist/store/vector/embeddings.d.ts +1 -1
  543. package/dist/store/vector/embeddings.js +26 -5
  544. package/dist/store/vector/embeddings.js.map +1 -1
  545. package/dist/store/vector/lancedb.d.ts +0 -0
  546. package/dist/store/vector/lancedb.js +0 -0
  547. package/dist/store/vector/lancedb.js.map +0 -0
  548. package/dist/store/vector/local-provider.d.ts +0 -0
  549. package/dist/store/vector/local-provider.js +0 -0
  550. package/dist/store/vector/local-provider.js.map +0 -0
  551. package/dist/store/vector/node-index.d.ts +0 -0
  552. package/dist/store/vector/node-index.js +0 -0
  553. package/dist/store/vector/node-index.js.map +0 -0
  554. package/dist/store/vector/provider-types.d.ts +0 -0
  555. package/dist/store/vector/provider-types.js +0 -0
  556. package/dist/store/vector/provider-types.js.map +0 -0
  557. package/dist/types/analyzer.d.ts +0 -0
  558. package/dist/types/analyzer.js +0 -0
  559. package/dist/types/analyzer.js.map +0 -0
  560. package/dist/types/domain.d.ts +166 -47
  561. package/dist/types/domain.js +0 -0
  562. package/dist/types/domain.js.map +0 -0
  563. package/dist/types/plugin.d.ts +3 -1
  564. package/dist/types/plugin.js +0 -0
  565. package/dist/types/plugin.js.map +0 -0
  566. package/dist/types/storage.d.ts +0 -0
  567. package/dist/types/storage.js +0 -0
  568. package/dist/types/storage.js.map +0 -0
  569. package/dist/utils/clock.d.ts +0 -0
  570. package/dist/utils/clock.js +0 -0
  571. package/dist/utils/clock.js.map +0 -0
  572. package/dist/utils/errors.d.ts +0 -0
  573. package/dist/utils/errors.js +0 -0
  574. package/dist/utils/errors.js.map +0 -0
  575. package/dist/utils/hashing.d.ts +0 -0
  576. package/dist/utils/hashing.js +0 -0
  577. package/dist/utils/hashing.js.map +0 -0
  578. package/dist/utils/ids.d.ts +0 -0
  579. package/dist/utils/ids.js +0 -0
  580. package/dist/utils/ids.js.map +0 -0
  581. package/dist/utils/text.d.ts +0 -0
  582. package/dist/utils/text.js +0 -0
  583. package/dist/utils/text.js.map +0 -0
  584. package/dist/version/package-version.d.ts +0 -0
  585. package/dist/version/package-version.js +0 -0
  586. package/dist/version/package-version.js.map +0 -0
  587. package/dist/version/remote-release.d.ts +0 -0
  588. package/dist/version/remote-release.js +0 -0
  589. package/dist/version/remote-release.js.map +0 -0
  590. package/docs/releases/v0.1.0.md +0 -0
  591. package/docs/releases/v0.1.1.md +0 -0
  592. package/docs/releases/v0.1.2.md +3 -3
  593. package/docs/releases/v0.1.3.md +95 -0
  594. package/docs/releases/v0.2.0.md +85 -0
  595. package/docs/user-guide.md +263 -133
  596. package/hooks/hooks.json +0 -0
  597. package/openclaw.plugin.json +81 -1
  598. package/package.json +25 -16
  599. package/plugins/claude-code-experienceengine/.claude-plugin/plugin.json +1 -1
  600. package/plugins/claude-code-experienceengine/.mcp.json +4 -3
  601. package/plugins/claude-code-experienceengine/hooks/hooks.json +0 -0
  602. package/plugins/claude-code-experienceengine/scripts/claude-hook.sh +30 -1
  603. package/plugins/claude-code-experienceengine/scripts/install-deps.sh +41 -6
  604. package/scripts/claude-plugin/claude-hook.sh +0 -0
  605. package/scripts/claude-plugin/install-deps.sh +0 -0
  606. package/dist/cli/commands/pack.d.ts +0 -1
  607. package/dist/cli/commands/pack.js +0 -321
  608. package/dist/cli/commands/pack.js.map +0 -1
  609. package/dist/compiler/agents-renderer.d.ts +0 -4
  610. package/dist/compiler/agents-renderer.js +0 -105
  611. package/dist/compiler/agents-renderer.js.map +0 -1
  612. package/dist/compiler/claude-renderer.d.ts +0 -2
  613. package/dist/compiler/claude-renderer.js +0 -40
  614. package/dist/compiler/claude-renderer.js.map +0 -1
  615. package/dist/compiler/codex-renderer.d.ts +0 -2
  616. package/dist/compiler/codex-renderer.js +0 -40
  617. package/dist/compiler/codex-renderer.js.map +0 -1
  618. package/dist/compiler/compiler.d.ts +0 -4
  619. package/dist/compiler/compiler.js +0 -87
  620. package/dist/compiler/compiler.js.map +0 -1
  621. package/dist/compiler/deployer.d.ts +0 -21
  622. package/dist/compiler/deployer.js +0 -64
  623. package/dist/compiler/deployer.js.map +0 -1
  624. package/dist/compiler/github-renderer.d.ts +0 -2
  625. package/dist/compiler/github-renderer.js +0 -63
  626. package/dist/compiler/github-renderer.js.map +0 -1
  627. package/dist/compiler/types.d.ts +0 -45
  628. package/dist/compiler/types.js.map +0 -1
  629. package/dist/interaction/pack-actions-service.d.ts +0 -59
  630. package/dist/interaction/pack-actions-service.js +0 -172
  631. package/dist/interaction/pack-actions-service.js.map +0 -1
  632. package/dist/packs/fs-registry.d.ts +0 -27
  633. package/dist/packs/fs-registry.js +0 -216
  634. package/dist/packs/fs-registry.js.map +0 -1
  635. package/dist/packs/index-sync.d.ts +0 -9
  636. package/dist/packs/index-sync.js +0 -54
  637. package/dist/packs/index-sync.js.map +0 -1
  638. package/dist/packs/types.d.ts +0 -55
  639. package/dist/packs/types.js +0 -2
  640. package/dist/store/sqlite/repositories/pack-repo.d.ts +0 -16
  641. package/dist/store/sqlite/repositories/pack-repo.js +0 -192
  642. package/dist/store/sqlite/repositories/pack-repo.js.map +0 -1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "experienceengine",
3
3
  "name": "ExperienceEngine",
4
- "version": "0.1.0",
4
+ "version": "0.2.0",
5
5
  "description": "Context-aware experience intervention controller for coding and debugging tasks.",
6
6
  "configSchema": {
7
7
  "type": "object",
@@ -28,6 +28,15 @@
28
28
  "type": "string",
29
29
  "description": "Directory used to store raw runtime payload captures."
30
30
  },
31
+ "distillerProvider": {
32
+ "type": "string",
33
+ "enum": ["openai", "anthropic", "gemini", "openrouter", "deepseek", "bedrock", "vertex_gemini", "groq", "openai_compatible"],
34
+ "description": "Distillation provider reused by phase 2 provider-backed explain."
35
+ },
36
+ "distillerModel": {
37
+ "type": "string",
38
+ "description": "Distillation model identifier reused by phase 2 provider-backed explain."
39
+ },
31
40
  "maxHints": {
32
41
  "type": "integer",
33
42
  "minimum": 1,
@@ -39,6 +48,44 @@
39
48
  "minimum": 0,
40
49
  "maximum": 1,
41
50
  "description": "Trigger threshold for intervention gating."
51
+ },
52
+ "hybridEnabled": {
53
+ "type": "boolean",
54
+ "description": "Enable the hybrid routing layer."
55
+ },
56
+ "hybridSyncExplainEnabled": {
57
+ "type": "boolean",
58
+ "description": "Allow bounded sync escalation for explicit explanation requests."
59
+ },
60
+ "hybridAsyncPostmortemEnabled": {
61
+ "type": "boolean",
62
+ "description": "Allow bounded async postmortem review for eligible completed runs."
63
+ },
64
+ "hybridAsyncPostmortemLlmEnabled": {
65
+ "type": "boolean",
66
+ "description": "Enable provider-backed postmortem_review in phase 3."
67
+ },
68
+ "hybridExplainLlmEnabled": {
69
+ "type": "boolean",
70
+ "description": "Enable provider-backed explain_decision in phase 2."
71
+ },
72
+ "hybridExplainProviderMode": {
73
+ "type": "string",
74
+ "enum": ["shared_distiller"],
75
+ "description": "Provider resolution mode for phase 2 explain_decision."
76
+ },
77
+ "hybridExplainModelProfileVersion": {
78
+ "type": "string",
79
+ "description": "Version label for the provider-backed explain_decision model profile."
80
+ },
81
+ "hybridPostmortemProviderMode": {
82
+ "type": "string",
83
+ "enum": ["shared_distiller"],
84
+ "description": "Provider resolution mode for phase 3 postmortem_review."
85
+ },
86
+ "hybridPostmortemModelProfileVersion": {
87
+ "type": "string",
88
+ "description": "Version label for the provider-backed postmortem_review model profile."
42
89
  }
43
90
  }
44
91
  },
@@ -61,11 +108,44 @@
61
108
  "label": "Capture Directory",
62
109
  "placeholder": "./data/runtime-captures"
63
110
  },
111
+ "distillerProvider": {
112
+ "label": "Distiller Provider"
113
+ },
114
+ "distillerModel": {
115
+ "label": "Distiller Model"
116
+ },
64
117
  "maxHints": {
65
118
  "label": "Max Hints"
66
119
  },
67
120
  "triggerThreshold": {
68
121
  "label": "Trigger Threshold"
122
+ },
123
+ "hybridEnabled": {
124
+ "label": "Hybrid Enabled"
125
+ },
126
+ "hybridSyncExplainEnabled": {
127
+ "label": "Hybrid Sync Explain Enabled"
128
+ },
129
+ "hybridAsyncPostmortemEnabled": {
130
+ "label": "Hybrid Async Postmortem Enabled"
131
+ },
132
+ "hybridAsyncPostmortemLlmEnabled": {
133
+ "label": "Hybrid Async Postmortem LLM Enabled"
134
+ },
135
+ "hybridExplainLlmEnabled": {
136
+ "label": "Hybrid Explain LLM Enabled"
137
+ },
138
+ "hybridExplainProviderMode": {
139
+ "label": "Hybrid Explain Provider Mode"
140
+ },
141
+ "hybridExplainModelProfileVersion": {
142
+ "label": "Hybrid Explain Model Profile Version"
143
+ },
144
+ "hybridPostmortemProviderMode": {
145
+ "label": "Hybrid Postmortem Provider Mode"
146
+ },
147
+ "hybridPostmortemModelProfileVersion": {
148
+ "label": "Hybrid Postmortem Model Profile Version"
69
149
  }
70
150
  }
71
151
  }
package/package.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "name": "@alan512/experienceengine",
3
- "version": "0.1.2",
3
+ "version": "0.2.0",
4
4
  "type": "module",
5
- "description": "ExperienceEngine v2 MVP scaffold for OpenClaw companion-layer experience intervention.",
5
+ "description": "Experience governance for coding agents: learn from real task outcomes, inject reusable hints, and retire low-value guidance.",
6
+ "license": "MIT",
6
7
  "repository": {
7
8
  "type": "git",
8
9
  "url": "https://github.com/Alan-512/ExperienceEngine.git"
@@ -10,7 +11,15 @@
10
11
  "openclaw": {
11
12
  "extensions": [
12
13
  "./dist/plugin/openclaw-plugin.js"
13
- ]
14
+ ],
15
+ "compat": {
16
+ "pluginApi": ">=2026.4.1",
17
+ "minGatewayVersion": "2026.4.1"
18
+ },
19
+ "build": {
20
+ "openclawVersion": "2026.4.1",
21
+ "pluginSdkVersion": "2026.4.1"
22
+ }
14
23
  },
15
24
  "engines": {
16
25
  "node": ">=20.0.0"
@@ -31,28 +40,28 @@
31
40
  "scripts/claude-plugin",
32
41
  ".env.example"
33
42
  ],
43
+ "dependencies": {
44
+ "@huggingface/transformers": "^3.8.1",
45
+ "@modelcontextprotocol/sdk": "^1.27.1",
46
+ "zod": "^3.25.76"
47
+ },
48
+ "devDependencies": {
49
+ "@types/node": "^22.13.14",
50
+ "tsx": "^4.19.3",
51
+ "typescript": "^5.8.2",
52
+ "vitest": "^3.0.9"
53
+ },
34
54
  "scripts": {
35
55
  "build": "node scripts/build/clean-dist.mjs && tsc -p tsconfig.build.json && node scripts/build/copy-sqlite-schema.mjs",
36
56
  "dev": "tsx watch src/cli/index.ts",
37
57
  "evaluate:openclaw-baseline": "tsx src/cli/index.ts evaluate openclaw-baseline",
38
58
  "evaluate:openclaw-scenarios": "tsx src/cli/index.ts evaluate openclaw-scenarios --pack high-confidence",
59
+ "evaluate:codex-lifecycle": "tsx src/cli/index.ts evaluate codex-lifecycle",
39
60
  "maintenance:merge-warning-variants": "tsx scripts/maintenance/merge-warning-variants.ts",
40
61
  "runtime:promote-payload": "tsx scripts/openclaw/promote-runtime-payload.ts",
41
62
  "runtime:replay-fixture": "tsx scripts/openclaw/replay-runtime-fixture.ts",
42
- "prepack": "pnpm build",
43
63
  "typecheck": "tsc --noEmit",
44
64
  "test": "vitest run",
45
65
  "check": "pnpm typecheck && pnpm test && pnpm build"
46
- },
47
- "dependencies": {
48
- "@huggingface/transformers": "^3.8.1",
49
- "@modelcontextprotocol/sdk": "^1.27.1",
50
- "zod": "^3.25.76"
51
- },
52
- "devDependencies": {
53
- "@types/node": "^22.13.14",
54
- "tsx": "^4.19.3",
55
- "typescript": "^5.8.2",
56
- "vitest": "^3.0.9"
57
66
  }
58
- }
67
+ }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "experienceengine",
3
3
  "description": "Context-aware experience intervention controller for Claude Code.",
4
- "version": "0.1.2",
4
+ "version": "0.2.0",
5
5
  "author": {
6
6
  "name": "ExperienceEngine"
7
7
  },
@@ -4,12 +4,13 @@
4
4
  "type": "stdio",
5
5
  "command": "node",
6
6
  "args": [
7
- "${CLAUDE_PLUGIN_DATA}/node_modules/@alan512/experienceengine/dist/cli/index.js",
7
+ "${CLAUDE_PLUGIN_ROOT}/node_modules/@alan512/experienceengine/dist/cli/index.js",
8
8
  "mcp-server"
9
9
  ],
10
10
  "env": {
11
- "NODE_PATH": "${CLAUDE_PLUGIN_DATA}/node_modules",
12
- "EXPERIENCE_ENGINE_HOME": "${CLAUDE_PLUGIN_DATA}/experienceengine-home"
11
+ "NODE_PATH": "${CLAUDE_PLUGIN_ROOT}/node_modules",
12
+ "EXPERIENCE_ENGINE_HOME": "${CLAUDE_PLUGIN_ROOT}/experienceengine-home",
13
+ "EXPERIENCE_ENGINE_CLAUDE_HOOK_SOURCE": "marketplace"
13
14
  }
14
15
  }
15
16
  }
@@ -1,9 +1,38 @@
1
1
  #!/usr/bin/env bash
2
2
  set -euo pipefail
3
3
 
4
- PLUGIN_DATA="${CLAUDE_PLUGIN_DATA:?CLAUDE_PLUGIN_DATA is required}"
4
+ PLUGIN_DATA="${CLAUDE_PLUGIN_DATA:-${CLAUDE_PLUGIN_ROOT:-}}"
5
+ if [[ -z "${PLUGIN_DATA}" ]]; then
6
+ echo "CLAUDE_PLUGIN_DATA or CLAUDE_PLUGIN_ROOT is required" >&2
7
+ exit 1
8
+ fi
5
9
 
6
10
  export NODE_PATH="${PLUGIN_DATA}/node_modules${NODE_PATH:+:${NODE_PATH}}"
7
11
  export EXPERIENCE_ENGINE_HOME="${EXPERIENCE_ENGINE_HOME:-${PLUGIN_DATA}/experienceengine-home}"
12
+ STATE_PATH="${EXPERIENCE_ENGINE_HOME}/claude-marketplace-state.json"
13
+
14
+ node - "${STATE_PATH}" <<'NODE'
15
+ const fs = require("node:fs");
16
+ const path = require("node:path");
17
+
18
+ const [statePath] = process.argv.slice(2);
19
+ let current = {};
20
+ try {
21
+ current = JSON.parse(fs.readFileSync(statePath, "utf8"));
22
+ } catch {}
23
+
24
+ const next = {
25
+ adapter: "claude-code",
26
+ install_mode: "marketplace",
27
+ hook_source: "marketplace",
28
+ package_version: current.package_version,
29
+ written_at: current.written_at ?? new Date().toISOString(),
30
+ last_hook_seen_at: new Date().toISOString(),
31
+ last_mcp_seen_at: current.last_mcp_seen_at
32
+ };
33
+
34
+ fs.mkdirSync(path.dirname(statePath), { recursive: true });
35
+ fs.writeFileSync(statePath, `${JSON.stringify(next, null, 2)}\n`);
36
+ NODE
8
37
 
9
38
  exec node --no-warnings "${PLUGIN_DATA}/node_modules/@alan512/experienceengine/dist/cli/index.js" claude-hook "$@"
@@ -1,19 +1,54 @@
1
1
  #!/usr/bin/env bash
2
2
  set -euo pipefail
3
3
 
4
- PLUGIN_DATA="${CLAUDE_PLUGIN_DATA:?CLAUDE_PLUGIN_DATA is required}"
4
+ PLUGIN_DATA="${CLAUDE_PLUGIN_DATA:-${CLAUDE_PLUGIN_ROOT:-}}"
5
+ if [[ -z "${PLUGIN_DATA}" ]]; then
6
+ echo "CLAUDE_PLUGIN_DATA or CLAUDE_PLUGIN_ROOT is required" >&2
7
+ exit 1
8
+ fi
5
9
  PACKAGE_DIR="${PLUGIN_DATA}/node_modules/@alan512/experienceengine"
10
+ PACKAGE_ENTRY="${PACKAGE_DIR}/dist/cli/index.js"
6
11
  STAMP_PATH="${PLUGIN_DATA}/.experienceengine-plugin-version"
7
- REPO_URL="${EXPERIENCE_ENGINE_PLUGIN_GIT_URL:-https://github.com/Alan-512/ExperienceEngine.git}"
8
- REPO_REF="${EXPERIENCE_ENGINE_PLUGIN_GIT_REF:-main}"
9
- PACKAGE_VERSION="0.1.2"
12
+ EXPERIENCE_ENGINE_HOME_PATH="${EXPERIENCE_ENGINE_HOME:-${PLUGIN_DATA}/experienceengine-home}"
13
+ STATE_PATH="${EXPERIENCE_ENGINE_HOME_PATH}/claude-marketplace-state.json"
14
+ PACKAGE_VERSION="0.2.0"
15
+ PACKAGE_SPEC="${EXPERIENCE_ENGINE_PLUGIN_PACKAGE_SPEC:-@alan512/experienceengine@${PACKAGE_VERSION}}"
10
16
 
11
17
  mkdir -p "${PLUGIN_DATA}"
18
+ mkdir -p "${EXPERIENCE_ENGINE_HOME_PATH}"
19
+
20
+ write_marketplace_state() {
21
+ node - "${STATE_PATH}" "${PACKAGE_VERSION}" <<'NODE'
22
+ const fs = require("node:fs");
23
+ const path = require("node:path");
24
+
25
+ const [statePath, packageVersion] = process.argv.slice(2);
26
+ let current = {};
27
+ try {
28
+ current = JSON.parse(fs.readFileSync(statePath, "utf8"));
29
+ } catch {}
30
+
31
+ const next = {
32
+ adapter: "claude-code",
33
+ install_mode: "marketplace",
34
+ hook_source: "marketplace",
35
+ package_version: packageVersion,
36
+ written_at: current.written_at ?? new Date().toISOString(),
37
+ last_hook_seen_at: current.last_hook_seen_at,
38
+ last_mcp_seen_at: current.last_mcp_seen_at
39
+ };
40
+
41
+ fs.mkdirSync(path.dirname(statePath), { recursive: true });
42
+ fs.writeFileSync(statePath, `${JSON.stringify(next, null, 2)}\n`);
43
+ NODE
44
+ }
12
45
 
13
- if [[ -f "${STAMP_PATH}" ]] && [[ "$(cat "${STAMP_PATH}")" == "${PACKAGE_VERSION}" ]] && [[ -d "${PACKAGE_DIR}" ]]; then
46
+ if [[ -f "${STAMP_PATH}" ]] && [[ "$(cat "${STAMP_PATH}")" == "${PACKAGE_VERSION}" ]] && [[ -f "${PACKAGE_ENTRY}" ]]; then
47
+ write_marketplace_state
14
48
  exit 0
15
49
  fi
16
50
 
17
51
  rm -rf "${PLUGIN_DATA}/node_modules"
18
- npm install --prefix "${PLUGIN_DATA}" --no-package-lock --omit=dev "${REPO_URL}#${REPO_REF}"
52
+ npm install --prefix "${PLUGIN_DATA}" --no-package-lock --omit=dev --ignore-scripts "${PACKAGE_SPEC}"
19
53
  printf '%s' "${PACKAGE_VERSION}" > "${STAMP_PATH}"
54
+ write_marketplace_state
File without changes
File without changes
@@ -1 +0,0 @@
1
- export declare const runPackCommand: (args: string[]) => void;
@@ -1,321 +0,0 @@
1
- import { loadConfig } from "../../config/load-config.js";
2
- import { compilePack } from "../../compiler/compiler.js";
3
- import { deployCompiledPack } from "../../compiler/deployer.js";
4
- import { resolveExperienceEnginePaths } from "../../config/path-resolver.js";
5
- import { ExperiencePackRegistry } from "../../packs/fs-registry.js";
6
- import { ExperiencePackIndexSync } from "../../packs/index-sync.js";
7
- import { basename } from "node:path";
8
- import { bootstrapDatabase, openDatabase } from "../../store/sqlite/db.js";
9
- import { NodeRepository } from "../../store/sqlite/repositories/node-repo.js";
10
- import { ExperiencePackRepository } from "../../store/sqlite/repositories/pack-repo.js";
11
- import { resolveScope } from "../../input/scope-resolver.js";
12
- import { nowIso } from "../../utils/clock.js";
13
- const ALL_HOSTS = ["openclaw", "claude-code", "codex"];
14
- const usage = () => {
15
- console.log("Usage: ee pack <list|inspect <pack-id>|status <pack-id> [version] [agents|codex|github|claude] [repo-path]|draft create <pack-id> <node-id[,node-id...]> [name...]|review <pack-id> <description...>|publish <pack-id>|compile <pack-id> [version] [agents|codex|github|claude]|deploy <pack-id> [version] [agents|codex|github|claude] [repo-path] [--dry-run] [--force] [--status-only]|rollback <pack-id> <version>>");
16
- };
17
- const openServices = () => {
18
- const config = loadConfig();
19
- const paths = resolveExperienceEnginePaths();
20
- const db = openDatabase(config);
21
- bootstrapDatabase(db);
22
- const nodeRepo = new NodeRepository(db);
23
- const packRepo = new ExperiencePackRepository(db);
24
- const registry = new ExperiencePackRegistry({ packsDir: paths.packsDir });
25
- const indexSync = new ExperiencePackIndexSync(registry, packRepo);
26
- return { nodeRepo, packRepo, registry, indexSync };
27
- };
28
- const unique = (values) => Array.from(new Set(values));
29
- export const runPackCommand = (args) => {
30
- const [action, ...rest] = args;
31
- const { nodeRepo, packRepo, registry, indexSync } = openServices();
32
- if (!action || action === "help") {
33
- usage();
34
- return;
35
- }
36
- if (action === "list") {
37
- const packs = registry.listPacks();
38
- if (!packs.length) {
39
- console.log("No experience packs created yet.");
40
- return;
41
- }
42
- console.table(packs.map((pack) => {
43
- const compileStatus = registry.getCompileStatus(pack.packId, pack.currentVersion);
44
- return {
45
- pack_id: pack.packId,
46
- status: pack.status,
47
- current_version: pack.currentVersion,
48
- current_version_compiled: compileStatus.currentVersionCompiledTargets.join(", ") || "none",
49
- stale: compileStatus.stale,
50
- latest_compile_target: compileStatus.latestArtifact?.target ?? "",
51
- latest_compile_at: compileStatus.latestArtifact?.generatedAt ?? "",
52
- owner: pack.owner,
53
- updated_at: pack.updatedAt
54
- };
55
- }));
56
- return;
57
- }
58
- if (action === "inspect") {
59
- const packId = rest[0];
60
- if (!packId) {
61
- usage();
62
- return;
63
- }
64
- const pack = registry.readPack(packId);
65
- const versions = registry.listVersions(packId);
66
- const current = registry.readVersionManifest(packId, pack.currentVersion);
67
- const nodes = registry.readVersionNodes(packId, pack.currentVersion);
68
- const activations = packRepo.listActivationsByPack(packId);
69
- const activationSummary = activations.length
70
- ? activations
71
- .map((activation) => `${activation.scope_id}@${activation.pinned_version ?? pack.currentVersion} [${activation.enabled ? "enabled" : "disabled"}]`)
72
- .join(", ")
73
- : "none";
74
- console.log(`Pack: ${pack.packId}`);
75
- console.log(`Name: ${pack.name}`);
76
- console.log(`Status: ${pack.status}`);
77
- console.log(`Current version: ${pack.currentVersion}`);
78
- console.log(`Owner: ${pack.owner}`);
79
- console.log(`Description: ${pack.description}`);
80
- console.log(`Task families: ${pack.taskFamilies.join(", ")}`);
81
- console.log(`Hosts: ${pack.hostCompatibility.join(", ")}`);
82
- console.log(`Version count: ${versions.length}`);
83
- console.log(`Evidence: ${current.evidenceSummary}`);
84
- console.log(`Nodes: ${nodes.map((node) => node.id).join(", ")}`);
85
- console.log(`Activations: ${activationSummary}`);
86
- const compileStatus = registry.getCompileStatus(packId, pack.currentVersion);
87
- console.log(`Current version compiled targets: ${compileStatus.currentVersionCompiledTargets.join(", ") || "none"}`);
88
- console.log(`Compile stale: ${compileStatus.stale}`);
89
- const compiledArtifacts = registry.listCompiledArtifacts(packId);
90
- if (compiledArtifacts.length) {
91
- console.log("Compiled targets:");
92
- for (const artifact of compiledArtifacts) {
93
- console.log(`- ${artifact.target}@${artifact.version} (${artifact.renderedNodeCount} nodes)`);
94
- console.log(` Output: ${artifact.outputPath}`);
95
- }
96
- }
97
- else {
98
- console.log("Compiled targets: none");
99
- }
100
- const compileTarget = (value) => value === "agents" || value === "codex" || value === "github" || value === "claude" ? value : undefined;
101
- const arg2Target = compileTarget(rest[1]);
102
- const arg3Target = compileTarget(rest[2]);
103
- const version = arg2Target ? undefined : rest[1];
104
- const target = arg2Target ?? arg3Target;
105
- const repoPath = target ? rest[arg2Target ? 2 : arg3Target ? 3 : version ? 2 : 1] : undefined;
106
- if (target && repoPath) {
107
- const paths = resolveExperienceEnginePaths();
108
- const deployment = deployCompiledPack({
109
- packsDir: paths.packsDir,
110
- packId,
111
- version,
112
- target,
113
- repoPath,
114
- statusOnly: true
115
- });
116
- console.log("Deployment status:");
117
- console.log(` Target: ${deployment.target}`);
118
- console.log(` Destination: ${deployment.destinationPath}`);
119
- console.log(` Status: ${deployment.deploymentStatus}`);
120
- }
121
- return;
122
- }
123
- if (action === "draft" && rest[0] === "create") {
124
- const packId = rest[1];
125
- const nodeIdsCsv = rest[2];
126
- const name = rest.slice(3).join(" ").trim() || packId;
127
- if (!packId || !nodeIdsCsv) {
128
- usage();
129
- return;
130
- }
131
- const nodeIds = nodeIdsCsv.split(",").map((value) => value.trim()).filter(Boolean);
132
- const nodes = nodeIds
133
- .map((id) => nodeRepo.getById(id))
134
- .filter((node) => Boolean(node));
135
- if (nodes.length !== nodeIds.length) {
136
- throw new Error(`Unknown node id in pack draft: ${nodeIds.join(", ")}`);
137
- }
138
- const typedNodes = nodes;
139
- registry.createDraft({
140
- packId,
141
- name,
142
- description: name,
143
- owner: process.env.USER ?? process.env.USERNAME ?? "unknown",
144
- scopeHints: unique(typedNodes.map((node) => `scope:${node.scope_id}`)),
145
- taskFamilies: unique(typedNodes.map((node) => node.task_type)),
146
- hostCompatibility: [...ALL_HOSTS],
147
- nodes: typedNodes
148
- });
149
- indexSync.syncPack(packId);
150
- console.log(`[ExperienceEngine] Drafted experience pack ${packId}.`);
151
- return;
152
- }
153
- if (action === "review") {
154
- const packId = rest[0];
155
- const description = rest.slice(1).join(" ").trim();
156
- if (!packId || !description) {
157
- usage();
158
- return;
159
- }
160
- registry.reviewPack(packId, {
161
- description,
162
- evidenceSummary: description,
163
- riskLevel: "medium"
164
- });
165
- indexSync.syncPack(packId);
166
- console.log(`[ExperienceEngine] Reviewed experience pack ${packId}.`);
167
- return;
168
- }
169
- if (action === "publish") {
170
- const packId = rest[0];
171
- if (!packId) {
172
- usage();
173
- return;
174
- }
175
- registry.publishPack(packId);
176
- indexSync.syncPack(packId);
177
- console.log(`[ExperienceEngine] Published experience pack ${packId}.`);
178
- return;
179
- }
180
- if (action === "compile") {
181
- const packId = rest[0];
182
- const compileTarget = (value) => value === "agents" || value === "codex" || value === "github" || value === "claude" ? value : undefined;
183
- const arg2Target = compileTarget(rest[1]);
184
- const arg3Target = compileTarget(rest[2]);
185
- const version = arg2Target ? undefined : rest[1];
186
- const target = arg2Target ?? arg3Target ?? "agents";
187
- if (!packId) {
188
- usage();
189
- return;
190
- }
191
- const paths = resolveExperienceEnginePaths();
192
- const result = compilePack({
193
- packsDir: paths.packsDir,
194
- packId,
195
- version,
196
- target
197
- });
198
- console.log(`[ExperienceEngine] Compiled experience pack ${packId}.`);
199
- console.log(`${basename(result.outputPath)}: ${result.outputPath}`);
200
- console.log(`compile-report.json: ${result.reportPath}`);
201
- return;
202
- }
203
- if (action === "status") {
204
- const compileTarget = (value) => value === "agents" || value === "codex" || value === "github" || value === "claude" ? value : undefined;
205
- const packId = rest[0];
206
- const arg2Target = compileTarget(rest[1]);
207
- const arg3Target = compileTarget(rest[2]);
208
- const version = arg2Target ? undefined : rest[1];
209
- const target = arg2Target ?? arg3Target ?? "agents";
210
- const repoPath = rest[arg2Target ? 2 : arg3Target ? 3 : version ? 2 : 1] ?? process.cwd();
211
- if (!packId) {
212
- usage();
213
- return;
214
- }
215
- const paths = resolveExperienceEnginePaths();
216
- const result = deployCompiledPack({
217
- packsDir: paths.packsDir,
218
- packId,
219
- version,
220
- target,
221
- repoPath,
222
- statusOnly: true
223
- });
224
- console.log(`Pack status: ${packId}`);
225
- console.log(`Target: ${result.target}`);
226
- console.log(`Source: ${result.sourcePath}`);
227
- console.log(`Destination: ${result.destinationPath}`);
228
- console.log(`Status: ${result.deploymentStatus}`);
229
- console.log(`Status only: ${result.statusOnly}`);
230
- return;
231
- }
232
- if (action === "deploy") {
233
- const compileTarget = (value) => value === "agents" || value === "codex" || value === "github" || value === "claude" ? value : undefined;
234
- const positional = rest.filter((value) => value !== "--dry-run" && value !== "--force" && value !== "--status-only");
235
- const packId = positional[0];
236
- const arg2Target = compileTarget(positional[1]);
237
- const arg3Target = compileTarget(positional[2]);
238
- const version = arg2Target ? undefined : positional[1];
239
- const target = arg2Target ?? arg3Target ?? "agents";
240
- const repoPath = positional[arg2Target ? 2 : arg3Target ? 3 : version ? 2 : 1] ?? process.cwd();
241
- const dryRun = rest.includes("--dry-run");
242
- const force = rest.includes("--force");
243
- const statusOnly = rest.includes("--status-only");
244
- if (!packId) {
245
- usage();
246
- return;
247
- }
248
- const paths = resolveExperienceEnginePaths();
249
- const result = deployCompiledPack({
250
- packsDir: paths.packsDir,
251
- packId,
252
- version,
253
- target,
254
- repoPath,
255
- dryRun,
256
- force,
257
- statusOnly
258
- });
259
- console.log(`[ExperienceEngine] Deployed compiled pack ${packId}.`);
260
- console.log(`Deploy target: ${result.target}`);
261
- console.log(`Source: ${result.sourcePath}`);
262
- console.log(`Destination: ${result.destinationPath}`);
263
- console.log(`Status: ${result.deploymentStatus}`);
264
- console.log(`Status only: ${result.statusOnly}`);
265
- console.log(`Dry run: ${result.dryRun}`);
266
- console.log(`Overwrote existing file: ${result.overwritten}`);
267
- return;
268
- }
269
- if (action === "enable") {
270
- const packId = rest[0];
271
- const scopeId = rest[1] ?? resolveScope(process.cwd()).scope_id;
272
- if (!packId) {
273
- usage();
274
- return;
275
- }
276
- const pack = registry.readPack(packId);
277
- packRepo.upsertActivation({
278
- scope_id: scopeId,
279
- pack_id: packId,
280
- enabled: true,
281
- pinned_version: pack.currentVersion,
282
- created_at: nowIso(),
283
- updated_at: nowIso()
284
- });
285
- console.log(`[ExperienceEngine] Enabled experience pack ${packId} for scope ${scopeId}.`);
286
- return;
287
- }
288
- if (action === "disable") {
289
- const packId = rest[0];
290
- const scopeId = rest[1] ?? resolveScope(process.cwd()).scope_id;
291
- if (!packId) {
292
- usage();
293
- return;
294
- }
295
- const existing = packRepo.listActivations(scopeId).find((activation) => activation.pack_id === packId);
296
- packRepo.upsertActivation({
297
- scope_id: scopeId,
298
- pack_id: packId,
299
- enabled: false,
300
- pinned_version: existing?.pinned_version,
301
- created_at: existing?.created_at ?? nowIso(),
302
- updated_at: nowIso()
303
- });
304
- console.log(`[ExperienceEngine] Disabled experience pack ${packId} for scope ${scopeId}.`);
305
- return;
306
- }
307
- if (action === "rollback") {
308
- const packId = rest[0];
309
- const version = rest[1];
310
- if (!packId || !version) {
311
- usage();
312
- return;
313
- }
314
- registry.rollbackPack(packId, version);
315
- indexSync.syncPack(packId);
316
- console.log(`[ExperienceEngine] Rolled back experience pack ${packId} to ${version}.`);
317
- return;
318
- }
319
- usage();
320
- };
321
- //# sourceMappingURL=pack.js.map