@wildo-ai/framework-knowledge 1.1.9 → 1.1.10

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 (376) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  5. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  6. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  8. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  9. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  10. package/dist/esm/framework-knowledge.definitions.js +84 -4
  11. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  12. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  13. package/dist/esm/index.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
  15. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
  17. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +132 -20
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
  25. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
  27. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  29. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +85 -8
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
  33. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
  35. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  37. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
  41. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
  43. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  45. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  47. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  51. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
  52. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  53. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  55. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  56. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +10 -4
  58. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  60. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  61. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  62. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  63. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
  64. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  65. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
  66. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  67. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  68. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  69. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  70. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  72. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  75. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
  80. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  81. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
  82. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  83. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  85. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  88. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  89. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
  90. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  91. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  93. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  95. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  97. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  99. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
  103. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  104. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  105. package/dist/knowledge/manifest.json +7 -7
  106. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
  107. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  108. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  109. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +149 -11
  110. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
  111. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
  113. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -2
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +107 -11
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
  118. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
  119. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  122. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
  123. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
  124. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +2 -1
  125. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  126. package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
  127. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
  128. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  129. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  130. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  131. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  132. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +7 -3
  133. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  134. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  135. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  136. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  137. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  138. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  139. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  140. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  141. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  142. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  143. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
  144. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  145. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
  150. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  152. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  153. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  154. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  157. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +19 -0
  158. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
  159. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  160. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  161. package/dist/knowledge/references/build-plan.task-graph.config.md +55 -0
  162. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  163. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  164. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  165. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
  166. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  167. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
  168. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  169. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  170. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  171. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  172. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  173. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  174. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  175. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  176. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
  177. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  178. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  179. package/dist/knowledge/references/experience-plan.config.md +60 -7
  180. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  181. package/dist/knowledge/references/placement-plan.config.md +43 -0
  182. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  183. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  184. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  185. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  186. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  187. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  188. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  189. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  190. package/dist/knowledge/references/saas.backend.email.send.md +77 -0
  191. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  192. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  193. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  194. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  195. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
  196. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
  197. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
  198. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
  199. package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
  200. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
  201. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
  202. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  203. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
  204. package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
  205. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
  206. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
  207. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  208. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  209. package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
  210. package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
  211. package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
  212. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  213. package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
  214. package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
  215. package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
  216. package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
  217. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  218. package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
  219. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  220. package/dist/knowledge/references/website-plan.config.md +26 -0
  221. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
  222. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
  223. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  224. package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
  225. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
  226. package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
  227. package/dist/knowledge/references/zod.factories.code.md +1 -0
  228. package/dist/knowledge/references/zod.factories.duration.md +1 -0
  229. package/dist/knowledge/references/zod.factories.money.md +1 -0
  230. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  231. package/dist/knowledge/registries/framework-topics.json +337 -1
  232. package/dist/knowledge/registries/playbooks.json +18 -18
  233. package/dist/knowledge/registries/source-tags.json +1435 -873
  234. package/dist/knowledge/rules/live-context-door.md +1 -1
  235. package/dist/knowledge/skills/INDEX.md +3 -1
  236. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  237. package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
  238. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  239. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  240. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  241. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
  242. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
  243. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  244. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
  245. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
  246. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  247. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  248. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  249. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
  250. package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
  251. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
  252. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
  253. package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
  254. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  255. package/dist/knowledge/skills/config-saas/SKILL.md +25 -11
  256. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
  257. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
  258. package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
  259. package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
  260. package/dist/knowledge/skills/email-add-template/SKILL.md +27 -5
  261. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  262. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
  263. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  264. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  265. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  266. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
  267. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
  268. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
  269. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
  270. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
  271. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +18 -4
  272. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
  273. package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
  274. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  275. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  276. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  277. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  278. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  279. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  280. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +11 -3
  281. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
  282. package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
  283. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
  284. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  285. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  286. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  287. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  288. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  289. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  290. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  291. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  292. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  293. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
  294. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  295. package/dist/knowledge/skills/module-relationships/SKILL.md +31 -4
  296. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  297. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
  298. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
  299. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
  300. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
  301. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  302. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
  303. package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
  304. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
  305. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
  306. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
  307. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
  308. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
  309. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  310. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
  311. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
  312. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  313. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
  314. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
  315. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
  316. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
  317. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
  318. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  319. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
  320. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
  321. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
  322. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
  323. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  324. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  325. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  326. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
  327. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
  328. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
  329. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  330. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  331. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  332. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  333. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
  334. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
  335. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  336. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  337. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
  338. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  339. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  340. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  341. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  342. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  343. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  344. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
  345. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  346. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  347. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
  348. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
  349. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
  350. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
  351. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
  352. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
  353. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
  354. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
  355. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +10 -2
  356. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
  357. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
  358. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
  359. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
  360. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
  361. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
  362. package/dist/knowledge/skills/website-page-authoring/SKILL.md +16 -5
  363. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
  364. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
  365. package/dist/knowledge/skills/website-section-faq/SKILL.md +6 -1
  366. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
  367. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
  368. package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
  369. package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
  370. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
  371. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
  372. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
  373. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
  374. package/dist/knowledge/topic-index.json +1441 -269
  375. package/dist/tsconfig.build.tsbuildinfo +1 -1
  376. package/package.json +4 -4
