principles-disciple 1.72.0 → 1.74.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 (319) hide show
  1. package/INSTALL.md +1 -3
  2. package/openclaw.plugin.json +10 -5
  3. package/package.json +17 -19
  4. package/scripts/acceptance-test.mjs +16 -73
  5. package/scripts/sync-plugin.mjs +382 -77
  6. package/src/commands/archive-impl.ts +2 -1
  7. package/src/commands/capabilities.ts +2 -2
  8. package/src/commands/context.ts +2 -2
  9. package/src/commands/disable-impl.ts +2 -1
  10. package/src/commands/evolution-status.ts +16 -16
  11. package/src/commands/export.ts +12 -67
  12. package/src/commands/pain.ts +91 -1
  13. package/src/commands/principle-rollback.ts +2 -1
  14. package/src/commands/promote-impl.ts +7 -43
  15. package/src/commands/rollback-impl.ts +2 -1
  16. package/src/commands/rollback.ts +2 -1
  17. package/src/commands/samples.ts +2 -1
  18. package/src/commands/thinking-os.ts +2 -1
  19. package/src/config/errors.ts +18 -2
  20. package/src/constants/diagnostician.ts +2 -2
  21. package/src/constants/tools.ts +2 -1
  22. package/src/core/__tests__/focus-history.test.ts +210 -0
  23. package/src/core/config.ts +1 -1
  24. package/src/core/correction-cue-learner.ts +2 -136
  25. package/src/core/correction-types.ts +16 -88
  26. package/src/core/dictionary.ts +19 -20
  27. package/src/core/empathy-keyword-matcher.ts +17 -289
  28. package/src/core/empathy-types.ts +18 -229
  29. package/src/core/event-log.ts +29 -132
  30. package/src/core/evolution-reducer.ts +21 -2
  31. package/src/core/evolution-types.ts +76 -464
  32. package/src/core/file-store.ts +80 -0
  33. package/src/core/focus-history.ts +228 -955
  34. package/src/core/local-worker-routing.ts +34 -314
  35. package/src/core/merge-gate-audit.ts +0 -195
  36. package/src/core/migration.ts +0 -1
  37. package/src/core/pain-diagnostic-gate.ts +154 -0
  38. package/src/core/pain-signal.ts +21 -138
  39. package/src/core/pain.ts +15 -88
  40. package/src/core/path-resolver.ts +0 -1
  41. package/src/core/paths.ts +0 -1
  42. package/src/core/pd-task-reconciler.ts +26 -115
  43. package/src/core/pd-task-service.ts +9 -9
  44. package/src/core/pd-task-types.ts +23 -127
  45. package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +174 -0
  46. package/src/core/principle-compiler/code-validator.ts +15 -42
  47. package/src/core/principle-compiler/compiler.ts +100 -15
  48. package/src/core/principle-compiler/index.ts +5 -2
  49. package/src/core/principle-compiler/template-generator.ts +4 -104
  50. package/src/core/principle-injection.ts +10 -202
  51. package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +42 -0
  52. package/src/core/principle-internalization/lifecycle-read-model.ts +39 -242
  53. package/src/core/principle-internalization/principle-lifecycle-service.ts +12 -10
  54. package/src/core/principle-tree-ledger-adapter.ts +145 -0
  55. package/src/core/principle-tree-ledger.ts +8 -6
  56. package/src/core/reflection/reflection-context.ts +14 -109
  57. package/src/core/replay-engine.ts +8 -500
  58. package/src/core/rule-host-helpers.ts +5 -35
  59. package/src/core/rule-host-types.ts +10 -82
  60. package/src/core/rule-host.ts +6 -63
  61. package/src/core/runtime-v2-prompt-activation-reader.ts +231 -0
  62. package/src/core/session-tracker.ts +87 -101
  63. package/src/core/shadow-observation-registry.ts +19 -48
  64. package/src/core/trajectory.ts +3 -1
  65. package/src/core/workflow-funnel-loader.ts +62 -68
  66. package/src/core/workspace-context.ts +46 -0
  67. package/src/core/workspace-dir-service.ts +1 -1
  68. package/src/core/workspace-dir-validation.ts +18 -9
  69. package/src/hooks/AGENTS.md +1 -1
  70. package/src/hooks/gate-block-helper.ts +71 -64
  71. package/src/hooks/gate.ts +183 -31
  72. package/src/hooks/lifecycle.ts +30 -32
  73. package/src/hooks/llm.ts +60 -32
  74. package/src/hooks/pain.ts +297 -103
  75. package/src/hooks/prompt.ts +400 -440
  76. package/src/hooks/subagent.ts +2 -29
  77. package/src/i18n/commands.ts +2 -10
  78. package/src/index.ts +95 -85
  79. package/src/openclaw-sdk.ts +311 -0
  80. package/src/service/central-database.ts +8 -4
  81. package/src/service/evolution-queue-migration.ts +2 -1
  82. package/src/service/evolution-worker.ts +163 -1786
  83. package/src/service/internalization-trigger-adapter.ts +302 -0
  84. package/src/service/keyword-optimization-service.ts +4 -4
  85. package/src/service/monitoring-query-service.ts +1 -215
  86. package/src/service/queue-io.ts +60 -331
  87. package/src/service/runtime-summary-service.ts +59 -16
  88. package/src/service/subagent-workflow/index.ts +0 -41
  89. package/src/service/subagent-workflow/types.ts +9 -120
  90. package/src/service/subagent-workflow/workflow-store.ts +2 -119
  91. package/src/service/workflow-watchdog.ts +0 -43
  92. package/src/types/event-payload.ts +16 -74
  93. package/src/types/event-types.ts +38 -547
  94. package/src/types/hygiene-types.ts +7 -30
  95. package/src/types/principle-tree-schema.ts +20 -222
  96. package/src/types/queue.ts +15 -70
  97. package/src/types/runtime-summary.ts +5 -49
  98. package/src/utils/io.ts +8 -20
  99. package/src/utils/retry.ts +1 -1
  100. package/src/utils/shadow-fingerprint.ts +2 -2
  101. package/src/utils/workspace-resolver.ts +50 -0
  102. package/templates/langs/en/core/AGENTS.md +7 -7
  103. package/templates/langs/en/core/BOOT.md +1 -1
  104. package/templates/langs/en/core/HEARTBEAT.md +2 -2
  105. package/templates/langs/en/principles/THINKING_OS.md +3 -2
  106. package/templates/langs/en/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
  107. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
  108. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
  109. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
  110. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
  111. package/templates/langs/en/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
  112. package/templates/langs/en/skills/evolve-task/SKILL.md +3 -3
  113. package/templates/langs/en/skills/pd-cli-operator/SKILL.md +67 -0
  114. package/templates/langs/en/skills/pd-diagnostician/SKILL.md +1 -1
  115. package/templates/langs/en/skills/pd-mentor/SKILL.md +2 -3
  116. package/templates/langs/en/skills/pd-pain-signal/SKILL.md +17 -39
  117. package/templates/langs/en/skills/pd-runtime-v2/SKILL.md +61 -0
  118. package/templates/langs/zh/core/AGENTS.md +7 -7
  119. package/templates/langs/zh/core/BOOT.md +1 -1
  120. package/templates/langs/zh/core/HEARTBEAT.md +2 -2
  121. package/templates/langs/zh/principles/THINKING_OS.md +3 -2
  122. package/templates/langs/zh/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
  123. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
  124. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
  125. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/nocturnal-trinity-quality-enhancement.json +8 -8
  126. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
  127. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
  128. package/templates/langs/zh/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
  129. package/templates/langs/zh/skills/ai-sprint-orchestration/test/run.test.mjs +21 -5
  130. package/templates/langs/zh/skills/evolve-task/SKILL.md +4 -4
  131. package/templates/langs/zh/skills/pd-cli-operator/SKILL.md +67 -0
  132. package/templates/langs/zh/skills/pd-diagnostician/SKILL.md +1 -1
  133. package/templates/langs/zh/skills/pd-mentor/SKILL.md +2 -3
  134. package/templates/langs/zh/skills/pd-pain-signal/SKILL.md +17 -38
  135. package/templates/langs/zh/skills/pd-runtime-v2/SKILL.md +61 -0
  136. package/tests/build-artifacts.test.ts +1 -3
  137. package/tests/commands/evolution-status.test.ts +0 -118
  138. package/tests/core/bootstrap-rules.test.ts +1 -1
  139. package/tests/core/config.test.ts +1 -1
  140. package/tests/core/event-log.test.ts +35 -0
  141. package/tests/core/evolution-engine.test.ts +610 -0
  142. package/tests/core/file-store.test.ts +102 -0
  143. package/tests/core/focus-history.test.ts +203 -11
  144. package/tests/core/merge-gate-audit.test.ts +2 -169
  145. package/tests/core/migration.test.ts +7 -7
  146. package/tests/core/model-deployment-registry.test.ts +7 -1
  147. package/tests/core/model-training-registry.test.ts +19 -0
  148. package/tests/core/observability.test.ts +0 -1
  149. package/tests/core/pain-diagnostic-gate.test.ts +498 -0
  150. package/tests/core/pain.test.ts +0 -1
  151. package/tests/core/path-resolver.test.ts +1 -1
  152. package/tests/core/paths-refactor.test.ts +0 -22
  153. package/tests/core/principle-internalization/deprecated-readiness.test.ts +2 -2
  154. package/tests/core/principle-internalization/lifecycle-metrics.test.ts +2 -2
  155. package/tests/core/principle-internalization/{internalization-routing-policy.test.ts → lifecycle-routing-policy.test.ts} +6 -6
  156. package/tests/core/principle-internalization/lineage-source-retired.test.ts +56 -0
  157. package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +1 -23
  158. package/tests/core/principle-tree-ledger-adapter.test.ts +253 -0
  159. package/tests/core/reflection-context.test.ts +0 -14
  160. package/tests/core/replay-engine.test.ts +127 -215
  161. package/tests/core/rule-host-helpers.test.ts +2 -2
  162. package/tests/core/rule-implementation-runtime.test.ts +0 -27
  163. package/tests/core/workflow-funnel-loader.test.ts +162 -0
  164. package/tests/core/workspace-context.test.ts +2 -2
  165. package/tests/core/workspace-dir-validation.test.ts +8 -1
  166. package/tests/core-anti-growth.test.ts +191 -0
  167. package/tests/hook-workspace-nextaction-contract.test.ts +42 -0
  168. package/tests/hooks/confirm-first-removal.test.ts +188 -0
  169. package/tests/hooks/gate-auto-correct-shadow.test.ts +310 -0
  170. package/tests/hooks/gate-auto-correct.test.ts +665 -0
  171. package/tests/hooks/gate-no-path-write-tool.test.ts +172 -0
  172. package/tests/hooks/gate-rule-host-pipeline.test.ts +2 -1
  173. package/tests/hooks/pain.test.ts +269 -12
  174. package/tests/hooks/prompt-characterization.test.ts +500 -0
  175. package/tests/hooks/prompt-size-guard.test.ts +32 -17
  176. package/tests/hooks/runtime-v2-prompt-activation.test.ts +869 -0
  177. package/tests/index.test.ts +94 -1
  178. package/tests/integration/auto-entry-gate.test.ts +248 -0
  179. package/tests/integration/internalization-trigger-guard.test.ts +69 -0
  180. package/tests/integration/m8-legacy-paths.test.ts +63 -0
  181. package/tests/integration/runtime-v2-pain-guard.test.ts +125 -0
  182. package/tests/plugin-config-resolution-cutover.test.ts +359 -0
  183. package/tests/runtime-v2-discovery-guard.test.ts +154 -0
  184. package/tests/service/central-database.test.ts +457 -0
  185. package/tests/service/evolution-worker.correction-observer.test.ts +173 -0
  186. package/tests/service/evolution-worker.timeout.test.ts +11 -129
  187. package/tests/service/internalization-trigger-adapter.test.ts +251 -0
  188. package/tests/service/monitoring-query-service.test.ts +1 -47
  189. package/tests/service/queue-io.test.ts +1 -62
  190. package/tests/service/runtime-summary-service.test.ts +3 -1
  191. package/tests/service/workflow-watchdog.test.ts +0 -91
  192. package/tests/utils/file-lock.test.ts +5 -3
  193. package/tests/utils/session-key.test.ts +52 -0
  194. package/tests/utils/subagent-probe.test.ts +48 -1
  195. package/vitest.config.ts +4 -11
  196. package/.planning/codebase/ARCHITECTURE.md +0 -157
  197. package/.planning/codebase/CONCERNS.md +0 -145
  198. package/.planning/codebase/CONVENTIONS.md +0 -148
  199. package/.planning/codebase/INTEGRATIONS.md +0 -81
  200. package/.planning/codebase/STACK.md +0 -87
  201. package/.planning/codebase/STRUCTURE.md +0 -193
  202. package/.planning/codebase/TESTING.md +0 -243
  203. package/.planning/phases/01-basic-visualization/01-GAP-CLOSURE-VERIFICATION.md +0 -113
  204. package/docs/COMMAND_REFERENCE.md +0 -76
  205. package/docs/COMMAND_REFERENCE_EN.md +0 -79
  206. package/scripts/build-web.mjs +0 -46
  207. package/scripts/diagnose-nocturnal.mjs +0 -537
  208. package/scripts/seed-nocturnal-scenarios.mjs +0 -384
  209. package/src/commands/nocturnal-review.ts +0 -322
  210. package/src/commands/nocturnal-rollout.ts +0 -790
  211. package/src/commands/nocturnal-train.ts +0 -986
  212. package/src/commands/pd-reflect.ts +0 -88
  213. package/src/core/adaptive-thresholds.ts +0 -478
  214. package/src/core/diagnostician-task-store.ts +0 -192
  215. package/src/core/nocturnal-arbiter.ts +0 -715
  216. package/src/core/nocturnal-artifact-lineage.ts +0 -116
  217. package/src/core/nocturnal-artificer.ts +0 -257
  218. package/src/core/nocturnal-candidate-scoring.ts +0 -530
  219. package/src/core/nocturnal-compliance.ts +0 -1146
  220. package/src/core/nocturnal-dataset.ts +0 -763
  221. package/src/core/nocturnal-executability.ts +0 -428
  222. package/src/core/nocturnal-export.ts +0 -499
  223. package/src/core/nocturnal-paths.ts +0 -240
  224. package/src/core/nocturnal-reasoning-deriver.ts +0 -343
  225. package/src/core/nocturnal-rule-implementation-validator.ts +0 -246
  226. package/src/core/nocturnal-snapshot-contract.ts +0 -99
  227. package/src/core/nocturnal-trajectory-extractor.ts +0 -512
  228. package/src/core/nocturnal-trinity-types.ts +0 -218
  229. package/src/core/nocturnal-trinity.ts +0 -2680
  230. package/src/core/principle-internalization/deprecated-readiness.ts +0 -93
  231. package/src/core/principle-internalization/internalization-routing-policy.ts +0 -208
  232. package/src/core/principle-internalization/lifecycle-metrics.ts +0 -152
  233. package/src/http/principles-console-route.ts +0 -709
  234. package/src/service/central-health-service.ts +0 -49
  235. package/src/service/central-overview-service.ts +0 -138
  236. package/src/service/control-ui-query-service.ts +0 -900
  237. package/src/service/cooldown-strategy.ts +0 -97
  238. package/src/service/evolution-pain-context.ts +0 -79
  239. package/src/service/evolution-query-service.ts +0 -407
  240. package/src/service/health-query-service.ts +0 -1038
  241. package/src/service/nocturnal-config.ts +0 -214
  242. package/src/service/nocturnal-runtime.ts +0 -734
  243. package/src/service/nocturnal-service.ts +0 -1605
  244. package/src/service/nocturnal-target-selector.ts +0 -545
  245. package/src/service/sleep-cycle.ts +0 -157
  246. package/src/service/startup-reconciler.ts +0 -112
  247. package/src/service/subagent-workflow/correction-observer-types.ts +0 -82
  248. package/src/service/subagent-workflow/correction-observer-workflow-manager.ts +0 -250
  249. package/src/service/subagent-workflow/deep-reflect-workflow-manager.ts +0 -1
  250. package/src/service/subagent-workflow/dynamic-timeout.ts +0 -30
  251. package/src/service/subagent-workflow/empathy-observer-workflow-manager.ts +0 -268
  252. package/src/service/subagent-workflow/nocturnal-workflow-manager.ts +0 -795
  253. package/src/service/subagent-workflow/runtime-direct-driver.ts +0 -268
  254. package/src/service/subagent-workflow/workflow-manager-base.ts +0 -580
  255. package/src/tools/write-pain-flag.ts +0 -215
  256. package/templates/langs/en/skills/plan-script/SKILL.md +0 -32
  257. package/templates/langs/zh/skills/plan-script/SKILL.md +0 -32
  258. package/tests/commands/nocturnal-review.test.ts +0 -448
  259. package/tests/commands/nocturnal-train.test.ts +0 -97
  260. package/tests/commands/pd-reflect.test.ts +0 -49
  261. package/tests/core/adaptive-thresholds.test.ts +0 -261
  262. package/tests/core/nocturnal-arbiter.test.ts +0 -559
  263. package/tests/core/nocturnal-artifact-lineage.test.ts +0 -53
  264. package/tests/core/nocturnal-artificer.test.ts +0 -241
  265. package/tests/core/nocturnal-candidate-scoring.test.ts +0 -532
  266. package/tests/core/nocturnal-compliance-p-principles.test.ts +0 -133
  267. package/tests/core/nocturnal-compliance.test.ts +0 -646
  268. package/tests/core/nocturnal-dataset.test.ts +0 -892
  269. package/tests/core/nocturnal-e2e.test.ts +0 -234
  270. package/tests/core/nocturnal-executability.test.ts +0 -357
  271. package/tests/core/nocturnal-export.test.ts +0 -517
  272. package/tests/core/nocturnal-reasoning-deriver.test.ts +0 -372
  273. package/tests/core/nocturnal-reviewed-subset-comparison.test.ts +0 -428
  274. package/tests/core/nocturnal-rule-implementation-validator.test.ts +0 -127
  275. package/tests/core/nocturnal-snapshot-contract.test.ts +0 -121
  276. package/tests/core/nocturnal-trajectory-extractor.test.ts +0 -634
  277. package/tests/core/nocturnal-trinity.test.ts +0 -2053
  278. package/tests/core/pain-auto-repair.test.ts +0 -96
  279. package/tests/core/pain-integration.test.ts +0 -510
  280. package/tests/fixtures/nocturnal-reviewed-subset.json +0 -183
  281. package/tests/http/principles-console-route.test.ts +0 -162
  282. package/tests/integration/chaos-resilience.test.ts +0 -348
  283. package/tests/integration/empathy-workflow-integration.test.ts +0 -626
  284. package/tests/integration/pain-diagnostician-loop.e2e.test.ts +0 -380
  285. package/tests/service/control-ui-query-service.test.ts +0 -121
  286. package/tests/service/cooldown-strategy.test.ts +0 -164
  287. package/tests/service/data-endpoints-regression.test.ts +0 -834
  288. package/tests/service/empathy-observer-workflow-manager.test.ts +0 -175
  289. package/tests/service/evolution-worker.nocturnal.test.ts +0 -601
  290. package/tests/service/nocturnal-runtime-hardening.test.ts +0 -118
  291. package/tests/service/nocturnal-runtime.test.ts +0 -473
  292. package/tests/service/nocturnal-service-code-candidate.test.ts +0 -330
  293. package/tests/service/nocturnal-target-selector.test.ts +0 -615
  294. package/tests/service/startup-reconciler.test.ts +0 -148
  295. package/tests/tools/write-pain-flag.test.ts +0 -358
  296. package/ui/src/App.tsx +0 -45
  297. package/ui/src/api.ts +0 -220
  298. package/ui/src/charts.tsx +0 -955
  299. package/ui/src/components/ErrorState.tsx +0 -6
  300. package/ui/src/components/Loading.tsx +0 -13
  301. package/ui/src/components/ProtectedRoute.tsx +0 -12
  302. package/ui/src/components/Shell.tsx +0 -91
  303. package/ui/src/components/WorkspaceConfig.tsx +0 -178
  304. package/ui/src/components/index.ts +0 -5
  305. package/ui/src/context/auth.tsx +0 -80
  306. package/ui/src/context/theme.tsx +0 -66
  307. package/ui/src/hooks/useAutoRefresh.ts +0 -39
  308. package/ui/src/i18n/ui.ts +0 -473
  309. package/ui/src/main.tsx +0 -16
  310. package/ui/src/pages/EvolutionPage.tsx +0 -333
  311. package/ui/src/pages/FeedbackPage.tsx +0 -138
  312. package/ui/src/pages/GateMonitorPage.tsx +0 -136
  313. package/ui/src/pages/LoginPage.tsx +0 -89
  314. package/ui/src/pages/OverviewPage.tsx +0 -599
  315. package/ui/src/pages/SamplesPage.tsx +0 -174
  316. package/ui/src/pages/ThinkingModelsPage.tsx +0 -702
  317. package/ui/src/styles.css +0 -2020
  318. package/ui/src/types.ts +0 -384
  319. package/ui/src/utils/format.ts +0 -15
