principles-disciple 1.71.0 → 1.73.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 (309) hide show
  1. package/openclaw.plugin.json +10 -5
  2. package/package.json +17 -19
  3. package/scripts/acceptance-test.mjs +16 -73
  4. package/scripts/sync-plugin.mjs +382 -77
  5. package/src/commands/archive-impl.ts +2 -1
  6. package/src/commands/capabilities.ts +2 -2
  7. package/src/commands/context.ts +2 -2
  8. package/src/commands/disable-impl.ts +2 -1
  9. package/src/commands/evolution-status.ts +16 -16
  10. package/src/commands/export.ts +12 -67
  11. package/src/commands/pain.ts +91 -1
  12. package/src/commands/principle-rollback.ts +2 -1
  13. package/src/commands/promote-impl.ts +7 -43
  14. package/src/commands/rollback-impl.ts +2 -1
  15. package/src/commands/rollback.ts +2 -1
  16. package/src/commands/samples.ts +2 -1
  17. package/src/commands/thinking-os.ts +2 -1
  18. package/src/config/errors.ts +18 -2
  19. package/src/constants/diagnostician.ts +2 -2
  20. package/src/constants/tools.ts +2 -1
  21. package/src/core/__tests__/focus-history.test.ts +210 -0
  22. package/src/core/config.ts +1 -1
  23. package/src/core/confirm-first-gate.ts +255 -0
  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 +38 -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/pain-diagnostic-gate.ts +154 -0
  37. package/src/core/pain-signal.ts +21 -138
  38. package/src/core/pain.ts +15 -88
  39. package/src/core/pd-task-reconciler.ts +26 -115
  40. package/src/core/pd-task-service.ts +9 -9
  41. package/src/core/pd-task-types.ts +23 -127
  42. package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +174 -0
  43. package/src/core/principle-compiler/code-validator.ts +15 -42
  44. package/src/core/principle-compiler/compiler.ts +100 -15
  45. package/src/core/principle-compiler/index.ts +5 -2
  46. package/src/core/principle-compiler/template-generator.ts +4 -104
  47. package/src/core/principle-injection.ts +10 -202
  48. package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +42 -0
  49. package/src/core/principle-internalization/lifecycle-read-model.ts +39 -242
  50. package/src/core/principle-internalization/principle-lifecycle-service.ts +12 -10
  51. package/src/core/principle-tree-ledger-adapter.ts +145 -0
  52. package/src/core/principle-tree-ledger.ts +8 -6
  53. package/src/core/reflection/reflection-context.ts +14 -109
  54. package/src/core/replay-engine.ts +8 -500
  55. package/src/core/rule-host-helpers.ts +5 -35
  56. package/src/core/rule-host-types.ts +10 -82
  57. package/src/core/rule-host.ts +6 -63
  58. package/src/core/runtime-v2-prompt-activation-reader.ts +231 -0
  59. package/src/core/session-tracker.ts +87 -101
  60. package/src/core/shadow-observation-registry.ts +19 -48
  61. package/src/core/trajectory.ts +3 -1
  62. package/src/core/workflow-funnel-loader.ts +62 -68
  63. package/src/core/workspace-context.ts +46 -0
  64. package/src/core/workspace-dir-service.ts +1 -1
  65. package/src/core/workspace-dir-validation.ts +18 -9
  66. package/src/hooks/AGENTS.md +1 -1
  67. package/src/hooks/gate-block-helper.ts +46 -44
  68. package/src/hooks/gate.ts +207 -7
  69. package/src/hooks/lifecycle.ts +30 -32
  70. package/src/hooks/llm.ts +60 -32
  71. package/src/hooks/pain.ts +297 -103
  72. package/src/hooks/prompt.ts +469 -339
  73. package/src/hooks/subagent.ts +2 -29
  74. package/src/i18n/commands.ts +2 -10
  75. package/src/index.ts +95 -85
  76. package/src/openclaw-sdk.ts +311 -0
  77. package/src/service/central-database.ts +8 -4
  78. package/src/service/evolution-queue-migration.ts +2 -1
  79. package/src/service/evolution-worker.ts +163 -1786
  80. package/src/service/internalization-trigger-adapter.ts +302 -0
  81. package/src/service/keyword-optimization-service.ts +4 -4
  82. package/src/service/monitoring-query-service.ts +1 -215
  83. package/src/service/queue-io.ts +60 -331
  84. package/src/service/runtime-summary-service.ts +115 -18
  85. package/src/service/subagent-workflow/index.ts +0 -41
  86. package/src/service/subagent-workflow/types.ts +9 -120
  87. package/src/service/subagent-workflow/workflow-store.ts +2 -119
  88. package/src/service/workflow-watchdog.ts +0 -43
  89. package/src/types/event-payload.ts +16 -74
  90. package/src/types/event-types.ts +39 -547
  91. package/src/types/hygiene-types.ts +7 -30
  92. package/src/types/principle-tree-schema.ts +20 -222
  93. package/src/types/queue.ts +15 -70
  94. package/src/types/runtime-summary.ts +5 -49
  95. package/src/utils/io.ts +10 -0
  96. package/src/utils/retry.ts +1 -1
  97. package/src/utils/shadow-fingerprint.ts +2 -2
  98. package/src/utils/workspace-resolver.ts +50 -0
  99. package/templates/langs/en/core/AGENTS.md +2 -2
  100. package/templates/langs/en/core/BOOT.md +1 -1
  101. package/templates/langs/en/core/HEARTBEAT.md +2 -2
  102. package/templates/langs/en/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
  103. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
  104. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
  105. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
  106. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
  107. package/templates/langs/en/skills/ai-sprint-orchestration/runtime/.gitignore +2 -2
  108. package/templates/langs/en/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
  109. package/templates/langs/en/skills/evolve-task/SKILL.md +1 -1
  110. package/templates/langs/en/skills/pd-cli-operator/SKILL.md +67 -0
  111. package/templates/langs/en/skills/pd-diagnostician/SKILL.md +1 -1
  112. package/templates/langs/en/skills/pd-mentor/SKILL.md +1 -1
  113. package/templates/langs/en/skills/pd-pain-signal/SKILL.md +17 -39
  114. package/templates/langs/en/skills/pd-runtime-v2/SKILL.md +61 -0
  115. package/templates/langs/zh/core/AGENTS.md +2 -2
  116. package/templates/langs/zh/core/BOOT.md +1 -1
  117. package/templates/langs/zh/core/HEARTBEAT.md +2 -2
  118. package/templates/langs/zh/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
  119. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
  120. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
  121. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/nocturnal-trinity-quality-enhancement.json +8 -8
  122. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
  123. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
  124. package/templates/langs/zh/skills/ai-sprint-orchestration/runtime/.gitignore +2 -2
  125. package/templates/langs/zh/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
  126. package/templates/langs/zh/skills/ai-sprint-orchestration/test/run.test.mjs +21 -5
  127. package/templates/langs/zh/skills/evolve-task/SKILL.md +2 -2
  128. package/templates/langs/zh/skills/pd-cli-operator/SKILL.md +67 -0
  129. package/templates/langs/zh/skills/pd-diagnostician/SKILL.md +1 -1
  130. package/templates/langs/zh/skills/pd-mentor/SKILL.md +1 -1
  131. package/templates/langs/zh/skills/pd-pain-signal/SKILL.md +17 -38
  132. package/templates/langs/zh/skills/pd-runtime-v2/SKILL.md +61 -0
  133. package/tests/build-artifacts.test.ts +1 -3
  134. package/tests/commands/evolution-status.test.ts +0 -118
  135. package/tests/core/bootstrap-rules.test.ts +1 -1
  136. package/tests/core/config.test.ts +1 -1
  137. package/tests/core/event-log.test.ts +35 -0
  138. package/tests/core/evolution-engine.test.ts +610 -0
  139. package/tests/core/file-store.test.ts +102 -0
  140. package/tests/core/focus-history.test.ts +203 -11
  141. package/tests/core/merge-gate-audit.test.ts +2 -169
  142. package/tests/core/model-deployment-registry.test.ts +7 -1
  143. package/tests/core/model-training-registry.test.ts +19 -0
  144. package/tests/core/observability.test.ts +0 -1
  145. package/tests/core/pain-diagnostic-gate.test.ts +498 -0
  146. package/tests/core/pain.test.ts +0 -1
  147. package/tests/core/principle-internalization/deprecated-readiness.test.ts +2 -2
  148. package/tests/core/principle-internalization/lifecycle-metrics.test.ts +2 -2
  149. package/tests/core/principle-internalization/{internalization-routing-policy.test.ts → lifecycle-routing-policy.test.ts} +6 -6
  150. package/tests/core/principle-internalization/lineage-source-retired.test.ts +56 -0
  151. package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +1 -23
  152. package/tests/core/principle-tree-ledger-adapter.test.ts +253 -0
  153. package/tests/core/reflection-context.test.ts +0 -14
  154. package/tests/core/replay-engine.test.ts +127 -215
  155. package/tests/core/rule-host-helpers.test.ts +2 -2
  156. package/tests/core/rule-implementation-runtime.test.ts +0 -27
  157. package/tests/core/workflow-funnel-loader.test.ts +162 -0
  158. package/tests/core/workspace-dir-validation.test.ts +8 -1
  159. package/tests/core-anti-growth.test.ts +192 -0
  160. package/tests/hook-workspace-nextaction-contract.test.ts +42 -0
  161. package/tests/hooks/confirm-first-gate.test.ts +333 -0
  162. package/tests/hooks/gate-auto-correct-shadow.test.ts +310 -0
  163. package/tests/hooks/gate-auto-correct.test.ts +665 -0
  164. package/tests/hooks/gate-rule-host-pipeline.test.ts +2 -1
  165. package/tests/hooks/pain.test.ts +269 -12
  166. package/tests/hooks/prompt-characterization.test.ts +500 -0
  167. package/tests/hooks/prompt-size-guard.test.ts +329 -0
  168. package/tests/hooks/runtime-v2-prompt-activation.test.ts +869 -0
  169. package/tests/index.test.ts +94 -1
  170. package/tests/integration/auto-entry-gate.test.ts +248 -0
  171. package/tests/integration/internalization-trigger-guard.test.ts +69 -0
  172. package/tests/integration/m8-legacy-paths.test.ts +63 -0
  173. package/tests/integration/runtime-v2-pain-guard.test.ts +125 -0
  174. package/tests/plugin-config-resolution-cutover.test.ts +359 -0
  175. package/tests/runtime-v2-discovery-guard.test.ts +154 -0
  176. package/tests/service/central-database.test.ts +457 -0
  177. package/tests/service/evolution-worker.correction-observer.test.ts +173 -0
  178. package/tests/service/evolution-worker.timeout.test.ts +11 -129
  179. package/tests/service/internalization-trigger-adapter.test.ts +251 -0
  180. package/tests/service/monitoring-query-service.test.ts +1 -47
  181. package/tests/service/queue-io.test.ts +1 -62
  182. package/tests/service/runtime-summary-service.test.ts +184 -3
  183. package/tests/service/workflow-watchdog.test.ts +0 -91
  184. package/tests/utils/file-lock.test.ts +5 -3
  185. package/tests/utils/session-key.test.ts +52 -0
  186. package/tests/utils/subagent-probe.test.ts +48 -1
  187. package/vitest.config.ts +4 -11
  188. package/.planning/codebase/ARCHITECTURE.md +0 -157
  189. package/.planning/codebase/CONCERNS.md +0 -145
  190. package/.planning/codebase/CONVENTIONS.md +0 -148
  191. package/.planning/codebase/INTEGRATIONS.md +0 -81
  192. package/.planning/codebase/STACK.md +0 -87
  193. package/.planning/codebase/STRUCTURE.md +0 -193
  194. package/.planning/codebase/TESTING.md +0 -243
  195. package/.planning/phases/01-basic-visualization/01-GAP-CLOSURE-VERIFICATION.md +0 -113
  196. package/docs/COMMAND_REFERENCE.md +0 -76
  197. package/docs/COMMAND_REFERENCE_EN.md +0 -79
  198. package/scripts/build-web.mjs +0 -46
  199. package/scripts/diagnose-nocturnal.mjs +0 -537
  200. package/scripts/seed-nocturnal-scenarios.mjs +0 -384
  201. package/src/commands/nocturnal-review.ts +0 -322
  202. package/src/commands/nocturnal-rollout.ts +0 -790
  203. package/src/commands/nocturnal-train.ts +0 -986
  204. package/src/commands/pd-reflect.ts +0 -88
  205. package/src/core/adaptive-thresholds.ts +0 -478
  206. package/src/core/diagnostician-task-store.ts +0 -192
  207. package/src/core/nocturnal-arbiter.ts +0 -715
  208. package/src/core/nocturnal-artifact-lineage.ts +0 -116
  209. package/src/core/nocturnal-artificer.ts +0 -257
  210. package/src/core/nocturnal-candidate-scoring.ts +0 -530
  211. package/src/core/nocturnal-compliance.ts +0 -1146
  212. package/src/core/nocturnal-dataset.ts +0 -763
  213. package/src/core/nocturnal-executability.ts +0 -428
  214. package/src/core/nocturnal-export.ts +0 -499
  215. package/src/core/nocturnal-paths.ts +0 -240
  216. package/src/core/nocturnal-reasoning-deriver.ts +0 -343
  217. package/src/core/nocturnal-rule-implementation-validator.ts +0 -246
  218. package/src/core/nocturnal-snapshot-contract.ts +0 -99
  219. package/src/core/nocturnal-trajectory-extractor.ts +0 -512
  220. package/src/core/nocturnal-trinity-types.ts +0 -218
  221. package/src/core/nocturnal-trinity.ts +0 -2680
  222. package/src/core/principle-internalization/deprecated-readiness.ts +0 -93
  223. package/src/core/principle-internalization/internalization-routing-policy.ts +0 -208
  224. package/src/core/principle-internalization/lifecycle-metrics.ts +0 -152
  225. package/src/http/principles-console-route.ts +0 -709
  226. package/src/service/central-health-service.ts +0 -49
  227. package/src/service/central-overview-service.ts +0 -138
  228. package/src/service/control-ui-query-service.ts +0 -900
  229. package/src/service/cooldown-strategy.ts +0 -97
  230. package/src/service/evolution-pain-context.ts +0 -79
  231. package/src/service/evolution-query-service.ts +0 -407
  232. package/src/service/health-query-service.ts +0 -1038
  233. package/src/service/nocturnal-config.ts +0 -214
  234. package/src/service/nocturnal-runtime.ts +0 -734
  235. package/src/service/nocturnal-service.ts +0 -1605
  236. package/src/service/nocturnal-target-selector.ts +0 -545
  237. package/src/service/sleep-cycle.ts +0 -157
  238. package/src/service/startup-reconciler.ts +0 -112
  239. package/src/service/subagent-workflow/correction-observer-types.ts +0 -82
  240. package/src/service/subagent-workflow/correction-observer-workflow-manager.ts +0 -250
  241. package/src/service/subagent-workflow/deep-reflect-workflow-manager.ts +0 -1
  242. package/src/service/subagent-workflow/dynamic-timeout.ts +0 -30
  243. package/src/service/subagent-workflow/empathy-observer-workflow-manager.ts +0 -268
  244. package/src/service/subagent-workflow/nocturnal-workflow-manager.ts +0 -795
  245. package/src/service/subagent-workflow/runtime-direct-driver.ts +0 -268
  246. package/src/service/subagent-workflow/workflow-manager-base.ts +0 -580
  247. package/src/tools/write-pain-flag.ts +0 -215
  248. package/tests/commands/nocturnal-review.test.ts +0 -448
  249. package/tests/commands/nocturnal-train.test.ts +0 -97
  250. package/tests/commands/pd-reflect.test.ts +0 -49
  251. package/tests/core/adaptive-thresholds.test.ts +0 -261
  252. package/tests/core/nocturnal-arbiter.test.ts +0 -559
  253. package/tests/core/nocturnal-artifact-lineage.test.ts +0 -53
  254. package/tests/core/nocturnal-artificer.test.ts +0 -241
  255. package/tests/core/nocturnal-candidate-scoring.test.ts +0 -532
  256. package/tests/core/nocturnal-compliance-p-principles.test.ts +0 -133
  257. package/tests/core/nocturnal-compliance.test.ts +0 -646
  258. package/tests/core/nocturnal-dataset.test.ts +0 -892
  259. package/tests/core/nocturnal-e2e.test.ts +0 -234
  260. package/tests/core/nocturnal-executability.test.ts +0 -357
  261. package/tests/core/nocturnal-export.test.ts +0 -517
  262. package/tests/core/nocturnal-reasoning-deriver.test.ts +0 -372
  263. package/tests/core/nocturnal-reviewed-subset-comparison.test.ts +0 -428
  264. package/tests/core/nocturnal-rule-implementation-validator.test.ts +0 -127
  265. package/tests/core/nocturnal-snapshot-contract.test.ts +0 -121
  266. package/tests/core/nocturnal-trajectory-extractor.test.ts +0 -634
  267. package/tests/core/nocturnal-trinity.test.ts +0 -2053
  268. package/tests/core/pain-auto-repair.test.ts +0 -96
  269. package/tests/core/pain-integration.test.ts +0 -510
  270. package/tests/fixtures/nocturnal-reviewed-subset.json +0 -183
  271. package/tests/http/principles-console-route.test.ts +0 -162
  272. package/tests/integration/chaos-resilience.test.ts +0 -348
  273. package/tests/integration/empathy-workflow-integration.test.ts +0 -626
  274. package/tests/integration/pain-diagnostician-loop.e2e.test.ts +0 -380
  275. package/tests/service/control-ui-query-service.test.ts +0 -121
  276. package/tests/service/cooldown-strategy.test.ts +0 -164
  277. package/tests/service/data-endpoints-regression.test.ts +0 -834
  278. package/tests/service/empathy-observer-workflow-manager.test.ts +0 -175
  279. package/tests/service/evolution-worker.nocturnal.test.ts +0 -601
  280. package/tests/service/nocturnal-runtime-hardening.test.ts +0 -118
  281. package/tests/service/nocturnal-runtime.test.ts +0 -473
  282. package/tests/service/nocturnal-service-code-candidate.test.ts +0 -330
  283. package/tests/service/nocturnal-target-selector.test.ts +0 -615
  284. package/tests/service/startup-reconciler.test.ts +0 -148
  285. package/tests/tools/write-pain-flag.test.ts +0 -358
  286. package/ui/src/App.tsx +0 -45
  287. package/ui/src/api.ts +0 -220
  288. package/ui/src/charts.tsx +0 -955
  289. package/ui/src/components/ErrorState.tsx +0 -6
  290. package/ui/src/components/Loading.tsx +0 -13
  291. package/ui/src/components/ProtectedRoute.tsx +0 -12
  292. package/ui/src/components/Shell.tsx +0 -91
  293. package/ui/src/components/WorkspaceConfig.tsx +0 -178
  294. package/ui/src/components/index.ts +0 -5
  295. package/ui/src/context/auth.tsx +0 -80
  296. package/ui/src/context/theme.tsx +0 -66
  297. package/ui/src/hooks/useAutoRefresh.ts +0 -39
  298. package/ui/src/i18n/ui.ts +0 -473
  299. package/ui/src/main.tsx +0 -16
  300. package/ui/src/pages/EvolutionPage.tsx +0 -333
  301. package/ui/src/pages/FeedbackPage.tsx +0 -138
  302. package/ui/src/pages/GateMonitorPage.tsx +0 -136
  303. package/ui/src/pages/LoginPage.tsx +0 -89
  304. package/ui/src/pages/OverviewPage.tsx +0 -599
  305. package/ui/src/pages/SamplesPage.tsx +0 -174
  306. package/ui/src/pages/ThinkingModelsPage.tsx +0 -702
  307. package/ui/src/styles.css +0 -2020
  308. package/ui/src/types.ts +0 -384
  309. package/ui/src/utils/format.ts +0 -15
