@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

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 (1167) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  21. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  22. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  23. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  24. package/dist/esm/framework-knowledge.definitions.js +547 -17
  25. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  26. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  27. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  28. package/dist/esm/framework-knowledge.loader.js +47 -1
  29. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  30. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  31. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  32. package/dist/esm/index.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  34. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
  36. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
  38. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
  40. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
  42. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
  44. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
  46. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
  48. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  52. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  54. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  55. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
  56. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  57. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  58. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  59. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
  60. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
  62. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  63. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
  64. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  65. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  66. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
  68. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  70. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  71. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
  72. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  73. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
  74. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
  76. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
  78. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  79. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
  80. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  81. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  82. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
  84. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  86. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  88. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
  90. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
  94. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
  96. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  98. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  99. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  100. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  101. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  102. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  103. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  104. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  105. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  106. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  107. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  108. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  109. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  110. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  111. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  112. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
  114. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  115. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
  116. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  118. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  120. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  122. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  123. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  124. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  125. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
  126. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  127. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
  128. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
  130. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
  132. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  134. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  135. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
  136. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
  138. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
  140. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
  142. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
  144. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
  146. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
  148. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
  150. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
  152. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  153. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
  154. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  155. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
  156. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
  158. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  159. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
  160. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  161. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  162. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  163. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  164. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  165. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  166. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  167. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  168. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  169. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  170. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  171. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
  172. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  173. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  174. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  175. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
  176. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  177. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  178. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  179. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
  180. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  181. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  182. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  183. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
  184. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  185. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
  186. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  187. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
  188. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  189. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
  190. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  191. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
  192. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  193. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  194. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  195. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  196. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  197. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
  198. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  199. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
  200. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  201. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
  202. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  203. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
  204. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  205. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
  206. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  207. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
  208. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  209. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  210. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  211. package/dist/knowledge/manifest.json +9 -8
  212. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  213. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
  214. package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
  215. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
  216. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
  219. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
  220. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  221. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  222. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
  223. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
  224. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
  225. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
  226. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
  227. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
  228. package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
  229. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
  230. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
  231. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
  232. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
  233. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
  234. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
  235. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
  236. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
  237. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
  238. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
  239. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  240. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  241. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
  244. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
  245. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
  246. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  247. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
  248. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  249. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
  250. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  251. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  252. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  253. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  254. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  255. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  256. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
  257. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  258. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  259. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  260. package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
  261. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
  262. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  263. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  264. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
  267. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  268. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  269. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  270. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
  271. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
  272. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
  273. package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
  274. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
  275. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  276. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
  277. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  278. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  279. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
  280. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
  281. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  282. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
  283. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  284. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  285. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
  286. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
  287. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  288. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
  289. package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
  290. package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
  291. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  292. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
  293. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  294. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  295. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  296. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
  297. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  298. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
  299. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  300. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
  301. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  302. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  303. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
  304. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
  305. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  306. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  307. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  308. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
  309. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
  310. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
  311. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  312. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  313. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  314. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
  315. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
  316. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
  317. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  318. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  319. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
  320. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
  321. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
  322. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
  323. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  324. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  325. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  326. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  327. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  328. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  329. package/dist/knowledge/references/application-maturity.config.md +319 -0
  330. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  331. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  332. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  333. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  334. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  335. package/dist/knowledge/references/brand.asset.config.md +8 -16
  336. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  337. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  338. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  339. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  340. package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
  341. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  342. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  343. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/capability-composition.config.md +174 -0
  345. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  346. package/dist/knowledge/references/cli.market.utils.md +1 -0
  347. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  348. package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
  349. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  350. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  351. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  352. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  353. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  354. package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
  355. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  356. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  357. package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
  358. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  359. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  360. package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
  361. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  362. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  363. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  364. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  365. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  366. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  367. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  368. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  369. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  370. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  371. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
  372. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
  373. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  374. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  375. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  376. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  377. package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
  378. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  379. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  380. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  381. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  382. package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
  383. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  384. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  385. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  386. package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
  387. package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
  388. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  389. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
  390. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
  391. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  392. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
  393. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
  394. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  395. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  396. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
  397. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
  398. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  399. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  400. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  401. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  402. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  403. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  404. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  405. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  406. package/dist/knowledge/references/experience-plan.config.md +318 -0
  407. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
  408. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  409. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  410. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  411. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  412. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  413. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  414. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  415. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  416. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
  417. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  418. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  419. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  420. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  421. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  422. package/dist/knowledge/references/integration-plan.config.md +217 -0
  423. package/dist/knowledge/references/market.alternative.config.md +2 -2
  424. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  425. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  426. package/dist/knowledge/references/market.category.config.md +1 -1
  427. package/dist/knowledge/references/market.channel.config.md +4 -4
  428. package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
  429. package/dist/knowledge/references/market.gain.config.md +2 -2
  430. package/dist/knowledge/references/market.icp.config.md +3 -3
  431. package/dist/knowledge/references/market.job.config.md +2 -2
  432. package/dist/knowledge/references/market.message-template.config.md +3 -3
  433. package/dist/knowledge/references/market.objection.config.md +2 -2
  434. package/dist/knowledge/references/market.pain.config.md +2 -2
  435. package/dist/knowledge/references/market.persona.config.md +3 -3
  436. package/dist/knowledge/references/market.positioning.config.md +1 -1
  437. package/dist/knowledge/references/market.proof.config.md +2 -2
  438. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  439. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  440. package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
  441. package/dist/knowledge/references/market.trigger.config.md +2 -2
  442. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  443. package/dist/knowledge/references/placement-plan.config.md +375 -0
  444. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  445. package/dist/knowledge/references/platform.config.backing-services.md +15 -36
  446. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  447. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  448. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  449. package/dist/knowledge/references/platform.config.saas.md +261 -9
  450. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  451. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  452. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  453. package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
  454. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  455. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  456. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  457. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  458. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  459. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  460. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  461. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  462. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  463. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  464. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  465. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  466. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
  467. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  468. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  469. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  470. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
  471. package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
  472. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  473. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  479. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  480. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  481. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
  482. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  483. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  484. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  485. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  486. package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
  487. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  488. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  489. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  490. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  491. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  492. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  493. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  494. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  495. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  496. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  497. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  498. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  499. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
  500. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  501. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  502. package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
  503. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  504. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  505. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  506. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  507. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  508. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  509. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  510. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  511. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  513. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  514. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  515. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  516. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  517. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
  518. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  519. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  520. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
  521. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  522. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  523. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  524. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  525. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
  526. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
  527. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  528. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
  529. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  530. package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
  531. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  532. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  533. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  534. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  535. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  536. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  537. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  538. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  539. package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
  540. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  541. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  542. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
  543. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
  544. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  545. package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
  546. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  547. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
  548. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  549. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  550. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  551. package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
  552. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
  553. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  554. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  555. package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
  556. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  557. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  558. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  559. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  560. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  561. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  562. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  563. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  564. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  565. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  566. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  567. package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
  568. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  569. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  570. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  571. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  572. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  573. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  574. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  575. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  576. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  577. package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
  578. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
  579. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
  580. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
  581. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
  582. package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
  583. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
  584. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  585. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  586. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
  587. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  588. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  589. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  590. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  591. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  592. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  593. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  594. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  595. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  596. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  597. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  598. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  599. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  600. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  601. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  602. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  603. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  604. package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
  605. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  606. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  607. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
  608. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  609. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  610. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
  611. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  612. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  613. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  614. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  615. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
  616. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  617. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  618. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  619. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  620. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  621. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  622. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  623. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  624. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  625. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  626. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  627. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  628. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  629. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  630. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  631. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
  632. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
  633. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  634. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  635. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  636. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  637. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  638. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  639. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  640. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  641. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  642. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  643. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  644. package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
  645. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  646. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  647. package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
  648. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  649. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  650. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  651. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  652. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  653. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  654. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  655. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
  656. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
  657. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  658. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  659. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  660. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  661. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  662. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
  663. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  664. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  665. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
  666. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  667. package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
  668. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  669. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  670. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
  671. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
  672. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  673. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  674. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  675. package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
  676. package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
  677. package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
  678. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
  679. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  680. package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
  681. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  682. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  683. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  684. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  685. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  686. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  687. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  688. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  689. package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
  690. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  691. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  692. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  693. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  694. package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
  695. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  696. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  697. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  698. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  699. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  700. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  701. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  702. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  703. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  704. package/dist/knowledge/references/website-plan.config.md +238 -0
  705. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  706. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  707. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  708. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
  709. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
  710. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
  711. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  712. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  713. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  714. package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
  715. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
  716. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
  717. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  718. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  719. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  720. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  721. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
  722. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
  723. package/dist/knowledge/references/zod.factories.address.md +118 -0
  724. package/dist/knowledge/references/zod.factories.code.md +4 -2
  725. package/dist/knowledge/references/zod.factories.duration.md +6 -4
  726. package/dist/knowledge/references/zod.factories.money.md +5 -3
  727. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  728. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  729. package/dist/knowledge/registries/framework-topics.json +2602 -214
  730. package/dist/knowledge/registries/playbooks.json +468 -92
  731. package/dist/knowledge/registries/source-tags.json +6171 -1996
  732. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  733. package/dist/knowledge/rules/live-context-door.md +137 -0
  734. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  735. package/dist/knowledge/skills/INDEX.md +67 -29
  736. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  737. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  738. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  739. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  740. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  741. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  742. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  743. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  744. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  745. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
  746. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  747. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  748. package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
  749. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  750. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  751. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
  752. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
  753. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
  754. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
  755. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  756. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
  757. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  758. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  759. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  760. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
  761. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
  762. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  763. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  764. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
  765. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  766. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
  767. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  768. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  769. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  770. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
  771. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
  772. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
  773. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
  774. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  775. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  776. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  777. package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
  778. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
  779. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  780. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  781. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  782. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  783. package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
  784. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  785. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  786. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  787. package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
  788. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  789. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  790. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
  791. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
  792. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
  793. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
  794. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
  795. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  796. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  797. package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
  798. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
  799. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
  800. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  801. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
  802. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
  803. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  804. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
  805. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
  806. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  807. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  808. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  809. package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
  810. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  811. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  812. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  813. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  814. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
  815. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  816. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
  817. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  818. package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
  819. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
  820. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
  821. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
  822. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  823. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
  824. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  825. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
  826. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  827. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
  828. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
  829. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
  830. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  831. package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
  832. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  833. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
  834. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  835. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  836. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  837. package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
  838. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
  839. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  840. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  841. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  842. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  843. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
  844. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  845. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  846. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  847. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  848. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  849. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  850. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  851. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
  852. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
  853. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  854. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  855. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
  856. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
  857. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
  858. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
  859. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  860. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  861. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  862. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
  863. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  864. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
  865. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
  866. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  867. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  868. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  869. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  870. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
  871. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
  872. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  873. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
  874. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
  875. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
  876. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  877. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  878. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  879. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  880. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  881. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  882. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  883. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  884. package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
  885. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  886. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
  887. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  888. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  889. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  890. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  891. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  892. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  893. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  894. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  895. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  896. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  897. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
  898. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  899. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  900. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  901. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
  902. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
  903. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
  904. package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
  905. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  906. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  907. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  908. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  909. package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
  910. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
  911. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
  912. package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
  913. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
  914. package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
  915. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
  916. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
  917. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
  918. package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
  919. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  920. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  921. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
  922. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  923. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
  924. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  925. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
  926. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
  927. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
  928. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  929. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  930. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  931. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  932. package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
  933. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  934. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  935. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  936. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  937. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  938. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  939. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  940. package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
  941. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
  942. package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
  943. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
  944. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
  945. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  946. package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
  947. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  948. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  949. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  950. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  951. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  952. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  953. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  954. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  955. package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
  956. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  957. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  958. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  959. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  960. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  961. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  962. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  963. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  964. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  965. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
  966. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  967. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  968. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
  969. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  970. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  971. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  972. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  973. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  974. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
  975. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  976. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
  977. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  978. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
  979. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
  980. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  981. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
  982. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
  983. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  984. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  985. package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
  986. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  987. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
  988. package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
  989. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
  990. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  991. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  992. package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
  993. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
  994. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
  995. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
  996. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
  997. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
  998. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  999. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  1000. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  1001. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
  1002. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  1003. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
  1004. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  1005. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
  1006. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  1007. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
  1008. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
  1009. package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
  1010. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
  1011. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  1012. package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
  1013. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  1014. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  1015. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  1016. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
  1017. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
  1018. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
  1019. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  1020. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  1021. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  1022. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  1023. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  1024. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  1025. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  1026. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  1027. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  1028. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  1029. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
  1030. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  1031. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  1032. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  1033. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
  1034. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
  1035. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  1036. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  1037. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  1038. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  1039. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  1040. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  1041. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  1042. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  1043. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  1044. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
  1045. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  1046. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  1047. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  1048. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  1049. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
  1050. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
  1051. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  1052. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  1053. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
  1054. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
  1055. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  1056. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
  1057. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  1058. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  1059. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  1060. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  1061. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
  1062. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
  1063. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
  1064. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
  1065. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
  1066. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  1067. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  1068. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
  1069. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
  1070. package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
  1071. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  1072. package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
  1073. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  1074. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  1075. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  1076. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  1077. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  1078. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  1079. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  1080. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  1081. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  1082. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
  1083. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
  1084. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  1085. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  1086. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  1087. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
  1088. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
  1089. package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
  1090. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  1091. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  1092. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  1093. package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
  1094. package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
  1095. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  1096. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
  1097. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  1098. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  1099. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  1100. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
  1101. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  1102. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1103. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  1104. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
  1105. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  1106. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
  1107. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  1108. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  1109. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
  1110. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  1111. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  1112. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
  1113. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  1114. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
  1115. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
  1116. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
  1117. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
  1118. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  1119. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
  1120. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  1121. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  1122. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
  1123. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
  1124. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
  1125. package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
  1126. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  1127. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  1128. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  1129. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  1130. package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
  1131. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
  1132. package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
  1133. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
  1134. package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
  1135. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
  1136. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
  1137. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
  1138. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
  1139. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
  1140. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
  1141. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
  1142. package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
  1143. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
  1144. package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
  1145. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
  1146. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  1147. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
  1148. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
  1149. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  1150. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  1151. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
  1152. package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
  1153. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  1154. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  1155. package/dist/knowledge/topic-index.json +12659 -4142
  1156. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1157. package/dist/tsconfig.tsbuildinfo +1 -1
  1158. package/package.json +4 -4
  1159. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  1160. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  1161. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
  1162. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
  1163. package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
  1164. package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
  1165. package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
  1166. package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
  1167. /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,
