@wildo-ai/framework-knowledge 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (841) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +349 -17
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  6. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.loader.js +47 -1
  8. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
  13. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  14. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
  15. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  25. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  26. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
  27. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  28. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  29. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  30. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
  31. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  32. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
  33. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  34. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
  35. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  36. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  37. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  41. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  44. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
  45. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
  47. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  50. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
  51. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  52. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  53. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  54. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
  55. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  56. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  57. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
  60. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
  64. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  68. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  70. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  72. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  74. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
  76. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
  78. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  80. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  82. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
  84. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
  86. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  87. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
  88. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
  90. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  92. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
  94. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
  96. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
  100. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  103. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
  104. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  105. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
  112. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  113. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
  114. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
  116. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  117. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
  118. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  120. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  121. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  122. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  123. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  124. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  125. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
  126. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  127. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  128. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
  130. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  132. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
  134. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  136. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  137. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
  138. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  139. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
  140. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  141. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
  142. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
  144. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
  146. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  148. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  149. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  150. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  151. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
  152. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
  154. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
  156. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  157. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
  158. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  159. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
  160. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  161. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
  162. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  163. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  164. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  165. package/dist/knowledge/manifest.json +9 -8
  166. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  167. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
  168. package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
  169. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
  170. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  171. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  172. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
  173. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
  174. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  175. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
  177. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
  178. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
  179. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
  180. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
  181. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
  182. package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
  183. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
  184. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
  185. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
  186. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
  187. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
  188. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
  189. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
  190. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
  191. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
  192. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
  193. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  194. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  195. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
  196. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  197. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
  198. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
  200. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  203. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
  204. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  205. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  206. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  208. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  209. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  210. package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
  211. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
  212. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
  215. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  216. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
  219. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
  220. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
  221. package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
  222. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
  223. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  224. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
  225. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  226. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  227. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
  228. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
  229. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  230. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
  231. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  233. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
  234. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
  235. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  236. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
  237. package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
  238. package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
  239. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  240. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
  241. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  242. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
  243. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  244. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
  245. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  246. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
  247. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  248. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  249. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
  250. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
  251. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  252. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  253. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  254. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
  255. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
  256. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
  257. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  259. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  260. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
  261. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
  262. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
  263. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  264. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  265. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
  266. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
  267. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  268. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
  269. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  270. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  271. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  272. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  273. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  274. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  275. package/dist/knowledge/references/application-maturity.config.md +319 -0
  276. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  277. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  278. package/dist/knowledge/references/brand.asset.config.md +8 -16
  279. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  280. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  281. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  282. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  283. package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
  284. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  285. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  286. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  287. package/dist/knowledge/references/capability-composition.config.md +155 -0
  288. package/dist/knowledge/references/cli.market.utils.md +1 -0
  289. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  290. package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
  291. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  292. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  293. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  294. package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
  295. package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
  296. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
  297. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  298. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  299. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  300. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  301. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
  302. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
  303. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  304. package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
  305. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  306. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  307. package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
  308. package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
  309. package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
  310. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
  311. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
  312. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  313. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
  315. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
  316. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
  317. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  318. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  319. package/dist/knowledge/references/experience-plan.config.md +311 -0
  320. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
  321. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  322. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
  323. package/dist/knowledge/references/integration-plan.config.md +185 -0
  324. package/dist/knowledge/references/market.alternative.config.md +1 -1
  325. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  326. package/dist/knowledge/references/market.channel.config.md +3 -3
  327. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  328. package/dist/knowledge/references/market.gain.config.md +1 -1
  329. package/dist/knowledge/references/market.icp.config.md +2 -2
  330. package/dist/knowledge/references/market.job.config.md +1 -1
  331. package/dist/knowledge/references/market.message-template.config.md +2 -2
  332. package/dist/knowledge/references/market.objection.config.md +1 -1
  333. package/dist/knowledge/references/market.pain.config.md +1 -1
  334. package/dist/knowledge/references/market.persona.config.md +2 -2
  335. package/dist/knowledge/references/market.proof.config.md +1 -1
  336. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  337. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  338. package/dist/knowledge/references/market.trigger.config.md +1 -1
  339. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  340. package/dist/knowledge/references/placement-plan.config.md +369 -0
  341. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  342. package/dist/knowledge/references/platform.config.backing-services.md +0 -21
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  346. package/dist/knowledge/references/platform.config.saas.md +261 -9
  347. package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
  348. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  349. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  350. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  351. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  352. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  353. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  354. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  355. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  356. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
  357. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  358. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  359. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
  360. package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
  361. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
  363. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  364. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
  365. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  366. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  367. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
  368. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  369. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  370. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  371. package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
  372. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  373. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  374. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  375. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  376. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  377. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  378. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  379. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
  380. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  381. package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
  382. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  383. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  385. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  386. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  388. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  390. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  391. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  392. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
  393. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  394. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
  395. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
  399. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
  400. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  401. package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
  402. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  403. package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
  404. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  405. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
  406. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
  407. package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
  408. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  409. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
  410. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  411. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  412. package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
  413. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
  414. package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
  415. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  416. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  417. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  418. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  419. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  420. package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
  421. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  422. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  423. package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
  424. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
  425. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
  426. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
  427. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
  428. package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
  429. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
  430. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  431. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
  433. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  434. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  435. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  436. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  437. package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
  439. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  440. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  441. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
  442. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  443. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  444. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  445. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
  446. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  447. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  449. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  450. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  451. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  452. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  453. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  454. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  455. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  457. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  458. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  459. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
  462. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  463. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  465. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  466. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  467. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  468. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  469. package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
  470. package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
  471. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  472. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  473. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  474. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  475. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  476. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  477. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  478. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
  479. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
  480. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
  481. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  482. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
  483. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  484. package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
  486. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
  487. package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
  488. package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
  489. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  490. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
  491. package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
  492. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  493. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  494. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  495. package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
  496. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  497. package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
  498. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  499. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  500. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  501. package/dist/knowledge/references/website-plan.config.md +205 -0
  502. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  503. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  504. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  505. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
  506. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
  507. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
  508. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  509. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  510. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  511. package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
  512. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
  513. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
  514. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  515. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  516. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  517. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  518. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
  519. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
  520. package/dist/knowledge/references/zod.factories.address.md +118 -0
  521. package/dist/knowledge/references/zod.factories.code.md +2 -0
  522. package/dist/knowledge/references/zod.factories.duration.md +2 -0
  523. package/dist/knowledge/references/zod.factories.money.md +2 -0
  524. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  525. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  526. package/dist/knowledge/registries/framework-topics.json +1215 -11
  527. package/dist/knowledge/registries/playbooks.json +454 -50
  528. package/dist/knowledge/registries/source-tags.json +3153 -1043
  529. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  530. package/dist/knowledge/rules/live-context-door.md +108 -0
  531. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  532. package/dist/knowledge/skills/INDEX.md +46 -11
  533. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
  534. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  535. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  536. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
  537. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  538. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  539. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
  543. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  544. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
  545. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
  549. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
  550. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  551. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  552. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
  553. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  554. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
  555. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  556. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
  561. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
  562. package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
  563. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
  564. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  565. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  566. package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
  567. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  568. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  569. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  570. package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
  571. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  572. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
  573. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
  574. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
  575. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
  576. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
  577. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  578. package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
  579. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
  580. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
  581. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  582. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
  583. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
  584. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  585. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
  586. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
  587. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  588. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  589. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  590. package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
  591. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  592. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  593. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  594. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  595. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
  596. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  597. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
  598. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  599. package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
  600. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
  601. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
  602. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
  603. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  604. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
  605. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  606. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
  607. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
  608. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
  609. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
  610. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  611. package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
  612. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  613. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
  614. package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
  615. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
  616. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  617. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  618. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  619. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  620. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
  621. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  622. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  623. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
  624. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
  625. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
  626. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
  627. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
  628. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
  629. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  630. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  631. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
  632. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  633. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
  634. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
  635. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  636. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  637. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  638. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  639. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
  640. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
  641. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
  642. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
  643. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
  644. package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
  645. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  646. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
  647. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  648. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  649. package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
  650. package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
  651. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
  652. package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
  653. package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
  654. package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
  655. package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
  656. package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
  657. package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
  658. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
  659. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  660. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  661. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
  662. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
  663. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  664. package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
  665. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  666. package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
  667. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
  668. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
  669. package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
  670. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
  671. package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
  672. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
  673. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
  674. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
  675. package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
  676. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
  677. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
  678. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  679. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
  680. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
  681. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
  682. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  683. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  684. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  685. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  686. package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
  687. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  688. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  689. package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
  690. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
  691. package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
  692. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
  693. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
  694. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  695. package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
  696. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  697. package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
  698. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  699. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  700. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  701. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
  702. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  703. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
  704. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
  705. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  706. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
  707. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
  708. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
  709. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
  710. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
  711. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  712. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  713. package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
  714. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
  715. package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
  716. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
  717. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  718. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  719. package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
  720. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
  721. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
  722. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
  723. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
  724. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
  725. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  726. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  727. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  728. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
  729. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  730. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
  731. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  732. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
  733. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  734. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
  735. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
  736. package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
  737. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
  738. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  739. package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
  740. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
  741. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
  742. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
  743. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
  744. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  745. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  746. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  747. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
  748. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
  749. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  750. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  751. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
  752. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  753. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  754. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
  755. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
  756. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  757. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  758. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
  759. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
  760. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  761. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
  762. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  763. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  764. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  765. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  766. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
  767. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
  768. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
  769. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
  770. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
  771. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  772. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
  773. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
  774. package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
  775. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  776. package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
  777. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  778. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  779. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  780. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
  781. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
  782. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  783. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
  784. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
  785. package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
  786. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  787. package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
  788. package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
  789. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  790. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
  791. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
  792. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
  793. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  794. package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
  795. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  796. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
  797. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
  798. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  799. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
  800. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  801. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  802. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
  803. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
  804. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
  805. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
  806. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
  807. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
  808. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
  809. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
  810. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
  811. package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
  812. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  813. package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
  814. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
  815. package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
  816. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
  817. package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
  818. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
  819. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
  820. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
  821. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
  822. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
  823. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
  824. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
  825. package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
  826. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
  827. package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
  828. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
  829. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
  830. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
  831. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
  832. package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
  833. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  834. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  835. package/dist/knowledge/topic-index.json +5335 -1010
  836. package/dist/tsconfig.build.tsbuildinfo +1 -1
  837. package/dist/tsconfig.tsbuildinfo +1 -1
  838. package/package.json +4 -4
  839. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  840. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  841. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -0,0 +1,348 @@
