@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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: engine-product-definitions
3
- description: Author and maintain engine-level product definition registries — feature identifiers (`ApplicationFeature` enum), feature definitions (`CUSTOM_FEATURE_DEFINITIONS`), feature profiles (`FEATURE_PROFILES`), unavailability policy (`CUSTOM_UNAVAILABILITY_POLICY`), and the parallel role / milestone definition collections. Use when the user says "add a new feature flag", "define a tier profile", "wire an addon-prompt feature", "the feature shows but isn't gated", "add a milestone definition", "register a new role definition", or any change to the runtime product / feature / role / milestone taxonomy that complements the spec layer.
3
+ description: Author and maintain engine-level product definition registries — feature identifiers (`ApplicationFeature` enum), feature definitions (`CUSTOM_FEATURE_DEFINITIONS`), feature profiles (`FEATURE_PROFILES`), unavailability policy (`CUSTOM_UNAVAILABILITY_POLICY`), and the milestone definition collection (application roles are `application-roles-authoring`). Use when the user says "add a new feature flag", "define a tier profile", "wire an addon-prompt feature", "the feature shows but isn't gated", "add a milestone definition", or any change to the runtime product / feature / milestone taxonomy that complements the spec layer.
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -47,7 +47,7 @@ roles / milestones the app ships.
47
47
  |--------------------------------------|--------------------------------------------------------------------------------------------|
48
48
  | Feature identifiers + definitions | `shared-lib/src/engine/features.ts` |
49
49
  | Milestone definitions | `shared-lib/src/engine/milestones.ts` |
50
- | Role definitions | `shared-lib/src/engine/roles.ts` (when present) |
50
+ | Role definitions | `shared-lib/src/engine/roles.ts` — see the `application-roles-authoring` skill |
51
51
  | Existing engine module contribution | `shared-lib/src/engine/index.ts` |
52
52
  | Spec parity | `specifications/src/engine/features/**/*.feature.specification.ts` (and family equivalents) |
53
53
  | Runtime consumer (backend) | operation variants declaring `requiredFeatures` |
@@ -68,16 +68,21 @@ roles / milestones the app ships.
68
68
  (`spec-feature-update` / `spec-family-update`)
69
69
  - Resource field semantics → `spec-resource-update`
70
70
  - Backend operation handler logic → `backend-custom-operation`
71
+ - Declaring or enforcing application roles → `application-roles-authoring`
71
72
  - Frontend component slot wiring → `engine-component-registration`
72
73
 
73
74
  ## Workflow
74
75
 
75
76
  ### Step 1: Pick the correct registry
76
77
 
77
- `features.ts` for feature flags / limits, `milestones.ts` for
78
- onboarding / progression milestones, `roles.ts` for app-defined
79
- roles. Each registry follows the same pattern: a typed identifier
80
- enum + a `CUSTOM_*_DEFINITIONS` array + supporting policy maps.
78
+ `features.ts` for feature flags / limits (a typed `ApplicationFeature`
79
+ enum + the `CUSTOM_FEATURE_DEFINITIONS` array + supporting policy maps),
80
+ `milestones.ts` for onboarding / progression milestones
81
+ (`CUSTOM_MILESTONE_DEFINITIONS`). Roles are NOT this pattern: an
82
+ app-defined role is an entry of the `CUSTOM_ROLES_CONFIGURATION`
83
+ record in `roles.ts`, keyed by the role name, and only does something
84
+ once it is offered on an organization type and named on operations —
85
+ follow `application-roles-authoring` for roles and skip the steps below.
81
86
 
82
87
  ### Step 2: Add the identifier to the typed enum
83
88
 
@@ -422,13 +427,21 @@ Run from the app root, substituting `<MEMBER>`:
422
427
  |---------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
423
428
  | Identifiers come from the typed enum | `rg -n "ApplicationFeature\." shared-lib/src/engine/features.ts` |
424
429
  | **No string-literal identifiers in definitions** (must be empty) | `rg -n "defineFeature\('[A-Z_]+'" shared-lib/src/engine/features.ts` |
425
- | Definitions use the typed builder | `rg -n "defineFeature\(\|defineLimitFeature\(" shared-lib/src/engine/features.ts` |
426
- | Every consumption CAP declares `limitSemantic: CEILING` (a cap left on the default FLOOR silently never engages) | `rg -n "defineLimitFeature\(" -A 6 shared-lib/src/engine/features.ts \| rg -n "FEATURES_UNLIMITED" -B 3 \| rg -n "limitSemantic"` |
430
+ | Definitions use the typed builder | see the commands below the table |
431
+ | Every consumption CAP declares `limitSemantic: CEILING` (a cap left on the default FLOOR silently never engages) | see the commands below the table |
427
432
  | Unavailability behavior uses typed enum | `rg -n "behavior:\s+FeatureUnavailabilityBehavior\." shared-lib/src/engine/features.ts` |
428
433
  | **No string-literal behavior** (must be empty) | `rg -n "behavior:\s+'" shared-lib/src/engine/features.ts` |
429
434
  | Profile entries reference enum members | `rg -n "ApplicationFeature\.<MEMBER>" shared-lib/src/engine/features.ts` |
