@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

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 (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -41,6 +41,256 @@ export enum AssuranceProgramProofStage {
41
41
  ASSESSED = "ASSESSED",
42
42
  }
43
43
 
44
+ /**
45
+ * WHERE the evidence for one demand lives — and therefore what kind of query a collector must write.
46
+ *
47
+ * Routing a collector is the member set's ONLY job, so it discriminates on the one axis a collector
48
+ * cares about: **can one query, written once, serve every application?** A vocabulary that cannot
49
+ * answer that has to be supplemented out of band, which puts the discrimination somewhere less
50
+ * visible than the vocabulary itself.
51
+ *
52
+ * Settled on #384 from FIVE paper bodies (`__evidence-plane-slice__/`), after two of them found
53
+ * evidence that no member covered. The rejected alternative is recorded because it is the one that
54
+ * looks right: widening `EMITTED` to "any durable execution/event record" absorbs both cases with no
55
+ * new member — and also absorbs every product row in every application, so the member comes to mean
56
+ * "somewhere durable" and stops discriminating. What ships is that widening BOUNDED BY OWNER, plus
57
+ * the member the bound makes necessary.
58
+ */
59
+ export enum AssuranceEvidenceHome {
60
+ /** The committed specification IS the evidence. Uniform across applications; one query. */
61
+ DECLARED = "DECLARED",
62
+ /**
63
+ * An ENGINE-owned durable record class — the audit trail, or a batch execution record. Uniform
64
+ * across applications because the engine authors the store, so one query serves all.
65
+ *
66
+ * Widened from "an audit-row class" by `retention-window-declaration`, on the grounds that a sweep
67
+ * whose control emits no auditable event by design (a database TTL deletes silently) is evidenced
68
+ * by "the sweep's execution record".
69
+ *
70
+ * The original batch-record premise was withdrawn in 2026-09-10. Scheduled application
71
+ * receipts now create job-execution records before invoking the batch, with defined successful
72
+ * results retained separately. These operational records have bounded retention: 30 days for
73
+ * execution history and 24 hours for output payloads. They do not establish coverage for a longer
74
+ * assurance period. Sweep-continuity clauses still require period-covering retained evidence;
75
+ * the existence of a recent job row alone does not justify changing their evidence home.
76
+ *
77
+ * The member's meaning is therefore back to what it says above — a store a collector can query.
78
+ *
79
+ * **A STORE, always.** If a collector cannot query it for a window, it is not this — see
80
+ * {@link AssuranceEvidenceHome.OBSERVED} for a driven result and the note there about log lines.
81
+ * An audit row produced BY driving an action is still this, at the `VERIFICATION` plane.
82
+ */
83
+ EMITTED = "EMITTED",
84
+ /**
85
+ * An APPLICATION-authored durable record — a product resource row.
86
+ *
87
+ * Distinct from `EMITTED` because the schema, the status vocabulary and the operation refs are that
88
+ * application's own, so a collector can only query it against that application's specification.
89
+ * Found by `subject-erasure-execution-record`, whose entire intake/withdrawal/execution evidence is
90
+ * an application resource row and for which no audit member exists at all.
91
+ */
92
+ APPLICATION_RECORDED = "APPLICATION_RECORDED",
93
+ /**
94
+ * A DRIVEN result: a scenario outcome, a refusal, an enumeration. Reproducible on demand, and
95
+ * stored nowhere.
96
+ *
97
+ * Added 2026-09-10 after a six-batch review of all 51 bodies, in which FOUR reviewers
98
+ * independently reported the same thing: `EMITTED` was carrying **56 of 156 clauses** whose
99
+ * evidence is a driven token, a driven refusal or a call-site enumeration — none of which is
100
+ * "an ENGINE-owned durable record class". Authors reached for the nearest member because no
101
+ * accurate one existed, and it became the file's dominant convention.
102
+ *
103
+ * **The distinction is operational, not taxonomic.** The home tells a COLLECTOR what to do:
104
+ * `EMITTED` means *query this store for the window*; `OBSERVED` means *drive this and record what
105
+ * happened*. Collapsing them makes the field stop answering the one question it exists for — which
106
+ * is why widening `EMITTED`'s definition was considered and rejected.
107
+ *
108
+ * `plane` is NOT a substitute. It says WHERE a control runs, and `VERIFICATION` is compatible with
109
+ * both readings: an audit row produced by driving an action is `EMITTED` at the `VERIFICATION`
110
+ * plane, because the artifact is still a queryable row. Every one of the 56 reclassified clauses
111
+ * was checked for exactly that and none carried `requiredAuditEventMembers` — they name no store
112
+ * because there is none.
113
+ *
114
+ * NOT `UNPRODUCED`: an observation the framework can produce on demand is available evidence, and
115
+ * `UNPRODUCED` carries no severity. NOT `PERFORMED`: nobody supplies it as a host artifact — the
116
+ * running system produces it when driven.
117
+ *
118
+ * **A LOG LINE is neither this nor `EMITTED`.** It is reproducible only if you were already
119
+ * watching, and it lives in no store the framework owns; judge those per clause as `UNPRODUCED`,
120
+ * or `PERFORMED` against a host-supplied archive.
121
+ */
122
+ OBSERVED = "OBSERVED",
123
+ /**
124
+ * An artifact the HOST supplies, because the framework owns no store for it.
125
+ *
126
+ * Two shapes, and the defining property is where a collector must go rather than who made it:
127
+ * - a HUMAN ACT — a privileged-access review, an operator sign-off. Nothing in the running
128
+ * system produces it, which was this member's original and only meaning;
129
+ * - TELEMETRY the running system emits into a store the host owns and retains — a structured
130
+ * log line, a metric counter. The framework produces the signal and keeps none of it.
131
+ *
132
+ * The second shape was added 2026-09-10, in the same review that produced
133
+ * {@link AssuranceEvidenceHome.OBSERVED}, and it is a SMALLER correction than that one: no member
134
+ * is added, and the widening follows from what the home is for. Several clauses had been reading
135
+ * `EMITTED` — "an ENGINE-owned durable record class" — off a Pino line or a boot log, which sends
136
+ * a collector to query a store that does not exist. `UNPRODUCED` is equally wrong for them,
137
+ * because the signal IS produced and carries real fields; calling it unproduced retires a working
138
+ * control from examination and assigns it no severity.
139
+ *
140
+ * **What this costs, and it must be said in every clause that uses it:** a host archive has a
141
+ * retention window nobody in the framework decided, and an operational one at that. So a clause
142
+ * homed here can be evidenced for the period the host happens to keep, and no longer. If that is
143
+ * unacceptable for a given obligation, the answer is to give the control a record class — not to
144
+ * re-home the clause.
145
+ */
146
+ PERFORMED = "PERFORMED",
147
+ /**
148
+ * Authored, and nothing produces it — a VALUE, never an absence.
149
+ *
150
+ * It carries no severity against an application: a demand nothing can evidence is a framework gap,
151
+ * and raising it against every application forever is noise rather than a finding.
152
+ */
153
+ UNPRODUCED = "UNPRODUCED",
154
+ }
155
+
156
+ /**
157
+ * WHERE the control runs, and therefore what evidence about it can ever exist.
158
+ *
159
+ * Kept separate from the home because a multi-clause intent routinely spans both axes independently,
160
+ * and flattening them lets a reviewer accept a declaration as proof of a runtime property — the
161
+ * error `selected-processor-declaration` was written to prevent, where one clause is a committed
162
+ * selection and its sibling is a claim about behaviour under no selection.
163
+ */
164
+ export enum AssuranceEvidenceExecutionPlane {
165
+ /** Can evidence that a control is DECLARED or CONFIGURED. Never that it operated. */
166
+ META_APPLICATION = "META_APPLICATION",
167
+ /** Can evidence that a control OPERATES when driven. Attests the build it ran against. */
168
+ VERIFICATION = "VERIFICATION",
169
+ /** Can evidence that a control operated over a period — the only plane that can. */
170
+ PRODUCTION = "PRODUCTION",
171
+ }
172
+
173
+ /**
174
+ * The outcome of judging ONE evidence demand against what was collected.
175
+ *
176
+ * ## Why this is an enum and not the five strings it replaces
177
+ *
178
+ * These five values already governed the plane — every one of the 51 requirement bodies instructs a
179
+ * judge to "record `insufficient_evidence` for that clause" or "record `not_applicable_as_configured`
180
+ * and stop" — and they lived only as PROSE inside those instruction sentences. Nowhere could a
181
+ * collector emit one, a reviewer branch on one, or a reader learn how two of them differ. That is
182
+ * the case the closed-vocabulary rule exists for: a bare `"observation"` cannot carry who sets it or
183
+ * why it is not a `NONCONFORMITY`, and this can.
184
+ *
185
+ * Distinct from {@link AssuranceProgramFindingKind} (`GAP` / `EXCEPTION`), which classifies what an
186
+ * accepted PROGRAMME declares about its own coverage. This classifies what one judgement RUN
187
+ * concluded about one demand. Merging them would put "the programme admits it does not cover this"
188
+ * and "the evidence for this run was never gathered" in one field.
189
+ *
190
+ * ## One of these is DERIVED, and the other four are judgements
191
+ *
192
+ * {@link AssuranceEvidenceJudgementVerdict.NOT_APPLICABLE_AS_CONFIGURED} is resolvable from
193
+ * configuration alone, before a single row is collected, by the same
194
+ * `deriveExpectationCapabilityApplicability` that validates a programme. The other four require
195
+ * evidence in hand. Keeping that asymmetry visible here is the whole lesson of #302 stage 1, which
196
+ * spent TWO full collection rounds evidencing a demand whose attesting capability the application
197
+ * had never enabled, and whose closing note reads: *"A demand's applicability is decided by the
198
+ * application's enabled capabilities, BEFORE any evidence is collected."*
199
+ */
200
+ export enum AssuranceEvidenceJudgementVerdict {
201
+ /** The evidence was gathered and satisfies every clause of the demand. */
202
+ CONFORMANT = "CONFORMANT",
203
+ /**
204
+ * Something worth recording that is NOT a failure against the demand as written.
205
+ *
206
+ * The weakest verdict that still asserts the evidence was sufficient to conclude, which is why it
207
+ * is the one most easily reached for. #302 stage 1's author verdict was `OBSERVATION` and an
208
+ * independent judge overturned it to `INSUFFICIENT_EVIDENCE` on the ground that a clause had been
209
+ * passed on counts rather than on attribution — so prefer the verdict below when a clause was not
210
+ * actually evidenced.
211
+ */
212
+ OBSERVATION = "OBSERVATION",
213
+ /** The control does not do what the demand requires, and the evidence shows it. */
214
+ NONCONFORMITY = "NONCONFORMITY",
215
+ /**
216
+ * The demand may or may not be met; the evidence needed to decide was not obtained.
217
+ *
218
+ * **Never a pass, and never inherited across clauses.** The bodies state the rule they enforce:
219
+ * *"Record any clause not run as insufficient_evidence for that clause; never let a NOT RUN clause
220
+ * pass on its siblings' evidence."* A multi-clause demand with one unevidenced clause is this,
221
+ * not {@link AssuranceEvidenceJudgementVerdict.CONFORMANT}.
222
+ */
223
+ INSUFFICIENT_EVIDENCE = "INSUFFICIENT_EVIDENCE",
224
+ /**
225
+ * The application does not enable the capability the authority basis names as attesting this
226
+ * objective, so the demand cannot be evidenced for it — and nothing is broken.
227
+ *
228
+ * DERIVED, not judged: resolvable from the application's own declared `engineCapabilities` in
229
+ * `wildo.saas.config.ts`, before any collection — no evidence, and no judgement, is needed to
230
+ * reach it. A collector that resolves it FIRST stops rather than gathering evidence for a demand
231
+ * that was never applicable.
232
+ *
233
+ * Distinct from {@link AssuranceEvidenceJudgementVerdict.NONCONFORMITY} in the direction that
234
+ * matters: a control the application never claimed is not a control the application fails.
235
+ */
236
+ NOT_APPLICABLE_AS_CONFIGURED = "NOT_APPLICABLE_AS_CONFIGURED",
237
+ }
238
+
239
+ /**
240
+ * How much a NONCONFORMITY is worth — the severity axis #299 decided and #297 recorded as flat until
241
+ * it existed.
242
+ *
243
+ * ## It grades one verdict, and only one
244
+ *
245
+ * A finding opens on a nonconformity and on nothing else, so this is the only verdict a severity can
246
+ * apply to. {@link AssuranceEvidenceJudgementVerdict.OBSERVATION} is not a milder nonconformity — it
247
+ * asserts the demand is NOT failed — and giving it a severity would make the two comparable on a
248
+ * scale they do not share. `INSUFFICIENT_EVIDENCE` is likewise not a mild failure but an absence of
249
+ * evidence, and grading it would put a number on how badly we failed to look.
250
+ *
251
+ * ## Two members, because the bodies already speak in two
252
+ *
253
+ * Measured across all 58 requirement bodies that carry `severityGuidance`: MAJOR 157 times, MINOR 4,
254
+ * and OBSERVATION 37 — the last being the verdict rather than a grade. So the vocabulary is not
255
+ * invented here; it is the one the authored guidance has used since #296, given a runtime home so
256
+ * something other than a reader can act on it.
257
+ *
258
+ * No CRITICAL, deliberately: no body's guidance reaches for one, and a member with no author is a
259
+ * member a judge would have to decide the meaning of.
260
+ *
261
+ * ## What a severity IS, and the arithmetic it must never become
262
+ *
263
+ * It is the demand body's own statement of what this failure EXPOSES — "a contradicted absence claim
264
+ * is a MAJOR: the application states in committed configuration that it does not take an exposure the
265
+ * derivation finds present, and that statement is the kind a reader relies on". That is severity
266
+ * following evidenced risk, which is what #299 decided and what
267
+ * `severityGuidance`'s own JSDoc asks for: "severity follows evidenced risk rather than wording
268
+ * intensity".
269
+ *
270
+ * It is NOT a product of the risk register's bands. `ApplicationRiskRegisterSchema` refuses that
271
+ * multiplication for the reason Layer 1 refuses a score — two judgements multiplied into a third is
272
+ * the number a reader trusts without checking — and reintroducing it here, one layer over, would
273
+ * defeat the refusal rather than respect it.
274
+ *
275
+ * assurance-control: WILDO.RISK.TREATMENT_DECLARED — a recorded failure carries what it exposes, not
276
+ * only that it occurred.
277
+ */
278
+ export enum AssuranceFindingSeverity {
279
+ /**
280
+ * The control does not operate, or the application states something a reader would rely on that
281
+ * the evidence contradicts.
282
+ */
283
+ MAJOR = "MAJOR",
284
+ /**
285
+ * The control operates and something around it is owed — an undeclared decision nobody has taken
286
+ * yet, a record that exists in a weaker form than the demand asks for.
287
+ *
288
+ * Honest states live here. The bodies use it for exactly that: "an undeclared signal is a MINOR on
289
+ * its own — nobody has decided yet, which is an honest state".
290
+ */
291
+ MINOR = "MINOR",
292
+ }
293
+
44
294
  export enum AssuranceProgramCapabilityKind {
45
295
  ENGINE = "ENGINE",
46
296
  PROVIDER = "PROVIDER",
@@ -149,7 +399,7 @@ const AssuranceProgramSourceRevisionIdentitySchema = z.strictObject({
149
399
  * digested engine sources moved, including for purely additive changes that altered no control.
150
400
  * Which BYTES an acceptance was made against is answered by the engine's committed git revision
151
401
  * plus the commit that recorded the acceptance — both of which merge across branches, which a hash
152
- * does not (`.claude/rules/one-source-of-truth.md`).
402
+ * does not — git is the accepted state, so the evidence of acceptance is a commit.
153
403
  */
154
404
  export const AssuranceProgramAuthorityBasisIdentitySchema = z.strictObject({
155
405
  basisRef: AssuranceNamespacedRefSchema,
@@ -185,7 +435,7 @@ export type AssuranceProgramRoleAuthorityV2 = z.infer<typeof AssuranceProgramRol
185
435
  export const AssuranceProgramCapabilityAuthoritySchema = z
186
436
  .strictObject({
187
437
  identity: AssuranceCapabilityIdentitySchema,
188
- capabilityKind: z.enum(AssuranceProgramCapabilityKind),
438
+ capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
189
439
  implementationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
190
440
  implementationRevision: AssuranceProgramSourceRevisionIdentitySchema,
191
441
  })
@@ -198,7 +448,7 @@ export type AssuranceProgramCapabilityAuthority = z.infer<typeof AssuranceProgra
198
448
  export const AssuranceProgramCapabilityAuthorityV2Schema = z
199
449
  .strictObject({
200
450
  identity: AssuranceCapabilityIdentitySchema,
201
- capabilityKind: z.enum(AssuranceProgramCapabilityKind),
451
+ capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
202
452
  implementationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
203
453
  implementationAuthority: AssuranceProgramAuthorityBasisIdentitySchema,
204
454
  })
@@ -271,25 +521,312 @@ export const AssuranceProgramImplementationExpectationAuthoritySchema = z
271
521
  })
272
522
  .superRefine((authority, context) => addUniqueSortedIssue(authority.requiredCapabilityRefs, context, ["requiredCapabilityRefs"], "requiredCapabilityRefs"));
273
523
 
524
+ /**
525
+ * What one evidence demand actually ASKS FOR — the content behind an otherwise opaque
526
+ * `evidence-requirement:*` slug.
527
+ *
528
+ * Derived from the five paper bodies in `__evidence-plane-slice__/` rather than designed ahead of
529
+ * them (#302's whole premise: a schema error costs 1/49th here of what it costs after authoring at
530
+ * scale). The shape is what all five converged on, and the per-clause split is not decoration —
531
+ * three of the five carry clauses that do NOT share a home or a plane, and a single home per demand
532
+ * would have flattened exactly the distinction those bodies exist to record.
533
+ */
534
+ export const AssuranceEvidenceRequirementClauseSchema = z.strictObject({
535
+ /** Stable within the body — `C1`, `C2` — so a finding can name the clause it failed. */
536
+ clauseRef: z.string().trim().regex(/^C[0-9]+$/u),
537
+ /** The obligation in the objective's own terms, one clause of its intent. */
538
+ obligation: z.string().trim().min(1),
539
+ home: z.enum(AssuranceEvidenceHome).systemEnum('AssuranceEvidenceHome'),
540
+ plane: z.enum(AssuranceEvidenceExecutionPlane).systemEnum('AssuranceEvidenceExecutionPlane'),
541
+ /**
542
+ * For an `EMITTED` clause whose store is the audit trail: the event members that satisfy it, DERIVED
543
+ * from `CoreAuditableEventType` rather than transcribed.
544
+ *
545
+ * Structured rather than named in prose, and the reason is the harness's own most error-prone step:
546
+ * *"before naming any audit member, check it has an EMITTER"*. A member that is declared but never
547
+ * emitted raises a MAJOR against a working control the first time its activity occurs — which the
548
+ * first drafted body did, with `USER_MFA_ENABLED`. As a typed array the members are checkable by a
549
+ * test instead of by an author's memory, and a collector reads the query off the demand rather than
550
+ * parsing English out of `minimumEvidence`.
551
+ *
552
+ * Optional because only an audit-trail-backed clause has them: an application resource row, a batch
553
+ * execution record and a host artifact are all `EMITTED` or otherwise without audit members.
554
+ */
555
+ requiredAuditEventMembers: z.array(z.enum(CoreAuditableEventType)).min(1).optional(),
556
+ /**
557
+ * For an audit-trail-backed clause whose event TYPE carries several meanings: which rows of that
558
+ * type satisfy the clause, as one `eventData` field and the values that qualify.
559
+ *
560
+ * An event type is a closed vocabulary of KINDS; some kinds carry a second axis inside the row.
561
+ * `USER_PROVIDER_CREDENTIAL_DELETED` is one row shape for a revocation by its owner, an
562
+ * administrator's hard delete of the account, and a subject erasure, told apart by
563
+ * `eventData.reason`. Only the erasure is erasure evidence, and the requirement body said so in
564
+ * prose — which no collector reads. Counting by type alone over-counted the erasure clause with
565
+ * rows asserting that no erasure happened (#1087). The audit door filters by type, so the collector
566
+ * applies this predicate to every row it reads, and a measurement says how many rows of the type it
567
+ * set aside.
568
+ *
569
+ * Values are the member's own wire values (`ProviderCredentialDeletionReason.USER_ERASED`), named
570
+ * from the enum at the declaring site so the vocabulary stays with its source. Only meaningful
571
+ * beside `requiredAuditEventMembers`; a clause naming no event type has no rows to discriminate,
572
+ * and the refinement below refuses that pairing.
573
+ */
574
+ requiredAuditEventDataMatch: z
575
+ .strictObject({
576
+ /** The `eventData` field the meaning rides on (`reason`). Top-level in `eventData`, no path. */
577
+ field: z.string().trim().min(1),
578
+ /** The values that satisfy the clause. A row whose field holds any other value is set aside, not counted. */
579
+ values: z.array(z.string().trim().min(1)).min(1),
580
+ })
581
+ .optional(),
582
+ /**
583
+ * Why this home, stated as the reasoning that is NOT the proxy.
584
+ *
585
+ * Required, because both available proxies are wrong often enough to matter: the attesting
586
+ * capability misread `PRIVILEGED_REVIEW` as an audit row when it is a human act, and the ref's head
587
+ * noun misread `retention-window-declaration` as `DECLARED` when its clauses demand enforcement.
588
+ */
589
+ /**
590
+ * What a row COUNT of the declared members cannot reach for this clause — present only when it cannot.
591
+ *
592
+ * The judge's EMITTED rule asks the audit trail one question: how many rows of these classes fell in the
593
+ * window. For an obligation that IS an existence claim — "issuance, refresh, rotation, revocation and
594
+ * expiry are explicit attributable transitions" — that count settles it, because each member is judged
595
+ * separately and all of them must have rows.
596
+ *
597
+ * It settles nothing for four other obligation shapes, and a count read as a verdict there OVERCLAIMS:
598
+ *
599
+ * | shape | why a count cannot reach it |
600
+ * |---|---|
601
+ * | the row must CARRY something | a count never opens a row, so "names the purpose, the subject and both withholding lists" is unread |
602
+ * | a DISJUNCTION | "audited OR refused" — rows evidence one branch and say nothing about what took the other |
603
+ * | a NEGATIVE or universal claim | "spent only for that principal" is about the rows that do NOT exist |
604
+ * | a property of the SYSTEM | "without the record itself becoming an availability risk" is not a property of any row |
605
+ *
606
+ * Declaring this does not weaken the clause; it stops the clause being reported as met on evidence that
607
+ * does not meet it. A member with rows and a declared limit is INSUFFICIENT_EVIDENCE rather than
608
+ * CONFORMANT, and `unreached` is the sentence a reader is given instead of a verdict. The zero-row
609
+ * readings are unaffected: a class that emitted nothing is still a nonconformity where activity is
610
+ * evidenced, and an observation where it is not — UNLESS the clause also declares `absenceUnreadable`.
611
+ *
612
+ * ABSENT means the obligation is an existence claim over the declared members. That is the common case
613
+ * and it is why this is an exception rather than a required field — but it is a CLAIM, so a clause
614
+ * asserting more than emission and declaring no limit here is a defect in the body, not a silence.
615
+ */
616
+ emittedCountLimit: z
617
+ .strictObject({
618
+ /** What the obligation asks that a count of these rows does not establish. One sentence, in the clause's own terms. */
619
+ unreached: z.string().trim().min(1),
620
+ /**
621
+ * Why ZERO rows cannot be read as a quiet period on this clause, where that is so. Present, a member with no rows and
622
+ * no evidenced activity is INSUFFICIENT_EVIDENCE rather than an OBSERVATION.
623
+ *
624
+ * Rare, and it exists for one shape: an obligation whose failing outcome itself leaves no row. "Audited OR refused"
625
+ * on a runtime whose emission is fire-and-forget is the instance — the access that was neither audited nor refused is
626
+ * exactly as silent as a window with no access at all, so reading silence as quiet would pass the case the clause
627
+ * exists to catch. Added 2026-09-21 after the adversarial judge (#297) found `security-event-record` C2's severity
628
+ * guidance excusing every absent row; the rule-based judge, which cannot see a runtime profile, needed the body to
629
+ * SAY so rather than infer it.
630
+ */
631
+ absenceUnreadable: z.string().trim().min(1).optional(),
632
+ })
633
+ .optional(),
634
+ homeRationale: z.string().trim().min(1),
635
+ }).superRefine((clause, context) => {
636
+ if (clause.emittedCountLimit && !clause.requiredAuditEventMembers) {
637
+ context.addIssue({
638
+ code: "custom",
639
+ path: ["emittedCountLimit"],
640
+ message: `clause ${clause.clauseRef} states what a row count does not reach but names no audit event type to count`,
641
+ });
642
+ }
643
+ if (clause.requiredAuditEventDataMatch && !clause.requiredAuditEventMembers) {
644
+ context.addIssue({
645
+ code: "custom",
646
+ path: ["requiredAuditEventDataMatch"],
647
+ message: `clause ${clause.clauseRef} discriminates on eventData.${clause.requiredAuditEventDataMatch.field} but names no audit event type to read`,
648
+ });
649
+ }
650
+ });
651
+
652
+ /** @see AssuranceEvidenceRequirementClauseSchema */
653
+ export const AssuranceEvidenceRequirementBodySchema = z.strictObject({
654
+ schemaVersion: z.literal(1),
655
+ /**
656
+ * Whether the demand applies to THIS application at all, and how a judge decides.
657
+ *
658
+ * First field on purpose. `subject-erasure-execution-record` is majority application-owned, and an
659
+ * application that never built an erasure lane has not failed a control — it declared none. A body
660
+ * without this field invites a nonconformity against every application that does not implement it.
661
+ */
662
+ applicability: z.string().trim().min(1),
663
+ clauses: z.array(AssuranceEvidenceRequirementClauseSchema).min(1),
664
+ /** The artifacts that, at minimum, satisfy the demand — named vocabulary members, never prose lists. */
665
+ minimumEvidence: z.string().trim().min(1),
666
+ /** Mechanical enough that two judges gather the same thing. */
667
+ verificationSteps: z.array(z.string().trim().min(1)).min(1),
668
+ /**
669
+ * What an absence or failure MEANS, so severity follows evidenced risk rather than wording
670
+ * intensity — and so a control that operated with a missing evidence export stays an OBSERVATION
671
+ * rather than becoming a nonconformity.
672
+ */
673
+ severityGuidance: z.string().trim().min(1),
674
+ /** What the evidence does NOT prove, and what would make it stale. */
675
+ limits: z.string().trim().min(1),
676
+ });
677
+
678
+ export type AssuranceEvidenceRequirementBody = z.infer<typeof AssuranceEvidenceRequirementBodySchema>;
679
+
680
+ /**
681
+ * One stated evidence demand, paired with the body that says what would satisfy it.
682
+ *
683
+ * Paired rather than looked up, so a consumer reading an authority's pass conditions never has to decide
684
+ * which of several demands one body belongs to — the decision that went wrong, silently, the first time
685
+ * an authority stated two.
686
+ */
687
+ export const AssuranceProgramEvidenceRequirementBodyEntrySchema = z.strictObject({
688
+ requirementRef: AssuranceNamespacedRefSchema,
689
+ body: AssuranceEvidenceRequirementBodySchema,
690
+ });
691
+
692
+ export type AssuranceProgramEvidenceRequirementBodyEntry = z.infer<typeof AssuranceProgramEvidenceRequirementBodyEntrySchema>;
693
+
274
694
  export const AssuranceProgramEvidenceExpectationAuthoritySchema = z
275
695
  .strictObject({
276
696
  identity: AssuranceProgramExpectationIdentitySchema,
277
697
  objective: AssuranceObjectiveIdentitySchema,
278
698
  requiredStatementEvidenceRefs: z.array(AssuranceNamespacedRefSchema).min(1),
699
+ /**
700
+ * ONE BODY PER STATED DEMAND, in the order of `requiredStatementEvidenceRefs` — since 2026-09-12.
701
+ *
702
+ * This was a single `body`, joined by `requiredStatementEvidenceRefs[0]`, on the premise that every
703
+ * authority states one demand. `4ac83c1f` gave `WILDO.ACCESS.LEAST_PRIVILEGE` a second —
704
+ * `authorization-decision-record` beside `operation-role-declaration` — and the new ref sorts FIRST.
705
+ * From that commit the authority named `evidence-expectation:operation-role-declaration` carried the
706
+ * three clauses of the refusal record, and its own five clauses reached the composed basis nowhere.
707
+ * Nothing reported it: the guard beside the composer asserted that A body was present and that a body
708
+ * existed for `[0]`, and both stayed true. Reproduced on the committed collection plan, which answered
709
+ * a request for `operation-role-declaration` with a plan for a different demand, under that name.
710
+ *
711
+ * The history this field inherits: the single `body` became REQUIRED on 2026-09-10, when the catalog
712
+ * completed at 51 of 51 (#296 / #302), because an optional body invited a binding that shipped with
713
+ * nothing a collector could act on. That reasoning carries over whole — `.min(1)` and the agreement
714
+ * refinement below make a demand without its own body unrepresentable, now for every demand rather
715
+ * than the first.
716
+ *
717
+ * The verification authority below pairs its bodies the same way, and differs in one deliberate
718
+ * respect: it may carry FEWER bodies than demands, because an application's own basis may extend it
719
+ * with demands whose bodies are not written yet.
720
+ */
721
+ requirementBodies: z.array(AssuranceProgramEvidenceRequirementBodyEntrySchema).min(1),
279
722
  })
280
- .superRefine((authority, context) =>
281
- addUniqueSortedIssue(authority.requiredStatementEvidenceRefs, context, ["requiredStatementEvidenceRefs"], "requiredStatementEvidenceRefs"),
282
- );
723
+ .superRefine((authority, context) => {
724
+ addUniqueSortedIssue(authority.requiredStatementEvidenceRefs, context, ["requiredStatementEvidenceRefs"], "requiredStatementEvidenceRefs");
725
+ const pairedRequirementRefs = authority.requirementBodies.map((entry) => entry.requirementRef);
726
+ if (
727
+ pairedRequirementRefs.length !== authority.requiredStatementEvidenceRefs.length ||
728
+ pairedRequirementRefs.some((requirementRef, index) => requirementRef !== authority.requiredStatementEvidenceRefs[index])
729
+ ) {
730
+ context.addIssue({
731
+ code: "custom",
732
+ message: "requirementBodies must pair exactly one body with each stated demand, in the order of requiredStatementEvidenceRefs",
733
+ path: ["requirementBodies"],
734
+ });
735
+ }
736
+ });
737
+
738
+ /**
739
+ * What a VERIFICATION demand actually asks someone to do.
740
+ *
741
+ * The verification plane was degenerate until 2026-09-08: `requiredStatementVerificationRefs` held the
742
+ * expectation's own ref in 50 of 50 bindings, so the demand said "to verify X, see X" and stated
743
+ * nothing a verifier could act on (#452). The evidence axis beside it was never degenerate, which is
744
+ * what made the defect specific to this tier rather than a modelling slip.
745
+ *
746
+ * Deliberately NOT a copy of {@link AssuranceEvidenceRequirementBodySchema}. They answer different
747
+ * questions and conflating them is how a verification demand becomes a second evidence list:
748
+ *
749
+ * - EVIDENCE asks *what artifact proves this ran* — a row, an export, a declaration.
750
+ * - VERIFICATION asks *what a person or a test DOES to establish the control holds*, and what that
751
+ * act cannot establish.
752
+ *
753
+ * `acceptableMethods` is the field that makes it a demand rather than prose: it is drawn from
754
+ * {@link AssuranceVerificationMethod}, so a body states which kinds of act satisfy it and an
755
+ * application's own `AssuranceVerificationExpectation.method` can be checked against it.
756
+ */
757
+ export const AssuranceVerificationRequirementBodySchema = z.strictObject({
758
+ schemaVersion: z.literal(1),
759
+ /**
760
+ * Whether the demand applies to THIS application, and how a judge decides — first field for the
761
+ * same reason as on the evidence body: an application that declared no lane has not failed a
762
+ * control, and a body without this invites a nonconformity against everyone who did not build it.
763
+ */
764
+ applicability: z.string().trim().min(1),
765
+ /** Which kinds of act satisfy the demand. Named vocabulary members, never prose. */
766
+ acceptableMethods: z.array(z.enum(AssuranceVerificationMethod).systemEnum('AssuranceVerificationMethod')).min(1),
767
+ /** Mechanical enough that two verifiers perform the same act and can disagree about the result. */
768
+ procedure: z.array(z.string().trim().min(1)).min(1),
769
+ /** What a PASS looks like, stated so it can be false. */
770
+ passCriteria: z.string().trim().min(1),
771
+ /**
772
+ * What this act does NOT establish. The counterpart of an application's `limitationRefs`, and the
773
+ * field that stops a verification being read as operating effectiveness.
774
+ */
775
+ knownLimitations: z.string().trim().min(1),
776
+ /** What a failure MEANS, so severity follows evidenced risk rather than wording intensity. */
777
+ severityGuidance: z.string().trim().min(1),
778
+ });
779
+
780
+ export type AssuranceVerificationRequirementBody = z.infer<typeof AssuranceVerificationRequirementBodySchema>;
781
+
782
+ /**
783
+ * One stated verification demand, paired with the body that says what a verifier must do.
784
+ *
785
+ * The verification twin of `AssuranceProgramEvidenceRequirementBodyEntrySchema`: a body names its demand
786
+ * rather than being found by position, so no consumer has to decide which demand a body belongs to.
787
+ */
788
+ export const AssuranceProgramVerificationRequirementBodyEntrySchema = z.strictObject({
789
+ requirementRef: AssuranceNamespacedRefSchema,
790
+ body: AssuranceVerificationRequirementBodySchema,
791
+ });
792
+
793
+ export type AssuranceProgramVerificationRequirementBodyEntry = z.infer<typeof AssuranceProgramVerificationRequirementBodyEntrySchema>;
283
794
 
284
795
  export const AssuranceProgramVerificationExpectationAuthoritySchema = z
285
796
  .strictObject({
286
797
  identity: AssuranceProgramExpectationIdentitySchema,
287
798
  objective: AssuranceObjectiveIdentitySchema,
288
799
  requiredStatementVerificationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
800
+ /**
801
+ * The bodies AUTHORED so far, each naming the stated demand it belongs to — since 2026-09-12.
802
+ *
803
+ * This was one optional `body`, joined by `requiredStatementVerificationRefs[0]`. The evidence tier
804
+ * beside it had the same join and silently swapped a body the first time an authority stated two
805
+ * demands: the new ref sorted first and took over. No binding states two verification demands, so
806
+ * this tier never swapped — but a body that did not name its demand could not be checked against one.
807
+ *
808
+ * POSSIBLY EMPTY, and fewer entries than demands is legitimate — the reason the single body was
809
+ * optional carries over whole. An application's own basis may extend the model with demands whose
810
+ * bodies are not written yet, and a schema that refused that would refuse a partially-authored
811
+ * extension; completeness for the FRAMEWORK's basis is a test, not a schema rule. What the refinement
812
+ * below does refuse is a body attached to a demand this authority does not state, or two bodies for
813
+ * one demand.
814
+ */
815
+ requirementBodies: z.array(AssuranceProgramVerificationRequirementBodyEntrySchema),
289
816
  })
290
- .superRefine((authority, context) =>
291
- addUniqueSortedIssue(authority.requiredStatementVerificationRefs, context, ["requiredStatementVerificationRefs"], "requiredStatementVerificationRefs"),
292
- );
817
+ .superRefine((authority, context) => {
818
+ addUniqueSortedIssue(authority.requiredStatementVerificationRefs, context, ["requiredStatementVerificationRefs"], "requiredStatementVerificationRefs");
819
+ const pairedRequirementRefs = authority.requirementBodies.map((entry) => entry.requirementRef);
820
+ addUniqueSortedIssue(pairedRequirementRefs, context, ["requirementBodies"], "requirementBodies requirementRefs");
821
+ const statedRequirementRefs = new Set<string>(authority.requiredStatementVerificationRefs);
822
+ if (pairedRequirementRefs.some((requirementRef) => !statedRequirementRefs.has(requirementRef))) {
823
+ context.addIssue({
824
+ code: "custom",
825
+ message: "every verification body names a demand this authority states in requiredStatementVerificationRefs",
826
+ path: ["requirementBodies"],
827
+ });
828
+ }
829
+ });
293
830
 
294
831
  export const AssuranceProgramValidationAuthoritySnapshotSchema = z
295
832
  .strictObject({
@@ -297,7 +834,7 @@ export const AssuranceProgramValidationAuthoritySnapshotSchema = z
297
834
  snapshotRef: AssuranceNamespacedRefSchema,
298
835
  snapshotVersion: z.number().int().positive(),
299
836
  evaluatedAt: AssuranceIsoDateTimeSchema,
300
- requestedSourceUses: z.array(z.enum(AssuranceSourceUse)).min(1),
837
+ requestedSourceUses: z.array(z.enum(AssuranceSourceUse).systemEnum('AssuranceSourceUse')).min(1),
301
838
  sourceRegistry: AssuranceSourceRegistrySchema,
302
839
  /** Optional only so retained pre-document-system snapshots stay parseable. */
303
840
  documentAuthorityCatalog: AssuranceDocumentAuthorityCatalogSchema.optional(),
@@ -401,9 +938,9 @@ export type AssuranceProgramValidationAuthoritySnapshot = z.infer<typeof Assuran
401
938
  export const AssuranceProgramSourceReferenceSchema = z.strictObject({
402
939
  identity: AssuranceSourceIdentitySchema,
403
940
  edition: z.string().trim().min(1),
404
- authorityKind: z.enum(AssuranceSourceAuthorityKind),
941
+ authorityKind: z.enum(AssuranceSourceAuthorityKind).systemEnum('AssuranceSourceAuthorityKind'),
405
942
  authorityName: z.string().trim().min(1),
406
- lifecycleStatus: z.enum(AssuranceSourceLifecycleStatus),
943
+ lifecycleStatus: z.enum(AssuranceSourceLifecycleStatus).systemEnum('AssuranceSourceLifecycleStatus'),
407
944
  rightsRef: AssuranceNamespacedRefSchema,
408
945
  rightsVersion: z.number().int().positive(),
409
946
  });
@@ -414,7 +951,7 @@ export const AssuranceProgramScopeSelectorSchema = z
414
951
  .strictObject({
415
952
  scopeSelectorRef: AssuranceNamespacedRefSchema,
416
953
  scopeSelectorVersion: z.number().int().positive(),
417
- kind: z.enum(AssuranceProgramScopeSelectorKind),
954
+ kind: z.enum(AssuranceProgramScopeSelectorKind).systemEnum('AssuranceProgramScopeSelectorKind'),
418
955
  systemBoundaryRefs: z.array(AssuranceNamespacedRefSchema).min(1),
419
956
  organizationScopeRuleRefs: z.array(AssuranceNamespacedRefSchema),
420
957
  jurisdictionRefs: z.array(AssuranceNamespacedRefSchema),
@@ -441,7 +978,7 @@ export const AssuranceProgramApplicabilityDecisionSchema = z
441
978
  decisionVersion: z.number().int().positive(),
442
979
  source: AssuranceSourceIdentitySchema,
443
980
  scopeSelectorRef: AssuranceNamespacedRefSchema,
444
- status: z.enum(AssuranceProgramApplicabilityStatus),
981
+ status: z.enum(AssuranceProgramApplicabilityStatus).systemEnum('AssuranceProgramApplicabilityStatus'),
445
982
  basis: z.string().trim().min(1),
446
983
  authorityDecisionRef: AssuranceNamespacedRefSchema,
447
984
  effectiveFrom: AssuranceIsoDateSchema,
@@ -494,7 +1031,7 @@ export const AssuranceProgramControlObjectiveBindingSchema = z
494
1031
  implementationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
495
1032
  evidenceExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
496
1033
  verificationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
497
- requiredProofStage: z.enum(AssuranceProgramProofStage),
1034
+ requiredProofStage: z.enum(AssuranceProgramProofStage).systemEnum('AssuranceProgramProofStage'),
498
1035
  })
499
1036
  .superRefine((binding, context) => {
500
1037
  addUniqueSortedIssue(binding.scopeSelectorRefs, context, ["scopeSelectorRefs"], "scopeSelectorRefs");
@@ -537,10 +1074,10 @@ export const AssuranceProgramSharedResponsibilityRuleIdentitySchema = z.strictOb
537
1074
  export type AssuranceProgramSharedResponsibilityRuleIdentity = z.infer<typeof AssuranceProgramSharedResponsibilityRuleIdentitySchema>;
538
1075
 
539
1076
  const AssuranceProgramSharedResponsibilityPrecedenceSchema = z.discriminatedUnion("mode", [
540
- z.strictObject({ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.SHARED_WITHOUT_PRECEDENCE) }),
1077
+ z.strictObject({ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.SHARED_WITHOUT_PRECEDENCE).systemEnum('AssuranceProgramSharedResponsibilityPrecedenceMode') }),
541
1078
  z.strictObject({
542
- mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.NAMED_ACTOR_PRECEDENCE),
543
- precedenceActorKind: z.enum(AssuranceGovernanceActorKind),
1079
+ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.NAMED_ACTOR_PRECEDENCE).systemEnum('AssuranceProgramSharedResponsibilityPrecedenceMode'),
1080
+ precedenceActorKind: z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind'),
544
1081
  }),
545
1082
  ]);
546
1083
 
@@ -553,7 +1090,7 @@ export const AssuranceProgramSharedResponsibilityRuleSchema = z
553
1090
  sharedResponsibilityRuleRef: AssuranceNamespacedRefSchema,
554
1091
  sharedResponsibilityRuleVersion: z.number().int().positive(),
555
1092
  scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
556
- governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind)).min(2),
1093
+ governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind')).min(2),
557
1094
  accountableRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
558
1095
  operatingRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
559
1096
  evidenceProviderRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
@@ -588,7 +1125,7 @@ export const AssuranceProgramObligationCoverageDecisionSchema = z
588
1125
  coverageDecisionVersion: z.number().int().positive(),
589
1126
  obligation: AssuranceProgramObligationIdentitySchema,
590
1127
  sourceRequirementRefs: z.array(AssuranceProgramSourceRequirementReferenceSchema).min(1),
591
- reviewDisposition: z.enum(AssuranceProgramObligationCoverageReviewDisposition),
1128
+ reviewDisposition: z.enum(AssuranceProgramObligationCoverageReviewDisposition).systemEnum('AssuranceProgramObligationCoverageReviewDisposition'),
592
1129
  reviewedByRoleRef: AssuranceNamespacedRefSchema,
593
1130
  reviewedAt: AssuranceIsoDateTimeSchema,
594
1131
  rationale: z.string().trim().min(1),
@@ -613,12 +1150,12 @@ const AssuranceProgramObligationApplicabilityDecisionCommonSchema = z.strictObje
613
1150
  /** Outcome-level applicability. It cannot encode lifecycle activation, operating status or a compliance conclusion. */
614
1151
  export const AssuranceProgramObligationApplicabilityDecisionSchema = z
615
1152
  .discriminatedUnion("status", [
616
- AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.APPLICABLE) }),
1153
+ AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.APPLICABLE).systemEnum('AssuranceProgramObligationApplicabilityStatus') }),
617
1154
  AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({
618
- status: z.literal(AssuranceProgramObligationApplicabilityStatus.NOT_APPLICABLE),
1155
+ status: z.literal(AssuranceProgramObligationApplicabilityStatus.NOT_APPLICABLE).systemEnum('AssuranceProgramObligationApplicabilityStatus'),
619
1156
  evidenceRefs: z.array(AssuranceNamespacedRefSchema).min(1),
620
1157
  }),
