@wildo-ai/platform-config-lib 1.0.1 → 1.1.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 (414) hide show
  1. package/LICENSE +34 -0
  2. package/dist/esm/.builder.pid +9 -0
  3. package/dist/esm/_unimplemented/index.d.ts +3 -0
  4. package/dist/esm/_unimplemented/index.d.ts.map +1 -0
  5. package/dist/esm/_unimplemented/index.js +3 -0
  6. package/dist/esm/_unimplemented/index.js.map +1 -0
  7. package/dist/esm/_unimplemented/soft-warn.d.ts +124 -0
  8. package/dist/esm/_unimplemented/soft-warn.d.ts.map +1 -0
  9. package/dist/esm/_unimplemented/soft-warn.js +170 -0
  10. package/dist/esm/_unimplemented/soft-warn.js.map +1 -0
  11. package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts +137 -0
  12. package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts.map +1 -0
  13. package/dist/esm/_unimplemented/unimplemented-field-warning.js +153 -0
  14. package/dist/esm/_unimplemented/unimplemented-field-warning.js.map +1 -0
  15. package/dist/esm/bootstrap/application-backend-env.contracts.d.ts.map +1 -1
  16. package/dist/esm/bootstrap/application-backend-env.contracts.js +1 -1
  17. package/dist/esm/bootstrap/application-backend-env.contracts.js.map +1 -1
  18. package/dist/esm/bootstrap/application-creation-verification-env.contracts.d.ts +13 -0
  19. package/dist/esm/bootstrap/application-creation-verification-env.contracts.d.ts.map +1 -0
  20. package/dist/esm/bootstrap/application-creation-verification-env.contracts.js +14 -0
  21. package/dist/esm/bootstrap/application-creation-verification-env.contracts.js.map +1 -0
  22. package/dist/esm/bootstrap/bootstrap-planner.d.ts +1 -1
  23. package/dist/esm/bootstrap/bootstrap-planner.d.ts.map +1 -1
  24. package/dist/esm/bootstrap/bootstrap-planner.js +1 -1
  25. package/dist/esm/bootstrap/bootstrap-planner.js.map +1 -1
  26. package/dist/esm/bootstrap/bootstrap.contracts.d.ts +141 -37
  27. package/dist/esm/bootstrap/bootstrap.contracts.d.ts.map +1 -1
  28. package/dist/esm/bootstrap/bootstrap.contracts.js +104 -18
  29. package/dist/esm/bootstrap/bootstrap.contracts.js.map +1 -1
  30. package/dist/esm/bootstrap/bootstrap.schemas.d.ts +430 -421
  31. package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
  32. package/dist/esm/bootstrap/bootstrap.schemas.js +383 -21
  33. package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
  34. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +213 -8
  35. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
  36. package/dist/esm/bootstrap/platform-runtime-env.contracts.js +230 -5
  37. package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
  38. package/dist/esm/bootstrap/runtime-backing-service-access.d.ts +79 -0
  39. package/dist/esm/bootstrap/runtime-backing-service-access.d.ts.map +1 -0
  40. package/dist/esm/bootstrap/runtime-backing-service-access.js +83 -0
  41. package/dist/esm/bootstrap/runtime-backing-service-access.js.map +1 -0
  42. package/dist/esm/bootstrap/runtime-network-policy.d.ts +63 -0
  43. package/dist/esm/bootstrap/runtime-network-policy.d.ts.map +1 -0
  44. package/dist/esm/bootstrap/runtime-network-policy.js +104 -0
  45. package/dist/esm/bootstrap/runtime-network-policy.js.map +1 -0
  46. package/dist/esm/bootstrap/runtime-network-topology.d.ts +78 -0
  47. package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -0
  48. package/dist/esm/bootstrap/runtime-network-topology.js +134 -0
  49. package/dist/esm/bootstrap/runtime-network-topology.js.map +1 -0
  50. package/dist/esm/bootstrap/runtime-platform-access.d.ts +67 -0
  51. package/dist/esm/bootstrap/runtime-platform-access.d.ts.map +1 -0
  52. package/dist/esm/bootstrap/runtime-platform-access.js +57 -0
  53. package/dist/esm/bootstrap/runtime-platform-access.js.map +1 -0
  54. package/dist/esm/bootstrap/runtime-principal.contracts.d.ts +173 -0
  55. package/dist/esm/bootstrap/runtime-principal.contracts.d.ts.map +1 -0
  56. package/dist/esm/bootstrap/runtime-principal.contracts.js +218 -0
  57. package/dist/esm/bootstrap/runtime-principal.contracts.js.map +1 -0
  58. package/dist/esm/bootstrap/runtime-topology.contracts.d.ts +112 -1
  59. package/dist/esm/bootstrap/runtime-topology.contracts.d.ts.map +1 -1
  60. package/dist/esm/bootstrap/runtime-topology.contracts.js +141 -8
  61. package/dist/esm/bootstrap/runtime-topology.contracts.js.map +1 -1
  62. package/dist/esm/config-authoring.entry.d.ts +3 -0
  63. package/dist/esm/config-authoring.entry.d.ts.map +1 -0
  64. package/dist/esm/config-authoring.entry.js +5 -0
  65. package/dist/esm/config-authoring.entry.js.map +1 -0
  66. package/dist/esm/credentials/credential-generator.service.d.ts.map +1 -1
  67. package/dist/esm/credentials/credential-generator.service.js +1 -1
  68. package/dist/esm/credentials/credential-generator.service.js.map +1 -1
  69. package/dist/esm/index.d.ts +30 -15
  70. package/dist/esm/index.d.ts.map +1 -1
  71. package/dist/esm/index.js +16 -1
  72. package/dist/esm/index.js.map +1 -1
  73. package/dist/esm/lockfile/canonical-json.d.ts +41 -0
  74. package/dist/esm/lockfile/canonical-json.d.ts.map +1 -0
  75. package/dist/esm/lockfile/canonical-json.js +56 -0
  76. package/dist/esm/lockfile/canonical-json.js.map +1 -0
  77. package/dist/esm/lockfile/lockfile-io.d.ts +231 -0
  78. package/dist/esm/lockfile/lockfile-io.d.ts.map +1 -0
  79. package/dist/esm/lockfile/lockfile-io.js +303 -0
  80. package/dist/esm/lockfile/lockfile-io.js.map +1 -0
  81. package/dist/esm/lockfile/materialize-infra-section.d.ts +99 -0
  82. package/dist/esm/lockfile/materialize-infra-section.d.ts.map +1 -0
  83. package/dist/esm/lockfile/materialize-infra-section.js +153 -0
  84. package/dist/esm/lockfile/materialize-infra-section.js.map +1 -0
  85. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts +522 -0
  86. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -0
  87. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js +116 -0
  88. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -0
  89. package/dist/esm/project-config/define-framework-config.d.ts +36 -10
  90. package/dist/esm/project-config/define-framework-config.d.ts.map +1 -1
  91. package/dist/esm/project-config/define-framework-config.js +67 -3
  92. package/dist/esm/project-config/define-framework-config.js.map +1 -1
  93. package/dist/esm/project-config/define-infra-env-config.d.ts +570 -0
  94. package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -0
  95. package/dist/esm/project-config/define-infra-env-config.js +726 -0
  96. package/dist/esm/project-config/define-infra-env-config.js.map +1 -0
  97. package/dist/esm/project-config/define-minion-config.d.ts +221 -23
  98. package/dist/esm/project-config/define-minion-config.d.ts.map +1 -1
  99. package/dist/esm/project-config/define-minion-config.js +228 -11
  100. package/dist/esm/project-config/define-minion-config.js.map +1 -1
  101. package/dist/esm/project-config/define-saas-config.d.ts +427 -218
  102. package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
  103. package/dist/esm/project-config/define-saas-config.js +704 -75
  104. package/dist/esm/project-config/define-saas-config.js.map +1 -1
  105. package/dist/esm/project-config/define-worker-config.d.ts +106 -10
  106. package/dist/esm/project-config/define-worker-config.d.ts.map +1 -1
  107. package/dist/esm/project-config/define-worker-config.js +99 -9
  108. package/dist/esm/project-config/define-worker-config.js.map +1 -1
  109. package/dist/esm/project-config/index.d.ts +28 -21
  110. package/dist/esm/project-config/index.d.ts.map +1 -1
  111. package/dist/esm/project-config/index.js +14 -7
  112. package/dist/esm/project-config/index.js.map +1 -1
  113. package/dist/esm/project-config/loader.d.ts +120 -10
  114. package/dist/esm/project-config/loader.d.ts.map +1 -1
  115. package/dist/esm/project-config/loader.js +290 -38
  116. package/dist/esm/project-config/loader.js.map +1 -1
  117. package/dist/esm/project-config/minion-local-provider-registration.d.ts +69 -0
  118. package/dist/esm/project-config/minion-local-provider-registration.d.ts.map +1 -0
  119. package/dist/esm/project-config/minion-local-provider-registration.js +72 -0
  120. package/dist/esm/project-config/minion-local-provider-registration.js.map +1 -0
  121. package/dist/esm/project-config/provider-catalog-types.d.ts +12 -0
  122. package/dist/esm/project-config/provider-catalog-types.d.ts.map +1 -0
  123. package/dist/esm/project-config/provider-catalog-types.js +49 -0
  124. package/dist/esm/project-config/provider-catalog-types.js.map +1 -0
  125. package/dist/esm/project-config/provider-companion-discovery.d.ts +24 -0
  126. package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -0
  127. package/dist/esm/project-config/provider-companion-discovery.js +244 -0
  128. package/dist/esm/project-config/provider-companion-discovery.js.map +1 -0
  129. package/dist/esm/project-config/provider-runtime-artifacts.d.ts +297 -0
  130. package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -0
  131. package/dist/esm/project-config/provider-runtime-artifacts.js +860 -0
  132. package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -0
  133. package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts +18 -0
  134. package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts.map +1 -0
  135. package/dist/esm/project-config/shared/application-creation-verification.schemas.js +25 -0
  136. package/dist/esm/project-config/shared/application-creation-verification.schemas.js.map +1 -0
  137. package/dist/esm/project-config/shared/application-modules.schemas.d.ts +10 -2
  138. package/dist/esm/project-config/shared/application-modules.schemas.d.ts.map +1 -1
  139. package/dist/esm/project-config/shared/application-modules.schemas.js +12 -1
  140. package/dist/esm/project-config/shared/application-modules.schemas.js.map +1 -1
  141. package/dist/esm/project-config/shared/application-modules.utils.d.ts +2 -1
  142. package/dist/esm/project-config/shared/application-modules.utils.d.ts.map +1 -1
  143. package/dist/esm/project-config/shared/application-modules.utils.js +6 -1
  144. package/dist/esm/project-config/shared/application-modules.utils.js.map +1 -1
  145. package/dist/esm/project-config/shared/auth.schemas.d.ts +102 -0
  146. package/dist/esm/project-config/shared/auth.schemas.d.ts.map +1 -0
  147. package/dist/esm/project-config/shared/auth.schemas.js +100 -0
  148. package/dist/esm/project-config/shared/auth.schemas.js.map +1 -0
  149. package/dist/esm/project-config/shared/backing-services.schemas.d.ts +316 -39
  150. package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
  151. package/dist/esm/project-config/shared/backing-services.schemas.js +359 -24
  152. package/dist/esm/project-config/shared/backing-services.schemas.js.map +1 -1
  153. package/dist/esm/project-config/shared/cdn.example.d.ts +14 -0
  154. package/dist/esm/project-config/shared/cdn.example.d.ts.map +1 -0
  155. package/dist/esm/project-config/shared/cdn.example.js +38 -0
  156. package/dist/esm/project-config/shared/cdn.example.js.map +1 -0
  157. package/dist/esm/project-config/shared/cdn.schemas.d.ts +182 -0
  158. package/dist/esm/project-config/shared/cdn.schemas.d.ts.map +1 -0
  159. package/dist/esm/project-config/shared/cdn.schemas.js +151 -0
  160. package/dist/esm/project-config/shared/cdn.schemas.js.map +1 -0
  161. package/dist/esm/project-config/shared/csp-defaults.d.ts +92 -0
  162. package/dist/esm/project-config/shared/csp-defaults.d.ts.map +1 -0
  163. package/dist/esm/project-config/shared/csp-defaults.js +195 -0
  164. package/dist/esm/project-config/shared/csp-defaults.js.map +1 -0
  165. package/dist/esm/project-config/shared/csp-emit.d.ts +106 -0
  166. package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -0
  167. package/dist/esm/project-config/shared/csp-emit.js +305 -0
  168. package/dist/esm/project-config/shared/csp-emit.js.map +1 -0
  169. package/dist/esm/project-config/shared/csp.schemas.d.ts +266 -0
  170. package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -0
  171. package/dist/esm/project-config/shared/csp.schemas.js +281 -0
  172. package/dist/esm/project-config/shared/csp.schemas.js.map +1 -0
  173. package/dist/esm/project-config/shared/data-services.schemas.d.ts +45 -9
  174. package/dist/esm/project-config/shared/data-services.schemas.d.ts.map +1 -1
  175. package/dist/esm/project-config/shared/data-services.schemas.js +45 -9
  176. package/dist/esm/project-config/shared/data-services.schemas.js.map +1 -1
  177. package/dist/esm/project-config/shared/env-example-defaults.d.ts +0 -1
  178. package/dist/esm/project-config/shared/env-example-defaults.d.ts.map +1 -1
  179. package/dist/esm/project-config/shared/env-example-defaults.js +1 -2
  180. package/dist/esm/project-config/shared/env-example-defaults.js.map +1 -1
  181. package/dist/esm/project-config/shared/environment.schemas.d.ts +134 -8
  182. package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
  183. package/dist/esm/project-config/shared/environment.schemas.js +185 -2
  184. package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
  185. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts +779 -0
  186. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -0
  187. package/dist/esm/project-config/shared/infra-providers.schemas.js +210 -0
  188. package/dist/esm/project-config/shared/infra-providers.schemas.js.map +1 -0
  189. package/dist/esm/project-config/shared/infra-service.schemas.d.ts +18 -0
  190. package/dist/esm/project-config/shared/infra-service.schemas.d.ts.map +1 -0
  191. package/dist/esm/project-config/shared/infra-service.schemas.js +16 -0
  192. package/dist/esm/project-config/shared/infra-service.schemas.js.map +1 -0
  193. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts +83 -1
  194. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
  195. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js +99 -2
  196. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
  197. package/dist/esm/project-config/shared/k8s-utils.d.ts +51 -7
  198. package/dist/esm/project-config/shared/k8s-utils.d.ts.map +1 -1
  199. package/dist/esm/project-config/shared/k8s-utils.js +59 -12
  200. package/dist/esm/project-config/shared/k8s-utils.js.map +1 -1
  201. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts +31 -0
  202. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts.map +1 -0
  203. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js +32 -0
  204. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js.map +1 -0
  205. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts +142 -0
  206. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts.map +1 -0
  207. package/dist/esm/project-config/shared/minion-resource-access.validation.js +159 -0
  208. package/dist/esm/project-config/shared/minion-resource-access.validation.js.map +1 -0
  209. package/dist/esm/project-config/shared/object-storage-session-policy.d.ts +100 -0
  210. package/dist/esm/project-config/shared/object-storage-session-policy.d.ts.map +1 -0
  211. package/dist/esm/project-config/shared/object-storage-session-policy.js +130 -0
  212. package/dist/esm/project-config/shared/object-storage-session-policy.js.map +1 -0
  213. package/dist/esm/project-config/shared/platform-services.schemas.d.ts +9 -14
  214. package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
  215. package/dist/esm/project-config/shared/platform-services.schemas.js +13 -9
  216. package/dist/esm/project-config/shared/platform-services.schemas.js.map +1 -1
  217. package/dist/esm/project-config/shared/schema-version.schemas.d.ts +15 -0
  218. package/dist/esm/project-config/shared/schema-version.schemas.d.ts.map +1 -0
  219. package/dist/esm/project-config/shared/schema-version.schemas.js +40 -0
  220. package/dist/esm/project-config/shared/schema-version.schemas.js.map +1 -0
  221. package/dist/esm/project-config/shared/service-definitions.schemas.d.ts +283 -8
  222. package/dist/esm/project-config/shared/service-definitions.schemas.d.ts.map +1 -1
  223. package/dist/esm/project-config/shared/service-definitions.schemas.js +325 -8
  224. package/dist/esm/project-config/shared/service-definitions.schemas.js.map +1 -1
  225. package/dist/esm/registry/artifact-domain.schemas.d.ts +54 -0
  226. package/dist/esm/registry/artifact-domain.schemas.d.ts.map +1 -0
  227. package/dist/esm/registry/artifact-domain.schemas.js +40 -0
  228. package/dist/esm/registry/artifact-domain.schemas.js.map +1 -0
  229. package/dist/esm/registry/companion-api.schemas.d.ts +176 -0
  230. package/dist/esm/registry/companion-api.schemas.d.ts.map +1 -0
  231. package/dist/esm/registry/companion-api.schemas.js +165 -0
  232. package/dist/esm/registry/companion-api.schemas.js.map +1 -0
  233. package/dist/esm/registry/digest.schemas.d.ts +20 -0
  234. package/dist/esm/registry/digest.schemas.d.ts.map +1 -0
  235. package/dist/esm/registry/digest.schemas.js +21 -0
  236. package/dist/esm/registry/digest.schemas.js.map +1 -0
  237. package/dist/esm/registry/index.d.ts +33 -0
  238. package/dist/esm/registry/index.d.ts.map +1 -0
  239. package/dist/esm/registry/index.js +33 -0
  240. package/dist/esm/registry/index.js.map +1 -0
  241. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts +107 -0
  242. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts.map +1 -0
  243. package/dist/esm/registry/lockfile-modules-section.schemas.js +67 -0
  244. package/dist/esm/registry/lockfile-modules-section.schemas.js.map +1 -0
  245. package/dist/esm/registry/module-artifact.schemas.d.ts +94 -0
  246. package/dist/esm/registry/module-artifact.schemas.d.ts.map +1 -0
  247. package/dist/esm/registry/module-artifact.schemas.js +69 -0
  248. package/dist/esm/registry/module-artifact.schemas.js.map +1 -0
  249. package/dist/esm/registry/module-manifest.schemas.d.ts +134 -0
  250. package/dist/esm/registry/module-manifest.schemas.d.ts.map +1 -0
  251. package/dist/esm/registry/module-manifest.schemas.js +155 -0
  252. package/dist/esm/registry/module-manifest.schemas.js.map +1 -0
  253. package/dist/esm/registry/registry-config.schemas.d.ts +31 -0
  254. package/dist/esm/registry/registry-config.schemas.d.ts.map +1 -0
  255. package/dist/esm/registry/registry-config.schemas.js +24 -0
  256. package/dist/esm/registry/registry-config.schemas.js.map +1 -0
  257. package/dist/esm/registry/registry-defaults.constants.d.ts +37 -0
  258. package/dist/esm/registry/registry-defaults.constants.d.ts.map +1 -0
  259. package/dist/esm/registry/registry-defaults.constants.js +37 -0
  260. package/dist/esm/registry/registry-defaults.constants.js.map +1 -0
  261. package/dist/esm/registry/registry-errors.d.ts +109 -0
  262. package/dist/esm/registry/registry-errors.d.ts.map +1 -0
  263. package/dist/esm/registry/registry-errors.js +185 -0
  264. package/dist/esm/registry/registry-errors.js.map +1 -0
  265. package/dist/esm/registry/registry-section-schemas.constants.d.ts +39 -0
  266. package/dist/esm/registry/registry-section-schemas.constants.d.ts.map +1 -0
  267. package/dist/esm/registry/registry-section-schemas.constants.js +22 -0
  268. package/dist/esm/registry/registry-section-schemas.constants.js.map +1 -0
  269. package/dist/esm/release/framework-release.constants.d.ts +26 -1
  270. package/dist/esm/release/framework-release.constants.d.ts.map +1 -1
  271. package/dist/esm/release/framework-release.constants.js +27 -2
  272. package/dist/esm/release/framework-release.constants.js.map +1 -1
  273. package/dist/esm/schemas/framework-info.schemas.d.ts +1 -1
  274. package/dist/esm/schemas/framework-info.schemas.d.ts.map +1 -1
  275. package/dist/esm/schemas/framework-info.schemas.js +1 -1
  276. package/dist/esm/schemas/framework-info.schemas.js.map +1 -1
  277. package/dist/esm/schemas/framework-secrets.schemas.d.ts +5 -5
  278. package/dist/esm/schemas/framework-secrets.schemas.d.ts.map +1 -1
  279. package/dist/esm/schemas/framework-secrets.schemas.js +1 -1
  280. package/dist/esm/schemas/framework-secrets.schemas.js.map +1 -1
  281. package/dist/esm/schemas/platform-application-config.schemas.d.ts +1 -1
  282. package/dist/esm/schemas/platform-application-config.schemas.d.ts.map +1 -1
  283. package/dist/esm/schemas/platform-application-config.schemas.js +11 -2
  284. package/dist/esm/schemas/platform-application-config.schemas.js.map +1 -1
  285. package/dist/esm/schemas/platform-application-secrets.schemas.d.ts +7 -7
  286. package/dist/esm/schemas/platform-application-secrets.schemas.d.ts.map +1 -1
  287. package/dist/esm/schemas/platform-application-secrets.schemas.js +17 -2
  288. package/dist/esm/schemas/platform-application-secrets.schemas.js.map +1 -1
  289. package/dist/esm/schemas/platform-config.schemas.d.ts +12 -13
  290. package/dist/esm/schemas/platform-config.schemas.d.ts.map +1 -1
  291. package/dist/esm/schemas/platform-config.schemas.js +15 -3
  292. package/dist/esm/schemas/platform-config.schemas.js.map +1 -1
  293. package/dist/esm/workspace-scope/application-subject-manifest.d.ts +26 -0
  294. package/dist/esm/workspace-scope/application-subject-manifest.d.ts.map +1 -0
  295. package/dist/esm/workspace-scope/application-subject-manifest.js +43 -0
  296. package/dist/esm/workspace-scope/application-subject-manifest.js.map +1 -0
  297. package/dist/esm/workspace-scope/index.d.ts +5 -2
  298. package/dist/esm/workspace-scope/index.d.ts.map +1 -1
  299. package/dist/esm/workspace-scope/index.js +4 -1
  300. package/dist/esm/workspace-scope/index.js.map +1 -1
  301. package/dist/esm/workspace-scope/resolve-homes.d.ts +20 -0
  302. package/dist/esm/workspace-scope/resolve-homes.d.ts.map +1 -0
  303. package/dist/esm/workspace-scope/resolve-homes.js +62 -0
  304. package/dist/esm/workspace-scope/resolve-homes.js.map +1 -0
  305. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts +211 -0
  306. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts.map +1 -0
  307. package/dist/esm/workspace-scope/workspace-homes.schemas.js +113 -0
  308. package/dist/esm/workspace-scope/workspace-homes.schemas.js.map +1 -0
  309. package/dist/esm/workspace-scope/workspace-scope-detector.d.ts +10 -5
  310. package/dist/esm/workspace-scope/workspace-scope-detector.d.ts.map +1 -1
  311. package/dist/esm/workspace-scope/workspace-scope-detector.js +22 -36
  312. package/dist/esm/workspace-scope/workspace-scope-detector.js.map +1 -1
  313. package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts +147 -58
  314. package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts.map +1 -1
  315. package/dist/esm/workspace-scope/workspace-scope.schemas.js +174 -78
  316. package/dist/esm/workspace-scope/workspace-scope.schemas.js.map +1 -1
  317. package/dist/tsconfig.build.tsbuildinfo +1 -1
  318. package/package.json +31 -17
  319. package/dist/esm/credentials/credentials-provisioner.service.d.ts +0 -190
  320. package/dist/esm/credentials/credentials-provisioner.service.d.ts.map +0 -1
  321. package/dist/esm/credentials/credentials-provisioner.service.js +0 -278
  322. package/dist/esm/credentials/credentials-provisioner.service.js.map +0 -1
  323. package/dist/esm/infra-managers/infra-manager.models.d.ts +0 -146
  324. package/dist/esm/infra-managers/infra-manager.models.d.ts.map +0 -1
  325. package/dist/esm/infra-managers/infra-manager.models.js +0 -2
  326. package/dist/esm/infra-managers/infra-manager.models.js.map +0 -1
  327. package/dist/esm/infra-managers/mongo-atlas-manager.service.d.ts +0 -64
  328. package/dist/esm/infra-managers/mongo-atlas-manager.service.d.ts.map +0 -1
  329. package/dist/esm/infra-managers/mongo-atlas-manager.service.js +0 -307
  330. package/dist/esm/infra-managers/mongo-atlas-manager.service.js.map +0 -1
  331. package/dist/esm/infra-managers/postgresql-manager.service.d.ts +0 -115
  332. package/dist/esm/infra-managers/postgresql-manager.service.d.ts.map +0 -1
  333. package/dist/esm/infra-managers/postgresql-manager.service.js +0 -403
  334. package/dist/esm/infra-managers/postgresql-manager.service.js.map +0 -1
  335. package/dist/esm/infra-managers/rabbitmq-manager.service.d.ts +0 -64
  336. package/dist/esm/infra-managers/rabbitmq-manager.service.d.ts.map +0 -1
  337. package/dist/esm/infra-managers/rabbitmq-manager.service.js +0 -288
  338. package/dist/esm/infra-managers/rabbitmq-manager.service.js.map +0 -1
  339. package/dist/esm/infra-managers/redis-manager.service.d.ts +0 -78
  340. package/dist/esm/infra-managers/redis-manager.service.d.ts.map +0 -1
  341. package/dist/esm/infra-managers/redis-manager.service.js +0 -326
  342. package/dist/esm/infra-managers/redis-manager.service.js.map +0 -1
  343. package/dist/esm/project-config/define-infra-config.d.ts +0 -128
  344. package/dist/esm/project-config/define-infra-config.d.ts.map +0 -1
  345. package/dist/esm/project-config/define-infra-config.js +0 -87
  346. package/dist/esm/project-config/define-infra-config.js.map +0 -1
  347. package/dist/esm/project-config/define-platform-config.d.ts +0 -65
  348. package/dist/esm/project-config/define-platform-config.d.ts.map +0 -1
  349. package/dist/esm/project-config/define-platform-config.js +0 -22
  350. package/dist/esm/project-config/define-platform-config.js.map +0 -1
  351. package/dist/esm/project-config/define-platform-env-config.d.ts +0 -41
  352. package/dist/esm/project-config/define-platform-env-config.d.ts.map +0 -1
  353. package/dist/esm/project-config/define-platform-env-config.js +0 -45
  354. package/dist/esm/project-config/define-platform-env-config.js.map +0 -1
  355. package/dist/esm/project-config/define-project-config.d.ts +0 -38
  356. package/dist/esm/project-config/define-project-config.d.ts.map +0 -1
  357. package/dist/esm/project-config/define-project-config.js +0 -57
  358. package/dist/esm/project-config/define-project-config.js.map +0 -1
  359. package/dist/esm/project-config/define-sharing-policy.d.ts +0 -35
  360. package/dist/esm/project-config/define-sharing-policy.d.ts.map +0 -1
  361. package/dist/esm/project-config/define-sharing-policy.js +0 -30
  362. package/dist/esm/project-config/define-sharing-policy.js.map +0 -1
  363. package/dist/esm/project-config/sharing-policy-validation.d.ts +0 -40
  364. package/dist/esm/project-config/sharing-policy-validation.d.ts.map +0 -1
  365. package/dist/esm/project-config/sharing-policy-validation.js +0 -143
  366. package/dist/esm/project-config/sharing-policy-validation.js.map +0 -1
  367. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.d.ts +0 -23
  368. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.d.ts.map +0 -1
  369. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.js +0 -13
  370. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.js.map +0 -1
  371. package/src/bootstrap/application-backend-env.contracts.ts +0 -17
  372. package/src/bootstrap/bootstrap-planner.ts +0 -46
  373. package/src/bootstrap/bootstrap.contracts.ts +0 -251
  374. package/src/bootstrap/bootstrap.schemas.ts +0 -164
  375. package/src/bootstrap/platform-runtime-env.contracts.ts +0 -99
  376. package/src/bootstrap/runtime-topology.contracts.ts +0 -102
  377. package/src/credentials/credential-generator.service.ts +0 -39
  378. package/src/index.ts +0 -16
  379. package/src/project-config/__tests__/application-modules.utils.test.ts +0 -53
  380. package/src/project-config/__tests__/define-framework-config.test.ts +0 -43
  381. package/src/project-config/__tests__/define-saas-config.test.ts +0 -210
  382. package/src/project-config/__tests__/loader.test.ts +0 -100
  383. package/src/project-config/define-framework-config.ts +0 -44
  384. package/src/project-config/define-infra-config.ts +0 -168
  385. package/src/project-config/define-minion-config.ts +0 -27
  386. package/src/project-config/define-platform-config.ts +0 -28
  387. package/src/project-config/define-platform-env-config.ts +0 -59
  388. package/src/project-config/define-project-config.ts +0 -63
  389. package/src/project-config/define-saas-config.ts +0 -171
  390. package/src/project-config/define-sharing-policy.ts +0 -36
  391. package/src/project-config/define-worker-config.ts +0 -27
  392. package/src/project-config/index.ts +0 -23
  393. package/src/project-config/loader.ts +0 -220
  394. package/src/project-config/shared/application-modules.schemas.ts +0 -12
  395. package/src/project-config/shared/application-modules.utils.ts +0 -65
  396. package/src/project-config/shared/backing-services.schemas.ts +0 -59
  397. package/src/project-config/shared/data-services.schemas.ts +0 -58
  398. package/src/project-config/shared/env-example-defaults.ts +0 -50
  399. package/src/project-config/shared/environment.schemas.ts +0 -136
  400. package/src/project-config/shared/infrastructure-defaults.schemas.ts +0 -47
  401. package/src/project-config/shared/k8s-utils.ts +0 -56
  402. package/src/project-config/shared/platform-services.schemas.ts +0 -33
  403. package/src/project-config/shared/service-definitions.schemas.ts +0 -38
  404. package/src/project-config/sharing-policy-validation.ts +0 -159
  405. package/src/release/framework-release.constants.ts +0 -2
  406. package/src/schemas/__tests__/platform-config.schemas.test.ts +0 -90
  407. package/src/schemas/framework-info.schemas.ts +0 -13
  408. package/src/schemas/framework-secrets.schemas.ts +0 -19
  409. package/src/schemas/platform-application-config.schemas.ts +0 -25
  410. package/src/schemas/platform-application-secrets.schemas.ts +0 -78
  411. package/src/schemas/platform-config.schemas.ts +0 -45
  412. package/src/workspace-scope/index.ts +0 -2
  413. package/src/workspace-scope/workspace-scope-detector.ts +0 -98
  414. package/src/workspace-scope/workspace-scope.schemas.ts +0 -224
