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,57 @@
1
+ /**
2
+ * Raw Observation Adapter — PRI-362
3
+ *
4
+ * Unified source-kind resolution from RawObservation.
5
+ *
6
+ * Replaces scattered resolveSourceKindFrom* functions with a single
7
+ * field-driven adapter that maps observation fields to SourceKind.
8
+ *
9
+ * Field precedence (highest to lowest):
10
+ * 1. isManualEntry → owner_reported
11
+ * 2. isGateBlock → rulehost_block
12
+ * 3. isSubagentError → subagent_error
13
+ * 4. isRateLimit → rate_limit (if true)
14
+ * 5. toolName === 'pain' / 'skill:pain' → agent_on_owner_request (with openclaw_context_bound) / owner_reported
15
+ * 6. failureSource → tool_failure / dispatch_error
16
+ * 7. isGfiTriggered → gfi_threshold
17
+ * 8. detectionSource → llm_paralysis / semantic / empathy_inferred / unknown
18
+ * 9. Fallback → unknown
19
+ *
20
+ * ERR checklist:
21
+ * - ERR-001: Source kind resolved from runtime values, no `as` casts.
22
+ * - ERR-002: Every path returns a valid SourceKind (fallback to 'unknown').
23
+ * - EP-01: Runtime values validated before use.
24
+ */
25
+ import type { SourceKind } from '@principles/core/runtime-v2';
26
+ import type { RawObservation } from './raw-observation-types.js';
27
+ export type { RawObservation } from './raw-observation-types.js';
28
+ /**
29
+ * Resolve SourceKind from a unified RawObservation.
30
+ *
31
+ * This function replaces the scattered resolveSourceKindFrom* functions
32
+ * and provides a single entry point for source-kind classification.
33
+ *
34
+ * Field precedence is explicitly defined in the function body to ensure
35
+ * deterministic behavior and make the logic easy to understand and test.
36
+ */
37
+ export declare function resolveSourceKind(observation: RawObservation): SourceKind;
38
+ /**
39
+ * Build a RawObservation for a tool failure context.
40
+ *
41
+ * This replaces classifyToolFailureSource and the inline classification
42
+ * in after-tool-call-helpers. All tool error → dispatch/tool_failure
43
+ * classification is centralized here.
44
+ */
45
+ export declare function buildToolFailureObservation(options: {
46
+ toolName: string | undefined;
47
+ error: unknown;
48
+ exitCode?: number;
49
+ provenance?: RawObservation['provenance'];
50
+ }): RawObservation;
51
+ /**
52
+ * Build a RawObservation for an LLM detection context.
53
+ */
54
+ export declare function buildLlmDetectionObservation(options: {
55
+ detectionSource: string;
56
+ isGfiTriggered: boolean;
57
+ }): RawObservation;
@@ -0,0 +1,170 @@
1
+ /**
2
+ * Raw Observation Adapter — PRI-362
3
+ *
4
+ * Unified source-kind resolution from RawObservation.
5
+ *
6
+ * Replaces scattered resolveSourceKindFrom* functions with a single
7
+ * field-driven adapter that maps observation fields to SourceKind.
8
+ *
9
+ * Field precedence (highest to lowest):
10
+ * 1. isManualEntry → owner_reported
11
+ * 2. isGateBlock → rulehost_block
12
+ * 3. isSubagentError → subagent_error
13
+ * 4. isRateLimit → rate_limit (if true)
14
+ * 5. toolName === 'pain' / 'skill:pain' → agent_on_owner_request (with openclaw_context_bound) / owner_reported
15
+ * 6. failureSource → tool_failure / dispatch_error
16
+ * 7. isGfiTriggered → gfi_threshold
17
+ * 8. detectionSource → llm_paralysis / semantic / empathy_inferred / unknown
18
+ * 9. Fallback → unknown
19
+ *
20
+ * ERR checklist:
21
+ * - ERR-001: Source kind resolved from runtime values, no `as` casts.
22
+ * - ERR-002: Every path returns a valid SourceKind (fallback to 'unknown').
23
+ * - EP-01: Runtime values validated before use.
24
+ */
25
+ /**
26
+ * Resolve SourceKind from a unified RawObservation.
27
+ *
28
+ * This function replaces the scattered resolveSourceKindFrom* functions
29
+ * and provides a single entry point for source-kind classification.
30
+ *
31
+ * Field precedence is explicitly defined in the function body to ensure
32
+ * deterministic behavior and make the logic easy to understand and test.
33
+ */
34
+ export function resolveSourceKind(observation) {
35
+ const { isManualEntry, isGateBlock, isSubagentError, isRateLimit, toolName, failureSource, isGfiTriggered, detectionSource, nonZeroExit, timedOut, toolNotFound, } = observation;
36
+ // Priority 1: Manual entry (CLI, owner-reported)
37
+ if (isManualEntry) {
38
+ return 'owner_reported';
39
+ }
40
+ // Priority 2: Gate block
41
+ if (isGateBlock) {
42
+ return 'rulehost_block';
43
+ }
44
+ // Priority 3: Subagent error
45
+ if (isSubagentError) {
46
+ return 'subagent_error';
47
+ }
48
+ // Priority 4: Provider rate limit (explicit true/false)
49
+ if (isRateLimit === true) {
50
+ return 'rate_limit';
51
+ }
52
+ if (isRateLimit === false) {
53
+ return 'provider_failure';
54
+ }
55
+ // Priority 5: Manual pain tool
56
+ if (toolName === 'pain' || toolName === 'skill:pain') {
57
+ // Match resolveSourceKindFromToolFailure behavior:
58
+ // openclaw_context_bound → agent_on_owner_request
59
+ // other provenance or undefined → owner_reported
60
+ if (observation.provenance === 'openclaw_context_bound') {
61
+ return 'agent_on_owner_request';
62
+ }
63
+ return 'owner_reported';
64
+ }
65
+ // Priority 6: GFI threshold (must check before failure source for LLM detection path)
66
+ if (isGfiTriggered) {
67
+ return 'gfi_threshold';
68
+ }
69
+ // Priority 7: Tool failure / dispatch error
70
+ if (failureSource) {
71
+ // Match resolveSourceKindFromToolFailure behavior:
72
+ // dispatch_error → dispatch_error, anything else → tool_failure
73
+ if (failureSource === 'dispatch_error') {
74
+ return 'dispatch_error';
75
+ }
76
+ return 'tool_failure';
77
+ }
78
+ // Infer failureSource from tool failure indicators if not explicitly set
79
+ if (toolNotFound) {
80
+ return 'dispatch_error';
81
+ }
82
+ // Match classifyToolFailureSource behavior: unknown tool name → dispatch_error
83
+ // BUT only if this looks like a tool failure context (has other tool fields)
84
+ // Otherwise, this is likely a non-tool observation (e.g., LLM detection)
85
+ const hasToolContext = toolName !== undefined || nonZeroExit || timedOut || toolNotFound;
86
+ if (hasToolContext && (!toolName || toolName.trim() === '')) {
87
+ return 'dispatch_error';
88
+ }
89
+ // Exit code-based detection: non-zero exit or timeout → tool_failure
90
+ if (nonZeroExit || timedOut) {
91
+ return 'tool_failure';
92
+ }
93
+ // Priority 8: LLM detection source
94
+ if (detectionSource) {
95
+ // Match resolveSourceKindFromLlmDetection behavior:
96
+ if (detectionSource === 'llm_paralysis') {
97
+ return 'llm_paralysis';
98
+ }
99
+ if (detectionSource.startsWith('llm_')) {
100
+ return 'semantic';
101
+ }
102
+ if (detectionSource === 'user_empathy') {
103
+ return 'empathy_inferred';
104
+ }
105
+ }
106
+ // Fallback: unknown
107
+ return 'unknown';
108
+ }
109
+ // ── Builder Functions ──────────────────────────────────────────────────────
110
+ //
111
+ // PRI-360 S1: These builders construct RawObservation from specific contexts,
112
+ // centralizing source classification rules in the adapter layer.
113
+ // Hooks should NOT hold source classification logic — use these builders.
114
+ /**
115
+ * Classify error message as dispatch_error vs tool_failure.
116
+ *
117
+ * This centralizes the regex-based classification that was previously
118
+ * scattered in classifyToolFailureSource and after-tool-call-helpers.
119
+ * Now hooks call this builder + resolveSourceKind instead of holding rules.
120
+ */
121
+ function classifyErrorForDispatch(error) {
122
+ if (!error)
123
+ return 'tool_failure';
124
+ const msg = String(error);
125
+ if (/\btool\s+(?:\S+\s+)?not\s+found\b/i.test(msg) || /\bunknown\s+tool\b/i.test(msg)) {
126
+ return 'dispatch_error';
127
+ }
128
+ return 'tool_failure';
129
+ }
130
+ /**
131
+ * Build a RawObservation for a tool failure context.
132
+ *
133
+ * This replaces classifyToolFailureSource and the inline classification
134
+ * in after-tool-call-helpers. All tool error → dispatch/tool_failure
135
+ * classification is centralized here.
136
+ */
137
+ export function buildToolFailureObservation(options) {
138
+ const { toolName, error, provenance } = options;
139
+ const nonZeroExit = typeof options.exitCode === 'number' && options.exitCode !== 0;
140
+ // Classify dispatch vs tool_failure centrally
141
+ let failureSource;
142
+ if (!toolName || toolName.trim() === '') {
143
+ // Empty/whitespace tool name → dispatch error
144
+ failureSource = 'dispatch_error';
145
+ }
146
+ else {
147
+ failureSource = classifyErrorForDispatch(error);
148
+ }
149
+ // If neither error nor non-zero exit, this is not a failure context
150
+ if (!error && !nonZeroExit) {
151
+ failureSource = undefined;
152
+ }
153
+ return {
154
+ observedAt: new Date().toISOString(),
155
+ toolName,
156
+ failureSource,
157
+ nonZeroExit,
158
+ provenance,
159
+ };
160
+ }
161
+ /**
162
+ * Build a RawObservation for an LLM detection context.
163
+ */
164
+ export function buildLlmDetectionObservation(options) {
165
+ return {
166
+ observedAt: new Date().toISOString(),
167
+ detectionSource: options.detectionSource,
168
+ isGfiTriggered: options.isGfiTriggered,
169
+ };
170
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * Raw Observation Types — PRI-362
3
+ *
4
+ * Source adapter layer that normalizes diverse hook contexts into a unified
5
+ * observation model before mapping to SourceKind.
6
+ *
7
+ * This replaces scattered resolveSourceKindFrom* functions with a single
8
+ * field-driven adapter.
9
+ *
10
+ * ERR checklist:
11
+ * - ERR-001: No `as` casts; validate unknown payload field-by-field.
12
+ * - ERR-002: Every decision carries reason + nextAction.
13
+ * - EP-01: Source adapter validates before use.
14
+ */
15
+ /**
16
+ * Raw observation from a source adapter.
17
+ *
18
+ * This is the input to resolveSourceKind. It contains all possible
19
+ * context fields that different sources may provide. The adapter
20
+ * reads only the fields it needs based on the observation source.
21
+ */
22
+ export interface RawObservation {
23
+ /** When the observation was made (ISO timestamp) */
24
+ readonly observedAt: string;
25
+ /** Workspace identifier */
26
+ readonly workspaceId?: string;
27
+ /** Session identifier */
28
+ readonly sessionId?: string;
29
+ /** Trace identifier for correlation */
30
+ readonly traceId?: string;
31
+ /** Tool name (for after_tool_call hook) */
32
+ readonly toolName?: string;
33
+ /** Failure source classification */
34
+ readonly failureSource?: 'tool_failure' | 'dispatch_error';
35
+ /** Whether the tool call exited with non-zero code */
36
+ readonly nonZeroExit?: boolean;
37
+ /** Whether the tool call timed out */
38
+ readonly timedOut?: boolean;
39
+ /** Whether the tool does not exist */
40
+ readonly toolNotFound?: boolean;
41
+ /** Detection source identifier */
42
+ readonly detectionSource?: string;
43
+ /** Whether GFI threshold was crossed */
44
+ readonly isGfiTriggered?: boolean;
45
+ /** Whether the failure was a rate limit (429) */
46
+ readonly isRateLimit?: boolean;
47
+ /** Whether this observation came from a gate block */
48
+ readonly isGateBlock?: boolean;
49
+ /** Whether this was a manual CLI entry */
50
+ readonly isManualEntry?: boolean;
51
+ /** Provenance: how trustworthy and context-bound is the observation */
52
+ readonly provenance?: 'openclaw_context_bound' | 'owner_reported_no_host_trace' | 'automatic_hook';
53
+ /** Whether this observation came from a subagent error */
54
+ readonly isSubagentError?: boolean;
55
+ /**
56
+ * Raw payload from the source.
57
+ *
58
+ * This is always `unknown` (ERR-005). Source adapters validate only
59
+ * enough to identify the source and capture bounded context.
60
+ */
61
+ readonly payload?: unknown;
62
+ }
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Raw Observation Types — PRI-362
3
+ *
4
+ * Source adapter layer that normalizes diverse hook contexts into a unified
5
+ * observation model before mapping to SourceKind.
6
+ *
7
+ * This replaces scattered resolveSourceKindFrom* functions with a single
8
+ * field-driven adapter.
9
+ *
10
+ * ERR checklist:
11
+ * - ERR-001: No `as` casts; validate unknown payload field-by-field.
12
+ * - ERR-002: Every decision carries reason + nextAction.
13
+ * - EP-01: Source adapter validates before use.
14
+ */
15
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { PluginHookSubagentEndedEvent, PluginHookSubagentContext, OpenClawPluginApi } from '../openclaw-sdk.js';
2
+ type SubagentEndedHookContext = PluginHookSubagentContext & {
3
+ api?: OpenClawPluginApi;
4
+ workspaceDir?: string;
5
+ sessionId?: string;
6
+ agentId?: string;
7
+ };
8
+ export declare function handleSubagentEnded(event: PluginHookSubagentEndedEvent, ctx: SubagentEndedHookContext): Promise<void>;
9
+ export {};
@@ -1,42 +1,20 @@
1
- import type { PluginHookSubagentEndedEvent, PluginHookSubagentContext, PluginLogger, OpenClawPluginApi } from '../openclaw-sdk.js';
2
1
  import { WorkspaceContext } from '../core/workspace-context.js';
3
2
  import { extractAgentIdFromSessionKey } from '../utils/session-key.js';
4
3
  import { recordEvolutionSuccess } from '../core/evolution-engine.js';
5
4
  import { WorkflowStore } from '../service/subagent-workflow/workflow-store.js';
6
- import type { WorkflowManager } from '../service/subagent-workflow/types.js';
7
-
8
5
  /**
9
6
  * Factory to create the appropriate WorkflowManager by workflow_type string.
10
7
  * Used by the subagent_ended hook to dispatch lifecycle recovery to the right manager.
11
8
  */
12
-
13
-
14
- function createWorkflowManagerForType(
15
- workflowType: string,
16
- ): WorkflowManager | null {
9
+ function createWorkflowManagerForType(workflowType) {
17
10
  switch (workflowType) {
18
11
  default:
19
12
  return null;
20
13
  }
21
14
  }
22
-
23
15
  const HELPER_WORKFLOW_SESSION_PREFIX = 'agent:main:subagent:workflow-';
24
-
25
- type HookLogger = Pick<PluginLogger, 'info' | 'warn' | 'error'>;
26
-
27
16
  // Cleanup expired retry entries periodically
28
-
29
- function emitSubagentPainEvent(
30
- wctx: WorkspaceContext,
31
- payload: {
32
- source: string;
33
- reason: string;
34
- score: number;
35
- sessionId?: string;
36
- agentId?: string;
37
- },
38
- logger: HookLogger
39
- ): void {
17
+ function emitSubagentPainEvent(wctx, payload, logger) {
40
18
  try {
41
19
  wctx.evolutionReducer.emitSync({
42
20
  ts: new Date().toISOString(),
@@ -51,29 +29,18 @@ function emitSubagentPainEvent(
51
29
  agentId: payload.agentId,
52
30
  },
53
31
  });
54
- } catch (e) {
32
+ }
33
+ catch (e) {
55
34
  logger.warn(`[PD:Subagent] failed to emit evolution event: ${String(e)}`);
56
35
  }
57
36
  }
58
-
59
- type SubagentEndedHookContext = PluginHookSubagentContext & {
60
- api?: OpenClawPluginApi;
61
- workspaceDir?: string;
62
- sessionId?: string;
63
- agentId?: string;
64
- };
65
-
66
- export async function handleSubagentEnded(
67
- event: PluginHookSubagentEndedEvent,
68
- ctx: SubagentEndedHookContext
69
- ): Promise<void> {
37
+ export async function handleSubagentEnded(event, ctx) {
70
38
  const { outcome, targetSessionKey } = event;
71
- const {workspaceDir} = ctx;
72
-
73
- if (!workspaceDir) return;
74
-
39
+ const { workspaceDir } = ctx;
40
+ if (!workspaceDir)
41
+ return;
75
42
  const wctx = WorkspaceContext.fromHookContext(ctx);
76
- const logger: HookLogger = ctx.api?.logger ?? console;
43
+ const logger = ctx.api?.logger ?? console;
77
44
  // ── Helper Workflow Lifecycle Notification ──
78
45
  // When a helper workflow's subagent ends, notify the workflow manager
79
46
  // so that it can trigger fallback recovery (notifyWaitResult → finalizeOnce)
@@ -83,13 +50,11 @@ export async function handleSubagentEnded(
83
50
  const workflow = store.getWorkflowByChildSession(targetSessionKey);
84
51
  if (workflow && workflow.state !== 'completed' && workflow.state !== 'terminal_error' && workflow.state !== 'expired') {
85
52
  logger.info(`[PD:Subagent] Helper workflow lifecycle event: workflowId=${workflow.workflow_id}, workflowType=${workflow.workflow_type}, outcome=${outcome}`);
86
-
87
53
  const mappedOutcome = outcome === 'deleted' ? 'deleted' :
88
- outcome === 'killed' ? 'killed' :
89
- outcome === 'reset' ? 'reset' :
90
- outcome === 'error' ? 'error' :
91
- outcome === 'timeout' ? 'timeout' : 'ok';
92
-
54
+ outcome === 'killed' ? 'killed' :
55
+ outcome === 'reset' ? 'reset' :
56
+ outcome === 'error' ? 'error' :
57
+ outcome === 'timeout' ? 'timeout' : 'ok';
93
58
  // Call notifyLifecycleEvent on the appropriate manager so it
94
59
  // triggers notifyWaitResult → finalizeOnce / terminal transition.
95
60
  const subagentRuntime = ctx.api?.runtime?.subagent;
@@ -98,11 +63,13 @@ export async function handleSubagentEnded(
98
63
  if (mgr) {
99
64
  await mgr.notifyLifecycleEvent(workflow.workflow_id, 'subagent_ended', { outcome: mappedOutcome });
100
65
  mgr.dispose();
101
- } else {
66
+ }
67
+ else {
102
68
  logger.warn(`[PD:Subagent] Unknown workflow type ${workflow.workflow_type} — falling back to store-only event`);
103
69
  store.recordEvent(workflow.workflow_id, 'subagent_ended', workflow.state, workflow.state, `subagent ended with outcome: ${outcome}`, { outcome: mappedOutcome });
104
70
  }
105
- } else {
71
+ }
72
+ else {
106
73
  logger.warn(`[PD:Subagent] Subagent runtime not available — cannot notify manager, falling back to store event`);
107
74
  store.recordEvent(workflow.workflow_id, 'subagent_ended', workflow.state, workflow.state, `subagent ended with outcome: ${outcome}`, { outcome: mappedOutcome });
108
75
  }
@@ -110,23 +77,20 @@ export async function handleSubagentEnded(
110
77
  return;
111
78
  }
112
79
  store.dispose();
113
- } catch (e) {
80
+ }
81
+ catch (e) {
114
82
  logger.warn(`[PD:Subagent] Failed to notify helper workflow lifecycle: ${String(e)}`);
115
83
  }
116
84
  }
117
-
118
- const {config} = wctx;
119
-
85
+ const { config } = wctx;
120
86
  // ── Outcome-based EP and Pain Signal handling ──
121
87
  // OpenClaw v2026.3.23 fixes: timeout may be false positive (fast-finishing workers)
122
88
  // Only penalize actual errors, not timeout/killed/reset
123
-
124
89
  if (outcome === 'error') {
125
90
  // Only actual errors trigger penalty
126
91
  const scoreSettings = config.get('scores');
127
92
  const score = scoreSettings.subagent_error_penalty;
128
93
  const reason = `Subagent session ${targetSessionKey} ended with error`;
129
-
130
94
  // Emit pain via Runtime v2 chain (M8: no .pain_flag file)
131
95
  emitSubagentPainEvent(wctx, {
132
96
  source: `subagent_error`,
@@ -136,26 +100,22 @@ export async function handleSubagentEnded(
136
100
  agentId: ctx.agentId || extractAgentIdFromSessionKey(targetSessionKey),
137
101
  }, logger);
138
102
  }
139
-
140
103
  if (outcome === 'timeout') {
141
104
  // OpenClaw v2026.3.23 fix: timeout may be false positive
142
105
  // Fast-finishing workers are no longer incorrectly reported as timed out
143
106
  // Do not penalize - the task may have actually succeeded
144
107
  logger.warn(`[PD:Subagent] Session ${targetSessionKey} timed out - not penalizing (OpenClaw fix applied)`);
145
108
  }
146
-
147
109
  if (outcome === 'killed' || outcome === 'reset') {
148
110
  // User-initiated termination or system reset - not an agent failure
149
111
  logger.info(`[PD:Subagent] Session ${targetSessionKey} ended with ${outcome} - no penalty (user/system action)`);
150
112
  }
151
-
152
113
  if (outcome === 'ok' || outcome === 'deleted') {
153
114
  recordEvolutionSuccess(workspaceDir, 'subagent', {
154
115
  sessionId: ctx.sessionId,
155
116
  reason: 'subagent_success',
156
117
  });
157
118
  }
158
-
159
119
  // ── End of subagent_ended handling ──
160
120
  // Note: Diagnostician runs via HEARTBEAT (main session LLM), not as a subagent.
161
121
  // Principle creation happens in evolution-worker.ts marker detection path.
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Trajectory Collector - message write trajectory recording
3
+ *
4
+ * Records message data to memory/trajectories/ JSONL files.
5
+ * PRI-347 removed tool_call and llm_output JSONL writers (no consumers).
6
+ * PRI-346 will repurpose handleBeforeMessageWrite for SQLite collection.
7
+ */
8
+ import type { PluginHookAgentContext, PluginHookBeforeMessageWriteEvent } from '../openclaw-sdk.js';
9
+ /**
10
+ * PRI-346: Message write hook with SQLite fallback trajectory recording.
11
+ *
12
+ * When allowConversationAccess is NOT set (unauthorized), llm_output is silently
13
+ * blocked by OpenClaw and trajectory.db has no data. This hook is NOT in
14
+ * CONVERSATION_HOOK_NAMES, so it always fires — making it the natural fallback.
15
+ *
16
+ * De-duplication: only writes to SQLite when llm_output is blocked (unauthorized).
17
+ * When llm_output is working (authorized), this hook degrades to JSONL-only.
18
+ *
19
+ * ERR-002: structured observability when fallback fires.
20
+ * ERR-001/005: content is sanitized before persisting.
21
+ */
22
+ export declare function handleBeforeMessageWrite(event: PluginHookBeforeMessageWriteEvent, ctx: PluginHookAgentContext & {
23
+ workspaceDir?: string;
24
+ pluginConfig?: unknown;
25
+ }): void;