1
+ # Authoring the processor register
2
+
3
+ The shape of an entry naming somebody else who processes personal data — their legal identity, where
4
+ they process, and their own subprocessors.
5
+
6
+ Read this when:
7
+
8
+ - a privacy notice or a transfer statement needs a recipient's identity and you have to add it;
9
+ - a report names a configured provider as undeclared;
10
+ - you are deciding between the two entry kinds, or whether an entry needs a `purpose`;
11
+ - you are tempted to fill an entry in from what a vendor probably is.
12
+
13
+ Do not do the last one. The register has no field for an unverified identity, on purpose: an entry
14
+ that is PRESENT means somebody established it, and an entry that is ABSENT means nobody has looked.
15
+ Inventing a plausible legal entity destroys the only signal the absence carries — and a stale entity
16
+ in a published notice is worse than an absent one.
17
+
18
+ ## Import Origins
19
+
20
+ - `@wildo-ai/saas-specifications`
21
+
22
+ ## Source Excerpts
23
+
24
+ ### Origin Package: `@wildo-ai/saas-specifications`
25
+
26
+ ```typescript
27
+ /**
28
+ * **Who else processes personal data, under what legal identity, and where.**
29
+ *
30
+ * ## The gap this closes
31
+ *
32
+ * A configured provider establishes THAT a third party is involved and WHAT FUNCTION it performs —
33
+ * `EngineCapability` gives email delivery, storage, payments, LLM inference, observability. It gives
34
+ * none of the three things a reader of a privacy notice needs: the processor's legal identity, the
35
+ * region it processes in, and its own subprocessors (issue #88).
36
+ *
37
+ * That gap blocks two concerns rather than one, and the second cannot be answered independently: an
38
+ * international-transfer statement is a statement about WHERE a recipient processes, so a provider
39
+ * carrying no region cannot support one.
40
+ *
41
+ * ## Declared by the APPLICATION, not derived from the provider
42
+ *
43
+ * A provider's legal entity is a fact about a vendor, and it is tempting to put it on the provider
44
+ * definition so every application inherits it. It is not carried there, deliberately: what a document
45
+ * must state is the arrangement THIS operator has — which vendor, in which region, under which
46
+ * contract — and two applications using the same vendor can honestly differ on all three. A
47
+ * framework-supplied identity would also be a fact the framework cannot keep true: vendors reorganise,
48
+ * and a stale legal entity in a published notice is worse than an absent one.
49
+ *
50
+ * So the register is authored beside the application's other specifications and read from there. What
51
+ * the framework contributes is the QUESTION and the gap report, never the answer.
52
+ *
53
+ * ## Absence is a gap with a NAME, because the configured set is already known
54
+ *
55
+ * The application's composition already lists its configured providers. Comparing that list against
56
+ * this register turns "processor identities are not established" into "`anthropic` is configured and
57
+ * undeclared" — a gap an operator can act on, per provider, rather than a sentence they cannot.
58
+ *
59
+ * See {@link undeclaredProcessorRefs}. An entry ABSENT from the register means nobody has established
60
+ * that processor's identity; it never means the provider is not in use.
61
+ */
62
+
63
+ /**
64
+ * One subprocessor a declared processor uses in turn.
65
+ *
66
+ * Carried because a privacy notice's recipient statement is only as true as its deepest hop: a
67
+ * customer's data reaching a vendor's own hosting provider is a disclosure, and a notice naming only
68
+ * the first hop understates who holds the data.
69
+ */
70
+ export const ProcessorSubprocessorSchema = z.strictObject({
71
+ /** The subprocessor's name as the processor discloses it. */
72
+ name: z.string().trim().min(1),
73
+ /**
74
+ * Where this subprocessor processes, as the processor discloses it.
75
+ *
76
+ * Required: a subprocessor with no location cannot support the transfer statement that is the whole
77
+ * reason for following the chain this far.
78
+ */
79
+ processingRegions: z.array(z.string().trim().min(1)).min(1),
80
+ });
81
+ export type ProcessorSubprocessor = z.infer<typeof ProcessorSubprocessorSchema>;
82
+
83
+ /**
84
+ * WHICH KIND of subprocessor an entry describes.
85
+ *
86
+ * **Providers are a SUBSET of subprocessors, and this register was built as if they were the whole
87
+ * set.** Every entry keyed on `providerRef` and the schema enforced one entry per provider, which
88
+ * made it structurally unable to hold a subprocessor the application does not configure as a
89
+ * provider — a hosting company, a CDN, a support tool, an accountant. Those are processors under
90
+ * Art. 28 and belong in the same register a notice reads (issue #130).
91
+ *
92
+ * The discriminator exists because the two arms differ in what can be CHECKED, not merely in shape.
93
+ * A configured-provider entry joins to the application's composition, so a claim about a provider it
94
+ * does not configure is detectable and a configured provider with no entry is a reportable gap. An
95
+ * authored entry joins to nothing: no configuration mentions the operator's hosting company, so the
96
+ * framework can neither confirm it nor notice its absence. Collapsing them would present an
97
+ * unverifiable claim with the same authority as a checkable one.
98
+ */
99
+ export enum ProcessorRegisterEntryKind {
100
+ /** A provider the application configures. Joins to `providerRef`, and its absence is reportable. */
101
+ CONFIGURED_PROVIDER = "CONFIGURED_PROVIDER",
102
+ /** A subprocessor nothing in the configuration mentions. Unverifiable by construction, and stated as authored. */
103
+ AUTHORED = "AUTHORED",
104
+ }
105
+
106
+ /**
107
+ * The instrument that makes a transfer of personal data out of its origin jurisdiction lawful.
108
+ *
109
+ * spec-cite: GDPR Chapter V — Art. 45 (adequacy), Art. 46(2)(b)–(f) (appropriate safeguards), Art. 47 (binding
110
+ * corporate rules), Art. 49(1) (derogations). The UK GDPR keeps the same structure, so one vocabulary serves
111
+ * both; the INSTRUMENT that fills a member differs by jurisdiction (the EU clauses, the UK Addendum), which is
112
+ * why each safeguard names its instrument in prose beside the member.
113
+ *
114
+ * Recorded, never computed (#126): which mechanism applies is a legal determination with a shelf life —
115
+ * an adequacy decision can be struck down while the vendor stays where it is — so the framework offers the
116
+ * place to write it down and derives nothing from a region.
117
+ */
118
+ export enum InternationalTransferMechanism {
119
+ /** Art. 45 — the destination is covered by an adequacy decision (for the United States, the Data Privacy Framework, for a certified recipient). */
120
+ ADEQUACY_DECISION = "ADEQUACY_DECISION",
121
+ /** Art. 46(2)(c)/(d) — standard data protection clauses, or a jurisdiction's equivalent (the UK Addendum to them). */
122
+ STANDARD_CONTRACTUAL_CLAUSES = "STANDARD_CONTRACTUAL_CLAUSES",
123
+ /** Art. 46(2)(b) and Art. 47 — binding corporate rules approved for the recipient's group. */
124
+ BINDING_CORPORATE_RULES = "BINDING_CORPORATE_RULES",
125
+ /** Art. 46(2)(e) — an approved code of conduct with binding commitments of the recipient. */
126
+ APPROVED_CODE_OF_CONDUCT = "APPROVED_CODE_OF_CONDUCT",
127
+ /** Art. 46(2)(f) — an approved certification with binding commitments of the recipient. */
128
+ APPROVED_CERTIFICATION = "APPROVED_CERTIFICATION",
129
+ /** Art. 49 — a derogation for a specific situation. Requires {@link InternationalTransferDerogation}. */
130
+ DEROGATION = "DEROGATION",
131
+ }
132
+
133
+ /** Which Art. 49 derogation a {@link InternationalTransferMechanism.DEROGATION} relies on. spec-cite: GDPR Art. 49(1). */
134
+ export enum InternationalTransferDerogation {
135
+ /** Art. 49(1)(a) — explicit consent after being informed of the risks. */
136
+ EXPLICIT_CONSENT = "EXPLICIT_CONSENT",
137
+ /** Art. 49(1)(b) — necessary for a contract with the data subject. */
138
+ CONTRACT_WITH_SUBJECT = "CONTRACT_WITH_SUBJECT",
139
+ /** Art. 49(1)(c) — necessary for a contract concluded in the subject's interest with another party. */
140
+ CONTRACT_IN_SUBJECT_INTEREST = "CONTRACT_IN_SUBJECT_INTEREST",
141
+ /** Art. 49(1)(d) — important reasons of public interest. */
142
+ PUBLIC_INTEREST = "PUBLIC_INTEREST",
143
+ /** Art. 49(1)(e) — establishment, exercise or defence of legal claims. */
144
+ LEGAL_CLAIMS = "LEGAL_CLAIMS",
145
+ /** Art. 49(1)(f) — vital interests where the subject cannot consent. */
146
+ VITAL_INTERESTS = "VITAL_INTERESTS",
147
+ /** Art. 49(1)(g) — a transfer from a public register. */
148
+ PUBLIC_REGISTER = "PUBLIC_REGISTER",
149
+ /** Art. 49(1), second subparagraph — compelling legitimate interests, for a non-repetitive transfer. */
150
+ COMPELLING_LEGITIMATE_INTERESTS = "COMPELLING_LEGITIMATE_INTERESTS",
151
+ }
152
+
153
+ /**
154
+ * Whether reaching this processor moves personal data out of the jurisdiction it came from.
155
+ *
156
+ * A DETERMINATION, recorded by the operator, because regions are free text: nothing can compare
157
+ * `United States` or `eu-west-1` with a declared operating jurisdiction, so the framework cannot tell a
158
+ * domestic processor from a foreign one and does not guess.
159
+ */
160
+ export enum ProcessorTransferDeterminationKind {
161
+ /** Every region this processor (and its subprocessors) uses lies within the jurisdictions the data comes from. */
162
+ NO_TRANSFER = "NO_TRANSFER",
163
+ /** Personal data leaves its origin jurisdiction to reach this processor, under the safeguards named. */
164
+ TRANSFER = "TRANSFER",
165
+ }
166
+
167
+ /** The safeguard one origin jurisdiction's data travels under. */
168
+ export const ProcessorTransferSafeguardSchema = z
169
+ .strictObject({
170
+ /** The jurisdiction the data leaves — one of the application's `operatingJurisdictions`. */
171
+ originJurisdictionSlug: z.string().trim().min(1),
172
+ mechanism: z.enum(InternationalTransferMechanism).systemEnum("InternationalTransferMechanism"),
173
+ /** Required with {@link InternationalTransferMechanism.DEROGATION}, refused otherwise. */
174
+ derogation: z.enum(InternationalTransferDerogation).systemEnum("InternationalTransferDerogation").optional(),
175
+ /**
176
+ * The instrument, as a reader could look it up: "EU SCCs (Commission Decision 2021/914), Module Two",
177
+ * "UK Addendum to the EU SCCs", "EU-US Data Privacy Framework — recipient certified". A mechanism
178
+ * member alone tells a reader the article, not the document that binds the recipient.
179
+ */
180
+ instrument: z.string().trim().min(1),
181
+ })
182
+ .superRefine((safeguard, context) => {
183
+ const isDerogation = safeguard.mechanism === InternationalTransferMechanism.DEROGATION;
184
+ if (isDerogation !== (safeguard.derogation !== undefined)) {
185
+ context.addIssue({
186
+ code: "custom",
187
+ path: ["derogation"],
188
+ message: isDerogation ? "a derogation must name which Art. 49 ground it relies on" : "only a DEROGATION mechanism names a derogation",
189
+ });
190
+ }
191
+ });
192
+ export type ProcessorTransferSafeguard = z.infer<typeof ProcessorTransferSafeguardSchema>;
193
+
194
+ /**
195
+ * The operator's transfer determination for one register entry.
196
+ *
197
+ * Carried by the ENTRY, not the provider, and not per subprocessor: a vendor's regions change when it opens
198
+ * a data centre, a mechanism changes when a court rules, and the processor's own contract is what binds its
199
+ * onward transfers to its subprocessors — so the determination for reaching this processor covers the chain
200
+ * behind it. It is OPTIONAL, and absence means "not determined": the `international-transfers` fact then
201
+ * answers nothing, because a register with an undetermined entry cannot support either "no transfer" or a
202
+ * list of safeguards.
203
+ */
204
+ export const ProcessorTransferDeterminationSchema = z.discriminatedUnion("kind", [
205
+ z.strictObject({
206
+ kind: z.literal(ProcessorTransferDeterminationKind.NO_TRANSFER).systemEnum("ProcessorTransferDeterminationKind"),
207
+ /** Why none of the regions is outside the origin jurisdictions — the comparison the framework cannot make. */
208
+ rationale: z.string().trim().min(1),
209
+ }),
210
+ z
211
+ .strictObject({
212
+ kind: z.literal(ProcessorTransferDeterminationKind.TRANSFER).systemEnum("ProcessorTransferDeterminationKind"),
213
+ /** One safeguard per origin jurisdiction whose data reaches this processor. */
214
+ safeguards: z.array(ProcessorTransferSafeguardSchema).min(1),
215
+ })
216
+ .superRefine((determination, context) => {
217
+ const origins = determination.safeguards.map((safeguard) => safeguard.originJurisdictionSlug);
218
+ if (new Set(origins).size !== origins.length) {
219
+ context.addIssue({ code: "custom", path: ["safeguards"], message: "one safeguard per origin jurisdiction" });
220
+ }
221
+ }),
222
+ ]);
223
+ export type ProcessorTransferDetermination = z.infer<typeof ProcessorTransferDeterminationSchema>;
224
+
225
+ const ProcessorIdentityFieldsSchema = z.object({
226
+ /**
227
+ * The processor's LEGAL entity — the party a data-protection obligation actually binds.
228
+ *
229
+ * Not the brand. "Anthropic" is a product name; a notice, a DPA and a supervisory authority all need
230
+ * the entity that signs.
231
+ */
232
+ legalEntityName: z.string().trim().min(1),
233
+ /**
234
+ * Where this processor processes personal data for this application.
235
+ *
236
+ * A LIST at the processor level rather than per capability. The issue that opened this suggested
237
+ * per-capability regions, "where a provider offers regional endpoints" — declined for the reason
238
+ * that settled the retention schedule the same day: an operator decides a small number of things and
239
+ * defends them, and a granularity nobody maintains produces a register that is precise and wrong.
240
+ * An operator using one vendor in two regions declares both, which is what a notice states anyway.
241
+ *
242
+ * Free text rather than a closed vocabulary: region names are genuinely open (`eu-west-1`, `EU`,
243
+ * `Ireland`, `United States`), and a fixed list would be wrong for the next vendor.
244
+ */
245
+ processingRegions: z.array(z.string().trim().min(1)).min(1),
246
+ /**
247
+ * The processor's own subprocessors.
248
+ *
249
+ * EMPTY is a real answer — "this processor discloses no subprocessors" — and it is available only
250
+ * because the whole entry is an authored declaration. An operator who has not checked omits the
251
+ * ENTRY, not this field, keeping one clean absence axis: present means established, absent means
252
+ * nobody has looked.
253
+ */
254
+ subprocessors: z.array(ProcessorSubprocessorSchema),
255
+ /** Whether reaching this processor is an international transfer, and under what. See {@link ProcessorTransferDeterminationSchema}. */
256
+ transferDetermination: ProcessorTransferDeterminationSchema.optional(),
257
+ });
258
+
259
+ /** One entry in the register — a configured provider, or a subprocessor nothing configures. */
260
+ export const ApplicationProcessorDeclarationSchema = z.discriminatedUnion("kind", [
261
+ ProcessorIdentityFieldsSchema.extend({
262
+ kind: z.literal(ProcessorRegisterEntryKind.CONFIGURED_PROVIDER).systemEnum('ProcessorRegisterEntryKind'),
263
+ /**
264
+ * The configured provider this describes — the same ref the application's composition uses.
265
+ *
266
+ * The join is what makes this arm checkable: a declaration naming a provider the application does
267
+ * not configure describes a relationship it does not have, and a configured provider with no
268
+ * declaration is the gap {@link undeclaredProcessorRefs} reports.
269
+ */
270
+ providerRef: z.string().trim().min(1),
271
+ /**
272
+ * Why this processor is used, where the capability does not already say.
273
+ *
274
+ * OPTIONAL on this arm alone, and the asymmetry is the point: a configured provider's purpose is
275
+ * implied by the capability it serves — `AI_LLM` takes prompt content, `EMAIL` takes recipient
276
+ * addresses — so restating it is a second authority for one fact. Supply it only where the
277
+ * capability under-describes what this particular vendor does for this application.
278
+ */
279
+ purpose: z.string().trim().min(1).optional(),
280
+ }).strict(),
281
+ ProcessorIdentityFieldsSchema.extend({
282
+ kind: z.literal(ProcessorRegisterEntryKind.AUTHORED).systemEnum('ProcessorRegisterEntryKind'),
283
+ /**
284
+ * A stable slug for a subprocessor the configuration never mentions — `hosting`, `cdn`,
285
+ * `support-desk`. Its own key, because there is no `providerRef` to borrow.
286
+ */
287
+ subprocessorRef: z.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
288
+ /**
289
+ * Why this subprocessor is used. REQUIRED here, because nothing else can say.
290
+ *
291
+ * The configured-provider arm can lean on its capability; this arm has no capability, no
292
+ * configuration and no runtime binding to imply anything. Without a purpose the entry is a name
293
+ * and a region, which tells a reader that someone else holds their data and not what for.
294
+ */
295
+ purpose: z.string().trim().min(1),
296
+ }).strict(),
297
+ ]);
298
+ export type ApplicationProcessorDeclaration = z.infer<typeof ApplicationProcessorDeclarationSchema>;
299
+
300
+ /**
301
+ * The application's accepted processor register.
302
+ *
303
+ * Deliberately NOT requiring an entry per configured provider. Requiring completeness would make the
304
+ * register unauthorable until every vendor had been researched, which is the blocking this whole
305
+ * capability exists to remove — a partial register is useful, and its holes are reported rather than
306
+ * hidden.
307
+ */
308
+ export const ApplicationProcessorRegisterSchema = z
309
+ .strictObject({
310
+ schemaVersion: z.literal(1),
311
+ processors: z.array(ApplicationProcessorDeclarationSchema),
312
+ })
313
+ .superRefine((register, context) => {
314
+ /*
315
+ * Uniqueness PER ARM, on each arm's own key.
316
+ *
317
+ * Not one shared namespace: a `providerRef` and a `subprocessorRef` are addresses in different
318
+ * spaces, and colliding them would refuse an application whose hosting company happens to share a
319
+ * slug with a provider it configures — a refusal with no compliance meaning at all.
320
+ */
321
+ const seenProviderRefs = new Set<string>();
322
+ const seenSubprocessorRefs = new Set<string>();
323
+
324
+ register.processors.forEach((processor, index) => {
325
+ if (processor.kind === ProcessorRegisterEntryKind.CONFIGURED_PROVIDER) {
326
+ if (seenProviderRefs.has(processor.providerRef)) {
327
+ context.addIssue({
328
+ code: "custom",
329
+ path: ["processors", index, "providerRef"],
330
+ message: `"${processor.providerRef}" is declared twice; one provider carries one processor identity`,
331
+ });
332
+ }
333
+ seenProviderRefs.add(processor.providerRef);
334
+ return;
335
+ }
336
+
337
+ if (seenSubprocessorRefs.has(processor.subprocessorRef)) {
338
+ context.addIssue({
339
+ code: "custom",
340
+ path: ["processors", index, "subprocessorRef"],
341
+ message: `"${processor.subprocessorRef}" is declared twice; one subprocessor carries one identity`,
342
+ });
343
+ }
344
+ seenSubprocessorRefs.add(processor.subprocessorRef);
345
+ });
346
+ });
347
+ export type ApplicationProcessorRegister = z.infer<typeof ApplicationProcessorRegisterSchema>;
348
+ ```
@@ -0,0 +1,123 @@
1
+ # Per-provider compliance choice
2
+
3
+ Where a privacy notice's "who processes this, and where" comes from: the deployment model and
4
+ processing region an application declares for each provider it has configured.
5
+
6
+ Read this when:
7
+
8
+ - a notice or processor-register entry has to state where personal data goes;
9
+ - you are adding a provider and need to say whether the vendor or the operator runs it;
10
+ - the configuration is refused for a missing or a surplus processing region;
11
+ - you are checking whether the regions an application asserts agree with what its vendors declare.
12
+
13
+ The last one is the case with no mechanism behind it — see the warning in the extracted source.
14
+
15
+ ## Import Origins
16
+
17
+ - `@wildo-ai/saas-models`
18
+
19
+ ## Source Excerpts
20
+
21
+ ### Origin Package: `@wildo-ai/saas-models`
22
+
23
+ ```typescript
24
+ /**
25
+ * The application's CHOICE among what a provider offers — one entry per configured provider.
26
+ *
27
+ * The provider declares possibilities ({@link ProviderComplianceProfileSchema}); this is where an
28
+ * operator says which of them applies to their deployment. Keeping the two apart is the whole point
29
+ * of the layering: a vendor's regions change when it opens a data centre, an operator's choice
30
+ * changes when they migrate, and collapsing them would make one edit look like the other.
31
+ *
32
+ * Not carried inside `providerConfigurations`, which is an opaque `Record<string, unknown>` bag for a
33
+ * provider's own runtime profile. A compliance answer must not live somewhere nothing can read it
34
+ * without knowing the provider.
35
+ */
36
+ export const ApplicationProviderComplianceChoiceSchema = z.strictObject({
37
+ /**
38
+ * Who runs this provider in THIS deployment.
39
+ *
40
+ * Required even when the provider supports only one model. The redundancy is deliberate: whether
41
+ * personal data leaves the operator's control is the single most consequential fact a notice states
42
+ * about a provider, and reading it out of a framework default rather than an operator's declaration
43
+ * is how a wrong one goes unnoticed.
44
+ */
45
+ deploymentModel: z.enum(ProviderDeploymentModel),
46
+ /**
47
+ * Which region this provider processes in, chosen from what the provider declares possible.
48
+ *
49
+ * NOT validated here, and NOT validated at boot either. This schema cannot see the provider
50
+ * registry, and refusing an unlisted region would make a vendor's new data centre an application
51
+ * build failure, so the intended posture is warn-do-not-block: a region outside the provider's
52
+ * declared list is APP-ASSERTED and reported, never refused.
53
+ *
54
+ * WIRED since 2026-09-10 (issue #308). `appAssertedProcessingRegions` below computes exactly that
55
+ * set, and the companion's compliance-primary-facts section reports it per provider, naming both the
56
+ * configured value and what the provider declares — because a divergence is either a typo or a stale
57
+ * provider module, and those are opposite work. It took this long only because of a DATA PATH: the
58
+ * vendor's region list lives on the backend provider module and the renderer reads provider
59
+ * SPECIFICATIONS, so the helper could not be called until `complianceProfile` was mirrored onto the
60
+ * specification contract. Any future report must call this helper rather than re-derive the
61
+ * comparison.
62
+ */
63
+ processingRegion: z.string().trim().min(1).optional(),
64
+ }).superRefine((choice, context) => {
65
+ /*
66
+ * The pairing, in both directions.
67
+ *
68
+ * A VENDOR_HOSTED choice with no region leaves the notice unable to state where the data goes,
69
+ * which is the question this whole layer exists to answer. A SELF_HOSTED choice WITH one is the
70
+ * fiction the provider layer already refuses: the operator runs it, so its region is wherever they
71
+ * run it, and a value here would be a guess presented as a configuration.
72
+ */
73
+ if (choice.deploymentModel === ProviderDeploymentModel.VENDOR_HOSTED && choice.processingRegion === undefined) {
74
+ context.addIssue({
75
+ code: 'custom',
76
+ path: ['processingRegion'],
77
+ message: 'a VENDOR_HOSTED provider must be configured with the region it processes in — without one, no notice can state where this data goes',
78
+ });
79
+ }
80
+ if (choice.deploymentModel === ProviderDeploymentModel.SELF_HOSTED && choice.processingRegion !== undefined) {
81
+ context.addIssue({
82
+ code: 'custom',
83
+ path: ['processingRegion'],
84
+ message: 'a SELF_HOSTED provider runs wherever the operator runs it, so a processing region here is a guess presented as configuration — drop it',
85
+ });
86
+ }
87
+ });
88
+ export type ApplicationProviderComplianceChoice = z.infer<typeof ApplicationProviderComplianceChoiceSchema>;
89
+
90
+ /** Per configured provider ref, the operator's compliance choice. */
91
+ export const ApplicationProviderComplianceChoicesSchema = z.record(
92
+ z.string().trim().min(1),
93
+ ApplicationProviderComplianceChoiceSchema,
94
+ );
95
+ export type ApplicationProviderComplianceChoices = z.infer<typeof ApplicationProviderComplianceChoicesSchema>;
96
+
97
+ /**
98
+ * Regions an application asserts that the provider does not declare.
99
+ *
100
+ * Reported, never refused — a vendor opening a data centre must not become a build failure, and an
101
+ * operator who genuinely knows better than a stale framework list should be able to say so. What the
102
+ * framework owes is that the divergence is VISIBLE, which is the same trade the personal-data
103
+ * declaration report makes.
104
+ */
105
+ export function appAssertedProcessingRegions(params: {
106
+ readonly choices: ApplicationProviderComplianceChoices;
107
+ readonly profilesByProviderRef: Readonly<Record<string, ProviderComplianceProfile>>;
108
+ }): ReadonlyArray<{ readonly providerRef: string; readonly region: string }> {
109
+ const asserted: Array<{ providerRef: string; region: string }> = [];
110
+
111
+ for (const [providerRef, choice] of Object.entries(params.choices)) {
112
+ if (choice.processingRegion === undefined) continue;
113
+ const profile = params.profilesByProviderRef[providerRef];
114
+ // No profile is not an assertion about a region — it is a provider that declares no compliance
115
+ // profile at all, which is a different gap and belongs to whoever reports THAT.
116
+ if (profile === undefined) continue;
117
+ if (profile.processingRegions.includes(choice.processingRegion)) continue;
118
+ asserted.push({ providerRef, region: choice.processingRegion });
119
+ }
120
+
121
+ return asserted;
122
+ }
123
+ ```
@@ -37,6 +37,7 @@ them.
37
37
  | Module command items| `frontend/src/modules/<module>/app-shell.module.frontend.ts` (`commandMenuItems` contribution)|