@@ -0,0 +1,231 @@
1
+ /**
2
+ * Shared `wildo-saas.lock.json` IO primitives.
3
+ *
4
+ * Phase 1 graduates the locking + atomic-write surface validated by
5
+ * the Phase 0.B contention spike (`module-registry-analysis.md`)
6
+ * into `platform-config-lib`. Both the dev companion's
7
+ * `WildoSaasLockCompanionService` and the CLI-side
8
+ * `RegistryLockfileService` consume this module so concurrent
9
+ * writers — across processes (CLI + companion + minions) — never
10
+ * lose updates and never observe a half-written envelope.
11
+ *
12
+ * Exposes two layers:
13
+ *
14
+ * 1. `withLockfileMutate(opts, mutator)` — full-envelope mutate
15
+ * under `proper-lockfile` + `write-file-atomic`. The companion
16
+ * uses this so it can preserve its full-envelope contract and
17
+ * validate its companion-owned i18n schema in the same pass.
18
+ *
19
+ * 2. `withLockfileSectionMutate(opts, mutator)` — section-scoped
20
+ * mutate. The CLI uses this so it can ONLY touch one section
21
+ * (e.g. `sections.modules`) and never accidentally clobber a
22
+ * sibling section.
23
+ *
24
+ * Both layers preserve unknown sections verbatim — every consumer
25
+ * MUST round-trip every `sections.*` key it does not recognize.
26
+ *
27
+ * Hard contract (KD-4 / KD-15 / KD-18):
28
+ * - The library NEVER writes provider runtime artifacts under
29
+ * `.wildo-saas/generated/providers/*.runtime-providers.generated.json` or
30
+ * `src/generated/wildo-provider-runtime.generated.ts`. Those are
31
+ * produced by the provider materialization workflow alone.
32
+ * - `sections.providers.runtimeScopes` is owned end-to-end by the
33
+ * provider workstream; module-registry callers MUST NOT mutate it.
34
+ * This module is unaware of the provider section beyond
35
+ * preserving its bytes.
36
+ */
37
+ import { z } from 'zod';
38
+ import { type SaasLockfileEnvelope } from './wildo-saas-lock.shared.schemas';
39
+ /**
40
+ * Canonical path of the saas-app lockfile, relative to the saas root.
41
+ */
42
+ export declare const WILDO_SAAS_LOCK_RELATIVE_PATH = ".wildo-saas/wildo-saas.lock.json";
43
+ /**
44
+ * Build the absolute lockfile path for a given saas root.
45
+ */
46
+ export declare function getWildoSaasLockPath(saasRoot: string): string;
47
+ /**
48
+ * Default `proper-lockfile` options. The 5s `stale` window matches
49
+ * the Phase 0.B spike (`module-registry-analysis.md` Phase 0.B
50
+ * Findings): typical lock-hold time is < 50ms; 5s is generous enough
51
+ * to absorb a CI pause without compromising legitimate locks. Tests
52
+ * 4a-4d all passed under these settings.
53
+ *
54
+ * `realpath: false` is required when the saas root is symlinked
55
+ * (common with pnpm `dependenciesMeta.injected: true` workspaces).
56
+ */
57
+ export declare const DEFAULT_LOCK_OPTIONS: {
58
+ readonly retries: {
59
+ readonly retries: 200;
60
+ readonly minTimeout: 5;
61
+ readonly maxTimeout: 50;
62
+ readonly factor: 1.2;
63
+ };
64
+ readonly stale: 5000;
65
+ readonly realpath: false;
66
+ };
67
+ /**
68
+ * The result of merging caller options over {@link DEFAULT_LOCK_OPTIONS}.
69
+ *
70
+ * Its leaves are WIDENED (`number` / `boolean`) and that is the point: the
71
+ * defaults are `as const`, so `typeof DEFAULT_LOCK_OPTIONS` describes those exact
72
+ * literals — `stale: 5000`, `realpath: false`. A merge that honours a caller
73
+ * override cannot satisfy it, because an overridden `stale` is not `5000`.
74
+ *
75
+ * Annotating the merge as `typeof DEFAULT_LOCK_OPTIONS` claimed the result was
76
+ * always the defaults, which is true only when nothing was overridden — i.e. in
77
+ * the one case the function exists to avoid.
78
+ */
79
+ export type ResolvedLockOptions = {
80
+ /**
81
+ * Either a retry POLICY or a bare attempt count — `proper-lockfile` accepts
82
+ * both, and the merge passes a bare number straight through
83
+ * (`overrideRetries ?? baseRetries`). Omitting `number` made the merge unable to
84
+ * describe its own fallback branch.
85
+ */
86
+ readonly retries: number | {
87
+ retries?: number;
88
+ minTimeout?: number;
89
+ maxTimeout?: number;
90
+ factor?: number;
91
+ };
92
+ readonly stale: number;
93
+ readonly realpath: boolean;
94
+ };
95
+ export interface LockfileMutateOptions {
96
+ /** Absolute path to the saas application root. */
97
+ saasRoot: string;
98
+ /**
99
+ * Optional Zod schemas to validate sibling sections at parse time.
100
+ * Companion-owned sections (e.g. `i18n`) are validated by passing
101
+ * them here. CLI callers can pass
102
+ * `DEFAULT_REGISTRY_SECTION_SCHEMAS` to validate `modules`.
103
+ *
104
+ * Sections not listed here are still PRESERVED on round-trip via
105
+ * the envelope's `.catchall(z.unknown())` — they are simply not
106
+ * type-narrowed.
107
+ */
108
+ sectionSchemas?: Record<string, z.ZodTypeAny>;
109
+ /**
110
+ * Override `proper-lockfile` options. Phase 0.B's measurements
111
+ * suggest the defaults are fine for both CLI and companion
112
+ * call patterns; this hook exists for tests + tuning.
113
+ */
114
+ lockOptions?: DedicatedFileLockOptions;
115
+ /**
116
+ * If true (default), the lockfile is created on first read with an
117
+ * empty `sections` map. Set to false to fail with ENOENT.
118
+ */
119
+ createIfMissing?: boolean;
120
+ }
121
+ /**
122
+ * Read the lockfile envelope, applying schema validation.
123
+ *
124
+ * - Returns a fresh empty envelope if the file does not exist
125
+ * (and `createIfMissing` is not explicitly false).
126
+ * - Validates the canonical envelope shape (schemaVersion, generatedAt,
127
+ * sections) against `SaasLockfileEnvelopeSchema`.
128
+ * - Applies caller-supplied `sectionSchemas` after the envelope
129
+ * shape passes — failures throw a `ZodError` so the caller knows
130
+ * exactly which section + field rejected.
131
+ *
132
+ * Does NOT acquire a lock; reads are unsynchronized. Callers that
133
+ * need read-after-write coherence must read INSIDE `withLockfileMutate`.
134
+ */
135
+ export declare function readWildoSaasLock(options: Pick<LockfileMutateOptions, 'saasRoot' | 'sectionSchemas' | 'createIfMissing'>): Promise<SaasLockfileEnvelope>;
136
+ /**
137
+ * Read-modify-write a lockfile under an OS-level lock.
138
+ *
139
+ * The mutator receives a deep-cloned, schema-validated envelope —
140
+ * any in-place mutation is safe and won't bleed back into the
141
+ * pre-write copy. After the mutator returns, the result is
142
+ * re-validated against the envelope schema (and any caller-supplied
143
+ * `sectionSchemas`) before being atomically written.
144
+ *
145
+ * `generatedAt` is always refreshed after a successful mutation.
146
+ *
147
+ * The library never inspects `sections.providers.runtimeScopes`,
148
+ * `sections.modules`, or `sections.i18n` — it only enforces the
149
+ * envelope shape. Concrete section semantics live in their owning
150
+ * subsystems.
151
+ */
152
+ export declare function withLockfileMutate(options: LockfileMutateOptions, mutator: (envelope: SaasLockfileEnvelope) => void | Promise<void>): Promise<SaasLockfileEnvelope>;
153
+ /**
154
+ * Hold an OS-level `proper-lockfile` lock on an ARBITRARY dedicated lock
155
+ * target while `fn` runs — the path-parameterized sibling of
156
+ * `withLockfileMutate` for callers that need cross-process mutual
157
+ * exclusion WITHOUT the `wildo-saas.lock.json` envelope semantics.
158
+ *
159
+ * Why this exists (meta-workflows P-20, 2026-07-03): the companion's
160
+ * coding-agent dispatch lane serializes workspace mutations on a
161
+ * dedicated target (`<saasRoot>/.wildo-saas/state/workspace-mutation.lock`)
162
+ * held for the WHOLE agent run (minutes). Routing that through
163
+ * `withLockfileMutate` would hold the shared saas lockfile hostage —
164
+ * starving i18n/registry writers — and the envelope re-validation is
165
+ * meaningless for a pure mutex. The primitive lives HERE (not
166
+ * companion-local) so the CLI can adopt the SAME lock target with the
167
+ * SAME semantics when its worktree-mutating commands learn to respect it.
168
+ *
169
+ * Semantics:
170
+ * - Parent directory + an empty placeholder file are created if missing
171
+ * (`proper-lockfile` refuses ENOENT targets). The file content is never
172
+ * read or written by this helper — it is a pure lock anchor.
173
+ * - `proper-lockfile` auto-refreshes the lock mtime while the holder is
174
+ * alive, so long-running holds survive the `stale` window; a crashed
175
+ * holder's lock goes stale and is reclaimed by the next acquirer.
176
+ * - Lock options merge over {@link DEFAULT_LOCK_OPTIONS}. Callers that
177
+ * want fail-fast contention (HTTP 409 instead of queueing) pass
178
+ * `{ retries: { retries: 0 } }`.
179
+ * - The lock is always released (or at least attempted) on completion,
180
+ * including the error path.
181
+ *
182
+ * Contention surfaces as the `proper-lockfile` `ELOCKED` error
183
+ * (`error.code === 'ELOCKED'`) — callers map it to their own conflict
184
+ * vocabulary.
185
+ */
186
+ export interface DedicatedFileLockOptions {
187
+ /** `proper-lockfile` retry policy — `{ retries: { retries: 0 } }` = fail-fast contention. */
188
+ retries?: {
189
+ retries?: number;
190
+ minTimeout?: number;
191
+ maxTimeout?: number;
192
+ factor?: number;
193
+ };
194
+ /** Stale window in ms (lock mtime auto-refreshes while the holder lives). */
195
+ stale?: number;
196
+ /** Keep `false` for symlinked (pnpm-injected) workspaces. */
197
+ realpath?: boolean;
198
+ }
199
+ export declare function withDedicatedFileLock<T>(lockTargetPath: string, fn: () => Promise<T>, lockOptions?: DedicatedFileLockOptions): Promise<T>;
200
+ /**
201
+ * Canonical workspace-mutation lock target, app-root-relative. ONE constant
202
+ * shared by every process that mutates the application worktree in a way
203
+ * that must serialize against coding-agent dispatch runs (meta-workflows
204
+ * P-20): the companion's dispatch lane holds it for the whole agent run;
205
+ * CLI worktree-writers (e.g. `wildo config sync`) acquire it fail-fast
206
+ * around their write phase. Deliberately NOT taken by human/parallel-session
207
+ * edits (P-19b — per-file attribution compensates, never exclusion).
208
+ * Keep companion and CLI on THIS constant — a hand-copied path is drift.
209
+ */
210
+ export declare const WORKSPACE_MUTATION_LOCK_RELATIVE_PATH: string;
211
+ /** Absolute workspace-mutation lock target for an application root. */
212
+ export declare function getWorkspaceMutationLockPath(saasRoot: string): string;
213
+ /**
214
+ * Section-scoped mutate. The mutator only sees one section's payload
215
+ * (`sections.<sectionKey>`) and CANNOT reach sibling sections —
216
+ * preventing accidental clobbers. Returns the mutated section.
217
+ *
218
+ * Use this from CLI callers (`RegistryLockfileService`) so cross-
219
+ * section bugs are impossible by construction. Companion callers
220
+ * that legitimately need full-envelope access keep using
221
+ * `withLockfileMutate` directly.
222
+ */
223
+ export declare function withLockfileSectionMutate<S>(options: LockfileMutateOptions & {
224
+ /** Section key under `sections` (e.g. `'modules'`, `'i18n'`). */
225
+ sectionKey: string;
226
+ /** Zod schema validating the section payload. Required. */
227
+ sectionSchema: z.ZodType<S>;
228
+ /** Initial value when the section does not yet exist. */
229
+ initialSection: () => S;
230
+ }, mutator: (section: S) => S | void | Promise<S | void>): Promise<S>;
231
+ //# sourceMappingURL=lockfile-io.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lockfile-io.d.ts","sourceRoot":"","sources":["../../../../src/lockfile/lockfile-io.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,303 @@
1
+ /**
2
+ * Shared `wildo-saas.lock.json` IO primitives.
3
+ *
4
+ * Phase 1 graduates the locking + atomic-write surface validated by
5
+ * the Phase 0.B contention spike (`module-registry-analysis.md`)
6
+ * into `platform-config-lib`. Both the dev companion's
7
+ * `WildoSaasLockCompanionService` and the CLI-side
8
+ * `RegistryLockfileService` consume this module so concurrent
9
+ * writers — across processes (CLI + companion + minions) — never
10
+ * lose updates and never observe a half-written envelope.
11
+ *
12
+ * Exposes two layers:
13
+ *
14
+ * 1. `withLockfileMutate(opts, mutator)` — full-envelope mutate
15
+ * under `proper-lockfile` + `write-file-atomic`. The companion
16
+ * uses this so it can preserve its full-envelope contract and
17
+ * validate its companion-owned i18n schema in the same pass.
18
+ *
19
+ * 2. `withLockfileSectionMutate(opts, mutator)` — section-scoped
20
+ * mutate. The CLI uses this so it can ONLY touch one section
21
+ * (e.g. `sections.modules`) and never accidentally clobber a
22
+ * sibling section.
23
+ *
24
+ * Both layers preserve unknown sections verbatim — every consumer
25
+ * MUST round-trip every `sections.*` key it does not recognize.
26
+ *
27
+ * Hard contract (KD-4 / KD-15 / KD-18):
28
+ * - The library NEVER writes provider runtime artifacts under
29
+ * `.wildo-saas/generated/providers/*.runtime-providers.generated.json` or
30
+ * `src/generated/wildo-provider-runtime.generated.ts`. Those are
31
+ * produced by the provider materialization workflow alone.
32
+ * - `sections.providers.runtimeScopes` is owned end-to-end by the
33
+ * provider workstream; module-registry callers MUST NOT mutate it.
34
+ * This module is unaware of the provider section beyond
35
+ * preserving its bytes.
36
+ */
37
+ import { promises as fs } from 'node:fs';
38
+ import * as path from 'node:path';
39
+ import lockfile from 'proper-lockfile';
40
+ import writeFileAtomic from 'write-file-atomic';
41
+ import { SaasLockfileEnvelopeSchema, } from './wildo-saas-lock.shared.schemas.js';
42
+ /**
43
+ * Canonical path of the saas-app lockfile, relative to the saas root.
44
+ */
45
+ export const WILDO_SAAS_LOCK_RELATIVE_PATH = '.wildo-saas/wildo-saas.lock.json';
46
+ /**
47
+ * Build the absolute lockfile path for a given saas root.
48
+ */
49
+ export function getWildoSaasLockPath(saasRoot) {
50
+ return path.resolve(saasRoot, WILDO_SAAS_LOCK_RELATIVE_PATH);
51
+ }
52
+ /**
53
+ * Default `proper-lockfile` options. The 5s `stale` window matches
54
+ * the Phase 0.B spike (`module-registry-analysis.md` Phase 0.B
55
+ * Findings): typical lock-hold time is < 50ms; 5s is generous enough
56
+ * to absorb a CI pause without compromising legitimate locks. Tests
57
+ * 4a-4d all passed under these settings.
58
+ *
59
+ * `realpath: false` is required when the saas root is symlinked
60
+ * (common with pnpm `dependenciesMeta.injected: true` workspaces).
61
+ */
62
+ export const DEFAULT_LOCK_OPTIONS = {
63
+ retries: { retries: 200, minTimeout: 5, maxTimeout: 50, factor: 1.2 },
64
+ stale: 5000,
65
+ realpath: false,
66
+ };
67
+ /**
68
+ * Deep-merge caller-supplied lock options on top of `DEFAULT_LOCK_OPTIONS`.
69
+ *
70
+ * Phase 1 review (M-2.1): a shallow merge replaced the entire
71
+ * `retries` object whenever a caller passed a partial — so
72
+ * `lockOptions: { retries: { retries: 5 } }` silently lost the
73
+ * `minTimeout`/`maxTimeout`/`factor` defaults that Phase 0.B
74
+ * validated. The deep merge keeps every default intact unless
75
+ * the caller explicitly overrides each leaf.
76
+ */
77
+ function mergeLockOptions(
78
+ // `DedicatedFileLockOptions`, NOT `Partial<typeof DEFAULT_LOCK_OPTIONS>`: that constant is
79
+ // `as const`, so every leaf is a LITERAL type and `Partial` only reaches the top level — which
80
+ // made the very call shape this merge exists to support (`{ retries: { retries: 5 } }`) a type
81
+ // error, because `5` is not `200`. It also removes the cast the dedicated-lock caller needed.
82
+ override) {
83
+ if (!override)
84
+ return DEFAULT_LOCK_OPTIONS;
85
+ const baseRetries = DEFAULT_LOCK_OPTIONS.retries;
86
+ const overrideRetries = override.retries;
87
+ const mergedRetries = typeof overrideRetries === 'object' && overrideRetries !== null
88
+ ? { ...baseRetries, ...overrideRetries }
89
+ : overrideRetries ?? baseRetries;
90
+ return {
91
+ ...DEFAULT_LOCK_OPTIONS,
92
+ ...override,
93
+ retries: mergedRetries,
94
+ };
95
+ }
96
+ /**
97
+ * Read the lockfile envelope, applying schema validation.
98
+ *
99
+ * - Returns a fresh empty envelope if the file does not exist
100
+ * (and `createIfMissing` is not explicitly false).
101
+ * - Validates the canonical envelope shape (schemaVersion, generatedAt,
102
+ * sections) against `SaasLockfileEnvelopeSchema`.
103
+ * - Applies caller-supplied `sectionSchemas` after the envelope
104
+ * shape passes — failures throw a `ZodError` so the caller knows
105
+ * exactly which section + field rejected.
106
+ *
107
+ * Does NOT acquire a lock; reads are unsynchronized. Callers that
108
+ * need read-after-write coherence must read INSIDE `withLockfileMutate`.
109
+ */
110
+ export async function readWildoSaasLock(options) {
111
+ const filePath = getWildoSaasLockPath(options.saasRoot);
112
+ let raw;
113
+ try {
114
+ raw = await fs.readFile(filePath, 'utf8');
115
+ }
116
+ catch (err) {
117
+ if (err.code === 'ENOENT' && options.createIfMissing !== false) {
118
+ return {
119
+ schemaVersion: 2,
120
+ generatedAt: new Date().toISOString(),
121
+ sections: {},
122
+ };
123
+ }
124
+ throw err;
125
+ }
126
+ const json = JSON.parse(raw);
127
+ const envelope = SaasLockfileEnvelopeSchema.parse(json);
128
+ if (options.sectionSchemas) {
129
+ validateAndNormalizeSections(envelope.sections, options.sectionSchemas);
130
+ }
131
+ return envelope;
132
+ }
133
+ /**
134
+ * Validate every present `sections.<key>` against its caller-supplied
135
+ * Zod schema AND write the parsed (default-expanded) value back so
136
+ * defaults declared in those schemas actually persist on disk.
137
+ *
138
+ * Phase 1 review (H-2.1 / M-1.2): the prior implementation called
139
+ * `.parse(value)` and discarded the result, which meant
140
+ * `.default(...)` clauses in section schemas were only ever applied
141
+ * during validation — never written. Schemas with shallow defaults
142
+ * (e.g. `installed: z.record(...).default({})`) tolerated the bug
143
+ * because mutators always set `installed` directly, but a future
144
+ * schema with deep defaults would silently lose them.
145
+ */
146
+ function validateAndNormalizeSections(sections, sectionSchemas) {
147
+ const mutable = sections;
148
+ for (const [key, schema] of Object.entries(sectionSchemas)) {
149
+ const value = mutable[key];
150
+ if (value === undefined)
151
+ continue;
152
+ mutable[key] = schema.parse(value);
153
+ }
154
+ }
155
+ /**
156
+ * Acquire the OS-level lockfile lock, run `fn`, then release it.
157
+ *
158
+ * Wrapper around `proper-lockfile` that:
159
+ * - Creates the parent dir + an empty file if missing (proper-lockfile
160
+ * refuses to lock a non-existent file).
161
+ * - Forwards `realpath: false` so symlinked workspaces lock correctly.
162
+ * - Always releases the lock, even on error.
163
+ */
164
+ async function withLock(filePath, fn,
165
+ // A MERGED value, not the defaults — see `ResolvedLockOptions`. Typing this as
166
+ // `typeof DEFAULT_LOCK_OPTIONS` demanded the literal `200`/`5000`/`false`, so any
167
+ // caller-overridden option was a type error at the point of USE rather than at
168
+ // the point of override, which is why it read as a failure in the merge.
169
+ lockOptions) {
170
+ await fs.mkdir(path.dirname(filePath), { recursive: true });
171
+ // Ensure the file exists; `proper-lockfile.lock` refuses ENOENT.
172
+ try {
173
+ await fs.access(filePath);
174
+ }
175
+ catch {
176
+ await writeFileAtomicAsync(filePath, JSON.stringify(emptyEnvelope(), null, 2));
177
+ }
178
+ const release = await lockfile.lock(filePath, lockOptions);
179
+ try {
180
+ return await fn();
181
+ }
182
+ finally {
183
+ await release();
184
+ }
185
+ }
186
+ function emptyEnvelope() {
187
+ return {
188
+ schemaVersion: 2,
189
+ generatedAt: new Date().toISOString(),
190
+ sections: {},
191
+ };
192
+ }
193
+ async function writeFileAtomicAsync(filePath, content) {
194
+ await new Promise((resolve, reject) => {
195
+ writeFileAtomic(filePath, content, (err) => {
196
+ if (err)
197
+ reject(err);
198
+ else
199
+ resolve();
200
+ });
201
+ });
202
+ }
203
+ /**
204
+ * Read-modify-write a lockfile under an OS-level lock.
205
+ *
206
+ * The mutator receives a deep-cloned, schema-validated envelope —
207
+ * any in-place mutation is safe and won't bleed back into the
208
+ * pre-write copy. After the mutator returns, the result is
209
+ * re-validated against the envelope schema (and any caller-supplied
210
+ * `sectionSchemas`) before being atomically written.
211
+ *
212
+ * `generatedAt` is always refreshed after a successful mutation.
213
+ *
214
+ * The library never inspects `sections.providers.runtimeScopes`,
215
+ * `sections.modules`, or `sections.i18n` — it only enforces the
216
+ * envelope shape. Concrete section semantics live in their owning
217
+ * subsystems.
218
+ */
219
+ export async function withLockfileMutate(options, mutator) {
220
+ const filePath = getWildoSaasLockPath(options.saasRoot);
221
+ const lockOptions = mergeLockOptions(options.lockOptions);
222
+ return withLock(filePath, async () => {
223
+ const before = await readWildoSaasLock({
224
+ saasRoot: options.saasRoot,
225
+ sectionSchemas: options.sectionSchemas,
226
+ createIfMissing: true,
227
+ });
228
+ const next = structuredClone(before);
229
+ await mutator(next);
230
+ next.generatedAt = new Date().toISOString();
231
+ // Re-validate AFTER mutation; the mutator may have introduced
232
+ // structurally-invalid input.
233
+ SaasLockfileEnvelopeSchema.parse(next);
234
+ if (options.sectionSchemas) {
235
+ validateAndNormalizeSections(next.sections, options.sectionSchemas);
236
+ }
237
+ await writeFileAtomicAsync(filePath, JSON.stringify(next, null, 2) + '\n');
238
+ return next;
239
+ }, lockOptions);
240
+ }
241
+ export async function withDedicatedFileLock(lockTargetPath, fn, lockOptions) {
242
+ await fs.mkdir(path.dirname(lockTargetPath), { recursive: true });
243
+ try {
244
+ await fs.access(lockTargetPath);
245
+ }
246
+ catch {
247
+ await writeFileAtomicAsync(lockTargetPath, '');
248
+ }
249
+ const release = await lockfile.lock(lockTargetPath, mergeLockOptions(lockOptions));
250
+ try {
251
+ return await fn();
252
+ }
253
+ finally {
254
+ await release();
255
+ }
256
+ }
257
+ /**
258
+ * Canonical workspace-mutation lock target, app-root-relative. ONE constant
259
+ * shared by every process that mutates the application worktree in a way
260
+ * that must serialize against coding-agent dispatch runs (meta-workflows
261
+ * P-20): the companion's dispatch lane holds it for the whole agent run;
262
+ * CLI worktree-writers (e.g. `wildo config sync`) acquire it fail-fast
263
+ * around their write phase. Deliberately NOT taken by human/parallel-session
264
+ * edits (P-19b — per-file attribution compensates, never exclusion).
265
+ * Keep companion and CLI on THIS constant — a hand-copied path is drift.
266
+ */
267
+ export const WORKSPACE_MUTATION_LOCK_RELATIVE_PATH = '.wildo-saas/state/workspace-mutation.lock';
268
+ /** Absolute workspace-mutation lock target for an application root. */
269
+ export function getWorkspaceMutationLockPath(saasRoot) {
270
+ return path.join(saasRoot, WORKSPACE_MUTATION_LOCK_RELATIVE_PATH);
271
+ }
272
+ /**
273
+ * Section-scoped mutate. The mutator only sees one section's payload
274
+ * (`sections.<sectionKey>`) and CANNOT reach sibling sections —
275
+ * preventing accidental clobbers. Returns the mutated section.
276
+ *
277
+ * Use this from CLI callers (`RegistryLockfileService`) so cross-
278
+ * section bugs are impossible by construction. Companion callers
279
+ * that legitimately need full-envelope access keep using
280
+ * `withLockfileMutate` directly.
281
+ */
282
+ export async function withLockfileSectionMutate(options, mutator) {
283
+ let mutatedOut;
284
+ await withLockfileMutate({
285
+ saasRoot: options.saasRoot,
286
+ lockOptions: options.lockOptions,
287
+ sectionSchemas: {
288
+ ...options.sectionSchemas,
289
+ [options.sectionKey]: options.sectionSchema,
290
+ },
291
+ }, async (envelope) => {
292
+ const sections = envelope.sections;
293
+ const current = sections[options.sectionKey] ?? options.initialSection();
294
+ const cloned = structuredClone(current);
295
+ const ret = await mutator(cloned);
296
+ const next = (ret ?? cloned);
297
+ // Per-section validation (also covers initial-default re-validation).
298
+ mutatedOut = options.sectionSchema.parse(next);
299
+ sections[options.sectionKey] = mutatedOut;
300
+ });
301
+ return mutatedOut;
302
+ }
303
+ //# sourceMappingURL=lockfile-io.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lockfile-io.js","sourceRoot":"","sources":["../../../../src/lockfile/lockfile-io.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared `wildo-saas.lock.json` IO primitives.\n *\n * Phase 1 graduates the locking + atomic-write surface validated by\n * the Phase 0.B contention spike (`module-registry-analysis.md`)\n * into `platform-config-lib`. Both the dev companion's\n * `WildoSaasLockCompanionService` and the CLI-side\n * `RegistryLockfileService` consume this module so concurrent\n * writers — across processes (CLI + companion + minions) — never\n * lose updates and never observe a half-written envelope.\n *\n * Exposes two layers:\n *\n * 1. `withLockfileMutate(opts, mutator)` — full-envelope mutate\n * under `proper-lockfile` + `write-file-atomic`. The companion\n * uses this so it can preserve its full-envelope contract and\n * validate its companion-owned i18n schema in the same pass.\n *\n * 2. `withLockfileSectionMutate(opts, mutator)` — section-scoped\n * mutate. The CLI uses this so it can ONLY touch one section\n * (e.g. `sections.modules`) and never accidentally clobber a\n * sibling section.\n *\n * Both layers preserve unknown sections verbatim — every consumer\n * MUST round-trip every `sections.*` key it does not recognize.\n *\n * Hard contract (KD-4 / KD-15 / KD-18):\n * - The library NEVER writes provider runtime artifacts under\n * `.wildo-saas/generated/providers/*.runtime-providers.generated.json` or\n * `src/generated/wildo-provider-runtime.generated.ts`. Those are\n * produced by the provider materialization workflow alone.\n * - `sections.providers.runtimeScopes` is owned end-to-end by the\n * provider workstream; module-registry callers MUST NOT mutate it.\n * This module is unaware of the provider section beyond\n * preserving its bytes.\n */\n\nimport { promises as fs } from 'node:fs';\nimport * as path from 'node:path';\nimport lockfile from 'proper-lockfile';\nimport writeFileAtomic from 'write-file-atomic';\nimport { z } from 'zod';\nimport {\n SaasLockfileEnvelopeSchema,\n type SaasLockfileEnvelope,\n type SaasLockfileKnownSections,\n} from './wildo-saas-lock.shared.schemas';\n\n/**\n * Canonical path of the saas-app lockfile, relative to the saas root.\n */\nexport const WILDO_SAAS_LOCK_RELATIVE_PATH = '.wildo-saas/wildo-saas.lock.json';\n\n/**\n * Build the absolute lockfile path for a given saas root.\n */\nexport function getWildoSaasLockPath(saasRoot: string): string {\n return path.resolve(saasRoot, WILDO_SAAS_LOCK_RELATIVE_PATH);\n}\n\n/**\n * Default `proper-lockfile` options. The 5s `stale` window matches\n * the Phase 0.B spike (`module-registry-analysis.md` Phase 0.B\n * Findings): typical lock-hold time is < 50ms; 5s is generous enough\n * to absorb a CI pause without compromising legitimate locks. Tests\n * 4a-4d all passed under these settings.\n *\n * `realpath: false` is required when the saas root is symlinked\n * (common with pnpm `dependenciesMeta.injected: true` workspaces).\n */\nexport const DEFAULT_LOCK_OPTIONS = {\n retries: { retries: 200, minTimeout: 5, maxTimeout: 50, factor: 1.2 },\n stale: 5000,\n realpath: false,\n} as const satisfies Parameters<typeof lockfile.lock>[1];\n\n/**\n * The result of merging caller options over {@link DEFAULT_LOCK_OPTIONS}.\n *\n * Its leaves are WIDENED (`number` / `boolean`) and that is the point: the\n * defaults are `as const`, so `typeof DEFAULT_LOCK_OPTIONS` describes those exact\n * literals — `stale: 5000`, `realpath: false`. A merge that honours a caller\n * override cannot satisfy it, because an overridden `stale` is not `5000`.\n *\n * Annotating the merge as `typeof DEFAULT_LOCK_OPTIONS` claimed the result was\n * always the defaults, which is true only when nothing was overridden — i.e. in\n * the one case the function exists to avoid.\n */\nexport type ResolvedLockOptions = {\n /**\n * Either a retry POLICY or a bare attempt count — `proper-lockfile` accepts\n * both, and the merge passes a bare number straight through\n * (`overrideRetries ?? baseRetries`). Omitting `number` made the merge unable to\n * describe its own fallback branch.\n */\n readonly retries: number | { retries?: number; minTimeout?: number; maxTimeout?: number; factor?: number };\n readonly stale: number;\n readonly realpath: boolean;\n};\n\n/**\n * Deep-merge caller-supplied lock options on top of `DEFAULT_LOCK_OPTIONS`.\n *\n * Phase 1 review (M-2.1): a shallow merge replaced the entire\n * `retries` object whenever a caller passed a partial — so\n * `lockOptions: { retries: { retries: 5 } }` silently lost the\n * `minTimeout`/`maxTimeout`/`factor` defaults that Phase 0.B\n * validated. The deep merge keeps every default intact unless\n * the caller explicitly overrides each leaf.\n */\nfunction mergeLockOptions(\n // `DedicatedFileLockOptions`, NOT `Partial<typeof DEFAULT_LOCK_OPTIONS>`: that constant is\n // `as const`, so every leaf is a LITERAL type and `Partial` only reaches the top level — which\n // made the very call shape this merge exists to support (`{ retries: { retries: 5 } }`) a type\n // error, because `5` is not `200`. It also removes the cast the dedicated-lock caller needed.\n override?: DedicatedFileLockOptions,\n): ResolvedLockOptions {\n if (!override) return DEFAULT_LOCK_OPTIONS;\n const baseRetries = DEFAULT_LOCK_OPTIONS.retries;\n const overrideRetries = override.retries;\n const mergedRetries =\n typeof overrideRetries === 'object' && overrideRetries !== null\n ? { ...baseRetries, ...overrideRetries }\n : overrideRetries ?? baseRetries;\n return {\n ...DEFAULT_LOCK_OPTIONS,\n ...override,\n retries: mergedRetries,\n };\n}\n\nexport interface LockfileMutateOptions {\n /** Absolute path to the saas application root. */\n saasRoot: string;\n /**\n * Optional Zod schemas to validate sibling sections at parse time.\n * Companion-owned sections (e.g. `i18n`) are validated by passing\n * them here. CLI callers can pass\n * `DEFAULT_REGISTRY_SECTION_SCHEMAS` to validate `modules`.\n *\n * Sections not listed here are still PRESERVED on round-trip via\n * the envelope's `.catchall(z.unknown())` — they are simply not\n * type-narrowed.\n */\n sectionSchemas?: Record<string, z.ZodTypeAny>;\n /**\n * Override `proper-lockfile` options. Phase 0.B's measurements\n * suggest the defaults are fine for both CLI and companion\n * call patterns; this hook exists for tests + tuning.\n */\n lockOptions?: DedicatedFileLockOptions;\n /**\n * If true (default), the lockfile is created on first read with an\n * empty `sections` map. Set to false to fail with ENOENT.\n */\n createIfMissing?: boolean;\n}\n\n/**\n * Read the lockfile envelope, applying schema validation.\n *\n * - Returns a fresh empty envelope if the file does not exist\n * (and `createIfMissing` is not explicitly false).\n * - Validates the canonical envelope shape (schemaVersion, generatedAt,\n * sections) against `SaasLockfileEnvelopeSchema`.\n * - Applies caller-supplied `sectionSchemas` after the envelope\n * shape passes — failures throw a `ZodError` so the caller knows\n * exactly which section + field rejected.\n *\n * Does NOT acquire a lock; reads are unsynchronized. Callers that\n * need read-after-write coherence must read INSIDE `withLockfileMutate`.\n */\nexport async function readWildoSaasLock(\n options: Pick<LockfileMutateOptions, 'saasRoot' | 'sectionSchemas' | 'createIfMissing'>,\n): Promise<SaasLockfileEnvelope> {\n const filePath = getWildoSaasLockPath(options.saasRoot);\n let raw: string;\n try {\n raw = await fs.readFile(filePath, 'utf8');\n } catch (err) {\n if ((err as NodeJS.ErrnoException).code === 'ENOENT' && options.createIfMissing !== false) {\n return {\n schemaVersion: 2,\n generatedAt: new Date().toISOString(),\n sections: {},\n };\n }\n throw err;\n }\n const json = JSON.parse(raw) as unknown;\n const envelope = SaasLockfileEnvelopeSchema.parse(json);\n if (options.sectionSchemas) {\n validateAndNormalizeSections(envelope.sections, options.sectionSchemas);\n }\n return envelope;\n}\n\n/**\n * Validate every present `sections.<key>` against its caller-supplied\n * Zod schema AND write the parsed (default-expanded) value back so\n * defaults declared in those schemas actually persist on disk.\n *\n * Phase 1 review (H-2.1 / M-1.2): the prior implementation called\n * `.parse(value)` and discarded the result, which meant\n * `.default(...)` clauses in section schemas were only ever applied\n * during validation — never written. Schemas with shallow defaults\n * (e.g. `installed: z.record(...).default({})`) tolerated the bug\n * because mutators always set `installed` directly, but a future\n * schema with deep defaults would silently lose them.\n */\nfunction validateAndNormalizeSections(\n sections: SaasLockfileKnownSections,\n sectionSchemas: Record<string, z.ZodTypeAny>,\n): void {\n const mutable = sections as Record<string, unknown>;\n for (const [key, schema] of Object.entries(sectionSchemas)) {\n const value = mutable[key];\n if (value === undefined) continue;\n mutable[key] = schema.parse(value);\n }\n}\n\n/**\n * Acquire the OS-level lockfile lock, run `fn`, then release it.\n *\n * Wrapper around `proper-lockfile` that:\n * - Creates the parent dir + an empty file if missing (proper-lockfile\n * refuses to lock a non-existent file).\n * - Forwards `realpath: false` so symlinked workspaces lock correctly.\n * - Always releases the lock, even on error.\n */\nasync function withLock<T>(\n filePath: string,\n fn: () => Promise<T>,\n // A MERGED value, not the defaults — see `ResolvedLockOptions`. Typing this as\n // `typeof DEFAULT_LOCK_OPTIONS` demanded the literal `200`/`5000`/`false`, so any\n // caller-overridden option was a type error at the point of USE rather than at\n // the point of override, which is why it read as a failure in the merge.\n lockOptions: ResolvedLockOptions,\n): Promise<T> {\n await fs.mkdir(path.dirname(filePath), { recursive: true });\n // Ensure the file exists; `proper-lockfile.lock` refuses ENOENT.\n try {\n await fs.access(filePath);\n } catch {\n await writeFileAtomicAsync(filePath, JSON.stringify(emptyEnvelope(), null, 2));\n }\n const release = await lockfile.lock(filePath, lockOptions);\n try {\n return await fn();\n } finally {\n await release();\n }\n}\n\nfunction emptyEnvelope(): SaasLockfileEnvelope {\n return {\n schemaVersion: 2,\n generatedAt: new Date().toISOString(),\n sections: {},\n };\n}\n\nasync function writeFileAtomicAsync(filePath: string, content: string): Promise<void> {\n await new Promise<void>((resolve, reject) => {\n writeFileAtomic(filePath, content, (err: Error | undefined) => {\n if (err) reject(err);\n else resolve();\n });\n });\n}\n\n/**\n * Read-modify-write a lockfile under an OS-level lock.\n *\n * The mutator receives a deep-cloned, schema-validated envelope —\n * any in-place mutation is safe and won't bleed back into the\n * pre-write copy. After the mutator returns, the result is\n * re-validated against the envelope schema (and any caller-supplied\n * `sectionSchemas`) before being atomically written.\n *\n * `generatedAt` is always refreshed after a successful mutation.\n *\n * The library never inspects `sections.providers.runtimeScopes`,\n * `sections.modules`, or `sections.i18n` — it only enforces the\n * envelope shape. Concrete section semantics live in their owning\n * subsystems.\n */\nexport async function withLockfileMutate(\n options: LockfileMutateOptions,\n mutator: (envelope: SaasLockfileEnvelope) => void | Promise<void>,\n): Promise<SaasLockfileEnvelope> {\n const filePath = getWildoSaasLockPath(options.saasRoot);\n const lockOptions = mergeLockOptions(options.lockOptions);\n return withLock(filePath, async () => {\n const before = await readWildoSaasLock({\n saasRoot: options.saasRoot,\n sectionSchemas: options.sectionSchemas,\n createIfMissing: true,\n });\n const next: SaasLockfileEnvelope = structuredClone(before);\n await mutator(next);\n next.generatedAt = new Date().toISOString();\n // Re-validate AFTER mutation; the mutator may have introduced\n // structurally-invalid input.\n SaasLockfileEnvelopeSchema.parse(next);\n if (options.sectionSchemas) {\n validateAndNormalizeSections(next.sections, options.sectionSchemas);\n }\n await writeFileAtomicAsync(filePath, JSON.stringify(next, null, 2) + '\\n');\n return next;\n }, lockOptions);\n}\n\n/**\n * Hold an OS-level `proper-lockfile` lock on an ARBITRARY dedicated lock\n * target while `fn` runs — the path-parameterized sibling of\n * `withLockfileMutate` for callers that need cross-process mutual\n * exclusion WITHOUT the `wildo-saas.lock.json` envelope semantics.\n *\n * Why this exists (meta-workflows P-20, 2026-07-03): the companion's\n * coding-agent dispatch lane serializes workspace mutations on a\n * dedicated target (`<saasRoot>/.wildo-saas/state/workspace-mutation.lock`)\n * held for the WHOLE agent run (minutes). Routing that through\n * `withLockfileMutate` would hold the shared saas lockfile hostage —\n * starving i18n/registry writers — and the envelope re-validation is\n * meaningless for a pure mutex. The primitive lives HERE (not\n * companion-local) so the CLI can adopt the SAME lock target with the\n * SAME semantics when its worktree-mutating commands learn to respect it.\n *\n * Semantics:\n * - Parent directory + an empty placeholder file are created if missing\n * (`proper-lockfile` refuses ENOENT targets). The file content is never\n * read or written by this helper — it is a pure lock anchor.\n * - `proper-lockfile` auto-refreshes the lock mtime while the holder is\n * alive, so long-running holds survive the `stale` window; a crashed\n * holder's lock goes stale and is reclaimed by the next acquirer.\n * - Lock options merge over {@link DEFAULT_LOCK_OPTIONS}. Callers that\n * want fail-fast contention (HTTP 409 instead of queueing) pass\n * `{ retries: { retries: 0 } }`.\n * - The lock is always released (or at least attempted) on completion,\n * including the error path.\n *\n * Contention surfaces as the `proper-lockfile` `ELOCKED` error\n * (`error.code === 'ELOCKED'`) — callers map it to their own conflict\n * vocabulary.\n */\nexport interface DedicatedFileLockOptions {\n /** `proper-lockfile` retry policy — `{ retries: { retries: 0 } }` = fail-fast contention. */\n retries?: { retries?: number; minTimeout?: number; maxTimeout?: number; factor?: number };\n /** Stale window in ms (lock mtime auto-refreshes while the holder lives). */\n stale?: number;\n /** Keep `false` for symlinked (pnpm-injected) workspaces. */\n realpath?: boolean;\n}\n\nexport async function withDedicatedFileLock<T>(\n lockTargetPath: string,\n fn: () => Promise<T>,\n lockOptions?: DedicatedFileLockOptions,\n): Promise<T> {\n await fs.mkdir(path.dirname(lockTargetPath), { recursive: true });\n try {\n await fs.access(lockTargetPath);\n } catch {\n await writeFileAtomicAsync(lockTargetPath, '');\n }\n const release = await lockfile.lock(\n lockTargetPath,\n mergeLockOptions(lockOptions),\n );\n try {\n return await fn();\n } finally {\n await release();\n }\n}\n\n/**\n * Canonical workspace-mutation lock target, app-root-relative. ONE constant\n * shared by every process that mutates the application worktree in a way\n * that must serialize against coding-agent dispatch runs (meta-workflows\n * P-20): the companion's dispatch lane holds it for the whole agent run;\n * CLI worktree-writers (e.g. `wildo config sync`) acquire it fail-fast\n * around their write phase. Deliberately NOT taken by human/parallel-session\n * edits (P-19b — per-file attribution compensates, never exclusion).\n * Keep companion and CLI on THIS constant — a hand-copied path is drift.\n */\nexport const WORKSPACE_MUTATION_LOCK_RELATIVE_PATH: string =\n '.wildo-saas/state/workspace-mutation.lock';\n\n/** Absolute workspace-mutation lock target for an application root. */\nexport function getWorkspaceMutationLockPath(saasRoot: string): string {\n return path.join(saasRoot, WORKSPACE_MUTATION_LOCK_RELATIVE_PATH);\n}\n\n/**\n * Section-scoped mutate. The mutator only sees one section's payload\n * (`sections.<sectionKey>`) and CANNOT reach sibling sections —\n * preventing accidental clobbers. Returns the mutated section.\n *\n * Use this from CLI callers (`RegistryLockfileService`) so cross-\n * section bugs are impossible by construction. Companion callers\n * that legitimately need full-envelope access keep using\n * `withLockfileMutate` directly.\n */\nexport async function withLockfileSectionMutate<S>(\n options: LockfileMutateOptions & {\n /** Section key under `sections` (e.g. `'modules'`, `'i18n'`). */\n sectionKey: string;\n /** Zod schema validating the section payload. Required. */\n sectionSchema: z.ZodType<S>;\n /** Initial value when the section does not yet exist. */\n initialSection: () => S;\n },\n mutator: (section: S) => S | void | Promise<S | void>,\n): Promise<S> {\n let mutatedOut!: S;\n await withLockfileMutate(\n {\n saasRoot: options.saasRoot,\n lockOptions: options.lockOptions,\n sectionSchemas: {\n ...options.sectionSchemas,\n [options.sectionKey]: options.sectionSchema,\n },\n },\n async (envelope) => {\n const sections = envelope.sections as Record<string, unknown>;\n const current = (sections[options.sectionKey] as S | undefined) ?? options.initialSection();\n const cloned = structuredClone(current);\n const ret = await mutator(cloned);\n const next = (ret ?? cloned) as S;\n // Per-section validation (also covers initial-default re-validation).\n mutatedOut = options.sectionSchema.parse(next);\n sections[options.sectionKey] = mutatedOut;\n },\n );\n return mutatedOut;\n}\n"]}