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
@@ -1,261 +0,0 @@
1
- /**
2
- * PRI-437 Slice 4: Approved compile failure is visible in EventLog, CLI and Console
3
- *
4
- * PURPOSE: Verify that when an approved rule fails to compile/load, the failure
5
- * is recorded in EventLog as an unhealthy event with reason and nextAction.
6
- * NOT just a logger.warn that's silently skipped.
7
- *
8
- * ERR risk mitigation:
9
- * - ERR-002: degradation must include a reason (not silent logger.warn)
10
- * - Observability: unhealthy state must be persisted and queryable
11
- *
12
- * Test approach:
13
- * - Real SQLite activation with broken code (syntax error)
14
- * - Real RuleHost.evaluate() (public interface)
15
- * - Read real EventLog JSONL file to verify unhealthy record
16
- */
17
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
18
- import * as fs from 'fs';
19
- import * as os from 'os';
20
- import * as path from 'path';
21
- import { SqliteConnection, SqliteActivationStateStore } from '@principles/core/runtime-v2';
22
- import type { RuleHostInput } from '@principles/core/runtime-v2';
23
- import { RuleHost } from '../../src/core/rule-host.js';
24
- import { EventLogService } from '../../src/core/event-log.js';
25
-
26
- // ── Test helpers ───────────────────────────────────────────────────────────
27
-
28
- const RULE_ID_BROKEN = 'R_TEST_BROKEN_004';
29
- const ARTIFACT_ID_BROKEN = 'art-broken-004';
30
- const ACTIVATION_ID_BROKEN = `act_code_${RULE_ID_BROKEN}`;
31
-
32
- // Code with a syntax error that will cause compilation failure
33
- const BROKEN_CODE = `
34
- function evaluate(input, helpers) {
35
- // Syntax error: unclosed brace
36
- return { decision: 'block', matched: true, reason: 'broken'
37
- // Missing closing brace for function and return object
38
- var meta = { name: 'broken-rule', version: '1', ruleId: '${RULE_ID_BROKEN}', coversCondition: 'all' };
39
- `;
40
-
41
- let tempWorkspaceDir: string;
42
- let tempStateDir: string;
43
- let sqliteConn: SqliteConnection;
44
-
45
- function setupTempDirs(): void {
46
- const baseTmp = os.tmpdir();
47
- tempWorkspaceDir = fs.mkdtempSync(path.join(baseTmp, 'pd-rulehost-unhealthy-'));
48
- tempStateDir = path.join(tempWorkspaceDir, '.principles');
49
- fs.mkdirSync(tempStateDir, { recursive: true });
50
- }
51
-
52
- function insertRuleArtifact(): void {
53
- const db = sqliteConn.getDb();
54
- const now = new Date().toISOString();
55
- const contentJson = JSON.stringify({
56
- principleId: 'P_TEST_BROKEN_004',
57
- ruleId: RULE_ID_BROKEN,
58
- implementationCode: BROKEN_CODE,
59
- goldenTrace: { traceId: 'trace-broken-004', cases: [], createdAt: now, version: 1 },
60
- ruleHostGateDecision: 'accepted_shadow',
61
- affectedTools: ['write_file'],
62
- painReasonSummary: 'Test: broken code compilation',
63
- });
64
-
65
- db.prepare(`
66
- INSERT INTO pi_artifacts (artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at)
67
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
68
- `).run(
69
- ARTIFACT_ID_BROKEN,
70
- 'rule',
71
- 'task-broken-004',
72
- 'P_TEST_BROKEN_004',
73
- RULE_ID_BROKEN,
74
- '[]',
75
- 'validated',
76
- contentJson,
77
- now,
78
- now,
79
- );
80
- }
81
-
82
- async function insertActivation(): Promise<void> {
83
- const store = new SqliteActivationStateStore(sqliteConn);
84
- const now = new Date().toISOString();
85
- await store.recordActivation({
86
- activationId: ACTIVATION_ID_BROKEN,
87
- idempotencyKey: `${ARTIFACT_ID_BROKEN}::code_tool_hook`,
88
- artifactId: ARTIFACT_ID_BROKEN,
89
- channel: 'code_tool_hook',
90
- action: 'code_tool_hook_shadow_activate',
91
- targetRef: `impl://${RULE_ID_BROKEN}`,
92
- activatedAt: now,
93
- deactivatedAt: null,
94
- });
95
- }
96
-
97
- function makeInput(): RuleHostInput {
98
- return {
99
- action: {
100
- toolName: 'write_file',
101
- normalizedPath: '/etc/passwd',
102
- paramsSummary: { path: '/etc/passwd' },
103
- },
104
- workspace: { isRiskPath: false, planStatus: 'NONE' as const, hasPlanFile: false },
105
- session: { sessionId: 'test-session-unhealthy', currentGfi: 0, recentThinking: false },
106
- evolution: { epTier: 1 },
107
- derived: { estimatedLineChanges: 1, bashRisk: 'safe' as const },
108
- };
109
- }
110
-
111
- function readTodayEvents(stateDir: string): string {
112
- const today = new Date().toISOString().slice(0, 10);
113
- const eventsFile = path.join(stateDir, 'logs', `events_${today}.jsonl`);
114
- if (!fs.existsSync(eventsFile)) {
115
- return '';
116
- }
117
- return fs.readFileSync(eventsFile, 'utf-8');
118
- }
119
-
120
- // ── Setup / Teardown ───────────────────────────────────────────────────────
121
-
122
- beforeEach(() => {
123
- setupTempDirs();
124
- EventLogService.disposeAll();
125
- sqliteConn = new SqliteConnection(tempWorkspaceDir);
126
- sqliteConn.getDb();
127
- });
128
-
129
- afterEach(() => {
130
- EventLogService.disposeAll();
131
- try { sqliteConn?.close(); } catch { /* best-effort */ }
132
- try { fs.rmSync(tempWorkspaceDir, { recursive: true, force: true }); } catch { /* Windows */ }
133
- });
134
-
135
- // ── Slice 4: Compile failure visible in EventLog ───────────────────────────
136
-
137
- describe('PRI-437 Slice 4: Approved compile failure is visible in EventLog', () => {
138
- it('broken code compilation → EventLog records rulehost_unhealthy with reason and nextAction', async () => {
139
- insertRuleArtifact();
140
- await insertActivation();
141
-
142
- const warnCalls: string[] = [];
143
- const spyLogger = {
144
- warn: (message: string) => { warnCalls.push(message); },
145
- error: () => {},
146
- info: () => {},
147
- };
148
-
149
- const ruleHost = new RuleHost(tempStateDir, spyLogger, { workspaceDir: tempWorkspaceDir });
150
-
151
- // Evaluate — should attempt to compile the broken code and fail
152
- const result = ruleHost.evaluate(makeInput());
153
-
154
- // Conservative degradation: undefined (no opinion)
155
- expect(result).toBeUndefined();
156
-
157
- // Flush EventLog to ensure events are written to disk
158
- const eventLog = EventLogService.get(tempStateDir);
159
- eventLog.flush();
160
-
161
- // Read the EventLog JSONL file and verify unhealthy record exists
162
- const eventsContent = readTodayEvents(tempStateDir);
163
-
164
- // Must contain a rulehost_unhealthy event (NOT just logger.warn)
165
- expect(eventsContent).toContain('rulehost_unhealthy');
166
-
167
- // Structured validation: parse JSONL lines and find the unhealthy event
168
- const lines = eventsContent.trim().split('\n').filter(l => l.trim());
169
- const unhealthyEvents = lines
170
- .map(line => { try { return JSON.parse(line); } catch { return null; } })
171
- .filter(evt => evt?.type === 'rulehost_unhealthy');
172
-
173
- expect(unhealthyEvents.length).toBeGreaterThanOrEqual(1);
174
-
175
- // Verify the unhealthy event has all required fields in the same record
176
- const unhealthy = unhealthyEvents[0];
177
- expect(unhealthy.data.activationId).toBe(ACTIVATION_ID_BROKEN);
178
- expect(unhealthy.data.ruleId).toBe(RULE_ID_BROKEN);
179
- expect(typeof unhealthy.data.reason).toBe('string');
180
- expect(unhealthy.data.reason.length).toBeGreaterThan(0);
181
- expect(typeof unhealthy.data.nextAction).toBe('string');
182
- expect(unhealthy.data.nextAction.length).toBeGreaterThan(0);
183
- });
184
-
185
- it('valid rule does NOT produce rulehost_unhealthy event', async () => {
186
- // Insert a VALID rule (not broken)
187
- const VALID_CODE = `
188
- function evaluate(input, helpers) {
189
- var p = input.action.normalizedPath || '';
190
- if (p.indexOf('/etc/') === 0) {
191
- return { decision: 'block', matched: true, reason: 'valid block' };
192
- }
193
- return { decision: 'allow', matched: false, reason: 'not matched' };
194
- }
195
- var meta = { name: 'valid-rule', version: '1', ruleId: '${RULE_ID_BROKEN}', coversCondition: 'all' };
196
- `;
197
-
198
- const db = sqliteConn.getDb();
199
- const now = new Date().toISOString();
200
- const contentJson = JSON.stringify({
201
- principleId: 'P_TEST_VALID_004',
202
- ruleId: RULE_ID_BROKEN,
203
- implementationCode: VALID_CODE,
204
- goldenTrace: { traceId: 'trace-valid-004', cases: [], createdAt: now, version: 1 },
205
- ruleHostGateDecision: 'accepted_shadow',
206
- affectedTools: ['write_file'],
207
- painReasonSummary: 'Test: valid code',
208
- });
209
-
210
- db.prepare(`
211
- INSERT INTO pi_artifacts (artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at)
212
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
213
- `).run(
214
- ARTIFACT_ID_BROKEN, 'rule', 'task-valid-004', 'P_TEST_VALID_004', RULE_ID_BROKEN,
215
- '[]', 'validated', contentJson, now, now,
216
- );
217
-
218
- await insertActivation();
219
-
220
- const ruleHost = new RuleHost(tempStateDir, { warn: () => {}, error: () => {}, info: () => {} }, { workspaceDir: tempWorkspaceDir });
221
- const result = ruleHost.evaluate(makeInput());
222
-
223
- // Valid rule should block (not undefined)
224
- expect(result).toBeDefined();
225
- expect(result?.decision).toBe('block');
226
-
227
- // Flush and verify NO unhealthy event
228
- const eventLog = EventLogService.get(tempStateDir);
229
- eventLog.flush();
230
-
231
- const eventsContent = readTodayEvents(tempStateDir);
232
- expect(eventsContent).not.toContain('rulehost_unhealthy');
233
- });
234
-
235
- it('runtime-invalid result is persisted as rulehost_unhealthy and never executes', async () => {
236
- const invalidResultCode = `
237
- function evaluate() {
238
- return { decision: 'block', matched: 'yes', reason: 'invalid matched type' };
239
- }
240
- var meta = { name: 'invalid-result-rule', version: '1', ruleId: '${RULE_ID_BROKEN}', coversCondition: 'all' };
241
- `;
242
- const now = new Date().toISOString();
243
- sqliteConn.getDb().prepare(`
244
- INSERT INTO pi_artifacts (artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at)
245
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
246
- `).run(
247
- ARTIFACT_ID_BROKEN, 'rule', 'task-invalid-result', 'P_TEST_INVALID_RESULT', RULE_ID_BROKEN,
248
- '[]', 'validated', JSON.stringify({ ruleId: RULE_ID_BROKEN, implementationCode: invalidResultCode }), now, now,
249
- );
250
- await insertActivation();
251
-
252
- const ruleHost = new RuleHost(tempStateDir, { warn: () => {} }, { workspaceDir: tempWorkspaceDir });
253
- expect(ruleHost.evaluate(makeInput())).toBeUndefined();
254
- EventLogService.get(tempStateDir).flush();
255
-
256
- const events = readTodayEvents(tempStateDir);
257
- expect(events).toContain('rulehost_unhealthy');
258
- expect(events).toContain('invalid RuleHostResult');
259
- expect(events).toContain(ACTIVATION_ID_BROKEN);
260
- });
261
- });
@@ -1,315 +0,0 @@
1
- /**
2
- * PRI-437: Harden RuleHost execution validation, isolation and activation health
3
- *
4
- * TDD vertical slices:
5
- * 1. Malformed VM results never enforce and create unhealthy evidence
6
- * 2. Valid decisions work through public before-tool-call hook
7
- * 3. Infinite loop and memory allocation terminate without taking down host
8
- * 4. Approved compile failure is visible in health, CLI JSON and Console API
9
- * 5. Invalid tier/adversarial diagnostics cannot corrupt output
10
- *
11
- * Tests verify through public interfaces:
12
- * - Real SQLite store (SqliteConnection + SqliteActivationStateStore)
13
- * - Real RuleHost.evaluate()
14
- * - No mocking of private internals
15
- *
16
- * ERR risk mitigation:
17
- * - ERR-001: no `as` bypass at trust boundary — VM output validated as unknown
18
- * - ERR-002: no catch-and-degrade — malformed results emit structured unhealthy evidence
19
- * - ERR-013: Object.hasOwn for untrusted object key checks
20
- * - ERR-024: validator wired into production path, not just demo/test
21
- */
22
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
23
- import * as fs from 'fs';
24
- import * as os from 'os';
25
- import * as path from 'path';
26
- import { SqliteConnection, SqliteActivationStateStore } from '@principles/core/runtime-v2';
27
- import type { RuleHostInput } from '@principles/core/runtime-v2';
28
- import { RuleHost } from '../../src/core/rule-host.js';
29
-
30
- // ── Test helpers (shared with rule-host-sqlite-source.test.ts pattern) ──────
31
-
32
- const RULE_ID = 'R_TEST_PRI437_001';
33
- const ARTIFACT_ID = 'art-pri437-001';
34
- const ACTIVATION_ID = `act_code_${RULE_ID}`;
35
-
36
- let tempWorkspaceDir: string;
37
- let tempStateDir: string;
38
- let sqliteConn: SqliteConnection;
39
-
40
- function setupTempDirs(): void {
41
- const baseTmp = os.tmpdir();
42
- tempWorkspaceDir = fs.mkdtempSync(path.join(baseTmp, 'pd-rulehost-pri437-'));
43
- tempStateDir = path.join(tempWorkspaceDir, '.principles');
44
- fs.mkdirSync(tempStateDir, { recursive: true });
45
- }
46
-
47
- function insertRuleArtifact(overrides?: {
48
- artifactId?: string;
49
- ruleId?: string;
50
- contentJson?: string;
51
- validationStatus?: string;
52
- sourceTaskId?: string;
53
- }): void {
54
- const artifactId = overrides?.artifactId ?? ARTIFACT_ID;
55
- const ruleId = overrides?.ruleId ?? RULE_ID;
56
- const validationStatus = overrides?.validationStatus ?? 'validated';
57
- const sourceTaskId = overrides?.sourceTaskId ?? 'task-pri437-001';
58
- const db = sqliteConn.getDb();
59
- const now = new Date().toISOString();
60
-
61
- const contentJson = overrides?.contentJson ?? JSON.stringify({
62
- principleId: 'P_TEST_PRI437',
63
- ruleId,
64
- implementationCode: '',
65
- goldenTrace: {
66
- traceId: 'trace-pri437',
67
- cases: [],
68
- createdAt: now,
69
- version: 1,
70
- },
71
- ruleHostGateDecision: 'accepted_shadow',
72
- affectedTools: ['write_file'],
73
- painReasonSummary: 'Test: PRI-437',
74
- });
75
-
76
- db.prepare(`
77
- INSERT INTO pi_artifacts (artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at)
78
- VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
79
- `).run(
80
- artifactId,
81
- 'rule',
82
- sourceTaskId,
83
- 'P_TEST_PRI437',
84
- ruleId,
85
- '[]',
86
- validationStatus,
87
- contentJson,
88
- now,
89
- now,
90
- );
91
- }
92
-
93
- async function insertCodeToolHookActivation(overrides?: {
94
- activationId?: string;
95
- artifactId?: string;
96
- ruleId?: string;
97
- deactivatedAt?: string | null;
98
- }): Promise<void> {
99
- const activationId = overrides?.activationId ?? ACTIVATION_ID;
100
- const artifactId = overrides?.artifactId ?? ARTIFACT_ID;
101
- const ruleId = overrides?.ruleId ?? RULE_ID;
102
- const store = new SqliteActivationStateStore(sqliteConn);
103
- const now = new Date().toISOString();
104
-
105
- await store.recordActivation({
106
- activationId,
107
- idempotencyKey: `${artifactId}::code_tool_hook`,
108
- artifactId,
109
- channel: 'code_tool_hook',
110
- action: 'code_tool_hook_shadow_activate',
111
- targetRef: `impl://${ruleId}`,
112
- activatedAt: now,
113
- deactivatedAt: overrides?.deactivatedAt ?? null,
114
- });
115
- }
116
-
117
- function makeInput(normalizedPath: string): RuleHostInput {
118
- return {
119
- action: {
120
- toolName: 'write_file',
121
- normalizedPath,
122
- paramsSummary: { path: normalizedPath },
123
- },
124
- workspace: {
125
- isRiskPath: false,
126
- planStatus: 'NONE',
127
- hasPlanFile: false,
128
- },
129
- session: {
130
- sessionId: 'test-session',
131
- currentGfi: 0,
132
- recentThinking: false,
133
- },
134
- evolution: {
135
- epTier: 1,
136
- },
137
- derived: {
138
- estimatedLineChanges: 1,
139
- bashRisk: 'safe' as const,
140
- },
141
- };
142
- }
143
-
144
- function makeContentJson(ruleId: string, code: string): string {
145
- return JSON.stringify({
146
- principleId: 'P_TEST_PRI437',
147
- ruleId,
148
- implementationCode: code,
149
- goldenTrace: {
150
- traceId: 'trace-pri437',
151
- cases: [],
152
- createdAt: new Date().toISOString(),
153
- version: 1,
154
- },
155
- ruleHostGateDecision: 'accepted_shadow',
156
- affectedTools: ['write_file'],
157
- painReasonSummary: 'Test: PRI-437',
158
- });
159
- }
160
-
161
- // ── Setup / Teardown ───────────────────────────────────────────────────────
162
-
163
- beforeEach(() => {
164
- setupTempDirs();
165
- sqliteConn = new SqliteConnection(tempWorkspaceDir);
166
- sqliteConn.getDb();
167
- });
168
-
169
- afterEach(() => {
170
- try { sqliteConn?.close(); } catch { /* best-effort */ }
171
- try { fs.rmSync(tempWorkspaceDir, { recursive: true, force: true }); } catch { /* Windows */ }
172
- });
173
-
174
- // ── Slice 1: Malformed VM results never enforce and create unhealthy evidence ─
175
-
176
- describe('PRI-437 Slice 1: Malformed VM results never enforce and create unhealthy evidence', () => {
177
- it('malformed result with non-string reason does not enforce and emits unhealthy evidence', async () => {
178
- // RuleCode returns { matched: true, decision: 'block', reason: 42 } — reason is a number, not a string
179
- const MALFORMED_CODE = `
180
- function evaluate(input, helpers) {
181
- return { matched: true, decision: 'block', reason: 42 };
182
- }
183
- var meta = { name: 'malformed-rule', version: '1', ruleId: '${RULE_ID}', coversCondition: 'all' };
184
- `;
185
- insertRuleArtifact({ contentJson: makeContentJson(RULE_ID, MALFORMED_CODE) });
186
- await insertCodeToolHookActivation();
187
-
188
- const warnCalls: string[] = [];
189
- const spyLogger: { warn: (_message: string) => void } = {
190
- warn: (message: string) => { warnCalls.push(message); },
191
- };
192
-
193
- const ruleHost = new RuleHost(tempStateDir, spyLogger, { workspaceDir: tempWorkspaceDir });
194
- const result = ruleHost.evaluate(makeInput('/etc/passwd'));
195
-
196
- // Malformed result must NOT enforce — no block returned
197
- expect(result).toBeUndefined();
198
-
199
- // Unhealthy evidence must be emitted via logger.warn
200
- expect(warnCalls.length).toBeGreaterThan(0);
201
- const unhealthyWarn = warnCalls.find(m =>
202
- m.toLowerCase().includes('invalid') ||
203
- m.toLowerCase().includes('malformed') ||
204
- m.toLowerCase().includes('unhealthy') ||
205
- m.toLowerCase().includes('validation')
206
- );
207
- expect(unhealthyWarn).toBeDefined();
208
- });
209
-
210
- it('malformed result with non-boolean matched does not enforce and emits unhealthy evidence', async () => {
211
- // RuleCode returns { matched: "yes", decision: 'block', reason: 'valid' } — matched is a string
212
- const MALFORMED_CODE = `
213
- function evaluate(input, helpers) {
214
- return { matched: "yes", decision: 'block', reason: 'Blocked: system directory' };
215
- }
216
- var meta = { name: 'malformed-matched', version: '1', ruleId: '${RULE_ID}', coversCondition: 'all' };
217
- `;
218
- insertRuleArtifact({ contentJson: makeContentJson(RULE_ID, MALFORMED_CODE) });
219
- await insertCodeToolHookActivation();
220
-
221
- const warnCalls: string[] = [];
222
- const spyLogger: { warn: (_message: string) => void } = {
223
- warn: (message: string) => { warnCalls.push(message); },
224
- };
225
-
226
- const ruleHost = new RuleHost(tempStateDir, spyLogger, { workspaceDir: tempWorkspaceDir });
227
- const result = ruleHost.evaluate(makeInput('/etc/passwd'));
228
-
229
- expect(result).toBeUndefined();
230
- expect(warnCalls.length).toBeGreaterThan(0);
231
- const unhealthyWarn = warnCalls.find(m =>
232
- m.toLowerCase().includes('invalid') ||
233
- m.toLowerCase().includes('malformed') ||
234
- m.toLowerCase().includes('unhealthy') ||
235
- m.toLowerCase().includes('validation')
236
- );
237
- expect(unhealthyWarn).toBeDefined();
238
- });
239
-
240
- it('malformed result with invalid decision does not enforce and emits unhealthy evidence', async () => {
241
- // RuleCode returns { matched: true, decision: 'execute', reason: 'valid' } — decision is not one of the four
242
- const MALFORMED_CODE = `
243
- function evaluate(input, helpers) {
244
- return { matched: true, decision: 'execute', reason: 'do it' };
245
- }
246
- var meta = { name: 'malformed-decision', version: '1', ruleId: '${RULE_ID}', coversCondition: 'all' };
247
- `;
248
- insertRuleArtifact({ contentJson: makeContentJson(RULE_ID, MALFORMED_CODE) });
249
- await insertCodeToolHookActivation();
250
-
251
- const warnCalls: string[] = [];
252
- const spyLogger: { warn: (_message: string) => void } = {
253
- warn: (message: string) => { warnCalls.push(message); },
254
- };
255
-
256
- const ruleHost = new RuleHost(tempStateDir, spyLogger, { workspaceDir: tempWorkspaceDir });
257
- const result = ruleHost.evaluate(makeInput('/etc/passwd'));
258
-
259
- expect(result).toBeUndefined();
260
- expect(warnCalls.length).toBeGreaterThan(0);
261
- const unhealthyWarn = warnCalls.find(m =>
262
- m.toLowerCase().includes('invalid') ||
263
- m.toLowerCase().includes('malformed') ||
264
- m.toLowerCase().includes('unhealthy') ||
265
- m.toLowerCase().includes('validation')
266
- );
267
- expect(unhealthyWarn).toBeDefined();
268
- });
269
-
270
- it('null return from evaluate does not enforce and emits unhealthy evidence', async () => {
271
- const MALFORMED_CODE = `
272
- function evaluate(input, helpers) {
273
- return null;
274
- }
275
- var meta = { name: 'null-return', version: '1', ruleId: '${RULE_ID}', coversCondition: 'all' };
276
- `;
277
- insertRuleArtifact({ contentJson: makeContentJson(RULE_ID, MALFORMED_CODE) });
278
- await insertCodeToolHookActivation();
279
-
280
- const warnCalls: string[] = [];
281
- const spyLogger: { warn: (_message: string) => void } = {
282
- warn: (message: string) => { warnCalls.push(message); },
283
- };
284
-
285
- const ruleHost = new RuleHost(tempStateDir, spyLogger, { workspaceDir: tempWorkspaceDir });
286
- const result = ruleHost.evaluate(makeInput('/etc/passwd'));
287
-
288
- expect(result).toBeUndefined();
289
- expect(warnCalls.length).toBeGreaterThan(0);
290
- });
291
-
292
- it('valid block result still enforces correctly (no false positive rejection)', async () => {
293
- const VALID_CODE = `
294
- function evaluate(input, helpers) {
295
- var p = input.action.normalizedPath || '';
296
- if (p.startsWith('/etc')) {
297
- return { decision: 'block', matched: true, reason: 'Blocked: system directory' };
298
- }
299
- return { decision: 'allow', matched: false, reason: 'Not matched' };
300
- }
301
- var meta = { name: 'valid-rule', version: '1', ruleId: '${RULE_ID}', coversCondition: 'all' };
302
- `;
303
- insertRuleArtifact({ contentJson: makeContentJson(RULE_ID, VALID_CODE) });
304
- await insertCodeToolHookActivation();
305
-
306
- const ruleHost = new RuleHost(tempStateDir, console, { workspaceDir: tempWorkspaceDir });
307
- const result = ruleHost.evaluate(makeInput('/etc/passwd'));
308
-
309
- expect(result).toBeDefined();
310
- expect(result?.decision).toBe('block');
311
- expect(result?.matched).toBe(true);
312
- expect(result?.reason).toBe('Blocked: system directory');
313
- expect(result?.ruleId).toBe(RULE_ID);
314
- });
315
- });
@@ -1,49 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { loadRuleImplementationModule } from '../../src/core/rule-implementation-runtime.js';
3
-
4
- describe('rule-implementation-runtime', () => {
5
- it('does not leak global mutations from loaded rule implementations into the host realm', () => {
6
- delete (globalThis as Record<string, unknown>).__pdRuleHostLeak;
7
-
8
- const moduleExports = loadRuleImplementationModule(
9
- `
10
- globalThis.__pdRuleHostLeak = 'sandbox-only';
11
- export const meta = {
12
- name: 'leak-check',
13
- version: '1.0.0',
14
- ruleId: 'R-LEAK',
15
- coversCondition: 'host isolation'
16
- };
17
-
18
- export function evaluate() {
19
- globalThis.__pdRuleHostLeak = 'still-sandboxed';
20
- return {
21
- decision: 'allow',
22
- matched: false,
23
- reason: 'ok'
24
- };
25
- }
26
- `,
27
- 'rule-leak-check.js',
28
- );
29
-
30
- expect(typeof moduleExports.evaluate).toBe('function');
31
- expect((globalThis as Record<string, unknown>).__pdRuleHostLeak).toBeUndefined();
32
-
33
- (moduleExports.evaluate as () => unknown)();
34
-
35
- expect((globalThis as Record<string, unknown>).__pdRuleHostLeak).toBeUndefined();
36
- });
37
-
38
- it('contains memory-exhausting evaluation in a resource-limited worker', () => {
39
- const moduleExports = loadRuleImplementationModule(
40
- `export function evaluate() {
41
- const memoryBomb = new Array(100_000_000).fill('x');
42
- return { decision: 'allow', matched: false, reason: String(memoryBomb.length) };
43
- }`,
44
- 'rule-memory-limit.js',
45
- );
46
-
47
- expect(() => moduleExports.callEvaluate?.({}, {})).toThrow(/worker|memory|heap|timed out|exited without a valid result/i);
48
- });
49
- });