@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
@@ -65,7 +65,7 @@ must trace back to a real schema field or a real config operation.
65
65
  ### Step 2: Route field work
66
66
 
67
67
  Use `references/resource-spec-field-routing.md` to pick the right
68
- `*Spec` shape (`enumSpec`, `relationSpec`, `semanticSpec`, etc.).
68
+ `*Spec()` method for the field's shape (`stringSpec`, `enumSpec`, `foreignKeySpec`, `moneySpec`, …) and its params type.
69
69
 
70
70
  ### Step 3: Specification decorators in code
71
71
 
@@ -198,19 +198,39 @@ Run from the app root, substituting `<resource>` (e.g. `todos`) and
198
198
 
199
199
  | Invariant | Command |
200
200
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
201
- | Schema fields exist | `rg -oN '^\s+([a-zA-Z]+):\s*z\.' shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts \| sort -u` |
202
- | Spec field map entries | `rg -oN '^\s+([a-zA-Z]+):\s*schemaShape\.' specifications/src/modules/<module>/resources/<resource>.resource.specification.ts \| sort -u` |
203
- | **Schema field set ↔ spec field set agree** (must return empty) | `comm -3 <(rg -oN '^\s+\K[a-zA-Z]+(?=:\s*z\.)' shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts \| sort -u) <(rg -oN '^\s+\K[a-zA-Z]+(?=:\s*schemaShape\.)' specifications/src/modules/<module>/resources/<resource>.resource.specification.ts \| sort -u)` |
201
+ | Schema fields exist | see the commands below the table |
202
+ | Spec field map entries | see the commands below the table |
203
+ | **Every field the spec documents exists in the schema** (must return empty) | see the commands below the table |
204
204
  | Enum specs name `enumDeclaration` | `rg -n "enumDeclaration:" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts` |
205
205
  | Every spec field has `meaning` | `rg -c "meaning:" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts` |
206
- | Operations declared in config | `rg -oN "CoreResourceOperation\.[A-Z_]+" shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts \| sort -u` |
207
- | Operations described in spec | `rg -oN "CoreResourceOperation\.[A-Z_]+" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts \| sort -u` |
206
+ | Operations declared in config | see the commands below the table |
207
+ | Operations described in spec | see the commands below the table |
208
208
  | Conditional operations (compare with the next row) | `rg -c "enabledCondition" shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts` |
209
209
  | Operations stating why they can be unavailable | `rg -c "unavailableWhen" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts` |
210
210
 
211
- The third invariant (schema ↔ spec field-set parity) is the
212
- high-signal one — it catches "added a field, forgot to document it" and
213
- "renamed a field, spec still references the old name" in one shot.
211
+ ```bash
212
+ # Schema fields exist
213
+ rg -oN '^\s+([a-zA-Z]+):\s*z\.' shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts | sort -u
214
+
215
+ # Spec field map entries
216
+ rg -oN '^\s+([a-zA-Z]+):\s*schemaShape\.' specifications/src/modules/<module>/resources/<resource>.resource.specification.ts | sort -u
217
+
218
+ # Every field the spec documents exists in the schema (must return empty)
219
+ for f in $(rg -oNP 'schemaShape\.\K\w+' specifications/src/modules/<module>/resources/<resource>.resource.specification.ts | sort -u); do
220
+ rg -q "^\s+$f\s*:" shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts || echo "stale spec entry: $f"
221
+ done
222
+
223
+ # Operations declared in config
224
+ rg -oN "CoreResourceOperation\.[A-Z_]+" shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts | sort -u
225
+
226
+ # Operations described in spec
227
+ rg -oN "CoreResourceOperation\.[A-Z_]+" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts | sort -u
228
+ ```
229
+
230
+ The stale-entry invariant is the high-signal one: it catches "renamed or
231
+ removed a field, the spec still names the old one". Whether a NEW field
232
+ deserves an entry is a judgement no grep makes: document the fields that
233
+ carry meaning.
214
234
 
215
235
  ## Common Rationalizations
216
236
 
