@wildo-ai/framework-knowledge 1.1.5 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (835) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  21. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  22. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  23. package/dist/esm/framework-knowledge.definitions.js +320 -11
  24. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
  28. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
  32. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
  36. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
  40. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  42. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  44. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  46. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
  48. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
  50. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
  52. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
  54. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
  56. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
  59. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
  61. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
  65. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
  67. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
  69. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
  71. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
  73. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
  75. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
  77. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
  79. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
  81. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
  83. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
  85. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
  87. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
  89. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
  90. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  92. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  94. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  96. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  98. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  100. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
  101. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  103. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  104. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  105. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  106. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
  107. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
  108. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  109. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
  110. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  111. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  113. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  114. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
  115. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
  116. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
  118. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
  119. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
  121. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  123. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
  125. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
  127. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
  130. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
  132. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
  134. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
  135. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  137. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  138. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  139. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  140. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
  141. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  142. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
  143. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
  145. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  148. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
  150. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
  151. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
  153. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
  156. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
  157. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
  159. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
  160. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  161. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
  162. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  163. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  164. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  165. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
  166. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  167. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
  168. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  169. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  170. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  171. package/dist/knowledge/manifest.json +8 -8
  172. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
  173. package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
  174. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
  175. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  176. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  177. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
  178. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
  179. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
  180. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
  181. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
  182. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
  183. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
  184. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
  185. package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
  186. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
  187. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
  188. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
  189. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
  190. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
  191. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
  192. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
  193. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
  194. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
  195. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
  196. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
  197. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
  198. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
  199. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
  200. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
  201. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
  202. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
  203. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  204. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  205. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  206. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  207. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
  208. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  209. package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
  210. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
  211. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  212. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  213. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
  214. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  215. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
  216. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
  217. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
  218. package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
  219. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
  220. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
  221. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
  222. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
  223. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
  224. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
  225. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
  226. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
  227. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
  228. package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
  229. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
  230. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
  231. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  232. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  233. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
  234. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
  235. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
  236. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
  237. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
  238. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
  239. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
  240. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
  241. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
  242. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
  243. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
  244. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
  245. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
  246. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
  247. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
  248. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
  249. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  250. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  251. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  252. package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
  253. package/dist/knowledge/references/capability-composition.config.md +20 -1
  254. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  255. package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
  256. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  257. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  258. package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
  259. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  260. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  261. package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
  262. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  263. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  264. package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
  265. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  266. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  267. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  268. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  269. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  270. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  271. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
  272. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
  273. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  274. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  275. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  276. package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
  277. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  278. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  279. package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
  280. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  281. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  282. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  283. package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
  284. package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
  285. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  286. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
  287. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
  288. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
  289. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
  290. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
  291. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  292. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  293. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
  294. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
  295. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  296. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  297. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  298. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  299. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  300. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  301. package/dist/knowledge/references/experience-plan.config.md +11 -4
  302. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
  303. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  304. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  305. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  306. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  307. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  308. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  309. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  310. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
  311. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  312. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  313. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  314. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  315. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  316. package/dist/knowledge/references/integration-plan.config.md +34 -2
  317. package/dist/knowledge/references/market.alternative.config.md +1 -1
  318. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  319. package/dist/knowledge/references/market.category.config.md +1 -1
  320. package/dist/knowledge/references/market.channel.config.md +1 -1
  321. package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
  322. package/dist/knowledge/references/market.gain.config.md +1 -1
  323. package/dist/knowledge/references/market.icp.config.md +1 -1
  324. package/dist/knowledge/references/market.job.config.md +1 -1
  325. package/dist/knowledge/references/market.message-template.config.md +1 -1
  326. package/dist/knowledge/references/market.objection.config.md +1 -1
  327. package/dist/knowledge/references/market.pain.config.md +1 -1
  328. package/dist/knowledge/references/market.persona.config.md +1 -1
  329. package/dist/knowledge/references/market.positioning.config.md +1 -1
  330. package/dist/knowledge/references/market.proof.config.md +1 -1
  331. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  332. package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
  333. package/dist/knowledge/references/market.trigger.config.md +1 -1
  334. package/dist/knowledge/references/placement-plan.config.md +7 -1
  335. package/dist/knowledge/references/platform.config.backing-services.md +15 -15
  336. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
  337. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  338. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  339. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  340. package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
  341. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  342. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  343. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  344. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  345. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
  346. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
  348. package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
  349. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  350. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  351. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
  352. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
  353. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  354. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
  355. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  356. package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
  357. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  358. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  359. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  360. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  361. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  362. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
  363. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  364. package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
  365. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  366. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  367. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  368. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  369. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
  370. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  371. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
  372. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  373. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  374. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
  375. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
  376. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  377. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
  378. package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
  379. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  380. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  381. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  382. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  383. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  384. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  385. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  386. package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
  387. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  388. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
  389. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
  390. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  391. package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
  392. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
  393. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  394. package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
  395. package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
  396. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
  397. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  398. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  399. package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
  400. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  401. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  402. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  403. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  404. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  405. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  406. package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
  407. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  408. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  409. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  410. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  411. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  412. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  413. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  414. package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
  415. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
  416. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
  417. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
  418. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
  419. package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
  420. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
  421. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
  422. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  423. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  424. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  425. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  426. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  427. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  428. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  429. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  430. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  431. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  432. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  433. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  434. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  435. package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
  436. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  437. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  438. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
  439. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
  440. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
  442. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  443. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
  444. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
  445. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  446. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  447. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  448. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  449. package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
  450. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  451. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  452. package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
  453. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
  454. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
  455. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  456. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  457. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  458. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  459. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  460. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
  461. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  462. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
  463. package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
  464. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  465. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  466. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
  467. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
  468. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  469. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  470. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  471. package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
  472. package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
  473. package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
  474. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
  475. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  476. package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
  477. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  478. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  479. package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
  480. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  481. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  482. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  483. package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
  484. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  485. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  486. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  487. package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
  488. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  489. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  490. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  491. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  492. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  493. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  494. package/dist/knowledge/references/website-plan.config.md +39 -6
  495. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
  496. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
  497. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
  498. package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
  499. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
  500. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
  501. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
  502. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
  503. package/dist/knowledge/references/zod.factories.address.md +7 -7
  504. package/dist/knowledge/references/zod.factories.code.md +2 -2
  505. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  506. package/dist/knowledge/references/zod.factories.money.md +3 -3
  507. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  508. package/dist/knowledge/registries/framework-topics.json +1238 -54
  509. package/dist/knowledge/registries/playbooks.json +81 -109
  510. package/dist/knowledge/registries/source-tags.json +3191 -1126
  511. package/dist/knowledge/rules/live-context-door.md +29 -0
  512. package/dist/knowledge/skills/INDEX.md +27 -24
  513. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  514. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  515. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  516. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  517. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  518. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  520. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  521. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
  523. package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
  524. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
  525. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
  526. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  527. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
  528. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
  529. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
  530. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
  531. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
  532. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
  533. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
  534. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
  535. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
  536. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
  537. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  538. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  539. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  540. package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
  541. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
  542. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  543. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  544. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
  545. package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
  546. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  547. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
  548. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
  549. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
  550. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
  551. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
  552. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
  553. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  554. package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
  555. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
  556. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
  557. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
  558. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
  559. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
  560. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
  561. package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
  562. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
  563. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
  564. package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
  565. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
  566. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
  567. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
  568. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
  569. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
  570. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  571. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
  572. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
  573. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
  574. package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
  575. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
  576. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  577. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  578. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  579. package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
  580. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
  581. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
  582. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  583. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  584. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  585. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  586. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  587. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
  588. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
  589. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  590. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  591. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
  592. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
  594. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
  595. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  596. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
  597. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
  598. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
  599. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
  600. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
  601. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
  602. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  603. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
  604. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
  605. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
  606. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  607. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  608. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  609. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  610. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  611. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  612. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  613. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  614. package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
  615. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
  616. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  617. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  618. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  619. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  620. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  621. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  622. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  623. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  624. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
  625. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  626. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
  627. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
  628. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
  629. package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
  630. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  631. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  632. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  633. package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
  634. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
  635. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
  636. package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
  637. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
  638. package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
  639. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
  640. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
  641. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  642. package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
  643. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  644. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  645. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
  646. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  647. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
  648. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
  649. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
  650. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
  651. package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
  652. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  653. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  654. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
  659. package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
  660. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
  661. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
  662. package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
  663. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  664. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  665. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  666. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  667. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  668. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  669. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  670. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  677. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
  678. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  679. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
  680. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  681. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  682. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  683. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  684. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  685. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
  686. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
  687. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
  688. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  689. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
  690. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
  691. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  692. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
  693. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
  694. package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
  695. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  696. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
  697. package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
  698. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
  699. package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
  700. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
  701. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
  702. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
  703. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
  704. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
  705. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
  706. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
  707. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
  708. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
  709. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
  710. package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
  711. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
  712. package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
  713. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  714. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  715. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  716. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
  717. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
  718. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
  719. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  720. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  721. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  722. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  723. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  724. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  725. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  726. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  727. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  728. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  729. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
  730. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
  731. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
  732. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  733. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  734. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  735. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  736. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  737. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  738. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
  740. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  741. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  742. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
  743. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
  744. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
  745. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
  746. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
  747. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
  752. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  753. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
  754. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
  755. package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
  756. package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
  757. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  758. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  759. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  760. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  761. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  762. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  763. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
  764. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
  765. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  766. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  767. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
  768. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
  769. package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
  770. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  771. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  772. package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
  773. package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
  774. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
  775. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  776. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  777. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
  778. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
  779. package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
  780. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
  781. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  782. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
  783. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  784. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
  785. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
  786. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  787. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
  788. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
  789. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
  790. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
  791. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  792. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
  793. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  794. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  795. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
  796. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
  797. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
  798. package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
  799. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  800. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  801. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  802. package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
  803. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
  804. package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
  805. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
  806. package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
  807. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
  808. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
  809. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
  810. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
  811. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
  812. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
  813. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
  814. package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
  815. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
  816. package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
  817. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
  818. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  819. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
  820. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
  821. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  822. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  823. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
  824. package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
  825. package/dist/knowledge/topic-index.json +5887 -1695
  826. package/dist/tsconfig.build.tsbuildinfo +1 -1
  827. package/dist/tsconfig.tsbuildinfo +1 -1
  828. package/package.json +4 -4
  829. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
  830. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
  831. package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
  832. package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
  833. package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
  834. package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
  835. /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
