@wildo-ai/framework-knowledge 1.1.4 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1167) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
  3. package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
  4. package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
  5. package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
  8. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
  9. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
  10. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
  11. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
  12. package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
  14. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
  15. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
  17. package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
  18. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
  19. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
  20. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
  21. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
  22. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  23. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  24. package/dist/esm/framework-knowledge.definitions.js +547 -17
  25. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  26. package/dist/esm/framework-knowledge.loader.d.ts +19 -0
  27. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  28. package/dist/esm/framework-knowledge.loader.js +47 -1
  29. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  30. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  31. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  32. package/dist/esm/index.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  34. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
  36. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +135 -0
  38. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
  40. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
  42. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +374 -11
  44. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  45. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +6 -4
  46. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +22 -20
  48. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
  52. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
  54. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
  55. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
  56. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
  57. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
  58. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
  59. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
  60. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
  61. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
  62. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
  63. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
  64. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
  65. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
  66. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +18 -8
  68. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
  70. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
  71. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
  72. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
  73. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
  74. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
  76. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  77. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +68 -0
  78. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
  79. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
  80. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
  81. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
  82. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
  84. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
  86. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  88. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +78 -0
  90. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
  94. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
  95. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
  96. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
  97. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
  98. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
  99. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
  100. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
  101. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
  102. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
  103. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
  104. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
  105. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
  106. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
  107. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
  108. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
  109. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
  110. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  111. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
  112. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  113. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
  114. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  115. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
  116. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  117. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
  118. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
  119. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
  120. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
  121. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
  122. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
  123. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
  124. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
  125. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
  126. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  127. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
  128. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  129. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
  130. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  131. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
  132. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  133. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
  134. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  135. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
  136. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +6 -4
  138. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
  140. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +193 -28
  142. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  143. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
  144. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +3 -2
  146. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
  148. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  149. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +183 -6
  150. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
  152. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  153. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +3 -2
  154. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  155. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
  156. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  157. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +173 -0
  158. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
  159. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
  160. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
  161. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
  162. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
  163. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
  164. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
  165. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
  166. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
  167. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
  168. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
  169. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
  170. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  171. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
  172. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  173. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
  174. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  175. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
  176. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  177. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
  178. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  179. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
  180. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  181. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
  182. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  183. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -4
  184. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  185. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +33 -5
  186. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  187. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
  188. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  189. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -3
  190. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  191. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
  192. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  193. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
  194. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
  195. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
  196. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
  197. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
  198. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  199. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
  200. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  201. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
  202. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  203. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -5
  204. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  205. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +7 -6
  206. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  207. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +28 -19
  208. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  209. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  210. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
  211. package/dist/knowledge/manifest.json +9 -8
  212. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
  213. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
  214. package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
  215. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
  216. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
  217. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
  218. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
  219. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
  220. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
  221. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
  222. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
  223. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
  224. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
  225. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
  226. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
  227. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
  228. package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
  229. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
  230. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
  231. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
  232. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
  233. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
  234. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
  235. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
  236. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
  237. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
  238. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
  239. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
  240. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
  241. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
  244. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
  245. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
  246. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
  247. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
  248. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
  249. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
  250. package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
  251. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
  252. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
  253. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
  254. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
  255. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
  256. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
  257. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
  258. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
  259. package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
  260. package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
  261. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
  262. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
  263. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
  264. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
  265. package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
  266. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
  267. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
  268. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
  269. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
  270. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
  271. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
  272. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
  273. package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
  274. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
  275. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
  276. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
  277. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
  278. package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
  279. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
  280. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
  281. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
  282. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
  283. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
  284. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
  285. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
  286. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
  287. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
  288. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
  289. package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
  290. package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
  291. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
  292. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
  293. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
  294. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
  295. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
  296. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
  297. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  298. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
  299. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  300. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
  301. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
  302. package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
  303. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
  304. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
  305. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  306. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  307. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
  308. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
  309. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
  310. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
  311. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
  312. package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
  313. package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
  314. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
  315. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
  316. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
  317. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
  318. package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
  319. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
  320. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
  321. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
  322. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
  323. package/dist/knowledge/references/acp.execution-profile.md +266 -0
  324. package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
  325. package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
  326. package/dist/knowledge/references/acp.permission-escalation.md +37 -0
  327. package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
  328. package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
  329. package/dist/knowledge/references/application-maturity.config.md +319 -0
  330. package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
  331. package/dist/knowledge/references/assertions.specification.config.md +1 -1
  332. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
  333. package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
  334. package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
  335. package/dist/knowledge/references/brand.asset.config.md +8 -16
  336. package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
  337. package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
  338. package/dist/knowledge/references/brand.snapshot.config.md +16 -2
  339. package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
  340. package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
  341. package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
  342. package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
  343. package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
  344. package/dist/knowledge/references/capability-composition.config.md +174 -0
  345. package/dist/knowledge/references/cli.market.generate-command.md +18 -2
  346. package/dist/knowledge/references/cli.market.utils.md +1 -0
  347. package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
  348. package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
  349. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
  350. package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
  351. package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
  352. package/dist/knowledge/references/engine.saas-website.config.md +22 -10
  353. package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
  354. package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
  355. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
  356. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
  357. package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
  358. package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
  359. package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
  360. package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
  361. package/dist/knowledge/references/example.config.design-system.full.md +3 -0
  362. package/dist/knowledge/references/example.config.navigation.full.md +45 -2
  363. package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
  364. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
  365. package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
  366. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
  367. package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
  368. package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
  369. package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
  370. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
  371. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
  372. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
  373. package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
  374. package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
  375. package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
  376. package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
  377. package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
  378. package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
  379. package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
  380. package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
  381. package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
  382. package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
  383. package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
  384. package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
  385. package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
  386. package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
  387. package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
  388. package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
  389. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
  390. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
  391. package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
  392. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
  393. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
  394. package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
  395. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
  396. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
  397. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
  398. package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
  399. package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
  400. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
  401. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
  402. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
  403. package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
  404. package/dist/knowledge/references/example.website.page.manifest.md +30 -0
  405. package/dist/knowledge/references/example.worker.node-route.md +94 -0
  406. package/dist/knowledge/references/experience-plan.config.md +318 -0
  407. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
  408. package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
  409. package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
  410. package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
  411. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
  412. package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
  413. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
  414. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
  415. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
  416. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
  417. package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
  418. package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
  419. package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
  420. package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
  421. package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
  422. package/dist/knowledge/references/integration-plan.config.md +217 -0
  423. package/dist/knowledge/references/market.alternative.config.md +2 -2
  424. package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
  425. package/dist/knowledge/references/market.buying-journey.config.md +1 -1
  426. package/dist/knowledge/references/market.category.config.md +1 -1
  427. package/dist/knowledge/references/market.channel.config.md +4 -4
  428. package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
  429. package/dist/knowledge/references/market.gain.config.md +2 -2
  430. package/dist/knowledge/references/market.icp.config.md +3 -3
  431. package/dist/knowledge/references/market.job.config.md +2 -2
  432. package/dist/knowledge/references/market.message-template.config.md +3 -3
  433. package/dist/knowledge/references/market.objection.config.md +2 -2
  434. package/dist/knowledge/references/market.pain.config.md +2 -2
  435. package/dist/knowledge/references/market.persona.config.md +3 -3
  436. package/dist/knowledge/references/market.positioning.config.md +1 -1
  437. package/dist/knowledge/references/market.proof.config.md +2 -2
  438. package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
  439. package/dist/knowledge/references/market.snapshot.validation.md +15 -0
  440. package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
  441. package/dist/knowledge/references/market.trigger.config.md +2 -2
  442. package/dist/knowledge/references/minions.tick-contract.md +83 -0
  443. package/dist/knowledge/references/placement-plan.config.md +375 -0
  444. package/dist/knowledge/references/platform.config.application-database.md +5 -2
  445. package/dist/knowledge/references/platform.config.backing-services.md +15 -36
  446. package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
  447. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
  448. package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
  449. package/dist/knowledge/references/platform.config.saas.md +261 -9
  450. package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
  451. package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
  452. package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
  453. package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
  454. package/dist/knowledge/references/presets.models.shell-region.md +47 -0
  455. package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
  456. package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
  457. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
  458. package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
  459. package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
  460. package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
  461. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
  462. package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
  463. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
  464. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  465. package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
  466. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
  467. package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
  468. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
  469. package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
  470. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
  471. package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
  472. package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
  473. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
  474. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
  475. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
  476. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
  477. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
  478. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
  479. package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
  480. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
  481. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
  482. package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
  483. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
  484. package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
  485. package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
  486. package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
  487. package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
  488. package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
  489. package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
  490. package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
  491. package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
  492. package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
  493. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
  494. package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
  495. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
  496. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
  497. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
  498. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
  499. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
  500. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
  501. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
  502. package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
  503. package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
  504. package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
  505. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
  506. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
  507. package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
  508. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
  509. package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
  510. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
  511. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
  512. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
  513. package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
  514. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
  515. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
  516. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
  517. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
  518. package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
  519. package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
  520. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
  521. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
  522. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
  523. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
  524. package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
  525. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
  526. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
  527. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
  528. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
  529. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
  530. package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
  531. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
  532. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
  533. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
  534. package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
  535. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
  536. package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
  537. package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
  538. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
  539. package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
  540. package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
  541. package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
  542. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
  543. package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
  544. package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
  545. package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
  546. package/dist/knowledge/references/saas.models.config.registration.md +188 -0
  547. package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
  548. package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
  549. package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
  550. package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
  551. package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
  552. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
  553. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
  554. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
  555. package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
  556. package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
  557. package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
  558. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
  559. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
  560. package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
  561. package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
  562. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
  563. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
  564. package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
  565. package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
  566. package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
  567. package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
  568. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
  569. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
  570. package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
  571. package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
  572. package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
  573. package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
  574. package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
  575. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
  576. package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
  577. package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
  578. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
  579. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
  580. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
  581. package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
  582. package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
  583. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
  584. package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
  585. package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
  586. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
  587. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
  588. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
  589. package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
  590. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
  591. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
  592. package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
  593. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
  594. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
  595. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
  596. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
  597. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
  598. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
  599. package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
  600. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
  601. package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
  602. package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
  603. package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
  604. package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
  605. package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
  606. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
  607. package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
  608. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
  609. package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
  610. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
  611. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
  612. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
  613. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
  614. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
  615. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
  616. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
  617. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
  618. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
  619. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
  620. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
  621. package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
  622. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
  623. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
  624. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
  625. package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
  626. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
  627. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
  628. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
  629. package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
  630. package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
  631. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
  632. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
  633. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
  634. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
  635. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
  636. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
  637. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
  638. package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
  639. package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
  640. package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
  641. package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
  642. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
  643. package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
  644. package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
  645. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
  646. package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
  647. package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
  648. package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
  649. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
  650. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
  651. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
  652. package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
  653. package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
  654. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
  655. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
  656. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
  657. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
  658. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
  659. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
  660. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
  661. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
  662. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
  663. package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
  664. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
  665. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
  666. package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
  667. package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
  668. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
  669. package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
  670. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
  671. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
  672. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
  673. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
  674. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
  675. package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
  676. package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
  677. package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
  678. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
  679. package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
  680. package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
  681. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
  682. package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
  683. package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
  684. package/dist/knowledge/references/saas.website.consent.context.md +162 -0
  685. package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
  686. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
  687. package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
  688. package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
  689. package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
  690. package/dist/knowledge/references/saas.website.page.context.md +4 -3
  691. package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
  692. package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
  693. package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
  694. package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
  695. package/dist/knowledge/references/saas.website.section.context.md +3 -2
  696. package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
  697. package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
  698. package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
  699. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
  700. package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
  701. package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
  702. package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
  703. package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
  704. package/dist/knowledge/references/website-plan.config.md +238 -0
  705. package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
  706. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
  707. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  708. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
  709. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
  710. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
  711. package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
  712. package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
  713. package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
  714. package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
  715. package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
  716. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
  717. package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
  718. package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
  719. package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
  720. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
  721. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
  722. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
  723. package/dist/knowledge/references/zod.factories.address.md +118 -0
  724. package/dist/knowledge/references/zod.factories.code.md +4 -2
  725. package/dist/knowledge/references/zod.factories.duration.md +6 -4
  726. package/dist/knowledge/references/zod.factories.money.md +5 -3
  727. package/dist/knowledge/references/zod.factories.phone.md +14 -1
  728. package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
  729. package/dist/knowledge/registries/framework-topics.json +2602 -214
  730. package/dist/knowledge/registries/playbooks.json +468 -92
  731. package/dist/knowledge/registries/source-tags.json +6171 -1996
  732. package/dist/knowledge/rules/database-migration-obligation.md +110 -0
  733. package/dist/knowledge/rules/live-context-door.md +137 -0
  734. package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
  735. package/dist/knowledge/skills/INDEX.md +67 -29
  736. package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
  737. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
  738. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
  739. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
  740. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
  741. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
  742. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
  743. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
  744. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
  745. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
  746. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
  747. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
  748. package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
  749. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
  750. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
  751. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
  752. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
  753. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
  754. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
  755. package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
  756. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
  757. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
  758. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
  759. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
  760. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
  761. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
  762. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
  763. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
  764. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
  765. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
  766. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
  767. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
  768. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
  769. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
  770. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
  771. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
  772. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
  773. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
  774. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
  775. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
  776. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
  777. package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
  778. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
  779. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
  780. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
  781. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
  782. package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
  783. package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
  784. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
  785. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
  786. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
  787. package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
  788. package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
  789. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
  790. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
  791. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
  792. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
  793. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
  794. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
  795. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
  796. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
  797. package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
  798. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
  799. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
  800. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
  801. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
  802. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
  803. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
  804. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
  805. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
  806. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
  807. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
  808. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  809. package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
  810. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
  811. package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
  812. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
  813. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
  814. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
  815. package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
  816. package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
  817. package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
  818. package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
  819. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
  820. package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
  821. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
  822. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
  823. package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
  824. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
  825. package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
  826. package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
  827. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
  828. package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
  829. package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
  830. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
  831. package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
  832. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
  833. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
  834. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
  835. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
  836. package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
  837. package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
  838. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
  839. package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
  840. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
  841. package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
  842. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
  843. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
  844. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
  845. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
  846. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
  847. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
  848. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
  849. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
  850. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
  851. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
  852. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
  853. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
  854. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
  855. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
  856. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
  857. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
  858. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
  859. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
  860. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
  861. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
  862. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
  863. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
  864. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
  865. package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
  866. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
  867. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
  868. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
  869. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
  870. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
  871. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
  872. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
  873. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
  874. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
  875. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
  876. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
  877. package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
  878. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
  879. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
  880. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
  881. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
  882. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
  883. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
  884. package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
  885. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
  886. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
  887. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
  888. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
  889. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
  890. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
  891. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
  892. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
  893. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
  894. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
  895. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
  896. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
  897. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
  898. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
  899. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
  900. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
  901. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
  902. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
  903. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
  904. package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
  905. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
  906. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
  907. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
  908. package/dist/knowledge/skills/market-category/SKILL.md +2 -1
  909. package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
  910. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
  911. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
  912. package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
  913. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
  914. package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
  915. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
  916. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
  917. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
  918. package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
  919. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
  920. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
  921. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
  922. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
  923. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
  924. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
  925. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
  926. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
  927. package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
  928. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
  929. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
  930. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
  931. package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
  932. package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
  933. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
  934. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
  935. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
  936. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
  937. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
  938. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
  939. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
  940. package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
  941. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
  942. package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
  943. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
  944. package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
  945. package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
  946. package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
  947. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
  948. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
  949. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
  950. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
  951. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
  952. package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
  953. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
  954. package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
  955. package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
  956. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
  957. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
  958. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
  959. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
  960. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
  961. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
  962. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
  963. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
  964. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
  965. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
  966. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
  967. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
  968. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
  969. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
  970. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
  971. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
  972. package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
  973. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
  974. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
  975. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
  976. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
  977. package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
  978. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
  979. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
  980. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
  981. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
  982. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
  983. package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
  984. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
  985. package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
  986. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
  987. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
  988. package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
  989. package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
  990. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
  991. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
  992. package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
  993. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
  994. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
  995. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
  996. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
  997. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
  998. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
  999. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
  1000. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
  1001. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
  1002. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
  1003. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
  1004. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
  1005. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
  1006. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
  1007. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
  1008. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
  1009. package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
  1010. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
  1011. package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
  1012. package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
  1013. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
  1014. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
  1015. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
  1016. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
  1017. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
  1018. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
  1019. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
  1020. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
  1021. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
  1022. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
  1023. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
  1024. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
  1025. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
  1026. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
  1027. package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
  1028. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
  1029. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
  1030. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
  1031. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
  1032. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
  1033. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
  1034. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
  1035. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
  1036. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
  1037. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
  1038. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
  1039. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
  1040. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
  1041. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
  1042. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
  1043. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
  1044. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
  1045. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
  1046. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
  1047. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
  1048. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
  1049. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
  1050. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
  1051. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  1052. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
  1053. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
  1054. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
  1055. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
  1056. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
  1057. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
  1058. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
  1059. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
  1060. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
  1061. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
  1062. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
  1063. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
  1064. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
  1065. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
  1066. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
  1067. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
  1068. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
  1069. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
  1070. package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
  1071. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
  1072. package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
  1073. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
  1074. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
  1075. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
  1076. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
  1077. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
  1078. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
  1079. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
  1080. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
  1081. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
  1082. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
  1083. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
  1084. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
  1085. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
  1086. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
  1087. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
  1088. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
  1089. package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
  1090. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
  1091. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
  1092. package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
  1093. package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
  1094. package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
  1095. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
  1096. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
  1097. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
  1098. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
  1099. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  1100. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
  1101. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
  1102. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  1103. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
  1104. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
  1105. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
  1106. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
  1107. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
  1108. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
  1109. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
  1110. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
  1111. package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
  1112. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
  1113. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
  1114. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
  1115. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
  1116. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
  1117. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
  1118. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
  1119. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
  1120. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
  1121. package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
  1122. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
  1123. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
  1124. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
  1125. package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
  1126. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
  1127. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
  1128. package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
  1129. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
  1130. package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
  1131. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
  1132. package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
  1133. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
  1134. package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
  1135. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
  1136. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
  1137. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
  1138. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
  1139. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
  1140. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
  1141. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
  1142. package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
  1143. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
  1144. package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
  1145. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
  1146. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
  1147. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
  1148. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
  1149. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
  1150. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
  1151. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
  1152. package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
  1153. package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
  1154. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
  1155. package/dist/knowledge/topic-index.json +12659 -4142
  1156. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1157. package/dist/tsconfig.tsbuildinfo +1 -1
  1158. package/package.json +4 -4
  1159. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
  1160. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
  1161. package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
  1162. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
  1163. package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
  1164. package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
  1165. package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
  1166. package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
  1167. /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
