@wildo-ai/framework-knowledge 1.1.0

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 (922) hide show
  1. package/LICENSE +34 -0
  2. package/dist/esm/.builder.pid +9 -0
  3. package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
  4. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
  5. package/dist/esm/framework-knowledge.definitions.js +1571 -0
  6. package/dist/esm/framework-knowledge.definitions.js.map +1 -0
  7. package/dist/esm/framework-knowledge.loader.d.ts +72 -0
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
  9. package/dist/esm/framework-knowledge.loader.js +258 -0
  10. package/dist/esm/framework-knowledge.loader.js.map +1 -0
  11. package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
  12. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
  13. package/dist/esm/framework-knowledge.schemas.js +23 -0
  14. package/dist/esm/framework-knowledge.schemas.js.map +1 -0
  15. package/dist/esm/index.d.ts +4 -0
  16. package/dist/esm/index.d.ts.map +1 -0
  17. package/dist/esm/index.js +4 -0
  18. package/dist/esm/index.js.map +1 -0
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
  24. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
  25. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
  27. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
  28. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
  29. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
  30. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
  32. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
  33. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
  34. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
  35. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
  36. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
  37. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
  38. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
  40. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
  42. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
  43. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
  44. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
  45. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
  46. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
  47. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
  48. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
  51. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
  52. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
  53. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
  54. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
  55. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
  56. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
  57. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
  58. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
  59. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
  60. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
  62. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
  64. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
  66. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
  68. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
  70. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
  72. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
  73. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
  74. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
  75. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
  76. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
  77. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
  78. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
  79. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
  80. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
  82. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
  84. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
  85. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
  86. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
  87. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
  88. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
  89. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
  90. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
  91. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
  92. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
  94. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
  96. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
  98. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
  100. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
  103. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
  104. package/dist/knowledge/manifest.json +45 -0
  105. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
  106. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
  107. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
  108. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
  109. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
  110. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
  111. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
  113. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
  118. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
  119. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
  122. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
  123. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
  124. package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
  125. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
  126. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
  127. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
  128. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
  129. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
  130. package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
  131. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
  132. package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
  133. package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
  134. package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
  135. package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
  136. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
  137. package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
  138. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
  139. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
  140. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
  141. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
  142. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  143. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
  144. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  145. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
  150. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
  152. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
  153. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
  154. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
  157. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
  158. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
  159. package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
  160. package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
  161. package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
  162. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
  163. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
  164. package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
  165. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
  166. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
  167. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
  168. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
  169. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
  170. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
  171. package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
  172. package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
  173. package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
  174. package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
  175. package/dist/knowledge/references/assertions.references.conventions.md +92 -0
  176. package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
  177. package/dist/knowledge/references/assertions.specification.config.md +287 -0
  178. package/dist/knowledge/references/brand.asset.config.md +167 -0
  179. package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
  180. package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
  181. package/dist/knowledge/references/brand.name.config.md +46 -0
  182. package/dist/knowledge/references/brand.snapshot.config.md +76 -0
  183. package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
  184. package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
  185. package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
  186. package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
  187. package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
  188. package/dist/knowledge/references/business-model.references.conventions.md +99 -0
  189. package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
  190. package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
  191. package/dist/knowledge/references/cli.market.generate-command.md +230 -0
  192. package/dist/knowledge/references/cli.market.utils.md +147 -0
  193. package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
  194. package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
  195. package/dist/knowledge/references/companion.market.generation-service.md +270 -0
  196. package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
  197. package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
  198. package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
  199. package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
  200. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
  201. package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
  202. package/dist/knowledge/references/engine.saas-website.config.md +331 -0
  203. package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
  204. package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
  205. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
  206. package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
  207. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
  208. package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
  209. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
  210. package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
  211. package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
  213. package/dist/knowledge/references/example.config.design-system.full.md +162 -0
  214. package/dist/knowledge/references/example.config.navigation.full.md +71 -0
  215. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
  216. package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
  217. package/dist/knowledge/references/example.email.template.minimal.md +54 -0
  218. package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
  219. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
  220. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
  221. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
  222. package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
  223. package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
  224. package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
  225. package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
  226. package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
  227. package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
  228. package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
  229. package/dist/knowledge/references/example.market.category.config.md +71 -0
  230. package/dist/knowledge/references/example.market.channel.community.md +39 -0
  231. package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
  232. package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
  233. package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
  234. package/dist/knowledge/references/example.market.icp.individual.md +82 -0
  235. package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
  236. package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
  237. package/dist/knowledge/references/example.market.job.emotional.md +27 -0
  238. package/dist/knowledge/references/example.market.job.functional.md +28 -0
  239. package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
  240. package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
  241. package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
  242. package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
  243. package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
  244. package/dist/knowledge/references/example.market.proof.metric.md +39 -0
  245. package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
  246. package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
  247. package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
  248. package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
  249. package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
  250. package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
  251. package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
  252. package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
  253. package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
  254. package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
  255. package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
  256. package/dist/knowledge/references/example.module.registration.shared.md +16 -0
  257. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
  258. package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
  259. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
  260. package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
  261. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
  262. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
  263. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
  264. package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
  265. package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
  266. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
  267. package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
  268. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
  269. package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
  270. package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
  271. package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
  272. package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
  273. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
  274. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
  275. package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
  276. package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
  277. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
  278. package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
  279. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
  280. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
  281. package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
  282. package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
  283. package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
  284. package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
  285. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
  286. package/dist/knowledge/references/market.alternative.config.md +68 -0
  287. package/dist/knowledge/references/market.alternative.kind.md +32 -0
  288. package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
  289. package/dist/knowledge/references/market.buying-journey.config.md +43 -0
  290. package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
  291. package/dist/knowledge/references/market.category.config.md +63 -0
  292. package/dist/knowledge/references/market.channel.config.md +59 -0
  293. package/dist/knowledge/references/market.channel.kind.md +49 -0
  294. package/dist/knowledge/references/market.context-block.builder.md +544 -0
  295. package/dist/knowledge/references/market.context-block.response.md +57 -0
  296. package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
  297. package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
  298. package/dist/knowledge/references/market.gain.config.md +50 -0
  299. package/dist/knowledge/references/market.generation.response.md +108 -0
  300. package/dist/knowledge/references/market.icp.config.md +162 -0
  301. package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
  302. package/dist/knowledge/references/market.inherit-from.md +74 -0
  303. package/dist/knowledge/references/market.is-benefit-available.md +58 -0
  304. package/dist/knowledge/references/market.job.config.md +48 -0
  305. package/dist/knowledge/references/market.message-template.config.md +86 -0
  306. package/dist/knowledge/references/market.objection.config.md +56 -0
  307. package/dist/knowledge/references/market.objection.kind.md +34 -0
  308. package/dist/knowledge/references/market.pain.config.md +50 -0
  309. package/dist/knowledge/references/market.persona.config.md +64 -0
  310. package/dist/knowledge/references/market.positioning.config.md +84 -0
  311. package/dist/knowledge/references/market.proof.config.md +48 -0
  312. package/dist/knowledge/references/market.proof.kind.md +34 -0
  313. package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
  314. package/dist/knowledge/references/market.scoring.fit.md +215 -0
  315. package/dist/knowledge/references/market.snapshot.config.md +34 -0
  316. package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
  317. package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
  318. package/dist/knowledge/references/market.trigger.config.md +45 -0
  319. package/dist/knowledge/references/market.trigger.kind.md +35 -0
  320. package/dist/knowledge/references/placement-plan.config.md +330 -0
  321. package/dist/knowledge/references/platform.config.application-database.md +74 -0
  322. package/dist/knowledge/references/platform.config.application-modules.md +30 -0
  323. package/dist/knowledge/references/platform.config.backing-services.md +266 -0
  324. package/dist/knowledge/references/platform.config.cdn.md +167 -0
  325. package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
  326. package/dist/knowledge/references/platform.config.saas.md +405 -0
  327. package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
  328. package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
  329. package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
  330. package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
  331. package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
  332. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
  333. package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
  334. package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
  335. package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
  336. package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
  337. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
  338. package/dist/knowledge/references/requirements.references.conventions.md +125 -0
  339. package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
  340. package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
  341. package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
  342. package/dist/knowledge/references/roadmap.phase.config.md +149 -0
  343. package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
  344. package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
  345. package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
  346. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
  347. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
  348. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
  349. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
  350. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
  351. package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
  352. package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
  354. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
  355. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
  356. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
  357. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
  358. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
  359. package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
  360. package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
  361. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
  362. package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
  363. package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
  364. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
  365. package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
  366. package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
  367. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
  368. package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
  369. package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
  370. package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
  371. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
  372. package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
  373. package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
  374. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
  375. package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
  376. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
  377. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
  378. package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
  379. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
  380. package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
  381. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
  382. package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
  383. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
  385. package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
  386. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
  388. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
  389. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
  391. package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
  392. package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
  393. package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
  395. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
  396. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
  397. package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
  398. package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
  399. package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
  400. package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
  401. package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
  402. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
  403. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
  404. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
  405. package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
  406. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
  407. package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
  408. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
  409. package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
  410. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
  411. package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
  412. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
  413. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
  414. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
  415. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
  416. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
  417. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
  418. package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
  419. package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
  420. package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
  421. package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
  422. package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
  423. package/dist/knowledge/references/saas.models.error-type.md +45 -0
  424. package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
  425. package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
  429. package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
  430. package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
  431. package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
  433. package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
  434. package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
  435. package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
  437. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
  438. package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
  439. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
  440. package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
  442. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
  443. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
  444. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
  445. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
  446. package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
  447. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
  449. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
  450. package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
  451. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
  452. package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
  453. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
  454. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
  455. package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
  456. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
  457. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
  458. package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
  459. package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
  460. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
  461. package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
  462. package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
  463. package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
  464. package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
  465. package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
  466. package/dist/knowledge/references/saas.models.resource-type.md +24 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
  468. package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
  469. package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
  470. package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
  471. package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
  472. package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
  474. package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
  475. package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
  476. package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
  477. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
  478. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
  479. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
  480. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
  481. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
  482. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
  483. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
  484. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
  485. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
  486. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
  487. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
  488. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
  489. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
  490. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
  492. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
  493. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
  494. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
  495. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
  496. package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
  497. package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
  498. package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
  499. package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
  500. package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
  501. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
  502. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
  503. package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
  504. package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
  505. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
  506. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
  507. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
  508. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
  509. package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
  510. package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
  511. package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
  512. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
  513. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
  514. package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
  515. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
  516. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
  517. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
  518. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
  519. package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
  520. package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
  521. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
  522. package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
  523. package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
  524. package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
  525. package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
  526. package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
  527. package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
  528. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
  529. package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
  530. package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
  531. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
  532. package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
  533. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
  534. package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
  535. package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
  536. package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
  537. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
  538. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
  539. package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
  540. package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
  541. package/dist/knowledge/references/saas.website.page.context.md +57 -0
  542. package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
  543. package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
  544. package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
  545. package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
  546. package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
  547. package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
  548. package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
  549. package/dist/knowledge/references/saas.website.refs.page.md +56 -0
  550. package/dist/knowledge/references/saas.website.refs.section.md +57 -0
  551. package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
  552. package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
  553. package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
  554. package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
  555. package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
  556. package/dist/knowledge/references/saas.website.section.component.md +138 -0
  557. package/dist/knowledge/references/saas.website.section.context.md +63 -0
  558. package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
  559. package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
  560. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
  561. package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
  562. package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
  563. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
  564. package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
  565. package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
  566. package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
  567. package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
  568. package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
  569. package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
  570. package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
  571. package/dist/knowledge/references/vision.constraint.config.md +66 -0
  572. package/dist/knowledge/references/vision.idea.config.md +45 -0
  573. package/dist/knowledge/references/vision.mission.config.md +46 -0
  574. package/dist/knowledge/references/vision.problem.config.md +51 -0
  575. package/dist/knowledge/references/vision.references.conventions.md +115 -0
  576. package/dist/knowledge/references/vision.snapshot.config.md +85 -0
  577. package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
  578. package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
  579. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
  580. package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
  581. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  582. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
  583. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
  584. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
  585. package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
  586. package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
  587. package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
  588. package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
  589. package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
  590. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
  591. package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
  592. package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
  593. package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
  594. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
  595. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
  596. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
  597. package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
  598. package/dist/knowledge/references/zod.factories.code.md +127 -0
  599. package/dist/knowledge/references/zod.factories.duration.md +246 -0
  600. package/dist/knowledge/references/zod.factories.money.md +166 -0
  601. package/dist/knowledge/references/zod.factories.phone.md +88 -0
  602. package/dist/knowledge/references/zod.factories.range.md +174 -0
  603. package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
  604. package/dist/knowledge/registries/framework-topics.json +5212 -0
  605. package/dist/knowledge/registries/playbooks.json +488 -0
  606. package/dist/knowledge/registries/source-tags.json +7664 -0
  607. package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
  608. package/dist/knowledge/skills/INDEX.md +349 -0
  609. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
  610. package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
  611. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
  612. package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
  613. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
  614. package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
  615. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
  616. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  617. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
  618. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
  619. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
  620. package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
  621. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
  622. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
  623. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
  624. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
  625. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
  626. package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
  627. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
  628. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
  629. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
  630. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
  631. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
  632. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
  633. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
  634. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
  635. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
  636. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
  637. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
  638. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
  639. package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
  640. package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
  641. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
  642. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
  643. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
  644. package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
  645. package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
  646. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
  647. package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
  648. package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
  649. package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
  650. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
  651. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
  652. package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
  653. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
  654. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
  655. package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
  656. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
  657. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
  658. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  659. package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
  660. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
  661. package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
  662. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
  663. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
  664. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
  665. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
  666. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
  667. package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
  668. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
  669. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
  670. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
  671. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
  672. package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
  673. package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
  674. package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
  675. package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
  676. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
  677. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
  678. package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
  679. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
  680. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
  681. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
  682. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
  683. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
  684. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
  685. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
  686. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
  687. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
  688. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
  689. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
  690. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
  691. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
  692. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
  693. package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
  694. package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
  695. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
  696. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
  697. package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
  698. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
  699. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
  700. package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
  701. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
  702. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
  703. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
  704. package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
  705. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
  706. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
  707. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
  708. package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
  709. package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
  710. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
  711. package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
  712. package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
  713. package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
  714. package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
  715. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
  716. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
  717. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
  718. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
  719. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
  720. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
  721. package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
  722. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
  723. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
  724. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
  725. package/dist/knowledge/skills/market-category/SKILL.md +290 -0
  726. package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
  727. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
  728. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
  729. package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
  730. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
  731. package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
  732. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
  733. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
  734. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
  735. package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
  736. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
  737. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
  738. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
  739. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
  740. package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
  741. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
  742. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
  743. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
  744. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
  745. package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
  746. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
  747. package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
  748. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
  749. package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
  750. package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
  751. package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
  752. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
  753. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
  754. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
  755. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
  756. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
  757. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
  758. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
  759. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
  760. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
  761. package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
  762. package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
  763. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
  764. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
  765. package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
  766. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
  767. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
  768. package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
  769. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
  770. package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
  771. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
  772. package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
  773. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
  774. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
  775. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
  776. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
  777. package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
  778. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
  779. package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
  780. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
  781. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
  782. package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
  783. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
  784. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
  785. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
  786. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
  787. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
  788. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
  789. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
  790. package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
  791. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
  792. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
  793. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
  794. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
  795. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
  796. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
  797. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
  798. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
  799. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
  800. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
  801. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  802. package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
  803. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
  804. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
  805. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
  806. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
  807. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
  808. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
  809. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
  810. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
  811. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
  812. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
  813. package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
  814. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
  815. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
  816. package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
  817. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
  818. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
  819. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
  820. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
  821. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
  822. package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
  823. package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
  824. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
  825. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
  826. package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
  827. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
  828. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
  829. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
  830. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
  831. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
  832. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
  833. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
  834. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
  835. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
  836. package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
  837. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
  838. package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
  839. package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
  840. package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
  841. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
  842. package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
  843. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
  844. package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
  845. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
  846. package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
  847. package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
  848. package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
  849. package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
  850. package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
  851. package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
  852. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
  853. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
  854. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
  855. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
  856. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
  857. package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
  858. package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
  859. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
  860. package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
  861. package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
  862. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
  863. package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
  864. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
  865. package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
  866. package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
  867. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
  868. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
  869. package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
  870. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
  871. package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
  872. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
  873. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
  874. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
  875. package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
  876. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
  877. package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
  878. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
  879. package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
  880. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
  881. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
  882. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
  883. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
  884. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
  885. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
  886. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
  887. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
  888. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
  889. package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
  890. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
  891. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
  892. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
  893. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
  894. package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
  895. package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
  896. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
  897. package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
  898. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
  899. package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
  900. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
  901. package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
  902. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
  903. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
  904. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
  905. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
  906. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
  907. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
  908. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
  909. package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
  910. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
  911. package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
  912. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
  913. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
  914. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
  915. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
  916. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
  917. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
  918. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
  919. package/dist/knowledge/topic-index.json +17510 -0
  920. package/dist/tsconfig.build.tsbuildinfo +1 -0
  921. package/dist/tsconfig.tsbuildinfo +1 -0
  922. package/package.json +49 -0
