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
@@ -1,7 +1,8 @@
1
1
  /**
2
- * The context-builder delegate signature for "the finalizer reported external
3
- * evidence gaps under external_gap_policy:degrade": status "partial" WITHOUT
4
- * fallback. No other path produces that pair (fallback always sets
2
+ * The context-builder delegate signature for "the finalizer reported evidence
3
+ * gaps under external_gap_policy:degrade" (accepted external gaps and/or
4
+ * confirmed-ENOENT unresolved gaps): status "partial" WITHOUT fallback. Only
5
+ * that degrade path produces the pair (fallback always sets
5
6
  * fallback_used:true; a clean run is "succeeded"), so it is the single shared
6
7
  * definition for engine context_quality, run health, and receipt status.
7
8
  *
@@ -1 +1 @@
1
- {"version":3,"file":"delegate-signature.js","sourceRoot":"","sources":["../src/delegate-signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAoF;IAEpF,OAAO,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK,CAAC;AAC5E,CAAC"}
1
+ {"version":3,"file":"delegate-signature.js","sourceRoot":"","sources":["../src/delegate-signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAoF;IAEpF,OAAO,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK,CAAC;AAC5E,CAAC"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * Crash-durable file publication: the one implementation behind run state
3
+ * (`durable-file.ts`) and the dashboard settings documents
4
+ * (`settings/durable-write.ts`).
5
+ *
6
+ * Replace mode writes a unique same-directory temporary opened
7
+ * `O_CREAT|O_EXCL|O_NOFOLLOW`, applies the mode with `fchmod` (never trusting
8
+ * the umask: the dashboard container reads these files as another user),
9
+ * fsyncs and closes it, renames it over the target, then fsyncs the parent
10
+ * directory. Exclusive mode keeps the `wx` create-once contract by creating
11
+ * and writing the target itself under the same flags, then fsyncing the
12
+ * parent directory.
13
+ *
14
+ * A write, fchmod, fsync, close or rename failure removes the file this call
15
+ * created: the temporary in replace mode, where the target is untouched until
16
+ * the rename; the target itself in exclusive mode, where it is visible under
17
+ * its final name while being written. An existing target makes exclusive mode
18
+ * fail with EEXIST and is never removed. Only a failed directory fsync after
19
+ * that point is a `DurablePublishError`, so callers know the new bytes are
20
+ * already there.
21
+ *
22
+ * This module imports node built-ins only and never logs by default: the
23
+ * settings CLI reaches it and must stay free of the logger/pino.
24
+ */
25
+ export interface DurableWriteOptions {
26
+ readonly mode: number;
27
+ /** Create-only: fail with EEXIST instead of replacing an existing target. */
28
+ readonly exclusive?: boolean | undefined;
29
+ }
30
+ /**
31
+ * The persistence seam. Production paths always resolve to
32
+ * `durableFileWriter`; tests that do not exercise durability may pass a fast
33
+ * writer through the store/tool options (there is deliberately no env switch).
34
+ */
35
+ export interface FileWriter {
36
+ writeFile(path: string, data: string | Uint8Array, options: DurableWriteOptions): Promise<void>;
37
+ /** Make a directory's entries (a new child directory, a rename) durable. */
38
+ syncDirectory(path: string): Promise<void>;
39
+ }
40
+ /** The new bytes are visible at `path`; only the directory fsync failed. */
41
+ export declare class DurablePublishError extends Error {
42
+ readonly published: true;
43
+ readonly path: string;
44
+ constructor(path: string, cause: unknown);
45
+ }
46
+ export interface DurableFileHandle {
47
+ writeFile(data: string | Uint8Array): Promise<void>;
48
+ chmod(mode: number): Promise<void>;
49
+ sync(): Promise<void>;
50
+ stat(): Promise<{
51
+ readonly dev: number | bigint;
52
+ }>;
53
+ close(): Promise<void>;
54
+ }
55
+ /** Filesystem operations the writer uses; injectable for order/fault tests. */
56
+ export interface DurableFsOps {
57
+ open(path: string, flags: number, mode?: number): Promise<DurableFileHandle>;
58
+ rename(from: string, to: string): Promise<void>;
59
+ unlink(path: string): Promise<void>;
60
+ }
61
+ export interface DurableFileWriterDeps {
62
+ readonly fs?: DurableFsOps | undefined;
63
+ readonly tempSuffix?: (() => string) | undefined;
64
+ readonly warn?: ((fields: Record<string, unknown>, message: string) => void) | undefined;
65
+ }
66
+ export declare function createDurableFileWriterCore(deps?: DurableFileWriterDeps): FileWriter;
67
+ /**
68
+ * `mkdir -p` whose newly created entries are durable: each directory this call
69
+ * created is fsynced into its parent, so a file later published beneath it
70
+ * cannot outlive its own path after a crash.
71
+ *
72
+ * It lives here, not in `durable-file.ts`, because it needs no diagnostics
73
+ * sink beyond the writer's own — keeping it importable from logger-free
74
+ * contexts such as the settings store (P7).
75
+ */
76
+ export declare function mkdirDurable(writer: FileWriter, path: string, mode?: number): Promise<void>;
@@ -0,0 +1,146 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import { constants as fsConstants } from "node:fs";
3
+ import { mkdir, open, rename, unlink } from "node:fs/promises";
4
+ import { basename, dirname, join, relative, sep } from "node:path";
5
+ /** The new bytes are visible at `path`; only the directory fsync failed. */
6
+ export class DurablePublishError extends Error {
7
+ published = true;
8
+ // An explicit field, not a parameter property: the settings fork test loads
9
+ // this module with Node's strip-only type removal, which rejects those.
10
+ path;
11
+ constructor(path, cause) {
12
+ super(`published ${path} but could not fsync its directory: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
13
+ this.name = "DurablePublishError";
14
+ this.path = path;
15
+ }
16
+ }
17
+ const CREATE_FLAGS = fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL | fsConstants.O_NOFOLLOW;
18
+ const DIRECTORY_FLAGS = fsConstants.O_RDONLY | (fsConstants.O_DIRECTORY ?? 0);
19
+ const nodeFs = {
20
+ open: async (path, flags, mode) => await open(path, flags, mode),
21
+ rename,
22
+ unlink,
23
+ };
24
+ function errnoCode(error) {
25
+ return typeof error === "object" && error !== null && "code" in error
26
+ ? String(error.code)
27
+ : undefined;
28
+ }
29
+ export function createDurableFileWriterCore(deps = {}) {
30
+ const fs = deps.fs ?? nodeFs;
31
+ const tempSuffix = deps.tempSuffix ?? (() => `${String(process.pid)}.${randomBytes(8).toString("hex")}`);
32
+ const warn = deps.warn ?? (() => undefined);
33
+ // Some filesystems (certain network/FUSE mounts) reject a directory fsync.
34
+ // That is tolerated, but reported once per filesystem rather than per write.
35
+ const warnedFilesystems = new Set();
36
+ async function syncDirectory(path) {
37
+ const handle = await fs.open(path, DIRECTORY_FLAGS);
38
+ try {
39
+ try {
40
+ await handle.sync();
41
+ }
42
+ catch (error) {
43
+ const code = errnoCode(error);
44
+ if (code !== "EINVAL" && code !== "ENOTSUP")
45
+ throw error;
46
+ const key = await handle.stat().then((stat) => String(stat.dev), () => path);
47
+ if (!warnedFilesystems.has(key)) {
48
+ warnedFilesystems.add(key);
49
+ warn({ directory: path, code }, "directory fsync is unsupported on this filesystem; renames are not crash-durable here");
50
+ }
51
+ }
52
+ }
53
+ finally {
54
+ await handle.close();
55
+ }
56
+ }
57
+ /**
58
+ * Create `path` (never following or reusing an existing entry), write, fchmod
59
+ * and fsync it. Any failure after creation removes the file it created.
60
+ */
61
+ async function createSynced(path, data, mode) {
62
+ const handle = await fs.open(path, CREATE_FLAGS, mode);
63
+ try {
64
+ await handle.writeFile(data);
65
+ await handle.chmod(mode);
66
+ await handle.sync();
67
+ }
68
+ catch (error) {
69
+ await handle.close().catch(() => { });
70
+ await discard(path);
71
+ throw error;
72
+ }
73
+ try {
74
+ await handle.close();
75
+ }
76
+ catch (error) {
77
+ await discard(path);
78
+ throw error;
79
+ }
80
+ }
81
+ async function discard(path) {
82
+ try {
83
+ await fs.unlink(path);
84
+ }
85
+ catch (error) {
86
+ if (errnoCode(error) !== "ENOENT") {
87
+ warn({ path, err: error instanceof Error ? error.message : String(error) }, "failed to remove an unpublished durable-write file");
88
+ }
89
+ }
90
+ }
91
+ async function publishDirectory(target) {
92
+ try {
93
+ await syncDirectory(dirname(target));
94
+ }
95
+ catch (error) {
96
+ throw new DurablePublishError(target, error);
97
+ }
98
+ }
99
+ return {
100
+ syncDirectory,
101
+ async writeFile(path, data, options) {
102
+ if (options.exclusive === true) {
103
+ await createSynced(path, data, options.mode);
104
+ await publishDirectory(path);
105
+ return;
106
+ }
107
+ const temporary = join(dirname(path), `.${basename(path)}.${tempSuffix()}.tmp`);
108
+ await createSynced(temporary, data, options.mode);
109
+ try {
110
+ await fs.rename(temporary, path);
111
+ }
112
+ catch (error) {
113
+ await discard(temporary);
114
+ throw error;
115
+ }
116
+ await publishDirectory(path);
117
+ },
118
+ };
119
+ }
120
+ /**
121
+ * `mkdir -p` whose newly created entries are durable: each directory this call
122
+ * created is fsynced into its parent, so a file later published beneath it
123
+ * cannot outlive its own path after a crash.
124
+ *
125
+ * It lives here, not in `durable-file.ts`, because it needs no diagnostics
126
+ * sink beyond the writer's own — keeping it importable from logger-free
127
+ * contexts such as the settings store (P7).
128
+ */
129
+ export async function mkdirDurable(writer, path, mode) {
130
+ const first = await mkdir(path, { recursive: true, ...(mode === undefined ? {} : { mode }) });
131
+ if (first === undefined)
132
+ return;
133
+ const created = [first];
134
+ const rest = relative(first, path);
135
+ if (rest !== "") {
136
+ let current = first;
137
+ for (const part of rest.split(sep)) {
138
+ current = join(current, part);
139
+ created.push(current);
140
+ }
141
+ }
142
+ for (const directory of created) {
143
+ await writer.syncDirectory(dirname(directory));
144
+ }
145
+ }
146
+ //# sourceMappingURL=durable-file-core.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durable-file-core.js","sourceRoot":"","sources":["../src/durable-file-core.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { type DurableFileWriterDeps, type FileWriter } from "./durable-file-core.js";
2
+ /**
3
+ * Run-state entry point for crash-durable writes. The implementation and its
4
+ * contract live in `durable-file-core.ts`; this module adds the logger as the
5
+ * default diagnostics sink, the production writer, and re-exports
6
+ * `mkdirDurable` (which is implemented in the core so logger-free consumers
7
+ * such as the settings store can reach it).
8
+ */
9
+ export { DurablePublishError, type DurableFileHandle, type DurableFileWriterDeps, type DurableFsOps, type DurableWriteOptions, type FileWriter, } from "./durable-file-core.js";
10
+ export { mkdirDurable } from "./durable-file-core.js";
11
+ export declare function createDurableFileWriter(deps?: DurableFileWriterDeps): FileWriter;
12
+ export declare const durableFileWriter: FileWriter;
13
+ export declare function resolveFileWriter(writer: FileWriter | undefined): FileWriter;
@@ -0,0 +1,22 @@
1
+ import { logger } from "./logger.js";
2
+ import { createDurableFileWriterCore } from "./durable-file-core.js";
3
+ /**
4
+ * Run-state entry point for crash-durable writes. The implementation and its
5
+ * contract live in `durable-file-core.ts`; this module adds the logger as the
6
+ * default diagnostics sink, the production writer, and re-exports
7
+ * `mkdirDurable` (which is implemented in the core so logger-free consumers
8
+ * such as the settings store can reach it).
9
+ */
10
+ export { DurablePublishError, } from "./durable-file-core.js";
11
+ export { mkdirDurable } from "./durable-file-core.js";
12
+ export function createDurableFileWriter(deps = {}) {
13
+ return createDurableFileWriterCore({
14
+ ...deps,
15
+ warn: deps.warn ?? ((fields, message) => logger.warn(fields, message)),
16
+ });
17
+ }
18
+ export const durableFileWriter = createDurableFileWriter();
19
+ export function resolveFileWriter(writer) {
20
+ return writer ?? durableFileWriter;
21
+ }
22
+ //# sourceMappingURL=durable-file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"durable-file.js","sourceRoot":"","sources":["../src/durable-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,2BAA2B,EAA+C,MAAM,wBAAwB,CAAC;AAElH;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,GAMpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,UAAU,uBAAuB,CAAC,OAA8B,EAAE;IACtE,OAAO,2BAA2B,CAAC;QACjC,GAAG,IAAI;QACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvE,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAe,uBAAuB,EAAE,CAAC;AAEvE,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC9D,OAAO,MAAM,IAAI,iBAAiB,CAAC;AACrC,CAAC"}
@@ -62,12 +62,13 @@
62
62
  * isError: true with termination_reason: "wall" or "idle", which the
63
63
  * workflow engine treats as a transient failure eligible for retry.
64
64
  */
65
+ import { type FileWriter } from "./durable-file.js";
65
66
  import type { NormalizedWorkflowDefinition } from "./definition-normalizer.js";
66
67
  import type { PlanReviewCallBinding } from "./plan-review/run-state.js";
67
68
  import { type CouncilPlanReviewError } from "./plan-review/publication.js";
68
69
  import { type ChildFailureMetadata } from "./errors.js";
69
70
  import { type FidelityReport } from "./fidelity.js";
70
- import type { CallState, FailureClass, RunStatus } from "./state-schema.js";
71
+ import type { CallFailureKind, CallState, FailureClass, RunStatus } from "./state-schema.js";
71
72
  import type { InvocationAuditWrite, ObservedInvocationV1 } from "./dashboard/invocation-contract.js";
72
73
  import type { ClinkBackend } from "./backend.js";
73
74
  import type { ValidatorRegistry } from "./validators/index.js";
@@ -75,6 +76,7 @@ import { type ArtifactRecord } from "./artifacts.js";
75
76
  import type { PlanReviewContextPolicy, PlanReviewContextProvenance } from "./plan-review/run-state.js";
76
77
  import type { ContextBuilderMetricsShape, ContextBuilderRunner, LightCallerProvenance, PreflightContextResult, WorkflowContext } from "./context-preflight.js";
77
78
  import type { VerifiedRepairRuntime } from "./verified-repair/runtime.js";
79
+ import type { PingPongRuntime } from "./ping-pong/runtime.js";
78
80
  import { type WorkflowContextPolicy, type WorkflowContextRequestedMode, type WorkflowContextEffectiveMode } from "./context-mode-resolver.js";
79
81
  /**
80
82
  * Maps a runner's {@link PreflightContextResult} to the persisted {@link WorkflowContext}.
@@ -107,15 +109,19 @@ export interface WorkflowExecutionResult {
107
109
  readonly stages: readonly ExecutedStage[];
108
110
  readonly artifactsDir: string;
109
111
  }
112
+ /** A persisted failed call replayed on resume, with its recorded provenance. */
113
+ export interface EngineResumeFailedCall {
114
+ readonly stageId: string;
115
+ readonly callId: string;
116
+ readonly error: string;
117
+ readonly terminal: boolean;
118
+ readonly failureClass?: FailureClass | undefined;
119
+ readonly failureKind?: CallFailureKind | undefined;
120
+ }
110
121
  export interface EngineResumeState {
111
122
  readonly completedCalls?: ReadonlyMap<string, ExecutedCall> | undefined;
112
123
  readonly preparedInputs?: ReadonlyMap<string, Readonly<Record<string, unknown>>> | undefined;
113
- readonly failedCalls?: ReadonlyMap<string, {
114
- readonly stageId: string;
115
- readonly callId: string;
116
- readonly error: string;
117
- readonly terminal: boolean;
118
- }> | undefined;
124
+ readonly failedCalls?: ReadonlyMap<string, EngineResumeFailedCall> | undefined;
119
125
  readonly nextRetryCounts?: ReadonlyMap<string, number> | undefined;
120
126
  }
121
127
  type HookResult = Promise<void> | void;
@@ -155,6 +161,8 @@ export interface EngineCallStateChange {
155
161
  readonly outputText?: string | undefined;
156
162
  readonly error?: string | undefined;
157
163
  readonly failureClass?: FailureClass | undefined;
164
+ /** Structured provenance on a failed emit; absent clears any prior value. */
165
+ readonly failureKind?: CallFailureKind | undefined;
158
166
  readonly fidelity?: FidelityReport | undefined;
159
167
  readonly artifact?: ArtifactRecord | undefined;
160
168
  readonly childDebugMetadata?: ChildFailureMetadata | undefined;
@@ -256,6 +264,10 @@ export interface WorkflowEngineOptions {
256
264
  readonly terminalResultPolicy?: EngineTerminalResultPolicy | undefined;
257
265
  /** Prepared root-host capability for the validated fixed repair workflow. */
258
266
  readonly verifiedRepair?: VerifiedRepairRuntime | undefined;
267
+ /** Prepared ping-pong runtime (root recipe host); required for the ping-pong topology. */
268
+ readonly pingPong?: PingPongRuntime | undefined;
269
+ /** Test seam for call-artifact and recipe-evidence writes; production omits it. */
270
+ readonly fileWriter?: FileWriter | undefined;
259
271
  /**
260
272
  * Optional root-injected model/effort provenance audit. The engine has no
261
273
  * adapter registry and cannot derive `adapter_pin` itself. Standalone
@@ -298,7 +310,9 @@ export declare class WorkflowEngine {
298
310
  private readonly planReviewDeliveredAliases;
299
311
  private readonly artifactStore;
300
312
  private readonly architectureComparison;
313
+ private readonly architectureArena;
301
314
  private readonly verifiedRepair;
315
+ private readonly pingPong;
302
316
  private readonly architectureResume;
303
317
  private readonly contextBuilderRunner;
304
318
  private readonly contextDefault;
@@ -390,8 +404,29 @@ export declare class WorkflowEngine {
390
404
  private isCorrectiveRetryEligible;
391
405
  private buildCorrectiveRetrySuffix;
392
406
  private invokeCall;
407
+ /**
408
+ * Ping-pong seat dispatch: recipe call options (worktree cwd, confirmed
409
+ * exit), operation intent before and result after every attempt, and two
410
+ * in-place retry arms with independent counters: busy-before-spawn,
411
+ * bounded by PP_BUSY_ATTEMPTS, and the runtime-decided reviewer retry
412
+ * (D-C), bounded by PP_REVIEWER_RETRIES and dispatched with the rebuilt
413
+ * packet.
414
+ */
415
+ private invokePingPongCall;
416
+ /**
417
+ * The dispatched prompt with its trailing ping-pong packet replaced by the
418
+ * rebuilt one, re-checked against the prompt budget. Fails closed when the
419
+ * prompt does not end with the packet it was dispatched with.
420
+ */
421
+ private rebuildPingPongInput;
393
422
  private computeDispatchDeadline;
394
423
  private prepareDispatchInput;
424
+ /** Prompt-budget estimate of a fully built call input (prompt, context, files, images). */
425
+ private estimateInputPromptBudget;
426
+ /**
427
+ * The artifact (and any recipe evidence it updates) is durable before it
428
+ * returns, so the succeeded call state that names it is published second.
429
+ */
395
430
  private maybeWriteArtifact;
396
431
  private resolveDynamicPaths;
397
432
  private resolveDynamicPathVariable;