@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
@@ -592,10 +592,18 @@ export const enterpriseProcurementAntiTargetIcp = marketIcpConfig({
592
592
  | Invariant | Command |
593
593
  |--------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
594
594
  | Every ICP file uses the typed `MarketICPConfig` contract | `rg -n ":\s+MarketICPConfig" specifications/src/market/customer-profile/icps.ts` |
595
- | Anti-target ICPs zero out `purposeMix` | `rg -n "ANTI_TARGET" -A 5 specifications/src/market/ \| rg "adoption:\s*0,\s*revenue:\s*0"` |
596
- | Geographies look like ISO codes | `rg -n "geographies:\s*\[" -A 1 specifications/src/market/ \| rg -v "'[A-Z]{2,5}'"` |
595
+ | Anti-target ICPs zero out `purposeMix` | see the commands below the table |
596
+ | Geographies look like ISO codes | see the commands below the table |
597
597
  | No localized-string shapes inside ICPs | `rg -n "LocalizedString" specifications/src/market/customer-profile/` |
598
598
 
599
+ ```bash
600
+ # Anti-target ICPs zero out `purposeMix`
601
+ rg -n "ANTI_TARGET" -A 5 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
602
+
603
+ # Geographies look like ISO codes
604
+ rg -n "geographies:\s*\[" -A 1 specifications/src/market/ | rg -v "'[A-Z]{2,5}'"
605
+ ```
606
+
599
607
  ## Common Rationalizations
600
608
 
601
609
  | Rationalization | Reality |
@@ -320,7 +320,12 @@ export const contextSwitchingCostPain: MarketPainConfig = {
320
320
  | Pains use the typed `MarketPainConfig` contract | `rg -n ":\s+MarketPainConfig" specifications/src/market/value-proposition/pains.ts` |
321
321
  | Gains use the typed `MarketGainConfig` contract | `rg -n ":\s+MarketGainConfig" specifications/src/market/value-proposition/gains.ts` |
322
322
  | Jobs use the typed `MarketJobConfig` contract | `rg -n ":\s+MarketJobConfig" specifications/src/market/customer-profile/jobs.ts` |
323
- | `weight` values stay within 1–10 | `rg -n "weight:\s*([0-9]+)" specifications/src/market/ \| rg -v "weight:\s*([1-9]\|10)\b"` |
323
+ | `weight` values stay within 1–10 | see the commands below the table |
324
+
325
+ ```bash
326
+ # `weight` values stay within 1–10
327
+ rg -n "weight:\s*([0-9]+)" specifications/src/market/ | rg -v "weight:\s*([1-9]|10)\b"
328
+ ```
324
329
 
325
330
  ## Common Rationalizations
326
331
 
@@ -367,7 +367,12 @@ export const applicationMessageTemplates: MarketMessageTemplateConfig[] = [
367
367
  |--------------------------------------------------------------------|--------------------------------------------------------------------------|
368
368
  | Templates declared on the snapshot | `rg -n "messageTemplates:" --type ts` |
369
369
  | `requiredInputs` references the enum (not raw strings) | `rg -n "MarketMessageRequiredInput\." --type ts` |
370
- | `{{output_language}}` is present in every template body | `rg -n "promptTemplate:" -A 5 --type ts \| rg "output_language"` |
370
+ | `{{output_language}}` is present in every template body | see the commands below the table |
371
+
372
+ ```bash
373
+ # `{{output_language}}` is present in every template body
374
+ rg -n "promptTemplate:" -A 5 --type ts | rg "output_language"
375
+ ```
371
376
 
372
377
  ## Common Rationalizations
373
378
 
@@ -379,9 +379,20 @@ export const indieMakerSelfPersona: MarketPersonaConfig = {
379
379
  | Invariant | Command |
380
380
  |--------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
381
381
  | Every persona file uses the typed `MarketPersonaConfig` contract | `rg -n ":\s+MarketPersonaConfig" specifications/src/market/customer-profile/personas.ts` |
382
- | `BUYING_GROUP_MEMBER` carries a `dmuRole` | `rg -n "BUYING_GROUP_MEMBER" -A 4 specifications/src/market/ \| rg "dmuRole"` |
383
- | `INDIVIDUAL_SELF` / `INDIVIDUAL_INFLUENCER` does NOT carry a `dmuRole` | `rg -n "INDIVIDUAL_SELF\|INDIVIDUAL_INFLUENCER" -A 4 specifications/src/market/ \| rg -v "dmuRole"` |
384
- | Every persona declares `belongsToIcpRefs` | `rg -n "MarketPersonaConfig" -A 6 specifications/src/market/ \| rg "belongsToIcpRefs"` |
382
+ | `BUYING_GROUP_MEMBER` carries a `dmuRole` | see the commands below the table |
383
+ | `INDIVIDUAL_SELF` / `INDIVIDUAL_INFLUENCER` does NOT carry a `dmuRole` | see the commands below the table |
384
+ | Every persona declares `belongsToIcpRefs` | see the commands below the table |
385
+
386
+ ```bash
387
+ # `BUYING_GROUP_MEMBER` carries a `dmuRole`
388
+ rg -n "BUYING_GROUP_MEMBER" -A 4 specifications/src/market/ | rg "dmuRole"
389
+
390
+ # `INDIVIDUAL_SELF` / `INDIVIDUAL_INFLUENCER` does NOT carry a `dmuRole`
391
+ rg -n "INDIVIDUAL_SELF|INDIVIDUAL_INFLUENCER" -A 4 specifications/src/market/ | rg -v "dmuRole"
392
+
393
+ # Every persona declares `belongsToIcpRefs`
394
+ rg -n "MarketPersonaConfig" -A 6 specifications/src/market/ | rg "belongsToIcpRefs"
395
+ ```
385
396
 
386
397
  ## Common Rationalizations
387
398
 
@@ -350,9 +350,14 @@ export const indieMakerPositioning: MarketPositioningConfig = {
350
350
  |-------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
351
351
  | Every positioning file uses the typed `MarketPositioningConfig` | `rg -n ":\s+MarketPositioningConfig" specifications/src/market/positioning.ts` |
352
352
  | Each positioning ties to a CORE / EXPANSION ICP | `rg -n "icpRef:" specifications/src/market/positioning.ts` |
353
- | Each pillar is backed by at least one benefit | `rg -n "valuePillars" -A 6 specifications/src/market/positioning.ts \| rg "backedByBenefitRefs"` |
353
+ | Each pillar is backed by at least one benefit | see the commands below the table |
354
354
  | No `LocalizedString` shapes inside positioning | `rg -n "LocalizedString" specifications/src/market/positioning.ts` |
355
355
 
356
+ ```bash
357
+ # Each pillar is backed by at least one benefit
358
+ rg -n "valuePillars" -A 6 specifications/src/market/positioning.ts | rg "backedByBenefitRefs"
359
+ ```
360
+
356
361
  ## Common Rationalizations
357
362
 
358
363
  | Rationalization | Reality |
@@ -624,10 +624,18 @@ fires WARN:
624
624
  |-----------|---------|
625
625
  | Every proof file uses the typed `MarketProofConfig` | `rg -n ":\s+MarketProofConfig" specifications/src/market/` |
626
626
  | Every objection file uses the typed `MarketObjectionConfig` | `rg -n ":\s+MarketObjectionConfig" specifications/src/market/` |
627
- | Every proof declares non-empty support edges | `rg -n "MarketProofConfig" -A 12 specifications/src/market/ \| rg "supportsBenefitRefs\|supportsIcpRefs"` |
628
- | Every objection declares a `response` | `rg -n "MarketObjectionConfig" -A 10 specifications/src/market/ \| rg "response:"` |
627
+ | Every proof declares non-empty support edges | see the commands below the table |
628
+ | Every objection declares a `response` | see the commands below the table |
629
629
  | No `LocalizedString` shapes in proof / objection files | `rg -n "LocalizedString" specifications/src/market/proofs.ts specifications/src/market/objections.ts` |
630
630
 
631
+ ```bash
632
+ # Every proof declares non-empty support edges
633
+ rg -n "MarketProofConfig" -A 12 specifications/src/market/ | rg "supportsBenefitRefs|supportsIcpRefs"
634
+
635
+ # Every objection declares a `response`
636
+ rg -n "MarketObjectionConfig" -A 10 specifications/src/market/ | rg "response:"
637
+ ```
638
+
631
639
  ## Common Rationalizations
632
640
 
633
641
  | Rationalization | Reality |
@@ -578,10 +578,15 @@ itself:
578
578
  | Invariant | Command |
579
579
  |------------------------------------------------------------------------|------------------------------------------------------------------------------|
580
580
  | Consumers import the typed scorer entrypoint | `rg -n "computeFeatureFitScoreForICP" --type ts` |
581
- | No call site re-derives the algorithm by hand | `rg -n "(theoreticalMax\|raw \* 100\|painSeverity)" --type ts \| rg -v "market-scoring"` |
581
+ | No call site re-derives the algorithm by hand | see the commands below the table |
582
582
  | Anti-target opt-in is intentional (rare; flag uses) | `rg -n "excludeAntiTargets:\s*false" --type ts` |
583
583
  | Runtime no-go check uses the dedicated helper | `rg -n "isBenefitAvailable\(" --type ts` |
584
584
 
585
+ ```bash
586
+ # No call site re-derives the algorithm by hand
587
+ rg -n "(theoreticalMax|raw \* 100|painSeverity)" --type ts | rg -v "market-scoring"
588
+ ```
589
+
585
590
  ## Common Rationalizations
586
591
 
587
592
  | Rationalization | Reality |
@@ -1663,9 +1663,20 @@ objection threatens:
1663
1663
  | Invariant | Command |
1664
1664
  |--------------------------------------------------------------------|--------------------------------------------------------------------------|
1665
1665
  | Bootstrap calls the validator | `rg -n "validateMarketSnapshot\(" --type ts` |
1666
- | Bootstrap throws BusinessConfigError on ERROR | `rg -n "validateMarketSnapshot" -A 6 --type ts \| rg "BusinessConfigError"` |
1667
- | Bootstrap passes cross-family ref sets | `rg -n "validateMarketSnapshot" -A 4 --type ts \| rg "availableFeatureRefs\|availableProductRefs"` |
1668
- | No consumer reaches into `result.issues` to mutate | `rg -n "result\.issues\." --type ts \| rg -v "filter\|forEach\|map\|find"` |
1666
+ | Bootstrap throws BusinessConfigError on ERROR | see the commands below the table |
1667
+ | Bootstrap passes cross-family ref sets | see the commands below the table |
1668
+ | No consumer reaches into `result.issues` to mutate | see the commands below the table |
1669
+
1670
+ ```bash
1671
+ # Bootstrap throws BusinessConfigError on ERROR
1672
+ rg -n "validateMarketSnapshot" -A 6 --type ts | rg "BusinessConfigError"
1673
+
1674
+ # Bootstrap passes cross-family ref sets
1675
+ rg -n "validateMarketSnapshot" -A 4 --type ts | rg "availableFeatureRefs|availableProductRefs"
1676
+
1677
+ # No consumer reaches into `result.issues` to mutate
1678
+ rg -n "result\.issues\." --type ts | rg -v "filter|forEach|map|find"
1679
+ ```
1669
1680
 
1670
1681
  ## Common Rationalizations
1671
1682
 
@@ -233,9 +233,14 @@ export const trustedEngineerVoice: ToneOfVoiceConfig = {
233
233
  | Invariant | Command |
234
234
  |----------------------------------------------------------------------|----------------------------------------------------------------------------------------|
235
235
  | Voices use the typed `ToneOfVoiceConfig` contract | `rg -n ":\s+ToneOfVoiceConfig" specifications/src/market/tones-of-voice.ts` |
236
- | Axis values stay in -2..+2 | `rg -n "formality:\|seriousness:\|respectfulness:\|enthusiasm:" specifications/src/market/ \| rg -v ":\s*-?[012]\b"` |
236
+ | Axis values stay in -2..+2 | see the commands below the table |
237
237
  | At least 2 examples per voice | `rg -n "examples:\s*\[" -A 3 specifications/src/market/` |
238
238
 
239
+ ```bash
240
+ # Axis values stay in -2..+2
241
+ rg -n "formality:|seriousness:|respectfulness:|enthusiasm:" specifications/src/market/ | rg -v ":\s*-?[012]\b"
242
+ ```
243
+
239
244
  ## Common Rationalizations
240
245
 
241
246
  | Rationalization | Reality |
@@ -620,6 +620,32 @@ export type ResourceConfiguration_BuilderParameters<
620
620
  * Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
621
621
  * one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
622
622
  * a person — and if so, whose session an erasure ends.
623
+ *
624
+ * And it REQUIRES three operations, for every `mode` including `RETAIN_ONLY`: `READ`, `LIST` and
625
+ * `UPDATE_MANY`, in `coreOperations` (and so in its core-operation type parameter), each with an
626
+ * `API_CALL` or `INTERNAL_CALL` DEFAULT variant. `UPDATE_MANY` is normally `INTERNAL_CALL`: route-less
627
+ * and still service-resolvable; `REPOSITORY_ONLY` is route-less too but resolves through a different
628
+ * transport, so the factory refuses it when the backend starts (`… to be SERVICE-RESOLVABLE`). Retaining a row still writes to it (the
629
+ * erasure marks `retentionStatus` in place through `updateManyAsSystem`). Do not author
630
+ * `systemAccessPolicy.updateMany` or `seeRetained` as `FORBIDDEN`; both are derived to `ALLOWED`.
631
+ *
632
+ * Checked twice. At COMPILE time the factory refuses a `retentionPolicy` whose core-operation TYPE lacks READ, LIST
633
+ * or UPDATE_MANY (`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations` in the error). When the BACKEND
634
+ * STARTS it checks what a type cannot see: the `coreOperations` array itself, and that each operation has a
635
+ * service-resolvable default variant. `wildo config check-resources` asks the start-time half without starting it.
636
+ *
637
+ * @example
638
+ * ```ts
639
+ * retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY },
640
+ * dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
641
+ * coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.UPDATE_MANY],
642
+ * operationsConfiguration: {
643
+ * // …READ / LIST as API_CALL defaults…
644
+ * [CoreResourceOperation.UPDATE_MANY]: {
645
+ * variants: [{ variantType: ResourceOperationVariantType.INTERNAL_CALL, isDefault: true, roles: [], riskLevel: ResourceOperationRiskLevel.CRITICAL }],
646
+ * },
647
+ * },
648
+ * ```
623
649
  */
624
650
  retentionPolicy?: ResourceRetentionPolicy,
625
651
 
@@ -286,6 +286,12 @@ What earns its place:
286
286
  (`compositeViewSpecifications`, `tasksManagerExecutionViewSpecifications`,
287
287
  `tasksManagerChartViewSpecifications`) keep authorship close to the
288
288
  module; the companion-exports file only **wires** them.
289
+ - In an application scaffolded by `wildo init`, that wiring is done for you: the file declares four
290
+ anchors (`applicationModuleResourceSpecifications`, `applicationModuleChartViewSpecifications`,
291
+ `applicationModuleExecutionViewSpecifications`, `applicationModuleCompositeViewSpecifications`),
292
+ and the `add-module` scenario spreads each new module's maps into them. A module created by hand
293
+ must be spread into the same four anchors, or its specifications exist and the companion reads
294
+ none of them.
289
295
  - Annotate the authored snapshot with `BusinessSemanticsSnapshotDeclaration`, never with
290
296
  `BusinessSemanticsSnapshot`. The declaration type leaves every defaulted list optional, so a
291
297
  list the framework adds later (as `systemsOfRecord` was) does not break your specifications
@@ -324,7 +330,7 @@ Run from the app root:
324
330
  |--------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
325
331
  | Companion exports use the typed contract | `rg -n "SpecificationsCompanionExports<" specifications/src/companion-exports.ts` |
326
332
  | Every spec family declared in the generic has an assignment | `rg -c ":\s+" specifications/src/companion-exports.ts` then count `<...>` parameters by hand (TS is the source of truth — must build) |
327
- | No deep imports across package boundaries | `rg -n "from\s+'@wildo-ai/[^']+/(?!companion\b)[^']+/[^']+/" specifications/src/companion-exports.ts` (must return empty) |
333
+ | No deep imports across package boundaries | `rg -P -n "from\s+'@wildo-ai/[^']+/(?!companion\b)[^']+/[^']+/" specifications/src/companion-exports.ts` (must return empty) |
328
334
  | Framework-default maps spread before app maps in merges | `rg -n "\.\.\.framework[A-Z][A-Za-z]+Specifications" specifications/src/companion-exports.ts` |
329
335
 
330
336
  The first invariant (typed contract) is the high-signal one — the
@@ -40,6 +40,7 @@ matching FK field produces silent JOIN failures at query time.
40
40
  | Module relationships file | `shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` |
41
41
  | Resource schemas (FK side) | `shared-lib/src/modules/<slug>/resources/<resource>/<resource>.schemas.ts` |
42
42
  | Resource configs | `shared-lib/src/modules/<slug>/resources/<resource>/<resource>.config.ts` |
43
+ | Holder UI behavior | `frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
43
44
  | Resource specs | `specifications/src/modules/<slug>/resources/<resource>.resource.specification.ts` |
44
45
  | FK identifier map | `shared-lib/src/modules/<slug>/resources/<slug>.resources-types.ts` |
45
46
 
@@ -92,7 +93,8 @@ one `[dependent-lifecycle-unclassified]` warning. Declare one of four on the edg
92
93
  the rows hold nothing worth keeping once their owner is gone (the common case). The
93
94
  child must declare `DELETE` or `DELETE_MANY`; an `INTERNAL_CALL` variant is enough and
94
95
  adds no route.
95
- - `strategy: IMPERSONALIZE_AND_RETAIN` — the child declares a `retentionPolicy`, so its
96
+ - `strategy: IMPERSONALIZE_AND_RETAIN` — the child declares a `retentionPolicy` (with the
97
+ `dataSubjectPolicy` the factory requires beside it), so its
96
98
  rows survive frozen and hidden rather than destroyed. Only a retention-governed child
97
99
  can take it; boot refuses it on any other.
98
100
  - `onParentDelete: { enabled: true, strategy: REFUSE_WHILE_CHILDREN_EXIST }` — the
@@ -107,12 +109,29 @@ one `[dependent-lifecycle-unclassified]` warning. Declare one of four on the edg
107
109
  Mind `maxDepth` where edges meet: a deeper budget carries a child's own DELETE cascade
108
110
  further down, and can hard-delete rows another edge of the same parent retains.
109
111
 
110
- ### Step 3: Specifications
112
+ ### Step 3: Show the reference on the holder's pages
113
+
114
+ A relationship that only reaches the form is invisible to the person reading a record: a job
115
+ page that does not say whose job it is. In the FK holder's
116
+ `frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx`:
117
+
118
+ - `edit()` — a `<FormField name="<fkField>" />`, so the reference can be chosen.
119
+ - `display()` — a `<DisplayField name="<fkField>" />`, so the read page names the related record.
120
+ - `summary()` — the same, when the related record is part of how a row is recognised (a job's
121
+ customer, an invoice's job).
122
+ - How it renders — `.foreignKeyUI({ display: { mode } })` on the schema field (`LABEL`, or
123
+ `SUMMARY` for a card); see `resource-ui-behavior` → `references/framework-foreign-key-ui-api.md`.
124
+ - If the UI task left an interim row label waiting for this relationship (a date, an id), replace
125
+ it now with the related record's label (`forwardedLabel`, `resource-config-wiring`).
126
+
127
+ Leave a reference off a read surface only on purpose, and say why in a comment beside the layout.
128
+
129
+ ### Step 4: Specifications
111
130
 
112
131
  Update specs for both resources (`spec-resource-update`) so the
113
132
  companion sees the relationship.
114
133
 
115
- ### Step 4: Verify
134
+ ### Step 5: Verify
116
135
 
117
136
  `references/cross-resource-fk-checklist.md` — runs the full
118
137
  schema/config/spec parity check.
@@ -547,8 +566,14 @@ Run from the app root:
547
566
  | `foreignKeyField` literal always paired with explicit declaration | `rg -n "foreignKeyField:" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` |
548
567
  | Discriminators use typed field references (no string field names) | `rg -n "discriminatorField:\s+'[a-z]" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` (must return empty) |
549
568
  | `nature` is declared on every relationship | `rg -n "nature:\s+RelationshipNature\." shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` |
550
- | Composition relationships with `onParentDelete` declare `maxDepth` | `rg -nB 1 "onParentDelete" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts \| rg "maxDepth"` |
569
+ | Composition relationships with `onParentDelete` declare `maxDepth` | see the commands below the table |
551
570
  | Every `COMPOSITION` edge declares its parent-delete lifecycle | `rg -c "^[^/*]*nature: RelationshipNature\.COMPOSITION" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts` equals `rg -c "^[^/*]*onParentDelete: \{" …` on the same file (the `^[^/*]*` prefix skips comment lines, which quote declarations when explaining them) |
571
+ | The holder shows the reference on its read page | `rg -c 'DisplayField name="<fkField>"' frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` is at least 1, or a comment beside the layout says why it is left off |
572
+
573
+ ```bash
574
+ # Composition relationships with `onParentDelete` declare `maxDepth`
575
+ rg -nB 1 "onParentDelete" shared-lib/src/modules/<slug>/resources/<slug>.relationships.ts | rg "maxDepth"
576
+ ```
552
577
 
553
578
  The third invariant (typed discriminator) is the high-signal one —
554
579
  string field names bypass typecheck and break silently when fields
@@ -563,6 +588,7 @@ are renamed.
563
588
  | "I'll model self-referencing M:N as direct peers" | The framework fail-closes peer M:N expansion. Use an explicit junction resource (TODOS_RELATIONSHIPS pattern) so source/target identity stays unambiguous. |
564
589
  | "Conditional logic belongs in app code" | The `discriminator` mechanism is the framework's first-class conditional. Authoring it in app code bypasses the spec layer and breaks introspection. |
565
590
  | "A COMPOSITION edge cascades by default" | It does not: `onParentDelete.enabled` defaults to `false`. Declaring COMPOSITION says who owns the rows; only `onParentDelete` says what happens to them, and a tenant purge relies on it for every owned resource. |
591
+ | "The UI task already did the ui-behavior" | It ran before this relationship existed, so the foreign key was not there to show. Adding it to the read page is this task's work (Step 3). |
566
592
  | "Cascade is fine without `maxDepth`" | `maxDepth` bounds the cascade. Without it, a deep tree can produce expensive deletes (or wedge the framework on cyclic graphs). |
567
593
  | "The cycle report is wrong — my two columns are different, no row can loop" | Both halves are true and the refusal still stands. The detector is type-level because the traversals it protects are type-level. Declare `allowCycle` on every edge and say in a comment why the loop is unreachable at row level. |
568
594
  | "I'll set `allowCycle` on the new edge only" | The check is all-or-nothing: the error names each edge still missing the flag, including ones you did not write. |
@@ -578,6 +604,7 @@ are renamed.
578
604
  - `onParentDelete: { enabled: true }` without `maxDepth` (catch with the **Composition relationships with `onParentDelete` declare `maxDepth`** grep).
579
605
  - A `COMPOSITION` edge with no `onParentDelete` at all (catch with the **Every `COMPOSITION` edge declares its parent-delete lifecycle** counts, and with the boot line `[dependent-lifecycle-unclassified]`).
580
606
  - An odd number of `allowCycle: true` edges, or one with no explicit `foreignKeyField` (catch with the two **allowCycle** greps above — a cycle needs the flag on every edge, and the edges are told apart only by their columns).
607
+ - A foreign key that appears in the holder's `edit()` and not in its `display()`: the read page never says which record it belongs to (catch with the **holder shows the reference on its read page** grep).
581
608
  - A second edge to a parent type declared `COMPOSITION` or `REQUIRES_CONTEXT` when it is only an actor reference (catch by reading both edges together — the resource's scope must come from exactly one of them).
582
609
 
583
610
  ## Related Skills
@@ -107,8 +107,10 @@ Rules:
107
107
 
108
108
  ### Step 3: Bind at backend startup
109
109
 
110
- Add the module binding with `definePdfTemplateBindings(...)` and merge it
111
- through the backend domain-module assembly.
110
+ Add the module binding with `definePdfTemplateBindings(...)` and contribute it
111
+ through the module's `pdfTemplateBindings` slot on its `BackendDomainModule`
112
+ (`backend-api/src/modules/<slug>/index.ts`), which the backend domain-module
113
+ assembly merges.
112
114
 
113
115
  The binding is keyed by resource type and field name. The shared schema
114
116
  stores only a stable `templateId`; the binding stores the live imported
@@ -178,11 +178,22 @@ export const GOOGLE_PLACES_ADDRESS_LOOKUP_ADAPTER: ProviderAddressLookupAdapter
178
178
 
179
179
  | Invariant | Command |
180
180
  |---|---|
181
- | Both operations opened | `rg -n "address_suggest\|address_retrieve" wildo.saas.config.ts` (both present) |
182
- | No Google key in the frontend | `rg -n "AIza\|GOOGLE_PLACES_API_KEY" frontend/src` (must be empty) |
183
- | No direct vendor call | `rg -n "places.googleapis.com\|maps.googleapis.com" frontend/src` (must be empty) |
181
+ | Both operations opened | see the commands below the table (both present) |
182
+ | No Google key in the frontend | see the commands below the table (must be empty) |
183
+ | No direct vendor call | see the commands below the table (must be empty) |
184
184
  | No stored place id | `rg -in "placeId" shared-lib/src` (must be empty) |
185
185
 
186
+ ```bash
187
+ # Both operations opened
188
+ rg -n "address_suggest|address_retrieve" wildo.saas.config.ts
189
+
190
+ # No Google key in the frontend
191
+ rg -n "AIza|GOOGLE_PLACES_API_KEY" frontend/src
192
+
193
+ # No direct vendor call
194
+ rg -n "places.googleapis.com|maps.googleapis.com" frontend/src
195
+ ```
196
+
186
197
  ## Common Rationalizations
187
198
 
188
199
  | Rationalization | Reality |
@@ -338,9 +338,14 @@ Run from the app root, substituting `<ref>`:
338
338
  | No hand-written `frontendEntry` literal | `rg -n "frontendEntry: \{" frontend/src/provider-contributions.ts` (must be empty) |
339
339
  | Scope entry present | `rg -n "<ref>" wildo.saas.config.ts` |
340
340
  | Consent purposes use the vocabulary, not strings | `rg -n "consentPurposes: \['" frontend/src/engine/providers/` (must be empty) |
341
- | No secret-looking key in publicConfig | `rg -in "secret\|apikey\|token" frontend/src/engine/providers/<ref>.frontend-app.module.ts` (must be empty) |
341
+ | No secret-looking key in publicConfig | see the commands below the table (must be empty) |
342
342
  | Module declares its public-config keys | `rg -n "publicConfigSchema: defineFrontendPublicConfigSchema" frontend/src/engine/providers/<ref>.frontend-app.module.ts` |
343
343
 
344
+ ```bash
345
+ # No secret-looking key in publicConfig
346
+ rg -in "secret|apikey|token" frontend/src/engine/providers/<ref>.frontend-app.module.ts
347
+ ```
348
+
344
349
  ## Common Rationalizations
345
350
 
346
351
  | Rationalization | Reality |
@@ -208,12 +208,23 @@ export async function listMyAsanaProjects(
208
208
 
209
209
  | Invariant | Command |
210
210
  |---|---|
211
- | Clients are built from `forExecution` | `rg -n "Client\(" backend-api/src \| rg -v forExecution` (review each hit) |
212
- | No credential handled in application code | `rg -in "accessToken\|apiKey\|botToken" backend-api/src frontend/src` (must be empty) |
211
+ | Clients are built from `forExecution` | see the commands below the table (review each hit) |
212
+ | No credential handled in application code | see the commands below the table (must be empty) |
213
213
  | Browser calls name declared operations | `rg -n "executeProviderOperation" frontend/src` then check each against `rg -n "browserOperations" wildo.saas.config.ts` |
214
214
  | No component calls a vendor directly | `rg -n "fetch\(['\"]https://" frontend/src` (must be empty) |
215
215
  | A scope refusal grows the connection | `rg -n "SCOPE_NOT_GRANTED" frontend/src` then check each handler passes `addScopes` to `startProviderConnection` |
216
- | No hand-rolled vendor throttle | `rg -n "setTimeout\|sleep\|RATE_BUDGET" backend-api/src` (review each hit near a provider call) |
216
+ | No hand-rolled vendor throttle | see the commands below the table (review each hit near a provider call) |
217
+
218
+ ```bash
219
+ # Clients are built from `forExecution`
220
+ rg -n "Client\(" backend-api/src | rg -v forExecution
221
+
222
+ # No credential handled in application code
223
+ rg -in "accessToken|apiKey|botToken" backend-api/src frontend/src
224
+
225
+ # No hand-rolled vendor throttle
226
+ rg -n "setTimeout|sleep|RATE_BUDGET" backend-api/src
227
+ ```
217
228
 
218
229
  ## Common Rationalizations
219
230
 
@@ -651,8 +651,16 @@ Run from the app root, substituting `<slug>` and `<resource>`:
651
651
  | `rateLimit?` declared on variant builder | `rg -n "rateLimit:\s*\{" shared-lib/src/modules/<slug>/resources/<resource>/` |
652
652
  | `checkPolicy` invoked from controller | `rg -n "rateLimitService\.checkPolicy\(" backend-api/src/modules/<slug>/controllers/` |
653
653
  | **No `req.ip` direct reference** (must be empty in custom controllers; use `getClientIpFromRequest`) | `rg -n "\\breq\\.ip\\b" backend-api/src/modules/<slug>/controllers/` |
654
- | **No `if (ipAddress)` guard** around per-IP `checkPolicy` (must be empty outside K-3 sites) | `rg -nB1 "checkPolicy\\([^)]*\\.by-ip" backend-api/src/modules/<slug>/controllers/ \| rg "if \\(ipAddress\\)"` |
655
- | F-15 `:by-<dim>` suffix when an endpoint declares multiple buckets | `rg -n "checkPolicy\\(" backend-api/src/modules/<slug>/controllers/<file>.controller.ts \| rg ":by-"` |
654
+ | **No `if (ipAddress)` guard** around per-IP `checkPolicy` (must be empty outside K-3 sites) | see the commands below the table |
655
+ | F-15 `:by-<dim>` suffix when an endpoint declares multiple buckets | see the commands below the table |
656
+
657
+ ```bash
658
+ # No `if (ipAddress)` guard around per-IP `checkPolicy` (must be empty outside K-3 sites)
659
+ rg -nB1 "checkPolicy\\([^)]*\\.by-ip" backend-api/src/modules/<slug>/controllers/ | rg "if \\(ipAddress\\)"
660
+
661
+ # F-15 `:by-<dim>` suffix when an endpoint declares multiple buckets
662
+ rg -n "checkPolicy\\(" backend-api/src/modules/<slug>/controllers/<file>.controller.ts | rg ":by-"
663
+ ```
656
664
 
657
665
  The high-signal invariant is **"no `req.ip` direct reference"**
658
666
  combined with **"no `if (ipAddress)` guard around per-IP
@@ -243,8 +243,16 @@ substitute the new field name (`<field>`) and resource path:
243
243
  | FK field has corresponding `isForeignKey()` decorator | `rg -n "<field>.*isForeignKey\(\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
244
244
  | FK field has a registered relationship edge (the decorator marks, it does not resolve) | `rg -n "foreignKeyField: '<field>'" shared-lib/src/modules/*/resources/*.relationships.ts` |
245
245
  | Enum declared by the schema is re-exported from the module barrel (declaring is not publishing) | `rg -n "<EnumName>" shared-lib/src/modules/*/resources/index.ts` |
246
- | Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable | `rg -n "<field>" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \| rg "exclude(From|FromCreate\|FromUpdate)"` |
247
- | Label keys exist in the primary locale | `rg -n "\"<resource>\.<field>\.(label\|<enumValue>)\"" frontend/src/i18n` |
246
+ | Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable | see the commands below the table |
247
+ | Label keys exist in the primary locale | see the commands below the table |
248
+
249
+ ```bash
250
+ # Field absent from `excludeFromCreate` / `excludeFromUpdate` if user-editable
251
+ rg -n "<field>" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts | rg "exclude(From|FromCreate|FromUpdate)"
252
+
253
+ # Label keys exist in the primary locale
254
+ rg -n "\"<resource>\.<field>\.(label|<enumValue>)\"" frontend/src/i18n
255
+ ```
248
256
 
249
257
  If a user-facing field passes none of the UI / spec / label greps, the
250
258
  work stopped after the schema and the task is **not done**.
@@ -405,6 +405,8 @@ export enum CollectionFilterPanelVisibility {
405
405
  HIDDEN = 'hidden',
406
406
  }
407
407
 
408
+ /**
409
+ */
408
410
  /**
409
411
  * A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.
410
412
  *
@@ -417,39 +419,63 @@ export enum CollectionFilterPanelVisibility {
417
419
  * Resolution is in the VIEWER's timezone, which is the only one that makes "today" true for the
418
420
  * person reading the screen. The backend compares instants, so the boundaries travel as absolute
419
421
  * times and nothing downstream has to know a timezone was involved.
422
+ *
423
+ * Every window is whole local days and ends at the LAST instant of its last day, one millisecond before the next local
424
+ * midnight. The date-range filter's end bound is inclusive, and a date-only value (a due date picked in a calendar) is
425
+ * stored at the local midnight of the day it names, so ending at the next midnight would also match the day after.
420
426
  */
421
427
  export enum CollectionFilterPresetRelativeRange {
422
- /** Midnight this morning until midnight tonight, local. */
428
+ /** All of today, local: midnight this morning to the end of the day. */
423
429
  TODAY = 'today',
424
- /** The same window, one day back. */
430
+ /** All of yesterday, local. */
425
431
  YESTERDAY = 'yesterday',
426
432
  /** The last seven days INCLUDING today — the rolling week, not the last seven whole days. */
427
433
  LAST_7_DAYS = 'last_7_days',
428
434
  /** The last thirty days including today. */
429
435
  LAST_30_DAYS = 'last_30_days',
430
- /** The first of this calendar month until now. */
436
+ /** The first of this calendar month through the end of today. */
431
437
  THIS_MONTH = 'this_month',
432
- /** The first of this calendar year until now. */
438
+ /** The first of this calendar year through the end of today. */
433
439
  THIS_YEAR = 'this_year',
440
+ /**
441
+ * Everything BEFORE today, local: what an "overdue" list shows on a due-date field. Ends at the last instant of
442
+ * yesterday, so a date-only value due TODAY is due, not overdue. A deadline with a time earlier today is in TODAY, not
443
+ * here: the window is whole days, like every other member, so the pill reads the same all day.
444
+ */
445
+ BEFORE_TODAY = 'before_today',
446
+ /** Today and the six days after it, local: "due this week" from today. */
447
+ NEXT_7_DAYS = 'next_7_days',
448
+ /** Today and the twenty-nine days after it, local. */
449
+ NEXT_30_DAYS = 'next_30_days',
434
450
  }
435
451
 
436
452
  /**
437
- * What a preset ASSIGNS to one filter field.
453
+ * A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
454
+ * viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
455
+ * reading the list, whoever that is.
438
456
  *
439
- * Two members, and the split is between a value that is FIXED at authoring time and one that can
440
- * only be known when the pill is clicked. A literal covers every enum value, id, number and flag —
441
- * which is the whole of "filter to HIGH priority". A relative range covers the temporal case, whose
442
- * defining property is that an authored answer would be wrong by tomorrow.
457
+ * A preset naming one is unavailable to a viewer the value cannot be resolved for (no signed-in user): the pill is
458
+ * disabled rather than applied without the field, which would show a different list under the same name.
459
+ */
460
+ export enum CollectionFilterPresetContextValue {
461
+ /** The signed-in user's id, for a reference field such as an assignee or owner. */
462
+ CURRENT_USER = 'current_user',
463
+ }
464
+
465
+ /**
466
+ * What a preset ASSIGNS to one filter field.
443
467
  *
444
- * A NUMERIC BOUND is the third, and it is the one that needed the rest of the stack before it could
445
- * mean anything: the framework's collection filters carried a date range and scalars and no numeric
446
- * range, so a preset could have declared "cost below 500" and nothing between here and the database
447
- * would have honoured it. It is expressible now because `Resources_Filter_NumberRangeSchema`, the
448
- * controller's fail-closed value guard and the cross-adapter normalizer all learned the `{ min, max }`
449
- * vocabulary — a preset assigning one is writing the same value the filter panel's own two inputs do.
468
+ * Four kinds, split by WHEN the value is known:
450
469
  *
451
- * Both bounds optional, for the same reason the schema has them optional: "under 500" is a range
452
- * with no floor, and that is the commonest threshold anyone asks for.
470
+ * - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
471
+ * which is the whole of "filter to HIGH priority";
472
+ * - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
473
+ * answer would be wrong by tomorrow;
474
+ * - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
475
+ * backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
476
+ * commonest threshold anyone asks for;
477
+ * - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
478
+ * when the pill is clicked, so the same authored preset shows each viewer their own rows.
453
479
  */
454
480
  export const CollectionFilterPresetValueSchema = z.union([
455
481
  z.string(),
@@ -457,6 +483,7 @@ export const CollectionFilterPresetValueSchema = z.union([
457
483
  z.boolean(),
458
484
  z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
459
485
  z.object({ min: z.number().optional(), max: z.number().optional() }),
486
+ z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
460
487
  ]);
461
488
  export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
462
489
 
@@ -1020,6 +1047,8 @@ export const ResourceOperationFrontendConfigSchema = z.object({
1020
1047
  * presetFilters: [
1021
1048
  * { ref: 'urgent', filters: { priority: 'high' } },
1022
1049
  * { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
1050
+ * { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
1051
+ * { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
1023
1052
  * ]
1024
1053
  */
1025
1054
  presetFilters: z.array(CollectionFilterPresetSchema).optional(),
@@ -188,7 +188,7 @@ module barrel (`index.ts`) if siblings re-export theirs.
188
188
 
189
189
  ## Verification
190
190
 
191
- - [ ] **The personal-data question is ANSWERED** — a `retentionPolicy` (`RETAIN_ONLY` says, checkably, that it holds none of its own), a `dataSubjectPolicy`, a `systemAccessPolicy.exportSubject`, or `.dataCategories()` on the fields that hold it. This is the cheapest moment; later means editing a shipped schema, and until it is answered the application's privacy notice can say nothing about this resource.
191
+ - [ ] **The personal-data question is ANSWERED** — a `retentionPolicy` TOGETHER WITH its `dataSubjectPolicy` (the factory refuses either one alone; `RETAIN_ONLY` + `NO_PRINCIPAL` says, checkably, that it holds no personal data of its own), a `systemAccessPolicy.exportSubject`, or `.dataCategories()` on the fields that hold it. The decision table in `resource-config-wiring`'s `references/framework-personal-data-declaration-api.md` routes the four cases. This is the cheapest moment; later means editing a shipped schema, and until it is answered the application's privacy notice can say nothing about this resource.
192
192
  - [ ] New value added to the module's `<Module>_ResourceType` enum
193
193
  - [ ] A user-facing resource's `ui-behavior` declares `views: [...]` (ADDRESSABLE per operation with a page) and `getFrontendResourceLabel` — without them it has no page and no Create button
194
194
  - [ ] `<resource>.schemas.ts` exists and calls `initZodDecorators(z)` before schema definitions
@@ -211,7 +211,19 @@ Run from the app root and substitute `<resource>` (folder name) and
211
211
  | The new schema file initializes Zod decorators | `rg -n "initZodDecorators" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts` |
212
212
  | The new factory is exported from the resource's own config file | `rg -n "<resource>_ResourceConfiguration_InitializationFactory" shared-lib/src/modules/*/resources/<resource>/<resource>.resources-config.ts` |
213
213
  | **The module factory map includes the new resource** (this MUST return 1 match) | `rg -n "<RESOURCE>\\]:\\s*<resource>_ResourceConfiguration" shared-lib/src/modules/*/resources/*.resource-configs.ts` |
214
- | Every FK on the new schema has a relationship declaration | `comm -23 <(rg -oN "isForeignKey\\(\\)" shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \\| sort -u) <(rg -oN "<RESOURCE>" shared-lib/src/modules/*/resources/*.relationships.ts \\| sort -u)` |
214
+ | Every FK on the new schema has a relationship declaration (must print nothing) | see the commands below the table |
215
+
216
+ ```bash
217
+ # Every FK on the new schema has a relationship declaration — prints each `.isForeignKey()` field no relationship names
218
+ rg -oNP '^\s*\K\w+(?=\s*:.*\.isForeignKey\(\))' shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts | sort -u | while read -r f; do
219
+ rg -q "foreignKeyField:\s*.$f." shared-lib/src/modules/*/resources/*.relationships.ts || echo "no relationship names: $f"
220
+ done
221
+ ```
222
+
223
+ The frontend enforces the same rule: in development its resource registry refuses to start
224
+ (`frontend_fk_resolution_failed`, naming the field) when an `.isForeignKey()` field resolves to no resource. One gap
225
+ in both: a field named after a resource's own identifier (`organizationId`, `userId`) resolves by NAME even with no
226
+ relationship edge, so declare `foreignKeyField` on every relationship, which also makes the check above exact.
215
227
 
216
228
  The fourth grep is the most important invariant: a missing entry in the
217
229
  factory map is the most common silent scaffold failure.