principles-disciple 1.127.0 → 1.129.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 (593) hide show
  1. package/dist/commands/archive-impl.d.ts +18 -0
  2. package/dist/commands/archive-impl.js +105 -0
  3. package/dist/commands/capabilities.d.ts +3 -0
  4. package/dist/commands/capabilities.js +76 -0
  5. package/dist/commands/context.d.ts +5 -0
  6. package/{src/commands/context.ts → dist/commands/context.js} +34 -83
  7. package/dist/commands/disable-impl.d.ts +22 -0
  8. package/dist/commands/disable-impl.js +118 -0
  9. package/dist/commands/evolution-status.d.ts +4 -0
  10. package/dist/commands/evolution-status.js +187 -0
  11. package/dist/commands/export.d.ts +2 -0
  12. package/dist/commands/export.js +53 -0
  13. package/dist/commands/focus.d.ts +14 -0
  14. package/dist/commands/focus.js +443 -0
  15. package/dist/commands/pain.d.ts +6 -0
  16. package/{src/commands/pain.ts → dist/commands/pain.js} +137 -188
  17. package/dist/commands/principle-rollback.d.ts +4 -0
  18. package/dist/commands/principle-rollback.js +26 -0
  19. package/dist/commands/promote-impl.d.ts +22 -0
  20. package/dist/commands/promote-impl.js +194 -0
  21. package/dist/commands/rollback-impl.d.ts +32 -0
  22. package/dist/commands/rollback-impl.js +180 -0
  23. package/dist/commands/rollback.d.ts +19 -0
  24. package/{src/commands/rollback.ts → dist/commands/rollback.js} +10 -53
  25. package/dist/commands/samples.d.ts +2 -0
  26. package/dist/commands/samples.js +58 -0
  27. package/dist/commands/strategy.d.ts +2 -0
  28. package/dist/commands/strategy.js +16 -0
  29. package/dist/commands/thinking-os.d.ts +2 -0
  30. package/{src/commands/thinking-os.ts → dist/commands/thinking-os.js} +35 -58
  31. package/dist/commands/workflow-debug.d.ts +6 -0
  32. package/{src/commands/workflow-debug.ts → dist/commands/workflow-debug.js} +13 -33
  33. package/dist/config/defaults/runtime.d.ts +58 -0
  34. package/{src/config/defaults/runtime.ts → dist/config/defaults/runtime.js} +4 -41
  35. package/dist/config/errors.d.ts +86 -0
  36. package/dist/config/errors.js +107 -0
  37. package/{src/config/index.ts → dist/config/index.d.ts} +1 -2
  38. package/dist/config/index.js +7 -0
  39. package/dist/constants/diagnostician.d.ts +12 -0
  40. package/{src/constants/diagnostician.ts → dist/constants/diagnostician.js} +0 -1
  41. package/dist/constants/tools.d.ts +17 -0
  42. package/dist/constants/tools.js +53 -0
  43. package/dist/core/__tests__/focus-history.test.d.ts +1 -0
  44. package/dist/core/__tests__/focus-history.test.js +160 -0
  45. package/dist/core/bootstrap-rules.d.ts +50 -0
  46. package/dist/core/bootstrap-rules.js +187 -0
  47. package/dist/core/code-implementation-storage.d.ts +71 -0
  48. package/dist/core/code-implementation-storage.js +139 -0
  49. package/dist/core/config-health.d.ts +27 -0
  50. package/dist/core/config-health.js +60 -0
  51. package/dist/core/config-service.d.ts +15 -0
  52. package/{src/core/config-service.ts → dist/core/config-service.js} +4 -7
  53. package/dist/core/config.d.ts +111 -0
  54. package/{src/core/config.ts → dist/core/config.js} +46 -146
  55. package/dist/core/control-ui-db.d.ts +106 -0
  56. package/dist/core/control-ui-db.js +309 -0
  57. package/dist/core/correction-cue-learner.d.ts +33 -0
  58. package/dist/core/correction-cue-learner.js +184 -0
  59. package/dist/core/correction-types.d.ts +3 -0
  60. package/dist/core/correction-types.js +1 -0
  61. package/dist/core/detection-funnel.d.ts +33 -0
  62. package/{src/core/detection-funnel.ts → dist/core/detection-funnel.js} +17 -37
  63. package/dist/core/detection-service.d.ts +15 -0
  64. package/{src/core/detection-service.ts → dist/core/detection-service.js} +4 -7
  65. package/dist/core/dictionary-service.d.ts +15 -0
  66. package/{src/core/dictionary-service.ts → dist/core/dictionary-service.js} +4 -7
  67. package/dist/core/dictionary.d.ts +38 -0
  68. package/{src/core/dictionary.ts → dist/core/dictionary.js} +33 -59
  69. package/dist/core/empathy-keyword-matcher.d.ts +5 -0
  70. package/dist/core/empathy-keyword-matcher.js +40 -0
  71. package/dist/core/empathy-types.d.ts +2 -0
  72. package/dist/core/empathy-types.js +1 -0
  73. package/dist/core/event-log.d.ts +90 -0
  74. package/dist/core/event-log.js +702 -0
  75. package/dist/core/evolution-engine.d.ts +119 -0
  76. package/dist/core/evolution-engine.js +460 -0
  77. package/dist/core/evolution-logger.d.ts +137 -0
  78. package/dist/core/evolution-logger.js +261 -0
  79. package/dist/core/evolution-migration.d.ts +5 -0
  80. package/dist/core/evolution-migration.js +65 -0
  81. package/dist/core/evolution-reducer.d.ts +124 -0
  82. package/dist/core/evolution-reducer.js +730 -0
  83. package/dist/core/evolution-types.d.ts +50 -0
  84. package/dist/core/evolution-types.js +11 -0
  85. package/dist/core/external-training-contract.d.ts +276 -0
  86. package/dist/core/external-training-contract.js +269 -0
  87. package/dist/core/file-store.d.ts +41 -0
  88. package/dist/core/file-store.js +46 -0
  89. package/dist/core/focus-history.d.ts +50 -0
  90. package/dist/core/focus-history.js +574 -0
  91. package/dist/core/hygiene/tracker.d.ts +22 -0
  92. package/dist/core/hygiene/tracker.js +110 -0
  93. package/dist/core/init.d.ts +30 -0
  94. package/{src/core/init.ts → dist/core/init.js} +87 -118
  95. package/dist/core/local-worker-routing.d.ts +124 -0
  96. package/dist/core/local-worker-routing.js +216 -0
  97. package/dist/core/migration.d.ts +6 -0
  98. package/{src/core/migration.ts → dist/core/migration.js} +10 -18
  99. package/dist/core/model-deployment-registry.d.ts +218 -0
  100. package/dist/core/model-deployment-registry.js +502 -0
  101. package/dist/core/model-training-registry.d.ts +295 -0
  102. package/dist/core/model-training-registry.js +474 -0
  103. package/dist/core/observability.d.ts +40 -0
  104. package/dist/core/observability.js +164 -0
  105. package/dist/core/pain-diagnostic-gate.d.ts +36 -0
  106. package/dist/core/pain-diagnostic-gate.js +105 -0
  107. package/dist/core/pain.d.ts +87 -0
  108. package/dist/core/pain.js +223 -0
  109. package/dist/core/path-resolver.d.ts +60 -0
  110. package/{src/core/path-resolver.ts → dist/core/path-resolver.js} +41 -131
  111. package/dist/core/paths.d.ts +60 -0
  112. package/{src/core/paths.ts → dist/core/paths.js} +4 -13
  113. package/dist/core/pd-config-loader.d.ts +96 -0
  114. package/dist/core/pd-config-loader.js +307 -0
  115. package/dist/core/pd-task-reconciler.d.ts +89 -0
  116. package/dist/core/pd-task-reconciler.js +262 -0
  117. package/dist/core/pd-task-service.d.ts +2 -0
  118. package/dist/core/pd-task-service.js +32 -0
  119. package/dist/core/pd-task-store.d.ts +5 -0
  120. package/dist/core/pd-task-store.js +62 -0
  121. package/dist/core/pd-task-types.d.ts +8 -0
  122. package/dist/core/pd-task-types.js +2 -0
  123. package/dist/core/principle-compiler/__tests__/compiler-replay-gate.test.d.ts +1 -0
  124. package/dist/core/principle-compiler/__tests__/compiler-replay-gate.test.js +132 -0
  125. package/dist/core/principle-compiler/code-validator.d.ts +14 -0
  126. package/dist/core/principle-compiler/code-validator.js +86 -0
  127. package/dist/core/principle-compiler/compiler.d.ts +45 -0
  128. package/dist/core/principle-compiler/compiler.js +287 -0
  129. package/{src/core/principle-compiler/index.ts → dist/core/principle-compiler/index.d.ts} +0 -1
  130. package/dist/core/principle-compiler/index.js +10 -0
  131. package/dist/core/principle-compiler/ledger-registrar.d.ts +28 -0
  132. package/dist/core/principle-compiler/ledger-registrar.js +95 -0
  133. package/{src/core/principle-compiler/template-generator.ts → dist/core/principle-compiler/template-generator.d.ts} +0 -1
  134. package/dist/core/principle-compiler/template-generator.js +7 -0
  135. package/{src/core/principle-injection.ts → dist/core/principle-injection.d.ts} +1 -7
  136. package/dist/core/principle-injection.js +10 -0
  137. package/dist/core/principle-internalization/filesystem-lifecycle-datasource.d.ts +15 -0
  138. package/dist/core/principle-internalization/filesystem-lifecycle-datasource.js +34 -0
  139. package/dist/core/principle-internalization/lifecycle-read-model.d.ts +17 -0
  140. package/{src/core/principle-internalization/lifecycle-read-model.ts → dist/core/principle-internalization/lifecycle-read-model.js} +2 -21
  141. package/dist/core/principle-internalization/lifecycle-refresh.d.ts +2 -0
  142. package/dist/core/principle-internalization/lifecycle-refresh.js +4 -0
  143. package/dist/core/principle-internalization/principle-lifecycle-service.d.ts +28 -0
  144. package/dist/core/principle-internalization/principle-lifecycle-service.js +89 -0
  145. package/dist/core/principle-training-state.d.ts +47 -0
  146. package/dist/core/principle-training-state.js +113 -0
  147. package/dist/core/principle-tree-ledger-adapter.d.ts +32 -0
  148. package/dist/core/principle-tree-ledger-adapter.js +125 -0
  149. package/dist/core/principle-tree-ledger.d.ts +82 -0
  150. package/dist/core/principle-tree-ledger.js +527 -0
  151. package/dist/core/profile.d.ts +62 -0
  152. package/dist/core/profile.js +211 -0
  153. package/dist/core/promotion-gate.d.ts +243 -0
  154. package/dist/core/promotion-gate.js +554 -0
  155. package/dist/core/reflection/reflection-context.d.ts +31 -0
  156. package/dist/core/reflection/reflection-context.js +91 -0
  157. package/dist/core/replay-engine.d.ts +12 -0
  158. package/dist/core/replay-engine.js +82 -0
  159. package/dist/core/risk-calculator.d.ts +22 -0
  160. package/{src/core/risk-calculator.ts → dist/core/risk-calculator.js} +19 -49
  161. package/{src/core/rule-host-helpers.ts → dist/core/rule-host-helpers.d.ts} +0 -1
  162. package/dist/core/rule-host-helpers.js +7 -0
  163. package/{src/core/rule-host-types.ts → dist/core/rule-host-types.d.ts} +1 -8
  164. package/dist/core/rule-host-types.js +7 -0
  165. package/dist/core/rule-host.d.ts +86 -0
  166. package/dist/core/rule-host.js +311 -0
  167. package/dist/core/rule-implementation-runtime.d.ts +18 -0
  168. package/dist/core/rule-implementation-runtime.js +112 -0
  169. package/dist/core/runtime-v2-prompt-activation-reader.d.ts +22 -0
  170. package/dist/core/runtime-v2-prompt-activation-reader.js +99 -0
  171. package/{src/core/schema/db-types.ts → dist/core/schema/db-types.d.ts} +4 -9
  172. package/dist/core/schema/db-types.js +5 -0
  173. package/{src/core/schema/index.ts → dist/core/schema/index.d.ts} +1 -10
  174. package/dist/core/schema/index.js +15 -0
  175. package/dist/core/schema/migration-runner.d.ts +53 -0
  176. package/dist/core/schema/migration-runner.js +170 -0
  177. package/dist/core/schema/migrations/001-init-trajectory.d.ts +6 -0
  178. package/{src/core/schema/migrations/001-init-trajectory.ts → dist/core/schema/migrations/001-init-trajectory.js} +38 -56
  179. package/dist/core/schema/migrations/002-init-central.d.ts +5 -0
  180. package/{src/core/schema/migrations/002-init-central.ts → dist/core/schema/migrations/002-init-central.js} +27 -41
  181. package/dist/core/schema/migrations/003-init-workflow.d.ts +5 -0
  182. package/{src/core/schema/migrations/003-init-workflow.ts → dist/core/schema/migrations/003-init-workflow.js} +16 -21
  183. package/dist/core/schema/migrations/004-add-thinking-and-gfi.d.ts +8 -0
  184. package/{src/core/schema/migrations/004-add-thinking-and-gfi.ts → dist/core/schema/migrations/004-add-thinking-and-gfi.js} +19 -27
  185. package/{src/core/schema/migrations/index.ts → dist/core/schema/migrations/index.d.ts} +1 -16
  186. package/dist/core/schema/migrations/index.js +27 -0
  187. package/dist/core/schema/schema-definitions.d.ts +46 -0
  188. package/{src/core/schema/schema-definitions.ts → dist/core/schema/schema-definitions.js} +242 -291
  189. package/dist/core/session-tracker.d.ts +119 -0
  190. package/{src/core/session-tracker.ts → dist/core/session-tracker.js} +96 -239
  191. package/dist/core/shadow-observation-registry.d.ts +217 -0
  192. package/dist/core/shadow-observation-registry.js +280 -0
  193. package/dist/core/surface-guard.d.ts +31 -0
  194. package/dist/core/surface-guard.js +131 -0
  195. package/dist/core/system-logger.d.ts +8 -0
  196. package/{src/core/system-logger.ts → dist/core/system-logger.js} +20 -34
  197. package/dist/core/thinking-models.d.ts +70 -0
  198. package/dist/core/thinking-models.js +300 -0
  199. package/dist/core/thinking-os-parser.d.ts +35 -0
  200. package/dist/core/thinking-os-parser.js +123 -0
  201. package/dist/core/trajectory-types.d.ts +220 -0
  202. package/dist/core/trajectory-types.js +8 -0
  203. package/dist/core/trajectory.d.ts +242 -0
  204. package/dist/core/trajectory.js +1500 -0
  205. package/dist/core/workflow-funnel-loader.d.ts +72 -0
  206. package/dist/core/workflow-funnel-loader.js +135 -0
  207. package/dist/core/workspace-context.d.ts +111 -0
  208. package/{src/core/workspace-context.ts → dist/core/workspace-context.js} +50 -105
  209. package/dist/core/workspace-dir-validation.d.ts +11 -0
  210. package/dist/core/workspace-dir-validation.js +37 -0
  211. package/dist/core/workspace-guidance-migrator.d.ts +12 -0
  212. package/{src/core/workspace-guidance-migrator.ts → dist/core/workspace-guidance-migrator.js} +21 -59
  213. package/dist/hooks/after-tool-call-helpers.d.ts +89 -0
  214. package/dist/hooks/after-tool-call-helpers.js +475 -0
  215. package/dist/hooks/after-tool-call-types.d.ts +86 -0
  216. package/dist/hooks/after-tool-call-types.js +13 -0
  217. package/dist/hooks/gate-block-helper.d.ts +44 -0
  218. package/dist/hooks/gate-block-helper.js +209 -0
  219. package/dist/hooks/gate.d.ts +16 -0
  220. package/dist/hooks/gate.js +381 -0
  221. package/dist/hooks/lifecycle.d.ts +5 -0
  222. package/dist/hooks/lifecycle.js +287 -0
  223. package/dist/hooks/llm.d.ts +13 -0
  224. package/{src/hooks/llm.ts → dist/hooks/llm.js} +63 -117
  225. package/dist/hooks/message-sanitize.d.ts +24 -0
  226. package/dist/hooks/message-sanitize.js +77 -0
  227. package/dist/hooks/pain.d.ts +33 -0
  228. package/dist/hooks/pain.js +294 -0
  229. package/dist/hooks/prompt.d.ts +52 -0
  230. package/dist/hooks/prompt.js +930 -0
  231. package/dist/hooks/raw-observation-adapter.d.ts +57 -0
  232. package/dist/hooks/raw-observation-adapter.js +170 -0
  233. package/dist/hooks/raw-observation-types.d.ts +62 -0
  234. package/dist/hooks/raw-observation-types.js +15 -0
  235. package/dist/hooks/subagent.d.ts +9 -0
  236. package/{src/hooks/subagent.ts → dist/hooks/subagent.js} +20 -60
  237. package/dist/hooks/trajectory-collector.d.ts +25 -0
  238. package/dist/hooks/trajectory-collector.js +225 -0
  239. package/dist/hooks/trajectory-evidence.d.ts +11 -0
  240. package/dist/hooks/trajectory-evidence.js +88 -0
  241. package/dist/hooks/triage-adapter.d.ts +58 -0
  242. package/{src/hooks/triage-adapter.ts → dist/hooks/triage-adapter.js} +36 -68
  243. package/dist/hooks/trigger-cooldown-tracker.d.ts +30 -0
  244. package/dist/hooks/trigger-cooldown-tracker.js +55 -0
  245. package/dist/i18n/commands.d.ts +26 -0
  246. package/dist/i18n/commands.js +96 -0
  247. package/dist/index.d.ts +50 -0
  248. package/dist/index.js +829 -0
  249. package/dist/openclaw-sdk.d.ts +293 -0
  250. package/dist/openclaw-sdk.js +4 -0
  251. package/dist/service/central-database.d.ts +138 -0
  252. package/dist/service/central-database.js +731 -0
  253. package/dist/service/central-sync-service.d.ts +8 -0
  254. package/dist/service/central-sync-service.js +71 -0
  255. package/dist/service/correction-observer-service.d.ts +19 -0
  256. package/{src/service/correction-observer-service.ts → dist/service/correction-observer-service.js} +36 -76
  257. package/dist/service/evolution-dedup.d.ts +27 -0
  258. package/{src/service/evolution-dedup.ts → dist/service/evolution-dedup.js} +11 -31
  259. package/{src/service/evolution-queue-migration.ts → dist/service/evolution-queue-migration.d.ts} +15 -62
  260. package/dist/service/evolution-queue-migration.js +53 -0
  261. package/dist/service/evolution-worker.d.ts +103 -0
  262. package/{src/service/evolution-worker.ts → dist/service/evolution-worker.js} +169 -331
  263. package/dist/service/internalization-auto-consumer-service.d.ts +8 -0
  264. package/dist/service/internalization-auto-consumer-service.js +322 -0
  265. package/dist/service/keyword-optimization-service.d.ts +44 -0
  266. package/dist/service/keyword-optimization-service.js +137 -0
  267. package/dist/service/phase3-input-filter.d.ts +73 -0
  268. package/dist/service/phase3-input-filter.js +172 -0
  269. package/dist/service/queue-io.d.ts +30 -0
  270. package/dist/service/queue-io.js +79 -0
  271. package/{src/service/queue-migration.ts → dist/service/queue-migration.d.ts} +6 -45
  272. package/dist/service/queue-migration.js +56 -0
  273. package/dist/service/runtime-summary-service.d.ts +158 -0
  274. package/dist/service/runtime-summary-service.js +636 -0
  275. package/dist/service/subagent-workflow/subagent-error-utils.d.ts +8 -0
  276. package/{src/service/subagent-workflow/subagent-error-utils.ts → dist/service/subagent-workflow/subagent-error-utils.js} +3 -6
  277. package/{src/service/subagent-workflow/types.ts → dist/service/subagent-workflow/types.d.ts} +17 -80
  278. package/dist/service/subagent-workflow/types.js +11 -0
  279. package/dist/service/subagent-workflow/workflow-store.d.ts +30 -0
  280. package/{src/service/subagent-workflow/workflow-store.ts → dist/service/subagent-workflow/workflow-store.js} +43 -108
  281. package/dist/service/trajectory-service.d.ts +2 -0
  282. package/dist/service/trajectory-service.js +16 -0
  283. package/dist/service/workflow-watchdog.d.ts +23 -0
  284. package/dist/service/workflow-watchdog.js +103 -0
  285. package/dist/types/event-types.d.ts +2 -0
  286. package/dist/types/event-types.js +1 -0
  287. package/dist/types/hygiene-types.d.ts +2 -0
  288. package/dist/types/hygiene-types.js +1 -0
  289. package/{src/types/principle-tree-schema.ts → dist/types/principle-tree-schema.d.ts} +2 -25
  290. package/dist/types/principle-tree-schema.js +24 -0
  291. package/dist/types/queue.d.ts +2 -0
  292. package/dist/types/queue.js +1 -0
  293. package/dist/types/runtime-summary.d.ts +1 -0
  294. package/dist/types/runtime-summary.js +1 -0
  295. package/dist/types.d.ts +33 -0
  296. package/dist/types.js +16 -0
  297. package/dist/utils/file-lock.d.ts +68 -0
  298. package/dist/utils/file-lock.js +310 -0
  299. package/dist/utils/hashing.d.ts +9 -0
  300. package/{src/utils/hashing.ts → dist/utils/hashing.js} +4 -6
  301. package/dist/utils/io.d.ts +11 -0
  302. package/dist/utils/io.js +174 -0
  303. package/dist/utils/node-vm-polyfill.d.ts +9 -0
  304. package/{src/utils/node-vm-polyfill.ts → dist/utils/node-vm-polyfill.js} +0 -2
  305. package/dist/utils/retry.d.ts +210 -0
  306. package/dist/utils/retry.js +375 -0
  307. package/dist/utils/session-key.d.ts +10 -0
  308. package/{src/utils/session-key.ts → dist/utils/session-key.js} +5 -4
  309. package/dist/utils/shadow-fingerprint.d.ts +16 -0
  310. package/dist/utils/shadow-fingerprint.js +34 -0
  311. package/dist/utils/workspace-resolver.d.ts +82 -0
  312. package/dist/utils/workspace-resolver.js +288 -0
  313. package/openclaw.plugin.json +1 -1
  314. package/package.json +8 -2
  315. package/templates/workspace/.principles/DECISION_POLICY.json +44 -0
  316. package/templates/workspace/.principles/PRINCIPLES.md +20 -0
  317. package/templates/workspace/.principles/PROFILE.json +54 -0
  318. package/templates/workspace/.principles/PROFILE.schema.json +56 -0
  319. package/templates/workspace/.principles/THINKING_OS.md +65 -0
  320. package/templates/workspace/.principles/THINKING_OS_ARCHIVE.md +7 -0
  321. package/templates/workspace/.principles/THINKING_OS_CANDIDATES.md +9 -0
  322. package/templates/workspace/.principles/models/_INDEX.md +27 -0
  323. package/templates/workspace/.principles/models/first_principles.md +62 -0
  324. package/templates/workspace/.principles/models/marketing_4p.md +52 -0
  325. package/templates/workspace/.principles/models/porter_five.md +63 -0
  326. package/templates/workspace/.principles/models/swot.md +60 -0
  327. package/templates/workspace/.principles/models/user_story_map.md +63 -0
  328. package/templates/workspace/.state/WORKBOARD.json +4 -0
  329. package/.dependency-cruiser.json +0 -19
  330. package/ADVANCED_CONFIG_ZH.md +0 -93
  331. package/AGENT_INSTALL.md +0 -173
  332. package/AGENT_INSTALL_EN.md +0 -173
  333. package/CHANGELOG.md +0 -26
  334. package/INSTALL.md +0 -254
  335. package/SKILL.md +0 -63
  336. package/esbuild.config.js +0 -104
  337. package/src/commands/archive-impl.ts +0 -147
  338. package/src/commands/capabilities.ts +0 -89
  339. package/src/commands/disable-impl.ts +0 -159
  340. package/src/commands/evolution-status.ts +0 -247
  341. package/src/commands/export.ts +0 -59
  342. package/src/commands/focus.ts +0 -523
  343. package/src/commands/principle-rollback.ts +0 -32
  344. package/src/commands/promote-impl.ts +0 -254
  345. package/src/commands/rollback-impl.ts +0 -246
  346. package/src/commands/samples.ts +0 -65
  347. package/src/commands/strategy.ts +0 -21
  348. package/src/config/errors.ts +0 -180
  349. package/src/constants/tools.ts +0 -62
  350. package/src/core/AGENTS.md +0 -34
  351. package/src/core/__tests__/focus-history.test.ts +0 -210
  352. package/src/core/bootstrap-rules.ts +0 -216
  353. package/src/core/code-implementation-storage.ts +0 -213
  354. package/src/core/config-health.ts +0 -72
  355. package/src/core/control-ui-db.ts +0 -454
  356. package/src/core/correction-cue-learner.ts +0 -239
  357. package/src/core/correction-types.ts +0 -16
  358. package/src/core/empathy-keyword-matcher.ts +0 -64
  359. package/src/core/empathy-types.ts +0 -18
  360. package/src/core/event-log.ts +0 -787
  361. package/src/core/evolution-engine.ts +0 -613
  362. package/src/core/evolution-logger.ts +0 -357
  363. package/src/core/evolution-migration.ts +0 -77
  364. package/src/core/evolution-reducer.ts +0 -891
  365. package/src/core/evolution-types.ts +0 -110
  366. package/src/core/external-training-contract.ts +0 -530
  367. package/src/core/file-store.ts +0 -80
  368. package/src/core/focus-history.ts +0 -763
  369. package/src/core/hygiene/tracker.ts +0 -122
  370. package/src/core/local-worker-routing.ts +0 -337
  371. package/src/core/model-deployment-registry.ts +0 -724
  372. package/src/core/model-training-registry.ts +0 -815
  373. package/src/core/observability.ts +0 -242
  374. package/src/core/pain-diagnostic-gate.ts +0 -169
  375. package/src/core/pain.ts +0 -309
  376. package/src/core/pd-config-loader.ts +0 -400
  377. package/src/core/pd-task-reconciler.ts +0 -380
  378. package/src/core/pd-task-service.ts +0 -43
  379. package/src/core/pd-task-store.ts +0 -78
  380. package/src/core/pd-task-types.ts +0 -24
  381. package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +0 -174
  382. package/src/core/principle-compiler/code-validator.ts +0 -96
  383. package/src/core/principle-compiler/compiler.ts +0 -327
  384. package/src/core/principle-compiler/ledger-registrar.ts +0 -116
  385. package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +0 -42
  386. package/src/core/principle-internalization/lifecycle-refresh.ts +0 -11
  387. package/src/core/principle-internalization/principle-lifecycle-service.ts +0 -170
  388. package/src/core/principle-training-state.ts +0 -177
  389. package/src/core/principle-tree-ledger-adapter.ts +0 -145
  390. package/src/core/principle-tree-ledger.ts +0 -725
  391. package/src/core/profile.ts +0 -228
  392. package/src/core/promotion-gate.ts +0 -854
  393. package/src/core/reflection/reflection-context.ts +0 -133
  394. package/src/core/replay-engine.ts +0 -106
  395. package/src/core/rule-host.ts +0 -386
  396. package/src/core/rule-implementation-runtime.ts +0 -145
  397. package/src/core/runtime-v2-prompt-activation-reader.ts +0 -114
  398. package/src/core/schema/migration-runner.ts +0 -207
  399. package/src/core/shadow-observation-registry.ts +0 -508
  400. package/src/core/surface-guard.ts +0 -188
  401. package/src/core/thinking-models.ts +0 -377
  402. package/src/core/thinking-os-parser.ts +0 -165
  403. package/src/core/trajectory-types.ts +0 -247
  404. package/src/core/trajectory.ts +0 -1831
  405. package/src/core/workflow-funnel-loader.ts +0 -195
  406. package/src/core/workspace-dir-validation.ts +0 -52
  407. package/src/hooks/AGENTS.md +0 -31
  408. package/src/hooks/after-tool-call-helpers.ts +0 -601
  409. package/src/hooks/after-tool-call-types.ts +0 -99
  410. package/src/hooks/gate-block-helper.ts +0 -265
  411. package/src/hooks/gate.ts +0 -394
  412. package/src/hooks/lifecycle.ts +0 -334
  413. package/src/hooks/message-sanitize.ts +0 -102
  414. package/src/hooks/pain.ts +0 -358
  415. package/src/hooks/prompt.ts +0 -1102
  416. package/src/hooks/raw-observation-adapter.ts +0 -215
  417. package/src/hooks/raw-observation-types.ts +0 -77
  418. package/src/hooks/trajectory-collector.ts +0 -253
  419. package/src/hooks/trajectory-evidence.ts +0 -97
  420. package/src/hooks/trigger-cooldown-tracker.ts +0 -82
  421. package/src/i18n/commands.ts +0 -101
  422. package/src/index.ts +0 -939
  423. package/src/openclaw-sdk.ts +0 -312
  424. package/src/service/central-database.ts +0 -936
  425. package/src/service/central-sync-service.ts +0 -85
  426. package/src/service/internalization-auto-consumer-service.ts +0 -397
  427. package/src/service/keyword-optimization-service.ts +0 -169
  428. package/src/service/phase3-input-filter.ts +0 -237
  429. package/src/service/queue-io.ts +0 -108
  430. package/src/service/runtime-summary-service.ts +0 -990
  431. package/src/service/trajectory-service.ts +0 -16
  432. package/src/service/workflow-watchdog.ts +0 -125
  433. package/src/types/event-types.ts +0 -39
  434. package/src/types/hygiene-types.ts +0 -8
  435. package/src/types/queue.ts +0 -15
  436. package/src/types/runtime-summary.ts +0 -5
  437. package/src/types.ts +0 -53
  438. package/src/utils/file-lock.ts +0 -394
  439. package/src/utils/io.ts +0 -176
  440. package/src/utils/retry.ts +0 -573
  441. package/src/utils/shadow-fingerprint.ts +0 -42
  442. package/src/utils/workspace-resolver.ts +0 -393
  443. package/tests/README.md +0 -120
  444. package/tests/build-artifacts.test.ts +0 -55
  445. package/tests/commands/evolution-status.test.ts +0 -511
  446. package/tests/commands/export.test.ts +0 -78
  447. package/tests/commands/pain.test.ts +0 -287
  448. package/tests/commands/samples.test.ts +0 -65
  449. package/tests/commands/strategy.test.ts +0 -19
  450. package/tests/commands/thinking-os.test.ts +0 -88
  451. package/tests/core/bootstrap-rules.test.ts +0 -596
  452. package/tests/core/code-implementation-storage.test.ts +0 -300
  453. package/tests/core/code-validator.test.ts +0 -197
  454. package/tests/core/config-service.test.ts +0 -89
  455. package/tests/core/config.test.ts +0 -90
  456. package/tests/core/control-ui-db.test.ts +0 -75
  457. package/tests/core/core-principle-registry-drift.test.ts +0 -39
  458. package/tests/core/core-template-guidance.test.ts +0 -21
  459. package/tests/core/correction-cue-learner.test.ts +0 -345
  460. package/tests/core/detection-service.test.ts +0 -50
  461. package/tests/core/dictionary-service.test.ts +0 -116
  462. package/tests/core/dictionary.test.ts +0 -171
  463. package/tests/core/empathy-keyword-matcher.test.ts +0 -209
  464. package/tests/core/event-log.test.ts +0 -484
  465. package/tests/core/evolution-engine.test.ts +0 -610
  466. package/tests/core/evolution-logger.test.ts +0 -148
  467. package/tests/core/evolution-migration.test.ts +0 -374
  468. package/tests/core/evolution-paths.test.ts +0 -21
  469. package/tests/core/evolution-reducer.compilation-retry.test.ts +0 -189
  470. package/tests/core/evolution-reducer.detector-metadata.test.ts +0 -602
  471. package/tests/core/evolution-types-loop.test.ts +0 -48
  472. package/tests/core/external-training-contract.test.ts +0 -463
  473. package/tests/core/file-store.test.ts +0 -102
  474. package/tests/core/focus-history.test.ts +0 -874
  475. package/tests/core/init-flatten.test.ts +0 -69
  476. package/tests/core/init-refactor.test.ts +0 -87
  477. package/tests/core/init-v1.3.test.ts +0 -46
  478. package/tests/core/init.test.ts +0 -190
  479. package/tests/core/ledger-registrar.test.ts +0 -235
  480. package/tests/core/migration.test.ts +0 -84
  481. package/tests/core/model-deployment-registry.test.ts +0 -858
  482. package/tests/core/model-training-registry.test.ts +0 -908
  483. package/tests/core/observability.test.ts +0 -382
  484. package/tests/core/pain-diagnostic-gate.test.ts +0 -614
  485. package/tests/core/pain-score.property.test.ts +0 -19
  486. package/tests/core/pain.test.ts +0 -132
  487. package/tests/core/path-resolver.test.ts +0 -57
  488. package/tests/core/paths-refactor.test.ts +0 -20
  489. package/tests/core/pd-config-loader.test.ts +0 -407
  490. package/tests/core/pd-task-store.test.ts +0 -126
  491. package/tests/core/phase7-rollout-integration.test.ts +0 -477
  492. package/tests/core/principle-compiler.test.ts +0 -350
  493. package/tests/core/principle-injection.test.ts +0 -223
  494. package/tests/core/principle-internalization/deprecated-readiness.test.ts +0 -193
  495. package/tests/core/principle-internalization/lifecycle-metrics.test.ts +0 -350
  496. package/tests/core/principle-internalization/lifecycle-routing-policy.test.ts +0 -212
  497. package/tests/core/principle-internalization/lineage-source-retired.test.ts +0 -56
  498. package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +0 -189
  499. package/tests/core/principle-training-state.test.ts +0 -939
  500. package/tests/core/principle-tree-ledger-adapter.test.ts +0 -253
  501. package/tests/core/principle-tree-ledger.test.ts +0 -423
  502. package/tests/core/profile.test.ts +0 -56
  503. package/tests/core/promotion-gate.test.ts +0 -561
  504. package/tests/core/queue-purge.test.ts +0 -337
  505. package/tests/core/reflection-context.test.ts +0 -342
  506. package/tests/core/regression-v1-9-1.test.ts +0 -266
  507. package/tests/core/replay-engine.test.ts +0 -165
  508. package/tests/core/risk-calculator.test.ts +0 -168
  509. package/tests/core/rule-host-adversarial-output.test.ts +0 -242
  510. package/tests/core/rule-host-autocorrect-vm.test.ts +0 -163
  511. package/tests/core/rule-host-helpers.test.ts +0 -120
  512. package/tests/core/rule-host-resource-bounds.test.ts +0 -231
  513. package/tests/core/rule-host-sqlite-source.test.ts +0 -720
  514. package/tests/core/rule-host-unhealthy-visibility.test.ts +0 -261
  515. package/tests/core/rule-host-validation.test.ts +0 -315
  516. package/tests/core/rule-implementation-runtime.test.ts +0 -49
  517. package/tests/core/session-tracker.test.ts +0 -191
  518. package/tests/core/surface-guard.test.ts +0 -338
  519. package/tests/core/template-generator.test.ts +0 -101
  520. package/tests/core/trajectory.test.ts +0 -427
  521. package/tests/core/workflow-funnel-loader.test.ts +0 -1028
  522. package/tests/core/workspace-context-factory.test.ts +0 -18
  523. package/tests/core/workspace-context.test.ts +0 -187
  524. package/tests/core/workspace-guidance-migrator.test.ts +0 -248
  525. package/tests/core-anti-growth.test.ts +0 -182
  526. package/tests/evolution-worker-quarantine.test.ts +0 -400
  527. package/tests/evolution-worker-slimming.test.ts +0 -380
  528. package/tests/fixtures/legacy-queue-v1.json +0 -74
  529. package/tests/fixtures/production-compatibility.test.ts +0 -147
  530. package/tests/fixtures/production-mock-generator.ts +0 -282
  531. package/tests/globalSetup.ts +0 -38
  532. package/tests/hook-workspace-nextaction-contract.test.ts +0 -50
  533. package/tests/hooks/confirm-first-removal.test.ts +0 -188
  534. package/tests/hooks/gate-auto-correct-shadow.test.ts +0 -309
  535. package/tests/hooks/gate-auto-correct.test.ts +0 -664
  536. package/tests/hooks/gate-block-helper-profile.test.ts +0 -186
  537. package/tests/hooks/gate-no-path-write-tool.test.ts +0 -171
  538. package/tests/hooks/gate-rule-host-pipeline.test.ts +0 -230
  539. package/tests/hooks/gate-rule-host-real-pipeline.test.ts +0 -190
  540. package/tests/hooks/lifecycle.test.ts +0 -248
  541. package/tests/hooks/message-sanitize.test.ts +0 -244
  542. package/tests/hooks/pain-emission-characterization.test.ts +0 -420
  543. package/tests/hooks/pain.test.ts +0 -795
  544. package/tests/hooks/prompt-characterization.test.ts +0 -476
  545. package/tests/hooks/prompt-diet.test.ts +0 -335
  546. package/tests/hooks/prompt-size-guard.test.ts +0 -319
  547. package/tests/hooks/raw-observation-adapter.test.ts +0 -312
  548. package/tests/hooks/runtime-v2-prompt-activation.test.ts +0 -895
  549. package/tests/hooks/single-gate-pain-admission.test.ts +0 -258
  550. package/tests/hooks/subagent.test.ts +0 -469
  551. package/tests/hooks/trajectory-collector.test.ts +0 -269
  552. package/tests/hooks/trajectory-evidence.test.ts +0 -280
  553. package/tests/hooks/triage-adapter.test.ts +0 -331
  554. package/tests/hygiene-tracker.test.ts +0 -77
  555. package/tests/index.test.ts +0 -142
  556. package/tests/integration/auto-entry-gate.test.ts +0 -256
  557. package/tests/integration/gate-real-io.e2e.test.ts +0 -248
  558. package/tests/integration/m8-legacy-paths.test.ts +0 -63
  559. package/tests/integration/mvp-surface-registry-guard.test.ts +0 -536
  560. package/tests/integration/pain-id-chain-e2e.test.ts +0 -313
  561. package/tests/integration/principle-compiler-e2e.test.ts +0 -403
  562. package/tests/integration/principle-lifecycle.e2e.test.ts +0 -198
  563. package/tests/integration/runtime-v2-pain-guard.test.ts +0 -125
  564. package/tests/integration/trajectory-lifecycle.e2e.test.ts +0 -523
  565. package/tests/internalization-auto-consumer-gate.test.ts +0 -158
  566. package/tests/internalization-auto-consumer-service.test.ts +0 -219
  567. package/tests/plugin-config-resolution-cutover.test.ts +0 -359
  568. package/tests/queue/async-lock.test.ts +0 -200
  569. package/tests/runtime-v2-discovery-guard.test.ts +0 -153
  570. package/tests/scripts/validate-live-path.test.ts +0 -286
  571. package/tests/service/central-database.test.ts +0 -457
  572. package/tests/service/correction-observer-service.test.ts +0 -505
  573. package/tests/service/evolution-worker.compilation-backfill.test.ts +0 -203
  574. package/tests/service/evolution-worker.correction-observer.test.ts +0 -50
  575. package/tests/service/evolution-worker.queue.test.ts +0 -296
  576. package/tests/service/evolution-worker.timeout.test.ts +0 -233
  577. package/tests/service/keyword-optimization-service.test.ts +0 -121
  578. package/tests/service/phase3-input-filter.test.ts +0 -289
  579. package/tests/service/queue-io.test.ts +0 -168
  580. package/tests/service/queue-migration.test.ts +0 -147
  581. package/tests/service/runtime-summary-service.test.ts +0 -1100
  582. package/tests/service/workflow-watchdog.test.ts +0 -281
  583. package/tests/task-compliance.test.ts +0 -166
  584. package/tests/test-utils.ts +0 -48
  585. package/tests/utils/file-lock.test.ts +0 -409
  586. package/tests/utils/hashing.test.ts +0 -32
  587. package/tests/utils/hook-workspace-resolver.test.ts +0 -524
  588. package/tests/utils/io.test.ts +0 -39
  589. package/tests/utils/retry.test.ts +0 -327
  590. package/tests/utils/session-key.test.ts +0 -52
  591. package/tsconfig.json +0 -16
  592. package/vitest.config.ts +0 -61
  593. package/vitest.unit.config.ts +0 -12
