principles-disciple 1.127.0 → 1.129.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (593) hide show
  1. package/dist/commands/archive-impl.d.ts +18 -0
  2. package/dist/commands/archive-impl.js +105 -0
  3. package/dist/commands/capabilities.d.ts +3 -0
  4. package/dist/commands/capabilities.js +76 -0
  5. package/dist/commands/context.d.ts +5 -0
  6. package/{src/commands/context.ts → dist/commands/context.js} +34 -83
  7. package/dist/commands/disable-impl.d.ts +22 -0
  8. package/dist/commands/disable-impl.js +118 -0
  9. package/dist/commands/evolution-status.d.ts +4 -0
  10. package/dist/commands/evolution-status.js +187 -0
  11. package/dist/commands/export.d.ts +2 -0
  12. package/dist/commands/export.js +53 -0
  13. package/dist/commands/focus.d.ts +14 -0
  14. package/dist/commands/focus.js +443 -0
  15. package/dist/commands/pain.d.ts +6 -0
  16. package/{src/commands/pain.ts → dist/commands/pain.js} +137 -188
  17. package/dist/commands/principle-rollback.d.ts +4 -0
  18. package/dist/commands/principle-rollback.js +26 -0
  19. package/dist/commands/promote-impl.d.ts +22 -0
  20. package/dist/commands/promote-impl.js +194 -0
  21. package/dist/commands/rollback-impl.d.ts +32 -0
  22. package/dist/commands/rollback-impl.js +180 -0
  23. package/dist/commands/rollback.d.ts +19 -0
  24. package/{src/commands/rollback.ts → dist/commands/rollback.js} +10 -53
  25. package/dist/commands/samples.d.ts +2 -0
  26. package/dist/commands/samples.js +58 -0
  27. package/dist/commands/strategy.d.ts +2 -0
  28. package/dist/commands/strategy.js +16 -0
  29. package/dist/commands/thinking-os.d.ts +2 -0
  30. package/{src/commands/thinking-os.ts → dist/commands/thinking-os.js} +35 -58
  31. package/dist/commands/workflow-debug.d.ts +6 -0
  32. package/{src/commands/workflow-debug.ts → dist/commands/workflow-debug.js} +13 -33
  33. package/dist/config/defaults/runtime.d.ts +58 -0
  34. package/{src/config/defaults/runtime.ts → dist/config/defaults/runtime.js} +4 -41
  35. package/dist/config/errors.d.ts +86 -0
  36. package/dist/config/errors.js +107 -0
  37. package/{src/config/index.ts → dist/config/index.d.ts} +1 -2
  38. package/dist/config/index.js +7 -0
  39. package/dist/constants/diagnostician.d.ts +12 -0
  40. package/{src/constants/diagnostician.ts → dist/constants/diagnostician.js} +0 -1
  41. package/dist/constants/tools.d.ts +17 -0
  42. package/dist/constants/tools.js +53 -0
  43. package/dist/core/__tests__/focus-history.test.d.ts +1 -0
  44. package/dist/core/__tests__/focus-history.test.js +160 -0
  45. package/dist/core/bootstrap-rules.d.ts +50 -0
  46. package/dist/core/bootstrap-rules.js +187 -0
  47. package/dist/core/code-implementation-storage.d.ts +71 -0
  48. package/dist/core/code-implementation-storage.js +139 -0
  49. package/dist/core/config-health.d.ts +27 -0
  50. package/dist/core/config-health.js +60 -0
  51. package/dist/core/config-service.d.ts +15 -0
  52. package/{src/core/config-service.ts → dist/core/config-service.js} +4 -7
  53. package/dist/core/config.d.ts +111 -0
  54. package/{src/core/config.ts → dist/core/config.js} +46 -146
  55. package/dist/core/control-ui-db.d.ts +106 -0
  56. package/dist/core/control-ui-db.js +309 -0
  57. package/dist/core/correction-cue-learner.d.ts +33 -0
  58. package/dist/core/correction-cue-learner.js +184 -0
  59. package/dist/core/correction-types.d.ts +3 -0
  60. package/dist/core/correction-types.js +1 -0
  61. package/dist/core/detection-funnel.d.ts +33 -0
  62. package/{src/core/detection-funnel.ts → dist/core/detection-funnel.js} +17 -37
  63. package/dist/core/detection-service.d.ts +15 -0
  64. package/{src/core/detection-service.ts → dist/core/detection-service.js} +4 -7
  65. package/dist/core/dictionary-service.d.ts +15 -0
  66. package/{src/core/dictionary-service.ts → dist/core/dictionary-service.js} +4 -7
  67. package/dist/core/dictionary.d.ts +38 -0
  68. package/{src/core/dictionary.ts → dist/core/dictionary.js} +33 -59
  69. package/dist/core/empathy-keyword-matcher.d.ts +5 -0
  70. package/dist/core/empathy-keyword-matcher.js +40 -0
  71. package/dist/core/empathy-types.d.ts +2 -0
  72. package/dist/core/empathy-types.js +1 -0
  73. package/dist/core/event-log.d.ts +90 -0
  74. package/dist/core/event-log.js +702 -0
  75. package/dist/core/evolution-engine.d.ts +119 -0
  76. package/dist/core/evolution-engine.js +460 -0
  77. package/dist/core/evolution-logger.d.ts +137 -0
  78. package/dist/core/evolution-logger.js +261 -0
  79. package/dist/core/evolution-migration.d.ts +5 -0
  80. package/dist/core/evolution-migration.js +65 -0
  81. package/dist/core/evolution-reducer.d.ts +124 -0
  82. package/dist/core/evolution-reducer.js +730 -0
  83. package/dist/core/evolution-types.d.ts +50 -0
  84. package/dist/core/evolution-types.js +11 -0
  85. package/dist/core/external-training-contract.d.ts +276 -0
  86. package/dist/core/external-training-contract.js +269 -0
  87. package/dist/core/file-store.d.ts +41 -0
  88. package/dist/core/file-store.js +46 -0
  89. package/dist/core/focus-history.d.ts +50 -0
  90. package/dist/core/focus-history.js +574 -0
  91. package/dist/core/hygiene/tracker.d.ts +22 -0
  92. package/dist/core/hygiene/tracker.js +110 -0
  93. package/dist/core/init.d.ts +30 -0
  94. package/{src/core/init.ts → dist/core/init.js} +87 -118
  95. package/dist/core/local-worker-routing.d.ts +124 -0
  96. package/dist/core/local-worker-routing.js +216 -0
  97. package/dist/core/migration.d.ts +6 -0
  98. package/{src/core/migration.ts → dist/core/migration.js} +10 -18
  99. package/dist/core/model-deployment-registry.d.ts +218 -0
  100. package/dist/core/model-deployment-registry.js +502 -0
  101. package/dist/core/model-training-registry.d.ts +295 -0
  102. package/dist/core/model-training-registry.js +474 -0
  103. package/dist/core/observability.d.ts +40 -0
  104. package/dist/core/observability.js +164 -0
  105. package/dist/core/pain-diagnostic-gate.d.ts +36 -0
  106. package/dist/core/pain-diagnostic-gate.js +105 -0
  107. package/dist/core/pain.d.ts +87 -0
  108. package/dist/core/pain.js +223 -0
  109. package/dist/core/path-resolver.d.ts +60 -0
  110. package/{src/core/path-resolver.ts → dist/core/path-resolver.js} +41 -131
  111. package/dist/core/paths.d.ts +60 -0
  112. package/{src/core/paths.ts → dist/core/paths.js} +4 -13
  113. package/dist/core/pd-config-loader.d.ts +96 -0
  114. package/dist/core/pd-config-loader.js +307 -0
  115. package/dist/core/pd-task-reconciler.d.ts +89 -0
  116. package/dist/core/pd-task-reconciler.js +262 -0
  117. package/dist/core/pd-task-service.d.ts +2 -0
  118. package/dist/core/pd-task-service.js +32 -0
  119. package/dist/core/pd-task-store.d.ts +5 -0
  120. package/dist/core/pd-task-store.js +62 -0
  121. package/dist/core/pd-task-types.d.ts +8 -0
  122. package/dist/core/pd-task-types.js +2 -0
  123. package/dist/core/principle-compiler/__tests__/compiler-replay-gate.test.d.ts +1 -0
  124. package/dist/core/principle-compiler/__tests__/compiler-replay-gate.test.js +132 -0
  125. package/dist/core/principle-compiler/code-validator.d.ts +14 -0
  126. package/dist/core/principle-compiler/code-validator.js +86 -0
  127. package/dist/core/principle-compiler/compiler.d.ts +45 -0
  128. package/dist/core/principle-compiler/compiler.js +287 -0
  129. package/{src/core/principle-compiler/index.ts → dist/core/principle-compiler/index.d.ts} +0 -1
  130. package/dist/core/principle-compiler/index.js +10 -0
  131. package/dist/core/principle-compiler/ledger-registrar.d.ts +28 -0
  132. package/dist/core/principle-compiler/ledger-registrar.js +95 -0
  133. package/{src/core/principle-compiler/template-generator.ts → dist/core/principle-compiler/template-generator.d.ts} +0 -1
  134. package/dist/core/principle-compiler/template-generator.js +7 -0
  135. package/{src/core/principle-injection.ts → dist/core/principle-injection.d.ts} +1 -7
  136. package/dist/core/principle-injection.js +10 -0
  137. package/dist/core/principle-internalization/filesystem-lifecycle-datasource.d.ts +15 -0
  138. package/dist/core/principle-internalization/filesystem-lifecycle-datasource.js +34 -0
  139. package/dist/core/principle-internalization/lifecycle-read-model.d.ts +17 -0
  140. package/{src/core/principle-internalization/lifecycle-read-model.ts → dist/core/principle-internalization/lifecycle-read-model.js} +2 -21
  141. package/dist/core/principle-internalization/lifecycle-refresh.d.ts +2 -0
  142. package/dist/core/principle-internalization/lifecycle-refresh.js +4 -0
  143. package/dist/core/principle-internalization/principle-lifecycle-service.d.ts +28 -0
  144. package/dist/core/principle-internalization/principle-lifecycle-service.js +89 -0
  145. package/dist/core/principle-training-state.d.ts +47 -0
  146. package/dist/core/principle-training-state.js +113 -0
  147. package/dist/core/principle-tree-ledger-adapter.d.ts +32 -0
  148. package/dist/core/principle-tree-ledger-adapter.js +125 -0
  149. package/dist/core/principle-tree-ledger.d.ts +82 -0
  150. package/dist/core/principle-tree-ledger.js +527 -0
  151. package/dist/core/profile.d.ts +62 -0
  152. package/dist/core/profile.js +211 -0
  153. package/dist/core/promotion-gate.d.ts +243 -0
  154. package/dist/core/promotion-gate.js +554 -0
  155. package/dist/core/reflection/reflection-context.d.ts +31 -0
  156. package/dist/core/reflection/reflection-context.js +91 -0
  157. package/dist/core/replay-engine.d.ts +12 -0
  158. package/dist/core/replay-engine.js +82 -0
  159. package/dist/core/risk-calculator.d.ts +22 -0
  160. package/{src/core/risk-calculator.ts → dist/core/risk-calculator.js} +19 -49
  161. package/{src/core/rule-host-helpers.ts → dist/core/rule-host-helpers.d.ts} +0 -1
  162. package/dist/core/rule-host-helpers.js +7 -0
  163. package/{src/core/rule-host-types.ts → dist/core/rule-host-types.d.ts} +1 -8
  164. package/dist/core/rule-host-types.js +7 -0
  165. package/dist/core/rule-host.d.ts +86 -0
  166. package/dist/core/rule-host.js +311 -0
  167. package/dist/core/rule-implementation-runtime.d.ts +18 -0
  168. package/dist/core/rule-implementation-runtime.js +112 -0
  169. package/dist/core/runtime-v2-prompt-activation-reader.d.ts +22 -0
  170. package/dist/core/runtime-v2-prompt-activation-reader.js +99 -0
  171. package/{src/core/schema/db-types.ts → dist/core/schema/db-types.d.ts} +4 -9
  172. package/dist/core/schema/db-types.js +5 -0
  173. package/{src/core/schema/index.ts → dist/core/schema/index.d.ts} +1 -10
  174. package/dist/core/schema/index.js +15 -0
  175. package/dist/core/schema/migration-runner.d.ts +53 -0
  176. package/dist/core/schema/migration-runner.js +170 -0
  177. package/dist/core/schema/migrations/001-init-trajectory.d.ts +6 -0
  178. package/{src/core/schema/migrations/001-init-trajectory.ts → dist/core/schema/migrations/001-init-trajectory.js} +38 -56
  179. package/dist/core/schema/migrations/002-init-central.d.ts +5 -0
  180. package/{src/core/schema/migrations/002-init-central.ts → dist/core/schema/migrations/002-init-central.js} +27 -41
  181. package/dist/core/schema/migrations/003-init-workflow.d.ts +5 -0
  182. package/{src/core/schema/migrations/003-init-workflow.ts → dist/core/schema/migrations/003-init-workflow.js} +16 -21
  183. package/dist/core/schema/migrations/004-add-thinking-and-gfi.d.ts +8 -0
  184. package/{src/core/schema/migrations/004-add-thinking-and-gfi.ts → dist/core/schema/migrations/004-add-thinking-and-gfi.js} +19 -27
  185. package/{src/core/schema/migrations/index.ts → dist/core/schema/migrations/index.d.ts} +1 -16
  186. package/dist/core/schema/migrations/index.js +27 -0
  187. package/dist/core/schema/schema-definitions.d.ts +46 -0
  188. package/{src/core/schema/schema-definitions.ts → dist/core/schema/schema-definitions.js} +242 -291
  189. package/dist/core/session-tracker.d.ts +119 -0
  190. package/{src/core/session-tracker.ts → dist/core/session-tracker.js} +96 -239
  191. package/dist/core/shadow-observation-registry.d.ts +217 -0
  192. package/dist/core/shadow-observation-registry.js +280 -0
  193. package/dist/core/surface-guard.d.ts +31 -0
  194. package/dist/core/surface-guard.js +131 -0
  195. package/dist/core/system-logger.d.ts +8 -0
  196. package/{src/core/system-logger.ts → dist/core/system-logger.js} +20 -34
  197. package/dist/core/thinking-models.d.ts +70 -0
  198. package/dist/core/thinking-models.js +300 -0
  199. package/dist/core/thinking-os-parser.d.ts +35 -0
  200. package/dist/core/thinking-os-parser.js +123 -0
  201. package/dist/core/trajectory-types.d.ts +220 -0
  202. package/dist/core/trajectory-types.js +8 -0
  203. package/dist/core/trajectory.d.ts +242 -0
  204. package/dist/core/trajectory.js +1500 -0
  205. package/dist/core/workflow-funnel-loader.d.ts +72 -0
  206. package/dist/core/workflow-funnel-loader.js +135 -0
  207. package/dist/core/workspace-context.d.ts +111 -0
  208. package/{src/core/workspace-context.ts → dist/core/workspace-context.js} +50 -105
  209. package/dist/core/workspace-dir-validation.d.ts +11 -0
  210. package/dist/core/workspace-dir-validation.js +37 -0
  211. package/dist/core/workspace-guidance-migrator.d.ts +12 -0
  212. package/{src/core/workspace-guidance-migrator.ts → dist/core/workspace-guidance-migrator.js} +21 -59
  213. package/dist/hooks/after-tool-call-helpers.d.ts +89 -0
  214. package/dist/hooks/after-tool-call-helpers.js +475 -0
  215. package/dist/hooks/after-tool-call-types.d.ts +86 -0
  216. package/dist/hooks/after-tool-call-types.js +13 -0
  217. package/dist/hooks/gate-block-helper.d.ts +44 -0
  218. package/dist/hooks/gate-block-helper.js +209 -0
  219. package/dist/hooks/gate.d.ts +16 -0
  220. package/dist/hooks/gate.js +381 -0
  221. package/dist/hooks/lifecycle.d.ts +5 -0
  222. package/dist/hooks/lifecycle.js +287 -0
  223. package/dist/hooks/llm.d.ts +13 -0
  224. package/{src/hooks/llm.ts → dist/hooks/llm.js} +63 -117
  225. package/dist/hooks/message-sanitize.d.ts +24 -0
  226. package/dist/hooks/message-sanitize.js +77 -0
  227. package/dist/hooks/pain.d.ts +33 -0
  228. package/dist/hooks/pain.js +294 -0
  229. package/dist/hooks/prompt.d.ts +52 -0
  230. package/dist/hooks/prompt.js +930 -0
  231. package/dist/hooks/raw-observation-adapter.d.ts +57 -0
  232. package/dist/hooks/raw-observation-adapter.js +170 -0
  233. package/dist/hooks/raw-observation-types.d.ts +62 -0
  234. package/dist/hooks/raw-observation-types.js +15 -0
  235. package/dist/hooks/subagent.d.ts +9 -0
  236. package/{src/hooks/subagent.ts → dist/hooks/subagent.js} +20 -60
  237. package/dist/hooks/trajectory-collector.d.ts +25 -0
  238. package/dist/hooks/trajectory-collector.js +225 -0
  239. package/dist/hooks/trajectory-evidence.d.ts +11 -0
  240. package/dist/hooks/trajectory-evidence.js +88 -0
  241. package/dist/hooks/triage-adapter.d.ts +58 -0
  242. package/{src/hooks/triage-adapter.ts → dist/hooks/triage-adapter.js} +36 -68
  243. package/dist/hooks/trigger-cooldown-tracker.d.ts +30 -0
  244. package/dist/hooks/trigger-cooldown-tracker.js +55 -0
  245. package/dist/i18n/commands.d.ts +26 -0
  246. package/dist/i18n/commands.js +96 -0
  247. package/dist/index.d.ts +50 -0
  248. package/dist/index.js +829 -0
  249. package/dist/openclaw-sdk.d.ts +293 -0
  250. package/dist/openclaw-sdk.js +4 -0
  251. package/dist/service/central-database.d.ts +138 -0
  252. package/dist/service/central-database.js +731 -0
  253. package/dist/service/central-sync-service.d.ts +8 -0
  254. package/dist/service/central-sync-service.js +71 -0
  255. package/dist/service/correction-observer-service.d.ts +19 -0
  256. package/{src/service/correction-observer-service.ts → dist/service/correction-observer-service.js} +36 -76
  257. package/dist/service/evolution-dedup.d.ts +27 -0
  258. package/{src/service/evolution-dedup.ts → dist/service/evolution-dedup.js} +11 -31
  259. package/{src/service/evolution-queue-migration.ts → dist/service/evolution-queue-migration.d.ts} +15 -62
  260. package/dist/service/evolution-queue-migration.js +53 -0
  261. package/dist/service/evolution-worker.d.ts +103 -0
  262. package/{src/service/evolution-worker.ts → dist/service/evolution-worker.js} +169 -331
  263. package/dist/service/internalization-auto-consumer-service.d.ts +8 -0
  264. package/dist/service/internalization-auto-consumer-service.js +322 -0
  265. package/dist/service/keyword-optimization-service.d.ts +44 -0
  266. package/dist/service/keyword-optimization-service.js +137 -0
  267. package/dist/service/phase3-input-filter.d.ts +73 -0
  268. package/dist/service/phase3-input-filter.js +172 -0
  269. package/dist/service/queue-io.d.ts +30 -0
  270. package/dist/service/queue-io.js +79 -0
  271. package/{src/service/queue-migration.ts → dist/service/queue-migration.d.ts} +6 -45
  272. package/dist/service/queue-migration.js +56 -0
  273. package/dist/service/runtime-summary-service.d.ts +158 -0
  274. package/dist/service/runtime-summary-service.js +636 -0
  275. package/dist/service/subagent-workflow/subagent-error-utils.d.ts +8 -0
  276. package/{src/service/subagent-workflow/subagent-error-utils.ts → dist/service/subagent-workflow/subagent-error-utils.js} +3 -6
  277. package/{src/service/subagent-workflow/types.ts → dist/service/subagent-workflow/types.d.ts} +17 -80
  278. package/dist/service/subagent-workflow/types.js +11 -0
  279. package/dist/service/subagent-workflow/workflow-store.d.ts +30 -0
  280. package/{src/service/subagent-workflow/workflow-store.ts → dist/service/subagent-workflow/workflow-store.js} +43 -108
  281. package/dist/service/trajectory-service.d.ts +2 -0
  282. package/dist/service/trajectory-service.js +16 -0
  283. package/dist/service/workflow-watchdog.d.ts +23 -0
  284. package/dist/service/workflow-watchdog.js +103 -0
  285. package/dist/types/event-types.d.ts +2 -0
  286. package/dist/types/event-types.js +1 -0
  287. package/dist/types/hygiene-types.d.ts +2 -0
  288. package/dist/types/hygiene-types.js +1 -0
  289. package/{src/types/principle-tree-schema.ts → dist/types/principle-tree-schema.d.ts} +2 -25
  290. package/dist/types/principle-tree-schema.js +24 -0
  291. package/dist/types/queue.d.ts +2 -0
  292. package/dist/types/queue.js +1 -0
  293. package/dist/types/runtime-summary.d.ts +1 -0
  294. package/dist/types/runtime-summary.js +1 -0
  295. package/dist/types.d.ts +33 -0
  296. package/dist/types.js +16 -0
  297. package/dist/utils/file-lock.d.ts +68 -0
  298. package/dist/utils/file-lock.js +310 -0
  299. package/dist/utils/hashing.d.ts +9 -0
  300. package/{src/utils/hashing.ts → dist/utils/hashing.js} +4 -6
  301. package/dist/utils/io.d.ts +11 -0
  302. package/dist/utils/io.js +174 -0
  303. package/dist/utils/node-vm-polyfill.d.ts +9 -0
  304. package/{src/utils/node-vm-polyfill.ts → dist/utils/node-vm-polyfill.js} +0 -2
  305. package/dist/utils/retry.d.ts +210 -0
  306. package/dist/utils/retry.js +375 -0
  307. package/dist/utils/session-key.d.ts +10 -0
  308. package/{src/utils/session-key.ts → dist/utils/session-key.js} +5 -4
  309. package/dist/utils/shadow-fingerprint.d.ts +16 -0
  310. package/dist/utils/shadow-fingerprint.js +34 -0
  311. package/dist/utils/workspace-resolver.d.ts +82 -0
  312. package/dist/utils/workspace-resolver.js +288 -0
  313. package/openclaw.plugin.json +1 -1
  314. package/package.json +8 -2
  315. package/templates/workspace/.principles/DECISION_POLICY.json +44 -0
  316. package/templates/workspace/.principles/PRINCIPLES.md +20 -0
  317. package/templates/workspace/.principles/PROFILE.json +54 -0
  318. package/templates/workspace/.principles/PROFILE.schema.json +56 -0
  319. package/templates/workspace/.principles/THINKING_OS.md +65 -0
  320. package/templates/workspace/.principles/THINKING_OS_ARCHIVE.md +7 -0
  321. package/templates/workspace/.principles/THINKING_OS_CANDIDATES.md +9 -0
  322. package/templates/workspace/.principles/models/_INDEX.md +27 -0
  323. package/templates/workspace/.principles/models/first_principles.md +62 -0
  324. package/templates/workspace/.principles/models/marketing_4p.md +52 -0
  325. package/templates/workspace/.principles/models/porter_five.md +63 -0
  326. package/templates/workspace/.principles/models/swot.md +60 -0
  327. package/templates/workspace/.principles/models/user_story_map.md +63 -0
  328. package/templates/workspace/.state/WORKBOARD.json +4 -0
  329. package/.dependency-cruiser.json +0 -19
  330. package/ADVANCED_CONFIG_ZH.md +0 -93
  331. package/AGENT_INSTALL.md +0 -173
  332. package/AGENT_INSTALL_EN.md +0 -173
  333. package/CHANGELOG.md +0 -26
  334. package/INSTALL.md +0 -254
  335. package/SKILL.md +0 -63
  336. package/esbuild.config.js +0 -104
  337. package/src/commands/archive-impl.ts +0 -147
  338. package/src/commands/capabilities.ts +0 -89
  339. package/src/commands/disable-impl.ts +0 -159
  340. package/src/commands/evolution-status.ts +0 -247
  341. package/src/commands/export.ts +0 -59
  342. package/src/commands/focus.ts +0 -523
  343. package/src/commands/principle-rollback.ts +0 -32
  344. package/src/commands/promote-impl.ts +0 -254
  345. package/src/commands/rollback-impl.ts +0 -246
  346. package/src/commands/samples.ts +0 -65
  347. package/src/commands/strategy.ts +0 -21
  348. package/src/config/errors.ts +0 -180
  349. package/src/constants/tools.ts +0 -62
  350. package/src/core/AGENTS.md +0 -34
  351. package/src/core/__tests__/focus-history.test.ts +0 -210
  352. package/src/core/bootstrap-rules.ts +0 -216
  353. package/src/core/code-implementation-storage.ts +0 -213
  354. package/src/core/config-health.ts +0 -72
  355. package/src/core/control-ui-db.ts +0 -454
  356. package/src/core/correction-cue-learner.ts +0 -239
  357. package/src/core/correction-types.ts +0 -16
  358. package/src/core/empathy-keyword-matcher.ts +0 -64
  359. package/src/core/empathy-types.ts +0 -18
  360. package/src/core/event-log.ts +0 -787
  361. package/src/core/evolution-engine.ts +0 -613
  362. package/src/core/evolution-logger.ts +0 -357
  363. package/src/core/evolution-migration.ts +0 -77
  364. package/src/core/evolution-reducer.ts +0 -891
  365. package/src/core/evolution-types.ts +0 -110
  366. package/src/core/external-training-contract.ts +0 -530
  367. package/src/core/file-store.ts +0 -80
  368. package/src/core/focus-history.ts +0 -763
  369. package/src/core/hygiene/tracker.ts +0 -122
  370. package/src/core/local-worker-routing.ts +0 -337
  371. package/src/core/model-deployment-registry.ts +0 -724
  372. package/src/core/model-training-registry.ts +0 -815
  373. package/src/core/observability.ts +0 -242
  374. package/src/core/pain-diagnostic-gate.ts +0 -169
  375. package/src/core/pain.ts +0 -309
  376. package/src/core/pd-config-loader.ts +0 -400
  377. package/src/core/pd-task-reconciler.ts +0 -380
  378. package/src/core/pd-task-service.ts +0 -43
  379. package/src/core/pd-task-store.ts +0 -78
  380. package/src/core/pd-task-types.ts +0 -24
  381. package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +0 -174
  382. package/src/core/principle-compiler/code-validator.ts +0 -96
  383. package/src/core/principle-compiler/compiler.ts +0 -327
  384. package/src/core/principle-compiler/ledger-registrar.ts +0 -116
  385. package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +0 -42
  386. package/src/core/principle-internalization/lifecycle-refresh.ts +0 -11
  387. package/src/core/principle-internalization/principle-lifecycle-service.ts +0 -170
  388. package/src/core/principle-training-state.ts +0 -177
  389. package/src/core/principle-tree-ledger-adapter.ts +0 -145
  390. package/src/core/principle-tree-ledger.ts +0 -725
  391. package/src/core/profile.ts +0 -228
  392. package/src/core/promotion-gate.ts +0 -854
  393. package/src/core/reflection/reflection-context.ts +0 -133
  394. package/src/core/replay-engine.ts +0 -106
  395. package/src/core/rule-host.ts +0 -386
  396. package/src/core/rule-implementation-runtime.ts +0 -145
  397. package/src/core/runtime-v2-prompt-activation-reader.ts +0 -114
  398. package/src/core/schema/migration-runner.ts +0 -207
  399. package/src/core/shadow-observation-registry.ts +0 -508
  400. package/src/core/surface-guard.ts +0 -188
  401. package/src/core/thinking-models.ts +0 -377
  402. package/src/core/thinking-os-parser.ts +0 -165
  403. package/src/core/trajectory-types.ts +0 -247
  404. package/src/core/trajectory.ts +0 -1831
  405. package/src/core/workflow-funnel-loader.ts +0 -195
  406. package/src/core/workspace-dir-validation.ts +0 -52
  407. package/src/hooks/AGENTS.md +0 -31
  408. package/src/hooks/after-tool-call-helpers.ts +0 -601
  409. package/src/hooks/after-tool-call-types.ts +0 -99
  410. package/src/hooks/gate-block-helper.ts +0 -265
  411. package/src/hooks/gate.ts +0 -394
  412. package/src/hooks/lifecycle.ts +0 -334
  413. package/src/hooks/message-sanitize.ts +0 -102
  414. package/src/hooks/pain.ts +0 -358
  415. package/src/hooks/prompt.ts +0 -1102
  416. package/src/hooks/raw-observation-adapter.ts +0 -215
  417. package/src/hooks/raw-observation-types.ts +0 -77
  418. package/src/hooks/trajectory-collector.ts +0 -253
  419. package/src/hooks/trajectory-evidence.ts +0 -97
  420. package/src/hooks/trigger-cooldown-tracker.ts +0 -82
  421. package/src/i18n/commands.ts +0 -101
  422. package/src/index.ts +0 -939
  423. package/src/openclaw-sdk.ts +0 -312
  424. package/src/service/central-database.ts +0 -936
  425. package/src/service/central-sync-service.ts +0 -85
  426. package/src/service/internalization-auto-consumer-service.ts +0 -397
  427. package/src/service/keyword-optimization-service.ts +0 -169
  428. package/src/service/phase3-input-filter.ts +0 -237
  429. package/src/service/queue-io.ts +0 -108
  430. package/src/service/runtime-summary-service.ts +0 -990
  431. package/src/service/trajectory-service.ts +0 -16
  432. package/src/service/workflow-watchdog.ts +0 -125
  433. package/src/types/event-types.ts +0 -39
  434. package/src/types/hygiene-types.ts +0 -8
  435. package/src/types/queue.ts +0 -15
  436. package/src/types/runtime-summary.ts +0 -5
  437. package/src/types.ts +0 -53
  438. package/src/utils/file-lock.ts +0 -394
  439. package/src/utils/io.ts +0 -176
  440. package/src/utils/retry.ts +0 -573
  441. package/src/utils/shadow-fingerprint.ts +0 -42
  442. package/src/utils/workspace-resolver.ts +0 -393
  443. package/tests/README.md +0 -120
  444. package/tests/build-artifacts.test.ts +0 -55
  445. package/tests/commands/evolution-status.test.ts +0 -511
  446. package/tests/commands/export.test.ts +0 -78
  447. package/tests/commands/pain.test.ts +0 -287
  448. package/tests/commands/samples.test.ts +0 -65
  449. package/tests/commands/strategy.test.ts +0 -19
  450. package/tests/commands/thinking-os.test.ts +0 -88
  451. package/tests/core/bootstrap-rules.test.ts +0 -596
  452. package/tests/core/code-implementation-storage.test.ts +0 -300
  453. package/tests/core/code-validator.test.ts +0 -197
  454. package/tests/core/config-service.test.ts +0 -89
  455. package/tests/core/config.test.ts +0 -90
  456. package/tests/core/control-ui-db.test.ts +0 -75
  457. package/tests/core/core-principle-registry-drift.test.ts +0 -39
  458. package/tests/core/core-template-guidance.test.ts +0 -21
  459. package/tests/core/correction-cue-learner.test.ts +0 -345
  460. package/tests/core/detection-service.test.ts +0 -50
  461. package/tests/core/dictionary-service.test.ts +0 -116
  462. package/tests/core/dictionary.test.ts +0 -171
  463. package/tests/core/empathy-keyword-matcher.test.ts +0 -209
  464. package/tests/core/event-log.test.ts +0 -484
  465. package/tests/core/evolution-engine.test.ts +0 -610
  466. package/tests/core/evolution-logger.test.ts +0 -148
  467. package/tests/core/evolution-migration.test.ts +0 -374
  468. package/tests/core/evolution-paths.test.ts +0 -21
  469. package/tests/core/evolution-reducer.compilation-retry.test.ts +0 -189
  470. package/tests/core/evolution-reducer.detector-metadata.test.ts +0 -602
  471. package/tests/core/evolution-types-loop.test.ts +0 -48
  472. package/tests/core/external-training-contract.test.ts +0 -463
  473. package/tests/core/file-store.test.ts +0 -102
  474. package/tests/core/focus-history.test.ts +0 -874
  475. package/tests/core/init-flatten.test.ts +0 -69
  476. package/tests/core/init-refactor.test.ts +0 -87
  477. package/tests/core/init-v1.3.test.ts +0 -46
  478. package/tests/core/init.test.ts +0 -190
  479. package/tests/core/ledger-registrar.test.ts +0 -235
  480. package/tests/core/migration.test.ts +0 -84
  481. package/tests/core/model-deployment-registry.test.ts +0 -858
  482. package/tests/core/model-training-registry.test.ts +0 -908
  483. package/tests/core/observability.test.ts +0 -382
  484. package/tests/core/pain-diagnostic-gate.test.ts +0 -614
  485. package/tests/core/pain-score.property.test.ts +0 -19
  486. package/tests/core/pain.test.ts +0 -132
  487. package/tests/core/path-resolver.test.ts +0 -57
  488. package/tests/core/paths-refactor.test.ts +0 -20
  489. package/tests/core/pd-config-loader.test.ts +0 -407
  490. package/tests/core/pd-task-store.test.ts +0 -126
  491. package/tests/core/phase7-rollout-integration.test.ts +0 -477
  492. package/tests/core/principle-compiler.test.ts +0 -350
  493. package/tests/core/principle-injection.test.ts +0 -223
  494. package/tests/core/principle-internalization/deprecated-readiness.test.ts +0 -193
  495. package/tests/core/principle-internalization/lifecycle-metrics.test.ts +0 -350
  496. package/tests/core/principle-internalization/lifecycle-routing-policy.test.ts +0 -212
  497. package/tests/core/principle-internalization/lineage-source-retired.test.ts +0 -56
  498. package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +0 -189
  499. package/tests/core/principle-training-state.test.ts +0 -939
  500. package/tests/core/principle-tree-ledger-adapter.test.ts +0 -253
  501. package/tests/core/principle-tree-ledger.test.ts +0 -423
  502. package/tests/core/profile.test.ts +0 -56
  503. package/tests/core/promotion-gate.test.ts +0 -561
  504. package/tests/core/queue-purge.test.ts +0 -337
  505. package/tests/core/reflection-context.test.ts +0 -342
  506. package/tests/core/regression-v1-9-1.test.ts +0 -266
  507. package/tests/core/replay-engine.test.ts +0 -165
  508. package/tests/core/risk-calculator.test.ts +0 -168
  509. package/tests/core/rule-host-adversarial-output.test.ts +0 -242
  510. package/tests/core/rule-host-autocorrect-vm.test.ts +0 -163
  511. package/tests/core/rule-host-helpers.test.ts +0 -120
  512. package/tests/core/rule-host-resource-bounds.test.ts +0 -231
  513. package/tests/core/rule-host-sqlite-source.test.ts +0 -720
  514. package/tests/core/rule-host-unhealthy-visibility.test.ts +0 -261
  515. package/tests/core/rule-host-validation.test.ts +0 -315
  516. package/tests/core/rule-implementation-runtime.test.ts +0 -49
  517. package/tests/core/session-tracker.test.ts +0 -191
  518. package/tests/core/surface-guard.test.ts +0 -338
  519. package/tests/core/template-generator.test.ts +0 -101
  520. package/tests/core/trajectory.test.ts +0 -427
  521. package/tests/core/workflow-funnel-loader.test.ts +0 -1028
  522. package/tests/core/workspace-context-factory.test.ts +0 -18
  523. package/tests/core/workspace-context.test.ts +0 -187
  524. package/tests/core/workspace-guidance-migrator.test.ts +0 -248
  525. package/tests/core-anti-growth.test.ts +0 -182
  526. package/tests/evolution-worker-quarantine.test.ts +0 -400
  527. package/tests/evolution-worker-slimming.test.ts +0 -380
  528. package/tests/fixtures/legacy-queue-v1.json +0 -74
  529. package/tests/fixtures/production-compatibility.test.ts +0 -147
  530. package/tests/fixtures/production-mock-generator.ts +0 -282
  531. package/tests/globalSetup.ts +0 -38
  532. package/tests/hook-workspace-nextaction-contract.test.ts +0 -50
  533. package/tests/hooks/confirm-first-removal.test.ts +0 -188
  534. package/tests/hooks/gate-auto-correct-shadow.test.ts +0 -309
  535. package/tests/hooks/gate-auto-correct.test.ts +0 -664
  536. package/tests/hooks/gate-block-helper-profile.test.ts +0 -186
  537. package/tests/hooks/gate-no-path-write-tool.test.ts +0 -171
  538. package/tests/hooks/gate-rule-host-pipeline.test.ts +0 -230
  539. package/tests/hooks/gate-rule-host-real-pipeline.test.ts +0 -190
  540. package/tests/hooks/lifecycle.test.ts +0 -248
  541. package/tests/hooks/message-sanitize.test.ts +0 -244
  542. package/tests/hooks/pain-emission-characterization.test.ts +0 -420
  543. package/tests/hooks/pain.test.ts +0 -795
  544. package/tests/hooks/prompt-characterization.test.ts +0 -476
  545. package/tests/hooks/prompt-diet.test.ts +0 -335
  546. package/tests/hooks/prompt-size-guard.test.ts +0 -319
  547. package/tests/hooks/raw-observation-adapter.test.ts +0 -312
  548. package/tests/hooks/runtime-v2-prompt-activation.test.ts +0 -895
  549. package/tests/hooks/single-gate-pain-admission.test.ts +0 -258
  550. package/tests/hooks/subagent.test.ts +0 -469
  551. package/tests/hooks/trajectory-collector.test.ts +0 -269
  552. package/tests/hooks/trajectory-evidence.test.ts +0 -280
  553. package/tests/hooks/triage-adapter.test.ts +0 -331
  554. package/tests/hygiene-tracker.test.ts +0 -77
  555. package/tests/index.test.ts +0 -142
  556. package/tests/integration/auto-entry-gate.test.ts +0 -256
  557. package/tests/integration/gate-real-io.e2e.test.ts +0 -248
  558. package/tests/integration/m8-legacy-paths.test.ts +0 -63
  559. package/tests/integration/mvp-surface-registry-guard.test.ts +0 -536
  560. package/tests/integration/pain-id-chain-e2e.test.ts +0 -313
  561. package/tests/integration/principle-compiler-e2e.test.ts +0 -403
  562. package/tests/integration/principle-lifecycle.e2e.test.ts +0 -198
  563. package/tests/integration/runtime-v2-pain-guard.test.ts +0 -125
  564. package/tests/integration/trajectory-lifecycle.e2e.test.ts +0 -523
  565. package/tests/internalization-auto-consumer-gate.test.ts +0 -158
  566. package/tests/internalization-auto-consumer-service.test.ts +0 -219
  567. package/tests/plugin-config-resolution-cutover.test.ts +0 -359
  568. package/tests/queue/async-lock.test.ts +0 -200
  569. package/tests/runtime-v2-discovery-guard.test.ts +0 -153
  570. package/tests/scripts/validate-live-path.test.ts +0 -286
  571. package/tests/service/central-database.test.ts +0 -457
  572. package/tests/service/correction-observer-service.test.ts +0 -505
  573. package/tests/service/evolution-worker.compilation-backfill.test.ts +0 -203
  574. package/tests/service/evolution-worker.correction-observer.test.ts +0 -50
  575. package/tests/service/evolution-worker.queue.test.ts +0 -296
  576. package/tests/service/evolution-worker.timeout.test.ts +0 -233
  577. package/tests/service/keyword-optimization-service.test.ts +0 -121
  578. package/tests/service/phase3-input-filter.test.ts +0 -289
  579. package/tests/service/queue-io.test.ts +0 -168
  580. package/tests/service/queue-migration.test.ts +0 -147
  581. package/tests/service/runtime-summary-service.test.ts +0 -1100
  582. package/tests/service/workflow-watchdog.test.ts +0 -281
  583. package/tests/task-compliance.test.ts +0 -166
  584. package/tests/test-utils.ts +0 -48
  585. package/tests/utils/file-lock.test.ts +0 -409
  586. package/tests/utils/hashing.test.ts +0 -32
  587. package/tests/utils/hook-workspace-resolver.test.ts +0 -524
  588. package/tests/utils/io.test.ts +0 -39
  589. package/tests/utils/retry.test.ts +0 -327
  590. package/tests/utils/session-key.test.ts +0 -52
  591. package/tsconfig.json +0 -16
  592. package/vitest.config.ts +0 -61
  593. package/vitest.unit.config.ts +0 -12