38
38
  | Module scope fields | `frontend/src/modules/<module>/app-shell.module.frontend.ts` (`quickSwitcherFields` contribution)|
39
39
  | Other app config | `frontend/src/config/*.config.ts` (navigation, design-system, global-views) |
40
+ | Public-page identity | `frontend/src/modules-registry.frontend.ts` (`publicShellIdentityMode` — NOT `app-shell.config.ts`) |
40
41
  | Translation labels | `frontend/src/i18n/`, `frontend/src/labels/` (depending on app convention) |
41
42
  | Hotkey bindings | Resolved by the engine from `[ApplicationLevelComponentType.HOTKEY]` + per-component `openShortcut` |
42
43
 
@@ -53,6 +54,7 @@ them.
53
54
  - Adjusting user dropdown sections / avatar display
54
55
  - Toggling deferred shell surfaces (activity bar, utility panel, control panel)
55
56
  - Changing responsive policy (sidebar burger threshold, etc.)
57
+ - Naming the application on its sign-in / registration pages (`publicShellIdentityMode`)
56
58
 
57
59
  ## When NOT to Use
58
60
 
@@ -135,6 +137,24 @@ dropdown rows, `presentation` for the closed control. Read
135
137
  for what the declaration wires for free (ambient scope, URL promotion,
136
138
  bi-directional mirroring, deselection).
