@wildo-ai/saas-specifications 1.1.9 → 1.1.11

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 (928) hide show
  1. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts +5 -4
  2. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
  3. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js +5 -4
  4. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js.map +1 -1
  5. package/dist/esm/_catalogs/schema-org/index.js +1 -1
  6. package/dist/esm/_core/application-maturity/application-maturity.schemas.js +1 -1
  7. package/dist/esm/_core/application-maturity/application-maturity.schemas.js.map +1 -1
  8. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts +11 -0
  9. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts.map +1 -1
  10. package/dist/esm/_core/application-specification-family-identity.schemas.js +11 -0
  11. package/dist/esm/_core/application-specification-family-identity.schemas.js.map +1 -1
  12. package/dist/esm/_core/brand/brand-name-choice.d.ts +72 -10
  13. package/dist/esm/_core/brand/brand-name-choice.d.ts.map +1 -1
  14. package/dist/esm/_core/brand/brand-name-choice.js +144 -24
  15. package/dist/esm/_core/brand/brand-name-choice.js.map +1 -1
  16. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.d.ts +41 -1
  17. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.d.ts.map +1 -1
  18. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.js +19 -3
  19. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.js.map +1 -1
  20. package/dist/esm/_core/brand/brand-name-screening-validation.d.ts +7 -1
  21. package/dist/esm/_core/brand/brand-name-screening-validation.d.ts.map +1 -1
  22. package/dist/esm/_core/brand/brand-name-screening-validation.js +24 -3
  23. package/dist/esm/_core/brand/brand-name-screening-validation.js.map +1 -1
  24. package/dist/esm/_core/brand/brand-name-screening-view.d.ts +61 -9
  25. package/dist/esm/_core/brand/brand-name-screening-view.d.ts.map +1 -1
  26. package/dist/esm/_core/brand/brand-name-screening-view.js +42 -1
  27. package/dist/esm/_core/brand/brand-name-screening-view.js.map +1 -1
  28. package/dist/esm/_core/brand/brand-name-screening.schemas.d.ts +130 -2
  29. package/dist/esm/_core/brand/brand-name-screening.schemas.d.ts.map +1 -1
  30. package/dist/esm/_core/brand/brand-name-screening.schemas.js +165 -3
  31. package/dist/esm/_core/brand/brand-name-screening.schemas.js.map +1 -1
  32. package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts +25 -7
  33. package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts.map +1 -1
  34. package/dist/esm/_core/brand/brand-visual-tone.schemas.js +26 -8
  35. package/dist/esm/_core/brand/brand-visual-tone.schemas.js.map +1 -1
  36. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts +76 -0
  37. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
  38. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +7 -2
  39. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
  40. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +21 -3
  41. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
  42. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts +411 -13
  43. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
  44. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js +281 -8
  45. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js.map +1 -1
  46. package/dist/esm/_core/build-plan/build-plan.family-aspects.js +1 -1
  47. package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -1
  48. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts +4 -0
  49. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
  50. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js +3 -0
  51. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
  52. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts +6 -0
  53. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
  54. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js +20 -0
  55. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
  56. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts +1 -0
  57. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts.map +1 -1
  58. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts +1 -0
  59. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts.map +1 -1
  60. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.js +7 -0
  61. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.js.map +1 -1
  62. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts +4 -3
  63. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts.map +1 -1
  64. package/dist/esm/_core/capability-composition/capability-composition.schemas.js +4 -3
  65. package/dist/esm/_core/capability-composition/capability-composition.schemas.js.map +1 -1
  66. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.d.ts +265 -0
  67. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.d.ts.map +1 -0
  68. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.js +371 -0
  69. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.js.map +1 -0
  70. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts +55 -5
  71. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts.map +1 -1
  72. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js +66 -2
  73. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js.map +1 -1
  74. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.d.ts +42 -2
  75. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.d.ts.map +1 -1
  76. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.js +174 -1
  77. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.js.map +1 -1
  78. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +4 -1
  79. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
  80. package/dist/esm/_core/compliance-documents/processor-register.schemas.js +10 -1
  81. package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
  82. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts +102 -10
  83. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts.map +1 -1
  84. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js +128 -25
  85. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js.map +1 -1
  86. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts +28 -0
  87. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts.map +1 -1
  88. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js +36 -1
  89. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js.map +1 -1
  90. package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts +15 -0
  91. package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts.map +1 -1
  92. package/dist/esm/_core/compliance-documents/required-document-set.schemas.js +15 -0
  93. package/dist/esm/_core/compliance-documents/required-document-set.schemas.js.map +1 -1
  94. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts +21 -10
  95. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts.map +1 -1
  96. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js +130 -14
  97. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js.map +1 -1
  98. package/dist/esm/_core/data-seed-specification.schemas.d.ts.map +1 -1
  99. package/dist/esm/_core/data-seed-specification.schemas.js +5 -1
  100. package/dist/esm/_core/data-seed-specification.schemas.js.map +1 -1
  101. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts +32 -1
  102. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts.map +1 -1
  103. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.js +41 -1
  104. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.js.map +1 -1
  105. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts +33 -1
  106. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts.map +1 -1
  107. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.js +134 -9
  108. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.js.map +1 -1
  109. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts +117 -0
  110. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts.map +1 -1
  111. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.js +118 -0
  112. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.js.map +1 -1
  113. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +1 -0
  114. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
  115. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +22 -1
  116. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -1
  117. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.d.ts +17 -1
  118. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.d.ts.map +1 -1
  119. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.js +21 -5
  120. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.js.map +1 -1
  121. package/dist/esm/_core/experience-plan/experience-plan-validation.d.ts +7 -1
  122. package/dist/esm/_core/experience-plan/experience-plan-validation.d.ts.map +1 -1
  123. package/dist/esm/_core/experience-plan/experience-plan-validation.js +39 -1
  124. package/dist/esm/_core/experience-plan/experience-plan-validation.js.map +1 -1
  125. package/dist/esm/_core/experience-plan/experience-plan.family-aspects.d.ts.map +1 -1
  126. package/dist/esm/_core/experience-plan/experience-plan.family-aspects.js +31 -5
  127. package/dist/esm/_core/experience-plan/experience-plan.family-aspects.js.map +1 -1
  128. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts +81 -9
  129. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts.map +1 -1
  130. package/dist/esm/_core/experience-plan/experience-plan.schemas.js +88 -7
  131. package/dist/esm/_core/experience-plan/experience-plan.schemas.js.map +1 -1
  132. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts +13 -6
  133. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
  134. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js +13 -6
  135. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
  136. package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -1
  137. package/dist/esm/_core/family-aspects.registry.js +2 -0
  138. package/dist/esm/_core/family-aspects.registry.js.map +1 -1
  139. package/dist/esm/_core/family-aspects.schemas.d.ts +24 -0
  140. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
  141. package/dist/esm/_core/family-aspects.schemas.js +20 -0
  142. package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
  143. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +6 -6
  144. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js +2 -2
  145. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js.map +1 -1
  146. package/dist/esm/_core/index.d.ts +6 -0
  147. package/dist/esm/_core/index.d.ts.map +1 -1
  148. package/dist/esm/_core/index.js +6 -0
  149. package/dist/esm/_core/index.js.map +1 -1
  150. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts +1 -0
  151. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts.map +1 -1
  152. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.d.ts.map +1 -1
  153. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js +2 -1
  154. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js.map +1 -1
  155. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts +26 -2
  156. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts.map +1 -1
  157. package/dist/esm/_core/integration-plan/integration-plan.schemas.js +21 -1
  158. package/dist/esm/_core/integration-plan/integration-plan.schemas.js.map +1 -1
  159. package/dist/esm/_core/market/market-references.schemas.d.ts +7 -0
  160. package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
  161. package/dist/esm/_core/market/market-references.schemas.js +13 -1
  162. package/dist/esm/_core/market/market-references.schemas.js.map +1 -1
  163. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +18 -12
  164. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
  165. package/dist/esm/_core/market/market-snapshot-generation.schemas.js +46 -17
  166. package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
  167. package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -1
  168. package/dist/esm/_core/market/market.family-aspects.js +4 -1
  169. package/dist/esm/_core/market/market.family-aspects.js.map +1 -1
  170. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts +15 -3
  171. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
  172. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js +6 -3
  173. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
  174. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +12 -1
  175. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
  176. package/dist/esm/_core/placement-plan/placement-plan-validation.js +56 -3
  177. package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
  178. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -1
  179. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js +9 -0
  180. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js.map +1 -1
  181. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +83 -0
  182. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
  183. package/dist/esm/_core/placement-plan/placement-plan.schemas.js +102 -2
  184. package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
  185. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts +3 -2
  186. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
  187. package/dist/esm/_core/requirements/functional-requirement.schemas.js +8 -2
  188. package/dist/esm/_core/requirements/functional-requirement.schemas.js.map +1 -1
  189. package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts +1 -0
  190. package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts.map +1 -1
  191. package/dist/esm/_core/requirements/non-functional-requirement.schemas.js +2 -0
  192. package/dist/esm/_core/requirements/non-functional-requirement.schemas.js.map +1 -1
  193. package/dist/esm/_core/requirements/requirements-pain-coverage.d.ts +41 -0
  194. package/dist/esm/_core/requirements/requirements-pain-coverage.d.ts.map +1 -0
  195. package/dist/esm/_core/requirements/requirements-pain-coverage.js +63 -0
  196. package/dist/esm/_core/requirements/requirements-pain-coverage.js.map +1 -0
  197. package/dist/esm/_core/requirements/requirements-references.schemas.d.ts +1 -1
  198. package/dist/esm/_core/requirements/requirements-references.schemas.js +1 -1
  199. package/dist/esm/_core/requirements/requirements-references.schemas.js.map +1 -1
  200. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts +16 -0
  201. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
  202. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js +12 -1
  203. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
  204. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts +13 -2
  205. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
  206. package/dist/esm/_core/requirements/requirements-snapshot-validation.js +32 -1
  207. package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
  208. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts +65 -1
  209. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
  210. package/dist/esm/_core/requirements/requirements-snapshot.schemas.js +53 -1
  211. package/dist/esm/_core/requirements/requirements-snapshot.schemas.js.map +1 -1
  212. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -1
  213. package/dist/esm/_core/requirements/requirements.family-aspects.js +2 -0
  214. package/dist/esm/_core/requirements/requirements.family-aspects.js.map +1 -1
  215. package/dist/esm/_core/resource-specification.schemas.d.ts +56 -15
  216. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  217. package/dist/esm/_core/resource-specification.schemas.js +73 -13
  218. package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
  219. package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts +1 -16
  220. package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts.map +1 -1
  221. package/dist/esm/_core/roadmap/roadmap-phase.schemas.js +3 -17
  222. package/dist/esm/_core/roadmap/roadmap-phase.schemas.js.map +1 -1
  223. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts +2 -1
  224. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
  225. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js +2 -1
  226. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
  227. package/dist/esm/_core/roadmap/roadmap-snapshot.schemas.d.ts +1 -1
  228. package/dist/esm/_core/service-method/service-method-derivation.d.ts +155 -0
  229. package/dist/esm/_core/service-method/service-method-derivation.d.ts.map +1 -0
  230. package/dist/esm/_core/service-method/service-method-derivation.js +410 -0
  231. package/dist/esm/_core/service-method/service-method-derivation.js.map +1 -0
  232. package/dist/esm/_core/service-method/service-method-generation.schemas.d.ts +86 -0
  233. package/dist/esm/_core/service-method/service-method-generation.schemas.d.ts.map +1 -0
  234. package/dist/esm/_core/service-method/service-method-generation.schemas.js +28 -0
  235. package/dist/esm/_core/service-method/service-method-generation.schemas.js.map +1 -0
  236. package/dist/esm/_core/service-method/service-method-validation.d.ts +35 -0
  237. package/dist/esm/_core/service-method/service-method-validation.d.ts.map +1 -0
  238. package/dist/esm/_core/service-method/service-method-validation.js +75 -0
  239. package/dist/esm/_core/service-method/service-method-validation.js.map +1 -0
  240. package/dist/esm/_core/service-method/service-method.family-aspects.d.ts +3 -0
  241. package/dist/esm/_core/service-method/service-method.family-aspects.d.ts.map +1 -0
  242. package/dist/esm/_core/service-method/service-method.family-aspects.js +59 -0
  243. package/dist/esm/_core/service-method/service-method.family-aspects.js.map +1 -0
  244. package/dist/esm/_core/service-method/service-method.schemas.d.ts +385 -0
  245. package/dist/esm/_core/service-method/service-method.schemas.d.ts.map +1 -0
  246. package/dist/esm/_core/service-method/service-method.schemas.js +372 -0
  247. package/dist/esm/_core/service-method/service-method.schemas.js.map +1 -0
  248. package/dist/esm/_core/website-plan/website-plan-generation.schemas.d.ts +37 -5
  249. package/dist/esm/_core/website-plan/website-plan-generation.schemas.d.ts.map +1 -1
  250. package/dist/esm/_core/website-plan/website-plan-generation.schemas.js +34 -6
  251. package/dist/esm/_core/website-plan/website-plan-generation.schemas.js.map +1 -1
  252. package/dist/esm/_core/website-plan/website-plan-validation.d.ts +29 -3
  253. package/dist/esm/_core/website-plan/website-plan-validation.d.ts.map +1 -1
  254. package/dist/esm/_core/website-plan/website-plan-validation.js +97 -5
  255. package/dist/esm/_core/website-plan/website-plan-validation.js.map +1 -1
  256. package/dist/esm/_core/website-plan/website-plan.family-aspects.d.ts.map +1 -1
  257. package/dist/esm/_core/website-plan/website-plan.family-aspects.js +6 -1
  258. package/dist/esm/_core/website-plan/website-plan.family-aspects.js.map +1 -1
  259. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts +521 -15
  260. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts.map +1 -1
  261. package/dist/esm/_core/website-plan/website-plan.schemas.js +703 -23
  262. package/dist/esm/_core/website-plan/website-plan.schemas.js.map +1 -1
  263. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.d.ts +78 -0
  264. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.d.ts.map +1 -0
  265. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.js +92 -0
  266. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.js.map +1 -0
  267. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts +26 -0
  268. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts.map +1 -1
  269. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js +14 -0
  270. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js.map +1 -1
  271. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +21 -5
  272. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  273. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +22 -4
  274. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  275. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts +119 -10
  276. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts.map +1 -1
  277. package/dist/esm/application-creation/application-line.application-creation.schemas.js +140 -7
  278. package/dist/esm/application-creation/application-line.application-creation.schemas.js.map +1 -1
  279. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts +7 -1
  280. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts.map +1 -1
  281. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.js +7 -1
  282. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.js.map +1 -1
  283. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +4 -2
  284. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
  285. package/dist/esm/application-creation/journey.application-creation.schemas.js +4 -2
  286. package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
  287. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +103 -15
  288. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  289. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +151 -21
  290. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  291. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts +1 -0
  292. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
  293. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js +1 -0
  294. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js.map +1 -1
  295. package/dist/esm/application-creation.exports.d.ts +7 -0
  296. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  297. package/dist/esm/application-creation.exports.js +7 -0
  298. package/dist/esm/application-creation.exports.js.map +1 -1
  299. package/dist/esm/assurance/application-risk-signals.derivations.d.ts +36 -2
  300. package/dist/esm/assurance/application-risk-signals.derivations.d.ts.map +1 -1
  301. package/dist/esm/assurance/application-risk-signals.derivations.js +52 -4
  302. package/dist/esm/assurance/application-risk-signals.derivations.js.map +1 -1
  303. package/dist/esm/assurance/assurance-assessment-twins.d.ts +38 -0
  304. package/dist/esm/assurance/assurance-assessment-twins.d.ts.map +1 -0
  305. package/dist/esm/assurance/assurance-assessment-twins.js +36 -0
  306. package/dist/esm/assurance/assurance-assessment-twins.js.map +1 -0
  307. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +608 -9
  308. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  309. package/dist/esm/assurance/assurance-authority-basis.definitions.js +2962 -1078
  310. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  311. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +15 -0
  312. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  313. package/dist/esm/assurance/assurance-authority-basis.schemas.js +1 -0
  314. package/dist/esm/assurance/assurance-authority-basis.schemas.js.map +1 -1
  315. package/dist/esm/assurance/assurance-document-system.definitions.d.ts +2 -0
  316. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  317. package/dist/esm/assurance/assurance-document-system.definitions.js +138 -19
  318. package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
  319. package/dist/esm/assurance/assurance-document-system.schemas.d.ts +65 -0
  320. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  321. package/dist/esm/assurance/assurance-document-system.schemas.js +13 -0
  322. package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
  323. package/dist/esm/assurance/assurance-evidence-judgement.schemas.d.ts +81 -6
  324. package/dist/esm/assurance/assurance-evidence-judgement.schemas.d.ts.map +1 -1
  325. package/dist/esm/assurance/assurance-evidence-judgement.schemas.js +68 -7
  326. package/dist/esm/assurance/assurance-evidence-judgement.schemas.js.map +1 -1
  327. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -1
  328. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +1631 -70
  329. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -1
  330. package/dist/esm/assurance/assurance-host-implementation-artifacts.d.ts +77 -0
  331. package/dist/esm/assurance/assurance-host-implementation-artifacts.d.ts.map +1 -0
  332. package/dist/esm/assurance/assurance-host-implementation-artifacts.js +51 -0
  333. package/dist/esm/assurance/assurance-host-implementation-artifacts.js.map +1 -0
  334. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +3 -2
  335. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  336. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +327 -3
  337. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  338. package/dist/esm/assurance/assurance-open-compliance-answer-cell.d.ts +12 -0
  339. package/dist/esm/assurance/assurance-open-compliance-answer-cell.d.ts.map +1 -0
  340. package/dist/esm/assurance/assurance-open-compliance-answer-cell.js +19 -0
  341. package/dist/esm/assurance/assurance-open-compliance-answer-cell.js.map +1 -0
  342. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.d.ts +403 -0
  343. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.d.ts.map +1 -0
  344. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.js +825 -0
  345. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.js.map +1 -0
  346. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +83 -8
  347. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
  348. package/dist/esm/assurance/assurance-program-generation.schemas.js +167 -20
  349. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
  350. package/dist/esm/assurance/assurance-program.schemas.d.ts +234 -35
  351. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  352. package/dist/esm/assurance/assurance-program.schemas.js +255 -14
  353. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  354. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts +2 -1
  355. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  356. package/dist/esm/assurance/assurance-source-registry.definitions.js +259 -18
  357. package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
  358. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.d.ts +17 -0
  359. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.d.ts.map +1 -0
  360. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.js +216 -0
  361. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.js.map +1 -0
  362. package/dist/esm/assurance/assurance-sources.schemas.d.ts +110 -0
  363. package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
  364. package/dist/esm/assurance/assurance-sources.schemas.js +111 -1
  365. package/dist/esm/assurance/assurance-sources.schemas.js.map +1 -1
  366. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -1
  367. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +356 -5
  368. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -1
  369. package/dist/esm/assurance/governed-document-audience.derivations.d.ts +83 -0
  370. package/dist/esm/assurance/governed-document-audience.derivations.d.ts.map +1 -0
  371. package/dist/esm/assurance/governed-document-audience.derivations.js +97 -0
  372. package/dist/esm/assurance/governed-document-audience.derivations.js.map +1 -0
  373. package/dist/esm/assurance/governed-document-release.d.ts +15 -1
  374. package/dist/esm/assurance/governed-document-release.d.ts.map +1 -1
  375. package/dist/esm/assurance/governed-document-release.js +3 -1
  376. package/dist/esm/assurance/governed-document-release.js.map +1 -1
  377. package/dist/esm/assurance.exports.d.ts +4 -0
  378. package/dist/esm/assurance.exports.d.ts.map +1 -1
  379. package/dist/esm/assurance.exports.js +4 -0
  380. package/dist/esm/assurance.exports.js.map +1 -1
  381. package/dist/esm/companion-exports.d.ts +9 -1
  382. package/dist/esm/companion-exports.d.ts.map +1 -1
  383. package/dist/esm/companion-exports.js.map +1 -1
  384. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts +1 -1
  385. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  386. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +33 -5
  387. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  388. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  389. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +9 -12
  390. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  391. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +1 -1
  392. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  393. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +60 -6
  394. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  395. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +4 -4
  396. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  397. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts +1 -0
  398. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  399. package/dist/esm/engine/applications/resources/applications.resource.specification.js +2 -2
  400. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  401. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts +12 -4
  402. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -1
  403. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +46 -10
  404. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -1
  405. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts +3 -2
  406. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
  407. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +15 -4
  408. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  409. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts +1 -1
  410. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  411. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +40 -11
  412. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  413. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +1 -1
  414. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  415. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +44 -3
  416. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  417. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +7 -3
  418. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -1
  419. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +40 -8
  420. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -1
  421. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts +14 -8
  422. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  423. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +72 -19
  424. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  425. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts +2 -2
  426. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  427. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +6 -6
  428. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  429. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts +1 -0
  430. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  431. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +14 -13
  432. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  433. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  434. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +2 -2
  435. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  436. package/dist/esm/engine/auth/resources/siem-delivery-outbox.resource.specification.d.ts.map +1 -1
  437. package/dist/esm/engine/auth/resources/siem-delivery-outbox.resource.specification.js.map +1 -1
  438. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  439. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +68 -12
  440. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  441. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  442. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +75 -19
  443. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
  444. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +3 -1
  445. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -1
  446. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +11 -7
  447. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -1
  448. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts +2 -0
  449. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  450. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +2 -1
  451. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  452. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts +4 -2
  453. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
  454. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +8 -7
  455. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  456. package/dist/esm/engine/billing/resources/prices.resource.specification.js +1 -1
  457. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  458. package/dist/esm/engine/billing/resources/products.resource.specification.js +1 -1
  459. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  460. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +1 -1
  461. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  462. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +6 -6
  463. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  464. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +2 -2
  465. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +1 -1
  466. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  467. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +4 -0
  468. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
  469. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +4 -1
  470. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  471. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +9 -5
  472. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -1
  473. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +16 -8
  474. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -1
  475. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.d.ts +73 -0
  476. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.d.ts.map +1 -0
  477. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.js +192 -0
  478. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.js.map +1 -0
  479. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts +5 -3
  480. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  481. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +19 -13
  482. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  483. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts +11 -6
  484. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts.map +1 -1
  485. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js +14 -3
  486. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js.map +1 -1
  487. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.d.ts +37 -0
  488. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.d.ts.map +1 -0
  489. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.js +161 -0
  490. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.js.map +1 -0
  491. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js +1 -1
  492. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js.map +1 -1
  493. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  494. package/dist/esm/engine/engine-resource-specifications.registry.js +55 -11
  495. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  496. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  497. package/dist/esm/engine/errors/error-messages.specification.js +300 -5
  498. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  499. package/dist/esm/engine/features/core-limits.feature.specifications.d.ts +10 -4
  500. package/dist/esm/engine/features/core-limits.feature.specifications.d.ts.map +1 -1
  501. package/dist/esm/engine/features/core-limits.feature.specifications.js +100 -5
  502. package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
  503. package/dist/esm/engine/features/custom-branding.feature.specification.d.ts.map +1 -1
  504. package/dist/esm/engine/features/custom-branding.feature.specification.js +7 -3
  505. package/dist/esm/engine/features/custom-branding.feature.specification.js.map +1 -1
  506. package/dist/esm/engine/features/index.d.ts +4 -2
  507. package/dist/esm/engine/features/index.d.ts.map +1 -1
  508. package/dist/esm/engine/features/index.js +6 -4
  509. package/dist/esm/engine/features/index.js.map +1 -1
  510. package/dist/esm/engine/features/resources/application-features.resource.specification.js +2 -2
  511. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  512. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
  513. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +34 -15
  514. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  515. package/dist/esm/engine/files/resources/files.resource.specification.d.ts +4 -1
  516. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  517. package/dist/esm/engine/files/resources/files.resource.specification.js +24 -3
  518. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  519. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  520. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +31 -3
  521. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  522. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +6 -6
  523. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  524. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.d.ts +30 -0
  525. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.d.ts.map +1 -0
  526. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.js +181 -0
  527. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.js.map +1 -0
  528. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.d.ts +3 -0
  529. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.d.ts.map +1 -0
  530. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.js +110 -0
  531. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.js.map +1 -0
  532. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.d.ts +3 -0
  533. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.d.ts.map +1 -0
  534. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.js +286 -0
  535. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.js.map +1 -0
  536. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.d.ts +3 -0
  537. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.d.ts.map +1 -0
  538. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.js +147 -0
  539. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.js.map +1 -0
  540. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts.map +1 -1
  541. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js +71 -26
  542. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js.map +1 -1
  543. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.d.ts +3 -0
  544. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.d.ts.map +1 -0
  545. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.js +92 -0
  546. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.js.map +1 -0
  547. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.d.ts +46 -0
  548. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.d.ts.map +1 -0
  549. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.js +196 -0
  550. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.js.map +1 -0
  551. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +73 -31
  552. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  553. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +118 -18
  554. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  555. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts +3 -0
  556. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  557. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +9 -4
  558. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
  559. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.d.ts +3 -0
  560. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.d.ts.map +1 -0
  561. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.js +184 -0
  562. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.js.map +1 -0
  563. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts.map +1 -1
  564. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js +17 -5
  565. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js.map +1 -1
  566. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts.map +1 -1
  567. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js +47 -7
  568. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js.map +1 -1
  569. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.d.ts +3 -0
  570. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.d.ts.map +1 -0
  571. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.js +118 -0
  572. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.js.map +1 -0
  573. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.d.ts +3 -0
  574. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.d.ts.map +1 -0
  575. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.js +230 -0
  576. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.js.map +1 -0
  577. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.d.ts +3 -0
  578. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.d.ts.map +1 -0
  579. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.js +151 -0
  580. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.js.map +1 -0
  581. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.d.ts +23 -0
  582. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.d.ts.map +1 -0
  583. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.js +124 -0
  584. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.js.map +1 -0
  585. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.d.ts +3 -0
  586. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.d.ts.map +1 -0
  587. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.js +114 -0
  588. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.js.map +1 -0
  589. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts.map +1 -1
  590. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js +45 -3
  591. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js.map +1 -1
  592. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.d.ts.map +1 -1
  593. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.js +6 -0
  594. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.js.map +1 -1
  595. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.d.ts +4 -0
  596. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.d.ts.map +1 -0
  597. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.js +78 -0
  598. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.js.map +1 -0
  599. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.d.ts.map +1 -1
  600. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.js +4 -4
  601. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.js.map +1 -1
  602. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js +3 -3
  603. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js.map +1 -1
  604. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.d.ts.map +1 -1
  605. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.js +4 -4
  606. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.js.map +1 -1
  607. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.d.ts.map +1 -1
  608. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.js +3 -3
  609. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.js.map +1 -1
  610. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.d.ts +5 -0
  611. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.d.ts.map +1 -0
  612. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.js +79 -0
  613. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.js.map +1 -0
  614. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js +2 -2
  615. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js.map +1 -1
  616. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.d.ts +5 -0
  617. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.d.ts.map +1 -0
  618. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.js +79 -0
  619. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.js.map +1 -0
  620. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -1
  621. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +3 -2
  622. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -1
  623. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js +3 -3
  624. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js.map +1 -1
  625. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.d.ts +5 -0
  626. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.d.ts.map +1 -0
  627. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.js +79 -0
  628. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.js.map +1 -0
  629. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.d.ts +5 -0
  630. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.d.ts.map +1 -0
  631. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.js +79 -0
  632. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.js.map +1 -0
  633. package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.js +3 -3
  634. package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.js.map +1 -1
  635. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.d.ts +4 -0
  636. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.d.ts.map +1 -0
  637. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.js +22 -0
  638. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.js.map +1 -0
  639. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
  640. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js +2 -1
  641. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js.map +1 -1
  642. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.d.ts.map +1 -1
  643. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js +3 -2
  644. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js.map +1 -1
  645. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.d.ts +4 -0
  646. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.d.ts.map +1 -0
  647. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.js +22 -0
  648. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.js.map +1 -0
  649. package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.js +2 -2
  650. package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.js.map +1 -1
  651. package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.js +1 -1
  652. package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.js.map +1 -1
  653. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js +1 -1
  654. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js.map +1 -1
  655. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.d.ts.map +1 -1
  656. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.js +7 -0
  657. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.js.map +1 -1
  658. package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.js +1 -1
  659. package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.js.map +1 -1
  660. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
  661. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
  662. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js +6 -6
  663. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js.map +1 -1
  664. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.d.ts +4 -0
  665. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.d.ts.map +1 -0
  666. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.js +24 -0
  667. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.js.map +1 -0
  668. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.js +6 -6
  669. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.js.map +1 -1
  670. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.d.ts +4 -0
  671. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.d.ts.map +1 -0
  672. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.js +128 -0
  673. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.js.map +1 -0
  674. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.js +1 -1
  675. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.js.map +1 -1
  676. package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.js +1 -1
  677. package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.js.map +1 -1
  678. package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.js +1 -1
  679. package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.js.map +1 -1
  680. package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.js +1 -1
  681. package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.js.map +1 -1
  682. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.js +1 -1
  683. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.js.map +1 -1
  684. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.js +1 -1
  685. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.js.map +1 -1
  686. package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.js +1 -1
  687. package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.js.map +1 -1
  688. package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.js +4 -4
  689. package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.js.map +1 -1
  690. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.d.ts +5 -0
  691. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.d.ts.map +1 -0
  692. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.js +139 -0
  693. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.js.map +1 -0
  694. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js +1 -1
  695. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js.map +1 -1
  696. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.d.ts.map +1 -1
  697. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.js +5 -1
  698. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.js.map +1 -1
  699. package/dist/esm/engine/frontend-components/index.d.ts +7 -0
  700. package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
  701. package/dist/esm/engine/frontend-components/index.js +29 -0
  702. package/dist/esm/engine/frontend-components/index.js.map +1 -1
  703. package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.js +1 -1
  704. package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.js.map +1 -1
  705. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.d.ts.map +1 -1
  706. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.js +3 -1
  707. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.js.map +1 -1
  708. package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.js +4 -4
  709. package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.js.map +1 -1
  710. package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.js +2 -2
  711. package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.js.map +1 -1
  712. package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.js +2 -2
  713. package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.js.map +1 -1
  714. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.d.ts +4 -0
  715. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.d.ts.map +1 -0
  716. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.js +27 -0
  717. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.js.map +1 -0
  718. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.d.ts.map +1 -1
  719. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.js +3 -1
  720. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.js.map +1 -1
  721. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.d.ts +24 -0
  722. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.d.ts.map +1 -0
  723. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.js +136 -0
  724. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.js.map +1 -0
  725. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
  726. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +6 -1
  727. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  728. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.d.ts +9 -0
  729. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.d.ts.map +1 -0
  730. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.js +110 -0
  731. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.js.map +1 -0
  732. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts.map +1 -1
  733. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js +10 -4
  734. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js.map +1 -1
  735. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts.map +1 -1
  736. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js +20 -2
  737. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js.map +1 -1
  738. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js +6 -6
  739. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js.map +1 -1
  740. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts +1 -1
  741. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js +5 -5
  742. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js.map +1 -1
  743. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.d.ts +10 -0
  744. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.d.ts.map +1 -0
  745. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.js +118 -0
  746. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.js.map +1 -0
  747. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts.map +1 -1
  748. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js +54 -8
  749. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js.map +1 -1
  750. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  751. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +9 -0
  752. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  753. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts.map +1 -1
  754. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js +33 -5
  755. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js.map +1 -1
  756. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts +21 -4
  757. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  758. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +3 -3
  759. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +1 -1
  760. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  761. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.d.ts +10 -0
  762. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.d.ts.map +1 -0
  763. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.js +159 -0
  764. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.js.map +1 -0
  765. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.d.ts +5 -5
  766. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.d.ts.map +1 -1
  767. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js +38 -10
  768. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js.map +1 -1
  769. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.d.ts +9 -0
  770. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.d.ts.map +1 -0
  771. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.js +100 -0
  772. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.js.map +1 -0
  773. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.d.ts +37 -0
  774. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.d.ts.map +1 -0
  775. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.js +181 -0
  776. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.js.map +1 -0
  777. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts +3 -3
  778. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js +7 -7
  779. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js.map +1 -1
  780. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts +31 -1
  781. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts.map +1 -1
  782. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js +33 -7
  783. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js.map +1 -1
  784. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts +16 -14
  785. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts.map +1 -1
  786. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js +56 -53
  787. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js.map +1 -1
  788. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts +6 -2
  789. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  790. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +22 -4
  791. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  792. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts +2 -2
  793. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts +2 -0
  794. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  795. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +3 -3
  796. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  797. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts +1 -0
  798. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts.map +1 -1
  799. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js +43 -2
  800. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js.map +1 -1
  801. package/dist/esm/engine/notifications/system-emails/index.d.ts +0 -1
  802. package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
  803. package/dist/esm/engine/notifications/system-emails/index.js +1 -3
  804. package/dist/esm/engine/notifications/system-emails/index.js.map +1 -1
  805. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts +1 -1
  806. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts.map +1 -1
  807. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.js +25 -15
  808. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.js.map +1 -1
  809. package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.js +13 -13
  810. package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.js.map +1 -1
  811. package/dist/esm/engine/organizations/resources/index.d.ts +1 -2
  812. package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
  813. package/dist/esm/engine/organizations/resources/index.js +1 -2
  814. package/dist/esm/engine/organizations/resources/index.js.map +1 -1
  815. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +5 -4
  816. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  817. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +114 -51
  818. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  819. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts +11 -10
  820. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  821. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +10 -7
  822. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  823. package/dist/esm/engine/organizations/resources/{service-provider-relationships.resource.specification.d.ts → organization-relationships.resource.specification.d.ts} +73 -56
  824. package/dist/esm/engine/organizations/resources/organization-relationships.resource.specification.d.ts.map +1 -0
  825. package/dist/esm/engine/organizations/resources/organization-relationships.resource.specification.js +643 -0
  826. package/dist/esm/engine/organizations/resources/organization-relationships.resource.specification.js.map +1 -0
  827. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts +1 -1
  828. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  829. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +6 -4
  830. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  831. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +2 -2
  832. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
  833. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts +4 -4
  834. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  835. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +93 -43
  836. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  837. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.d.ts +39 -0
  838. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.d.ts.map +1 -0
  839. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.js +140 -0
  840. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.js.map +1 -0
  841. package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -1
  842. package/dist/esm/engine/providers/github.provider.specification.js +8 -5
  843. package/dist/esm/engine/providers/github.provider.specification.js.map +1 -1
  844. package/dist/esm/engine/providers/google-drive.provider.specification.d.ts +6 -0
  845. package/dist/esm/engine/providers/google-drive.provider.specification.d.ts.map +1 -0
  846. package/dist/esm/engine/providers/google-drive.provider.specification.js +39 -0
  847. package/dist/esm/engine/providers/google-drive.provider.specification.js.map +1 -0
  848. package/dist/esm/engine/providers/index.d.ts +2 -0
  849. package/dist/esm/engine/providers/index.d.ts.map +1 -1
  850. package/dist/esm/engine/providers/index.js +5 -1
  851. package/dist/esm/engine/providers/index.js.map +1 -1
  852. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.d.ts +6 -0
  853. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.d.ts.map +1 -0
  854. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.js +39 -0
  855. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.js.map +1 -0
  856. package/dist/esm/engine/providers/mistral.provider.specification.js +2 -2
  857. package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -1
  858. package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -1
  859. package/dist/esm/engine/providers/resend.provider.specification.js +8 -6
  860. package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -1
  861. package/dist/esm/engine/roles/app-audit-evidence-reader.role.specification.js +1 -1
  862. package/dist/esm/engine/roles/app-audit-evidence-reader.role.specification.js.map +1 -1
  863. package/dist/esm/engine/roles/index.d.ts +2 -2
  864. package/dist/esm/engine/roles/index.d.ts.map +1 -1
  865. package/dist/esm/engine/roles/index.js +5 -5
  866. package/dist/esm/engine/roles/index.js.map +1 -1
  867. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts +1 -1
  868. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts.map +1 -1
  869. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js +24 -24
  870. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js.map +1 -1
  871. package/dist/esm/engine/roles/org-representative.role.specification.d.ts +2 -0
  872. package/dist/esm/engine/roles/org-representative.role.specification.d.ts.map +1 -0
  873. package/dist/esm/engine/roles/org-representative.role.specification.js +22 -0
  874. package/dist/esm/engine/roles/org-representative.role.specification.js.map +1 -0
  875. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts +1 -0
  876. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
  877. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +7 -5
  878. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  879. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts +3 -3
  880. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +3 -3
  881. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  882. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +3 -3
  883. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  884. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts +1 -1
  885. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
  886. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +13 -1
  887. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  888. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts +1 -0
  889. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
  890. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js +2 -0
  891. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js.map +1 -1
  892. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +4 -0
  893. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  894. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +3 -3
  895. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  896. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +1 -1
  897. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  898. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +4 -0
  899. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  900. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +6 -2
  901. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  902. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts +1 -0
  903. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  904. package/dist/esm/engine/users/resources/user-self.resource.specification.js +33 -0
  905. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  906. package/dist/esm/engine/users/resources/users.resource.specification.d.ts +2 -1
  907. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  908. package/dist/esm/engine/users/resources/users.resource.specification.js +10 -4
  909. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  910. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  911. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +17 -15
  912. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  913. package/package.json +8 -8
  914. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts +0 -6
  915. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts.map +0 -1
  916. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.js +0 -146
  917. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.js.map +0 -1
  918. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts +0 -38
  919. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts.map +0 -1
  920. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js +0 -152
  921. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js.map +0 -1
  922. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts.map +0 -1
  923. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js +0 -417
  924. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js.map +0 -1
  925. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts +0 -2
  926. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts.map +0 -1
  927. package/dist/esm/engine/roles/org-service-provider.role.specification.js +0 -22
  928. package/dist/esm/engine/roles/org-service-provider.role.specification.js.map +0 -1