@@ -0,0 +1,845 @@
1
+ # Field change — shared + operation UI contracts (source)
2
+
3
+ - After the shared schema edit, **operation-level** frontend config and **structural** param shapes must stay consistent.
4
+
5
+ ## Import Origins
6
+
7
+ - `@wildo-ai/zod-decorators`
8
+
9
+ ## Source Excerpts
10
+
11
+ ### Origin Package: `@wildo-ai/zod-decorators`
12
+
13
+ ```typescript
14
+ *
15
+ * Structural FK params — backend/factory-relevant subset.
16
+ * Stays on `IS_FOREIGN_KEY`. UI-specific params (mode, linkable,
17
+ * displayPresetOverride) live on `ForeignKeyUIParams` via `.foreignKeyUI()`.
18
+ */
19
+ export interface ForeignKeyStructuralParams {
20
+ /**
21
+ * Marks this FK as polymorphic over a set of scope branches.
22
+ *
23
+ * - On a resource that is itself polymorphically expanded, these drive the
24
+ * per-variant FK field RENAME (e.g. `billingAccountId` →
25
+ * `organizationBillingAccountId`).
26
+ * - On a FLAT resource that holds ONE shared FK to a polymorphic branch group
27
+ * (e.g. a referral's `referrerBillingAccountId` → user OR organization
28
+ * billing account), combine with {@link polymorphicDiscriminatorField}: each
29
+ * variant carries a `discriminatorValue`, and the concrete branch is
30
+ * resolved PER RECORD from the discriminator field. The single-valued
31
+ * registry FK→type map keeps a non-authoritative representative for these
32
+ * fields; the per-record resolver is authoritative for display/links.
33
+ */
34
+ polymorphicVariants?: PolymorphicFkVariant[];
35
+ /**
36
+ * Sibling field name (on the SAME record) whose value selects which
37
+ * {@link polymorphicVariants} branch this record's FK points at. Required to
38
+ * turn `polymorphicVariants` into a per-record discriminated FK; pairs with
39
+ * each variant's `discriminatorValue`. The value is matched against the
40
+ * candidate branches' primary scope, so it typically holds a scope-type enum
41
+ * (e.g. `referrerScopeType`). Without it, `polymorphicVariants` is rename-only.
42
+ */
43
+ polymorphicDiscriminatorField?: string;
44
+ }
45
+ ```
46
+
47
+ ### Origin Package: `@wildo-ai/zod-decorators`
48
+
49
+ ```typescript
50
+ *
51
+ * Parameters for the isBackendOnly decorator.
52
+ * Marks fields that should only exist on the backend and be stripped from API responses.
53
+ */
54
+ export interface BackendOnlyFieldParams {
55
+ /**
56
+ * If true, the field will be included in the response for CREATE operations only,
57
+ * then stripped from all subsequent READ operations.
58
+ * Useful for secrets, API keys, etc. that should only be returned once.
59
+ *
60
+ * This is also the framework's ONLY disclosure-audit trigger: a field that carries it emits one
61
+ * `FIELD_ACCESS` audit event at the moment it is first (and last) exposed. That pairing is not a
62
+ * coincidence — first exposure is the only point at which a backend-only field crosses the client
63
+ * boundary at all, so it is the only point at which "this value left the system" is a true claim.
64
+ *
65
+ * Scope limit worth knowing before relying on it: the audit event is raised from the TOP-LEVEL
66
+ * shape of the response DTO. A single `CREATE` is the reliably covered case; do not assume a
67
+ * bulk-create response gives you the same guarantee without checking.
68
+ *
69
+ * assurance-control: WILDO.SECRETS.DISCLOSURE_AUDIT — first disclosure of server-minted secret
70
+ * material is attributable.
71
+ */
72
+ isReturnedAtCreation?: boolean;
73
+ }
74
+
75
+ /**
76
+ * Parameters for the isWriteOnlySecret decorator.
77
+ * Marks a user-provided secret that stays in CREATE/UPDATE request DTOs
78
+ * (client-writable) but is masked to a placeholder on every client-facing
79
+ * response DTO; the real value is retained for backend internal reads.
80
+ * Read-side masking and the write-back sentinel are enforced by the framework
81
+ * at the client-serialization boundary — no per-resource custom implementation
82
+ * needed.
83
+ *
84
+ * Pick the right secret posture by **who owns the value and which direction it
85
+ * flows** — the three are mutually exclusive on a field:
86
+ * - `.isWriteOnlySecret()` — the CLIENT supplies the secret and the server keeps
87
+ * it (e.g. a webhook signing key, an SSO client secret). Client-writable,
88
+ * masked on read, real value kept for backend use. Re-submitting the mask is
89
+ * a no-op (the stored value is preserved).
90
+ * - `.isEphemeral()` — the SERVER mints the secret and hands it to the client
91
+ * exactly once at creation (e.g. an API key shown in a one-time reveal). Not
92
+ * client-writable, not re-readable afterwards. A composite decorator (secret
93
+ * display + one-time reveal + not-editable).
94
+ * - `.isBackendOnly()` — the field never crosses the client boundary in EITHER
95
+ * direction. Do NOT use it for a client-provided secret: it strips the field
96
+ * from the write DTOs too, so the client could never set the value.
97
+ */
98
+ export interface WriteOnlySecretFieldParams {
99
+ /**
100
+ * Intentionally empty.
101
+ *
102
+ * A write-only secret is masked on EVERY client-facing response, so there is no disclosure to
103
+ * audit — the real value never crosses the boundary. The parameter bag is kept so the decorator
104
+ * can gain options later without changing its call shape.
105
+ */
106
+ readonly _reserved?: never;
107
+ }
108
+ ```
109
+
110
+ ### Origin Package: `@wildo-ai/zod-decorators`
111
+
112
+ ```typescript
113
+ *
114
+ * Parameters for the isDiscriminator decorator.
115
+ * Marks a field as the discriminator for a discriminated union schema.
116
+ */
117
+ export interface DiscriminatorFieldParams {
118
+ /**
119
+ * Values for which the base schema is used (no extended variant).
120
+ * If not provided, auto-detected from enum values not covered by variants.
121
+ */
122
+ baseValues?: string[];
123
+ }
124
+ ```
125
+
126
+ ### Origin Package: `@wildo-ai/zod-decorators`
127
+
128
+ ```typescript
129
+ *
130
+ * Scope for unique constraint enforcement.
131
+ * - 'global': Unique across the entire collection (default)
132
+ * - 'organization': Unique within an organization (compound index with organizationId)
133
+ * - 'user': Unique per user (compound index with createdByUserId)
134
+ */
135
+ export const UniqueScope = {
136
+ GLOBAL: 'global',
137
+ ORGANIZATION: 'organization',
138
+ USER: 'user',
139
+ } as const;
140
+ export type UniqueScope = typeof UniqueScope[keyof typeof UniqueScope];
141
+
142
+ /**
143
+ * Parameters for the isUnique decorator.
144
+ * Marks a field as unique in the database with unique index.
145
+ * MongoDB will enforce uniqueness and throw E11000 duplicate key error on violations.
146
+ */
147
+ export interface UniqueFieldParams {
148
+ /**
149
+ * Scope for uniqueness constraint.
150
+ * - 'global': Unique across the entire collection (default)
151
+ * - 'organization': Unique per organization (compound index with organizationId)
152
+ * - 'user': Unique per user (compound index with createdByUserId)
153
+ */
154
+ scope?: UniqueScope;
155
+
156
+ /**
157
+ * Create a compound unique index with another field in the same schema.
158
+ * The referenced field name is resolved against the actual schema fields,
159
+ * handling polymorphic field renames automatically.
160
+ *
161
+ * @example poolKey: z.string().isUnique({ compoundWith: 'billingAccountId' })
162
+ * // Creates compound unique index: { billingAccountId: 1, poolKey: 1 }
163
+ * // For polymorphic variants, resolves e.g. to: { organizationBillingAccountId: 1, poolKey: 1 }
164
+ */
165
+ compoundWith?: string;
166
+
167
+ /**
168
+ * Whether to allow null values without triggering uniqueness.
169
+ * MongoDB unique indexes exclude null by default when sparse is true.
170
+ * @default true
171
+ */
172
+ sparse?: boolean;
173
+
174
+ /**
175
+ * Custom error message to show when uniqueness is violated.
176
+ * Supports placeholder {fieldName} which is replaced with the actual field name.
177
+ * @example "This {fieldName} is already taken"
178
+ */
179
+ errorMessage?: string;
180
+
181
+ /**
182
+ * The custom message reference the API returns when THIS field's unique index is violated.
183
+ *
184
+ * Without it, every duplicate-key rejection collapses to one generic conflict code, so an
185
+ * integrator cannot tell "that slug is taken" from "that invoice number is taken" without
186
+ * parsing a message. Naming the reference here — next to the constraint that produces it —
187
+ * keeps one authority: the key and the error it raises cannot drift apart.
188
+ *
189
+ * Pass a member of the framework's error-reference vocabulary, never a bare literal.
190
+ *
191
+ * @example slug: z.string().isUnique({ conflictMessageReference: ErrorCustomMessageReference.ORGANIZATION_SLUG_EXISTS })
192
+ */
193
+ conflictMessageReference?: string;
194
+ }
195
+
196
+ /**
197
+ * Parameters for the object-level `businessKeySet([...])` decorator.
198
+ *
199
+ * Declares a **composite business key**: the ordered list of `fields` is the stable identity of a
200
+ * row, used both by seeding upsert / upgrade / sync passes to find an existing row independently
201
+ * from its random `_id`, and by the storage adapter to materialize a compound UNIQUE index so the
202
+ * identity is enforced by the database rather than by a race-prone read-then-write.
203
+ *
204
+ * - `fields` must be non-empty and every entry must be a key declared on the
205
+ * underlying `ZodObject` shape (validated at decoration time).
206
+ * - This decorator is **mutually exclusive** with field-level `isBusinessKey()`
207
+ * on the same schema — pick one identity model.
208
+ *
209
+ * @example
210
+ * // "one membership per user per organization"
211
+ * z.object({ userId: z.string(), organizationId: z.string(), roles: z.array(z.string()) })
212
+ * .businessKeySet(['userId', 'organizationId'])
213
+ */
214
+ export interface BusinessKeySetParams {
215
+ fields: string[];
216
+
217
+ /**
218
+ * Fields whose ABSENCE takes a row out of the uniqueness constraint entirely.
219
+ *
220
+ * By default a missing member counts as a real value, so two rows that both omit it COLLIDE.
221
+ * That is the correct default for an identity whose members are always meaningful — two rows
222
+ * that are "unscoped" in the same way really are the same row.
223
+ *
224
+ * It is wrong when a member is optional in the domain sense: "unit code, unique among siblings"
225
+ * must still allow any number of siblings that carry NO code. Listing that field here scopes the
226
+ * constraint to the rows that actually have it.
227
+ *
228
+ * Every entry must also appear in `fields`. List only the members whose absence means "this row
229
+ * has no key", never merely "this member happens to be optional" — a field left out of the list
230
+ * keeps the default null-collides behaviour, which is what most composite keys want.
231
+ *
232
+ * @example
233
+ * // many code-less siblings are fine; two siblings sharing a code are not
234
+ * .businessKeySet(['organizationId', 'parentUnitId', 'code'], { skipRowsMissing: ['code'] })
235
+ */
236
+ skipRowsMissing?: string[];
237
+
238
+ /**
239
+ * The custom message reference the API returns when THIS key's unique index is violated.
240
+ *
241
+ * Without it, every duplicate-key rejection collapses to one generic conflict code, so an
242
+ * integrator cannot tell which identity was violated without parsing a message. Naming the
243
+ * reference here — next to the key that produces it — keeps one authority: the key and the error
244
+ * it raises cannot drift apart.
245
+ *
246
+ * Pass a member of the framework's error-reference vocabulary, never a bare literal.
247
+ */
248
+ conflictMessageReference?: string;
249
+ }
250
+ ```
251
+
252
+ ### Origin Package: `@wildo-ai/zod-decorators`
253
+
254
+ ```typescript
255
+ *
256
+ * Parameters for the ttl decorator.
257
+ * Marks a Date field for TTL (Time To Live) expiration in MongoDB.
258
+ * MongoDB will automatically delete documents when the TTL expires.
259
+ *
260
+ * @example
261
+ * createdAt: z.date().ttl({ expireAfterSeconds: 3600 }) // Expire 1 hour after createdAt
262
+ *
263
+ * @example
264
+ * expiresAt: z.date().ttl({ expireAfterSeconds: 0 }) // Expire at the exact date value
265
+ */
266
+ export interface TtlFieldParams {
267
+ /**
268
+ * Number of seconds after the field's date value when the document should be deleted.
269
+ * - 0: Document expires at the exact date/time stored in the field
270
+ * - N > 0: Document expires N seconds after the date/time stored in the field
271
+ *
272
+ * @example
273
+ * // Expire documents 24 hours after createdAt
274
+ * createdAt: z.date().ttl({ expireAfterSeconds: 86400 })
275
+ *
276
+ * @example
277
+ * // Expire documents at the exact expiresAt date
278
+ * expiresAt: z.date().ttl({ expireAfterSeconds: 0 })
279
+ */
280
+ expireAfterSeconds: number;
281
+ }
282
+ ```
283
+
284
+ ### Origin Package: `@wildo-ai/zod-decorators`
285
+
286
+ ```typescript
287
+ *
288
+ * Parameters for the isSummaryField decorator.
289
+ * Controls how summary fields are handled, particularly for foreign key population.
290
+ */
291
+ export interface SummaryFieldParams {
292
+ /**
293
+ * Whether to populate this foreign key field with the related resource's summary data.
294
+ * Only applicable when the field also has isForeignKey() decorator.
295
+ *
296
+ * When true:
297
+ * - The related resource will be fetched using the resourceIdentifier naming convention
298
+ * - Only the related resource's isSummaryField fields will be included
299
+ * - The populated data is optional (null if the related resource doesn't exist)
300
+ *
301
+ * @default false
302
+ *
303
+ * @example
304
+ * // Field definition:
305
+ * userId: z.string().isForeignKey().isSummaryField({ populate: true })
306
+ *
307
+ * // LIST/SEARCH response will include:
308
+ * {
309
+ * _id: "123",
310
+ * userId: "user-456",
311
+ * user: { _id: "user-456", email: "...", displayName: "..." } // populated summary
312
+ * }
313
+ */
314
+ populate?: boolean;
315
+ }
316
+ ```
317
+ ## Import Origins
318
+
319
+ - `@wildo-ai/saas-frontend-lib`
320
+
321
+ ## Source Excerpts
322
+
323
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
324
+
325
+ ```typescript
326
+ *
327
+ * How a resource collection renders its items (cards vs table). A FRONTEND
328
+ * presentation vocabulary — authored on a LIST/SEARCH operation's
329
+ * `collectionDisplayConfig` (below) in the resource UI behavior, NEVER on the
330
+ * shared resources-config operation: the backend has no notion of cards-vs-table.
331
+ * The string values are the persisted view-mode keys, so a stored user choice
332
+ * reads straight across.
333
+ *
334
+ * @example
335
+ * // resource UI behavior `views` entry:
336
+ * [Op.LIST, { collectionDisplayConfig: { displayMode: CollectionDisplayMode.TABLE, userSwitchableDisplayMode: true } }]
337
+ */
338
+ export enum CollectionDisplayMode {
339
+ /** Stacked cards — one row per item via `ResourceListItemRenderer`. */
340
+ CARDS = 'cards',
341
+ /** Dense table — one column per summary field via the table body. */
342
+ TABLE = 'table',
343
+ }
344
+
345
+ /**
346
+ * How CARDS-mode items are arranged. Orthogonal to {@link CollectionDisplayMode}
347
+ * (this only shapes the CARDS body; TABLE ignores it). LIST and GRID are kept as
348
+ * DISTINCT layouts, not a `columns: 1` collapse — a list is bordered rows sharing
349
+ * one container (`divide-y`), a grid is separated card cells in N responsive
350
+ * columns.
351
+ */
352
+ export enum CardLayoutStyle {
353
+ /** Bordered rows in a single shared container (the classic stacked list). */
354
+ LIST = 'list',
355
+ /** Separated card cells laid out in an N-column responsive grid. */
356
+ GRID = 'grid',
357
+ }
358
+ ```
359
+
360
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
361
+
362
+ ```typescript
363
+ *
364
+ * Frontend configuration for a single resource operation.
365
+ *
366
+ * Controls how the operation is surfaced in the frontend:
367
+ * - `surface` — the operation's frontend surface: `ADDRESSABLE` (routable page),
368
+ * `EMBEDDED` (non-addressable view rendered within a host: overlay, composite, or
369
+ * nested), or `API_ONLY` (headless — no interface, callable as an API). See
370
+ * `ResourceOperationFrontendSurface`.
371
+ * - `customView` — direct UIBehavior-owned React component override for authored custom operation views.
372
+ * Use the exported operation-family component types (`ResourceReadCustomViewComponent`,
373
+ * `ResourceListCustomViewComponent`, etc.) plus the matching
374
+ * `useReadOperationSurface()` / `useListOperationSurface()` helpers when you
375
+ * want a strongly truthful custom host for a specific layout family.
376
+ * - `displayPresetOverride` — layout preset override for the operation's UI
377
+ * - `navigationOverrides` — per-operation navigation transition overrides
378
+ * - `displayPriority` — visual ordering in ActionBar/operation lists (lower = higher priority)
379
+ * - `iconOverride` — per-operation icon ref (overrides resource-level icon in navigation items)
380
+ * - `collectionDisplayConfig` — for LIST/SEARCH collection operations: the default
381
+ * cards-vs-table body (`displayMode`) and whether the user may toggle it
382
+ * (`userSwitchableDisplayMode`, persisted per resource type); the CARDS
383
+ * arrangement (`cardLayout` — LIST vs N-column GRID); where each card's action
384
+ * buttons sit (`cardActionPlacement` — 2-axis anchor + orientation); and
385
+ * whether items are selectable for bulk actions (`selectable`). Pure frontend
386
+ * presentation; the backend never reads it.
387
+ *
388
+ * **Resource-owned inserted views are NOT configured here.** Composite, chart,
389
+ * and execution views declared on the resource UI behavior surface themselves
390
+ * into their targeted operation host directly, via their own canonical fields:
391
+ * `compositeViews[*].operationLike` / `chartViews[*].operationLike` (single)
392
+ * and `executionViews[*].surfaceInOperations` (list). The layout consumer
393
+ * (`ResourceLayout_InsertedViews`) reads those declarations and filters them
394
+ * by the current operation at render time — there is no operation-level
395
+ * view-ref list to author or compile.
396
+ *
397
+ * **Historical note (search hit):** earlier versions of this schema exposed an
398
+ * `additionalViews: ResourceViewRef[]` (and before that `additionalViewLinks:
399
+ * string[]`) operation-level field that authored which resource-owned views
400
+ * surfaced in this operation. That field was removed in the
401
+ * `resource-owned-view-surfacing-contract.md` workstream because it duplicated
402
+ * the per-view declaration sites (`compositeViews`, `chartViews`,
403
+ * `executionViews`) and could silently disagree with them. If you are looking
404
+ * for `additionalViews` because a doc, comment, prompt, or downstream code
405
+ * still references it, the answer is: declare the surface on the view itself
406
+ * (use `operationLike` for composite/chart, `surfaceInOperations` for
407
+ * execution), do not re-introduce an operation-level seam.
408
+ */
409
+ /**
410
+ * How an operation's ACTION (its action-bar button) is surfaced in this application.
411
+ *
412
+ * A per-app, **display-only** axis — backend authorization is unaffected, roles
413
+ * remain the only security authority, so this never makes an operation reachable
414
+ * that wasn't already; it only governs the button.
415
+ */
416
+ export enum ActionVisibility {
417
+ /** Always shown; rendered DISABLED when its `enabledCondition` is unmet. The default. */
418
+ ALWAYS = 'always',
419
+ /**
420
+ * Never shown — this app declares the operation's action off for this surface.
421
+ *
422
+ * Invariant: do NOT pair with a visible (addressable) view for the same operation.
423
+ * The action is the entry point to the view, so a visible view whose action is
424
+ * hidden is contradictory — there is no way to reach it. Hiding the action removes
425
+ * the operation, and the path to any view it has, from this app's UI.
426
+ */
427
+ HIDDEN = 'hidden',
428
+ /**
429
+ * Shown ONLY when its `enabledCondition` is met; HIDDEN (not disabled) otherwise.
430
+ *
431
+ * For state-conditional operations whose disabled state is just noise — e.g.
432
+ * organization `ACTIVATE` appears on a suspended org but vanishes on an active one,
433
+ * rather than sitting there greyed out.
434
+ */
435
+ WHEN_AVAILABLE = 'when_available',
436
+ }
437
+
438
+ /**
439
+ * Where an operation's ACTION sits in the action bar for this application.
440
+ *
441
+ * A per-app, **display-only** layout axis, orthogonal to authorization. When
442
+ * omitted, placement is DERIVED from the operation's `riskLevel`: HIGH/CRITICAL
443
+ * operations default to `DANGER_ZONE`, everything else to `PRIMARY`. Set it
444
+ * explicitly to override that default — e.g. tuck a non-risky-but-rare action
445
+ * into the danger zone, or keep a CRITICAL action inline in a dedicated admin
446
+ * tool. The same axis drives the bulk action bar, since both are built from the
447
+ * same operation pipeline.
448
+ */
449
+ export enum ActionPlacement {
450
+ /** Inline in the main action group. The default for low/medium-risk operations. */
451
+ PRIMARY = 'primary',
452
+ /**
453
+ * Segregated into a trailing "danger zone" group, fenced off by a separator,
454
+ * after every PRIMARY action. The default for HIGH/CRITICAL-risk operations
455
+ * (destructive deletes, lifecycle suspends).
456
+ */
457
+ DANGER_ZONE = 'danger_zone',
458
+ }
459
+
460
+ /**
461
+ * HOW an operation's action collects its input and shows its result — the chrome the user meets
462
+ * when they click the button.
463
+ *
464
+ * ## Why this axis exists
465
+ *
466
+ * Until this axis, one rule decided the answer for every custom operation:
467
+ * *has a `requestDto` ⇒ navigate*. So an action asking for a single reason string got the same
468
+ * full-page treatment as a multi-step wizard, and the only way out was to author
469
+ * `navigationOverrides` — per operation, in terms of a zone, a transition verb and an appearance.
470
+ * Three concepts to answer one question.
471
+ *
472
+ * This is that one question. It is a **display-only** axis: backend authorization is untouched and
473
+ * `roles` remain the only security authority, exactly like its siblings {@link ActionVisibility},
474
+ * {@link ActionPlacement} and {@link ResourceOperationActionScope}.
475
+ *
476
+ * ## It is an ALIAS, not a parallel mechanism
477
+ *
478
+ * `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions
479
+ * that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one
480
+ * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at
481
+ * all, because none of them is a destination: nothing is pushed, no zone changes, and there is
482
+ * nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —
483
+ * see `InPlaceOperationContext` for why that is not the navigation layer's job.
484
+ *
485
+ * Consequently an explicit `navigationOverrides` entry still WINS over a presentation authored here
486
+ * (it is the more specific instrument, and it is checked first in the resolution chain). Author this
487
+ * axis to say what KIND of chrome the action wants; author `navigationOverrides` when you need to
488
+ * name the zone, the appearance or the viewport yourself.
489
+ *
490
+ * ## When omitted
491
+ *
492
+ * It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An
493
+ * operation that asks for nothing executes directly; a small field set opens a modal; input the
494
+ * framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it
495
+ * has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author
496
+ * has already said it is a deep-linkable destination.
497
+ */
498
+ export enum ResourceOperationActionPresentation {
499
+ /**
500
+ * Execute on click, with no form at all — the confirmation dialog for a risky operation is the
501
+ * only thing between the click and the request.
502
+ *
503
+ * Only meaningful for an operation that needs no caller input. Declaring it on an operation that
504
+ * DOES have required request fields would send an empty body, so the resolver refuses to derive it
505
+ * there and an author who declares it anyway gets the operation's fields dropped — check
506
+ * `requestDto` before reaching for this.
507
+ */
508
+ DIRECT = 'direct',
509
+ /**
510
+ * A small form anchored to the button that opened it, dismissed by clicking away.
511
+ *
512
+ * The single-input idiom ("assign to…", "snooze until…"). Transient by construction: no URL, no
513
+ * history entry, nothing to deep-link. Use it when the surrounding context is the point — the user
514
+ * is reading the row they are acting on and must not lose sight of it.
515
+ */
516
+ POPOVER = 'popover',
517
+ /**
518
+ * The element being acted on transforms in place to collect the input, leaving its neighbours
519
+ * visible — the row becomes the form rather than being covered by one.
520
+ *
521
+ * Use it when the surrounding rows are the point: the user is comparing, and an overlay would hide
522
+ * the very thing that made them act on this row.
523
+ *
524
+ * **Transient, like {@link POPOVER}, and for the same reason.** Nothing is pushed, no URL changes,
525
+ * and a reload returns the list to rest. An inline row-edit is a momentary state of a listing, not
526
+ * a place — which is also why no admin framework deep-links one, and why anything that SHOULD be
527
+ * linkable, reloadable or reachable by a back button wants {@link PAGE}.
528
+ *
529
+ * **It requires a collection.** The host is provided by the list the element belongs to
530
+ * (`InPlaceOperationProvider`); the same action rendered on a detail page, in a danger zone or in a
531
+ * picker has no row to transform and degrades to an overlay rather than becoming a dead button.
532
+ *
533
+ * Note it does NOT resolve to `NavigationTransition.INPLACE`. Element-level hosting uses none of
534
+ * what the navigation layer offers — no zone, no stack entry, no appearance — and routing it there
535
+ * is exactly why that transition has never done what its own docstring promises. See
536
+ * `InPlaceOperationContext`.
537
+ */
538
+ INLINE = 'inline',
539
+ /**
540
+ * An overlay above the layout — the workhorse for "a handful of fields", and the default the
541
+ * derivation reaches for.
542
+ *
543
+ * Resolves to {@link NavigationTransition.OVERLAY}. The concrete appearance (dialog / sheet /
544
+ * drawer / panel) stays the app's decision, resolved from its navigation layout exactly as any
545
+ * other overlay: this axis says "an overlay", not "a dialog specifically". Author
546
+ * `navigationOverrides` when you need to name one.
547
+ */
548
+ MODAL = 'modal',
549
+ /**
550
+ * A routable page, resolved through the ordinary navigation chain (zone transitions, viewport
551
+ * overrides, the framework `PUSH` fallback) — i.e. exactly the behaviour every parameterised
552
+ * action had before this axis existed.
553
+ *
554
+ * The right answer for complex or multi-step input, and for anything a user should be able to
555
+ * link to, reload, or reach with a back button.
556
+ */
557
+ PAGE = 'page',
558
+ }
559
+
560
+ /**
561
+ * Does an operation's action target a SINGLE resource instance, or the WHOLE
562
+ * collection in the current scope?
563
+ *
564
+ * A per-app **surfacing** axis, orthogonal to authorization. Most actions are
565
+ * `ITEM` (edit / delete / retry one row) and render in the per-row and detail
566
+ * action bars. A `COLLECTION` action operates on every row in scope at once
567
+ * (e.g. "retry all failed deliveries", "purge the queue"): it renders ONCE in
568
+ * the list's collection-action surface (the toolbar), never per row, and
569
+ * confirms + executes in place rather than opening a per-row form.
570
+ *
571
+ * For a `COLLECTION` action to have a callable route, its operation must borrow
572
+ * a COLLECTION verb via `resourceOperationLike` (`UPDATE_MANY` / `DELETE_MANY` /
573
+ * `CREATE_MANY`) — an entity verb (`UPDATE` / `DELETE`) generates a route with a
574
+ * `:id` segment the scope-level surface has no single row to fill.
575
+ */
576
+ export enum ResourceOperationActionScope {
577
+ /** Targets one resource instance — the per-row / detail action bars. The default when omitted. */
578
+ ITEM = 'item',
579
+ /** Targets the whole collection in scope — rendered once in the list's collection-action surface. */
580
+ COLLECTION = 'collection',
581
+ }
582
+
583
+ /**
584
+ * What happens to an operation's action when its `enabledCondition` is currently
585
+ * unmet — the per-view default for actions that don't declare an explicit
586
+ * `actionVisibility`. An explicit per-operation `actionVisibility` always wins
587
+ * over this policy; feature-gated unavailability keeps its own
588
+ * `FeatureUnavailabilityBehavior` (upgrade/prompt) and is never hidden by this.
589
+ *
590
+ * - `HIDE` — drop the action entirely while unavailable (as if it declared
591
+ * `ActionVisibility.WHEN_AVAILABLE`). The framework default for BOTH views: a
592
+ * greyed, non-actionable button is noise wherever it sits, and hiding it also
593
+ * collapses mutually-exclusive state pairs (e.g. "Set as recurring" / "Set as
594
+ * one time") down to the one that currently applies.
595
+ * - `SHOW_DISABLED` — render the action greyed/disabled (the classic behavior).
596
+ * Opt in per view when the disabled action + its reason tooltip is genuinely
597
+ * informative and you want it always present.
598
+ */
599
+ export enum DisabledActionHandling {
600
+ SHOW_DISABLED = 'show_disabled',
601
+ HIDE = 'hide',
602
+ }
603
+
604
+ /**
605
+ * Per-view action-surfacing (disclosure) policy — how many actions stay visible
606
+ * and how unavailable ones are treated, for ONE {@link ResourceOperationDisplayMode}.
607
+ */
608
+ export interface ResourceActionDisclosureConfig {
609
+ /**
610
+ * How many PRIMARY actions render as direct buttons before the remainder
611
+ * collapse into the `…` overflow menu. Omitted inherits the framework default
612
+ * for the view ({@link DEFAULT_ACTION_DISCLOSURE}): 3 for SUMMARY, unlimited
613
+ * for DETAIL. `0` pushes every action into the menu.
614
+ */
615
+ maxPrimaryActions?: number;
616
+ /**
617
+ * Default handling for actions disabled by an unmet `enabledCondition` — see
618
+ * {@link DisabledActionHandling}. Omitted inherits the framework default,
619
+ * which is `HIDE` for both views (set `SHOW_DISABLED` here to keep disabled
620
+ * actions greyed-but-present for a view).
621
+ */
622
+ disabledActionHandling?: DisabledActionHandling;
623
+ }
624
+
625
+ /** Fully-resolved disclosure policy (no optional fields) for one view. */
626
+ export interface ResolvedActionDisclosure {
627
+ /** `undefined` = unlimited (no overflow cap). */
628
+ maxPrimaryActions: number | undefined;
629
+ disabledActionHandling: DisabledActionHandling;
630
+ }
631
+
632
+ /**
633
+ * Framework defaults per view. Both views HIDE actions disabled by an unmet
634
+ * `enabledCondition` — an inapplicable, greyed button is noise everywhere, so
635
+ * the bar only ever shows actions the user can actually take right now. They
636
+ * differ on the overflow cap: SUMMARY (dense list/table rows) shows at most 3
637
+ * direct actions before the `…` menu; DETAIL (roomy read view) is uncapped.
638
+ * A resource that WANTS the informative greyed-with-reason affordance opts into
639
+ * `SHOW_DISABLED` per view via `layout.actionDisclosure`.
640
+ */
641
+ export const DEFAULT_ACTION_DISCLOSURE: Record<ResourceOperationDisplayMode, ResolvedActionDisclosure> = {
642
+ [ResourceOperationDisplayMode.SUMMARY]: {
643
+ maxPrimaryActions: 3,
644
+ disabledActionHandling: DisabledActionHandling.HIDE,
645
+ },
646
+ [ResourceOperationDisplayMode.DETAIL]: {
647
+ maxPrimaryActions: undefined,
648
+ disabledActionHandling: DisabledActionHandling.HIDE,
649
+ },
650
+ };
651
+
652
+ /**
653
+ * Resolve the effective disclosure policy for a view: per-resource override
654
+ * (`layout.actionDisclosure[view]`) layered over the framework default. Used by
655
+ * both the action-building hook (disabled handling) and the operations-items
656
+ * host (overflow cap).
657
+ */
658
+ export function resolveActionDisclosure(
659
+ displayMode: ResourceOperationDisplayMode,
660
+ disclosure: Partial<Record<ResourceOperationDisplayMode, ResourceActionDisclosureConfig>> | undefined,
661
+ ): ResolvedActionDisclosure {
662
+ const base = DEFAULT_ACTION_DISCLOSURE[displayMode] ?? DEFAULT_ACTION_DISCLOSURE[ResourceOperationDisplayMode.DETAIL];
663
+ const override = disclosure?.[displayMode];
664
+ return {
665
+ maxPrimaryActions: override?.maxPrimaryActions ?? base.maxPrimaryActions,
666
+ disabledActionHandling: override?.disabledActionHandling ?? base.disabledActionHandling,
667
+ };
668
+ }
669
+
670
+ /**
671
+ * 2-axis card action-button placement. Single source of truth for the config
672
+ * field AND the `card-action-placement.utils` resolver (which imports the
673
+ * `CardActionPlacement` type inferred from this schema, so the two can never
674
+ * drift). `MIDDLE × MIDDLE` is rejected — dead-center overlaps the card content.
675
+ */
676
+ export const CardActionPlacementSchema = z.object({
677
+ vertical: z.enum(VerticalPlacement),
678
+ horizontal: z.enum(HorizontalPlacement),
679
+ orientation: z.enum(DisplayDirection).optional(),
680
+ }).refine(
681
+ (p) => !(p.vertical === VerticalPlacement.MIDDLE && p.horizontal === HorizontalPlacement.MIDDLE),
682
+ { message: 'cardActionPlacement cannot be MIDDLE × MIDDLE (dead-center overlaps card content); choose an edge or corner.' },
683
+ );
684
+
685
+ /** Authored 2-axis card action placement — inferred from {@link CardActionPlacementSchema}. */
686
+ export type CardActionPlacement = z.infer<typeof CardActionPlacementSchema>;
687
+
688
+ export const ResourceOperationFrontendConfigSchema = z.object({
689
+ /**
690
+ * The operation's frontend **surface** — see {@link ResourceOperationFrontendSurface}.
691
+ * `ADDRESSABLE` (routable page) and `EMBEDDED` (non-addressable view rendered within
692
+ * a host — overlay/composite/nested) both have a view + action button; `API_ONLY` is
693
+ * headless (no view, no button). The view fields below (`actionVisibility`,
694
+ * `customView`, `iconOverride`, layout, …) apply only to `ADDRESSABLE`/`EMBEDDED`; a
695
+ * build-time check rejects them on `API_ONLY`.
696
+ * Replaces the former `isAddressable` boolean — read via `isOperationAddressable()`.
697
+ */
698
+ surface: z.enum(ResourceOperationFrontendSurface),
699
+ /**
700
+ * How this operation's action is surfaced — see {@link ActionVisibility}. Omitted
701
+ * (the common case) behaves as `ALWAYS`.
702
+ */
703
+ actionVisibility: z.enum(ActionVisibility).optional(),
704
+ /**
705
+ * Where this operation's action sits in the bar — see {@link ActionPlacement}.
706
+ * Omitted derives from `riskLevel` (HIGH/CRITICAL → danger zone, else primary).
707
+ */
708
+ actionPlacement: z.enum(ActionPlacement).optional(),
709
+ /**
710
+ * Visual button variant (colour) for this operation's action — a
711
+ * `ButtonVariants_Variant` (e.g. `DESTRUCTIVE`, `GHOST`, `ACCENT`). Omitted
712
+ * derives from `riskLevel` (HIGH/CRITICAL → destructive/red, else ghost). Typed
713
+ * on the interface below; the Zod field stays `z.any()` because the enum lives
714
+ * in a component module a schema must not pull at runtime (same as `iconOverride`).
715
+ */
716
+ actionVariant: z.any().optional(),
717
+ /**
718
+ * Does this action target one row or the whole collection — see
719
+ * {@link ResourceOperationActionScope}. Omitted behaves as `ITEM`. A
720
+ * `COLLECTION` action renders once in the list's collection-action surface
721
+ * (never per row) and confirms + executes in place; pair it with a COLLECTION
722
+ * `resourceOperationLike` (`*_MANY`) so its generated route carries no `:id`.
723
+ */
724
+ actionScope: z.enum(ResourceOperationActionScope).optional(),
725
+ /**
726
+ * For an `ITEM` action whose backend addresses the target row by a field in
727
+ * the REQUEST BODY (not the URL id), the request-DTO field name to fill with
728
+ * the clicked row's id. When set, clicking the action executes IN PLACE —
729
+ * sending `{ [rowTargetRequestField]: <rowId> }` — instead of opening a form:
730
+ * e.g. a per-row "Retry" whose handler reads `{ entryId }` from the body. (The
731
+ * row id still rides the URL path too, which the handler may ignore.)
732
+ */
733
+ rowTargetRequestField: z.string().optional(),
734
+ /**
735
+ * HOW this action collects its input — see {@link ResourceOperationActionPresentation}.
736
+ * Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input
737
+ * executes directly, a small field set opens a modal, complex input keeps its page.
738
+ *
739
+ * Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins
740
+ * over whatever this resolves to.
741
+ */
742
+ actionPresentation: z.enum(ResourceOperationActionPresentation).optional(),
743
+ customView: z.any().optional(),
744
+ displayPresetOverride: z.object({
745
+ resourceLayoutPresetKey: z.string().optional(),
746
+ }).optional(),
747
+ navigationOverrides: z.array(NavigationOperationOverrideSchema).optional(),
748
+ displayPriority: z.number().optional(),
749
+ iconOverride: z.any().optional(),
750
+ collectionDisplayConfig: z.object({
751
+ displayMode: z.enum(CollectionDisplayMode).optional(),
752
+ userSwitchableDisplayMode: z.boolean().optional(),
753
+ /**
754
+ * Promote ONE enum filter field to a prominent quick-filter tab strip
755
+ * rendered above the collection toolbar ("All · <value> · <value> …" —
756
+ * the Stripe/Ignisign webhook-dashboard idiom, e.g. All/Delivered/Failed).
757
+ *
758
+ * The named field MUST be an enum member of the operation's backend
759
+ * `filterFields` — the tabs write into the SAME filter state as the
760
+ * filters panel (selecting a tab filters server-side), and the field is
761
+ * removed from the panel/chips so there is never a second competing
762
+ * control for it. Unknown / non-enum field names degrade gracefully
763
+ * (no tab strip, field stays in the panel). Tab labels reuse the enum
764
+ * value i18n (`tResourceFieldEnumValue`).
765
+ */
766
+ quickFilterField: z.string().optional(),
767
+ /**
768
+ * Group CARDS-mode rows into day buckets by this date field, rendering a
769
+ * date heading between groups (activity-feed idiom for log-like
770
+ * collections, e.g. webhook deliveries by day). Purely presentational:
771
+ * grouping applies to the fetched page in its server order — pair it
772
+ * with a default sort on the same field so buckets are contiguous.
773
+ * Ignored in TABLE mode (column sorting owns the ordering there). Rows
774
+ * whose field value is missing/unparsable render in a trailing bucket
775
+ * without a date heading rather than being dropped.
776
+ */
777
+ temporalGroupField: z.string().optional(),
778
+ /**
779
+ * CARDS-mode arrangement — a single-column bordered LIST (default) or an
780
+ * N-column responsive GRID. See {@link CardLayoutStyle}. `columns` (1–6) is
781
+ * the TARGET maximum; the grid steps DOWN to fewer columns as the grid's own
782
+ * available WIDTH narrows (an intrinsic `auto-fill minmax` track spec — so a
783
+ * grid embedded in a narrow pane collapses even on a wide viewport, with no
784
+ * media breakpoint). Authors give one N; the framework handles the rest.
785
+ * Ignored in TABLE mode.
786
+ *
787
+ * @example
788
+ * cardLayout: { style: CardLayoutStyle.GRID, columns: 3 }
789
+ */
790
+ cardLayout: z.discriminatedUnion('style', [
791
+ z.object({ style: z.literal(CardLayoutStyle.LIST) }),
792
+ z.object({
793
+ style: z.literal(CardLayoutStyle.GRID),
794
+ columns: z.number().int().min(1).max(6),
795
+ }),
796
+ ]).optional(),
797
+ /**
798
+ * Where each card's per-item action buttons sit, as a 2-axis anchor:
799
+ * `vertical` ({@link VerticalPlacement} TOP/MIDDLE/BOTTOM) × `horizontal`
800
+ * ({@link HorizontalPlacement} START/MIDDLE/END, RTL-aware). `orientation`
801
+ * ({@link DisplayDirection}) lays the button set out as a row (HORIZONTAL,
802
+ * default) or a vertical stack (VERTICAL). Omitted → the classic
803
+ * MIDDLE × END horizontal row.
804
+ *
805
+ * `MIDDLE × MIDDLE` is rejected (dead-center overlaps the card content and
806
+ * has no sensible meaning).
807
+ *
808
+ * @example
809
+ * cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END }
810
+ */
811
+ cardActionPlacement: CardActionPlacementSchema.optional(),
812
+ /**
813
+ * Enable per-item SELECTION (checkboxes on cards / a select column in the
814
+ * table) and the resulting BULK ACTION bar. Explicit opt-in per view. The
815
+ * bar surfaces only operations declared `isBulkOperation` — a `selectable`
816
+ * view with no bulk operations shows checkboxes that drive an empty bar, so
817
+ * pair it with at least one bulk operation. Selection state is shared across
818
+ * the cards↔table toggle (it does not reset when switching modes).
819
+ */
820
+ selectable: z.boolean().optional(),
821
+ }).optional(),
822
+ /**
823
+ * Opt this operation into a generated per-operation description label
824
+ * (`resources.{res}.operations.{op}.description`, read via `tResourceOperation`).
825
+ * Default off — most operations need no description (making it mandatory for
826
+ * every operation is far too verbose). Surfaces that show one (e.g. the danger
827
+ * zone) fall back to risk-based copy when this is unset. Mirrors how fields opt
828
+ * into a description via the `.describe()` decorator.
829
+ */
830
+ hasDescription: z.boolean().optional(),
831
+ });
832
+
833
+ /**
834
+ * TypeScript interface for `ResourceOperationFrontendConfigSchema`.
835
+ * `iconOverride`, `customView`, and `actionVariant` are typed with their real
836
+ * React/enum values even though the Zod schema uses `z.any()` — Zod cannot
837
+ * validate function types, and `actionVariant`'s enum lives in a component
838
+ * module the schema must not import at runtime.
839
+ */
840
+ export type ResourceOperationFrontendConfig = Omit<z.infer<typeof ResourceOperationFrontendConfigSchema>, 'iconOverride' | 'customView' | 'actionVariant'> & {
841
+ iconOverride?: IconLike;
842
+ customView?: React.ComponentType;
843
+ actionVariant?: ButtonVariants_Variant;
844
+ };
845
+ ```