@@ -0,0 +1,447 @@
1
+ # Collection-export PDF template contracts (source)
2
+
3
+ - **`PdfCollectionTemplateDefinition` / `definePdfCollectionTemplate`** — backend-only template that renders the ROWS of a LIST/SEARCH export into one downloaded PDF.
4
+ - **`createGovernedDocumentsPdfTemplate`** — ready-made collection template printing governed documents (cover, contents, one section per document with its standing and clauses).
5
+
6
+ Read this when declaring `collectionExport: { formats: [ResourceCollectionExportFormat.PDF], pdfTemplateId }` on a LIST/SEARCH variant, or when authoring the template it names.
7
+
8
+ ## Import Origins
9
+
10
+ - `@wildo-ai/saas-backend-lib`
11
+
12
+ ## Source Excerpts
13
+
14
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
15
+
16
+ ```typescript
17
+ *
18
+ * Input to a collection-export PDF template: the rows a listing's export returned (#1645).
19
+ *
20
+ * The rows are exactly what the source LIST/SEARCH operation answered for this caller — same tenant
21
+ * scope, roles, contextual filters and field stripping — because the export re-runs that operation.
22
+ * A template therefore cannot show more than the caller could read in the listing itself.
23
+ */
24
+ export interface PdfCollectionBuildContextInput<TRow = Record<string, unknown>> {
25
+ /** The exported rows, in the listing's order. */
26
+ rows: readonly TRow[];
27
+ /** The resource the listing belongs to. */
28
+ resourceType: ResourceType;
29
+ /** Execution context of the SOURCE listing: auth, scope and audit attribution. */
30
+ executionContext: ExecutionContext<any>;
31
+ /** Locale chosen for this render. */
32
+ locale: string;
33
+ /** When the export was requested — print it rather than reading the clock inside `body`. */
34
+ generatedAt: Date;
35
+ }
36
+
37
+ /**
38
+ * Backend-only PDF template that renders a WHOLE collection export into one document (#1645).
39
+ *
40
+ * ## Why this is not `PdfTemplateDefinition`
41
+ *
42
+ * A `PdfTemplateDefinition` renders ONE record into a stored file field: its input is the record being
43
+ * created or regenerated. A collection template renders the rows of a listing into a document the
44
+ * caller downloads and nothing stores. Different input, different lifecycle, so a different type; the
45
+ * two share only the renderer.
46
+ *
47
+ * Declared on a LIST/SEARCH operation by `collectionExport: { formats: [PDF], pdfTemplateId }`, and
48
+ * bound at startup through the backend module's `pdfCollectionExportTemplates` slot. The backend
49
+ * refuses to boot when an export names a template nothing provides.
50
+ *
51
+ * @example
52
+ * export const invoicesDigestTemplate = definePdfCollectionTemplate<InvoiceRow, { rows: InvoiceRow[] }>({
53
+ * id: 'my-app.invoices.digest.v1',
54
+ * buildContext: async ({ rows }) => ({ rows: [...rows] }),
55
+ * body: ({ context }) => createElement(Document, null, ...),
56
+ * });
57
+ */
58
+ export interface PdfCollectionTemplateDefinition<TRow = Record<string, unknown>, TContext = unknown> {
59
+ /** Stable id, named by `collectionExport.pdfTemplateId`. */
60
+ id: string;
61
+ /**
62
+ * Optional locale-keyed label maps, resolved exact-locale, then base language, then the first
63
+ * declared locale, and handed to `body()` as one flat map.
64
+ */
65
+ labels?: Record<string, Record<string, string>>;
66
+ /** Build the render context. The only hook intended to perform I/O. */
67
+ buildContext(input: PdfCollectionBuildContextInput<TRow>): Promise<TContext>;
68
+ /** Build the React-PDF document from the context. No I/O here. */
69
+ body(props: { context: TContext; locale: string; labels: Record<string, string> }): ReactElement;
70
+ }
71
+
72
+ /** Authoring helper: keeps the row and context types at the call site; performs no registration. */
73
+ export function definePdfCollectionTemplate<TRow, TContext>(
74
+ template: PdfCollectionTemplateDefinition<TRow, TContext>,
75
+ ): PdfCollectionTemplateDefinition<TRow, TContext> {
76
+ return template;
77
+ }
78
+ ```
79
+
80
+ ## Import Origins
81
+
82
+ - `@wildo-ai/saas-backend-lib`
83
+
84
+ ## Source Excerpts
85
+
86
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
87
+
88
+ ```typescript
89
+ *
90
+ * What one exported row contributes to the governed-documents PDF (#1645), as `resolveSources` answers it.
91
+ *
92
+ * `document` is the content a reader would be shown: the document's release when it has one, else its
93
+ * latest draft — the same `GovernedDocumentPublicDocument` a public page renders. `null` means the
94
+ * document is declared but nothing has been composed for it yet; it still gets a page saying so, because
95
+ * a document that silently drops out of the bundle reads as a document that does not exist.
96
+ */
97
+ export interface GovernedDocumentsPdfSource {
98
+ /** Shown when `document` is null; otherwise the content's own title is used. */
99
+ title: string;
100
+ document: GovernedDocumentPublicDocument | null;
101
+ }
102
+
103
+ /** Where a document stands, as the PDF tells its reader. Derived, never authored. */
104
+ export enum GovernedDocumentsPdfStanding {
105
+ /** A release that has been approved: the published text. */
106
+ RELEASED_APPROVED = 'RELEASED_APPROVED',
107
+ /** A composed release nobody has approved yet: true text, not a published document. */
108
+ RELEASED_UNAPPROVED = 'RELEASED_UNAPPROVED',
109
+ /** A release whose `expiresAt` has passed at the export instant: no longer in force, whatever its approval. */
110
+ RELEASE_EXPIRED = 'RELEASE_EXPIRED',
111
+ /** The latest draft of a document that was never released. */
112
+ UNRELEASED_DRAFT = 'UNRELEASED_DRAFT',
113
+ /** Declared, and nothing composed yet. */
114
+ NOT_COMPOSED = 'NOT_COMPOSED',
115
+ }
116
+
117
+ /** The kinds of text block a clause's markdown is flattened into. */
118
+ export enum PdfTextBlockKind {
119
+ HEADING = 'HEADING',
120
+ PARAGRAPH = 'PARAGRAPH',
121
+ LIST_ITEM = 'LIST_ITEM',
122
+ }
123
+
124
+ export interface PdfTextBlock {
125
+ kind: PdfTextBlockKind;
126
+ text: string;
127
+ /** The item's marker (`•`, `1.`) — present exactly for a list item. */
128
+ marker?: string;
129
+ }
130
+
131
+ /**
132
+ * Flatten a clause's `bodyMarkdown` into text blocks a PDF can lay out.
133
+ *
134
+ * A public document's markdown is rendered as TEXT everywhere (it is never trusted as HTML), so this
135
+ * keeps the structure a reader needs — paragraphs, list items, sub-headings — and drops inline
136
+ * emphasis marks rather than interpreting them. A link keeps its target beside its text, because a
137
+ * printed page cannot be clicked.
138
+ */
139
+ export function markdownToPdfTextBlocks(markdown: string): PdfTextBlock[] {
140
+ const blocks: PdfTextBlock[] = [];
141
+ let paragraph: string[] = [];
142
+ const flushParagraph = () => {
143
+ if (paragraph.length > 0) {
144
+ blocks.push({ kind: PdfTextBlockKind.PARAGRAPH, text: stripInlineMarkdown(paragraph.join(' ')) });
145
+ paragraph = [];
146
+ }
147
+ };
148
+ for (const rawLine of markdown.split(/\r?\n/)) {
149
+ const line = rawLine.trim();
150
+ if (line === '') {
151
+ flushParagraph();
152
+ continue;
153
+ }
154
+ const heading = /^#{1,6}\s+(.*)$/.exec(line);
155
+ if (heading) {
156
+ flushParagraph();
157
+ blocks.push({ kind: PdfTextBlockKind.HEADING, text: stripInlineMarkdown(heading[1]) });
158
+ continue;
159
+ }
160
+ const bullet = /^[-*+]\s+(.*)$/.exec(line);
161
+ const numbered = /^(\d+)[.)]\s+(.*)$/.exec(line);
162
+ if (bullet || numbered) {
163
+ flushParagraph();
164
+ blocks.push(bullet
165
+ ? { kind: PdfTextBlockKind.LIST_ITEM, marker: '•', text: stripInlineMarkdown(bullet[1]) }
166
+ : { kind: PdfTextBlockKind.LIST_ITEM, marker: `${numbered![1]}.`, text: stripInlineMarkdown(numbered![2]) });
167
+ continue;
168
+ }
169
+ paragraph.push(line);
170
+ }
171
+ flushParagraph();
172
+ return blocks;
173
+ }
174
+
175
+ function stripInlineMarkdown(text: string): string {
176
+ return text
177
+ .replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1')
178
+ .replace(/\[([^\]]+)\]\(([^)\s]+)[^)]*\)/g, (_match, label: string, target: string) => (label === target ? label : `${label} (${target})`))
179
+ .replace(/\*\*([^*]+)\*\*/g, '$1')
180
+ .replace(/__([^_]+)__/g, '$1')
181
+ .replace(/\*([^*]+)\*/g, '$1')
182
+ .replace(/`([^`]+)`/g, '$1');
183
+ }
184
+
185
+ interface GovernedDocumentsPdfClause {
186
+ blocks: PdfTextBlock[];
187
+ /** Present exactly when the clause is not yet established: what it still lacks, in the reader's terms. */
188
+ missingInformation?: string;
189
+ }
190
+
191
+ interface GovernedDocumentsPdfEntry {
192
+ title: string;
193
+ standing: GovernedDocumentsPdfStanding;
194
+ /** Release number, effective date and — for an expired one — the day it lapsed. */
195
+ release?: { version: number; effectiveOn: string; expiredOn?: string };
196
+ sections: { title: string; clauses: GovernedDocumentsPdfClause[] }[];
197
+ notYetEstablishedClauseCount: number;
198
+ }
199
+
200
+ export interface GovernedDocumentsPdfContext {
201
+ generatedOn: string;
202
+ entries: GovernedDocumentsPdfEntry[];
203
+ }
204
+
205
+ function toEntry(source: GovernedDocumentsPdfSource, generatedAt: Date): GovernedDocumentsPdfEntry {
206
+ if (source.document === null) {
207
+ return { title: source.title, standing: GovernedDocumentsPdfStanding.NOT_COMPOSED, sections: [], notYetEstablishedClauseCount: 0 };
208
+ }
209
+ // Parsed, not trusted: the schema is what guarantees a marked clause says what it lacks.
210
+ const document = GovernedDocumentPublicDocumentSchema.parse(source.document);
211
+ const sections = document.content.sections.map((section) => ({
212
+ title: section.title,
213
+ clauses: section.clauses.map((clause) => ({
214
+ blocks: markdownToPdfTextBlocks(clause.bodyMarkdown),
215
+ missingInformation: clause.standing === GovernedDocumentPublicClauseStanding.NOT_YET_ESTABLISHED ? clause.missingInformation : undefined,
216
+ })),
217
+ }));
218
+ const notYetEstablishedClauseCount = sections.reduce(
219
+ (count, section) => count + section.clauses.filter((clause) => clause.missingInformation !== undefined).length,
220
+ 0,
221
+ );
222
+ if (document.kind === GovernedDocumentPublicDocumentKind.UNRELEASED_DRAFT) {
223
+ return { title: document.content.title, standing: GovernedDocumentsPdfStanding.UNRELEASED_DRAFT, sections, notYetEstablishedClauseCount };
224
+ }
225
+ // Expiry is judged at the EXPORT instant, the same instant the cover prints, so a file never calls a
226
+ // release current on a day it had already lapsed.
227
+ const expired = document.release.expiresAt !== undefined && Date.parse(document.release.expiresAt) <= generatedAt.getTime();
228
+ return {
229
+ title: document.content.title,
230
+ standing: expired
231
+ ? GovernedDocumentsPdfStanding.RELEASE_EXPIRED
232
+ : document.approvalState === GovernedDocumentReleaseApprovalState.APPROVED
233
+ ? GovernedDocumentsPdfStanding.RELEASED_APPROVED
234
+ : GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED,
235
+ release: {
236
+ version: document.release.identity.releaseVersion,
237
+ effectiveOn: document.release.effectiveAt.slice(0, 10),
238
+ ...(expired ? { expiredOn: document.release.expiresAt!.slice(0, 10) } : {}),
239
+ },
240
+ sections,
241
+ notYetEstablishedClauseCount,
242
+ };
243
+ }
244
+
245
+ /**
246
+ * The words of the governed-documents PDF, per locale. A key missing from the resolved map renders as
247
+ * the key itself, so an unauthored label looks unauthored rather than borrowing invented text.
248
+ */
249
+ export const GOVERNED_DOCUMENTS_PDF_LABELS: Record<string, Record<string, string>> = {
250
+ en: {
251
+ coverEyebrow: 'Governed documents',
252
+ coverTitle: 'Compliance documents',
253
+ generatedOn: 'Generated on {date}',
254
+ documentCount: 'Documents in this file: {count}',
255
+ contents: 'Contents',
256
+ empty: 'This application has no governed documents.',
257
+ [GovernedDocumentsPdfStanding.RELEASED_APPROVED]: 'Release {version}, effective {date}',
258
+ [GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED]: 'Release {version}, effective {date} — not approved',
259
+ [GovernedDocumentsPdfStanding.RELEASE_EXPIRED]: 'Release {version}, expired {expiredDate}',
260
+ [GovernedDocumentsPdfStanding.UNRELEASED_DRAFT]: 'Draft — never released',
261
+ [GovernedDocumentsPdfStanding.NOT_COMPOSED]: 'Not composed yet',
262
+ unapprovedNotice: 'This release has not been approved. It is not a published document.',
263
+ expiredNotice: 'This release has expired. It is no longer in force.',
264
+ draftNotice: 'This document is a draft. It has never been released and is not in force.',
265
+ notComposedNotice: 'Nothing has been composed for this document yet.',
266
+ incompleteNotice: 'Clauses not yet established: {count}',
267
+ notYetEstablished: 'Not yet established: {detail}',
268
+ page: 'Page {page} of {total}',
269
+ },
270
+ fr: {
271
+ coverEyebrow: 'Documents gouvernés',
272
+ coverTitle: 'Documents de conformité',
273
+ generatedOn: 'Généré le {date}',
274
+ documentCount: 'Documents dans ce fichier : {count}',
275
+ contents: 'Sommaire',
276
+ empty: "Cette application n'a aucun document gouverné.",
277
+ [GovernedDocumentsPdfStanding.RELEASED_APPROVED]: 'Version publiée {version}, en vigueur le {date}',
278
+ [GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED]: 'Version publiée {version}, en vigueur le {date} — non approuvée',
279
+ [GovernedDocumentsPdfStanding.RELEASE_EXPIRED]: 'Version publiée {version}, expirée le {expiredDate}',
280
+ [GovernedDocumentsPdfStanding.UNRELEASED_DRAFT]: 'Brouillon — jamais publié',
281
+ [GovernedDocumentsPdfStanding.NOT_COMPOSED]: 'Pas encore rédigé',
282
+ unapprovedNotice: "Cette version n'a pas été approuvée. Ce n'est pas un document publié.",
283
+ expiredNotice: "Cette version a expiré. Elle n'est plus en vigueur.",
284
+ draftNotice: "Ce document est un brouillon. Il n'a jamais été publié et n'est pas en vigueur.",
285
+ notComposedNotice: "Rien n'a encore été rédigé pour ce document.",
286
+ incompleteNotice: 'Clauses pas encore établies : {count}',
287
+ notYetEstablished: 'Pas encore établi : {detail}',
288
+ page: 'Page {page} sur {total}',
289
+ },
290
+ };
291
+
292
+ function word(labels: Record<string, string>, key: string, params: Record<string, string | number> = {}): string {
293
+ const template = labels[key] ?? key;
294
+ return template.replace(/\{(\w+)\}/g, (match, name: string) => (name in params ? String(params[name]) : match));
295
+ }
296
+
297
+ function standingLine(entry: GovernedDocumentsPdfEntry, labels: Record<string, string>): string {
298
+ return word(labels, entry.standing, entry.release
299
+ ? { version: entry.release.version, date: entry.release.effectiveOn, expiredDate: entry.release.expiredOn ?? '' }
300
+ : {});
301
+ }
302
+
303
+ const NOTICE_BY_STANDING: Partial<Record<GovernedDocumentsPdfStanding, string>> = {
304
+ [GovernedDocumentsPdfStanding.RELEASED_UNAPPROVED]: 'unapprovedNotice',
305
+ [GovernedDocumentsPdfStanding.RELEASE_EXPIRED]: 'expiredNotice',
306
+ [GovernedDocumentsPdfStanding.UNRELEASED_DRAFT]: 'draftNotice',
307
+ [GovernedDocumentsPdfStanding.NOT_COMPOSED]: 'notComposedNotice',
308
+ };
309
+
310
+ const styles = StyleSheet.create({
311
+ // No `lineHeight` here: set on the PAGE it is inherited by the fixed footer, and React-PDF 4.5 then
312
+ // drops a `render`-prop Text entirely — the page numbers vanish with no error. Measured; it is set on
313
+ // the text styles below instead.
314
+ page: { paddingTop: 48, paddingBottom: 56, paddingHorizontal: 48, fontSize: 10.5, fontFamily: 'Helvetica', color: '#111827' },
315
+ eyebrow: { fontSize: 9, textTransform: 'uppercase', color: '#6b7280', marginBottom: 6 },
316
+ coverTitle: { fontSize: 26, fontFamily: 'Helvetica-Bold', marginBottom: 10 },
317
+ meta: { fontSize: 10, color: '#4b5563', marginBottom: 2 },
318
+ contentsHeading: { fontSize: 13, fontFamily: 'Helvetica-Bold', marginTop: 28, marginBottom: 10 },
319
+ contentsRow: { flexDirection: 'row', marginBottom: 6 },
320
+ contentsNumber: { width: 24, color: '#6b7280' },
321
+ contentsTitle: { flex: 1 },
322
+ contentsStanding: { fontSize: 9, color: '#6b7280' },
323
+ documentTitle: { fontSize: 18, fontFamily: 'Helvetica-Bold', marginBottom: 4 },
324
+ standing: { fontSize: 10, color: '#4b5563', marginBottom: 10 },
325
+ notice: { padding: 8, marginBottom: 12, lineHeight: 1.4, backgroundColor: '#fef3c7', color: '#78350f', fontSize: 10 },
326
+ sectionTitle: { fontSize: 13, fontFamily: 'Helvetica-Bold', marginTop: 14, marginBottom: 6 },
327
+ clause: { marginBottom: 8 },
328
+ heading: { fontFamily: 'Helvetica-Bold', marginTop: 4, marginBottom: 2 },
329
+ paragraph: { marginBottom: 4, lineHeight: 1.45 },
330
+ listItem: { flexDirection: 'row', marginBottom: 2, paddingLeft: 8 },
331
+ listMarker: { width: 16 },
332
+ listText: { flex: 1, lineHeight: 1.45 },
333
+ missing: { marginTop: 2, padding: 6, lineHeight: 1.4, borderLeftWidth: 2, borderLeftColor: '#d97706', backgroundColor: '#fffbeb', fontSize: 9.5, color: '#78350f' },
334
+ footer: { position: 'absolute', bottom: 24, left: 48, right: 48, fontSize: 8.5, color: '#9ca3af', textAlign: 'right' },
335
+ });
336
+
337
+ function footer(labels: Record<string, string>): ReactElement {
338
+ return createElement(Text, {
339
+ style: styles.footer,
340
+ fixed: true,
341
+ render: ({ pageNumber, totalPages }: { pageNumber: number; totalPages: number }) => word(labels, 'page', { page: pageNumber, total: totalPages }),
342
+ });
343
+ }
344
+
345
+ function renderBlock(block: PdfTextBlock, key: number): ReactNode {
346
+ if (block.kind === PdfTextBlockKind.LIST_ITEM) {
347
+ return createElement(View, { key, style: styles.listItem },
348
+ createElement(Text, { style: styles.listMarker }, block.marker ?? ''),
349
+ createElement(Text, { style: styles.listText }, block.text));
350
+ }
351
+ return createElement(Text, { key, style: block.kind === PdfTextBlockKind.HEADING ? styles.heading : styles.paragraph }, block.text);
352
+ }
353
+
354
+ function coverPage(context: GovernedDocumentsPdfContext, labels: Record<string, string>): ReactElement {
355
+ const contents = context.entries.length === 0
356
+ ? [createElement(Text, { key: 'empty', style: styles.meta }, word(labels, 'empty'))]
357
+ : context.entries.map((entry, index) =>
358
+ createElement(View, { key: index, style: styles.contentsRow, wrap: false },
359
+ createElement(Text, { style: styles.contentsNumber }, `${index + 1}.`),
360
+ createElement(View, { style: styles.contentsTitle },
361
+ createElement(Text, null, entry.title),
362
+ createElement(Text, { style: styles.contentsStanding }, standingLine(entry, labels)))));
363
+ return createElement(Page, { size: 'A4', style: styles.page },
364
+ createElement(Text, { style: styles.eyebrow }, word(labels, 'coverEyebrow')),
365
+ createElement(Text, { style: styles.coverTitle }, word(labels, 'coverTitle')),
366
+ createElement(Text, { style: styles.meta }, word(labels, 'generatedOn', { date: context.generatedOn })),
367
+ createElement(Text, { style: styles.meta }, word(labels, 'documentCount', { count: context.entries.length })),
368
+ createElement(Text, { style: styles.contentsHeading }, word(labels, 'contents')),
369
+ ...contents,
370
+ footer(labels));
371
+ }
372
+
373
+ function documentPage(entry: GovernedDocumentsPdfEntry, index: number, labels: Record<string, string>): ReactElement {
374
+ const noticeKey = NOTICE_BY_STANDING[entry.standing];
375
+ return createElement(Page, { key: index, size: 'A4', style: styles.page, wrap: true },
376
+ createElement(Text, { style: styles.eyebrow }, `${index + 1}.`),
377
+ createElement(Text, { style: styles.documentTitle }, entry.title),
378
+ createElement(Text, { style: styles.standing }, standingLine(entry, labels)),
379
+ noticeKey ? createElement(Text, { style: styles.notice }, word(labels, noticeKey)) : null,
380
+ entry.notYetEstablishedClauseCount > 0
381
+ ? createElement(Text, { style: styles.notice }, word(labels, 'incompleteNotice', { count: entry.notYetEstablishedClauseCount }))
382
+ : null,
383
+ ...entry.sections.map((section, sectionIndex) =>
384
+ createElement(View, { key: sectionIndex },
385
+ createElement(Text, { style: styles.sectionTitle, minPresenceAhead: 40 }, section.title),
386
+ ...section.clauses.map((clause, clauseIndex) =>
387
+ createElement(View, { key: clauseIndex, style: styles.clause },
388
+ ...clause.blocks.map(renderBlock),
389
+ clause.missingInformation !== undefined
390
+ ? createElement(Text, { style: styles.missing }, word(labels, 'notYetEstablished', { detail: clause.missingInformation }))
391
+ : null)))),
392
+ footer(labels));
393
+ }
394
+
395
+ /**
396
+ * The engine's governed-documents PDF: a cover with contents, then one section per document with its
397
+ * standing, its release line, and every clause — each not-yet-established clause marked with what it
398
+ * still lacks (#1645).
399
+ *
400
+ * The standing is the first thing under each title on purpose. A reviewer handed this file must not be
401
+ * able to mistake a draft, or an unapproved release, for the application's published text; the same
402
+ * rule the public pages follow (`GovernedDocumentPublicDocumentKind.UNRELEASED_DRAFT` "must SAY it is
403
+ * a draft").
404
+ *
405
+ * Bound like any collection-export template: a LIST export declares
406
+ * `collectionExport: { formats: [ResourceCollectionExportFormat.PDF], pdfTemplateId: <id> }` and the
407
+ * backend module lists the template in `pdfCollectionExportTemplates`.
408
+ *
409
+ * ## The rows name documents; `resolveSources` fetches their text
410
+ *
411
+ * The listing a caller exports decides WHICH documents are printed — its scope, filters and order. Their
412
+ * text is resolved here, once for all rows, rather than carried on every row, because a document's full
413
+ * text is large and a listing is read far more often than it is printed. `resolveSources` must answer
414
+ * one source per row, in row order; a mismatch is refused rather than printed misaligned.
415
+ *
416
+ * @example
417
+ * export const governedDocumentsPdfTemplate = createGovernedDocumentsPdfTemplate<GovernedDocumentRow>({
418
+ * id: 'my-app.governed-documents.v1',
419
+ * resolveSources: async ({ rows }) => rows.map((row) => ({ title: row.title, document: textsByRef.get(row.ref) ?? null })),
420
+ * });
421
+ */
422
+ export function createGovernedDocumentsPdfTemplate<TRow>(options: {
423
+ id: string;
424
+ resolveSources: (input: PdfCollectionBuildContextInput<TRow>) => Promise<readonly GovernedDocumentsPdfSource[]>;
425
+ labels?: Record<string, Record<string, string>>;
426
+ }): PdfCollectionTemplateDefinition<TRow, GovernedDocumentsPdfContext> {
427
+ return {
428
+ id: options.id,
429
+ labels: options.labels ?? GOVERNED_DOCUMENTS_PDF_LABELS,
430
+ async buildContext(input) {
431
+ const sources = await options.resolveSources(input);
432
+ if (sources.length !== input.rows.length) {
433
+ throw new Error(`The governed-documents PDF resolved ${sources.length} document(s) for ${input.rows.length} exported row(s); it prints one per row.`);
434
+ }
435
+ return {
436
+ generatedOn: input.generatedAt.toISOString().slice(0, 10),
437
+ entries: sources.map((source) => toEntry(source, input.generatedAt)),
438
+ };
439
+ },
440
+ body({ context, labels }) {
441
+ return createElement(Document, null,
442
+ coverPage(context, labels),
443
+ ...context.entries.map((entry, index) => documentPage(entry, index, labels)));
444
+ },
445
+ };
446
+ }
447
+ ```
@@ -0,0 +1,207 @@
1
+ ---
2
+ name: provider-address-lookup
3
+ description: Let people fill an address field by searching for their address (Google Places), or add another vendor's address lookup. Every `z_address()` field offers the lookup once a provider is enabled; the vendor is reached only through the application backend. Use when the user says "add address autocomplete", "let users search for their address", "fill the address from Google Places", "address suggestions", "Google Maps address lookup", "the address search says it is unavailable", "PROVIDER_OPERATION_RATE_LIMITED on the address search", or "add a Loqate / Mapbox address lookup".
4
+ user-invocable: false
5
+ ---
6
+
7
+ # Address Lookup Provider
8
+
9
+ ### Target Application Framing
10
+
11
+ This knowledge is for configuring behavior in the target application.
12
+ Wildo is the framework surface being used, not the product being built.
13
+
14
+ Read and apply these patterns from the application-developer point of view:
15
+
16
+ - how the application should configure the relevant app-level file
17
+ - how the application should use framework-provided factories, enums, and helpers
18
+ - how the application should avoid mixing frontend, backend, and infrastructure concerns
19
+
20
+
21
+ ## Overview
22
+
23
+ A field declared with `z_address()` renders one input per address part. When a `FRONTEND_ADDRESS_LOOKUP`
24
+ provider is enabled, the same field also shows a search box above the parts: the person types part of their
25
+ address, picks a suggestion, and the parts fill in, still editable. With no provider, or when the lookup fails,
26
+ the field is the plain multi-part control and nothing blocks the form.
27
+
28
+ The framework ships one lookup provider, `google-places` (Places API (New)). The vendor is NEVER called from the
29
+ page: each suggestion and the final retrieval run on the application backend through the provider-operation door,
30
+ with the application's server key. The page holds no key, loads no Google script, and needs no CSP origin.
31
+
32
+ ## App Paths
33
+
34
+ | Surface | Glob (relative to app root) |
35
+ |---|---|
36
+ | The address field | `shared-lib/src/**/resources/**/*.schemas.ts` → `z_address()` |
37
+ | Backend scope + the two browser operations | `wildo.saas.config.ts` → `providers.scopes.backend.providers['google-places']`, `providers.browserOperations['google-places']` |
38
+ | Frontend scope | `wildo.saas.config.ts` → `providers.scopes.frontendServices.app.providers['google-places']` |
39
+ | The server key | `infrastructure/**/secrets/secrets.json` → `GOOGLE_PLACES_API_KEY` |
40
+
41
+ ## When to Use
42
+
43
+ - An address field should offer address search.
44
+ - The address search shows "unavailable", or answers `PROVIDER_OPERATION_REFUSED` / `PROVIDER_OPERATION_RATE_LIMITED`.
45
+ - A vendor other than Google must power the lookup.
46
+
47
+ ## When NOT to Use
48
+
49
+ - Declaring the address field itself — `resource-schema-authoring` (`z_address()`).
50
+ - Calling some other provider operation from a component — `provider-operation-calls`.
51
+ - A file picker or another component that must run vendor code in the page — `provider-frontend-file-picker`.
52
+
53
+ ## Workflow
54
+
55
+ ### Step 1 — Enable Google Places on both scopes
56
+
57
+ Add `google-places` to the backend scope (`providerCapabilities: ['FRONTEND_ADDRESS_LOOKUP']`,
58
+ `protocols: ['REST_API']`) and to the application's frontend scope (`providerCapabilities:
59
+ ['FRONTEND_ADDRESS_LOOKUP']`, `protocols: []`). Read `references/google-places-setup.md`.
60
+
61
+ ### Step 2 — Supply a SERVER key
62
+
63
+ Set `GOOGLE_PLACES_API_KEY`. Restrict it in Google Cloud to Places API (New) and to the backend's IP addresses,
64
+ never to an HTTP referrer: it never reaches a browser. Do not put a key in the frontend provider's public
65
+ configuration; its schema declares no key and refuses one.
66
+
67
+ ### Step 3 — Open the two operations to browsers
68
+
69
+ Declare `address_suggest` and `address_retrieve` under `providers.browserOperations['google-places']` on the
70
+ application's own connection, with `allowedRoles` (required for the application's account). Every call is also
71
+ counted per person: the framework default is 60 a minute and 1000 an hour; declare `callerRateLimit` to change it.
72
+ Read `references/framework-browser-operation-policy-api.md`. Run `wildo config sync`.
73
+
74
+ ### Step 4 — Check what fills the field
75
+
76
+ Nothing else to wire: `FormField` mounts the lookup in every `z_address()` field's `renderLookup` slot. A chosen
77
+ place fills the text parts and the country only; coordinates are never filled from a lookup and no vendor id is
78
+ stored. An address the field refuses (a country outside `countriesAllowed`) fills nothing and says so. Read
79
+ `references/framework-address-field-lookup-slot-api.md`.
80
+
81
+ ### Step 5 — Another vendor: write an adapter, declare its operations
82
+
83
+ Author the vendor's backend operations (a suggest and a retrieve, each `remoteCallSemantics` with one attempt and
84
+ a short timeout), then a frontend module whose `FRONTEND_ADDRESS_LOOKUP` component declares `addressLookup`
85
+ (the two operation ids, the session-token input, the attribution) and a component that renders
86
+ `ProviderAddressLookupCombobox` with your `ProviderAddressLookupAdapter`. Read
87
+ `references/framework-address-lookup-contract-api.md`, then stop.
88
+
89
+ ## Worked Example
90
+
91
+ Google's adapter — the four functions the framework's lookup combobox runs. The request shapes follow the two
92
+ backend operations; the answer mapping reads Google's structured `postalAddress`, never a formatted string:
93
+
94
+
95
+ ## Usage Example
96
+
97
+ ```typescript
98
+ export const GOOGLE_PLACES_ADDRESS_LOOKUP_ADAPTER: ProviderAddressLookupAdapter = {
99
+ buildSuggestInput({ query, countriesAllowed, languageCode }) {
100
+ const regions = countriesAllowed !== undefined && countriesAllowed.length > 0 && countriesAllowed.length <= GOOGLE_PLACES_MAX_INCLUDED_REGION_CODES
101
+ ? countriesAllowed.map((code) => code.toLowerCase())
102
+ : undefined;
103
+ return {
104
+ input: query,
105
+ languageCode,
106
+ ...(regions !== undefined ? { includedRegionCodes: regions } : {}),
107
+ };
108
+ },
109
+
110
+ readSuggestions(output) {
111
+ if (!isRecord(output)) throw new GooglePlacesAnswerUnreadableError('suggestion list');
112
+ const raw = output.suggestions;
113
+ if (raw === undefined) return [];
114
+ if (!Array.isArray(raw)) throw new GooglePlacesAnswerUnreadableError('suggestion list');
115
+ const suggestions: ProviderAddressLookupSuggestion[] = [];
116
+ for (const entry of raw) {
117
+ // A `queryPrediction` (a search phrase rather than a place) is not requested and cannot be retrieved: skipped.
118
+ const prediction = isRecord(entry) ? entry.placePrediction : undefined;
119
+ if (!isRecord(prediction) || typeof prediction.placeId !== 'string' || prediction.placeId === '') continue;
120
+ const structured = isRecord(prediction.structuredFormat) ? prediction.structuredFormat : undefined;
121
+ const primaryText = textOf(structured?.mainText) ?? textOf(prediction.text);
122
+ if (primaryText === undefined) continue;
123
+ const secondaryText = textOf(structured?.secondaryText);
124
+ suggestions.push({ id: prediction.placeId, primaryText, ...(secondaryText !== undefined ? { secondaryText } : {}) });
125
+ }
126
+ return suggestions;
127
+ },
128
+
129
+ buildRetrieveInput({ suggestion, languageCode }) {
130
+ return { placeId: suggestion.id, languageCode };
131
+ },
132
+
133
+ readAddress(output): AddressValue | undefined {
134
+ if (!isRecord(output)) throw new GooglePlacesAnswerUnreadableError('place');
135
+ const postal = output.postalAddress;
136
+ if (postal === undefined) return undefined;
137
+ if (!isRecord(postal)) throw new GooglePlacesAnswerUnreadableError('postal address');
138
+ const lines = Array.isArray(postal.addressLines) ? postal.addressLines.map(nonEmpty).filter((line): line is string => line !== undefined) : [];
139
+ const country = nonEmpty(postal.regionCode)?.toUpperCase();
140
+ const [line1, ...rest] = lines;
141
+ const city = nonEmpty(postal.locality) ?? nonEmpty(postal.sublocality);
142
+ if (line1 === undefined || city === undefined || country === undefined) return undefined;
143
+ const state = nonEmpty(postal.administrativeArea);
144
+ const postalCode = nonEmpty(postal.postalCode);
145
+ return {
146
+ line1,
147
+ ...(rest.length > 0 ? { line2: rest.join(', ') } : {}),
148
+ city,
149
+ ...(state !== undefined ? { state } : {}),
150
+ ...(postalCode !== undefined ? { postalCode } : {}),
151
+ country,
152
+ };
153
+ },
154
+ };
155
+ ```
156
+
157
+ - `buildSuggestInput` restricts to the field's countries only when Google can (15 at most); the field validates
158
+ the country anyway.
159
+ - There is no session token here: the host writes it into the declared input on every call.
160
+ - `readAddress` answers `undefined` for a place the field cannot hold, and the host says the place cannot be used.
161
+
162
+ ## References
163
+
164
+ - `references/google-places-setup.md` — the complete configuration, the key restrictions, and what Google's terms allow
165
+ - `references/framework-address-lookup-contract-api.md` — the component props, the adapter, the `addressLookup` declaration (source-backed)
166
+ - `references/framework-address-field-lookup-slot-api.md` — the field's `renderLookup` slot and `applyAddress` (source-backed)
167
+ - `references/framework-browser-operation-policy-api.md` — `providers.browserOperations`, including `callerRateLimit` (source-backed)
168
+
169
+ ## Verification
170
+
171
+ - [ ] `google-places` is on the backend scope AND the frontend scope
172
+ - [ ] `GOOGLE_PLACES_API_KEY` is set as a secret, and no Google key appears in frontend code or public configuration
173
+ - [ ] `address_suggest` and `address_retrieve` are both in `providers.browserOperations['google-places']` with `allowedRoles`
174
+ - [ ] No component calls a Google host directly
175
+ - [ ] No resource stores a vendor place id or a lookup geocode
176
+
177
+ ### Grep invariants
178
+
179
+ | Invariant | Command |
180
+ |---|---|
181
+ | Both operations opened | `rg -n "address_suggest\|address_retrieve" wildo.saas.config.ts` (both present) |
182
+ | No Google key in the frontend | `rg -n "AIza\|GOOGLE_PLACES_API_KEY" frontend/src` (must be empty) |
183
+ | No direct vendor call | `rg -n "places.googleapis.com\|maps.googleapis.com" frontend/src` (must be empty) |
184
+ | No stored place id | `rg -in "placeId" shared-lib/src` (must be empty) |
185
+
186
+ ## Common Rationalizations
187
+
188
+ | Rationalization | Reality |
189
+ |---|---|
190
+ | "A browser key restricted by referrer is fine" | It is still a published key. The lookup runs on the backend, so there is nothing for a browser key to do. |
191
+ | "Store the place id so we can refresh the address later" | The framework never stores a vendor id; the saved value is the address the person confirmed. |
192
+ | "Fill the coordinates too, Google returns them" | A stored coordinate never expires, while a lookup's geocode may be kept for a limited time at best, and nothing would delete it on the vendor's clock. Coordinates are entered by hand or not at all. |
193
+ | "Throttle the typing in the component" | The door counts every call per person, in the application's store, for every process. |
194
+ | "Hide the Google Maps line, it clutters the form" | Google requires it wherever its suggestions appear without a Google map, inside the same container as the suggestions. The lookup shows it there; do not remove it. |
195
+
196
+ ## Red Flags
197
+
198
+ - A Google key in frontend code or a public config (catch with the **no Google key** grep)
199
+ - A component `fetch` to a Google host (catch with the **no direct vendor call** grep)
200
+ - Only one of the two operations opened: the search works and choosing does nothing (catch with the **both operations** grep)
201
+ - A `placeId` field on a resource (catch with the **no stored place id** grep)
202
+
203
+ ## Related Skills
204
+
205
+ - `resource-schema-authoring` — declaring `z_address()` and its `countriesAllowed`
206
+ - `provider-operation-calls` — the door the lookup runs through, and its refusals
207
+ - `provider-frontend-file-picker` — how any provider component loads, and consent