clinkx 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (371) hide show
  1. package/CHANGELOG.md +60 -0
  2. package/README.md +17 -8
  3. package/clinkx-workflows/dist/architecture-arena/admission.d.ts +16 -0
  4. package/clinkx-workflows/dist/architecture-arena/admission.js +107 -0
  5. package/clinkx-workflows/dist/architecture-arena/admission.js.map +1 -0
  6. package/clinkx-workflows/dist/architecture-arena/contract.d.ts +1368 -0
  7. package/clinkx-workflows/dist/architecture-arena/contract.js +254 -0
  8. package/clinkx-workflows/dist/architecture-arena/contract.js.map +1 -0
  9. package/clinkx-workflows/dist/architecture-arena/runtime.d.ts +53 -0
  10. package/clinkx-workflows/dist/architecture-arena/runtime.js +511 -0
  11. package/clinkx-workflows/dist/architecture-arena/runtime.js.map +1 -0
  12. package/clinkx-workflows/dist/architecture-comparison/admission.d.ts +17 -1
  13. package/clinkx-workflows/dist/architecture-comparison/admission.js +27 -4
  14. package/clinkx-workflows/dist/architecture-comparison/admission.js.map +1 -1
  15. package/clinkx-workflows/dist/architecture-comparison/contract.d.ts +59 -62
  16. package/clinkx-workflows/dist/architecture-comparison/contract.js +4 -21
  17. package/clinkx-workflows/dist/architecture-comparison/contract.js.map +1 -1
  18. package/clinkx-workflows/dist/architecture-comparison/runtime.d.ts +4 -3
  19. package/clinkx-workflows/dist/architecture-comparison/runtime.js +22 -67
  20. package/clinkx-workflows/dist/architecture-comparison/runtime.js.map +1 -1
  21. package/clinkx-workflows/dist/artifacts.d.ts +19 -4
  22. package/clinkx-workflows/dist/artifacts.js +16 -7
  23. package/clinkx-workflows/dist/artifacts.js.map +1 -1
  24. package/clinkx-workflows/dist/backend.d.ts +30 -0
  25. package/clinkx-workflows/dist/child-env.d.ts +3 -0
  26. package/clinkx-workflows/dist/child-env.js +11 -0
  27. package/clinkx-workflows/dist/child-env.js.map +1 -1
  28. package/clinkx-workflows/dist/clink-client.d.ts +8 -2
  29. package/clinkx-workflows/dist/clink-client.js +4 -2
  30. package/clinkx-workflows/dist/clink-client.js.map +1 -1
  31. package/clinkx-workflows/dist/context-preflight.d.ts +6 -0
  32. package/clinkx-workflows/dist/context-preflight.js.map +1 -1
  33. package/clinkx-workflows/dist/council-execution-policy.d.ts +3 -1
  34. package/clinkx-workflows/dist/council-execution-policy.js +4 -0
  35. package/clinkx-workflows/dist/council-execution-policy.js.map +1 -1
  36. package/clinkx-workflows/dist/dashboard/api-routes.d.ts +21 -0
  37. package/clinkx-workflows/dist/dashboard/api-routes.js +27 -0
  38. package/clinkx-workflows/dist/dashboard/api-routes.js.map +1 -1
  39. package/clinkx-workflows/dist/dashboard/auth/challenge-store.d.ts +13 -0
  40. package/clinkx-workflows/dist/dashboard/auth/challenge-store.js.map +1 -1
  41. package/clinkx-workflows/dist/dashboard/auth/controller.d.ts +27 -0
  42. package/clinkx-workflows/dist/dashboard/auth/controller.js +262 -23
  43. package/clinkx-workflows/dist/dashboard/auth/controller.js.map +1 -1
  44. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.d.ts +62 -0
  45. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js +70 -0
  46. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js.map +1 -0
  47. package/clinkx-workflows/dist/dashboard/contracts.d.ts +586 -586
  48. package/clinkx-workflows/dist/dashboard/progress-report-contract.d.ts +28 -28
  49. package/clinkx-workflows/dist/dashboard/request-admission.d.ts +6 -0
  50. package/clinkx-workflows/dist/dashboard/request-admission.js +9 -0
  51. package/clinkx-workflows/dist/dashboard/request-admission.js.map +1 -1
  52. package/clinkx-workflows/dist/dashboard/server-factory.js +15 -1
  53. package/clinkx-workflows/dist/dashboard/server-factory.js.map +1 -1
  54. package/clinkx-workflows/dist/dashboard/session-log-contract.d.ts +32 -32
  55. package/clinkx-workflows/dist/dashboard/settings-contract.d.ts +1806 -0
  56. package/clinkx-workflows/dist/dashboard/settings-contract.js +630 -0
  57. package/clinkx-workflows/dist/dashboard/settings-contract.js.map +1 -0
  58. package/clinkx-workflows/dist/dashboard/settings-process-reader.d.ts +48 -0
  59. package/clinkx-workflows/dist/dashboard/settings-process-reader.js +195 -0
  60. package/clinkx-workflows/dist/dashboard/settings-process-reader.js.map +1 -0
  61. package/clinkx-workflows/dist/dashboard/settings-routes.d.ts +87 -0
  62. package/clinkx-workflows/dist/dashboard/settings-routes.js +690 -0
  63. package/clinkx-workflows/dist/dashboard/settings-routes.js.map +1 -0
  64. package/clinkx-workflows/dist/dashboard-ui/assets/index-DSOtuS0p.js +122 -0
  65. package/clinkx-workflows/dist/dashboard-ui/assets/style-C5guUjwN.css +1 -0
  66. package/clinkx-workflows/dist/dashboard-ui/index.html +2 -2
  67. package/clinkx-workflows/dist/delegate-signature.d.ts +4 -3
  68. package/clinkx-workflows/dist/delegate-signature.js +4 -3
  69. package/clinkx-workflows/dist/delegate-signature.js.map +1 -1
  70. package/clinkx-workflows/dist/durable-file-core.d.ts +76 -0
  71. package/clinkx-workflows/dist/durable-file-core.js +146 -0
  72. package/clinkx-workflows/dist/durable-file-core.js.map +1 -0
  73. package/clinkx-workflows/dist/durable-file.d.ts +13 -0
  74. package/clinkx-workflows/dist/durable-file.js +22 -0
  75. package/clinkx-workflows/dist/durable-file.js.map +1 -0
  76. package/clinkx-workflows/dist/engine.d.ts +42 -7
  77. package/clinkx-workflows/dist/engine.js +196 -24
  78. package/clinkx-workflows/dist/engine.js.map +1 -1
  79. package/clinkx-workflows/dist/index.js +68 -2
  80. package/clinkx-workflows/dist/index.js.map +1 -1
  81. package/clinkx-workflows/dist/ping-pong/admission.d.ts +127 -0
  82. package/clinkx-workflows/dist/ping-pong/admission.js +522 -0
  83. package/clinkx-workflows/dist/ping-pong/admission.js.map +1 -0
  84. package/clinkx-workflows/dist/ping-pong/contract.d.ts +2539 -0
  85. package/clinkx-workflows/dist/ping-pong/contract.js +819 -0
  86. package/clinkx-workflows/dist/ping-pong/contract.js.map +1 -0
  87. package/clinkx-workflows/dist/ping-pong/control.d.ts +67 -0
  88. package/clinkx-workflows/dist/ping-pong/control.js +12 -0
  89. package/clinkx-workflows/dist/ping-pong/control.js.map +1 -0
  90. package/clinkx-workflows/dist/ping-pong/runtime-handle.d.ts +24 -0
  91. package/clinkx-workflows/dist/ping-pong/runtime-handle.js +55 -0
  92. package/clinkx-workflows/dist/ping-pong/runtime-handle.js.map +1 -0
  93. package/clinkx-workflows/dist/ping-pong/runtime.d.ts +235 -0
  94. package/clinkx-workflows/dist/ping-pong/runtime.js +1183 -0
  95. package/clinkx-workflows/dist/ping-pong/runtime.js.map +1 -0
  96. package/clinkx-workflows/dist/ping-pong/settle.d.ts +57 -0
  97. package/clinkx-workflows/dist/ping-pong/settle.js +58 -0
  98. package/clinkx-workflows/dist/ping-pong/settle.js.map +1 -0
  99. package/clinkx-workflows/dist/ping-pong/sidecar.d.ts +65 -0
  100. package/clinkx-workflows/dist/ping-pong/sidecar.js +138 -0
  101. package/clinkx-workflows/dist/ping-pong/sidecar.js.map +1 -0
  102. package/clinkx-workflows/dist/plan-review/publication.d.ts +2 -1
  103. package/clinkx-workflows/dist/plan-review/publication.js +5 -6
  104. package/clinkx-workflows/dist/plan-review/publication.js.map +1 -1
  105. package/clinkx-workflows/dist/plan-review/snapshot.d.ts +3 -2
  106. package/clinkx-workflows/dist/plan-review/snapshot.js +8 -8
  107. package/clinkx-workflows/dist/plan-review/snapshot.js.map +1 -1
  108. package/clinkx-workflows/dist/recipe-host.d.ts +315 -0
  109. package/clinkx-workflows/dist/recipe-host.js +183 -0
  110. package/clinkx-workflows/dist/recipe-host.js.map +1 -0
  111. package/clinkx-workflows/dist/recipe-seats.d.ts +96 -0
  112. package/clinkx-workflows/dist/recipe-seats.js +163 -0
  113. package/clinkx-workflows/dist/recipe-seats.js.map +1 -0
  114. package/clinkx-workflows/dist/recipe-shared/evidence.d.ts +67 -0
  115. package/clinkx-workflows/dist/recipe-shared/evidence.js +111 -0
  116. package/clinkx-workflows/dist/recipe-shared/evidence.js.map +1 -0
  117. package/clinkx-workflows/dist/reducers/index.d.ts +9 -1
  118. package/clinkx-workflows/dist/reducers/index.js +30 -0
  119. package/clinkx-workflows/dist/reducers/index.js.map +1 -1
  120. package/clinkx-workflows/dist/run-lock-reclaim.d.ts +44 -0
  121. package/clinkx-workflows/dist/run-lock-reclaim.js +86 -0
  122. package/clinkx-workflows/dist/run-lock-reclaim.js.map +1 -0
  123. package/clinkx-workflows/dist/settings/audit.d.ts +101 -0
  124. package/clinkx-workflows/dist/settings/audit.js +318 -0
  125. package/clinkx-workflows/dist/settings/audit.js.map +1 -0
  126. package/clinkx-workflows/dist/settings/bootstrap.d.ts +35 -0
  127. package/clinkx-workflows/dist/settings/bootstrap.js +52 -0
  128. package/clinkx-workflows/dist/settings/bootstrap.js.map +1 -0
  129. package/clinkx-workflows/dist/settings/codec.d.ts +51 -0
  130. package/clinkx-workflows/dist/settings/codec.js +410 -0
  131. package/clinkx-workflows/dist/settings/codec.js.map +1 -0
  132. package/clinkx-workflows/dist/settings/durable-write.d.ts +48 -0
  133. package/clinkx-workflows/dist/settings/durable-write.js +31 -0
  134. package/clinkx-workflows/dist/settings/durable-write.js.map +1 -0
  135. package/clinkx-workflows/dist/settings/index.d.ts +20 -0
  136. package/clinkx-workflows/dist/settings/index.js +23 -0
  137. package/clinkx-workflows/dist/settings/index.js.map +1 -0
  138. package/clinkx-workflows/dist/settings/loader.d.ts +80 -0
  139. package/clinkx-workflows/dist/settings/loader.js +577 -0
  140. package/clinkx-workflows/dist/settings/loader.js.map +1 -0
  141. package/clinkx-workflows/dist/settings/lock.d.ts +108 -0
  142. package/clinkx-workflows/dist/settings/lock.js +344 -0
  143. package/clinkx-workflows/dist/settings/lock.js.map +1 -0
  144. package/clinkx-workflows/dist/settings/paths.d.ts +65 -0
  145. package/clinkx-workflows/dist/settings/paths.js +173 -0
  146. package/clinkx-workflows/dist/settings/paths.js.map +1 -0
  147. package/clinkx-workflows/dist/settings/process-heartbeat.d.ts +47 -0
  148. package/clinkx-workflows/dist/settings/process-heartbeat.js +305 -0
  149. package/clinkx-workflows/dist/settings/process-heartbeat.js.map +1 -0
  150. package/clinkx-workflows/dist/settings/registry.d.ts +178 -0
  151. package/clinkx-workflows/dist/settings/registry.js +1285 -0
  152. package/clinkx-workflows/dist/settings/registry.js.map +1 -0
  153. package/clinkx-workflows/dist/settings/schema.d.ts +404 -0
  154. package/clinkx-workflows/dist/settings/schema.js +415 -0
  155. package/clinkx-workflows/dist/settings/schema.js.map +1 -0
  156. package/clinkx-workflows/dist/settings/store.d.ts +157 -0
  157. package/clinkx-workflows/dist/settings/store.js +842 -0
  158. package/clinkx-workflows/dist/settings/store.js.map +1 -0
  159. package/clinkx-workflows/dist/state-schema.d.ts +11 -0
  160. package/clinkx-workflows/dist/state-schema.js +4 -1
  161. package/clinkx-workflows/dist/state-schema.js.map +1 -1
  162. package/clinkx-workflows/dist/state.d.ts +178 -3
  163. package/clinkx-workflows/dist/state.js +618 -83
  164. package/clinkx-workflows/dist/state.js.map +1 -1
  165. package/clinkx-workflows/dist/stdio-entry.d.ts +2 -0
  166. package/clinkx-workflows/dist/stdio-entry.js +52 -0
  167. package/clinkx-workflows/dist/stdio-entry.js.map +1 -0
  168. package/clinkx-workflows/dist/transport.d.ts +2 -1
  169. package/clinkx-workflows/dist/transport.js +5 -0
  170. package/clinkx-workflows/dist/transport.js.map +1 -1
  171. package/clinkx-workflows/dist/validators/architecture-arena.d.ts +6 -0
  172. package/clinkx-workflows/dist/validators/architecture-arena.js +16 -0
  173. package/clinkx-workflows/dist/validators/architecture-arena.js.map +1 -0
  174. package/clinkx-workflows/dist/validators/index.js +4 -0
  175. package/clinkx-workflows/dist/validators/index.js.map +1 -1
  176. package/clinkx-workflows/dist/validators/ping-pong.d.ts +6 -0
  177. package/clinkx-workflows/dist/validators/ping-pong.js +10 -0
  178. package/clinkx-workflows/dist/validators/ping-pong.js.map +1 -0
  179. package/clinkx-workflows/dist/workflow-tools.d.ts +51 -5
  180. package/clinkx-workflows/dist/workflow-tools.js +785 -34
  181. package/clinkx-workflows/dist/workflow-tools.js.map +1 -1
  182. package/clinkx-workflows/dist/workflow-verification-contract.d.ts +4 -4
  183. package/clinkx-workflows/templates/architecture-arena/candidate.txt +39 -0
  184. package/clinkx-workflows/templates/architecture-arena/judge.txt +34 -0
  185. package/clinkx-workflows/templates/ping-pong/implement.txt +14 -0
  186. package/clinkx-workflows/templates/ping-pong/remediate.txt +14 -0
  187. package/clinkx-workflows/templates/ping-pong/review.txt +27 -0
  188. package/clinkx-workflows/workflows/architecture-arena.yaml +127 -0
  189. package/clinkx-workflows/workflows/ping-pong.yaml +158 -0
  190. package/dist/context-builder/bundle.js +4 -3
  191. package/dist/context-builder/bundle.js.map +1 -1
  192. package/dist/context-builder/delegate-packet.d.ts +1 -0
  193. package/dist/context-builder/delegate-packet.js +66 -7
  194. package/dist/context-builder/delegate-packet.js.map +1 -1
  195. package/dist/context-builder/delegate-validation.d.ts +12 -3
  196. package/dist/context-builder/delegate-validation.js +23 -13
  197. package/dist/context-builder/delegate-validation.js.map +1 -1
  198. package/dist/context-builder/external-gaps.d.ts +14 -3
  199. package/dist/context-builder/external-gaps.js +124 -18
  200. package/dist/context-builder/external-gaps.js.map +1 -1
  201. package/dist/context-builder/handler.js +108 -191
  202. package/dist/context-builder/handler.js.map +1 -1
  203. package/dist/context-builder/review-coverage.js +27 -1
  204. package/dist/context-builder/review-coverage.js.map +1 -1
  205. package/dist/context-builder/secrets.js +1 -1
  206. package/dist/context-builder/secrets.js.map +1 -1
  207. package/dist/context-builder/versions.d.ts +10 -4
  208. package/dist/context-builder/versions.js +10 -4
  209. package/dist/context-builder/versions.js.map +1 -1
  210. package/dist/context-builder/workflow-runner.js +33 -24
  211. package/dist/context-builder/workflow-runner.js.map +1 -1
  212. package/dist/dashboard-cli.d.ts +2 -0
  213. package/dist/dashboard-cli.js +197 -58
  214. package/dist/dashboard-cli.js.map +1 -1
  215. package/dist/dashboard-companion/client.d.ts +10 -0
  216. package/dist/dashboard-companion/client.js +43 -1
  217. package/dist/dashboard-companion/client.js.map +1 -1
  218. package/dist/dashboard-companion/config.d.ts +19 -1
  219. package/dist/dashboard-companion/config.js +104 -3
  220. package/dist/dashboard-companion/config.js.map +1 -1
  221. package/dist/dashboard-companion/protocol.d.ts +16 -0
  222. package/dist/dashboard-companion/protocol.js +55 -1
  223. package/dist/dashboard-companion/protocol.js.map +1 -1
  224. package/dist/dashboard-companion/workstation-binding.d.ts +69 -0
  225. package/dist/dashboard-companion/workstation-binding.js +192 -0
  226. package/dist/dashboard-companion/workstation-binding.js.map +1 -0
  227. package/dist/dashboard-gateway/admin-cli.d.ts +10 -0
  228. package/dist/dashboard-gateway/admin-cli.js +266 -0
  229. package/dist/dashboard-gateway/admin-cli.js.map +1 -0
  230. package/dist/dashboard-gateway/config.d.ts +50 -0
  231. package/dist/dashboard-gateway/config.js +235 -1
  232. package/dist/dashboard-gateway/config.js.map +1 -1
  233. package/dist/dashboard-gateway/connection-registry.d.ts +100 -0
  234. package/dist/dashboard-gateway/connection-registry.js +228 -0
  235. package/dist/dashboard-gateway/connection-registry.js.map +1 -0
  236. package/dist/dashboard-gateway/control-plane/account-auth.d.ts +78 -0
  237. package/dist/dashboard-gateway/control-plane/account-auth.js +198 -0
  238. package/dist/dashboard-gateway/control-plane/account-auth.js.map +1 -0
  239. package/dist/dashboard-gateway/control-plane/billing.d.ts +264 -0
  240. package/dist/dashboard-gateway/control-plane/billing.js +787 -0
  241. package/dist/dashboard-gateway/control-plane/billing.js.map +1 -0
  242. package/dist/dashboard-gateway/control-plane/contracts.d.ts +1293 -0
  243. package/dist/dashboard-gateway/control-plane/contracts.js +280 -0
  244. package/dist/dashboard-gateway/control-plane/contracts.js.map +1 -0
  245. package/dist/dashboard-gateway/control-plane/cookies.d.ts +13 -0
  246. package/dist/dashboard-gateway/control-plane/cookies.js +46 -0
  247. package/dist/dashboard-gateway/control-plane/cookies.js.map +1 -0
  248. package/dist/dashboard-gateway/control-plane/credentials.d.ts +63 -0
  249. package/dist/dashboard-gateway/control-plane/credentials.js +66 -0
  250. package/dist/dashboard-gateway/control-plane/credentials.js.map +1 -0
  251. package/dist/dashboard-gateway/control-plane/entitlements.d.ts +118 -0
  252. package/dist/dashboard-gateway/control-plane/entitlements.js +329 -0
  253. package/dist/dashboard-gateway/control-plane/entitlements.js.map +1 -0
  254. package/dist/dashboard-gateway/control-plane/errors.d.ts +17 -0
  255. package/dist/dashboard-gateway/control-plane/errors.js +23 -0
  256. package/dist/dashboard-gateway/control-plane/errors.js.map +1 -0
  257. package/dist/dashboard-gateway/control-plane/hosts.d.ts +6 -0
  258. package/dist/dashboard-gateway/control-plane/hosts.js +16 -0
  259. package/dist/dashboard-gateway/control-plane/hosts.js.map +1 -0
  260. package/dist/dashboard-gateway/control-plane/http.d.ts +34 -0
  261. package/dist/dashboard-gateway/control-plane/http.js +331 -0
  262. package/dist/dashboard-gateway/control-plane/http.js.map +1 -0
  263. package/dist/dashboard-gateway/control-plane/schema.d.ts +9 -0
  264. package/dist/dashboard-gateway/control-plane/schema.js +247 -0
  265. package/dist/dashboard-gateway/control-plane/schema.js.map +1 -0
  266. package/dist/dashboard-gateway/control-plane/secrets.d.ts +20 -0
  267. package/dist/dashboard-gateway/control-plane/secrets.js +39 -0
  268. package/dist/dashboard-gateway/control-plane/secrets.js.map +1 -0
  269. package/dist/dashboard-gateway/control-plane/store.d.ts +579 -0
  270. package/dist/dashboard-gateway/control-plane/store.js +1115 -0
  271. package/dist/dashboard-gateway/control-plane/store.js.map +1 -0
  272. package/dist/dashboard-gateway/cookie-boundary.d.ts +60 -0
  273. package/dist/dashboard-gateway/cookie-boundary.js +205 -0
  274. package/dist/dashboard-gateway/cookie-boundary.js.map +1 -0
  275. package/dist/dashboard-gateway/index.js +271 -494
  276. package/dist/dashboard-gateway/index.js.map +1 -1
  277. package/dist/dashboard-gateway/main.js +7 -2
  278. package/dist/dashboard-gateway/main.js.map +1 -1
  279. package/dist/dashboard-gateway/routing.d.ts +43 -0
  280. package/dist/dashboard-gateway/routing.js +65 -0
  281. package/dist/dashboard-gateway/routing.js.map +1 -0
  282. package/dist/dashboard-gateway/tenant-gateway.d.ts +56 -0
  283. package/dist/dashboard-gateway/tenant-gateway.js +989 -0
  284. package/dist/dashboard-gateway/tenant-gateway.js.map +1 -0
  285. package/dist/dashboard-gateway/tenant-main.d.ts +41 -0
  286. package/dist/dashboard-gateway/tenant-main.js +303 -0
  287. package/dist/dashboard-gateway/tenant-main.js.map +1 -0
  288. package/dist/dashboard-gateway/tunnel-errors.d.ts +16 -0
  289. package/dist/dashboard-gateway/tunnel-errors.js +22 -0
  290. package/dist/dashboard-gateway/tunnel-errors.js.map +1 -0
  291. package/dist/dashboard-gateway/tunnel-http.d.ts +21 -0
  292. package/dist/dashboard-gateway/tunnel-http.js +195 -0
  293. package/dist/dashboard-gateway/tunnel-http.js.map +1 -0
  294. package/dist/elaris/config.d.ts +10 -0
  295. package/dist/elaris/config.js +27 -1
  296. package/dist/elaris/config.js.map +1 -1
  297. package/dist/elaris/tools.js +4 -1
  298. package/dist/elaris/tools.js.map +1 -1
  299. package/dist/handler.d.ts +6 -0
  300. package/dist/handler.js +17 -1
  301. package/dist/handler.js.map +1 -1
  302. package/dist/index.d.ts +0 -31
  303. package/dist/index.js +41 -404
  304. package/dist/index.js.map +1 -1
  305. package/dist/lib.d.ts +17 -0
  306. package/dist/lib.js +17 -0
  307. package/dist/lib.js.map +1 -0
  308. package/dist/local-clink-backend.d.ts +2 -1
  309. package/dist/local-clink-backend.js +28 -4
  310. package/dist/local-clink-backend.js.map +1 -1
  311. package/dist/parsers/extract.d.ts +19 -1
  312. package/dist/parsers/extract.js +68 -3
  313. package/dist/parsers/extract.js.map +1 -1
  314. package/dist/pipeline.d.ts +17 -1
  315. package/dist/pipeline.js +34 -6
  316. package/dist/pipeline.js.map +1 -1
  317. package/dist/process-group.d.ts +65 -0
  318. package/dist/process-group.js +153 -0
  319. package/dist/process-group.js.map +1 -0
  320. package/dist/progress-report/lock.d.ts +17 -59
  321. package/dist/progress-report/lock.js +25 -329
  322. package/dist/progress-report/lock.js.map +1 -1
  323. package/dist/progress-report/schema.d.ts +23 -23
  324. package/dist/project-verification/files.js +1 -1
  325. package/dist/project-verification/files.js.map +1 -1
  326. package/dist/project-verification/process.js +23 -44
  327. package/dist/project-verification/process.js.map +1 -1
  328. package/dist/project-verification/service.js +9 -1
  329. package/dist/project-verification/service.js.map +1 -1
  330. package/dist/prompt.d.ts +7 -0
  331. package/dist/prompt.js +18 -1
  332. package/dist/prompt.js.map +1 -1
  333. package/dist/recipe-host/git-trust.d.ts +43 -0
  334. package/dist/recipe-host/git-trust.js +360 -0
  335. package/dist/recipe-host/git-trust.js.map +1 -0
  336. package/dist/recipe-host/git.d.ts +42 -0
  337. package/dist/recipe-host/git.js +207 -0
  338. package/dist/recipe-host/git.js.map +1 -0
  339. package/dist/recipe-host/native-recipe-host.d.ts +127 -0
  340. package/dist/recipe-host/native-recipe-host.js +880 -0
  341. package/dist/recipe-host/native-recipe-host.js.map +1 -0
  342. package/dist/recipe-host/seat-cwd.d.ts +16 -0
  343. package/dist/recipe-host/seat-cwd.js +170 -0
  344. package/dist/recipe-host/seat-cwd.js.map +1 -0
  345. package/dist/runner.d.ts +43 -1
  346. package/dist/runner.js +234 -35
  347. package/dist/runner.js.map +1 -1
  348. package/dist/server.js +84 -5
  349. package/dist/server.js.map +1 -1
  350. package/dist/settings-cli/clients.d.ts +137 -0
  351. package/dist/settings-cli/clients.js +1124 -0
  352. package/dist/settings-cli/clients.js.map +1 -0
  353. package/dist/settings-cli/commands.d.ts +67 -0
  354. package/dist/settings-cli/commands.js +726 -0
  355. package/dist/settings-cli/commands.js.map +1 -0
  356. package/dist/settings-cli/format.d.ts +34 -0
  357. package/dist/settings-cli/format.js +40 -0
  358. package/dist/settings-cli/format.js.map +1 -0
  359. package/dist/settings-cli/main.d.ts +18 -0
  360. package/dist/settings-cli/main.js +256 -0
  361. package/dist/settings-cli/main.js.map +1 -0
  362. package/dist/stdio-main.d.ts +73 -0
  363. package/dist/stdio-main.js +455 -0
  364. package/dist/stdio-main.js.map +1 -0
  365. package/docs/configuration.md +362 -40
  366. package/docs/engineering-recipes.md +291 -0
  367. package/docs/security.md +234 -6
  368. package/docs/verification/project-checks.md +24 -2
  369. package/package.json +6 -2
  370. package/clinkx-workflows/dist/dashboard-ui/assets/index-BdpmbPps.js +0 -115
  371. package/clinkx-workflows/dist/dashboard-ui/assets/style-Im5i1iAs.css +0 -1
