@wildo-ai/framework-knowledge 1.1.2 → 1.1.4

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 (289) 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 +351 -18
  4. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  5. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  6. package/dist/esm/framework-knowledge.schemas.d.ts +1 -2
  7. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  8. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  9. package/dist/esm/index.d.ts.map +1 -1
  10. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +3 -4
  11. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  12. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -4
  13. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  14. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +3 -4
  15. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  16. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +4 -4
  17. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  18. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -1
  19. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  20. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +0 -1
  21. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  22. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +0 -1
  23. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +0 -1
  25. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +1 -2
  27. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +1 -2
  29. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +2 -3
  31. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +3 -3
  33. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -2
  35. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
  37. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +0 -1
  39. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  40. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +0 -1
  41. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +0 -1
  43. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +0 -1
  45. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +0 -1
  47. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +0 -1
  49. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +0 -1
  51. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +0 -1
  53. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +0 -1
  55. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  56. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +0 -1
  57. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  58. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +0 -2
  59. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +2 -2
  61. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  62. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +0 -1
  63. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +0 -1
  65. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +0 -1
  67. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +0 -1
  69. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  70. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +0 -1
  71. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  72. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +0 -1
  73. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  74. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +0 -1
  75. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +0 -1
  77. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  78. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +0 -2
  79. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +9 -4
  81. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  82. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +0 -1
  83. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  84. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +0 -1
  85. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +0 -1
  87. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  88. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +0 -1
  89. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  90. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +0 -1
  91. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  92. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
  93. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  94. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +0 -1
  95. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  96. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +0 -1
  97. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +0 -1
  99. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +0 -1
  101. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +0 -1
  103. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  104. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +0 -1
  105. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  106. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +0 -1
  107. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  108. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
  109. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  110. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +0 -1
  111. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +0 -1
  113. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  114. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  115. package/dist/knowledge/manifest.json +8 -9
  116. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +13 -70
  117. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +11 -19
  118. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +5 -88
  119. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +15 -8
  120. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +4 -5
  121. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +15 -8
  122. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +4 -0
  123. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -7
  124. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +22 -49
  125. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -17
  126. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +15 -780
  127. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +11 -11
  128. package/dist/knowledge/playbooks/refinement.document-facts/method.md +20 -141
  129. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +15 -10
  130. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +3 -2
  131. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +16 -11
  132. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +14 -6
  133. package/dist/knowledge/playbooks/top_down.capability-map/method.md +4 -2
  134. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +16 -7
  135. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +4 -21
  136. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +65 -16
  137. package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/evaluation-protocol.json +1 -1
  138. package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/evaluation-treatment.json +1 -1
  139. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +165 -51
  140. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +43 -23
  141. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +4 -8
  142. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +7 -9
  143. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +7 -9
  144. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +15 -7
  145. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +3 -3
  146. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -11
  147. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +4 -2
  148. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +15 -7
  149. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +2 -2
  150. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +16 -11
  151. package/dist/knowledge/references/build-plan.task-graph.config.md +1 -45
  152. package/dist/knowledge/references/companion.technical-doc.service.md +2 -102
  153. package/dist/knowledge/references/example.config.app-shell.full.md +5 -0
  154. package/dist/knowledge/references/example.module.companion-exports.full.md +0 -1
  155. package/dist/knowledge/references/example.provider.backend-module-shape.md +0 -7
  156. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +1 -0
  157. package/dist/knowledge/references/platform.config.saas.md +0 -51
  158. package/dist/knowledge/references/presets.models.surface-policy.md +10 -19
  159. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +48 -0
  160. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +11 -31
  161. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +1 -0
  162. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +0 -45
  163. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +0 -198
  164. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -164
  165. package/dist/knowledge/references/saas.models.engine-capabilities.md +6 -26
  166. package/dist/knowledge/references/saas.models.http-api-binding.md +29 -3
  167. package/dist/knowledge/references/saas.models.provider-capabilities.md +3 -4
  168. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +2 -4
  169. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +0 -2
  170. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +0 -14
  171. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +31 -11
  172. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +2 -32
  173. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +6 -29
  174. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +0 -56
  175. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +0 -22
  176. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +0 -26
  177. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +0 -45
  178. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +1 -7
  179. package/dist/knowledge/references/zod.decorators.field-spec-params.md +5 -31
  180. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +1 -44
  181. package/dist/knowledge/references/zod.decorators.primitive-ui.md +0 -3
  182. package/dist/knowledge/references/zod.decorators.schema-metadata.md +0 -1
  183. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +0 -15
  184. package/dist/knowledge/registries/assurance-authority-bases.json +2 -3
  185. package/dist/knowledge/registries/framework-topics.json +11 -146
  186. package/dist/knowledge/registries/playbooks.json +18 -154
  187. package/dist/knowledge/registries/source-tags.json +630 -883
  188. package/dist/knowledge/skills/INDEX.md +3 -4
  189. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +1 -2
  190. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -16
  191. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +9 -31
  192. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +74 -252
  193. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +8 -26
  194. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +53 -97
  195. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +21 -84
  196. package/dist/knowledge/skills/config-app-shell/SKILL.md +9 -31
  197. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +12 -31
  198. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -23
  199. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +10 -19
  200. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -75
  201. package/dist/knowledge/skills/config-saas/SKILL.md +2 -19
  202. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +9 -30
  203. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +0 -51
  204. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +0 -7
  205. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +1 -2
  206. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +3 -4
  207. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +0 -56
  208. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +0 -56
  209. package/dist/knowledge/skills/module-companion-exports/SKILL.md +0 -1
  210. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +0 -56
  211. package/dist/knowledge/skills/resource-add-field/SKILL.md +3 -3
  212. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +0 -213
  213. package/dist/knowledge/skills/resource-add-resource/SKILL.md +1 -2
  214. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +2 -4
  215. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +0 -15
  216. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +2 -224
  217. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +0 -198
  218. package/dist/knowledge/skills/resource-external-data/SKILL.md +2 -0
  219. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +29 -3
  220. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +70 -0
  221. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -22
  222. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +8 -28
  223. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +0 -1
  224. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +0 -17
  225. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +0 -46
  226. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +0 -15
  227. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +0 -26
  228. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +1 -7
  229. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +0 -198
  230. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +1 -44
  231. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +0 -3
  232. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +0 -1
  233. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +0 -56
  234. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +5 -31
  235. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +0 -22
  236. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +0 -45
  237. package/dist/knowledge/topic-index.json +220 -725
  238. package/dist/tsconfig.build.tsbuildinfo +1 -1
  239. package/dist/tsconfig.tsbuildinfo +1 -1
  240. package/package.json +4 -4
  241. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +0 -1
  242. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +0 -51
  243. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -43
  244. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +0 -185
  245. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +0 -64
  246. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +0 -41
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +0 -100
  248. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +0 -117
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +0 -86
  250. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +0 -61
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +0 -41
  252. package/dist/knowledge/playbooks/top_down.compliance-research/method.md +0 -76
  253. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +0 -42
  254. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +0 -56
  255. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -42
  256. package/dist/knowledge/playbooks/top_down.market-research/method.md +0 -68
  257. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -44
  258. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +0 -239
  259. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +0 -67
  260. package/dist/knowledge/references/placement-plan.config.md +0 -330
  261. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +0 -34
  262. package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +0 -45
  263. package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +0 -65
  264. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +0 -58
  265. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +0 -118
  266. package/dist/knowledge/references/saas.models.file-upload-grant.md +0 -179
  267. package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +0 -124
  268. package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +0 -99
  269. package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +0 -127
  270. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +0 -42
  271. package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +0 -29
  272. package/dist/knowledge/references/zod.decorators.data-categories.md +0 -197
  273. package/dist/knowledge/rules/resource-schema-awareness.md +0 -77
  274. package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +0 -124
  275. package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +0 -47
  276. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +0 -98
  277. package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +0 -54
  278. package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +0 -232
  279. package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +0 -149
  280. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +0 -114
  281. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +0 -133
  282. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +0 -111
  283. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +0 -622
  284. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +0 -192
  285. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +0 -245
  286. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +0 -134
  287. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +0 -65
  288. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +0 -127
  289. /package/dist/knowledge/playbooks/{top_down.market-snapshot-produce → top_down.market-analysis}/structured-artifact-action.json +0 -0
