@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (812) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -35,10 +35,13 @@ everything below:
35
35
  derives every generated artifact from it. Hand-editing
36
36
  `docker-compose.wildo-platform.yml` is always wrong — the next sync
37
37
  overwrites it.
38
- 2. **Generated artifacts self-heal.** `wildo local up` runs a pre-flight
39
- that regenerates missing `config.json`, `docker-compose.wildo-platform.yml`,
40
- and `.env.wildo-platform` from the authored config. You should never
41
- have to author those by hand.
38
+ 2. **Generated artifacts self-heal.** `wildo local up` and `wildo local dev`
39
+ run a pre-flight that re-derives `config.json` whenever it no longer matches
40
+ the authored config, and renders `docker-compose.wildo-platform.yml` and
41
+ `.env.wildo-platform` on every start, rewriting each when its content changed.
42
+ An edit to the authored config, to `secrets.json` or to the framework's compose
43
+ template therefore takes effect on the next start, and you should never have
44
+ to author those files by hand.
42
45
  3. **Initialization is executable, not marker-based.** `wildo local init`
43
46
  converges generated artifacts, backing-service readiness, platform database
44
47
  state, native platform processes, one application registration snapshot,
@@ -60,7 +63,7 @@ what regenerates it.
60
63
  |------|----------|-------|----------------|-----------------|
61
64
  | **Authored** (in git) | `./infrastructure/local/wildo.infra.local.config.ts` or `./infrastructure/<env>/wildo.infra.remote.config.ts`, `./wildo.saas.config.ts` | You (the app developer) | Never — hand-edited | No — version-controlled truth |
62
65
  | **Authored secrets** (out of git) | `./infrastructure/<env>/secrets/secrets.json` (or your chosen secrets path) | You + the `wildo setup` wizard | Setup and ordinary non-CI sync can provision missing material or regenerate incomplete credential groups; complete existing groups are preserved without explicit rotation | No by default — destructive rotation is opt-in |
63
- | **Generated runtime artifacts** | `./.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/.env.wildo-platform` | The `wildo` CLI | `wildo local init` / `wildo local up` (self-heal missing files) or scoped `wildo config sync` | Yes — they regenerate from the authored sources |
66
+ | **Generated runtime artifacts** | `./.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/.env.wildo-platform` | The `wildo` CLI | `wildo local init` / `wildo local up` / `wildo local dev` (re-derive a missing or stale one) or scoped `wildo config sync` | Yes — they regenerate from the authored sources |
64
67
  | **Local state + data** | `./.wildo-saas/state/environments.json`, `./.wildo-saas/local_data/<service>/`, `./.wildo-saas/runtime-signals/` | The `wildo` CLI + dev companion | `wildo local init` recreates runtime state; data accumulates across non-destructive restarts | State: yes; **data: only through `wildo local reset` or `wildo local reinit`** after processes and containers stop |
65
68
 
66
69
  **Rule of thumb:** If the file lives under `./.wildo-saas/` it is generated
@@ -135,14 +138,14 @@ the user's situation, including whether another application owns the running pla
135
138
  | This application's `wildo.infra.<env>.config.ts` declares an `infrastructureHost` | Start the platform FROM THE HOST (`cd <host> && wildo local dev`), then `wildo local init` and `wildo local dev` here — both register and attach only |
136
139
  | "Add this application while another application uses the running platform" | `wildo local init --register-only` (application registration and runtime projections only; existing healthy platform required) |
137
140
  | "Initialize this project" / "repair broken Mongo-mounted platform state" | `wildo local init` (canonical non-destructive convergence + executable verification) |
138
- | "Start my local stack" / "spin up only the dev infra" | `wildo local up` (infra only; self-heals missing artifacts) |
141
+ | "Start my local stack" / "spin up only the dev infra" | `wildo local up` (infra only; re-derives missing or stale generated artifacts) |
139
142
  | "Stop the stack but keep my local data" | `wildo local down` |
140
143
  | "Wipe everything and return to a verified initialized project" | Framework developers: `wildo local reinit`. Application creators: explicitly authorized `wildo local reset`, then separate `wildo local init` |
141
144
  | "Stop everything and leave it empty" | `wildo local reset` |
142
145
  | "Remove this application from the platform" / "stop scheduling a dead application" | `wildo local deregister` (withdraws the schedule, REVOKES every credential, keeps the data); `--check` first to see what the platform still holds |
143
146
  | "Bring a withdrawn application back" | `wildo local restore` (re-mints the revoked credentials, then start the application) |
144
- | "I edited `wildo.infra.<env>.config.ts` and need to re-render compose" | `wildo config sync --domain manifest` then `wildo local up` (or just `wildo local up` — it will re-render if the file is missing) |
145
- | "I edited an existing local environment’s backing service or public address" | `wildo config sync` reconciles supported authored local state before rendering; use `wildo setup` for initial state/secrets or a reported unsupported setup path |
147
+ | "I edited `wildo.infra.<env>.config.ts` and need to re-render compose" | Just `wildo local up` / `wildo local dev`: a changed descriptor rewrites `config.json`, and compose and `.env.wildo-platform` are rendered on every start and rewritten when their content changes. `wildo config sync --domain manifest` also works |
148
+ | "I edited an existing local environment’s backing service or public address" | Just `wildo local up` / `wildo local dev`, as in the row above; `wildo config sync` also reconciles it. Use `wildo setup` only for initial state/secrets or a reported unsupported setup path |
146
149
 