@@ -175,7 +425,12 @@ export type AssuranceProgramRoleAuthority = z.infer<typeof AssuranceProgramRoleA
175
425
 
176
426
  /** Current role authority bound to one exact framework authority basis rather than its internal inventory. */
177
427
  export const AssuranceProgramRoleAuthorityV2Schema = z.strictObject({
178
- roleRef: AssuranceNamespacedRefSchema,
428
+ roleRef: AssuranceEntryKeySchema,
429
+ /**
430
+ * The role's NAME, as a reader meets it ("Application owner", "Control operator"). Optional because
431
+ * programmes landed before 2026-09-25 carry none — the role is then named by its `roleRef`.
432
+ */
433
+ title: z.string().trim().min(1).optional(),
179
434
  applicationRoleRef: z.string().trim().min(1),
180
435
  definitionAuthority: AssuranceProgramAuthorityBasisIdentitySchema,
181
436
  });
@@ -185,7 +440,7 @@ export type AssuranceProgramRoleAuthorityV2 = z.infer<typeof AssuranceProgramRol
185
440
  export const AssuranceProgramCapabilityAuthoritySchema = z
186
441
  .strictObject({
187
442
  identity: AssuranceCapabilityIdentitySchema,
188
- capabilityKind: z.enum(AssuranceProgramCapabilityKind),
443
+ capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
189
444
  implementationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
190
445
  implementationRevision: AssuranceProgramSourceRevisionIdentitySchema,
191
446
  })
@@ -198,7 +453,7 @@ export type AssuranceProgramCapabilityAuthority = z.infer<typeof AssuranceProgra
198
453
  export const AssuranceProgramCapabilityAuthorityV2Schema = z
199
454
  .strictObject({
200
455
  identity: AssuranceCapabilityIdentitySchema,
201
- capabilityKind: z.enum(AssuranceProgramCapabilityKind),
456
+ capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
202
457
  implementationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
203
458
  implementationAuthority: AssuranceProgramAuthorityBasisIdentitySchema,
204
459
  })
@@ -271,25 +526,368 @@ export const AssuranceProgramImplementationExpectationAuthoritySchema = z
271
526
  })
272
527
  .superRefine((authority, context) => addUniqueSortedIssue(authority.requiredCapabilityRefs, context, ["requiredCapabilityRefs"], "requiredCapabilityRefs"));
273
528
 