@@ -1,179 +0,0 @@
1
- # saas.models.file-upload-grant
2
-
3
- ## Import Origins
4
-
5
- - `@wildo-ai/saas-models`
6
-
7
- ## Source Excerpts
8
-
9
- ### Origin Package: `@wildo-ai/saas-models`
10
-
11
- ```typescript
12
- *
13
- * Lifetime bounds of an upload grant, in minutes. The ceiling is fixed by the framework and enforced
14
- * when the grant is minted — a request above it is REFUSED, never clamped, so a caller that asked for
15
- * two hours learns from an error that the bound is sixty minutes rather than from an expiry it did not
16
- * expect. The bound is the framework's to own because the grant is designed to leave the trust
17
- * boundary: it lands in an AI agent's transcript, a model provider's logs, a shell history.
18
- */
19
- export const FILE_UPLOAD_GRANT_DEFAULT_MINUTES = 15;
20
- export const FILE_UPLOAD_GRANT_ABSOLUTE_MAX_MINUTES = 60;
21
-
22
- /**
23
- * Which write the grant is for. A grant minted on the CREATE upload route uploads a file that a
24
- * later CREATE will reference; one minted on the UPDATE route (`…/{resourceId}/files/<field>`) is
25
- * bound to that row. The two routes authorize differently, so a grant may not cross from one to the
26
- * other — the upload middleware checks this against the route it is presented on.
27
- */
28
- export const FILE_UPLOAD_GRANT_OPERATIONS = [CoreResourceOperation.CREATE, CoreResourceOperation.UPDATE] as const;
29
- export type FileUploadGrantOperation = (typeof FILE_UPLOAD_GRANT_OPERATIONS)[number];
30
- /** Derived from `CoreResourceOperation` — the named source — rather than a second enum spelling the same two words. */
31
- export const FileUploadGrantOperationSchema: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }> = z.enum(FILE_UPLOAD_GRANT_OPERATIONS);
32
-
33
- /**
34
- * Lifecycle of a grant as the status read reports it. Derived from the token row — `isConsumed`,
35
- * `expiresAt`, `revokedAt` — never stored, so it cannot drift from the row.
36
- */
37
- export enum FileUploadGrantState {
38
- /** Minted, unexpired, unrevoked, not yet redeemed: an upload will be accepted. */
39
- PENDING = 'pending',
40
- /** Redeemed by exactly one upload. `file` names what it produced when the write-back succeeded. */
41
- REDEEMED = 'redeemed',
42
- /** Past `expiresAt` without being redeemed. Mint a new one. */
43
- EXPIRED = 'expired',
44
- /** Revoked by the minter or an administrator before redemption. */
45
- REVOKED = 'revoked',
46
- }
47
- export const FileUploadGrantStateSchema: z.ZodEnum<typeof FileUploadGrantState> = z.enum(FileUploadGrantState);
48
-
49
- /**
50
- * The `metadata` a FILE_UPLOAD_GRANT token carries — the ROUTE binding, as opposed to the identity
51
- * the typed token fields carry. The upload middleware reads this; the execution-context creator
52
- * deliberately does not.
53
- */
54
- export const FileUploadGrantMetadataSchema: z.ZodObject<{
55
- fieldName: z.ZodString;
56
- operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
57
- minter: z.ZodObject<{ entityType: z.ZodString; id: z.ZodString }>;
58
- uploadUrl: z.ZodString;
59
- producedFileId: z.ZodOptional<z.ZodString>;
60
- }> = z.object({
61
- /** The `z_file()` field the upload lands on, as authored (dotted for nested fields). */
62
- fieldName: z.string().min(1),
63
- operation: FileUploadGrantOperationSchema,
64
- /**
65
- * Who minted — recorded so the uploaded file is attributed to a PERSON or MACHINE, not to the
66
- * grant. `entityType` is a `FileUploaderEntityType` value; kept as a string here because the
67
- * uploader enum lives in `zod-decorators`, upstream of this package.
68
- */
69
- minter: z.object({ entityType: z.string().min(1), id: z.string().min(1) }),
70
- /** The concrete upload URL the grant was minted for — recorded so the status read can hand it to the drop page. */
71
- uploadUrl: z.string().url(),
72
- /** Written after a successful redemption; absent until then. */
73
- producedFileId: z.string().min(1).optional(),
74
- });
75
- export type FileUploadGrantMetadata = z.infer<typeof FileUploadGrantMetadataSchema>;
76
-
77
- /**
78
- * What a mint returns — identical on the REST door and the MCP tool. Two affordances for one
79
- * token: `uploadCommand` for a caller that can execute, `uploadPageUrl` for one that must hand a
80
- * human a link. The token appears in `uploadHeader.value` and inside both commands and the page URL;
81
- * it is the credential and cannot be omitted. It never appears in any audit row.
82
- */
83
- export const FileUploadGrantSchema: z.ZodObject<{
84
- grantId: z.ZodString;
85
- state: z.ZodEnum<typeof FileUploadGrantState>;
86
- expiresAt: z.ZodString;
87
- singleUse: z.ZodLiteral<true>;
88
- target: z.ZodObject<{
89
- resourceType: z.ZodString;
90
- fieldName: z.ZodString;
91
- operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
92
- resourceId: z.ZodNullable<z.ZodString>;
93
- }>;
94
- constraints: z.ZodObject<{
95
- maxBytes: z.ZodNumber;
96
- allowedMimeTypes: z.ZodArray<z.ZodString>;
97
- }>;
98
- uploadUrl: z.ZodString;
99
- uploadHeader: z.ZodObject<{ name: z.ZodString; value: z.ZodString }>;
100
- uploadCommand: z.ZodString;
101
- uploadCommandPowerShell: z.ZodString;
102
- uploadPageUrl: z.ZodNullable<z.ZodString>;
103
- statusUrl: z.ZodString;
104
- note: z.ZodString;
105
- }> = z.object({
106
- grantId: z.string().min(1),
107
- state: FileUploadGrantStateSchema,
108
- expiresAt: z.string().datetime(),
109
- singleUse: z.literal(true),
110
- target: z.object({
111
- resourceType: z.string().min(1),
112
- fieldName: z.string().min(1),
113
- operation: FileUploadGrantOperationSchema,
114
- resourceId: z.string().min(1).nullable(),
115
- }),
116
- /** From the field's own constraint resolver — the same one the upload enforces, so the two cannot disagree. */
117
- constraints: z.object({
118
- maxBytes: z.number().int().positive(),
119
- /** Empty means every type is accepted. */
120
- allowedMimeTypes: z.array(z.string()),
121
- }),
122
- uploadUrl: z.string().url(),
123
- /** The credential travels in a HEADER on the curl form: paths are logged by every proxy, headers are not. */
124
- uploadHeader: z.object({ name: z.string().min(1), value: z.string().min(1) }),
125
- /** No `-f`: on a refusal the JSON error body is the only thing that tells the caller why. */
126
- uploadCommand: z.string().min(1),
127
- /** In PowerShell `curl` aliases Invoke-WebRequest, which does not understand `-F`; the real binary is `curl.exe`. */
128
- uploadCommandPowerShell: z.string().min(1),
129
- /** `null` when the application declares no frontend service — a headless API has no page to hand a human. */
130
- uploadPageUrl: z.string().url().nullable(),
131
- statusUrl: z.string().url(),
132
- note: z.string().min(1),
133
- });
134
- export type FileUploadGrant = z.infer<typeof FileUploadGrantSchema>;
135
-
136
- /**
137
- * What the public status read returns. The token is the credential, so the read is unauthenticated
138
- * and returns only what the drop page needs to render and the agent needs to learn the `fileId`:
139
- * never the file's name (the status URL may be pasted around).
140
- */
141
- export const FileUploadGrantStatusSchema: z.ZodObject<{
142
- grantId: z.ZodString;
143
- state: z.ZodEnum<typeof FileUploadGrantState>;
144
- expiresAt: z.ZodString;
145
- target: z.ZodObject<{
146
- resourceType: z.ZodString;
147
- fieldName: z.ZodString;
148
- operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
149
- resourceId: z.ZodNullable<z.ZodString>;
150
- }>;
151
- constraints: z.ZodObject<{ maxBytes: z.ZodNumber; allowedMimeTypes: z.ZodArray<z.ZodString> }>;
152
- uploadUrl: z.ZodString;
153
- uploadHeaderName: z.ZodString;
154
- file: z.ZodNullable<z.ZodObject<{ fileId: z.ZodString; status: z.ZodEnum<typeof FileStatus> }>>;
155
- }> = z.object({
156
- grantId: z.string().min(1),
157
- state: FileUploadGrantStateSchema,
158
- expiresAt: z.string().datetime(),
159
- target: z.object({
160
- resourceType: z.string().min(1),
161
- fieldName: z.string().min(1),
162
- operation: FileUploadGrantOperationSchema,
163
- resourceId: z.string().min(1).nullable(),
164
- }),
165
- constraints: z.object({ maxBytes: z.number().int().positive(), allowedMimeTypes: z.array(z.string()) }),
166
- uploadUrl: z.string().url(),
167
- /** The page sets this header itself; the token it already holds is the value. */
168
- uploadHeaderName: z.string().min(1),
169
- /** `null` until redeemed, or when the post-redemption write-back failed (re-read the resource instead). */
170
- file: z.object({ fileId: z.string().min(1), status: z.enum(FileStatus) }).nullable(),
171
- });
172
- export type FileUploadGrantStatus = z.infer<typeof FileUploadGrantStatusSchema>;
173
-
174
- /** Body accepted by both mint doors. */
175
- export const FileUploadGrantMintRequestSchema: z.ZodObject<{ expiresInMinutes: z.ZodOptional<z.ZodNumber> }> = z.object({
176
- expiresInMinutes: z.number().int().min(1).max(FILE_UPLOAD_GRANT_ABSOLUTE_MAX_MINUTES).optional(),
177
- }).strict();
178
- export type FileUploadGrantMintRequest = z.infer<typeof FileUploadGrantMintRequestSchema>;
179
- ```
@@ -1,124 +0,0 @@
1
- # saas.models.navigation.surface-vocabulary
2
-
3
- ## Import Origins
4
-
5
- - `@wildo-ai/saas-models`
6
-
7
- ## Source Excerpts
8
-
9
- ### Origin Package: `@wildo-ai/saas-models`
10
-
11
- ```typescript
12
- */
13
- export enum NavigationZoneName {
14
- /** Main content area. Lists, root-level reads, primary workspace. Always exists. */
15
- PRIMARY = 'primary',
16
- /**
17
- * First adjacent zone. Detail content in list-detail patterns.
18
- * Only exists if declared in config. Appears when a `split` transition targets it.
19
- * Typical use: showing item details alongside a list.
20
- */
21
- SECONDARY = 'secondary',
22
- /**
23
- * Persistent supplementary content. Reference panels, docs, notes, threads.
24
- * Only exists if declared in config. Usually hidden by default (`defaultVisible: false`).
25
- * Activated by `split` with `persistent: true` or explicit user toggle.
26
- * Typical use: Slack thread panel, VS Code terminal, documentation sidebar.
27
- */
28
- COMPANION = 'companion',
29
- }
30
-
31
- /**
32
- * How a zone manages multiple items. Orthogonal to transitions.
33
- *
34
- * The transition says "content arrives" — the content model says
35
- * "how does the zone accommodate it." Any zone can use any content model,
36
- * regardless of which transitions it supports.
37
- */
38
- export enum NavigationZoneContentModel {
39
- /**
40
- * Navigation stack: new content pushes on top, previous preserved underneath.
41
- * Only one item visible at a time. Back navigation pops the stack.
42
- * `replace` replaces the top without adding to the stack.
43
- * This is the default for all zones.
44
- */
45
- SINGLE = 'single',
46
- /**
47
- * Parallel tabs: `push` creates a new tab (or activates existing for the same resource).
48
- * Tab bar is visible, showing all open tabs. No depth stack within tabs.
49
- * `replace` replaces the active tab's content. Close is an explicit action (not back).
50
- * When no tabs remain, `onEmpty` behavior applies.
51
- */
52
- TABBED = 'tabbed',
53
- }
54
-
55
- /**
56
- * Responsive collapse behavior when viewport shrinks below a zone's breakpoint.
57
- *
58
- * Only applies to secondary and companion zones. Primary never collapses.
59
- * When viewport grows back past the breakpoint, collapsed content migrates
60
- * back to its original zone (content is preserved).
61
- */
62
- export enum ResponsiveCollapseMode {
63
- /**
64
- * Zone hides. Its content joins primary's navigation stack.
65
- * The user sees the content in-context within primary.
66
- * Back navigation pops back to primary's previous content.
67
- */
68
- PUSH = 'push',
69
- /**
70
- * Zone hides. Its content opens as an overlay on top of primary.
71
- * The user sees the content as a floating sheet/dialog.
72
- * Dismiss returns to the underlying primary content.
73
- */
74
- OVERLAY = 'overlay',
75
- }
76
- ```
77
-
78
- ### Origin Package: `@wildo-ai/saas-models`
79
-
80
- ```typescript
81
- *
82
- * Visual presentation for overlay transitions.
83
- * Determines how floating content renders above the layout.
84
- */
85
- export enum OverlayAppearance {
86
- /**
87
- * Centered modal dialog with backdrop.
88
- * Best for focused tasks: create forms, confirmations, destructive actions.
89
- * Blocks underlying content visually. Escape or backdrop click dismisses.
90
- */
91
- DIALOG = 'dialog',
92
- /**
93
- * Side or bottom drawer panel that slides in from an edge.
94
- * Best for contextual content that benefits from seeing the underlying layout.
95
- * Less disruptive than dialog. Common for detail views on mobile.
96
- */
97
- SHEET = 'sheet',
98
- /**
99
- * Vaul-backed mobile drawer.
100
- * Use when the navigation resolver should choose a drawer directly rather
101
- * than relying on a dialog appearance plus mobileShape policy.
102
- */
103
- DRAWER = 'drawer',
104
- }
105
-
106
- /**
107
- * Visual presentation for split transitions.
108
- * Determines how adjacent zone content renders alongside the source zone.
109
- */
110
- export enum SplitAppearance {
111
- /**
112
- * Standard vertical side panel.
113
- * Content appears beside the source zone with a resizable divider.
114
- * Most common for list-detail patterns.
115
- */
116
- PANEL = 'panel',
117
- /**
118
- * Horizontal drawer (bottom panel).
119
- * Content appears below the source zone.
120
- * Used for companion panels like terminals, output logs, reference docs.
121
- */
122
- DRAWER = 'drawer',
123
- }
124
- ```
@@ -1,99 +0,0 @@
1
- # saas.models.navigation.transition-vocabulary
2
-
3
- ## Import Origins
4
-
5
- - `@wildo-ai/saas-models`
6
-
7
- ## Source Excerpts
8
-
9
- ### Origin Package: `@wildo-ai/saas-models`
10
-
11
- ```typescript
12
- */
13
- export enum NavigationTransition {
14
- /**
15
- * Content added to the zone's stack (single) or as a new tab (tabbed).
16
- * Back navigation pops the stack or switches to the previous tab.
17
- * URL adds a new path segment.
18
- */
19
- PUSH = 'push',
20
- /**
21
- * Content replaces the current content in the zone. No stack entry — the previous
22
- * content is gone from the zone's state (but remains in browser history).
23
- * URL replaces the current segment.
24
- */
25
- REPLACE = 'replace',
26
- /**
27
- * Content opens in an adjacent zone (secondary or companion).
28
- * Creates a side-by-side layout. The source zone's content remains visible.
29
- * Back navigation un-splits (closes the adjacent zone).
30
- * URL adds a split segment.
31
- */
32
- SPLIT = 'split',
33
- /**
34
- * Content opens in a floating layer above the entire layout (dialog, sheet, or drawer).
35
- * The underlying layout remains visible but non-interactive.
36
- * Back navigation or Escape dismisses the overlay.
37
- * URL adds an overlay param/hash.
38
- */
39
- OVERLAY = 'overlay',
40
- /**
41
- * Element-level transformation within the current view. A specific item in a
42
- * list/section transforms from one mode to another (read → edit); a CREATE
43
- * materializes a new element beside the existing ones. The parent view stays,
44
- * the zone stack is unchanged, and surrounding items remain visible.
45
- *
46
- * Fundamentally different from `replace` (which swaps the entire zone content).
47
- * `inplace` operates at the element level, not the zone level.
48
- *
49
- * No lifecycle modifiers (`persistent`/`ephemeral`) are valid on `inplace`.
50
- * No appearance to configure — the element transforms within its existing slot.
51
- *
52
- * **It is the one transition that does not place content in a zone**, which is
53
- * why the controller hands it to the element-level host
54
- * (`InPlaceOperationContext`) instead of resolving a target zone for it. That
55
- * host is provided by the COLLECTION the element belongs to, so a transition
56
- * resolving to `inplace` on a surface with no collection above it — a detail
57
- * page, a breadcrumb, a picker — degrades to an OVERLAY.
58
- *
59
- * **It is TRANSIENT: no URL, and a reload returns the view to rest.** Earlier
60
- * revisions of this comment promised a query param (`?editing=<childId>` /
61
- * `?creating=<resourceType>`) and none was ever written. It is not written now
62
- * either, and that is a decision rather than an omission: an inline row-edit is
63
- * a momentary state of a listing, not a place — no comparable admin framework
64
- * deep-links one, and anything that should survive a reload or a back button
65
- * wants `push`. `ResourceOperationActionPresentation.INLINE`, the per-operation
66
- * tier that selects the same host, is transient for the same reason.
67
- *
68
- * @example
69
- * // Click "edit" on a child in parent's inline section → item transforms to edit form
70
- * transitions: { [CoreResourceOperation.UPDATE]: NavigationTransition.INPLACE }
71
- *
72
- * // Click "add" in a relationship section → create form appears inline in the list
73
- * transitions: { [CoreResourceOperation.CREATE]: NavigationTransition.INPLACE }
74
- */
75
- INPLACE = 'inplace',
76
- /**
77
- * Escape the current context and open content at primary scope.
78
- * Abandons the current context: overlays close, companion/secondary dismiss.
79
- * The promoted content becomes the primary zone's top content.
80
- *
81
- * Use case: a link within an overlay should open as a full primary view,
82
- * or a nested detail in a companion zone should "pop out" to primary.
83
- *
84
- * Fundamentally different from `push` (which stays in the current zone) and
85
- * from `replace` (which replaces content within the same zone). `promote`
86
- * crosses zones and always targets primary.
87
- *
88
- * No lifecycle modifiers (`persistent`/`ephemeral`) are valid on `promote`.
89
- * No appearance to configure — content fills primary (same as push/replace).
90
- *
91
- * URL serialization: full URL change (promoted resource becomes the primary route).
92
- *
93
- * @example
94
- * // From an overlay, a link should open as primary (close overlay, show in primary)
95
- * transitions: { [CoreResourceOperation.READ]: NavigationTransition.PROMOTE }
96
- */
97
- PROMOTE = 'promote',
98
- }
99
- ```
@@ -1,127 +0,0 @@
1
- # saas.models.navigation.zone-declaration
2
-
3
- ## Import Origins
4
-
5
- - `@wildo-ai/saas-models`
6
-
7
- ## Source Excerpts
8
-
9
- ### Origin Package: `@wildo-ai/saas-models`
10
-
11
- ```typescript
12
- *
13
- * What happens when a zone's last content is dismissed.
14
- * Only meaningful for secondary and companion zones (primary never empties,
15
- * overlay auto-dismisses by definition).
16
- */
17
- export enum ZoneEmptyBehavior {
18
- /**
19
- * Zone hides, adjacent zones expand to fill the space.
20
- * Example: closing the last detail → layout returns to list-only.
21
- * This is the default for all non-primary zones.
22
- */
23
- COLLAPSE = 'collapse',
24
- /**
25
- * Zone stays visible with an empty-state placeholder.
26
- * Example: "Select an item to view details" message. Keeps layout stable.
27
- * Useful when the user frequently toggles between items.
28
- */
29
- EMPTY_STATE = 'emptyState',
30
- }
31
- ```
32
-
33
- ### Origin Package: `@wildo-ai/saas-models`
34
-
35
- ```typescript
36
- *
37
- * How much of its zone a DESTINATION's content occupies.
38
- *
39
- * The primary zone caps and centres its content at `var(--content-max-width, 80rem)` and gives it no
40
- * definite-height ancestor. That is correct for almost everything a zone hosts — a form, a list, a
41
- * settings page stretched across a 2560px monitor is unreadable — and wrong for content whose whole
42
- * value is the space it occupies. Until this enum existed there was no way to tell the two apart, so
43
- * a canvas had to hand-roll a viewport fraction (`h-[70vh]`), which sizes against the WINDOW rather
44
- * than the container and therefore ignores whatever chrome sits above it.
45
- *
46
- * Declared per DESTINATION rather than per zone: the same primary zone hosts a list that wants the
47
- * cap, a detail page that caps itself, and a graph that wants neither.
48
- *
49
- * Width and height are separable on purpose. A wide data table wants the cap gone and its natural
50
- * height; collapsing both into one boolean would merge two meanings, and two independent booleans
51
- * would make "full height, still capped at 80rem" representable — a combination nothing wants and
52
- * someone would eventually author by accident.
53
- */
54
-
55
- /**
56
- * Full zone configuration.
57
- *
58
- * Each declared zone in the layout owns its complete behavior:
59
- * which transition fires for each operation, how content appears,
60
- * and how the zone responds to viewport changes.
61
- *
62
- * Note: `minWidth`, `maxWidth`, `defaultVisible`, `onEmpty`,
63
- * and `responsiveCollapse` are only meaningful for secondary and companion zones.
64
- * Primary never collapses, never empties, and takes remaining space.
65
- * Setting these on primary has no effect.
66
- */
67
- export const ZoneConfigSchema = z.object({
68
- /**
69
- * How this zone manages multiple items.
70
- * - `NavigationZoneContentModel.SINGLE` (default): stack-based navigation. One item visible, back pops.
71
- * - `NavigationZoneContentModel.TABBED`: parallel tabs. Tab bar visible, multiple items accessible.
72
- * @default NavigationZoneContentModel.SINGLE
73
- */
74
- contentModel: z.enum(NavigationZoneContentModel).default(NavigationZoneContentModel.SINGLE),
75
-
76
- /** Operation → transition mapping. Defines what happens for each user action in this zone. */
77
- transitions: ZoneTransitionsSchema,
78
-
79
- /** Transition → visual appearance. Only split and overlay have appearance choices. */
80
- appearance: ZoneAppearanceSchema.optional(),
81
-
82
- /**
83
- * Minimum pixel width when resizing. Constrains how far this side of the
84
- * split divider can be dragged. Only meaningful for secondary and companion zones.
85
- * Works in conjunction with `SplitConfigSchema.resizable`.
86
- */
87
- minWidth: z.number().positive().optional(),
88
-
89
- /**
90
- * Maximum pixel width when resizing. Constrains how far this side of the
91
- * split divider can be dragged. Only meaningful for secondary and companion zones.
92
- * Works in conjunction with `SplitConfigSchema.resizable`.
93
- */
94
- maxWidth: z.number().positive().optional(),
95
-
96
- /**
97
- * Whether this zone is visible on first render (before any transition targets it).
98
- * - Primary: always visible (this field is ignored).
99
- * - Secondary: defaults to `true` when `split.autoSplit` is `true`, `false` otherwise.
100
- * - Companion: defaults to `false` (hidden until a `split` transition targets it or user toggles).
101
- */
102
- defaultVisible: z.boolean().optional(),
103
-
104
- /**
105
- * What happens when this zone's last content is dismissed (stack empty, last tab closed).
106
- * - `ZoneEmptyBehavior.COLLAPSE` (default): zone hides, adjacent zones expand to fill.
107
- * - `ZoneEmptyBehavior.EMPTY_STATE`: zone stays visible with placeholder ("Select an item to view details").
108
- * Only meaningful for secondary and companion zones. Primary never empties.
109
- */
110
- onEmpty: z.enum(ZoneEmptyBehavior).optional(),
111
-
112
- /**
113
- * Responsive collapse rules: what happens when viewport shrinks below the zone's breakpoint.
114
- * Accepts a plain `ResponsiveCollapseMode` (all breakpoints) or viewport-discriminated object.
115
- * Only meaningful for secondary and companion zones. Primary never collapses.
116
- *
117
- * When viewport grows back past the breakpoint, collapsed content migrates back
118
- * to its original zone (content is preserved).
119
- *
120
- * @example
121
- * responsiveCollapse: ResponsiveCollapseMode.PUSH // always push into primary
122
- * responsiveCollapse: { [ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH, [ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.OVERLAY } // tablet: push, mobile: overlay
123
- */
124
- responsiveCollapse: viewportDiscriminatedSchema(z.enum(ResponsiveCollapseMode)).optional(),
125
- });
126
- export type ZoneConfig = z.infer<typeof ZoneConfigSchema>;
127
- ```
@@ -1,42 +0,0 @@
1
- # saas.models.resource-config.operation-variant-client-timeout
2
-
3
- ## Import Origins
4
-
5
- - `@wildo-ai/saas-models`
6
-
7
- ## Source Excerpts
8
-
9
- ### Origin Package: `@wildo-ai/saas-models`
10
-
11
- ```typescript
12
- *
13
- * Frontend HTTP timeout for THIS variant, in milliseconds — declare it on any operation whose
14
- * synchronous round trip legitimately outlives the frontend client's 30-second default (an
15
- * operation that calls a model and waits for the answer, a long import, a blocking generation).
16
- *
17
- * The frontend resources client applies it as the per-request timeout on every dispatch shape
18
- * (api-call, api-call-with-callback, search). An explicit caller-supplied
19
- * `RequestOptions.timeout` still wins; omitting the field keeps the client default.
20
- *
21
- * Why it matters: without it, a long-running operation's request is aborted CLIENT-side while
22
- * the server work succeeds — the caller renders a network error, and the operation-success
23
- * refresh chain never fires, so lists keep showing the pre-operation world. Declare the
24
- * expectation on the variant (the operation knows it is long-running); do not hard-code
25
- * timeouts in consumer hooks, which duplicates that knowledge at every call site.
26
- *
27
- * This is a TRANSPORT expectation only — not a UI/observability signal (that is `riskLevel`)
28
- * and not a server-side bound: the backend is free to answer sooner or be cut off by its own
29
- * limits.
30
- *
31
- * @example a custom operation that generates a document before answering
32
- * variants: [{
33
- * variantType: ResourceOperationVariantType.API_CALL,
34
- * roles: [CORE_ORG_ROLES.ORG_MEMBER],
35
- * riskLevel: ResourceOperationRiskLevel.MEDIUM,
36
- * clientRequestTimeoutMs: 300_000, // five minutes — the generation is synchronous
37
- * requestDto: GenerateReportRequest_Schema,
38
- * customResponseDto: GenerateReportOutcome_Schema,
39
- * }]
40
- */
41
- clientRequestTimeoutMs?: number;
42
- ```
@@ -1,29 +0,0 @@
1
- # saas.specifications.application-authored-document-fact-specification.contract
2
-
3
- ## Import Origins
4
-
5
- - `@wildo-ai/saas-specifications`
6
-
7
- ## Source Excerpts
8
-
9
- ### Origin Package: `@wildo-ai/saas-specifications`
10
-
11
- ```typescript
12
- *
13
- * Accepted application declaration of governed-document facts ONLY A HUMAN MAY ESTABLISH — a creator's
14
- * decision, or a qualified review. Import from
15
- * `@wildo-ai/saas-specifications/application-creation`.
16
- *
17
- * Structurally identical to {@link ApplicationDocumentFactSpecificationSchema}: a declaration is a
18
- * declaration whoever wrote it, and a document reading facts does not care which file one came from.
19
- * The two are separate FAMILIES so that neither writer can destroy the other's half — the derived file
20
- * is regenerated by a producer, this one is only ever edited by a person or by a host acting on a
21
- * person's answers.
22
- *
23
- * Nothing in here may carry `APPLICATION_SPECIFICATION` authority. A fact the specification can answer
24
- * belongs in the derived family, where it is re-derived when the specification moves; pinning it here
25
- * would freeze yesterday's answer under a human's name.
26
- */
27
- export const ApplicationAuthoredDocumentFactSpecificationSchema = buildDocumentFactSpecificationSchema(ApplicationAuthoredDocumentFactDeclarationSchema);
28
- export type ApplicationAuthoredDocumentFactSpecification = z.infer<typeof ApplicationAuthoredDocumentFactSpecificationSchema>;
29
- ```