430
435
  | Spec exists for new identifier | `rg -n "<MEMBER>" specifications/src/engine/features/` |
431
436
 
437
+ ```bash
438
+ # Definitions use the typed builder
439
+ rg -n "defineFeature\(|defineLimitFeature\(" shared-lib/src/engine/features.ts
440
+
441
+ # Every consumption CAP declares `limitSemantic: CEILING` (a cap left on the default FLOOR silently never engages)
442
+ rg -n "defineLimitFeature\(" -A 6 shared-lib/src/engine/features.ts | rg -n "FEATURES_UNLIMITED" -B 3 | rg -n "limitSemantic"
443
+ ```
444
+
432
445
  Verify identifier → definition → module registration → grant → backend enforcement → frontend presentation → specification. A declared or documented feature alone neither grants access nor protects an operation.
433
446
 
434
447
  ## Common Rationalizations
@@ -360,9 +360,17 @@ export const moduleBackend_FlowsActorsRegistry: {
360
360
 
361
361
  | Check | Command |
362
362
  |---|---|
363
- | functionRefs ↔ functionTools | `rg "functionRefs|resourceReadTool|functionRef:" backend-api/src/modules/*/addons/flows-actors` |
363
+ | functionRefs ↔ functionTools | see the commands below the table |
364
364
  | system is frontend-visible | `rg "visibility:\s*FlowActorSystem_Visibility.FRONTEND" backend-api/src/modules` |
365
- | view ↔ system ↔ launcher refs align | `rg "systemRef|viewRef:|ref:\s*'" frontend/src/modules/*/app-level-views frontend/src/modules/*/app-shell.module.frontend.ts` |
365
+ | view ↔ system ↔ launcher refs align | see the commands below the table |
366
+
367
+ ```bash
368
+ # functionRefs ↔ functionTools
369
+ rg "functionRefs|resourceReadTool|functionRef:" backend-api/src/modules/*/addons/flows-actors
370
+
371
+ # view ↔ system ↔ launcher refs align
372
+ rg "systemRef|viewRef:|ref:\s*'" frontend/src/modules/*/app-level-views frontend/src/modules/*/app-shell.module.frontend.ts
373
+ ```
366
374
 
367
375
  ## Common Rationalizations
368
376
 
@@ -327,10 +327,24 @@ Run from the app root, substituting `<module>`:
327
327
  | Agent is registered, not just declared | `rg -n "agents:\s*\[" backend-api/src/modules/<module>/addons/flows-actors` |
328
328
  | Operation key agrees across config + operationDefinition | `rg -n "operationKey:" backend-api/src/modules/<module>/addons/flows-actors` |
329
329
  | Every structured agent's callers pass a schema | `rg -n -U "GENERATE_STRUCTURED[\s\S]{0,400}schema:" backend-api/src` |
330
- | Output is unwrapped, not used bare | `rg -n "invokeAgent\(" -A 4 backend-api/src \| rg "\.output"` |
331
- | **No tools on a one-shot agent** (should be empty) | `rg -n -U "GENERATE_(TEXT\|STRUCTURED)[\s\S]{0,600}functionRefs" backend-api/src` |
332
- | **No hand-rolled provider SDK call** (should be empty) | `rg -n "@ai-sdk/\|new Anthropic\(\|new OpenAI\(" backend-api/src` |
333
- | **No API key read in app code** (should be empty) | `rg -n "ANTHROPIC_API_KEY\|OPENAI_API_KEY" backend-api/src` |
330
+ | Output is unwrapped, not used bare | see the commands below the table |
331
+ | **No tools on a one-shot agent** (should be empty) | see the commands below the table |
332
+ | **No hand-rolled provider SDK call** (should be empty) | see the commands below the table |
333
+ | **No API key read in app code** (should be empty) | see the commands below the table |
334
+
335
+ ```bash
336
+ # Output is unwrapped, not used bare
337
+ rg -n "invokeAgent\(" -A 4 backend-api/src | rg "\.output"
338
+
339
+ # No tools on a one-shot agent (should be empty)
340
+ rg -n -U "GENERATE_(TEXT|STRUCTURED)[\s\S]{0,600}functionRefs" backend-api/src
341
+
342
+ # No hand-rolled provider SDK call (should be empty)
343
+ rg -n "@ai-sdk/|new Anthropic\(|new OpenAI\(" backend-api/src
344
+
345
+ # No API key read in app code (should be empty)
346
+ rg -n "ANTHROPIC_API_KEY|OPENAI_API_KEY" backend-api/src
347
+ ```
334
348
 
335
349
  ## Common Rationalizations
336
350
 
@@ -169,10 +169,18 @@ Run from the app root, substituting `<View>` for the view's file:
169
169
  |---|---|
170
170
  | The view imports framework components | `rg -n "from '@wildo-ai/saas-frontend-lib'" <View>` |
171
171
  | No deep import into the frontend library | `rg -n "@wildo-ai/saas-frontend-lib/" <View>` |
172
- | No hand-written colour | `rg -n "#[0-9a-fA-F]{3,8}\b\|rgba?\(" <View>` |
173
- | No hand-written surface treatment | `rg -n "className=\"[^\"]*(border\|rounded\|shadow\|bg-)" <View>` |
172
+ | No hand-written colour | see the commands below the table |
173
+ | No hand-written surface treatment | see the commands below the table |
174
174
  | No unexplained `preset` pass-through | `rg -n "preset=" <View>` |
175
175
 
176
+ ```bash
177
+ # No hand-written colour
178
+ rg -n "#[0-9a-fA-F]{3,8}\b|rgba?\(" <View>
179
+
180
+ # No hand-written surface treatment
181
+ rg -n "className=\"[^\"]*(border|rounded|shadow|bg-)" <View>
182
+ ```
183
+
176
184
  The second through fifth greps should return zero matches in a finished view.
177
185
  The second is not a judgement call — a deep import into the library is forbidden
178
186
  outright; the rest are lines to re-check against step 5, not automatic defects.
@@ -219,7 +227,7 @@ once you have a candidate.
219
227
  - **Ai Elements / Meta** (7) — `AI_AgentCapabilities`, `AI_AgentCard`, `AI_AgentList`, `AI_AgentPromptSpec`, `AI_Context`, `AI_ModelSelector`, `AI_OpenInChat`
220
228
  - **Ai Elements / Shared** (2) — `AI_Loader`, `AI_Shimmer`
221
229
  - **Ai Elements / Trace** (5) — `AI_ChainOfThought`, `AI_Checkpoint`, `AI_InlineCitation`, `AI_Plan`, `AI_Reasoning`
222
- - **App** (10) — `AppLayout_ConsentGate`, `AppLayout_DocumentAcceptanceGate`, `AppLayout_ErrorBoundary`, `AppLayout_Home`, `AppLayout_MainContainer`, `AppLayout_RouterErrorBoundary`, `Files_UploadGrantDrop`, `PublicLayout_MainContainer`, `PublicLayout_StaticContentContainer`, `PublicLayout_Terms`
230
+ - **App** (11) — `AppLayout_ConsentGate`, `AppLayout_DocumentAcceptanceGate`, `AppLayout_ErrorBoundary`, `AppLayout_Home`, `AppLayout_MainContainer`, `AppLayout_RouterErrorBoundary`, `Files_UploadGrantDrop`, `PublicLayout_LegalNotice`, `PublicLayout_MainContainer`, `PublicLayout_StaticContentContainer`, `PublicLayout_Terms`
223
231
  - **Auth** (14) — `Auth_AuthCallback`, `Auth_ConfirmEmail`, `Auth_EnrollmentRequired`, `Auth_Invitation`, `Auth_MagicLinkVerify`, `Auth_Main`, `Auth_MfaChallenge`, `Auth_OAuthConsent`, `Auth_OAuthLoggedOut`, `Auth_OAuthLogoutConfirm`, `Auth_OneOffSession`, `Auth_OrganizationOnboarding`, `Auth_PasswordLost`, `Auth_Register`
224
232
  - **Billing** (6) — `BillingPortalLink`, `InvoiceHistory`, `PlanChangePreview`, `PricingTable`, `SubscriptionStatus`, `UsageDashboard`
225
233
  - **Data Display** (10) — `Avatar`, `Badge`, `DescriptionDetails`, `DescriptionList`, `DescriptionTerm`, `Duration`, `Identifier`, `Kbd`, `NotificationIndicator`, `Timeline`
@@ -114,7 +114,7 @@ an application reaches those through configuration, never through JSX.
114
114
  | `AI_Plan` | Card + collapsible composition for structured plans. | Use when agents emit explicit multi-step plans. | Avoid for unstructured prose-only replies. |
115
115
  | `AI_Reasoning` | Collapsible content area with streaming-friendly layout. | Use when showing model reasoning separate from final answer. | Avoid when reasoning must not be displayed. |
116
116
 
117
- ## App (10)
117
+ ## App (11)
118
118
 
119
119
  | Component | Renders | Use when | Avoid when |
120
120
  | --- | --- | --- | --- |
@@ -125,6 +125,7 @@ an application reaches those through configuration, never through JSX.
125
125
  | `AppLayout_MainContainer` | Root layout preset wiring `useAppShellLayout` with sidebar, toolbars, overlays, and loading gates. | Use as the top-level wrapper for signed-in SaaS experiences. | Avoid for marketing or auth-only public pages — use `PUBLIC_LAYOUTS_MAIN_CONTAINER`. |
126
126
  | `AppLayout_RouterErrorBoundary` | ErrorDisplay presets for 404/403/5xx, application crashes, and unknown failures. | Use at the router boundary wrapping navigable content. | Avoid for isolated component errors — use `APP_LAYOUTS_ERROR_BOUNDARY`. |
127
127
  | `Files_UploadGrantDrop` | Focused public shell — the target field and its constraints, one file chooser, one upload, then a terminal state (received, already used, expired, cancelled). | Reached only through a grant’s `uploadPageUrl`. It is the fallback for an assistant host that cannot perform the upload itself; a host that can run a command uses the grant’s curl example instead. | Never as a general upload surface — authenticated uploads go through the resource file fields, and nothing on this page is reachable without a grant token. |
128
+ | `PublicLayout_LegalNotice` | Public legal layout listing the legal name, establishment address and contact always, marking any of those three the operator has not declared yet, and listing legal form, representatives, trade register, VAT number, supervisory authority and regulated profession when declared; it states that no notice is published when the operator owes none. | Use on `/legal-notice`, the route the application router mounts from the public-documents atom and the marketing website links when the notice is owed. | Avoid for governed documents with releases (privacy notice, terms: use the public governed-document page) and for any text the operator did not declare: this page never drafts or invents a particular. |
128
129
  | `PublicLayout_MainContainer` | Minimal full-viewport wrapper driven by `usePublicShellLayout`. In card mode it may open the card with a brand header: the mark when one resolves, and the name — set from the TYPOGRAPHY.HEADING recipe, and not a heading element, since the card content owns the page heading. The login page may pass `organizationBranding` from identification; an explicit shell identity still wins. Tenant color is a decorative identity accent, not a replacement for accessible application theme tokens. Other public pages keep their defaults. | Use for auth flows, static marketing content, and other pre-app surfaces. | Avoid for authenticated app shells — use `APP_LAYOUTS_MAIN_CONTAINER`. |
129
130
  | `PublicLayout_StaticContentContainer` | Thin wrapper around centered content within the public shell. | Use for legal, help, or marketing pages that do not need auth chrome. | Avoid for authenticated app surfaces. |
130
131
  | `PublicLayout_Terms` | Public legal-document layout that shows release version and effective date for a release, a draft notice for an unreleased draft, and a "not yet established" note beneath any clause the document states is incomplete; it shows no partial content when nothing may be displayed, and withholds unapproved releases and drafts only when the application arms its governed-document approval gate (`compliance.governedDocumentApprovalGate`), the same switch every acceptance surface reads. | Use on `/privacy`, `/terms` and future stable-definition public document routes. | Avoid for authenticated governance records, off-site documents, or rendering a draft candidate directly — drafts reach this page only as projected public documents. |
@@ -3259,6 +3259,14 @@ import { ProgressionTrackerVariant } from '@wildo-ai/saas-models';
3259
3259
  <ProgressionMilestoneTracker variant={ProgressionTrackerVariant.DETAILED} className="w-full" />
3260
3260
  ```
3261
3261
 
3262
+ ## `PublicLayout_LegalNotice`
3263
+
3264
+ Public legal-notice (imprint) page at `/legal-notice`, rendering the operator identity particulars an information-society service provider established in the EU, the EEA, the UK or Switzerland must publish, from the application's `compliance.legalNotice` (projected from `operatorComplianceIdentity` by `wildo config legal-notice`).
3265
+
3266
+ **Composition**
3267
+
3268
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3269
+
3262
3270
  ## `PublicLayout_MainContainer`
3263
3271
 
3264
3272
  Public / unauthenticated layout container with optional centered card chrome, and — when the application opts in via `publicShellIdentityMode` — the surface identity at the top of that card.
@@ -217,13 +217,27 @@ Run from the app root, substituting `<source>` and `<target>`:
217
217
  | Invariant | Command |
218
218
  |--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
219
219
  | Engine barrel uses the scanner (single owner) | `rg -n 'scanCustomLabelsDirectory' backend-api/src/engine/i18n/index.ts` |
220
- | At least one per-unit source-locale file exists | `rg --files backend-api/src/engine/i18n -g '*.<source>.ts' \| head` |
221
- | Per-unit count matches between source and target | `diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' \| sed 's/<source>/X/' \| sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' \| sed 's/<target>/X/' \| sort)` |
222
- | Lock file is up-to-date with both locales | `rg -n '"localeCode":\s*"(<source>\|<target>)"' wildo-saas.lock.json` |
220
+ | At least one per-unit source-locale file exists | see the commands below the table |
221
+ | Per-unit count matches between source and target | see the commands below the table |
222
+ | Lock file is up-to-date with both locales | see the commands below the table |
223
223
  | **No empty values** in any per-unit file (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.ts'` |