529
+ /**
530
+ * What one evidence demand actually ASKS FOR — the content behind an otherwise opaque
531
+ * `evidence-requirement:*` slug.
532
+ *
533
+ * Derived from the five paper bodies in `__evidence-plane-slice__/` rather than designed ahead of
534
+ * them (#302's whole premise: a schema error costs 1/49th here of what it costs after authoring at
535
+ * scale). The shape is what all five converged on, and the per-clause split is not decoration —
536
+ * three of the five carry clauses that do NOT share a home or a plane, and a single home per demand
537
+ * would have flattened exactly the distinction those bodies exist to record.
538
+ */
539
+ export const AssuranceEvidenceRequirementClauseSchema = z.strictObject({
540
+ /** Stable within the body — `C1`, `C2` — so a finding can name the clause it failed. */
541
+ clauseRef: z.string().trim().regex(/^C[0-9]+$/u),
542
+ /** The obligation in the objective's own terms, one clause of its intent. */
543
+ obligation: z.string().trim().min(1),
544
+ home: z.enum(AssuranceEvidenceHome).systemEnum('AssuranceEvidenceHome'),
545
+ plane: z.enum(AssuranceEvidenceExecutionPlane).systemEnum('AssuranceEvidenceExecutionPlane'),
546
+ /**
547
+ * For an `EMITTED` clause whose store is the audit trail: the event members that satisfy it, DERIVED
548
+ * from `CoreAuditableEventType` rather than transcribed.
549
+ *
550
+ * Structured rather than named in prose, and the reason is the harness's own most error-prone step:
551
+ * *"before naming any audit member, check it has an EMITTER"*. A member that is declared but never
552
+ * emitted raises a MAJOR against a working control the first time its activity occurs — which the
553
+ * first drafted body did, with `USER_MFA_ENABLED`. As a typed array the members are checkable by a
554
+ * test instead of by an author's memory, and a collector reads the query off the demand rather than
555
+ * parsing English out of `minimumEvidence`.
556
+ *
557
+ * Optional because only an audit-trail-backed clause has them: an application resource row, a batch
558
+ * execution record and a host artifact are all `EMITTED` or otherwise without audit members.
559
+ */
560
+ requiredAuditEventMembers: z.array(z.enum(CoreAuditableEventType)).min(1).optional(),
561
+ /**
562
+ * For an audit-trail-backed clause whose event TYPE carries several meanings: which rows of that
563
+ * type satisfy the clause, as one `eventData` field and the values that qualify.
564
+ *
565
+ * An event type is a closed vocabulary of KINDS; some kinds carry a second axis inside the row.
566
+ * `USER_PROVIDER_CREDENTIAL_DELETED` is one row shape for a revocation by its owner, an
567
+ * administrator's hard delete of the account, and a subject erasure, told apart by
568
+ * `eventData.reason`. Only the erasure is erasure evidence, and the requirement body said so in
569
+ * prose — which no collector reads. Counting by type alone over-counted the erasure clause with
570
+ * rows asserting that no erasure happened (#1087). The audit door filters by type, so the collector
571
+ * applies this predicate to every row it reads, and a measurement says how many rows of the type it
572
+ * set aside.
573
+ *
574
+ * Values are the member's own wire values (`ProviderCredentialDeletionReason.USER_ERASED`), named
575
+ * from the enum at the declaring site so the vocabulary stays with its source. Only meaningful
576
+ * beside `requiredAuditEventMembers`; a clause naming no event type has no rows to discriminate,
577
+ * and the refinement below refuses that pairing.
578
+ */
579
+ requiredAuditEventDataMatch: z
580
+ .strictObject({
581
+ /** The `eventData` field the meaning rides on (`reason`). Top-level in `eventData`, no path. */
582
+ field: z.string().trim().min(1),
583
+ /** The values that satisfy the clause. A row whose field holds any other value is set aside, not counted. */
584
+ values: z.array(z.string().trim().min(1)).min(1),
585
+ })
586
+ .optional(),
587
+ /**
588
+ * For an audit-trail-backed clause: one `eventData` field whose DISTRIBUTION over the counted rows the
589
+ * collector reports beside the count — reported, never judged.
590
+ *
591
+ * Some clauses count rows whose meaning has a second, OUTCOME-shaped axis that no discriminator should
592
+ * filter on, because every value is evidence. The instance is the erasure clause's credential rows (#1711):
593
+ * each `USER_ERASED` row carries `vendorRevocation` — whether the vendor was told the grant is over
594
+ * (`revoked`), could not be (`not_declared`, `not_configured`), or did not answer (`unreachable`,
595
+ * `refused`). A `requiredAuditEventDataMatch` on it would DROP the rows that did not revoke, which are the
596
+ * ones a reviewer most needs to see; the count alone hides them inside a total. So the collector reads
597
+ * every counted row and states how many carry each value, and how many carry none (rows written before
598
+ * the field existed).
599
+ *
600
+ * Only meaningful beside `requiredAuditEventMembers` (refused otherwise, below). It forces an exhaustive
601
+ * read of the window, because a distribution is a property of row CONTENT that no server-side total
602
+ * expresses.
603
+ */
604
+ reportedAuditEventDataDistribution: z
605
+ .strictObject({
606
+ /** The `eventData` field whose values are tallied (`vendorRevocation`). Top-level in `eventData`, no path. */
607
+ field: z.string().trim().min(1),
608
+ })
609
+ .optional(),
610
+ /**
611
+ * For an audit-trail-backed clause: one COUNT-shaped `eventData` field the collector SUMS over the counted rows
612
+ * and reports beside the count — reported, never judged (#1746).
613
+ *
614
+ * The distribution above suits an outcome with a few values; a count has as many values as it has sizes, and what
615
+ * a reviewer needs is the total. The instance is the erasure clause's pipeline runs: each
616
+ * `externalDataPipelineRun` read-through row carries `suppressedRows`, how many rows that run declined to re-import
617
+ * because an erasure suppressed their records. The row count says the runs happened; the sum says suppression held.
618
+ * A row carrying no number (written before the field existed) is counted apart, never as zero.
619
+ *
620
+ * Only meaningful beside `requiredAuditEventMembers` (refused otherwise, below), and it forces an exhaustive read of
621
+ * the window, for the same reason a distribution does.
622
+ */
623
+ reportedAuditEventDataSum: z
624
+ .strictObject({
625
+ /** The numeric `eventData` field summed (`suppressedRows`). Top-level in `eventData`, no path. */
626
+ field: z.string().trim().min(1),
627
+ })
628
+ .optional(),
629
+ /**
630
+ * Why this home, stated as the reasoning that is NOT the proxy.
631
+ *
632
+ * Required, because both available proxies are wrong often enough to matter: the attesting
633
+ * capability misread `PRIVILEGED_REVIEW` as an audit row when it is a human act, and the ref's head
634
+ * noun misread `retention-window-declaration` as `DECLARED` when its clauses demand enforcement.
635
+ */
636
+ /**
637
+ * What a row COUNT of the declared members cannot reach for this clause — present only when it cannot.
638
+ *
639
+ * The judge's EMITTED rule asks the audit trail one question: how many rows of these classes fell in the
640
+ * window. For an obligation that IS an existence claim — "issuance, refresh, rotation, revocation and
641
+ * expiry are explicit attributable transitions" — that count settles it, because each member is judged
642
+ * separately and all of them must have rows.
643
+ *
644
+ * It settles nothing for four other obligation shapes, and a count read as a verdict there OVERCLAIMS:
645
+ *
646
+ * | shape | why a count cannot reach it |
647
+ * |---|---|
648
+ * | the row must CARRY something | a count never opens a row, so "names the purpose, the subject and both withholding lists" is unread |
649
+ * | a DISJUNCTION | "audited OR refused" — rows evidence one branch and say nothing about what took the other |
650
+ * | a NEGATIVE or universal claim | "spent only for that principal" is about the rows that do NOT exist |
651
+ * | a property of the SYSTEM | "without the record itself becoming an availability risk" is not a property of any row |
652
+ *
653
+ * Declaring this does not weaken the clause; it stops the clause being reported as met on evidence that
654
+ * does not meet it. A member with rows and a declared limit is INSUFFICIENT_EVIDENCE rather than
655
+ * CONFORMANT, and `unreached` is the sentence a reader is given instead of a verdict. The zero-row
656
+ * readings are unaffected: a class that emitted nothing is still a nonconformity where activity is
657
+ * evidenced, and an observation where it is not — UNLESS the clause also declares `absenceUnreadable`.
658
+ *
659
+ * ABSENT means the obligation is an existence claim over the declared members. That is the common case
660
+ * and it is why this is an exception rather than a required field — but it is a CLAIM, so a clause
661
+ * asserting more than emission and declaring no limit here is a defect in the body, not a silence.
662
+ */
663
+ emittedCountLimit: z
664
+ .strictObject({
665
+ /** What the obligation asks that a count of these rows does not establish. One sentence, in the clause's own terms. */
666
+ unreached: z.string().trim().min(1),
667
+ /**
668
+ * Why ZERO rows cannot be read as a quiet period on this clause, where that is so. Present, a member with no rows and
669
+ * no evidenced activity is INSUFFICIENT_EVIDENCE rather than an OBSERVATION.
670
+ *
671
+ * Rare, and it exists for one shape: an obligation whose failing outcome itself leaves no row. "Audited OR refused"
672
+ * on a runtime whose emission is fire-and-forget is the instance — the access that was neither audited nor refused is
673
+ * exactly as silent as a window with no access at all, so reading silence as quiet would pass the case the clause
674
+ * exists to catch. Added 2026-09-21 after the adversarial judge (#297) found `security-event-record` C2's severity
675
+ * guidance excusing every absent row; the rule-based judge, which cannot see a runtime profile, needed the body to
676
+ * SAY so rather than infer it.
677
+ */
678
+ absenceUnreadable: z.string().trim().min(1).optional(),
679
+ })
680
+ .optional(),
681
+ homeRationale: z.string().trim().min(1),
682
+ }).superRefine((clause, context) => {
683
+ if (clause.emittedCountLimit && !clause.requiredAuditEventMembers) {
684
+ context.addIssue({
685
+ code: "custom",
686
+ path: ["emittedCountLimit"],
687
+ message: `clause ${clause.clauseRef} states what a row count does not reach but names no audit event type to count`,
688
+ });
689
+ }
690
+ if (clause.reportedAuditEventDataDistribution && !clause.requiredAuditEventMembers) {
691
+ context.addIssue({
692
+ code: "custom",
693
+ path: ["reportedAuditEventDataDistribution"],
694
+ message: `clause ${clause.clauseRef} reports the distribution of eventData.${clause.reportedAuditEventDataDistribution.field} but names no audit event type to read`,
695
+ });
696
+ }
697
+ if (clause.reportedAuditEventDataSum && !clause.requiredAuditEventMembers) {
698
+ context.addIssue({
699
+ code: "custom",
700
+ path: ["reportedAuditEventDataSum"],
701
+ message: `clause ${clause.clauseRef} sums eventData.${clause.reportedAuditEventDataSum.field} but names no audit event type to read`,
702
+ });
703
+ }
704
+ if (clause.requiredAuditEventDataMatch && !clause.requiredAuditEventMembers) {
705
+ context.addIssue({
706
+ code: "custom",
707
+ path: ["requiredAuditEventDataMatch"],
708
+ message: `clause ${clause.clauseRef} discriminates on eventData.${clause.requiredAuditEventDataMatch.field} but names no audit event type to read`,
709
+ });
710
+ }
711
+ });
712
+
713
+ /** @see AssuranceEvidenceRequirementClauseSchema */
714
+ export const AssuranceEvidenceRequirementBodySchema = z.strictObject({
715
+ schemaVersion: z.literal(1),
716
+ /**
717
+ * Whether the demand applies to THIS application at all, and how a judge decides.
718
+ *
719
+ * First field on purpose. `subject-erasure-execution-record` is majority application-owned, and an
720
+ * application that never built an erasure lane has not failed a control — it declared none. A body
721
+ * without this field invites a nonconformity against every application that does not implement it.
722
+ */
723
+ applicability: z.string().trim().min(1),
724
+ clauses: z.array(AssuranceEvidenceRequirementClauseSchema).min(1),
725
+ /** The artifacts that, at minimum, satisfy the demand — named vocabulary members, never prose lists. */
726
+ minimumEvidence: z.string().trim().min(1),
727
+ /** Mechanical enough that two judges gather the same thing. */
728
+ verificationSteps: z.array(z.string().trim().min(1)).min(1),
729
+ /**
730
+ * What an absence or failure MEANS, so severity follows evidenced risk rather than wording
731
+ * intensity — and so a control that operated with a missing evidence export stays an OBSERVATION
732
+ * rather than becoming a nonconformity.
733
+ */
734
+ severityGuidance: z.string().trim().min(1),
735
+ /** What the evidence does NOT prove, and what would make it stale. */
736
+ limits: z.string().trim().min(1),
737
+ });
738
+
739
+ export type AssuranceEvidenceRequirementBody = z.infer<typeof AssuranceEvidenceRequirementBodySchema>;
740
+
741
+ /**
742
+ * One stated evidence demand, paired with the body that says what would satisfy it.
743
+ *
744
+ * Paired rather than looked up, so a consumer reading an authority's pass conditions never has to decide
745
+ * which of several demands one body belongs to — the decision that went wrong, silently, the first time
746
+ * an authority stated two.
747
+ */
748
+ export const AssuranceProgramEvidenceRequirementBodyEntrySchema = z.strictObject({
749
+ requirementRef: AssuranceNamespacedRefSchema,
750
+ body: AssuranceEvidenceRequirementBodySchema,
751
+ });
752
+
753
+ export type AssuranceProgramEvidenceRequirementBodyEntry = z.infer<typeof AssuranceProgramEvidenceRequirementBodyEntrySchema>;
754
+
274
755
  export const AssuranceProgramEvidenceExpectationAuthoritySchema = z
275
756
  .strictObject({
276
757
  identity: AssuranceProgramExpectationIdentitySchema,
277
758
  objective: AssuranceObjectiveIdentitySchema,
278
759
  requiredStatementEvidenceRefs: z.array(AssuranceNamespacedRefSchema).min(1),
760
+ /**
761
+ * ONE BODY PER STATED DEMAND, in the order of `requiredStatementEvidenceRefs` — since 2026-09-12.
762
+ *
763
+ * This was a single `body`, joined by `requiredStatementEvidenceRefs[0]`, on the premise that every
764
+ * authority states one demand. `4ac83c1f` gave `WILDO.ACCESS.LEAST_PRIVILEGE` a second —
765
+ * `authorization-decision-record` beside `operation-role-declaration` — and the new ref sorts FIRST.
766
+ * From that commit the authority named `evidence-expectation:operation-role-declaration` carried the
767
+ * three clauses of the refusal record, and its own five clauses reached the composed basis nowhere.
768
+ * Nothing reported it: the guard beside the composer asserted that A body was present and that a body
769
+ * existed for `[0]`, and both stayed true. Reproduced on the committed collection plan, which answered
770
+ * a request for `operation-role-declaration` with a plan for a different demand, under that name.
771
+ *
772
+ * The history this field inherits: the single `body` became REQUIRED on 2026-09-10, when the catalog
773
+ * completed at 51 of 51 (#296 / #302), because an optional body invited a binding that shipped with
774
+ * nothing a collector could act on. That reasoning carries over whole — `.min(1)` and the agreement
775
+ * refinement below make a demand without its own body unrepresentable, now for every demand rather
776
+ * than the first.
777
+ *
778
+ * The verification authority below pairs its bodies the same way, and differs in one deliberate
779
+ * respect: it may carry FEWER bodies than demands, because an application's own basis may extend it
780
+ * with demands whose bodies are not written yet.
781
+ */
782
+ requirementBodies: z.array(AssuranceProgramEvidenceRequirementBodyEntrySchema).min(1),
279
783
  })