@@ -0,0 +1,702 @@
1
+ import * as fs from 'fs';
2
+ import * as path from 'path';
3
+ import { createEmptyDailyStats } from '../types/event-types.js';
4
+ import { atomicWriteFileSync } from '../utils/io.js';
5
+ import { redactTelemetryString } from '@principles/core/runtime-v2';
6
+ const EVENT_LOG_RETENTION_DAYS = 7;
7
+ export class EventLog {
8
+ logsDir;
9
+ statsFile;
10
+ logger;
11
+ statsCache = new Map();
12
+ eventBuffer = [];
13
+ maxBufferSize = 20;
14
+ flushIntervalMs = 30000;
15
+ flushTimer;
16
+ currentEventsFile;
17
+ currentDate;
18
+ painScoreSums = new Map();
19
+ constructor(stateDir, logger) {
20
+ this.logsDir = path.join(stateDir, 'logs');
21
+ if (!fs.existsSync(this.logsDir)) {
22
+ fs.mkdirSync(this.logsDir, { recursive: true });
23
+ }
24
+ this.statsFile = path.join(this.logsDir, 'daily-stats.json');
25
+ this.logger = logger;
26
+ this.loadStats();
27
+ this.startFlushTimer();
28
+ }
29
+ getEventsFile(date) {
30
+ return path.join(this.logsDir, `events_${date}.jsonl`);
31
+ }
32
+ getTodayStr() {
33
+ return new Date().toISOString().split('T')[0];
34
+ }
35
+ ensureEventsFile() {
36
+ const today = this.getTodayStr();
37
+ if (this.currentDate !== today || !this.currentEventsFile) {
38
+ this.currentDate = today;
39
+ this.currentEventsFile = this.getEventsFile(today);
40
+ this.cleanupOldEventFiles(today);
41
+ }
42
+ return this.currentEventsFile;
43
+ }
44
+ cleanupOldEventFiles(_today) {
45
+ if (EVENT_LOG_RETENTION_DAYS <= 0)
46
+ return;
47
+ try {
48
+ const cutoffMs = Date.now() - EVENT_LOG_RETENTION_DAYS * 24 * 60 * 60 * 1000;
49
+ const files = fs.readdirSync(this.logsDir);
50
+ for (const file of files) {
51
+ if (!file.startsWith('events_') || !file.endsWith('.jsonl'))
52
+ continue;
53
+ const filePath = path.join(this.logsDir, file);
54
+ const stat = fs.statSync(filePath);
55
+ if (stat.mtimeMs < cutoffMs) {
56
+ fs.unlinkSync(filePath);
57
+ }
58
+ }
59
+ }
60
+ catch (err) {
61
+ this.logger?.debug?.(`[PD] Event file cleanup failed (non-blocking): ${String(err)}`);
62
+ }
63
+ }
64
+ recordToolCall(sessionId, data) {
65
+ const category = data.error || (data.exitCode !== undefined && data.exitCode !== 0) ? 'failure' : 'success';
66
+ this.record('tool_call', category, sessionId, data);
67
+ }
68
+ recordPainSignal(sessionId, data) {
69
+ this.record('pain_signal', 'detected', sessionId, data);
70
+ }
71
+ recordRuleMatch(sessionId, data) {
72
+ this.record('rule_match', 'detected', sessionId, data);
73
+ }
74
+ recordRulePromotion(data) {
75
+ this.record('rule_promotion', 'promoted', undefined, data);
76
+ }
77
+ recordHookExecution(data, opts) {
78
+ const category = data.error ? 'failure' : 'success';
79
+ this.record('hook_execution', category, undefined, data);
80
+ if (opts?.flushImmediately) {
81
+ this.flushEvents();
82
+ }
83
+ }
84
+ recordGateBlock(sessionId, data) {
85
+ this.record('gate_block', 'blocked', sessionId, data);
86
+ }
87
+ recordGateBypass(sessionId, data) {
88
+ this.record('gate_bypass', 'bypassed', sessionId, data);
89
+ }
90
+ recordPlanApproval(sessionId, data) {
91
+ this.record('plan_approval', 'approved', sessionId, data);
92
+ }
93
+ recordEvolutionTask(data) {
94
+ this.record('evolution_task', 'enqueued', undefined, data);
95
+ }
96
+ recordEvolutionTaskCompleted(data) {
97
+ this.record('evolution_task', 'completed', undefined, data);
98
+ }
99
+ recordEmpathyRollback(sessionId, data) {
100
+ this.record('empathy_rollback', 'rolled_back', sessionId, data);
101
+ }
102
+ recordError(sessionId, message, context) {
103
+ this.record('error', 'failure', sessionId, { message, ...context });
104
+ }
105
+ recordWarn(sessionId, message, context) {
106
+ this.record('warn', 'failure', sessionId, { message, ...context });
107
+ }
108
+ recordDiagnosisTask(data) {
109
+ this.record('diagnosis_task', 'written', undefined, data);
110
+ }
111
+ recordHeartbeatDiagnosis(data) {
112
+ this.record('heartbeat_diagnosis', 'injected', undefined, data);
113
+ }
114
+ recordDiagnosticianReport(data) {
115
+ const categoryMap = {
116
+ success: 'completed',
117
+ missing_json: 'failure',
118
+ incomplete_fields: 'failure',
119
+ };
120
+ this.record('diagnostician_report', categoryMap[data.category], undefined, data);
121
+ }
122
+ recordPrincipleCandidate(data) {
123
+ this.record('principle_candidate', 'created', undefined, data);
124
+ }
125
+ recordRuleEnforced(data) {
126
+ this.record('rule_enforced', 'matched', undefined, data);
127
+ }
128
+ recordRuleHostEvaluated(data) {
129
+ this.record('rulehost_evaluated', 'evaluated', undefined, data);
130
+ }
131
+ recordRuleHostBlocked(data) {
132
+ this.record('rulehost_blocked', 'blocked', undefined, data);
133
+ }
134
+ recordRuleHostRequireApproval(data) {
135
+ this.record('rulehost_requireApproval', 'requireApproval', undefined, data);
136
+ }
137
+ recordRuleHostAutoCorrectProposed(data) {
138
+ this.record('rulehost_auto_correct_proposed', 'auto_correct', undefined, data);
139
+ }
140
+ recordRuleHostAutoCorrectApplied(data) {
141
+ this.record('rulehost_auto_correct_applied', 'auto_correct', undefined, data);
142
+ }
143
+ recordRuntimeV2ActivationsInjected(data) {
144
+ this.record('runtime_v2_prompt_activations_injected', 'injected', data.sessionId, data);
145
+ }
146
+ /**
147
+ * PRI-437: Record that an approved rule failed to compile or load.
148
+ *
149
+ * This is NOT just a logger.warn — the unhealthy state is persisted to EventLog
150
+ * so it's visible to CLI (pd runtime health) and Console API.
151
+ *
152
+ * ERR-002: degradation includes a reason and nextAction (not silent).
153
+ */
154
+ recordRuleHostUnhealthy(data) {
155
+ this.record('rulehost_unhealthy', 'failure', undefined, data);
156
+ }
157
+ /**
158
+ * Redact telemetry-sensitive string values in event data before persistence.
159
+ * Applies redactTelemetryString to known high-risk fields (filePath, command,
160
+ * reason, args, new_string, old_string, text, paramsSummary values) and to all
161
+ * string values in tool_call/rulehost_* data as a safety net.
162
+ *
163
+ * ERR-002: never throws; returns data unchanged on error.
164
+ * ERR-045/046: covers composite command strings, Authorization headers, env vars.
165
+ */
166
+ redactEventData(type, data) {
167
+ try {
168
+ // Known high-risk event types — telemetry that carries tool commands / paths
169
+ const telemetryTypes = new Set([
170
+ 'tool_call',
171
+ 'rulehost_evaluated',
172
+ 'rulehost_blocked',
173
+ 'rulehost_requireApproval',
174
+ 'rulehost_auto_correct_proposed',
175
+ 'rulehost_auto_correct_applied',
176
+ 'rule_enforced',
177
+ 'hook_execution',
178
+ 'gate_block',
179
+ 'gate_bypass',
180
+ ]);
181
+ if (!telemetryTypes.has(type))
182
+ return data;
183
+ const redacted = {};
184
+ for (const [key, value] of Object.entries(data)) {
185
+ if (typeof value === 'string') {
186
+ redacted[key] = redactTelemetryString(value);
187
+ }
188
+ else if (Array.isArray(value)) {
189
+ // Recurse into arrays (e.g. correctedFields with original/applied)
190
+ redacted[key] = value.map((item) => {
191
+ if (typeof item === 'string') {
192
+ return redactTelemetryString(item);
193
+ }
194
+ if (typeof item === 'object' && item !== null) {
195
+ const nested = {};
196
+ for (const [nk, nv] of Object.entries(item)) {
197
+ nested[nk] = typeof nv === 'string' ? redactTelemetryString(nv) : nv;
198
+ }
199
+ return nested;
200
+ }
201
+ return item;
202
+ });
203
+ }
204
+ else if (typeof value === 'object' && value !== null) {
205
+ // Recurse one level for nested objects (e.g. paramsSummary)
206
+ const nested = {};
207
+ for (const [nk, nv] of Object.entries(value)) {
208
+ if (typeof nv === 'string') {
209
+ nested[nk] = redactTelemetryString(nv);
210
+ }
211
+ else {
212
+ nested[nk] = nv;
213
+ }
214
+ }
215
+ redacted[key] = nested;
216
+ }
217
+ else {
218
+ redacted[key] = value;
219
+ }
220
+ }
221
+ return redacted;
222
+ }
223
+ catch (e) {
224
+ // ERR-002: fail safe — never write raw payload on redaction failure.
225
+ // Return a masked payload with context so downstream knows what happened.
226
+ const errStr = e instanceof Error ? e.message.slice(0, 200) : String(e).slice(0, 200);
227
+ const masked = {
228
+ redactionFailure: true,
229
+ redactionStatus: 'failed',
230
+ 'redaction.status': 'failed',
231
+ redactionReason: errStr || 'unknown error',
232
+ redactionDataDropped: true,
233
+ originalType: type,
234
+ originalSessionId: data.sessionId ?? null,
235
+ };
236
+ return masked;
237
+ }
238
+ }
239
+ record(type, category, sessionId, data) {
240
+ const now = new Date();
241
+ const date = this.formatDate(now);
242
+ const redactedData = this.redactEventData(type, data);
243
+ const entry = {
244
+ ts: now.toISOString(),
245
+ date,
246
+ type,
247
+ category,
248
+ sessionId,
249
+ data: redactedData,
250
+ };
251
+ this.eventBuffer.push(entry);
252
+ this.updateStats(entry);
253
+ if (this.eventBuffer.length >= this.maxBufferSize) {
254
+ this.flushEvents();
255
+ }
256
+ }
257
+ formatDate(date) {
258
+ return date.toISOString().split('T')[0];
259
+ }
260
+ loadStats() {
261
+ if (fs.existsSync(this.statsFile)) {
262
+ try {
263
+ const data = JSON.parse(fs.readFileSync(this.statsFile, 'utf-8'));
264
+ for (const date in data) {
265
+ this.statsCache.set(date, data[date]);
266
+ }
267
+ }
268
+ catch (e) {
269
+ if (this.logger)
270
+ this.logger.error(`[PD] Failed to load daily-stats.json: ${String(e)}`);
271
+ }
272
+ }
273
+ }
274
+ updateStats(entry) {
275
+ let stats = this.statsCache.get(entry.date);
276
+ if (!stats) {
277
+ stats = createEmptyDailyStats(entry.date);
278
+ this.statsCache.set(entry.date, stats);
279
+ }
280
+ if (entry.type === 'tool_call') {
281
+ stats.tools.total++;
282
+ if (entry.category === 'success')
283
+ stats.tools.success++;
284
+ else
285
+ stats.tools.failure++;
286
+ const tcData = entry.data;
287
+ const observedGfi = tcData.gfiAfter ?? tcData.gfi;
288
+ if (observedGfi !== undefined) {
289
+ stats.gfi.samples++;
290
+ stats.gfi.total += observedGfi;
291
+ stats.gfi.peak = Math.max(stats.gfi.peak, observedGfi);
292
+ }
293
+ }
294
+ else if (entry.type === 'pain_signal') {
295
+ const data = entry.data;
296
+ stats.pain.signalsDetected++;
297
+ stats.pain.maxScore = Math.max(stats.pain.maxScore, data.score);
298
+ if (data.source) {
299
+ stats.pain.signalsBySource[data.source] = (stats.pain.signalsBySource[data.source] || 0) + 1;
300
+ }
301
+ const currentSum = this.painScoreSums.get(entry.date) ?? 0;
302
+ this.painScoreSums.set(entry.date, currentSum + (data.score || 0));
303
+ stats.pain.avgScore = stats.pain.signalsDetected > 0
304
+ ? Math.round((currentSum + (data.score || 0)) / stats.pain.signalsDetected)
305
+ : 0;
306
+ if (data.source === 'user_empathy') {
307
+ if (data.deduped) {
308
+ stats.empathy.dedupedCount++;
309
+ }
310
+ else {
311
+ stats.empathy.totalEvents++;
312
+ stats.empathy.totalPenaltyScore += data.score || 0;
313
+ if (data.severity) {
314
+ stats.empathy.bySeverity[data.severity]++;
315
+ stats.empathy.scoreBySeverity[data.severity] += data.score || 0;
316
+ }
317
+ if (data.detection_mode) {
318
+ stats.empathy.byDetectionMode[data.detection_mode]++;
319
+ }
320
+ if (data.origin) {
321
+ stats.empathy.byOrigin[data.origin]++;
322
+ }
323
+ const conf = data.confidence ?? 1;
324
+ if (conf >= 0.8)
325
+ stats.empathy.confidenceDistribution.high++;
326
+ else if (conf >= 0.5)
327
+ stats.empathy.confidenceDistribution.medium++;
328
+ else
329
+ stats.empathy.confidenceDistribution.low++;
330
+ }
331
+ const total = stats.empathy.totalEvents + stats.empathy.dedupedCount;
332
+ stats.empathy.dedupeHitRate = total > 0 ? stats.empathy.dedupedCount / total : 0;
333
+ }
334
+ }
335
+ else if (entry.type === 'hook_execution') {
336
+ const data = entry.data;
337
+ stats.hooks.total++;
338
+ if (entry.category === 'success')
339
+ stats.hooks.success++;
340
+ else
341
+ stats.hooks.failure++;
342
+ if (data.hook) {
343
+ if (!stats.hooks.byType[data.hook]) {
344
+ stats.hooks.byType[data.hook] = { total: 0, success: 0, failure: 0 };
345
+ }
346
+ stats.hooks.byType[data.hook].total++;
347
+ if (entry.category === 'success')
348
+ stats.hooks.byType[data.hook].success++;
349
+ else
350
+ stats.hooks.byType[data.hook].failure++;
351
+ }
352
+ }
353
+ else if (entry.type === 'empathy_rollback') {
354
+ const data = entry.data;
355
+ stats.empathy.rollbackCount++;
356
+ stats.empathy.rolledBackScore += data.originalScore || 0;
357
+ }
358
+ else if (entry.type === 'rule_match') {
359
+ const data = entry.data;
360
+ if (data.ruleId) {
361
+ stats.pain.rulesMatched[data.ruleId] = (stats.pain.rulesMatched[data.ruleId] || 0) + 1;
362
+ }
363
+ }
364
+ else if (entry.type === 'rule_promotion') {
365
+ stats.pain.candidatesPromoted++;
366
+ stats.evolution.rulesPromoted++;
367
+ }
368
+ else if (entry.type === 'evolution_task') {
369
+ if (entry.category === 'completed') {
370
+ stats.evolution.tasksCompleted++;
371
+ }
372
+ else if (entry.category === 'enqueued') {
373
+ stats.evolution.tasksEnqueued++;
374
+ }
375
+ }
376
+ else if (entry.type === 'diagnosis_task') {
377
+ stats.evolution.diagnosisTasksWritten++;
378
+ }
379
+ else if (entry.type === 'heartbeat_diagnosis') {
380
+ stats.evolution.heartbeatsInjected++;
381
+ }
382
+ else if (entry.type === 'diagnostician_report') {
383
+ const raw = entry.data;
384
+ if (Object.prototype.hasOwnProperty.call(raw, 'category')) {
385
+ const cat = raw['category'];
386
+ if (cat === 'success' || cat === 'missing_json' || cat === 'incomplete_fields') {
387
+ stats.evolution.diagnosticianReportsWritten++;
388
+ }
389
+ if (cat === 'missing_json') {
390
+ stats.evolution.reportsMissingJson++;
391
+ }
392
+ if (cat === 'incomplete_fields') {
393
+ stats.evolution.reportsIncompleteFields++;
394
+ }
395
+ }
396
+ else if (Object.prototype.hasOwnProperty.call(raw, 'success')) {
397
+ stats.evolution.diagnosticianReportsWritten++;
398
+ }
399
+ }
400
+ else if (entry.type === 'principle_candidate') {
401
+ stats.evolution.principleCandidatesCreated++;
402
+ }
403
+ else if (entry.type === 'rule_enforced') {
404
+ stats.evolution.rulesEnforced++;
405
+ }
406
+ else if (entry.type === 'rulehost_evaluated') {
407
+ stats.evolution.rulehostEvaluated++;
408
+ }
409
+ else if (entry.type === 'rulehost_blocked') {
410
+ stats.evolution.rulehostBlocked++;
411
+ }
412
+ else if (entry.type === 'rulehost_requireApproval') {
413
+ stats.evolution.rulehostRequireApproval++;
414
+ }
415
+ else if (entry.type === 'rulehost_auto_correct_proposed') {
416
+ stats.evolution.rulehostAutoCorrectProposed++;
417
+ }
418
+ else if (entry.type === 'rulehost_auto_correct_applied') {
419
+ stats.evolution.rulehostAutoCorrectApplied++;
420
+ }
421
+ }
422
+ startFlushTimer() {
423
+ this.flushTimer = setInterval(() => this.flush(), this.flushIntervalMs);
424
+ this.flushTimer.unref();
425
+ }
426
+ flush() {
427
+ this.flushEvents();
428
+ this.flushStats();
429
+ }
430
+ getBufferedEvents() {
431
+ return this.eventBuffer.map((entry) => ({ ...entry, data: { ...entry.data } }));
432
+ }
433
+ getEventDedupKey(entry) {
434
+ const eventId = typeof entry.data?.eventId === 'string'
435
+ ? String(entry.data.eventId)
436
+ : null;
437
+ if (eventId) {
438
+ return `${entry.type}:${entry.sessionId ?? 'none'}:${eventId}`;
439
+ }
440
+ const data = entry.data ?? {};
441
+ return [
442
+ entry.ts ?? 'no-ts',
443
+ entry.type ?? 'no-type',
444
+ entry.category ?? 'no-category',
445
+ entry.sessionId ?? 'no-session',
446
+ typeof data.source === 'string' ? data.source : 'no-source',
447
+ typeof data.toolName === 'string' ? data.toolName : 'no-tool',
448
+ typeof data.reason === 'string' ? data.reason : 'no-reason',
449
+ ].join('::');
450
+ }
451
+ readPersistedEvents() {
452
+ const eventsFile = this.ensureEventsFile();
453
+ if (!fs.existsSync(eventsFile))
454
+ return [];
455
+ try {
456
+ const content = fs.readFileSync(eventsFile, 'utf-8');
457
+ return content
458
+ .trim()
459
+ .split('\n')
460
+ .filter((line) => line.trim().length > 0)
461
+ .map((line) => {
462
+ try {
463
+ return JSON.parse(line);
464
+ }
465
+ catch (err) {
466
+ this.logger?.warn?.(`[PD] Corrupted event line skipped: ${String(err).slice(0, 100)}`);
467
+ return null;
468
+ }
469
+ })
470
+ .filter((entry) => entry !== null);
471
+ }
472
+ catch (e) {
473
+ if (this.logger)
474
+ this.logger.error(`[PD] Failed to read events file: ${String(e)}`);
475
+ return [];
476
+ }
477
+ }
478
+ getMergedEvents() {
479
+ const merged = new Map();
480
+ for (const entry of [...this.readPersistedEvents(), ...this.getBufferedEvents()]) {
481
+ merged.set(this.getEventDedupKey(entry), entry);
482
+ }
483
+ return [...merged.values()].sort((a, b) => a.ts.localeCompare(b.ts));
484
+ }
485
+ flushEvents() {
486
+ if (this.eventBuffer.length === 0)
487
+ return;
488
+ const eventsFile = this.ensureEventsFile();
489
+ const lines = this.eventBuffer.map(e => JSON.stringify(e)).join('\n') + '\n';
490
+ try {
491
+ fs.appendFileSync(eventsFile, lines, 'utf-8');
492
+ this.eventBuffer = [];
493
+ }
494
+ catch (e) {
495
+ if (this.logger)
496
+ this.logger.error(`[PD] Failed to flush events: ${String(e)}`);
497
+ }
498
+ }
499
+ flushStats() {
500
+ if (this.statsCache.size === 0)
501
+ return;
502
+ const data = {};
503
+ this.statsCache.forEach((stats, date) => {
504
+ data[date] = stats;
505
+ });
506
+ try {
507
+ atomicWriteFileSync(this.statsFile, JSON.stringify(data, null, 2));
508
+ }
509
+ catch (e) {
510
+ if (this.logger)
511
+ this.logger.error(`[PD] Failed to flush daily-stats.json: ${String(e)}`);
512
+ }
513
+ }
514
+ getDailyStats(date) {
515
+ let stats = this.statsCache.get(date);
516
+ if (!stats) {
517
+ stats = createEmptyDailyStats(date);
518
+ this.statsCache.set(date, stats);
519
+ }
520
+ return stats;
521
+ }
522
+ getEmpathyStats(range, sessionId) {
523
+ const now = new Date();
524
+ const today = this.formatDate(now);
525
+ const result = {
526
+ totalEvents: 0,
527
+ dedupedCount: 0,
528
+ dedupeHitRate: 0,
529
+ totalPenaltyScore: 0,
530
+ rolledBackScore: 0,
531
+ rollbackCount: 0,
532
+ bySeverity: { mild: 0, moderate: 0, severe: 0 },
533
+ scoreBySeverity: { mild: 0, moderate: 0, severe: 0 },
534
+ byDetectionMode: { structured: 0, legacy_tag: 0 },
535
+ byOrigin: { assistant_self_report: 0, user_manual: 0, system_infer: 0 },
536
+ confidenceDistribution: { high: 0, medium: 0, low: 0 },
537
+ dailyTrend: [],
538
+ };
539
+ if (range === 'session' && sessionId) {
540
+ this.aggregateSessionEmpathy(sessionId, result);
541
+ }
542
+ else if (range === 'week') {
543
+ for (let i = 0; i < 7; i++) {
544
+ const date = new Date(now);
545
+ date.setDate(date.getDate() - i);
546
+ const dateStr = this.formatDate(date);
547
+ const stats = this.getDailyStats(dateStr);
548
+ result.totalEvents += stats.empathy.totalEvents;
549
+ result.dedupedCount += stats.empathy.dedupedCount;
550
+ result.totalPenaltyScore += stats.empathy.totalPenaltyScore;
551
+ result.rolledBackScore += stats.empathy.rolledBackScore;
552
+ result.rollbackCount += stats.empathy.rollbackCount;
553
+ for (const sev of ['mild', 'moderate', 'severe']) {
554
+ result.bySeverity[sev] += stats.empathy.bySeverity[sev];
555
+ result.scoreBySeverity[sev] += stats.empathy.scoreBySeverity[sev];
556
+ }
557
+ result.byDetectionMode.structured += stats.empathy.byDetectionMode.structured;
558
+ result.byDetectionMode.legacy_tag += stats.empathy.byDetectionMode.legacy_tag;
559
+ for (const org of ['assistant_self_report', 'user_manual', 'system_infer']) {
560
+ result.byOrigin[org] += stats.empathy.byOrigin[org];
561
+ }
562
+ result.confidenceDistribution.high += stats.empathy.confidenceDistribution.high;
563
+ result.confidenceDistribution.medium += stats.empathy.confidenceDistribution.medium;
564
+ result.confidenceDistribution.low += stats.empathy.confidenceDistribution.low;
565
+ if (stats.empathy.totalEvents > 0 || stats.empathy.dedupedCount > 0) {
566
+ result.dailyTrend.push({
567
+ date: dateStr,
568
+ count: stats.empathy.totalEvents,
569
+ score: stats.empathy.totalPenaltyScore,
570
+ });
571
+ }
572
+ }
573
+ }
574
+ else {
575
+ const stats = this.getDailyStats(today);
576
+ Object.assign(result, stats.empathy);
577
+ if (stats.empathy.totalEvents > 0 || stats.empathy.dedupedCount > 0) {
578
+ result.dailyTrend = [{
579
+ date: today,
580
+ count: stats.empathy.totalEvents,
581
+ score: stats.empathy.totalPenaltyScore,
582
+ }];
583
+ }
584
+ }
585
+ const total = result.totalEvents + result.dedupedCount;
586
+ result.dedupeHitRate = total > 0 ? result.dedupedCount / total : 0;
587
+ return result;
588
+ }
589
+ aggregateSessionEmpathy(sessionId, result) {
590
+ for (const entry of this.getMergedEvents()) {
591
+ if (entry.sessionId === sessionId && entry.type === 'pain_signal') {
592
+ const data = entry.data;
593
+ if (data.source === 'user_empathy') {
594
+ if (data.deduped) {
595
+ result.dedupedCount++;
596
+ }
597
+ else {
598
+ result.totalEvents++;
599
+ result.totalPenaltyScore += data.score || 0;
600
+ if (data.severity) {
601
+ result.bySeverity[data.severity]++;
602
+ result.scoreBySeverity[data.severity] += data.score || 0;
603
+ }
604
+ if (data.detection_mode)
605
+ result.byDetectionMode[data.detection_mode]++;
606
+ if (data.origin)
607
+ result.byOrigin[data.origin]++;
608
+ const conf = data.confidence ?? 1;
609
+ if (conf >= 0.8)
610
+ result.confidenceDistribution.high++;
611
+ else if (conf >= 0.5)
612
+ result.confidenceDistribution.medium++;
613
+ else
614
+ result.confidenceDistribution.low++;
615
+ }
616
+ }
617
+ }
618
+ else if (entry.sessionId === sessionId && entry.type === 'empathy_rollback') {
619
+ const data = entry.data;
620
+ result.rollbackCount++;
621
+ result.rolledBackScore += data.originalScore || 0;
622
+ }
623
+ }
624
+ }
625
+ rollbackEmpathyEvent(eventId, sessionId, reason, triggeredBy) {
626
+ const allEvents = this.getMergedEvents();
627
+ let foundEvent = null;
628
+ for (const entry of allEvents) {
629
+ if (entry.type === 'pain_signal') {
630
+ const data = entry.data;
631
+ if (data.eventId === eventId && data.source === 'user_empathy') {
632
+ foundEvent = { entry, data };
633
+ break;
634
+ }
635
+ }
636
+ }
637
+ if (!foundEvent || foundEvent.data.deduped) {
638
+ return 0;
639
+ }
640
+ const originalScore = foundEvent.data.score || 0;
641
+ this.recordEmpathyRollback(sessionId, {
642
+ eventId,
643
+ originalScore,
644
+ originalSessionId: foundEvent.entry.sessionId,
645
+ reason,
646
+ triggeredBy,
647
+ });
648
+ return originalScore;
649
+ }
650
+ getLastEmpathyEventId(sessionId) {
651
+ const allEvents = this.getMergedEvents();
652
+ for (let i = allEvents.length - 1; i >= 0; i--) {
653
+ const entry = allEvents[i];
654
+ if (entry.sessionId === sessionId && entry.type === 'pain_signal') {
655
+ const data = entry.data;
656
+ if (data.source === 'user_empathy' && !data.deduped) {
657
+ return data.eventId || null;
658
+ }
659
+ }
660
+ }
661
+ return null;
662
+ }
663
+ findLatestPainSignal(sessionId) {
664
+ const allEvents = this.getMergedEvents();
665
+ for (let i = allEvents.length - 1; i >= 0; i--) {
666
+ const entry = allEvents[i];
667
+ if (entry.sessionId === sessionId && entry.type === "pain_signal") {
668
+ return entry.data;
669
+ }
670
+ }
671
+ return null;
672
+ }
673
+ dispose() {
674
+ if (this.flushTimer) {
675
+ clearInterval(this.flushTimer);
676
+ this.flushTimer = undefined;
677
+ }
678
+ this.flush();
679
+ }
680
+ }
681
+ export class EventLogService {
682
+ static instances = new Map();
683
+ static get(stateDir, logger) {
684
+ let instance = this.instances.get(stateDir);
685
+ if (!instance) {
686
+ instance = new EventLog(stateDir, logger);
687
+ this.instances.set(stateDir, instance);
688
+ }
689
+ return instance;
690
+ }
691
+ static flushAll() {
692
+ for (const instance of this.instances.values()) {
693
+ instance.flush();
694
+ }
695
+ }
696
+ static disposeAll() {
697
+ for (const instance of this.instances.values()) {
698
+ instance.dispose();
699
+ }
700
+ this.instances.clear();
701
+ }
702
+ }