224
224
  | **No hard-coded product strings** in JSX touched in this change | `rg -n ">[A-Z][a-z]+ [A-Z][a-z]" frontend/src/modules/<slug>/` |
225
225
  | Every per-unit file preserves the auto-generated header | `rg --files-without-match "DO NOT EDIT THIS FILE MANUALLY" backend-api/src/engine/i18n -g '*.ts'` (output should be empty) |
226
- | **No** monolithic `labels.<locale>.ts` (must be empty) | `rg --files backend-api/src/engine/i18n -g 'labels.*.ts' \| rg -v '/'` |
226
+ | **No** monolithic `labels.<locale>.ts` (must be empty) | see the commands below the table |
227
+
228
+ ```bash
229
+ # At least one per-unit source-locale file exists
230
+ rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | head
231
+
232
+ # Per-unit count matches between source and target
233
+ diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | sed 's/<source>/X/' | sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | sed 's/<target>/X/' | sort)
234
+
235
+ # Lock file is up-to-date with both locales
236
+ rg -n '"localeCode":\s*"(<source>|<target>)"' wildo-saas.lock.json
237
+
238
+ # No monolithic `labels.<locale>.ts` (must be empty)
239
+ rg --files backend-api/src/engine/i18n -g 'labels.*.ts' | rg -v '/'
240
+ ```
227
241
 