@@ -82,6 +82,13 @@ export declare enum PlacementSubjectKind {
82
82
  * application declares as its own destination.
83
83
  */
84
84
  export declare const PLACEMENT_SURFACE_EXPRESSIBLE_SUBJECT_KINDS: Readonly<Record<PlacementSurface, readonly PlacementSubjectKind[]>>;
85
+ /**
86
+ * The surfaces where a placement may be shown to some roles only: the LAUNCHER surfaces, whose entries carry
87
+ * `runtimeAvailability.requiredRoles` in the application's configuration. The settings rail and the user dropdown hold
88
+ * settings destinations, which carry their own role gating, so an audience declared there is a decision no
89
+ * configuration realises.
90
+ */
91
+ export declare const PLACEMENT_AUDIENCE_SURFACES: readonly PlacementSurface[];
85
92
  export declare const PlacementSubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
86
93
  kind: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION>>;
87
94
  destinationRef: z.ZodString;
@@ -106,6 +113,20 @@ export type PlacementSubject = z.infer<typeof PlacementSubjectSchema>;
106
113
  * model invent filler from the ref alone. The plan does NOT author the label
107
114
  * string — that is the labelling pipeline's job.
108
115
  */
116
+ /**
117
+ * A SUB-CATEGORY of a settings rail category (#2481): a heading inside the category that gathers some of its sections.
118
+ * It lands as an entry of the category's `groups` in `settings-hub.config.ts`, which is why it is declared INSIDE its
119
+ * category here rather than beside it: its ref is scoped to that category (two categories may each have `people`), and
120
+ * a structure that cannot name two parents cannot nest twice.
121
+ */
122
+ export declare const PlacementSubGroupSchema: z.ZodObject<{
123
+ groupRef: z.ZodString;
124
+ /** What the sub-category gathers, from a product perspective; it grounds the generated heading. */
125
+ purpose: z.ZodString;
126
+ /** Sort order among its category's sub-categories (lower = higher). */
127
+ order: z.ZodNumber;
128
+ }, z.core.$strict>;
129
+ export type PlacementSubGroup = z.infer<typeof PlacementSubGroupSchema>;
109
130
  export declare const PlacementGroupSchema: z.ZodObject<{
110
131
  groupRef: z.ZodString;
111
132
  /** Which grouped surface this group belongs to. */
@@ -114,8 +135,29 @@ export declare const PlacementGroupSchema: z.ZodObject<{
114
135
  purpose: z.ZodString;
115
136
  /** Sort order among groups on its surface (lower = higher). */
116
137
  order: z.ZodNumber;
138
+ /**
139
+ * The category's sub-categories (#2481). SETTINGS_HUB only: a sidebar section does not nest. Absent or empty, the
140
+ * category's sections sit in one flat list.
141
+ */
142
+ subGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
143
+ groupRef: z.ZodString;
144
+ /** What the sub-category gathers, from a product perspective; it grounds the generated heading. */
145
+ purpose: z.ZodString;
146
+ /** Sort order among its category's sub-categories (lower = higher). */
147
+ order: z.ZodNumber;
148
+ }, z.core.$strict>>>;
149
+ /**
150
+ * The roles this group is shown to, when it is for one audience only (see `PlacementAudienceRolesSchema`). Only on a
151
+ * SIDEBAR group, where it becomes the section's `runtimeAvailability.requiredRoles`; refused on a settings category.
152
+ */
153
+ requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
117
154
  }, z.core.$strict>;
118
155
  export type PlacementGroup = z.infer<typeof PlacementGroupSchema>;
156
+ /**
157
+ * The identity of a declared group within a plan: a category or sidebar section by surface and ref, a sub-category by
158
+ * surface, category and ref. One function so the plan's refinement and `validatePlacementPlan` cannot key them apart.
159
+ */
160
+ export declare function placementGroupIdentity(surface: PlacementSurface, groupRef: string, categoryRef?: string): string;
119
161
  /**
120
162
  * WHERE a placed subject sits. Discriminated on surface because the address
121
163
  * vocabularies genuinely differ: the grouped surfaces name a group, the flat
@@ -125,6 +167,11 @@ export declare const PlacementAddressSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
125
167
  surface: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSurface.SETTINGS_HUB>>;
126
168
  /** The `PlacementGroup.groupRef` of the settings rail category. */
127
169
  groupRef: z.ZodString;
170
+ /**
171
+ * The sub-category of that category the section sits under (#2481): one of the category's `subGroups`. Absent, the
172
+ * section sits directly in its category, above the sub-categories.
173
+ */
174
+ subGroupRef: z.ZodOptional<z.ZodString>;
128
175
  order: z.ZodNumber;
129
176
  }, z.core.$strict>, z.ZodObject<{
130
177
  surface: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSurface.SIDEBAR>>;
@@ -231,6 +278,11 @@ export declare const PlacementDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObje
231
278
  surface: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSurface.SETTINGS_HUB>>;
232
279
  /** The `PlacementGroup.groupRef` of the settings rail category. */
233
280
  groupRef: z.ZodString;
281
+ /**
282
+ * The sub-category of that category the section sits under (#2481): one of the category's `subGroups`. Absent, the
283
+ * section sits directly in its category, above the sub-categories.
284
+ */
285
+ subGroupRef: z.ZodOptional<z.ZodString>;
234
286
  order: z.ZodNumber;
235
287
  }, z.core.$strict>, z.ZodObject<{
236
288
  surface: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSurface.SIDEBAR>>;
@@ -246,6 +298,11 @@ export declare const PlacementDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObje
246
298
  }, z.core.$strict>], "surface">;