280
- .superRefine((authority, context) =>
281
- addUniqueSortedIssue(authority.requiredStatementEvidenceRefs, context, ["requiredStatementEvidenceRefs"], "requiredStatementEvidenceRefs"),
282
- );
784
+ .superRefine((authority, context) => {
785
+ addUniqueSortedIssue(authority.requiredStatementEvidenceRefs, context, ["requiredStatementEvidenceRefs"], "requiredStatementEvidenceRefs");
786
+ const pairedRequirementRefs = authority.requirementBodies.map((entry) => entry.requirementRef);
787
+ if (
788
+ pairedRequirementRefs.length !== authority.requiredStatementEvidenceRefs.length ||
789
+ pairedRequirementRefs.some((requirementRef, index) => requirementRef !== authority.requiredStatementEvidenceRefs[index])
790
+ ) {
791
+ context.addIssue({
792
+ code: "custom",
793
+ message: "requirementBodies must pair exactly one body with each stated demand, in the order of requiredStatementEvidenceRefs",
794
+ path: ["requirementBodies"],
795
+ });
796
+ }
797
+ });
798
+
799
+ /**
800
+ * What a VERIFICATION demand actually asks someone to do.
801
+ *
802
+ * The verification plane was degenerate until 2026-09-08: `requiredStatementVerificationRefs` held the
803
+ * expectation's own ref in 50 of 50 bindings, so the demand said "to verify X, see X" and stated
804
+ * nothing a verifier could act on (#452). The evidence axis beside it was never degenerate, which is
805
+ * what made the defect specific to this tier rather than a modelling slip.
806
+ *
807
+ * Deliberately NOT a copy of {@link AssuranceEvidenceRequirementBodySchema}. They answer different
808
+ * questions and conflating them is how a verification demand becomes a second evidence list:
809
+ *
810
+ * - EVIDENCE asks *what artifact proves this ran* — a row, an export, a declaration.
811
+ * - VERIFICATION asks *what a person or a test DOES to establish the control holds*, and what that
812
+ * act cannot establish.
813
+ *
814
+ * `acceptableMethods` is the field that makes it a demand rather than prose: it is drawn from
815
+ * {@link AssuranceVerificationMethod}, so a body states which kinds of act satisfy it and an
816
+ * application's own `AssuranceVerificationExpectation.method` can be checked against it.
817
+ */
818
+ export const AssuranceVerificationRequirementBodySchema = z.strictObject({
819
+ schemaVersion: z.literal(1),
820
+ /**
821
+ * Whether the demand applies to THIS application, and how a judge decides — first field for the
822
+ * same reason as on the evidence body: an application that declared no lane has not failed a
823
+ * control, and a body without this invites a nonconformity against everyone who did not build it.
824
+ */
825
+ applicability: z.string().trim().min(1),
826
+ /** Which kinds of act satisfy the demand. Named vocabulary members, never prose. */
827
+ acceptableMethods: z.array(z.enum(AssuranceVerificationMethod).systemEnum('AssuranceVerificationMethod')).min(1),
828
+ /** Mechanical enough that two verifiers perform the same act and can disagree about the result. */
829
+ procedure: z.array(z.string().trim().min(1)).min(1),
830
+ /** What a PASS looks like, stated so it can be false. */
831
+ passCriteria: z.string().trim().min(1),
832
+ /**
833
+ * What this act does NOT establish. The counterpart of an application's `limitationRefs`, and the
834
+ * field that stops a verification being read as operating effectiveness.
835
+ */
836
+ knownLimitations: z.string().trim().min(1),
837
+ /** What a failure MEANS, so severity follows evidenced risk rather than wording intensity. */
838
+ severityGuidance: z.string().trim().min(1),
839
+ });
840
+
841
+ export type AssuranceVerificationRequirementBody = z.infer<typeof AssuranceVerificationRequirementBodySchema>;
842
+
843
+ /**
844
+ * One stated verification demand, paired with the body that says what a verifier must do.
845
+ *
846
+ * The verification twin of `AssuranceProgramEvidenceRequirementBodyEntrySchema`: a body names its demand
847
+ * rather than being found by position, so no consumer has to decide which demand a body belongs to.
848
+ */
849
+ export const AssuranceProgramVerificationRequirementBodyEntrySchema = z.strictObject({
850
+ requirementRef: AssuranceNamespacedRefSchema,
851
+ body: AssuranceVerificationRequirementBodySchema,
852
+ });
853
+
854
+ export type AssuranceProgramVerificationRequirementBodyEntry = z.infer<typeof AssuranceProgramVerificationRequirementBodyEntrySchema>;
283
855
 
284
856
  export const AssuranceProgramVerificationExpectationAuthoritySchema = z
285
857
  .strictObject({
286
858
  identity: AssuranceProgramExpectationIdentitySchema,
287
859
  objective: AssuranceObjectiveIdentitySchema,
288
860
  requiredStatementVerificationRefs: z.array(AssuranceNamespacedRefSchema).min(1),
861
+ /**
862
+ * The bodies AUTHORED so far, each naming the stated demand it belongs to — since 2026-09-12.
863
+ *
864
+ * This was one optional `body`, joined by `requiredStatementVerificationRefs[0]`. The evidence tier
865
+ * beside it had the same join and silently swapped a body the first time an authority stated two
866
+ * demands: the new ref sorted first and took over. No binding states two verification demands, so
867
+ * this tier never swapped — but a body that did not name its demand could not be checked against one.
868
+ *
869
+ * POSSIBLY EMPTY, and fewer entries than demands is legitimate — the reason the single body was
870
+ * optional carries over whole. An application's own basis may extend the model with demands whose
871
+ * bodies are not written yet, and a schema that refused that would refuse a partially-authored
872
+ * extension; completeness for the FRAMEWORK's basis is a test, not a schema rule. What the refinement
873
+ * below does refuse is a body attached to a demand this authority does not state, or two bodies for
874
+ * one demand.
875
+ */
876
+ requirementBodies: z.array(AssuranceProgramVerificationRequirementBodyEntrySchema),
289
877
  })
290
- .superRefine((authority, context) =>
291
- addUniqueSortedIssue(authority.requiredStatementVerificationRefs, context, ["requiredStatementVerificationRefs"], "requiredStatementVerificationRefs"),
292
- );
878
+ .superRefine((authority, context) => {
879
+ addUniqueSortedIssue(authority.requiredStatementVerificationRefs, context, ["requiredStatementVerificationRefs"], "requiredStatementVerificationRefs");
880
+ const pairedRequirementRefs = authority.requirementBodies.map((entry) => entry.requirementRef);
881
+ addUniqueSortedIssue(pairedRequirementRefs, context, ["requirementBodies"], "requirementBodies requirementRefs");
882
+ const statedRequirementRefs = new Set<string>(authority.requiredStatementVerificationRefs);
883
+ if (pairedRequirementRefs.some((requirementRef) => !statedRequirementRefs.has(requirementRef))) {
884
+ context.addIssue({
885
+ code: "custom",
886
+ message: "every verification body names a demand this authority states in requiredStatementVerificationRefs",
887
+ path: ["requirementBodies"],
888
+ });
889
+ }
890
+ });
293
891
 
294
892
  export const AssuranceProgramValidationAuthoritySnapshotSchema = z