@@ -0,0 +1,156 @@
1
+ # saas.backend.document-sequence.raise-floor
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ *
13
+ * CONTINUE an existing numbering: set the last number one document sequence has issued, so the next document gets
14
+ * `floor + 1`. Use it when the application replaces another invoicing tool (its last invoice was INV-2026-00417, so
15
+ * pass `floor: 417` and the next is INV-2026-00418), or when a field that already held numbers gains
16
+ * `.documentSequence(...)` (see `raiseDocumentSequenceFloorsToExistingRows`).
17
+ *
18
+ * It only RAISES. A floor below the counter is refused (`document_sequence_floor_below_counter`), because lowering it
19
+ * would hand out numbers already issued; pass `whenBelowCounter: KEEP_COUNTER` to keep the counter instead. Raising
20
+ * skips numbers on purpose: the numbers between the old counter and the floor must exist in the other system or in the
21
+ * existing rows.
22
+ *
23
+ * It runs in the caller's transaction and refuses without one. It serializes with documents numbered at the same
24
+ * moment: on PostgreSQL it waits on the counter's row lock, and on MongoDB the transaction is retried. A
25
+ * compare-and-set on the counter's value backs that up (`document_sequence_counter_moved`), so a stale read can never
26
+ * overwrite a number already handed out.
27
+ *
28
+ * From an operation, call {@link raiseDocumentSequenceFloorInOperation}. The engine exposes no endpoint for it, so your
29
+ * operation is what decides who may continue a numbering, and what the audit trail keeps:
30
+ *
31
+ * - **Who**: mount the operation under the organization route for an ORGANIZATION sequence, with your organization
32
+ * administrator role, and the wrapper takes the organization from that route, never from the request body. For an
33
+ * APPLICATION sequence, restrict it to an application administrator role.
34
+ * - **Why**: put a required, bounded `justification` string in the request DTO and declare
35
+ * `auditableEvent: { reasonField: 'justification' }`, with a `HIGH` or `CRITICAL` risk level. The trail then records
36
+ * who ran it, when, and the justification.
37
+ * - **What it does NOT record**: the counter's previous and new value. No other request value is copied into the
38
+ * trail, so state the floor in the justification, and return the outcome from the operation. A dedicated event
39
+ * recording the move is planned.
40
+ *
41
+ * Import from `@wildo-ai/saas-backend-lib`.
42
+ *
43
+ * @example
44
+ * // a "continue numbering" custom operation on invoices, under /organizations/{organizationId}/…, registered with
45
+ * // transactionalCore: true and transactionParticipants: { invoices: AppResourceType.INVOICES,
46
+ * // documentSequenceCounters: DOCUMENT_SEQUENCE_COUNTERS_RESOURCE_TYPE }; request DTO { floor, periodKey, justification }
47
+ * const outcome = await raiseDocumentSequenceFloorInOperation(utils, {
48
+ * resourceType: AppResourceType.INVOICES, fieldName: 'invoiceNumber',
49
+ * periodKey: input.periodKey, floor: input.floor, executionContext,
50
+ * });
51
+ * // outcome: { previousValue, value, raised }
52
+ */
53
+ export async function raiseDocumentSequenceFloor(input: {
54
+ readonly registry: DocumentSequenceAllocationRegistry;
55
+ readonly errorBuilder: ErrorBuilderBackendService;
56
+ readonly resourceType: string;
57
+ readonly mainSchema: z.ZodTypeAny;
58
+ readonly fieldName: string;
59
+ /** The organization of an ORGANIZATION sequence. Omit it for an APPLICATION sequence. */
60
+ readonly organizationId?: string;
61
+ /**
62
+ * The counting period: `'2026'` for a yearly sequence, `'2026-10'` for a monthly one, `''` for one that never
63
+ * restarts. Defaults to the current period, read in the organization's timezone.
64
+ */
65
+ readonly periodKey?: string;
66
+ /** The last number already issued in that sequence. */
67
+ readonly floor: number;
68
+ readonly whenBelowCounter?: DocumentSequenceFloorBelowCounter;
69
+ readonly executionContext: ExecutionContext<any>;
70
+ readonly options: RepositoryOptions | undefined;
71
+ /** Only used to default `periodKey`. */
72
+ readonly now?: Date;
73
+ }): Promise<DocumentSequenceFloorRaise> {
74
+ const { registry, errorBuilder, executionContext, resourceType } = input;
75
+ const refuse = (type: ErrorType, reason: string, extra: Record<string, unknown> = {}) =>
76
+ errorBuilder.buildError(type, executionContext, { context: { reason, resourceType, fieldName: input.fieldName, ...extra } });
77
+ const field = documentSequenceFieldsOf(input.mainSchema).find((candidate) => candidate.fieldName === input.fieldName);
78
+ if (field === undefined) throw refuse(ErrorType.CONFIGURATION, 'document_sequence_field_not_declared');
79
+ if (!Number.isSafeInteger(input.floor) || input.floor < 0) throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_invalid', { floor: input.floor });
80
+ const transaction = input.options?.transaction;
81
+ if (transaction === undefined) throw refuse(ErrorType.CONFIGURATION, 'document_sequence_requires_transaction');
82
+
83
+ const isOrganizationSequence = field.params.scope === DocumentSequenceScope.ORGANIZATION;
84
+ const organizationId = input.organizationId;
85
+ if (isOrganizationSequence && (typeof organizationId !== 'string' || organizationId.length === 0)) {
86
+ throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_without_organization');
87
+ }
88
+ // An organization named for an APPLICATION sequence would be silently ignored, and the floor applied to everyone.
89
+ if (!isOrganizationSequence && organizationId !== undefined) throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_organization_for_application_sequence');
90
+ const scopeKey = isOrganizationSequence ? organizationId! : DOCUMENT_SEQUENCE_APPLICATION_SCOPE_KEY;
91
+
92
+ const parsed = parseDocumentSequenceFormat(field.params.format);
93
+ const periodKey = input.periodKey
94
+ ?? documentSequencePeriodKey(parsed, input.now ?? new Date(), await organizationTimeZone(input, field, scopeKey, new Map()));
95
+ if (!PERIOD_KEY_SHAPE[parsed.period].test(periodKey)) throw refuse(ErrorType.VALIDATION, 'document_sequence_floor_period_invalid', { periodKey, period: parsed.period });
96
+
97
+ const _id = await ensureDocumentSequenceCounter(registry, executionContext, transaction, { resourceType, fieldName: field.fieldName, scopeKey, periodKey });
98
+ const current = await registry.readUnscopedByKey<DocumentSequenceCounter>(COUNTERS, { _id }, { transaction });
99
+ const previousValue = current?.value;
100
+ if (typeof previousValue !== 'number') throw refuse(ErrorType.INTERNAL, 'document_sequence_counter_not_advanced');
101
+ if (input.floor === previousValue) return { previousValue, value: previousValue, raised: false };
102
+ if (input.floor < previousValue) {
103
+ if ((input.whenBelowCounter ?? DocumentSequenceFloorBelowCounter.REFUSE) === DocumentSequenceFloorBelowCounter.KEEP_COUNTER) {
104
+ return { previousValue, value: previousValue, raised: false };
105
+ }
106
+ throw refuse(ErrorType.CONFLICT, 'document_sequence_floor_below_counter', { floor: input.floor, counter: previousValue, periodKey });
107
+ }
108
+ // Compare-and-set: a number allocated since the read moves the value, and this write then matches nothing.
109
+ const written = await registry.atomicGuardedMutation<DocumentSequenceCounter>(COUNTERS, { _id, value: previousValue }, { set: { value: input.floor } }, undefined, { transaction });
110
+ if (written === null) throw refuse(ErrorType.CONFLICT, 'document_sequence_counter_moved', { periodKey });
111
+ return { previousValue, value: input.floor, raised: true };
112
+ }
113
+
114
+ /**
115
+ * {@link raiseDocumentSequenceFloor} from inside the application's own operation: the schema comes from the resource
116
+ * registry, the transaction from the operation, and an ORGANIZATION sequence's organization from the operation's
117
+ * organization route (`/organizations/{organizationId}/…`), which the framework has already authorized the caller for.
118
+ * Refuses an ORGANIZATION sequence when the operation has no organization in its route, rather than accept one from the
119
+ * request, which would let one organization's administrator move another's numbering.
120
+ */
121
+ export async function raiseDocumentSequenceFloorInOperation(
122
+ utils: {
123
+ readonly repositoriesRegistry: RepositoriesRegistryHandlerBackendService;
124
+ readonly errorBuilder: ErrorBuilderBackendService;
125
+ readonly resourcesRegistry: { getResourceConfiguration(resourceType: string): { mainSchema: z.ZodTypeAny } };
126
+ readonly serviceOptions?: { readonly transaction?: RepositoryOptions['transaction'] };
127
+ },
128
+ input: {
129
+ readonly resourceType: string;
130
+ readonly fieldName: string;
131
+ readonly periodKey?: string;
132
+ readonly floor: number;
133
+ readonly whenBelowCounter?: DocumentSequenceFloorBelowCounter;
134
+ readonly executionContext: ExecutionContext<any>;
135
+ },
136
+ ): Promise<DocumentSequenceFloorRaise> {
137
+ const mainSchema = utils.resourcesRegistry.getResourceConfiguration(input.resourceType).mainSchema;
138
+ const field = documentSequenceFieldsOf(mainSchema).find((candidate) => candidate.fieldName === input.fieldName);
139
+ const routeOrganizationId = input.executionContext.getContextResourceId(coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS]);
140
+ const isOrganizationSequence = field?.params.scope === DocumentSequenceScope.ORGANIZATION;
141
+ return raiseDocumentSequenceFloor({
142
+ registry: utils.repositoriesRegistry,
143
+ errorBuilder: utils.errorBuilder,
144
+ resourceType: input.resourceType,
145
+ mainSchema,
146
+ fieldName: input.fieldName,
147
+ // Absent for an ORGANIZATION sequence when the route names no organization: the raise then refuses.
148
+ ...(isOrganizationSequence && routeOrganizationId !== undefined ? { organizationId: routeOrganizationId } : {}),
149
+ ...(input.periodKey === undefined ? {} : { periodKey: input.periodKey }),
150
+ floor: input.floor,
151
+ ...(input.whenBelowCounter === undefined ? {} : { whenBelowCounter: input.whenBelowCounter }),
152
+ executionContext: input.executionContext,
153
+ options: utils.serviceOptions?.transaction === undefined ? undefined : { transaction: utils.serviceOptions.transaction },
154
+ });
155
+ }
156
+ ```
@@ -0,0 +1,77 @@
1
+ # saas.backend.email.send
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ /**
13
+ * What `EmailBackendService.send(request)` takes: one email, rendered from a REGISTERED template (`templateRef` is the
14
+ * scanned key, such as `email.quotes.issue.customer`) in one locale. Reach the service from a custom operation through
15
+ * the factory's container: `container.get<EmailBackendService>(SAAS_SERVICE_TYPES.EmailService)`.
16
+ *
17
+ * Unlike a `userNotifications` entry, a direct send consults no recipient preference: the caller decides that this
18
+ * person receives this email. Use it for an email the product owes regardless of preferences (a document the customer
19
+ * asked for); anything a person may switch off belongs in `userNotifications`.
20
+ */
21
+ export interface EmailSendRequest {
22
+ /**
23
+ * Stable identity of one logical provider submission. A caller that can
24
+ * retry across process/job boundaries must persist and reuse this value.
25
+ * Ephemeral callers may omit it and let the service allocate one.
26
+ */
27
+ submissionId?: string;
28
+ /** Template reference (e.g., "system.welcome_email") */
29
+ templateRef: string;
30
+ /** Locale for template selection */
31
+ locale: AvailableLanguage;
32
+ /** Email type for provider routing */
33
+ type: EmailTemplateType;
34
+ /** Primary recipient email(s) */
35
+ to: string | string[];
36
+ /** CC recipients (optional) */
37
+ cc?: string[];
38
+ /** BCC recipients (optional) */
39
+ bcc?: string[];
40
+ /** Reply-to address (optional) */
41
+ replyTo?: string;
42
+ /** From address (optional - uses provider default if not specified) */
43
+ from?: string;
44
+ /** Context for template rendering */
45
+ context: EmailTemplateContext;
46
+ /** File IDs for attachments (optional) */
47
+ attachmentFileIds?: string[];
48
+ /** Organization ID for org-scoped templates (optional) */
49
+ organizationId?: string;
50
+ /**
51
+ * Thread this email as a reply (#1630). Becomes exactly `Message-ID`, `In-Reply-To` and `References` —
52
+ * see {@link EmailThreadingHeaders} for why there is no general headers field.
53
+ */
54
+ threading?: EmailThreadingHeaders;
55
+ }
56
+
57
+ export interface EmailSendResult {
58
+ success: boolean;
59
+ /**
60
+ * Whether an at-least-once caller should retry. An acceptance-unknown retry
61
+ * can duplicate an externally visible email; provider-native idempotency is
62
+ * only an optional risk reduction.
63
+ */
64
+ retryable: boolean;
65
+ submissionId: string;
66
+ outcome: EmailSubmissionOutcome;
67
+ /** All honest provider receipts. Empty means no receipt was returned. */
68
+ providerMessageIds: string[];
69
+ /** Provider confirmed that this logical submission was already accepted. */
70
+ deduplicated?: boolean;
71
+ rejectedRecipients?: Array<{ email: string; reason?: string }>;
72
+ providerId?: string;
73
+ error?: string;
74
+ templateRef: string;
75
+ recipientCount: number;
76
+ }
77
+ ```
@@ -0,0 +1,60 @@
1
+ # saas.backend.notifications.operation-email-template-ref
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ /**
13
+ * Canonical template identity for operation-authored email notifications: the template a `userNotifications` EMAIL
14
+ * entry renders.
15
+ *
16
+ * `email.<resource>.<operation>[.<variantKey>].<target>[_<customNotificationRef>]`, where `<target>` is the entry's
17
+ * `target` lowercased with `_` turned into `-` (an engine-internal entry without a target uses its `identifier`). The
18
+ * variant segment is present only for a variant that declares a `variantKey`, and `userNotifications` is declared on
19
+ * the OPERATION, so one entry on an operation with a keyed variant needs one template per variant.
20
+ *
21
+ * With the scanner an application ships (`keyFromPath` turns `/` into `.` under the `resources/` directory beside it), the template's
22
+ * directory is `resources/<resource>/<the rest of the ref, dotted>`: for `todos` / `change_status` / variant `admin` /
23
+ * target `USERS_CUSTOM` / custom ref `notify-assignee` it is
24
+ * `resources/todos/change_status.admin.users-custom_notify-assignee/`.
25
+ *
26
+ * Startup validation and runtime dispatch must use the same derivation;
27
+ * otherwise an application can boot against one template reference and fail
28
+ * only after a mutation commits because delivery derived another.
29
+ */
30
+ export function buildUserNotificationEmailTemplateRef(
31
+ operation: {
32
+ resourceIdentifier: string;
33
+ operationIdentifier: string;
34
+ variantKey?: string;
35
+ },
36
+ notification: {
37
+ identifier: string;
38
+ target?: string;
39
+ customNotificationRef?: string;
40
+ },
41
+ ): string {
42
+ const targetKebab =
43
+ (notification.target || notification.identifier)
44
+ .toLowerCase()
45
+ .replace(/_/g, '-');
46
+ const refParts = [
47
+ 'email',
48
+ operation.resourceIdentifier,
49
+ operation.operationIdentifier,
50
+ ];
51
+ if (operation.variantKey) {
52
+ refParts.push(operation.variantKey);
53
+ }
54
+ refParts.push(targetKebab);
55
+ const baseRef = refParts.join('.');
56
+ return notification.customNotificationRef
57
+ ? `${baseRef}_${notification.customNotificationRef}`
58
+ : baseRef;
59
+ }
60
+ ```
@@ -0,0 +1,43 @@
1
+ # saas.data-seeding.computed-entry
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ *
13
+ * Function shape of a **computed** seed entry — used by a seed whose payload depends on the row that triggered it
14
+ * (an `afterCreate` seed needs that row's `_id`). Declared as a type rather than in the Zod schema, because Zod cannot
15
+ * validate what a function returns.
16
+ *
17
+ * `triggeringRow` is that row as stored, untyped (`Record<string, unknown>` with its `_id`), or `null` for a
18
+ * lazy-access seed. Narrow the fields you read yourself.
19
+ *
20
+ * The context deliberately offers no way to READ other rows. A foreign key to a
21
+ * row another seed writes is returned as `referenceDataSeedRow(targetSeed, key)`
22
+ * and resolved by the engine (the target seed must be in `dependsOn`).
23
+ *
24
+ * It returns exactly ONE entry, every time it is called: there is no "skip this row" value. A seed that should
25
+ * apply to only some triggering rows is the wrong shape; put the condition in an operation (a postfix that creates
26
+ * the row when the condition holds) instead.
27
+ */
28
+ export type DataSeedComputedEntryFn = (context: {
29
+ /**
30
+ * The resource row whose lifecycle event fired the seed (Level B only).
31
+ * Always present for `triggerKind: 'resourceLifecycle'`. `null` for lazy
32
+ * access seeds where there is no triggering row.
33
+ */
34
+ triggeringRow: { _id: string } & Record<string, unknown> | null;
35
+ /**
36
+ * Who caused the run, for attribution only: the seed itself always runs as an internal request, whoever triggered
37
+ * it. `triggeredByUserId` is recorded in the row's `__seed` metadata and in the `DataSeedRun` ledger.
38
+ */
39
+ executionContext: {
40
+ triggeredByUserId: string | null;
41
+ };
42
+ }) => DataSeedStaticEntry | Promise<DataSeedStaticEntry>;
43
+ ```
@@ -46,8 +46,14 @@
46
46
  * dispatcher walks `fromVersion` from the persisted row's
