@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -37,6 +37,12 @@ A floor can be raised, never lowered: `defineSaasConfig` refuses a binding whose
37
37
  than the engine's on any axis, a scope the purpose does not offer, and a provider your application
38
38
  does not declare with `KEY_MANAGEMENT`.
39
39
 
40
+ A raised floor states all four axes, `protectionEvidence` included: it says whose word the
41
+ protection level may rest on. `provider_claim` accepts the vendor's own statement, which is how a
42
+ cloud KMS or HSM key meets a `hardware` floor today. `verified_hardware_attestation` accepts only a
43
+ level verified from the HSM's own signed statement; no provider verifies one yet, so
44
+ `defineSaasConfig` refuses that floor for every provider.
45
+
40
46
  ## What the application keeps
41
47
 
42
48
  Your backend stores the public half of every key version the platform signs with for it
@@ -188,6 +194,14 @@ in the same transaction as the decision. A lapse, a withdrawal and an answer who
188
194
  their authority are nobody's verdict, and are not sealed. An approval whose work then could not run
189
195
  is still the person's approval, and is sealed as one.
190
196
 
197
+ A seal goes with the record it attests, its subject, and keeps no retention of its own: it is deleted
198
+ when that record is deleted, disposed of at its retention end or purged with its tenant, and a legal
199
+ hold on the record keeps it. Each destruction leaves an `approval_evidence_destroyed` audit row. An
200
+ operation approval attests the record its operation acts on; a conversational tool approval attests the
201
+ row its tool declares (`argumentsResource.rowIdArgument`); a question, or a call that names no row,
202
+ attests the conversation. So declare `argumentsResource` on a gated tool whose approval belongs with a
203
+ record (a close's sign-off), or its seal goes when the conversation goes.
204
+
191
205
  The engine also seals the decisions people take outside those planes, each in the transaction that
192
206
  records it:
193
207
 
@@ -196,17 +210,25 @@ records it:
196
210
  | approving or denying a platform access grant, revoking one | `platform_access_grant` | authorization (revocation: instruction) |
197
211
  | the second administrator's signature on an application-wide grant | `application_access_grant` | authorization (revocation: instruction) |
198
212
  | the granting organization accepting or declining a proposed relationship, or the representing organization accepting one | `organization_relationship` | authorization |
213
+ | the granting organization suspending, resuming or terminating a relationship, or the representing organization withdrawing from one | `organization_relationship` | instruction (resumption: authorization) |
214
+ | the granting organization's owner amending a relationship's role, units or term | `organization_relationship` | authorization |
199
215
  | placing or releasing a legal hold | `legal_hold` | instruction |
216
+ | the granting organization lending a delegated capability to a relationship, or revoking it, directly or by narrowing the relationship to units | `relationship_capability_grant` | authorization (revocation: instruction) |
217
+ | an administrator verifying a person's professional qualification against its proof, or revoking it | `professional_qualification` | approval (revocation: instruction) |
218
+ | the representing organization assigning one of its people to a granting organization, or ending that assignment; the granting organization ending it by removing that person | `representative_assignment` | authorization (ending: instruction) |
200
219
  | a person accepting a governed document (at sign-up, federated sign-up, or later) | `governed_document_acceptance` | approval |
201
220
 
202
221
  Each is declared on the operation variant that settles it (`approvalSeal`), or on the route for a
203
222
  manual route, with the record fields the decision is about. Such a seal's presentation is those fields
204
223
  as the record stood when the person decided, marked RECORDED: the engine sealed the record, it did not
205
224
  watch a screen. Each source's own audit row (the grant's or the relationship's lifecycle row,
206
- `legal_hold_placed` / `legal_hold_released`, the governed-document interaction) carries the seal's
207
- `decisionPayloadDigest`. An expiry, an auto-approval, a person's consent to their own data, an OAuth
208
- consent and an invitation's answer are not sealed, and each declaration says why. Suspending, resuming,
209
- terminating or withdrawing from a live relationship is not sealed yet either, and says so.
225
+ `legal_hold_placed` / `legal_hold_released`, the governed-document interaction, a capability's granted or revoked
226
+ row, a representative's assigned or unassigned row) carries the seal's `decisionPayloadDigest`; a qualification has no
227
+ lifecycle row of its own, and its seal's `approval_seal_pending` row carries it. A qualification's seal never holds
228
+ its registration number or its proof: the holder's erasure removes those from the qualification, and a seal is kept
229
+ whole. An expiry, an auto-approval, a person's consent to their own data, an OAuth
230
+ consent, an invitation's answer, an invitation the organization withdraws before it is delivered, and an
231
+ administrator's handling of a report about an agent are not sealed, and each declaration says why.
210
232
 