@@ -1,858 +0,0 @@
1
- /**
2
- * Model Deployment Registry — Tests
3
- * ==================================
4
- *
5
- * Tests for worker profile → checkpoint binding, routing enable/disable,
6
- * and rollback operations.
7
- *
8
- * Prerequisites: Many tests set up a training run + checkpoint in the
9
- * training registry before exercising deployment registry operations.
10
- */
11
-
12
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
13
- import * as fs from 'fs';
14
- import * as path from 'path';
15
- import * as os from 'os';
16
- import {
17
- bindCheckpointToWorkerProfile,
18
- getDeployment,
19
- listDeployments,
20
- enableRoutingForProfile,
21
- disableRoutingForProfile,
22
- rollbackDeployment,
23
- isRoutingEnabledForProfile,
24
- getActiveCheckpointForProfile,
25
- getDeploymentLineage,
26
- getFullDeploymentRegistry,
27
- getDeploymentRegistryStats,
28
- assertSupportedProfile,
29
- SUPPORTED_PROFILES,
30
- type WorkerProfile,
31
- } from '../../src/core/model-deployment-registry.js';
32
- import {
33
- registerTrainingRun,
34
- startTrainingRun,
35
- completeTrainingRun,
36
- registerCheckpoint,
37
- attachEvalSummary,
38
- markCheckpointDeployable,
39
- } from '../../src/core/model-training-registry.js';
40
- import {
41
- advancePromotion,
42
- DEFAULT_BASELINE_METRICS,
43
- } from '../../src/core/promotion-gate.js';
44
-
45
- // ---------------------------------------------------------------------------
46
- // Test Fixtures
47
- // ---------------------------------------------------------------------------
48
-
49
- function makeTmpDir(): string {
50
- return fs.mkdtempSync(path.join(os.tmpdir(), 'pd-deployment-registry-test-'));
51
- }
52
-
53
- function rmdir(dir: string): void {
54
- try {
55
- if (fs.existsSync(dir)) {
56
- fs.rmSync(dir, { recursive: true, force: true });
57
- }
58
- } catch {
59
- // Ignore
60
- }
61
- }
62
-
63
- /**
64
- * Create a fully deployable reader-family checkpoint.
65
- * Family keyword "reader" → satisfies local-reader profile constraint.
66
- */
67
- function setupDeployableReaderCheckpoint(tmpDir: string): { runId: string; checkpointId: string } {
68
- const run = registerTrainingRun(tmpDir, {
69
- experimentId: 'mock-experiment-id',
70
- targetModelFamily: 'claude-reader-latest',
71
- datasetFingerprint: 'sha256-reader-001',
72
- exportId: 'export-reader',
73
- sampleCount: 30,
74
- configFingerprint: 'cfg-v1',
75
- });
76
- const ck = registerCheckpoint(tmpDir, {
77
- trainRunId: run.trainRunId,
78
- targetModelFamily: 'claude-reader-latest',
79
- artifactPath: '/checkpoints/reader-ck-001.safetensors',
80
- });
81
- attachEvalSummary(tmpDir, ck.checkpointId, {
82
- evalId: 'eval-reader-001',
83
- checkpointId: ck.checkpointId,
84
- targetModelFamily: 'claude-reader-latest',
85
- benchmarkId: 'bench-reader-001',
86
- mode: 'reduced_prompt',
87
- baselineScore: 0.5,
88
- candidateScore: 0.65,
89
- delta: 0.15,
90
- verdict: 'pass',
91
- });
92
- startTrainingRun(tmpDir, run.trainRunId);
93
- completeTrainingRun(tmpDir, run.trainRunId);
94
- markCheckpointDeployable(tmpDir, ck.checkpointId, true);
95
- // Advance through promotion gate (Phase 7: only local-reader is allowed)
96
- advancePromotion(tmpDir, {
97
- checkpointId: ck.checkpointId,
98
- targetProfile: 'local-reader',
99
- baselineMetrics: DEFAULT_BASELINE_METRICS,
100
- orchestratorReviewPassed: true,
101
- reviewNote: 'Test approval',
102
- });
103
- return { runId: run.trainRunId, checkpointId: ck.checkpointId };
104
- }
105
-
106
- /**
107
- * Create a fully deployable editor-family checkpoint.
108
- * Family keyword "editor" → satisfies local-editor profile constraint.
109
- */
110
- function setupDeployableEditorCheckpoint(tmpDir: string): { runId: string; checkpointId: string } {
111
- const run = registerTrainingRun(tmpDir, {
112
- experimentId: 'mock-experiment-id',
113
- targetModelFamily: 'gpt-editor-v4',
114
- datasetFingerprint: 'sha256-editor-001',
115
- exportId: 'export-editor',
116
- sampleCount: 30,
117
- configFingerprint: 'cfg-v1',
118
- });
119
- const ck = registerCheckpoint(tmpDir, {
120
- trainRunId: run.trainRunId,
121
- targetModelFamily: 'gpt-editor-v4',
122
- artifactPath: '/checkpoints/editor-ck-001.safetensors',
123
- });
124
- attachEvalSummary(tmpDir, ck.checkpointId, {
125
- evalId: 'eval-editor-001',
126
- checkpointId: ck.checkpointId,
127
- targetModelFamily: 'gpt-editor-v4',
128
- benchmarkId: 'bench-editor-001',
129
- mode: 'reduced_prompt',
130
- baselineScore: 0.5,
131
- candidateScore: 0.7,
132
- delta: 0.2,
133
- verdict: 'pass',
134
- });
135
- startTrainingRun(tmpDir, run.trainRunId);
136
- completeTrainingRun(tmpDir, run.trainRunId);
137
- markCheckpointDeployable(tmpDir, ck.checkpointId, true);
138
- // Advance through promotion gate
139
- advancePromotion(tmpDir, {
140
- checkpointId: ck.checkpointId,
141
- targetProfile: 'local-editor',
142
- baselineMetrics: DEFAULT_BASELINE_METRICS,
143
- orchestratorReviewPassed: true,
144
- reviewNote: 'Test approval',
145
- });
146
- return { runId: run.trainRunId, checkpointId: ck.checkpointId };
147
- }
148
-
149
- /**
150
- * Create a non-deployable checkpoint (no eval attached).
151
- */
152
- function setupNonDeployableCheckpoint(tmpDir: string): { runId: string; checkpointId: string } {
153
- const run = registerTrainingRun(tmpDir, {
154
- experimentId: 'mock-experiment-id',
155
- targetModelFamily: 'claude-reader-latest',
156
- datasetFingerprint: 'sha256-abc',
157
- exportId: 'export-abc',
158
- sampleCount: 10,
159
- configFingerprint: 'cfg-v1',
160
- });
161
- const ck = registerCheckpoint(tmpDir, {
162
- trainRunId: run.trainRunId,
163
- targetModelFamily: 'claude-reader-latest',
164
- artifactPath: '/checkpoints/nondeployable.safetensors',
165
- });
166
- return { runId: run.trainRunId, checkpointId: ck.checkpointId };
167
- }
168
-
169
- // ---------------------------------------------------------------------------
170
- // Tests: assertSupportedProfile
171
- // ---------------------------------------------------------------------------
172
-
173
- describe('ModelDeploymentRegistry assertSupportedProfile', () => {
174
- it('accepts local-reader', () => {
175
- expect(() => assertSupportedProfile('local-reader')).not.toThrow();
176
- });
177
-
178
- it('accepts local-editor', () => {
179
- expect(() => assertSupportedProfile('local-editor')).not.toThrow();
180
- });
181
-
182
- it('rejects unknown profile', () => {
183
- expect(() => assertSupportedProfile('local-architect')).toThrow('Unsupported worker profile');
184
- });
185
-
186
- it('rejects arbitrary strings', () => {
187
- expect(() => assertSupportedProfile('gpt-5')).toThrow('Unsupported worker profile');
188
- });
189
- });
190
-
191
- // ---------------------------------------------------------------------------
192
- // Tests: bindCheckpointToWorkerProfile
193
- // ---------------------------------------------------------------------------
194
-
195
- describe('ModelDeploymentRegistry bindCheckpointToWorkerProfile', () => {
196
- let tmpDir: string;
197
-
198
- beforeEach(() => {
199
- tmpDir = makeTmpDir();
200
- });
201
-
202
- afterEach(() => {
203
- rmdir(tmpDir);
204
- });
205
-
206
- it('binds a deployable reader checkpoint to local-reader', () => {
207
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
208
-
209
- const deployment = bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
210
-
211
- expect(deployment.workerProfile).toBe('local-reader');
212
- expect(deployment.activeCheckpointId).toBe(checkpointId);
213
- expect(deployment.previousCheckpointId).toBeNull();
214
- expect(deployment.routingEnabled).toBe(false);
215
- expect(deployment.targetModelFamily).toBe('claude-reader-latest');
216
- expect(deployment.deploymentId).toBeDefined();
217
- expect(deployment.deployedAt).toBeDefined();
218
- expect(deployment.updatedAt).toBeDefined();
219
- });
220
-
221
- it('binds a deployable editor checkpoint to local-editor', () => {
222
- const { checkpointId } = setupDeployableEditorCheckpoint(tmpDir);
223
-
224
- const deployment = bindCheckpointToWorkerProfile(tmpDir, 'local-editor', checkpointId);
225
-
226
- expect(deployment.workerProfile).toBe('local-editor');
227
- expect(deployment.activeCheckpointId).toBe(checkpointId);
228
- expect(deployment.routingEnabled).toBe(false);
229
- expect(deployment.targetModelFamily).toBe('gpt-editor-v4');
230
- });
231
-
232
- it('persists the deployment to disk', () => {
233
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
234
-
235
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
236
-
237
- const retrieved = getDeployment(tmpDir, 'local-reader');
238
- expect(retrieved).not.toBeNull();
239
- expect(retrieved!.activeCheckpointId).toBe(checkpointId);
240
- });
241
-
242
- it('rejects binding to a non-deployable checkpoint', () => {
243
- const { checkpointId } = setupNonDeployableCheckpoint(tmpDir);
244
-
245
- expect(() =>
246
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId)
247
- ).toThrow('not deployable');
248
- });
249
-
250
- it('rejects binding to a nonexistent checkpoint', () => {
251
- expect(() =>
252
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', 'nonexistent-ck-id')
253
- ).toThrow('not found');
254
- });
255
-
256
- it('rejects local-reader binding to an editor-family checkpoint', () => {
257
- const { checkpointId } = setupDeployableEditorCheckpoint(tmpDir); // gpt-editor-v4
258
-
259
- expect(() =>
260
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId)
261
- ).toThrow('Family constraint violated');
262
- });
263
-
264
- it('rejects local-editor binding to a reader-family checkpoint', () => {
265
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir); // claude-reader-latest
266
-
267
- expect(() =>
268
- bindCheckpointToWorkerProfile(tmpDir, 'local-editor', checkpointId)
269
- ).toThrow('Family constraint violated');
270
- });
271
-
272
- it('rejects unsupported profile', () => {
273
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
274
-
275
- expect(() =>
276
- // @ts-expect-error — intentionally passing invalid profile
277
- bindCheckpointToWorkerProfile(tmpDir, 'local-architect', checkpointId)
278
- ).toThrow('Unsupported worker profile');
279
- });
280
-
281
- it('updating binding to a new checkpoint preserves previousCheckpointId', () => {
282
- const { checkpointId: ck1 } = setupDeployableReaderCheckpoint(tmpDir);
283
-
284
- // Set up a second reader checkpoint
285
- const run2 = registerTrainingRun(tmpDir, {
286
- experimentId: 'mock-experiment-id',
287
- targetModelFamily: 'claude-reader-latest',
288
- datasetFingerprint: 'sha256-reader-002',
289
- exportId: 'export-reader-2',
290
- sampleCount: 30,
291
- configFingerprint: 'cfg-v1',
292
- });
293
- const ck2 = registerCheckpoint(tmpDir, {
294
- trainRunId: run2.trainRunId,
295
- targetModelFamily: 'claude-reader-latest',
296
- artifactPath: '/checkpoints/reader-ck-002.safetensors',
297
- });
298
- attachEvalSummary(tmpDir, ck2.checkpointId, {
299
- evalId: 'eval-reader-002',
300
- checkpointId: ck2.checkpointId,
301
- targetModelFamily: 'claude-reader-latest',
302
- benchmarkId: 'bench-reader-002',
303
- mode: 'reduced_prompt',
304
- baselineScore: 0.5,
305
- candidateScore: 0.7,
306
- delta: 0.2,
307
- verdict: 'pass',
308
- });
309
- startTrainingRun(tmpDir, run2.trainRunId);
310
- completeTrainingRun(tmpDir, run2.trainRunId);
311
- markCheckpointDeployable(tmpDir, ck2.checkpointId, true);
312
- advancePromotion(tmpDir, {
313
- checkpointId: ck2.checkpointId,
314
- targetProfile: 'local-reader',
315
- baselineMetrics: DEFAULT_BASELINE_METRICS,
316
- orchestratorReviewPassed: true,
317
- reviewNote: 'Test approval',
318
- });
319
-
320
- // First bind
321
- const d1 = bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck1);
322
- expect(d1.activeCheckpointId).toBe(ck1);
323
- expect(d1.previousCheckpointId).toBeNull();
324
-
325
- // Update bind to new checkpoint
326
- const d2 = bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck2.checkpointId);
327
- expect(d2.activeCheckpointId).toBe(ck2.checkpointId);
328
- expect(d2.previousCheckpointId).toBe(ck1);
329
- expect(d2.routingEnabled).toBe(false); // Reset to false on re-bind
330
- expect(d2.deploymentId).toBe(d1.deploymentId); // Same deployment record
331
- });
332
-
333
- it('accepts a note on bind', () => {
334
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
335
-
336
- const deployment = bindCheckpointToWorkerProfile(
337
- tmpDir,
338
- 'local-reader',
339
- checkpointId,
340
- 'Initial production deployment'
341
- );
342
-
343
- expect(deployment.note).toBe('Initial production deployment');
344
- });
345
- });
346
-
347
- // ---------------------------------------------------------------------------
348
- // Tests: getDeployment / listDeployments
349
- // ---------------------------------------------------------------------------
350
-
351
- describe('ModelDeploymentRegistry getDeployment / listDeployments', () => {
352
- let tmpDir: string;
353
-
354
- beforeEach(() => {
355
- tmpDir = makeTmpDir();
356
- });
357
-
358
- afterEach(() => {
359
- rmdir(tmpDir);
360
- });
361
-
362
- it('returns null for a profile with no deployment', () => {
363
- const deployment = getDeployment(tmpDir, 'local-reader');
364
- expect(deployment).toBeNull();
365
- });
366
-
367
- it('getDeployment returns the bound deployment', () => {
368
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
369
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
370
-
371
- const deployment = getDeployment(tmpDir, 'local-reader');
372
- expect(deployment).not.toBeNull();
373
- expect(deployment!.workerProfile).toBe('local-reader');
374
- });
375
-
376
- it('listDeployments returns all deployments sorted by updatedAt desc', () => {
377
- const { checkpointId: ckReader } = setupDeployableReaderCheckpoint(tmpDir);
378
- const { checkpointId: ckEditor } = setupDeployableEditorCheckpoint(tmpDir);
379
-
380
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ckReader);
381
- bindCheckpointToWorkerProfile(tmpDir, 'local-editor', ckEditor);
382
-
383
- const deployments = listDeployments(tmpDir);
384
- expect(deployments).toHaveLength(2);
385
- // Verify sort order is descending by updatedAt (most recent first)
386
- const [first, second] = deployments;
387
- const firstUpdated = new Date(first.updatedAt).getTime();
388
- const secondUpdated = new Date(second.updatedAt).getTime();
389
- expect(firstUpdated).toBeGreaterThanOrEqual(secondUpdated);
390
- // Also verify both expected profiles are present (order-independent)
391
- const profiles = deployments.map(d => d.workerProfile);
392
- expect(profiles).toContain('local-reader');
393
- expect(profiles).toContain('local-editor');
394
- });
395
-
396
- it('listDeployments filters by workerProfile', () => {
397
- const { checkpointId: ckReader } = setupDeployableReaderCheckpoint(tmpDir);
398
- const { checkpointId: ckEditor } = setupDeployableEditorCheckpoint(tmpDir);
399
-
400
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ckReader);
401
- bindCheckpointToWorkerProfile(tmpDir, 'local-editor', ckEditor);
402
-
403
- const readerDeployments = listDeployments(tmpDir, { workerProfile: 'local-reader' });
404
- expect(readerDeployments).toHaveLength(1);
405
- expect(readerDeployments[0].workerProfile).toBe('local-reader');
406
- });
407
-
408
- it('listDeployments filters by routingEnabled', () => {
409
- const { checkpointId: ckReader } = setupDeployableReaderCheckpoint(tmpDir);
410
- const { checkpointId: ckEditor } = setupDeployableEditorCheckpoint(tmpDir);
411
-
412
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ckReader);
413
- bindCheckpointToWorkerProfile(tmpDir, 'local-editor', ckEditor);
414
-
415
- enableRoutingForProfile(tmpDir, 'local-editor');
416
-
417
- const enabled = listDeployments(tmpDir, { routingEnabled: true });
418
- const disabled = listDeployments(tmpDir, { routingEnabled: false });
419
-
420
- expect(enabled).toHaveLength(1);
421
- expect(enabled[0].workerProfile).toBe('local-editor');
422
- expect(disabled).toHaveLength(1);
423
- expect(disabled[0].workerProfile).toBe('local-reader');
424
- });
425
- });
426
-
427
- // ---------------------------------------------------------------------------
428
- // Tests: enableRoutingForProfile / disableRoutingForProfile
429
- // ---------------------------------------------------------------------------
430
-
431
- describe('ModelDeploymentRegistry routing enable/disable', () => {
432
- let tmpDir: string;
433
-
434
- beforeEach(() => {
435
- tmpDir = makeTmpDir();
436
- });
437
-
438
- afterEach(() => {
439
- rmdir(tmpDir);
440
- });
441
-
442
- it('routingEnabled starts false after bind', () => {
443
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
444
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
445
-
446
- const deployment = getDeployment(tmpDir, 'local-reader');
447
- expect(deployment!.routingEnabled).toBe(false);
448
- });
449
-
450
- it('enableRoutingForProfile sets routingEnabled to true', () => {
451
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
452
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
453
-
454
- const deployment = enableRoutingForProfile(tmpDir, 'local-reader');
455
-
456
- expect(deployment.routingEnabled).toBe(true);
457
- expect(isRoutingEnabledForProfile(tmpDir, 'local-reader')).toBe(true);
458
- });
459
-
460
- it('disableRoutingForProfile sets routingEnabled to false', () => {
461
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
462
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
463
- enableRoutingForProfile(tmpDir, 'local-reader');
464
-
465
- const deployment = disableRoutingForProfile(tmpDir, 'local-reader');
466
-
467
- expect(deployment.routingEnabled).toBe(false);
468
- expect(isRoutingEnabledForProfile(tmpDir, 'local-reader')).toBe(false);
469
- });
470
-
471
- it('enableRoutingForProfile fails if no deployment exists', () => {
472
- expect(() => enableRoutingForProfile(tmpDir, 'local-reader')).toThrow(
473
- 'no deployment found'
474
- );
475
- });
476
-
477
- it('enableRoutingForProfile fails if active checkpoint was rolled back to null', () => {
478
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
479
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
480
- // Manually set activeCheckpointId to null via direct registry manipulation
481
- // to simulate a profile bound to a checkpoint that was subsequently revoked
482
- // (an out-of-scope Phase 5 operation would normally do this).
483
- // This tests the guard in enableRoutingForProfile that checks activeCheckpointId.
484
- const registryPath = path.join(tmpDir, '.state', 'nocturnal', 'deployment-registry.json');
485
- const registry = JSON.parse(fs.readFileSync(registryPath, 'utf-8'));
486
- registry.deployments[0].activeCheckpointId = null;
487
- fs.writeFileSync(registryPath, JSON.stringify(registry, null, 2));
488
- expect(() => enableRoutingForProfile(tmpDir, 'local-reader')).toThrow(
489
- 'no active checkpoint'
490
- );
491
- });
492
-
493
- it('isRoutingEnabledForProfile returns false for unknown profile', () => {
494
- expect(isRoutingEnabledForProfile(tmpDir, 'local-reader')).toBe(false);
495
- });
496
-
497
- it('isRoutingEnabledForProfile returns false when active checkpoint is revoked', () => {
498
- // Set up a bound and enabled deployment
499
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
500
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
501
- enableRoutingForProfile(tmpDir, 'local-reader');
502
-
503
- // Confirm routing is enabled
504
- expect(isRoutingEnabledForProfile(tmpDir, 'local-reader')).toBe(true);
505
-
506
- // Revoke the checkpoint (simulates re-evaluation failure or deprecation)
507
- markCheckpointDeployable(tmpDir, checkpointId, false);
508
-
509
- // GOVERNANCE: isRoutingEnabledForProfile must return false after revocation
510
- // even though the routingEnabled toggle is still true in the deployment registry
511
- expect(isRoutingEnabledForProfile(tmpDir, 'local-reader')).toBe(false);
512
- });
513
-
514
- it('getActiveCheckpointForProfile returns checkpoint ID when bound', () => {
515
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
516
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
517
-
518
- expect(getActiveCheckpointForProfile(tmpDir, 'local-reader')).toBe(checkpointId);
519
- });
520
-
521
- it('getActiveCheckpointForProfile returns null when no deployment', () => {
522
- expect(getActiveCheckpointForProfile(tmpDir, 'local-reader')).toBeNull();
523
- });
524
-
525
- it('enable/disable does not change activeCheckpointId', () => {
526
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
527
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
528
- enableRoutingForProfile(tmpDir, 'local-reader');
529
- disableRoutingForProfile(tmpDir, 'local-reader');
530
-
531
- expect(getActiveCheckpointForProfile(tmpDir, 'local-reader')).toBe(checkpointId);
532
- });
533
- });
534
-
535
- // ---------------------------------------------------------------------------
536
- // Tests: rollbackDeployment
537
- // ---------------------------------------------------------------------------
538
-
539
- describe('ModelDeploymentRegistry rollbackDeployment', () => {
540
- let tmpDir: string;
541
-
542
- beforeEach(() => {
543
- tmpDir = makeTmpDir();
544
- });
545
-
546
- afterEach(() => {
547
- rmdir(tmpDir);
548
- });
549
-
550
- it('rollback fails when there is no previous checkpoint', () => {
551
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
552
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
553
-
554
- expect(() => rollbackDeployment(tmpDir, 'local-reader')).toThrow(
555
- 'no previous checkpoint available'
556
- );
557
- });
558
-
559
- it('rollback fails when no deployment exists', () => {
560
- expect(() => rollbackDeployment(tmpDir, 'local-reader')).toThrow(
561
- 'no deployment found'
562
- );
563
- });
564
-
565
- it('rollback to previous checkpoint succeeds and disables routing', () => {
566
- // Set up ck1
567
- const { checkpointId: ck1 } = setupDeployableReaderCheckpoint(tmpDir);
568
-
569
- // Set up ck2
570
- const run2 = registerTrainingRun(tmpDir, {
571
- experimentId: 'mock-experiment-id',
572
- targetModelFamily: 'claude-reader-latest',
573
- datasetFingerprint: 'sha256-reader-002',
574
- exportId: 'export-reader-2',
575
- sampleCount: 30,
576
- configFingerprint: 'cfg-v1',
577
- });
578
- const ck2 = registerCheckpoint(tmpDir, {
579
- trainRunId: run2.trainRunId,
580
- targetModelFamily: 'claude-reader-latest',
581
- artifactPath: '/checkpoints/reader-ck-002.safetensors',
582
- });
583
- attachEvalSummary(tmpDir, ck2.checkpointId, {
584
- evalId: 'eval-reader-002',
585
- checkpointId: ck2.checkpointId,
586
- targetModelFamily: 'claude-reader-latest',
587
- benchmarkId: 'bench-reader-002',
588
- mode: 'reduced_prompt',
589
- baselineScore: 0.5,
590
- candidateScore: 0.7,
591
- delta: 0.2,
592
- verdict: 'pass',
593
- });
594
- startTrainingRun(tmpDir, run2.trainRunId);
595
- completeTrainingRun(tmpDir, run2.trainRunId);
596
- markCheckpointDeployable(tmpDir, ck2.checkpointId, true);
597
- advancePromotion(tmpDir, {
598
- checkpointId: ck2.checkpointId,
599
- targetProfile: 'local-reader',
600
- baselineMetrics: DEFAULT_BASELINE_METRICS,
601
- orchestratorReviewPassed: true,
602
- reviewNote: 'Test approval',
603
- });
604
-
605
- // Bind ck1, then update to ck2
606
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck1);
607
- enableRoutingForProfile(tmpDir, 'local-reader');
608
- // Note: re-binding resets routingEnabled to false — must re-enable
609
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck2.checkpointId, 'promoted ck2');
610
- enableRoutingForProfile(tmpDir, 'local-reader');
611
-
612
- // Verify ck2 is active and routing is enabled
613
- expect(getActiveCheckpointForProfile(tmpDir, 'local-reader')).toBe(ck2.checkpointId);
614
- expect(isRoutingEnabledForProfile(tmpDir, 'local-reader')).toBe(true);
615
-
616
- // Roll back
617
- const rolledBack = rollbackDeployment(tmpDir, 'local-reader', 'rolled back to ck1');
618
-
619
- expect(rolledBack.activeCheckpointId).toBe(ck1);
620
- expect(rolledBack.previousCheckpointId).toBe(ck2.checkpointId); // ck2 becomes previous
621
- expect(rolledBack.routingEnabled).toBe(false); // Always reset
622
- expect(rolledBack.note).toBe('rolled back to ck1');
623
- });
624
-
625
- it('rollback fails when previous checkpoint no longer exists', () => {
626
- const { checkpointId: ck1 } = setupDeployableReaderCheckpoint(tmpDir);
627
- const run2 = registerTrainingRun(tmpDir, {
628
- experimentId: 'mock-experiment-id',
629
- targetModelFamily: 'claude-reader-latest',
630
- datasetFingerprint: 'sha256-reader-002',
631
- exportId: 'export-reader-2',
632
- sampleCount: 30,
633
- configFingerprint: 'cfg-v1',
634
- });
635
- const ck2 = registerCheckpoint(tmpDir, {
636
- trainRunId: run2.trainRunId,
637
- targetModelFamily: 'claude-reader-latest',
638
- artifactPath: '/checkpoints/reader-ck-002.safetensors',
639
- });
640
- attachEvalSummary(tmpDir, ck2.checkpointId, {
641
- evalId: 'eval-reader-002',
642
- checkpointId: ck2.checkpointId,
643
- targetModelFamily: 'claude-reader-latest',
644
- benchmarkId: 'bench-reader-002',
645
- mode: 'reduced_prompt',
646
- baselineScore: 0.5,
647
- candidateScore: 0.7,
648
- delta: 0.2,
649
- verdict: 'pass',
650
- });
651
- startTrainingRun(tmpDir, run2.trainRunId);
652
- completeTrainingRun(tmpDir, run2.trainRunId);
653
- markCheckpointDeployable(tmpDir, ck2.checkpointId, true);
654
- advancePromotion(tmpDir, {
655
- checkpointId: ck2.checkpointId,
656
- targetProfile: 'local-reader',
657
- baselineMetrics: DEFAULT_BASELINE_METRICS,
658
- orchestratorReviewPassed: true,
659
- reviewNote: 'Test approval',
660
- });
661
-
662
- // Bind ck1, then ck2 on top — previousCheckpointId = ck1
663
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck1);
664
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck2.checkpointId);
665
-
666
- // Simulate ck1 being deleted from the training registry (outside Phase 5 scope)
667
- // by directly editing the training-registry.json
668
- const trainingRegistryPath = path.join(tmpDir, '.state', 'nocturnal', 'training-registry.json');
669
- const trainingRegistry = JSON.parse(fs.readFileSync(trainingRegistryPath, 'utf-8'));
670
- trainingRegistry.checkpoints = trainingRegistry.checkpoints.filter(
671
- (ck: { checkpointId: string }) => ck.checkpointId !== ck1
672
- );
673
- fs.writeFileSync(trainingRegistryPath, JSON.stringify(trainingRegistry, null, 2));
674
-
675
- // Now rollbackDeployment must fail because ck1 no longer exists
676
- expect(() => rollbackDeployment(tmpDir, 'local-reader')).toThrow(
677
- `no longer exists in the training registry`
678
- );
679
- });
680
-
681
- it('can roll back twice (ck1 → ck2 → ck1)', () => {
682
- const { checkpointId: ck1 } = setupDeployableReaderCheckpoint(tmpDir);
683
-
684
- const run2 = registerTrainingRun(tmpDir, {
685
- experimentId: 'mock-experiment-id',
686
- targetModelFamily: 'claude-reader-latest',
687
- datasetFingerprint: 'sha256-reader-002',
688
- exportId: 'export-reader-2',
689
- sampleCount: 30,
690
- configFingerprint: 'cfg-v1',
691
- });
692
- const ck2 = registerCheckpoint(tmpDir, {
693
- trainRunId: run2.trainRunId,
694
- targetModelFamily: 'claude-reader-latest',
695
- artifactPath: '/checkpoints/reader-ck-002.safetensors',
696
- });
697
- attachEvalSummary(tmpDir, ck2.checkpointId, {
698
- evalId: 'eval-reader-002',
699
- checkpointId: ck2.checkpointId,
700
- targetModelFamily: 'claude-reader-latest',
701
- benchmarkId: 'bench-reader-002',
702
- mode: 'reduced_prompt',
703
- baselineScore: 0.5,
704
- candidateScore: 0.7,
705
- delta: 0.2,
706
- verdict: 'pass',
707
- });
708
- startTrainingRun(tmpDir, run2.trainRunId);
709
- completeTrainingRun(tmpDir, run2.trainRunId);
710
- markCheckpointDeployable(tmpDir, ck2.checkpointId, true);
711
- advancePromotion(tmpDir, {
712
- checkpointId: ck2.checkpointId,
713
- targetProfile: 'local-reader',
714
- baselineMetrics: DEFAULT_BASELINE_METRICS,
715
- orchestratorReviewPassed: true,
716
- reviewNote: 'Test approval',
717
- });
718
-
719
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck1);
720
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ck2.checkpointId); // ck1 is now previous
721
- const r1 = rollbackDeployment(tmpDir, 'local-reader'); // back to ck1, ck2 is now previous
722
- expect(r1.activeCheckpointId).toBe(ck1);
723
-
724
- // Enable routing, then roll back again to ck2
725
- enableRoutingForProfile(tmpDir, 'local-reader');
726
- const r2 = rollbackDeployment(tmpDir, 'local-reader'); // back to ck2
727
- expect(r2.activeCheckpointId).toBe(ck2.checkpointId);
728
- expect(r2.previousCheckpointId).toBe(ck1); // ck1 is still tracked
729
- expect(r2.routingEnabled).toBe(false);
730
- });
731
- });
732
-
733
- // ---------------------------------------------------------------------------
734
- // Tests: Lineage Queries
735
- // ---------------------------------------------------------------------------
736
-
737
- describe('ModelDeploymentRegistry lineage queries', () => {
738
- let tmpDir: string;
739
-
740
- beforeEach(() => {
741
- tmpDir = makeTmpDir();
742
- });
743
-
744
- afterEach(() => {
745
- rmdir(tmpDir);
746
- });
747
-
748
- it('getDeploymentLineage returns deployment and active checkpoint', () => {
749
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
750
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId, 'reader v1');
751
-
752
- const lineage = getDeploymentLineage(tmpDir, 'local-reader');
753
-
754
- expect(lineage).not.toBeNull();
755
- expect(lineage!.deployment.workerProfile).toBe('local-reader');
756
- expect(lineage!.deployment.note).toBe('reader v1');
757
- expect(lineage!.activeCheckpoint).not.toBeNull();
758
- expect(lineage!.activeCheckpoint!.checkpointId).toBe(checkpointId);
759
- });
760
-
761
- it('getDeploymentLineage returns null for unknown profile', () => {
762
- const lineage = getDeploymentLineage(tmpDir, 'local-reader');
763
- expect(lineage).toBeNull();
764
- });
765
-
766
- it('rollback exhausts history when only one checkpoint exists (no previous to roll back to)', () => {
767
- // Bind a single checkpoint — there is no previous to roll back to
768
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
769
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
770
-
771
- // Attempting to roll back should fail because previousCheckpointId is null
772
- expect(() => rollbackDeployment(tmpDir, 'local-reader')).toThrow(
773
- 'no previous checkpoint available'
774
- );
775
-
776
- // The active checkpoint is still set (rollback didn't happen)
777
- expect(getActiveCheckpointForProfile(tmpDir, 'local-reader')).toBe(checkpointId);
778
- });
779
- });
780
-
781
- // ---------------------------------------------------------------------------
782
- // Tests: Stats
783
- // ---------------------------------------------------------------------------
784
-
785
- describe('ModelDeploymentRegistry stats', () => {
786
- let tmpDir: string;
787
-
788
- beforeEach(() => {
789
- tmpDir = makeTmpDir();
790
- });
791
-
792
- afterEach(() => {
793
- rmdir(tmpDir);
794
- });
795
-
796
- it('returns zeros for empty registry', () => {
797
- const stats = getDeploymentRegistryStats(tmpDir);
798
- expect(stats.totalDeployments).toBe(0);
799
- expect(stats.activeDeployments).toBe(0);
800
- expect(stats.profilesWithBindings).toBe(0);
801
- expect(stats.profilesWithRoutingEnabled).toBe(0);
802
- });
803
-
804
- it('counts profiles with bindings and routing enabled', () => {
805
- const { checkpointId: ckReader } = setupDeployableReaderCheckpoint(tmpDir);
806
- const { checkpointId: ckEditor } = setupDeployableEditorCheckpoint(tmpDir);
807
-
808
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ckReader);
809
- bindCheckpointToWorkerProfile(tmpDir, 'local-editor', ckEditor);
810
- enableRoutingForProfile(tmpDir, 'local-editor');
811
-
812
- const stats = getDeploymentRegistryStats(tmpDir);
813
- expect(stats.totalDeployments).toBe(2);
814
- expect(stats.profilesWithBindings).toBe(2);
815
- expect(stats.activeDeployments).toBe(1);
816
- expect(stats.profilesWithRoutingEnabled).toBe(1);
817
- });
818
- });
819
-
820
- // ---------------------------------------------------------------------------
821
- // Tests: Registry Persistence
822
- // ---------------------------------------------------------------------------
823
-
824
- describe('ModelDeploymentRegistry persistence', () => {
825
- let tmpDir: string;
826
-
827
- beforeEach(() => {
828
- tmpDir = makeTmpDir();
829
- });
830
-
831
- afterEach(() => {
832
- rmdir(tmpDir);
833
- });
834
-
835
- it('getFullDeploymentRegistry returns all deployment records', () => {
836
- const { checkpointId: ckReader } = setupDeployableReaderCheckpoint(tmpDir);
837
- const { checkpointId: ckEditor } = setupDeployableEditorCheckpoint(tmpDir);
838
-
839
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', ckReader);
840
- bindCheckpointToWorkerProfile(tmpDir, 'local-editor', ckEditor);
841
-
842
- const registry = getFullDeploymentRegistry(tmpDir);
843
- expect(registry.deployments).toHaveLength(2);
844
- });
845
-
846
- it('registry persists to disk as JSON', () => {
847
- const { checkpointId } = setupDeployableReaderCheckpoint(tmpDir);
848
- bindCheckpointToWorkerProfile(tmpDir, 'local-reader', checkpointId);
849
-
850
- const registryPath = path.join(tmpDir, '.state', 'nocturnal', 'deployment-registry.json');
851
- expect(fs.existsSync(registryPath)).toBe(true);
852
-
853
- const raw = fs.readFileSync(registryPath, 'utf-8');
854
- const parsed = JSON.parse(raw);
855
- expect(parsed.deployments).toHaveLength(1);
856
- expect(parsed.deployments[0].workerProfile).toBe('local-reader');
857
- });
858
- });