@@ -1,148 +0,0 @@
1
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
- import * as fs from 'fs';
3
- import * as path from 'path';
4
- import * as os from 'os';
5
-
6
- import { reconcileStartup } from '../../src/service/startup-reconciler.js';
7
- import { readState, writeState } from '../../src/service/nocturnal-runtime.js';
8
-
9
- let tmpDir: string;
10
-
11
- beforeEach(() => {
12
- tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'startup-reconcile-test-'));
13
- });
14
-
15
- afterEach(() => {
16
- fs.rmSync(tmpDir, { recursive: true, force: true });
17
- });
18
-
19
- describe('startup-reconciler', () => {
20
- describe('reconcileStartup', () => {
21
- it('returns zero counts when no state exists', async () => {
22
- const result = await reconcileStartup(tmpDir);
23
- expect(result.cooldownsCleared).toBe(0);
24
- expect(result.orphansRemoved).toEqual([]);
25
- expect(result.stateReset).toBe(false);
26
- });
27
-
28
- it('clears expired cooldownUntil entries', async () => {
29
- const state = await readState(tmpDir);
30
- state.taskFailureState = {
31
- sleep_reflection: {
32
- consecutiveFailures: 3,
33
- escalationTier: 2,
34
- cooldownUntil: new Date(Date.now() - 60000).toISOString(), // Expired 1 min ago
35
- },
36
- keyword_optimization: {
37
- consecutiveFailures: 1,
38
- escalationTier: 1,
39
- cooldownUntil: new Date(Date.now() + 3600000).toISOString(), // Still active (1h from now)
40
- },
41
- };
42
- await writeState(tmpDir, state);
43
-
44
- const result = await reconcileStartup(tmpDir);
45
- expect(result.cooldownsCleared).toBe(1);
46
-
47
- const updated = await readState(tmpDir);
48
- expect(updated.taskFailureState!['sleep_reflection'].cooldownUntil).toBeUndefined();
49
- expect(updated.taskFailureState!['sleep_reflection'].escalationTier).toBe(2); // Preserved
50
- expect(updated.taskFailureState!['keyword_optimization'].cooldownUntil).toBeDefined(); // Not cleared
51
- });
52
-
53
- it('preserves escalation history when clearing cooldowns', async () => {
54
- const state = await readState(tmpDir);
55
- state.taskFailureState = {
56
- sleep_reflection: {
57
- consecutiveFailures: 5,
58
- escalationTier: 3,
59
- cooldownUntil: new Date(Date.now() - 1000).toISOString(),
60
- },
61
- };
62
- await writeState(tmpDir, state);
63
-
64
- await reconcileStartup(tmpDir);
65
-
66
- const updated = await readState(tmpDir);
67
- expect(updated.taskFailureState!['sleep_reflection'].consecutiveFailures).toBe(5);
68
- expect(updated.taskFailureState!['sleep_reflection'].escalationTier).toBe(3);
69
- expect(updated.taskFailureState!['sleep_reflection'].cooldownUntil).toBeUndefined();
70
- });
71
-
72
- it('removes orphan .tmp files', async () => {
73
- // Create a .tmp file without corresponding target
74
- const orphanPath = path.join(tmpDir, 'orphan.tmp');
75
- fs.writeFileSync(orphanPath, 'stale data');
76
-
77
- // Create a .tmp file WITH corresponding target (not orphan)
78
- const validTmpPath = path.join(tmpDir, 'valid-data.json.tmp');
79
- const validTargetPath = path.join(tmpDir, 'valid-data.json');
80
- fs.writeFileSync(validTmpPath, 'temp');
81
- fs.writeFileSync(validTargetPath, 'real');
82
-
83
- const result = await reconcileStartup(tmpDir);
84
- expect(result.orphansRemoved).toEqual(['orphan.tmp']);
85
- expect(fs.existsSync(orphanPath)).toBe(false);
86
- expect(fs.existsSync(validTmpPath)).toBe(true); // Not removed — target exists
87
- });
88
-
89
- it('resets corrupted state file', async () => {
90
- const statePath = path.join(tmpDir, 'nocturnal-runtime.json');
91
- fs.writeFileSync(statePath, '{corrupted json!!!', 'utf8');
92
-
93
- const result = await reconcileStartup(tmpDir);
94
- expect(result.stateReset).toBe(true);
95
-
96
- // State should be readable after reset
97
- const state = await readState(tmpDir);
98
- expect(state.principleCooldowns).toEqual({});
99
- });
100
-
101
- it('reports stateReset=false for valid state', async () => {
102
- const state = await readState(tmpDir); // Creates valid state
103
- state.globalCooldownUntil = new Date(Date.now() + 60000).toISOString();
104
- await writeState(tmpDir, state);
105
-
106
- const result = await reconcileStartup(tmpDir);
107
- expect(result.stateReset).toBe(false);
108
- });
109
-
110
- it('handles multiple expired cooldowns across task kinds', async () => {
111
- const state = await readState(tmpDir);
112
- state.taskFailureState = {
113
- sleep_reflection: {
114
- consecutiveFailures: 3,
115
- escalationTier: 2,
116
- cooldownUntil: new Date(Date.now() - 1000).toISOString(),
117
- },
118
- keyword_optimization: {
119
- consecutiveFailures: 4,
120
- escalationTier: 3,
121
- cooldownUntil: new Date(Date.now() - 2000).toISOString(),
122
- },
123
- };
124
- await writeState(tmpDir, state);
125
-
126
- const result = await reconcileStartup(tmpDir);
127
- expect(result.cooldownsCleared).toBe(2);
128
- });
129
-
130
- it('is idempotent — safe to call multiple times', async () => {
131
- const state = await readState(tmpDir);
132
- state.taskFailureState = {
133
- sleep_reflection: {
134
- consecutiveFailures: 2,
135
- escalationTier: 1,
136
- cooldownUntil: new Date(Date.now() - 1000).toISOString(),
137
- },
138
- };
139
- await writeState(tmpDir, state);
140
-
141
- const result1 = await reconcileStartup(tmpDir);
142
- expect(result1.cooldownsCleared).toBe(1);
143
-
144
- const result2 = await reconcileStartup(tmpDir);
145
- expect(result2.cooldownsCleared).toBe(0); // Already cleared
146
- });
147
- });
148
- });
@@ -1,358 +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 { createWritePainFlagTool } from '../../src/tools/write-pain-flag.js';
6
-
7
- // ─── Mock state shared between isolated tests ────────────────────────────────
8
- type MockFn = (...args: unknown[]) => unknown;
9
- let mockRecordPainEventFn: MockFn | undefined;
10
- let mockRecordPainEventThrows = false;
11
-
12
- function makeTrajectoryMock() {
13
- const fn = vi.fn((...args: unknown[]) => {
14
- if (mockRecordPainEventThrows) throw new Error('trajectory DB write error');
15
- return mockRecordPainEventFn ? mockRecordPainEventFn(...args) : 1;
16
- });
17
- return { recordPainEvent: fn };
18
- }
19
-
20
- vi.mock('../../src/core/trajectory.js', () => ({
21
- TrajectoryRegistry: {
22
- get: vi.fn(() => makeTrajectoryMock()),
23
- },
24
- }));
25
-
26
- function safeRmDir(dir: string): void {
27
- try { fs.rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ }
28
- }
29
-
30
- /**
31
- * Create a mock OpenClawPluginApi for testing
32
- */
33
- function createMockApi(workspaceDir: string) {
34
- const logs: { level: string; message: string }[] = [];
35
- return {
36
- config: { workspaceDir },
37
- logger: {
38
- info: (m: string) => logs.push({ level: 'info', message: m }),
39
- warn: (m: string) => logs.push({ level: 'warn', message: m }),
40
- error: (m: string) => logs.push({ level: 'error', message: m }),
41
- debug: (m: string) => logs.push({ level: 'debug', message: m }),
42
- },
43
- runtime: { subagent: null, agent: null },
44
- _logs: logs,
45
- };
46
- }
47
-
48
- describe('write_pain_flag tool', () => {
49
- let workspaceDir: string;
50
- let stateDir: string;
51
-
52
- beforeEach(() => {
53
- workspaceDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-pain-tool-'));
54
- stateDir = path.join(workspaceDir, '.state');
55
- fs.mkdirSync(stateDir, { recursive: true });
56
- });
57
-
58
- afterEach(() => {
59
- safeRmDir(workspaceDir);
60
- });
61
-
62
- // ─────────────────────────────────────────────────────────
63
- // Contract: Tool interface matches OpenClaw AgentTool spec
64
- // ─────────────────────────────────────────────────────────
65
- it('matches the AgentTool interface (name, description, parameters, execute)', () => {
66
- const api = createMockApi(workspaceDir) as any;
67
- const tool = createWritePainFlagTool(api);
68
-
69
- expect(tool.name).toBe('write_pain_flag');
70
- expect(tool.description).toBeDefined();
71
- expect(tool.description).toContain('pain signal');
72
- expect(tool.parameters).toBeDefined();
73
- expect(typeof tool.execute).toBe('function');
74
- });
75
-
76
- it('has clear, unambiguous description in English', () => {
77
- const api = createMockApi(workspaceDir) as any;
78
- const tool = createWritePainFlagTool(api);
79
-
80
- expect(tool.description).not.toBe('');
81
- expect(tool.description).toContain('pain signal');
82
- expect(tool.description).toContain('INSTEAD');
83
- expect(tool.description).toContain('.pain_flag');
84
- });
85
-
86
- // ─────────────────────────────────────────────────────────
87
- // Contract: Pain flag format (KV, not JSON, not [object Object])
88
- // ─────────────────────────────────────────────────────────
89
- it('writes pain flag in correct KV format, never [object Object]', async () => {
90
- const api = createMockApi(workspaceDir) as any;
91
- const tool = createWritePainFlagTool(api);
92
-
93
- const result = await tool.execute('test-1', {
94
- reason: 'Agent forgot to read file before editing',
95
- score: 85,
96
- source: 'manual',
97
- });
98
-
99
- // Verify tool returns success
100
- expect(result.content[0].text).toContain('✅');
101
- expect(result.content[0].text).toContain('85');
102
- expect(result.content[0].text).toContain('manual');
103
-
104
- // Verify file exists and is NOT [object Object]
105
- const painFlagPath = path.join(stateDir, '.pain_flag');
106
- expect(fs.existsSync(painFlagPath)).toBe(true);
107
- const content = fs.readFileSync(painFlagPath, 'utf-8');
108
- expect(content).not.toContain('[object Object]');
109
- expect(content).not.toContain('{');
110
- expect(content).not.toContain('undefined');
111
-
112
- // Verify KV format — each line is "key: value"
113
- const lines = content.trim().split('\n').filter(l => l.trim());
114
- for (const line of lines) {
115
- expect(line).toMatch(/^[a-z_]+: .+$/);
116
- }
117
-
118
- // Verify required fields
119
- const fields: Record<string, string> = {};
120
- for (const line of lines) {
121
- const colonIdx = line.indexOf(':');
122
- fields[line.substring(0, colonIdx).trim()] = line.substring(colonIdx + 1).trim();
123
- }
124
- expect(fields.source).toBe('manual');
125
- expect(fields.score).toBe('85');
126
- expect(fields.reason).toBe('Agent forgot to read file before editing');
127
- expect(fields.time).toBeDefined();
128
- expect(fields.pain_event_id).toBeDefined();
129
- expect(fields.pain_event_id).toMatch(/^\d+$/);
130
- });
131
-
132
- // ─────────────────────────────────────────────────────────
133
- // Contract: Required field validation
134
- // ─────────────────────────────────────────────────────────
135
- it('returns clear error when reason is missing', async () => {
136
- const api = createMockApi(workspaceDir) as any;
137
- const tool = createWritePainFlagTool(api);
138
-
139
- const result = await tool.execute('test-2', {});
140
-
141
- expect(result.content[0].text).toContain('❌');
142
- expect(result.content[0].text).toContain('reason');
143
- expect(api._logs.some((l: any) => l.level === 'warn')).toBe(true);
144
- });
145
-
146
- it('falls back to PathResolver when config.workspaceDir is not set', async () => {
147
- // Even without explicit workspaceDir, the tool should succeed
148
- // by falling back to PathResolver (which finds default workspace)
149
- const logs: { level: string; message: string }[] = [];
150
- const api = {
151
- config: {},
152
- logger: {
153
- info: (m: string) => logs.push({ level: 'info', message: m }),
154
- warn: (m: string) => logs.push({ level: 'warn', message: m }),
155
- error: (m: string) => logs.push({ level: 'error', message: m }),
156
- debug: (m: string) => logs.push({ level: 'debug', message: m }),
157
- },
158
- runtime: { subagent: null, agent: null },
159
- _logs: logs,
160
- } as any;
161
-
162
- const tool = createWritePainFlagTool(api);
163
- const result = await tool.execute('test-3', { reason: 'Test fallback' });
164
-
165
- // Should succeed via PathResolver fallback
166
- expect(result.content[0].text).toContain('✅');
167
- expect(result.content[0].text).toContain('Test fallback');
168
- });
169
-
170
- // ─────────────────────────────────────────────────────────
171
- // Atomic write: temp file + rename
172
- // ─────────────────────────────────────────────────────────
173
- it('writes atomically (no partial writes on crash)', async () => {
174
- const api = createMockApi(workspaceDir) as any;
175
- const tool = createWritePainFlagTool(api);
176
-
177
- // First write
178
- await tool.execute('test-4a', { reason: 'First pain signal', score: 50 });
179
- const painFlagPath = path.join(stateDir, '.pain_flag');
180
- const content1 = fs.readFileSync(painFlagPath, 'utf-8');
181
- expect(content1).toContain('First pain signal');
182
-
183
- // Verify no temp files left
184
- const files = fs.readdirSync(stateDir);
185
- const tempFiles = files.filter(f => f.startsWith('.pain_flag.tmp'));
186
- expect(tempFiles.length).toBe(0);
187
-
188
- // Second write (overwrites)
189
- await tool.execute('test-4b', { reason: 'Second pain signal', score: 70 });
190
- const content2 = fs.readFileSync(painFlagPath, 'utf-8');
191
- expect(content2).toContain('Second pain signal');
192
- expect(content2).not.toContain('First pain signal');
193
-
194
- // Verify no temp files left
195
- const files2 = fs.readdirSync(stateDir);
196
- const tempFiles2 = files2.filter(f => f.startsWith('.pain_flag.tmp'));
197
- expect(tempFiles2.length).toBe(0);
198
- });
199
-
200
- // ─────────────────────────────────────────────────────────
201
- // Score clamping (0-100)
202
- // ─────────────────────────────────────────────────────────
203
- it('clamps score to 0-100 range', async () => {
204
- const api = createMockApi(workspaceDir) as any;
205
- const tool = createWritePainFlagTool(api);
206
-
207
- // Score too high
208
- const result1 = await tool.execute('test-5a', { reason: 'Test', score: 200 });
209
- expect(result1.content[0].text).toContain('100');
210
-
211
- // Score too low
212
- const result2 = await tool.execute('test-5b', { reason: 'Test', score: -50 });
213
- expect(result2.content[0].text).toContain('0');
214
-
215
- // Score at boundaries
216
- const result3 = await tool.execute('test-5c', { reason: 'Test', score: 0 });
217
- expect(result3.content[0].text).toContain('0');
218
-
219
- const result4 = await tool.execute('test-5d', { reason: 'Test', score: 100 });
220
- expect(result4.content[0].text).toContain('100');
221
- });
222
-
223
- // ─────────────────────────────────────────────────────────
224
- // Agent feedback: clear success/failure messages
225
- // ─────────────────────────────────────────────────────────
226
- it('provides clear success feedback with all details', async () => {
227
- const api = createMockApi(workspaceDir) as any;
228
- const tool = createWritePainFlagTool(api);
229
-
230
- const result = await tool.execute('test-6', {
231
- reason: 'Test error for feedback',
232
- score: 75,
233
- source: 'tool_failure',
234
- is_risky: true,
235
- });
236
-
237
- const text = result.content[0].text;
238
- expect(text).toContain('✅');
239
- expect(text).toContain('Test error for feedback');
240
- expect(text).toContain('75');
241
- expect(text).toContain('tool_failure');
242
- expect(text).toContain('Yes'); // is_risky
243
- expect(text).toContain('heartbeat');
244
- });
245
-
246
- it('handles missing state directory by creating it automatically', async () => {
247
- const api = createMockApi(workspaceDir) as any;
248
- // Remove .state directory to test auto-creation
249
- if (fs.existsSync(stateDir)) {
250
- fs.rmSync(stateDir, { recursive: true, force: true });
251
- }
252
-
253
- const tool = createWritePainFlagTool(api);
254
- const result = await tool.execute('test-auto', { reason: 'Auto-create state dir' });
255
-
256
- expect(result.content[0].text).toContain('✅');
257
- const painFlagPath = path.join(stateDir, '.pain_flag');
258
- expect(fs.existsSync(painFlagPath)).toBe(true);
259
- });
260
-
261
- // ─────────────────────────────────────────────────────────
262
- // Default values
263
- // ─────────────────────────────────────────────────────────
264
- it('uses correct defaults for optional parameters', async () => {
265
- const api = createMockApi(workspaceDir) as any;
266
- const tool = createWritePainFlagTool(api);
267
-
268
- const result = await tool.execute('test-8', {
269
- reason: 'Test defaults',
270
- });
271
-
272
- const text = result.content[0].text;
273
- expect(text).toContain('80'); // default score
274
- expect(text).toContain('manual'); // default source
275
- expect(text).toContain('No'); // default is_risky
276
- });
277
-
278
- // ─────────────────────────────────────────────────────────
279
- // Graceful degradation: trajectory write failure still writes flag
280
- // ─────────────────────────────────────────────────────────
281
- it('writes pain flag even when recordPainEvent throws', async () => {
282
- // Configure the module-level mock to throw
283
- mockRecordPainEventThrows = true;
284
-
285
- const api = createMockApi(workspaceDir) as any;
286
- const tool = createWritePainFlagTool(api);
287
-
288
- const result = await tool.execute('test-degradation', {
289
- reason: 'Pain signal with failing trajectory',
290
- score: 60,
291
- source: 'user_empathy',
292
- });
293
-
294
- // Should still succeed (graceful degradation)
295
- expect(result.content[0].text).toContain('✅');
296
- expect(result.content[0].text).toContain('60');
297
-
298
- // Flag file should still exist
299
- const painFlagPath = path.join(stateDir, '.pain_flag');
300
- expect(fs.existsSync(painFlagPath)).toBe(true);
301
- const content = fs.readFileSync(painFlagPath, 'utf-8');
302
- expect(content).toContain('Pain signal with failing trajectory');
303
-
304
- // pain_event_id should NOT be present since trajectory failed
305
- expect(content).not.toContain('pain_event_id:');
306
-
307
- // Should have logged a warning
308
- expect(api._logs.some((l: any) => l.level === 'warn')).toBe(true);
309
-
310
- // Reset for next test
311
- mockRecordPainEventThrows = false;
312
- });
313
-
314
- // ─────────────────────────────────────────────────────────
315
- // recordPainEvent called with correct arguments
316
- // ─────────────────────────────────────────────────────────
317
- it('calls recordPainEvent with correct arguments from tool params', async () => {
318
- // Set up the spy result via the module-level mock factory
319
- mockRecordPainEventFn = vi.fn(() => 42);
320
-
321
- const api = createMockApi(workspaceDir) as any;
322
- const tool = createWritePainFlagTool(api);
323
-
324
- await tool.execute('test-spy', {
325
- reason: 'Spy test reason',
326
- score: 55,
327
- source: 'tool_failure',
328
- session_id: 'session-spy-001',
329
- is_risky: true,
330
- });
331
-
332
- // Access the spy through the TrajectoryRegistry.get mock
333
- const { TrajectoryRegistry } = await import('../../src/core/trajectory.js');
334
- const mockGet = TrajectoryRegistry.get as ReturnType<typeof vi.fn>;
335
- const mockTraj = mockGet.mock.results.at(-1)!.value as { recordPainEvent: ReturnType<typeof vi.fn> };
336
-
337
- expect(mockTraj.recordPainEvent).toHaveBeenCalledOnce();
338
- expect(mockTraj.recordPainEvent).toHaveBeenCalledWith(
339
- expect.objectContaining({
340
- sessionId: 'session-spy-001',
341
- source: 'tool_failure',
342
- score: 55,
343
- reason: 'Spy test reason',
344
- severity: null,
345
- origin: 'manual',
346
- confidence: null,
347
- })
348
- );
349
-
350
- // Also verify pain_event_id: 42 appears in the flag file
351
- const painFlagPath = path.join(stateDir, '.pain_flag');
352
- const content = fs.readFileSync(painFlagPath, 'utf-8');
353
- expect(content).toContain('pain_event_id: 42');
354
-
355
- // Reset for next test
356
- mockRecordPainEventFn = undefined;
357
- });
358
- });
package/ui/src/App.tsx DELETED
@@ -1,45 +0,0 @@
1
- import React from 'react';
2
- import { BrowserRouter, Navigate, Route, Routes } from 'react-router-dom';
3
- import { AuthProvider } from './context/auth';
4
- import { ThemeProvider } from './context/theme';
5
- import { ProtectedRoute } from './components/ProtectedRoute';
6
- import { Shell } from './components/Shell';
7
- import { LoginPage } from './pages/LoginPage';
8
- import { OverviewPage } from './pages/OverviewPage';
9
- import { SamplesPage } from './pages/SamplesPage';
10
- import { ThinkingModelsPage } from './pages/ThinkingModelsPage';
11
- import { EvolutionPage } from './pages/EvolutionPage';
12
- import { FeedbackPage } from './pages/FeedbackPage';
13
- import { GateMonitorPage } from './pages/GateMonitorPage';
14
-
15
- function AppRoutes() {
16
- return (
17
- <Shell>
18
- <Routes>
19
- <Route path="/" element={<Navigate to="/overview" replace />} />
20
- <Route path="/overview" element={<OverviewPage />} />
21
- <Route path="/evolution" element={<EvolutionPage />} />
22
- <Route path="/samples" element={<SamplesPage />} />
23
- <Route path="/thinking-models" element={<ThinkingModelsPage />} />
24
- <Route path="/feedback" element={<FeedbackPage />} />
25
- <Route path="/gate" element={<GateMonitorPage />} />
26
- <Route path="*" element={<Navigate to="/overview" replace />} />
27
- </Routes>
28
- </Shell>
29
- );
30
- }
31
-
32
- export default function App() {
33
- return (
34
- <BrowserRouter basename="/plugins/principles">
35
- <ThemeProvider>
36
- <AuthProvider>
37
- <Routes>
38
- <Route path="/login" element={<LoginPage />} />
39
- <Route path="/*" element={<ProtectedRoute><AppRoutes /></ProtectedRoute>} />
40
- </Routes>
41
- </AuthProvider>
42
- </ThemeProvider>
43
- </BrowserRouter>
44
- );
45
- }