@cleocode/core 2026.9.8 → 2026.9.9

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 (561) hide show
  1. package/dist/audit/reconstruct.d.ts +13 -43
  2. package/dist/audit/reconstruct.d.ts.map +1 -1
  3. package/dist/audit/reconstruct.js +295 -290
  4. package/dist/audit/reconstruct.js.map +1 -1
  5. package/dist/bootstrap.d.ts.map +1 -1
  6. package/dist/bootstrap.js +8 -2
  7. package/dist/bootstrap.js.map +1 -1
  8. package/dist/dispatch/mutate-projection.d.ts.map +1 -1
  9. package/dist/dispatch/mutate-projection.js +12 -0
  10. package/dist/dispatch/mutate-projection.js.map +1 -1
  11. package/dist/dispatch/mvi-projection.d.ts +29 -6
  12. package/dist/dispatch/mvi-projection.d.ts.map +1 -1
  13. package/dist/dispatch/mvi-projection.js +109 -139
  14. package/dist/dispatch/mvi-projection.js.map +1 -1
  15. package/dist/docs/docs-read-model.d.ts +3 -2
  16. package/dist/docs/docs-read-model.d.ts.map +1 -1
  17. package/dist/docs/docs-read-model.js +4 -3
  18. package/dist/docs/docs-read-model.js.map +1 -1
  19. package/dist/docs/export-document.js +5100 -2297
  20. package/dist/docs/export-document.js.map +3 -3
  21. package/dist/docs/projection.d.ts +67 -0
  22. package/dist/docs/projection.d.ts.map +1 -0
  23. package/dist/docs/projection.js +370 -0
  24. package/dist/docs/projection.js.map +1 -0
  25. package/dist/doctor/acceptance-drift.d.ts +6 -2
  26. package/dist/doctor/acceptance-drift.d.ts.map +1 -1
  27. package/dist/doctor/acceptance-drift.js +43 -5
  28. package/dist/doctor/acceptance-drift.js.map +1 -1
  29. package/dist/doctor/knowledge-summary.d.ts +41 -0
  30. package/dist/doctor/knowledge-summary.d.ts.map +1 -0
  31. package/dist/doctor/knowledge-summary.js +81 -0
  32. package/dist/doctor/knowledge-summary.js.map +1 -0
  33. package/dist/doctor/knowledge.d.ts +192 -0
  34. package/dist/doctor/knowledge.d.ts.map +1 -0
  35. package/dist/doctor/knowledge.js +1864 -0
  36. package/dist/doctor/knowledge.js.map +1 -0
  37. package/dist/git/work-tree.d.ts +64 -0
  38. package/dist/git/work-tree.d.ts.map +1 -0
  39. package/dist/git/work-tree.js +111 -0
  40. package/dist/git/work-tree.js.map +1 -0
  41. package/dist/hooks/handlers/task-hooks.d.ts +8 -5
  42. package/dist/hooks/handlers/task-hooks.d.ts.map +1 -1
  43. package/dist/hooks/handlers/task-hooks.js +15 -60
  44. package/dist/hooks/handlers/task-hooks.js.map +1 -1
  45. package/dist/identity/cleo-identity.d.ts +13 -0
  46. package/dist/identity/cleo-identity.d.ts.map +1 -1
  47. package/dist/identity/cleo-identity.js +20 -6
  48. package/dist/identity/cleo-identity.js.map +1 -1
  49. package/dist/injection.d.ts.map +1 -1
  50. package/dist/injection.js +29 -13
  51. package/dist/injection.js.map +1 -1
  52. package/dist/internal.d.ts +2 -0
  53. package/dist/internal.d.ts.map +1 -1
  54. package/dist/internal.js +2 -0
  55. package/dist/internal.js.map +1 -1
  56. package/dist/lifecycle/verification/satisfies-validator.d.ts.map +1 -1
  57. package/dist/lifecycle/verification/satisfies-validator.js +124 -120
  58. package/dist/lifecycle/verification/satisfies-validator.js.map +1 -1
  59. package/dist/llm/plugin-facade.js +4018 -1726
  60. package/dist/llm/plugin-facade.js.map +3 -3
  61. package/dist/memory/brain-backfill.d.ts +27 -12
  62. package/dist/memory/brain-backfill.d.ts.map +1 -1
  63. package/dist/memory/brain-backfill.js +325 -134
  64. package/dist/memory/brain-backfill.js.map +1 -1
  65. package/dist/memory/brain-doctor.d.ts +21 -0
  66. package/dist/memory/brain-doctor.d.ts.map +1 -1
  67. package/dist/memory/brain-doctor.js +111 -53
  68. package/dist/memory/brain-doctor.js.map +1 -1
  69. package/dist/memory/brain-links.d.ts.map +1 -1
  70. package/dist/memory/brain-links.js +31 -4
  71. package/dist/memory/brain-links.js.map +1 -1
  72. package/dist/memory/brain-reasoning.d.ts.map +1 -1
  73. package/dist/memory/brain-reasoning.js +28 -2
  74. package/dist/memory/brain-reasoning.js.map +1 -1
  75. package/dist/memory/brain-reconciler.d.ts +14 -19
  76. package/dist/memory/brain-reconciler.d.ts.map +1 -1
  77. package/dist/memory/brain-reconciler.js +70 -97
  78. package/dist/memory/brain-reconciler.js.map +1 -1
  79. package/dist/memory/brain-search.d.ts +2 -0
  80. package/dist/memory/brain-search.d.ts.map +1 -1
  81. package/dist/memory/brain-search.js +59 -29
  82. package/dist/memory/brain-search.js.map +1 -1
  83. package/dist/memory/brain-similarity.d.ts.map +1 -1
  84. package/dist/memory/brain-similarity.js +5 -4
  85. package/dist/memory/brain-similarity.js.map +1 -1
  86. package/dist/memory/brain-stub-prune.d.ts +31 -9
  87. package/dist/memory/brain-stub-prune.d.ts.map +1 -1
  88. package/dist/memory/brain-stub-prune.js +65 -18
  89. package/dist/memory/brain-stub-prune.js.map +1 -1
  90. package/dist/memory/brain-writer-handlers.d.ts +10 -1
  91. package/dist/memory/brain-writer-handlers.d.ts.map +1 -1
  92. package/dist/memory/brain-writer-handlers.js +23 -3
  93. package/dist/memory/brain-writer-handlers.js.map +1 -1
  94. package/dist/memory/brain-writer-thread.d.ts +11 -1
  95. package/dist/memory/brain-writer-thread.d.ts.map +1 -1
  96. package/dist/memory/brain-writer-thread.js +87 -20
  97. package/dist/memory/brain-writer-thread.js.map +1 -1
  98. package/dist/memory/brain-writer-worker.js +8 -1
  99. package/dist/memory/brain-writer-worker.js.map +1 -1
  100. package/dist/memory/decision-cross-link.d.ts +39 -0
  101. package/dist/memory/decision-cross-link.d.ts.map +1 -1
  102. package/dist/memory/decision-cross-link.js +316 -0
  103. package/dist/memory/decision-cross-link.js.map +1 -1
  104. package/dist/memory/decisions.d.ts +4 -1
  105. package/dist/memory/decisions.d.ts.map +1 -1
  106. package/dist/memory/decisions.js +7 -24
  107. package/dist/memory/decisions.js.map +1 -1
  108. package/dist/memory/dispatch-trace.d.ts +12 -5
  109. package/dist/memory/dispatch-trace.d.ts.map +1 -1
  110. package/dist/memory/dispatch-trace.js +17 -7
  111. package/dist/memory/dispatch-trace.js.map +1 -1
  112. package/dist/memory/eligibility.d.ts +51 -0
  113. package/dist/memory/eligibility.d.ts.map +1 -0
  114. package/dist/memory/eligibility.js +77 -0
  115. package/dist/memory/eligibility.js.map +1 -0
  116. package/dist/memory/engine-compat.d.ts +2 -0
  117. package/dist/memory/engine-compat.d.ts.map +1 -1
  118. package/dist/memory/engine-compat.js +10 -0
  119. package/dist/memory/engine-compat.js.map +1 -1
  120. package/dist/memory/extraction-gate.d.ts +21 -7
  121. package/dist/memory/extraction-gate.d.ts.map +1 -1
  122. package/dist/memory/extraction-gate.js +178 -216
  123. package/dist/memory/extraction-gate.js.map +1 -1
  124. package/dist/memory/graph-auto-populate.d.ts +38 -5
  125. package/dist/memory/graph-auto-populate.d.ts.map +1 -1
  126. package/dist/memory/graph-auto-populate.js +182 -60
  127. package/dist/memory/graph-auto-populate.js.map +1 -1
  128. package/dist/memory/graph-memory-bridge.d.ts +14 -1
  129. package/dist/memory/graph-memory-bridge.d.ts.map +1 -1
  130. package/dist/memory/graph-memory-bridge.js +66 -28
  131. package/dist/memory/graph-memory-bridge.js.map +1 -1
  132. package/dist/memory/index.d.ts +1 -19
  133. package/dist/memory/index.d.ts.map +1 -1
  134. package/dist/memory/index.js +1 -50
  135. package/dist/memory/index.js.map +1 -1
  136. package/dist/memory/learnings.d.ts.map +1 -1
  137. package/dist/memory/learnings.js +2 -23
  138. package/dist/memory/learnings.js.map +1 -1
  139. package/dist/memory/manifest-filter.d.ts +21 -0
  140. package/dist/memory/manifest-filter.d.ts.map +1 -0
  141. package/dist/memory/manifest-filter.js +51 -0
  142. package/dist/memory/manifest-filter.js.map +1 -0
  143. package/dist/memory/manifest-ingestion.d.ts +28 -30
  144. package/dist/memory/manifest-ingestion.d.ts.map +1 -1
  145. package/dist/memory/manifest-ingestion.js +104 -235
  146. package/dist/memory/manifest-ingestion.js.map +1 -1
  147. package/dist/memory/observer-reflector.d.ts +2 -0
  148. package/dist/memory/observer-reflector.d.ts.map +1 -1
  149. package/dist/memory/observer-reflector.js +6 -49
  150. package/dist/memory/observer-reflector.js.map +1 -1
  151. package/dist/memory/patterns.d.ts +10 -0
  152. package/dist/memory/patterns.d.ts.map +1 -1
  153. package/dist/memory/patterns.js +25 -33
  154. package/dist/memory/patterns.js.map +1 -1
  155. package/dist/memory/pipeline-manifest-sqlite.d.ts +72 -9
  156. package/dist/memory/pipeline-manifest-sqlite.d.ts.map +1 -1
  157. package/dist/memory/pipeline-manifest-sqlite.js +508 -412
  158. package/dist/memory/pipeline-manifest-sqlite.js.map +1 -1
  159. package/dist/memory/retrieval/build-retrieval-bundle.d.ts.map +1 -1
  160. package/dist/memory/retrieval/build-retrieval-bundle.js +16 -15
  161. package/dist/memory/retrieval/build-retrieval-bundle.js.map +1 -1
  162. package/dist/memory/retrieval/fetch.d.ts +7 -0
  163. package/dist/memory/retrieval/fetch.d.ts.map +1 -1
  164. package/dist/memory/retrieval/fetch.js +14 -11
  165. package/dist/memory/retrieval/fetch.js.map +1 -1
  166. package/dist/memory/retrieval/observe.d.ts +7 -1
  167. package/dist/memory/retrieval/observe.d.ts.map +1 -1
  168. package/dist/memory/retrieval/observe.js +58 -4
  169. package/dist/memory/retrieval/observe.js.map +1 -1
  170. package/dist/memory/retrieval/search.d.ts +14 -1
  171. package/dist/memory/retrieval/search.d.ts.map +1 -1
  172. package/dist/memory/retrieval/search.js +133 -69
  173. package/dist/memory/retrieval/search.js.map +1 -1
  174. package/dist/memory/retrieval/telemetry.d.ts +31 -0
  175. package/dist/memory/retrieval/telemetry.d.ts.map +1 -0
  176. package/dist/memory/retrieval/telemetry.js +53 -0
  177. package/dist/memory/retrieval/telemetry.js.map +1 -0
  178. package/dist/nexus/analyze-orchestrator.d.ts +41 -9
  179. package/dist/nexus/analyze-orchestrator.d.ts.map +1 -1
  180. package/dist/nexus/analyze-orchestrator.js +257 -58
  181. package/dist/nexus/analyze-orchestrator.js.map +1 -1
  182. package/dist/nexus/api-contracts.d.ts +2 -6
  183. package/dist/nexus/api-contracts.d.ts.map +1 -1
  184. package/dist/nexus/api-contracts.js +11 -2
  185. package/dist/nexus/api-contracts.js.map +1 -1
  186. package/dist/nexus/context.d.ts.map +1 -1
  187. package/dist/nexus/context.js +14 -37
  188. package/dist/nexus/context.js.map +1 -1
  189. package/dist/nexus/diff.d.ts.map +1 -1
  190. package/dist/nexus/diff.js +2 -1
  191. package/dist/nexus/diff.js.map +1 -1
  192. package/dist/nexus/identity.d.ts +29 -3
  193. package/dist/nexus/identity.d.ts.map +1 -1
  194. package/dist/nexus/identity.js +63 -12
  195. package/dist/nexus/identity.js.map +1 -1
  196. package/dist/nexus/impact.d.ts +21 -19
  197. package/dist/nexus/impact.d.ts.map +1 -1
  198. package/dist/nexus/impact.js +96 -192
  199. package/dist/nexus/impact.js.map +1 -1
  200. package/dist/nexus/knowledge.d.ts +80 -0
  201. package/dist/nexus/knowledge.d.ts.map +1 -0
  202. package/dist/nexus/knowledge.js +786 -0
  203. package/dist/nexus/knowledge.js.map +1 -0
  204. package/dist/nexus/living-brain.d.ts +8 -5
  205. package/dist/nexus/living-brain.d.ts.map +1 -1
  206. package/dist/nexus/living-brain.js +252 -188
  207. package/dist/nexus/living-brain.js.map +1 -1
  208. package/dist/nexus/registry.d.ts +11 -2
  209. package/dist/nexus/registry.d.ts.map +1 -1
  210. package/dist/nexus/registry.js +144 -128
  211. package/dist/nexus/registry.js.map +1 -1
  212. package/dist/nexus/source-roots.d.ts +16 -0
  213. package/dist/nexus/source-roots.d.ts.map +1 -0
  214. package/dist/nexus/source-roots.js +174 -0
  215. package/dist/nexus/source-roots.js.map +1 -0
  216. package/dist/nexus/task-evidence.d.ts +22 -0
  217. package/dist/nexus/task-evidence.d.ts.map +1 -0
  218. package/dist/nexus/task-evidence.js +210 -0
  219. package/dist/nexus/task-evidence.js.map +1 -0
  220. package/dist/nexus/tasks-bridge.d.ts +14 -7
  221. package/dist/nexus/tasks-bridge.d.ts.map +1 -1
  222. package/dist/nexus/tasks-bridge.js +81 -40
  223. package/dist/nexus/tasks-bridge.js.map +1 -1
  224. package/dist/orchestrate/lifecycle-ops.d.ts.map +1 -1
  225. package/dist/orchestrate/lifecycle-ops.js +170 -120
  226. package/dist/orchestrate/lifecycle-ops.js.map +1 -1
  227. package/dist/orchestrate/query-ops.d.ts +6 -7
  228. package/dist/orchestrate/query-ops.d.ts.map +1 -1
  229. package/dist/orchestrate/query-ops.js +509 -532
  230. package/dist/orchestrate/query-ops.js.map +1 -1
  231. package/dist/orchestration/bootstrap.d.ts +15 -1
  232. package/dist/orchestration/bootstrap.d.ts.map +1 -1
  233. package/dist/orchestration/bootstrap.js +21 -10
  234. package/dist/orchestration/bootstrap.js.map +1 -1
  235. package/dist/orchestration/index.d.ts +35 -3
  236. package/dist/orchestration/index.d.ts.map +1 -1
  237. package/dist/orchestration/index.js +64 -35
  238. package/dist/orchestration/index.js.map +1 -1
  239. package/dist/orchestration/lead-rollup.d.ts +24 -1
  240. package/dist/orchestration/lead-rollup.d.ts.map +1 -1
  241. package/dist/orchestration/lead-rollup.js +31 -11
  242. package/dist/orchestration/lead-rollup.js.map +1 -1
  243. package/dist/orchestration/spawn-prompt.d.ts.map +1 -1
  244. package/dist/orchestration/spawn-prompt.js +16 -41
  245. package/dist/orchestration/spawn-prompt.js.map +1 -1
  246. package/dist/orchestration/unblock.d.ts +15 -1
  247. package/dist/orchestration/unblock.d.ts.map +1 -1
  248. package/dist/orchestration/unblock.js +23 -12
  249. package/dist/orchestration/unblock.js.map +1 -1
  250. package/dist/orchestration/validate-spawn.d.ts.map +1 -1
  251. package/dist/orchestration/validate-spawn.js +3 -3
  252. package/dist/orchestration/validate-spawn.js.map +1 -1
  253. package/dist/orchestration/waves.d.ts +29 -13
  254. package/dist/orchestration/waves.d.ts.map +1 -1
  255. package/dist/orchestration/waves.js +43 -55
  256. package/dist/orchestration/waves.js.map +1 -1
  257. package/dist/paths.d.ts +17 -163
  258. package/dist/paths.d.ts.map +1 -1
  259. package/dist/paths.js +145 -496
  260. package/dist/paths.js.map +1 -1
  261. package/dist/project-info.d.ts +2 -11
  262. package/dist/project-info.d.ts.map +1 -1
  263. package/dist/project-info.js +3 -31
  264. package/dist/project-info.js.map +1 -1
  265. package/dist/project-scope.d.ts +239 -0
  266. package/dist/project-scope.d.ts.map +1 -0
  267. package/dist/project-scope.js +473 -0
  268. package/dist/project-scope.js.map +1 -0
  269. package/dist/release/pr-evidence.d.ts +16 -3
  270. package/dist/release/pr-evidence.d.ts.map +1 -1
  271. package/dist/release/pr-evidence.js +53 -7
  272. package/dist/release/pr-evidence.js.map +1 -1
  273. package/dist/render/nexus/graph/index.d.ts.map +1 -1
  274. package/dist/render/nexus/graph/index.js +4 -2
  275. package/dist/render/nexus/graph/index.js.map +1 -1
  276. package/dist/render/orchestration/audit-reconstruct.d.ts +11 -0
  277. package/dist/render/orchestration/audit-reconstruct.d.ts.map +1 -1
  278. package/dist/render/orchestration/audit-reconstruct.js +21 -6
  279. package/dist/render/orchestration/audit-reconstruct.js.map +1 -1
  280. package/dist/render/tasks/show.js +2 -1
  281. package/dist/render/tasks/show.js.map +1 -1
  282. package/dist/resources/spawn-wrapper.d.ts +82 -14
  283. package/dist/resources/spawn-wrapper.d.ts.map +1 -1
  284. package/dist/resources/spawn-wrapper.js +585 -27
  285. package/dist/resources/spawn-wrapper.js.map +1 -1
  286. package/dist/selfimprove/fix-gen.js +4026 -1734
  287. package/dist/selfimprove/fix-gen.js.map +3 -3
  288. package/dist/sequence/index.d.ts.map +1 -1
  289. package/dist/sequence/index.js +76 -68
  290. package/dist/sequence/index.js.map +1 -1
  291. package/dist/session/canon-lint.d.ts +24 -3
  292. package/dist/session/canon-lint.d.ts.map +1 -1
  293. package/dist/session/canon-lint.js +72 -31
  294. package/dist/session/canon-lint.js.map +1 -1
  295. package/dist/session/engine-ops.d.ts +1 -4
  296. package/dist/session/engine-ops.d.ts.map +1 -1
  297. package/dist/session/engine-ops.js +6 -2
  298. package/dist/session/engine-ops.js.map +1 -1
  299. package/dist/sessions/briefing.d.ts +11 -1
  300. package/dist/sessions/briefing.d.ts.map +1 -1
  301. package/dist/sessions/briefing.js +76 -8
  302. package/dist/sessions/briefing.js.map +1 -1
  303. package/dist/sessions/handoff.d.ts +3 -1
  304. package/dist/sessions/handoff.d.ts.map +1 -1
  305. package/dist/sessions/handoff.js +2 -0
  306. package/dist/sessions/handoff.js.map +1 -1
  307. package/dist/shutdown-deadline.d.ts +24 -33
  308. package/dist/shutdown-deadline.d.ts.map +1 -1
  309. package/dist/shutdown-deadline.js +71 -14
  310. package/dist/shutdown-deadline.js.map +1 -1
  311. package/dist/shutdown.d.ts +21 -10
  312. package/dist/shutdown.d.ts.map +1 -1
  313. package/dist/shutdown.js +89 -42
  314. package/dist/shutdown.js.map +1 -1
  315. package/dist/skills/index.d.ts +1 -1
  316. package/dist/skills/index.d.ts.map +1 -1
  317. package/dist/skills/index.js +1 -1
  318. package/dist/skills/index.js.map +1 -1
  319. package/dist/skills/orchestrator/validator.d.ts +87 -20
  320. package/dist/skills/orchestrator/validator.d.ts.map +1 -1
  321. package/dist/skills/orchestrator/validator.js +330 -241
  322. package/dist/skills/orchestrator/validator.js.map +1 -1
  323. package/dist/store/agent-resolver.d.ts.map +1 -1
  324. package/dist/store/agent-resolver.js +16 -9
  325. package/dist/store/agent-resolver.js.map +1 -1
  326. package/dist/store/attachment-store.d.ts +4 -1
  327. package/dist/store/attachment-store.d.ts.map +1 -1
  328. package/dist/store/attachment-store.js +20 -3
  329. package/dist/store/attachment-store.js.map +1 -1
  330. package/dist/store/background-jobs.d.ts +426 -105
  331. package/dist/store/background-jobs.d.ts.map +1 -1
  332. package/dist/store/background-jobs.js +1208 -252
  333. package/dist/store/background-jobs.js.map +1 -1
  334. package/dist/store/background-ops.d.ts +145 -8
  335. package/dist/store/background-ops.d.ts.map +1 -1
  336. package/dist/store/background-ops.js +459 -15
  337. package/dist/store/background-ops.js.map +1 -1
  338. package/dist/store/backup-inspect.d.ts +48 -4
  339. package/dist/store/backup-inspect.d.ts.map +1 -1
  340. package/dist/store/backup-inspect.js +384 -4
  341. package/dist/store/backup-inspect.js.map +1 -1
  342. package/dist/store/converters.d.ts.map +1 -1
  343. package/dist/store/converters.js +19 -2
  344. package/dist/store/converters.js.map +1 -1
  345. package/dist/store/data-accessor.d.ts +9 -1
  346. package/dist/store/data-accessor.d.ts.map +1 -1
  347. package/dist/store/data-accessor.js +22 -5
  348. package/dist/store/data-accessor.js.map +1 -1
  349. package/dist/store/data-safety-central.d.ts.map +1 -1
  350. package/dist/store/data-safety-central.js +272 -232
  351. package/dist/store/data-safety-central.js.map +1 -1
  352. package/dist/store/db-helpers.d.ts +19 -3
  353. package/dist/store/db-helpers.d.ts.map +1 -1
  354. package/dist/store/db-helpers.js +42 -58
  355. package/dist/store/db-helpers.js.map +1 -1
  356. package/dist/store/dual-scope-db.d.ts +63 -4
  357. package/dist/store/dual-scope-db.d.ts.map +1 -1
  358. package/dist/store/dual-scope-db.js +166 -19
  359. package/dist/store/dual-scope-db.js.map +1 -1
  360. package/dist/store/exodus/archive.d.ts +21 -7
  361. package/dist/store/exodus/archive.d.ts.map +1 -1
  362. package/dist/store/exodus/archive.js +60 -18
  363. package/dist/store/exodus/archive.js.map +1 -1
  364. package/dist/store/exodus/migrate.d.ts.map +1 -1
  365. package/dist/store/exodus/migrate.js +27 -23
  366. package/dist/store/exodus/migrate.js.map +1 -1
  367. package/dist/store/exodus/on-open.d.ts +16 -27
  368. package/dist/store/exodus/on-open.d.ts.map +1 -1
  369. package/dist/store/exodus/on-open.js +121 -169
  370. package/dist/store/exodus/on-open.js.map +1 -1
  371. package/dist/store/exodus/recovery.d.ts +90 -0
  372. package/dist/store/exodus/recovery.d.ts.map +1 -0
  373. package/dist/store/exodus/recovery.js +434 -0
  374. package/dist/store/exodus/recovery.js.map +1 -0
  375. package/dist/store/exodus/types.d.ts +15 -0
  376. package/dist/store/exodus/types.d.ts.map +1 -1
  377. package/dist/store/memory-accessor.d.ts +52 -3
  378. package/dist/store/memory-accessor.d.ts.map +1 -1
  379. package/dist/store/memory-accessor.js +122 -7
  380. package/dist/store/memory-accessor.js.map +1 -1
  381. package/dist/store/nexus-sqlite.d.ts +24 -6
  382. package/dist/store/nexus-sqlite.d.ts.map +1 -1
  383. package/dist/store/nexus-sqlite.js +39 -20
  384. package/dist/store/nexus-sqlite.js.map +1 -1
  385. package/dist/store/ports/domain-binding.d.ts.map +1 -1
  386. package/dist/store/ports/domain-binding.js +27 -5
  387. package/dist/store/ports/domain-binding.js.map +1 -1
  388. package/dist/store/schema/background-jobs.d.ts +181 -2
  389. package/dist/store/schema/background-jobs.d.ts.map +1 -1
  390. package/dist/store/schema/background-jobs.js +27 -3
  391. package/dist/store/schema/background-jobs.js.map +1 -1
  392. package/dist/store/schema/cleo-global/skills.d.ts +2 -2
  393. package/dist/store/schema/cleo-project/lifecycle.d.ts +2 -2
  394. package/dist/store/schema/cleo-project/runtime.d.ts +1 -1
  395. package/dist/store/schema/cleo-project/tasks-core.d.ts +1 -1
  396. package/dist/store/schema/lifecycle.d.ts +2 -2
  397. package/dist/store/schema/skills-schema.d.ts +2 -2
  398. package/dist/store/schema/tasks.d.ts +1 -1
  399. package/dist/store/session-store.d.ts +3 -1
  400. package/dist/store/session-store.d.ts.map +1 -1
  401. package/dist/store/session-store.js +252 -207
  402. package/dist/store/session-store.js.map +1 -1
  403. package/dist/store/sqlite-data-accessor.d.ts +39 -4
  404. package/dist/store/sqlite-data-accessor.d.ts.map +1 -1
  405. package/dist/store/sqlite-data-accessor.js +689 -527
  406. package/dist/store/sqlite-data-accessor.js.map +1 -1
  407. package/dist/store/tasks-sqlite.d.ts +3 -1
  408. package/dist/store/tasks-sqlite.d.ts.map +1 -1
  409. package/dist/store/tasks-sqlite.js +309 -279
  410. package/dist/store/tasks-sqlite.js.map +1 -1
  411. package/dist/store/validation-schemas.d.ts +8 -8
  412. package/dist/store/writer-lease.d.ts +80 -8
  413. package/dist/store/writer-lease.d.ts.map +1 -1
  414. package/dist/store/writer-lease.js +503 -134
  415. package/dist/store/writer-lease.js.map +1 -1
  416. package/dist/system/audit.d.ts +2 -1
  417. package/dist/system/audit.d.ts.map +1 -1
  418. package/dist/system/audit.js +118 -71
  419. package/dist/system/audit.js.map +1 -1
  420. package/dist/system/backup.d.ts.map +1 -1
  421. package/dist/system/backup.js +5 -5
  422. package/dist/system/backup.js.map +1 -1
  423. package/dist/system/inject-generate.js +1 -1
  424. package/dist/task-work/index.d.ts +3 -0
  425. package/dist/task-work/index.d.ts.map +1 -1
  426. package/dist/task-work/index.js +34 -37
  427. package/dist/task-work/index.js.map +1 -1
  428. package/dist/tasks/ac-coverage-gate.d.ts.map +1 -1
  429. package/dist/tasks/ac-coverage-gate.js +4 -0
  430. package/dist/tasks/ac-coverage-gate.js.map +1 -1
  431. package/dist/tasks/ac-immutability.d.ts +7 -4
  432. package/dist/tasks/ac-immutability.d.ts.map +1 -1
  433. package/dist/tasks/ac-immutability.js +19 -17
  434. package/dist/tasks/ac-immutability.js.map +1 -1
  435. package/dist/tasks/ac-table.d.ts +5 -5
  436. package/dist/tasks/ac-table.d.ts.map +1 -1
  437. package/dist/tasks/ac-table.js +26 -12
  438. package/dist/tasks/ac-table.js.map +1 -1
  439. package/dist/tasks/acceptance-input.d.ts +52 -0
  440. package/dist/tasks/acceptance-input.d.ts.map +1 -0
  441. package/dist/tasks/acceptance-input.js +259 -0
  442. package/dist/tasks/acceptance-input.js.map +1 -0
  443. package/dist/tasks/add.d.ts +67 -29
  444. package/dist/tasks/add.d.ts.map +1 -1
  445. package/dist/tasks/add.js +255 -97
  446. package/dist/tasks/add.js.map +1 -1
  447. package/dist/tasks/complete.d.ts +16 -1
  448. package/dist/tasks/complete.d.ts.map +1 -1
  449. package/dist/tasks/complete.js +152 -55
  450. package/dist/tasks/complete.js.map +1 -1
  451. package/dist/tasks/decompose.d.ts +103 -0
  452. package/dist/tasks/decompose.d.ts.map +1 -0
  453. package/dist/tasks/decompose.js +224 -0
  454. package/dist/tasks/decompose.js.map +1 -0
  455. package/dist/tasks/delete.d.ts +5 -8
  456. package/dist/tasks/delete.d.ts.map +1 -1
  457. package/dist/tasks/delete.js +4 -3
  458. package/dist/tasks/delete.js.map +1 -1
  459. package/dist/tasks/dependency-check.d.ts +59 -0
  460. package/dist/tasks/dependency-check.d.ts.map +1 -1
  461. package/dist/tasks/dependency-check.js +73 -0
  462. package/dist/tasks/dependency-check.js.map +1 -1
  463. package/dist/tasks/deps-ready.d.ts +13 -1
  464. package/dist/tasks/deps-ready.d.ts.map +1 -1
  465. package/dist/tasks/deps-ready.js +16 -5
  466. package/dist/tasks/deps-ready.js.map +1 -1
  467. package/dist/tasks/engine-converters.d.ts +7 -0
  468. package/dist/tasks/engine-converters.d.ts.map +1 -1
  469. package/dist/tasks/engine-converters.js +8 -1
  470. package/dist/tasks/engine-converters.js.map +1 -1
  471. package/dist/tasks/evidence.d.ts +54 -26
  472. package/dist/tasks/evidence.d.ts.map +1 -1
  473. package/dist/tasks/evidence.js +292 -40
  474. package/dist/tasks/evidence.js.map +1 -1
  475. package/dist/tasks/find.d.ts +16 -12
  476. package/dist/tasks/find.d.ts.map +1 -1
  477. package/dist/tasks/find.js +107 -93
  478. package/dist/tasks/find.js.map +1 -1
  479. package/dist/tasks/gate-runner.d.ts +88 -14
  480. package/dist/tasks/gate-runner.d.ts.map +1 -1
  481. package/dist/tasks/gate-runner.js +596 -253
  482. package/dist/tasks/gate-runner.js.map +1 -1
  483. package/dist/tasks/hierarchy-policy.d.ts +8 -0
  484. package/dist/tasks/hierarchy-policy.d.ts.map +1 -1
  485. package/dist/tasks/hierarchy-policy.js +9 -2
  486. package/dist/tasks/hierarchy-policy.js.map +1 -1
  487. package/dist/tasks/hierarchy.d.ts +67 -1
  488. package/dist/tasks/hierarchy.d.ts.map +1 -1
  489. package/dist/tasks/hierarchy.js +81 -1
  490. package/dist/tasks/hierarchy.js.map +1 -1
  491. package/dist/tasks/index.d.ts +3 -0
  492. package/dist/tasks/index.d.ts.map +1 -1
  493. package/dist/tasks/index.js +3 -0
  494. package/dist/tasks/index.js.map +1 -1
  495. package/dist/tasks/infer-add-params.d.ts +1 -20
  496. package/dist/tasks/infer-add-params.d.ts.map +1 -1
  497. package/dist/tasks/infer-add-params.js +2 -203
  498. package/dist/tasks/infer-add-params.js.map +1 -1
  499. package/dist/tasks/list.d.ts +7 -2
  500. package/dist/tasks/list.d.ts.map +1 -1
  501. package/dist/tasks/list.js +24 -36
  502. package/dist/tasks/list.js.map +1 -1
  503. package/dist/tasks/ops.d.ts +6 -61
  504. package/dist/tasks/ops.d.ts.map +1 -1
  505. package/dist/tasks/ops.js +5 -53
  506. package/dist/tasks/ops.js.map +1 -1
  507. package/dist/tasks/plan.d.ts +15 -1
  508. package/dist/tasks/plan.d.ts.map +1 -1
  509. package/dist/tasks/plan.js +23 -25
  510. package/dist/tasks/plan.js.map +1 -1
  511. package/dist/tasks/population.d.ts +46 -0
  512. package/dist/tasks/population.d.ts.map +1 -0
  513. package/dist/tasks/population.js +88 -0
  514. package/dist/tasks/population.js.map +1 -0
  515. package/dist/tasks/reconcile-scope.d.ts +157 -0
  516. package/dist/tasks/reconcile-scope.d.ts.map +1 -0
  517. package/dist/tasks/reconcile-scope.js +242 -0
  518. package/dist/tasks/reconcile-scope.js.map +1 -0
  519. package/dist/tasks/req.d.ts +51 -12
  520. package/dist/tasks/req.d.ts.map +1 -1
  521. package/dist/tasks/req.js +125 -69
  522. package/dist/tasks/req.js.map +1 -1
  523. package/dist/tasks/session-scope.d.ts +6 -31
  524. package/dist/tasks/session-scope.d.ts.map +1 -1
  525. package/dist/tasks/session-scope.js +3 -17
  526. package/dist/tasks/session-scope.js.map +1 -1
  527. package/dist/tasks/severity-attestation.d.ts +39 -10
  528. package/dist/tasks/severity-attestation.d.ts.map +1 -1
  529. package/dist/tasks/severity-attestation.js +75 -36
  530. package/dist/tasks/severity-attestation.js.map +1 -1
  531. package/dist/tasks/task-next.d.ts +5 -0
  532. package/dist/tasks/task-next.d.ts.map +1 -1
  533. package/dist/tasks/task-next.js +10 -9
  534. package/dist/tasks/task-next.js.map +1 -1
  535. package/dist/tasks/task-reparent.d.ts.map +1 -1
  536. package/dist/tasks/task-reparent.js +3 -13
  537. package/dist/tasks/task-reparent.js.map +1 -1
  538. package/dist/tasks/update.d.ts +20 -43
  539. package/dist/tasks/update.d.ts.map +1 -1
  540. package/dist/tasks/update.js +64 -49
  541. package/dist/tasks/update.js.map +1 -1
  542. package/dist/validation/engine-ops.d.ts +17 -1
  543. package/dist/validation/engine-ops.d.ts.map +1 -1
  544. package/dist/validation/engine-ops.js +149 -11
  545. package/dist/validation/engine-ops.js.map +1 -1
  546. package/dist/workgraph/reparent-preflight.d.ts +1 -1
  547. package/dist/workgraph/reparent-preflight.d.ts.map +1 -1
  548. package/dist/workgraph/reparent-preflight.js +6 -1
  549. package/dist/workgraph/reparent-preflight.js.map +1 -1
  550. package/dist/workgraph/scaffold-apply.d.ts.map +1 -1
  551. package/dist/workgraph/scaffold-apply.js +81 -76
  552. package/dist/workgraph/scaffold-apply.js.map +1 -1
  553. package/dist/workgraph/structure-validation.d.ts +1 -1
  554. package/dist/workgraph/structure-validation.d.ts.map +1 -1
  555. package/dist/workgraph/structure-validation.js +6 -1
  556. package/dist/workgraph/structure-validation.js.map +1 -1
  557. package/migrations/drizzle-tasks/20260919180000_t12263-job-ownership-fences/migration.sql +34 -0
  558. package/migrations/drizzle-tasks/20260919184500_t12265-durable-pending-proposals/migration.sql +4 -0
  559. package/package.json +18 -13
  560. package/schemas/config.schema.json +2 -2
  561. package/templates/CLEO-INJECTION.md +103 -101
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Bounded knowledge summaries for orientation responses.
3
+ *
4
+ * Code placed in `packages/core/` per Package-Boundary Check — verified
5
+ * against AGENTS.md. Full diagnostics remain available through doctor knowledge.
6
+ */
7
+ import type { KnowledgeCoverage, KnowledgeHealth, KnowledgeReplacement } from '@cleocode/contracts';
8
+ /**
9
+ * Preserve coverage status and provenance without letting per-file reasons consume orientation.
10
+ * @param coverage - Complete read-only assessment.
11
+ * @returns A bounded sample with exact original counts and a detailed follow-up command.
12
+ * @remarks The complete assessment remains unchanged; status and provenance are preserved.
13
+ * @example
14
+ * ```ts
15
+ * const summary = compactKnowledgeCoverage(coverage);
16
+ * ```
17
+ */
18
+ export declare function compactKnowledgeCoverage(coverage: KnowledgeCoverage): KnowledgeCoverage;
19
+ /**
20
+ * Keep independent diagnostic states visible while deferring the repair matrix to its query.
21
+ * @param health - Complete assessment produced by bounded maintenance.
22
+ * @returns Compact health retaining the real finding count, never an implied empty healthy result.
23
+ * @remarks State counts distinguish pending work from an assessed empty matrix.
24
+ * @example
25
+ * ```ts
26
+ * const summary = compactKnowledgeHealth(health);
27
+ * ```
28
+ */
29
+ export declare function compactKnowledgeHealth(health: KnowledgeHealth): KnowledgeHealth;
30
+ /**
31
+ * Keep sourced replacement identities visible without repeating potentially large source excerpts.
32
+ * @param corrections - Verified replacements read from immutable repair receipts.
33
+ * @returns Bounded presentation copies; stored receipts and source evidence remain unchanged.
34
+ * @remarks Source identifiers and hashes remain available; full excerpts stay in canonical receipts.
35
+ * @example
36
+ * ```ts
37
+ * const visible = compactKnowledgeCorrections(corrections);
38
+ * ```
39
+ */
40
+ export declare function compactKnowledgeCorrections(corrections: KnowledgeReplacement[]): KnowledgeReplacement[];
41
+ //# sourceMappingURL=knowledge-summary.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge-summary.d.ts","sourceRoot":"","sources":["../../src/doctor/knowledge-summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,iBAAiB,EAGjB,eAAe,EACf,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAa7B;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAUvF;AAUD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAe/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,oBAAoB,EAAE,GAClC,oBAAoB,EAAE,CAOxB"}
@@ -0,0 +1,81 @@
1
+ const DETAILS_COMMAND = 'cleo doctor knowledge';
2
+ function preview(value, limit = 180) {
3
+ return value.length > limit ? `${value.slice(0, limit - 1)}…` : value;
4
+ }
5
+ function reference(evidence) {
6
+ const { excerpt: _excerpt, ...source } = evidence;
7
+ return source;
8
+ }
9
+ /**
10
+ * Preserve coverage status and provenance without letting per-file reasons consume orientation.
11
+ * @param coverage - Complete read-only assessment.
12
+ * @returns A bounded sample with exact original counts and a detailed follow-up command.
13
+ * @remarks The complete assessment remains unchanged; status and provenance are preserved.
14
+ * @example
15
+ * ```ts
16
+ * const summary = compactKnowledgeCoverage(coverage);
17
+ * ```
18
+ */
19
+ export function compactKnowledgeCoverage(coverage) {
20
+ return {
21
+ ...coverage,
22
+ reasons: coverage.reasons.slice(0, 2).map((reason) => preview(reason)),
23
+ evidence: coverage.evidence.slice(0, 1).map(reference),
24
+ limitations: coverage.limitations.slice(0, 1).map((reason) => preview(reason)),
25
+ reasonCount: coverage.reasonCount ?? coverage.reasons.length,
26
+ evidenceCount: coverage.evidenceCount ?? coverage.evidence.length,
27
+ detailsCommand: DETAILS_COMMAND,
28
+ };
29
+ }
30
+ function diagnostic(value) {
31
+ return {
32
+ status: value.status,
33
+ reasons: value.reasons.slice(0, 1).map((r) => preview(r)),
34
+ evidence: [],
35
+ };
36
+ }
37
+ /**
38
+ * Keep independent diagnostic states visible while deferring the repair matrix to its query.
39
+ * @param health - Complete assessment produced by bounded maintenance.
40
+ * @returns Compact health retaining the real finding count, never an implied empty healthy result.
41
+ * @remarks State counts distinguish pending work from an assessed empty matrix.
42
+ * @example
43
+ * ```ts
44
+ * const summary = compactKnowledgeHealth(health);
45
+ * ```
46
+ */
47
+ export function compactKnowledgeHealth(health) {
48
+ const findingStates = {};
49
+ for (const finding of health.findings) {
50
+ findingStates[finding.state] = (findingStates[finding.state] ?? 0) + 1;
51
+ }
52
+ return {
53
+ structure: diagnostic(health.structure),
54
+ semantics: diagnostic(health.semantics),
55
+ extraction: diagnostic(health.extraction),
56
+ coverage: compactKnowledgeCoverage(health.coverage),
57
+ findings: [],
58
+ findingCount: health.findingCount ?? health.findings.length,
59
+ findingStates: health.findingStates ?? findingStates,
60
+ detailsCommand: DETAILS_COMMAND,
61
+ };
62
+ }
63
+ /**
64
+ * Keep sourced replacement identities visible without repeating potentially large source excerpts.
65
+ * @param corrections - Verified replacements read from immutable repair receipts.
66
+ * @returns Bounded presentation copies; stored receipts and source evidence remain unchanged.
67
+ * @remarks Source identifiers and hashes remain available; full excerpts stay in canonical receipts.
68
+ * @example
69
+ * ```ts
70
+ * const visible = compactKnowledgeCorrections(corrections);
71
+ * ```
72
+ */
73
+ export function compactKnowledgeCorrections(corrections) {
74
+ return corrections.slice(0, 3).map((correction) => ({
75
+ previousId: correction.previousId,
76
+ successorId: correction.successorId,
77
+ reason: preview(correction.reason),
78
+ evidence: [reference(correction.evidence[0])],
79
+ }));
80
+ }
81
+ //# sourceMappingURL=knowledge-summary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge-summary.js","sourceRoot":"","sources":["../../src/doctor/knowledge-summary.ts"],"names":[],"mappings":"AAcA,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,SAAS,OAAO,CAAC,KAAa,EAAE,KAAK,GAAG,GAAG;IACzC,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACxE,CAAC;AAED,SAAS,SAAS,CAAC,QAA8B;IAC/C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA2B;IAClE,OAAO;QACL,GAAG,QAAQ;QACX,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;QACtD,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9E,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM;QAC5D,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM;QACjE,cAAc,EAAE,eAAe;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAA0B;IAC5C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzD,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,MAAM,aAAa,GAAkD,EAAE,CAAC;IACxE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC;QACzC,QAAQ,EAAE,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC;QACnD,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC3D,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,aAAa;QACpD,cAAc,EAAE,eAAe;KAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAmC;IAEnC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAClD,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAClC,QAAQ,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9C,CAAC,CAAC,CAAC;AACN,CAAC"}
@@ -0,0 +1,192 @@
1
+ /**
2
+ * Foreground knowledge assessment and transactional, sourced repair.
3
+ *
4
+ * Code placed in `packages/core/` per Package-Boundary Check — verified
5
+ * against AGENTS.md. No repair reasoning is delegated to a background model.
6
+ */
7
+ import type { KnowledgeDoctorOptions, KnowledgeDoctorResult, KnowledgeRepairProposal, KnowledgeRepairReceipt } from '@cleocode/contracts';
8
+ import type { OperationExecutionContext } from '@cleocode/contracts/jobs';
9
+ import type { KnowledgeRepairAttemptFailure, KnowledgeRepairCancellation, KnowledgeRepairInspection, KnowledgeRepairInventory, KnowledgeRepairInventoryQuery, KnowledgeRepairPreparation, KnowledgeRepairRecoveredState } from '@cleocode/contracts/knowledge-health';
10
+ /**
11
+ * Validation error preserving a stable repair failure code for CLI envelopes.
12
+ * @remarks Stale proposals and failed source validation never apply a mutation.
13
+ * @example
14
+ * ```ts
15
+ * if (error instanceof KnowledgeRepairError) return error.code;
16
+ * ```
17
+ */
18
+ export declare class KnowledgeRepairError extends Error {
19
+ /** Stable machine-readable repair failure code. */
20
+ readonly code: string;
21
+ /** Observed owned-attempt outcome and truthful persistence status. @defaultValue undefined */
22
+ readonly attemptFailure?: KnowledgeRepairAttemptFailure;
23
+ /** Current recovery state, separate from an unmodified historical receipt. @defaultValue undefined */
24
+ readonly recoveryState?: KnowledgeRepairRecoveredState;
25
+ /**
26
+ * Construct an actionable validation or concurrency error.
27
+ * @param code - Stable repair validation failure code.
28
+ * @param message - Observable reason the repair was rejected.
29
+ * @param attemptFailure - Optional observed attempt with committed or pending finalization.
30
+ * @param recoveryState - Optional current rollback disclosure retaining authentic historical receipts.
31
+ */
32
+ constructor(code: string, message: string, attemptFailure?: KnowledgeRepairAttemptFailure, recoveryState?: KnowledgeRepairRecoveredState);
33
+ }
34
+ /**
35
+ * Parse caller-supplied repair JSON against the supported operation contract.
36
+ * @param text - JSON proposal supplied by the foreground calling agent.
37
+ * @returns Validated proposal with an explicit supported operation.
38
+ * @remarks Parsing does not apply repairs; source and state validation occur transactionally.
39
+ * @example
40
+ * ```ts
41
+ * const proposal = parseKnowledgeRepairProposal(await readFile(path, 'utf8'));
42
+ * ```
43
+ */
44
+ export declare function parseKnowledgeRepairProposal(text: string): KnowledgeRepairProposal;
45
+ /**
46
+ * Prepare a sourced existing knowledge repair without starting an executor.
47
+ * @param context - Captured project, actor, retry identity, cancellation and shared deadline.
48
+ * @param input - Existing supported proposal whose revision and state must still match.
49
+ * @returns Authentic immutable pending work or the identical existing submission.
50
+ * @throws KnowledgeRepairError when scope, source evidence or preconditions are invalid.
51
+ * @remarks The existing job store commits proposal bytes and their digest atomically.
52
+ * Cancellation is cooperative at guarded boundaries; admitted synchronous SQLite work
53
+ * cannot be preempted by a timer. Preparation never changes authority or quarantine.
54
+ * @example
55
+ * ```ts
56
+ * const pending = await prepareKnowledgeRepair(context, report.proposals[0]);
57
+ * ```
58
+ */
59
+ export declare function prepareKnowledgeRepair(context: OperationExecutionContext, input: KnowledgeRepairProposal): Promise<KnowledgeRepairPreparation>;
60
+ /**
61
+ * Construct a repair invocation using a root and deadline captured before caller asynchronous work.
62
+ * @param projectRoot - Explicit project identity root captured by the foreground caller.
63
+ * @param actor - Explicit stable caller attribution; never copied from stored proposal ownership.
64
+ * @param proposalId - Immutable proposal/retry key supplied by the caller.
65
+ * @param deadlineAt - Original absolute invocation deadline including earlier file reads.
66
+ * @returns Validated execution context that the caller must close in a finally block.
67
+ * @throws KnowledgeRepairError when actor, identity or deadline input is invalid.
68
+ * @remarks Metadata reads do not renew the deadline. This attribution is not an owner signature.
69
+ * @example
70
+ * ```ts
71
+ * const context = await createKnowledgeRepairInvocation(root, actor, proposalId, deadlineAt);
72
+ * ```
73
+ */
74
+ export declare function createKnowledgeRepairInvocation(projectRoot: string, actor: string, proposalId: string, deadlineAt: number): Promise<OperationExecutionContext>;
75
+ /**
76
+ * Prepare guarded recovery from a retained original receipt without applying it.
77
+ * @param context - Explicit recovery actor, new immutable proposal identity and original deadline.
78
+ * @param receiptId - Successful scoped original receipt whose complete affected images are retained.
79
+ * @returns Durable immutable pending rollback through the existing preparation service.
80
+ * @throws KnowledgeRepairError when the receipt, evidence or affected resources cannot authorize recovery.
81
+ * @remarks Historical receipt bytes are retained; unrelated changes do not authorize overwriting an affected edit.
82
+ * @example
83
+ * ```ts
84
+ * const pending = await prepareKnowledgeRollback(context, originalReceiptId);
85
+ * ```
86
+ */
87
+ export declare function prepareKnowledgeRollback(context: OperationExecutionContext, receiptId: string): Promise<KnowledgeRepairPreparation>;
88
+ /**
89
+ * Apply an authentic prepared repair through the established owned job transaction.
90
+ * @param context - Captured scope and one deadline shared by this foreground attempt.
91
+ * @param jobId - Existing durable pending proposal or inspectable completed operation.
92
+ * @returns Verified receipt committed with the source mutation and terminal job state.
93
+ * @throws KnowledgeRepairError when immutable inputs, resources, generation or identity changed.
94
+ * @remarks Uses the existing domain validators and repair ledger. Synchronous database
95
+ * work cannot be preempted; cancellation is checked at cooperating write boundaries.
96
+ * File hashes are rechecked around mutation but SQLite cannot lock external file edits.
97
+ * A later explicit invocation may supply a new bounded context for the same immutable
98
+ * proposal; an active attempt never renews its deadline. Interrupted uncommitted work
99
+ * records observed failure/cancellation atomically when the original budget and
100
+ * ownership permit; otherwise the error explicitly reports pending finalization
101
+ * and retains the lease/checkpoint. No automatic retry or background reasoning runs.
102
+ * @example
103
+ * ```ts
104
+ * const receipt = await applyPreparedKnowledgeRepair(context, pending.jobId);
105
+ * ```
106
+ */
107
+ export declare function applyPreparedKnowledgeRepair(context: OperationExecutionContext, jobId: string): Promise<KnowledgeRepairReceipt>;
108
+ /**
109
+ * Explicitly resume immutable repair work, preserving terminal or expired running attempts before retry.
110
+ * @param context - Fresh bounded invocation with the same explicit actor and proposal identity.
111
+ * @param jobId - Authentic prepared job to inspect and revalidate before retry.
112
+ * @returns Existing committed receipt or the newly committed repair receipt.
113
+ * @throws KnowledgeRepairError when actor, source, recovery snapshot or resource preconditions changed.
114
+ * @remarks Terminal retries retain the complete prior stored attempt atomically with a new claim.
115
+ * An active attempt is never stolen and an expired context is never renewed. Already committed
116
+ * effects are not reapplied. Historical outcomes and original repair evidence remain inspectable.
117
+ * @example
118
+ * ```ts
119
+ * const receipt = await resumePreparedKnowledgeRepair(newInvocation, jobId);
120
+ * ```
121
+ */
122
+ export declare function resumePreparedKnowledgeRepair(context: OperationExecutionContext, jobId: string): Promise<KnowledgeRepairReceipt>;
123
+ /**
124
+ * Discover durable repair jobs for one explicit principal without starting an executor.
125
+ * @param context - Captured project, explicit actor and original invocation deadline.
126
+ * @param query - Candidate limit, text-byte cap, lifecycle filter and scoped continuation.
127
+ * @returns Authenticated matching identities, explicit partial diagnostics and last-scanned cursor.
128
+ * @throws KnowledgeRepairError for missing scope or required storage/metadata failures.
129
+ * @remarks Lease claimant labels never establish proposal authority. This page does not
130
+ * verify current effects or load unbounded attempt ledgers; exact inspection arguments
131
+ * expose the retained history. Independent pages are not a multi-page snapshot.
132
+ * @example
133
+ * ```ts
134
+ * const page = await listPreparedKnowledgeRepairs(context, { limit: 20 });
135
+ * ```
136
+ */
137
+ export declare function listPreparedKnowledgeRepairs(context: OperationExecutionContext, query?: KnowledgeRepairInventoryQuery): Promise<KnowledgeRepairInventory>;
138
+ /**
139
+ * Inspect authentic prepared work, its receipt and separate append-only attempt history.
140
+ * @param context - Captured project, explicit original actor and immutable proposal identity.
141
+ * @param jobId - Existing durable operation identity.
142
+ * @param limit - Maximum lifecycle entries, default 100 and bounded to 1000.
143
+ * @param offset - Zero-based ledger page offset, default zero.
144
+ * @returns Actual job state and a page whose completeness is explicit.
145
+ * @throws KnowledgeRepairError when scope, actor, proposal or persisted evidence is inconsistent.
146
+ * @remarks This does not infer a failed outcome from lease expiry or count a cancellation request as rollback.
147
+ * @example
148
+ * ```ts
149
+ * const state = await inspectPreparedKnowledgeRepair(context, jobId, 100, 0);
150
+ * ```
151
+ */
152
+ export declare function inspectPreparedKnowledgeRepair(context: OperationExecutionContext, jobId: string, limit?: number, offset?: number): Promise<KnowledgeRepairInspection>;
153
+ /**
154
+ * Persist an explicit cancellation request under the original invocation budget.
155
+ * @param context - Captured project, explicit actor and immutable proposal identity.
156
+ * @param jobId - Existing prepared work to cancel or signal.
157
+ * @returns Committed request status and actual observed job/receipt state.
158
+ * @throws KnowledgeRepairError when scope or authentic prepared input is invalid.
159
+ * @remarks Running work remains running until its owner acknowledges cancellation; completed
160
+ * effects and receipts are preserved. Cancellation observed after commit cannot erase the request.
161
+ * @example
162
+ * ```ts
163
+ * const cancellation = await cancelPreparedKnowledgeRepair(context, jobId);
164
+ * ```
165
+ */
166
+ export declare function cancelPreparedKnowledgeRepair(context: OperationExecutionContext, jobId: string): Promise<KnowledgeRepairCancellation>;
167
+ /**
168
+ * List accepted sourced repairs without changing retrieval counters.
169
+ * @param projectRoot - Canonical project root containing the repair ledger.
170
+ * @param limit - Maximum receipts read, default 100 and capped at 1000.
171
+ * @returns Repaired receipts that have not been rolled back.
172
+ * @remarks Historical receipts remain stored but cannot reappear as current guidance after rollback.
173
+ * @example
174
+ * ```ts
175
+ * const corrections = await listKnowledgeRepairReceipts(projectRoot, 100);
176
+ * ```
177
+ */
178
+ export declare function listKnowledgeRepairReceipts(projectRoot: string, limit?: number): Promise<KnowledgeRepairReceipt[]>;
179
+ /**
180
+ * Assess project knowledge and optionally apply verified foreground repairs.
181
+ * @param projectRoot - Canonical project identity root; source-root selection stays explicit.
182
+ * @param options - Assessment budget, deterministic fix mode, sourced proposal, or receipt recovery.
183
+ * @returns Separate health dimensions, actionable findings, proposals, and durable repair receipts.
184
+ * @remarks Rollback conservatively checks the entire substantive project state, including unrelated later edits. Automatic repair is capped at 25 confirmed stubs and checked against the maintenance deadline before mutation.
185
+ * @example
186
+ * ```ts
187
+ * const options = { fix: true, dryRun: true };
188
+ * const report = await runKnowledgeDoctor(projectRoot, options);
189
+ * ```
190
+ */
191
+ export declare function runKnowledgeDoctor(projectRoot: string, options?: KnowledgeDoctorOptions): Promise<KnowledgeDoctorResult>;
192
+ //# sourceMappingURL=knowledge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/doctor/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EAErB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAEV,6BAA6B,EAE7B,2BAA2B,EAG3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAE9B,MAAM,sCAAsC,CAAC;AA2K9C;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC;IACxD,sGAAsG;IACtG,QAAQ,CAAC,aAAa,CAAC,EAAE,6BAA6B,CAAC;IACvD;;;;;;OAMG;gBAED,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,6BAA6B,EAC9C,aAAa,CAAC,EAAE,6BAA6B;CAQhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAElF;AAkLD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAsIrC;AA8HD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAqCpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,yBAAyB,EAClC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAoDrC;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AA2CD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,yBAAyB,EAClC,KAAK,GAAE,6BAAkC,GACxC,OAAO,CAAC,wBAAwB,CAAC,CAuGnC;AA+ID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,MAAM,EACb,KAAK,SAAM,EACX,MAAM,SAAI,GACT,OAAO,CAAC,yBAAyB,CAAC,CASpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,2BAA2B,CAAC,CAgCtC;AAwnBD;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,KAAK,SAAM,GACV,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAsBnC;AAkJD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA2ShC"}