@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,461 @@
1
+ # Launcher items: what an entry targets, and how entries merge (source-backed)
2
+
3
+ Every sidebar item, command, quick action, hotkey and control-panel entry is a `LauncherItemRef`: an object
4
+ discriminated on `kind`, naming WHAT the entry opens. The surface adds its own display fields on top.
5
+
6
+ Read this when:
7
+
8
+ - writing a sidebar section, a command menu command or any other launcher entry, and you need the exact fields for
9
+ its target (a resource operation, a view, a settings section, a registered component);
10
+ - an entry you declared does not appear, appears twice, or replaced one you expected to keep (read "How entries
11
+ merge": a module's section beats a same-`ref` one in `app-shell.config.ts`).
12
+
13
+ ## What an entry targets
14
+
15
+ ## Import Origins
16
+
17
+ - `@wildo-ai/saas-frontend-lib`
18
+
19
+ ## Source Excerpts
20
+
21
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
22
+
23
+ ```typescript
24
+ /**
25
+ * What kind of target a launcher item points to.
26
+ *
27
+ * This is a config-time concept — the resolution layer maps each kind to a
28
+ * navigation action. Different from `NavigationContentType` which is a runtime
29
+ * concept for zone content rendering. Both have `RESOURCE_OPERATION` but serve
30
+ * different axes: `LauncherItemTargetKind` = what a launcher item targets,
31
+ * `NavigationContentType` = what renders in a navigation zone.
32
+ */
33
+ export enum LauncherItemTargetKind {
34
+ /** Navigate to a resource operation (list, create, read, etc.). */
35
+ RESOURCE_OPERATION = 'resource_operation',
36
+ /** Navigate to an application-scoped special view. */
37
+ VIEW = 'view',
38
+ /** Navigate to a resource-scoped special view. */
39
+ RESOURCE_VIEW = 'resource_view',
40
+ /** Navigate to a framework-provided page (home, security settings, etc.). */
41
+ ENGINE_PAGE = 'engine_page',
42
+ /** Render a custom registered React component. */
43
+ CUSTOM_COMPONENT = 'custom_component',
44
+ /** Open the unified Settings Hub (overlay), optionally at a specific section. */
45
+ SETTINGS_SECTION = 'settings_section',
46
+ }
47
+ ```
48
+
49
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
50
+
51
+ ```typescript
52
+ /**
53
+ * What kind of content a sidebar section renders.
54
+ *
55
+ * This is the discriminant for the `SidebarSection` discriminated union.
56
+ * Each content kind has its own set of properties and rendering behavior.
57
+ */
58
+ export enum SidebarSectionContentKind {
59
+ /** Traditional navigation item list (tree, collapsible, inline create). */
60
+ NAVIGATION_LIST = 'navigation_list',
61
+ /** Filterable resource instance list — fetches from a bound operation. */
62
+ RESOURCE_BROWSER = 'resource_browser',
63
+ /** Guidance/onboarding widget — renders a registered guidance component. */
64
+ GUIDANCE_WIDGET = 'guidance_widget',
65
+ /** Arbitrary registered React component. */
66
+ CUSTOM_COMPONENT = 'custom_component',
67
+ }
68
+
69
+ // ════════════════════════════════════════════════════════════════
70
+ // LauncherItemRef — Discriminated Union
71
+ // ════════════════════════════════════════════════════════════════
72
+
73
+ /**
74
+ * Points to a resource operation (list, create, read, etc.).
75
+ * The resolution layer resolves this via the resource registry.
76
+ */
77
+ export interface ResourceOperationItemRef {
78
+ kind: LauncherItemTargetKind.RESOURCE_OPERATION;
79
+ resourceType: string;
80
+ operation: string;
81
+ operationVariant?: string;
82
+ }
83
+
84
+ /** Points to an application-scoped special view. */
85
+ export interface ViewItemRef {
86
+ kind: LauncherItemTargetKind.VIEW;
87
+ viewRef: string;
88
+ }
89
+
90
+ /** Points to a resource-scoped special view. */
91
+ export interface ResourceViewItemRef {
92
+ kind: LauncherItemTargetKind.RESOURCE_VIEW;
93
+ resourceType: string;
94
+ viewRef: string;
95
+ }
96
+
97
+ /** Points to a framework page (home, security settings). */
98
+ export interface EnginePageItemRef {
99
+ kind: LauncherItemTargetKind.ENGINE_PAGE;
100
+ pageRef: EnginePageRef;
101
+ }
102
+
103
+ /** Points to a registered component — engine or application (see `ComponentRegistryRef`). */
104
+ export interface CustomComponentItemRef {
105
+ kind: LauncherItemTargetKind.CUSTOM_COMPONENT;
106
+ /**
107
+ * The name a component is REGISTERED under — an engine `FrontendComponentType` member, or an
108
+ * application component a domain module binds in `componentRegistrations` (#549). Resolved through
109
+ * `ComponentRegistryService` under the default preset; a ref nothing is registered under is
110
+ * reported, never rendered as something plausible.
111
+ */
112
+ componentRef: string;
113
+ }
114
+
115
+ /**
116
+ * Opens the unified Settings Hub (overlay), optionally pre-selecting a section.
117
+ * Resolves to a `/settings` / `/settings/:sectionRef` URL navigation — the hub
118
+ * is URL-driven (`useSettingsHubRouterSync` reconstructs it), so every settings
119
+ * entry point converges on one destination.
120
+ */
121
+ export interface SettingsSectionItemRef {
122
+ kind: LauncherItemTargetKind.SETTINGS_SECTION;
123
+ /** Section to pre-open; omit to open the hub's default section. */
124
+ sectionRef?: string;
125
+ }
126
+
127
+ /**
128
+ * A launcher item reference — identifies WHAT a launcher item targets.
129
+ * Discriminated on `kind`. The resolution layer dispatches on this to
130
+ * produce a `ResolvedNavigationItem`.
131
+ */
132
+ export type LauncherItemRef =
133
+ | ResourceOperationItemRef
134
+ | ViewItemRef
135
+ | ResourceViewItemRef
136
+ | EnginePageItemRef
137
+ | CustomComponentItemRef
138
+ | SettingsSectionItemRef;
139
+
140
+ /**
141
+ * Toolbar items are navigation-only launcher refs.
142
+ * Custom-component materialization belongs to other app-level surfaces and is
143
+ * intentionally excluded from the global app-level toolbar contract.
144
+ */
145
+ export type ToolbarItemRef =
146
+ | ResourceOperationItemRef
147
+ | ViewItemRef
148
+ | ResourceViewItemRef
149
+ | EnginePageItemRef;
150
+
151
+ // ════════════════════════════════════════════════════════════════
152
+ // Per-Launcher Item Types
153
+ // ════════════════════════════════════════════════════════════════
154
+
155
+ /**
156
+ * A sidebar navigation item — extends `LauncherItemRef` with sidebar-specific
157
+ * display properties. Supports all launcher target kinds as targets.
158
+ */
159
+ export type SidebarItem = LauncherItemRef & {
160
+ displayPolicy?: SidebarItemDisplayPolicy;
161
+ /**
162
+ * Typed reference to a registered `NotificationBadgeDefinition` — its badge KEY,
163
+ * `<scope>:<identifier>`, built by `buildNotificationBadgeKey` /
164
+ * `notificationBadgeIdentityKey` from `@wildo-ai/saas-models`.
165
+ *
166
+ * The key, not the bare `identifier`: a definition is `(scope, identifier)`, so an identifier
167
+ * alone names a definition only while no second scope declares the same one. Matching on it made
168
+ * the second definition unreachable and gave it the first's count.
169
+ *
170
+ * The resolved definition supplies the display mode / tone / pulse, and the live count comes from
171
+ * `useNotificationBadges`, which indexes by the same key. Reported by `verify-launcher-content`
172
+ * when it resolves to nothing.
173
+ */
174
+ notificationBadgeRef?: string;
175
+ children?: SidebarItem[];
176
+ runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
177
+ };
178
+
179
+ /** A command menu entry. */
180
+ export type CommandMenuCommand = LauncherItemRef & {
181
+ category?: string;
182
+ shortcut?: string;
183
+ /**
184
+ * OPTIONAL extra literal match terms, appended to the localized keyword set
185
+ * the palette already resolves for this command. These literals are NOT
186
+ * translated — reserve them for genuinely app-specific jargon that no
187
+ * localized label or operation-verb synonym covers (e.g. an internal codename
188
+ * like `"boards"` for a Todo-Lists list command).
189
+ *
190
+ * You do NOT need to author generic action verbs here: for a
191
+ * `RESOURCE_OPERATION` command the framework already folds in the LOCALIZED
192
+ * operation-verb synonyms (`components.APPLICATION_LEVEL_COMMAND_MENU.keywords*`,
193
+ * generated + translated by the labelling pipeline) keyed off the command's
194
+ * core operation semantic, and the record/command noun is covered by the
195
+ * command's already-localized label. So a French user finds "Create Todo" by
196
+ * typing "nouveau"/"créer" without any literal being authored here.
197
+ */
198
+ searchKeywords?: string[];
199
+ displayPolicy?: CommandMenuDisplayPolicy;
200
+ runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
201
+ };
202
+ ```
203
+
204
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
205
+
206
+ ```typescript
207
+ /**
208
+ * Base properties shared by all sidebar section types.
209
+ * `ref` is `string`-typed — no framework enum, apps define their own refs.
210
+ */
211
+ export interface SidebarSectionBase {
212
+ contentKind: SidebarSectionContentKind;
213
+ /** Section reference — app-defined, used for i18n and configuration matching. */
214
+ ref: string;
215
+ /** Display label (i18n ref). If omitted, section renders without a header. */
216
+ label?: string;
217
+ /** Icon for the section header. */
218
+ icon?: string;
219
+ /** Whether the section header (label + icon) is rendered. Defaults to `true`. */
220
+ showLabel?: boolean;
221
+ /** Whether the section can be collapsed by the user. */
222
+ collapsible?: boolean;
223
+ /** Whether the section starts collapsed. */
224
+ defaultCollapsed?: boolean;
225
+ /**
226
+ * Mode refs this section is visible in. If omitted, visible in all modes.
227
+ * String-based — validated at startup against `appModes[].ref`.
228
+ * The section is hidden while the active mode is not one of them.
229
+ */
230
+ visibleInModes?: string[];
231
+ /**
232
+ * Function-based visibility condition for complex scope-dependent logic.
233
+ * Called with the current scope; the section is hidden when it returns false.
234
+ */
235
+ scopeCondition?: ScopeConditionFn;
236
+ /** Declarative availability evaluated by the app-shell layer: required capabilities and the roles shown to (`visibleToRoles`). */
237
+ runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
238
+ }
239
+
240
+ /**
241
+ * Traditional navigation item list section.
242
+ * Supports tree hierarchy, inline create, drag-reorder (via behavior).
243
+ */
244
+ export interface SidebarSection_NavigationList extends SidebarSectionBase {
245
+ contentKind: SidebarSectionContentKind.NAVIGATION_LIST;
246
+ children: SidebarItem[];
247
+ behavior?: SidebarSectionBehavior;
248
+ /**
249
+ * Marks this section as the sidebar's PRIMARY navigation group — the app's
250
+ * top-level destinations (the "Home group"). Primary sections render at the
251
+ * top of the sidebar with no section header and never collapsible. When
252
+ * `SIDEBAR.homeDisplayMode` is `NAVIGATION_ITEM` (the default) the framework's
253
+ * Home row heads that same group, giving the Linear/Notion "Inbox / My Issues
254
+ * right under Home" shape; the other home modes surface home elsewhere and
255
+ * leave this group to the app's own destinations.
256
+ *
257
+ * This is a PLACEMENT/CHROME role, deliberately distinct from
258
+ * `SidebarSectionBehavior` (which describes where a section's ITEMS come
259
+ * from). Section ordering is engine policy and ignores declaration order for
260
+ * the special roles: primary section(s) first, then non-empty
261
+ * `SidebarSectionBehavior.FAVORITES` section(s), then the remaining sections
262
+ * in declared order. Modules can therefore contribute a primary section
263
+ * without the app config having to interleave it manually.
264
+ */
265
+ isPrimary?: boolean;
266
+ inlineCreate?: SidebarSectionInlineCreate;
267
+ inlineCreateResourceType?: string;
268
+ /** Field that receives the user's input during inline creation. Defaults to `'title'`. */
269
+ inlineCreateField?: string;
270
+ nested?: boolean;
271
+ maxNestingDepth?: number;
272
+ }
273
+
274
+ /**
275
+ * Filterable resource instance list section.
276
+ * Fetches data from a bound operation and displays resource instances.
277
+ */
278
+ export interface SidebarSection_ResourceBrowser extends SidebarSectionBase {
279
+ contentKind: SidebarSectionContentKind.RESOURCE_BROWSER;
280
+ /** Resource type to browse. */
281
+ resourceType: string;
282
+ /** Override the default LIST operation (optional — defaults to LIST). */
283
+ operation?: string;
284
+ /** Operation variant for filtered views. */
285
+ operationVariant?: string;
286
+ /**
287
+ * Operation used when the user clicks a listed instance.
288
+ * Defaults to READ when available; otherwise falls back to the bound operation.
289
+ */
290
+ navigateOperation?: string;
291
+ /** Variant for the click/navigation operation. */
292
+ navigateOperationVariant?: string;
293
+ /**
294
+ * Client-side filter predicate applied after fetching.
295
+ * Enables display restrictions (e.g., "starred only").
296
+ */
297
+ instanceFilter?: (instance: Record<string, unknown>) => boolean;
298
+ /**
299
+ * Custom click handler for resource instances.
300
+ * Default: navigate to instance via `NavigationUtils.resolveResourceUrl()`.
301
+ */
302
+ onInstanceClick?: (context: ResourceBrowserClickContext) => void;
303
+ }
304
+
305
+ /** Guidance/onboarding widget section. */
306
+ export interface SidebarSection_GuidanceWidget extends SidebarSectionBase {
307
+ contentKind: SidebarSectionContentKind.GUIDANCE_WIDGET;
308
+ /** Reference to a registered guidance component. */
309
+ guidanceRef: string;
310
+ }
311
+
312
+ /** Arbitrary custom component section. */
313
+ export interface SidebarSection_CustomComponent extends SidebarSectionBase {
314
+ contentKind: SidebarSectionContentKind.CUSTOM_COMPONENT;
315
+ /** The name a component is registered under — engine or application (see `ComponentRegistryRef`, #549). */
316
+ componentRef: string;
317
+ }
318
+
319
+ /**
320
+ * Discriminated union of all sidebar section types.
321
+ * Narrow on `contentKind` to access type-specific properties.
322
+ */
323
+ export type SidebarSection =
324
+ | SidebarSection_NavigationList
325
+ | SidebarSection_ResourceBrowser
326
+ | SidebarSection_GuidanceWidget
327
+ | SidebarSection_CustomComponent;
328
+ ```
329
+
330
+ - Pick the `kind` from what the entry OPENS, never from where it sits: a sidebar row and a command that open the same
331
+ list carry the same `{ kind: RESOURCE_OPERATION, resourceType, operation }`.
332
+ - `SETTINGS_SECTION` opens the Settings Hub; its `sectionRef` is the section, and omitting it opens the hub's default
333
+ section.
334
+ - `CUSTOM_COMPONENT` names a registered component by its `componentRef`; one nothing registered is reported, not
335
+ rendered.
336
+ - The toolbar takes only navigation targets (`ToolbarItemRef`): no `CUSTOM_COMPONENT`, no `SETTINGS_SECTION`.
337
+ - A sidebar SECTION is discriminated on `contentKind`. Only a `NAVIGATION_LIST` section holds `children` (launcher
338
+ items); a `RESOURCE_BROWSER` lists records of a `resourceType`, a `GUIDANCE_WIDGET` names a `guidanceRef`, and a
339
+ `CUSTOM_COMPONENT` section names a `componentRef`.
340
+
341
+ ## How entries merge
342
+
343
+ ## Import Origins
344
+
345
+ - `@wildo-ai/saas-frontend-lib`
346
+
347
+ ## Source Excerpts
348
+
349
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
350
+
351
+ ```typescript
352
+ *
353
+ * Merges two `contentSections` arrays.
354
+ *
355
+ * **Merge key:** `ref`
356
+ * **Semantics:** App sections **replace** base sections on collision
357
+ * (full section replace, no item-level deep merge). Base-only sections
358
+ * preserved.
359
+ *
360
+ * @param base - Base sections array (e.g., from a kit preset)
361
+ * @param override - App-specific sections array (wins on collision)
362
+ * @returns Merged sections array
363
+ */
364
+ export function mergeSidebarSections(
365
+ base: SidebarSection[] | undefined,
366
+ override: SidebarSection[] | undefined,
367
+ ): SidebarSection[] {
368
+ if (!base && !override) return [];
369
+ if (!base) return warnOnDuplicateLauncherTargets([...(override ?? [])]);
370
+ if (!override) return warnOnDuplicateLauncherTargets([...(base ?? [])]);
371
+
372
+ return warnOnDuplicateLauncherTargets(mergeByKey(base, override, s => s.ref));
373
+ }
374
+ ```
375
+
376
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
377
+
378
+ ```typescript
379
+ /**
380
+ * Stable key for deduping launcher rows (sidebar children, command list, etc.).
381
+ *
382
+ * Two entries with the same key open the same target, so they are one entry. Every `kind` has its own key, and a
383
+ * settings command keys on its `sectionRef`, so commands opening different settings sections never collapse.
384
+ *
385
+ * Exhaustive over `LauncherItemTargetKind` on purpose. It used to end in a `default` that answered `'unknown'`, and
386
+ * `SETTINGS_SECTION` fell into it: every settings command then shared one key, so an application's `members` command
387
+ * collapsed into the engine's billing command and disappeared. A kind added to the enum is now a compile error here.
388
+ */
389
+ export function launcherItemRefKey(item: LauncherItemRef): string {
390
+ switch (item.kind) {
391
+ case LauncherItemTargetKind.RESOURCE_OPERATION:
392
+ return `resource_operation:${item.resourceType}:${item.operation}:${item.operationVariant ?? 'default'}`;
393
+ case LauncherItemTargetKind.VIEW:
394
+ return `${item.kind}:${item.viewRef}`;
395
+ case LauncherItemTargetKind.RESOURCE_VIEW:
396
+ return `${item.kind}:${item.resourceType}:${item.viewRef}`;
397
+ case LauncherItemTargetKind.ENGINE_PAGE:
398
+ return `engine_page:${item.pageRef}`;
399
+ case LauncherItemTargetKind.CUSTOM_COMPONENT:
400
+ return `custom_component:${item.componentRef}`;
401
+ case LauncherItemTargetKind.SETTINGS_SECTION:
402
+ // No section opens the hub at its landing; that is one destination, so it is one key.
403
+ return `settings_section:${item.sectionRef ?? ''}`;
404
+ default: {
405
+ const unhandled: never = item;
406
+ throw new Error(`launcherItemRefKey: unhandled launcher item kind ${JSON.stringify(unhandled)}`);
407
+ }
408
+ }
409
+ }
410
+
411
+ /**
412
+ * Appends sidebar navigation children to the `NAVIGATION_LIST` section with `sectionRef`.
413
+ * Skips items whose `launcherItemRefKey` already exists under that section (idempotent).
414
+ */
415
+ export function appendNavChildrenToSidebarSection(
416
+ sections: SidebarSection[] | undefined,
417
+ sectionRef: string,
418
+ items: SidebarItem[],
419
+ ): SidebarSection[] {
420
+ if (!sections?.length) return sections ?? [];
421
+ if (!items.length) return [...sections];
422
+
423
+ return sections.map(section => {
424
+ if (section.ref !== sectionRef || section.contentKind !== SidebarSectionContentKind.NAVIGATION_LIST) {
425
+ return section;
426
+ }
427
+ const nav = section as Extract<SidebarSection, { contentKind: SidebarSectionContentKind.NAVIGATION_LIST }>;
428
+ const existing = new Set(nav.children.map(launcherItemRefKey));
429
+ const toAdd = items.filter(i => !existing.has(launcherItemRefKey(i)));
430
+ if (toAdd.length === 0) return section;
431
+ return { ...nav, children: [...nav.children, ...toAdd] };
432
+ });
433
+ }
434
+
435
+ /**
436
+ * Merges command menu command arrays by `launcherItemRefKey` — override wins on collision.
437
+ */
438
+ export function mergeCommandMenuCommandLists(
439
+ base: CommandMenuCommand[] | undefined,
440
+ extra: CommandMenuCommand[] | undefined,
441
+ ): CommandMenuCommand[] {
442
+ if (!base?.length) return [...(extra ?? [])];
443
+ if (!extra?.length) return [...base];
444
+ return mergeByKey(base, extra, launcherItemRefKey);
445
+ }
446
+ ```
447
+
448
+ Three sources feed the shell, merged in this order: `app-shell.config.ts` (its `contentSections` and `commands`, often
449
+ taken from a preset kit), then each domain module's `sidebarSections` and `commandMenuItems` in registration order, then
450
+ each module's `sidebarSectionItems`. The later source wins.
451
+
452
+ - **A sidebar section is merged by its `ref`, whole.** A module's `sidebarSections` entry with the same `ref` as a
453
+ section in `app-shell.config.ts` (or in an earlier module) REPLACES that section, items included, and takes its
454
+ place in the order. Sections with a new `ref` are added after.
455
+ - **To add rows to an existing section, do not re-declare it.** Use the module's `sidebarSectionItems:
456
+ [{ sectionRef, items }]`. Those items go to the end of that section and skip any target its top-level children
457
+ already show, so an entry declared in both places appears once. A `sectionRef` that names no section, or names a
458
+ section that is not a navigation list, drops the items with no warning.
459
+ - **A command is merged by its TARGET** (`launcherItemRefKey`). A module's `commandMenuItems` entry that opens the
460
+ same target as an entry in `app-shell.config.ts`'s `commands` replaces it in place, and a later module's replaces an
461
+ earlier one's. A settings command keys on its `sectionRef`, so commands opening different sections stay distinct.
@@ -0,0 +1,80 @@
1
+ # Launcher visibility (source-backed)
2
+
3
+ `runtimeAvailability` decides whether a sidebar section, a sidebar item, a command, a quick action or another launcher
4
+ entry appears at all.
5
+
6
+ Read this when:
7
+
8
+ - a sidebar section or entry is for one audience only (office staff, field staff, administrators);
9
+ - an entry should appear only when a capability is on (billing, single sign-on);
10
+ - the placement plan gives a group or a decision `visibleToRoles`.
11
+
12
+ ## Import Origins
13
+
14
+ - `@wildo-ai/saas-frontend-lib`
15
+
16
+ ## Source Excerpts
17
+
18
+ ### Origin Package: `@wildo-ai/saas-frontend-lib`
19
+
20
+ ```typescript
21
+ *
22
+ * When a launcher entry appears at all: `runtimeAvailability` on a sidebar section, a sidebar item, a command-menu
23
+ * command, a quick action, a toolbar, control-panel or menubar item, or a hotkey. An entry that fails it is removed, not
24
+ * shown disabled.
25
+ *
26
+ * - `requiredCapabilities`: runtime capabilities that must all be on (`billingEnabled`, `ssoEnabled`…).
27
+ * - `visibleToRoles`: the roles the entry is shown to (an office-only section a field technician does not see).
28
+ *
29
+ * Import from `@wildo-ai/saas-frontend-lib`.
30
+ *
31
+ * @example
32
+ * // frontend/src/config/app-shell.config.ts: a sidebar section only office staff see
33
+ * { contentKind: SidebarSectionContentKind.NAVIGATION_LIST, ref: 'office',
34
+ * runtimeAvailability: { visibleToRoles: ['office-manager', CORE_ORG_ROLES.ORG_ADMIN] },
35
+ * children: [{ kind: LauncherItemTargetKind.VIEW, viewRef: 'invoices' }] }
36
+ *
37
+ * This is intentionally distinct from `requiredFeatures` on resolved
38
+ * view/resource targets:
39
+ * - `runtimeAvailability` decides whether a launcher declaration should survive
40
+ * the app-shell filtering pass at all
41
+ * - `requiredFeatures` stays the canonical plan/subscription gating mechanism
42
+ * once an item has already survived launcher filtering and is being resolved
43
+ */
44
+ export interface LauncherRuntimeAvailabilityConfig {
45
+ requiredCapabilities?: string[];
46
+ /**
47
+ * The roles this item is shown to: an office-only "Invoices" section a field technician does not see. Visible when the
48
+ * viewer holds ANY listed role, at the application or in the current organization, or a CORE role that inherits one
49
+ * (an organization owner sees an `ORG_MEMBER` item).
50
+ *
51
+ * A custom role counts only as itself: the browser receives the application's role keys, not how its custom roles
52
+ * inherit, so list every role that should see the item. Never wider: an unknown role does not reveal an item, because
53
+ * the declaration names exactly who it is for.
54
+ *
55
+ * Navigation, not authorization. Hiding an entry stops nobody from opening its target; the target operation's `roles`
56
+ * are what the backend enforces. An entry opening a resource operation the viewer's roles cannot perform is already
57
+ * hidden by resolution, so `visibleToRoles` is for narrowing further: an operation open to every member that only
58
+ * office staff need in their navigation.
59
+ *
60
+ * Omitted or empty: shown to every role.
61
+ */
62
+ visibleToRoles?: string[];
63
+ }
64
+
65
+ export const LauncherRuntimeAvailabilityConfigSchema = z.object({
66
+ requiredCapabilities: z.array(z.string()).optional(),
67
+ visibleToRoles: z.array(z.string().min(1)).optional(),
68
+ });
69
+ ```
70
+
71
+ - `visibleToRoles` shows the entry to a viewer holding ANY listed role, at the application or in the current
72
+ organization. A core role also counts when it inherits a listed one: an organization owner sees an `ORG_MEMBER` entry.
73
+ - A custom role counts only as itself, because the browser does not receive how custom roles inherit. List every role
74
+ that should see the entry. Omitted means everyone.
75
+ - An entry that opens a resource operation the viewer's roles cannot perform is hidden for you: the launcher reads the
76
+ operation's `roles` with the same rule as the action bar. A sidebar resource-browser section the viewer cannot list
77
+ (its bound operation) is dropped the same way. So restrict the OPERATION when people must not use it, and
78
+ use `visibleToRoles` only to narrow navigation further (an operation every member may use that only office staff
79
+ need in their sidebar).
80
+ - Hiding is not access control. A hidden page is still one URL away, and the operation's `roles` decide on the server.
@@ -419,14 +419,36 @@ Run from the app root:
419
419
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
420
420
  | Default config is spread at each nested layer | `rg -n "\.\.\.DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG\." frontend/src/config/design-system.config.ts` |
421
421
  | Theme is declared | `rg -n "theme:\s+" frontend/src/config/design-system.config.ts` |
422
- | Every background token has a foreground pair (sample) | `rg -oN "'\K[a-z-]+(?=':)" frontend/src/config/design-system.config.ts \| rg -v "foreground" \| sort -u` |
422
+ | Every background token has a foreground pair (sample) | see the commands below the table |
423
423
  | **No string-literal hex / rgb in the config** (must return empty) | `rg -n "'#[0-9a-fA-F]{3,8}'" frontend/src/config/design-system.config.ts` |
424
424
  | **The head theme bootstrap is present and render-blocking** | `rg -n 'blocking="render"' frontend/index.html` (must match; without it the loading and error screens paint light) |
425
- | **No duplicated first-paint palette literals** (must return empty) | `rg -n "oklch\\(|#[0-9a-fA-F]{3,8}|rgba?\\(" frontend/index.html frontend/src/browser-bootstrap` |
426
- | Generated CSS exists | `ls -1 frontend/src/styles/design-tokens.css 2>/dev/null \|\| ls -1 frontend/dist/design-tokens.css 2>/dev/null` |
427
- | Material profiles and aggregate policy stay theme-owned | `rg -n "materials:|materialRuntimePolicy:|priority:" frontend/src/config/design-system.config.ts` |
428
- | Candidate app-wide SHELL main opt-in lines for manual inspection | `rg -n "SurfaceVariant\\.SHELL|landmarkRole:\\s*'main'" frontend/src/config/design-system.config.ts` |
429
- | Candidate local SHELL wrappers and opt-outs for manual comparison | `rg -n "variant=\\{SurfaceVariant\\.SHELL\\}|landmarkRole:\\s*'none'" frontend/src` |
425
+ | **No duplicated first-paint palette literals** (must return empty) | see the commands below the table |
426
+ | Generated CSS exists | see the commands below the table |
427
+ | Material profiles and aggregate policy stay theme-owned | see the commands below the table |
428
+ | Candidate app-wide SHELL main opt-in lines for manual inspection | see the commands below the table |
429
+ | Candidate local SHELL wrappers and opt-outs for manual comparison | see the commands below the table |
430
+
431
+ ```bash
432
+ # No duplicated first-paint palette literals (must return empty)
433
+ rg -n "oklch\\(|#[0-9a-fA-F]{3,8}|rgba?\\(" frontend/index.html frontend/src/browser-bootstrap
434
+
435
+ # Generated CSS exists
436
+ ls -1 frontend/src/styles/design-tokens.css 2>/dev/null || ls -1 frontend/dist/design-tokens.css 2>/dev/null
437
+
438
+ # Material profiles and aggregate policy stay theme-owned
439
+ rg -n "materials:|materialRuntimePolicy:|priority:" frontend/src/config/design-system.config.ts
440
+
441
+ # Candidate app-wide SHELL main opt-in lines for manual inspection
442
+ rg -n "SurfaceVariant\\.SHELL|landmarkRole:\\s*'main'" frontend/src/config/design-system.config.ts
443
+
444
+ # Candidate local SHELL wrappers and opt-outs for manual comparison
445
+ rg -n "variant=\\{SurfaceVariant\\.SHELL\\}|landmarkRole:\\s*'none'" frontend/src
446
+ ```
447
+
448
+ ```bash
449
+ # Every background token has a foreground pair (sample)
450
+ rg -P -oN "'\K[a-z-]+(?=':)" frontend/src/config/design-system.config.ts | rg -v "foreground" | sort -u
451
+ ```
430
452
 
431
453
  The first invariant (defaults spread at every layer) is the high-signal
432
454
  one — without it, the app freezes on the framework version that authored
@@ -377,10 +377,21 @@ Run from the app root:
377
377
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
378
378
  | Transitions use the typed enum | `rg -n "NavigationTransition\." frontend/src/config/navigation.config.ts` |
379
379
  | Operations use the typed enum | `rg -n "CoreResourceOperation\." frontend/src/config/navigation.config.ts` |
380
- | **No string-literal transitions** (must return empty) | `rg -n ":\s+'(OVERLAY\|PUSH\|REPLACE)'" frontend/src/config/navigation.config.ts` |
381
- | Each zone declares `contentModel` + `transitions` | `rg -n "(contentModel\|transitions):" frontend/src/config/navigation.config.ts` |
380
+ | **No string-literal transitions** (must return empty) | see the commands below the table |
381
+ | Each zone declares `contentModel` + `transitions` | see the commands below the table |
382
382
  | Viewport override uses the typed key | `rg -n "\[ViewportBreakpoint\." frontend/src/config/navigation.config.ts` |
383
- | **A SPLIT override has a pane** — if the first returns rows, the second must too | `rg -n "NavigationTransition.SPLIT" --glob '*.ui-behavior.tsx' frontend/src` then `rg -n "secondary:\|companion:" frontend/src/config/navigation.config.ts` |
383
+ | **A SPLIT override has a pane** — if the first returns rows, the second must too | `rg -n "NavigationTransition.SPLIT" --glob '*.ui-behavior.tsx' frontend/src`, then the command below the table |
384
+
385
+ ```bash
386
+ # No string-literal transitions (must return empty)
387
+ rg -n ":\s+'(OVERLAY|PUSH|REPLACE)'" frontend/src/config/navigation.config.ts
388
+
389
+ # Each zone declares `contentModel` + `transitions`
390
+ rg -n "(contentModel|transitions):" frontend/src/config/navigation.config.ts
391
+
392
+ # A SPLIT override has a pane — if the first returns rows, the second must too
393
+ rg -n "secondary:|companion:" frontend/src/config/navigation.config.ts
394
+ ```
384
395
 
385
396
  The third invariant (no string-literal transitions) is the high-signal
386
397
  one — string literals bypass typecheck, silently misroute, and break