137
139
 
140
+ ### Step 3d: Name the application on its public pages
141
+
142
+ Sign-in, registration and every other pre-authentication card can carry the
143
+ application's mark and name. It is opt-in and off by default.
144
+
145
+ It is one property, inside the existing `buildFrontendModuleConfigOverrides({ … })`
146
+ call in `frontend/src/modules-registry.frontend.ts`, beside `homeDefinition` and
147
+ `errorPageConfig`:
148
+
149
+ `publicShellIdentityMode: PublicShellIdentityMode.BRAND_HEADER` (imported from
150
+ `@wildo-ai/saas-frontend-lib`).
151
+
152
+ Two things to know before you reach for `appShellConfig` instead: this is not an
153
+ `ApplicationLevelComponentType` key and putting it there silently configures
154
+ nothing, and the mode is a PERMISSION rather than a promise that a logo exists —
155
+ an application with no generated brand shows its name alone. Read
156
+ `references/framework-public-shell-identity-api.md` for the full render matrix.
157
+
138
158
  ### Step 4: Labels
139
159
 
140
160
  Any new user-visible chrome string (command names, section titles,
@@ -225,7 +245,6 @@ export const appShellConfig : AppConfiguration_Frontend['appComponentsConfigurat
225
245
  responsiveBreakpoint: ViewportBreakpoint.MOBILE,
226
246
  responsivePolicy: SidebarResponsivePolicy.BURGER,
227
247
  defaultSection: 'main',
228
- showUncategorized: true,
229
248
  // HOME as the app's BRAND HEADER: the generated Your Application symbol + the
230
249
  // application display name, pinned above the search trigger and doubling as
231
250
  // the home button (so no separate "Home" row renders). The alternatives are
@@ -278,6 +297,11 @@ export const appShellConfig : AppConfiguration_Frontend['appComponentsConfigurat
278
297
  [ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: true,
279
298
 
280
299
  [ApplicationLevelComponentType.QUICK_SWITCHER]: true,
300
+ /**
301
+ * OFF, and that is an answer rather than an omission (#504). This application's settings and
302
+ * actions are served by the settings hub overlay, so a persistent rail would duplicate it. It is
303
+ * switched on by the first application that genuinely wants one.
304
+ */
281
305
  [ApplicationLevelComponentType.CONTROL_PANEL]: false,
282
306
  [ApplicationLevelComponentType.STATUS_BAR]: {
283
307
  showMemoryUsage: false,
@@ -296,18 +320,49 @@ export const appShellConfig : AppConfiguration_Frontend['appComponentsConfigurat
296
320
  ],
297
321
  showOrgSwitcher: true,
298
322
  showLogout: true,
299
- mergeSettings: false,
300
323
  },
301
324
 
302
- [ApplicationLevelComponentType.SETTINGS_DROPDOWN]: {
303
- mergedWith: ApplicationLevelComponentType.USER_DROPDOWN,
304
- },
305
325
 
306
326
  [ApplicationLevelComponentType.NAVIGATION_CONTROL]: true,
307
327
 
308
- // ─── Deferred shell surfaces ───────────────────────────────────────────────
328
+ /**
329
+ * The Gmail-style right-side panel, holding the Todo Assistant (#504).
330
+ *
331
+ * It hosts a VIEW rather than a component, and that distinction is the point. The assistant is an
332
+ * ACTOR SYSTEM — `todo-assistant`, declared by the backend addon and exposed as the
333
+ * `todo-assistant-view` flows-actors view — not a chat widget, and an actor is not necessarily an
334
+ * agent: `Actor_ExecutionMode` is `AGENTIC | FLOW_EXECUTION | HUMAN_INTERACTION`, so the same
335
+ * surface renders a programmatic node as readily as a model-backed one. A `CUSTOM_COMPONENT` item
336
+ * is rendered with no arguments and so could never be told WHICH system to show.
337
+ *
338
+ * The panel is where this belongs rather than a route: an assistant grounded in what you are
339
+ * looking at has to stay beside the workspace, and `/flows-actors/todo-assistant-view` replaces it.
340
+ * Nothing in the panel navigates, so hosting a view here needs no navigation zone of its own —
341
+ * see the `UTILITY_PANEL` declaration for when that changes.
342
+ */
343
+ [ApplicationLevelComponentType.UTILITY_PANEL]: {
344
+ position: HorizontalPlacement.END,
345
+ items: [
346
+ {
347
+ kind: LauncherItemTargetKind.VIEW,
348
+ viewRef: 'todo-assistant-view',
349
+ // semantic-literal-boundary: the value of `StandardIconReference.BRAIN`. That enum is not on
350
+ // the `/companion` entrypoint this file imports from, and reaching it through the package
351
+ // root would pull the frontend runtime graph into a config the companion parses statically —
352
+ // which is the coupling that entrypoint exists to prevent.
353
+ icon: 'brain',
354
+ label: 'Todo Assistant',
355
+ },
356
+ ],
357
+ },
358
+
359
+ /**
360
+ * OFF, and that is an answer rather than an omission (#504). The activity bar selects `AppMode`s
361
+ * and this application declares none, so switching it on renders an empty rail — it would
362
+ * demonstrate the gap instead of the surface. It is switched on by the first application that
363
+ * declares more than one mode; the condition is recorded at the engine declaration too.
364
+ */
309
365
  [ApplicationLevelComponentType.ACTIVITY_BAR]: false,
310
- [ApplicationLevelComponentType.UTILITY_PANEL]: false,
311
366
  };
312
367
  ```
313
368
 
@@ -363,10 +418,12 @@ What earns its place:
363
418
  `[ApplicationLevelComponentType.HOTKEY]: true` to the platform hotkey
364
419
  provider, which is what makes `Cmd+K` reachable.
365
420
  - `USER_DROPDOWN.sections: [UserDropdownSection.*, ...]` orders the
366
- dropdown contents. `mergeSettings: false` keeps the settings
367
- dropdown separate; `SETTINGS_DROPDOWN.mergedWith` then lets a
368
- separate dropdown declare it merges into another — this is the
369
- framework's idiom for "two surfaces, one popover".
421
+ dropdown contents. `settingsEntries: ['profile', 'security']` surfaces
422
+ those Settings Hub sections inline in the dropdown, in that order; omit
423
+ it (or leave it empty) to render the single "Settings" button that opens
424
+ the hub at its default section. The refs name **settings-hub sections**,
425
+ the same vocabulary `settings-hub.config.ts` places — never sidebar
426
+ section refs. There is no separate enable flag: the list is the intent.
370
427
  - Deferred surfaces (`ACTIVITY_BAR`, `UTILITY_PANEL`,
371
428
  `CONTROL_PANEL`) are explicitly set to `false`. This is **not**
372
429
  optional — explicit disable signals "we know this exists, we chose
@@ -613,11 +670,13 @@ What earns its place:
613
670
 
614
671
  ## References
615
672
 
673
+ - `references/framework-brand-identity-api.md` — `useBrandIdentity()` for any shell surface rendering the brand, and why a tool must declare `shellIdentity` or it shows its customer's brand as its own
616
674
  - `references/app-shell-surfaces.md` — author-facing surface list
617
675
  - `references/framework-app-shell-api.md` — engine app-level component vocabulary + configuration schema
618
676
  - `references/framework-command-menu-omnibox-api.md` — command-menu policy (`CommandBarPolicy`) + omnibox `searchResources` (`CommandMenuSearchResource`) contract
619
677
  - `references/framework-app-shell-hosted-components-api.md` — menubar/sidebar `hostedComponents` entry shape (`MenubarHostedComponent` / `SidebarHostedComponent`) + per-placement `triggerWidth`
620
678
  - `references/framework-quick-switcher-scope-field-api.md` — `quickSwitcherFields` entry shape (`QuickSwitcherScopeField`), the two independent presentation axes (`optionDisplayMode` / `presentation`), and what a scope declaration wires for free
679
+ - `references/framework-public-shell-identity-api.md` — naming the application on its public/auth cards: where the field goes, and what actually renders for each brand state
621
680
 
622
681
  ## Verification
623
682
 
@@ -647,6 +706,7 @@ Run from the app root:
647
706
  | Sidebar section refs are unique | `rg -oN "ref:\s+'\K[a-z-]+" frontend/src/config/app-shell.config.ts \| sort \| uniq -d` (must return empty) |
648
707
  | Command menu has an `openShortcut` | `rg -n "openShortcut:" frontend/src/config/app-shell.config.ts` |
649
708
  | Every `commands: []` entry resolves to a registered `commandId` | `rg -oN "commandId:\s+'\K[A-Z_.]+" frontend/src/config/app-shell.config.ts \| sort -u` then verify each appears in `frontend/src/commands/**/*.ts` (or the engine command registry) |
709
+ | `publicShellIdentityMode` is NOT in the shell config | `rg -n "publicShellIdentityMode" frontend/src/config/app-shell.config.ts` (must return empty; it belongs in `frontend/src/modules-registry.frontend.ts`) |
650
710
  | `searchResources` implies `policy: OMNIBOX` | `rg -n "searchResources:" frontend/src/config/app-shell.config.ts` — if it matches, `rg -n "CommandBarPolicy.OMNIBOX" frontend/src/config/app-shell.config.ts` must also match |
651
711
  | Module command items are typed launcher refs | `rg -n "kind:\s+LauncherItemTargetKind\." frontend/src/modules/*/app-shell.module.frontend.ts` (each `commandMenuItems` entry must be a typed `LauncherItemTargetKind`, never a string) |
652
712
  | Hosted-component placement uses the typed enum | `rg -n "placement:\s+(Horizontal\|Vertical)Placement\." frontend/src/config/app-shell.config.ts` (every `hostedComponents` entry that sets `placement` must use `HorizontalPlacement.*` in the menubar / `VerticalPlacement.*` in the sidebar) |
@@ -677,6 +737,8 @@ spec or navigation that targets the section.
677
737
  | "Add a clear button next to the switcher so users can deselect" | The control already renders a clear affordance inside its trigger whenever a value is selected. A sibling button reads as one more chrome icon in the cluster and names no owner. |
678
738
  | "The scope field must exist on the resource schema" | It need not. With no matching schema field the framework falls back to the target resource's primary key — which is why the option-rendering mode is declared on the FIELD and cannot come from a `.foreignKeyUI(...)` decorator. |
679
739
  | "`presentation: LABEL_ABOVE` will break the menubar's alignment" | The bar has no fixed height and centre-aligns its row: it grows to fit the tallest hosted control and shorter siblings re-centre. Pick `LABEL_ABOVE` when you want the label and accept a taller bar; `ICON_LED` when you want identity at one row height. |
740
+ | "`publicShellIdentityMode` is shell config, so it goes in `appShellConfig`." | It is not an `ApplicationLevelComponentType` key. Placed there it configures nothing and raises no error — those keys govern the AUTHENTICATED shell, which does not exist on a public page. It belongs in the `buildFrontendModuleConfigOverrides` call. |
741
+ | "We have no logo yet, so turning on the public identity would render a broken image." | The mode is a permission, not a promise. With no generated brand the card shows the name alone, and starts showing the mark by itself once one exists — nothing to revisit. |
680
742
 
681
743
  ## Red Flags
682
744
 
@@ -692,6 +754,7 @@ spec or navigation that targets the section.
692
754
  - A scope field's `resourceType` given as a string literal — it bypasses typecheck and silently names no registered resource, so the picker loads no options (catch with the **Scope-field resource types are typed** grep — must return empty).
693
755
  - `optionDisplayMode` / `presentation` given quoted strings instead of their enums (catch with the **Presentation axes use their typed enums** grep — every extracted value must be an enum member).
694
756
  - A hand-rolled "clear scope" button authored beside the switcher — duplicates the affordance the control already renders inside its trigger (catch with the **No hand-rolled clear button** verification item; grep the app for a scope-clear handler).
757
+ - `publicShellIdentityMode` appearing inside `frontend/src/config/app-shell.config.ts` — catch with the public-identity grep below
695
758
 
696
759
  ## Related Skills
697
760