247
299
  /** Why this subject belongs at this address. One or two sentences, product-level. */
248
300
  rationale: z.ZodString;
301
+ /**
302
+ * The roles this entry is shown to, when it is for one audience only. Only on a launcher surface
303
+ * (`PLACEMENT_AUDIENCE_SURFACES`), where it becomes the entry's `runtimeAvailability.requiredRoles`.
304
+ */
305
+ requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
249
306
  /** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */
250
307
  supersedes: z.ZodOptional<z.ZodObject<{
251
308
  /** The rationale the panel gave for the decision this one replaced. */
@@ -304,6 +361,22 @@ export declare const PlacementPlanSchema: z.ZodObject<{
304
361
  purpose: z.ZodString;
305
362
  /** Sort order among groups on its surface (lower = higher). */
306
363
  order: z.ZodNumber;
364
+ /**
365
+ * The category's sub-categories (#2481). SETTINGS_HUB only: a sidebar section does not nest. Absent or empty, the
366
+ * category's sections sit in one flat list.
367
+ */
368
+ subGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
369
+ groupRef: z.ZodString;
370
+ /** What the sub-category gathers, from a product perspective; it grounds the generated heading. */
371
+ purpose: z.ZodString;
372
+ /** Sort order among its category's sub-categories (lower = higher). */
373
+ order: z.ZodNumber;
374
+ }, z.core.$strict>>>;
375
+ /**
376
+ * The roles this group is shown to, when it is for one audience only (see `PlacementAudienceRolesSchema`). Only on a
377
+ * SIDEBAR group, where it becomes the section's `runtimeAvailability.requiredRoles`; refused on a settings category.
378
+ */
379
+ requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
307
380
  }, z.core.$strict>>>;