@@ -0,0 +1,415 @@
1
+ /**
2
+ * Settings disk-document schemas — S0-1 freeze point.
3
+ *
4
+ * Four versioned documents (snake_case on disk, matching the existing
5
+ * sidecar conventions like clinkx-roster-v1):
6
+ * - `clinkx-settings-v1` the settings document (values per registry key)
7
+ * - `clinkx-settings-secrets-v1` the 0600 secrets document (separate file,
8
+ * separate revision, never inside the settings
9
+ * document, TASKS amendment 3)
10
+ * - `clinkx-settings-process-v1` per-process "loaded settings revision +
11
+ * provenance" heartbeat (coordinator decision 8)
12
+ * - `clinkx-settings-audit-v1` one audit-log line per policy/secret save
13
+ *
14
+ * Parsing rules (owner decision 7, OQ-2):
15
+ * - Known keys are strict: a known key with an invalid value is a per-key
16
+ * error, not a document rejection.
17
+ * - Unknown keys produce warnings, never errors (mixed code versions share
18
+ * one file).
19
+ * - A schema_version other than v1 parses as "unsupported".
20
+ *
21
+ * Only zod + the registry + the codec (all inside src/settings/); safe for
22
+ * the pre-logger bootstrap import closure.
23
+ */
24
+ import { z } from "zod";
25
+ import { validateSettingValue } from "./codec.js";
26
+ import { getSettingDescriptor, isSecretSettingKey } from "./registry.js";
27
+ // ---------------------------------------------------------------------------
28
+ // Shared primitives
29
+ // ---------------------------------------------------------------------------
30
+ export const SETTINGS_DOCUMENT_SCHEMA_VERSION = "clinkx-settings-v1";
31
+ export const SECRETS_DOCUMENT_SCHEMA_VERSION = "clinkx-settings-secrets-v1";
32
+ export const PROCESS_HEARTBEAT_SCHEMA_VERSION = "clinkx-settings-process-v1";
33
+ export const AUDIT_ENTRY_SCHEMA_VERSION = "clinkx-settings-audit-v1";
34
+ const TimestampSchema = z.string().datetime({ offset: true });
35
+ export const SettingsActorSchema = z.enum(["dashboard", "cli", "system"]);
36
+ export const SettingsAuthSchema = z.enum(["passkey", "bearer", "none", "local-fs"]);
37
+ export const SettingsUpdatedBySchema = z
38
+ .object({
39
+ actor: SettingsActorSchema,
40
+ auth: SettingsAuthSchema,
41
+ })
42
+ .strict();
43
+ // ---------------------------------------------------------------------------
44
+ // clinkx-settings-v1 (settings document)
45
+ // ---------------------------------------------------------------------------
46
+ const SettingsEnvelopeSchema = z
47
+ .object({
48
+ schema_version: z.string(),
49
+ revision: z.number().int().min(1),
50
+ updated_at: TimestampSchema,
51
+ updated_by: SettingsUpdatedBySchema,
52
+ values: z.record(z.string(), z.unknown()),
53
+ })
54
+ .strict();
55
+ /**
56
+ * Parse a settings document payload (already JSON-decoded).
57
+ *
58
+ * The payload's `values` record is NOT schema-validated here — the codec owns
59
+ * per-key validation against the registry — this function splits known keys
60
+ * (validated via `validateValue`, injected to keep schema.ts zod-only),
61
+ * unknown keys (warnings) and reports per-key errors without rejecting the
62
+ * whole document.
63
+ */
64
+ export function parseSettingsDocument(input, validateValue) {
65
+ const envelope = SettingsEnvelopeSchema.safeParse(input);
66
+ if (!envelope.success) {
67
+ return {
68
+ status: "invalid",
69
+ reason: "shape",
70
+ issues: envelope.error.issues.map((issue) => ({
71
+ key: issue.path.join(".") || "(document)",
72
+ error: issue.message,
73
+ })),
74
+ warnings: [],
75
+ unknownKeys: [],
76
+ };
77
+ }
78
+ if (envelope.data.schema_version !== SETTINGS_DOCUMENT_SCHEMA_VERSION) {
79
+ return {
80
+ status: "unsupported",
81
+ found: envelope.data.schema_version,
82
+ supported: SETTINGS_DOCUMENT_SCHEMA_VERSION,
83
+ };
84
+ }
85
+ const warnings = [];
86
+ const unknownKeys = [];
87
+ const issues = [];
88
+ const values = {};
89
+ for (const [key, value] of Object.entries(envelope.data.values)) {
90
+ // Own-property lookup only: prototype-shaped names ("__proto__",
91
+ // "constructor") resolve no descriptor and fall through to unknown (S1).
92
+ const descriptor = getSettingDescriptor(key);
93
+ if (descriptor == null) {
94
+ unknownKeys.push(key);
95
+ warnings.push({
96
+ key,
97
+ message: `unknown settings key ${key} ignored (written by a newer ClinkX?)`,
98
+ });
99
+ continue;
100
+ }
101
+ const error = validateValue(key, value);
102
+ if (error != null) {
103
+ issues.push({ key, error });
104
+ continue;
105
+ }
106
+ values[key] = value;
107
+ }
108
+ if (issues.length > 0) {
109
+ return { status: "invalid", reason: "values", issues, warnings, unknownKeys };
110
+ }
111
+ return {
112
+ status: "ok",
113
+ document: {
114
+ schema_version: SETTINGS_DOCUMENT_SCHEMA_VERSION,
115
+ revision: envelope.data.revision,
116
+ updated_at: envelope.data.updated_at,
117
+ updated_by: envelope.data.updated_by,
118
+ values,
119
+ },
120
+ warnings,
121
+ unknownKeys,
122
+ };
123
+ }
124
+ function nullProtoRecord() {
125
+ return Object.create(null);
126
+ }
127
+ /**
128
+ * Classify a settings document per key (S1/S2/P5, the one shared classifier
129
+ * for the loader and the store).
130
+ *
131
+ * Reads `values` OWN entries from the caller's original `JSON.parse` result —
132
+ * never from a zod-rebuilt record, whose construction re-parents a
133
+ * `"__proto__"` own entry onto the rebuilt object's prototype. Every record
134
+ * returned is null-prototype, so a `__proto__` key that arrived via
135
+ * `JSON.parse` stays an UNKNOWN raw entry: it is copied by name, never
136
+ * dereferenced, and can never re-parent anything.
137
+ *
138
+ * Per-key tolerance: an invalid known value lands in `invalid` and does not
139
+ * change `status`; secret-class keys are reported by name only (their values
140
+ * never enter `valid`); unknown keys keep their verbatim value in both
141
+ * `unknownRaw` and `raw`.
142
+ */
143
+ export function classifySettingsDocument(parsed) {
144
+ const envelope = SettingsEnvelopeSchema.safeParse(parsed);
145
+ if (!envelope.success) {
146
+ return {
147
+ status: "shape_invalid",
148
+ revision: 0,
149
+ updated_at: "",
150
+ updated_by: null,
151
+ valid: nullProtoRecord(),
152
+ invalid: new Map(),
153
+ unknownRaw: nullProtoRecord(),
154
+ secretClassKeys: [],
155
+ raw: nullProtoRecord(),
156
+ };
157
+ }
158
+ // Scalars are safe from zod's rebuild (a `values` record is not); the
159
+ // values record itself must be read from the original parse.
160
+ const { revision, updated_at, updated_by } = envelope.data;
161
+ if (envelope.data.schema_version !== SETTINGS_DOCUMENT_SCHEMA_VERSION) {
162
+ return {
163
+ status: "unsupported",
164
+ revision,
165
+ updated_at,
166
+ updated_by,
167
+ valid: nullProtoRecord(),
168
+ invalid: new Map(),
169
+ unknownRaw: nullProtoRecord(),
170
+ secretClassKeys: [],
171
+ raw: nullProtoRecord(),
172
+ };
173
+ }
174
+ const valid = nullProtoRecord();
175
+ const invalid = new Map();
176
+ const unknownRaw = nullProtoRecord();
177
+ const secretClassKeys = [];
178
+ const raw = nullProtoRecord();
179
+ const valuesSource = parsed.values;
180
+ for (const [key, value] of Object.entries(valuesSource)) {
181
+ raw[key] = value;
182
+ const descriptor = getSettingDescriptor(key);
183
+ if (descriptor == null) {
184
+ unknownRaw[key] = value;
185
+ continue;
186
+ }
187
+ if (descriptor.class === "secret") {
188
+ // Name only: a secret-class key inside settings.json is a writer bug;
189
+ // its value must never reach the loader overlay or a save base (S2).
190
+ secretClassKeys.push(key);
191
+ continue;
192
+ }
193
+ const error = validateSettingValue(descriptor, value);
194
+ if (error !== undefined) {
195
+ invalid.set(key, error);
196
+ continue;
197
+ }
198
+ valid[key] = value;
199
+ }
200
+ return {
201
+ status: "ok",
202
+ revision,
203
+ updated_at,
204
+ updated_by,
205
+ valid,
206
+ invalid,
207
+ unknownRaw,
208
+ secretClassKeys,
209
+ raw,
210
+ };
211
+ }
212
+ // ---------------------------------------------------------------------------
213
+ // clinkx-settings-secrets-v1 (secrets document)
214
+ // ---------------------------------------------------------------------------
215
+ const SecretsEnvelopeSchema = z
216
+ .object({
217
+ schema_version: z.string(),
218
+ revision: z.number().int().min(1),
219
+ updated_at: TimestampSchema,
220
+ entries: z.record(z.string(), z.object({ value: z.string(), updated_at: TimestampSchema }).strict()),
221
+ })
222
+ .strict();
223
+ export function parseSecretsDocument(input) {
224
+ const envelope = SecretsEnvelopeSchema.safeParse(input);
225
+ if (!envelope.success) {
226
+ return {
227
+ status: "invalid",
228
+ reason: "shape",
229
+ issues: envelope.error.issues.map((issue) => ({
230
+ key: issue.path.join(".") || "(document)",
231
+ error: issue.message,
232
+ })),
233
+ warnings: [],
234
+ unknownKeys: [],
235
+ };
236
+ }
237
+ if (envelope.data.schema_version !== SECRETS_DOCUMENT_SCHEMA_VERSION) {
238
+ return {
239
+ status: "unsupported",
240
+ found: envelope.data.schema_version,
241
+ supported: SECRETS_DOCUMENT_SCHEMA_VERSION,
242
+ };
243
+ }
244
+ const warnings = [];
245
+ const unknownKeys = [];
246
+ const issues = [];
247
+ const entries = {};
248
+ for (const [key, entry] of Object.entries(envelope.data.entries)) {
249
+ if (!isSecretSettingKey(key)) {
250
+ // A non-secret registry key (or a plain unknown name) inside the
251
+ // secrets file is a writer bug, not a forward-compat case.
252
+ issues.push({
253
+ key,
254
+ error: `${key} is not a secret-class settings key`,
255
+ });
256
+ continue;
257
+ }
258
+ if (entry.value.trim() === "") {
259
+ issues.push({ key, error: "secret value must be non-empty" });
260
+ continue;
261
+ }
262
+ entries[key] = entry;
263
+ }
264
+ if (issues.length > 0) {
265
+ return { status: "invalid", reason: "keys", issues, warnings, unknownKeys };
266
+ }
267
+ return {
268
+ status: "ok",
269
+ document: {
270
+ schema_version: SECRETS_DOCUMENT_SCHEMA_VERSION,
271
+ revision: envelope.data.revision,
272
+ updated_at: envelope.data.updated_at,
273
+ entries,
274
+ },
275
+ warnings,
276
+ unknownKeys,
277
+ };
278
+ }
279
+ // ---------------------------------------------------------------------------
280
+ // clinkx-settings-process-v1 (per-process heartbeat)
281
+ // ---------------------------------------------------------------------------
282
+ export const ProcessHeartbeatEntrySchema = z.enum([
283
+ "root",
284
+ "workflows-standalone",
285
+ "dashboard",
286
+ "companion",
287
+ "gateway",
288
+ "static-ui",
289
+ "other",
290
+ ]);
291
+ export const ProcessHeartbeatSettingsStateSchema = z.enum([
292
+ "off",
293
+ "absent",
294
+ "loaded",
295
+ "unreadable",
296
+ ]);
297
+ /**
298
+ * Provenance source (S0-1 addendum):
299
+ * - `env`: explicit env (incl. empty-value and legacy-alias env presence) won
300
+ * - `file`: a valid file value was filled
301
+ * - `default`: neither env nor file carried a usable value
302
+ * - `invalid_fallback`: the file carried a value but it was invalid, so the
303
+ * registry-declared onInvalid policy applied (restrictive fill or default)
304
+ */
305
+ export const ProcessHeartbeatProvenanceSourceSchema = z.enum([
306
+ "env",
307
+ "file",
308
+ "default",
309
+ "invalid_fallback",
310
+ ]);
311
+ export const ProcessHeartbeatProvenanceEntrySchema = z
312
+ .object({
313
+ source: ProcessHeartbeatProvenanceSourceSchema,
314
+ effective: z.string().optional(),
315
+ /** True when env and the file carry the same effective value (harmless shadow). */
316
+ env_equals_file: z.boolean().optional(),
317
+ })
318
+ .strict();
319
+ /** Bounds shared by the heartbeat disk document and the processes WIRE response. */
320
+ export const MAX_PROCESS_HEARTBEAT_UNKNOWN_ENV_KEYS = 64;
321
+ export const MAX_PROCESS_HEARTBEAT_WARNINGS = 32;
322
+ export const MAX_PROCESS_HEARTBEAT_WARNING_CHARS = 300;
323
+ /** Random per-boot nonce (32 hex chars) — distinguishes same-pid processes. */
324
+ export const PROCESS_HEARTBEAT_BOOT_NONCE_PATTERN = /^[0-9a-f]{32}$/;
325
+ export const ProcessHeartbeatV1Schema = z
326
+ .object({
327
+ schema_version: z.literal(PROCESS_HEARTBEAT_SCHEMA_VERSION),
328
+ pid: z.number().int().min(1),
329
+ hostname: z.string().min(1).max(255),
330
+ entry: ProcessHeartbeatEntrySchema,
331
+ version: z.string().min(1).max(64),
332
+ started_at: TimestampSchema,
333
+ heartbeat_at: TimestampSchema,
334
+ /** Random 128-bit hex; two processes with the same pid are distinguishable. */
335
+ boot_nonce: z.string().regex(PROCESS_HEARTBEAT_BOOT_NONCE_PATTERN),
336
+ settings: z
337
+ .object({
338
+ state: ProcessHeartbeatSettingsStateSchema,
339
+ revision: z.number().int().min(1).optional(),
340
+ digest: z
341
+ .string()
342
+ .regex(/^[0-9a-f]{64}$/)
343
+ .optional(),
344
+ /**
345
+ * Secrets-document revision this process loaded; null when none was
346
+ * read (T09 freshness rule). Optional so pre-W3 heartbeats (which
347
+ * never carry it) still parse — the dashboard reports their freshness
348
+ * as unknown rather than skipping the row.
349
+ */
350
+ secrets_revision: z.number().int().min(1).nullable().optional(),
351
+ })
352
+ .strict(),
353
+ provenance: z.record(z.string(), ProcessHeartbeatProvenanceEntrySchema),
354
+ /** Unclassified CLINKX_* names present in this process's env (names only). */
355
+ unknown_env_keys: z
356
+ .array(z.string())
357
+ .max(MAX_PROCESS_HEARTBEAT_UNKNOWN_ENV_KEYS),
358
+ /** Sanitized diagnostics; never secret or env values. */
359
+ warnings: z
360
+ .array(z.string().min(1).max(MAX_PROCESS_HEARTBEAT_WARNING_CHARS))
361
+ .max(MAX_PROCESS_HEARTBEAT_WARNINGS),
362
+ })
363
+ .strict()
364
+ .superRefine((doc, ctx) => {
365
+ for (const key of Object.keys(doc.provenance)) {
366
+ if (isSecretSettingKey(key)) {
367
+ const entry = doc.provenance[key];
368
+ if (entry != null && entry.effective != null) {
369
+ ctx.addIssue({
370
+ code: z.ZodIssueCode.custom,
371
+ path: ["provenance", key, "effective"],
372
+ message: "secret-class keys must not carry an effective value",
373
+ });
374
+ }
375
+ }
376
+ }
377
+ });
378
+ // ---------------------------------------------------------------------------
379
+ // clinkx-settings-audit-v1 (audit line)
380
+ // ---------------------------------------------------------------------------
381
+ /**
382
+ * One audit line exactly as `audit.ts` renders it. The shape is structural
383
+ * redaction: it carries key NAMES, classes and revisions only, so no value
384
+ * (secret or otherwise) can ever be represented in it. `digestAfter` is
385
+ * omitted for `save_secrets` (the secrets document is never hashed);
386
+ * `keysOmitted` appears only when the 4 KiB line cap dropped trailing keys.
387
+ * `outcome:"pending"` is the pre-publication line the store appends before it
388
+ * publishes, so a crash between the two leaves a durable marker (T05 order).
389
+ */
390
+ export const SettingsAuditEntryV1Schema = z
391
+ .object({
392
+ schema_version: z.literal(AUDIT_ENTRY_SCHEMA_VERSION),
393
+ at: TimestampSchema,
394
+ actor: SettingsActorSchema,
395
+ auth: SettingsAuthSchema,
396
+ keys: z.array(z.string().min(1).max(64)).max(64),
397
+ classes: z.array(z.string().min(1).max(32)).max(8),
398
+ action: z.enum(["save", "recover", "save_secrets"]),
399
+ revisionBefore: z.number().int().min(0),
400
+ revisionAfter: z.number().int().min(1),
401
+ digestAfter: z.string().regex(/^[0-9a-f]{64}$/).optional(),
402
+ outcome: z.enum(["pending", "ok", "published_uncertain"]),
403
+ keysOmitted: z.number().int().min(1).optional(),
404
+ })
405
+ .strict()
406
+ .superRefine((entry, ctx) => {
407
+ if (entry.action === "save_secrets" && entry.digestAfter != null) {
408
+ ctx.addIssue({
409
+ code: z.ZodIssueCode.custom,
410
+ path: ["digestAfter"],
411
+ message: "save_secrets audit lines never carry a digest",
412
+ });
413
+ }
414
+ });
415
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/settings/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,157 @@
1
+ import { type SettingValue } from "./registry.js";
2
+ import { type SettingsActor, type SettingsAuth } from "./schema.js";
3
+ import { type DurableWriter } from "./durable-write.js";
4
+ import { type SettingsLockDeps } from "./lock.js";
5
+ import { SettingsAuditLog, type SettingsAuditOutcome } from "./audit.js";
6
+ export declare const SETTINGS_DOCUMENT_FILENAME = "settings.json";
7
+ export declare const SECRETS_DOCUMENT_FILENAME = "secrets.json";
8
+ /** Settings documents are world-readable (the dashboard container reads them as another user); secrets never are. */
9
+ export declare const SETTINGS_DIR_MODE = 448;
10
+ export declare const SETTINGS_DOCUMENT_MODE = 420;
11
+ export declare const SECRETS_DOCUMENT_MODE = 384;
12
+ /** Parity with the wire contract's MAX_SETTINGS_OPS_PER_SAVE / MAX_SETTINGS_SECRET_CHARS. */
13
+ export declare const MAX_OPS_PER_SAVE = 64;
14
+ export declare const MAX_SECRET_VALUE_CHARS = 4096;
15
+ export type SettingsStoreErrorCode = "settings_conflict" | "settings_locked" | "settings_unreadable" | "settings_invalid" | "settings_unavailable";
16
+ export interface SettingsFieldError {
17
+ readonly key: string;
18
+ readonly message: string;
19
+ }
20
+ export declare class SettingsStoreError extends Error {
21
+ readonly code: SettingsStoreErrorCode;
22
+ readonly status: number;
23
+ readonly fieldErrors: readonly SettingsFieldError[] | undefined;
24
+ /** Current document revision, on a CAS conflict, so the caller can retry. */
25
+ readonly expectedRevision: number | undefined;
26
+ /**
27
+ * Digest of the current (unreadable) settings bytes. Secret documents never
28
+ * expose a digest, so this is only ever set for the settings document.
29
+ */
30
+ readonly digest: string | undefined;
31
+ constructor(code: SettingsStoreErrorCode, message: string, details?: {
32
+ readonly fieldErrors?: readonly SettingsFieldError[];
33
+ readonly expectedRevision?: number;
34
+ readonly digest?: string;
35
+ });
36
+ }
37
+ export interface SettingsStoreOp {
38
+ readonly key: string;
39
+ readonly action: "set" | "unset";
40
+ /** Required for `set`; forbidden for `unset`. A secret value is a non-empty string. */
41
+ readonly value?: SettingValue;
42
+ }
43
+ export interface SettingsSaveInput {
44
+ readonly expectedRevision: number;
45
+ readonly ops: readonly SettingsStoreOp[];
46
+ readonly actor: SettingsActor;
47
+ readonly auth: SettingsAuth;
48
+ /** Recover from an unreadable document (requires `expectedDigest`). */
49
+ readonly recover?: boolean;
50
+ readonly expectedDigest?: string;
51
+ }
52
+ export interface SettingsSaveResult {
53
+ readonly revision: number;
54
+ readonly updatedAt: string;
55
+ readonly applied: readonly {
56
+ readonly key: string;
57
+ readonly action: "set" | "unset";
58
+ }[];
59
+ /** sha256 of the written settings bytes — the next save's external-edit baseline. */
60
+ readonly digest: string;
61
+ readonly outcome: SettingsAuditOutcome;
62
+ }
63
+ export type SettingsSecretsSaveResult = Omit<SettingsSaveResult, "digest">;
64
+ export type SettingsReadState = "absent" | "present" | "unreadable";
65
+ export interface SettingsReadResult {
66
+ readonly state: SettingsReadState;
67
+ /** Bounded, sanitized; unreadable only. */
68
+ readonly reason?: string;
69
+ /** 0 when absent or unreadable. */
70
+ readonly revision: number;
71
+ /** Valid values for known non-secret keys; `{}` when absent, and `{}` ONLY THEN — an unreadable document never parses as empty. */
72
+ readonly values: Readonly<Record<string, SettingValue>>;
73
+ /** sha256 of the raw current bytes (of no bytes, when absent). */
74
+ readonly digest: string;
75
+ /** The on-disk digest differs from the last audited digestAfter. */
76
+ readonly externalEdit: boolean;
77
+ /** Known keys whose stored value failed codec validation (value-free reasons). Present-state reads only (R4). */
78
+ readonly invalidKeys?: ReadonlyMap<string, string>;
79
+ /** Unrecognized key names kept verbatim on disk. Present-state reads only (P5). */
80
+ readonly unknownKeys?: readonly string[];
81
+ /** RFC3339 `updated_at` of the present document (present state only). */
82
+ readonly updatedAt?: string;
83
+ /** `updated_by` of the present document (present state only). */
84
+ readonly updatedBy?: {
85
+ readonly actor: SettingsActor;
86
+ readonly auth: SettingsAuth;
87
+ };
88
+ }
89
+ export interface SettingsSecretState {
90
+ readonly set: boolean;
91
+ readonly updatedAt?: string;
92
+ }
93
+ export interface SecretsStatusResult {
94
+ readonly state: SettingsReadState;
95
+ readonly revision: number;
96
+ /** `{KEY: {set, updatedAt}}` — structurally incapable of carrying a value. */
97
+ readonly entries: Readonly<Record<string, SettingsSecretState>>;
98
+ readonly reason?: string;
99
+ readonly warnings: readonly string[];
100
+ }
101
+ export interface SecretsSaveInput {
102
+ readonly expectedRevision: number;
103
+ readonly ops: readonly SettingsStoreOp[];
104
+ readonly actor: SettingsActor;
105
+ readonly auth: SettingsAuth;
106
+ /**
107
+ * Recover from an unreadable secrets document. No digest binding: secret
108
+ * material is never hashed, so there is nothing safe to compare against.
109
+ */
110
+ readonly recover?: boolean;
111
+ }
112
+ /**
113
+ * Remaining node-fs operations the store performs outside the durable writer
114
+ * and the loader's reader: only the best-effort mode tightening of the
115
+ * settings directory. Document reads go through the loader's hardened reader;
116
+ * every write goes through the durable writer.
117
+ */
118
+ export interface SettingsStoreFsOps {
119
+ chmod(path: string, mode: number): Promise<void>;
120
+ }
121
+ /**
122
+ * The audit surface the store consumes. Structural (a `Pick` of the class's
123
+ * public methods) so fault tests can stub appends without subclassing; a real
124
+ * `SettingsAuditLog` remains assignable.
125
+ */
126
+ export type SettingsStoreAudit = Pick<SettingsAuditLog, "append" | "lastSettingsDigestBaselines">;
127
+ export interface SettingsStoreDeps {
128
+ readonly fs?: SettingsStoreFsOps | undefined;
129
+ readonly writer?: DurableWriter | undefined;
130
+ readonly audit?: SettingsStoreAudit | undefined;
131
+ /** Passed through to `withSettingsLock` (lock fs/kill/hostname/now injection). */
132
+ readonly lock?: SettingsLockDeps | undefined;
133
+ readonly now?: (() => number) | undefined;
134
+ readonly warn?: ((fields: Record<string, unknown>, message: string) => void) | undefined;
135
+ }
136
+ export declare class SettingsStore {
137
+ #private;
138
+ constructor(dir: string, deps?: SettingsStoreDeps);
139
+ /**
140
+ * Read the settings document. A well-formed document with invalid values is
141
+ * PER-KEY TOLERANT (R4): it reads as `present`, its `values` carry the valid
142
+ * non-secret entries, and `invalidKeys`/`unknownKeys` report the rest, which
143
+ * stay on disk verbatim. An unparseable or shape-invalid document is
144
+ * REPORTED as unreadable (with its raw-bytes digest so a recover save can
145
+ * bind to it), never silently as an empty document.
146
+ */
147
+ read(): Promise<SettingsReadResult>;
148
+ /**
149
+ * Secret presence, never values. A secrets file whose mode allows
150
+ * group/other access is treated as unset with a warning (it is not read);
151
+ * the next save replaces it with a 0600 file.
152
+ */
153
+ secretStatus(): Promise<SecretsStatusResult>;
154
+ save(input: SettingsSaveInput): Promise<SettingsSaveResult>;
155
+ saveSecrets(input: SecretsSaveInput): Promise<SettingsSecretsSaveResult>;
156
+ }
157
+ export declare function createSettingsStore(dir: string, deps?: SettingsStoreDeps): SettingsStore;