147
150
  If the user is describing a symptom rather than an action ("the dev
148
151
  companion can't reach mongodb", "the stack won't start"), read
@@ -469,7 +472,7 @@ setup; supported local edits can be refreshed by config sync.
469
472
  | Rationalization | Reality |
470
473
  |-----------------|---------|
471
474
  | "Full init refuses while another app is running; I should stop it" | For second-app onboarding, use `wildo local init --register-only` with existing config/secrets and a healthy platform. The live-owner refusal protects shared services; it does not require an outage for application registration. |
472
- | "I'll just hand-edit `docker-compose.wildo-platform.yml` to add the missing service" | The file is regenerated from `wildo.infra.<env>.config.ts` on every `wildo config sync` and on every self-heal pass of `wildo local up`. Add the service to the **authored** config and run `wildo config sync` for supported local state, then the intended startup command. Inspect any skipped/unsupported result; initial or missing setup state still requires `wildo setup`. Hand edits to generated files are silently overwritten — and the developer who comes after you will not know why the change reverted. |
475
+ | "I'll just hand-edit `docker-compose.wildo-platform.yml` to add the missing service" | The file is regenerated from `wildo.infra.<env>.config.ts` on every `wildo config sync`, and by `wildo local up` / `wildo local dev` whenever its input changed. Add the service to the **authored** config and run `wildo config sync` for supported local state, then the intended startup command. Inspect any skipped/unsupported result; initial or missing setup state still requires `wildo setup`. Hand edits to generated files are silently overwritten — and the developer who comes after you will not know why the change reverted. |
473
476
  | "`wildo local up` says config.json is missing — let me create it manually" | Creating `config.json` by hand drifts it from the authored truth and from the schema. The CLI's runtime-bootstrap pre-flight regenerates `config.json` from `wildo.infra.<env>.config.ts` automatically when it is missing — re-running `wildo local up` rebuilds it. If the pre-flight fails, the right fix is to make the authored config valid, not to fabricate the generated artifact. |
474
477
  | "`--force` will fix it; it always works" | `--force` is command-specific: on setup it requests reconfiguration, not credential rotation; other commands may use it to skip confirmations. It does NOT substitute for an explicit destructive-operation flag. Using `--force` to "make it work" without understanding what it will overwrite leads to silent rotation of generated artifacts, not silent rotation of secrets — but it also conditions you to ignore the prompts you should be reading. Read the prompt; pick the explicit flag. |
475
478
  | "I'll delete `secrets.json` and let `wildo setup` recreate it" | Deleting `secrets.json` is the most destructive action available — it rotates every credential the file holds, breaking any deployed environment that shares them and forcing re-issuance of OIDC client secrets, S3 access keys, JWT signing material, etc. Use `wildo config sync --rotate-secrets` only when rotation is the *intent*, not as a recovery mechanism. For recovery, restore from the secrets backup or from a teammate's checkout. |
@@ -33,7 +33,7 @@ Four facts govern every row below:
33
33
  refusal go away.
34
34
  - **Regenerating is safe.** `wildo config sync` never rotates a secret unless you pass
35
35
  `--rotate-secrets`; it only adds framework-managed secrets that are missing. Apart from that, the
36
- one authored file it can change is a backend `package.json` (and the root `pnpm.overrides`), when
36
+ one authored file it can change is a backend `package.json` (and the root overrides in `pnpm-workspace.yaml`), when
37
37
  `systemsOfRecord` is declared and the library it needs is not: run `pnpm install` after that.
38
38
  Regenerating a current file changes nothing.
39
39
 
@@ -57,7 +57,7 @@ Four facts govern every row below:
57
57
  | `generated provider runtime artifact at … does not satisfy the current contract` | a `.wildo-saas/generated/providers/*.runtime-providers.generated.json` file | `wildo -y config sync --local` |
58
58
  | `generated before the contract changed. Regenerate it … and restart` · `The artifact is stale for this package` | `backend-api/src/generated/wildo-provider-runtime.generated.ts` | `wildo -y config sync --local` |
59
59
  | `runtime artifact lists no facet modules` | the same module, generated before systems of record existed | `wildo -y config sync --local --domain env-files` |
60
- | `Missing generated provider runtime module` (printed by your backend's own `src/index.ts`) | the same module, absent | `wildo -y config sync --local` |
60
+ | `Missing generated provider runtime module` (printed by your backend's own `src/index.ts`) | the same module, absent | `wildo local dev` writes it before it starts the backend; with the stack running, `wildo -y config sync --local` |
61
61
  | `Missing or invalid companion provider runtime artifact` | `.wildo-saas/generated/providers/companion.runtime-providers.generated.json` | `wildo -y config sync --local` |
62
62
  | `detected stale provider topology` · `does not contain a scope for worker/minion` | a minion's or worker's `.wildo-providers.env` or generated module | `wildo -y config sync --local` |
63
63
  | browser console: `bundle carries no code for it … regenerate frontend-providers.generated.ts` (a provider silently missing) | `<frontend service>/src/generated/frontend-providers.generated.ts` | `wildo -y config sync --local`, then commit it |
@@ -76,7 +76,7 @@ Four facts govern every row below:
76
76
  | Provider catalogue types | `.wildo-saas/generated/provider-catalog.types.ts` | `wildo -y config sync --local` | Nothing; stale only means stale autocomplete | Yes |
77
77
  | Application lockfile | `.wildo-saas/wildo-saas.lock.json` | `wildo -y config sync --local` (providers, infra); module and label commands write their own sections | `wildo lock check` — checks the providers and infra sections only | Yes |
78
78
  | Content security policy | `<frontend service>/src/generated/csp.generated.json` | `wildo dev sync-csp` (also `wildo dev start`) — **not** `wildo config sync` | `wildo dev sync-csp --check` (it refreshes the provider artifacts before comparing) | Yes |
79
- | Environment config and local stack | `.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `…/docker-compose/docker-compose.wildo-platform.yml`, `…/docker-compose/.env.wildo-platform` | `wildo -y config sync --local`. `wildo local up` only recreates a MISSING one, never a stale one | `wildo config validate --domain config` checks coherence with your secrets, not currency | No |
79
+ | Environment config and local stack | `.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `…/docker-compose/docker-compose.wildo-platform.yml`, `…/docker-compose/.env.wildo-platform` | `wildo -y config sync --local`. `wildo local up` and `wildo local dev` also re-derive them when they start: `config.json` when it no longer matches `wildo.infra.<env>.config.ts`, and the two compose files are rendered on every start and rewritten when their content changed. So an edited backing service, port, `publicDomain`, secret or framework template takes effect on the next start | `wildo config validate --domain config` checks coherence with your secrets, not currency | No |
80
80
  | Per-package `.env` files | `backend-api/.env`, `frontend/.env`, `website/.env`, `technical-doc/.env`, each minion and worker, `.wildo-saas/wildo-dev-companion/.env` | `wildo -y config sync --local --domain env-files` — needs the local platform running (when it is down this phase fails, but the provider artifacts are still written). It asks before overwriting; `-y` SKIPS existing files, `--force` rewrites them | Nothing | No |
81
81
  | Application identity | `.wildo-saas/infrastructure/environments/<env>/generated/config/application-runtime-identity.json` | **Not derived** — assigned when the application registered (`wildo local init`) | — | No, and **do not delete it**: only re-registration restores it |
82
82
  | Compliance modules | `backend-api/src/{data-retention,service-consent-requirement,subject-data-recipients,governed-document-releases}.generated.ts` | `wildo config data-retention` · `service-consent` · `subject-data-recipients` · `document-releases` | The same command with `--check`, or `wildo config validate --domain <same name>` | Yes |
@@ -14,7 +14,7 @@ It moves the two homes of a release, in this order:
14
14
  1. **The CLI.** The scaffold templates, the compose and k8s templates and the platform image tag
15
15
  travel with it. The new one is installed beside the current one, verified, and only then made
16
16
  the one `wildo` runs; the previous one is removed on the next update.
17
- 2. **This application**, run by the NEW CLI: every `@wildo-ai/*` pin in `pnpm.overrides`, the
17
+ 2. **This application**, run by the NEW CLI: every `@wildo-ai/*` pin in the overrides of `pnpm-workspace.yaml` (moved there from `package.json` → `pnpm`, which pnpm 11 does not read), the
18
18
  companion and workbench drops (the workbench drop is created if this application predates it), `pnpm install` → dependency alignment → `pnpm install`, the delivered templates,
19
19
  docs, skills and rules, and the deploy manifests (`config sync --domain manifest`).
20
20
 
@@ -64,7 +64,7 @@ command that re-derives them, and you can run it on its own; it needs no framewo
64
64
  `wildo update` does this for you. By hand it is:
65
65
 
66
66
  ```bash
67
- # 1. bump the @wildo-ai/* entries in this application's pnpm.overrides
67
+ # 1. bump the @wildo-ai/* entries in the overrides of this application's pnpm-workspace.yaml
68
68
  pnpm install # 2. the new pin set can only be READ once it is on disk
69
69
  wildo align-deps --write # 3. re-derive pins and peer declarations
70
70
  pnpm install # 4. the peer half takes effect only now
@@ -152,16 +152,24 @@ rg -n "<service>:" infrastructure/<env>/wildo.infra.<env>.config.ts
152
152
  rg -n "\"backingServices\":" .wildo-saas/state/environments.json
153
153
  ```
154
154
 
155
- **Cause:** `wildo setup` is the only command that hydrates
156
- `env.backingServices` / `env.serviceAuth` / `env.logging` from the
157
- authored config before the compose generator runs. If you edited
158
- the authored config and only ran `wildo config sync --domain manifest`
159
- (or only `wildo local up` against an already-generated env state),
160
- the env state is stale.
161
-
162
- **Fix:** `wildo -y setup` — re-runs the wizard, re-loads the
163
- authored config, and re-seeds the env state before re-rendering the
164
- compose file. Then `wildo -y local up`.
155
+ **Cause:** the env state is re-seeded from the authored config by
156
+ `wildo local up`, `wildo local dev`, `wildo config sync` and
157
+ `wildo setup`. Each of them refreshes `env.backingServices` /
158
+ `env.serviceAuth` / `env.logging` from `wildo.infra.<env>.config.ts`,
159
+ rewrites `config.json` when it no longer matches, and renders the
160
+ compose file and `.env.wildo-platform`, rewriting each when its content
161
+ changed. A stale env state therefore means none of them has run
162
+ since the edit. `wildo local up` / `wildo local dev` STOP with an error
163
+ when the authored config is missing or uses a setup path they cannot
164
+ reconcile, so a run that got past the pre-flight has applied the edit.
165
+
166
+ **Fix:** run `wildo -y local up` (or `wildo local dev`) and read its
167
+ pre-flight lines. You should see a line like `Rewrote config.json: the
168
+ authored backingServices changed.` (it lists every field that changed) and the
169
+ compose re-render. If the pre-flight
170
+ stops, fix the error it names and run it again.
171
+ `wildo -y setup` is only needed when the environment was never set up
172
+ or its setup state is missing.
165
173
 
166
174
  ## Docker Desktop credential helper hung
167
175
 
@@ -79,7 +79,7 @@ separate artifact-input path.
79
79
  |------|--------|
80
80
  | `-y` / `--yes` | Skip the final "Proceed?" confirmation. Does NOT skip the per-question wizard prompts. |
81
81
  | `--force` | Skip safety prompts on operations that would overwrite existing **generated** artifacts. **Does NOT rotate `secrets.json`** — that requires `--rotate-secrets` (or answering "yes" to the explicit rotation prompt during the wizard). |
82
- | `--rotate-secrets` | Explicit opt-in to regenerate every credential in `secrets.json`. Required for any unattended secret rotation. Combine with `--force` for fully unattended rotation. |
82
+ | `--rotate-secrets` | Explicit opt-in to regenerate the framework-generated credentials in `secrets.json`. Required for any unattended secret rotation. Combine with `--force` for fully unattended rotation. A secret a running server would not take from `secrets.json` (the self-hosted immudb's and OpenBao's) is left unchanged and reported as `Not rotated: <key> (<reason>)`. |
83
83
  | `--domain <name>` | (When passed; `wildo setup` typically calls `wildo config sync` internally with the full domain set.) See `wildo config sync` below. |
84
84
 
85
85
  **Common invocations:**
@@ -102,12 +102,12 @@ generation, prefer `wildo local init`, which includes this readiness work plus
102
102
  application-state reconciliation and executable verification.
103
103
 
104
104
  Bring the local docker-compose stack up. Runs a **runtime-bootstrap
105
- pre-flight** that self-heals missing generated artifacts before
105
+ pre-flight** that re-derives missing or stale generated artifacts before
106
106
  invoking `docker compose up -d`:
107
107
 
108
- - If `./.wildo-saas/infrastructure/environments/<env>/generated/config/config.json` is missing, regenerate from `wildo.infra.local.config.ts` / `wildo.infra.remote.config.ts`
109
- - If `./.wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml` is missing, regenerate
110
- - If `./.wildo-saas/infrastructure/environments/<env>/docker-compose/.env.wildo-platform` is missing, regenerate
108
+ - If `./.wildo-saas/infrastructure/environments/<env>/generated/config/config.json` is missing, or no longer matches `wildo.infra.local.config.ts` / `wildo.infra.remote.config.ts`, regenerate it from that file
109
+ - Render `./.wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml` and write it when missing or when its content changed (an edited descriptor, `secrets.json` or framework template). The files it bind-mounts, such as the immudb signing key, are checked on every start and restored when missing or different
110
+ - Generate `./.wildo-saas/infrastructure/environments/<env>/docker-compose/.env.wildo-platform` the same way
111
111
  - Refresh the in-memory env state from the authored config (so
112
112
  `kubernetes.namespace`, `publicDomain`, `database`, etc. are
113
113
  current — preserves the runtime-only fields the authored config
@@ -326,7 +326,7 @@ wildo -y config sync --local --domain secrets --rotate-secrets
326
326
  The one command for day-to-day work, and the one that owns the START ORDER so you
327
327
  do not have to hold it in your head. It claims the application's generation before
328
328
  it stops or replaces anything, reaps only prior process trees whose arguments name
329
- this application root, runs the preflight, self-heals missing local runtime
329
+ this application root, runs the preflight, re-derives missing or stale local runtime
330
330
  artifacts from the authored declaration, brings the container stack up if none of
331
331
  its containers are running, and blocks on readiness before starting anything that
332
332
  depends on it.
@@ -493,7 +493,7 @@ their values in logs or documentation.
493
493
  | The declaration, on an application that is already running | `wildo config reapply-declaration` (leaves credentials, database, infra and the seeded administrator alone) |
494
494
  | Nothing — but something is behaving impossibly | `wildo local doctor` FIRST, then `derived-artifact-currency.md`: a process refusing a generated file names the command that regenerates it |
495
495
  | Nothing — you want a newer framework release | `wildo update` (or `--to <version>`). It moves the CLI, then this application's pins, dependencies, companion, skills and deploy manifests. See `framework-upgrade-and-dependency-alignment.md` |
496
- | The `@wildo-ai/*` versions in `pnpm.overrides`, by hand | `pnpm install` → `wildo align-deps --write` → `pnpm install` again, then `wildo assets sync`. Prefer `wildo update`, which does all of it and moves the CLI to match |
496
+ | The `@wildo-ai/*` versions in the overrides of `pnpm-workspace.yaml`, by hand | `pnpm install` → `wildo align-deps --write` → `pnpm install` again, then `wildo assets sync`. Prefer `wildo update`, which does all of it and moves the CLI to match |
497
497
  | Nothing — the application was just scaffolded and installed for the first time | `wildo align-deps --write` once, then `pnpm install`. Expected, not a defect: scaffolding pins from the framework checkout while pinning the framework to the published release |
498
498
 
499
499
 
@@ -697,6 +697,7 @@ The two introspection behavior definitions:
697
697
  },
698
698
  },
699
699
  execution: {
700
+ readsSpecificationFamiliesOnly: true,
700
701
  ...SHARED_EXECUTION_BOUNDARY,
701
702
  materializationKind: 'json-snapshot',
702
703
  },
@@ -718,6 +719,7 @@ The two introspection behavior definitions:
718
719
  },
719
720
  },