228
242
  The high-signal invariant is **"per-unit count matches between
229
243
  source and target"** combined with **"no empty values"** — drift
@@ -210,11 +210,19 @@ Run from the app root, substituting `<source>` and `<target>`:
210
210
 
211
211
  | Invariant | Command |
212
212
  |------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
213
- | At least one target-locale per-unit file exists | `rg --files backend-api/src/engine/i18n -g '*.<target>.ts' \| head` |
214
- | Source-locale per-unit count matches target-locale count | `diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' \| sed 's/<source>/X/' \| sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' \| sed 's/<target>/X/' \| sort)` |
213
+ | At least one target-locale per-unit file exists | see the commands below the table |
214
+ | Source-locale per-unit count matches target-locale count | see the commands below the table |
215
215
  | Lock file tracks the target locale | `rg -n '"localeCode":\s*"<target>"' wildo-saas.lock.json` |
216
216
  | **No empty translated values** in target files (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.<target>.ts'` |
217
217
 
218
+ ```bash
219
+ # At least one target-locale per-unit file exists
220
+ rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | head
221
+
222
+ # Source-locale per-unit count matches target-locale count
223
+ diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | sed 's/<source>/X/' | sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | sed 's/<target>/X/' | sort)
224
+ ```
225
+
218
226
  The high-signal invariants are **"source per-unit count matches
219
227
  target per-unit count"** combined with **"no empty translated
220
228
  values"** — drift in either direction means the translation rerun
@@ -890,11 +890,16 @@ Run from the app root, substituting `<env>`:
890
890
  | Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
891
891
  | Every `MANAGED` declaration is MongoDB Atlas (anything else is refused) | `rg -n "BackingServiceSource\.MANAGED" infrastructure/*/wildo.infra.*.config.ts` — every hit must be `mongodb` with `provider: 'atlas'` |
892
892
  | Audit capability has an audit store in EVERY env (both sides must match) | `rg -n "COMPLIANCE_AUDIT_TRAIL" wildo.saas.config.ts` then `rg -ln "immudb:" infrastructure/*/wildo.infra.*.config.ts` |
893
- | **No secrets** in infra file (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts` |
893
+ | **No secrets** in infra file (must be empty) | see the commands below the table |
894
894
  | Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
895
895
  | Optional local companion binding is deliberate | Inspect `devCompanion` when present; omission is schema-valid. |
896
896
  | Remote runtime mode is explicit | Inspect `runtimeEnvironment`; remote Kubernetes additionally requires `remoteProvider`. `deployment` is optional. |
897
897
 
898
+ ```bash
899
+ # No secrets in infra file (must be empty)
900
+ rg -n "(password|apiKey|secret|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts
901
+ ```
902
+
898
903
  Validate the environment slug and its filename separately from the closed
899
904
  runtime/source enums. Keep secret values outside authored infrastructure.
900
905
 
@@ -448,9 +448,14 @@ Run from the app root, substituting `<env>` (typically `local`):
448
448
  | Generated `config.json` rendered for the env | `ls .wildo-saas/infrastructure/environments/<env>/generated/config/config.json` |
449
449
  | Compose file declares every authored backing service (e.g. clamav) | `rg -n "^ clamav:" .wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml` |
450
450
  | **No empty `host:container` port mapping** in the compose (must be empty) | `rg -n "^\s+- \":\"" .wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml` |
451
- | **No secret values** in the authored infra config (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.<env>.config.ts` |
451
+ | **No secret values** in the authored infra config (must be empty) | see the commands below the table |
452
452
  | `secrets.json` has not been re-written by an unintended sync | `git status --porcelain infrastructure/<env>/secrets/secrets.json` (should be empty unless you explicitly rotated) |
453
453
 
454
+ ```bash
455
+ # No secret values in the authored infra config (must be empty)
456
+ rg -n "(password|apiKey|secret|token):\s*['\"]" infrastructure/<env>/wildo.infra.<env>.config.ts
457
+ ```
458
+
454
459
  Compare the authored hosting choices, the selected environment's
455
460
  `backingServices` state and the generated workloads together. Each enabled
456
461
  self-hosted service should have its expected workload and resolved ports;
@@ -428,11 +428,19 @@ export const aiAssistantWeeklyDigestBenefit: FeatureBenefitConfig = {
428
428
  | Invariant | Command |
429
429
  |-------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
430
430
  | Every benefit file uses the typed `FeatureBenefitConfig` | `rg -n ":\s+FeatureBenefitConfig" specifications/src/market/value-proposition/` |
431
- | Every benefit declares a non-empty `deliveredBy` | `rg -n "FeatureBenefitConfig" -A 8 specifications/src/market/ \| rg "deliveredBy:\s*\["` |
431
+ | Every benefit declares a non-empty `deliveredBy` | see the commands below the table |
432
432
  | `THRESHOLD` benefits are intentional (find them all) | `rg -n "BenefitKanoCategory.THRESHOLD" specifications/src/market/` |
433
- | `REVERSE` benefits live with `ANTI_TARGET` ICPs | `rg -n "BenefitKanoCategory.REVERSE" -B 4 specifications/src/market/ \| rg "ANTI_TARGET\|icp-anti-"` |
433
+ | `REVERSE` benefits live with `ANTI_TARGET` ICPs | see the commands below the table |
434
434
  | No `LocalizedString` shapes inside benefits | `rg -n "LocalizedString" specifications/src/market/value-proposition/` |
435
435
 
436
+ ```bash
437
+ # Every benefit declares a non-empty `deliveredBy`
438
+ rg -n "FeatureBenefitConfig" -A 8 specifications/src/market/ | rg "deliveredBy:\s*\["
439
+
440
+ # `REVERSE` benefits live with `ANTI_TARGET` ICPs
441
+ rg -n "BenefitKanoCategory.REVERSE" -B 4 specifications/src/market/ | rg "ANTI_TARGET|icp-anti-"
442
+ ```
443
+
436
444
  ## Common Rationalizations
437
445
 
438
446
  | Rationalization | Reality |
@@ -507,10 +507,18 @@ export const inHouseNotionAlternative: MarketAlternativeConfig = {
507
507
  | Invariant | Command |
508
508
  |-----------|---------|
509
509
  | Every alternative file uses the typed `MarketAlternativeConfig` | `rg -n ":\s+MarketAlternativeConfig" specifications/src/market/` |
510
- | Every alternative declares both `whenChosen` and `whenWeBeat` | `rg -n "MarketAlternativeConfig" -A 12 specifications/src/market/ \| rg "whenChosen\|whenWeBeat"` |
511
- | `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` | `rg -n "STATUS_QUO\|ADJACENT_PROXY\|IN_HOUSE_BUILD" -A 6 specifications/src/market/ \| rg -v "url"` |
510
+ | Every alternative declares both `whenChosen` and `whenWeBeat` | see the commands below the table |
511
+ | `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` | see the commands below the table |
512
512
  | At least one positioning references each alternative | `rg -n "alt-" specifications/src/market/positioning.ts` |
513
513
 
514
+ ```bash
515
+ # Every alternative declares both `whenChosen` and `whenWeBeat`
516
+ rg -n "MarketAlternativeConfig" -A 12 specifications/src/market/ | rg "whenChosen|whenWeBeat"
517
+
518
+ # `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url`
519
+ rg -n "STATUS_QUO|ADJACENT_PROXY|IN_HOUSE_BUILD" -A 6 specifications/src/market/ | rg -v "url"
520
+ ```
521
+
514
522
  ## Common Rationalizations
515
523
 
516
524
  | Rationalization | Reality |
@@ -296,9 +296,17 @@ What earns its place:
296
296
  |----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
297
297
  | Snapshot uses the typed `MarketSnapshot` contract | `rg -n ":\s+MarketSnapshot" specifications/src/market/index.ts` |
298
298
  | Snapshot version is V2 (Phase-3 surface) | `rg -n "version:\s+MarketSnapshotVersion\.V2" specifications/src/market/index.ts` |
299
- | No `LocalizedString` / `MarketLocaleConfig` references inside `market/` | `rg -n "LocalizedString\|MarketLocaleConfig" specifications/src/market/` |
299
+ | No `LocalizedString` / `MarketLocaleConfig` references inside `market/` | see the commands below the table |
300
300
  | Geographies use ISO 3166-1 alpha-2 codes or recognized region tags | `rg -n "geographies:" specifications/src/market/` (visually verify each value is `[A-Z]{2}` or one of `EMEA / NAM / APAC / LATAM / MENA / GLOBAL`; the validator enforces this at boot) |
301
- | Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` | `rg -n "ICPPriority.ANTI_TARGET" -A 3 specifications/src/market/ \| rg "adoption:\s*0,\s*revenue:\s*0"` |
301
+ | Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` | see the commands below the table |
302
+
303
+ ```bash
304
+ # No `LocalizedString` / `MarketLocaleConfig` references inside `market/`
305
+ rg -n "LocalizedString|MarketLocaleConfig" specifications/src/market/
306
+
307
+ # Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }`
308
+ rg -n "ICPPriority.ANTI_TARGET" -A 3 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
309
+ ```
302
310
 
303
311
  ## Common Rationalizations
304
312
 
@@ -65,6 +65,17 @@ Locate the surfaces that may need editing using these app-relative globs:
65
65
 
66
66
  ### Step 1 — Pick the category name
67
67
 
68
+ Start from what the creator said the product IS: their one-liner, the
69
+ workflow they named and what they left out. The category keeps every
70
+ stage of that workflow and puts nothing they excluded at its centre: a
71
+ category under which a stated stage disappears is the wrong category,
72
+ not a sharper one. Better market words for the creator's own kind of
73
+ product are fine. When your name is a different kind of product from
74
+ the one the creator named, add a `notes[]` entry starting `Reframe:`
75
+ that quotes their framing, names yours and says why, so they can
76
+ overturn it. Never list the creator's own framing among
77
+ `rejectedCategories`.
78
+
68
79
  The name is the words you want a buyer to repeat back. It should
69
80
  be:
70
81
 
@@ -80,14 +91,14 @@ explaining it to a smart friend who has never seen the product.
80
91
 
81
92
  ### Step 3 — Author 2–5 `rejectedCategories`
82
93
 
83
- For each: `name`, `whyRejected`. These are the neighbouring
94
+ For each: `name`, `rationale`. These are the neighbouring
84
95
  categories buyers might think we are — and which we explicitly
85
- turn down. The `whyRejected` line is the verbatim AI / landing-copy
96
+ turn down. The `rationale` line is the verbatim AI / landing-copy
86
97
  ammunition for the comparison.
87
98
 
88
99
  ### Step 4 — Author 2–4 `differentiationDimensions`
89
100
 
90
- For each: `name`, `whatWeOptimizeFor`. These are the axes where
101
+ For each: `name`, `description`. These are the axes where
91
102
  we are deliberately better than the average competitor in our
92
103
  category. They are what AI prompts pull when asked to argue our
93
104
  position.
@@ -166,8 +177,8 @@ export type MarketCategoryConfig = z.infer<typeof MarketCategoryConfigSchema>;
166
177
 
167
178
  A complete, schema-shaped `MarketCategoryConfig` from the
168
179
  reference application — a productized category with
169
- explicit `rejectedCategories` (with `whyRejected`) and
170
- `differentiationDimensions` (with `whatWeOptimizeFor`):
180
+ explicit `rejectedCategories` (with `rationale`) and
181
+ `differentiationDimensions` (with `description`):
171
182
 
172
183
 
173
184
  ## Usage Example
@@ -251,9 +262,12 @@ quartet is what the snapshot validator audits.
251
262
  defensive, none looks unfocused)
252
263
  - [ ] At least 2 `differentiationDimensions` (no-axis category is
253
264
  unactionable)
254
- - [ ] Every `rejectedCategory` carries a `whyRejected`
265
+ - [ ] Every `rejectedCategory` carries a `rationale`
255
266
  - [ ] Every `differentiationDimension` carries a
256
- `whatWeOptimizeFor`
267
+ `description`
268
+ - [ ] The category keeps every workflow stage the creator named,
269
+ and a name of a different kind of product from theirs carries a
270
+ `Reframe:` note
257
271
 
258
272
  ### Grep invariants
259
273
 
@@ -326,9 +326,14 @@ export const communityIndieHackersChannel: MarketChannelConfig = {
326
326
  | Invariant | Command |
327
327
  |-----------|---------|
328
328
  | Every channel file uses the typed `MarketChannelConfig` | `rg -n ":\s+MarketChannelConfig" specifications/src/market/` |
329
- | Every channel declares non-empty `buyingJourneyStages` | `rg -n "MarketChannelConfig" -A 8 specifications/src/market/ \| rg "buyingJourneyStages:\s*\["` |
329
+ | Every channel declares non-empty `buyingJourneyStages` | see the commands below the table |
330
330
  | No `LocalizedString` shapes in channel files | `rg -n "LocalizedString" specifications/src/market/channels.ts` |
331
331
 
332
+ ```bash
333
+ # Every channel declares non-empty `buyingJourneyStages`
334
+ rg -n "MarketChannelConfig" -A 8 specifications/src/market/ | rg "buyingJourneyStages:\s*\["
335
+ ```
336
+
332
337
  ## Common Rationalizations
333
338
 
334
339
  | Rationalization | Reality |
@@ -651,7 +651,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
651
651
  const trimmed = value.trim();
652
652
  if (trimmed.length === 0) return undefined;
653
653
  if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
654
- throw new Error(
654
+ throw new IntrospectionInputValidationError(
655
655
  `buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
656
656
  + `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
657
657
  + `not a sentence — translation prose belongs in the LLM output, not the tag.`,
@@ -2893,9 +2893,17 @@ function detectMessageTemplatePlaceholderMismatch(
2893
2893
 
2894
2894
  | Invariant | Command |
2895
2895
  |--------------------------------------------------------------------|--------------------------------------------------------------------------|
2896
- | Behavior IDs registered in the companion model | `rg -n "market-context-for-(feature\|icp)" --type ts` |
2896
+ | Behavior IDs registered in the companion model | see the commands below the table |
2897
2897
  | Handlers wired into the builtin handler map | `rg -n "buildMarketContextBlock\(" --type ts` |
2898
- | Specifications companion exports `marketSpecification` | `rg -n "marketSpecification" --type ts \| rg "companion-exports"` |
2898
+ | Specifications companion exports `marketSpecification` | see the commands below the table |
2899
+
2900
+ ```bash
2901
+ # Behavior IDs registered in the companion model
2902
+ rg -n "market-context-for-(feature|icp)" --type ts
2903
+
2904
+ # Specifications companion exports `marketSpecification`
2905
+ rg -n "marketSpecification" --type ts | rg "companion-exports"
2906
+ ```
2899
2907
 
2900
2908
  ## Common Rationalizations
2901
2909
 
@@ -541,7 +541,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
541
541
  const trimmed = value.trim();
542
542
  if (trimmed.length === 0) return undefined;
543
543
  if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
544
- throw new Error(
544
+ throw new IntrospectionInputValidationError(
545
545
  `buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
546
546
  + `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
547
547
  + `not a sentence — translation prose belongs in the LLM output, not the tag.`,
@@ -134,10 +134,10 @@ intent picker (feature-scoped vs ICP-scoped sections). It is
134
134
  **never** consumed for placeholder substitution and is not gated by
135
135
  `requiredInputs[]`.
136
136
 
137
- If a required flag is missing, the renderer (subprocess) returns a
138
- typed `MarketPromptMissingRequiredInputError` with the exact missing
139
- input name — surfaces precisely on the CLI as `Market generation
140
- failed: …`. There is no "guess based on the snapshot"
137
+ If a required flag is missing, the request is refused as a bad
138
+ request naming the exact missing input — it surfaces precisely on
139
+ the CLI as `Market generation failed: …`. An unknown ref or template
140
+ name is refused the same way, with the refs the snapshot does hold. There is no "guess based on the snapshot"
141
141
  fallback by design (D17 / framework-mindset).
142
142
 
143
143
  ### Step 3 — Pick the output language
@@ -707,19 +707,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
707
707
  }
708
708
  }
709
709
 
710
- export class MarketPromptMissingRequiredInputError extends Error {
710
+ /*
711
+ * The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
712
+ * named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
713
+ * its name across the subprocess boundary: the controller answers 400 with the message instead of a
714
+ * sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
715
+ * `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
716
+ * the AUTHORED template, which no change to the request can fix.
717
+ */
718
+ export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
711
719
  public readonly missing: MarketMessageRequiredInput[];
712
720
  constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
713
721
  super(
714
722
  `Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
715
723
  + `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
716
724
  );
717
- this.name = 'MarketPromptMissingRequiredInputError';
718
725
  this.missing = missing;
719
726
  }
720
727
  }
721
728
 
722
- export class MarketPromptUnknownRefError extends Error {
729
+ export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
723
730
  public readonly entityKind: string;
724
731
  public readonly providedRef: string;
725
732
  constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
@@ -727,19 +734,17 @@ export class MarketPromptUnknownRefError extends Error {
727
734
  `No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
728
735
  + `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
729
736
  );
730
- this.name = 'MarketPromptUnknownRefError';
731
737
  this.entityKind = entityKind;
732
738
  this.providedRef = providedRef;
733
739
  }
734
740
  }
735
741
 
736
- export class MarketPromptTemplateNotFoundError extends Error {
742
+ export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
737
743
  constructor(templateRef: string, knownRefs: string[]) {
738
744
  super(
739
745
  `No MarketMessageTemplate found with ref \`${templateRef}\`. `
740
746
  + `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
741
747
  );
742
- this.name = 'MarketPromptTemplateNotFoundError';
743
748
  }
744
749
  }
745
750
 
@@ -1491,7 +1496,12 @@ above is derived from this shape).
1491
1496
  | The CLI command class is registered in the `Market` category | `rg -n "category:\\s*CommandCategory\\.Market" --type ts` |
1492
1497
  | The companion HTTP route the CLI POSTs to | `rg -n "/api/companion/market/generate" --type ts` |
1493
1498
  | The default timeout constant has not drifted | `rg -n "MARKET_COMPANION_DEFAULT_TIMEOUT_MS\\s*=\\s*90_000" --type ts` |
1494
- | The renderer's typed errors surface to the CLI | `rg -n "MarketPrompt(MissingRequiredInput\|UnknownRef\|UnknownPlaceholder\|TemplateNotFound)Error" --type ts` |
1499
+ | The renderer's typed errors surface to the CLI | see the commands below the table |
1500
+
1501
+ ```bash
1502
+ # The renderer's typed errors surface to the CLI
1503
+ rg -n "MarketPrompt(MissingRequiredInput|UnknownRef|UnknownPlaceholder|TemplateNotFound)Error" --type ts
1504
+ ```
1495
1505
 
1496
1506
  ## Common Rationalizations
1497
1507
 
@@ -529,19 +529,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
529
529
  }
530
530
  }
531
531
 
532
- export class MarketPromptMissingRequiredInputError extends Error {
532
+ /*
533
+ * The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
534
+ * named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
535
+ * its name across the subprocess boundary: the controller answers 400 with the message instead of a
536
+ * sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
537
+ * `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
538
+ * the AUTHORED template, which no change to the request can fix.
539
+ */
540
+ export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
533
541
  public readonly missing: MarketMessageRequiredInput[];
534
542
  constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
535
543
  super(
536
544
  `Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
537
545
  + `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
538
546
  );
539
- this.name = 'MarketPromptMissingRequiredInputError';
540
547
  this.missing = missing;
541
548
  }
542
549
  }
543
550
 
544
- export class MarketPromptUnknownRefError extends Error {
551
+ export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
545
552
  public readonly entityKind: string;
546
553
  public readonly providedRef: string;
547
554
  constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
@@ -549,19 +556,17 @@ export class MarketPromptUnknownRefError extends Error {
549
556
  `No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
550
557
  + `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
551
558
  );
552
- this.name = 'MarketPromptUnknownRefError';
553
559
  this.entityKind = entityKind;
554
560
  this.providedRef = providedRef;
555
561
  }
556
562
  }
557
563
 
558
- export class MarketPromptTemplateNotFoundError extends Error {
564
+ export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
559
565
  constructor(templateRef: string, knownRefs: string[]) {
560
566
  super(
561
567
  `No MarketMessageTemplate found with ref \`${templateRef}\`. `
562
568
  + `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
563
569
  );
564
- this.name = 'MarketPromptTemplateNotFoundError';
565
570
  }
566
571
  }
567
572