@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,953 @@
1
+ # Framework Personal-Data Declaration API
2
+
3
+ Read this **once per resource**, before you consider it finished.
4
+
5
+ It answers one question: **do this resource's rows describe a person?** Every resource owes an
6
+ answer — including "no", which is a real answer and has a way to say it.
7
+
8
+ ## Why you are asked, when nothing forces you
9
+
10
+ The framework does NOT refuse to start a resource that says nothing. That was decided deliberately:
11
+ a hard constraint on every author, for every resource, forever is too strict, and the framework's
12
+ own directive is that the system works first and protection arrives as guidance rather than as a
13
+ refusal wired into the mechanism.
14
+
15
+ What happens instead is that the application logs a startup **warning** naming every resource of
16
+ yours that has said nothing, and the application's generated privacy notice can say nothing about
17
+ those resources. The measured consequence, in a real application: a notice that is accurate about
18
+ the platform — identity, credentials, sessions, membership all come free with the engine — and
19
+ silent about the contacts, deals and interaction history, which is the data the customers of that
20
+ application actually care about.
21
+
22
+ So this is the cheapest possible moment to answer. Later means editing a shipped schema.
23
+
24
+ ## Four ways to answer, and they are four different questions
25
+
26
+ Declaring ANY of them counts as having answered. Declare the ones that are true.
27
+
28
+ | declaration | where | the question it answers |
29
+ |---|---|---|
30
+ | `retentionPolicy` | `resources-config` | does an erasure KEEP this row, and are its fields scrubbed? |
31
+ | `dataSubjectPolicy` | `resources-config` | whose LOGIN SESSION does erasing this row end? |
32
+ | `systemAccessPolicy.exportSubject` | `resources-config` | do these rows belong in a subject's export bundle? |
33
+ | `.dataCategories(...)` | the schema, per field | what KIND of personal data does this field hold? |
34
+
35
+ ### The "no personal data" answer is `RETAIN_ONLY`
36
+
37
+ `retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY }` means *this resource holds no personal
38
+ data of its own*, and it is CHECKED: the resource factory refuses a `.impersonalizeWith()` treatment
39
+ beside it, because the treatment would never run. It is a positive statement a compliance document
40
+ can cite, not silence — which is exactly why saying it is worth a line.
41
+
42
+ A resource that genuinely holds nothing about people — a product catalog, a price list, a pipeline
43
+ stage — should say so this way.
44
+
45
+ ### The two config declarations that must travel together
46
+
47
+ `retentionPolicy` REQUIRES `dataSubjectPolicy`, and `dataSubjectPolicy` is rejected without a
48
+ `retentionPolicy`. A retention-governed resource is exactly one that can be handed to an erasure as a
49
+ subject, so it must say whether its rows ARE a person and, if so, which field names the user whose
50
+ session the erasure ends.
51
+
52
+ ⚠️ `dataSubjectPolicy.kind = NO_PRINCIPAL` is the SESSION axis and nothing else. It is equally true
53
+ of an invoice and of a CRM contact who has no account. It does NOT mean "not a person" — read
54
+ `retentionPolicy.mode` for that.
55
+
56
+ ### `.dataCategories()` is per FIELD, and is not derived from names
57
+
58
+ A resource-level category cannot express that one row holds a name, an email and a payment token,
59
+ which is exactly what a privacy notice enumerates. Nothing in the framework infers a category from a
60
+ field's NAME — `email`, `phone` and `dateOfBirth` are suggestive while `notes` is not, and an
61
+ inventory built that way is a guess whose misses are silently undisclosed.
62
+
63
+ The one category the framework derives is `CREDENTIALS`, from `.isPassword()` / `.isOtp()` /
64
+ `.isWriteOnlySecret()` — markers you wrote.
65
+
66
+ If you declare `.impersonalizeWith()` on a field, declare a category on it too. A field that is
67
+ personal by one declaration and uncategorized by another is reported BY NAME as an outstanding gap
68
+ in every compliance document the application produces.
69
+
70
+ ### Who OWES an `exportSubject`, and why a bare count of declarations misleads
71
+
72
+ The other three declarations are owed by every resource, and the framework only warns. `exportSubject`
73
+ is different: it is **enforced**, and on a defined population rather than on all of them. The
74
+ obligation covers exactly the resources whose rows would enter a subject-export bundle — those
75
+ reachable from the subject on the export graph, which includes edges an erasure calls `NOT_OWNED`
76
+ because the subject-access right covers all personal data concerning a person, not only what they own.
77
+ A resource off that graph owes nothing, and its silence is correct.
78
+
79
+ So if you ever audit this — counting how many of your resources declare `exportSubject` and reporting
80
+ the shortfall as a gap — **the denominator is the resources on the export graph, never the resource
81
+ count.** "11 of 13" is arithmetic; "13 of 13 that owe it" is the answer. Ask which resources are
82
+ reachable from the subject before you report anything missing.
83
+
84
+ ## Resource configuration surface
85
+
86
+ ## Import Origins
87
+
88
+ - `@wildo-ai/saas-models`
89
+
90
+ ## Source Excerpts
91
+
92
+ ### Origin Package: `@wildo-ai/saas-models`
93
+
94
+ ```typescript
95
+ *
96
+ * Valid operation keys from core + custom enums, and builder params for `createResourceConfiguration`.
97
+ */
98
+ // Helper type to extract valid operation keys, excluding undefined
99
+ export type ValidOperationKeys<
100
+ TCustomOperationEnum extends EnumLikeType | undefined,
101
+ TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined
102
+ > = (TCustomOperationEnum extends EnumLikeType ? EnumValues<TCustomOperationEnum> : never) |
103
+ (TCoreOperationEnum extends Partial<CoreResourceOperation> ? TCoreOperationEnum : never);
104
+
105
+ /**
106
+ *
107
+ * Access mode for the ACL-bypassing system-context reads
108
+ * (`SystemAccessBackendService.readAsSystem` / `listAsSystem`, from
109
+ * `@wildo-ai/saas-backend-lib`).
110
+ *
111
+ * Those primitives run with a synthesised super-admin execution context and
112
+ * therefore SKIP the caller's scope and role checks entirely. A resource is
113
+ * readable that way ONLY if its resource configuration opts the verb in. Any
114
+ * verb left undeclared defaults to `FORBIDDEN`: a system read of a resource
115
+ * that has not opted in throws `ErrorType.CONFIGURATION` — the framework is
116
+ * fail-closed here by construction.
117
+ */
118
+ export enum ResourceSystemAccessMode {
119
+ /** The verb's system-context primitive is rejected for this resource (default). */
120
+ FORBIDDEN = 'FORBIDDEN',
121
+ /** The verb's system-context primitive is permitted for this resource. */
122
+ ALLOWED = 'ALLOWED',
123
+ }
124
+
125
+ /**
126
+ * Per-resource opt-in policy for the ACL-bypassing system-context primitives
127
+ * on `SystemAccessBackendService`: the reads (`readAsSystem` / `listAsSystem`)
128
+ * and the trusted writes (`createAsSystem` / `updateAsSystem` /
129
+ * `updateManyAsSystem`).
130
+ *
131
+ * A system-context call does not REMOVE the authorization decision — it
132
+ * RELOCATES it from the resource ACL onto the calling service, which MUST
133
+ * enforce an explicit alternative check (e.g. consumable-token or
134
+ * email-ownership matching). Declaring this policy is the data owner's
135
+ * statement that such a bypass is permissible at all, and for which verb. An
136
+ * absent policy — or a verb set to (or left defaulting to) `FORBIDDEN` — makes
137
+ * the primitive throw.
138
+ *
139
+ * The WRITE verbs additionally let a trusted in-process caller persist the
140
+ * fields the client-shaped request DTO strips — `.isBackendOnly()` material
141
+ * (e.g. a credential `passwordHash`) and the context-auto-populated FKs (e.g.
142
+ * `userId` on a system resource that has no HTTP surface to seed it) — by
143
+ * re-attaching exactly those fields after the strict parse. They are the
144
+ * sanctioned path for engine flows like registration that must write system
145
+ * resources directly; opting a verb in is the data owner's acknowledgement that
146
+ * a super-admin-context mutation of this resource is legitimate.
147
+ *
148
+ * Caveats a system-context call inherits (it runs as super-admin), to weigh
149
+ * before opting in:
150
+ * - a READ returns the FULL record — every field, including ones a normal
151
+ * caller's role / field-visibility would hide — so never forward the result
152
+ * verbatim to an under-privileged caller; project only what is safe.
153
+ * - a WRITE bypasses the caller's scope + role ACL, so the calling service
154
+ * owns the authorization decision (only trusted engine code can reach the
155
+ * primitive — it is never exposed to an HTTP payload).
156
+ * - feature flags do not gate it (it is an internal request).
157
+ * - the policy is RESOURCE-LEVEL: for a polymorphic resource it is shared by
158
+ * every scope variant (declare it once on the shared config).
159
+ *
160
+ * Intentionally DISTINCT from `isSystemResource`: marking a resource as
161
+ * framework infrastructure does NOT imply that an ACL bypass is acceptable
162
+ * for its data. Keep the two concepts separate.
163
+ */
164
+ /**
165
+ * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
166
+ *
167
+ * ## Why the application declares it rather than the framework knowing it
168
+ *
169
+ * The erasure lane is application-owned — four of the five marked sites for
170
+ * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
171
+ * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
172
+ * status vocabulary are the application's, so a collector queries it against that application's
173
+ * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
174
+ * that is one application's modelling choice"*.
175
+ *
176
+ * So a collector may not know that a request is raised through a field called `channel` carrying a
177
+ * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
178
+ * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
179
+ * to find it (#1209): not a missing control, a control nobody could point at.
180
+ *
181
+ * ## It binds FIELDS, never values the framework invents
182
+ *
183
+ * Every member below names something the application already authored. The one value the
184
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
185
+ * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
186
+ * framework supplies no vocabulary here and must never grow one.
187
+ *
188
+ * ## What is deliberately NOT declared
189
+ *
190
+ * The SCHEDULE. C3 asks that requests be executed on the declared schedule, and that schedule is
191
+ * already on the executing operation's `CRON_JOB` variant (`cronExpression`) — declaring it again
192
+ * here would be a second copy that can only ever disagree with the one the scheduler reads.
193
+ * `executionOperationIdentifier` names the operation; the schedule is read from it.
194
+ */
195
+ export type ResourceSubjectErasureLane = {
196
+ /**
197
+ * How a row says WHO raised the request — the subject exercising their own right, or the
198
+ * controller acting on their behalf. C1's whole obligation is that the two are distinguishable.
199
+ */
200
+ raisedBy: {
201
+ /** The field carrying it. Must be a persisted field of this resource. */
202
+ fieldName: string,
203
+ /**
204
+ * The value of that field meaning the SUBJECT raised it themselves. Every other value is read as
205
+ * controller-raised — stated this way round because a lane may grow a second controller channel
206
+ * without the declaration going stale, whereas enumerating the controller values could not.
207
+ */
208
+ subjectValue: string,
209
+ },
210
+ /**
211
+ * The field carrying WHICH user raised a controller-raised request.
212
+ *
213
+ * Omitting it is a positive claim, not a gap: it says this lane admits no controller-raised
214
+ * request at all. A collector reads it that way and a row carrying a non-subject value then
215
+ * contradicts the declaration, which is a finding about the application rather than about the
216
+ * evidence.
217
+ */
218
+ requesterFieldName?: string,
219
+ /** The field carrying the justification a controller-raised request was made on, where the lane records one. */
220
+ justificationFieldName?: string,
221
+ /** The field carrying the instant the request was executed or failed. C3 judges execution against it. */
222
+ completedAtFieldName: string,
223
+ /** The field carrying what the execution did. Its vocabulary is the application's. */
224
+ outcomeFieldName: string,
225
+ /**
226
+ * The operation a SUBJECT uses to withdraw their own pending request (C2). Named rather than
227
+ * inferred: "the operation that cancels" is not derivable from an operation vocabulary, and
228
+ * guessing it would make the evidence depend on a naming convention no application agreed to.
229
+ */
230
+ withdrawalOperationIdentifier: string,
231
+ /**
232
+ * How a WITHDRAWN row is recognisable afterwards — the same shape as {@link raisedBy}, and for the
233
+ * same reason: the vocabulary is the application's.
234
+ *
235
+ * C2 asks for the withdrawal door AND for "any cancelled rows", and those are two different
236
+ * questions. The door is answered from {@link withdrawalOperationIdentifier} — is the operation
237
+ * reachable to a subject while the request is pending — and needs no data at all. The rows need a
238
+ * marker, and there is nothing to derive one from: withdrawal and execution both leave a request in
239
+ * a terminal state, so a reader that knows only `completedAtFieldName` cannot tell "the subject
240
+ * changed their mind" from "the sweep ran".
241
+ *
242
+ * OPTIONAL, because an application may not model withdrawal as a value at all — it may delete the
243
+ * row, or move it. Omitting it says the count is unavailable, and a collector reports that rather
244
+ * than guessing; it never turns into a zero, which would read as "nobody withdrew anything".
245
+ *
246
+ * Note an EMPTY withdrawal set is explicitly not a deficiency in the demand — people do not have
247
+ * to change their minds — so this exists to make the number REPORTABLE, never to make it a target.
248
+ */
249
+ withdrawnMarker?: {
250
+ /** The field carrying it. Must be a persisted field of this resource. */
251
+ fieldName: string,
252
+ /** The value of that field meaning the SUBJECT withdrew the request before it executed. */
253
+ withdrawnValue: string,
254
+ },
255
+ /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
256
+ executionOperationIdentifier: string,
257
+ };
258
+
259
+ export type ResourceSystemAccessPolicy = {
260
+ /** Governs `readAsSystem`. Omitted ⇒ FORBIDDEN. */
261
+ read?: ResourceSystemAccessMode,
262
+ /** Governs `listAsSystem`. Omitted ⇒ FORBIDDEN. */
263
+ list?: ResourceSystemAccessMode,
264
+ /** Governs `createAsSystem`. Omitted ⇒ FORBIDDEN. */
265
+ create?: ResourceSystemAccessMode,
266
+ /** Governs `updateAsSystem`. Omitted ⇒ FORBIDDEN. */
267
+ update?: ResourceSystemAccessMode,
268
+ /** Governs `updateManyAsSystem`. Omitted ⇒ FORBIDDEN. */
269
+ updateMany?: ResourceSystemAccessMode,
270
+ // NOTE: there is deliberately NO `delete` verb here — there is no `deleteAsSystem` primitive. A row is
271
+ // removed either through its own DELETE operation ACL (e.g. an owner-facing `API_CALL` DELETE under the
272
+ // USER_SELF owner filter) or by the `onParentDelete` composition cascade (which deletes at the raw
273
+ // repository layer, variant-agnostic — see `deleteChildrenImmediate`). If you find yourself reaching
274
+ // for `systemAccessPolicy.delete`, model the removal as one of those two instead.
275
+ /**
276
+ * Governs the impersonalization see-through reads (`readRetainedAsSystem` /
277
+ * `listRetainedAsSystem`) — the privileged, audited path that reveals
278
+ * `retentionStatus = RETAINED` rows hidden-by-default. Omitted ⇒ FORBIDDEN.
279
+ * Auto-derived to `ALLOWED` by the factory when a resource opts into
280
+ * `retentionPolicy`; never authored by hand in the common case.
281
+ *
282
+ * **LIVE, and REACHABLE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
283
+ * the verb is asserted fail-closed, a privileged human role is required, and every reveal emits a
284
+ * human-attributed `RETAINED_DATA_ACCESS` audit event.
285
+ *
286
+ * "Reachable" is the half that was missing until #490, and the distinction is worth keeping. The
287
+ * primitives were correct and enforced from the day M5b landed — and had **no caller**, so the only
288
+ * route an operator actually had to a retained record was a database console: the unaudited path
289
+ * they were built to replace. `users | read_retained` is the operator surface that closes it, an
290
+ * authenticated `APP_ADMIN_SUPER_ADMIN` operation carrying a mandatory justification.
291
+ *
292
+ * A resource that derives this grant and exposes no such operation is reachable by nothing. That
293
+ * is a defensible state — not every retention resource needs an operator door — but it should be a
294
+ * decision rather than an oversight, and `retained-see-through-operator-surface.test.ts` is what
295
+ * makes it one.
296
+ *
297
+ * (This block previously said the primitives were "wired in a later phase" — false since M5b.)
298
+ */
299
+ seeRetained?: ResourceSystemAccessMode,
300
+
301
+ /**
302
+ * May this resource's rows be swept into a SUBJECT EXPORT bundle (GDPR Art. 15 / Art. 20)?
303
+ *
304
+ * Fail-closed by omission, like every other verb here. A subject export reads across the whole
305
+ * child-direction graph of its subject, so without an explicit opt-in a resource could be
306
+ * disclosed to a data subject because it merely sits on an edge — nobody having decided that its
307
+ * contents are appropriate to hand over.
308
+ *
309
+ * **The refusal is LOUD, not a silent skip.** When an edge the classifier marked for inclusion
310
+ * belongs to a resource that has not opted in, the export REFUSES and names it. Silently dropping
311
+ * it would produce an access bundle that is incomplete without saying so — a disclosure failure
312
+ * wearing the appearance of a successful response, which is the same class of lie as the routed
313
+ * export operations this capability replaced. Refusing is a one-line fix per resource; a silent
314
+ * omission is undetectable.
315
+ *
316
+ * NOT derived from `portabilityPolicy`: declaring where fields came from (Art. 20 scoping) and
317
+ * consenting to be disclosed at all are different decisions, and a resource may legitimately want
318
+ * the first without the second.
319
+ */
320
+ exportSubject?: ResourceSystemAccessMode,
321
+ };
322
+
323
+ /**
324
+ * WHO a row of this resource is with respect to an erasure, and where that person's session lives.
325
+ * The companion of {@link ResourceRetentionPolicy}: retention says what happens to the ROW and whether
326
+ * the row holds personal data at all; this says **whose SESSION an erasure of it must end**.
327
+ *
328
+ * The two are independent, and reading this one as "is the row about a person" is the mistake that
329
+ * cost `NO_PRINCIPAL` its previous name — see {@link ResourceDataSubjectKind}. A CRM contact holds
330
+ * personal data (`RETAIN_AND_IMPERSONALIZE`) and has no session (`NO_PRINCIPAL`); an invoice holds
331
+ * none (`RETAIN_ONLY`) and also has no session. Same value here, opposite compliance meaning, and the
332
+ * retention mode is what tells them apart.
333
+ *
334
+ * Required on every resource declaring a {@link ResourceRetentionPolicy}, because those are exactly
335
+ * the resources that can be passed to `eraseSubjectAsSystem` as a subject (the orchestrator refuses a
336
+ * subject with no retention policy). Undeclared fails at config build rather than defaulting: the safe
337
+ * default is unknowable — guessing `NO_PRINCIPAL` silently drops a real person's revocation, and
338
+ * guessing a linked principal revokes the wrong people. See {@link ResourceDataSubjectKind} for why
339
+ * the linkage can never be inferred from the presence of a user foreign key.
340
+ */
341
+ export interface ResourceDataSubjectPolicy {
342
+ /** Whose login session an erasure of this row must end — never whether the row is about a person. */
343
+ kind: ResourceDataSubjectKind;
344
+ /**
345
+ * The field naming the `USERS` row whose session an erasure of this row must end.
346
+ *
347
+ * REQUIRED when {@link kind} is `LINKED_PRINCIPAL`, and FORBIDDEN otherwise — under
348
+ * `SELF_PRINCIPAL` the row's own id is the principal, and under `NO_PRINCIPAL` there is no
349
+ * principal at all, so a field there would be a contradiction rather than redundancy. Both
350
+ * directions are enforced at config build.
351
+ */
352
+ sessionPrincipalField?: string;
353
+ }
354
+
355
+ /*
356
+ * `ResourceRetentionPolicy` — maintainer notes, kept OUTSIDE the anchored contract below because they cite
357
+ * repository test files an application cannot see. (This block used to sit orphaned above
358
+ * `ResourceDataSubjectPolicy`'s JSDoc, attached to nothing.)
359
+ *
360
+ * Resource-level opt-in to the **impersonalization-on-erasure** capability: on erasure the
361
+ * resource is impersonalized-and-retained (personal fields scrubbed, row kept for a legal/audit
362
+ * obligation) instead of hard-deleted. When set, the factory injects a `retentionStatus` marker
363
+ * and derives the `updateMany` + `seeRetained` system-access grants.
364
+ *
365
+ * RESOURCE-level (intrinsic, trigger-agnostic). The per-EDGE trigger is
366
+ * `onParentDelete.strategy = IMPERSONALIZE_AND_RETAIN`; the per-FIELD scrub is `.impersonalizeWith()`.
367
+ *
368
+ * **LIVE — opting in has real effect today.** The marker + derived grants, the in-place scrub writer,
369
+ * the `IMPERSONALIZE_AND_RETAIN` cascade mode and the hidden-by-default read filter all exist and are
370
+ * enforced. A RETAINED row is invisible to reads, lists, counts and CHART aggregates, and immutable
371
+ * to ordinary writes, on BOTH persistence adapters; the only door is the audited see-through path.
372
+ *
373
+ * Runtime-proven, not asserted — and scoped precisely, because an earlier revision of this block
374
+ * over-claimed it. Against a real MongoDB, the erasure orchestrator reaches its terminal path and its
375
+ * receipt is truthful over a registered subset of resources
376
+ * (`subject-erasure-completion.mongo.integration.test.ts`); the retention OUTCOME and a SECOND erasure
377
+ * are observed (`subject-impersonalization-retention-outcome.mongo.integration.test.ts`); and a
378
+ * retained row is absent from a real application chart over real HTTP
379
+ * (Your Application `e2e/chart-retention-hide.e2e.ts`).
380
+ *
381
+ * What is NOT proven: that an erasure completes over the FULL `onParentDelete` closure, and that
382
+ * external (provider-side) effects run. The completion lane deliberately requires
383
+ * `declinedEdges.length > 0`, so it asserts a state in which some edges were NOT executed, and
384
+ * `externalEffects` is stubbed empty. Do not read "runtime-proven" here as end-to-end completeness.
385
+ *
386
+ * (This block previously read "Contract only in this phase … No record is impersonalized-and-retained
387
+ * yet." That was true when written and became false without being revisited — it is the public
388
+ * authoring contract an app developer reads before declaring this policy, so it is corrected here
389
+ * rather than left to mislead.)
390
+ *
391
+ * ⚠️ NOT the anonymous-user concept (`isAnonymizable` is pre-auth ownership transposition — the
392
+ * opposite direction). Reuse of that mechanism, never its name.
393
+ */
394
+ /**
395
+ * `retentionPolicy` on a resource configuration — what a subject ERASURE does to this resource's rows, and,
396
+ * for a record a statute keeps, on what ground and for how long it survives one.
397
+ *
398
+ * Imported from `@wildo-ai/saas-models`. Declaring it requires a `dataSubjectPolicy` and a service-resolvable
399
+ * `UPDATE_MANY`, `READ` and `LIST`; the factory injects the `retentionStatus` marker every retained row carries.
400
+ *
401
+ * @example A statutory business record — kept through an erasure, restricted, until its period ends
402
+ * ```ts
403
+ * retentionPolicy: {
404
+ * mode: ErasureRetentionMode.RETAIN_ONLY,
405
+ * statutoryRetention: { ground: StatutoryRetentionGround.LEGAL_OBLIGATION, rationale: 'HGB §257(1) no. 4, AO §147(1)' },
406
+ * },
407
+ * dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
408
+ * retentionBinding: { retentionClass: DataRetentionClass.BUSINESS_RECORDS, startPoint: RetentionStartPoint.END_OF_CALENDAR_YEAR },
409
+ * ```
410
+ */
411
+ export interface ResourceRetentionPolicy {
412
+ /**
413
+ * WHAT happens to a row of this resource when its subject is erased.
414
+ *
415
+ * Both modes retain the row (kept, marked `RETAINED`, hidden from normal reads and immutable,
416
+ * readable only through the audited see-through path). They differ on whether the row's own FIELDS
417
+ * additionally need scrubbing — which is a genuinely separate question, because a record can be
418
+ * legally retainable while holding no personal data of its own (a financial row that merely POINTS
419
+ * at a person). Fusing the two forced such a resource to either invent a fake scrub or forgo
420
+ * retention entirely; keeping them distinct is what makes "retain, nothing to scrub" expressible.
421
+ */
422
+ mode: ErasureRetentionMode;
423
+ /**
424
+ * WHY an erasure may not delete these rows yet: the law requires them kept (#1635).
425
+ *
426
+ * Declared by a resource bound to `DataRetentionClass.BUSINESS_RECORDS` — and REQUIRED there: the factory
427
+ * refuses that binding without it, and refuses this member on any other class. A subject erasure then
428
+ * RESTRICTS each row still inside its statutory period instead of treating it as the author's choice:
429
+ * the row is kept with {@link mode}'s treatment (flipped to `RETAINED`, so hidden from every ordinary
430
+ * read and refused every ordinary write — the GDPR Art. 18(2) effect), listed in the erasure report
431
+ * with this ground and the instant its period ends, and deleted by the retention-class sweep when it
432
+ * does. Every other row of the request is erased as usual; the request is never refused for these.
433
+ *
434
+ * ## The PERIOD is not here, on purpose
435
+ *
436
+ * How long the rows are kept is `dataRetention[BUSINESS_RECORDS].retentionDays`, counted from the
437
+ * resource's `retentionBinding.startPoint`. A second number on this declaration would be a second
438
+ * authority for one period, and the two would drift.
439
+ *
440
+ * ## One erasure authority
441
+ *
442
+ * This lives INSIDE `retentionPolicy` rather than beside it: `retentionPolicy` is the declaration whose
443
+ * whole subject is what an erasure does to a row, and a separate "erasure exemption" beside it would give
444
+ * one row two erasure authorities.
445
+ */
446
+ statutoryRetention?: ResourceStatutoryRetention;
447
+ }
448
+
449
+ /**
450
+ * The legal ground on which a {@link ResourceRetentionPolicy} keeps its rows through an erasure, and the
451
+ * operator's words for it (#1635).
452
+ */
453
+ export interface ResourceStatutoryRetention {
454
+ /** The GDPR Art. 17(3) exemption relied on. One member today — see {@link StatutoryRetentionGround}. */
455
+ ground: StatutoryRetentionGround;
456
+ /**
457
+ * WHICH statute, in the operator's words — "HGB §257(1) no. 4 and AO §147(1): accounting source documents,
458
+ * 8 years from the end of the calendar year". Required and non-empty: an operator telling a data subject
459
+ * why a record was kept (Art. 12(4)) has to be able to name the law, and a ground with no law named is a
460
+ * claim nobody can check.
461
+ */
462
+ rationale: string;
463
+ }
464
+
465
+ /**
466
+ * Resource-level DEFAULT for where this resource's field values came from — the axis that decides
467
+ * GDPR Art. 20 (portability) scope. Per-field overrides are `.portabilityProvenance()`.
468
+ *
469
+ * ## Why a resource-level default exists at all
470
+ *
471
+ * Art. 20 is intrinsically a per-FIELD question: one row routinely mixes data the subject supplied
472
+ * (`firstName`) with data the controller produced about them (a computed score, a server-assigned
473
+ * status). But requiring a decorator on EVERY field of every resource would make the capability
474
+ * unadoptable, and an unadopted disclosure capability is worse than a coarse one — it means
475
+ * portability requests cannot be answered at all.
476
+ *
477
+ * So the declaration is two-level: this default carries the resource's common case in one line, and
478
+ * only fields that DIFFER from it need a decorator. A `USER_PROFILES` resource is
479
+ * `SUBJECT_PROVIDED` by default with a handful of derived exceptions; an `AUDIT_LOGS` resource is
480
+ * `DERIVED` throughout with none.
481
+ *
482
+ * ## Why it is optional, and what happens without it
483
+ *
484
+ * Omitting it entirely is legitimate: **Art. 15 (access) never consults provenance**, so an
485
+ * application can answer access requests in full before annotating anything. Only an Art. 20
486
+ * portability export needs the axis, and for a resource where neither the field nor this default
487
+ * declares one, that export REFUSES rather than guessing — see
488
+ * `SubjectExportFieldScope.UNDECLARED` for why neither guess is the safe one.
489
+ *
490
+ * ⚠️ NOT `retentionPolicy`. That says what happens to a value on ERASURE (destroy vs retain-and-
491
+ * scrub); this says where the value ORIGINATED, for a DISCLOSURE decision. A field is commonly
492
+ * `SUBJECT_PROVIDED` here and masked on erasure there — orthogonal axes on the same value.
493
+ */
494
+ export interface ResourcePortabilityPolicy {
495
+ /**
496
+ * The provenance every field of this resource is assumed to carry unless its own
497
+ * `.portabilityProvenance()` says otherwise.
498
+ */
499
+ defaultProvenance: DataPortabilityProvenance;
500
+ }
501
+
502
+ /**
503
+ * Builder parameters for creating a resource configuration.
504
+ * NOTE: databaseSchema has been removed. Backend-only fields are now marked with
505
+ * the isBackendOnly decorator in mainSchema and are stripped at the service layer.
506
+ */
507
+ export type ResourceConfiguration_BuilderParameters<
508
+ TCustomOperationEnum extends EnumLikeType | undefined,
509
+ TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined,
510
+ TMainSchema extends z.ZodTypeAny,
511
+ > = {
512
+ isDisabled?: boolean, // default false
513
+ mainSchema: TMainSchema,
514
+ resourceIdentifier : ResourceType,
515
+ resourceFieldIdentifier : ResourceFieldIdentifier,
516
+ resourceRelationships : ResourceRelationship[],
517
+ inheritenceSchemaDefinition?: ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType,TMainSchema>,
518
+
519
+ /**
520
+ * Persistence adapter (database type) for this resource.
521
+ * - `mongodb`: MongoDB with Mongoose ORM
522
+ * - `postgresql`: PostgreSQL (SQL adapter)
523
+ *
524
+ * If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
525
+ * should stay the normal case.
526
+ *
527
+ * **Declaring a value that DISAGREES with the application default is refused at registration
528
+ * unless {@link ResourceConfiguration_BuilderParameters.persistenceAdapterIsolation} is also
529
+ * declared.** An application is wholly one adapter by default because two adapters cannot
530
+ * share a native transaction; the isolation declaration is the only way past that refusal,
531
+ * and it is a claim about this resource's write topology rather than a way to silence the
532
+ * error. Declaring an adapter that AGREES with the default is always fine and needs nothing.
533
+ */
534
+ persistenceAdapter?: PersistenceAdapterType,
535
+
536
+ /**
537
+ * This resource's declared relationship to cross-adapter atomic write boundaries.
538
+ *
539
+ * Required — and only meaningful — when {@link
540
+ * ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
541
+ * `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
542
+ * application at startup; with it, the registry admits the resource and LOGS the admitted
543
+ * set, so a mixed configuration is always named and never ambient.
544
+ *
545
+ * Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
546
+ * assertion about the resource's design that the persistence unit of work will still enforce
547
+ * at every real boundary.
548
+ */
549
+ persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
550
+
551
+ /**
552
+ * REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
553
+ *
554
+ * Carries everything the external repository needs that the platform does not own: provider
555
+ * reference (credentials resolve through `ExternalProvidersRegistryBackendService`), transport
556
+ * dialect, remote entity, ordered key declaration (id synthesis), identity mode, tenancy
557
+ * stance, erasure stance, and remote-call semantics. The factory enforces presence/absence
558
+ * coherence and content-validates the declaration.
559
+ */
560
+ httpApiBinding?: HttpApiResourceBindingAuthored,
561
+
562
+ /** REQUIRED when `persistenceAdapter` is INTROSPECTION; meaningless otherwise. */
563
+ introspectionBinding?: IntrospectionResourceBinding,
564
+
565
+ /**
566
+ * OPTIONAL inbound ETL pipeline on an ordinary LOCAL resource — "some resources local, some
567
+ * remote, ETL between them" (partial-resource coverage, model v3; PR-3). FORBIDDEN on an
568
+ * HTTP_API-adapter resource: a virtual resource IS the remote side. The factory
569
+ * content-validates the declaration and every mainSchema-dependent coherence rule (the
570
+ * remote-key field is a declared `.isBusinessKey()` + excludeFromCreate/Update STRING; mapped
571
+ * targets exist, accept null unless `required`, and are excludeFromCreate/Update; CLOSED
572
+ * population refuses caller CREATE operations).
573
+ */
574
+ externalDataPipeline?: ExternalDataPipelineDeclarationAuthored,
575
+
576
+ isSystemResource?: boolean, // default false - true for core system resources (organizations, users, etc.), false for tenant-specific resources
577
+
578
+ /**
579
+ * Does this resource's OWN primary-key URL segment name the CALLER, or the SUBJECT?
580
+ *
581
+ * Default `true` (the segment names the caller) — deliberately the SAFE default, so a resource
582
+ * whose author has not considered the question keeps the identity-coherence guard rather than
583
+ * silently losing it.
584
+ *
585
+ * ## Why this cannot be inferred
586
+ *
587
+ * The W3.6 identity-coherence guard (`handleUserJwtAuthentication` →
588
+ * `AUTHORIZATION_USER_ID_MISMATCH`) refuses a request whose URL `userId` differs from the JWT
589
+ * subject. That is exactly right for `USER_SELF` (`/user-self/{userId}` — the segment IS the
590
+ * caller, pinned by the horizontal-IDOR probes) and for child routes under a user
591
+ * (`/users/{userId}/draft-notes` — a PARENT segment naming whose rows these are).
592
+ *
593
+ * It is exactly WRONG for `USERS`, whose own `resourceFieldIdentifier` is also `userId` but whose
594
+ * segment names the TARGET of an administrative action. Both resources are keyed on the same
595
+ * field name, so no structural rule can tell them apart — the framework already had to add
596
+ * `coreResourceShared_FieldIdentifierPriority` to disambiguate the very same collision for FK
597
+ * resolution. This declaration is that disambiguation for IDENTITY.
598
+ *
599
+ * ## What it does and does not change
600
+ *
601
+ * Setting `false` relaxes ONLY the coherence refusal. It does not touch:
602
+ * - `initiatorIds.userId`, which is taken from the JWT and spread LAST precisely so a URL can
603
+ * never spoof the caller (see the `W3.6` comment at that assignment) — so permitting the
604
+ * mismatch cannot produce impersonation;
605
+ * - the contextual-field map, which legitimately carries the ADDRESSED resource's id;
606
+ * - authorization, which still decides whether this caller may run this operation at all.
607
+ *
608
+ * Set `false` only for an administrative resource whose primary key is a person/tenant identifier
609
+ * that a privileged caller is MEANT to address on someone else's behalf.
610
+ */
611
+ primaryKeyIdentifiesInitiator?: boolean,
612
+
613
+ /**
614
+ * Opt-in policy for the ACL-bypassing system-context primitives
615
+ * (`readAsSystem` / `listAsSystem` and the trusted writes `createAsSystem` /
616
+ * `updateAsSystem` / `updateManyAsSystem`). Omitted ⇒ EVERY verb FORBIDDEN
617
+ * (fail-closed): a system-context call on this resource throws unless the
618
+ * matching verb is explicitly set to ALLOWED. Declare ONLY the verb(s) that
619
+ * genuinely need a system bypass, and ensure the calling service enforces an
620
+ * explicit alternative authorization.
621
+ */
622
+ systemAccessPolicy?: ResourceSystemAccessPolicy,
623
+
624
+ /**
625
+ * Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
626
+ * evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
627
+ * most resources are not, and an application that never built an erasure lane has declared none
628
+ * rather than failed a control. See {@link ResourceSubjectErasureLane}.
629
+ */
630
+ subjectErasureLane?: ResourceSubjectErasureLane,
631
+ coreOperations: TCoreOperationEnum[],
632
+ customOperation?: TCustomOperationEnum, // default undefined
633
+ operationsConfiguration : { [K in ValidOperationKeys<TCustomOperationEnum, TCoreOperationEnum>]: OperationConfig_ForKey<K, TMainSchema> }
634
+ /**
635
+ * Configuration for auto-generated operation variants.
636
+ * Controls which READ/LIST variants (summary, context) are auto-generated.
637
+ * All variants are enabled by default.
638
+ */
639
+ autoVariants?: ResourceConfiguration_AutoVariants,
640
+ // NOTE: responseSummaryDto removed - now auto-derived from isSummaryField() decorators in factory
641
+
642
+ /**
643
+ * W7.3a: Marks this resource as accessible to anonymous sessions.
644
+ * When true, the factory auto-generates dual URL paths (USER_SELF + ANONYMOUS)
645
+ * and a STANDALONE relationship to ANONYMOUS_USERS.
646
+ * The resource MUST have a nullable `userId` field.
647
+ */
648
+ isAnonymizable?: boolean,
649
+
650
+ /**
651
+ * W7.3a: Controls how anonymous resources are handled during transposition.
652
+ * Only meaningful when isAnonymizable is true.
653
+ * Defaults to ADD (simple ownership reassignment).
654
+ */
655
+ transpositionPolicy?: ResourceTranspositionPolicy,
656
+
657
+ /**
658
+ * Opt in to impersonalization-on-erasure (retain + scrub instead of hard-delete). When set, the
659
+ * factory injects a `retentionStatus` marker and derives the `updateMany` / `seeRetained`
660
+ * system-access grants. Per-field scrub is `.impersonalizeWith()`; the per-edge trigger is the
661
+ * `IMPERSONALIZE_AND_RETAIN` cascade mode.
662
+ *
663
+ * **LIVE.** Marker injection, grant derivation, the scrub writer, the cascade mode and the
664
+ * hidden-by-default read filter are all enforced today — see `ResourceRetentionPolicy` for the
665
+ * runtime evidence. Declaring this changes behaviour; it is not a forward declaration.
666
+ *
667
+ * Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
668
+ * one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
669
+ * a person — and if so, whose session an erasure ends.
670
+ */
671
+ retentionPolicy?: ResourceRetentionPolicy,
672
+
673
+ /**
674
+ * WHO a row of this resource is with respect to an erasure — and, when it is a person, which field
675
+ * names the `USERS` row whose session that erasure must end.
676
+ *
677
+ * Mandatory for any resource declaring a {@link retentionPolicy}; meaningless (and rejected) without
678
+ * one, since a resource with no retention policy can never be an erasure subject. See
679
+ * {@link ResourceDataSubjectPolicy}.
680
+ */
681
+ dataSubjectPolicy?: ResourceDataSubjectPolicy,
682
+
683
+ /**
684
+ * How long this resource's rows are KEPT: a binding to one of the application's declared retention
685
+ * classes, and the moment each row's clock starts. An engine sweep deletes a bound row once its
686
+ * class's `retentionDays` have passed since that start point, through the service layer, on both
687
+ * persistence adapters.
688
+ *
689
+ * ⚠️ NOT {@link retentionPolicy}. That is what an ERASURE does to a row (delete, or retain and
690
+ * scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
691
+ * deleted when its class period ends.
692
+ *
693
+ * Optional. An unbound resource is kept until it is erased, and is reported as unbound
694
+ * (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
695
+ * may not also declare a `.ttl()` field — one row, one retention authority.
696
+ *
697
+ * {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
698
+ */
699
+ retentionBinding?: ResourceRetentionBinding,
700
+
701
+ /**
702
+ * Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
703
+ * are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
704
+ * application can answer access requests without declaring this. See
705
+ * {@link ResourcePortabilityPolicy}.
706
+ */
707
+ portabilityPolicy?: ResourcePortabilityPolicy,
708
+
709
+ /**
710
+ * Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
711
+ * matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
712
+ * application can compute its cost per case (#1598), and expert decisions on agent work name it (#1599).
713
+ *
714
+ * A reference to a case is a `WorkUnitRef` (`{ resourceType, resourceId }`), and the engine accepts one at a
715
+ * service boundary only when `resourceType` names a resource declaring `workUnit: true` and the caller can
716
+ * READ that row. Several resources of one application may be work units. Default `false`.
717
+ *
718
+ * The engine opens the case frame by itself around every single-row operation on a work-unit resource (and
719
+ * around a CREATE once the new row's id is assigned, before its after-create hooks), so a model call made
720
+ * by a hook, a tool or a queued job started there is attributed without the application passing anything.
721
+ */
722
+ workUnit?: boolean,
723
+ }
724
+ ```
725
+
726
+ ## System-access policy (where `exportSubject` lives)
727
+
728
+ ## Import Origins
729
+
730
+ - `@wildo-ai/saas-models`
731
+
732
+ ## Source Excerpts
733
+
734
+ ### Origin Package: `@wildo-ai/saas-models`
735
+
736
+ ```typescript
737
+ *
738
+ * Access mode for the ACL-bypassing system-context reads
739
+ * (`SystemAccessBackendService.readAsSystem` / `listAsSystem`, from
740
+ * `@wildo-ai/saas-backend-lib`).
741
+ *
742
+ * Those primitives run with a synthesised super-admin execution context and
743
+ * therefore SKIP the caller's scope and role checks entirely. A resource is
744
+ * readable that way ONLY if its resource configuration opts the verb in. Any
745
+ * verb left undeclared defaults to `FORBIDDEN`: a system read of a resource
746
+ * that has not opted in throws `ErrorType.CONFIGURATION` — the framework is
747
+ * fail-closed here by construction.
748
+ */
749
+ export enum ResourceSystemAccessMode {
750
+ /** The verb's system-context primitive is rejected for this resource (default). */
751
+ FORBIDDEN = 'FORBIDDEN',
752
+ /** The verb's system-context primitive is permitted for this resource. */
753
+ ALLOWED = 'ALLOWED',
754
+ }
755
+
756
+ /**
757
+ * Per-resource opt-in policy for the ACL-bypassing system-context primitives
758
+ * on `SystemAccessBackendService`: the reads (`readAsSystem` / `listAsSystem`)
759
+ * and the trusted writes (`createAsSystem` / `updateAsSystem` /
760
+ * `updateManyAsSystem`).
761
+ *
762
+ * A system-context call does not REMOVE the authorization decision — it
763
+ * RELOCATES it from the resource ACL onto the calling service, which MUST
764
+ * enforce an explicit alternative check (e.g. consumable-token or
765
+ * email-ownership matching). Declaring this policy is the data owner's
766
+ * statement that such a bypass is permissible at all, and for which verb. An
767
+ * absent policy — or a verb set to (or left defaulting to) `FORBIDDEN` — makes
768
+ * the primitive throw.
769
+ *
770
+ * The WRITE verbs additionally let a trusted in-process caller persist the
771
+ * fields the client-shaped request DTO strips — `.isBackendOnly()` material
772
+ * (e.g. a credential `passwordHash`) and the context-auto-populated FKs (e.g.
773
+ * `userId` on a system resource that has no HTTP surface to seed it) — by
774
+ * re-attaching exactly those fields after the strict parse. They are the
775
+ * sanctioned path for engine flows like registration that must write system
776
+ * resources directly; opting a verb in is the data owner's acknowledgement that
777
+ * a super-admin-context mutation of this resource is legitimate.
778
+ *
779
+ * Caveats a system-context call inherits (it runs as super-admin), to weigh
780
+ * before opting in:
781
+ * - a READ returns the FULL record — every field, including ones a normal
782
+ * caller's role / field-visibility would hide — so never forward the result
783
+ * verbatim to an under-privileged caller; project only what is safe.
784
+ * - a WRITE bypasses the caller's scope + role ACL, so the calling service
785
+ * owns the authorization decision (only trusted engine code can reach the
786
+ * primitive — it is never exposed to an HTTP payload).
787
+ * - feature flags do not gate it (it is an internal request).
788
+ * - the policy is RESOURCE-LEVEL: for a polymorphic resource it is shared by
789
+ * every scope variant (declare it once on the shared config).
790
+ *
791
+ * Intentionally DISTINCT from `isSystemResource`: marking a resource as
792
+ * framework infrastructure does NOT imply that an ACL bypass is acceptable
793
+ * for its data. Keep the two concepts separate.
794
+ */
795
+ /**
796
+ * Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
797
+ *
798
+ * ## Why the application declares it rather than the framework knowing it
799
+ *
800
+ * The erasure lane is application-owned — four of the five marked sites for
801
+ * `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
802
+ * (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
803
+ * status vocabulary are the application's, so a collector queries it against that application's
804
+ * specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
805
+ * that is one application's modelling choice"*.
806
+ *
807
+ * So a collector may not know that a request is raised through a field called `channel` carrying a
808
+ * value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
809
+ * existed, three clauses of that demand had a durable row holding every fact they wanted and no way
810
+ * to find it (#1209): not a missing control, a control nobody could point at.
811
+ *
812
+ * ## It binds FIELDS, never values the framework invents
813
+ *
814
+ * Every member below names something the application already authored. The one value the
815
+ * declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
816
+ * application's OWN enum member, quoted back so a reader can tell the two populations apart. The
817
+ * framework supplies no vocabulary here and must never grow one.
818
+ *
819
+ * ## What is deliberately NOT declared
820
+ *
821
+ * The SCHEDULE. C3 asks that requests be executed on the declared schedule, and that schedule is
822
+ * already on the executing operation's `CRON_JOB` variant (`cronExpression`) — declaring it again
823
+ * here would be a second copy that can only ever disagree with the one the scheduler reads.
824
+ * `executionOperationIdentifier` names the operation; the schedule is read from it.
825
+ */
826
+ export type ResourceSubjectErasureLane = {
827
+ /**
828
+ * How a row says WHO raised the request — the subject exercising their own right, or the
829
+ * controller acting on their behalf. C1's whole obligation is that the two are distinguishable.
830
+ */
831
+ raisedBy: {
832
+ /** The field carrying it. Must be a persisted field of this resource. */
833
+ fieldName: string,
834
+ /**
835
+ * The value of that field meaning the SUBJECT raised it themselves. Every other value is read as
836
+ * controller-raised — stated this way round because a lane may grow a second controller channel
837
+ * without the declaration going stale, whereas enumerating the controller values could not.
838
+ */
839
+ subjectValue: string,
840
+ },
841
+ /**
842
+ * The field carrying WHICH user raised a controller-raised request.
843
+ *
844
+ * Omitting it is a positive claim, not a gap: it says this lane admits no controller-raised
845
+ * request at all. A collector reads it that way and a row carrying a non-subject value then
846
+ * contradicts the declaration, which is a finding about the application rather than about the
847
+ * evidence.
848
+ */
849
+ requesterFieldName?: string,
850
+ /** The field carrying the justification a controller-raised request was made on, where the lane records one. */
851
+ justificationFieldName?: string,
852
+ /** The field carrying the instant the request was executed or failed. C3 judges execution against it. */
853
+ completedAtFieldName: string,
854
+ /** The field carrying what the execution did. Its vocabulary is the application's. */
855
+ outcomeFieldName: string,
856
+ /**
857
+ * The operation a SUBJECT uses to withdraw their own pending request (C2). Named rather than
858
+ * inferred: "the operation that cancels" is not derivable from an operation vocabulary, and
859
+ * guessing it would make the evidence depend on a naming convention no application agreed to.
860
+ */
861
+ withdrawalOperationIdentifier: string,
862
+ /**
863
+ * How a WITHDRAWN row is recognisable afterwards — the same shape as {@link raisedBy}, and for the
864
+ * same reason: the vocabulary is the application's.
865
+ *
866
+ * C2 asks for the withdrawal door AND for "any cancelled rows", and those are two different
867
+ * questions. The door is answered from {@link withdrawalOperationIdentifier} — is the operation
868
+ * reachable to a subject while the request is pending — and needs no data at all. The rows need a
869
+ * marker, and there is nothing to derive one from: withdrawal and execution both leave a request in
870
+ * a terminal state, so a reader that knows only `completedAtFieldName` cannot tell "the subject
871
+ * changed their mind" from "the sweep ran".
872
+ *
873
+ * OPTIONAL, because an application may not model withdrawal as a value at all — it may delete the
874
+ * row, or move it. Omitting it says the count is unavailable, and a collector reports that rather
875
+ * than guessing; it never turns into a zero, which would read as "nobody withdrew anything".
876
+ *
877
+ * Note an EMPTY withdrawal set is explicitly not a deficiency in the demand — people do not have
878
+ * to change their minds — so this exists to make the number REPORTABLE, never to make it a target.
879
+ */
880
+ withdrawnMarker?: {
881
+ /** The field carrying it. Must be a persisted field of this resource. */
882
+ fieldName: string,
883
+ /** The value of that field meaning the SUBJECT withdrew the request before it executed. */
884
+ withdrawnValue: string,
885
+ },
886
+ /** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
887
+ executionOperationIdentifier: string,
888
+ };
889
+
890
+ export type ResourceSystemAccessPolicy = {
891
+ /** Governs `readAsSystem`. Omitted ⇒ FORBIDDEN. */
892
+ read?: ResourceSystemAccessMode,
893
+ /** Governs `listAsSystem`. Omitted ⇒ FORBIDDEN. */
894
+ list?: ResourceSystemAccessMode,
895
+ /** Governs `createAsSystem`. Omitted ⇒ FORBIDDEN. */
896
+ create?: ResourceSystemAccessMode,
897
+ /** Governs `updateAsSystem`. Omitted ⇒ FORBIDDEN. */
898
+ update?: ResourceSystemAccessMode,
899
+ /** Governs `updateManyAsSystem`. Omitted ⇒ FORBIDDEN. */
900
+ updateMany?: ResourceSystemAccessMode,
901
+ // NOTE: there is deliberately NO `delete` verb here — there is no `deleteAsSystem` primitive. A row is
902
+ // removed either through its own DELETE operation ACL (e.g. an owner-facing `API_CALL` DELETE under the
903
+ // USER_SELF owner filter) or by the `onParentDelete` composition cascade (which deletes at the raw
904
+ // repository layer, variant-agnostic — see `deleteChildrenImmediate`). If you find yourself reaching
905
+ // for `systemAccessPolicy.delete`, model the removal as one of those two instead.
906
+ /**
907
+ * Governs the impersonalization see-through reads (`readRetainedAsSystem` /
908
+ * `listRetainedAsSystem`) — the privileged, audited path that reveals
909
+ * `retentionStatus = RETAINED` rows hidden-by-default. Omitted ⇒ FORBIDDEN.
910
+ * Auto-derived to `ALLOWED` by the factory when a resource opts into
911
+ * `retentionPolicy`; never authored by hand in the common case.
912
+ *
913
+ * **LIVE, and REACHABLE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
914
+ * the verb is asserted fail-closed, a privileged human role is required, and every reveal emits a
915
+ * human-attributed `RETAINED_DATA_ACCESS` audit event.
916
+ *
917
+ * "Reachable" is the half that was missing until #490, and the distinction is worth keeping. The
918
+ * primitives were correct and enforced from the day M5b landed — and had **no caller**, so the only
919
+ * route an operator actually had to a retained record was a database console: the unaudited path
920
+ * they were built to replace. `users | read_retained` is the operator surface that closes it, an
921
+ * authenticated `APP_ADMIN_SUPER_ADMIN` operation carrying a mandatory justification.
922
+ *
923
+ * A resource that derives this grant and exposes no such operation is reachable by nothing. That
924
+ * is a defensible state — not every retention resource needs an operator door — but it should be a
925
+ * decision rather than an oversight, and `retained-see-through-operator-surface.test.ts` is what
926
+ * makes it one.
927
+ *
928
+ * (This block previously said the primitives were "wired in a later phase" — false since M5b.)
929
+ */
930
+ seeRetained?: ResourceSystemAccessMode,
931
+
932
+ /**
933
+ * May this resource's rows be swept into a SUBJECT EXPORT bundle (GDPR Art. 15 / Art. 20)?
934
+ *
935
+ * Fail-closed by omission, like every other verb here. A subject export reads across the whole
936
+ * child-direction graph of its subject, so without an explicit opt-in a resource could be
937
+ * disclosed to a data subject because it merely sits on an edge — nobody having decided that its
938
+ * contents are appropriate to hand over.
939
+ *
940
+ * **The refusal is LOUD, not a silent skip.** When an edge the classifier marked for inclusion
941
+ * belongs to a resource that has not opted in, the export REFUSES and names it. Silently dropping
942
+ * it would produce an access bundle that is incomplete without saying so — a disclosure failure
943
+ * wearing the appearance of a successful response, which is the same class of lie as the routed
944
+ * export operations this capability replaced. Refusing is a one-line fix per resource; a silent
945
+ * omission is undetectable.
946
+ *
947
+ * NOT derived from `portabilityPolicy`: declaring where fields came from (Art. 20 scoping) and
948
+ * consenting to be disclosed at all are different decisions, and a resource may legitimately want
949
+ * the first without the second.
950
+ */
951
+ exportSubject?: ResourceSystemAccessMode,
952
+ };
953
+ ```