295
893
  .strictObject({
@@ -297,7 +895,7 @@ export const AssuranceProgramValidationAuthoritySnapshotSchema = z
297
895
  snapshotRef: AssuranceNamespacedRefSchema,
298
896
  snapshotVersion: z.number().int().positive(),
299
897
  evaluatedAt: AssuranceIsoDateTimeSchema,
300
- requestedSourceUses: z.array(z.enum(AssuranceSourceUse)).min(1),
898
+ requestedSourceUses: z.array(z.enum(AssuranceSourceUse).systemEnum('AssuranceSourceUse')).min(1),
301
899
  sourceRegistry: AssuranceSourceRegistrySchema,
302
900
  /** Optional only so retained pre-document-system snapshots stay parseable. */
303
901
  documentAuthorityCatalog: AssuranceDocumentAuthorityCatalogSchema.optional(),
@@ -401,9 +999,9 @@ export type AssuranceProgramValidationAuthoritySnapshot = z.infer<typeof Assuran
401
999
  export const AssuranceProgramSourceReferenceSchema = z.strictObject({
402
1000
  identity: AssuranceSourceIdentitySchema,
403
1001
  edition: z.string().trim().min(1),
404
- authorityKind: z.enum(AssuranceSourceAuthorityKind),
1002
+ authorityKind: z.enum(AssuranceSourceAuthorityKind).systemEnum('AssuranceSourceAuthorityKind'),
405
1003
  authorityName: z.string().trim().min(1),
406
- lifecycleStatus: z.enum(AssuranceSourceLifecycleStatus),
1004
+ lifecycleStatus: z.enum(AssuranceSourceLifecycleStatus).systemEnum('AssuranceSourceLifecycleStatus'),
407
1005
  rightsRef: AssuranceNamespacedRefSchema,
408
1006
  rightsVersion: z.number().int().positive(),
409
1007
  });
@@ -412,9 +1010,9 @@ export type AssuranceProgramSourceReference = z.infer<typeof AssuranceProgramSou
412
1010
  /** Reusable application-level scope policy. Runtime resolution supplies actual tenant and assignee identities. */
413
1011
  export const AssuranceProgramScopeSelectorSchema = z
414
1012
  .strictObject({
415
- scopeSelectorRef: AssuranceNamespacedRefSchema,
1013
+ scopeSelectorRef: AssuranceEntryKeySchema,
416
1014
  scopeSelectorVersion: z.number().int().positive(),
417
- kind: z.enum(AssuranceProgramScopeSelectorKind),
1015
+ kind: z.enum(AssuranceProgramScopeSelectorKind).systemEnum('AssuranceProgramScopeSelectorKind'),
418
1016
  systemBoundaryRefs: z.array(AssuranceNamespacedRefSchema).min(1),
419
1017
  organizationScopeRuleRefs: z.array(AssuranceNamespacedRefSchema),
420
1018
  jurisdictionRefs: z.array(AssuranceNamespacedRefSchema),
@@ -437,11 +1035,11 @@ export type AssuranceProgramScopeSelector = z.infer<typeof AssuranceProgramScope
437
1035
 
438
1036
  export const AssuranceProgramApplicabilityDecisionSchema = z
439
1037
  .strictObject({
440
- decisionRef: AssuranceNamespacedRefSchema,
1038
+ decisionRef: AssuranceEntryKeySchema,
441
1039
  decisionVersion: z.number().int().positive(),
442
1040
  source: AssuranceSourceIdentitySchema,
443
1041
  scopeSelectorRef: AssuranceNamespacedRefSchema,
444
- status: z.enum(AssuranceProgramApplicabilityStatus),
1042
+ status: z.enum(AssuranceProgramApplicabilityStatus).systemEnum('AssuranceProgramApplicabilityStatus'),
445
1043
  basis: z.string().trim().min(1),
446
1044
  authorityDecisionRef: AssuranceNamespacedRefSchema,
447
1045
  effectiveFrom: AssuranceIsoDateSchema,
@@ -494,7 +1092,7 @@ export const AssuranceProgramControlObjectiveBindingSchema = z
494
1092
  implementationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
495
1093
  evidenceExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
496
1094
  verificationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
497
- requiredProofStage: z.enum(AssuranceProgramProofStage),
1095
+ requiredProofStage: z.enum(AssuranceProgramProofStage).systemEnum('AssuranceProgramProofStage'),
498
1096
  })
499
1097
  .superRefine((binding, context) => {
500
1098
  addUniqueSortedIssue(binding.scopeSelectorRefs, context, ["scopeSelectorRefs"], "scopeSelectorRefs");
@@ -537,10 +1135,10 @@ export const AssuranceProgramSharedResponsibilityRuleIdentitySchema = z.strictOb
537
1135
  export type AssuranceProgramSharedResponsibilityRuleIdentity = z.infer<typeof AssuranceProgramSharedResponsibilityRuleIdentitySchema>;
538
1136
 
539
1137
  const AssuranceProgramSharedResponsibilityPrecedenceSchema = z.discriminatedUnion("mode", [
540
- z.strictObject({ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.SHARED_WITHOUT_PRECEDENCE) }),
1138
+ z.strictObject({ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.SHARED_WITHOUT_PRECEDENCE).systemEnum('AssuranceProgramSharedResponsibilityPrecedenceMode') }),
541
1139
  z.strictObject({
542
- mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.NAMED_ACTOR_PRECEDENCE),
543
- precedenceActorKind: z.enum(AssuranceGovernanceActorKind),
1140
+ mode: z.literal(AssuranceProgramSharedResponsibilityPrecedenceMode.NAMED_ACTOR_PRECEDENCE).systemEnum('AssuranceProgramSharedResponsibilityPrecedenceMode'),
1141
+ precedenceActorKind: z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind'),
544
1142
  }),
545
1143
  ]);
546
1144
 
@@ -550,10 +1148,10 @@ const AssuranceProgramSharedResponsibilityPrecedenceSchema = z.discriminatedUnio
550
1148
  */
551
1149
  export const AssuranceProgramSharedResponsibilityRuleSchema = z
552
1150
  .strictObject({
553
- sharedResponsibilityRuleRef: AssuranceNamespacedRefSchema,
1151
+ sharedResponsibilityRuleRef: AssuranceEntryKeySchema,
554
1152
  sharedResponsibilityRuleVersion: z.number().int().positive(),
555
1153
  scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
556
- governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind)).min(2),
1154
+ governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind')).min(2),
557
1155
  accountableRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
558
1156
  operatingRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
559
1157
  evidenceProviderRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
@@ -584,11 +1182,11 @@ export type AssuranceProgramSharedResponsibilityRule = z.infer<typeof AssuranceP
584
1182
  /** Exact human-reviewed coverage claim over one obligation and its complete cited source-requirement inventory. */
585
1183
  export const AssuranceProgramObligationCoverageDecisionSchema = z
586
1184
  .strictObject({
587
- coverageDecisionRef: AssuranceNamespacedRefSchema,
1185
+ coverageDecisionRef: AssuranceEntryKeySchema,
588
1186
  coverageDecisionVersion: z.number().int().positive(),
589
1187
  obligation: AssuranceProgramObligationIdentitySchema,
590
1188
  sourceRequirementRefs: z.array(AssuranceProgramSourceRequirementReferenceSchema).min(1),
591
- reviewDisposition: z.enum(AssuranceProgramObligationCoverageReviewDisposition),
1189
+ reviewDisposition: z.enum(AssuranceProgramObligationCoverageReviewDisposition).systemEnum('AssuranceProgramObligationCoverageReviewDisposition'),
592
1190
  reviewedByRoleRef: AssuranceNamespacedRefSchema,
593
1191
  reviewedAt: AssuranceIsoDateTimeSchema,
594
1192
  rationale: z.string().trim().min(1),
@@ -613,12 +1211,12 @@ const AssuranceProgramObligationApplicabilityDecisionCommonSchema = z.strictObje
613
1211
  /** Outcome-level applicability. It cannot encode lifecycle activation, operating status or a compliance conclusion. */
614
1212
  export const AssuranceProgramObligationApplicabilityDecisionSchema = z
615
1213
  .discriminatedUnion("status", [
616
- AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.APPLICABLE) }),
1214
+ AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.APPLICABLE).systemEnum('AssuranceProgramObligationApplicabilityStatus') }),
617
1215
  AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({
618
- status: z.literal(AssuranceProgramObligationApplicabilityStatus.NOT_APPLICABLE),
1216
+ status: z.literal(AssuranceProgramObligationApplicabilityStatus.NOT_APPLICABLE).systemEnum('AssuranceProgramObligationApplicabilityStatus'),
619
1217
  evidenceRefs: z.array(AssuranceNamespacedRefSchema).min(1),
620
1218
  }),
621
- AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.UNDETERMINED) }),
1219
+ AssuranceProgramObligationApplicabilityDecisionCommonSchema.extend({ status: z.literal(AssuranceProgramObligationApplicabilityStatus.UNDETERMINED).systemEnum('AssuranceProgramObligationApplicabilityStatus') }),
622
1220
  ])
623
1221
  .superRefine((decision, context) => {
624
1222
  addUniqueSortedIssue(decision.evidenceRefs, context, ["evidenceRefs"], "evidenceRefs");
@@ -629,11 +1227,11 @@ export type AssuranceProgramObligationApplicabilityDecision = z.infer<typeof Ass
629
1227
  /** One source-neutral application obligation. External framework ids and protected source bytes remain outside this contract. */
630
1228
  export const AssuranceProgramObligationEntrySchema = z
631
1229
  .strictObject({
632
- obligationRef: AssuranceNamespacedRefSchema,
1230
+ obligationRef: AssuranceEntryKeySchema,
633
1231
  obligationVersion: z.number().int().positive(),
634
1232
  objective: AssuranceObjectiveIdentitySchema,
635
1233
  scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
636
- governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind)).min(1),
1234
+ governanceActorKinds: z.array(z.enum(AssuranceGovernanceActorKind).systemEnum('AssuranceGovernanceActorKind')).min(1),
637
1235
  sharedResponsibilityRule: AssuranceProgramSharedResponsibilityRuleIdentitySchema.optional(),
638
1236
  sourceRequirementRefs: z.array(AssuranceProgramSourceRequirementReferenceSchema).min(1),
639
1237
  sourceApplicabilityDecisionRefs: z.array(AssuranceProgramSourceApplicabilityDecisionIdentitySchema).min(1),
@@ -643,12 +1241,23 @@ export const AssuranceProgramObligationEntrySchema = z
643
1241
  implementationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
644
1242
  evidenceExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
645
1243
  verificationExpectationRefs: z.array(AssuranceProgramExpectationIdentitySchema).min(1),
646
- requiredProofStage: z.enum(AssuranceProgramProofStage),
647
- blockingEffect: z.enum(AssuranceProgramObligationBlockingEffect),
1244
+ requiredProofStage: z.enum(AssuranceProgramProofStage).systemEnum('AssuranceProgramProofStage'),
1245
+ blockingEffect: z.enum(AssuranceProgramObligationBlockingEffect).systemEnum('AssuranceProgramObligationBlockingEffect'),
648
1246
  gapRefs: z.array(AssuranceProgramFindingIdentitySchema),
649
1247
  dependencyObligationRefs: z.array(AssuranceProgramObligationIdentitySchema),
650
1248
  reviewOwnerRoleRefs: z.array(AssuranceNamespacedRefSchema).min(1),
651
- reviewOn: AssuranceIsoDateSchema,
1249
+ /**
1250
+ * When this obligation is next reviewed, or ABSENT when no review schedule is committed.
1251
+ *
1252
+ * Optional since #647 decision C, and absence is a MARKED state rather than a gap: a programme
1253
+ * produced for an application that declares no periodic `assuranceReviewCadence` omits it on every
1254
+ * entry and carries a stamped `knownProgramLimitations` line saying no schedule is committed. It was
1255
+ * required, which meant an unscheduled programme could not be REPRESENTED at all — so the normalizer
1256
+ * refused, and a workflow fact (somebody committing to a schedule) stood in front of the mechanism.
1257
+ * An unfinished workflow MARKS; only an artifact that would be FALSE may refuse. Absent is never
1258
+ * "overdue" — the overdue check below skips it.
1259
+ */
1260
+ reviewOn: AssuranceIsoDateSchema.optional(),
652
1261
  reviewTriggerRefs: z.array(AssuranceNamespacedRefSchema).min(1),
653
1262
  })
654
1263
  .superRefine((entry, context) => {
@@ -695,7 +1304,13 @@ export const AssuranceProgramObligationEntrySchema = z
695
1304
  });
696
1305
  export type AssuranceProgramObligationEntry = z.infer<typeof AssuranceProgramObligationEntrySchema>;
697
1306
 
698
- /** Complete, content-addressed application obligation inventory. It is not the governed-document release register. */
1307
+ /**
1308
+ * Complete application obligation inventory. It is not the governed-document release register.
1309
+ *
1310
+ * 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
1311
+ * strict shape below is the whole truth: a ref, a version and the entries. Completeness is proven by `obligationCoverageDecisions` and the uniqueness refinement, not
1312
+ * by a hash. A test still named `registerWithoutDigest` is a leftover from when the field existed.
1313
+ */
699
1314
  export const AssuranceProgramObligationRegisterSchema = z
