kiokuko-dsh 0.2.39 → 0.2.41

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 (540) hide show
  1. package/PERMISSIONS.md +2 -2
  2. package/README.ja.md +17 -5
  3. package/README.ko.md +17 -5
  4. package/README.md +17 -5
  5. package/README.zh-CN.md +17 -5
  6. package/dist/akinator/skill-discovery-attempt.d.ts +3 -1
  7. package/dist/akinator/skill-discovery-attempt.d.ts.map +1 -1
  8. package/dist/akinator/skill-discovery-attempt.js +12 -11
  9. package/dist/akinator/skill-discovery-attempt.js.map +1 -1
  10. package/dist/client.cjs +7 -10
  11. package/dist/client.d.ts.map +1 -1
  12. package/dist/context/continuity-view.d.ts +0 -11
  13. package/dist/context/continuity-view.d.ts.map +1 -1
  14. package/dist/context/continuity-view.js +5 -9
  15. package/dist/context/continuity-view.js.map +1 -1
  16. package/dist/deep-thinker/controller.d.ts +4 -1
  17. package/dist/deep-thinker/controller.d.ts.map +1 -1
  18. package/dist/deep-thinker/controller.js +10 -0
  19. package/dist/deep-thinker/controller.js.map +1 -1
  20. package/dist/deep-thinker/core/contracts.d.ts +11 -11
  21. package/dist/deep-thinker/memory-finalizer.d.ts +1 -1
  22. package/dist/deep-thinker/native-executor.d.ts +1 -1
  23. package/dist/deep-thinker/native-executor.d.ts.map +1 -1
  24. package/dist/deep-thinker/prompts.js +1 -1
  25. package/dist/deep-thinker/prompts.js.map +1 -1
  26. package/dist/deep-thinker/quality-prompts.js +1 -1
  27. package/dist/deep-thinker/quality-prompts.js.map +1 -1
  28. package/dist/deep-thinker/report.d.ts +1 -1
  29. package/dist/deep-thinker/store.d.ts +1 -1
  30. package/dist/dsh/agenticreplay-hooks.d.ts.map +1 -1
  31. package/dist/dsh/agenticreplay-hooks.js +13 -0
  32. package/dist/dsh/agenticreplay-hooks.js.map +1 -1
  33. package/dist/dsh/agenticreplay-recorder.d.ts +5 -0
  34. package/dist/dsh/agenticreplay-recorder.d.ts.map +1 -1
  35. package/dist/dsh/agenticreplay-recorder.js +19 -0
  36. package/dist/dsh/agenticreplay-recorder.js.map +1 -1
  37. package/dist/dsh/coding-workflow/contracts.d.ts +2 -5
  38. package/dist/dsh/coding-workflow/contracts.d.ts.map +1 -1
  39. package/dist/dsh/coding-workflow/contracts.js +1 -1
  40. package/dist/dsh/coding-workflow/contracts.js.map +1 -1
  41. package/dist/dsh/coding-workflow/host.d.ts.map +1 -1
  42. package/dist/dsh/coding-workflow/host.js +1 -4
  43. package/dist/dsh/coding-workflow/host.js.map +1 -1
  44. package/dist/dsh/coding-workflow/intent.d.ts.map +1 -1
  45. package/dist/dsh/coding-workflow/intent.js +0 -6
  46. package/dist/dsh/coding-workflow/intent.js.map +1 -1
  47. package/dist/dsh/coding-workflow/service.d.ts +4 -8
  48. package/dist/dsh/coding-workflow/service.d.ts.map +1 -1
  49. package/dist/dsh/coding-workflow/service.js +5 -57
  50. package/dist/dsh/coding-workflow/service.js.map +1 -1
  51. package/dist/dsh/completion-report.d.ts +0 -31
  52. package/dist/dsh/completion-report.d.ts.map +1 -1
  53. package/dist/dsh/completion-report.js +16 -94
  54. package/dist/dsh/completion-report.js.map +1 -1
  55. package/dist/dsh/composition.d.ts +1 -3
  56. package/dist/dsh/composition.d.ts.map +1 -1
  57. package/dist/dsh/composition.js +13 -34
  58. package/dist/dsh/composition.js.map +1 -1
  59. package/dist/dsh/config.d.ts +1 -22
  60. package/dist/dsh/config.d.ts.map +1 -1
  61. package/dist/dsh/config.js +0 -8
  62. package/dist/dsh/config.js.map +1 -1
  63. package/dist/dsh/context-injection.d.ts +1 -11
  64. package/dist/dsh/context-injection.d.ts.map +1 -1
  65. package/dist/dsh/context-injection.js +3 -24
  66. package/dist/dsh/context-injection.js.map +1 -1
  67. package/dist/dsh/continuity-adapter.d.ts +0 -5
  68. package/dist/dsh/continuity-adapter.d.ts.map +1 -1
  69. package/dist/dsh/continuity-adapter.js +1 -39
  70. package/dist/dsh/continuity-adapter.js.map +1 -1
  71. package/dist/dsh/decisions/contracts.d.ts +0 -1
  72. package/dist/dsh/decisions/contracts.d.ts.map +1 -1
  73. package/dist/dsh/decisions/contracts.js +1 -1
  74. package/dist/dsh/decisions/contracts.js.map +1 -1
  75. package/dist/dsh/decisions/diagnostics.d.ts +8 -11
  76. package/dist/dsh/decisions/diagnostics.d.ts.map +1 -1
  77. package/dist/dsh/decisions/diagnostics.js +1 -9
  78. package/dist/dsh/decisions/diagnostics.js.map +1 -1
  79. package/dist/dsh/decisions/intent-assessment.d.ts +2 -5
  80. package/dist/dsh/decisions/intent-assessment.d.ts.map +1 -1
  81. package/dist/dsh/decisions/intent-assessment.js +17 -9
  82. package/dist/dsh/decisions/intent-assessment.js.map +1 -1
  83. package/dist/dsh/efficiency.d.ts +0 -3
  84. package/dist/dsh/efficiency.d.ts.map +1 -1
  85. package/dist/dsh/efficiency.js +1 -9
  86. package/dist/dsh/efficiency.js.map +1 -1
  87. package/dist/dsh/execution-selection.d.ts +6 -7
  88. package/dist/dsh/execution-selection.d.ts.map +1 -1
  89. package/dist/dsh/execution-selection.js +10 -15
  90. package/dist/dsh/execution-selection.js.map +1 -1
  91. package/dist/dsh/execution-support.d.ts +0 -4
  92. package/dist/dsh/execution-support.d.ts.map +1 -1
  93. package/dist/dsh/execution-support.js +3 -15
  94. package/dist/dsh/execution-support.js.map +1 -1
  95. package/dist/dsh/harness/factory.d.ts +109 -0
  96. package/dist/dsh/harness/factory.d.ts.map +1 -0
  97. package/dist/dsh/harness/factory.js +566 -0
  98. package/dist/dsh/harness/factory.js.map +1 -0
  99. package/dist/dsh/harness/inbox.d.ts +22 -0
  100. package/dist/dsh/harness/inbox.d.ts.map +1 -0
  101. package/dist/dsh/harness/inbox.js +61 -0
  102. package/dist/dsh/harness/inbox.js.map +1 -0
  103. package/dist/dsh/harness/index.d.ts +19 -0
  104. package/dist/dsh/harness/index.d.ts.map +1 -0
  105. package/dist/dsh/harness/index.js +26 -0
  106. package/dist/dsh/harness/index.js.map +1 -0
  107. package/dist/dsh/harness/lifecycle.d.ts +26 -0
  108. package/dist/dsh/harness/lifecycle.d.ts.map +1 -0
  109. package/dist/dsh/harness/lifecycle.js +21 -0
  110. package/dist/dsh/harness/lifecycle.js.map +1 -0
  111. package/dist/dsh/harness/projections.d.ts +16 -0
  112. package/dist/dsh/harness/projections.d.ts.map +1 -0
  113. package/dist/dsh/harness/projections.js +34 -0
  114. package/dist/dsh/harness/projections.js.map +1 -0
  115. package/dist/dsh/head-worker-configuration.d.ts +1 -2
  116. package/dist/dsh/head-worker-configuration.d.ts.map +1 -1
  117. package/dist/dsh/head-worker-configuration.js +0 -5
  118. package/dist/dsh/head-worker-configuration.js.map +1 -1
  119. package/dist/dsh/host-adapter/admission.d.ts +1 -8
  120. package/dist/dsh/host-adapter/admission.d.ts.map +1 -1
  121. package/dist/dsh/host-adapter/admission.js +51 -260
  122. package/dist/dsh/host-adapter/admission.js.map +1 -1
  123. package/dist/dsh/host-adapter/boundaries.d.ts +1 -28
  124. package/dist/dsh/host-adapter/boundaries.d.ts.map +1 -1
  125. package/dist/dsh/host-adapter/boundaries.js +27 -328
  126. package/dist/dsh/host-adapter/boundaries.js.map +1 -1
  127. package/dist/dsh/host-adapter/context.d.ts +1 -7
  128. package/dist/dsh/host-adapter/context.d.ts.map +1 -1
  129. package/dist/dsh/host-adapter/context.js +5 -28
  130. package/dist/dsh/host-adapter/context.js.map +1 -1
  131. package/dist/dsh/host-adapter/efficiency-host.d.ts +0 -2
  132. package/dist/dsh/host-adapter/efficiency-host.d.ts.map +1 -1
  133. package/dist/dsh/host-adapter/efficiency-host.js +2 -2
  134. package/dist/dsh/host-adapter/efficiency-host.js.map +1 -1
  135. package/dist/dsh/host-adapter/lifecycle.d.ts +0 -7
  136. package/dist/dsh/host-adapter/lifecycle.d.ts.map +1 -1
  137. package/dist/dsh/host-adapter/lifecycle.js +58 -71
  138. package/dist/dsh/host-adapter/lifecycle.js.map +1 -1
  139. package/dist/dsh/host-adapter/memory-application-host.d.ts +0 -2
  140. package/dist/dsh/host-adapter/memory-application-host.d.ts.map +1 -1
  141. package/dist/dsh/host-adapter/memory-application-host.js +2 -2
  142. package/dist/dsh/host-adapter/memory-application-host.js.map +1 -1
  143. package/dist/dsh/host-adapter/routing.d.ts +1 -5
  144. package/dist/dsh/host-adapter/routing.d.ts.map +1 -1
  145. package/dist/dsh/host-adapter/routing.js +21 -73
  146. package/dist/dsh/host-adapter/routing.js.map +1 -1
  147. package/dist/dsh/host-adapter/session-observation.d.ts +1 -8
  148. package/dist/dsh/host-adapter/session-observation.d.ts.map +1 -1
  149. package/dist/dsh/host-adapter/session-observation.js +2 -55
  150. package/dist/dsh/host-adapter/session-observation.js.map +1 -1
  151. package/dist/dsh/host-adapter/tool-host.d.ts +3 -41
  152. package/dist/dsh/host-adapter/tool-host.d.ts.map +1 -1
  153. package/dist/dsh/host-adapter/tool-host.js +14 -243
  154. package/dist/dsh/host-adapter/tool-host.js.map +1 -1
  155. package/dist/dsh/host-adapter/turn-state.d.ts +0 -4
  156. package/dist/dsh/host-adapter/turn-state.d.ts.map +1 -1
  157. package/dist/dsh/host-adapter/turn-state.js +16 -93
  158. package/dist/dsh/host-adapter/turn-state.js.map +1 -1
  159. package/dist/dsh/host-adapter.d.ts +0 -11
  160. package/dist/dsh/host-adapter.d.ts.map +1 -1
  161. package/dist/dsh/host-adapter.js +17 -179
  162. package/dist/dsh/host-adapter.js.map +1 -1
  163. package/dist/dsh/index.d.ts +3 -16
  164. package/dist/dsh/index.d.ts.map +1 -1
  165. package/dist/dsh/index.js +0 -6
  166. package/dist/dsh/index.js.map +1 -1
  167. package/dist/dsh/lifecycle-memory.d.ts +3 -0
  168. package/dist/dsh/lifecycle-memory.d.ts.map +1 -1
  169. package/dist/dsh/lifecycle-memory.js +67 -45
  170. package/dist/dsh/lifecycle-memory.js.map +1 -1
  171. package/dist/dsh/lisp/candidate.d.ts +2 -2
  172. package/dist/dsh/lisp/code-intelligence-contracts.d.ts +1 -1
  173. package/dist/dsh/lisp/compiled-cache.d.ts.map +1 -1
  174. package/dist/dsh/lisp/compiled-cache.js +27 -6
  175. package/dist/dsh/lisp/compiled-cache.js.map +1 -1
  176. package/dist/dsh/lisp/host-tool-dispatch.d.ts.map +1 -1
  177. package/dist/dsh/lisp/host-tool-dispatch.js +14 -5
  178. package/dist/dsh/lisp/host-tool-dispatch.js.map +1 -1
  179. package/dist/dsh/lisp/manager.d.ts +7 -4
  180. package/dist/dsh/lisp/manager.d.ts.map +1 -1
  181. package/dist/dsh/lisp/manager.js +132 -103
  182. package/dist/dsh/lisp/manager.js.map +1 -1
  183. package/dist/dsh/lisp/sandbox.d.ts.map +1 -1
  184. package/dist/dsh/lisp/sandbox.js +1 -5
  185. package/dist/dsh/lisp/sandbox.js.map +1 -1
  186. package/dist/dsh/lisp/supervision.d.ts +33 -0
  187. package/dist/dsh/lisp/supervision.d.ts.map +1 -0
  188. package/dist/dsh/lisp/supervision.js +89 -0
  189. package/dist/dsh/lisp/supervision.js.map +1 -0
  190. package/dist/dsh/lisp/surface.d.ts +2 -2
  191. package/dist/dsh/lisp/surface.d.ts.map +1 -1
  192. package/dist/dsh/lisp/surface.js +105 -11
  193. package/dist/dsh/lisp/surface.js.map +1 -1
  194. package/dist/dsh/lisp/worker.d.ts +2 -1
  195. package/dist/dsh/lisp/worker.d.ts.map +1 -1
  196. package/dist/dsh/lisp/worker.js +7 -1
  197. package/dist/dsh/lisp/worker.js.map +1 -1
  198. package/dist/dsh/loop-guard.d.ts +0 -8
  199. package/dist/dsh/loop-guard.d.ts.map +1 -1
  200. package/dist/dsh/loop-guard.js +0 -51
  201. package/dist/dsh/loop-guard.js.map +1 -1
  202. package/dist/dsh/memory-application.d.ts.map +1 -1
  203. package/dist/dsh/memory-application.js +0 -6
  204. package/dist/dsh/memory-application.js.map +1 -1
  205. package/dist/dsh/message-sources.d.ts +2 -12
  206. package/dist/dsh/message-sources.d.ts.map +1 -1
  207. package/dist/dsh/message-sources.js +20 -39
  208. package/dist/dsh/message-sources.js.map +1 -1
  209. package/dist/dsh/model-configuration.d.ts +6 -24
  210. package/dist/dsh/model-configuration.d.ts.map +1 -1
  211. package/dist/dsh/model-configuration.js +1 -78
  212. package/dist/dsh/model-configuration.js.map +1 -1
  213. package/dist/dsh/model-routing.d.ts +1 -3
  214. package/dist/dsh/model-routing.d.ts.map +1 -1
  215. package/dist/dsh/model-routing.js +0 -11
  216. package/dist/dsh/model-routing.js.map +1 -1
  217. package/dist/dsh/model-selection-ui.d.ts +1 -2
  218. package/dist/dsh/model-selection-ui.d.ts.map +1 -1
  219. package/dist/dsh/model-selection-ui.js +48 -309
  220. package/dist/dsh/model-selection-ui.js.map +1 -1
  221. package/dist/dsh/models/contracts.d.ts +2 -2
  222. package/dist/dsh/models/service.d.ts +1 -1
  223. package/dist/dsh/modules/legacy-bindings.d.ts +3 -1
  224. package/dist/dsh/modules/legacy-bindings.d.ts.map +1 -1
  225. package/dist/dsh/modules/legacy-bindings.js +5 -5
  226. package/dist/dsh/modules/legacy-bindings.js.map +1 -1
  227. package/dist/dsh/modules/lisp.js +1 -1
  228. package/dist/dsh/modules/lisp.js.map +1 -1
  229. package/dist/dsh/native-execution-ownership.d.ts.map +1 -1
  230. package/dist/dsh/native-execution-ownership.js +0 -2
  231. package/dist/dsh/native-execution-ownership.js.map +1 -1
  232. package/dist/dsh/native-worker-routing.d.ts.map +1 -1
  233. package/dist/dsh/native-worker-routing.js +7 -2
  234. package/dist/dsh/native-worker-routing.js.map +1 -1
  235. package/dist/dsh/on-demand-intake.d.ts.map +1 -1
  236. package/dist/dsh/on-demand-intake.js +17 -8
  237. package/dist/dsh/on-demand-intake.js.map +1 -1
  238. package/dist/dsh/orchestration/execution-owner.d.ts +3 -1
  239. package/dist/dsh/orchestration/execution-owner.d.ts.map +1 -1
  240. package/dist/dsh/orchestration/execution-owner.js.map +1 -1
  241. package/dist/dsh/owned-execution.js +1 -1
  242. package/dist/dsh/owned-execution.js.map +1 -1
  243. package/dist/dsh/replay-memory-extract.d.ts.map +1 -1
  244. package/dist/dsh/replay-memory-extract.js +15 -1
  245. package/dist/dsh/replay-memory-extract.js.map +1 -1
  246. package/dist/dsh/repository-learning.d.ts.map +1 -1
  247. package/dist/dsh/repository-learning.js +3 -0
  248. package/dist/dsh/repository-learning.js.map +1 -1
  249. package/dist/dsh/runtime.d.ts +10 -2
  250. package/dist/dsh/runtime.d.ts.map +1 -1
  251. package/dist/dsh/runtime.js +22 -43
  252. package/dist/dsh/runtime.js.map +1 -1
  253. package/dist/dsh/semantic-compaction/policy.js +1 -1
  254. package/dist/dsh/semantic-compaction/policy.js.map +1 -1
  255. package/dist/dsh/session-bridge.d.ts +1 -1
  256. package/dist/dsh/session-bridge.d.ts.map +1 -1
  257. package/dist/dsh/session-bridge.js +1 -1
  258. package/dist/dsh/session-bridge.js.map +1 -1
  259. package/dist/dsh/session-memory-finalizer.js +1 -1
  260. package/dist/dsh/session-memory-finalizer.js.map +1 -1
  261. package/dist/dsh/session-review-context.d.ts.map +1 -1
  262. package/dist/dsh/session-review-context.js +3 -16
  263. package/dist/dsh/session-review-context.js.map +1 -1
  264. package/dist/dsh/setup.d.ts +1 -1
  265. package/dist/dsh/setup.d.ts.map +1 -1
  266. package/dist/dsh/skill-compiler.js +1 -1
  267. package/dist/dsh/skill-compiler.js.map +1 -1
  268. package/dist/dsh/skill-prompt-contracts.d.ts +2 -2
  269. package/dist/dsh/skill-prompt-contracts.js +1 -1
  270. package/dist/dsh/skill-prompts.json +1 -1
  271. package/dist/dsh/standard-skills.d.ts +1 -8
  272. package/dist/dsh/standard-skills.d.ts.map +1 -1
  273. package/dist/dsh/standard-skills.js +1 -8
  274. package/dist/dsh/standard-skills.js.map +1 -1
  275. package/dist/dsh/task-authority-context.d.ts +3 -0
  276. package/dist/dsh/task-authority-context.d.ts.map +1 -1
  277. package/dist/dsh/task-authority-context.js +3 -0
  278. package/dist/dsh/task-authority-context.js.map +1 -1
  279. package/dist/dsh/task-completion-guidance.d.ts +1 -5
  280. package/dist/dsh/task-completion-guidance.d.ts.map +1 -1
  281. package/dist/dsh/task-completion-guidance.js +4 -6
  282. package/dist/dsh/task-completion-guidance.js.map +1 -1
  283. package/dist/dsh/task-completion-host.js +4 -4
  284. package/dist/dsh/task-completion-host.js.map +1 -1
  285. package/dist/dsh/task-completion.d.ts +1 -13
  286. package/dist/dsh/task-completion.d.ts.map +1 -1
  287. package/dist/dsh/task-completion.js +9 -104
  288. package/dist/dsh/task-completion.js.map +1 -1
  289. package/dist/dsh/task-intake.d.ts +2 -3
  290. package/dist/dsh/task-intake.d.ts.map +1 -1
  291. package/dist/dsh/task-intake.js +90 -86
  292. package/dist/dsh/task-intake.js.map +1 -1
  293. package/dist/dsh/task-state.d.ts.map +1 -1
  294. package/dist/dsh/task-state.js +0 -8
  295. package/dist/dsh/task-state.js.map +1 -1
  296. package/dist/dsh/tool-exposure.d.ts +1 -1
  297. package/dist/dsh/tool-exposure.d.ts.map +1 -1
  298. package/dist/dsh/tool-exposure.js +0 -2
  299. package/dist/dsh/tool-exposure.js.map +1 -1
  300. package/dist/dsh/tool-policy.d.ts +5 -8
  301. package/dist/dsh/tool-policy.d.ts.map +1 -1
  302. package/dist/dsh/tool-policy.js +3 -35
  303. package/dist/dsh/tool-policy.js.map +1 -1
  304. package/dist/dsh/tools.d.ts +2 -6
  305. package/dist/dsh/tools.d.ts.map +1 -1
  306. package/dist/dsh/tools.js +7 -63
  307. package/dist/dsh/tools.js.map +1 -1
  308. package/dist/dsh/turn-process.d.ts +0 -93
  309. package/dist/dsh/turn-process.d.ts.map +1 -1
  310. package/dist/dsh/turn-process.js +1 -307
  311. package/dist/dsh/turn-process.js.map +1 -1
  312. package/dist/dsh/user-interaction.d.ts +9 -16
  313. package/dist/dsh/user-interaction.d.ts.map +1 -1
  314. package/dist/dsh/user-interaction.js +19 -158
  315. package/dist/dsh/user-interaction.js.map +1 -1
  316. package/dist/index.js +2 -19
  317. package/dist/ledger/types.d.ts +1 -1
  318. package/dist/ledger/types.d.ts.map +1 -1
  319. package/dist/ledger/types.js +0 -7
  320. package/dist/ledger/types.js.map +1 -1
  321. package/dist/locale/en.json +1 -1
  322. package/dist/locale/ja.json +1 -1
  323. package/dist/locale/ko.json +1 -1
  324. package/dist/locale/zh-CN.json +1 -1
  325. package/dist/memory/correction-contract.d.ts +4 -4
  326. package/dist/memory/lifecycle.d.ts +1 -1
  327. package/dist/memory/review/evidence.js +1 -1
  328. package/dist/memory/review/evidence.js.map +1 -1
  329. package/dist/model-tools/contracts.d.ts +0 -437
  330. package/dist/model-tools/contracts.d.ts.map +1 -1
  331. package/dist/model-tools/contracts.js +0 -13
  332. package/dist/model-tools/contracts.js.map +1 -1
  333. package/dist/model-tools/names.d.ts +1 -1
  334. package/dist/model-tools/names.d.ts.map +1 -1
  335. package/dist/model-tools/names.js +0 -7
  336. package/dist/model-tools/names.js.map +1 -1
  337. package/dist/model-tools/registry.js +1 -1
  338. package/dist/model-tools/registry.js.map +1 -1
  339. package/dist/models-client.cjs +2 -2
  340. package/dist/models-client.js +2 -2
  341. package/dist/models-client.js.map +1 -1
  342. package/docs/README.ja.md +0 -1
  343. package/docs/README.md +0 -1
  344. package/docs/agenticreplay-recording.md +1 -1
  345. package/docs/agenticreplay-verification.md +1 -1
  346. package/docs/answer-review.md +2 -2
  347. package/docs/architecture.md +4 -7
  348. package/docs/auto-memory-review.md +3 -3
  349. package/docs/coding-workflow.md +1 -1
  350. package/docs/concepts.ja.md +3 -5
  351. package/docs/concepts.md +3 -5
  352. package/docs/core-modules.md +5 -16
  353. package/docs/database.md +5 -10
  354. package/docs/decision-diagnostics.md +1 -2
  355. package/docs/deep-planning.md +3 -3
  356. package/docs/dsh-plugin.md +42 -178
  357. package/docs/execution-ledger.md +1 -2
  358. package/docs/execution-support.md +6 -7
  359. package/docs/harness-map.md +1 -1
  360. package/docs/japanese-output.md +1 -1
  361. package/docs/keyboard-shortcuts.md +1 -1
  362. package/docs/kiokuko-harness.md +71 -0
  363. package/docs/kiokuko-models.md +4 -9
  364. package/docs/lisp-hot-tools.md +12 -7
  365. package/docs/lisp.md +43 -9
  366. package/docs/memory-application.md +5 -5
  367. package/docs/memory-delivery.md +1 -1
  368. package/docs/memory-reuse.md +1 -1
  369. package/docs/model-selection.ja.md +40 -123
  370. package/docs/model-selection.md +45 -114
  371. package/docs/on-demand-intake.md +2 -2
  372. package/docs/owned-execution.md +7 -7
  373. package/docs/pr72-ci-verification.md +2 -2
  374. package/docs/pstack-adaptation.json +0 -34
  375. package/docs/pstack-skills.md +1 -1
  376. package/docs/semantic-compaction.md +2 -2
  377. package/docs/session-history-repair.md +2 -2
  378. package/docs/skill-compiler.md +2 -4
  379. package/docs/tool-exposure.md +1 -1
  380. package/docs/typed-decisions.md +1 -9
  381. package/docs/verification.md +11 -7
  382. package/dsh/cordis.legacy.patch.yml +7 -0
  383. package/dsh/cordis.patch.yml +6 -1
  384. package/lisp/supervisor.mjs +16 -7
  385. package/lisp/tools.lisp +1 -1
  386. package/migrations/051_drop_enno.sql +19 -0
  387. package/package.json +5 -14
  388. package/scripts/session-history-codec.mjs +1 -1
  389. package/skills/coding-ideal-routine-skill/SKILL.md +1 -1
  390. package/skills/kiokuko-lisp/SKILL.md +11 -5
  391. package/skills/kiokuko-single-purpose-functions/SKILL.md +1 -1
  392. package/skills/kiokuko-ui-design-soul/SKILL.md +2 -2
  393. package/skills/one-shot-software-completion/SKILL.md +4 -7
  394. package/skills/one-shot-software-completion/references/boundaries-and-lifecycle.md +3 -5
  395. package/dist/dsh/advisory-runner.d.ts +0 -32
  396. package/dist/dsh/advisory-runner.d.ts.map +0 -1
  397. package/dist/dsh/advisory-runner.js +0 -116
  398. package/dist/dsh/advisory-runner.js.map +0 -1
  399. package/dist/dsh/completion-verifiers.d.ts +0 -45
  400. package/dist/dsh/completion-verifiers.d.ts.map +0 -1
  401. package/dist/dsh/completion-verifiers.js +0 -9
  402. package/dist/dsh/completion-verifiers.js.map +0 -1
  403. package/dist/dsh/continuation.d.ts +0 -24
  404. package/dist/dsh/continuation.d.ts.map +0 -1
  405. package/dist/dsh/continuation.js +0 -215
  406. package/dist/dsh/continuation.js.map +0 -1
  407. package/dist/dsh/decisions/check-model.d.ts +0 -6
  408. package/dist/dsh/decisions/check-model.d.ts.map +0 -1
  409. package/dist/dsh/decisions/check-model.js +0 -36
  410. package/dist/dsh/decisions/check-model.js.map +0 -1
  411. package/dist/dsh/decisions/plan-review.d.ts +0 -17
  412. package/dist/dsh/decisions/plan-review.d.ts.map +0 -1
  413. package/dist/dsh/decisions/plan-review.js +0 -68
  414. package/dist/dsh/decisions/plan-review.js.map +0 -1
  415. package/dist/dsh/directive-projection.d.ts +0 -7
  416. package/dist/dsh/directive-projection.d.ts.map +0 -1
  417. package/dist/dsh/directive-projection.js +0 -32
  418. package/dist/dsh/directive-projection.js.map +0 -1
  419. package/dist/dsh/enno-controller.d.ts +0 -132
  420. package/dist/dsh/enno-controller.d.ts.map +0 -1
  421. package/dist/dsh/enno-controller.js +0 -368
  422. package/dist/dsh/enno-controller.js.map +0 -1
  423. package/dist/dsh/enno-delegation.d.ts +0 -36
  424. package/dist/dsh/enno-delegation.d.ts.map +0 -1
  425. package/dist/dsh/enno-delegation.js +0 -203
  426. package/dist/dsh/enno-delegation.js.map +0 -1
  427. package/dist/dsh/enno-memory-refresh-store.d.ts +0 -26
  428. package/dist/dsh/enno-memory-refresh-store.d.ts.map +0 -1
  429. package/dist/dsh/enno-memory-refresh-store.js +0 -45
  430. package/dist/dsh/enno-memory-refresh-store.js.map +0 -1
  431. package/dist/dsh/enno-memory-refresh.d.ts +0 -57
  432. package/dist/dsh/enno-memory-refresh.d.ts.map +0 -1
  433. package/dist/dsh/enno-memory-refresh.js +0 -280
  434. package/dist/dsh/enno-memory-refresh.js.map +0 -1
  435. package/dist/dsh/host-adapter/enno-memory-host.d.ts +0 -29
  436. package/dist/dsh/host-adapter/enno-memory-host.d.ts.map +0 -1
  437. package/dist/dsh/host-adapter/enno-memory-host.js +0 -49
  438. package/dist/dsh/host-adapter/enno-memory-host.js.map +0 -1
  439. package/dist/dsh/modules/enno.d.ts +0 -70
  440. package/dist/dsh/modules/enno.d.ts.map +0 -1
  441. package/dist/dsh/modules/enno.js +0 -22
  442. package/dist/dsh/modules/enno.js.map +0 -1
  443. package/dist/dsh/verification-identity.d.ts +0 -3
  444. package/dist/dsh/verification-identity.d.ts.map +0 -1
  445. package/dist/dsh/verification-identity.js +0 -15
  446. package/dist/dsh/verification-identity.js.map +0 -1
  447. package/dist/enno-oduno/advisory-store.d.ts +0 -31
  448. package/dist/enno-oduno/advisory-store.d.ts.map +0 -1
  449. package/dist/enno-oduno/advisory-store.js +0 -105
  450. package/dist/enno-oduno/advisory-store.js.map +0 -1
  451. package/dist/enno-oduno/advisory.d.ts +0 -18
  452. package/dist/enno-oduno/advisory.d.ts.map +0 -1
  453. package/dist/enno-oduno/advisory.js +0 -311
  454. package/dist/enno-oduno/advisory.js.map +0 -1
  455. package/dist/enno-oduno/coding-workflow.d.ts +0 -39
  456. package/dist/enno-oduno/coding-workflow.d.ts.map +0 -1
  457. package/dist/enno-oduno/coding-workflow.js +0 -33
  458. package/dist/enno-oduno/coding-workflow.js.map +0 -1
  459. package/dist/enno-oduno/confirmation.d.ts +0 -4
  460. package/dist/enno-oduno/confirmation.d.ts.map +0 -1
  461. package/dist/enno-oduno/confirmation.js +0 -146
  462. package/dist/enno-oduno/confirmation.js.map +0 -1
  463. package/dist/enno-oduno/directives.d.ts +0 -10
  464. package/dist/enno-oduno/directives.d.ts.map +0 -1
  465. package/dist/enno-oduno/directives.js +0 -294
  466. package/dist/enno-oduno/directives.js.map +0 -1
  467. package/dist/enno-oduno/experts.d.ts +0 -3
  468. package/dist/enno-oduno/experts.d.ts.map +0 -1
  469. package/dist/enno-oduno/experts.js +0 -28
  470. package/dist/enno-oduno/experts.js.map +0 -1
  471. package/dist/enno-oduno/handoff.d.ts +0 -4
  472. package/dist/enno-oduno/handoff.d.ts.map +0 -1
  473. package/dist/enno-oduno/handoff.js +0 -18
  474. package/dist/enno-oduno/handoff.js.map +0 -1
  475. package/dist/enno-oduno/language.d.ts +0 -4
  476. package/dist/enno-oduno/language.d.ts.map +0 -1
  477. package/dist/enno-oduno/language.js +0 -6
  478. package/dist/enno-oduno/language.js.map +0 -1
  479. package/dist/enno-oduno/memory-focus.d.ts +0 -32
  480. package/dist/enno-oduno/memory-focus.d.ts.map +0 -1
  481. package/dist/enno-oduno/memory-focus.js +0 -87
  482. package/dist/enno-oduno/memory-focus.js.map +0 -1
  483. package/dist/enno-oduno/memory-refresh-policy.d.ts +0 -17
  484. package/dist/enno-oduno/memory-refresh-policy.d.ts.map +0 -1
  485. package/dist/enno-oduno/memory-refresh-policy.js +0 -11
  486. package/dist/enno-oduno/memory-refresh-policy.js.map +0 -1
  487. package/dist/enno-oduno/memory-verification.d.ts +0 -7
  488. package/dist/enno-oduno/memory-verification.d.ts.map +0 -1
  489. package/dist/enno-oduno/memory-verification.js +0 -59
  490. package/dist/enno-oduno/memory-verification.js.map +0 -1
  491. package/dist/enno-oduno/plan-draft.d.ts +0 -15
  492. package/dist/enno-oduno/plan-draft.d.ts.map +0 -1
  493. package/dist/enno-oduno/plan-draft.js +0 -20
  494. package/dist/enno-oduno/plan-draft.js.map +0 -1
  495. package/dist/enno-oduno/plan-recovery.d.ts +0 -44
  496. package/dist/enno-oduno/plan-recovery.d.ts.map +0 -1
  497. package/dist/enno-oduno/plan-recovery.js +0 -160
  498. package/dist/enno-oduno/plan-recovery.js.map +0 -1
  499. package/dist/enno-oduno/repository-state.d.ts +0 -10
  500. package/dist/enno-oduno/repository-state.d.ts.map +0 -1
  501. package/dist/enno-oduno/repository-state.js +0 -146
  502. package/dist/enno-oduno/repository-state.js.map +0 -1
  503. package/dist/enno-oduno/sanitize.d.ts +0 -17
  504. package/dist/enno-oduno/sanitize.d.ts.map +0 -1
  505. package/dist/enno-oduno/sanitize.js +0 -88
  506. package/dist/enno-oduno/sanitize.js.map +0 -1
  507. package/dist/enno-oduno/schemas.d.ts +0 -968
  508. package/dist/enno-oduno/schemas.d.ts.map +0 -1
  509. package/dist/enno-oduno/schemas.js +0 -622
  510. package/dist/enno-oduno/schemas.js.map +0 -1
  511. package/dist/enno-oduno/service.d.ts +0 -62
  512. package/dist/enno-oduno/service.d.ts.map +0 -1
  513. package/dist/enno-oduno/service.js +0 -1505
  514. package/dist/enno-oduno/service.js.map +0 -1
  515. package/dist/enno-oduno/skills.d.ts +0 -22
  516. package/dist/enno-oduno/skills.d.ts.map +0 -1
  517. package/dist/enno-oduno/skills.js +0 -127
  518. package/dist/enno-oduno/skills.js.map +0 -1
  519. package/dist/enno-oduno/store.d.ts +0 -109
  520. package/dist/enno-oduno/store.d.ts.map +0 -1
  521. package/dist/enno-oduno/store.js +0 -833
  522. package/dist/enno-oduno/store.js.map +0 -1
  523. package/dist/enno-oduno/types.d.ts +0 -457
  524. package/dist/enno-oduno/types.d.ts.map +0 -1
  525. package/dist/enno-oduno/types.js +0 -66
  526. package/dist/enno-oduno/types.js.map +0 -1
  527. package/dist/enno-oduno/validation-errors.d.ts +0 -93
  528. package/dist/enno-oduno/validation-errors.d.ts.map +0 -1
  529. package/dist/enno-oduno/validation-errors.js +0 -159
  530. package/dist/enno-oduno/validation-errors.js.map +0 -1
  531. package/dist/enno-oduno/verifier.d.ts +0 -16
  532. package/dist/enno-oduno/verifier.d.ts.map +0 -1
  533. package/dist/enno-oduno/verifier.js +0 -271
  534. package/dist/enno-oduno/verifier.js.map +0 -1
  535. package/docs/enno-memory-benchmark.json +0 -761
  536. package/docs/enno-memory-evaluation.md +0 -137
  537. package/docs/enno-oduno.ja.md +0 -68
  538. package/docs/enno-oduno.md +0 -94
  539. package/skills/kiokuko-enno-oduno/SKILL.md +0 -64
  540. package/skills/kiokuko-enno-oduno/enno-oduno.png +0 -0