47
47
  * `seedVersion` up to `version - 1`, then re-applies
48
48
  * `managedFields` from the declared entries.
49
- * - `dependsOn` — optional cross-seed dependency declarations (DAG
50
- * resolved at dispatch time).
49
+ * - `dependsOn` — seeds that run before this one. It orders and passes no
50
+ * data; to point an entry's foreign key at a row a dependency wrote, put
51
+ * `referenceDataSeedRow(dependencySeed, { …businessKey })` where the value
52
+ * goes, and the engine resolves it to that row's `_id` when this seed runs.
53
+ * Every referenced seed MUST be listed here.
54
+ * - `anchorEntriesToScopeForeignKey` — inject the scope's foreign key
55
+ * (`organizationId`, …) into every entry's business key, so static entries
56
+ * can be written once and seeded per scope row.
51
57
  * - `schedule` — optional cron-driven re-run binding; presence is the
52
58
  * sole opt-in signal for the engine cron batch. FORBIDDEN for
53
59
  * `mode === LAZY`.
@@ -0,0 +1,93 @@
1
+ # saas.data-seeding.row-reference
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ /**
13
+ * What a reference needs to know about the seed whose row it names. A whole `DataSeedDefinition` satisfies it — pass
14
+ * the target seed's definition, imported from the module that declares it.
15
+ */
16
+ export type DataSeedRowReferenceTarget = Pick<DataSeedDefinition, 'seedKey' | 'resourceType' | 'scope' | 'allowedApplicationEnvironments'>;
17
+
18
+ /**
19
+ * A reference to a row another seed writes, placed where a foreign-key VALUE goes in an entry's `businessKey` or
20
+ * `data` (directly, or inside a nested object or array). The engine replaces it with the row's `_id` before writing.
21
+ *
22
+ * Build it with {@link referenceDataSeedRow}; never construct one by hand.
23
+ */
24
+ export class DataSeedRowReference {
25
+ /** Brand read by {@link isDataSeedRowReference}. */
26
+ public readonly [DATA_SEED_ROW_REFERENCE_BRAND]: true = true;
27
+
28
+ /** @internal — use {@link referenceDataSeedRow}. */
29
+ public constructor(
30
+ /** The seed that writes the referenced row. Must be in the referring seed's `dependsOn`. */
31
+ public readonly target: DataSeedRowReferenceTarget,
32
+ /**
33
+ * The referenced row's business key, as the target resource declares it. The scope's own foreign key may be left
34
+ * out when both seeds share a scope kind; the engine fills it in from the scope being seeded.
35
+ */
36
+ public readonly businessKey: Readonly<Record<string, unknown>>,
37
+ ) {
38
+ Object.freeze(this);
39
+ }
40
+
41
+ /** What a log line or a JSON dump shows instead of an empty object (the brand is a symbol, which JSON drops). */
42
+ public toJSON(): string {
43
+ return describeDataSeedRowReference(this);
44
+ }
45
+ }
46
+
47
+ /**
48
+ * Reference the row a `dependsOn` seed writes, by that row's business key.
49
+ *
50
+ * @param target The seed that writes the row — its definition, as returned by `createDataSeedDefinition`.
51
+ * @param businessKey The row's business key. Leave out the scope foreign key (`organizationId`, `userId`, …) when the
52
+ * target seed has the same scope kind as the referring seed: the engine fills it from the scope being seeded.
53
+ * @throws Error when `target` has no `seedKey`, when `businessKey` is not a plain object, or when a business-key value
54
+ * is `undefined` or is itself a reference.
55
+ *
56
+ * @example
57
+ * ```ts
58
+ * import { referenceDataSeedRow } from '@wildo-ai/saas-backend-lib/data-seeding-models';
59
+ * import demoCustomersSeed from './crm.demo-customers.seed';
60
+ *
61
+ * // In a seed declaring dependsOn: [{ seedKey: demoCustomersSeed.seedKey }]
62
+ * data: { customerId: referenceDataSeedRow(demoCustomersSeed, { email: 'ana.martin@example.com' }) }
63
+ * ```
64
+ */
65
+ export function referenceDataSeedRow(
66
+ target: DataSeedRowReferenceTarget,
67
+ businessKey: Record<string, unknown>,
68
+ ): DataSeedRowReference {
69
+ if (target === null || typeof target !== 'object' || typeof target.seedKey !== 'string' || target.seedKey.length === 0) {
70
+ throw new Error('referenceDataSeedRow: `target` must be the referenced seed\'s definition (a value carrying its `seedKey`, `resourceType` and `scope`).');
71
+ }
72
+ if (!isPlainObject(businessKey)) {
73
+ throw new Error(`referenceDataSeedRow: the business key of a reference to seed '${target.seedKey}' must be a plain object.`);
74
+ }
75
+ for (const [field, value] of Object.entries(businessKey)) {
76
+ if (value === undefined) {
77
+ throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is undefined — a business key is identity; use null for a genuinely-nullable field.`);
78
+ }
79
+ if (containsDataSeedRowReference(value)) {
80
+ throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is itself a reference — a reference names its row by literal values.`);
81
+ }
82
+ }
83
+ return new DataSeedRowReference(
84
+ {
85
+ seedKey: target.seedKey,
86
+ resourceType: target.resourceType,
87
+ scope: target.scope,
88
+ ...(target.allowedApplicationEnvironments !== undefined ? { allowedApplicationEnvironments: target.allowedApplicationEnvironments } : {}),
89
+ },
90
+ Object.freeze({ ...businessKey }),
91
+ );
92
+ }
93
+ ```
@@ -0,0 +1,124 @@
1
+ # saas.frontend.collection-filter-presets
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-frontend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
10
+
11
+ ```typescript
12
+ */
13
+ /**
14
+ * A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.
15
+ *
16
+ * A preset is authored once and clicked forever, so "created today" cannot be an authored pair of
17
+ * instants — it has to be RESOLVED at the moment it is applied. The vocabulary is closed and small
18
+ * on purpose: each member is a window a person actually asks for, and each resolves to the
19
+ * `{ startDate, endDate }` pair the framework's date-range filter already carries end to end, so a
20
+ * preset needs no filter grammar of its own and no backend change.
21
+ *
22
+ * Resolution is in the VIEWER's timezone, which is the only one that makes "today" true for the
23
+ * person reading the screen. The backend compares instants, so the boundaries travel as absolute
24
+ * times and nothing downstream has to know a timezone was involved.
25
+ *
26
+ * Every window is whole local days and ends at the LAST instant of its last day, one millisecond before the next local
27
+ * midnight. The date-range filter's end bound is inclusive, and a date-only value (a due date picked in a calendar) is
28
+ * stored at the local midnight of the day it names, so ending at the next midnight would also match the day after.
29
+ */
30
+ export enum CollectionFilterPresetRelativeRange {
31
+ /** All of today, local: midnight this morning to the end of the day. */
32
+ TODAY = 'today',
33
+ /** All of yesterday, local. */
34
+ YESTERDAY = 'yesterday',
35
+ /** The last seven days INCLUDING today — the rolling week, not the last seven whole days. */
36
+ LAST_7_DAYS = 'last_7_days',
37
+ /** The last thirty days including today. */
38
+ LAST_30_DAYS = 'last_30_days',
39
+ /** The first of this calendar month through the end of today. */
40
+ THIS_MONTH = 'this_month',
41
+ /** The first of this calendar year through the end of today. */
42
+ THIS_YEAR = 'this_year',
43
+ /**
44
+ * Everything BEFORE today, local: what an "overdue" list shows on a due-date field. Ends at the last instant of
45
+ * yesterday, so a date-only value due TODAY is due, not overdue. A deadline with a time earlier today is in TODAY, not
46
+ * here: the window is whole days, like every other member, so the pill reads the same all day.
47
+ */
48
+ BEFORE_TODAY = 'before_today',
49
+ /** Today and the six days after it, local: "due this week" from today. */
50
+ NEXT_7_DAYS = 'next_7_days',
51
+ /** Today and the twenty-nine days after it, local. */
52
+ NEXT_30_DAYS = 'next_30_days',
53
+ }
54
+
55
+ /**
56
+ * A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
57
+ * viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
58
+ * reading the list, whoever that is.
59
+ *
60
+ * A preset naming one is unavailable to a viewer the value cannot be resolved for (no signed-in user): the pill is
61
+ * disabled rather than applied without the field, which would show a different list under the same name.
62
+ */
63
+ export enum CollectionFilterPresetContextValue {
64
+ /** The signed-in user's id, for a reference field such as an assignee or owner. */
65
+ CURRENT_USER = 'current_user',
66
+ }
67
+
68
+ /**
69
+ * What a preset ASSIGNS to one filter field.
70
+ *
71
+ * Four kinds, split by WHEN the value is known:
72
+ *
73
+ * - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
74
+ * which is the whole of "filter to HIGH priority";
75
+ * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
76
+ * answer would be wrong by tomorrow;
77
+ * - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
78
+ * backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
79
+ * commonest threshold anyone asks for;
80
+ * - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
81
+ * when the pill is clicked, so the same authored preset shows each viewer their own rows.
82
+ */
83
+ export const CollectionFilterPresetValueSchema = z.union([
84
+ z.string(),
85
+ z.number(),
86
+ z.boolean(),
87
+ z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
88
+ z.object({ min: z.number().optional(), max: z.number().optional() }),
89
+ z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
90
+ ]);
91
+ export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
92
+
93
+ /**
94
+ * ONE named, one-click narrowing of a collection, rendered as a toggleable pill above the list.
95
+ *
96
+ * ## Why this is not `quickFilterField`
97
+ *
98
+ * They answer different questions and both are worth having. A quick-filter field promotes ONE enum
99
+ * and spends every one of its values on a TAB STRIP: the tabs are mutually exclusive and they read
100
+ * as "which slice of this collection am I looking at". A preset is ADDITIVE and crosses fields —
101
+ * "high priority", "created today", "unassigned" — and several can be on at once. Collapsing them
102
+ * would cost one of the two meanings.
103
+ *
104
+ * ## No state of its own
105
+ *
106
+ * A preset is a WRITE into the collection's existing filter values, and its ON/OFF is DERIVED by
107
+ * reading them back: it is active exactly when every key it assigns currently holds its value. So
108
+ * clearing a chip, editing the panel, or applying a second preset that touches the same field all
109
+ * update the pills for free, and there is no second copy of the filter state to keep in step.
110
+ */
111
+ export const CollectionFilterPresetSchema = z.object({
112
+ /**
113
+ * Stable identity — the i18n key segment and the pill's DOM hook. Author-owned and never shown:
114
+ * the words come from `resources.<type>.filterPresets.<ref>.label`.
115
+ */
116
+ ref: z.string().min(1),
117
+ /**
118
+ * The fields this preset assigns, and to what. Every key must be a filter field of the operation;
119
+ * a key that is not simply never matches, so the pill would read as permanently off.
120
+ */
121
+ filters: z.record(z.string(), CollectionFilterPresetValueSchema),
122
+ });
123
+ export type CollectionFilterPreset = z.infer<typeof CollectionFilterPresetSchema>;
124
+ ```