700
1315
  .strictObject({
701
1316
  schemaVersion: z.literal(1),
@@ -730,7 +1345,7 @@ export const AssuranceProgramSelectedOptionSchema = z.strictObject({
730
1345
 
731
1346
  export const AssuranceProgramCapabilitySelectionSchema = z
732
1347
  .strictObject({
733
- capabilityKind: z.enum(AssuranceProgramCapabilityKind),
1348
+ capabilityKind: z.enum(AssuranceProgramCapabilityKind).systemEnum('AssuranceProgramCapabilityKind'),
734
1349
  capabilityRef: AssuranceNamespacedRefSchema,
735
1350
  capabilityVersion: z.number().int().positive(),
736
1351
  profileRef: AssuranceNamespacedRefSchema.optional(),
@@ -747,15 +1362,15 @@ export const AssuranceProgramCapabilitySelectionSchema = z
747
1362
 
748
1363
  export const AssuranceProgramImplementationDecisionSchema = z
749
1364
  .strictObject({
750
- decisionRef: AssuranceNamespacedRefSchema,
1365
+ decisionRef: AssuranceEntryKeySchema,
751
1366
  decisionVersion: z.number().int().positive(),
752
1367
  objective: AssuranceObjectiveIdentitySchema,
753
1368
  scopeSelectorRefs: z.array(AssuranceNamespacedRefSchema).min(1),
754
- resolution: z.enum(AssuranceProgramCapabilityResolution),
1369
+ resolution: z.enum(AssuranceProgramCapabilityResolution).systemEnum('AssuranceProgramCapabilityResolution'),
755
1370
  capabilitySelections: z.array(AssuranceProgramCapabilitySelectionSchema),
756
1371
  selectionAuthorityRef: AssuranceNamespacedRefSchema,
757
1372
  knownLimitations: z.array(z.string().trim().min(1)),
758
- gapDisposition: z.enum(AssuranceGapDisposition),
1373
+ gapDisposition: z.enum(AssuranceGapDisposition).systemEnum('AssuranceGapDisposition'),
759
1374
  gapRefs: z.array(AssuranceProgramFindingIdentitySchema),
760
1375
  })
761
1376
  .superRefine((decision, context) => {
@@ -784,14 +1399,41 @@ export const AssuranceProgramImplementationDecisionSchema = z
784
1399
  });
785
1400
  if (decision.resolution === AssuranceProgramCapabilityResolution.UNSUPPORTED && decision.capabilitySelections.length > 0)
786
1401
  context.addIssue({ code: "custom", message: "UNSUPPORTED resolution cannot select an implementation capability", path: ["capabilitySelections"] });
1402
+ /*
1403
+ * A HUMAN_OR_EXTERNAL resolution must SAY WHAT THE HUMAN DOES — and it may say so in prose,
1404
+ * because there is nothing for it to select.
1405
+ *
1406
+ * This required a `capabilitySelections` entry of kind `HUMAN_OR_EXTERNAL` until 2026-09-23
1407
+ * (#1273), and no producer could ever satisfy it. Measured: the authority basis declares 42
1408
+ * capabilities and every one is `ENGINE`; probed wide, `HUMAN_OR_EXTERNAL` appears in the whole
1409
+ * specifications tree only as these two enum members and this refusal. Inventing a ref does not
1410
+ * help either — the family separately refuses a selection with no declared authority
1411
+ * (`UNKNOWN_CAPABILITY`). So the requirement was doubly unsatisfiable, and it refused a producer
1412
+ * for being HONEST: on the first end-to-end journey run five obligations were correctly
1413
+ * classified as resolved by a human or external party and the programme was rejected three times
1414
+ * for it.
1415
+ *
1416
+ * The conflation underneath is worth naming, because it decides why the fix is not "add human
1417
+ * entries to the basis": `capabilitySelections` picks from the ENGINE capability basis, and a
1418
+ * human control ("the security officer reviews access quarterly") is operator-specific and can
1419
+ * never come from that basis. Two different kinds of thing were sharing one field.
1420
+ *
1421
+ * So the obligation moves to prose, which is where an operator control can actually be stated,
1422
+ * and the mechanism MARKS instead of refusing — `application-creation-directive.md`: if the
1423
+ * remedy is "author a commitment", it is a workflow, and a workflow never stands in front of the
1424
+ * mechanism. A selection of that kind stays LEGAL, so a future basis that does declare
1425
+ * human/external capabilities satisfies this with no change here.
1426
+ */
787
1427
  if (
788
1428
  decision.resolution === AssuranceProgramCapabilityResolution.HUMAN_OR_EXTERNAL &&
789
- !decision.capabilitySelections.some((selection) => selection.capabilityKind === AssuranceProgramCapabilityKind.HUMAN_OR_EXTERNAL)
1429
+ !decision.capabilitySelections.some((selection) => selection.capabilityKind === AssuranceProgramCapabilityKind.HUMAN_OR_EXTERNAL) &&
1430
+ decision.knownLimitations.length === 0
790
1431
  )
791
1432
  context.addIssue({
792
1433
  code: "custom",
793
- message: "HUMAN_OR_EXTERNAL resolution requires a human/external capability selection",
794
- path: ["capabilitySelections"],
1434
+ message:
1435
+ "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",
1436
+ path: ["knownLimitations"],
795
1437
  });
796
1438
  if (decision.gapDisposition === AssuranceGapDisposition.RESOLVED && decision.gapRefs.length > 0)
797
1439
  context.addIssue({ code: "custom", message: "RESOLVED disposition cannot retain open gap refs", path: ["gapRefs"] });
@@ -845,9 +1487,9 @@ export type AssuranceProgramResponsibilityAssignment = z.infer<typeof AssuranceP
845
1487
 
846
1488
  export const AssuranceProgramGapOrExceptionSchema = z
847
1489
  .strictObject({
848
- findingRef: AssuranceNamespacedRefSchema,
1490
+ findingRef: AssuranceEntryKeySchema,
849
1491
  findingVersion: z.number().int().positive(),
850
- kind: z.enum(AssuranceProgramFindingKind),
1492
+ kind: z.enum(AssuranceProgramFindingKind).systemEnum('AssuranceProgramFindingKind'),
851
1493
  objective: AssuranceObjectiveIdentitySchema.optional(),
852
1494
  source: AssuranceSourceIdentitySchema.optional(),
853
1495
  scopeSelectorRef: AssuranceNamespacedRefSchema,
@@ -855,9 +1497,27 @@ export const AssuranceProgramGapOrExceptionSchema = z
855
1497
  reason: z.string().trim().min(1),
856
1498
  ownerRoleRef: AssuranceNamespacedRefSchema,
857
1499
  compensatingControlRefs: z.array(AssuranceNamespacedRefSchema),
858
- disposition: z.enum(AssuranceGapDisposition),
1500
+ disposition: z.enum(AssuranceGapDisposition).systemEnum('AssuranceGapDisposition'),
859
1501
  authorityDecisionRef: AssuranceNamespacedRefSchema.optional(),
860
- reviewOn: AssuranceIsoDateSchema,
1502
+ /**
1503
+ * When this finding is next revisited — DERIVED from the application's declared review cadence,
1504
+ * never answered.
1505
+ *
1506
+ * OPTIONAL, and absent exactly when the application commits to no periodic review (no
1507
+ * `assuranceReviewCadence`, or `AS_NEEDED`). The programme then carries
1508
+ * `UNSCHEDULED_REVIEW_LIMITATION`, so the absence is stated where every reader of the programme
1509
+ * meets it rather than being silent.
1510
+ *
1511
+ * This was REQUIRED until 2026-09-23 (#1273), and the requirement blocked the compliance lane for
1512
+ * every newly created application: nothing in the creation lane declares a cadence and no question
1513
+ * asks for one, so a run that honestly found a gap could not record it. The obligation register
1514
+ * beside it already marked rather than refused, and the generation module's own prose already said
1515
+ * the rule — "MARKED, never defaulted and never refused" — so this was that rule's one unvisited
1516
+ * site (`.claude/rules/invariant-call-site-enumeration.md`).
1517
+ *
1518
+ * Never DEFAULT it. Stamping a plausible date manufactures a commitment nobody made.
1519
+ */
1520
+ reviewOn: AssuranceIsoDateSchema.optional(),
861
1521
  expiresOn: AssuranceIsoDateSchema.optional(),
862
1522
  reopenOnSourceChange: z.literal(true),
863
1523
  reopenOnScopeChange: z.literal(true),
@@ -870,14 +1530,14 @@ export const AssuranceProgramGapOrExceptionSchema = z
870
1530
  if (finding.disposition === AssuranceGapDisposition.RISK_ACCEPTED && !finding.authorityDecisionRef) {
871
1531
  context.addIssue({ code: "custom", message: "risk acceptance requires an authority decision", path: ["authorityDecisionRef"] });
872
1532
  }
873
- if (finding.expiresOn && finding.reviewOn > finding.expiresOn) {
1533
+ if (finding.expiresOn && finding.reviewOn !== undefined && finding.reviewOn > finding.expiresOn) {
874
1534
  context.addIssue({ code: "custom", message: "reviewOn cannot follow expiresOn", path: ["reviewOn"] });
875
1535
  }
876
1536
  });
877
1537
  export type AssuranceProgramGapOrException = z.infer<typeof AssuranceProgramGapOrExceptionSchema>;
878
1538
 
879
1539
  const AssuranceProgramDocumentationRequirementCommonSchema = z.strictObject({
880
- requirementRef: AssuranceNamespacedRefSchema,
1540
+ requirementRef: AssuranceEntryKeySchema,
881
1541
  requirementVersion: z.number().int().positive(),
882
1542
  documentKindRef: AssuranceNamespacedRefSchema,
883
1543
  documentRef: AssuranceNamespacedRefSchema,
@@ -893,7 +1553,7 @@ const AssuranceProgramDocumentationRequirementCommonSchema = z.strictObject({
893
1553
 
894
1554
  /** Retained pre-document-authority shape. Parse/replay only; current application authoring uses v2. */
895
1555
  export const AssuranceProgramDocumentationRequirementV1Schema = AssuranceProgramDocumentationRequirementCommonSchema.extend({
896
- approvalRequirement: z.enum(AssuranceProgramDocumentApprovalRequirement),
1556
+ approvalRequirement: z.enum(AssuranceProgramDocumentApprovalRequirement).systemEnum('AssuranceProgramDocumentApprovalRequirement'),
897
1557
  }).superRefine((requirement, context) => {
898
1558
  addUniqueSortedIssue(requirement.requiredAcceptedFactRefs, context, ["requiredAcceptedFactRefs"], "requiredAcceptedFactRefs");
899
1559
  addUniqueSortedIssue(requirement.requiredVariableRefs, context, ["requiredVariableRefs"], "requiredVariableRefs");
@@ -918,15 +1578,15 @@ export const AssuranceProgramDocumentationRequirementV2Schema = AssuranceProgram
918
1578
  schemaVersion: z.literal(2),
919
1579
  definition: GovernedDocumentDefinitionIdentitySchema,
920
1580
  governanceScope: GovernedDocumentGovernanceScopeSchema,
921
- applicabilityStatus: z.enum(GovernedDocumentApplicabilityStatus),
1581
+ applicabilityStatus: z.enum(GovernedDocumentApplicabilityStatus).systemEnum('GovernedDocumentApplicabilityStatus'),
922
1582
  applicabilityRationale: z.string().trim().min(1),
923
1583
  applicabilityDecidedByRef: AssuranceNamespacedRefSchema,
924
1584
  applicabilityDecidedAt: AssuranceIsoDateTimeSchema,
925
1585
  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),
1586
+ audienceKinds: z.array(z.enum(GovernedDocumentAudienceKind).systemEnum('GovernedDocumentAudienceKind')).min(1),
1587
+ requiredReviewKinds: z.array(z.enum(GovernedDocumentReviewKind).systemEnum('GovernedDocumentReviewKind')).min(1),
1588
+ allowedInteractionKinds: z.array(z.enum(GovernedDocumentInteractionKind).systemEnum('GovernedDocumentInteractionKind')),
1589
+ publicationChannelKinds: z.array(z.enum(GovernedDocumentPublicationChannelKind).systemEnum('GovernedDocumentPublicationChannelKind')).min(1),
930
1590
  }).superRefine((requirement, context) => {
931
1591
  for (const [key, values] of [
932
1592
  ["requiredAcceptedFactRefs", requirement.requiredAcceptedFactRefs],
@@ -1002,6 +1662,18 @@ export enum AssuranceProgramSpecificationIssueKind {
1002
1662
  * offer the claimed capability at all.
1003
1663
  */
1004
1664
  HOST_CAPABILITY_IMPLEMENTATION_DRIFT = "HOST_CAPABILITY_IMPLEMENTATION_DRIFT",
1665
+ /**
1666
+ * The host still offers the accepted capability, under the same kind, but NO LONGER offers some of the
1667
+ * implementation refs the program accepted (#1750). The control is still present; what it is implemented by has
1668
+ * shrunk, so the named refs need a decision and re-acceptance. Distinct from `UNKNOWN_CAPABILITY`, which is
1669
+ * reserved for a host offering NONE of the accepted refs — a different implementation, not a narrowed one.
1670
+ *
1671
+ * A host that offers MORE refs than the program accepted is not divergence at all: a capability whose refs are a
1672
+ * vocabulary (every `CoreAuditableEventType`, for `capability:audit-events`) grows every time an unrelated
1673
+ * workstream adds a member, and treating growth as divergence made every accepted program read as having lost
1674
+ * the control — a refusal whose only remedy was to copy the enum into the program again.
1675
+ */
1676
+ HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN = "HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN",
1005
1677
  /** The host supplies a valid authority basis, but it is not the exact basis identity accepted by the v2/v3 program. */
1006
1678
  HOST_AUTHORITY_BASIS_DRIFT = "HOST_AUTHORITY_BASIS_DRIFT",
1007
1679
  /**
@@ -1034,11 +1706,30 @@ export enum AssuranceProgramSpecificationIssueKind {
1034
1706
  UNKNOWN_APPLICABILITY_SOURCE = "UNKNOWN_APPLICABILITY_SOURCE",
1035
1707
  UNKNOWN_BINDING_SOURCE = "UNKNOWN_BINDING_SOURCE",
1036
1708
  /**
1037
- * The host does not offer the claimed capability at all, offers it under a different capability kind, or resolves
1038
- * it to different implementation refs. No host state makes the authored claim true. For a capability that is
1039
- * present and unchanged except for its implementation revision, see `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`.
1709
+ * The host does not offer the claimed capability at all, offers it under a different capability kind, or offers
1710
+ * NONE of the implementation refs the program accepted. No host state makes the authored claim true. For a
1711
+ * capability that is present and unchanged except for its implementation revision, see
1712
+ * `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`; for one that kept some accepted refs and lost others, see
1713
+ * `HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN`.
1040
1714
  */
1041
1715
  UNKNOWN_CAPABILITY = "UNKNOWN_CAPABILITY",
1716
+ /**
1717
+ * An expectation this program claims REQUIRES a capability the application's own configuration does
1718
+ * not make available, because the engine capability that carries it is not enabled.
1719
+ *
1720
+ * Distinct from `RELATIONSHIP_MISMATCH`, which reads as "the accepted statement forgot to bind
1721
+ * something", and from `UNKNOWN_CAPABILITY`, which is about a capability the program CLAIMS. Here
1722
+ * nothing was forgotten and nothing is claimed wrongly: the control simply cannot be attested with
1723
+ * this configuration, and no amount of re-authoring the statement changes that. Reported separately
1724
+ * because the two remedies are opposites — bind the capability, versus enable the engine capability
1725
+ * or stop claiming the objective.
1726
+ *
1727
+ * The issue carries the resulting applicability so the reader does not have to derive it: an
1728
+ * objective whose expectation required ONLY unavailable capabilities is `NOT_APPLICABLE`, while one
1729
+ * that also required an available capability is `UNDETERMINED` — the control operates and only the
1730
+ * capability attesting it is absent. See `deriveExpectationCapabilityApplicability`.
1731
+ */
1732
+ REQUIRED_CAPABILITY_UNAVAILABLE = "REQUIRED_CAPABILITY_UNAVAILABLE",
1042
1733
  UNKNOWN_DOCUMENT = "UNKNOWN_DOCUMENT",
1043
1734
  UNKNOWN_DOCUMENT_SOURCE = "UNKNOWN_DOCUMENT_SOURCE",
1044
1735
  UNKNOWN_FINDING = "UNKNOWN_FINDING",
@@ -1089,6 +1780,7 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
1089
1780
  Record<AssuranceProgramSpecificationIssueKind, AssuranceProgramSpecificationIssueClass>
1090
1781
  > = {
1091
1782
  [AssuranceProgramSpecificationIssueKind.HOST_CAPABILITY_IMPLEMENTATION_DRIFT]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
1783
+ [AssuranceProgramSpecificationIssueKind.HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
1092
1784
  [AssuranceProgramSpecificationIssueKind.HOST_AUTHORITY_BASIS_DRIFT]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
1093
1785
  [AssuranceProgramSpecificationIssueKind.HOST_IMPLEMENTATION_ARTIFACT_DRIFT]: AssuranceProgramSpecificationIssueClass.HOST_DIVERGENCE,
1094
1786
  [AssuranceProgramSpecificationIssueKind.AUTHORITY_SNAPSHOT_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.HOST_ATTESTATION_INVALID,
@@ -1108,6 +1800,12 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
1108
1800
  [AssuranceProgramSpecificationIssueKind.OBLIGATION_GOVERNANCE_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1109
1801
  [AssuranceProgramSpecificationIssueKind.OBLIGATION_REGISTER_DIGEST_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1110
1802
  [AssuranceProgramSpecificationIssueKind.RELATIONSHIP_MISMATCH]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1803
+ /*
1804
+ * SPECIFICATION_DEFECT, and deliberately NOT host divergence: nothing has drifted and there is no
1805
+ * newer host state to re-accept. The program claims an objective this application's configuration
1806
+ * forecloses, which is a statement about the authored program rather than about the host moving.
1807
+ */
1808
+ [AssuranceProgramSpecificationIssueKind.REQUIRED_CAPABILITY_UNAVAILABLE]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1111
1809
  /*
1112
1810
  * Deliberately a specification defect, not host attestation: the host record is internally sound and the program
1113
1811
  * simply disagrees with it. That is equally consistent with a mis-transcribed reference and with host metadata
@@ -1139,6 +1837,50 @@ export const ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND: Readonly<
1139
1837
  [AssuranceProgramSpecificationIssueKind.UNKNOWN_VALIDATION_AUTHORITY]: AssuranceProgramSpecificationIssueClass.SPECIFICATION_DEFECT,
1140
1838
  };
1141
1839
 
1840
+ /**
1841
+ * What an application's enabled capability set does to ONE expectation's demand.
1842
+ *
1843
+ * A capability an application has not enabled is filtered out of its authority snapshot, so an
1844
+ * expectation requiring it can never be satisfied there. The question this answers is what that
1845
+ * SHOULD mean, and the answer differs by whether the missing capability IS the control or merely
1846
+ * attests one:
1847
+ *
1848
+ * | required capabilities available | status | reading |
1849
+ * |---|---|---|
1850
+ * | all | `APPLICABLE` | nothing stands in the way |
1851
+ * | none | `NOT_APPLICABLE` | the absent capability IS the control; there is nothing to claim |
1852
+ * | some | `UNDETERMINED` | the control operates, and the capability that would ATTEST it is absent |
1853
+ *
1854
+ * The middle and last rows are the distinction that matters, and collapsing them is the trap. Treating
1855
+ * a partly-available expectation as `NOT_APPLICABLE` would let an application escape a control it
1856
+ * genuinely implements — a consent record is still written, an administrative floor still refuses —
1857
+ * merely by leaving the capability that reports those acts switched off. Treating it as `APPLICABLE`
1858
+ * would claim evidence nobody can produce. `UNDETERMINED` is the only one of the three that is true.
1859
+ *
1860
+ * Deliberately a pure function of two sets, so the same rule serves validation, program generation and
1861
+ * anything that wants to warn an application builder BEFORE a run: one rule, one place to read it.
1862
+ */
1863
+ export function deriveExpectationCapabilityApplicability(input: {
1864
+ readonly requiredCapabilityRefs: readonly string[];
1865
+ readonly availableCapabilityRefs: ReadonlySet<string>;
1866
+ }): {
1867
+ readonly status: AssuranceProgramApplicabilityStatus;
1868
+ readonly unavailableCapabilityRefs: readonly string[];
1869
+ } {
1870
+ const unavailableCapabilityRefs = input.requiredCapabilityRefs.filter((capabilityRef) => !input.availableCapabilityRefs.has(capabilityRef));
1871
+ if (unavailableCapabilityRefs.length === 0) return { status: AssuranceProgramApplicabilityStatus.APPLICABLE, unavailableCapabilityRefs };
1872
+ /*
1873
+ * An expectation authority always declares at least one required capability (its schema sets
1874
+ * `.min(1)`), so "every required capability is unavailable" cannot be reached vacuously by an empty
1875
+ * demand — which would otherwise report NOT_APPLICABLE for an expectation that demanded nothing.
1876
+ */
1877
+ const status =
1878
+ unavailableCapabilityRefs.length === input.requiredCapabilityRefs.length
1879
+ ? AssuranceProgramApplicabilityStatus.NOT_APPLICABLE
1880
+ : AssuranceProgramApplicabilityStatus.UNDETERMINED;
1881
+ return { status, unavailableCapabilityRefs };
1882
+ }
1883
+
1142
1884
  /** Classifies one issue as a statement about the specification or about the host. */
1143
1885
  export function classifyAssuranceProgramSpecificationIssue(issue: Pick<AssuranceProgramSpecificationIssue, "kind">): AssuranceProgramSpecificationIssueClass {
1144
1886
  return ASSURANCE_PROGRAM_SPECIFICATION_ISSUE_CLASS_BY_KIND[issue.kind];
@@ -1213,7 +1955,16 @@ const AssuranceProgramV3CommonFieldsSchema = z.strictObject({
1213
1955
  ...AssuranceProgramCommonFieldsAfterObjectiveBindingsSchema.shape,
1214
1956
  });
1215
1957
 
1216
- /** Historical source-revision-pinned program. Retained payloads remain parseable and replayable but new authoring is forbidden by the repository pin checker. */
1958
+ /**
1959
+ * Historical source-revision-pinned program. Retained payloads remain parseable and replayable.
1960
+ *
1961
+ * This said "new authoring is forbidden by the repository pin checker" until 2026-09-01. **Nothing forbids it.** That checker was
1962
+ * `pnpm check:assurance-revision-pin`, removed on 2026-08-27 with the rest of the digest mechanism, and no successor exists — the
1963
+ * only assurance check in `package.json` is `check:assurance-control-boundary`, which is about marker source-neutrality.
1964
+ *
1965
+ * So v1 is discouraged by this comment and by nothing else. A safety claim standing on a removed mechanism is worse than no claim,
1966
+ * because a reader stops looking for the guard. Building one is #221; until it lands, "forbidden" means "please do not".
1967
+ */
1217
1968
  export const AssuranceProgramSpecificationV1Schema = z
1218
1969
  .strictObject({
1219
1970
  schemaVersion: z.literal(1),
@@ -1231,9 +1982,20 @@ export type AssuranceProgramSpecificationV1 = z.infer<typeof AssuranceProgramSpe
1231
1982
  *
1232
1983
  * Validation authorities currently carry one sealed basis snapshot. Accepting several authored bases would make
1233
1984
  * 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.
1985
+ * host drift. Multi-basis composition therefore requires a later schema version with basis-indexed snapshots.
1986
+ *
1987
+ * This claimed a "repository checker" recognized v2 authoring "only through the serialized pre-v3 transition" until
1988
+ * 2026-09-01. There is no such checker — see the note on {@link AssuranceProgramSpecificationV1Schema}. The intent
1989
+ * stands and is worth keeping: after an application accepts v3, v2 should remain replayable rather than become a
1990
+ * second current authoring shape. It is an intent, not an enforced one (#221).
1991
+ *
1992
+ * Exactly one v2 programme exists today, in the framework's own reference application, and it is the only
1993
+ * assurance programme the framework ships an example of. Wonder CRM has none: what it carries is a PROCESSOR REGISTER, whose `schemaVersion: 1` belongs to
1994
+ * `ApplicationProcessorRegisterSchema` and must not be counted as a v1 programme.
1995
+ *
1996
+ * (An earlier revision named a `specifications/src/compliance/index.ts` register for the reference application, a
1997
+ * path it has never had — a processor register is authored under `specifications/src/processor-register/`. The
1998
+ * warning is kept because the confusion is real; the file-name half of it was not.)
1237
1999
  */
1238
2000
  export const AssuranceProgramSpecificationV2Schema = z
1239
2001
  .strictObject({
@@ -1249,7 +2011,7 @@ export type AssuranceProgramSpecificationV2 = z.infer<typeof AssuranceProgramSpe
1249
2011
 
1250
2012
  /**
1251
2013
  * 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
2014
+ * control-objective-binding array with one complete obligation register and its program-owned review
1253
2015
  * records. Activation and operating/evidence truth remain deliberately unrepresentable.
1254
2016
  */
1255
2017
  export const AssuranceProgramSpecificationV3Schema = z
@@ -2066,7 +2828,7 @@ export const validateAssuranceProgramSpecification = (
2066
2828
  * It is keyed on `basisRef@basisVersion`, the declared compatibility generation, so it fires when
2067
2829
  * the framework's interpretation contract moves and stays quiet for byte movement that does not.
2068
2830
  * (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`.)
2831
+ * 2026-08-27: a hash of a thing against itself can only catch a producer that already computed it wrong.)
2070
2832
  */
2071
2833
  if (program.schemaVersion !== 1) {
2072
2834
  const snapshotBasis = { basisRef: snapshot.snapshotRef, basisVersion: snapshot.snapshotVersion };
@@ -2088,6 +2850,14 @@ export const validateAssuranceProgramSpecification = (
2088
2850
  const objectiveRecords = new Map(snapshot.objectiveCatalog.objectives.map((objective) => [versionedObjectiveKey(objective.identity), objective]));
2089
2851
  const applicationRoleRefs = new Set<string>(snapshot.applicationRoleRefs);
2090
2852
  const hostCapabilities = new Map(snapshot.capabilityAuthorities.map((authority) => [versionedCapabilityKey(authority.identity), authority]));
2853
+ /*
2854
+ * Ref-only, unlike `hostCapabilities` above, and the difference is load-bearing. An expectation
2855
+ * authority names the capabilities it REQUIRES without a version, so asking the versioned map would
2856
+ * report every requirement as unavailable the moment a capability's version moved — a configuration
2857
+ * diagnosis for what is really a version question, which `HOST_CAPABILITY_IMPLEMENTATION_DRIFT`
2858
+ * already answers properly.
2859
+ */
2860
+ const hostCapabilityRefs = new Set(snapshot.capabilityAuthorities.map((authority) => authority.identity.capabilityRef));
2091
2861
  const hostArtifacts = new Set(snapshot.implementationArtifacts.map((artifact) => artifact.artifactRef));
2092
2862
  const hostImplementationArtifactsByKind = new Map(snapshot.hostImplementationArtifacts.map((artifact) => [artifact.artifactKindRef, artifact]));
2093
2863
  const sourceRequirementAuthorities = new Map(snapshot.sourceRequirementAuthorities.map((authority) => [versionedSourceRequirementKey(authority), authority]));
@@ -2212,7 +2982,7 @@ export const validateAssuranceProgramSpecification = (
2212
2982
  path: `obligationRegister.entries.${entryIndex}.applicability.decidedAt`,
2213
2983
  message: `obligation applicability decision cannot predate its approved coverage review at ${coverageDecision.reviewedAt}`,
2214
2984
  });
2215
- if (entry.reviewOn < evaluatedOn)
2985
+ if (entry.reviewOn !== undefined && entry.reviewOn < evaluatedOn)
2216
2986
  issues.push({
2217
2987
  kind: AssuranceProgramSpecificationIssueKind.TEMPORAL_POLICY_CONFLICT,
2218
2988
  path: `obligationRegister.entries.${entryIndex}.reviewOn`,
@@ -2280,8 +3050,15 @@ export const validateAssuranceProgramSpecification = (
2280
3050
  * bytes moved". The first can never be resolved by re-accepting; the second is resolved by exactly that.
2281
3051
  * Identity, kind and implementation refs are checked first because a capability that fails any of them is not
2282
3052
  * the accepted control at all — its revision is then irrelevant.
3053
+ *
3054
+ * Implementation refs are compared by CONTAINMENT, not equality (#1750): the host must still offer every ref the
3055
+ * program accepted. Refs the host ADDED are not divergence — a vocabulary-shaped capability grows whenever an
3056
+ * unrelated workstream adds a member. Refs it WITHDREW are divergence the operator must decide on, named. A host
3057
+ * offering none of them resolves the capability to a different implementation, which is not the accepted control.
2283
3058
  */
2284
- if (!host || host.capabilityKind !== authority.capabilityKind || JSON.stringify(host.implementationRefs) !== JSON.stringify(authority.implementationRefs)) {
3059
+ const hostRefs = new Set<string>(host?.implementationRefs ?? []);
3060
+ const withdrawnRefs = authority.implementationRefs.filter((ref) => !hostRefs.has(ref));
3061
+ if (!host || host.capabilityKind !== authority.capabilityKind || withdrawnRefs.length === authority.implementationRefs.length) {
2285
3062
  issues.push({
2286
3063
  kind: AssuranceProgramSpecificationIssueKind.UNKNOWN_CAPABILITY,
2287
3064
  path: `capabilityAuthorities.${index}`,
@@ -2289,6 +3066,16 @@ export const validateAssuranceProgramSpecification = (
2289
3066
  });
2290
3067
  return;
2291
3068
  }
3069
+ if (withdrawnRefs.length > 0) {
3070
+ issues.push({
3071
+ kind: AssuranceProgramSpecificationIssueKind.HOST_CAPABILITY_IMPLEMENTATION_REFS_WITHDRAWN,
3072
+ path: `capabilityAuthorities.${index}.implementationRefs`,
3073
+ // The withdrawn refs are part of the SUBJECT, not only the prose: tolerating the loss of one ref must not
3074
+ // tolerate a later, different loss under the same capability.
3075
+ subjectRef: `${key}#${withdrawnRefs.join(",")}`,
3076
+ message: `capability authority ${key} is still offered by the host, but no longer offers ${withdrawnRefs.length} implementation ref(s) the program accepted: ${withdrawnRefs.join(", ")}`,
3077
+ });
3078
+ }
2292
3079
  const implementationIdentityMatches =
2293
3080
  program.schemaVersion === 1
2294
3081
  ? sourceRevisionKey(host.implementationRevision) === sourceRevisionKey(authority.implementationRevision)
@@ -2486,7 +3273,8 @@ export const validateAssuranceProgramSpecification = (
2486
3273
  path: `gapsAndExceptions.${index}.expiresOn`,
2487
3274
  message: `exception or risk acceptance expired before authority evaluation date ${evaluatedOn}`,
2488
3275
  });
2489
- if (finding.disposition !== AssuranceGapDisposition.RESOLVED && finding.reviewOn < evaluatedOn)
3276
+ // An unscheduled review cannot be overdue. The programme's stamped limitation is what says so.
3277
+ if (finding.disposition !== AssuranceGapDisposition.RESOLVED && finding.reviewOn !== undefined && finding.reviewOn < evaluatedOn)
2490
3278
  issues.push({
2491
3279
  kind: AssuranceProgramSpecificationIssueKind.TEMPORAL_POLICY_CONFLICT,
2492
3280
  path: `gapsAndExceptions.${index}.reviewOn`,
@@ -2571,7 +3359,33 @@ export const validateAssuranceProgramSpecification = (
2571
3359
  const statementVerification = new Set(statement.verificationExpectations.map((expectation) => expectation.expectationRef));
2572
3360
  binding.implementationExpectationRefs.forEach((identity) => {
2573
3361
  const authority = implementationExpectationAuthorities.get(versionedExpectationKey(identity));
2574
- if (authority?.requiredCapabilityRefs.some((capabilityRef) => !statementCapabilities.has(capabilityRef)))
3362
+ if (!authority) return;
3363
+ /*
3364
+ * Ask WHY before reporting that the statement does not satisfy the expectation. A capability the
3365
+ * application's configuration withholds cannot be bound by any statement, so the generic mismatch
3366
+ * below would tell an author to fix something they cannot fix — and that misdirection is not
3367
+ * theoretical: it has already cost rounds of evidence collection against an objective whose
3368
+ * attesting capability was never available, answerable from configuration before any was gathered.
3369
+ */
3370
+ const applicability = deriveExpectationCapabilityApplicability({
3371
+ requiredCapabilityRefs: authority.requiredCapabilityRefs,
3372
+ availableCapabilityRefs: hostCapabilityRefs,
3373
+ });
3374
+ if (applicability.status !== AssuranceProgramApplicabilityStatus.APPLICABLE) {
3375
+ issues.push({
3376
+ kind: AssuranceProgramSpecificationIssueKind.REQUIRED_CAPABILITY_UNAVAILABLE,
3377
+ path: `implementationStatements.${statementIndex}.capabilityBindingRefs`,
3378
+ subjectRef: versionedExpectationKey(identity),
3379
+ message:
3380
+ `${versionedExpectationKey(identity)} requires ${applicability.unavailableCapabilityRefs.join(", ")}, which this ` +
3381
+ `application's configuration does not make available, so the objective is ${applicability.status}. ` +
3382
+ (applicability.status === AssuranceProgramApplicabilityStatus.NOT_APPLICABLE
3383
+ ? "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."
3384
+ : "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."),
3385
+ });
3386
+ return;
3387
+ }
3388
+ if (authority.requiredCapabilityRefs.some((capabilityRef) => !statementCapabilities.has(capabilityRef)))
2575
3389
  issues.push({
2576
3390
  kind: AssuranceProgramSpecificationIssueKind.RELATIONSHIP_MISMATCH,
2577
3391
  path: `implementationStatements.${statementIndex}.capabilityBindingRefs`,