@@ -223,7 +243,7 @@ high-signal one — it catches "added a field, forgot to document it" and
223
243
 
224
244
  ## Red Flags
225
245
 
226
- - Field exists in the resource's `*.schemas.ts` (under `shared-lib/src/modules/<module>/resources/<resource>/`) but missing from the spec's `fields` map (catch with the **schema field set ↔ spec field set agree** comm invariant — must return empty).
246
+ - The spec documents a field the schema no longer has, after a rename or a removal (catch with **Every field the spec documents exists in the schema** — must return empty). The other direction is a judgement, not a grep: the spec documents the fields that carry meaning (an enum, a foreign key, an array of objects), and may leave a plain field undocumented on purpose.
227
247
  - Operation appears in spec but not in `*.resources-config.ts`, or vice versa (catch with the two **CoreResourceOperation** greps and diff them).
228
248
  - Enum field documented without `enumDeclaration` (catch with **Enum specs name `enumDeclaration`** — must return at least 1 line per enum).
229
249
  - Spec `fields` entry without a `meaning` value (catch with **Every spec field has `meaning`** — count must equal field-map size).
@@ -10,3 +10,31 @@ When editing `*.resource.specification.ts`:
10
10
  | Variant-only | Place under correct variant path; update `additionalFieldSpecs` if used |
11
11
 
12
12
  Keep `codeHandling` import paths aligned with `shared-lib` exports.
13
+
14
+ ## Which `*Spec()` method a field takes
15
+
16
+ The method follows the field's SHAPE, the same way its `*UI()` method does. Its params object is optional; when you pass
17
+ one, `meaning` (what the field represents in the domain) is required. The types are in
18
+ `framework-field-spec-params-api.md`. There is no `relationSpec` or `semanticSpec`: a foreign key takes `foreignKeySpec`,
19
+ and the field's meaning goes in the shared params every method accepts (`FieldSpecBaseParams`).
20
+
21
+ | the field is | method | params type (beyond `FieldSpecBaseParams`) |
22
+ |---|---|---|
23
+ | `z.string()` (or a string format) | `stringSpec` | `StringSpecParams` |
24
+ | a foreign key (`z.string().isForeignKey()`) | `foreignKeySpec` | `ForeignKeySpecParams` |
25
+ | a time of day (a string) | `timeSpec` | none |
26
+ | `z.number()` | `numberSpec` | `NumberSpecParams` |
27
+ | `z.boolean()` | `booleanSpec` | none |
28
+ | `z.date()` holding a date / a date and time | `dateSpec` / `dateTimeSpec` | `DateSpecParams` |
29
+ | `z.enum(...)` | `enumSpec` | `EnumSpecParams` (per-value `EnumValueSpecConfig`) |
30
+ | `z_money()` | `moneySpec` | none |
31
+ | `z_code()` | `codeSpec` | none |
32
+ | `z_file()` | `fileSpec` | none |
33
+ | `z_duration()` | `durationSpec` | none |
34
+ | `z_phone()` | `phoneSpec` | none |
35
+ | `z_bigdecimal()` | `bigDecimalSpec` | `BigDecimalSpecParams` |
36
+ | `z.array(...)` | `arraySpec` | `ArraySpecParams` |
37
+ | `z.object(...)`, `z.record(...)`, `z.map(...)` | `objectSpec` | none |
38
+
39
+ Call it on the field the way it is written: after `.optional()` or `.default(...)` works too, since the wrappers carry the
40
+ same methods.
@@ -127,7 +127,7 @@ documented `meaning`:
127
127
 
128
128
  Apply the same shape to your edits:
129
129
 
130
- - **Schema added a field?** Add a `<fieldName>: schemaShape.<fieldName>.<...>Spec({...})` entry to the resource spec's `fields` map. The schema field set and the spec field set MUST agree.
130
+ - **Schema added a field?** If it carries meaning (an enum, a foreign key, an array of objects, a value a reader must understand), add a `<fieldName>: schemaShape.<fieldName>.<...>Spec({...})` entry to the resource spec's `fields` map; a plain field may stay undocumented on purpose. **Schema removed or renamed a field?** Its spec entry must go or follow, since the spec may never name a field the schema lacks.
131
131
  - **Schema added an enum value?** Add a `[MyEnum.NEW_VALUE]: { meaning: '...' }` entry to the spec's `values` map. TypeScript will catch this if the spec is typed against the enum — verify the `enumDeclaration` is in place.