621
- AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.UNDETERMINED) }),
1158
+ AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.UNDETERMINED).systemEnum('AssuranceProgramObligationApplicabilityStatus') }),
622
1159
  ])
623
1160
  .superRefine((decision, context) => {
624
1161
  addUniqueSortedIssue(decision.evidenceRefs, context, ["evidenceRefs"], "evidenceRefs");
@@ -633,7 +1170,7 @@ export const AssuranceProgramObligationEntrySchema = z
633
1170
  obligationVersion: z.number().int().positive(),
634
1171
  objective: AssuranceObjectiveIdentitySchema,
635
1172
  scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
636
- governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind)).min(1),
1173
+ governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind')).min(1),
637
1174
  sharedResponsibilityRule: AssuranceProgramSharedResponsibilityRuleIdentitySchema.optional(),
638
1175
  sourceRequirementRefs: z.array(AssuranceProgramSourceRequirementReferenceSchema).min(1),
639
1176
  sourceApplicabilityDecisionRefs: z.array(AssuranceProgramSourceApplicabilityDecisionIdentitySchema).min(1),
@@ -643,12 +1180,23 @@ export const AssuranceProgramObligationEntrySchema = z
643
1180
  implementationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
644
1181
  evidenceExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
645
1182
  verificationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
