@wildo-ai/framework-knowledge 1.1.2 → 1.1.3

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 (287) hide show
  1. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  3. package/dist/esm/framework-knowledge.definitions.js +228 -6
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.schemas.d.ts +1 -2
  6. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  7. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  8. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +3 -4
  9. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -4
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +3 -4
  13. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +4 -4
  15. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -1
  17. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +0 -1
  19. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +0 -1
  21. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +0 -1
  23. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +1 -2
  25. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +1 -2
  27. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +2 -3
  29. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +3 -3
  31. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -2
  33. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  35. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  36. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +0 -1
  37. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  38. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +0 -1
  39. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +0 -1
  41. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  42. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +0 -1
  43. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +0 -1
  45. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +0 -1
  47. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +0 -1
  49. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  50. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +0 -1
  51. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  52. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +0 -1
  53. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  54. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +0 -1
  55. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  56. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +0 -2
  57. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  58. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +2 -2
  59. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  60. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +0 -1
  61. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  62. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +0 -1
  63. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  64. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +0 -1
  65. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  66. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +0 -1
  67. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +0 -1
  69. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +0 -1
  71. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +0 -1
  73. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +0 -1
  75. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +0 -2
  77. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +9 -4
  79. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +0 -1
  81. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +0 -1
  83. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +0 -1
  85. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  86. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +0 -1
  87. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +0 -1
  89. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  91. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +0 -1
  93. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +0 -1
  95. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +0 -1
  97. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  98. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +0 -1
  99. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  100. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +0 -1
  101. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  102. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +0 -1
  103. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  104. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +0 -1
  105. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  107. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +0 -1
  109. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +0 -1
  111. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  112. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  113. package/dist/knowledge/manifest.json +8 -9
  114. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +13 -70
  115. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +11 -19
  116. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +5 -88
  117. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +15 -8
  118. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +4 -5
  119. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +15 -8
  120. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +4 -0
  121. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -7
  122. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +22 -49
  123. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -17
  124. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +15 -780
  125. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +11 -11
  126. package/dist/knowledge/playbooks/refinement.document-facts/method.md +20 -141
  127. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +15 -10
  128. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +3 -2
  129. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +16 -11
  130. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +14 -6
  131. package/dist/knowledge/playbooks/top_down.capability-map/method.md +4 -2
  132. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +16 -7
  133. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +4 -21
  134. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +65 -16
  135. package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/evaluation-protocol.json +1 -1
  136. package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/evaluation-treatment.json +1 -1
  137. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +165 -51
  138. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +43 -23
  139. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +4 -8
  140. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +7 -9
  141. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +7 -9
  142. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +15 -7
  143. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +3 -3
  144. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -11
  145. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +4 -2
  146. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +15 -7
  147. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +2 -2
  148. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +16 -11
  149. package/dist/knowledge/references/build-plan.task-graph.config.md +1 -45
  150. package/dist/knowledge/references/companion.technical-doc.service.md +2 -102
  151. package/dist/knowledge/references/example.config.app-shell.full.md +5 -0
  152. package/dist/knowledge/references/example.module.companion-exports.full.md +0 -1
  153. package/dist/knowledge/references/example.provider.backend-module-shape.md +0 -7
  154. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +1 -0
  155. package/dist/knowledge/references/platform.config.saas.md +0 -51
  156. package/dist/knowledge/references/presets.models.surface-policy.md +10 -19
  157. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +48 -0
  158. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +11 -31
  159. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +1 -0
  160. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +0 -45
  161. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +0 -198
  162. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -164
  163. package/dist/knowledge/references/saas.models.engine-capabilities.md +6 -26
  164. package/dist/knowledge/references/saas.models.http-api-binding.md +29 -3
  165. package/dist/knowledge/references/saas.models.provider-capabilities.md +3 -4
  166. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +2 -4
  167. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +0 -2
  168. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +0 -14
  169. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +31 -11
  170. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +2 -32
  171. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +6 -29
  172. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +0 -56
  173. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +0 -22
  174. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +0 -26
  175. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +0 -45
  176. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +1 -7
  177. package/dist/knowledge/references/zod.decorators.field-spec-params.md +5 -31
  178. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +1 -44
  179. package/dist/knowledge/references/zod.decorators.primitive-ui.md +0 -3
  180. package/dist/knowledge/references/zod.decorators.schema-metadata.md +0 -1
  181. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +0 -15
  182. package/dist/knowledge/registries/assurance-authority-bases.json +2 -3
  183. package/dist/knowledge/registries/framework-topics.json +11 -146
  184. package/dist/knowledge/registries/playbooks.json +18 -154
  185. package/dist/knowledge/registries/source-tags.json +630 -883
  186. package/dist/knowledge/skills/INDEX.md +3 -4
  187. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +1 -2
  188. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -16
  189. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +9 -31
  190. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +74 -252
  191. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +8 -26
  192. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +53 -97
  193. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +21 -84
  194. package/dist/knowledge/skills/config-app-shell/SKILL.md +9 -31
  195. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +12 -31
  196. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -23
  197. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +10 -19
  198. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -75
  199. package/dist/knowledge/skills/config-saas/SKILL.md +2 -19
  200. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +9 -30
  201. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +0 -51
  202. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +0 -7
  203. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +1 -2
  204. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +3 -4
  205. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +0 -56
  206. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +0 -56
  207. package/dist/knowledge/skills/module-companion-exports/SKILL.md +0 -1
  208. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +0 -56
  209. package/dist/knowledge/skills/resource-add-field/SKILL.md +3 -3
  210. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +0 -213
  211. package/dist/knowledge/skills/resource-add-resource/SKILL.md +1 -2
  212. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +2 -4
  213. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +0 -15
  214. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +2 -224
  215. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +0 -198
  216. package/dist/knowledge/skills/resource-external-data/SKILL.md +2 -0
  217. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +29 -3
  218. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +70 -0
  219. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -22
  220. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +8 -28
  221. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +0 -1
  222. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +0 -17
  223. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +0 -46
  224. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +0 -15
  225. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +0 -26
  226. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +1 -7
  227. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +0 -198
  228. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +1 -44
  229. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +0 -3
  230. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +0 -1
  231. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +0 -56
  232. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +5 -31
  233. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +0 -22
  234. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +0 -45
  235. package/dist/knowledge/topic-index.json +220 -725
  236. package/dist/tsconfig.build.tsbuildinfo +1 -1
  237. package/dist/tsconfig.tsbuildinfo +1 -1
  238. package/package.json +4 -4
  239. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +0 -1
  240. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +0 -51
  241. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -43
  242. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +0 -185
  243. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +0 -64
  244. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +0 -41
  245. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +0 -100
  246. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +0 -117
  247. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +0 -86
  248. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +0 -61
  249. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +0 -41
  250. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +0 -76
  251. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +0 -42
  252. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +0 -56
  253. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -42
  254. package/dist/knowledge/playbooks/top_down.market-research/method.md +0 -68
  255. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -44
  256. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +0 -239
  257. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +0 -67
  258. package/dist/knowledge/references/placement-plan.config.md +0 -330
  259. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +0 -34
  260. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +0 -45
  261. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +0 -65
  262. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +0 -58
  263. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +0 -118
  264. package/dist/knowledge/references/saas.models.file-upload-grant.md +0 -179
  265. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +0 -124
  266. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +0 -99
  267. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +0 -127
  268. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +0 -42
  269. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +0 -29
  270. package/dist/knowledge/references/zod.decorators.data-categories.md +0 -197
  271. package/dist/knowledge/rules/resource-schema-awareness.md +0 -77
  272. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +0 -124
  273. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +0 -47
  274. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +0 -98
  275. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +0 -54
  276. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +0 -232
  277. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +0 -149
  278. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +0 -114
  279. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +0 -133
  280. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +0 -111
  281. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +0 -622
  282. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +0 -192
  283. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +0 -245
  284. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +0 -134
  285. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +0 -65
  286. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +0 -127
  287. /package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/structured-artifact-action.json +0 -0