132
132
  - **Resources-config added an operation?** Reference it in the spec's operations section. The two `CoreResourceOperation.*` grep sets in `spec-resource-update` must match.
133
133
  - **Relationships file added an FK?** The corresponding relationship spec entry must follow.
@@ -157,10 +157,27 @@ Run from the app root, substituting `<resource>` and `<module>`:
157
157
 
158
158
  | Invariant | Command |
159
159
  |--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
160
- | **Schema field set ↔ spec field set agree** (must return empty) | `comm -3 <(rg -oN '^\s+\K[a-zA-Z]+(?=:\s*z\.)' shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts \| sort -u) <(rg -oN '^\s+\K[a-zA-Z]+(?=:\s*schemaShape\.)' specifications/src/modules/<module>/resources/<resource>.resource.specification.ts \| sort -u)` |
161
- | **Operations in config ↔ operations in spec agree** (must return empty) | `comm -3 <(rg -oN "CoreResourceOperation\.[A-Z_]+" shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts \| sort -u) <(rg -oN "CoreResourceOperation\.[A-Z_]+" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts \| sort -u)` |
162
- | **Composite view section refs ↔ spec section refs agree** (must return empty) | `comm -3 <(rg -oN '<Section name="\K[a-z0-9-]+' frontend/src/modules/<module>/resources/**/<Component>.tsx \| sort -u) <(rg -oN "sectionRef:\s*'\K[a-z0-9-]+" specifications/src/modules/<module>/composite-views/<view>.composite-view.specification.ts \| sort -u)` |
163
- | Resource schema commit without matching spec touch (sanity check) | `git diff --name-only HEAD~1 \| rg "(\\.schemas\\.ts\|\\.resources-config\\.ts)"` then `git diff --name-only HEAD~1 \| rg "\\.resource\\.specification\\.ts"` — both should be non-empty for the same resource |
160
+ | **Every field the spec documents exists in the schema** (must return empty) | see the commands below the table |
161
+ | **Operations in config ↔ operations in spec agree** (must return empty) | see the commands below the table |
162
+ | **Composite view section refs ↔ spec section refs agree** (must return empty) | see the commands below the table |
163
+ | Resource schema commit without matching spec touch (sanity check) | run the two commands below the table — both should be non-empty for the same resource |
164
+
165
+ ```bash
166
+ # Every field the spec documents exists in the schema (must return empty)
167
+ rg -oNP 'schemaShape\.\K\w+' specifications/src/modules/<module>/resources/<resource>.resource.specification.ts | sort -u | while read -r f; do
168
+ rg -q "^\s+$f\s*:" shared-lib/src/modules/<module>/resources/<resource>/<resource>.schemas.ts || echo "stale spec entry: $f"
169
+ done
170
+
171
+ # Operations in config ↔ operations in spec agree (must return empty)
172
+ comm -3 <(rg -oN "CoreResourceOperation\.[A-Z_]+" shared-lib/src/modules/<module>/resources/<resource>/<resource>.resources-config.ts | sort -u) <(rg -oN "CoreResourceOperation\.[A-Z_]+" specifications/src/modules/<module>/resources/<resource>.resource.specification.ts | sort -u)
173
+
174
+ # Composite view section refs ↔ spec section refs agree (must return empty)
175
+ comm -3 <(rg -P -oN '<Section name="\K[a-z0-9-]+' frontend/src/modules/<module>/resources/**/<Component>.tsx | sort -u) <(rg -P -oN "sectionRef:\s*'\K[a-z0-9-]+" specifications/src/modules/<module>/composite-views/<view>.composite-view.specification.ts | sort -u)
176
+
177
+ # Resource schema commit without matching spec touch (sanity check)
178
+ git diff --name-only HEAD~1 | rg "(\\.schemas\\.ts|\\.resources-config\\.ts)"
179
+ git diff --name-only HEAD~1 | rg "\\.resource\\.specification\\.ts"
180
+ ```
164
181
 