@@ -1,833 +0,0 @@
1
- import { registerCompletionVerifiers } from '../dsh/completion-verifiers.js';
2
- import { completionSourceDigest } from '../dsh/task-completion.js';
3
- import { readCodingWorkflow } from '../dsh/coding-workflow/store.js';
4
- import { recordDiagnosticEnnoCommit } from '../dsh/decisions/diagnostics.js';
5
- import { ennoCodingProjection } from './coding-workflow.js';
6
- import { executeIdempotentInTransaction } from '../dsh/intake-idempotency.js';
7
- import { readPlanDraft } from './plan-draft.js';
8
- import { createHash, randomUUID } from 'node:crypto';
9
- import path from 'node:path';
10
- import { withImmediateTransaction } from '../db/transaction.js';
11
- import { KiokukoError } from '../errors.js';
12
- import { LedgerStore } from '../ledger/store.js';
13
- import { canonicalContentHash, canonicalJson } from '../serialization/validate.js';
14
- import { parseStrictJson } from '../dsh/strict-json.js';
15
- import { parseEnnoContract, parseEnnoRequestHandoff, parseOdunoIdeal, parseOdunoMeditation, parseVerifierSpec, parseWorkReportResult, parseWorkPlan, } from './schemas.js';
16
- import { ADVISORY_OUTCOMES, ENNO_DEFAULT_MAX_ATTEMPTS, ENNO_APPLICABLE_TASK_TYPES, ENNO_STATUSES, } from './types.js';
17
- import { userFacingLanguageForTask } from './language.js';
18
- import { advisoryContextForSnapshot, advisoryInputDigest, advisoryPhaseForStatus, advisorySlotDefinitions, } from './advisory.js';
19
- import { captureRepositoryState } from './repository-state.js';
20
- function advisoryPhaseState(database, input) {
21
- const phase = advisoryPhaseForStatus(input.status);
22
- if (phase === null || (phase === 'final_review' && !input.finalEvidenceReady))
23
- return { state: 'not_started' };
24
- const row = database.prepare(`
25
- SELECT input_digest AS inputDigest, state
26
- FROM enno_advisory_rounds
27
- WHERE run_id = ? AND contract_revision = ? AND mutation_revision = ? AND phase = ?
28
- ORDER BY created_at DESC, round_id DESC
29
- LIMIT 1
30
- `).get(input.runId, input.revision, input.mutationRevision, phase);
31
- if (row === undefined || row.inputDigest !== input.currentInputDigest) {
32
- return { state: 'fanout_requested', slots: advisorySlotDefinitions(phase) };
33
- }
34
- if (row.state === 'consumed')
35
- return { state: 'consumed', inputDigest: row.inputDigest };
36
- if (row.state !== 'aggregated')
37
- return integrity('Stored advisory lifecycle state is invalid');
38
- const contributions = database.prepare(`
39
- SELECT c.slot_id AS slotId, c.outcome
40
- FROM enno_advisory_contributions AS c
41
- JOIN enno_advisory_rounds AS r ON r.round_id = c.round_id
42
- WHERE r.run_id = ? AND r.contract_revision = ? AND r.mutation_revision = ?
43
- AND r.phase = ? AND r.input_digest = ?
44
- ORDER BY c.slot_rank
45
- `).all(input.runId, input.revision, input.mutationRevision, phase, row.inputDigest);
46
- const slots = advisorySlotDefinitions(phase);
47
- if (contributions.length !== slots.length)
48
- return integrity('Stored advisory lifecycle contributions are invalid');
49
- return {
50
- state: 'aggregated',
51
- inputDigest: row.inputDigest,
52
- requiredDispositionSlots: slots.map((slot, index) => {
53
- const contribution = contributions[index];
54
- if (contribution?.slotId !== slot.slotId || !ADVISORY_OUTCOMES.includes(contribution.outcome)) {
55
- return integrity('Stored advisory lifecycle contributions are invalid');
56
- }
57
- const outcome = contribution.outcome;
58
- return {
59
- slotId: slot.slotId,
60
- outcome,
61
- allowedDispositions: outcome === 'completed'
62
- ? ['adopted', 'not_adopted']
63
- : ['unavailable'],
64
- };
65
- }),
66
- };
67
- }
68
- export function resolveEnnoIdentity(database, input) {
69
- if (input.workspace !== undefined && input.orchestrationId !== undefined && input.resumeToken === undefined) {
70
- return { runId: input.runId, workspace: input.workspace, orchestrationId: input.orchestrationId };
71
- }
72
- if (input.resumeToken === undefined || input.workspace !== undefined || input.orchestrationId !== undefined) {
73
- throw new KiokukoError('VALIDATION_ERROR', 'Enno identity requires either explicit identity or one resume token');
74
- }
75
- const tokenHash = createHash('sha256').update(input.resumeToken, 'utf8').digest('hex');
76
- const row = database.prepare(`
77
- SELECT ec.run_id AS runId, ec.workspace, ec.orchestration_session_id AS orchestrationId,
78
- ec.route_epoch AS routeEpoch, rt.route_epoch AS tokenRouteEpoch,
79
- rt.repository_root AS tokenRepositoryRoot, ec.repository_root AS repositoryRoot,
80
- rt.dsh_session_id AS tokenDshSessionId, ec.dsh_session_id AS dshSessionId,
81
- rt.expires_at AS expiresAt
82
- FROM enno_resume_tokens AS rt
83
- JOIN enno_contracts AS ec ON ec.run_id = rt.run_id
84
- WHERE rt.token_hash = ? AND rt.run_id = ?
85
- `).get(tokenHash, input.runId);
86
- if (row === undefined)
87
- throw new KiokukoError('CONFLICT', 'Enno resume token is invalid or expired');
88
- const expiresAt = Date.parse(row.expiresAt);
89
- if (row.routeEpoch !== row.tokenRouteEpoch || row.repositoryRoot !== row.tokenRepositoryRoot
90
- || row.dshSessionId !== row.tokenDshSessionId
91
- || !Number.isFinite(expiresAt) || expiresAt <= Date.now()) {
92
- throw new KiokukoError('CONFLICT', 'Enno resume token is stale');
93
- }
94
- return { runId: row.runId, workspace: row.workspace, orchestrationId: row.orchestrationId };
95
- }
96
- const OPERATION_LEASE_MS = 6 * 60_000;
97
- const VERIFIER_LEASE_GRACE_MS = 60_000;
98
- const VERIFIER_TERMINATION_GRACE_MS = 1_000;
99
- export function operationLeaseMsForVerifiers(verifiers) {
100
- const sequentialRuntime = verifiers.reduce((total, verifier) => total + verifier.timeoutMs + VERIFIER_TERMINATION_GRACE_MS, VERIFIER_LEASE_GRACE_MS);
101
- return Math.max(OPERATION_LEASE_MS, sequentialRuntime);
102
- }
103
- function integrity(message) {
104
- throw new KiokukoError('INTEGRITY_ERROR', message);
105
- }
106
- function parseCanonicalJson(value, message) {
107
- let parsed;
108
- try {
109
- parsed = parseStrictJson(value, { allowTrailingComma: false, disallowComments: true, allowEmptyContent: false }, message);
110
- }
111
- catch {
112
- return integrity(message);
113
- }
114
- if (canonicalJson(parsed) !== value)
115
- return integrity(message);
116
- return parsed;
117
- }
118
- function contractRow(database, runId) {
119
- return database.prepare('SELECT * FROM enno_contracts WHERE run_id = ?').get(runId);
120
- }
121
- function validateContractRow(row) {
122
- if (!ENNO_STATUSES.includes(row.status)
123
- || !ENNO_APPLICABLE_TASK_TYPES.includes(row.task_type)
124
- || !Number.isSafeInteger(row.revision) || row.revision < 1
125
- || !Number.isSafeInteger(row.attempts) || row.attempts < 0 || row.attempts > 20
126
- || !Number.isSafeInteger(row.mutation_revision) || row.mutation_revision < 0
127
- || !Number.isSafeInteger(row.route_epoch) || row.route_epoch < 0) {
128
- integrity('Stored Enno run state is invalid');
129
- }
130
- }
131
- function exposedStatus(row) {
132
- if (row.phase === null)
133
- return row.status;
134
- if (row.phase === 'oduno_ideal' && row.status === 'zenki_planning')
135
- return row.phase;
136
- if (row.phase === 'oduno_meditation' && row.status === 'enno_verifying')
137
- return row.phase;
138
- return integrity('Stored Oduno phase is inconsistent');
139
- }
140
- function persistedState(status) {
141
- if (status === 'oduno_ideal')
142
- return { status: 'zenki_planning', phase: status };
143
- if (status === 'oduno_meditation')
144
- return { status: 'enno_verifying', phase: status };
145
- return { status, phase: null };
146
- }
147
- function storedWorkResult(value, repositoryRoot) {
148
- if (typeof value !== 'object' || value === null || Array.isArray(value))
149
- return parseWorkReportResult(value);
150
- const result = value;
151
- if (!Array.isArray(result.changedPaths))
152
- return parseWorkReportResult(value);
153
- const changedPaths = result.changedPaths.map((candidate) => {
154
- if (typeof candidate !== 'string' || !path.isAbsolute(candidate))
155
- return candidate;
156
- const relative = path.relative(repositoryRoot, candidate);
157
- if (relative.startsWith(`..${path.sep}`) || relative === '..' || path.isAbsolute(relative))
158
- return candidate;
159
- return (relative || '.').split(path.sep).join('/');
160
- });
161
- return parseWorkReportResult({ ...result, changedPaths });
162
- }
163
- function workUnits(database, runId, revision, repositoryRoot) {
164
- const rows = database.prepare(`
165
- SELECT work_unit_json, status, attempt_count, result_json
166
- FROM enno_work_units
167
- WHERE run_id = ? AND contract_revision = ?
168
- ORDER BY order_index
169
- `).all(runId, revision);
170
- if (rows.length === 0)
171
- return [];
172
- const parsed = parseWorkPlan({
173
- objective: 'stored units',
174
- units: rows.map((row) => parseCanonicalJson(row.work_unit_json, 'Stored Enno WorkUnit is invalid')),
175
- });
176
- return rows.map((row, index) => ({
177
- workUnit: parsed.units[index],
178
- status: row.status,
179
- attemptCount: row.attempt_count,
180
- result: row.result_json === null
181
- ? null
182
- : storedWorkResult(parseCanonicalJson(row.result_json, 'Stored Enno work result is invalid'), repositoryRoot),
183
- }));
184
- }
185
- function assertLedgerIdentity(database, identity, repositoryRoot) {
186
- const run = new LedgerStore(database).readRun(identity.runId, identity.workspace);
187
- if (run === undefined)
188
- throw new KiokukoError('NOT_FOUND', 'Enno run was not found');
189
- const intake = database.prepare('SELECT session_id AS sessionId FROM run_intakes WHERE run_id = ?')
190
- .get(identity.runId);
191
- if (intake?.sessionId !== identity.orchestrationId) {
192
- throw new KiokukoError('CONFLICT', 'Enno orchestration session does not own this run');
193
- }
194
- if (repositoryRoot !== undefined && contractRow(database, identity.runId)?.repository_root !== repositoryRoot) {
195
- throw new KiokukoError('CONFLICT', 'Enno repository binding changed');
196
- }
197
- }
198
- function userFacingLanguage(database, runId) {
199
- const row = database.prepare(`
200
- SELECT s.task_text AS task
201
- FROM run_intakes AS ri
202
- JOIN akinator_sessions AS s ON s.id = ri.session_id
203
- WHERE ri.run_id = ?
204
- `).get(runId);
205
- if (row === undefined || typeof row.task !== 'string' || row.task.trim() === '') {
206
- return integrity('Stored Enno intake task is invalid');
207
- }
208
- return userFacingLanguageForTask(row.task);
209
- }
210
- export function readEnnoSnapshot(database, identity) {
211
- assertLedgerIdentity(database, identity);
212
- const row = contractRow(database, identity.runId);
213
- if (row === undefined)
214
- throw new KiokukoError('NOT_FOUND', 'Enno contract was not found');
215
- validateContractRow(row);
216
- if (row.workspace !== identity.workspace || row.orchestration_session_id !== identity.orchestrationId) {
217
- throw new KiokukoError('CONFLICT', 'Enno run identity changed');
218
- }
219
- if (row.dsh_session_id !== null && (row.dsh_session_id.length === 0 || row.dsh_session_id.length > 256)) {
220
- integrity('Stored Enno DSH session routing metadata is invalid');
221
- }
222
- const contract = parseEnnoContract(parseCanonicalJson(row.contract_json, 'Stored Enno contract is invalid'));
223
- const handoff = parseEnnoRequestHandoff(parseCanonicalJson(row.handoff_json, 'Stored Enno request handoff is invalid'));
224
- const ideal = row.ideal_json === null
225
- ? null
226
- : parseOdunoIdeal(parseCanonicalJson(row.ideal_json, 'Stored Oduno ideal is invalid'));
227
- const meditation = row.meditation_json === null
228
- ? null
229
- : parseOdunoMeditation(parseCanonicalJson(row.meditation_json, 'Stored Oduno meditation is invalid'));
230
- const status = exposedStatus(row);
231
- if (contract.revision !== row.revision)
232
- integrity('Stored Enno contract revision is inconsistent');
233
- if (handoff.taskType !== row.task_type)
234
- integrity('Stored Enno request handoff is inconsistent');
235
- if (status === 'oduno_ideal' && ideal !== null)
236
- integrity('Stored Oduno ideal phase is inconsistent');
237
- if (status === 'oduno_meditation' && (ideal === null || meditation !== null)) {
238
- integrity('Stored Oduno meditation phase is inconsistent');
239
- }
240
- if (meditation !== null && status !== 'completed')
241
- integrity('Stored Oduno meditation result is inconsistent');
242
- const currentRepositoryDigest = status === 'enno_verifying' && contract.finalVerifiers.length > 0
243
- ? captureRepositoryState(row.repository_root).digest
244
- : undefined;
245
- const finalEvidenceReady = contract.finalVerifiers.length > 0
246
- && hasFreshFinalVerifierResults(database, {
247
- runId: row.run_id,
248
- revision: row.revision,
249
- mutationRevision: row.mutation_revision,
250
- verifiers: contract.finalVerifiers,
251
- ...(currentRepositoryDigest === undefined ? {} : { repositoryDigest: currentRepositoryDigest }),
252
- });
253
- const finalEvidence = finalEvidenceReady
254
- ? readFreshFinalVerifierResults(database, {
255
- runId: row.run_id,
256
- revision: row.revision,
257
- mutationRevision: row.mutation_revision,
258
- verifiers: contract.finalVerifiers,
259
- ...(currentRepositoryDigest === undefined ? {} : { repositoryDigest: currentRepositoryDigest }),
260
- }) ?? []
261
- : [];
262
- const completionBindings = database.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='dsh_completion_bindings'").get()
263
- ? database.prepare(`SELECT criterion_id, method_digest, updated_at FROM dsh_completion_bindings
264
- WHERE run_id = ? AND criterion_revision = ? AND approved = 1 ORDER BY criterion_id`)
265
- .all(row.run_id, row.revision) : [];
266
- const snapshot = {
267
- runId: row.run_id,
268
- workspace: row.workspace,
269
- orchestrationId: row.orchestration_session_id,
270
- dshSessionId: row.dsh_session_id,
271
- repositoryRoot: row.repository_root,
272
- taskType: row.task_type,
273
- userFacingLanguage: userFacingLanguage(database, row.run_id),
274
- status,
275
- revision: row.revision,
276
- confirmationState: row.confirmation_state,
277
- attempts: row.attempts,
278
- mutationRevision: row.mutation_revision,
279
- ...(completionBindings.length ? { completionBindingDigest: canonicalContentHash(completionBindings) } : {}),
280
- routeEpoch: row.route_epoch,
281
- ideal,
282
- meditation,
283
- contract,
284
- handoff,
285
- workUnits: workUnits(database, identity.runId, row.revision, row.repository_root),
286
- finalEvidenceReady,
287
- finalEvidence,
288
- blocker: row.blocker,
289
- advisoryPhaseState: { state: 'not_started' },
290
- };
291
- const draft = readPlanDraft(database, snapshot);
292
- if (draft)
293
- snapshot.planDraft = draft;
294
- const advisoryPhase = advisoryPhaseForStatus(status);
295
- const currentInputDigest = advisoryPhase === null || (advisoryPhase === 'final_review' && !finalEvidenceReady)
296
- ? undefined
297
- : advisoryInputDigest({
298
- phase: advisoryPhase,
299
- contractRevision: row.revision,
300
- mutationRevision: row.mutation_revision,
301
- allowlistedContext: advisoryContextForSnapshot(snapshot, advisoryPhase),
302
- });
303
- snapshot.advisoryPhaseState = advisoryPhaseState(database, {
304
- runId: row.run_id,
305
- status,
306
- revision: row.revision,
307
- mutationRevision: row.mutation_revision,
308
- finalEvidenceReady,
309
- currentInputDigest,
310
- });
311
- return snapshot;
312
- }
313
- function emptyDiscovery(mode) {
314
- return {
315
- attempted: false,
316
- mode,
317
- requirements: [],
318
- queries: [],
319
- cacheHits: 0,
320
- candidates: 0,
321
- selected: [],
322
- failures: [],
323
- };
324
- }
325
- export function createEnnoDraft(database, input) {
326
- return withImmediateTransaction(database, () => {
327
- assertLedgerIdentity(database, input);
328
- const existing = contractRow(database, input.runId);
329
- if (existing !== undefined)
330
- return readEnnoSnapshot(database, input);
331
- const contract = {
332
- revision: 1,
333
- scope: input.taskTarget === null ? [] : [input.taskTarget],
334
- exclusions: [],
335
- acceptanceCriteria: input.taskExpected === null ? [] : [{ id: 'task-expected', description: input.taskExpected }],
336
- workPlan: { objective: input.taskTarget ?? 'Plan the requested task', units: [] },
337
- skillSet: {
338
- entries: [],
339
- intakeDiscovery: input.skillDiscovery,
340
- zenkiDiscovery: emptyDiscovery(input.skillDiscovery.mode),
341
- },
342
- finalVerifiers: [],
343
- maxAttempts: ENNO_DEFAULT_MAX_ATTEMPTS,
344
- provenance: {
345
- scope: 'inferred',
346
- exclusions: 'inferred',
347
- acceptanceCriteria: 'inferred',
348
- workPlan: 'inferred',
349
- skillSet: 'inferred',
350
- finalVerifiers: 'inferred',
351
- maxAttempts: 'inferred',
352
- },
353
- };
354
- const now = new Date().toISOString();
355
- database.prepare(`
356
- INSERT INTO enno_contracts (
357
- run_id, workspace, orchestration_session_id, dsh_session_id,
358
- repository_root, task_type, status, revision,
359
- confirmation_state, attempts, mutation_revision, contract_json, handoff_json,
360
- intake_discovery_json, plan_digest, blocker, created_at, updated_at
361
- , phase, ideal_json, meditation_json
362
- ) VALUES (?, ?, ?, ?, ?, ?, 'zenki_planning', 1, 'not_required', 0, 0, ?, ?, ?, NULL, NULL, ?, ?, 'oduno_ideal', NULL, NULL)
363
- `).run(input.runId, input.workspace, input.orchestrationId, input.dshSessionId, input.repositoryRoot, input.taskType, canonicalJson(contract), canonicalJson(input.handoff), canonicalJson(input.skillDiscovery), now, now);
364
- appendEnnoEventInTransaction(database, input.runId, 'enno.started', 'enno-oduno', 'started', {
365
- contractRevision: 1,
366
- dshSessionId: input.dshSessionId,
367
- });
368
- return readEnnoSnapshot(database, input);
369
- });
370
- }
371
- export function appendEnnoEventInTransaction(database, runId, eventType, actor, outcome, payload) {
372
- new LedgerStore(database).appendBatchInTransaction(runId, { events: [{
373
- eventId: randomUUID(),
374
- eventType,
375
- actor,
376
- outcome,
377
- payload,
378
- }] });
379
- }
380
- export function updateContractInTransaction(database, snapshot, input) {
381
- const nextState = persistedState(input.status);
382
- const currentState = persistedState(snapshot.status);
383
- const updated = database.prepare(`
384
- UPDATE enno_contracts
385
- SET status = ?, phase = ?, revision = ?, confirmation_state = ?, attempts = ?, mutation_revision = ?,
386
- contract_json = ?, ideal_json = ?, meditation_json = ?, plan_digest = ?, blocker = ?, updated_at = ?
387
- WHERE run_id = ? AND workspace = ? AND orchestration_session_id = ? AND revision = ?
388
- AND status = ? AND phase IS ?
389
- RETURNING run_id AS runId
390
- `).get(nextState.status, nextState.phase, input.contract.revision, input.confirmationState, input.attempts ?? snapshot.attempts, input.mutationRevision ?? snapshot.mutationRevision, canonicalJson(input.contract), input.ideal === undefined
391
- ? snapshot.ideal === null ? null : canonicalJson(snapshot.ideal)
392
- : input.ideal === null ? null : canonicalJson(input.ideal), input.meditation === undefined
393
- ? snapshot.meditation === null ? null : canonicalJson(snapshot.meditation)
394
- : input.meditation === null ? null : canonicalJson(input.meditation), input.planDigest ?? null, input.blocker ?? null, new Date().toISOString(), snapshot.runId, snapshot.workspace, snapshot.orchestrationId, snapshot.revision, currentState.status, currentState.phase);
395
- if (updated?.runId !== snapshot.runId)
396
- throw new KiokukoError('CONFLICT', 'Enno state changed concurrently');
397
- }
398
- export function replaceWorkUnitsInTransaction(database, runId, revision, workPlan) {
399
- database.prepare('DELETE FROM enno_work_units WHERE run_id = ? AND contract_revision = ?').run(runId, revision);
400
- const statement = database.prepare(`
401
- INSERT INTO enno_work_units (
402
- run_id, work_unit_id, contract_revision, order_index, work_unit_json,
403
- status, attempt_count, result_json, created_at, updated_at
404
- ) VALUES (?, ?, ?, ?, ?, 'pending', 0, NULL, ?, ?)
405
- `);
406
- const now = new Date().toISOString();
407
- workPlan.units.forEach((unit, index) => {
408
- statement.run(runId, unit.id, revision, index, canonicalJson(unit), now, now);
409
- });
410
- }
411
- export function setWorkUnitStatusInTransaction(database, input) {
412
- const from = Array.isArray(input.from) ? input.from : [input.from];
413
- const placeholders = from.map(() => '?').join(', ');
414
- const updated = database.prepare(`
415
- UPDATE enno_work_units
416
- SET status = ?,
417
- attempt_count = COALESCE(?, attempt_count),
418
- result_json = ?,
419
- updated_at = ?
420
- WHERE run_id = ? AND contract_revision = ? AND work_unit_id = ? AND status IN (${placeholders})
421
- RETURNING work_unit_id AS workUnitId
422
- `).get(input.to, input.attemptCount ?? null, input.result === undefined || input.result === null ? null : canonicalJson(input.result), new Date().toISOString(), input.runId, input.contractRevision, input.workUnitId, ...from);
423
- if (updated?.workUnitId !== input.workUnitId)
424
- throw new KiokukoError('CONFLICT', 'Enno WorkUnit changed concurrently');
425
- }
426
- const EXECUTION_LEASE_MS = 15 * 60_000;
427
- export function claimExecutionLeaseInTransaction(database, snapshot, workUnitId, owner) {
428
- const nowDate = new Date();
429
- const now = nowDate.toISOString();
430
- const existing = database.prepare(`
431
- SELECT contract_revision AS contractRevision, mutation_revision AS mutationRevision,
432
- work_unit_id AS workUnitId, route_epoch AS routeEpoch,
433
- dsh_session_id AS dshSessionId,
434
- lease_expires_at AS expiresAt
435
- FROM enno_execution_leases WHERE run_id = ?
436
- `).get(snapshot.runId);
437
- if (existing !== undefined && existing.expiresAt > now
438
- && (existing.contractRevision !== snapshot.revision
439
- || existing.mutationRevision !== snapshot.mutationRevision
440
- || existing.workUnitId !== workUnitId
441
- || existing.routeEpoch !== (snapshot.routeEpoch ?? 0)
442
- || existing.dshSessionId !== owner.dshSessionId)) {
443
- throw new KiokukoError('CONFLICT', 'Enno WorkUnit is leased to another current actor');
444
- }
445
- const leaseToken = randomUUID();
446
- const tokenHash = createHash('sha256').update(leaseToken, 'utf8').digest('hex');
447
- const expiresAt = new Date(nowDate.getTime() + EXECUTION_LEASE_MS).toISOString();
448
- database.prepare(`
449
- INSERT INTO enno_execution_leases (
450
- run_id, contract_revision, mutation_revision, work_unit_id, route_epoch,
451
- dsh_session_id, lease_token_hash, lease_expires_at,
452
- heartbeat_at, created_at, updated_at
453
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
454
- ON CONFLICT(run_id) DO UPDATE SET
455
- contract_revision = excluded.contract_revision,
456
- mutation_revision = excluded.mutation_revision,
457
- work_unit_id = excluded.work_unit_id,
458
- route_epoch = excluded.route_epoch,
459
- dsh_session_id = excluded.dsh_session_id,
460
- lease_token_hash = excluded.lease_token_hash,
461
- lease_expires_at = excluded.lease_expires_at,
462
- heartbeat_at = excluded.heartbeat_at,
463
- updated_at = excluded.updated_at
464
- `).run(snapshot.runId, snapshot.revision, snapshot.mutationRevision, workUnitId, snapshot.routeEpoch ?? 0, owner.dshSessionId, tokenHash, expiresAt, now, now, now);
465
- return {
466
- leaseToken,
467
- routeEpoch: snapshot.routeEpoch ?? 0,
468
- contractRevision: snapshot.revision,
469
- mutationRevision: snapshot.mutationRevision,
470
- workUnitId,
471
- expiresAt,
472
- };
473
- }
474
- export function assertExecutionLeaseInTransaction(database, snapshot, input) {
475
- const row = database.prepare(`
476
- SELECT contract_revision AS contractRevision, mutation_revision AS mutationRevision,
477
- work_unit_id AS workUnitId, route_epoch AS routeEpoch,
478
- dsh_session_id AS dshSessionId,
479
- lease_token_hash AS tokenHash, lease_expires_at AS expiresAt
480
- FROM enno_execution_leases WHERE run_id = ?
481
- `).get(snapshot.runId);
482
- if (row === undefined) {
483
- if (input.leaseToken !== undefined || input.routeEpoch !== undefined) {
484
- throw new KiokukoError('CONFLICT', 'Enno execution lease is not active');
485
- }
486
- return;
487
- }
488
- const tokenHash = input.leaseToken === undefined
489
- ? null
490
- : createHash('sha256').update(input.leaseToken, 'utf8').digest('hex');
491
- if (row.expiresAt <= new Date().toISOString()
492
- || row.contractRevision !== snapshot.revision
493
- || row.mutationRevision !== snapshot.mutationRevision
494
- || row.workUnitId !== input.workUnitId
495
- || row.routeEpoch !== input.routeEpoch
496
- || row.routeEpoch !== (snapshot.routeEpoch ?? 0)
497
- || row.dshSessionId !== snapshot.dshSessionId
498
- || tokenHash !== row.tokenHash) {
499
- throw new KiokukoError('CONFLICT', 'Enno execution lease is stale or belongs to another actor');
500
- }
501
- }
502
- export function releaseExecutionLeaseInTransaction(database, runId) {
503
- database.prepare('DELETE FROM enno_execution_leases WHERE run_id = ?').run(runId);
504
- }
505
- export function renewExecutionLeaseInTransaction(database, snapshot, input, minimumLeaseMs) {
506
- assertExecutionLeaseInTransaction(database, snapshot, input);
507
- const existing = database.prepare('SELECT 1 AS present FROM enno_execution_leases WHERE run_id = ?')
508
- .get(snapshot.runId);
509
- if (existing === undefined)
510
- return;
511
- const now = new Date();
512
- const leaseExpiresAt = new Date(now.getTime() + Math.max(EXECUTION_LEASE_MS, minimumLeaseMs)).toISOString();
513
- const updated = database.prepare(`
514
- UPDATE enno_execution_leases
515
- SET lease_expires_at = ?, heartbeat_at = ?, updated_at = ?
516
- WHERE run_id = ?
517
- RETURNING run_id AS runId
518
- `).get(leaseExpiresAt, now.toISOString(), now.toISOString(), snapshot.runId);
519
- if (updated?.runId !== snapshot.runId)
520
- throw new KiokukoError('CONFLICT', 'Enno execution lease changed concurrently');
521
- }
522
- export function startVerifierRunsInTransaction(database, input) {
523
- const nowDate = new Date();
524
- const now = nowDate.toISOString();
525
- database.prepare(`
526
- UPDATE enno_verifier_runs
527
- SET status = 'abandoned', failure_code = 'lease_expired', finished_at = ?
528
- WHERE run_id = ? AND status = 'started' AND lease_expires_at <= ?
529
- `).run(now, input.runId, now);
530
- const statement = database.prepare(`
531
- INSERT INTO enno_verifier_runs (
532
- verifier_run_id, run_id, work_unit_id, contract_revision, mutation_revision,
533
- verifier_id, verifier_json, status, owner_nonce, lease_expires_at, heartbeat_at,
534
- repository_state_policy_version, pre_repository_digest, verifier_spec_digest, started_at
535
- ) VALUES (?, ?, ?, ?, ?, ?, ?, 'started', ?, ?, ?, ?, ?, ?, ?)
536
- `);
537
- const leaseMs = operationLeaseMsForVerifiers(input.verifiers);
538
- const leaseExpiresAt = new Date(nowDate.getTime() + leaseMs).toISOString();
539
- return input.verifiers.map((verifier) => {
540
- const verifierRunId = randomUUID();
541
- statement.run(verifierRunId, input.runId, input.workUnitId, input.revision, input.mutationRevision, verifier.id, canonicalJson(verifier), randomUUID(), leaseExpiresAt, now, input.repositoryEvidence?.policyVersion ?? null, input.repositoryEvidence?.preDigest ?? null, input.repositoryEvidence?.verifierSpecDigest ?? null, now);
542
- const coding = readCodingWorkflow(database, input.runId);
543
- if (coding) {
544
- const row = contractRow(database, input.runId);
545
- const contract = parseEnnoContract(parseCanonicalJson(row.contract_json, 'Stored Enno contract is invalid'));
546
- const scopes = input.workUnitId ? contract.workPlan.units.find(unit => unit.id === input.workUnitId)?.scope ?? [] : contract.scope;
547
- const sources = scopes.map(scope => scope.replace(/[*?].*$/u, '').replace(/\/$/u, ''))
548
- .filter(scope => scope.length > 0 && scope !== '.' && !path.isAbsolute(scope) && !scope.split(/[\\/]/u).includes('..'));
549
- const tests = verifier.args.filter(arg => /\.(?:test|spec)\.(?:js|mjs|ts)$/u.test(arg)).map(arg => path.relative(coding.repositoryRoot, path.resolve(coding.repositoryRoot, verifier.cwd, arg)));
550
- const paths = [...new Set([...sources, ...tests])];
551
- if (paths.length) {
552
- const digest = completionSourceDigest(database, input.runId, coding.repositoryRoot, paths);
553
- database.prepare('UPDATE enno_verifier_runs SET coding_source_paths_json=?,coding_source_digest=? WHERE verifier_run_id=?')
554
- .run(JSON.stringify(paths), digest, verifierRunId);
555
- }
556
- }
557
- return verifierRunId;
558
- });
559
- }
560
- export function finishVerifierRunsInTransaction(database, verifierRunIds, results, repositoryEvidence) {
561
- if (verifierRunIds.length !== results.length)
562
- integrity('Enno verifier result count is inconsistent');
563
- const finishedAt = new Date().toISOString();
564
- results.forEach((result, index) => {
565
- const verifierRunId = verifierRunIds[index];
566
- if (verifierRunId === undefined)
567
- integrity('Enno verifier result count is inconsistent');
568
- const updated = database.prepare(`
569
- UPDATE enno_verifier_runs
570
- SET status = ?, exit_code = ?, signal = ?, duration_ms = ?,
571
- stdout_preview = ?, stderr_preview = ?, stdout_digest = ?, stderr_digest = ?, skipped = ?, tap_summary_json = ?,
572
- post_repository_digest = ?, changed_during_verification = ?, finished_at = ?
573
- WHERE verifier_run_id = ? AND status = 'started'
574
- RETURNING verifier_run_id AS verifierRunId
575
- `).get(result.status, result.exitCode, result.signal, result.durationMs, result.stdoutPreview, result.stderrPreview, result.stdoutDigest, result.stderrDigest, result.skipped === undefined ? null : result.skipped ? 1 : 0, result.tapSummary === undefined ? null : JSON.stringify(result.tapSummary), repositoryEvidence?.postDigest ?? null, repositoryEvidence === undefined ? null : repositoryEvidence.changedDuringVerification ? 1 : 0, finishedAt, verifierRunId);
576
- if (updated?.verifierRunId !== verifierRunId)
577
- throw new KiokukoError('CONFLICT', 'Enno verifier state changed concurrently');
578
- database.prepare('UPDATE enno_verifier_runs SET explicit_test_cases=? WHERE verifier_run_id=?')
579
- .run(result.explicitCases === undefined ? null : result.explicitCases ? 1 : 0, verifierRunId);
580
- });
581
- }
582
- export function readFreshFinalVerifierResults(database, input) {
583
- if (input.verifiers.length === 0)
584
- return undefined;
585
- const rows = database.prepare(`
586
- SELECT verifier_id, verifier_json, status, exit_code, signal, duration_ms,
587
- stdout_preview, stderr_preview, stdout_digest, stderr_digest, skipped, tap_summary_json,
588
- repository_state_policy_version, pre_repository_digest, post_repository_digest,
589
- verifier_spec_digest, changed_during_verification, finished_at, explicit_test_cases,
590
- coding_source_paths_json, coding_source_digest
591
- FROM enno_verifier_runs
592
- WHERE run_id = ? AND work_unit_id IS NULL
593
- AND contract_revision = ? AND mutation_revision = ?
594
- ORDER BY verifier_id, finished_at DESC, verifier_run_id DESC
595
- `).all(input.runId, input.revision, input.mutationRevision);
596
- const completedRows = rows.filter((row) => row.status !== 'started' && row.status !== 'abandoned');
597
- const byId = new Map();
598
- for (const row of completedRows)
599
- if (!byId.has(row.verifier_id))
600
- byId.set(row.verifier_id, row);
601
- if (byId.size !== input.verifiers.length || input.verifiers.some((verifier) => !byId.has(verifier.id)))
602
- return undefined;
603
- for (const verifier of input.verifiers) {
604
- const row = byId.get(verifier.id);
605
- const coding = readCodingWorkflow(database, input.runId);
606
- if (coding && (!row.coding_source_paths_json || row.coding_source_digest !== completionSourceDigest(database, input.runId, coding.repositoryRoot, JSON.parse(row.coding_source_paths_json))))
607
- return undefined;
608
- const storedVerifier = parseVerifierSpec(parseCanonicalJson(row.verifier_json, 'Stored Enno verifier is invalid'));
609
- if (canonicalJson(storedVerifier) !== canonicalJson(verifier))
610
- return undefined;
611
- // Missing audit evidence is unknown, never proof of an unchanged tree.
612
- if (row.changed_during_verification !== 0)
613
- return undefined;
614
- if (input.repositoryDigest !== undefined
615
- && (row.pre_repository_digest !== input.repositoryDigest
616
- || row.post_repository_digest !== input.repositoryDigest
617
- || row.verifier_spec_digest !== canonicalContentHash(input.verifiers)))
618
- return undefined;
619
- }
620
- // A criterion-to-verifier mapping approved after a verifier finished cannot
621
- // turn that earlier execution into proof. The next host verification must
622
- // run again against the approved mapping, even if repository bytes are same.
623
- if (database.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='dsh_completion_bindings'").get()) {
624
- const bindings = database.prepare(`SELECT method_json, updated_at FROM dsh_completion_bindings
625
- WHERE run_id = ? AND approved = 1 AND criterion_revision = ?`).all(input.runId, input.revision);
626
- for (const binding of bindings) {
627
- let method;
628
- try {
629
- method = JSON.parse(binding.method_json);
630
- }
631
- catch {
632
- return undefined;
633
- }
634
- if (method.kind !== 'enno_verifier')
635
- continue;
636
- if (method.workUnitId !== undefined)
637
- continue;
638
- if (typeof method.verifierId !== 'string' || !byId.get(method.verifierId)?.finished_at
639
- || byId.get(method.verifierId).finished_at <= binding.updated_at)
640
- return undefined;
641
- }
642
- }
643
- return input.verifiers.map((verifier) => {
644
- const row = byId.get(verifier.id);
645
- const storedVerifier = parseVerifierSpec(parseCanonicalJson(row.verifier_json, 'Stored Enno verifier is invalid'));
646
- return {
647
- verifier: { ...storedVerifier, args: [...storedVerifier.args] },
648
- status: row.status,
649
- exitCode: row.exit_code,
650
- signal: row.signal,
651
- durationMs: row.duration_ms,
652
- stdoutPreview: row.stdout_preview,
653
- stderrPreview: row.stderr_preview,
654
- stdoutDigest: row.stdout_digest,
655
- stderrDigest: row.stderr_digest,
656
- ...(row.skipped === null ? {} : { skipped: row.skipped === 1 }),
657
- ...(row.tap_summary_json === null ? {} : { tapSummary: JSON.parse(row.tap_summary_json) }),
658
- explicitCases: row.explicit_test_cases === 1,
659
- ...(row.repository_state_policy_version === null ? {} : { repositoryStatePolicyVersion: row.repository_state_policy_version }),
660
- ...(row.post_repository_digest === null ? {} : { repositoryStateDigest: row.post_repository_digest }),
661
- ...(row.changed_during_verification === null ? {} : { changedDuringVerification: row.changed_during_verification === 1 }),
662
- };
663
- });
664
- }
665
- export function hasFreshFinalVerifierResults(database, input) {
666
- try {
667
- return readFreshFinalVerifierResults(database, input) !== undefined;
668
- }
669
- catch {
670
- return false;
671
- }
672
- }
673
- export function readOperationReceipt(database, runId, operation) {
674
- const row = database.prepare(`
675
- SELECT request_digest, state, response_json, lease_expires_at
676
- FROM enno_operation_receipts
677
- WHERE run_id = ? AND operation = ? AND idempotency_key = ?
678
- `).get(runId, operation.operation, operation.idempotencyKey);
679
- if (row === undefined)
680
- return undefined;
681
- if (row.request_digest !== operation.requestDigest) {
682
- throw new KiokukoError('CONFLICT', 'Enno idempotency key was reused with different input');
683
- }
684
- if (row.state === 'started') {
685
- if (row.lease_expires_at === null || !Number.isFinite(Date.parse(row.lease_expires_at))) {
686
- return integrity('Stored Enno operation receipt lease is invalid');
687
- }
688
- const now = new Date().toISOString();
689
- if (row.lease_expires_at > now)
690
- throw new KiokukoError('CONFLICT', 'Enno operation is already in progress');
691
- const abandoned = database.prepare(`
692
- UPDATE enno_operation_receipts
693
- SET state = 'abandoned', failure_code = 'lease_expired', finished_at = ?
694
- WHERE run_id = ? AND operation = ? AND idempotency_key = ?
695
- AND request_digest = ? AND state = 'started' AND lease_expires_at <= ?
696
- RETURNING run_id AS runId
697
- `).get(now, runId, operation.operation, operation.idempotencyKey, operation.requestDigest, now);
698
- if (abandoned?.runId !== runId)
699
- throw new KiokukoError('CONFLICT', 'Enno operation state changed concurrently');
700
- return undefined;
701
- }
702
- if (row.state === 'failed' || row.state === 'abandoned')
703
- return undefined;
704
- if (row.response_json === null)
705
- integrity('Stored Enno operation receipt is invalid');
706
- return parseCanonicalJson(row.response_json, 'Stored Enno operation receipt is invalid');
707
- }
708
- export function startOperationInTransaction(database, runId, operation, leaseMs = OPERATION_LEASE_MS) {
709
- const replay = readOperationReceipt(database, runId, operation);
710
- if (replay !== undefined)
711
- throw new KiokukoError('CONFLICT', 'Completed Enno operation must be replayed before mutation');
712
- if (!Number.isSafeInteger(leaseMs) || leaseMs < OPERATION_LEASE_MS)
713
- integrity('Enno operation lease duration is invalid');
714
- const nowDate = new Date();
715
- const now = nowDate.toISOString();
716
- database.prepare(`
717
- UPDATE enno_operation_receipts
718
- SET state = 'abandoned', failure_code = 'lease_expired', finished_at = ?
719
- WHERE run_id = ? AND state = 'started' AND lease_expires_at <= ?
720
- `).run(now, runId, now);
721
- const active = database.prepare(`
722
- SELECT operation FROM enno_operation_receipts
723
- WHERE run_id = ? AND state = 'started' AND lease_expires_at > ?
724
- LIMIT 1
725
- `).get(runId, now);
726
- if (active !== undefined)
727
- throw new KiokukoError('CONFLICT', 'Another Enno operation is already in progress');
728
- const ownerNonce = randomUUID();
729
- const leaseExpiresAt = new Date(nowDate.getTime() + leaseMs).toISOString();
730
- const started = database.prepare(`
731
- INSERT INTO enno_operation_receipts (
732
- run_id, operation, idempotency_key, request_digest, state, response_json,
733
- owner_nonce, lease_expires_at, heartbeat_at, failure_code, created_at, finished_at
734
- ) VALUES (?, ?, ?, ?, 'started', NULL, ?, ?, ?, NULL, ?, NULL)
735
- ON CONFLICT(run_id, operation, idempotency_key) DO UPDATE SET
736
- state = 'started', response_json = NULL, owner_nonce = excluded.owner_nonce,
737
- lease_expires_at = excluded.lease_expires_at, heartbeat_at = excluded.heartbeat_at,
738
- failure_code = NULL, created_at = excluded.created_at, finished_at = NULL
739
- WHERE enno_operation_receipts.request_digest = excluded.request_digest
740
- AND enno_operation_receipts.state IN ('failed', 'abandoned')
741
- RETURNING run_id AS runId
742
- `).get(runId, operation.operation, operation.idempotencyKey, operation.requestDigest, ownerNonce, leaseExpiresAt, now, now);
743
- if (started?.runId !== runId)
744
- throw new KiokukoError('CONFLICT', 'Enno operation could not be claimed');
745
- return ownerNonce;
746
- }
747
- export function completeOperationInTransaction(database, runId, operation, ownerNonce, response) {
748
- const serialized = canonicalJson(response);
749
- const finishedAt = new Date().toISOString();
750
- const updated = database.prepare(`
751
- UPDATE enno_operation_receipts
752
- SET state = 'completed', response_json = ?, finished_at = ?
753
- WHERE run_id = ? AND operation = ? AND idempotency_key = ?
754
- AND request_digest = ? AND state = 'started' AND owner_nonce = ?
755
- AND lease_expires_at > ?
756
- RETURNING run_id AS runId
757
- `).get(serialized, finishedAt, runId, operation.operation, operation.idempotencyKey, operation.requestDigest, ownerNonce, finishedAt);
758
- if (updated?.runId !== runId)
759
- throw new KiokukoError('CONFLICT', 'Enno operation receipt changed concurrently');
760
- recordDiagnosticEnnoCommit(database, runId, operation.operation, operation.idempotencyKey);
761
- }
762
- export function terminalizeLedgerRunInTransaction(database, runId, status) {
763
- new LedgerStore(database).updateRunStatusInTransaction(runId, status);
764
- }
765
- /** Renew the authoritative Enno contract on explicit task resume. Prior
766
- * definitions and results remain history; none are proof for the new revision. */
767
- export function reopenEnnoTaskInTransaction(database, identity, input) {
768
- assertLedgerIdentity(database, identity, input.repositoryRoot);
769
- const receipt = executeIdempotentInTransaction(database, {
770
- scope: `enno-task-resume:${canonicalContentHash(identity.runId)}`, key: input.operationId,
771
- request: { identity, ...input }, createdAt: new Date().toISOString(),
772
- }, () => {
773
- const current = readEnnoSnapshot(database, identity);
774
- if (!input.force && !['completed', 'cancelled', 'blocked'].includes(current.status))
775
- return { reopened: false };
776
- const now = new Date().toISOString();
777
- if (database.prepare("SELECT 1 FROM enno_operation_receipts WHERE run_id=? AND state='started' AND lease_expires_at>?").get(identity.runId, now)) {
778
- throw new KiokukoError('CONFLICT', 'Wait for the active Enno operation to stop before resuming this task');
779
- }
780
- const previous = { contract: current.contract, ideal: current.ideal, meditation: current.meditation,
781
- status: current.status, confirmationState: current.confirmationState, attempts: current.attempts,
782
- mutationRevision: current.mutationRevision, routeEpoch: current.routeEpoch ?? 0, blocker: current.blocker };
783
- const contract = { ...current.contract, revision: current.revision + 1 };
784
- updateContractInTransaction(database, current, { contract,
785
- status: current.ideal === null ? 'oduno_ideal' : 'zenki_planning',
786
- confirmationState: 'revision_requested', attempts: 0, mutationRevision: current.mutationRevision + 1,
787
- meditation: null, planDigest: canonicalContentHash(contract.workPlan) });
788
- database.prepare('UPDATE enno_contracts SET route_epoch=route_epoch+1 WHERE run_id=?').run(identity.runId);
789
- database.prepare("UPDATE enno_operation_receipts SET state='abandoned',failure_code='explicit_task_resume',finished_at=? WHERE run_id=? AND state='started'").run(now, identity.runId);
790
- releaseExecutionLeaseInTransaction(database, identity.runId);
791
- // Existing rows are keyed by contract revision; the old rows are retained.
792
- replaceWorkUnitsInTransaction(database, identity.runId, contract.revision, contract.workPlan);
793
- appendEnnoEventInTransaction(database, identity.runId, 'enno.replan_requested', 'enno-oduno', 'explicit_task_resume', {
794
- fromContractRevision: current.revision, toContractRevision: contract.revision,
795
- previousContractDigest: canonicalContentHash(previous),
796
- historyScope: `enno-task-resume:${canonicalContentHash(identity.runId)}`,
797
- operationId: input.operationId,
798
- });
799
- // The source's idempotency receipt archives complete prior definitions
800
- // without the ledger event's preview/redaction or payload-size limits.
801
- return { reopened: true, previous: previous, revision: contract.revision };
802
- });
803
- return receipt.reopened;
804
- }
805
- registerCompletionVerifiers({
806
- reopenTask: reopenEnnoTaskInTransaction,
807
- codingProjection(database, identity) { return ennoCodingProjection(readEnnoSnapshot(database, identity)); },
808
- criteria(database, identity) {
809
- const snapshot = readEnnoSnapshot(database, identity);
810
- return { revision: snapshot.revision, criteria: snapshot.contract.acceptanceCriteria };
811
- },
812
- results(database, identity, root, workUnitId) {
813
- const snapshot = readEnnoSnapshot(database, identity);
814
- if (workUnitId) {
815
- const unit = snapshot.workUnits.find(unit => unit.workUnit.id === workUnitId);
816
- if (!unit)
817
- return;
818
- return unit.workUnit.focusedVerifiers.flatMap(verifier => {
819
- const row = database.prepare(`SELECT verifier_run_id,verifier_json,status,tap_summary_json,explicit_test_cases,coding_source_paths_json,coding_source_digest,finished_at
820
- FROM enno_verifier_runs WHERE run_id=? AND work_unit_id=? AND contract_revision=? AND verifier_id=?
821
- ORDER BY rowid DESC LIMIT 1`).get(identity.runId, workUnitId, snapshot.revision, verifier.id);
822
- if (!row || !row.finished_at || canonicalContentHash(JSON.parse(row.verifier_json)) !== canonicalContentHash(verifier))
823
- return [];
824
- if (readCodingWorkflow(database, identity.runId) && (!row.coding_source_paths_json || row.coding_source_digest !== completionSourceDigest(database, identity.runId, root, JSON.parse(row.coding_source_paths_json))))
825
- return [];
826
- return [{ verifierId: verifier.id, status: row.status, receiptId: row.verifier_run_id, explicitCases: row.explicit_test_cases === 1, ...(row.tap_summary_json ? { tapSummary: JSON.parse(row.tap_summary_json) } : {}) }];
827
- });
828
- }
829
- return readFreshFinalVerifierResults(database, { runId: identity.runId, revision: snapshot.revision, mutationRevision: snapshot.mutationRevision,
830
- verifiers: snapshot.contract.finalVerifiers, repositoryDigest: captureRepositoryState(root).digest })?.map(result => ({ verifierId: result.verifier.id, status: result.status, explicitCases: result.explicitCases === true, ...(result.tapSummary ? { tapSummary: result.tapSummary } : {}) }));
831
- },
832
- });
833
- //# sourceMappingURL=store.js.map