646
- requiredProofStage: z.enum(AssuranceProgramProofStage),
647
- blockingEffect: z.enum(AssuranceProgramObligationBlockingEffect),
1183
+ requiredProofStage: z.enum(AssuranceProgramProofStage).systemEnum('AssuranceProgramProofStage'),
1184
+ blockingEffect: z.enum(AssuranceProgramObligationBlockingEffect).systemEnum('AssuranceProgramObligationBlockingEffect'),
648
1185
  gapRefs: z.array(AssuranceProgramFindingIdentitySchema),
649
1186
  dependencyObligationRefs: z.array(AssuranceProgramObligationIdentitySchema),
650
1187
  reviewOwnerRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
651
- reviewOn: AssuranceIsoDateSchema,
1188
+ /**
1189
+ * When this obligation is next reviewed, or ABSENT when no review schedule is committed.
1190
+ *
1191
+ * Optional since #647 decision C, and absence is a MARKED state rather than a gap: a programme
1192
+ * produced for an application that declares no periodic `assuranceReviewCadence` omits it on every
1193
+ * entry and carries a stamped `knownProgramLimitations` line saying no schedule is committed. It was
1194
+ * required, which meant an unscheduled programme could not be REPRESENTED at all — so the normalizer
1195
+ * refused, and a workflow fact (somebody committing to a schedule) stood in front of the mechanism.
1196
+ * An unfinished workflow MARKS; only an artifact that would be FALSE may refuse. Absent is never
1197
+ * "overdue" — the overdue check below skips it.
1198
+ */
1199
+ reviewOn: AssuranceIsoDateSchema.optional(),
652
1200
  reviewTriggerRefs: z.array(AssuranceNamespacedRefSchema).min(1),