165
182
  The first three invariants are the high-signal ones — each catches a
166
183
  specific drift class (field, operation, section) at the surface where it
@@ -231,9 +231,14 @@ Run from the app root and substitute `<viewRef>` (the registry key, e.g.
231
231
  | The registry entry uses `satisfies ResourceCompositeViewsConfig` (typed) | `rg -n "satisfies ResourceCompositeViewsConfig" frontend/src/modules/*/resources/**/<Component>.tsx` |
232
232
  | Section names from the JSX | `rg -oN '<Section name="[a-z0-9-]+"' frontend/src/modules/*/resources/**/<Component>.tsx` |
233
233
  | Section refs from the registry | `rg -oN "sectionRefs:\\s*\\[[^\\]]+\\]" frontend/src/modules/*/resources/**/<Component>.tsx` |
234
- | **JSX section names ↔ registry sectionRefs agree** (must return empty) | `comm -3 <(rg -oNP '<Section name="\\K[a-z0-9-]+' frontend/src/modules/*/resources/**/<Component>.tsx \\| sort -u) <(rg -oNP "(?<=sectionRefs:\\s*\\[)[^\\]]+" frontend/src/modules/*/resources/**/<Component>.tsx \\| rg -oNP "'[a-z0-9-]+'" \\| tr -d "'" \\| sort -u)` (both sides derived from the same component file — no hardcoded list) |
234
+ | **JSX section names ↔ registry sectionRefs agree** (must return empty) | see the commands below the table (both sides derived from the same component file — no hardcoded list) |
235
235
  | The specification names the same composite ref | `rg -n "<viewRef>" specifications/src/modules/*/composite-views/*.composite-view.specification.ts` |
236
236
 
237
+ ```bash
238
+ # JSX section names ↔ registry sectionRefs agree (must return empty)
239
+ comm -3 <(rg -oNP '<Section name="\K[a-z0-9-]+' frontend/src/modules/*/resources/**/<Component>.tsx | sort -u) <(rg -oNP "(?<=sectionRefs:\\s*\\[)[^\\]]+" frontend/src/modules/*/resources/**/<Component>.tsx | rg -oNP "'[a-z0-9-]+'" | tr -d "'" | sort -u)
240
+ ```
241
+
237
242
  The fifth invariant is the high-signal one: if the JSX section names
238
243
  and the registry's `sectionRefs` diverge, the composite renders sections
239
244
  the spec doesn't describe (or describes sections that never render).
@@ -201,13 +201,21 @@ the operation key:
201
201
 
202
202
  | Invariant | Command |
203
203
  |--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
204
- | The component file exists and exports the component | `rg -n "export (function\\|default\\|const) <Component>" frontend/src/modules/*/resources/**/*.tsx` |
205
- | The component uses `useExecution()` (execution view) or `useResource()` (read/update host) | `rg -n "useExecution\\(\\)\\|useResource\\(" frontend/src/modules/*/resources/**/<Component>.tsx` |
204
+ | The component file exists and exports the component | see the commands below the table |
205
+ | The component uses `useExecution()` (execution view) or `useResource()` (read/update host) | see the commands below the table |
206
206
  | The `ui-behavior` references the component | `rg -n "<Component>" frontend/src/modules/*/resources/*/*.ui-behavior.tsx` |
207
207
  | The specification documents the view | `rg -n "exportName:\\s*'<Component>'" specifications/src/modules/*/resources/*.resource.specification.ts` |
208
208
  | **No anchor props** are passed at the call site (must return zero matches in `ui-behavior`) | `rg -n "<Component>\\s+resourceId=" frontend/src/modules/*/resources/*/*.ui-behavior.tsx` |
209
209
  | Component is not registered against more than one operation | `rg -c "<Component>" frontend/src/modules/*/resources/*/*.ui-behavior.tsx` |
210
210
 
211
+ ```bash
212
+ # The component file exists and exports the component
213
+ rg -n "export (function|default|const) <Component>" frontend/src/modules/*/resources/**/*.tsx
214
+
215
+ # The component uses `useExecution()` (execution view) or `useResource()` (read/update host)
216
+ rg -n "useExecution\\(\\)|useResource\\(" frontend/src/modules/*/resources/**/<Component>.tsx
217
+ ```
218
+
211
219
  The fifth grep MUST return zero matches: anchor extraction is the
212
220
  framework's job. The sixth grep should return at most `1` per file.
213
221
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: views-app-level
3
- description: Register module-level or app-level view definitions, view refs, and full custom views outside a single resource folder — exposed via the `AppCompositeViewsConfig` map and reachable from navigation, sidebar, command menu, or launcher. Use when the user says "add a hub screen for the module", "register an overview / dashboard view", "expose a cross-resource view from the launcher", "add a view ref the sidebar can target", or any module-level / app-level view registration.
3
+ description: Register module-level or app-level view definitions, view refs, and full custom views outside a single resource folder — exposed via the `AppCompositeViewsConfig` map and reachable from navigation, sidebar, command menu, or launcher. Use when the user says "add a hub screen for the module", "register an overview / dashboard view", "expose a cross-resource view from the launcher", "add a view ref the sidebar can target", "make this dashboard the home page", or any module-level / app-level view registration, including the application's home (`homeDefinitionFactory`).
4
4
  user-invocable: false
5
5
  ---
6
6
 
@@ -52,6 +52,7 @@ App-level views are routed differently than resource-owned views:
52
52
  - Registering a full custom view reachable from the app shell
53
53
  - Wiring cross-module view refs
54
54
  - Creating a module overview dashboard
55
+ - Setting the application's home (`homeDefinitionFactory`) — see `references/application-home.md`
55
56
 
56
57
  ## When NOT to Use
57
58
 
@@ -149,6 +150,7 @@ What is **not** in this block (and shouldn't be):
149
150
  ## References
150
151
 
151
152
  - `references/app-level-views-routing.md`
153
+ - `references/application-home.md` — make a view or a resource operation what a person sees at `/` (`homeDefinitionFactory`)
152
154
  - `references/framework-view-scope-and-full-custom-api.md` — source-backed `FrontendView_Definition` + `FullCustomViewDefinition`
153
155
 
154
156
  ## Verification
@@ -169,10 +171,18 @@ Run from the app root, substituting `<slug>`:
169
171
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
170
172
  | Registration map is typed | `rg -n "satisfies AppCompositeViewsConfig" frontend/src/modules/<slug>/app-level-views/index.ts` |
171
173
  | View refs are constants, not literals | `rg -n "viewRef=\"[a-z-]+\"" frontend/src/modules/<slug>/app-level-views` (must return empty — consumers should use the constant) |
172
- | Each registered view ref has a constant in `view-refs.frontend.ts` | `rg -oN "\[\K[A-Z_]+(?=\]:)" frontend/src/modules/<slug>/app-level-views/index.ts \| sort -u` cross-checked with `view-refs.frontend.ts` |
173
- | **Section names in JSX match `sectionRefs`** (must return empty per file) | `comm -3 <(rg -oN "<Section name=\"\K[a-z]+" <ViewFile>.tsx \| sort -u) <(rg -oN "sectionRefs:\s*\[\K[^\]]+" <registry>.ts \| tr ',' '\n' \| rg -oN "[a-z]+" \| sort -u)` |
174
+ | Each registered view ref has a constant in `view-refs.frontend.ts` | run the commands below the table, cross-checked with `view-refs.frontend.ts` |
175
+ | **Section names in JSX match `sectionRefs`** (must return empty per file) | see the commands below the table |
174
176
  | App-level views re-exported from the module index | `rg -n "from\s+'./app-level-views'" frontend/src/modules/<slug>/index.ts` |
175
177
 
178
+ ```bash
179
+ # Each registered view ref has a constant in `view-refs.frontend.ts`
180
+ rg -P -oN "\[\K[A-Z_]+(?=\]:)" frontend/src/modules/<slug>/app-level-views/index.ts | sort -u
181
+
182
+ # Section names in JSX match `sectionRefs` (must return empty per file)
183
+ comm -3 <(rg -P -oN "<Section name=\"\K[a-z]+" <ViewFile>.tsx | sort -u) <(rg -P -oN "sectionRefs:\s*\[\K[^\]]+" <registry>.ts | tr ',' '\n' | rg -oN "[a-z]+" | sort -u)
184
+ ```
185
+
176
186
  The first invariant (typed registration) is the high-signal one —
177
187
  without `satisfies AppCompositeViewsConfig`, the map silently
178
188
  accepts unknown keys and consumers cannot typecheck `viewRef`
@@ -0,0 +1,56 @@
1
+ # The application's home
2
+
3
+ What a person sees when they open the application root (`/`). It is set in one place:
4
+ `homeDefinitionFactory` in `frontend/src/config/global-views.config.ts`. When it returns nothing, the
5
+ application opens on the framework's default welcome page.
6
+
7
+ Read this when:
8
+
9
+ - the experience plan decides a `home` and your task's objective asks you to set it;
10
+ - the root shows the welcome page although a home was configured;
11
+ - you are choosing between showing a dashboard at the root and opening a resource's list.
12
+
13
+ ## Two forms, mutually exclusive
14
+
15
+ | Plan says | Return | Notes |
16
+ |---|---|---|
17
+ | a `VIEW` home | `{ compositeViewReference: <view ref constant> }` | Only an **application-level** composite view, a key of an `AppCompositeViewsConfig`. It renders in place, and the URL stays `/`. A composite view one resource owns (declared in its `ui-behavior`) is not registered there, so the root shows "view not found". |
18
+ | a `RESOURCE_OPERATION` home | `{ resourceOperationPath: { … } }` | The root redirects to that operation. |
19
+
20
+ ## A view home
21
+
22
+ Use the view's ref constant from `view-refs.frontend.ts`, never a string literal. A renamed view then
23
+ fails to compile instead of opening on "view not found":
24
+
25
+
26
+ ## Usage Example
27
+
28
+ ```typescript
29
+ export const homeDefinitionFactory: FrontendConfigFactory_HomeDefinition = () => ({
30
+ // Application root ("/") renders the home dashboard, an application-level composite view, IN PLACE: the URL stays
31
+ // "/", and the composite remains addressable at its own `/composite/<ref>` route. Named by its ref constant, never
32
+ // a string literal, so a renamed view fails to compile here instead of opening on "view not found".
33
+ compositeViewReference: HOME_DASHBOARD_VIEW_REF,
34
+ });
35
+ ```
36
+
37
+ ## A resource-operation home
38
+
39
+ `resourceOperationPath` is matched EXACTLY against the resource's operations, and a mismatch is
40
+ silent: the root shows the welcome page and nothing reports it. Fill every field:
41
+
42
+ | Field | Value |
43
+ |---|---|
44
+ | `resourceType` | the resource's registered type, camelCase (`workOrder`), not its kebab-case slug |
45
+ | `operationIdentifier` | the operation: `list`, `read`, or the custom verb's identifier |
46
+ | `isOperationDefault` | `true`: the operation's default variant |
47
+ | `isBulkOperation` | `false` |
48
+ | `variantKey` | that default variant's key, when it declares one; omit it otherwise |
49
+ | `parentResourcesRequirements` | `[]` for a top-level resource; the parent chain for a nested one |
50
+
51
+ ## Verify
52
+
53
+ - `rg -n "homeDefinitionFactory" -A6 frontend/src/config/global-views.config.ts`: it returns exactly one of
54
+ the two forms.
55
+ - For a view home, the ref constant is a key of an `AppCompositeViewsConfig` (`rg -n "<REF_CONSTANT>" frontend/src/modules/*/app-level-views/`).
56
+ - Open `/` in the running application: it shows the home, not the welcome title.