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,448 +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
- import { handleNocturnalReviewCommand } from '../../src/commands/nocturnal-review.js';
6
- import type { PluginCommandContext } from '../../src/openclaw-sdk.js';
7
- import {
8
- registerSample,
9
- updateReviewStatus,
10
- getDatasetRecord,
11
- } from '../../src/core/nocturnal-dataset.js';
12
- import type { NocturnalArtifact } from '../../src/core/nocturnal-arbiter.js';
13
-
14
- // ---------------------------------------------------------------------------
15
- // Fixtures
16
- // ---------------------------------------------------------------------------
17
-
18
- function makeArtifact(overrides: Partial<NocturnalArtifact> = {}): NocturnalArtifact {
19
- return {
20
- artifactId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
21
- sessionId: 'session-abc123',
22
- principleId: 'T-08',
23
- sourceSnapshotRef: 'snapshot-2026-03-27-001',
24
- badDecision: 'After bash command failed, immediately retried without diagnosing',
25
- betterDecision: 'Check the error message before retrying',
26
- rationale: 'Diagnosing failures prevents repeated failures and respects cost of each attempt',
27
- createdAt: '2026-03-27T12:00:00.000Z',
28
- ...overrides,
29
- };
30
- }
31
-
32
- function makeTmpDir(): string {
33
- return fs.mkdtempSync(path.join(os.tmpdir(), 'pd-nocturnal-review-test-'));
34
- }
35
-
36
- function rmdir(dir: string): void {
37
- try {
38
- if (fs.existsSync(dir)) {
39
- fs.rmSync(dir, { recursive: true, force: true });
40
- }
41
- } catch {
42
- // Ignore
43
- }
44
- }
45
-
46
- function makeCtx(workspaceDir: string, args = ''): PluginCommandContext {
47
- return {
48
- config: { workspaceDir, language: 'en' },
49
- args,
50
- } as unknown as PluginCommandContext;
51
- }
52
-
53
- function setupSample(
54
- workspaceDir: string,
55
- artifactId: string,
56
- family: string | null = 'gpt-4'
57
- ): { fingerprint: string; artifactPath: string } {
58
- const artifact = makeArtifact({ artifactId });
59
- const artifactPath = path.join(
60
- workspaceDir,
61
- '.state',
62
- 'nocturnal',
63
- 'samples',
64
- `${artifactId}.json`
65
- );
66
- fs.mkdirSync(path.dirname(artifactPath), { recursive: true });
67
- fs.writeFileSync(artifactPath, JSON.stringify({ ...artifact, status: 'approved' }), 'utf-8');
68
- const result = registerSample(workspaceDir, artifact, artifactPath, family);
69
- return { fingerprint: result.record.sampleFingerprint, artifactPath };
70
- }
71
-
72
- // ---------------------------------------------------------------------------
73
- // Tests: list
74
- // ---------------------------------------------------------------------------
75
-
76
- describe('NocturnalReviewCommand list', () => {
77
- let tmpDir: string;
78
-
79
- beforeEach(() => {
80
- tmpDir = makeTmpDir();
81
- });
82
-
83
- afterEach(() => {
84
- rmdir(tmpDir);
85
- });
86
-
87
- it('shows pending samples', () => {
88
- const { fingerprint } = setupSample(tmpDir, 'art-pending-list');
89
-
90
- const result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'list'));
91
-
92
- expect(result.text).toContain('pending_review');
93
- expect(result.text).toContain(fingerprint.substring(0, 16));
94
- });
95
-
96
- it('shows empty when no pending samples', () => {
97
- const { fingerprint } = setupSample(tmpDir, 'art-approved-list');
98
- updateReviewStatus(tmpDir, fingerprint, 'approved_for_training', 'Approved');
99
-
100
- const result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'list'));
101
-
102
- expect(result.text).toContain('No pending');
103
- });
104
- });
105
-
106
- // ---------------------------------------------------------------------------
107
- // Tests: approve
108
- // ---------------------------------------------------------------------------
109
-
110
- describe('NocturnalReviewCommand approve', () => {
111
- let tmpDir: string;
112
-
113
- beforeEach(() => {
114
- tmpDir = makeTmpDir();
115
- });
116
-
117
- afterEach(() => {
118
- rmdir(tmpDir);
119
- });
120
-
121
- it('approves a pending sample', () => {
122
- const { fingerprint } = setupSample(tmpDir, 'art-approve-test');
123
-
124
- const result = handleNocturnalReviewCommand(
125
- makeCtx(tmpDir, `approve ${fingerprint} Looks good for training`)
126
- );
127
-
128
- expect(result.text).toContain('approved for training');
129
- const record = getDatasetRecord(tmpDir, fingerprint);
130
- expect(record?.reviewStatus).toBe('approved_for_training');
131
- expect(record?.reviewReason).toBe('Looks good for training');
132
- });
133
-
134
- it('approves with default reason if not provided', () => {
135
- const { fingerprint } = setupSample(tmpDir, 'art-approve-default');
136
-
137
- const result = handleNocturnalReviewCommand(
138
- makeCtx(tmpDir, `approve ${fingerprint}`)
139
- );
140
-
141
- expect(result.text).toContain('approved for training');
142
- const record = getDatasetRecord(tmpDir, fingerprint);
143
- expect(record?.reviewStatus).toBe('approved_for_training');
144
- expect(record?.reviewReason).toBeTruthy();
145
- });
146
-
147
- it('rejects already approved sample', () => {
148
- const { fingerprint } = setupSample(tmpDir, 'art-already-approved');
149
- updateReviewStatus(tmpDir, fingerprint, 'approved_for_training', 'Already approved');
150
-
151
- const result = handleNocturnalReviewCommand(
152
- makeCtx(tmpDir, `approve ${fingerprint}`)
153
- );
154
-
155
- expect(result.text).toContain('already approved');
156
- });
157
-
158
- it('rejects rejected sample without reset', () => {
159
- const { fingerprint } = setupSample(tmpDir, 'art-already-rejected');
160
- updateReviewStatus(tmpDir, fingerprint, 'rejected', 'Rejected');
161
-
162
- const result = handleNocturnalReviewCommand(
163
- makeCtx(tmpDir, `approve ${fingerprint}`)
164
- );
165
-
166
- expect(result.text).toContain('rejected');
167
- });
168
-
169
- it('rejects superseded sample', () => {
170
- const { fingerprint } = setupSample(tmpDir, 'art-superseded');
171
- updateReviewStatus(tmpDir, fingerprint, 'approved_for_training', 'Approved');
172
- updateReviewStatus(tmpDir, fingerprint, 'superseded', 'Superseded by better');
173
-
174
- const result = handleNocturnalReviewCommand(
175
- makeCtx(tmpDir, `approve ${fingerprint}`)
176
- );
177
-
178
- expect(result.text).toContain('superseded');
179
- });
180
-
181
- it('returns error for unknown fingerprint', () => {
182
- const result = handleNocturnalReviewCommand(
183
- makeCtx(tmpDir, 'approve unknown-fingerprint')
184
- );
185
-
186
- expect(result.text).toContain('not found');
187
- });
188
-
189
- it('returns error when missing fingerprint', () => {
190
- const result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'approve'));
191
-
192
- expect(result.text).toContain('Usage');
193
- });
194
- });
195
-
196
- // ---------------------------------------------------------------------------
197
- // Tests: reject
198
- // ---------------------------------------------------------------------------
199
-
200
- describe('NocturnalReviewCommand reject', () => {
201
- let tmpDir: string;
202
-
203
- beforeEach(() => {
204
- tmpDir = makeTmpDir();
205
- });
206
-
207
- afterEach(() => {
208
- rmdir(tmpDir);
209
- });
210
-
211
- it('rejects a pending sample', () => {
212
- const { fingerprint } = setupSample(tmpDir, 'art-reject-test');
213
-
214
- const result = handleNocturnalReviewCommand(
215
- makeCtx(tmpDir, `reject ${fingerprint} Not suitable for training`)
216
- );
217
-
218
- expect(result.text).toContain('rejected');
219
- const record = getDatasetRecord(tmpDir, fingerprint);
220
- expect(record?.reviewStatus).toBe('rejected');
221
- expect(record?.reviewReason).toBe('Not suitable for training');
222
- });
223
-
224
- it('rejects with default reason if not provided', () => {
225
- const { fingerprint } = setupSample(tmpDir, 'art-reject-default');
226
-
227
- const result = handleNocturnalReviewCommand(
228
- makeCtx(tmpDir, `reject ${fingerprint}`)
229
- );
230
-
231
- expect(result.text).toContain('rejected');
232
- const record = getDatasetRecord(tmpDir, fingerprint);
233
- expect(record?.reviewStatus).toBe('rejected');
234
- });
235
-
236
- it('rejects already rejected sample', () => {
237
- const { fingerprint } = setupSample(tmpDir, 'art-already-rejected');
238
- updateReviewStatus(tmpDir, fingerprint, 'rejected', 'Already rejected');
239
-
240
- const result = handleNocturnalReviewCommand(
241
- makeCtx(tmpDir, `reject ${fingerprint}`)
242
- );
243
-
244
- expect(result.text).toContain('already rejected');
245
- });
246
-
247
- it('rejects superseded sample', () => {
248
- const { fingerprint } = setupSample(tmpDir, 'art-superseded-reject');
249
- updateReviewStatus(tmpDir, fingerprint, 'approved_for_training', 'Approved');
250
- updateReviewStatus(tmpDir, fingerprint, 'superseded', 'Superseded');
251
-
252
- const result = handleNocturnalReviewCommand(
253
- makeCtx(tmpDir, `reject ${fingerprint}`)
254
- );
255
-
256
- expect(result.text).toContain('superseded');
257
- });
258
-
259
- it('returns error for unknown fingerprint', () => {
260
- const result = handleNocturnalReviewCommand(
261
- makeCtx(tmpDir, 'reject unknown-fingerprint')
262
- );
263
-
264
- expect(result.text).toContain('not found');
265
- });
266
- });
267
-
268
- // ---------------------------------------------------------------------------
269
- // Tests: show
270
- // ---------------------------------------------------------------------------
271
-
272
- describe('NocturnalReviewCommand show', () => {
273
- let tmpDir: string;
274
-
275
- beforeEach(() => {
276
- tmpDir = makeTmpDir();
277
- });
278
-
279
- afterEach(() => {
280
- rmdir(tmpDir);
281
- });
282
-
283
- it('shows sample details', () => {
284
- const { fingerprint } = setupSample(tmpDir, 'art-show-test');
285
-
286
- const result = handleNocturnalReviewCommand(
287
- makeCtx(tmpDir, `show ${fingerprint}`)
288
- );
289
-
290
- expect(result.text).toContain(fingerprint.substring(0, 16));
291
- expect(result.text).toContain('T-08');
292
- expect(result.text).toContain('session-abc123');
293
- });
294
-
295
- it('returns error for unknown fingerprint', () => {
296
- const result = handleNocturnalReviewCommand(
297
- makeCtx(tmpDir, 'show unknown-fingerprint')
298
- );
299
-
300
- expect(result.text).toContain('not found');
301
- });
302
-
303
- it('returns error when missing fingerprint', () => {
304
- const result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'show'));
305
-
306
- expect(result.text).toContain('Usage');
307
- });
308
- });
309
-
310
- // ---------------------------------------------------------------------------
311
- // Tests: set-family
312
- // ---------------------------------------------------------------------------
313
-
314
- describe('NocturnalReviewCommand set-family', () => {
315
- let tmpDir: string;
316
-
317
- beforeEach(() => {
318
- tmpDir = makeTmpDir();
319
- });
320
-
321
- afterEach(() => {
322
- rmdir(tmpDir);
323
- });
324
-
325
- it('sets target model family', () => {
326
- const { fingerprint } = setupSample(tmpDir, 'art-family-test', null);
327
-
328
- const result = handleNocturnalReviewCommand(
329
- makeCtx(tmpDir, `set-family ${fingerprint} claude-3`)
330
- );
331
-
332
- expect(result.text).toContain('claude-3');
333
- const record = getDatasetRecord(tmpDir, fingerprint);
334
- expect(record?.targetModelFamily).toBe('claude-3');
335
- });
336
-
337
- it('updates existing family', () => {
338
- const { fingerprint } = setupSample(tmpDir, 'art-family-update-test', 'gpt-4');
339
-
340
- const result = handleNocturnalReviewCommand(
341
- makeCtx(tmpDir, `set-family ${fingerprint} gpt-4o`)
342
- );
343
-
344
- expect(result.text).toContain('gpt-4o');
345
- const record = getDatasetRecord(tmpDir, fingerprint);
346
- expect(record?.targetModelFamily).toBe('gpt-4o');
347
- });
348
-
349
- it('returns error for unknown fingerprint', () => {
350
- const result = handleNocturnalReviewCommand(
351
- makeCtx(tmpDir, 'set-family unknown-fingerprint gpt-4')
352
- );
353
-
354
- expect(result.text).toContain('not found');
355
- });
356
-
357
- it('returns error when missing args', () => {
358
- const { fingerprint } = setupSample(tmpDir, 'art-family-missing-test');
359
-
360
- const result = handleNocturnalReviewCommand(
361
- makeCtx(tmpDir, `set-family ${fingerprint}`)
362
- );
363
-
364
- expect(result.text).toContain('Usage');
365
- });
366
- });
367
-
368
- // ---------------------------------------------------------------------------
369
- // Tests: stats
370
- // ---------------------------------------------------------------------------
371
-
372
- describe('NocturnalReviewCommand stats', () => {
373
- let tmpDir: string;
374
-
375
- beforeEach(() => {
376
- tmpDir = makeTmpDir();
377
- });
378
-
379
- afterEach(() => {
380
- rmdir(tmpDir);
381
- });
382
-
383
- it('shows dataset statistics', () => {
384
- setupSample(tmpDir, 'art-stats-1', 'gpt-4');
385
- const { fingerprint: fp2 } = setupSample(tmpDir, 'art-stats-2', 'gpt-4');
386
- updateReviewStatus(tmpDir, fp2, 'approved_for_training', 'Approved');
387
-
388
- const result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'stats'));
389
-
390
- expect(result.text).toContain('Total');
391
- expect(result.text).toContain('2');
392
- });
393
-
394
- it('shows export-ready counts by family', () => {
395
- const { fingerprint: fp1 } = setupSample(tmpDir, 'art-stats-family-1', 'gpt-4');
396
- updateReviewStatus(tmpDir, fp1, 'approved_for_training', 'Approved');
397
-
398
- const result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'stats'));
399
-
400
- expect(result.text).toContain('gpt-4');
401
- expect(result.text).toContain('1');
402
- });
403
- });
404
-
405
- // ---------------------------------------------------------------------------
406
- // Integration: full review flow
407
- // ---------------------------------------------------------------------------
408
-
409
- describe('NocturnalReviewCommand full review flow', () => {
410
- let tmpDir: string;
411
-
412
- beforeEach(() => {
413
- tmpDir = makeTmpDir();
414
- });
415
-
416
- afterEach(() => {
417
- rmdir(tmpDir);
418
- });
419
-
420
- it('full flow: list → set-family → approve → export-ready', () => {
421
- // 1. Register sample without family
422
- const { fingerprint } = setupSample(tmpDir, 'art-full-flow', null);
423
-
424
- // 2. Verify it's pending
425
- let result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'list'));
426
- expect(result.text).toContain(fingerprint.substring(0, 16));
427
-
428
- // 3. Set family
429
- result = handleNocturnalReviewCommand(
430
- makeCtx(tmpDir, `set-family ${fingerprint} gpt-4`)
431
- );
432
- expect(result.text).toContain('gpt-4');
433
-
434
- // 4. Approve
435
- result = handleNocturnalReviewCommand(
436
- makeCtx(tmpDir, `approve ${fingerprint} Good sample`)
437
- );
438
- expect(result.text).toContain('approved for training');
439
-
440
- // 5. Verify stats show approved
441
- result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'stats'));
442
- expect(result.text).toContain('Approved for training');
443
-
444
- // 6. Verify not in pending list anymore
445
- result = handleNocturnalReviewCommand(makeCtx(tmpDir, 'list'));
446
- expect(result.text).not.toContain(fingerprint.substring(0, 16));
447
- });
448
- });
@@ -1,97 +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
- import { handleNocturnalTrainCommand } from '../../src/commands/nocturnal-train.js';
6
- import type { PluginCommandContext } from '../../src/openclaw-sdk.js';
7
-
8
- function makeTmpDir(): string {
9
- return fs.mkdtempSync(path.join(os.tmpdir(), 'pd-nocturnal-train-test-'));
10
- }
11
-
12
- function rmdir(dir: string): void {
13
- try {
14
- if (fs.existsSync(dir)) {
15
- fs.rmSync(dir, { recursive: true, force: true });
16
- }
17
- } catch {
18
- // ignore cleanup errors
19
- }
20
- }
21
-
22
- function makeCtx(workspaceDir: string, args = ''): PluginCommandContext {
23
- return {
24
- config: { workspaceDir, language: 'en' },
25
- args,
26
- } as unknown as PluginCommandContext;
27
- }
28
-
29
- function setupExport(workspaceDir: string, exportId = 'export-123'): void {
30
- const exportDir = path.join(workspaceDir, '.state', 'exports', 'orpo');
31
- fs.mkdirSync(exportDir, { recursive: true });
32
- const exportPath = path.join(exportDir, `${exportId}.jsonl`);
33
- fs.writeFileSync(
34
- exportPath,
35
- JSON.stringify({
36
- sampleFingerprint: 'sf-1',
37
- prompt: 'p',
38
- chosen: 'c',
39
- rejected: 'r',
40
- rationale: 'why',
41
- }) + '\n',
42
- 'utf-8'
43
- );
44
- fs.writeFileSync(
45
- path.join(exportDir, `${exportId}-manifest.json`),
46
- JSON.stringify({
47
- exportId,
48
- datasetFingerprint: 'dataset-fp-123',
49
- exportPath,
50
- targetModelFamily: 'qwen2.5-7b-reader',
51
- sampleCount: 1,
52
- createdAt: new Date().toISOString(),
53
- }),
54
- 'utf-8'
55
- );
56
- }
57
-
58
- describe('nocturnal-train command', () => {
59
- let tmpDir: string;
60
-
61
- beforeEach(() => {
62
- tmpDir = makeTmpDir();
63
- setupExport(tmpDir);
64
- });
65
-
66
- afterEach(() => {
67
- rmdir(tmpDir);
68
- });
69
-
70
- it('persists durable spec files for manual create-experiment flow', async () => {
71
- const result = await handleNocturnalTrainCommand(
72
- makeCtx(
73
- tmpDir,
74
- 'create-experiment --backend=peft-trl-orpo --family=qwen2.5-7b-reader --dataset=export-123'
75
- )
76
- );
77
-
78
- expect(result.text).toContain('Experiment created');
79
-
80
- const match = result.text.match(/Experiment ID:\s+([^\s]+)/);
81
- expect(match?.[1]).toBeTruthy();
82
- const experimentId = match![1];
83
-
84
- const pathLines = result.text
85
- .split('\n')
86
- .map((line) => line.trim())
87
- .map((line) => line.replace(/^-+ \s*/, ''))
88
- .filter((line) => path.isAbsolute(line));
89
-
90
- expect(pathLines).toHaveLength(2);
91
- const [trainerSpecPath, workspaceSpecPath] = pathLines;
92
-
93
- expect(fs.existsSync(trainerSpecPath)).toBe(true);
94
- expect(fs.existsSync(workspaceSpecPath)).toBe(true);
95
- expect(result.text).toContain(trainerSpecPath);
96
- });
97
- });
@@ -1,49 +0,0 @@
1
- import { beforeEach, describe, expect, it } from 'vitest';
2
- import * as fs from 'fs';
3
- import * as os from 'os';
4
- import * as path from 'path';
5
- import { handlePdReflect } from '../../src/commands/pd-reflect.js';
6
-
7
- describe('pd-reflect command', () => {
8
- let tempDir: string;
9
- let workspaceDir: string;
10
- let queuePath: string;
11
-
12
- beforeEach(() => {
13
- tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-reflect-'));
14
- workspaceDir = path.join(tempDir, 'workspace-a');
15
- fs.mkdirSync(path.join(workspaceDir, '.state'), { recursive: true });
16
- queuePath = path.join(workspaceDir, '.state', 'evolution_queue.json');
17
- fs.writeFileSync(queuePath, '[]', 'utf8');
18
- });
19
-
20
- it('requires an explicit resolved workspace directory', async () => {
21
- const result = await handlePdReflect.handler({} as any);
22
- expect(result.isError).toBe(true);
23
- expect(result.text).toContain('workspaceDir is not set');
24
- });
25
-
26
- it('enqueues into the provided active workspace', async () => {
27
- const result = await handlePdReflect.handler({ workspaceDir } as any);
28
- expect(result.isError).toBeUndefined();
29
-
30
- const queue = JSON.parse(fs.readFileSync(queuePath, 'utf8')) as Array<Record<string, unknown>>;
31
- expect(queue).toHaveLength(1);
32
- expect(queue[0].taskKind).toBe('sleep_reflection');
33
- expect(result.text).toContain('Nocturnal reflection task enqueued');
34
- });
35
-
36
- it('does not hardcode another workspace when context already provides one', async () => {
37
- const otherWorkspace = path.join(tempDir, 'workspace-b');
38
- fs.mkdirSync(path.join(otherWorkspace, '.state'), { recursive: true });
39
- const otherQueuePath = path.join(otherWorkspace, '.state', 'evolution_queue.json');
40
- fs.writeFileSync(otherQueuePath, '[]', 'utf8');
41
-
42
- await handlePdReflect.handler({ workspaceDir } as any);
43
-
44
- const activeQueue = JSON.parse(fs.readFileSync(queuePath, 'utf8')) as Array<Record<string, unknown>>;
45
- const otherQueue = JSON.parse(fs.readFileSync(otherQueuePath, 'utf8')) as Array<Record<string, unknown>>;
46
- expect(activeQueue).toHaveLength(1);
47
- expect(otherQueue).toHaveLength(0);
48
- });
49
- });