@@ -27,13 +27,6 @@ export const StripeBackendProvider: BackendProviderModule = {
27
27
  ref: "stripe",
28
28
  displayNameLabelKey: buildProviderDisplayNameLabelKey('stripe'),
29
29
  },
30
- // WHO can run this, and where its vendor processes — read by the compliance-document lane to
31
- // decide whether this provider is a third-party recipient at all (issue #130).
32
- complianceProfile: {
33
- deploymentModels: [ProviderDeploymentModel.VENDOR_HOSTED],
34
- processingRegions: ['us-east-1', 'eu-west-1'],
35
- vendorLegalEntityName: 'Stripe, Inc.',
36
- },
37
30
  providerCapabilities: [
38
31
  BUILTIN_PROVIDER_CAPABILITY.BILLING,
39
32
  ],
@@ -15,6 +15,7 @@ export const moduleResourcesConfigurationsFactoryMap: ResourceConfiguration_Init
15
15
  [TasksManager_ResourceType.TEAM_GOALS]: teamGoals_ResourceConfiguration_InitializationFactory,
16
16
  [TasksManager_ResourceType.ORGANIZATION_PARTNERSHIPS]: organizationPartnerships_ResourceConfiguration_InitializationFactory,
17
17
  [TasksManager_ResourceType.ORGANIZATION_ESCALATION_CONTACTS]: organizationEscalationContacts_ResourceConfiguration_InitializationFactory,
