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,5 @@
1
+ import type { PDTaskSpec } from './pd-task-types.js';
2
+ export declare function readTasks(workspaceDir: string): PDTaskSpec[];
3
+ export declare function writeTasks(workspaceDir: string, tasks: PDTaskSpec[]): Promise<void>;
4
+ export declare function initTaskMeta(task: PDTaskSpec): PDTaskSpec;
5
+ export declare function updateSyncMeta(task: PDTaskSpec, status: 'ok' | 'error', jobId?: string, error?: string): PDTaskSpec;
@@ -0,0 +1,62 @@
1
+ import * as fs from 'fs';
2
+ import * as path from 'path';
3
+ import { withLockAsync } from '../utils/file-lock.js';
4
+ import { atomicWriteFileSync } from '../utils/io.js';
5
+ const PD_TASKS_FILENAME = 'pd_tasks.json';
6
+ function resolvePdTasksPath(workspaceDir) {
7
+ return path.join(workspaceDir, '.state', PD_TASKS_FILENAME);
8
+ }
9
+ function ensureStateDir(workspaceDir) {
10
+ const stateDir = path.join(workspaceDir, '.state');
11
+ if (!fs.existsSync(stateDir)) {
12
+ fs.mkdirSync(stateDir, { recursive: true });
13
+ }
14
+ }
15
+ export function readTasks(workspaceDir) {
16
+ const filePath = resolvePdTasksPath(workspaceDir);
17
+ if (!fs.existsSync(filePath)) {
18
+ return [];
19
+ }
20
+ try {
21
+ const raw = fs.readFileSync(filePath, 'utf-8');
22
+ const parsed = JSON.parse(raw);
23
+ if (Array.isArray(parsed)) {
24
+ return parsed;
25
+ }
26
+ return [];
27
+ }
28
+ catch (err) {
29
+ console.warn(`[PD:TaskStore] Failed to parse ${PD_TASKS_FILENAME}: ${String(err)}`);
30
+ return [];
31
+ }
32
+ }
33
+ export async function writeTasks(workspaceDir, tasks) {
34
+ const filePath = resolvePdTasksPath(workspaceDir);
35
+ ensureStateDir(workspaceDir);
36
+ await withLockAsync(filePath, async () => {
37
+ atomicWriteFileSync(filePath, JSON.stringify(tasks, null, 2));
38
+ });
39
+ }
40
+ export function initTaskMeta(task) {
41
+ if (!task.meta) {
42
+ task.meta = {};
43
+ }
44
+ if (!task.meta.createdAtMs) {
45
+ task.meta.createdAtMs = Date.now();
46
+ }
47
+ return task;
48
+ }
49
+ export function updateSyncMeta(task, status, jobId, error) {
50
+ if (!task.meta) {
51
+ task.meta = {};
52
+ }
53
+ task.meta.lastSyncedAtMs = Date.now();
54
+ task.meta.lastSyncStatus = status;
55
+ if (jobId) {
56
+ task.meta.lastSyncedJobId = jobId;
57
+ }
58
+ if (error) {
59
+ task.meta.lastSyncError = error;
60
+ }
61
+ return task;
62
+ }
@@ -0,0 +1,8 @@
1
+ import type { PDTaskSchedule as CorePDTaskSchedule, PDTaskExecution as CorePDTaskExecution, PDTaskDelivery as CorePDTaskDelivery, PDTaskMeta as CorePDTaskMeta, PDTaskSpec as CorePDTaskSpec } from '@principles/core/runtime-v2';
2
+ export type PDTaskSchedule = CorePDTaskSchedule;
3
+ export type PDTaskExecution = CorePDTaskExecution;
4
+ export type PDTaskDelivery = CorePDTaskDelivery;
5
+ export type PDTaskMeta = CorePDTaskMeta;
6
+ export type PDTaskSpec = CorePDTaskSpec;
7
+ export { PDTaskScheduleSchema, PDTaskExecutionSchema, PDTaskDeliverySchema, PDTaskMetaSchema, PDTaskSpecSchema, } from '@principles/core/runtime-v2';
8
+ export declare const BUILTIN_PD_TASKS: PDTaskSpec[];
@@ -0,0 +1,2 @@
1
+ export { PDTaskScheduleSchema, PDTaskExecutionSchema, PDTaskDeliverySchema, PDTaskMetaSchema, PDTaskSpecSchema, } from '@principles/core/runtime-v2';
2
+ export const BUILTIN_PD_TASKS = [];
@@ -0,0 +1,132 @@
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+ // --- Mocks (hoisted for vi.mock compatibility) ---
3
+ const { mockCollect, mockRegister, mockCreateAssetDir, mockLoadModule, mockValidate, mockGenerate, } = vi.hoisted(() => ({
4
+ mockCollect: vi.fn(),
5
+ mockRegister: vi.fn(),
6
+ mockCreateAssetDir: vi.fn(),
7
+ mockLoadModule: vi.fn(),
8
+ mockValidate: vi.fn(),
9
+ mockGenerate: vi.fn(),
10
+ }));
11
+ vi.mock('../code-validator.js', () => ({
12
+ validateGeneratedCode: mockValidate,
13
+ }));
14
+ vi.mock('../template-generator.js', () => ({
15
+ generateFromTemplate: mockGenerate,
16
+ }));
17
+ vi.mock('../ledger-registrar.js', () => ({
18
+ registerCompiledRule: mockRegister,
19
+ }));
20
+ vi.mock('../../code-implementation-storage.js', () => ({
21
+ createImplementationAssetDir: mockCreateAssetDir,
22
+ }));
23
+ vi.mock('../../rule-implementation-runtime.js', () => ({
24
+ loadRuleImplementationModule: mockLoadModule,
25
+ }));
26
+ import { PrincipleCompiler } from '../compiler.js';
27
+ // --- Fixtures ---
28
+ const PRINCIPLE_ID = 'P_test_001';
29
+ function makeContext(overrides) {
30
+ return {
31
+ principle: {
32
+ id: PRINCIPLE_ID,
33
+ version: 1,
34
+ text: 'Never delete system files via bash',
35
+ triggerPattern: 'bash rm',
36
+ action: 'block dangerous bash commands',
37
+ status: 'active',
38
+ priority: 'high',
39
+ scope: 'global',
40
+ evaluability: 'deterministic',
41
+ valueScore: 0.9,
42
+ adherenceRate: 0.8,
43
+ painPreventedCount: 5,
44
+ derivedFromPainIds: ['pain_001'],
45
+ ruleIds: [],
46
+ conflictsWithPrincipleIds: [],
47
+ createdAt: '2026-05-01T00:00:00Z',
48
+ updatedAt: '2026-05-01T00:00:00Z',
49
+ },
50
+ painEvents: [
51
+ {
52
+ reason: overrides?.reason ?? 'bash command failed on /etc/important.conf',
53
+ source: 'tool_failure',
54
+ },
55
+ ],
56
+ sessionSnapshot: null,
57
+ lineage: { sourcePainIds: ['pain_001'], sessionId: null },
58
+ };
59
+ }
60
+ // --- Tests ---
61
+ describe('PrincipleCompiler replay gate (PRI-115)', () => {
62
+ let compiler;
63
+ beforeEach(() => {
64
+ vi.clearAllMocks();
65
+ // Mock collector.collect directly on the instance
66
+ mockCollect.mockReturnValue(makeContext());
67
+ mockValidate.mockReturnValue({ valid: true, errors: [], warnings: [] });
68
+ mockGenerate.mockReturnValue('export function evaluate() { return { decision: "block", matched: true, reason: "test", confidence: 0.95 }; }');
69
+ mockRegister.mockReturnValue({ ruleId: 'R_test_auto', implementationId: 'IMPL_test_auto' });
70
+ compiler = new PrincipleCompiler('/tmp/test-state', {});
71
+ // Override collector after construction to avoid module resolution issues
72
+ compiler.collector = { collect: mockCollect, collectBatch: vi.fn() };
73
+ });
74
+ it('failing replay returns degraded=true and blocks registration', () => {
75
+ mockCollect.mockReturnValue(makeContext());
76
+ mockLoadModule.mockReturnValue({
77
+ evaluate: () => ({ decision: 'allow', matched: false, reason: 'pass', confidence: 1.0 }),
78
+ });
79
+ const result = compiler.compileOne(PRINCIPLE_ID);
80
+ expect(result.success).toBe(false);
81
+ expect(result.degraded).toBe(true);
82
+ expect(result.reason).toBe('replay_validation_failed');
83
+ expect(result.replayResult).toBeDefined();
84
+ expect(result.replayResult.passed).toBe(false);
85
+ expect(mockRegister).not.toHaveBeenCalled();
86
+ });
87
+ it('no asset dir created on replay failure', () => {
88
+ mockCollect.mockReturnValue(makeContext());
89
+ mockLoadModule.mockReturnValue({
90
+ evaluate: () => ({ decision: 'allow', matched: false, reason: 'pass', confidence: 1.0 }),
91
+ });
92
+ compiler.compileOne(PRINCIPLE_ID);
93
+ expect(mockCreateAssetDir).not.toHaveBeenCalled();
94
+ });
95
+ it('passing replay registers normally', () => {
96
+ mockCollect.mockReturnValue(makeContext());
97
+ mockLoadModule.mockReturnValue({
98
+ evaluate: (input) => {
99
+ const path = input?.action?.paramsSummary?.path;
100
+ if (path && path.includes('passwd')) {
101
+ return { decision: 'block', matched: true, reason: 'dangerous', confidence: 0.95 };
102
+ }
103
+ return { decision: 'allow', matched: false, reason: 'safe', confidence: 1.0 };
104
+ },
105
+ });
106
+ const result = compiler.compileOne(PRINCIPLE_ID);
107
+ expect(result.success).toBe(true);
108
+ expect(result.degraded).toBeUndefined();
109
+ expect(mockRegister).toHaveBeenCalledOnce();
110
+ expect(mockCreateAssetDir).toHaveBeenCalledOnce();
111
+ });
112
+ it('no cases (no regex qualifier) skips replay gate and registers', () => {
113
+ mockCollect.mockReturnValue(makeContext({ reason: 'bash failed unexpectedly' }));
114
+ mockLoadModule.mockReturnValue({
115
+ evaluate: () => ({ decision: 'block', matched: true, reason: 'test', confidence: 0.95 }),
116
+ });
117
+ const result = compiler.compileOne(PRINCIPLE_ID);
118
+ expect(result.success).toBe(true);
119
+ expect(result.degraded).toBeUndefined();
120
+ expect(mockRegister).toHaveBeenCalledOnce();
121
+ expect(mockLoadModule).not.toHaveBeenCalled();
122
+ });
123
+ it('no evaluate export returns degraded', () => {
124
+ mockCollect.mockReturnValue(makeContext());
125
+ mockLoadModule.mockReturnValue({});
126
+ const result = compiler.compileOne(PRINCIPLE_ID);
127
+ expect(result.success).toBe(false);
128
+ expect(result.degraded).toBe(true);
129
+ expect(result.reason).toContain('no evaluate export');
130
+ expect(mockRegister).not.toHaveBeenCalled();
131
+ });
132
+ });
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Code Validator — Validates LLM-generated rule implementation code
3
+ *
4
+ * CHECKS:
5
+ * 1. Syntax: code parses without errors (VM)
6
+ * 2. Forbidden patterns: delegates to core checkForbiddenPatterns (PRI-44)
7
+ * 3. Export check: sandbox loads and exports evaluate + meta (VM)
8
+ * 4. Return shape: evaluate(mockInput) returns { matched: boolean } (VM)
9
+ *
10
+ * PRI-44: Forbidden pattern detection extracted to @principles/core.
11
+ */
12
+ import { type ValidationResult } from '@principles/core/runtime-v2';
13
+ export type { ValidationResult } from '@principles/core/runtime-v2';
14
+ export declare function validateGeneratedCode(code: string): ValidationResult;
@@ -0,0 +1,86 @@
1
+ /**
2
+ * Code Validator — Validates LLM-generated rule implementation code
3
+ *
4
+ * CHECKS:
5
+ * 1. Syntax: code parses without errors (VM)
6
+ * 2. Forbidden patterns: delegates to core checkForbiddenPatterns (PRI-44)
7
+ * 3. Export check: sandbox loads and exports evaluate + meta (VM)
8
+ * 4. Return shape: evaluate(mockInput) returns { matched: boolean } (VM)
9
+ *
10
+ * PRI-44: Forbidden pattern detection extracted to @principles/core.
11
+ */
12
+ import { nodeVm } from '../../utils/node-vm-polyfill.js';
13
+ import { loadRuleImplementationModule } from '../rule-implementation-runtime.js';
14
+ import { checkForbiddenPatterns } from '@principles/core/runtime-v2';
15
+ const MOCK_INPUT = {
16
+ action: {
17
+ toolName: 'bash',
18
+ normalizedPath: '/tmp/test.ts',
19
+ paramsSummary: { command: 'echo test' },
20
+ },
21
+ workspace: { isRiskPath: false, planStatus: 'NONE', hasPlanFile: false },
22
+ session: { sessionId: 'test', currentGfi: 0, recentThinking: false },
23
+ evolution: { epTier: 0 },
24
+ derived: { estimatedLineChanges: 0, bashRisk: 'safe' },
25
+ };
26
+ export function validateGeneratedCode(code) {
27
+ const errors = [];
28
+ const warnings = [];
29
+ // --- Check 1: Syntax ---
30
+ const normalized = code
31
+ .replace(/export\s+const\s+/g, 'const ')
32
+ .replace(/export\s+function\s+/g, 'function ');
33
+ try {
34
+ new nodeVm.Script(normalized, { filename: 'code-validator-syntax.js' });
35
+ }
36
+ catch (err) {
37
+ errors.push(`Syntax error: ${err.message}`);
38
+ return { valid: false, errors, warnings };
39
+ }
40
+ // --- Check 2: Forbidden patterns (delegated to core) ---
41
+ // PRI-439: checkForbiddenPatterns forbids `export` (canonical dialect is bare function).
42
+ // The openclaw-plugin legacy compiler still accepts `export` (the sandbox strips it),
43
+ // so we pass the normalized code (export keywords removed) to the checker.
44
+ const forbiddenLabels = checkForbiddenPatterns(normalized);
45
+ for (const label of forbiddenLabels) {
46
+ errors.push(`Forbidden pattern: ${label}`);
47
+ }
48
+ if (errors.length > 0) {
49
+ return { valid: false, errors, warnings };
50
+ }
51
+ // --- Check 3: Sandbox load + export check ---
52
+ let moduleExports;
53
+ try {
54
+ moduleExports = loadRuleImplementationModule(code, 'code-validator-candidate.js');
55
+ }
56
+ catch (err) {
57
+ errors.push(`Sandbox compilation error: ${err.message}`);
58
+ return { valid: false, errors, warnings };
59
+ }
60
+ if (!moduleExports.meta || typeof moduleExports.meta !== 'object') {
61
+ errors.push('Missing export: meta');
62
+ }
63
+ if (typeof moduleExports.evaluate !== 'function') {
64
+ errors.push('Missing export: evaluate');
65
+ }
66
+ if (errors.length > 0) {
67
+ return { valid: false, errors, warnings };
68
+ }
69
+ // --- Check 4: Return shape ---
70
+ // evaluate() throwing on mock input is acceptable — the function exists and has the
71
+ // right signature, it just can't handle our generic mock data.
72
+ // Track as a non-blocking warning so operators know the rule may be fragile.
73
+ try {
74
+ const result = moduleExports.evaluate(MOCK_INPUT);
75
+ if (!result || typeof result !== 'object') {
76
+ errors.push('evaluate must return an object');
77
+ }
78
+ else if (typeof result.matched !== 'boolean') {
79
+ errors.push('evaluate must return { matched: boolean }');
80
+ }
81
+ }
82
+ catch (evalWarning) {
83
+ warnings.push(`evaluate() threw on mock input: ${evalWarning.message}`);
84
+ }
85
+ return { valid: errors.length === 0, errors, warnings };
86
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * PrincipleCompiler — Orchestrator (Task 5)
3
+ *
4
+ * Orchestrates the full compilation flow:
5
+ * ReflectionContextCollector.collect() → extract patterns → generateFromTemplate()
6
+ * → validateGeneratedCode() → [replay validation] → registerCompiledRule()
7
+ *
8
+ * DESIGN DECISIONS:
9
+ * - extractPatterns infers toolName from pain event reasons and session tool calls
10
+ * - Groups by toolName into PainPattern objects
11
+ * - If no patterns can be extracted, returns a 'no patterns' failure
12
+ * - PRI-115: Replay validation gate runs after code validation, before registration
13
+ */
14
+ import type { TrajectoryDatabase } from '../trajectory.js';
15
+ import type { CompileResult } from '@principles/core/runtime-v2';
16
+ export type { CompileResult } from '@principles/core/runtime-v2';
17
+ export declare class PrincipleCompiler {
18
+ private readonly stateDir;
19
+ private readonly collector;
20
+ constructor(stateDir: string, trajectory: TrajectoryDatabase);
21
+ /**
22
+ * Compile a single principle into an auto-generated rule.
23
+ *
24
+ * Flow:
25
+ * 1. Collect reflection context
26
+ * 2. Extract pain patterns
27
+ * 3. Generate code from template
28
+ * 4. Validate generated code
29
+ * 4.5. Replay validation against GoldenTrace (PRI-115)
30
+ * 5. Register in ledger
31
+ */
32
+ compileOne(principleId: string): CompileResult;
33
+ /**
34
+ * Build GoldenTrace test cases from extracted pain patterns.
35
+ *
36
+ * Generates synthetic negative/positive parameter pairs based on whether
37
+ * the pattern targets commands (commandRegex) or paths (pathRegex).
38
+ * Returns an empty array when no patterns are available.
39
+ */
40
+ private buildGoldenTraceCases;
41
+ /**
42
+ * Compile all eligible principles (those with derivedFromPainIds).
43
+ */
44
+ compileAll(): CompileResult[];
45
+ }
@@ -0,0 +1,287 @@
1
+ /**
2
+ * PrincipleCompiler — Orchestrator (Task 5)
3
+ *
4
+ * Orchestrates the full compilation flow:
5
+ * ReflectionContextCollector.collect() → extract patterns → generateFromTemplate()
6
+ * → validateGeneratedCode() → [replay validation] → registerCompiledRule()
7
+ *
8
+ * DESIGN DECISIONS:
9
+ * - extractPatterns infers toolName from pain event reasons and session tool calls
10
+ * - Groups by toolName into PainPattern objects
11
+ * - If no patterns can be extracted, returns a 'no patterns' failure
12
+ * - PRI-115: Replay validation gate runs after code validation, before registration
13
+ */
14
+ import { ReflectionContextCollector } from '../reflection/reflection-context.js';
15
+ import { validateGeneratedCode } from './code-validator.js';
16
+ import { generateFromTemplate } from './template-generator.js';
17
+ import { registerCompiledRule } from './ledger-registrar.js';
18
+ import { createImplementationAssetDir } from '../code-implementation-storage.js';
19
+ import { loadRuleImplementationModule } from '../rule-implementation-runtime.js';
20
+ import { createGoldenTraceFixture } from '@principles/core/runtime-v2';
21
+ import { replayGoldenTrace } from '@principles/core/runtime-v2';
22
+ // ---------------------------------------------------------------------------
23
+ // Constants
24
+ // ---------------------------------------------------------------------------
25
+ /** Tool names to look for when scanning text for tool references */
26
+ const KNOWN_TOOLS = ['bash', 'write', 'edit', 'read', 'grep', 'glob', 'mcp'];
27
+ /** Regex to extract file paths from reason text */
28
+ const PATH_REGEX = /(?:\/[\w.-]+){2,}/;
29
+ // ---------------------------------------------------------------------------
30
+ // Pattern Extraction
31
+ // ---------------------------------------------------------------------------
32
+ /**
33
+ * Extract PainPatterns from a ReflectionContext.
34
+ *
35
+ * Strategy:
36
+ * 1. Scan pain event reasons for known tool names
37
+ * 2. Extract file paths from reason text as pathRegex candidates
38
+ * 3. Cross-reference with sessionSnapshot toolCalls for failed tool calls
39
+ * 4. Group by toolName into PainPattern objects
40
+ */
41
+ function extractPatterns(context) {
42
+ const toolNameMap = new Map();
43
+ // 1. Extract from pain event reasons
44
+ for (const pe of context.painEvents) {
45
+ const text = pe.reason ?? pe.source ?? '';
46
+ const toolName = inferToolName(text);
47
+ if (!toolName)
48
+ continue;
49
+ const pathRegex = extractPathRegex(text);
50
+ if (!toolNameMap.has(toolName)) {
51
+ toolNameMap.set(toolName, { toolName });
52
+ }
53
+ const pattern = toolNameMap.get(toolName);
54
+ if (pathRegex && !pattern.pathRegex) {
55
+ pattern.pathRegex = pathRegex;
56
+ }
57
+ }
58
+ // 2. Extract from session snapshot tool calls (failed ones)
59
+ if (context.sessionSnapshot?.toolCalls) {
60
+ for (const tc of context.sessionSnapshot.toolCalls) {
61
+ // Focus on failed/blocked tool calls as they indicate pain
62
+ if (tc.outcome !== 'failure' && tc.outcome !== 'blocked')
63
+ continue;
64
+ const toolName = tc.toolName;
65
+ if (!toolNameMap.has(toolName)) {
66
+ const pattern = { toolName };
67
+ if (tc.errorType) {
68
+ pattern.errorType = tc.errorType;
69
+ }
70
+ if (tc.filePath) {
71
+ pattern.pathRegex = escapeRegex(tc.filePath);
72
+ }
73
+ toolNameMap.set(toolName, pattern);
74
+ }
75
+ else {
76
+ const existing = toolNameMap.get(toolName);
77
+ if (tc.errorType && !existing.errorType) {
78
+ existing.errorType = tc.errorType;
79
+ }
80
+ if (tc.filePath && !existing.pathRegex) {
81
+ existing.pathRegex = escapeRegex(tc.filePath);
82
+ }
83
+ }
84
+ }
85
+ }
86
+ return Array.from(toolNameMap.values());
87
+ }
88
+ /**
89
+ * Infer tool name from text by checking for known tool names.
90
+ * Returns the first matching known tool name, or null if none found.
91
+ *
92
+ * Uses negative lookbehind to avoid matching natural-language uses:
93
+ * - "please read the error" → read is a verb, not a tool reference
94
+ * - "could write to file" → write is a verb, not a tool reference
95
+ * Tool references in pain events typically appear near words like
96
+ * "tool", "call", "command", "failed", "via", "using", etc.
97
+ */
98
+ function inferToolName(text) {
99
+ const lower = text.toLowerCase();
100
+ for (const tool of KNOWN_TOOLS) {
101
+ // Match as a standalone word but exclude common natural-language patterns
102
+ // e.g., "bash" in "bash" or "bash command" but not in "ambush"
103
+ // and not in "please read" or "could write" where it's a verb
104
+ const regex = new RegExp(`(?<!please |could |should |would )\\b${tool}\\b`);
105
+ if (regex.test(lower)) {
106
+ return tool;
107
+ }
108
+ }
109
+ return null;
110
+ }
111
+ /**
112
+ * Extract a file path from text and return it as an escaped regex pattern.
113
+ * Returns the first path found, or null.
114
+ */
115
+ function extractPathRegex(text) {
116
+ const match = PATH_REGEX.exec(text);
117
+ if (match) {
118
+ return escapeRegex(match[0]);
119
+ }
120
+ return null;
121
+ }
122
+ /**
123
+ * Escape special regex characters in a string.
124
+ */
125
+ function escapeRegex(str) {
126
+ return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
127
+ }
128
+ // ---------------------------------------------------------------------------
129
+ // PrincipleCompiler
130
+ // ---------------------------------------------------------------------------
131
+ export class PrincipleCompiler {
132
+ stateDir;
133
+ collector;
134
+ constructor(stateDir, trajectory) {
135
+ this.stateDir = stateDir;
136
+ this.collector = new ReflectionContextCollector(stateDir, trajectory);
137
+ }
138
+ /**
139
+ * Compile a single principle into an auto-generated rule.
140
+ *
141
+ * Flow:
142
+ * 1. Collect reflection context
143
+ * 2. Extract pain patterns
144
+ * 3. Generate code from template
145
+ * 4. Validate generated code
146
+ * 4.5. Replay validation against GoldenTrace (PRI-115)
147
+ * 5. Register in ledger
148
+ */
149
+ compileOne(principleId) {
150
+ // Step 1: Collect context
151
+ const context = this.collector.collect(principleId);
152
+ if (!context) {
153
+ return { success: false, principleId, reason: 'no context' };
154
+ }
155
+ // Step 2: Extract patterns
156
+ const patterns = extractPatterns({
157
+ painEvents: context.painEvents,
158
+ sessionSnapshot: context.sessionSnapshot,
159
+ });
160
+ // Step 3: Generate code
161
+ const coversCondition = context.principle.triggerPattern || context.principle.text;
162
+ const code = generateFromTemplate(principleId, coversCondition, patterns);
163
+ if (!code) {
164
+ return { success: false, principleId, reason: 'no patterns' };
165
+ }
166
+ // Step 4: Validate
167
+ const validation = validateGeneratedCode(code);
168
+ if (!validation.valid) {
169
+ return {
170
+ success: false,
171
+ principleId,
172
+ reason: `validation failed: ${validation.errors.join('; ')}`,
173
+ };
174
+ }
175
+ // Step 4.5: Replay validation against GoldenTrace (PRI-115)
176
+ const replayCases = this.buildGoldenTraceCases(patterns, context);
177
+ if (replayCases.length > 0) {
178
+ let moduleExports;
179
+ try {
180
+ moduleExports = loadRuleImplementationModule(code, `replay-${principleId}.js`);
181
+ }
182
+ catch (err) {
183
+ return {
184
+ success: false,
185
+ principleId,
186
+ reason: `module_load_error: ${err.message}`,
187
+ code,
188
+ degraded: true,
189
+ };
190
+ }
191
+ if (typeof moduleExports.evaluate !== 'function') {
192
+ return { success: false, principleId, reason: 'replay: no evaluate export', degraded: true };
193
+ }
194
+ try {
195
+ const evaluateFn = moduleExports.evaluate;
196
+ const replayResult = replayGoldenTrace(evaluateFn, replayCases);
197
+ if (!replayResult.passed) {
198
+ return {
199
+ success: false,
200
+ principleId,
201
+ reason: 'replay_validation_failed',
202
+ code,
203
+ replayResult,
204
+ degraded: true,
205
+ };
206
+ }
207
+ }
208
+ catch (err) {
209
+ return {
210
+ success: false,
211
+ principleId,
212
+ reason: `replay_error: ${err.message}`,
213
+ code,
214
+ degraded: true,
215
+ };
216
+ }
217
+ }
218
+ // Step 5: Register
219
+ const registration = registerCompiledRule(this.stateDir, {
220
+ principleId,
221
+ codeContent: code,
222
+ coversCondition,
223
+ });
224
+ // Step 6: Persist code to disk so RuleHost can load it
225
+ createImplementationAssetDir(this.stateDir, registration.implementationId, '1', {
226
+ entrySource: code,
227
+ });
228
+ return {
229
+ success: true,
230
+ principleId,
231
+ ruleId: registration.ruleId,
232
+ implementationId: registration.implementationId,
233
+ code,
234
+ };
235
+ }
236
+ /**
237
+ * Build GoldenTrace test cases from extracted pain patterns.
238
+ *
239
+ * Generates synthetic negative/positive parameter pairs based on whether
240
+ * the pattern targets commands (commandRegex) or paths (pathRegex).
241
+ * Returns an empty array when no patterns are available.
242
+ */
243
+ buildGoldenTraceCases(patterns, _context) {
244
+ if (patterns.length === 0)
245
+ return [];
246
+ const pattern = patterns[0];
247
+ // Skip replay when the pattern has no regex qualifier -- the generated template
248
+ // blocks ALL calls to the tool, making it impossible to construct a passing
249
+ // positive case. Replay is only meaningful when the template is selective.
250
+ // Also skip contentRegex-only patterns: synthetic content params are not meaningful.
251
+ if (!pattern.commandRegex && !pattern.pathRegex)
252
+ return [];
253
+ const negativeParams = {};
254
+ if (pattern.commandRegex)
255
+ negativeParams.command = 'rm -rf /';
256
+ else
257
+ negativeParams.path = '/etc/passwd';
258
+ const positiveParams = {};
259
+ if (pattern.commandRegex)
260
+ positiveParams.command = 'echo hello';
261
+ else
262
+ positiveParams.path = '/tmp/safe.txt';
263
+ const fixture = createGoldenTraceFixture({
264
+ toolName: pattern.toolName,
265
+ negativeParams,
266
+ positiveParams,
267
+ expectedDecision: 'block',
268
+ });
269
+ return fixture.cases;
270
+ }
271
+ /**
272
+ * Compile all eligible principles (those with derivedFromPainIds).
273
+ */
274
+ compileAll() {
275
+ const contexts = this.collector.collectBatch();
276
+ return contexts.map((ctx) => {
277
+ try {
278
+ return this.compileOne(ctx.principle.id);
279
+ }
280
+ catch (e) {
281
+ // Log for operator visibility — catch-return is intentional for batch容错
282
+ console.warn(`[PrincipleCompiler] compileAll failed for ${ctx.principle.id}: ${e.message}`);
283
+ return { success: false, principleId: ctx.principle.id, reason: `unhandled: ${e.message}` };
284
+ }
285
+ });
286
+ }
287
+ }
@@ -4,7 +4,6 @@
4
4
  * Re-exports all principle-compiler components for convenient importing.
5
5
  * PRI-44: Types and pure logic re-exported from @principles/core.
6
6
  */
7
-
8
7
  export { PrincipleCompiler } from './compiler.js';
9
8
  export type { CompileResult } from './compiler.js';
10
9
  export { validateGeneratedCode } from './code-validator.js';
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Principle Compiler — Barrel Export
3
+ *
4
+ * Re-exports all principle-compiler components for convenient importing.
5
+ * PRI-44: Types and pure logic re-exported from @principles/core.
6
+ */
7
+ export { PrincipleCompiler } from './compiler.js';
8
+ export { validateGeneratedCode } from './code-validator.js';
9
+ export { generateFromTemplate } from './template-generator.js';
10
+ export { registerCompiledRule } from './ledger-registrar.js';