653
1201
  })
654
1202
  .superRefine((entry, context) => {
@@ -695,7 +1243,13 @@ export const AssuranceProgramObligationEntrySchema = z
695
1243
  });
696
1244
  export type AssuranceProgramObligationEntry = z.infer<typeof AssuranceProgramObligationEntrySchema>;
697
1245
 
698
- /** Complete, content-addressed application obligation inventory. It is not the governed-document release register. */
1246
+ /**
1247
+ * Complete application obligation inventory. It is not the governed-document release register.
1248
+ *
1249
+ * It carried a digest until every digest was removed from the design (a digest chain cannot merge across branches) and the JSDoc went on calling it "content-addressed" afterwards. The
1250
+ * strict shape below is the whole truth: a ref, a version and the entries. Completeness is proven by `obligationCoverageDecisions` and the uniqueness refinement, not
1251
+ * by a hash. A test still named `registerWithoutDigest` is a leftover from when the field existed.
1252
+ */
699
1253
  export const AssuranceProgramObligationRegisterSchema = z
700
1254
  .strictObject({
701
1255
  schemaVersion: z.literal(1),
@@ -730,7 +1284,7 @@ export const AssuranceProgramSelectedOptionSchema = z.strictObject({
730
1284
 
731
1285
  export const AssuranceProgramCapabilitySelectionSchema = z
732
1286
  .strictObject({
733
- capabilityKind: z.enum(AssuranceProgramCapabilityKind),
1287
+ capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
734
1288
  capabilityRef: AssuranceNamespacedRefSchema,
735
1289
  capabilityVersion: z.number().int().positive(),
736
1290
  profileRef: AssuranceNamespacedRefSchema.optional(),
@@ -751,11 +1305,11 @@ export const AssuranceProgramImplementationDecisionSchema = z
751
1305
  decisionVersion: z.number().int().positive(),
752
1306
  objective: AssuranceObjectiveIdentitySchema,
753
1307
  scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
754
- resolution: z.enum(AssuranceProgramCapabilityResolution),
1308
+ resolution: z.enum(AssuranceProgramCapabilityResolution).systemEnum('AssuranceProgramCapabilityResolution'),
755
1309
  capabilitySelections: z.array(AssuranceProgramCapabilitySelectionSchema),
756
1310
  selectionAuthorityRef: AssuranceNamespacedRefSchema,
757
1311
  knownLimitations: z.array(z.string().trim().min(1)),
758
- gapDisposition: z.enum(AssuranceGapDisposition),
1312
+ gapDisposition: z.enum(AssuranceGapDisposition).systemEnum('AssuranceGapDisposition'),
759
1313
  gapRefs: z.array(AssuranceProgramFindingIdentitySchema),
760
1314
  })
761
1315
  .superRefine((decision, context) => {
@@ -784,14 +1338,41 @@ export const AssuranceProgramImplementationDecisionSchema = z
784
1338
  });
785
1339
  if (decision.resolution === AssuranceProgramCapabilityResolution.UNSUPPORTED && decision.capabilitySelections.length > 0)
786
1340
  context.addIssue({ code: "custom", message: "UNSUPPORTED resolution cannot select an implementation capability", path: ["capabilitySelections"] });
1341
+ /*
1342
+ * A HUMAN_OR_EXTERNAL resolution must SAY WHAT THE HUMAN DOES — and it may say so in prose,
1343
+ * because there is nothing for it to select.
1344
+ *
1345
+ * This required a `capabilitySelections` entry of kind `HUMAN_OR_EXTERNAL` until 2026-09-23
1346
+ * (#1273), and no producer could ever satisfy it. Measured: the authority basis declares 42
1347
+ * capabilities and every one is `ENGINE`; probed wide, `HUMAN_OR_EXTERNAL` appears in the whole
1348
+ * specifications tree only as these two enum members and this refusal. Inventing a ref does not
1349
+ * help either — the family separately refuses a selection with no declared authority
1350
+ * (`UNKNOWN_CAPABILITY`). So the requirement was doubly unsatisfiable, and it refused a producer
1351
+ * for being HONEST: on the first end-to-end journey run five obligations were correctly
1352
+ * classified as resolved by a human or external party and the programme was rejected three times
1353
+ * for it.
1354
+ *
1355
+ * The conflation underneath is worth naming, because it decides why the fix is not "add human
1356
+ * entries to the basis": `capabilitySelections` picks from the ENGINE capability basis, and a
1357
+ * human control ("the security officer reviews access quarterly") is operator-specific and can
1358
+ * never come from that basis. Two different kinds of thing were sharing one field.
1359
+ *
1360
+ * So the obligation moves to prose, which is where an operator control can actually be stated,
1361
+ * and the mechanism MARKS instead of refusing — `application-creation-directive.md`: if the
1362
+ * remedy is "author a commitment", it is a workflow, and a workflow never stands in front of the
1363
+ * mechanism. A selection of that kind stays LEGAL, so a future basis that does declare
1364
+ * human/external capabilities satisfies this with no change here.
1365
+ */
787
1366
  if (
788
1367
  decision.resolution === AssuranceProgramCapabilityResolution.HUMAN_OR_EXTERNAL &&
789
- !decision.capabilitySelections.some((selection) => selection.capabilityKind === AssuranceProgramCapabilityKind.HUMAN_OR_EXTERNAL)
1368
+ !decision.capabilitySelections.some((selection) => selection.capabilityKind === AssuranceProgramCapabilityKind.HUMAN_OR_EXTERNAL) &&
1369
+ decision.knownLimitations.length === 0
790
1370
  )
791
1371
  context.addIssue({
792
1372
  code: "custom",
793
- message: "HUMAN_OR_EXTERNAL resolution requires a human/external capability selection",
794
- path: ["capabilitySelections"],
1373
+ message:
1374
+ "HUMAN_OR_EXTERNAL resolution must state the human or external control — either a capability selection of that kind, or at least one knownLimitations entry describing what the human or external party does",
1375
+ path: ["knownLimitations"],
795
1376
  });
796
1377
  if (decision.gapDisposition === AssuranceGapDisposition.RESOLVED && decision.gapRefs.length > 0)
797
1378
  context.addIssue({ code: "custom", message: "RESOLVED disposition cannot retain open gap refs", path: ["gapRefs"] });
@@ -847,7 +1428,7 @@ export const AssuranceProgramGapOrExceptionSchema = z
847
1428
  .strictObject({
848
1429
  findingRef: AssuranceNamespacedRefSchema,
849
1430
  findingVersion: z.number().int().positive(),
850
- kind: z.enum(AssuranceProgramFindingKind),
1431
+ kind: z.enum(AssuranceProgramFindingKind).systemEnum('AssuranceProgramFindingKind'),
851
1432
  objective: AssuranceObjectiveIdentitySchema.optional(),
852
1433
  source: AssuranceSourceIdentitySchema.optional(),
853
1434
  scopeSelectorRef: AssuranceNamespacedRefSchema,
@@ -855,9 +1436,27 @@ export const AssuranceProgramGapOrExceptionSchema = z
855
1436
  reason: z.string().trim().min(1),
856
1437
  ownerRoleRef: AssuranceNamespacedRefSchema,
857
1438
  compensatingControlRefs: z.array(AssuranceNamespacedRefSchema),
858
- disposition: z.enum(AssuranceGapDisposition),
1439
+ disposition: z.enum(AssuranceGapDisposition).systemEnum('AssuranceGapDisposition'),
859
1440
  authorityDecisionRef: AssuranceNamespacedRefSchema.optional(),
860
- reviewOn: AssuranceIsoDateSchema,
1441
+ /**
1442
+ * When this finding is next revisited — DERIVED from the application's declared review cadence,
1443
+ * never answered.
1444
+ *
1445
+ * OPTIONAL, and absent exactly when the application commits to no periodic review (no
1446
+ * `assuranceReviewCadence`, or `AS_NEEDED`). The programme then carries
1447
+ * `UNSCHEDULED_REVIEW_LIMITATION`, so the absence is stated where every reader of the programme
1448
+ * meets it rather than being silent.
1449
+ *
1450
+ * This was REQUIRED until 2026-09-23 (#1273), and the requirement blocked the compliance lane for
1451
+ * every newly created application: nothing in the creation lane declares a cadence and no question
1452
+ * asks for one, so a run that honestly found a gap could not record it. The obligation register
1453
+ * beside it already marked rather than refused, and the generation module's own prose already said
1454
+ * the rule — "MARKED, never defaulted and never refused" — so this was that rule's one unvisited
1455
+ * site (`.claude/rules/invariant-call-site-enumeration.md`).
1456
+ *
1457
+ * Never DEFAULT it. Stamping a plausible date manufactures a commitment nobody made.
1458
+ */
1459
+ reviewOn: AssuranceIsoDateSchema.optional(),
861
1460
  expiresOn: AssuranceIsoDateSchema.optional(),
862
1461
  reopenOnSourceChange: z.literal(true),
863
1462
  reopenOnScopeChange: z.literal(true),
@@ -870,7 +1469,7 @@ export const AssuranceProgramGapOrExceptionSchema = z
870
1469
  if (finding.disposition === AssuranceGapDisposition.RISK_ACCEPTED && !finding.authorityDecisionRef) {
871
1470
  context.addIssue({ code: "custom", message: "risk acceptance requires an authority decision", path: ["authorityDecisionRef"] });
872
1471
  }
873
- if (finding.expiresOn && finding.reviewOn > finding.expiresOn) {
1472
+ if (finding.expiresOn && finding.reviewOn !== undefined && finding.reviewOn > finding.expiresOn) {
874
1473
  context.addIssue({ code: "custom", message: "reviewOn cannot follow expiresOn", path: ["reviewOn"] });
875
1474
  }
876
1475
  });
@@ -893,7 +1492,7 @@ const AssuranceProgramDocumentationRequirementCommonSchema = z.strictObject({
893
1492
 
894
1493
  /** Retained pre-document-authority shape. Parse/replay only; current application authoring uses v2. */
895
1494
  export const AssuranceProgramDocumentationRequirementV1Schema = AssuranceProgramDocumentationRequirementCommonSchema.extend({
896
- approvalRequirement: z.enum(AssuranceProgramDocumentApprovalRequirement),
1495
+ approvalRequirement: z.enum(AssuranceProgramDocumentApprovalRequirement).systemEnum('AssuranceProgramDocumentApprovalRequirement'),
897
1496
  }).superRefine((requirement, context) => {
898
1497
  addUniqueSortedIssue(requirement.requiredAcceptedFactRefs, context, ["requiredAcceptedFactRefs"], "requiredAcceptedFactRefs");
899
1498
  addUniqueSortedIssue(requirement.requiredVariableRefs, context, ["requiredVariableRefs"], "requiredVariableRefs");
@@ -918,15 +1517,15 @@ export const AssuranceProgramDocumentationRequirementV2Schema = AssuranceProgram
918
1517
  schemaVersion: z.literal(2),
919
1518
  definition: GovernedDocumentDefinitionIdentitySchema,
920
1519
  governanceScope: GovernedDocumentGovernanceScopeSchema,
921
- applicabilityStatus: z.enum(GovernedDocumentApplicabilityStatus),
1520
+ applicabilityStatus: z.enum(GovernedDocumentApplicabilityStatus).systemEnum('GovernedDocumentApplicabilityStatus'),
922
1521
  applicabilityRationale: z.string().trim().min(1),
923
1522
  applicabilityDecidedByRef: AssuranceNamespacedRefSchema,
924
1523
  applicabilityDecidedAt: AssuranceIsoDateTimeSchema,
925
1524
  applicabilityDependencyRefs: z.array(AssuranceNamespacedRefSchema).min(1),
926
- audienceKinds: z.array(z.enum(GovernedDocumentAudienceKind)).min(1),
927
- requiredReviewKinds: z.array(z.enum(GovernedDocumentReviewKind)).min(1),
928
- allowedInteractionKinds: z.array(z.enum(GovernedDocumentInteractionKind)),
929
- publicationChannelKinds: z.array(z.enum(GovernedDocumentPublicationChannelKind)).min(1),
1525
+ audienceKinds: z.array(z.enum(GovernedDocumentAudienceKind).systemEnum('GovernedDocumentAudienceKind')).min(1),
1526
+ requiredReviewKinds: z.array(z.enum(GovernedDocumentReviewKind).systemEnum('GovernedDocumentReviewKind')).min(1),
1527
+ allowedInteractionKinds: z.array(z.enum(GovernedDocumentInteractionKind).systemEnum('GovernedDocumentInteractionKind')),
1528
+ publicationChannelKinds: z.array(z.enum(GovernedDocumentPublicationChannelKind).systemEnum('GovernedDocumentPublicationChannelKind')).min(1),
930
1529
  }).superRefine((requirement, context) => {
931
1530
  for (const [key, values] of [
932
1531
  ["requiredAcceptedFactRefs", requirement.requiredAcceptedFactRefs],
@@ -1039,6 +1638,23 @@ export enum AssuranceProgramSpecificationIssueKind {
1039
1638
  * present and unchanged except for its implementation revision, see `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`.
1040
1639
  */
1041
1640
  UNKNOWN_CAPABILITY = "UNKNOWN_CAPABILITY",
1641
+ /**
1642
+ * An expectation this program claims REQUIRES a capability the application's own configuration does
1643
+ * not make available, because the engine capability that carries it is not enabled.
1644
+ *
1645
+ * Distinct from `RELATIONSHIP_MISMATCH`, which reads as "the accepted statement forgot to bind
1646
+ * something", and from `UNKNOWN_CAPABILITY`, which is about a capability the program CLAIMS. Here
1647
+ * nothing was forgotten and nothing is claimed wrongly: the control simply cannot be attested with
1648
+ * this configuration, and no amount of re-authoring the statement changes that. Reported separately
1649
+ * because the two remedies are opposites — bind the capability, versus enable the engine capability
1650
+ * or stop claiming the objective.
1651
+ *
1652
+ * The issue carries the resulting applicability so the reader does not have to derive it: an
1653
+ * objective whose expectation required ONLY unavailable capabilities is `NOT_APPLICABLE`, while one
1654
+ * that also required an available capability is `UNDETERMINED` — the control operates and only the
1655
+ * capability attesting it is absent. See `deriveExpectationCapabilityApplicability`.
1656
+ */
1657
+ REQUIRED_CAPABILITY_UNAVAILABLE = "REQUIRED_CAPABILITY_UNAVAILABLE",
1042
1658
  UNKNOWN_DOCUMENT = "UNKNOWN_DOCUMENT",
1043
1659
  UNKNOWN_DOCUMENT_SOURCE = "UNKNOWN_DOCUMENT_SOURCE",
1044
1660
  UNKNOWN_FINDING = "UNKNOWN_FINDING",
@@ -1108,6 +1724,12 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
1108
1724
  [AssuranceProgramSpecificationIssueKind.OBLIGATION_GOVERNANCE_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1109
1725
  [AssuranceProgramSpecificationIssueKind.OBLIGATION_REGISTER_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1110
1726
  [AssuranceProgramSpecificationIssueKind.RELATIONSHIP_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1727
+ /*
1728
+ * SPECIFICATION_DEFECT, and deliberately NOT host divergence: nothing has drifted and there is no
1729
+ * newer host state to re-accept. The program claims an objective this application's configuration
1730
+ * forecloses, which is a statement about the authored program rather than about the host moving.
1731
+ */
1732
+ [AssuranceProgramSpecificationIssueKind.REQUIRED_CAPABILITY_UNAVAILABLE]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1111
1733
  /*
1112
1734
  * Deliberately a specification defect, not host attestation: the host record is internally sound and the program
1113
1735
  * simply disagrees with it. That is equally consistent with a mis-transcribed reference and with host metadata
@@ -1139,6 +1761,50 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
1139
1761
  [AssuranceProgramSpecificationIssueKind.UNKNOWN_VALIDATION_AUTHORITY]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1140
1762
  };
1141
1763
 
1764
+ /**
1765
+ * What an application's enabled capability set does to ONE expectation's demand.
1766
+ *
1767
+ * A capability an application has not enabled is filtered out of its authority snapshot, so an
1768
+ * expectation requiring it can never be satisfied there. The question this answers is what that
1769
+ * SHOULD mean, and the answer differs by whether the missing capability IS the control or merely
1770
+ * attests one:
1771
+ *
1772
+ * | required capabilities available | status | reading |
1773
+ * |---|---|---|
1774
+ * | all | `APPLICABLE` | nothing stands in the way |
1775
+ * | none | `NOT_APPLICABLE` | the absent capability IS the control; there is nothing to claim |
1776
+ * | some | `UNDETERMINED` | the control operates, and the capability that would ATTEST it is absent |
1777
+ *
1778
+ * The middle and last rows are the distinction that matters, and collapsing them is the trap. Treating
1779
+ * a partly-available expectation as `NOT_APPLICABLE` would let an application escape a control it
1780
+ * genuinely implements — a consent record is still written, an administrative floor still refuses —
1781
+ * merely by leaving the capability that reports those acts switched off. Treating it as `APPLICABLE`
1782
+ * would claim evidence nobody can produce. `UNDETERMINED` is the only one of the three that is true.
1783
+ *
1784
+ * Deliberately a pure function of two sets, so the same rule serves validation, program generation and
1785
+ * anything that wants to warn an application builder BEFORE a run: one rule, one place to read it.
1786
+ */
1787
+ export function deriveExpectationCapabilityApplicability(input: {
1788
+ readonly requiredCapabilityRefs: readonly string[];
1789
+ readonly availableCapabilityRefs: ReadonlySet<string>;
1790
+ }): {
1791
+ readonly status: AssuranceProgramApplicabilityStatus;
1792
+ readonly unavailableCapabilityRefs: readonly string[];
1793
+ } {
1794
+ const unavailableCapabilityRefs = input.requiredCapabilityRefs.filter((capabilityRef) => !input.availableCapabilityRefs.has(capabilityRef));
1795
+ if (unavailableCapabilityRefs.length === 0) return { status: AssuranceProgramApplicabilityStatus.APPLICABLE, unavailableCapabilityRefs };
1796
+ /*
1797
+ * An expectation authority always declares at least one required capability (its schema sets
1798
+ * `.min(1)`), so "every required capability is unavailable" cannot be reached vacuously by an empty
1799
+ * demand — which would otherwise report NOT_APPLICABLE for an expectation that demanded nothing.
1800
+ */
1801
+ const status =
1802
+ unavailableCapabilityRefs.length === input.requiredCapabilityRefs.length
1803
+ ? AssuranceProgramApplicabilityStatus.NOT_APPLICABLE
1804
+ : AssuranceProgramApplicabilityStatus.UNDETERMINED;
1805
+ return { status, unavailableCapabilityRefs };
1806
+ }
1807
+
1142
1808
  /** Classifies one issue as a statement about the specification or about the host. */
1143
1809
  export function classifyAssuranceProgramSpecificationIssue(issue: Pick<AssuranceProgramSpecificationIssue, "kind">): AssuranceProgramSpecificationIssueClass {
1144
1810
  return ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND[issue.kind];
@@ -1213,7 +1879,16 @@ const AssuranceProgramV3CommonFieldsSchema = z.strictObject({
1213
1879
  ...AssuranceProgramCommonFieldsAfterObjectiveBindingsSchema.shape,
1214
1880
  });
1215
1881
 
1216
- /** Historical source-revision-pinned program. Retained payloads remain parseable and replayable but new authoring is forbidden by the repository pin checker. */
1882
+ /**
1883
+ * Historical source-revision-pinned program. Retained payloads remain parseable and replayable.
1884
+ *
1885
+ * This said "new authoring is forbidden by the repository pin checker" until 2026-09-01. **Nothing forbids it.** That checker was
1886
+ * `pnpm check:assurance-revision-pin`, removed on 2026-08-27 with the rest of the digest mechanism, and no successor exists — the
1887
+ * only assurance check in `package.json` is `check:assurance-control-boundary`, which is about marker source-neutrality.
1888
+ *
1889
+ * So v1 is discouraged by this comment and by nothing else. A safety claim standing on a removed mechanism is worse than no claim,
1890
+ * because a reader stops looking for the guard. Building one is #221; until it lands, "forbidden" means "please do not".
1891
+ */
1217
1892
  export const AssuranceProgramSpecificationV1Schema = z
1218
1893
  .strictObject({
1219
1894
  schemaVersion: z.literal(1),
@@ -1231,9 +1906,20 @@ export type AssuranceProgramSpecificationV1 = z.infer<typeof AssuranceProgramSpe
1231
1906
  *
1232
1907
  * Validation authorities currently carry one sealed basis snapshot. Accepting several authored bases would make
1233
1908
  * every extra basis compare against the wrong inventory and could misclassify an unverified authority as tolerable
1234
- * host drift. Multi-basis composition therefore requires a later schema version with basis-indexed snapshots. The
1235
- * repository checker continues recognizing existing v2 application authoring only through the serialized pre-v3
1236
- * transition; after Wonder accepts v3, v2 remains replayable rather than becoming a second current authoring shape.
1909
+ * host drift. Multi-basis composition therefore requires a later schema version with basis-indexed snapshots.
1910
+ *
1911
+ * This claimed a "repository checker" recognized v2 authoring "only through the serialized pre-v3 transition" until
1912
+ * 2026-09-01. There is no such checker — see the note on {@link AssuranceProgramSpecificationV1Schema}. The intent
1913
+ * stands and is worth keeping: after an application accepts v3, v2 should remain replayable rather than become a
1914
+ * second current authoring shape. It is an intent, not an enforced one (#221).
1915
+ *
1916
+ * Exactly one v2 programme exists today, in the framework's own reference application, and it is the only
1917
+ * assurance programme the framework ships an example of. Wonder CRM has none: what it carries is a PROCESSOR REGISTER, whose `schemaVersion: 1` belongs to
1918
+ * `ApplicationProcessorRegisterSchema` and must not be counted as a v1 programme.
1919
+ *
1920
+ * (An earlier revision named a `specifications/src/compliance/index.ts` register for the reference application, a
1921
+ * path it has never had — a processor register is authored under `specifications/src/processor-register/`. The
1922
+ * warning is kept because the confusion is real; the file-name half of it was not.)
1237
1923
  */
1238
1924
  export const AssuranceProgramSpecificationV2Schema = z
1239
1925
  .strictObject({
@@ -1249,7 +1935,7 @@ export type AssuranceProgramSpecificationV2 = z.infer<typeof AssuranceProgramSpe
1249
1935
 
1250
1936
  /**
1251
1937
  * Current application program. It preserves the v2 single-basis authority model while replacing the overlapping
1252
- * control-objective-binding array with one complete, digest-bound obligation register and its program-owned review
1938
+ * control-objective-binding array with one complete obligation register and its program-owned review
1253
1939
  * records. Activation and operating/evidence truth remain deliberately unrepresentable.
1254
1940
  */
1255
1941
  export const AssuranceProgramSpecificationV3Schema = z
@@ -2066,7 +2752,7 @@ export const validateAssuranceProgramSpecification = (
2066
2752
  * It is keyed on `basisRef@basisVersion`, the declared compatibility generation, so it fires when
2067
2753
  * the framework's interpretation contract moves and stays quiet for byte movement that does not.
2068
2754
  * (Five sibling checks here hashed the snapshot against its own material and were deleted
2069
- * 2026-08-27 — see `.claude/rules/one-source-of-truth.md`.)
2755
+ * 2026-08-27: a hash of a thing against itself can only catch a producer that already computed it wrong.)
2070
2756
  */
2071
2757
  if (program.schemaVersion !== 1) {
2072
2758
  const snapshotBasis = { basisRef: snapshot.snapshotRef, basisVersion: snapshot.snapshotVersion };
@@ -2088,6 +2774,14 @@ export const validateAssuranceProgramSpecification = (
2088
2774
  const objectiveRecords = new Map(snapshot.objectiveCatalog.objectives.map((objective) => [versionedObjectiveKey(objective.identity), objective]));
2089
2775
  const applicationRoleRefs = new Set<string>(snapshot.applicationRoleRefs);
2090
2776
  const hostCapabilities = new Map(snapshot.capabilityAuthorities.map((authority) => [versionedCapabilityKey(authority.identity), authority]));
2777
+ /*
2778
+ * Ref-only, unlike `hostCapabilities` above, and the difference is load-bearing. An expectation
2779
+ * authority names the capabilities it REQUIRES without a version, so asking the versioned map would
2780
+ * report every requirement as unavailable the moment a capability's version moved — a configuration
2781
+ * diagnosis for what is really a version question, which `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`
2782
+ * already answers properly.
2783
+ */
2784
+ const hostCapabilityRefs = new Set(snapshot.capabilityAuthorities.map((authority) => authority.identity.capabilityRef));
2091
2785
  const hostArtifacts = new Set(snapshot.implementationArtifacts.map((artifact) => artifact.artifactRef));
2092
2786
  const hostImplementationArtifactsByKind = new Map(snapshot.hostImplementationArtifacts.map((artifact) => [artifact.artifactKindRef, artifact]));
2093
2787
  const sourceRequirementAuthorities = new Map(snapshot.sourceRequirementAuthorities.map((authority) => [versionedSourceRequirementKey(authority), authority]));
@@ -2212,7 +2906,7 @@ export const validateAssuranceProgramSpecification = (
2212
2906
  path: `obligationRegister.entries.${entryIndex}.applicability.decidedAt`,
2213
2907
  message: `obligation applicability decision cannot predate its approved coverage review at ${coverageDecision.reviewedAt}`,
2214
2908
  });
2215
- if (entry.reviewOn < evaluatedOn)
2909
+ if (entry.reviewOn !== undefined && entry.reviewOn < evaluatedOn)
2216
2910
  issues.push({
2217
2911
  kind: AssuranceProgramSpecificationIssueKind.TEMPORAL_POLICY_CONFLICT,
2218
2912
  path: `obligationRegister.entries.${entryIndex}.reviewOn`,
@@ -2486,7 +3180,8 @@ export const validateAssuranceProgramSpecification = (
2486
3180
  path: `gapsAndExceptions.${index}.expiresOn`,
2487
3181
  message: `exception or risk acceptance expired before authority evaluation date ${evaluatedOn}`,
2488
3182
  });
2489
- if (finding.disposition !== AssuranceGapDisposition.RESOLVED && finding.reviewOn < evaluatedOn)
3183
+ // An unscheduled review cannot be overdue. The programme's stamped limitation is what says so.
3184
+ if (finding.disposition !== AssuranceGapDisposition.RESOLVED && finding.reviewOn !== undefined && finding.reviewOn < evaluatedOn)
2490
3185
  issues.push({
2491
3186
  kind: AssuranceProgramSpecificationIssueKind.TEMPORAL_POLICY_CONFLICT,
2492
3187
  path: `gapsAndExceptions.${index}.reviewOn`,
@@ -2571,7 +3266,33 @@ export const validateAssuranceProgramSpecification = (
2571
3266
  const statementVerification = new Set(statement.verificationExpectations.map((expectation) => expectation.expectationRef));
2572
3267
  binding.implementationExpectationRefs.forEach((identity) => {
2573
3268
  const authority = implementationExpectationAuthorities.get(versionedExpectationKey(identity));
2574
- if (authority?.requiredCapabilityRefs.some((capabilityRef) => !statementCapabilities.has(capabilityRef)))
3269
+ if (!authority) return;
3270
+ /*
3271
+ * Ask WHY before reporting that the statement does not satisfy the expectation. A capability the
3272
+ * application's configuration withholds cannot be bound by any statement, so the generic mismatch
3273
+ * below would tell an author to fix something they cannot fix — and that misdirection is not
3274
+ * theoretical: it has already cost rounds of evidence collection against an objective whose
3275
+ * attesting capability was never available, answerable from configuration before any was gathered.
3276
+ */
3277
+ const applicability = deriveExpectationCapabilityApplicability({
3278
+ requiredCapabilityRefs: authority.requiredCapabilityRefs,
3279
+ availableCapabilityRefs: hostCapabilityRefs,
3280
+ });
3281
+ if (applicability.status !== AssuranceProgramApplicabilityStatus.APPLICABLE) {
3282
+ issues.push({
3283
+ kind: AssuranceProgramSpecificationIssueKind.REQUIRED_CAPABILITY_UNAVAILABLE,
3284
+ path: `implementationStatements.${statementIndex}.capabilityBindingRefs`,
3285
+ subjectRef: versionedExpectationKey(identity),
3286
+ message:
3287
+ `${versionedExpectationKey(identity)} requires ${applicability.unavailableCapabilityRefs.join(", ")}, which this ` +
3288
+ `application's configuration does not make available, so the objective is ${applicability.status}. ` +
3289
+ (applicability.status === AssuranceProgramApplicabilityStatus.NOT_APPLICABLE
3290
+ ? "Every capability it required is absent, so there is no control here to claim: enable the engine capability that carries them, or stop claiming this objective."
3291
+ : "The control itself still operates; only the capability that would attest it is absent, so whether the objective holds cannot be determined from this configuration."),
3292
+ });
3293
+ return;
3294
+ }
3295
+ if (authority.requiredCapabilityRefs.some((capabilityRef) => !statementCapabilities.has(capabilityRef)))
2575
3296
  issues.push({
2576
3297
  kind: AssuranceProgramSpecificationIssueKind.RELATIONSHIP_MISMATCH,
2577
3298
  path: `implementationStatements.${statementIndex}.capabilityBindingRefs`,