308
381
  decisions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
309
382
  /** `placement-<slug>`, stamped by the trusted runtime. */
@@ -328,6 +401,11 @@ export declare const PlacementPlanSchema: z.ZodObject<{
328
401
  surface: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSurface.SETTINGS_HUB>>;
329
402
  /** The `PlacementGroup.groupRef` of the settings rail category. */
330
403
  groupRef: z.ZodString;
404
+ /**
405
+ * The sub-category of that category the section sits under (#2481): one of the category's `subGroups`. Absent, the
406
+ * section sits directly in its category, above the sub-categories.
407
+ */
408
+ subGroupRef: z.ZodOptional<z.ZodString>;
331
409
  order: z.ZodNumber;
332
410
  }, z.core.$strict>, z.ZodObject<{
333
411
  surface: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodLiteral<PlacementSurface.SIDEBAR>>;
@@ -343,6 +421,11 @@ export declare const PlacementPlanSchema: z.ZodObject<{
343
421
  }, z.core.$strict>], "surface">;
344
422
  /** Why this subject belongs at this address. One or two sentences, product-level. */
345
423
  rationale: z.ZodString;
424
+ /**
425
+ * The roles this entry is shown to, when it is for one audience only. Only on a launcher surface
426
+ * (`PLACEMENT_AUDIENCE_SURFACES`), where it becomes the entry's `runtimeAvailability.requiredRoles`.
427
+ */
428
+ requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
346
429
  /** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */
347
430
  supersedes: z.ZodOptional<z.ZodObject<{
348
431
  /** The rationale the panel gave for the decision this one replaced. */
@@ -1 +1 @@
1
- {"version":3,"file":"placement-plan.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/_core/placement-plan/placement-plan.schemas.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"placement-plan.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/_core/placement-plan/placement-plan.schemas.ts"],"names":[],"mappings":"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"}
@@ -96,6 +96,22 @@ export const PLACEMENT_SURFACE_EXPRESSIBLE_SUBJECT_KINDS = {
96
96
  [PlacementSurface.COMMAND_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],
97
97
  };
98
98
  const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
99
+ /**
100
+ * The surfaces where a placement may be shown to some roles only: the LAUNCHER surfaces, whose entries carry
101
+ * `runtimeAvailability.requiredRoles` in the application's configuration. The settings rail and the user dropdown hold
102
+ * settings destinations, which carry their own role gating, so an audience declared there is a decision no
103
+ * configuration realises.
104
+ */
105
+ export const PLACEMENT_AUDIENCE_SURFACES = [
106
+ PlacementSurface.SIDEBAR,
107
+ PlacementSurface.COMMAND_MENU,
108
+ ];
109
+ /**
110
+ * Who a sidebar section or an entry is shown to: the application's role keys (an office-only "Invoices" section a
111
+ * field technician does not see). Absent means everyone, so an empty list is refused: one spelling per state.
112
+ * Navigation, not authorization: the target operation's own roles are what the backend enforces.
113
+ */
114
+ const PlacementAudienceRolesSchema = z.array(z.string().trim().min(1)).min(1);
99
115
  /**
100
116
  * A placement group's OWN key (`groupRef` on the group) — the same slug grammar as the other refs,
101
117
  * declared apart from the fields that POINT at a group (an address's `groupRef`).
@@ -129,6 +145,19 @@ export const PlacementSubjectSchema = z.discriminatedUnion('kind', [
129
145
  * model invent filler from the ref alone. The plan does NOT author the label
130
146
  * string — that is the labelling pipeline's job.
131
147
  */
148
+ /**
149
+ * A SUB-CATEGORY of a settings rail category (#2481): a heading inside the category that gathers some of its sections.
150
+ * It lands as an entry of the category's `groups` in `settings-hub.config.ts`, which is why it is declared INSIDE its
151
+ * category here rather than beside it: its ref is scoped to that category (two categories may each have `people`), and
152
+ * a structure that cannot name two parents cannot nest twice.
153
+ */
154
+ export const PlacementSubGroupSchema = z.strictObject({
155
+ groupRef: PlacementGroupKeySchema,
156
+ /** What the sub-category gathers, from a product perspective; it grounds the generated heading. */
157
+ purpose: NonEmptyStringSchema,
158
+ /** Sort order among its category's sub-categories (lower = higher). */
159
+ order: z.number().int().min(0),
160
+ });
132
161
  export const PlacementGroupSchema = z.strictObject({
133
162
  groupRef: PlacementGroupKeySchema,
134
163
  /** Which grouped surface this group belongs to. */
@@ -137,7 +166,24 @@ export const PlacementGroupSchema = z.strictObject({
137
166
  purpose: NonEmptyStringSchema,
138
167
  /** Sort order among groups on its surface (lower = higher). */
139
168
  order: z.number().int().min(0),
169
+ /**
170
+ * The category's sub-categories (#2481). SETTINGS_HUB only: a sidebar section does not nest. Absent or empty, the
171
+ * category's sections sit in one flat list.
172
+ */
173
+ subGroups: z.array(PlacementSubGroupSchema).optional(),
174
+ /**
175
+ * The roles this group is shown to, when it is for one audience only (see `PlacementAudienceRolesSchema`). Only on a
176
+ * SIDEBAR group, where it becomes the section's `runtimeAvailability.requiredRoles`; refused on a settings category.
177
+ */
178
+ requiredRoles: PlacementAudienceRolesSchema.optional(),
140
179
  });
180
+ /**
181
+ * The identity of a declared group within a plan: a category or sidebar section by surface and ref, a sub-category by
182
+ * surface, category and ref. One function so the plan's refinement and `validatePlacementPlan` cannot key them apart.
183
+ */
184
+ export function placementGroupIdentity(surface, groupRef, categoryRef) {
185
+ return categoryRef === undefined ? `${surface}::${groupRef}` : `${surface}::${categoryRef}/${groupRef}`;
186
+ }
141
187
  /**
142
188
  * WHERE a placed subject sits. Discriminated on surface because the address
143
189
  * vocabularies genuinely differ: the grouped surfaces name a group, the flat
@@ -148,6 +194,11 @@ export const PlacementAddressSchema = z.discriminatedUnion('surface', [
148
194
  surface: z.literal(PlacementSurface.SETTINGS_HUB).systemEnum('PlacementSurface'),
149
195
  /** The `PlacementGroup.groupRef` of the settings rail category. */
150
196
  groupRef: SlugSchema,
197
+ /**
198
+ * The sub-category of that category the section sits under (#2481): one of the category's `subGroups`. Absent, the
199
+ * section sits directly in its category, above the sub-categories.
200
+ */
201
+ subGroupRef: SlugSchema.optional(),
151
202
  order: z.number().int().min(0),
152
203
  }),
153
204
  z.strictObject({
@@ -246,6 +297,11 @@ export const PlacementDecisionSchema = z.discriminatedUnion('disposition', [
246
297
  address: PlacementAddressSchema,
247
298
  /** Why this subject belongs at this address. One or two sentences, product-level. */
248
299
  rationale: NonEmptyStringSchema,
300
+ /**
301
+ * The roles this entry is shown to, when it is for one audience only. Only on a launcher surface
302
+ * (`PLACEMENT_AUDIENCE_SURFACES`), where it becomes the entry's `runtimeAvailability.requiredRoles`.
303
+ */
304
+ requiredRoles: PlacementAudienceRolesSchema.optional(),
249
305
  /** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */
250
306
  supersedes: PlacementSupersededDecisionSchema.optional(),
251
307
  }),
@@ -280,6 +336,14 @@ export const PlacementDecisionSchema = z.discriminatedUnion('disposition', [
280
336
  path: ['supersedes'],
281
337
  });
282
338
  }
339
+ if (decision.disposition === PlacementDisposition.PLACED && decision.requiredRoles !== undefined
340
+ && !PLACEMENT_AUDIENCE_SURFACES.includes(decision.address.surface)) {
341
+ context.addIssue({
342
+ code: 'custom',
343
+ message: `placement decision "${decision.decisionRef}" restricts its audience on ${decision.address.surface}, where entries are settings destinations with their own role gating — declare requiredRoles only on a launcher surface (${PLACEMENT_AUDIENCE_SURFACES.join(', ')})`,
344
+ path: ['requiredRoles'],
345
+ });
346
+ }
283
347
  if (decision.origin === PlacementDecisionOrigin.DELIBERATED && decision.supersedes !== undefined) {
284
348
  context.addIssue({
285
349
  code: 'custom',
@@ -325,11 +389,39 @@ export const PlacementPlanSchema = z.object({
325
389
  }).superRefine((plan, context) => {
326
390
  const groupKeys = new Set();
327
391
  plan.groups.forEach((group, index) => {
328
- const key = `${group.surface}::${group.groupRef}`;
392
+ if (group.requiredRoles !== undefined && !PLACEMENT_AUDIENCE_SURFACES.includes(group.surface)) {
393
+ context.addIssue({
394
+ code: 'custom',
395
+ message: `placement group "${group.groupRef}" restricts its audience on ${group.surface}, whose categories carry no audience — declare requiredRoles only on a SIDEBAR section`,
396
+ path: ['groups', index, 'requiredRoles'],
397
+ });
398
+ }
399
+ const key = placementGroupIdentity(group.surface, group.groupRef);
329
400
  if (groupKeys.has(key)) {
330
401
  context.addIssue({ code: 'custom', message: `duplicate placement group "${group.groupRef}" on surface ${group.surface}`, path: ['groups', index, 'groupRef'] });
331
402
  }
332
403
  groupKeys.add(key);
404
+ // A sub-category exists only on the settings rail, and once per category.
405
+ const subGroups = group.subGroups ?? [];
406
+ if (subGroups.length > 0 && group.surface !== PlacementSurface.SETTINGS_HUB) {
407
+ context.addIssue({
408
+ code: 'custom',
409
+ message: `group "${group.groupRef}" declares sub-categories, which only the ${PlacementSurface.SETTINGS_HUB} surface has; ${group.surface} groups do not nest`,
410
+ path: ['groups', index, 'subGroups'],
411
+ });
412
+ return;
413
+ }
414
+ subGroups.forEach((subGroup, subIndex) => {
415
+ const subKey = placementGroupIdentity(group.surface, subGroup.groupRef, group.groupRef);
416
+ if (groupKeys.has(subKey)) {
417
+ context.addIssue({
418
+ code: 'custom',
419
+ message: `duplicate sub-category "${subGroup.groupRef}" in category "${group.groupRef}"`,
420
+ path: ['groups', index, 'subGroups', subIndex, 'groupRef'],
421
+ });
422
+ }
423
+ groupKeys.add(subKey);
424
+ });
333
425
  });
334
426
  const decisionRefs = new Set();
335
427
  plan.decisions.forEach((decision, index) => {
@@ -342,13 +434,21 @@ export const PlacementPlanSchema = z.object({
342
434
  const address = decision.address;
343
435
  if (!('groupRef' in address))
344
436
  return;
345
- if (!groupKeys.has(`${address.surface}::${address.groupRef}`)) {
437
+ if (!groupKeys.has(placementGroupIdentity(address.surface, address.groupRef))) {
346
438
  context.addIssue({
347
439
  code: 'custom',
348
440
  message: `placement "${decision.decisionRef}" names group "${address.groupRef}", which this plan does not declare for surface ${address.surface}`,
349
441
  path: ['decisions', index, 'address', 'groupRef'],
350
442
  });
351
443
  }
444
+ if ('subGroupRef' in address && address.subGroupRef !== undefined
445
+ && !groupKeys.has(placementGroupIdentity(address.surface, address.subGroupRef, address.groupRef))) {
446
+ context.addIssue({
447
+ code: 'custom',
448
+ message: `placement "${decision.decisionRef}" names sub-category "${address.subGroupRef}", which this plan does not declare under category "${address.groupRef}"`,
449
+ path: ['decisions', index, 'address', 'subGroupRef'],
450
+ });
451
+ }
352
452
  });
353
453
  });
354
454
  /** @wildo_source:part:end placement-plan.config */
@@ -1 +1 @@
1
- {"version":3,"file":"placement-plan.schemas.js","sourceRoot":"","sources":["../../../../../src/_core/placement-plan/placement-plan.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\n\n/**\n * @wildo_source:part:start placement-plan.config facet:layer:specification facet:family:placement-plan\n *\n * Versioning for the placement-plan payload format itself. `V1` — initial\n * shape (declared groups + one decision per subject). The shape grows\n * additively across versions; `version` is the explicit marker for consumers\n * that branch on era.\n */\nexport enum PlacementPlanVersion {\n V1 = 'v1',\n}\n\n/** Stable prefix every placement decision ref carries; the trusted runtime stamps it, a provider supplies only the slug. */\nexport const PLACEMENT_DECISION_REF_PREFIX = 'placement-';\n\n/**\n * WHICH shell surface a subject is placed on — a closed vocabulary, because\n * each member names a different authoring file with a different vocabulary,\n * and the dispatching coding agent derives which skill and which file from it.\n *\n * Deliberately NOT merged into one \"navigation surface\" bucket: a settings\n * placement names a rail CATEGORY, a sidebar placement names a sidebar\n * SECTION, and the two are different concepts that happen to both be groups.\n */\nexport enum PlacementSurface {\n /** The settings hub rail (`frontend/src/config/settings-hub.config.ts`). Grouped by category. */\n SETTINGS_HUB = 'SETTINGS_HUB',\n /** The application sidebar (`appShellConfig[SIDEBAR].contentSections`). Grouped by section. */\n SIDEBAR = 'SIDEBAR',\n /** The user dropdown's settings entries. Flat — no groups. */\n USER_MENU = 'USER_MENU',\n /** The command palette (Cmd+K). Flat — its `category` is a search facet, not a placement group. */\n COMMAND_MENU = 'COMMAND_MENU',\n}\n\n/** The surfaces whose placements MUST name a declared group. The other members are flat by construction. */\nexport const GROUPED_PLACEMENT_SURFACES: readonly PlacementSurface[] = [\n PlacementSurface.SETTINGS_HUB,\n PlacementSurface.SIDEBAR,\n];\n\n/** WHAT is being placed. */\nexport enum PlacementSubjectKind {\n /**\n * An engine-owned settings destination, named by its `SettingsDestination.ref`.\n *\n * `_core` deliberately does not import a catalog, so ref EXISTENCE is checked by the caller that\n * holds one — see `validatePlacementPlan`'s `knownSubjects`. The app-creation semantic authority\n * supplies `ENGINE_SETTINGS_DESTINATION_REFS` from `@wildo-ai/saas-models`, so an unknown ref is\n * a hard floor there. What each ref MEANS (its render target, its role and capability gating)\n * stays in `@wildo-ai/saas-frontend-lib`, which is why the ref vocabulary was moved out of it on\n * 2026-09-09: a backend-side caller could not reach it, and the floor had no holder.\n *\n * (Two earlier drafts of this note were wrong in ways worth not repeating: the parameter was\n * called `knownSubjectRefs`, a name that never existed and made the pointer ungreppable; and\n * \"no caller supplies one yet\" outlived the wiring that made one.)\n */\n ENGINE_SETTINGS_DESTINATION = 'ENGINE_SETTINGS_DESTINATION',\n /** A resource operation surface the application owns (its LIST, its READ, a custom verb). */\n RESOURCE_OPERATION = 'RESOURCE_OPERATION',\n /** An application-scoped view (composite, chart, execution, full-custom). */\n APP_VIEW = 'APP_VIEW',\n}\n\n/**\n * Which subject kinds each surface can actually CARRY — a property of the shell's vocabulary, stated\n * once, total over {@link PlacementSurface}.\n *\n * The sidebar and the command palette hold LAUNCHERS, and a launcher can open a resource operation, an\n * application view or a settings section. The settings rail and the user dropdown hold SETTINGS\n * DESTINATIONS: the engine's, and the application's own, whose target is a resource operation, a\n * framework panel or a registered component. No settings target renders an application view, so an\n * APP_VIEW placed there is a decision no configuration can realise.\n *\n * Why it is written down rather than left to the coding task: the plan IS that task's specification. A\n * placement no configuration can express produces a task that can never land, however well the agent\n * works, and the first thing to notice would be the landing check after a full coding run. Refused at\n * the plan instead (`validatePlacementPlan`'s `SUBJECT_NOT_EXPRESSIBLE_ON_SURFACE`), the deciding panel\n * is told while it can still put the subject where a subject of that kind can go.\n *\n * A RESOURCE_OPERATION on the settings rail is realised by the application declaring its own\n * destination (`SettingsHubConfig.destinations`) whose target is that operation, then placing it. On\n * the user dropdown it is the same destination, listed in `settingsEntries`.\n *\n * Not offered: a settings target that renders an application view inside the rail's panel. Each view\n * content type would need its own in-panel renderer, and a view already reaches people through the\n * sidebar or the palette. Content that genuinely belongs in settings can be a registered component the\n * application declares as its own destination.\n */\nexport const PLACEMENT_SURFACE_EXPRESSIBLE_SUBJECT_KINDS: Readonly<Record<PlacementSurface, readonly PlacementSubjectKind[]>> = {\n [PlacementSurface.SETTINGS_HUB]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION],\n [PlacementSurface.USER_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION],\n [PlacementSurface.SIDEBAR]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],\n [PlacementSurface.COMMAND_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],\n};\n\nconst SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\n\n/**\n * A placement group's OWN key (`groupRef` on the group) — the same slug grammar as the other refs,\n * declared apart from the fields that POINT at a group (an address's `groupRef`).\n */\nconst PlacementGroupKeySchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nconst NonEmptyStringSchema = z.string().trim().min(1);\n\nexport const PlacementSubjectSchema = z.discriminatedUnion('kind', [\n z.strictObject({\n kind: z.literal(PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION).systemEnum('PlacementSubjectKind'),\n destinationRef: SlugSchema,\n }),\n z.strictObject({\n kind: z.literal(PlacementSubjectKind.RESOURCE_OPERATION).systemEnum('PlacementSubjectKind'),\n moduleRef: SlugSchema,\n resourceRef: SlugSchema,\n /** The operation this placement surfaces (`list`, `read`, a custom verb ref). */\n operation: NonEmptyStringSchema,\n }),\n z.strictObject({\n kind: z.literal(PlacementSubjectKind.APP_VIEW).systemEnum('PlacementSubjectKind'),\n viewRef: SlugSchema,\n }),\n]);\nexport type PlacementSubject = z.infer<typeof PlacementSubjectSchema>;\n\n/**\n * A container the plan decides should exist on a grouped surface — a settings\n * rail category, or a sidebar section.\n *\n * `purpose` is prose, and it is load-bearing rather than decorative: it is what\n * grounds the generated `settings_hub.categories.<ref>.label` /\n * `sidebar_sections.<ref>.title` labels in authored intent instead of letting a\n * model invent filler from the ref alone. The plan does NOT author the label\n * string — that is the labelling pipeline's job.\n */\nexport const PlacementGroupSchema = z.strictObject({\n groupRef: PlacementGroupKeySchema,\n /** Which grouped surface this group belongs to. */\n surface: z.enum(PlacementSurface).systemEnum('PlacementSurface'),\n /** Why this group exists / what it gathers, from a product perspective. */\n purpose: NonEmptyStringSchema,\n /** Sort order among groups on its surface (lower = higher). */\n order: z.number().int().min(0),\n});\nexport type PlacementGroup = z.infer<typeof PlacementGroupSchema>;\n\n/**\n * WHERE a placed subject sits. Discriminated on surface because the address\n * vocabularies genuinely differ: the grouped surfaces name a group, the flat\n * ones do not have one to name.\n */\nexport const PlacementAddressSchema = z.discriminatedUnion('surface', [\n z.strictObject({\n surface: z.literal(PlacementSurface.SETTINGS_HUB).systemEnum('PlacementSurface'),\n /** The `PlacementGroup.groupRef` of the settings rail category. */\n groupRef: SlugSchema,\n order: z.number().int().min(0),\n }),\n z.strictObject({\n surface: z.literal(PlacementSurface.SIDEBAR).systemEnum('PlacementSurface'),\n /** The `PlacementGroup.groupRef` of the sidebar section. */\n groupRef: SlugSchema,\n order: z.number().int().min(0),\n }),\n z.strictObject({\n surface: z.literal(PlacementSurface.USER_MENU).systemEnum('PlacementSurface'),\n order: z.number().int().min(0),\n }),\n z.strictObject({\n surface: z.literal(PlacementSurface.COMMAND_MENU).systemEnum('PlacementSurface'),\n order: z.number().int().min(0),\n }),\n]);\nexport type PlacementAddress = z.infer<typeof PlacementAddressSchema>;\n\n/**\n * Whether a considered subject was placed or deliberately left unplaced.\n *\n * `DECLINED` is a first-class outcome, not an absence. A subject that is simply\n * missing from the plan is a COVERAGE GAP (the decision was never taken); a\n * subject recorded as `DECLINED` is a decision, with a reason a reader can\n * disagree with. Collapsing the two would make \"we thought about it and said no\"\n * indistinguishable from \"nobody looked\".\n */\nexport enum PlacementDisposition {\n PLACED = 'PLACED',\n DECLINED = 'DECLINED',\n}\n\n/**\n * WHOSE judgement a decision currently represents.\n *\n * The placement plan is produced by an expert-panel deliberation, and every decision carries a\n * `rationale` written by that panel. Nothing stopped a later edit — a re-run, or a human changing\n * the landed file — from leaving that rationale in place while changing what it explains, so the\n * artifact went on asserting panel reasoning for a decision the panel never took.\n *\n * This is the field that makes the difference legible. It is REQUIRED and has NO DEFAULT, which is\n * the whole point: a defaulted `DELIBERATED` would mean silence claims the panel, and silence is\n * exactly what a hand-edit produces.\n *\n * ⚠️ TRUSTED, like `decisionRef`. `PlacementDecisionGenerationSchema` cannot express it, so a\n * provider cannot declare its own output a human revision; `parsePlacementPlanGeneration` stamps\n * `DELIBERATED` because a panel run is by definition the panel's judgement.\n *\n * ⚠️ This is not an audit trail and must not grow into one. Git already records WHO changed a\n * decision, WHEN, and with what commit message, mergeably and across branches — git is the\n * accepted state, and a second ledger beside it cannot merge. What git cannot tell a reader who is looking at the\n * FILE — the config, in an editor, asking \"why is Billing under Account?\" — is that this particular\n * line is no longer what the panel decided. That is the one fact this carries.\n */\nexport enum PlacementDecisionOrigin {\n /** The expert panel decided it, and nobody has changed it since. */\n DELIBERATED = 'DELIBERATED',\n /** A human changed it after the panel decided otherwise. {@link PlacementSupersededDecisionSchema} says what the panel had said. */\n REVISED = 'REVISED',\n}\n\n/**\n * What a revision replaced — the panel's own reasoning, kept beside the human's.\n *\n * Only the RATIONALE, deliberately. The decision schema's own note already says the reasoning is\n * \"the artifact's most perishable and most valuable part\", and it is the half a reader cannot\n * reconstruct: the prior address is visible in `git diff`, the prior argument is not, because a\n * diff shows the words that changed and never the case they were making.\n *\n * Keeping more — the old address, a timestamp, an author — would grow a shadow decision beside the\n * real one, and every one of those is something git already holds, in a form that merges.\n */\nexport const PlacementSupersededDecisionSchema = z.strictObject({\n /** The rationale the panel gave for the decision this one replaced. */\n rationale: NonEmptyStringSchema,\n});\nexport type PlacementSupersededDecision = z.infer<typeof PlacementSupersededDecisionSchema>;\n\n/**\n * One placement decision.\n *\n * `rationale` is REQUIRED on both arms. It is what lets a creator ask \"why is\n * Billing under Organization?\" and get an answer without re-running the panel\n * that decided it — the plan is produced by an expert-panel deliberation, so\n * the reasoning is the artifact's most perishable and most valuable part.\n *\n * A subject may legitimately be placed on SEVERAL surfaces (billing sits in the\n * settings rail AND answers to the command palette), so one decision per\n * (subject, surface) — never one per subject.\n */\nexport const PlacementDecisionSchema = z.discriminatedUnion('disposition', [\n z.strictObject({\n /** `placement-<slug>`, stamped by the trusted runtime. */\n decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),\n disposition: z.literal(PlacementDisposition.PLACED).systemEnum('PlacementDisposition'),\n /** Whose judgement this is. Required, never defaulted — see {@link PlacementDecisionOrigin}. */\n origin: z.enum(PlacementDecisionOrigin).systemEnum('PlacementDecisionOrigin'),\n subject: PlacementSubjectSchema,\n address: PlacementAddressSchema,\n /** Why this subject belongs at this address. One or two sentences, product-level. */\n rationale: NonEmptyStringSchema,\n /** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */\n supersedes: PlacementSupersededDecisionSchema.optional(),\n }),\n z.strictObject({\n decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),\n disposition: z.literal(PlacementDisposition.DECLINED).systemEnum('PlacementDisposition'),\n origin: z.enum(PlacementDecisionOrigin).systemEnum('PlacementDecisionOrigin'),\n subject: PlacementSubjectSchema,\n /** Why this subject is deliberately NOT surfaced anywhere. */\n rationale: NonEmptyStringSchema,\n supersedes: PlacementSupersededDecisionSchema.optional(),\n }),\n]).superRefine((decision, context) => {\n /*\n * The pairing, enforced on the DECISION rather than on the plan.\n *\n * `PlacementDecisionSchema` is exported and parsed on its own, so a check that lived only in the\n * plan's `superRefine` would hold for a whole plan and not for a decision — one of the two call\n * sites of an invariant — the shape where a guard is applied at one call site and silently\n * missing at another. Here it cannot be bypassed by parsing at a different granularity.\n *\n * Both directions, and the second matters as much as the first. A REVISED decision with no\n * `supersedes` is the defect this whole field was added for, wearing the new vocabulary: it says\n * \"a human changed this\" and still cannot say what was changed. A DELIBERATED decision that\n * CARRIES a `supersedes` is a plan claiming the panel overruled itself — no run produces that, so\n * it can only come from an edit that changed one half and forgot the other.\n */\n if (decision.origin === PlacementDecisionOrigin.REVISED && decision.supersedes === undefined) {\n context.addIssue({\n code: 'custom',\n message: `placement decision \"${decision.decisionRef}\" is REVISED but records no superseded rationale — a revision must say what the panel had decided, or the artifact loses the argument it replaced`,\n path: ['supersedes'],\n });\n }\n if (decision.origin === PlacementDecisionOrigin.DELIBERATED && decision.supersedes !== undefined) {\n context.addIssue({\n code: 'custom',\n message: `placement decision \"${decision.decisionRef}\" is DELIBERATED and records a superseded rationale — a panel decision supersedes nothing; set origin to REVISED, or drop the supersedes block`,\n path: ['supersedes'],\n });\n }\n});\nexport type PlacementDecision = z.infer<typeof PlacementDecisionSchema>;\n\n/**\n * THE placement payload — a **single aggregate per application**: which shell\n * surface every destination, resource operation and app view sits on, and why.\n *\n * **Artifact-family id: `placement-plan`.** This schema is the shape of the\n * journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===\n * 'placement-plan'` (the `family` vocabulary stays an open string owned by the\n * selector surface; this note is the single place tying the SHAPE to the NAME).\n * Produced by the `bottom_up.placement-plan` playbook — an expert-panel\n * deliberation, not a creator elicitation — and consumed by `build-decompose`,\n * which turns it into the coding tasks that author the real config files.\n *\n * Invariants enforced HERE: unique decision refs; at least one decision; every\n * placement on a grouped surface names a group declared in this plan, of the\n * SAME surface; no two groups share a ref on one surface. Coherence beyond\n * structure — duplicate placements, empty groups, order collisions, coverage\n * against the engine catalog — is `validatePlacementPlan`'s job.\n */\nexport const PlacementPlanSchema = z.object({\n version: z.enum(PlacementPlanVersion).default(PlacementPlanVersion.V1),\n /**\n * The groups the plan decides should exist. May be empty only when no\n * grouped-surface placement is made — enforced below rather than by a\n * `min(1)`, because a plan that places nothing but command-menu entries is\n * legitimate and needs no group.\n */\n groups: z.array(PlacementGroupSchema).default([]),\n /**\n * At least one decision, at the SCHEMA. A plan that decided nothing is a\n * refusal (\"there was nothing to place\"), never an artifact — and an empty\n * artifact that LANDS overwrites a real one, which is exactly how a completed\n * 3-task build plan was destroyed by a vacuous one on 2026-08-24.\n */\n decisions: z.array(PlacementDecisionSchema).min(1),\n}).superRefine((plan, context) => {\n const groupKeys = new Set<string>();\n plan.groups.forEach((group, index) => {\n const key = `${group.surface}::${group.groupRef}`;\n if (groupKeys.has(key)) {\n context.addIssue({ code: 'custom', message: `duplicate placement group \"${group.groupRef}\" on surface ${group.surface}`, path: ['groups', index, 'groupRef'] });\n }\n groupKeys.add(key);\n });\n\n const decisionRefs = new Set<string>();\n plan.decisions.forEach((decision, index) => {\n if (decisionRefs.has(decision.decisionRef)) {\n context.addIssue({ code: 'custom', message: `duplicate placement decision ref \"${decision.decisionRef}\"`, path: ['decisions', index, 'decisionRef'] });\n }\n decisionRefs.add(decision.decisionRef);\n\n if (decision.disposition !== PlacementDisposition.PLACED) return;\n const address = decision.address;\n if (!('groupRef' in address)) return;\n if (!groupKeys.has(`${address.surface}::${address.groupRef}`)) {\n context.addIssue({\n code: 'custom',\n message: `placement \"${decision.decisionRef}\" names group \"${address.groupRef}\", which this plan does not declare for surface ${address.surface}`,\n path: ['decisions', index, 'address', 'groupRef'],\n });\n }\n });\n});\nexport type PlacementPlan = z.infer<typeof PlacementPlanSchema>;\n/** @wildo_source:part:end placement-plan.config */\n"]}
1
+ {"version":3,"file":"placement-plan.schemas.js","sourceRoot":"","sources":["../../../../../src/_core/placement-plan/placement-plan.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\n\n/**\n * @wildo_source:part:start placement-plan.config facet:layer:specification facet:family:placement-plan\n *\n * Versioning for the placement-plan payload format itself. `V1` — initial\n * shape (declared groups + one decision per subject). The shape grows\n * additively across versions; `version` is the explicit marker for consumers\n * that branch on era.\n */\nexport enum PlacementPlanVersion {\n V1 = 'v1',\n}\n\n/** Stable prefix every placement decision ref carries; the trusted runtime stamps it, a provider supplies only the slug. */\nexport const PLACEMENT_DECISION_REF_PREFIX = 'placement-';\n\n/**\n * WHICH shell surface a subject is placed on — a closed vocabulary, because\n * each member names a different authoring file with a different vocabulary,\n * and the dispatching coding agent derives which skill and which file from it.\n *\n * Deliberately NOT merged into one \"navigation surface\" bucket: a settings\n * placement names a rail CATEGORY, a sidebar placement names a sidebar\n * SECTION, and the two are different concepts that happen to both be groups.\n */\nexport enum PlacementSurface {\n /** The settings hub rail (`frontend/src/config/settings-hub.config.ts`). Grouped by category. */\n SETTINGS_HUB = 'SETTINGS_HUB',\n /** The application sidebar (`appShellConfig[SIDEBAR].contentSections`). Grouped by section. */\n SIDEBAR = 'SIDEBAR',\n /** The user dropdown's settings entries. Flat — no groups. */\n USER_MENU = 'USER_MENU',\n /** The command palette (Cmd+K). Flat — its `category` is a search facet, not a placement group. */\n COMMAND_MENU = 'COMMAND_MENU',\n}\n\n/** The surfaces whose placements MUST name a declared group. The other members are flat by construction. */\nexport const GROUPED_PLACEMENT_SURFACES: readonly PlacementSurface[] = [\n PlacementSurface.SETTINGS_HUB,\n PlacementSurface.SIDEBAR,\n];\n\n/** WHAT is being placed. */\nexport enum PlacementSubjectKind {\n /**\n * An engine-owned settings destination, named by its `SettingsDestination.ref`.\n *\n * `_core` deliberately does not import a catalog, so ref EXISTENCE is checked by the caller that\n * holds one — see `validatePlacementPlan`'s `knownSubjects`. The app-creation semantic authority\n * supplies `ENGINE_SETTINGS_DESTINATION_REFS` from `@wildo-ai/saas-models`, so an unknown ref is\n * a hard floor there. What each ref MEANS (its render target, its role and capability gating)\n * stays in `@wildo-ai/saas-frontend-lib`, which is why the ref vocabulary was moved out of it on\n * 2026-09-09: a backend-side caller could not reach it, and the floor had no holder.\n *\n * (Two earlier drafts of this note were wrong in ways worth not repeating: the parameter was\n * called `knownSubjectRefs`, a name that never existed and made the pointer ungreppable; and\n * \"no caller supplies one yet\" outlived the wiring that made one.)\n */\n ENGINE_SETTINGS_DESTINATION = 'ENGINE_SETTINGS_DESTINATION',\n /** A resource operation surface the application owns (its LIST, its READ, a custom verb). */\n RESOURCE_OPERATION = 'RESOURCE_OPERATION',\n /** An application-scoped view (composite, chart, execution, full-custom). */\n APP_VIEW = 'APP_VIEW',\n}\n\n/**\n * Which subject kinds each surface can actually CARRY — a property of the shell's vocabulary, stated\n * once, total over {@link PlacementSurface}.\n *\n * The sidebar and the command palette hold LAUNCHERS, and a launcher can open a resource operation, an\n * application view or a settings section. The settings rail and the user dropdown hold SETTINGS\n * DESTINATIONS: the engine's, and the application's own, whose target is a resource operation, a\n * framework panel or a registered component. No settings target renders an application view, so an\n * APP_VIEW placed there is a decision no configuration can realise.\n *\n * Why it is written down rather than left to the coding task: the plan IS that task's specification. A\n * placement no configuration can express produces a task that can never land, however well the agent\n * works, and the first thing to notice would be the landing check after a full coding run. Refused at\n * the plan instead (`validatePlacementPlan`'s `SUBJECT_NOT_EXPRESSIBLE_ON_SURFACE`), the deciding panel\n * is told while it can still put the subject where a subject of that kind can go.\n *\n * A RESOURCE_OPERATION on the settings rail is realised by the application declaring its own\n * destination (`SettingsHubConfig.destinations`) whose target is that operation, then placing it. On\n * the user dropdown it is the same destination, listed in `settingsEntries`.\n *\n * Not offered: a settings target that renders an application view inside the rail's panel. Each view\n * content type would need its own in-panel renderer, and a view already reaches people through the\n * sidebar or the palette. Content that genuinely belongs in settings can be a registered component the\n * application declares as its own destination.\n */\nexport const PLACEMENT_SURFACE_EXPRESSIBLE_SUBJECT_KINDS: Readonly<Record<PlacementSurface, readonly PlacementSubjectKind[]>> = {\n [PlacementSurface.SETTINGS_HUB]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION],\n [PlacementSurface.USER_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION],\n [PlacementSurface.SIDEBAR]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],\n [PlacementSurface.COMMAND_MENU]: [PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION, PlacementSubjectKind.RESOURCE_OPERATION, PlacementSubjectKind.APP_VIEW],\n};\n\nconst SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\n\n/**\n * The surfaces where a placement may be shown to some roles only: the LAUNCHER surfaces, whose entries carry\n * `runtimeAvailability.requiredRoles` in the application's configuration. The settings rail and the user dropdown hold\n * settings destinations, which carry their own role gating, so an audience declared there is a decision no\n * configuration realises.\n */\nexport const PLACEMENT_AUDIENCE_SURFACES: readonly PlacementSurface[] = [\n PlacementSurface.SIDEBAR,\n PlacementSurface.COMMAND_MENU,\n];\n\n/**\n * Who a sidebar section or an entry is shown to: the application's role keys (an office-only \"Invoices\" section a\n * field technician does not see). Absent means everyone, so an empty list is refused: one spelling per state.\n * Navigation, not authorization: the target operation's own roles are what the backend enforces.\n */\nconst PlacementAudienceRolesSchema = z.array(z.string().trim().min(1)).min(1);\n\n/**\n * A placement group's OWN key (`groupRef` on the group) — the same slug grammar as the other refs,\n * declared apart from the fields that POINT at a group (an address's `groupRef`).\n */\nconst PlacementGroupKeySchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);\nconst NonEmptyStringSchema = z.string().trim().min(1);\n\nexport const PlacementSubjectSchema = z.discriminatedUnion('kind', [\n z.strictObject({\n kind: z.literal(PlacementSubjectKind.ENGINE_SETTINGS_DESTINATION).systemEnum('PlacementSubjectKind'),\n destinationRef: SlugSchema,\n }),\n z.strictObject({\n kind: z.literal(PlacementSubjectKind.RESOURCE_OPERATION).systemEnum('PlacementSubjectKind'),\n moduleRef: SlugSchema,\n resourceRef: SlugSchema,\n /** The operation this placement surfaces (`list`, `read`, a custom verb ref). */\n operation: NonEmptyStringSchema,\n }),\n z.strictObject({\n kind: z.literal(PlacementSubjectKind.APP_VIEW).systemEnum('PlacementSubjectKind'),\n viewRef: SlugSchema,\n }),\n]);\nexport type PlacementSubject = z.infer<typeof PlacementSubjectSchema>;\n\n/**\n * A container the plan decides should exist on a grouped surface — a settings\n * rail category, or a sidebar section.\n *\n * `purpose` is prose, and it is load-bearing rather than decorative: it is what\n * grounds the generated `settings_hub.categories.<ref>.label` /\n * `sidebar_sections.<ref>.title` labels in authored intent instead of letting a\n * model invent filler from the ref alone. The plan does NOT author the label\n * string — that is the labelling pipeline's job.\n */\n/**\n * A SUB-CATEGORY of a settings rail category (#2481): a heading inside the category that gathers some of its sections.\n * It lands as an entry of the category's `groups` in `settings-hub.config.ts`, which is why it is declared INSIDE its\n * category here rather than beside it: its ref is scoped to that category (two categories may each have `people`), and\n * a structure that cannot name two parents cannot nest twice.\n */\nexport const PlacementSubGroupSchema = z.strictObject({\n groupRef: PlacementGroupKeySchema,\n /** What the sub-category gathers, from a product perspective; it grounds the generated heading. */\n purpose: NonEmptyStringSchema,\n /** Sort order among its category's sub-categories (lower = higher). */\n order: z.number().int().min(0),\n});\nexport type PlacementSubGroup = z.infer<typeof PlacementSubGroupSchema>;\n\nexport const PlacementGroupSchema = z.strictObject({\n groupRef: PlacementGroupKeySchema,\n /** Which grouped surface this group belongs to. */\n surface: z.enum(PlacementSurface).systemEnum('PlacementSurface'),\n /** Why this group exists / what it gathers, from a product perspective. */\n purpose: NonEmptyStringSchema,\n /** Sort order among groups on its surface (lower = higher). */\n order: z.number().int().min(0),\n /**\n * The category's sub-categories (#2481). SETTINGS_HUB only: a sidebar section does not nest. Absent or empty, the\n * category's sections sit in one flat list.\n */\n subGroups: z.array(PlacementSubGroupSchema).optional(),\n /**\n * The roles this group is shown to, when it is for one audience only (see `PlacementAudienceRolesSchema`). Only on a\n * SIDEBAR group, where it becomes the section's `runtimeAvailability.requiredRoles`; refused on a settings category.\n */\n requiredRoles: PlacementAudienceRolesSchema.optional(),\n});\nexport type PlacementGroup = z.infer<typeof PlacementGroupSchema>;\n\n/**\n * The identity of a declared group within a plan: a category or sidebar section by surface and ref, a sub-category by\n * surface, category and ref. One function so the plan's refinement and `validatePlacementPlan` cannot key them apart.\n */\nexport function placementGroupIdentity(surface: PlacementSurface, groupRef: string, categoryRef?: string): string {\n return categoryRef === undefined ? `${surface}::${groupRef}` : `${surface}::${categoryRef}/${groupRef}`;\n}\n\n/**\n * WHERE a placed subject sits. Discriminated on surface because the address\n * vocabularies genuinely differ: the grouped surfaces name a group, the flat\n * ones do not have one to name.\n */\nexport const PlacementAddressSchema = z.discriminatedUnion('surface', [\n z.strictObject({\n surface: z.literal(PlacementSurface.SETTINGS_HUB).systemEnum('PlacementSurface'),\n /** The `PlacementGroup.groupRef` of the settings rail category. */\n groupRef: SlugSchema,\n /**\n * The sub-category of that category the section sits under (#2481): one of the category's `subGroups`. Absent, the\n * section sits directly in its category, above the sub-categories.\n */\n subGroupRef: SlugSchema.optional(),\n order: z.number().int().min(0),\n }),\n z.strictObject({\n surface: z.literal(PlacementSurface.SIDEBAR).systemEnum('PlacementSurface'),\n /** The `PlacementGroup.groupRef` of the sidebar section. */\n groupRef: SlugSchema,\n order: z.number().int().min(0),\n }),\n z.strictObject({\n surface: z.literal(PlacementSurface.USER_MENU).systemEnum('PlacementSurface'),\n order: z.number().int().min(0),\n }),\n z.strictObject({\n surface: z.literal(PlacementSurface.COMMAND_MENU).systemEnum('PlacementSurface'),\n order: z.number().int().min(0),\n }),\n]);\nexport type PlacementAddress = z.infer<typeof PlacementAddressSchema>;\n\n/**\n * Whether a considered subject was placed or deliberately left unplaced.\n *\n * `DECLINED` is a first-class outcome, not an absence. A subject that is simply\n * missing from the plan is a COVERAGE GAP (the decision was never taken); a\n * subject recorded as `DECLINED` is a decision, with a reason a reader can\n * disagree with. Collapsing the two would make \"we thought about it and said no\"\n * indistinguishable from \"nobody looked\".\n */\nexport enum PlacementDisposition {\n PLACED = 'PLACED',\n DECLINED = 'DECLINED',\n}\n\n/**\n * WHOSE judgement a decision currently represents.\n *\n * The placement plan is produced by an expert-panel deliberation, and every decision carries a\n * `rationale` written by that panel. Nothing stopped a later edit — a re-run, or a human changing\n * the landed file — from leaving that rationale in place while changing what it explains, so the\n * artifact went on asserting panel reasoning for a decision the panel never took.\n *\n * This is the field that makes the difference legible. It is REQUIRED and has NO DEFAULT, which is\n * the whole point: a defaulted `DELIBERATED` would mean silence claims the panel, and silence is\n * exactly what a hand-edit produces.\n *\n * ⚠️ TRUSTED, like `decisionRef`. `PlacementDecisionGenerationSchema` cannot express it, so a\n * provider cannot declare its own output a human revision; `parsePlacementPlanGeneration` stamps\n * `DELIBERATED` because a panel run is by definition the panel's judgement.\n *\n * ⚠️ This is not an audit trail and must not grow into one. Git already records WHO changed a\n * decision, WHEN, and with what commit message, mergeably and across branches — git is the\n * accepted state, and a second ledger beside it cannot merge. What git cannot tell a reader who is looking at the\n * FILE — the config, in an editor, asking \"why is Billing under Account?\" — is that this particular\n * line is no longer what the panel decided. That is the one fact this carries.\n */\nexport enum PlacementDecisionOrigin {\n /** The expert panel decided it, and nobody has changed it since. */\n DELIBERATED = 'DELIBERATED',\n /** A human changed it after the panel decided otherwise. {@link PlacementSupersededDecisionSchema} says what the panel had said. */\n REVISED = 'REVISED',\n}\n\n/**\n * What a revision replaced — the panel's own reasoning, kept beside the human's.\n *\n * Only the RATIONALE, deliberately. The decision schema's own note already says the reasoning is\n * \"the artifact's most perishable and most valuable part\", and it is the half a reader cannot\n * reconstruct: the prior address is visible in `git diff`, the prior argument is not, because a\n * diff shows the words that changed and never the case they were making.\n *\n * Keeping more — the old address, a timestamp, an author — would grow a shadow decision beside the\n * real one, and every one of those is something git already holds, in a form that merges.\n */\nexport const PlacementSupersededDecisionSchema = z.strictObject({\n /** The rationale the panel gave for the decision this one replaced. */\n rationale: NonEmptyStringSchema,\n});\nexport type PlacementSupersededDecision = z.infer<typeof PlacementSupersededDecisionSchema>;\n\n/**\n * One placement decision.\n *\n * `rationale` is REQUIRED on both arms. It is what lets a creator ask \"why is\n * Billing under Organization?\" and get an answer without re-running the panel\n * that decided it — the plan is produced by an expert-panel deliberation, so\n * the reasoning is the artifact's most perishable and most valuable part.\n *\n * A subject may legitimately be placed on SEVERAL surfaces (billing sits in the\n * settings rail AND answers to the command palette), so one decision per\n * (subject, surface) — never one per subject.\n */\nexport const PlacementDecisionSchema = z.discriminatedUnion('disposition', [\n z.strictObject({\n /** `placement-<slug>`, stamped by the trusted runtime. */\n decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),\n disposition: z.literal(PlacementDisposition.PLACED).systemEnum('PlacementDisposition'),\n /** Whose judgement this is. Required, never defaulted — see {@link PlacementDecisionOrigin}. */\n origin: z.enum(PlacementDecisionOrigin).systemEnum('PlacementDecisionOrigin'),\n subject: PlacementSubjectSchema,\n address: PlacementAddressSchema,\n /** Why this subject belongs at this address. One or two sentences, product-level. */\n rationale: NonEmptyStringSchema,\n /**\n * The roles this entry is shown to, when it is for one audience only. Only on a launcher surface\n * (`PLACEMENT_AUDIENCE_SURFACES`), where it becomes the entry's `runtimeAvailability.requiredRoles`.\n */\n requiredRoles: PlacementAudienceRolesSchema.optional(),\n /** Required exactly when `origin` is REVISED — enforced below, on the decision itself. */\n supersedes: PlacementSupersededDecisionSchema.optional(),\n }),\n z.strictObject({\n decisionRef: z.string().regex(new RegExp(`^${PLACEMENT_DECISION_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),\n disposition: z.literal(PlacementDisposition.DECLINED).systemEnum('PlacementDisposition'),\n origin: z.enum(PlacementDecisionOrigin).systemEnum('PlacementDecisionOrigin'),\n subject: PlacementSubjectSchema,\n /** Why this subject is deliberately NOT surfaced anywhere. */\n rationale: NonEmptyStringSchema,\n supersedes: PlacementSupersededDecisionSchema.optional(),\n }),\n]).superRefine((decision, context) => {\n /*\n * The pairing, enforced on the DECISION rather than on the plan.\n *\n * `PlacementDecisionSchema` is exported and parsed on its own, so a check that lived only in the\n * plan's `superRefine` would hold for a whole plan and not for a decision — one of the two call\n * sites of an invariant — the shape where a guard is applied at one call site and silently\n * missing at another. Here it cannot be bypassed by parsing at a different granularity.\n *\n * Both directions, and the second matters as much as the first. A REVISED decision with no\n * `supersedes` is the defect this whole field was added for, wearing the new vocabulary: it says\n * \"a human changed this\" and still cannot say what was changed. A DELIBERATED decision that\n * CARRIES a `supersedes` is a plan claiming the panel overruled itself — no run produces that, so\n * it can only come from an edit that changed one half and forgot the other.\n */\n if (decision.origin === PlacementDecisionOrigin.REVISED && decision.supersedes === undefined) {\n context.addIssue({\n code: 'custom',\n message: `placement decision \"${decision.decisionRef}\" is REVISED but records no superseded rationale — a revision must say what the panel had decided, or the artifact loses the argument it replaced`,\n path: ['supersedes'],\n });\n }\n if (decision.disposition === PlacementDisposition.PLACED && decision.requiredRoles !== undefined\n && !PLACEMENT_AUDIENCE_SURFACES.includes(decision.address.surface)) {\n context.addIssue({\n code: 'custom',\n message: `placement decision \"${decision.decisionRef}\" restricts its audience on ${decision.address.surface}, where entries are settings destinations with their own role gating — declare requiredRoles only on a launcher surface (${PLACEMENT_AUDIENCE_SURFACES.join(', ')})`,\n path: ['requiredRoles'],\n });\n }\n if (decision.origin === PlacementDecisionOrigin.DELIBERATED && decision.supersedes !== undefined) {\n context.addIssue({\n code: 'custom',\n message: `placement decision \"${decision.decisionRef}\" is DELIBERATED and records a superseded rationale — a panel decision supersedes nothing; set origin to REVISED, or drop the supersedes block`,\n path: ['supersedes'],\n });\n }\n});\nexport type PlacementDecision = z.infer<typeof PlacementDecisionSchema>;\n\n/**\n * THE placement payload — a **single aggregate per application**: which shell\n * surface every destination, resource operation and app view sits on, and why.\n *\n * **Artifact-family id: `placement-plan`.** This schema is the shape of the\n * journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===\n * 'placement-plan'` (the `family` vocabulary stays an open string owned by the\n * selector surface; this note is the single place tying the SHAPE to the NAME).\n * Produced by the `bottom_up.placement-plan` playbook — an expert-panel\n * deliberation, not a creator elicitation — and consumed by `build-decompose`,\n * which turns it into the coding tasks that author the real config files.\n *\n * Invariants enforced HERE: unique decision refs; at least one decision; every\n * placement on a grouped surface names a group declared in this plan, of the\n * SAME surface; no two groups share a ref on one surface. Coherence beyond\n * structure — duplicate placements, empty groups, order collisions, coverage\n * against the engine catalog — is `validatePlacementPlan`'s job.\n */\nexport const PlacementPlanSchema = z.object({\n version: z.enum(PlacementPlanVersion).default(PlacementPlanVersion.V1),\n /**\n * The groups the plan decides should exist. May be empty only when no\n * grouped-surface placement is made — enforced below rather than by a\n * `min(1)`, because a plan that places nothing but command-menu entries is\n * legitimate and needs no group.\n */\n groups: z.array(PlacementGroupSchema).default([]),\n /**\n * At least one decision, at the SCHEMA. A plan that decided nothing is a\n * refusal (\"there was nothing to place\"), never an artifact — and an empty\n * artifact that LANDS overwrites a real one, which is exactly how a completed\n * 3-task build plan was destroyed by a vacuous one on 2026-08-24.\n */\n decisions: z.array(PlacementDecisionSchema).min(1),\n}).superRefine((plan, context) => {\n const groupKeys = new Set<string>();\n plan.groups.forEach((group, index) => {\n if (group.requiredRoles !== undefined && !PLACEMENT_AUDIENCE_SURFACES.includes(group.surface)) {\n context.addIssue({\n code: 'custom',\n message: `placement group \"${group.groupRef}\" restricts its audience on ${group.surface}, whose categories carry no audience — declare requiredRoles only on a SIDEBAR section`,\n path: ['groups', index, 'requiredRoles'],\n });\n }\n const key = placementGroupIdentity(group.surface, group.groupRef);\n if (groupKeys.has(key)) {\n context.addIssue({ code: 'custom', message: `duplicate placement group \"${group.groupRef}\" on surface ${group.surface}`, path: ['groups', index, 'groupRef'] });\n }\n groupKeys.add(key);\n // A sub-category exists only on the settings rail, and once per category.\n const subGroups = group.subGroups ?? [];\n if (subGroups.length > 0 && group.surface !== PlacementSurface.SETTINGS_HUB) {\n context.addIssue({\n code: 'custom',\n message: `group \"${group.groupRef}\" declares sub-categories, which only the ${PlacementSurface.SETTINGS_HUB} surface has; ${group.surface} groups do not nest`,\n path: ['groups', index, 'subGroups'],\n });\n return;\n }\n subGroups.forEach((subGroup, subIndex) => {\n const subKey = placementGroupIdentity(group.surface, subGroup.groupRef, group.groupRef);\n if (groupKeys.has(subKey)) {\n context.addIssue({\n code: 'custom',\n message: `duplicate sub-category \"${subGroup.groupRef}\" in category \"${group.groupRef}\"`,\n path: ['groups', index, 'subGroups', subIndex, 'groupRef'],\n });\n }\n groupKeys.add(subKey);\n });\n });\n\n const decisionRefs = new Set<string>();\n plan.decisions.forEach((decision, index) => {\n if (decisionRefs.has(decision.decisionRef)) {\n context.addIssue({ code: 'custom', message: `duplicate placement decision ref \"${decision.decisionRef}\"`, path: ['decisions', index, 'decisionRef'] });\n }\n decisionRefs.add(decision.decisionRef);\n\n if (decision.disposition !== PlacementDisposition.PLACED) return;\n const address = decision.address;\n if (!('groupRef' in address)) return;\n if (!groupKeys.has(placementGroupIdentity(address.surface, address.groupRef))) {\n context.addIssue({\n code: 'custom',\n message: `placement \"${decision.decisionRef}\" names group \"${address.groupRef}\", which this plan does not declare for surface ${address.surface}`,\n path: ['decisions', index, 'address', 'groupRef'],\n });\n }\n if ('subGroupRef' in address && address.subGroupRef !== undefined\n && !groupKeys.has(placementGroupIdentity(address.surface, address.subGroupRef, address.groupRef))) {\n context.addIssue({\n code: 'custom',\n message: `placement \"${decision.decisionRef}\" names sub-category \"${address.subGroupRef}\", which this plan does not declare under category \"${address.groupRef}\"`,\n path: ['decisions', index, 'address', 'subGroupRef'],\n });\n }\n });\n});\nexport type PlacementPlan = z.infer<typeof PlacementPlanSchema>;\n/** @wildo_source:part:end placement-plan.config */\n"]}
@@ -18,9 +18,9 @@ import { z } from 'zod';
18
18
  * reviewer can check the delivered capability against. Free prose at
19
19
  * scaffold depth (a Gherkin / typed-scenario model is a Phase-J2
20
20
  * concern).
21
- * - **`icpRefs`** / **`jobRefs`** — OPTIONAL flat cross-references into
21
+ * - **`icpRefs`** / **`jobRefs`** / **`painRefs`** — OPTIONAL flat cross-references into
22
22
  * the market family (which ICP segments the requirement serves, which
23
- * jobs-to-be-done it advances). Opaque strings by the `_core`
23
+ * jobs-to-be-done it advances, which market pains it relieves). Opaque strings by the `_core`
24
24
  * reference convention — the market ICP/Job schemas are NOT imported
25
25
  * (families stay decoupled; the catalog resolves the refs, and the
26
26
  * snapshot validator can cross-check them against a supplied set,
@@ -40,6 +40,7 @@ export declare const FunctionalRequirementConfigSchema: z.ZodObject<{
40
40
  acceptanceCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
41
41
  icpRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
42
42
  jobRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
43
+ painRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
43
44
  authored: z.ZodOptional<z.ZodObject<{
44
45
  lastAuthoredAt: z.ZodISODateTime;
45
46
  confidence: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("..").AuthoredConfidence>>;
@@ -1 +1 @@
1
- {"version":3,"file":"functional-requirement.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/_core/requirements/functional-requirement.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;iBA8B5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,wEAAwE"}
1
+ {"version":3,"file":"functional-requirement.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/_core/requirements/functional-requirement.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;iBAoC5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAC5F,wEAAwE"}
@@ -21,9 +21,9 @@ import { RequirementsAuthoredMetadataSchema } from './requirements-authored-meta
21
21
  * reviewer can check the delivered capability against. Free prose at
22
22
  * scaffold depth (a Gherkin / typed-scenario model is a Phase-J2
23
23
  * concern).
24
- * - **`icpRefs`** / **`jobRefs`** — OPTIONAL flat cross-references into
24
+ * - **`icpRefs`** / **`jobRefs`** / **`painRefs`** — OPTIONAL flat cross-references into
25
25
  * the market family (which ICP segments the requirement serves, which
26
- * jobs-to-be-done it advances). Opaque strings by the `_core`
26
+ * jobs-to-be-done it advances, which market pains it relieves). Opaque strings by the `_core`
27
27
  * reference convention — the market ICP/Job schemas are NOT imported
28
28
  * (families stay decoupled; the catalog resolves the refs, and the
29
29
  * snapshot validator can cross-check them against a supplied set,
@@ -56,6 +56,12 @@ export const FunctionalRequirementConfigSchema = z.object({
56
56
  * advances. Flat opaque strings (see `icpRefs`).
57
57
  */
58
58
  jobRefs: z.array(NonEmptyStringSchema).optional(),
59
+ /**
60
+ * Optional cross-references to the market PAINS this requirement relieves (#2500). Flat opaque strings (see
61
+ * `icpRefs`). What lets "every high-severity pain is addressed or explicitly left out" be checked rather than hoped
62
+ * for: 005's market weighed missed follow-ups heavily and no requirement said so.
63
+ */
64
+ painRefs: z.array(NonEmptyStringSchema).optional(),
59
65
  /** Optional per-entity authoring provenance. */
60
66
  authored: RequirementsAuthoredMetadataSchema.optional(),
61
67
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"functional-requirement.schemas.js","sourceRoot":"","sources":["../../../../../src/_core/requirements/functional-requirement.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,mFAAmF;IACnF,GAAG,EAAE,8BAA8B;IACnC,uDAAuD;IACvD,SAAS,EAAE,oBAAoB;IAC/B,0EAA0E;IAC1E,SAAS,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC1C,2EAA2E;IAC3E,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7D;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACjD;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACjD,gDAAgD;IAChD,QAAQ,EAAE,kCAAkC,CAAC,QAAQ,EAAE;IACvD;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,wEAAwE","sourcesContent":["import { z } from 'zod';\n\nimport { NonEmptyStringSchema } from '../market/market-references.schemas';\nimport { FunctionalRequirementRefSchema } from './requirements-references.schemas';\nimport { RequirementsAuthoredMetadataSchema } from './requirements-authored-metadata.schemas';\n\n/**\n * @wildo_source:part:start requirements.functional-requirement.config facet:layer:specification facet:family:requirements\n *\n * One **functional requirement** — a capability the product must\n * provide, stated as behaviour (\"the system shall let a team owner\n * invite a teammate by email\"). A ref-addressable collection entity on\n * `RequirementsSnapshot` (`functional-requirement-<slug>`), so the\n * top-down capability-map catalog (U8) can point benefits at an\n * individual requirement and later derive spec-first feature drafts from\n * it.\n *\n * What earns its place here:\n * - **`statement`** — the required behaviour in one or two sentences.\n * - **`rationale`** — WHY the capability is needed (the user outcome or\n * business reason). Optional.\n * - **`acceptanceCriteria`** — prose statements of \"done\" a builder /\n * reviewer can check the delivered capability against. Free prose at\n * scaffold depth (a Gherkin / typed-scenario model is a Phase-J2\n * concern).\n * - **`icpRefs`** / **`jobRefs`** — OPTIONAL flat cross-references into\n * the market family (which ICP segments the requirement serves, which\n * jobs-to-be-done it advances). Opaque strings by the `_core`\n * reference convention — the market ICP/Job schemas are NOT imported\n * (families stay decoupled; the catalog resolves the refs, and the\n * snapshot validator can cross-check them against a supplied set,\n * fail-soft).\n *\n * Deliberately NOT modelled here (scaffold depth, Phase J1): requirement\n * PRIORITY (MoSCoW / WSJF / RICE), dependency edges between requirements,\n * and traceability matrices. Those are a Phase-J2 concern — a functional\n * requirement here is a stated capability with optional acceptance\n * criteria, not a prioritized, dependency-ordered backlog item\n * (framework mindset: breadth before depth, no premature taxonomy).\n */\nexport const FunctionalRequirementConfigSchema = z.object({\n /** Spec identity — kebab-case, `functional-requirement-` prefixed (never `id`). */\n ref: FunctionalRequirementRefSchema,\n /** The required behaviour, in one or two sentences. */\n statement: NonEmptyStringSchema,\n /** Why the capability is needed — the user outcome or business reason. */\n rationale: NonEmptyStringSchema.optional(),\n /** Prose \"done\" statements the delivered capability is checked against. */\n acceptanceCriteria: z.array(NonEmptyStringSchema).default([]),\n /**\n * Optional cross-references to market ICP segments this requirement\n * serves. Flat opaque strings (the catalog resolves them against the\n * market snapshot; the market schemas are not imported here).\n */\n icpRefs: z.array(NonEmptyStringSchema).optional(),\n /**\n * Optional cross-references to market jobs-to-be-done this requirement\n * advances. Flat opaque strings (see `icpRefs`).\n */\n jobRefs: z.array(NonEmptyStringSchema).optional(),\n /** Optional per-entity authoring provenance. */\n authored: RequirementsAuthoredMetadataSchema.optional(),\n /**\n * The SECONDARY LINE that contributed this element (#1608), as `<entry playbook>@<line key>`. STAMPED by the\n * landing, never authored: a value in generated output is discarded. Absent on the main line's own elements.\n * A contributed element belongs to its line: when the main line re-derives this family, an element it\n * leaves out is carried forward rather than dropped, and a line may not overwrite an element it did not\n * contribute.\n */\n contributedBy: z.string().trim().min(1).optional(),\n});\nexport type FunctionalRequirementConfig = z.infer<typeof FunctionalRequirementConfigSchema>;\n/** @wildo_source:part:end requirements.functional-requirement.config */\n"]}
1
+ {"version":3,"file":"functional-requirement.schemas.js","sourceRoot":"","sources":["../../../../../src/_core/requirements/functional-requirement.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAE9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,mFAAmF;IACnF,GAAG,EAAE,8BAA8B;IACnC,uDAAuD;IACvD,SAAS,EAAE,oBAAoB;IAC/B,0EAA0E;IAC1E,SAAS,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC1C,2EAA2E;IAC3E,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7D;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACjD;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IACjD;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IAClD,gDAAgD;IAChD,QAAQ,EAAE,kCAAkC,CAAC,QAAQ,EAAE;IACvD;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,wEAAwE","sourcesContent":["import { z } from 'zod';\n\nimport { NonEmptyStringSchema } from '../market/market-references.schemas';\nimport { FunctionalRequirementRefSchema } from './requirements-references.schemas';\nimport { RequirementsAuthoredMetadataSchema } from './requirements-authored-metadata.schemas';\n\n/**\n * @wildo_source:part:start requirements.functional-requirement.config facet:layer:specification facet:family:requirements\n *\n * One **functional requirement** — a capability the product must\n * provide, stated as behaviour (\"the system shall let a team owner\n * invite a teammate by email\"). A ref-addressable collection entity on\n * `RequirementsSnapshot` (`functional-requirement-<slug>`), so the\n * top-down capability-map catalog (U8) can point benefits at an\n * individual requirement and later derive spec-first feature drafts from\n * it.\n *\n * What earns its place here:\n * - **`statement`** — the required behaviour in one or two sentences.\n * - **`rationale`** — WHY the capability is needed (the user outcome or\n * business reason). Optional.\n * - **`acceptanceCriteria`** — prose statements of \"done\" a builder /\n * reviewer can check the delivered capability against. Free prose at\n * scaffold depth (a Gherkin / typed-scenario model is a Phase-J2\n * concern).\n * - **`icpRefs`** / **`jobRefs`** / **`painRefs`** — OPTIONAL flat cross-references into\n * the market family (which ICP segments the requirement serves, which\n * jobs-to-be-done it advances, which market pains it relieves). Opaque strings by the `_core`\n * reference convention — the market ICP/Job schemas are NOT imported\n * (families stay decoupled; the catalog resolves the refs, and the\n * snapshot validator can cross-check them against a supplied set,\n * fail-soft).\n *\n * Deliberately NOT modelled here (scaffold depth, Phase J1): requirement\n * PRIORITY (MoSCoW / WSJF / RICE), dependency edges between requirements,\n * and traceability matrices. Those are a Phase-J2 concern — a functional\n * requirement here is a stated capability with optional acceptance\n * criteria, not a prioritized, dependency-ordered backlog item\n * (framework mindset: breadth before depth, no premature taxonomy).\n */\nexport const FunctionalRequirementConfigSchema = z.object({\n /** Spec identity — kebab-case, `functional-requirement-` prefixed (never `id`). */\n ref: FunctionalRequirementRefSchema,\n /** The required behaviour, in one or two sentences. */\n statement: NonEmptyStringSchema,\n /** Why the capability is needed — the user outcome or business reason. */\n rationale: NonEmptyStringSchema.optional(),\n /** Prose \"done\" statements the delivered capability is checked against. */\n acceptanceCriteria: z.array(NonEmptyStringSchema).default([]),\n /**\n * Optional cross-references to market ICP segments this requirement\n * serves. Flat opaque strings (the catalog resolves them against the\n * market snapshot; the market schemas are not imported here).\n */\n icpRefs: z.array(NonEmptyStringSchema).optional(),\n /**\n * Optional cross-references to market jobs-to-be-done this requirement\n * advances. Flat opaque strings (see `icpRefs`).\n */\n jobRefs: z.array(NonEmptyStringSchema).optional(),\n /**\n * Optional cross-references to the market PAINS this requirement relieves (#2500). Flat opaque strings (see\n * `icpRefs`). What lets \"every high-severity pain is addressed or explicitly left out\" be checked rather than hoped\n * for: 005's market weighed missed follow-ups heavily and no requirement said so.\n */\n painRefs: z.array(NonEmptyStringSchema).optional(),\n /** Optional per-entity authoring provenance. */\n authored: RequirementsAuthoredMetadataSchema.optional(),\n /**\n * The SECONDARY LINE that contributed this element (#1608), as `<entry playbook>@<line key>`. STAMPED by the\n * landing, never authored: a value in generated output is discarded. Absent on the main line's own elements.\n * A contributed element belongs to its line: when the main line re-derives this family, an element it\n * leaves out is carried forward rather than dropped, and a line may not overwrite an element it did not\n * contribute.\n */\n contributedBy: z.string().trim().min(1).optional(),\n});\nexport type FunctionalRequirementConfig = z.infer<typeof FunctionalRequirementConfigSchema>;\n/** @wildo_source:part:end requirements.functional-requirement.config */\n"]}
@@ -64,6 +64,7 @@ export declare const NonFunctionalRequirementConfigSchema: z.ZodObject<{
64
64
  acceptanceCriteria: z.ZodDefault<z.ZodArray<z.ZodString>>;
65
65
  icpRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
66
66
  jobRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
67
+ painRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
67
68
  authored: z.ZodOptional<z.ZodObject<{
68
69
  lastAuthoredAt: z.ZodISODateTime;
69
70
  confidence: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("..").AuthoredConfidence>>;
@@ -1 +1 @@
1
- {"version":3,"file":"non-functional-requirement.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/_core/requirements/non-functional-requirement.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;GAQG;AACH,oBAAY,4BAA4B;IACtC,kDAAkD;IAClD,WAAW,gBAAgB;IAC3B,mEAAmE;IACnE,WAAW,gBAAgB;IAC3B,4EAA4E;IAC5E,WAAW,gBAAgB;IAC3B,0DAA0D;IAC1D,YAAY,iBAAiB;IAC7B,kEAAkE;IAClE,QAAQ,aAAa;IACrB;;;;OAIG;IACH,UAAU,eAAe;IACzB,mEAAmE;IACnE,SAAS,cAAc;IACvB,iEAAiE;IACjE,aAAa,kBAAkB;IAC/B,8DAA8D;IAC9D,eAAe,oBAAoB;IACnC,uEAAuE;IACvE,aAAa,kBAAkB;IAC/B,kEAAkE;IAClE,WAAW,gBAAgB;IAC3B,oDAAoD;IACpD,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;iBA6B/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAClG,4EAA4E"}
1
+ {"version":3,"file":"non-functional-requirement.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/_core/requirements/non-functional-requirement.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;GAQG;AACH,oBAAY,4BAA4B;IACtC,kDAAkD;IAClD,WAAW,gBAAgB;IAC3B,mEAAmE;IACnE,WAAW,gBAAgB;IAC3B,4EAA4E;IAC5E,WAAW,gBAAgB;IAC3B,0DAA0D;IAC1D,YAAY,iBAAiB;IAC7B,kEAAkE;IAClE,QAAQ,aAAa;IACrB;;;;OAIG;IACH,UAAU,eAAe;IACzB,mEAAmE;IACnE,SAAS,cAAc;IACvB,iEAAiE;IACjE,aAAa,kBAAkB;IAC/B,8DAA8D;IAC9D,eAAe,oBAAoB;IACnC,uEAAuE;IACvE,aAAa,kBAAkB;IAC/B,kEAAkE;IAClE,WAAW,gBAAgB;IAC3B,oDAAoD;IACpD,KAAK,UAAU;CAChB;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;iBA+B/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAClG,4EAA4E"}
@@ -87,6 +87,8 @@ export const NonFunctionalRequirementConfigSchema = z.object({
87
87
  * supports. Flat opaque strings (see `icpRefs`).
88
88
  */
89
89
  jobRefs: z.array(NonEmptyStringSchema).optional(),
90
+ /** Optional cross-references to the market pains this quality relieves (#2500), as on a functional requirement. */
91
+ painRefs: z.array(NonEmptyStringSchema).optional(),
90
92
  /** Optional per-entity authoring provenance. */
91
93
  authored: RequirementsAuthoredMetadataSchema.optional(),
92
94
  });