@@ -1,214 +0,0 @@
1
- import * as fs from 'fs';
2
- import * as path from 'path';
3
-
4
- export interface SleepReflectionConfig {
5
- /** Trigger mode: "idle" (default) or "periodic" */
6
- trigger_mode: 'idle' | 'periodic';
7
- /** In periodic mode, trigger every N heartbeat cycles */
8
- period_heartbeats: number;
9
- /** Minimum time between runs (ms) */
10
- cooldown_ms: number;
11
- /** Maximum runs per 24-hour window */
12
- max_runs_per_day: number;
13
- /** Whether sleep_reflection is enabled */
14
- enabled: boolean;
15
- }
16
-
17
- export interface KeywordOptimizationConfig {
18
- /** Periodic trigger interval in heartbeat cycles. Default 24 = 6 hours at 15-min heartbeat. */
19
- period_heartbeats: number;
20
- /** Whether keyword_optimization periodic trigger is enabled */
21
- enabled: boolean;
22
- }
23
-
24
- export interface NocturnalConfig {
25
- sleep_reflection?: Partial<SleepReflectionConfig>;
26
- keyword_optimization?: Partial<KeywordOptimizationConfig>;
27
- cooldown_escalation?: Partial<CooldownEscalationConfig>;
28
- }
29
-
30
- /** Cooldown escalation configuration (Phase 40: Failure Classification) */
31
- export interface CooldownEscalationConfig {
32
- /** Cooldown duration for Tier 1 escalation (ms). Default: 30 minutes */
33
- tier1_ms: number;
34
- /** Cooldown duration for Tier 2 escalation (ms). Default: 4 hours */
35
- tier2_ms: number;
36
- /** Cooldown duration for Tier 3+ escalation (ms). Default: 24 hours (cap) */
37
- tier3_ms: number;
38
- /** Consecutive failure threshold to trigger persistent detection. Default: 3 */
39
- consecutive_threshold: number;
40
- }
41
-
42
- const DEFAULT_SLEEP_REFLECTION: SleepReflectionConfig = {
43
- trigger_mode: 'idle',
44
- period_heartbeats: 4, // ~1 hour at 15-min heartbeat interval
45
- cooldown_ms: 30 * 60 * 1000, // 30 minutes
46
- max_runs_per_day: 3,
47
- enabled: true,
48
- };
49
-
50
- const DEFAULT_KEYWORD_OPTIMIZATION: KeywordOptimizationConfig = {
51
- period_heartbeats: 24, // 6 hours at 15-min heartbeat interval (24 * 15min = 360min = 6h)
52
- enabled: true,
53
- };
54
-
55
- const DEFAULT_COOLDOWN_ESCALATION: CooldownEscalationConfig = {
56
- tier1_ms: 30 * 60 * 1000, // 30 minutes = 1,800,000 ms
57
- tier2_ms: 4 * 60 * 60 * 1000, // 4 hours = 14,400,000 ms
58
- tier3_ms: 24 * 60 * 60 * 1000, // 24 hours = 86,400,000 ms
59
- consecutive_threshold: 3,
60
- };
61
-
62
- const CONFIG_FILENAME = 'nocturnal-config.json';
63
-
64
- /**
65
- * Resolve the nocturnal config file path.
66
- */
67
- function resolveConfigPath(stateDir: string): string {
68
- return path.join(stateDir, CONFIG_FILENAME);
69
- }
70
-
71
- /**
72
- * Read and parse nocturnal-config.json once.
73
- * Returns empty object if file doesn't exist or is malformed.
74
- */
75
- function readRawConfig(stateDir: string): NocturnalConfig {
76
- const configPath = resolveConfigPath(stateDir);
77
- if (fs.existsSync(configPath)) {
78
- try {
79
- return JSON.parse(fs.readFileSync(configPath, 'utf8'));
80
- } catch {
81
- // Malformed config — continue with defaults
82
- }
83
- }
84
- return {};
85
- }
86
-
87
- /**
88
- * Merged config result — all three sub-configs from a single file read.
89
- */
90
- export interface NocturnalConfigMerged {
91
- sleepReflection: SleepReflectionConfig;
92
- keywordOptimization: KeywordOptimizationConfig;
93
- cooldownEscalation: CooldownEscalationConfig;
94
- }
95
-
96
- /**
97
- * Load all nocturnal sub-configs from a single file read.
98
- * Use this when multiple configs are needed in the same code path
99
- * (e.g., heartbeat cycle) to avoid reading the same file 3 times.
100
- */
101
- export function loadNocturnalConfigMerged(stateDir: string): NocturnalConfigMerged {
102
- const fileConfig = readRawConfig(stateDir);
103
-
104
- const fileSleep = fileConfig.sleep_reflection || {};
105
- const fileKwOpt = fileConfig.keyword_optimization || {};
106
- const fileCooldown = fileConfig.cooldown_escalation || {};
107
-
108
- return {
109
- sleepReflection: {
110
- trigger_mode: fileSleep.trigger_mode === 'periodic' ? 'periodic' : DEFAULT_SLEEP_REFLECTION.trigger_mode,
111
- period_heartbeats: typeof fileSleep.period_heartbeats === 'number' && fileSleep.period_heartbeats > 0
112
- ? fileSleep.period_heartbeats
113
- : DEFAULT_SLEEP_REFLECTION.period_heartbeats,
114
- cooldown_ms: typeof fileSleep.cooldown_ms === 'number' && fileSleep.cooldown_ms >= 0
115
- ? fileSleep.cooldown_ms
116
- : DEFAULT_SLEEP_REFLECTION.cooldown_ms,
117
- max_runs_per_day: typeof fileSleep.max_runs_per_day === 'number' && fileSleep.max_runs_per_day > 0
118
- ? fileSleep.max_runs_per_day
119
- : DEFAULT_SLEEP_REFLECTION.max_runs_per_day,
120
- enabled: typeof fileSleep.enabled === 'boolean'
121
- ? fileSleep.enabled
122
- : DEFAULT_SLEEP_REFLECTION.enabled,
123
- },
124
- keywordOptimization: {
125
- period_heartbeats: typeof fileKwOpt.period_heartbeats === 'number' && fileKwOpt.period_heartbeats > 0
126
- ? fileKwOpt.period_heartbeats
127
- : DEFAULT_KEYWORD_OPTIMIZATION.period_heartbeats,
128
- enabled: typeof fileKwOpt.enabled === 'boolean'
129
- ? fileKwOpt.enabled
130
- : DEFAULT_KEYWORD_OPTIMIZATION.enabled,
131
- },
132
- cooldownEscalation: {
133
- tier1_ms: typeof fileCooldown.tier1_ms === 'number' && fileCooldown.tier1_ms > 0
134
- ? fileCooldown.tier1_ms
135
- : DEFAULT_COOLDOWN_ESCALATION.tier1_ms,
136
- tier2_ms: typeof fileCooldown.tier2_ms === 'number' && fileCooldown.tier2_ms > 0
137
- ? fileCooldown.tier2_ms
138
- : DEFAULT_COOLDOWN_ESCALATION.tier2_ms,
139
- tier3_ms: typeof fileCooldown.tier3_ms === 'number' && fileCooldown.tier3_ms > 0
140
- ? fileCooldown.tier3_ms
141
- : DEFAULT_COOLDOWN_ESCALATION.tier3_ms,
142
- consecutive_threshold: typeof fileCooldown.consecutive_threshold === 'number' && fileCooldown.consecutive_threshold > 0
143
- ? fileCooldown.consecutive_threshold
144
- : DEFAULT_COOLDOWN_ESCALATION.consecutive_threshold,
145
- },
146
- };
147
- }
148
-
149
- /**
150
- * Load nocturnal config from .state/nocturnal-config.json.
151
- * Returns default config if file doesn't exist or is malformed.
152
- */
153
- export function loadNocturnalConfig(stateDir: string): SleepReflectionConfig {
154
- const fileConfig = readRawConfig(stateDir);
155
- const fileSleep = fileConfig.sleep_reflection || {};
156
-
157
- return {
158
- trigger_mode: fileSleep.trigger_mode === 'periodic' ? 'periodic' : DEFAULT_SLEEP_REFLECTION.trigger_mode,
159
- period_heartbeats: typeof fileSleep.period_heartbeats === 'number' && fileSleep.period_heartbeats > 0
160
- ? fileSleep.period_heartbeats
161
- : DEFAULT_SLEEP_REFLECTION.period_heartbeats,
162
- cooldown_ms: typeof fileSleep.cooldown_ms === 'number' && fileSleep.cooldown_ms >= 0
163
- ? fileSleep.cooldown_ms
164
- : DEFAULT_SLEEP_REFLECTION.cooldown_ms,
165
- max_runs_per_day: typeof fileSleep.max_runs_per_day === 'number' && fileSleep.max_runs_per_day > 0
166
- ? fileSleep.max_runs_per_day
167
- : DEFAULT_SLEEP_REFLECTION.max_runs_per_day,
168
- enabled: typeof fileSleep.enabled === 'boolean'
169
- ? fileSleep.enabled
170
- : DEFAULT_SLEEP_REFLECTION.enabled,
171
- };
172
- }
173
-
174
- /**
175
- * Load keyword_optimization config from .state/nocturnal-config.json.
176
- * Returns default config if file doesn't exist or is malformed.
177
- */
178
- export function loadKeywordOptimizationConfig(stateDir: string): KeywordOptimizationConfig {
179
- const fileConfig = readRawConfig(stateDir);
180
- const fileKwOpt = fileConfig.keyword_optimization || {};
181
-
182
- return {
183
- period_heartbeats: typeof fileKwOpt.period_heartbeats === 'number' && fileKwOpt.period_heartbeats > 0
184
- ? fileKwOpt.period_heartbeats
185
- : DEFAULT_KEYWORD_OPTIMIZATION.period_heartbeats,
186
- enabled: typeof fileKwOpt.enabled === 'boolean'
187
- ? fileKwOpt.enabled
188
- : DEFAULT_KEYWORD_OPTIMIZATION.enabled,
189
- };
190
- }
191
-
192
- /**
193
- * Load cooldown escalation config from .state/nocturnal-config.json.
194
- * Returns default config if file doesn't exist or is malformed.
195
- */
196
- export function loadCooldownEscalationConfig(stateDir: string): CooldownEscalationConfig {
197
- const fileConfig = readRawConfig(stateDir);
198
- const fileCooldown = fileConfig.cooldown_escalation || {};
199
-
200
- return {
201
- tier1_ms: typeof fileCooldown.tier1_ms === 'number' && fileCooldown.tier1_ms > 0
202
- ? fileCooldown.tier1_ms
203
- : DEFAULT_COOLDOWN_ESCALATION.tier1_ms,
204
- tier2_ms: typeof fileCooldown.tier2_ms === 'number' && fileCooldown.tier2_ms > 0
205
- ? fileCooldown.tier2_ms
206
- : DEFAULT_COOLDOWN_ESCALATION.tier2_ms,
207
- tier3_ms: typeof fileCooldown.tier3_ms === 'number' && fileCooldown.tier3_ms > 0
208
- ? fileCooldown.tier3_ms
209
- : DEFAULT_COOLDOWN_ESCALATION.tier3_ms,
210
- consecutive_threshold: typeof fileCooldown.consecutive_threshold === 'number' && fileCooldown.consecutive_threshold > 0
211
- ? fileCooldown.consecutive_threshold
212
- : DEFAULT_COOLDOWN_ESCALATION.consecutive_threshold,
213
- };
214
- }