211
233
  A person's decision on something proposed goes through a decision plane, which seals it: a gated tool
212
234
  call (`humanApproval`), an actor question, or an operation that `requiresApproval`. When an agent's call
@@ -294,6 +316,26 @@ export const ApprovalSealsAdminEndpointPath = {
294
316
  * application does not hold the export key's record yet.
295
317
  */
296
318
  SIGNING_LOG_EXPORT: '/signing-log/export',
319
+ /**
320
+ * POST — rebuild the manifested copy of ONE SEALED seal's approved PDF (#2907): `{ "sealId": "…", "justification": "…",
321
+ * "operator"?: "…" }`. Only when the seal names no copy, or names one whose file is gone, unlinked or no longer
322
+ * servable; the copy is made exactly as the relay makes it, from the attested original and the seal, and the seal names
323
+ * it. The justification is required and recorded (`approval_seal_manifested_copy_rebuilt`) before the seal names the
324
+ * copy; when it cannot be recorded the copy is discarded and the rebuild refused. 404 for an unknown seal (a seal whose approver was erased is not found here: the copy prints their
325
+ * name, and nothing may print it again); 409 for one not SEALED, with no file deliverable, whose copy is present, or of
326
+ * which no copy can be made (`reason` names why, `detail` says more).
327
+ */
328
+ MANIFESTED_COPY_REBUILD: '/manifested-copy/rebuild',
329
+ /**
330
+ * POST — whether ONE seal's approval is still CURRENT over the record it is about (#2914): `{ "sealId": "…" }` →
331
+ * {@link ApprovalSealCurrencyResult}. The seal's presentation carries the values of the fields its tool declared the
332
+ * approval covers (`sealedRecordFields`); they are compared with the record as it is now. CURRENT right after the
333
+ * approval, NO_LONGER_CURRENT once one of them changed, SUBJECT_GONE when the record is gone, NO_SEALED_FIELD_SET when
334
+ * the seal covers no record field. Names which fields moved, never a value, so it is not recorded on the trail. 404 for
335
+ * an unknown seal (a seal its approver's erasure retained is not read here); 409 for one whose presentation file is
336
+ * unreadable or not the one its row recorded.
337
+ */
338
+ CURRENCY: '/currency',
297
339
  } as const;
298
340
 
299
341
  /**
@@ -312,10 +354,16 @@ export enum SigningLogSealStanding {
312
354
  */
313
355
  RESIGNED = 'resigned',
314
356
  /**
315
- * No stored seal has this decision: a signature the custodian made that the application does not hold. Until approval
316
- * evidence that is deliberately destroyed leaves a record of it (#2924), a seal purged with its record shows here too.
357
+ * No stored seal has this decision, and no record says it was destroyed: a signature the custodian made that the
358
+ * application does not hold.
317
359
  */
318
360
  UNACCOUNTED = 'unaccounted',
361
+ /**
362
+ * The seal is not stored because it was destroyed with the record it attested (#2924): an `APPROVAL_EVIDENCE_DESTROYED`
363
+ * row names this signature's `jti` and decision. Accounted for: evidence follows its record, and the record's removal
364
+ * is what destroyed it. A destroyed seal that had been signed must have been signed with exactly these claims.
365
+ */
366
+ DESTROYED = 'destroyed',
319
367
  }
320
368
 
321
369
  /** One seal signature of an export that the application does not store. Names no person. */
