principles-disciple 1.126.0 → 1.128.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 -93
  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,191 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
2
- import * as fs from 'fs';
3
- import * as os from 'os';
4
- import * as path from 'path';
5
- import {
6
- trackToolRead,
7
- trackLlmOutput,
8
- getSession,
9
- clearSession,
10
- trackFriction,
11
- resetFriction,
12
- initPersistence,
13
- trackBlock,
14
- recordThinkingCheckpoint,
15
- } from '../../src/core/session-tracker.js';
16
-
17
- describe('Session Tracker', () => {
18
- const sessionId = 'test-session-1';
19
- let tempDir: string | null = null;
20
-
21
- beforeEach(() => {
22
- clearSession(sessionId);
23
- });
24
-
25
- afterEach(() => {
26
- if (tempDir) {
27
- fs.rmSync(tempDir, { recursive: true, force: true });
28
- tempDir = null;
29
- }
30
- vi.useRealTimers();
31
- clearSession('session-a');
32
- clearSession('session-b');
33
- });
34
-
35
- it('should track tool reads per file', () => {
36
- trackToolRead(sessionId, 'src/main.ts');
37
- trackToolRead(sessionId, 'src/main.ts');
38
- trackToolRead(sessionId, 'docs/README.md');
39
-
40
- const state = getSession(sessionId);
41
- expect(state).toBeDefined();
42
- expect(state?.toolReadsByFile['src/main.ts']).toBe(2);
43
- expect(state?.toolReadsByFile['docs/README.md']).toBe(1);
44
- });
45
-
46
- it('should detect stuck loops (paralysis) on high input / tiny output', () => {
47
- // 1st turn
48
- trackLlmOutput(sessionId, { input: 100, output: 500 });
49
- // 2nd turn
50
- trackLlmOutput(sessionId, { input: 8500, output: 20 });
51
- // 3rd turn
52
- trackLlmOutput(sessionId, { input: 8800, output: 15 });
53
- // 4th turn
54
- trackLlmOutput(sessionId, { input: 9000, output: 10 });
55
- // 5th turn
56
- trackLlmOutput(sessionId, { input: 9100, output: 8 });
57
-
58
- let state = getSession(sessionId);
59
- expect(state?.stuckLoops).toBe(0); // Needs > 5 turns total
60
-
61
- // 6th turn (should trigger loop detection)
62
- trackLlmOutput(sessionId, { input: 9200, output: 10 });
63
- state = getSession(sessionId);
64
- expect(state?.stuckLoops).toBe(1);
65
-
66
- // 7th turn (continues loop)
67
- trackLlmOutput(sessionId, { input: 9300, output: 5 });
68
- state = getSession(sessionId);
69
- expect(state?.stuckLoops).toBe(2);
70
-
71
- // 8th turn (breaks out, high output)
72
- trackLlmOutput(sessionId, { input: 9400, output: 300 });
73
- state = getSession(sessionId);
74
- expect(state?.stuckLoops).toBe(1); // decrements
75
- });
76
-
77
- it('should accumulate friction and reset on success', () => {
78
- const errorHash = 'abc-123';
79
-
80
- // 1st error
81
- trackFriction(sessionId, 30, errorHash);
82
- let state = getSession(sessionId);
83
- expect(state?.currentGfi).toBe(30);
84
- expect(state?.consecutiveErrors).toBe(1);
85
-
86
- // 2nd identical error (multiplier 1.5^1 = 1.5)
87
- trackFriction(sessionId, 30, errorHash);
88
- state = getSession(sessionId);
89
- expect(state?.currentGfi).toBe(30 + (30 * 1.5)); // 75
90
- expect(state?.consecutiveErrors).toBe(2);
91
-
92
- // 3rd identical error (multiplier 1.5^2 = 2.25)
93
- trackFriction(sessionId, 30, errorHash);
94
- state = getSession(sessionId);
95
- expect(state?.currentGfi).toBe(75 + (30 * 2.25)); // 75 + 67.5 = 142.5
96
- expect(state?.consecutiveErrors).toBe(3);
97
-
98
- // Success should reset GFI
99
- resetFriction(sessionId);
100
- state = getSession(sessionId);
101
- expect(state?.currentGfi).toBe(0);
102
- expect(state?.consecutiveErrors).toBe(0);
103
- expect(state?.gfiBySource).toEqual({});
104
- });
105
-
106
- it('should reset multiplier on different error hash', () => {
107
- trackFriction(sessionId, 30, 'hash-1');
108
- trackFriction(sessionId, 30, 'hash-2');
109
-
110
- let state = getSession(sessionId);
111
- expect(state?.currentGfi).toBe(60); // 30 + 30
112
- expect(state?.consecutiveErrors).toBe(1); // reset to 1 for new hash
113
- });
114
-
115
- it('should rollback only the empathy source slice instead of wiping total gfi', () => {
116
- trackFriction(sessionId, 30, 'tool_failure_hash');
117
- trackFriction(sessionId, 20, 'user_empathy_moderate', undefined, { source: 'user_empathy' });
118
-
119
- let state = getSession(sessionId);
120
- expect(state?.currentGfi).toBe(50);
121
- expect(state?.gfiBySource).toEqual({
122
- 'unattributed:tool_failure_hash': 30,
123
- user_empathy: 20,
124
- });
125
-
126
- resetFriction(sessionId, undefined, { source: 'user_empathy', amount: 20 });
127
-
128
- state = getSession(sessionId);
129
- expect(state?.currentGfi).toBe(30);
130
- expect(state?.gfiBySource).toEqual({
131
- 'unattributed:tool_failure_hash': 30,
132
- });
133
- expect(state?.consecutiveErrors).toBe(0);
134
- expect(state?.lastErrorHash).toBe('');
135
- expect(state?.lastErrorSource).toBe('');
136
- });
137
-
138
- it('should clamp slice rollback amount and preserve other source ledger entries', () => {
139
- trackFriction(sessionId, 10, 'tool_failure_hash');
140
- trackFriction(sessionId, 15, 'user_empathy_mild', undefined, { source: 'user_empathy' });
141
- trackFriction(sessionId, 5, 'system_empathy_warn', undefined, { source: 'system_infer' });
142
-
143
- resetFriction(sessionId, undefined, { source: 'user_empathy', amount: 999 });
144
-
145
- const state = getSession(sessionId);
146
- expect(state?.currentGfi).toBe(15);
147
- expect(state?.gfiBySource).toEqual({
148
- 'unattributed:tool_failure_hash': 10,
149
- system_infer: 5,
150
- });
151
- });
152
-
153
- it('should ignore slice rollback for a source that does not exist', () => {
154
- trackFriction(sessionId, 12, 'tool_failure_hash');
155
-
156
- resetFriction(sessionId, undefined, { source: 'user_empathy', amount: 7 });
157
-
158
- const state = getSession(sessionId);
159
- expect(state?.currentGfi).toBe(12);
160
- expect(state?.gfiBySource).toEqual({
161
- 'unattributed:tool_failure_hash': 12,
162
- });
163
- expect(state?.consecutiveErrors).toBe(1);
164
- expect(state?.lastErrorHash).toBe('tool_failure_hash');
165
- });
166
-
167
- it('should persist multiple sessions independently instead of overwriting the previous debounce timer', () => {
168
- vi.useFakeTimers();
169
- tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-session-persist-'));
170
- initPersistence(tempDir);
171
-
172
- trackFriction('session-a', 10, 'hash-a', tempDir);
173
- trackFriction('session-b', 15, 'hash-b', tempDir);
174
-
175
- vi.advanceTimersByTime(1000);
176
-
177
- expect(fs.existsSync(path.join(tempDir, 'sessions', 'session-a.json'))).toBe(true);
178
- expect(fs.existsSync(path.join(tempDir, 'sessions', 'session-b.json'))).toBe(true);
179
- });
180
-
181
- it('should refresh control activity timestamps for block and thinking updates', () => {
182
- trackBlock(sessionId);
183
- let state = getSession(sessionId);
184
- const blockTs = state?.lastControlActivityAt ?? 0;
185
- expect(blockTs).toBeGreaterThan(0);
186
-
187
- recordThinkingCheckpoint(sessionId);
188
- state = getSession(sessionId);
189
- expect((state?.lastControlActivityAt ?? 0) >= blockTs).toBe(true);
190
- });
191
- });
@@ -1,338 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import {
3
- checkSurfaceGuard,
4
- isSurfaceEnabled,
5
- guardHook,
6
- guardService,
7
- getSurfaceIdForHook,
8
- getSurfaceIdForService,
9
- __resetSurfaceGuardSkipLogStateForTests,
10
- } from '../../src/core/surface-guard.js';
11
- import { PLUGIN_SURFACE_REGISTRY } from '@principles/core/runtime-v2';
12
- import type { OpenClawPluginService } from '../../src/openclaw-sdk.js';
13
-
14
- describe('surface-guard', () => {
15
- beforeEach(() => {
16
- // Each test starts with a clean surface-guard skip log state so the
17
- // first-fire assertions are deterministic (PRI-298).
18
- __resetSurfaceGuardSkipLogStateForTests();
19
- vi.clearAllMocks();
20
- });
21
- describe('getSurfaceIdForHook', () => {
22
- it('generates correct surface id without label', () => {
23
- expect(getSurfaceIdForHook('before_tool_call')).toBe('hook:before_tool_call');
24
- });
25
-
26
- it('generates correct surface id with label', () => {
27
- expect(getSurfaceIdForHook('after_tool_call', 'trajectory')).toBe('hook:after_tool_call.trajectory');
28
- });
29
- });
30
-
31
- describe('getSurfaceIdForService', () => {
32
- it('generates correct surface id for service', () => {
33
- expect(getSurfaceIdForService('evolution-worker')).toBe('service:evolution-worker');
34
- });
35
- });
36
-
37
- describe('checkSurfaceGuard', () => {
38
- it('returns passed=true when registry is valid', () => {
39
- const result = checkSurfaceGuard();
40
- expect(result.passed).toBe(true);
41
- expect(result.violations).toEqual([]);
42
- });
43
-
44
- it('includes enabled core surfaces', () => {
45
- const result = checkSurfaceGuard();
46
- expect(result.enabledCoreSurfaces.length).toBeGreaterThan(0);
47
- for (const surfaceId of result.enabledCoreSurfaces) {
48
- const entry = PLUGIN_SURFACE_REGISTRY.find(s => s.id === surfaceId);
49
- expect(entry).toBeDefined();
50
- expect(entry?.category).toBe('core');
51
- }
52
- });
53
-
54
- it('includes disabled non-core surfaces', () => {
55
- const result = checkSurfaceGuard();
56
- expect(result.disabledNonCoreSurfaces.length).toBeGreaterThan(0);
57
- for (const surfaceId of result.disabledNonCoreSurfaces) {
58
- const entry = PLUGIN_SURFACE_REGISTRY.find(s => s.id === surfaceId);
59
- expect(entry).toBeDefined();
60
- expect(entry?.category).not.toBe('core');
61
- expect(entry?.enabledByDefault).toBe(false);
62
- }
63
- });
64
-
65
- it('returns violations when non-core surface is enabledByDefault', () => {
66
- const result = checkSurfaceGuard();
67
- const nonCoreEnabled = PLUGIN_SURFACE_REGISTRY.filter(
68
- s => s.category !== 'core' && s.enabledByDefault,
69
- );
70
- if (nonCoreEnabled.length > 0) {
71
- expect(result.violations.length).toBeGreaterThan(0);
72
- }
73
- });
74
- });
75
-
76
- describe('isSurfaceEnabled', () => {
77
- it('returns enabled=true for core surface without override', () => {
78
- const result = isSurfaceEnabled('hook:before_prompt_build');
79
- expect(result.enabled).toBe(true);
80
- expect(result.reason).toBeUndefined();
81
- });
82
-
83
- it('returns enabled=false for quiet surface without override', () => {
84
- const result = isSurfaceEnabled('hook:after_tool_call.trajectory');
85
- expect(result.enabled).toBe(false);
86
- expect(result.reason).toBeDefined();
87
- });
88
-
89
- it('returns reason when surface not found', () => {
90
- const result = isSurfaceEnabled('hook:nonexistent_hook');
91
- expect(result.enabled).toBe(false);
92
- expect(result.reason).toContain('not found in registry');
93
- });
94
-
95
- it('allows override for quiet surface', () => {
96
- const result = isSurfaceEnabled('hook:subagent_spawning', {
97
- 'hook:subagent_spawning': true,
98
- });
99
- expect(result.enabled).toBe(true);
100
- });
101
-
102
- it('ignores non-boolean override', () => {
103
- const result = isSurfaceEnabled('hook:before_prompt_build', {
104
- 'hook:before_prompt_build': 'yes' as unknown as boolean,
105
- });
106
- expect(result.enabled).toBe(true);
107
- });
108
-
109
- it('cannot disable core surface', () => {
110
- const result = isSurfaceEnabled('hook:before_prompt_build', {
111
- 'hook:before_prompt_build': false,
112
- });
113
- expect(result.enabled).toBe(true);
114
- expect(result.reason).toContain('core');
115
- });
116
-
117
- it('returns disabledReason for disabled surface', () => {
118
- const result = isSurfaceEnabled('service:evolution-worker');
119
- expect(result.enabled).toBe(false);
120
- expect(result.reason).toContain('evolution_worker');
121
- });
122
- });
123
-
124
- describe('guardHook', () => {
125
- beforeEach(() => {
126
- vi.clearAllMocks();
127
- });
128
-
129
- it('returns original handler for enabled surface', () => {
130
- const mockHandler = vi.fn().mockReturnValue('result');
131
- const guarded = guardHook('hook:before_prompt_build', undefined, mockHandler);
132
- const result = guarded({}, {});
133
- expect(mockHandler).toHaveBeenCalled();
134
- expect(result).toBe('result');
135
- });
136
-
137
- it('returns no-op for disabled surface without logger', () => {
138
- const mockHandler = vi.fn();
139
- const guarded = guardHook('hook:after_tool_call.trajectory', undefined, mockHandler);
140
- const result = guarded({}, {});
141
- expect(mockHandler).not.toHaveBeenCalled();
142
- expect(result).toBeUndefined();
143
- });
144
-
145
- it('logs when surface is disabled with logger', () => {
146
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
147
- const mockHandler = vi.fn();
148
- const guarded = guardHook('hook:after_tool_call.trajectory', mockLogger, mockHandler);
149
- guarded({}, {});
150
- expect(mockLogger.info).toHaveBeenCalled();
151
- expect(mockHandler).not.toHaveBeenCalled();
152
- });
153
-
154
- it('does not log at guardHook construction time (PRI-298 / chatgpt P2)', () => {
155
- // Registering a guard for a quiet hook must not emit the SKIP line on
156
- // its own; the log fires only when the returned no-op is actually
157
- // invoked. Plugin startup that registers a dozen quiet hooks would
158
- // otherwise log a dozen SKIP lines before any real traffic.
159
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
160
- guardHook('hook:after_tool_call.trajectory', mockLogger, vi.fn());
161
- expect(mockLogger.info).not.toHaveBeenCalled();
162
- });
163
-
164
- it('logger undefined on first fire does not consume the one-shot slot (PRI-298 / coderabbit Major)', () => {
165
- // First call has no logger — the no-op still suppresses the handler,
166
- // and the once-only slot is preserved for a later call that does
167
- // have a logger.
168
- const handler1 = guardHook('hook:after_tool_call.trajectory', undefined, vi.fn());
169
- handler1({}, {});
170
-
171
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
172
- const handler2 = guardHook('hook:after_tool_call.trajectory', mockLogger, vi.fn());
173
- handler2({}, {});
174
-
175
- // Only the second call (which had a logger) should have emitted a log.
176
- expect(mockLogger.info).toHaveBeenCalledTimes(1);
177
- expect(mockLogger.info).toHaveBeenCalledWith(
178
- expect.stringContaining('[PD:surface-guard] SKIP hook:after_tool_call.trajectory'),
179
- );
180
-
181
- // A third call should now be silent (slot consumed by the second call).
182
- const handler3 = guardHook('hook:after_tool_call.trajectory', mockLogger, vi.fn());
183
- handler3({}, {});
184
- expect(mockLogger.info).toHaveBeenCalledTimes(1);
185
- });
186
-
187
- it('does not log for enabled surface', () => {
188
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
189
- const mockHandler = vi.fn();
190
- const guarded = guardHook('hook:before_prompt_build', mockLogger, mockHandler);
191
- guarded({}, {});
192
- expect(mockLogger.info).not.toHaveBeenCalled();
193
- });
194
-
195
- it('guards unknown surface with not-found reason', () => {
196
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
197
- const guarded = guardHook('hook:unknown_hook', mockLogger, vi.fn());
198
- guarded({}, {});
199
- expect(mockLogger.info).toHaveBeenCalledWith(
200
- expect.stringContaining('not found in registry'),
201
- );
202
- });
203
-
204
- it('logs once on first fire and stays silent on subsequent fires (PRI-298 rate-limit)', () => {
205
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
206
- const mockHandler = vi.fn();
207
- const guarded = guardHook('hook:after_tool_call.trajectory', mockLogger, mockHandler);
208
-
209
- // First fire: log is emitted once with the disabled reason.
210
- guarded({}, {});
211
- expect(mockLogger.info).toHaveBeenCalledTimes(1);
212
- expect(mockLogger.info).toHaveBeenCalledWith(
213
- expect.stringContaining('[PD:surface-guard] SKIP hook:after_tool_call.trajectory'),
214
- );
215
-
216
- // Subsequent fires on the same surfaceId: no further log noise, but the
217
- // handler is still suppressed (observability remains: the no-op returns
218
- // undefined; the surface is still classified as disabled).
219
- for (let i = 0; i < 5; i += 1) {
220
- guarded({}, {});
221
- }
222
- expect(mockLogger.info).toHaveBeenCalledTimes(1);
223
- expect(mockHandler).not.toHaveBeenCalled();
224
- });
225
-
226
- it('logs first fire per surfaceId independently (one log per quiet surface)', () => {
227
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
228
- const handler1 = guardHook('hook:after_tool_call.trajectory', mockLogger, vi.fn());
229
- const handler2 = guardHook('hook:llm_output.trajectory', mockLogger, vi.fn());
230
- const handler3 = guardHook('hook:subagent_spawning', mockLogger, vi.fn());
231
-
232
- handler1({}, {});
233
- handler2({}, {});
234
- handler3({}, {});
235
-
236
- expect(mockLogger.info).toHaveBeenCalledTimes(3);
237
- const calls = mockLogger.info.mock.calls.map(c => String(c[0]));
238
- expect(calls.some(c => c.includes('hook:after_tool_call.trajectory'))).toBe(true);
239
- expect(calls.some(c => c.includes('hook:llm_output.trajectory'))).toBe(true);
240
- expect(calls.some(c => c.includes('hook:subagent_spawning'))).toBe(true);
241
- });
242
- });
243
-
244
- describe('guardService', () => {
245
- beforeEach(() => {
246
- vi.clearAllMocks();
247
- });
248
-
249
- it('returns original service for enabled surface', () => {
250
- const mockService: OpenClawPluginService = { id: 'test-service' };
251
- const result = guardService('hook:before_prompt_build', mockService);
252
- expect(result).toBe(mockService);
253
- });
254
-
255
- it('returns null for disabled surface without logger', () => {
256
- const mockService: OpenClawPluginService = { id: 'test-service' };
257
- const result = guardService('hook:after_tool_call.trajectory', mockService);
258
- expect(result).toBeNull();
259
- });
260
-
261
- it('logs when surface is disabled with logger', () => {
262
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
263
- const mockService: OpenClawPluginService = { id: 'test-service' };
264
- const result = guardService('hook:after_tool_call.trajectory', mockService, mockLogger);
265
- expect(result).toBeNull();
266
- expect(mockLogger.info).toHaveBeenCalledWith(
267
- expect.stringContaining('SKIP service'),
268
- );
269
- });
270
-
271
- it('returns null for unknown surface', () => {
272
- const mockService: OpenClawPluginService = { id: 'test-service' };
273
- const result = guardService('service:nonexistent', mockService);
274
- expect(result).toBeNull();
275
- });
276
-
277
- it('logs once per service surface on first registration (PRI-298 rate-limit)', () => {
278
- const mockLogger = { info: vi.fn(), debug: vi.fn() };
279
- const service: OpenClawPluginService = { id: 'test-service' };
280
-
281
- // service:evolution-worker is quiet/disabled — use it for the rate-limit test.
282
- const first = guardService('service:evolution-worker', service, mockLogger);
283
- expect(first).toBeNull();
284
- expect(mockLogger.info).toHaveBeenCalledTimes(1);
285
- expect(mockLogger.info).toHaveBeenCalledWith(
286
- expect.stringContaining('SKIP service service:evolution-worker'),
287
- );
288
-
289
- // Subsequent guardService calls for the same surfaceId stay silent.
290
- guardService('service:evolution-worker', service, mockLogger);
291
- guardService('service:evolution-worker', service, mockLogger);
292
- expect(mockLogger.info).toHaveBeenCalledTimes(1);
293
- });
294
- });
295
-
296
- describe('PRI-298 disabledReason copy', () => {
297
- it('no quiet surface disabledReason references "Story A" or "Story A\'"', () => {
298
- const quietOrNonCore = PLUGIN_SURFACE_REGISTRY.filter(
299
- s => s.category === 'quiet' || s.category === 'gone' || s.category === 'legacy_retire',
300
- );
301
- expect(quietOrNonCore.length).toBeGreaterThan(0);
302
- for (const surface of quietOrNonCore) {
303
- expect(surface.disabledReason).toBeDefined();
304
- // MVP residue that should not appear in production log copy.
305
- expect(surface.disabledReason).not.toMatch(/Story A/);
306
- expect(surface.disabledReason).not.toMatch(/MVP\s*验收/);
307
- expect(surface.disabledReason).not.toMatch(/测试任务/);
308
- }
309
- });
310
-
311
- it('subagent hook disabledReason is opt-in and ADR-anchored (PRI-298)', () => {
312
- const subagent = PLUGIN_SURFACE_REGISTRY.find(
313
- s => s.id === 'hook:subagent_spawning',
314
- );
315
- expect(subagent?.disabledReason).toBeDefined();
316
- const reason = subagent!.disabledReason!.toLowerCase();
317
- // Quiet hook copy is opt-in / opt-out anchored on a real ADR section
318
- expect(reason).toContain('opt-in');
319
- expect(reason).toContain('default off');
320
- expect(reason).toMatch(/adr-?0014/);
321
- });
322
-
323
- it('no quiet surface disabledReason promises a feature flag override (PRI-298 / chatgpt P2)', () => {
324
- // The runtime guard path (`isSurfaceEnabled(surfaceId)` with no
325
- // overrides argument) does not consume `.pd/config.yaml`, so
326
- // telling operators to "enable via feature flag override" would be
327
- // an impossible next action. Quiet copy must describe the surface
328
- // honestly without pointing to a non-existent override path.
329
- const quiet = PLUGIN_SURFACE_REGISTRY.filter(s => s.category === 'quiet');
330
- expect(quiet.length).toBeGreaterThan(0);
331
- for (const surface of quiet) {
332
- const reason = surface.disabledReason!.toLowerCase();
333
- expect(reason).not.toContain('enable via feature flag');
334
- expect(reason).not.toMatch(/enable via .* override/);
335
- }
336
- });
337
- });
338
- });
@@ -1,101 +0,0 @@
1
- import { describe, it, expect } from 'vitest';
2
- import { generateFromTemplate, PainPattern } from '../../src/core/principle-compiler/template-generator';
3
-
4
- describe('generateFromTemplate', () => {
5
- it('should generate code for a single tool with path pattern', () => {
6
- const patterns: PainPattern[] = [
7
- { toolName: 'write', pathRegex: 'secrets/.*\\.env' },
8
- ];
9
-
10
- const result = generateFromTemplate('P_066', 'Writing to secrets directory', patterns);
11
-
12
- expect(result).not.toBeNull();
13
- expect(result).toContain("export const meta");
14
- expect(result).toContain("export function evaluate(input)");
15
- expect(result).toContain('name: "Auto_P_066"');
16
- expect(result).toContain('ruleId: "R_P_066_auto"');
17
- expect(result).toContain('sourcePrincipleId: "P_066"');
18
- expect(result).toContain('coversCondition: "Writing to secrets directory"');
19
- expect(result).toContain('input.action.toolName === "write"');
20
- expect(result).toContain("secrets/.*\\\\.env");
21
- expect(result).toContain("input.action.normalizedPath");
22
- expect(result).toContain("decision: 'block'");
23
- expect(result).toContain("matched: true");
24
- expect(result).toContain("[P_066]");
25
- });
26
-
27
- it('should generate code for write tool with content pattern', () => {
28
- const patterns: PainPattern[] = [
29
- { toolName: 'write', contentRegex: 'BEGIN RSA PRIVATE KEY' },
30
- ];
31
-
32
- const result = generateFromTemplate('P_007', 'Writing private keys', patterns);
33
-
34
- expect(result).not.toBeNull();
35
- expect(result).toContain('input.action.toolName === "write"');
36
- expect(result).toContain("BEGIN RSA PRIVATE KEY");
37
- expect(result).toContain("paramsSummary.content");
38
- });
39
-
40
- it('should generate code for multiple tool patterns', () => {
41
- const patterns: PainPattern[] = [
42
- { toolName: 'bash', commandRegex: 'rm\\s+-rf\\s+/' },
43
- { toolName: 'write', pathRegex: 'secrets/', contentRegex: 'password' },
44
- ];
45
-
46
- const result = generateFromTemplate('P_010', 'Destructive operations', patterns);
47
-
48
- expect(result).not.toBeNull();
49
- expect(result).toContain('input.action.toolName === "bash"');
50
- expect(result).toContain("rm\\\\s+-rf\\\\s+/");
51
- expect(result).toContain("paramsSummary.command");
52
- expect(result).toContain('input.action.toolName === "write"');
53
- expect(result).toContain("secrets/");
54
- expect(result).toContain("password");
55
- });
56
-
57
- it('should return null when patterns array is empty', () => {
58
- const result = generateFromTemplate('P_066', 'some condition', []);
59
- expect(result).toBeNull();
60
- });
61
-
62
- it('should not contain forbidden patterns (require, import, fetch)', () => {
63
- const patterns: PainPattern[] = [
64
- { toolName: 'bash', commandRegex: 'dangerous' },
65
- ];
66
-
67
- const result = generateFromTemplate('P_099', 'Dangerous commands', patterns);
68
-
69
- expect(result).not.toBeNull();
70
- expect(result).not.toContain('require(');
71
- expect(result).not.toContain('import ');
72
- expect(result).not.toContain('fetch(');
73
- });
74
-
75
- it('should have proper structure with meta and evaluate function', () => {
76
- const patterns: PainPattern[] = [
77
- { toolName: 'edit', pathRegex: '\\.json$', contentRegex: 'admin.*true' },
78
- ];
79
-
80
- const result = generateFromTemplate('P_050', 'Modifying admin config', patterns);
81
-
82
- expect(result).not.toBeNull();
83
-
84
- // Check meta structure
85
- expect(result).toMatch(/export const meta = \{/);
86
- expect(result).toMatch(/name: "Auto_P_050"/);
87
- expect(result).toMatch(/version: '1\.0\.0'/);
88
- expect(result).toMatch(/ruleId: "R_P_050_auto"/);
89
- expect(result).toMatch(/sourcePrincipleId: "P_050"/);
90
- expect(result).toMatch(/compiledAt: "\d{4}-\d{2}-\d{2}T/);
91
-
92
- // Check evaluate function structure
93
- expect(result).toMatch(/export function evaluate\(input\)/);
94
- expect(result).toMatch(/decision: 'block'/);
95
- expect(result).toMatch(/matched: true/);
96
- expect(result).toMatch(/return \{ matched: false \}/);
97
-
98
- // Check edit tool uses new_string fallback
99
- expect(result).toContain("input.action.paramsSummary.content || input.action.paramsSummary.new_string");
100
- });
101
- });