720
721
  execution: {
722
+ readsSpecificationFamiliesOnly: true,
721
723
  ...SHARED_EXECUTION_BOUNDARY,
722
724
  materializationKind: 'json-snapshot',
723
725
  },
@@ -753,6 +755,7 @@ The two introspection behavior definitions:
753
755
  },
754
756
  },
755
757
  execution: {
758
+ readsSpecificationFamiliesOnly: true,
756
759
  ...SHARED_EXECUTION_BOUNDARY,
757
760
  materializationKind: 'json-snapshot',
758
761
  },
@@ -926,6 +929,8 @@ export interface SpecificationsCompanionExports<
926
929
  TBrandNameScreening = BrandNameScreening,
927
930
  // Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
928
931
  TServiceMethod = ServiceMethod,
932
+ // Appended STRICTLY LAST: the regimes research established for the product (#3362).
933
+ TCompliancePosture = CompliancePosture,
929
934
  > {
930
935
  resourceSpecifications: TResourceSpecifications;
931
936
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -1430,8 +1435,10 @@ export interface SpecificationsCompanionExports<
1430
1435
  */
1431
1436
  documentationPlan?: TApplicationDocumentationPlan;
1432
1437
  /**
1433
- * THE AUTHORED BODY of each chapter `documentationPlan` declares, keyed by `chapterRef` (#874) —
1434
- * from `specifications/src/technical-documentation/index.ts`, accepted by being committed.
1438
+ * THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
1439
+ * by being committed. Optional: a chapter is normally written in its own file,
1440
+ * `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
1441
+ * publication reads those files beside this set and merges them, refusing a chapter declared in both.
1435
1442
  *
1436
1443
  * Read by the documentation publication, which joins each body to its planned chapter and publishes
1437
1444
  * it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
@@ -1442,6 +1449,15 @@ export interface SpecificationsCompanionExports<
1442
1449
  * positional parameter would only add a slot for every consumer to skip.
1443
1450
  */
1444
1451
  documentationChapters?: ApplicationDocumentationChapterSet;
1452
+ /**
1453
+ * THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
1454
+ * honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
1455
+ * `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
1456
+ * ignored. Optional: absent means every word is the model's.
1457
+ *
1458
+ * Typed directly, like `documentationChapters`: no application narrows it.
1459
+ */
1460
+ translationGlossary?: ApplicationTranslationGlossaryDeclaration;
1445
1461
  /**
1446
1462
  * WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
1447
1463
  * minion's tick may touch, and the providers this application binds (#1495). Read by
@@ -1471,6 +1487,12 @@ export interface SpecificationsCompanionExports<
1471
1487
  * playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
1472
1488
  */
1473
1489
  serviceMethod?: TServiceMethod;
1490
+ /**
1491
+ * WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
1492
+ * compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
1493
+ * creator's own compliance constraints; this carries the researched ones.
1494
+ */
1495
+ compliancePosture?: TCompliancePosture;
1474
1496
  /**
1475
1497
  * Accepted application-declared semantic causality between whole
1476
1498
  * specification-family states. This is not the registry's physical
@@ -592,6 +592,7 @@ a standard `companionPost` request to either behavior id.
592
592
  },
593
593
  },
594
594
  execution: {
595
+ readsSpecificationFamiliesOnly: true,
595
596
  ...SHARED_EXECUTION_BOUNDARY,
596
597
  materializationKind: 'json-snapshot',
597
598
  },
@@ -613,6 +614,7 @@ a standard `companionPost` request to either behavior id.
613
614
  },
614
615
  },
615
616
  execution: {
617
+ readsSpecificationFamiliesOnly: true,
616
618
  ...SHARED_EXECUTION_BOUNDARY,
617
619
  materializationKind: 'json-snapshot',
618
620
  },
@@ -648,6 +650,7 @@ a standard `companionPost` request to either behavior id.
648
650
  },
649
651
  },
650
652
  execution: {
653
+ readsSpecificationFamiliesOnly: true,
651
654
  ...SHARED_EXECUTION_BOUNDARY,
652
655
  materializationKind: 'json-snapshot',
653
656
  },
@@ -831,6 +834,8 @@ export interface SpecificationsCompanionExports<
831
834
  TBrandNameScreening = BrandNameScreening,
832
835
  // Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
833
836
  TServiceMethod = ServiceMethod,
837
+ // Appended STRICTLY LAST: the regimes research established for the product (#3362).
838
+ TCompliancePosture = CompliancePosture,
834
839
  > {
835
840
  resourceSpecifications: TResourceSpecifications;
836
841
  applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
@@ -1335,8 +1340,10 @@ export interface SpecificationsCompanionExports<
1335
1340
  */
1336
1341
  documentationPlan?: TApplicationDocumentationPlan;
1337
1342
  /**
1338
- * THE AUTHORED BODY of each chapter `documentationPlan` declares, keyed by `chapterRef` (#874) —
1339
- * from `specifications/src/technical-documentation/index.ts`, accepted by being committed.
1343
+ * THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
1344
+ * by being committed. Optional: a chapter is normally written in its own file,
1345
+ * `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
1346
+ * publication reads those files beside this set and merges them, refusing a chapter declared in both.
1340
1347
  *
1341
1348
  * Read by the documentation publication, which joins each body to its planned chapter and publishes
1342
1349
  * it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
@@ -1347,6 +1354,15 @@ export interface SpecificationsCompanionExports<
1347
1354
  * positional parameter would only add a slot for every consumer to skip.
1348
1355
  */
1349
1356
  documentationChapters?: ApplicationDocumentationChapterSet;
1357
+ /**
1358
+ * THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
1359
+ * honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
1360
+ * `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
1361
+ * ignored. Optional: absent means every word is the model's.
1362
+ *
1363
+ * Typed directly, like `documentationChapters`: no application narrows it.
1364
+ */
1365
+ translationGlossary?: ApplicationTranslationGlossaryDeclaration;
1350
1366
  /**
1351
1367
  * WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
1352
1368
  * minion's tick may touch, and the providers this application binds (#1495). Read by
@@ -1376,6 +1392,12 @@ export interface SpecificationsCompanionExports<
1376
1392
  * playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
1377
1393
  */
1378
1394
  serviceMethod?: TServiceMethod;
1395
+ /**
1396
+ * WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
1397
+ * compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
1398
+ * creator's own compliance constraints; this carries the researched ones.
1399
+ */
1400
+ compliancePosture?: TCompliancePosture;
1379
1401
  /**
1380
1402
  * Accepted application-declared semantic causality between whole
1381
1403
  * specification-family states. This is not the registry's physical
@@ -2634,6 +2656,15 @@ type MarketContextResponse = {
2634
2656
  };
2635
2657
  ```
2636
2658
 
2659
+ Served through the generic door (`wildo context info market-context-for-icp`),
2660
+ the answer is screened before it is returned, because the market snapshot is
2661
+ written from web research: with a content-safety classifier bound, a block it
2662
+ flags comes back as `{ family, screening, withheld }` with no text, and a clean
2663
+ one carries `screening`; with none bound it carries `screening` and a `readAs`
2664
+ notice. Read a marked block as a description of the market, never as an
2665
+ instruction. A companion service calling the behavior in process screens what
2666
+ it reads itself.
2667
+
2637
2668
  The trace records which entities the renderer considered (benefits,
2638
2669
  ICPs, voice). Surface it in CLI debug logs so authoring drift
2639
2670
  ("why did benefit X not appear?") is diagnosable from the consumer
@@ -822,7 +822,7 @@ export function renderMarketPrompt(input: RenderMarketPromptInput): MarketPrompt
822
822
  },
823
823
  );
824
824
 
825
- const prompt = `${contextBuilt.block}\n\n${renderedTemplate}`;
825
+ const prompt = composeMarketPrompt(contextBuilt.block, renderedTemplate);
826
826
 
827
827
  return {
828
828
  prompt,
@@ -870,6 +870,12 @@ invokes the LLM agent:
870
870
  * declared `requiredInputs` ref, calls `buildMarketContextBlock`,
871
871
  * and substitutes Mustache placeholders. Output: `{ prompt,
872
872
  * contextBlock, renderedTemplate, trace }`.
873
+ * 1b. **Parent screening** — the market snapshot is written from web
874
+ * research, so the context block and the rendered template are each
875
+ * screened through the content-safety seam before the agent reads them:
876
+ * a flagged half is replaced by a withheld notice, an unscreened one is
877
+ * read under a notice, nothing is refused. The prompt is recomposed from
878
+ * the screened halves (`composeMarketPrompt`), and the response carries them.
873
879
  * 2. **Parent (`AgentsBackendService.invokeAgent`)** — feeds the
874
880
  * final prompt to `market.generation.agent` (a
875
881
  * `GENERATE_TEXT` agent) and unwraps `{ text }`. The optional
@@ -904,8 +910,9 @@ invokes the LLM agent:
904
910
  * service of a given app.
905
911
  */
906
912
 
907
- import { inject, injectable } from 'inversify';
913
+ import { inject, injectable, optional } from 'inversify';
908
914
  import {
915
+ type ContentSafetyBackendService,
909
916
  ErrorBuilderBackendService,
910
917
  LoggerService,
911
918
  MARKET_GENERATION_AGENT_REF,
@@ -928,10 +935,17 @@ import {
928
935
  MarketRenderPromptResponseSchema,
929
936
  type MarketGenerationResponse,
930
937
  } from '@wildo-ai/saas-specifications';
938
+ import { ApplicationSpecificationFamily } from '@wildo-ai/saas-specifications/application-creation';
931
939
 
932
940
  import { COMPANION_SERVICE_TYPES } from '../../core/inject/models/service-types';
933
941
  import type { CompanionContext } from '../../core/context/companion-context';
934
942
  import { CompanionIntrospectionService } from '../../core/introspection/services/companion-introspection.companion.service';
943
+ import { composeMarketPrompt } from '../../core/introspection/subprocess/market-prompt-renderer';
944
+ import {
945
+ catalogResearchInformedFamilies,
946
+ researchFamilyScreeningHostOf,
947
+ screenResearchInformedRenderings,
948
+ } from '../../meta-workflows/services/build-brief-third-party-screening.companion';
935
949
 
936
950
  export interface MarketGenerationRequest {
937
951
  templateRef: string;
@@ -969,6 +983,12 @@ export class MarketGenerationCompanionService {
969
983
  private readonly companionContext: CompanionContext,
970
984
  @inject(COMPANION_SERVICE_TYPES.IntrospectionService)
971
985
  private readonly companionIntrospectionService: CompanionIntrospectionService,
986
+ /**
987
+ * The classifier the market snapshot's text is screened through before the generation agent reads it (#2938), the
988
+ * one every door screens through. Optional: absent is "no classifier bound", which marks rather than refuses.
989
+ */
990
+ @inject(SAAS_SERVICE_TYPES.ContentSafetyService) @optional()
991
+ private readonly contentSafety?: ContentSafetyBackendService,
972
992
  ) {
973
993
  this.logDebug = this.logger.debugByType('MarketGenerationCompanionService');
974
994
  this.logger.setDebugTypeLogging('MarketGenerationCompanionService', true);
@@ -1027,6 +1047,27 @@ export class MarketGenerationCompanionService {
1027
1047
  });
1028
1048
  }
1029
1049
 
1050
+ /*
1051
+ * ── 1b. Screen what the market snapshot wrote (#2938) ──────────
1052
+ *
1053
+ * Both halves of the prompt are the market snapshot's text: the context block renders its ICPs, benefits and voice,
1054
+ * and the template body is a `MarketMessageTemplate` OF the snapshot with snapshot entities substituted in. A
1055
+ * research step writes the snapshot, so each half is screened before the agent reads it, on its own: a flagged half
1056
+ * is replaced by its withheld notice (the agent is told to say so, never to invent it), an unscreened one is read
1057
+ * under its notice, and nothing is refused. The response carries the screened halves, so the prompt it returns is
1058
+ * the one the agent read.
1059
+ */
1060
+ const marketFamily = ApplicationSpecificationFamily.MARKET_SNAPSHOT;
1061
+ const researchInformed = catalogResearchInformedFamilies()(marketFamily);
1062
+ const [contextBlock, renderedTemplate] = await screenResearchInformedRenderings(
1063
+ [
1064
+ { family: marketFamily, text: renderResult.contextBlock, researchInformed },
1065
+ { family: marketFamily, text: renderResult.renderedTemplate, researchInformed },
1066
+ ],
1067
+ researchFamilyScreeningHostOf(this.contentSafety, this.logger, `market-generation:${request.templateRef}`),
1068
+ );
1069
+ const prompt = composeMarketPrompt(contextBlock!.text, renderedTemplate!.text);
1070
+
1030
1071
  // ── 2. Parent-process LLM call ─────────────────────────────
1031
1072
  const invocation: FlowsActors_Agent_Invocation<
1032
1073
  typeof LLMProvider_GenerateTextInputSchema,
@@ -1036,7 +1077,7 @@ export class MarketGenerationCompanionService {
1036
1077
  agentRef: MARKET_GENERATION_AGENT_REF,
1037
1078
  initiator: {},
1038
1079
  invocationContext: [],
1039
- input: { prompt: renderResult.prompt },
1080
+ input: { prompt },
1040
1081
  output: { text: '' },
1041
1082
  executionContext: { callTimestamp: new Date().toISOString() },
1042
1083
  artifactBindings: [],
@@ -1054,9 +1095,9 @@ export class MarketGenerationCompanionService {
1054
1095
  }
1055
1096
 
1056
1097
  return {
1057
- prompt: renderResult.prompt,
1058
- renderedTemplate: renderResult.renderedTemplate,
1059
- contextBlock: renderResult.contextBlock,
1098
+ prompt,
1099
+ renderedTemplate: renderedTemplate!.text,
1100
+ contextBlock: contextBlock!.text,
1060
1101
  output: outputText,
1061
1102
  trace: {
1062
1103
  template: renderResult.trace.template,
@@ -644,7 +644,7 @@ export function renderMarketPrompt(input: RenderMarketPromptInput): MarketPrompt
644
644
  },
645
645
  );
646
646
 
647
- const prompt = `${contextBuilt.block}\n\n${renderedTemplate}`;
647
+ const prompt = composeMarketPrompt(contextBuilt.block, renderedTemplate);
648
648
 
649
649
  return {
650
650
  prompt,
@@ -694,6 +694,12 @@ agent via the `AgentsBackendService`:
694
694
  * declared `requiredInputs` ref, calls `buildMarketContextBlock`,
695
695
  * and substitutes Mustache placeholders. Output: `{ prompt,
696
696
  * contextBlock, renderedTemplate, trace }`.
697
+ * 1b. **Parent screening** — the market snapshot is written from web
698
+ * research, so the context block and the rendered template are each
699
+ * screened through the content-safety seam before the agent reads them:
700
+ * a flagged half is replaced by a withheld notice, an unscreened one is
701
+ * read under a notice, nothing is refused. The prompt is recomposed from
702
+ * the screened halves (`composeMarketPrompt`), and the response carries them.
697
703
  * 2. **Parent (`AgentsBackendService.invokeAgent`)** — feeds the
698
704
  * final prompt to `market.generation.agent` (a
699
705
  * `GENERATE_TEXT` agent) and unwraps `{ text }`. The optional
@@ -728,8 +734,9 @@ agent via the `AgentsBackendService`:
728
734
  * service of a given app.
729
735
  */
730
736
 
731
- import { inject, injectable } from 'inversify';
737
+ import { inject, injectable, optional } from 'inversify';
732
738
  import {
739
+ type ContentSafetyBackendService,
733
740
  ErrorBuilderBackendService,
734
741
  LoggerService,
735
742
  MARKET_GENERATION_AGENT_REF,
@@ -752,10 +759,17 @@ import {
752
759
  MarketRenderPromptResponseSchema,
753
760
  type MarketGenerationResponse,
754
761
  } from '@wildo-ai/saas-specifications';
762
+ import { ApplicationSpecificationFamily } from '@wildo-ai/saas-specifications/application-creation';
755
763
 
756
764
  import { COMPANION_SERVICE_TYPES } from '../../core/inject/models/service-types';
757
765
  import type { CompanionContext } from '../../core/context/companion-context';
758
766
  import { CompanionIntrospectionService } from '../../core/introspection/services/companion-introspection.companion.service';
767
+ import { composeMarketPrompt } from '../../core/introspection/subprocess/market-prompt-renderer';
768
+ import {
769
+ catalogResearchInformedFamilies,
770
+ researchFamilyScreeningHostOf,
771
+ screenResearchInformedRenderings,
772
+ } from '../../meta-workflows/services/build-brief-third-party-screening.companion';
759
773
 
760
774
  export interface MarketGenerationRequest {
761
775
  templateRef: string;
@@ -793,6 +807,12 @@ export class MarketGenerationCompanionService {
793
807
  private readonly companionContext: CompanionContext,
794
808
  @inject(COMPANION_SERVICE_TYPES.IntrospectionService)
795
809
  private readonly companionIntrospectionService: CompanionIntrospectionService,
810
+ /**
811
+ * The classifier the market snapshot's text is screened through before the generation agent reads it (#2938), the
812
+ * one every door screens through. Optional: absent is "no classifier bound", which marks rather than refuses.
813
+ */
814
+ @inject(SAAS_SERVICE_TYPES.ContentSafetyService) @optional()
815
+ private readonly contentSafety?: ContentSafetyBackendService,
796
816
  ) {
797
817
  this.logDebug = this.logger.debugByType('MarketGenerationCompanionService');
798
818
  this.logger.setDebugTypeLogging('MarketGenerationCompanionService', true);
@@ -851,6 +871,27 @@ export class MarketGenerationCompanionService {
851
871
  });
852
872
  }
853
873
 
874
+ /*
875
+ * ── 1b. Screen what the market snapshot wrote (#2938) ──────────
876
+ *
877
+ * Both halves of the prompt are the market snapshot's text: the context block renders its ICPs, benefits and voice,
878
+ * and the template body is a `MarketMessageTemplate` OF the snapshot with snapshot entities substituted in. A
879
+ * research step writes the snapshot, so each half is screened before the agent reads it, on its own: a flagged half
880
+ * is replaced by its withheld notice (the agent is told to say so, never to invent it), an unscreened one is read
881
+ * under its notice, and nothing is refused. The response carries the screened halves, so the prompt it returns is
882
+ * the one the agent read.
883
+ */
884
+ const marketFamily = ApplicationSpecificationFamily.MARKET_SNAPSHOT;
885
+ const researchInformed = catalogResearchInformedFamilies()(marketFamily);
886
+ const [contextBlock, renderedTemplate] = await screenResearchInformedRenderings(
887
+ [
888
+ { family: marketFamily, text: renderResult.contextBlock, researchInformed },
889
+ { family: marketFamily, text: renderResult.renderedTemplate, researchInformed },
890
+ ],
891
+ researchFamilyScreeningHostOf(this.contentSafety, this.logger, `market-generation:${request.templateRef}`),
892
+ );
893
+ const prompt = composeMarketPrompt(contextBlock!.text, renderedTemplate!.text);
894
+
854
895
  // ── 2. Parent-process LLM call ─────────────────────────────
855
896
  const invocation: FlowsActors_Agent_Invocation<
856
897
  typeof LLMProvider_GenerateTextInputSchema,
@@ -860,7 +901,7 @@ export class MarketGenerationCompanionService {
860
901
  agentRef: MARKET_GENERATION_AGENT_REF,
861
902
  initiator: {},
862
903
  invocationContext: [],
863
- input: { prompt: renderResult.prompt },
904
+ input: { prompt },
864
905
  output: { text: '' },
865
906
  executionContext: { callTimestamp: new Date().toISOString() },
866
907
  artifactBindings: [],
@@ -878,9 +919,9 @@ export class MarketGenerationCompanionService {
878
919
  }
879
920
 
880
921
  return {
881
- prompt: renderResult.prompt,
882
- renderedTemplate: renderResult.renderedTemplate,
883
- contextBlock: renderResult.contextBlock,
922
+ prompt,
923
+ renderedTemplate: renderedTemplate!.text,
924
+ contextBlock: contextBlock!.text,
884
925
  output: outputText,
885
926
  trace: {
886
927
  template: renderResult.trace.template,
@@ -1253,6 +1294,11 @@ wildo market generate
1253
1294
  │ ▼
1254
1295
  │ { prompt, contextBlock, renderedTemplate, trace }
1255
1296
  │
1297
+ ├─► screen contextBlock and renderedTemplate (content-safety seam)
1298
+ │ - the market snapshot is written from web research
1299
+ │ - a flagged half → its withheld notice; unscreened → marked
1300
+ │ - prompt recomposed from the screened halves
1301
+ │
1256
1302
  └─► AgentsBackendService.invokeAgent(market.generation.agent, prompt)
1257
1303
  │
1258
1304
  ▼
@@ -1268,7 +1314,14 @@ wildo market generate
1268
1314
 
1269
1315
  The subprocess is the only place that touches the snapshot. The
1270
1316
  parent process never reads the snapshot, never knows the template
1271
- shape, and never sees the validator — its job is the LLM round-trip
1272
- plus the response shape. This split is the authoring-time vs
1317
+ shape, and never sees the validator — its job is the screening of
1318
+ what the snapshot wrote, the LLM round-trip and the response shape.
1319
+ The screening runs in the parent because only the parent holds the
1320
+ companion's content-safety classifier: with one bound, a half it
1321
+ flags never reaches the agent (the agent reads a withheld notice in
1322
+ its place, and `--explain` shows that notice); with none bound, each
1323
+ half reaches it under a notice saying nothing screened it. The
1324
+ response's `prompt`, `contextBlock` and `renderedTemplate` are the
1325
+ screened ones, so `--explain` shows exactly what the agent read. This split is the authoring-time vs
1273
1326
  runtime boundary that keeps the CLI fast, the renderer pure, and
1274
1327
  the LLM-call surface narrow.
@@ -65,7 +65,9 @@ organization reads its own cost: see step 5.
65
65
  1. **Declare the case.** Add `workUnit: true` to the resource whose rows are the unit of work
66
66
  (`references/framework-work-unit-api.md`). Several resources may be cases. Say so in the resource
67
67
  specification's `businessRole`. The engine then opens the case frame by itself around every single-row
68
- operation on that resource, including after-create hooks and the jobs they enqueue.
68
+ operation on that resource, including after-create hooks and the jobs they enqueue. Every other operation (on a
69
+ resource that is no case, or a list or bulk operation) attributes its model calls to the organization it acts in,
70
+ so they are charged to that organization without a case; only work for no organization is left unattributed.
69
71
  2. **Pass the case where the engine cannot see it.** A turn that is not an operation on the case row names it
70
72
  as `caseRef: { resourceType, resourceId }`: on a chat start (`useFlowsActors().startExecution(systemRef, input,
71
73
  undefined, undefined, { caseRef })`), an actor run, an inbound handler's autonomous turn, or an A2A message's `metadata.caseRef`. The engine refuses a ref to a resource that is not a work unit or to a row the