@@ -335,6 +383,8 @@ export interface SigningLogReconciliation {
335
383
  readonly resigned: readonly SigningLogUnaccountedSeal[];
336
384
  /** Signatures of a decision no stored seal has (UNACCOUNTED). */
337
385
  readonly unaccounted: readonly SigningLogUnaccountedSeal[];
386
+ /** Signatures of seals destroyed with their record (DESTROYED, #2924): accounted for, listed so the operator sees them. */
387
+ readonly destroyed: readonly SigningLogUnaccountedSeal[];
338
388
  }
339
389
 
340
390
  /** `POST /signing-log/export`'s answer: what the operator keeps (`jws`, `key`), where its next pull starts, and the reconciliation. */
@@ -370,6 +420,25 @@ export interface ApprovalSealRetryResult {
370
420
  /** True when the relay's immediate attempt signed it; false when the batch will. */
371
421
  readonly sealed: boolean;
372
422
  }
423
+
424
+ /** `POST /currency`'s answer (#2914). Names no person and no value. */
425
+ export interface ApprovalSealCurrencyResult {
426
+ readonly sealId: string;
427
+ readonly standing: ApprovalSealSubjectCurrency;
428
+ /** The record compared, as the seal names it; absent for NO_SEALED_FIELD_SET. */
429
+ readonly subject?: { readonly resourceType: string; readonly resourceId: string };
430
+ /** Each sealed field's currency (CURRENT / CHANGED / ABSENT); absent unless compared. */
431
+ readonly fields?: readonly { readonly key: string; readonly currency: HumanDecision_PresentedFieldCurrency }[];
432
+ }
433
+
434
+ /** `POST /manifested-copy/rebuild`'s answer. */
435
+ export interface ApprovalSealManifestedCopyRebuildResult {
436
+ readonly sealId: string;
437
+ /** The new copy's file. */
438
+ readonly fileId: string;
439
+ /** The copy the seal named before, when it named one. */
440
+ readonly replacedFileId?: string;
441
+ }
373
442
  ```
374
443
 
375
444
  ### What the person was shown is part of the seal
@@ -406,16 +475,80 @@ record of its key, the issuer, and the disclosures the row still holds (the peop
406
475
  statement). Each export is recorded (`approval_seal_exported`); a seal kept after its approver's erasure
407
476
  needs `--operator` and `--justification`. A person's own data export also carries their seals' key
408
477
  records (`verificationKeys`), and leaves out the requester and what was presented, which are other
409
- people's data. Seals are not part of a portability export: the operator made them. To verify a seal, `wildo seal verify <bundle.json>` reads `{ jws, keys, expectedIssuer?, disclosures? }`, where each key is its stored record (`publishedVerificationKeys`: kid, public JWK,
478
+ people's data. Seals are not part of a portability export: the operator made them. To verify a seal, `wildo seal verify <bundle.json>` reads `{ jws, keys, expectedIssuer?, disclosures?, erasedClaims?, deliverableFile?, manifestedCopy? }`, where each key is its stored record (`publishedVerificationKeys`: kid, public JWK,
410
479
  scope, scope id, issuer, state) and calls nothing. It pins ES256 from the key record, ignores any key
411
480
  the token names, refuses an organization key used for another tenant, checks each disclosure against
412
- its commitment, and reports a seal under a compromised key as not provable unless the decision's
481
+ its commitment, and reports content the seal commits to and the bundle does not give without failing
482
+ the seal: a claim the export lists in `erasedClaims` (what the row lost to an erasure: the approver's own,
483
+ or a later erasure of the requester or of a person the presentation named) reads UNDISCLOSED (erased),
484
+ the presentation PRESENTATION_ERASED; anything else absent reads not given (withheld). It reports a seal under a compromised key as not provable unless the decision's
413
485
  digest was recorded elsewhere before the compromise (`--corroboration <file>`, a
414
486
  `{ decisionPayloadDigest, recordedAt }` you hold), or a signing-log export you kept from before it lists
415
487
  the seal. The bundle is the platform's file, so none of that evidence is read from it: give your own,
416
488
  `wildo seal verify <bundle.json> --pins <pins.json> --signing-log-exports <files…>`; it then trusts the seal key only if you pinned it, takes
417
489
  the key's state from your pin, and says which evidence corroborated a compromised key's seal.
418
490
 
491
+ When the person approves a FILE (a generated document, an agent's output file), declare the tool argument
492
+ that names it, `deliverableFileArgument` on the function tool. The card then binds the file by its bytes:
493
+ its hash, computed then when the file has none, enters the presentation as a commitment
494
+ `H(salt ‖ contentSha256)`, so an answer given on a card shown before the file's recorded hash changed is
495
+ refused as stale, and an approver may not swap the file in an edit. The seal attests the file
496
+ (`deliverableFileId`, frozen while the seal exists) and keeps the salt; the bundle names both, and
497
+ `wildo seal verify <bundle.json> --deliverable <file>` checks the file's bytes against the commitment: one
498
+ changed byte and the seal does not verify. A file the engine cannot hash (a remote reference whose vendor
499
+ keeps the bytes, a missing file, a file of another organization) is shown and sealed as not bound, never
500
+ bound to an empty hash.
501
+
502
+ When the person approves what a RECORD says (a month's figures signed off, an invoice's amounts), declare
503
+ the fields the approval covers, `sealedRecordFields` on the function tool, beside
504
+ `argumentsResource: { resourceType, rowIdArgument }`. The card then shows those fields of the row the call
505
+ names, read when the card is built, and the seal commits to them inside its presentation, so you can ask
506
+ later whether the approval still holds: `wildo seal currency <sealId>` (the operator door
507
+ `POST /internal/admin/approval-seals/currency`) answers CURRENT, NO_LONGER_CURRENT with the fields that
508
+ moved (never their values), SUBJECT_GONE, or NO_SEALED_FIELD_SET; offline,
509
+ `wildo seal verify <bundle.json> --subject-record <record.json>` compares the same values with the record
510
+ you give, and reports a change without failing the seal. Name only what the approval is about, never a
511
+ status, a timestamp or the column the approved call writes the seal's id into: those change when the
512
+ approval is recorded, and would make every approval stale at once. A card read before one of the values
513
+ changed is refused as stale. In your own code, `assessApprovalSealCurrency` (from
514
+ `@wildo-ai/saas-backend-lib`) and `approvalSealSubjectCurrencyOf` (from `@wildo-ai/saas-models`) give the
515
+ same answer. A record of another organization than the decision's is shown and sealed with no values, and
516
+ so is an answer clicked on a chat card: no chat card shows the record, so its seal claims none of it.
517
+
518
+ When the same decision is taken again on a record after the record was reopened (signed off, reopened,
519
+ signed off again), it is a NEW decision, and its seal names no predecessor unless you declare
520
+ `approvalReplacesEarlierApprovalOfRow: true` on the tool: its seal then supersedes the latest seal of that
521
+ tool on that record (`supersedesSealId`, and `supersedes` in the signed claims), as a decision answered
522
+ again supersedes its own earlier answer, and the trail records the earlier one `approval_seal_superseded`.
523
+ An approval made through another tool on the same row is never superseded.
524
+
525
+ When the approved file is a PDF, the engine also makes its **manifested copy** as it seals: a separate
526
+ file holding the original byte for byte, followed by a last page naming the approver, the date and time
527
+ of the decision, the meaning and outcome and the seal's identity, with the seal's JWS attached
528
+ (`approval-seal.jws`). The original is never modified. The seal row owns the copy (`manifestedCopy`) and
529
+ the copy's lineage names the original; your application reads it like any file field. A copy is not made
530
+ of a PDF that is encrypted or has a structure the engine cannot append to, of a file that is not servable,
531
+ or when the approver was erased before the seal was signed: the seal stands without one. The approver's
532
+ erasure deletes the copy, since it prints their name; the bundle then states the copy erased and the
533
+ verifier reports `CONTENT_ERASED`. `wildo seal verify <bundle.json> --manifested-copy <file>` rebuilds the
534
+ copy from what precedes its approval page and the seal, and checks that part against the approved file's
535
+ commitment: a changed approval page, attachment or original and the seal does not verify.
536
+
537
+ The page's words are your application's labels, in its primary language, under
538
+ `backend_documents.approval_manifestation.*` (the meaning and outcome under
539
+ `system_enums.ApprovalSealMeaning` and `system_enums.HumanDecision_Outcome`); the labelling pipeline plans
540
+ them, and a word missing there means no copy is made rather than a key printed on the page. The font is
541
+ embedded (Liberation Sans, which covers Latin, Greek and Cyrillic): a name it cannot print refuses the
542
+ copy, never prints `?`. The JWS and the inputs the page was printed from (`manifestation.json`) are
543
+ document-level attachments (ISO 32000-2 §14.13, `AFRelationship /Supplement`), so the copy verifies from
544
+ the seal alone. When your API declares a public URL, the page carries a QR code linking to
545
+ `GET /api/v1/approval-seals/verify?jws=<seal>`, a public check of the seal against your published keys:
546
+ it takes no seal id and reads no record, the address carries only the seal (whose people are salted
547
+ fingerprints), and a browser gets a page worded from `backend_documents.approval_verification.*`. It
548
+ checks the seal, not the document. A copy that was not made, or is gone, is rebuilt by an operator with
549
+ `wildo seal rebuild-copy <sealId> --justification "…"`, recorded on the audit trail as
550
+ `approval_seal_manifested_copy_rebuilt`; a seal whose copy is present is refused.
551
+
419
552
  ## Pinning your keys
420
553
 
421
554
  The host holds the keys and publishes their public halves, so on its own your application can only
@@ -476,7 +609,11 @@ a signature your application stores counts as accounted for. The others are prin
476
609
  decision looks like this; so does a signature your backend is still writing, which pulling the same
477
610
  range again shows as stored.
478
611
 
479
- A seal whose evidence was deliberately destroyed with its record also shows as unaccounted for now.
612
+ A seal destroyed with the record it attested is **destroyed**, and accounted for: approval evidence
613
+ has no retention of its own and goes when its record goes (a delete, a retention-end disposal, a parent
614
+ removal, an erasure), unless a legal hold keeps it, and each destruction leaves an
615
+ `APPROVAL_EVIDENCE_DESTROYED` audit row naming the seal's `jti` and decision. The pull lists such seals
616
+ without failing. A signature of a destroyed decision under other claims is still unaccounted.
480
617
  An export is dated by the instant it states for itself, so `wildo seal verify` corroborates from your
481
618
  exports only when they agree with each other; give it every export you kept.
482
619
 
@@ -501,6 +638,33 @@ retires. The platform operator rotates, in one of three ways:
501
638
  Every seal already made keeps verifying after each of them: a rotated, destroyed or compromised
502
639
  key's public half stays in your application.
503
640
 
641
+ When the platform runs its own Vault (`platformKeyManagement: { vault: { source: 'self' } }`), a
642
+ leaked credential of that Vault is replaced without touching the keys it holds:
643
+
644
+ | what leaked | command |
645
+ |---|---|
646
+ | the token the platform signs or manages keys with | `wildo keys vault-rotate-tokens --reason "<why>"` (`--token recovery` for the break-glass token itself), then `wildo config sync` and restart the platform's apps-manager |
647
+ | the Vault's unseal key | `wildo keys vault-rotate-unseal-key --begin`, restart the Vault, then `--complete`, and restart it again |
648
+
649
+ A Vault first started before these commands existed holds no break-glass token, and they say so: stop
650
+ it, start a fresh one, and move each Vault-held key onto it with `wildo keys rotate --emergency`.
651
+
652
+ Your application's own signing keys (access, refresh and ID tokens, webhook signatures, and the requests it
653
+ sends the platform and its workers) are held in its secrets, not in the keyring, so `wildo keys rotate`
654
+ refuses them. Rotate them with `wildo keys rotate-signing-keys` (`--status` shows them, with any staged
655
+ key and when it may be promoted):
656
+
657
+ | rotation | commands | what verifiers see |
658
+ |---|---|---|
659
+ | planned | `--stage --reason "<why>"`, then, at least 70 minutes later, `--promote --reason "<why>"` | the next keys are published (your `/oauth/jwks`, a webhook configuration's `applicationVerificationJwks`) before anything is signed with them; `--promote` is refused until they have been published long enough for any cached key set to have been fetched again |
660
+ | immediate, for a key that may have leaked | `--reason "<why>"` | the new keys at once; a verifier fetches them the first time a token names one |
661
+
662
+ Each replaced key keeps verifying what it signed until the longest token it can have signed expires, so
663
+ nobody is signed out. A running backend signs with the new keys within five minutes, without a restart.
664
+ Every step names the keys it acts on, so a request whose answer was lost is re-sent and answered "already
665
+ staged", "already promoted" or "already rotated" instead of acting twice. After a failure, check
666
+ `--status` before running it again.
667
+
504
668
  Your stored secrets (SSO client secrets, TOTP seeds, provider credentials, SIEM export credentials)
505
669
  are sealed under data keys that the `sealed_secrets` key wraps. After any rotation of that key, your
506
670
  backend re-wraps its data keys within five minutes. After an emergency rotation it also marks every
@@ -510,6 +674,15 @@ this. A secret queued for delivery keeps its old seal until it is sent. The re-s
510
674
  against copies of your tables taken after it, so if the leak may have reached your data, also rotate
511
675
  those credentials with their vendors.
512
676
 
677
+ Secrets sealed before the data keys existed are older envelopes that your backend moves to the data keys
678
+ at boot, and that one older key, the session encryption key, still opens. At every boot the backend logs
679
+ how many are left: `V1 envelope census (#3028)`, with `totalV1Envelopes` and `complete`. Once that reads
680
+ zero and complete, stop delivering the old key with `wildo keys legacy-envelope-key --retire --observed-v1 0
681
+ --reason "<why>"` and restart the backend and minions. The platform refuses anything but a complete zero
682
+ and keeps the key stored. If a later boot logs at ERROR that the key is retired but older envelopes are
683
+ still held (a restored backup, say), deliver it again with `wildo keys legacy-envelope-key --restore
684
+ --reason "<why>"`. `--status` shows where it stands.
685
+
513
686
  ## The configuration section
514
687
 
515
688
  ## Import Origins
@@ -687,6 +860,13 @@ export enum CryptoKey_Purpose {
687
860
  TOOL_APPROVAL_SIGNING = 'tool_approval_signing',
688
861
  /** MACs a proof-of-work challenge the application issues to a public form, so it cannot be minted by the client (#2893). */
689
862
  SUBMISSION_CHALLENGE = 'submission_challenge',
863
+ /**
864
+ * Keys the digest a consumable-token row keeps of a one-time code (an email, SMS or phone-verification code), so the
865
+ * code itself is never stored (#3506). A six-digit code has 900,000 values, so an unkeyed hash of it is reversed by
866
+ * enumeration; under this key, someone who reads the row but not the key learns nothing. Held by the backend only,
867
+ * which mints and checks every code.
868
+ */
869
+ ONE_TIME_CODE_DIGEST = 'one_time_code_digest',
690
870
  /**
691
871
  * Keys the id of what a person was shown before deciding (#2893), so an answer names the exact presentation it was given
692
872
  * and a stale card is refused. Held by the backend and the minions, which both present decisions.
@@ -806,6 +986,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
806
986
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
807
987
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
808
988
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
989
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
809
990
  },
810
991
  },
811
992
  [CryptoKey_Purpose.PLATFORM_RESPONSE_INTEGRITY]: {
@@ -826,6 +1007,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
826
1007
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
827
1008
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
828
1009
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1010
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
829
1011
  },
830
1012
  },
831
1013
  [CryptoKey_Purpose.APPLICATION_AUTH_TOKEN]: {
@@ -847,6 +1029,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
847
1029
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
848
1030
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
849
1031
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1032
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
850
1033
  },
851
1034
  },
852
1035
  [CryptoKey_Purpose.APPLICATION_WEBHOOK]: {
@@ -868,6 +1051,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
868
1051
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
869
1052
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
870
1053
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1054
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
871
1055
  },
872
1056
  },
873
1057
  [CryptoKey_Purpose.APPLICATION_PLATFORM_REQUEST]: {
@@ -889,6 +1073,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
889
1073
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
890
1074
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
891
1075
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1076
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
892
1077
  },
893
1078
  },
894
1079
  [CryptoKey_Purpose.APPLICATION_WORKER_REQUEST]: {
@@ -910,6 +1095,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
910
1095
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
911
1096
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
912
1097
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1098
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
913
1099
  },
914
1100
  },
915
1101
  [CryptoKey_Purpose.TOOL_APPROVAL_SIGNING]: {
@@ -931,6 +1117,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
931
1117
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
932
1118
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
933
1119
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1120
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
934
1121
  },
935
1122
  },
936
1123
  [CryptoKey_Purpose.SUBMISSION_CHALLENGE]: {
@@ -952,6 +1139,30 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
952
1139
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
953
1140
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
954
1141
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1142
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1143
+ },
1144
+ },
1145
+ [CryptoKey_Purpose.ONE_TIME_CODE_DIGEST]: {
1146
+ primitive: CryptoKey_Primitive.HMAC_SHA256,
1147
+ jwsTypes: [],
1148
+ holding: CryptoKey_Holding.APPLICATION_SECRETS,
1149
+ scopes: [CryptoKey_Scope.APPLICATION],
1150
+ publication: CryptoKey_Publication.PRIVATE,
1151
+ // A digest is matched only while its code lives (ten minutes at most), so a retired version is needed for no longer.
1152
+ rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
1153
+ // A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
1154
+ cryptoperiodDays: 365,
1155
+ custodies: [CryptoKey_Custody.PLATFORM],
1156
+ // Only the backend mints and checks a one-time code.
1157
+ heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
1158
+ mayRequestSignature: [],
1159
+ mayRequestDataKeys: [],
1160
+ // The runtime that holds it computes with the retrieved key, so the floor allows retrieval.
1161
+ engineFloor: {
1162
+ protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1163
+ materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
1164
+ provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1165
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
955
1166
  },
956
1167
  },
957
1168
  [CryptoKey_Purpose.DECISION_PRESENTATION_ID]: {
@@ -973,6 +1184,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
973
1184
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
974
1185
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
975
1186
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1187
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
976
1188
  },
977
1189
  },
978
1190
  [CryptoKey_Purpose.AGENT_WORK_CORRECTION_DIGEST]: {
@@ -994,6 +1206,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
994
1206
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
995
1207
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
996
1208
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1209
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
997
1210
  },
998
1211
  },
999
1212
  [CryptoKey_Purpose.EVALUATION_PSEUDONYM]: {
@@ -1015,6 +1228,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1015
1228
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1016
1229
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
1017
1230
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1231
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1018
1232
  },
1019
1233
  },
1020
1234
  [CryptoKey_Purpose.SIEM_DELIVERY_INTEGRITY]: {
@@ -1036,6 +1250,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1036
1250
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1037
1251
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
1038
1252
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1253
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1039
1254
  },
1040
1255
  },
1041
1256
  [CryptoKey_Purpose.SIEM_DESTINATION_FINGERPRINT]: {
@@ -1057,6 +1272,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1057
1272
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1058
1273
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
1059
1274
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1275
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1060
1276
  },
1061
1277
  },
1062
1278
  [CryptoKey_Purpose.EXTERNAL_DATA_ERASURE_SUPPRESSION]: {
@@ -1078,6 +1294,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1078
1294
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1079
1295
  materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
1080
1296
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1297
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1081
1298
  },
1082
1299
  },
1083
1300
  [CryptoKey_Purpose.SEALED_SECRETS]: {
@@ -1103,6 +1320,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1103
1320
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1104
1321
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
1105
1322
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1323
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1106
1324
  },
1107
1325
  },
1108
1326
  [CryptoKey_Purpose.SIGNING_LOG_EXPORT]: {
@@ -1125,6 +1343,7 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1125
1343
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1126
1344
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
1127
1345
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1346
+ protectionEvidence: CryptoKey_ProtectionEvidence.PROVIDER_CLAIM,
1128
1347
  },
1129
1348
  },
1130
1349
  };
@@ -1145,11 +1364,21 @@ export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose,
1145
1364
  * The least protection a purpose's key accepts. The engine sets one per purpose; an application may RAISE it in its
1146
1365
  * `keyManagement` configuration, never lower it. Each axis is ordered: a floor is met when every axis is at least the
1147
1366
  * floor's.
1367
+ *
1368
+ * `protectionEvidence` is stated, never defaulted, so a floor that asks for HARDWARE says whose word it accepts for it:
1369
+ * - `provider_claim` accepts the vendor's own statement (an AWS or Azure HSM key, a Google HSM version, an allow-listed
1370
+ * PKCS#11 token). That is how cloud HSM protection is relied on in practice: the vendor states it and backs it with its
1371
+ * published FIPS 140 validation; AWS and Azure give nothing stronger for a standard key.
1372
+ * - `verified_hardware_attestation` accepts only a level the custodian verified from the HSM's own signed statement. No
1373
+ * provider produces one yet (#3016), so such a floor is refused at configuration time for every provider but LOCAL.
1374
+ * The engine's floors are SOFTWARE and say `provider_claim`: a provider that understates its protection cannot hurt them.
1148
1375
  */
1149
1376
  export interface CryptoKeyFloor {
1150
1377
  readonly protectionLevel: CryptoKey_ProtectionLevel;
1151
1378
  readonly materialAccess: CryptoKey_MaterialAccess;
1152
1379
  readonly provenance: CryptoKey_MaterialProvenance;
1380
+ /** Whose word the protection level rests on (#3016). */
1381
+ readonly protectionEvidence: CryptoKey_ProtectionEvidence;
1153
1382
  }
1154
1383
  ```
1155
1384
 
@@ -1178,5 +1407,7 @@ export const LOCAL_KEY_PROVIDER_PROTECTION: CryptoKeyFloor = {
1178
1407
  protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
1179
1408
  materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
1180
1409
  provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
1410
+ // The custodian makes and seals the key itself: its software level is known first-hand, not claimed.
1411
+ protectionEvidence: CryptoKey_ProtectionEvidence.CUSTODIAN_CONSTRUCTION,
1181
1412
  };
1182
1413
  ```
@@ -77,6 +77,16 @@ export enum EngineCapability {
77
77
  */
78
78
  EMAIL_INBOUND = 'EMAIL_INBOUND',
79
79
  SMS = 'SMS',
80
+ /**
81
+ * A deliverable signed by its signers' own electronic signatures, applied by a trust-service vendor (#2293): level 2 of
82
+ * epic #2916, opt-in per deliverable. Level 1 (the operator's seal over a decision, `KEY_MANAGEMENT`) needs no vendor.
83
+ *
84
+ * Its own slot: which vendor applies a client's signature is a legal and procurement decision (its levels, its
85
+ * environments, where it keeps the signed documents) that no other provider choice should make. Enabling it declares
86
+ * that deliverables are sent for signature, so an enabled slot with no provider refuses to start
87
+ * (`ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED`).
88
+ */
89
+ ELECTRONIC_SIGNATURE = 'ELECTRONIC_SIGNATURE',
80
90
 
81
91
  AI_LLM = 'AI_LLM',
82
92
  AI_IMAGE_GENERATION = 'AI_IMAGE_GENERATION',
@@ -194,8 +204,7 @@ export enum EngineCapability {
194
204
  * `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
195
205
  * applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
196
206
  * through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
197
- * was a plan-era intention (`provider-registry-materialization-workflow.md`) that the shipped
198
- * model settled the other way. So the withdrawal removes a name, not a capability.
207
+ * was an early plan that the shipped model settled the other way. So the withdrawal removes a name, not a capability.
199
208
  *
200
209
  * The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
201
210
  * member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
@@ -278,6 +287,11 @@ export const BUILTIN_PROVIDER_CAPABILITY = {
278
287
  */
279
288
  EMAIL_INBOUND: 'EMAIL_INBOUND',
280
289
  SMS: 'SMS',
290
+ /**
291
+ * Provider has a trust-service vendor apply its signers' own electronic signatures to a deliverable (#2293), at the
292
+ * levels its contract declares. Maps to `EngineCapability.ELECTRONIC_SIGNATURE`.
293
+ */
294
+ ELECTRONIC_SIGNATURE: 'ELECTRONIC_SIGNATURE',
281
295
  /**
282
296
  * Single billing-engagement capability covering everything from
283
297
  * Checkout-style hosted flows to first-party PaymentIntent flows.