@@ -0,0 +1,79 @@
1
+ # Framework Milestone Celebration API
2
+
3
+ How a milestone is CELEBRATED: its `celebrationLevel` (how big a moment), its optional
4
+ `celebrationMode` (how to draw it), the framework default that turns one into the other, and the
5
+ `CelebrationDisplayMode` vocabulary.
6
+
7
+ Read this when:
8
+
9
+ - a milestone's celebration is too loud, too quiet, or blocks the person mid-task;
10
+ - you want a significant milestone drawn as confetti, or a small one as a dialog;
11
+ - you need to know what `LOTTIE` does before choosing it.
12
+
13
+ ## Import Origins
14
+
15
+ - `@wildo-ai/saas-models`
16
+
17
+ ## Source Excerpts
18
+
19
+ ### Origin Package: `@wildo-ai/saas-models`
20
+
21
+ ```typescript
22
+ *
23
+ * How much of a moment a milestone is — NOT how it is drawn.
24
+ *
25
+ * Presentation is a separate choice, `celebrationMode` (a `CelebrationDisplayMode`), so that a
26
+ * milestone can be significant without having to accept a particular animation. Leave the mode out
27
+ * and the level picks one through `DEFAULT_CELEBRATION_MODE_BY_LEVEL`.
28
+ */
29
+ export enum MilestoneCelebrationLevel {
30
+ LOW = 'low',
31
+ MEDIUM = 'medium',
32
+ HIGH = 'high',
33
+ }
34
+
35
+ /**
36
+ * The display mode each level gets when a milestone does not name one — the framework's default,
37
+ * readable so an application knows what it is opting out of when it sets `celebrationMode`.
38
+ */
39
+ export const DEFAULT_CELEBRATION_MODE_BY_LEVEL: Record<MilestoneCelebrationLevel, CelebrationDisplayMode> = {
40
+ [MilestoneCelebrationLevel.LOW]: CelebrationDisplayMode.CONFETTI,
41
+ [MilestoneCelebrationLevel.MEDIUM]: CelebrationDisplayMode.OVERLAY,
42
+ [MilestoneCelebrationLevel.HIGH]: CelebrationDisplayMode.LOTTIE,
43
+ };
44
+
45
+ /**
46
+ * How a celebration is drawn, in order: the milestone's own `celebrationMode`; else the default for
47
+ * its `celebrationLevel`; else `CONFETTI`, the quietest presentation, for a reward that says neither.
48
+ */
49
+ export function resolveCelebrationDisplayMode(reward: {
50
+ readonly celebrationLevel?: MilestoneCelebrationLevel;
51
+ readonly celebrationMode?: CelebrationDisplayMode;
52
+ }): CelebrationDisplayMode {
53
+ if (reward.celebrationMode) return reward.celebrationMode;
54
+ if (reward.celebrationLevel) return DEFAULT_CELEBRATION_MODE_BY_LEVEL[reward.celebrationLevel];
55
+ return CelebrationDisplayMode.CONFETTI;
56
+ }
57
+ ```
58
+
59
+ ### Origin Package: `@wildo-ai/saas-models`
60
+
61
+ ```typescript
62
+ /**
63
+ * How the frontend renders a celebration after a successful operation — the value a milestone's
64
+ * `celebrationMode` takes. Import from `@wildo-ai/saas-models`.
65
+ * - CONFETTI: a lightweight, non-blocking confetti burst over the page. Decorative only: no message,
66
+ * no next step, nothing to dismiss.
67
+ * - OVERLAY: a dialog carrying the celebration animation, the milestone's title, the message, an
68
+ * optional next-step action and a dismiss.
69
+ * - LOTTIE: in the framework's DEFAULT celebration overlay, identical to OVERLAY — the same dialog
70
+ * and the same animation. It is the mode to use when the application's OWN celebration-overlay
71
+ * preset draws something distinct for it, such as a per-milestone animation chosen from the
72
+ * notification identifier the preset receives.
73
+ */
74
+ export enum CelebrationDisplayMode {
75
+ OVERLAY = 'overlay',
76
+ CONFETTI = 'confetti',
77
+ LOTTIE = 'lottie',
78
+ }
79
+ ```
@@ -0,0 +1,220 @@
1
+ # Framework Milestone Definition API
2
+
3
+ The contract for DECLARING a milestone: `defineMilestone(...)`, `MilestoneDefinition`, the reward
4
+ and trigger shapes, and the three vocabularies (`MilestoneType`, `MilestoneRewardType`,
5
+ `ProgressionScope`).
6
+
7
+ Read this when:
8
+
9
+ - adding a milestone to a module (`customMilestoneDefinitions`) or to the application-wide list;
10
+ - choosing between first-time, count-threshold and custom-condition milestones;
11
+ - deciding whether progress belongs to a person (`USER`) or to the whole organization;
12
+ - chaining milestones with `dependencies`, or moving the lifecycle with `lifecycleTransition`.
13
+
14
+ ## Import Origins
15
+
16
+ - `@wildo-ai/saas-models`
17
+
18
+ ## Source Excerpts
19
+
20
+ ### Origin Package: `@wildo-ai/saas-models`
21
+
22
+ ```typescript
23
+ /**
24
+ * defineMilestone() — Milestone Builder
25
+ *
26
+ * Creates a MilestoneDefinition with sensible defaults.
27
+ * Follows the same pattern as defineFeature() / defineLimitFeature().
28
+ *
29
+ * @example // Personal milestone (scope defaults to USER)
30
+ * defineMilestone('FIRST_PROJECT_CREATED', {
31
+ * type: MilestoneType.FIRST_TIME,
32
+ * trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },
33
+ * reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },
34
+ * category: 'getting-started',
35
+ * points: 10,
36
+ * labels: { description: true },
37
+ * })
38
+ *
39
+ * @example // Org-wide milestone — any member creating the 100th project triggers it
40
+ * defineMilestone('ORG_100_PROJECTS', {
41
+ * type: MilestoneType.COUNT_THRESHOLD,
42
+ * scope: ProgressionScope.ORGANIZATION,
43
+ * trigger: { resourceType: 'PROJECTS', operation: CoreResourceOperation.CREATE },
44
+ * threshold: 100,
45
+ * reward: { type: MilestoneRewardType.CELEBRATION, celebrationLevel: MilestoneCelebrationLevel.HIGH },
46
+ * category: 'team-achievements',
47
+ * points: 50,
48
+ * })
49
+ */
50
+ export function defineMilestone(
51
+ identifier: string,
52
+ options: {
53
+ type: MilestoneType;
54
+ /** Scope of this milestone — defaults to USER if omitted.
55
+ * ORGANIZATION milestones track collective achievements (any member can trigger). */
56
+ scope?: ProgressionScope;
57
+ trigger: MilestoneTrigger;
58
+ threshold?: number;
59
+ conditionRef?: string;
60
+ reward: MilestoneReward;
61
+ category: string;
62
+ points?: number;
63
+ labels?: { description?: boolean };
64
+ lifecycleTransition?: MilestoneLifecycleTransition;
65
+ dependencies?: string[];
66
+ }
67
+ ): MilestoneDefinition {
68
+ return {
69
+ identifier,
70
+ type: options.type,
71
+ scope: options.scope ?? ProgressionScope.USER,
72
+ trigger: options.trigger,
73
+ threshold: options.threshold,
74
+ conditionRef: options.conditionRef,
75
+ reward: options.reward,
76
+ category: options.category,
77
+ points: options.points ?? 0,
78
+ labels: options.labels,
79
+ lifecycleTransition: options.lifecycleTransition,
80
+ dependencies: options.dependencies ?? [],
81
+ };
82
+ }
83
+ ```
84
+
85
+ ### Origin Package: `@wildo-ai/saas-models`
86
+
87
+ ```typescript
88
+ *
89
+ * A milestone is a moment in a person's (or an organization's) use of the application that the
90
+ * application wants to recognise: the first project created, the tenth todo completed. Declare them
91
+ * in `shared-lib/src/engine/milestones.ts`; the framework counts the triggering operations, marks a
92
+ * milestone achieved, awards its points and delivers its reward. Import from `@wildo-ai/saas-models`.
93
+ */
94
+ export enum MilestoneType {
95
+ /** Achieved on first occurrence of the trigger operation */
96
+ FIRST_TIME = 'first_time',
97
+ /** Achieved when operation count reaches the threshold */
98
+ COUNT_THRESHOLD = 'count_threshold',
99
+ /** Achieved when a custom condition function returns true */
100
+ CUSTOM_CONDITION = 'custom_condition',
101
+ }
102
+
103
+ /** ──────────────────────────────────────────────────────────────
104
+ * Milestone Reward Type
105
+ * ────────────────────────────────────────────────────────────── */
106
+
107
+ export enum MilestoneRewardType {
108
+ /** Visual celebration (confetti, animation) via notification system */
109
+ CELEBRATION = 'celebration',
110
+ /** Unlock a feature by writing override to scope-matched features resource */
111
+ FEATURE_UNLOCK = 'feature_unlock',
112
+ /** Activate a guidance flow via WS push */
113
+ GUIDANCE_FLOW = 'guidance_flow',
114
+ }
115
+
116
+ /** ──────────────────────────────────────────────────────────────
117
+ * Progression Scope — Bi-Scope State Routing
118
+ * ────────────────────────────────────────────────────────────── */
119
+
120
+ export enum ProgressionScope {
121
+ /** State stored in USER_PROGRESSION_STATE — personal milestones (default) */
122
+ USER = 'user',
123
+ /** State stored in ORGANIZATION_PROGRESSION_STATE — org-wide milestones
124
+ * (e.g., "Team reached 50 members", "First integration configured") */
125
+ ORGANIZATION = 'organization',
126
+ }
127
+ ```
128
+
129
+ ### Origin Package: `@wildo-ai/saas-models`
130
+
131
+ ```typescript
132
+ /**
133
+ * The lifecycle stage change a milestone triggers when it is achieved — for example moving a person
134
+ * from `LifecycleStage.SIGNED_UP` to `LifecycleStage.ACTIVATED` when they create their first project.
135
+ *
136
+ * Use the `LifecycleStage` enum values, not their names. When the application's lifecycle config
137
+ * declares no `activationCriteria`, a milestone transition is how activation happens at all.
138
+ */
139
+ export interface MilestoneLifecycleTransition {
140
+ from: LifecycleStage;
141
+ to: LifecycleStage;
142
+ }
143
+ ```
144
+
145
+ ### Origin Package: `@wildo-ai/saas-models`
146
+
147
+ ```typescript
148
+ /**
149
+ * What a person gets when the milestone is achieved. `type` picks which of the other fields apply:
150
+ * `CELEBRATION` reads `celebrationLevel` / `celebrationMode`, `FEATURE_UNLOCK` reads `featureRef`,
151
+ * `GUIDANCE_FLOW` reads `guidanceFlowRef`.
152
+ */
153
+ export interface MilestoneReward {
154
+ type: MilestoneRewardType;
155
+ /** For FEATURE_UNLOCK: the feature identifier to enable */
156
+ featureRef?: string;
157
+ /** For GUIDANCE_FLOW: the guidance flow ref to activate */
158
+ guidanceFlowRef?: string;
159
+ /** For CELEBRATION: how big a moment this is. Presentation follows from it unless overridden. */
160
+ celebrationLevel?: MilestoneCelebrationLevel;
161
+ /**
162
+ * For CELEBRATION: draw it THIS way, whatever the level would have chosen.
163
+ *
164
+ * Makes the level a default rather than a verdict: a milestone that is significant but should
165
+ * still get confetti says so here. Omit it to get {@link DEFAULT_CELEBRATION_MODE_BY_LEVEL}.
166
+ */
167
+ celebrationMode?: CelebrationDisplayMode;
168
+ }
169
+
170
+ /** ──────────────────────────────────────────────────────────────
171
+ * Milestone Trigger — What Operation Triggers Evaluation
172
+ * ────────────────────────────────────────────────────────────── */
173
+
174
+ export interface MilestoneTrigger {
175
+ /** Resource type that triggers evaluation */
176
+ resourceType: string;
177
+ /** Operation that triggers evaluation */
178
+ operation: CoreResourceOperation;
179
+ }
180
+
181
+ /** ──────────────────────────────────────────────────────────────
182
+ * Milestone Definition — Full Declaration
183
+ * ────────────────────────────────────────────────────────────── */
184
+
185
+ export interface MilestoneDefinition {
186
+ /** Unique milestone identifier (e.g., 'FIRST_PROJECT_CREATED') */
187
+ identifier: string;
188
+ /** Milestone type — determines condition evaluation logic */
189
+ type: MilestoneType;
190
+ /** State scope — determines which resource stores this milestone's progress.
191
+ * USER (default): personal milestones, each user has their own state.
192
+ * ORGANIZATION: org-wide milestones, shared across all members. When any member
193
+ * triggers "org reached 50 members", it's achieved for the whole org.
194
+ */
195
+ scope?: ProgressionScope;
196
+ /** What resource operation triggers this milestone's evaluation */
197
+ trigger: MilestoneTrigger;
198
+ /** For COUNT_THRESHOLD: the count that must be reached */
199
+ threshold?: number;
200
+ /** For CUSTOM_CONDITION: condition function reference key.
201
+ * Receives (operationCounts, milestonesAchieved) and returns boolean.
202
+ * Note: Serialized as a reference string for frontend — backend evaluates the function. */
203
+ conditionRef?: string;
204
+ /** What the user gets when milestone is achieved */
205
+ reward: MilestoneReward;
206
+ /** Category for grouping (e.g., 'getting-started', 'power-user') */
207
+ category: string;
208
+ /** Points awarded for this milestone (for gamification) */
209
+ points?: number;
210
+ /** i18n: which labels to generate */
211
+ labels?: {
212
+ description?: boolean;
213
+ };
214
+ /** Phase 5 integration: lifecycle stage transition triggered by this milestone */
215
+ lifecycleTransition?: MilestoneLifecycleTransition;
216
+ /** Dependencies: milestone refs that must be achieved first (for unlocking chains).
217
+ * Dependencies are validated and evaluated within the same progression scope. */
218
+ dependencies?: string[];
219
+ }
220
+ ```
@@ -0,0 +1,86 @@
1
+ # Framework Progression Tracker API
2
+
3
+ `ProgressionTrackerVariant` — how much progression one `ProgressionMilestoneTracker` mount shows.
4
+ The component itself (import, props, examples) is in the framework component catalog under
5
+ "milestone tracker".
6
+
7
+ Read this when:
8
+
9
+ - placing a progress card on a dashboard, a home screen or an achievements page;
10
+ - the tracker shows too much or too little for the space it has;
11
+ - you need a progress shape none of the variants covers.
12
+
13
+ ## Import Origins
14
+
15
+ - `@wildo-ai/saas-models`
16
+
17
+ ## Source Excerpts
18
+
19
+ ### Origin Package: `@wildo-ai/saas-models`
20
+
21
+ ```typescript
22
+ *
23
+ * How much progression one `ProgressionMilestoneTracker` mount shows — passed as its `variant` prop.
24
+ * Import from `@wildo-ai/saas-models`.
25
+ *
26
+ * Chosen PER MOUNT, because surfaces of one application want different amounts: a home dashboard
27
+ * wants a glance, an achievements screen wants the detail, a product still teaching its first task
28
+ * wants only the next thing to do. Every variant reads the same progression state and the same
29
+ * milestone definitions; they differ only in how much of it reaches the screen.
30
+ *
31
+ * These four are the common shapes, not a ceiling — but the tracker is composed by name, not
32
+ * resolved through the component registry, so there is no preset to swap. An application needing a
33
+ * shape none of them covers builds its own card from `useProgression()` (exported by
34
+ * `@wildo-ai/saas-frontend-lib`), which gives the same milestone definitions, per-scope state and
35
+ * points total the tracker renders from.
36
+ */
37
+ export enum ProgressionTrackerVariant {
38
+ /**
39
+ * Overall progress and the milestones actually in reach — nothing else.
40
+ *
41
+ * No categories, no points, no per-milestone bars, and ACHIEVED milestones are not listed at all:
42
+ * the "5 of 8" line is the record of them. For a surface whose job is to get someone to the next
43
+ * action rather than to celebrate the last one. The smallest shape, and the right default for a
44
+ * product that is still teaching itself.
45
+ */
46
+ NEXT_ACTIONS = 'next_actions',
47
+
48
+ /**
49
+ * A glance: overall progress, the points total, and the single next milestone.
50
+ *
51
+ * For a dashboard card sitting beside other cards, where progression is one of several things
52
+ * competing for the same screen. Pairs with a `DETAILED` mount on a dedicated view — this is the
53
+ * summary that links to it.
54
+ */
55
+ SUMMARY = 'summary',
56
+
57
+ /**
58
+ * One list and ONE progress signal.
59
+ *
60
+ * Categories become plain section headings rather than separately measured units, so there is a
61
+ * single bar for the whole surface; a per-milestone count appears only where one is genuinely in
62
+ * flight. Every milestone is listed, achieved ones included, with achievement carried by ONE
63
+ * encoding rather than four.
64
+ */
65
+ FLAT = 'flat',
66
+
67
+ /**
68
+ * Categories measured in their own right, with the full per-milestone breakdown.
69
+ *
70
+ * The densest shape, for a screen whose whole subject is progression. It keeps the per-category
71
+ * bar and the per-milestone count that `FLAT` collapses, and gives them different visual weight so
72
+ * they stop competing — the defect in the original was never that both existed, it was that they
73
+ * were rendered identically and so read as one confused signal.
74
+ */
75
+ DETAILED = 'detailed',
76
+ }
77
+
78
+ /**
79
+ * The shape used when a mount does not name one.
80
+ *
81
+ * `SUMMARY` rather than `DETAILED`, deliberately: the overwhelmingly common mount is a card on a
82
+ * home surface, and the density that made the original hard to read is exactly what a card cannot
83
+ * afford. An application that wants everything asks for it.
84
+ */
85
+ export const DEFAULT_PROGRESSION_TRACKER_VARIANT: ProgressionTrackerVariant = ProgressionTrackerVariant.SUMMARY;
86
+ ```
@@ -0,0 +1,144 @@
1
+ ---
2
+ name: minion-authoring
3
+ description: Author a cron minion — a scheduled background unit that wakes on its own and works through a contained system-access whitelist. Use when the user says "run this nightly", "add a cron job", "this should happen on a schedule", "sweep the stale rows", or when a task's target is a MINION. Covers the package the add-minion scenario composes, the onTick handler, and the three-part containment chain a minion needs before it can touch any resource.
4
+ user-invocable: false
5
+ ---
6
+
7
+ # Minion Authoring
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 minion is a **cron-mode background unit**: it wakes on its own schedule, does its work through the
24
+ system-access surface, and goes back to sleep. Nobody calls it — which is what separates it from a
25
+ worker, and which is why its access is contained by declaration rather than by the identity of a
26
+ caller.
27
+
28
+ The package is composed by the `add-minion` scenario. **You author its `onTick`**, and the
29
+ containment chain that lets that tick touch anything at all.
30
+
31
+ ## App Paths
32
+
33
+ | Surface | Glob (relative to app root) |
34
+ |---|---|
35
+ | Minion declaration + containment | `wildo.saas.config.ts` → the `applicationMinions` object → `<minionCamel>: { path, resourceAccess: { read: [], write: [] }, platformAccess }` |
36
+ | Minion provider scope | `wildo.saas.config.ts` → `minionProviderScopes: { <minionCamel>: { providers: {} } }` |
37
+ | Per-minion config | `minions/<minionDir>/wildo.minion.config.ts` (`defineMinionConfig`: the `schedule`) |
38
+ | The tick | `minions/<minionDir>/src/minion-init.ts` (`defineMinionInit({ onTick })`) |
39
+ | Entry | `minions/<minionDir>/src/index.ts` |
40
+ | Resource opt-in | `shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts` → `systemAccessPolicy` |
41
+ | Workspace member | `pnpm-workspace.yaml` → `- 'minions/<minionDir>'` |
42
+
43
+ ## When to Use
44
+
45
+ - Work that happens because TIME passed: a nightly sweep, a retention pass, a reminder.
46
+ - A task whose build-plan target is `MINION`.
47
+
48
+ ## When NOT to Use
49
+
50
+ - **Work something ASKS for** → a worker (`worker-authoring`) or a custom operation.
51
+ - **Work that belongs to a request** → a custom operation on the resource
52
+ (`backend-custom-operation`), which keeps the caller's authorization.
53
+ - **Composing the package** → the `add-minion` scenario, which the FOUNDATION applies once per
54
+ minion the integration plan declares. The capability composition records that ownership; it does
55
+ not decide whether this application has a minion.
56
+
57
+ ## Workflow
58
+
59
+ 1. **Set the schedule** in `wildo.minion.config.ts`. It is the whole reason the minion exists; a
60
+ minion with no schedule never runs.
61
+ 2. **Author the `onTick`** in `src/minion-init.ts`. It receives the tick token (`jobId`,
62
+ `applicationId`) and the minion's name. Keep it short and make it safe to run twice: a tick may
63
+ overlap a previous one that has not finished.
64
+ 3. **Author the CONTAINMENT CHAIN — all three parts, or the tick can touch nothing.** This is the
65
+ part a minion fails on, and it fails quietly:
66
+ - `resourceAccess: { read: [...], write: [...] }` on the minion's entry in
67
+ `wildo.saas.config.ts` — the DENY-ALL starter whitelist. Widen it to exactly the resources the
68
+ tick touches; the system-access proxy refuses anything outside it.
69
+ - `systemAccessPolicy` on each of those resources' own configs — and it is **PER VERB**, not a
70
+ boolean: `systemAccessPolicy: { read: ALLOWED, create: ALLOWED }`. Every verb is refused unless
71
+ that verb is `ALLOWED`, so a resource carrying `systemAccessPolicy: { exportSubject: ALLOWED }`
72
+ — which several engine resources do — has opted in to nothing the tick does. Name the verbs
73
+ the tick actually performs.
74
+ - `platformAccess: { scopes: ['own_cron_records'] }` on the minion's entry, if and only if the
75
+ tick reads `ownSchedule.read()`.
76
+ 4. **Use `systemAccess`, never a direct database client.** The proxy is what the whitelist contains;
77
+ a direct client is uncontained by construction. The platform also confines the minion's own
78
+ database credential to what `resourceAccess` declares (plus the job-execution records every
79
+ minion needs), on a self-hosted MongoDB, on MongoDB Atlas and on PostgreSQL alike — the minion
80
+ never receives the application's database user.
81
+ 5. **Log the tick's OUTCOME, not its occurrence.** "Tick handled" tells an operator nothing; how many
82
+ rows it swept, and what it skipped, tells them whether it is working.
83
+
84
+ ## Verification
85
+
86
+ - `wildo.minion.config.ts` declares a `schedule`.
87
+ - Every resource the tick touches appears in the minion's `resourceAccess`, and its config declares
88
+ `systemAccessPolicy` **for each verb the tick performs** — the presence of the block is not enough.
89
+ - The `onTick` does something beyond acknowledging the tick.
90
+ - `ownSchedule.read()` and `platformAccess: { scopes: ['own_cron_records'] }` appear together or not
91
+ at all.
92
+ - `pnpm -C minions/<minionDir> exec tsc --noEmit` passes.
93
+
94
+ ### Grep invariants
95
+
96
+ ```bash
97
+ # the containment whitelist — an empty pair is the DENY-ALL starter
98
+ rg -n -A 6 "<minionCamel>: \{" wildo.saas.config.ts
99
+ # every resource the whitelist names must opt in — READ THE VERBS, not just the block
100
+ rg -n -A 4 "systemAccessPolicy" shared-lib/src/modules/*/resources/**/*.resources-config.ts
101
+ # the tick must not reach a client directly
102
+ rg -n "mongoose|new MongoClient|createPool|drizzle" minions/<minionDir>/src
103
+ # the starter onTick, shipped unchanged: a handler whose only statement is a log
104
+ rg -n -A 3 "onTick" minions/<minionDir>/src/minion-init.ts
105
+ # reading your own schedule needs the platform scope beside it
106
+ rg -n "ownSchedule|own_cron_records" minions/<minionDir>/src wildo.saas.config.ts
107
+ ```
108
+
109
+ ## Common Rationalizations
110
+
111
+ | Rationalization | Reality |
112
+ |---|---|
113
+ | "The whitelist is empty, so it defaults to everything." | It is DENY-ALL. An empty `read`/`write` pair means the tick can touch nothing, and the application logs a soft warning rather than failing — so it looks like it is running while doing nothing. |
114
+ | "I added the resource to `resourceAccess`, that is enough." | The resource must ALSO opt in with `systemAccessPolicy`. Two declarations, both required, on purpose: one says what the minion may ask for, the other what the resource will answer. |
115
+ | "The resource already has a `systemAccessPolicy`, so it is opted in." | It is per VERB. A resource allowing `exportSubject` and nothing else refuses every read and write the tick performs — and the checklist and the grep both look satisfied, which is what makes this the expensive one. |
116
+ | "Ticks cannot overlap, the scheduler prevents it." | Write the tick so an overlap is harmless. A slow tick and a short schedule is the ordinary case, not the exception. |
117
+ | "It is background work, so a worker and a minion are the same thing." | A worker answers a call and a minion wakes itself. That decides the containment: a worker inherits a caller's context, a minion has none and must declare everything. |
118
+
119
+ ## Red Flags
120
+
121
+ - An `onTick` that only logs — the starter, shipped unchanged (catch with the `onTick` grep above).
122
+ - A resource written by the tick that is absent from `resourceAccess`, or present there with a
123
+ `systemAccessPolicy` that allows a DIFFERENT verb (catch with the two greps above — read the
124
+ verbs, because the block being present is what makes this one look fine).
125
+ - A direct database client inside the minion (catch with the client grep above).
126
+ - `ownSchedule.read()` with no `platformAccess: { scopes: ['own_cron_records'] }` (catch with the
127
+ `ownSchedule` grep above).
128
+
129
+ ## Worked Example
130
+
131
+ `examples/contained-tick.example.md` — the dogfood application's own tick, which is the only place
132
+ the full containment chain is exercised end to end rather than described.
133
+
134
+ ## References
135
+
136
+ - `references/framework-minion-tick-contract.md` — what the tick receives, from the engine's own
137
+ source: the contained `systemAccess` door, the scheduled-attempt identity, `ownSchedule`.
138
+ - `examples/contained-tick.example.md` — the chain, exercised.
139
+
140
+ ## Related Skills
141
+
142
+ - `worker-authoring` — the called sibling: an HTTP surface, not a schedule.
143
+ - `config-saas` — the declaration and the containment whitelist both live there.
144
+ - `backend-custom-operation` — when the work belongs to a request after all.
@@ -0,0 +1,84 @@
1
+ # A contained tick, as an application actually writes one
2
+
3
+ The three-part containment chain exercised end to end: the minion's `resourceAccess` whitelist
4
+ contains the read, the resource opts in per verb, and the access leaves an audit record naming this
5
+ minion. Read the comment as carefully as the code — it is the clearest statement of why a read the
6
+ whitelist permits can still be refused.
7
+
8
+
9
+ ## Usage Example
10
+
11
+ ```typescript
12
+ return defineMinionInit({
13
+ ...projected,
14
+ /**
15
+ * Your Application KD-10 dogfood handler. Each MINION_TICK from the
16
+ * platform crontabs-batches-manager publisher (KD-12) lands here.
17
+ *
18
+ * This performs a REAL privileged read, which is the point: until a minion
19
+ * actually exercises the system-access door, none of the axis-C machinery is
20
+ * observable at runtime. It is the first exercise of the full chain —
21
+ * containment → reach → accountability — end to end:
22
+ *
23
+ * 1. `resourceAccess: { read: ['todos'], write: [] }` (authored next door in
24
+ * `wildo.saas.config.ts`) contains it. The `systemAccess` handed in via the
25
+ * tick context routes through that ACL proxy, so a read of any other
26
+ * resource is refused here even though the door itself would allow it.
27
+ * 2. `listAsSystem` is the sanctioned cross-tenant reach. `todos` opts in with
28
+ * `systemAccessPolicy: { list: ALLOWED }` precisely so a background runtime
29
+ * can see the fleet across every organization — a scope no synthesised
30
+ * tenant context is a member of.
31
+ * 3. Every such read emits a `SYSTEM_CONTEXT_READ` audit naming THIS minion
32
+ * (`performedByRuntime.runtimeKey = 'marketingScrapper'`), and because the
33
+ * MINION profile requires accountable access, a read that cannot be audited
34
+ * is refused rather than silently unrecorded.
35
+ *
36
+ * Deliberately READ-ONLY and side-effect-free. The scraping/enrichment flow
37
+ * (an actor dispatched via `flowsActorsRegistry`, per Q5/Q9 LOCKED) is a later
38
+ * slice; writes would additionally need `resourceAccess.write`, which the
39
+ * operator has deliberately left empty.
40
+ *
41
+ * The containment chain this exercises is written up for application authors in the
42
+ * `minion-authoring` skill, which cites this handler as its worked example. A gitignored plan
43
+ * path stood here and was removed: it does not survive a re-clone, and it now ships into every
44
+ * generated application through that skill — which the knowledge generator refuses outright.
45
+ */
46
+ onTick: async (token, { systemAccess, minionName, ownSchedule }) => {
47
+ const todos = await systemAccess.listAsSystem<{ _id: string }>(
48
+ TasksManager_ResourceType.TODOS,
49
+ {},
50
+ );
51
+
52
+ const todoCount = Array.isArray(todos) ? todos.length : todos?.data?.length ?? 0;
53
+
54
+ // The PLATFORM-access axis (R4), exercised alongside the application-data
55
+ // axis above so the two stay visibly independent (D12). This minion
56
+ // declares `platformAccess: { scopes: ['own_cron_records'] }` in
57
+ // `wildo.saas.config.ts`; a minion that declared only `resourceAccess`
58
+ // would reach the line above and be refused here, which is the point.
59
+ //
60
+ // `read()` takes no arguments. The subject is this runtime's own attested
61
+ // identity, so there is no way to ask for a sibling minion's schedule —
62
+ // not a refusal, an inexpressible request.
63
+ const ownJobs = await ownSchedule.read();
64
+
65
+ console.log('[marketing-scrapper] tick handled', {
66
+ jobId: token.jobId,
67
+ minionName,
68
+ applicationId: token.applicationId,
69
+ // The observable proof that the privileged read ran AND was accountable:
70
+ // reaching this line means the `SYSTEM_CONTEXT_READ` audit was written,
71
+ // because an unauditable read throws instead of returning.
72
+ todosVisibleFleetWide: todoCount,
73
+ // The observable proof of the platform axis: reaching this line means the
74
+ // bootstrap secret was exchanged for an attestation at apps-manager and
75
+ // crontabs accepted it.
76
+ ownCronJobs: ownJobs.map((entry) => ({
77
+ jobId: entry.job.jobId,
78
+ cron: entry.job.schedule?.cron,
79
+ recentRuns: entry.recentExecutions.length,
80
+ })),
81
+ });
82
+ },
83
+ });
84
+ ```