18
+ [TasksManager_ResourceType.EXTERNAL_CUSTOMERS]: externalCustomers_ResourceConfiguration_InitializationFactory,
18
19
  [TasksManager_ResourceType.ACCOUNT_ERASURE_REQUESTS]: accountErasureRequests_ResourceConfiguration_InitializationFactory,
19
20
  [TasksManager_ResourceType.KNOWLEDGE_DOCUMENTS]: knowledgeDocuments_ResourceConfiguration_InitializationFactory,
20
21
  }
@@ -93,57 +93,6 @@ export const WildoSaasConfigSchema = z.strictObject({
93
93
  bootstrap: AppBootstrapSchema.optional(),
94
94
  dataServices: AppDataServicesSchema,
95
95
 
96
- /**
97
- * How long this application keeps each class of data, and why.
98
- *
99
- * Declared HERE, beside `dataServices`, because the two describe the same thing from opposite ends:
100
- * `dataServices` says which stores exist, and this says how long what is in them is kept. Both are
101
- * application-wide operator decisions rather than per-resource authoring.
102
- *
103
- * Optional as a whole, and partial within itself. An application that has decided nothing omits it;
104
- * one that has decided only its customer-data period declares only that. Absence is never read as
105
- * "kept forever" — a compliance document states the classes that ARE declared and marks the rest as
106
- * needing an operator decision, which is what lets the document be produced today rather than
107
- * waiting on a number nobody has yet.
108
- *
109
- * Two consumers, and the second is why the classes are the STORES: a privacy notice's retention
110
- * paragraph (issue #89, which is why this exists), and the backup-and-restore inventory a remote
111
- * environment still has none of (issue #8) — one declaration answers both instead of two that drift.
112
- */
113
- dataRetention: ApplicationRetentionScheduleSchema.optional(),
114
-
115
- /**
116
- * Whether each AI capability this application enables DECIDES something about a person, and who
117
- * reviews it if so.
118
- *
119
- * A capability establishes that AI is in use and for what function; it cannot establish consequence,
120
- * because the same `AI_LLM` backs a summariser that decides nothing and a screener that decides a
121
- * great deal (issue #92).
122
- *
123
- * Optional and partial, like `dataRetention` — but the silence here is the more dangerous one. A
124
- * notice describing AI use without addressing consequence does not read as "unknown", it reads as
125
- * "nothing significant happens", which silently claims an exemption. So an enabled AI capability with
126
- * no entry is REPORTED as outstanding rather than assumed harmless.
127
- */
128
- aiUsePosture: ApplicationAiUsePostureSchema.optional(),
129
-
130
- /**
131
- * What this application stores in a visitor's browser, per FRONTEND SURFACE — the itemised table a
132
- * cookie notice IS (issue #91).
133
- *
134
- * Per surface because a public marketing site and the authenticated application set different things,
135
- * and one merged list would be wrong for both. The FRAMEWORK's own cookies are not declared here:
136
- * every application inherits them and none authored them, so they are answered by
137
- * `ENGINE_CLIENT_STORAGE_ENTRIES` and reported separately.
138
- *
139
- * Optional and partial. A surface with no entry has not been inventoried and is reported as such; an
140
- * empty ARRAY is the different, positive answer — this surface sets nothing of its own.
141
- */
142
- clientStorage: ApplicationClientStorageInventorySchema.optional(),
143
- operatingJurisdictions: ApplicationOperatingJurisdictionsSchema.optional(),
144
- operatorComplianceIdentity: ApplicationOperatorComplianceIdentitySchema.optional(),
145
- providerComplianceChoices: ApplicationProviderComplianceChoicesSchema.optional(),
146
-
147
96
  /**
148
97
  * Module registries the app pulls modules from. Each entry pairs a
149
98
  * stable id (used by lockfile entries + the `--registry <id>` CLI
@@ -370,29 +370,20 @@ export interface A11yPolicy {
370
370
  * disable). When a finite tier is set the surface is also centered in its
371
371
  * container (`margin-inline: auto`).
372
372
  */
373
- export const RESPONSIVE_MAX_WIDTH_VALUES = [
374
- 'full',
375
- 'sm',
376
- 'md',
377
- 'lg',
378
- 'xl',
373
+ export type ResponsiveMaxWidth =
374
+ | 'full'
375
+ | 'sm'
376
+ | 'md'
377
+ | 'lg'
378
+ | 'xl'
379
379
  // Reading-measure cap (~42rem) for single-column FORM / field stacks (T4c),
380
380
  // so detail/settings forms stop stretching edge-to-edge inside a wide content
381
381
  // zone. Wider than the component tiers (`sm`–`xl`, dialog-scale) but far tighter
382
382
  // than `content`/`centered-readable`. Retune via `--measure-max-width`.
383
- 'measure',
384
- 'centered-readable',
385
- 'content',
386
- 'none',
387
- ] as const;
388
-
389
- /**
390
- * The RUNTIME source for the width vocabulary, so a schema that must validate a declared tier can
391
- * name it instead of re-listing the members. It became necessary the moment width stopped being a
392
- * surface-only concern: the zone content boundary, `DisplayLayout` and `FormLayout` all select a tier
393
- * now, and a second hand-written list of the same nine values is a list that drifts.
394
- */
395
- export type ResponsiveMaxWidth = (typeof RESPONSIVE_MAX_WIDTH_VALUES)[number];
383
+ | 'measure'
384
+ | 'centered-readable'
385
+ | 'content'
386
+ | 'none';
396
387
 
397
388
  export type MobileShape = 'inline' | 'drawer' | 'sheet';
398
389
 
@@ -0,0 +1,48 @@
1
+ # saas.external-data.admin-endpoints
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-backend-lib`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-backend-lib`
10
+
11
+ ```typescript
12
+ /**
13
+ * Environment variable holding the secret these endpoints require. When unset or empty EVERY
14
+ * endpoint answers 503 — the safe default, so a fresh deployment never accidentally exposes an
15
+ * operator surface that can reach a third party's production system.
16
+ *
17
+ * Deliberately the SAME key data-seeding uses: an operator administering one app has one admin
18
+ * secret, and minting a second would mean two rotations to remember and one of them forgotten.
19
+ */
20
+ export const ExternalDataAdminEndpointEnvKey = 'APPLICATION_ADMIN_SECRET' as const;
21
+
22
+ /** Header carrying the secret. Hash-then-`timingSafeEqual`, per the sibling controller. */
23
+ export const ExternalDataAdminEndpointHeaderKey = 'X-Admin-Secret' as const;
24
+
25
+ /**
26
+ * Root mount. Under `/internal/...` rather than `/api/v1/...` because this is an operator surface,
27
+ * not a consumer API — the convention `/health` and the data-seeding admin surface already follow.
28
+ */
29
+ export const ExternalDataAdminEndpointMountBasePath = '/internal/admin/external-data' as const;
30
+
31
+ /** Sub-paths, relative to {@link ExternalDataAdminEndpointMountBasePath}. */
32
+ export const ExternalDataAdminEndpointPath = {
33
+ /** GET — every declared pipeline with its persisted cursor and last-run summary. */
34
+ PIPELINES: '/pipelines',
35
+ /**
36
+ * POST — run ONE pipeline now. `{ "resourceType": "externalCustomers" }`.
37
+ *
38
+ * This exists because a scheduled-only capability is undevelopable: authoring a mapping against
39
+ * SAP or Dynamics means change → sync → look, dozens of times, and an hourly cron makes that loop
40
+ * unusable. Verifying the first dogfood required either waiting an hour or editing committed app
41
+ * config, which is what proved the door was missing.
42
+ */
43
+ RUN: '/run',
44
+ } as const;
45
+
46
+ export type ExternalDataAdminEndpointPathValue =
47
+ (typeof ExternalDataAdminEndpointPath)[keyof typeof ExternalDataAdminEndpointPath];
48
+ ```
@@ -73,34 +73,10 @@ export const AppLevelComponentConfigurationSchema = z.object({
73
73
  z.object({
74
74
  placement: z.union([ z.literal(HorizontalPlacement.START), z.literal(HorizontalPlacement.END)]),
75
75
  collapsible: z.boolean().default(true),
76
- /**
77
- * Does the sidebar start COLLAPSED (the icon rail) rather than expanded?
78
- *
79
- * This is the application's STARTING POSITION, not a lock: the rail
80
- * collapse is a per-machine user preference persisted under
81
- * `LOCAL_STORAGE_KEYS.SIDEBAR_COLLAPSED`, and a stored preference always
82
- * wins. So this answers "what does a visitor with no preference yet
83
- * see", which nothing could express before — the hydration fell back to
84
- * `false`, making EXPANDED the only reachable default for every
85
- * application.
86
- *
87
- * Pairs with the theme's `SidebarCompactLabelMode`: `ICON_AND_LABEL`
88
- * renders a wrapping label under each icon in the collapsed rail, so a
89
- * rail-first shell stays readable rather than becoming a column of
90
- * unlabelled glyphs.
91
- *
92
- * OPTIONAL rather than `.default(false)` for the reason `homeDisplayMode`
93
- * gives one line below: a Zod default makes the key REQUIRED in the
94
- * inferred authoring type, forcing every preset and application config to
95
- * restate an opinion it does not have. The framework default (expanded —
96
- * the behavior every app had before this axis existed) is applied in
97
- * `useSidebarBehavior`, which must resolve it there regardless because a
98
- * sidebar authored as plain `true` never reaches this object branch.
99
- */
100
- defaultCollapsed: z.boolean().optional(),
101
76
  responsiveBreakpoint: z.enum(ViewportBreakpoint).default(ViewportBreakpoint.MOBILE),
102
77
  responsivePolicy: z.enum(SidebarResponsivePolicy).default(SidebarResponsivePolicy.BURGER),
103
78
  defaultSection: z.string().default("main"),
79
+ showUncategorized: z.boolean().default(true),
104
80
  /**
105
81
  * How the sidebar surfaces HOME — hidden, the pinned brand header
106
82
  * (app symbol + name above the search trigger), or a "Home" navigation
@@ -246,12 +222,16 @@ export const AppLevelComponentConfigurationSchema = z.object({
246
222
  sections: z.array(z.enum(UserDropdownSection)).optional(),
247
223
  showOrgSwitcher: z.boolean().default(true),
248
224
  showLogout: z.boolean().default(true),
249
- /**
250
- * Settings-hub section refs surfaced inline in the dropdown, in order.
251
- * Empty or omitted renders the single "Settings" button. Names the
252
- * SETTINGS vocabulary directly — never a sidebar section ref.
253
- */
254
- settingsEntries: z.array(z.string()).optional(),
225
+ mergeSettings: z.boolean().default(false),
226
+ /** Sidebar section ref for the single settings block merged into the dropdown when `mergeSettings` is true. */
227
+ settingsSectionRef: z.string().optional(),
228
+ }),
229
+ ]).default(true),
230
+
231
+ [ApplicationLevelComponentType.SETTINGS_DROPDOWN]: z.union([
232
+ z.boolean().default(true),
233
+ z.object({
234
+ mergedWith: z.literal(ApplicationLevelComponentType.USER_DROPDOWN),
255
235
  }),
256
236
  ]).default(true),
257
237
 
@@ -31,6 +31,7 @@ export enum ApplicationLevelComponentType {
31
31
  * renders the same preset. Exists to allow separate config entries while reusing
32
32
  * the user dropdown component. For distinct UX, register a dedicated preset.
33
33
  */
34
+ SETTINGS_DROPDOWN = 'settings_dropdown',
34
35
  NAVIGATION_CONTROL = 'navigation_control',
35
36
  /** Mode selector — renders available `AppMode`s as selectable icons. */
36
37
  ACTIVITY_BAR = 'activity_bar',
@@ -39,45 +39,6 @@ export interface CompositeViewAuthoringConfig {
39
39
  * overlays) render the authored icon.
40
40
  */
41
41
  icon?: IconLike;
42
- /**
43
- * What happens to an ADJACENT zone (secondary / companion) this destination
44
- * splits into, once that zone's last content is dismissed — overriding the
45
- * zone's own `onEmpty` while this destination occupies primary.
46
- *
47
- * The zone-level `ZoneConfig.onEmpty` is one value for every destination that
48
- * splits into that zone, and destinations legitimately disagree: a LIST wants
49
- * the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow
50
- * while a reviewer steps through rows, while a CANVAS wants its width back
51
- * (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,
52
- * so without this override one of them is always wrong.
53
- *
54
- * Omitted (the common case) defers to the zone, which itself defaults to
55
- * `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →
56
- * COLLAPSE; see `resolveZoneEmptyBehavior`.
57
- */
58
- adjacentZoneOnEmpty?: ZoneEmptyBehavior;
59
- /**
60
- * How wide this destination's content may grow in the zone, in the framework's shared width
61
- * vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.
62
- *
63
- * Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,
64
- * right for a form, a list or a detail page and wrong only for content whose value IS the space it
65
- * occupies — a board, a wide table, a canvas — which declare `'none'`.
66
- */
67
- zoneContentMaxWidth?: ResponsiveMaxWidth;
68
- /**
69
- * Whether this destination's content fills the zone's HEIGHT as well.
70
- *
71
- * `true` makes the zone's content boundary a definite-height flex column, so this view's root may use
72
- * `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height
73
- * and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW
74
- * rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child
75
- * and a scrolling parent contradict each other.
76
- *
77
- * Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that
78
- * fused them could not express a capped width with a definite height.
79
- */
80
- zoneContentFillsHeight?: boolean;
81
42
  }
82
43
 
83
44
  /**
@@ -133,12 +94,6 @@ export interface CompositeViewDefinition {
133
94
  * `CoreIconRegistry.compositeView`, keyed by `ref`.
134
95
  */
135
96
  icon?: IconLike;
136
- /** See {@link CompositeViewAuthoringConfig.adjacentZoneOnEmpty}. Mirrored from authoring. */
137
- adjacentZoneOnEmpty?: ZoneEmptyBehavior;
138
- /** See {@link CompositeViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */
139
- zoneContentMaxWidth?: ResponsiveMaxWidth;
140
- /** See {@link CompositeViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */
141
- zoneContentFillsHeight?: boolean;
142
97
  }
143
98
 
144
99
  export type AppCompositeViewsConfig = Record<string, CompositeViewAuthoringConfig>;
@@ -143,106 +143,6 @@ export enum ActionPlacement {
143
143
  DANGER_ZONE = 'danger_zone',
144
144
  }
145
145
 
146
- /**
147
- * HOW an operation's action collects its input and shows its result — the chrome the user meets
148
- * when they click the button.
149
- *
150
- * ## Why this axis exists
151
- *
152
- * Until this axis, one rule decided the answer for every custom operation:
153
- * *has a `requestDto` ⇒ navigate*. So an action asking for a single reason string got the same
154
- * full-page treatment as a multi-step wizard, and the only way out was to author
155
- * `navigationOverrides` — per operation, in terms of a zone, a transition verb and an appearance.
156
- * Three concepts to answer one question.
157
- *
158
- * This is that one question. It is a **display-only** axis: backend authorization is untouched and
159
- * `roles` remain the only security authority, exactly like its siblings {@link ActionVisibility},
160
- * {@link ActionPlacement} and {@link ResourceOperationActionScope}.
161
- *
162
- * ## It is an ALIAS, not a parallel mechanism
163
- *
164
- * `MODAL` and `PAGE` do not render anything themselves — they resolve to the navigation transitions
165
- * that already exist (`OVERLAY`, and the ordinary chain), so there is one runtime mechanism and one
166
- * set of zone/appearance/URL semantics. `DIRECT`, `POPOVER` and `INLINE` never enter navigation at
167
- * all, because none of them is a destination: nothing is pushed, no zone changes, and there is
168
- * nothing for a back button to pop. `INLINE` is hosted by the collection the element belongs to —
169
- * see `InPlaceOperationContext` for why that is not the navigation layer's job.
170
- *
171
- * Consequently an explicit `navigationOverrides` entry still WINS over a presentation authored here
172
- * (it is the more specific instrument, and it is checked first in the resolution chain). Author this
173
- * axis to say what KIND of chrome the action wants; author `navigationOverrides` when you need to
174
- * name the zone, the appearance or the viewport yourself.
175
- *
176
- * ## When omitted
177
- *
178
- * It is DERIVED from the operation — see `resolveResourceOperationActionPresentation()`. An
179
- * operation that asks for nothing executes directly; a small field set opens a modal; input the
180
- * framework cannot fit in an overlay (files, nested writes, a large field set) keeps the page it
181
- * has always had. An operation whose `surface` is `ADDRESSABLE` always keeps its page: the author
182
- * has already said it is a deep-linkable destination.
183
- */
184
- export enum ResourceOperationActionPresentation {
185
- /**
186
- * Execute on click, with no form at all — the confirmation dialog for a risky operation is the
187
- * only thing between the click and the request.
188
- *
189
- * Only meaningful for an operation that needs no caller input. Declaring it on an operation that
190
- * DOES have required request fields would send an empty body, so the resolver refuses to derive it
191
- * there and an author who declares it anyway gets the operation's fields dropped — check
192
- * `requestDto` before reaching for this.
193
- */
194
- DIRECT = 'direct',
195
- /**
196
- * A small form anchored to the button that opened it, dismissed by clicking away.
197
- *
198
- * The single-input idiom ("assign to…", "snooze until…"). Transient by construction: no URL, no
199
- * history entry, nothing to deep-link. Use it when the surrounding context is the point — the user
200
- * is reading the row they are acting on and must not lose sight of it.
201
- */
202
- POPOVER = 'popover',
203
- /**
204
- * The element being acted on transforms in place to collect the input, leaving its neighbours
205
- * visible — the row becomes the form rather than being covered by one.
206
- *
207
- * Use it when the surrounding rows are the point: the user is comparing, and an overlay would hide
208
- * the very thing that made them act on this row.
209
- *
210
- * **Transient, like {@link POPOVER}, and for the same reason.** Nothing is pushed, no URL changes,
211
- * and a reload returns the list to rest. An inline row-edit is a momentary state of a listing, not
212
- * a place — which is also why no admin framework deep-links one, and why anything that SHOULD be
213
- * linkable, reloadable or reachable by a back button wants {@link PAGE}.
214
- *
215
- * **It requires a collection.** The host is provided by the list the element belongs to
216
- * (`InPlaceOperationProvider`); the same action rendered on a detail page, in a danger zone or in a
217
- * picker has no row to transform and degrades to an overlay rather than becoming a dead button.
218
- *
219
- * Note it does NOT resolve to `NavigationTransition.INPLACE`. Element-level hosting uses none of
220
- * what the navigation layer offers — no zone, no stack entry, no appearance — and routing it there
221
- * is exactly why that transition has never done what its own docstring promises. See
222
- * `InPlaceOperationContext`.
223
- */
224
- INLINE = 'inline',
225
- /**
226
- * An overlay above the layout — the workhorse for "a handful of fields", and the default the
227
- * derivation reaches for.
228
- *
229
- * Resolves to {@link NavigationTransition.OVERLAY}. The concrete appearance (dialog / sheet /
230
- * drawer / panel) stays the app's decision, resolved from its navigation layout exactly as any
231
- * other overlay: this axis says "an overlay", not "a dialog specifically". Author
232
- * `navigationOverrides` when you need to name one.
233
- */
234
- MODAL = 'modal',
235
- /**
236
- * A routable page, resolved through the ordinary navigation chain (zone transitions, viewport
237
- * overrides, the framework `PUSH` fallback) — i.e. exactly the behaviour every parameterised
238
- * action had before this axis existed.
239
- *
240
- * The right answer for complex or multi-step input, and for anything a user should be able to
241
- * link to, reload, or reach with a back button.
242
- */
243
- PAGE = 'page',
244
- }
245
-
246
146
  /**
247
147
  * Does an operation's action target a SINGLE resource instance, or the WHOLE
248
148
  * collection in the current scope?
@@ -371,26 +271,6 @@ export const CardActionPlacementSchema = z.object({
371
271
  /** Authored 2-axis card action placement — inferred from {@link CardActionPlacementSchema}. */
372
272
  export type CardActionPlacement = z.infer<typeof CardActionPlacementSchema>;
373
273
 
374
- /**
375
- * Who paints the identity GLYPH on this operation's page header.
376
- *
377
- * The header band renders the resource's registry icon beside the identity line by default. A
378
- * `layout.header` template that composes its own record-linked glyph (a per-row kind icon, a
379
- * per-family symbol) would otherwise sit BESIDE the resource icon — two glyphs naming one thing.
380
- *
381
- * Declared at the OPERATION layer rather than detected from the template, deliberately: the
382
- * resource icon renders before the template mounts, so detection could only suppress it after the
383
- * fact — a glyph that flashes and vanishes on every load. Mirrors
384
- * `SummaryTitlePlacement.TEMPLATE_OWNED`, the same contract one surface over: ceding a
385
- * framework-owned element to the template is a declaration, not an inference.
386
- */
387
- export enum HeaderIconPlacement {
388
- /** The framework renders the resource's registry icon (default). */
389
- AUTO = 'auto',
390
- /** The header template owns the glyph; the framework renders none. */
391
- TEMPLATE_OWNED = 'template_owned',
392
- }
393
-
394
274
  export const ResourceOperationFrontendConfigSchema = z.object({
395
275
  /**
396
276
  * The operation's frontend **surface** — see {@link ResourceOperationFrontendSurface}.
@@ -402,8 +282,6 @@ export const ResourceOperationFrontendConfigSchema = z.object({
402
282
  * Replaces the former `isAddressable` boolean — read via `isOperationAddressable()`.
403
283
  */
404
284
  surface: z.enum(ResourceOperationFrontendSurface),
405
- /** Who paints the page header's identity glyph — see {@link HeaderIconPlacement}. Omitted = AUTO. */
406
- headerIconPlacement: z.enum(HeaderIconPlacement).optional(),
407
285
  /**
408
286
  * How this operation's action is surfaced — see {@link ActionVisibility}. Omitted
409
287
  * (the common case) behaves as `ALWAYS`.
@@ -439,15 +317,6 @@ export const ResourceOperationFrontendConfigSchema = z.object({
439
317
  * row id still rides the URL path too, which the handler may ignore.)
440
318
  */
441
319
  rowTargetRequestField: z.string().optional(),
442
- /**
443
- * HOW this action collects its input — see {@link ResourceOperationActionPresentation}.
444
- * Omitted derives from the operation (`resolveResourceOperationActionPresentation`): no input
445
- * executes directly, a small field set opens a modal, complex input keeps its page.
446
- *
447
- * Display-only. An explicit `navigationOverrides` entry is the more specific instrument and wins
448
- * over whatever this resolves to.
449
- */
450
- actionPresentation: z.enum(ResourceOperationActionPresentation).optional(),
451
320
  customView: z.any().optional(),
452
321
  displayPresetOverride: z.object({
453
322
  resourceLayoutPresetKey: z.string().optional(),
@@ -483,30 +352,6 @@ export const ResourceOperationFrontendConfigSchema = z.object({
483
352
  * without a date heading rather than being dropped.
484
353
  */
485
354
  temporalGroupField: z.string().optional(),
486
- /**
487
- * Group CARDS-mode rows into buckets by this ENUM field, rendering the
488
- * enum value's own label as a heading between groups.
489
- *
490
- * Sibling of {@link temporalGroupField}, and deliberately NOT the same
491
- * algorithm. Temporal grouping ADJACENT-MERGES in server order, because
492
- * dates are open-ended and a page can legitimately revisit one. An enum is
493
- * a CLOSED, ORDERED vocabulary, so its buckets are emitted in the enum's
494
- * DECLARATION ORDER regardless of the order rows arrived in — the
495
- * declaration is the authority for "which concern comes first", and a
496
- * server sort cannot express it without a second, drifting copy of that
497
- * order. Rows are therefore collected across the whole fetched page rather
498
- * than merged adjacently, and no sort needs pairing with it.
499
- *
500
- * Headings resolve through `tResourceFieldEnumValue` — the SAME source the
501
- * filters panel and the promoted quick-filter tabs use, so a bucket
502
- * heading and its tab can never disagree.
503
- *
504
- * Ignored in TABLE mode (column sorting owns the ordering there). Rows
505
- * whose value is absent, or outside the vocabulary, render in a trailing
506
- * bucket with no heading rather than being dropped — the same fail-open
507
- * the temporal grouping makes.
508
- */
509
- enumGroupField: z.string().optional(),
510
355
  /**
511
356
  * CARDS-mode arrangement — a single-column bordered LIST (default) or an
512
357
  * N-column responsive GRID. See {@link CardLayoutStyle}. `columns` (1–6) is
@@ -560,49 +405,6 @@ export const ResourceOperationFrontendConfigSchema = z.object({
560
405
  * into a description via the `.describe()` decorator.
561
406
  */
562
407
  hasDescription: z.boolean().optional(),
563
- /**
564
- * What happens to an ADJACENT zone (secondary / companion) this operation
565
- * splits into, once that zone's last content is dismissed — overriding the
566
- * zone's own `onEmpty` while this operation occupies primary.
567
- *
568
- * The zone-level `ZoneConfig.onEmpty` is one value for every destination that
569
- * splits into that zone, and destinations legitimately disagree: a LIST wants
570
- * the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow
571
- * while a reviewer steps through rows, while a CANVAS wants its width back
572
- * (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,
573
- * so without this override one of them is always wrong.
574
- *
575
- * Declared on the SOURCE operation — the one occupying primary — not on the
576
- * operation that lands in the pane: it answers "what should MY layout do when
577
- * the detail closes", which is a property of the surface being returned to.
578
- *
579
- * Omitted (the common case) defers to the zone, which itself defaults to
580
- * `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →
581
- * COLLAPSE; see `resolveZoneEmptyBehavior`.
582
- */
583
- adjacentZoneOnEmpty: z.enum(ZoneEmptyBehavior).optional(),
584
- /**
585
- * How wide this destination's content may grow in the zone, in the framework's shared width
586
- * vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.
587
- *
588
- * Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,
589
- * right for a form, a list or a detail page and wrong only for content whose value IS the space it
590
- * occupies — a board, a wide table, a canvas — which declare `'none'`.
591
- */
592
- zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),
593
- /**
594
- * Whether this destination's content fills the zone's HEIGHT as well.
595
- *
596
- * `true` makes the zone's content boundary a definite-height flex column, so this view's root may use
597
- * `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height
598
- * and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW
599
- * rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child
600
- * and a scrolling parent contradict each other.
601
- *
602
- * Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that
603
- * fused them could not express a capped width with a definite height.
604
- */
605
- zoneContentFillsHeight: z.boolean().optional(),
606
408
  });
607
409
 
608
410
  /**