@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
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.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md
CHANGED
|
@@ -32,7 +32,6 @@ export enum BackingServiceKind {
|
|
|
32
32
|
RABBITMQ = 'rabbitmq',
|
|
33
33
|
S3 = 's3',
|
|
34
34
|
POSTGRESQL = 'postgresql',
|
|
35
|
-
GOTENBERG = 'gotenberg',
|
|
36
35
|
CLAMAV = 'clamav',
|
|
37
36
|
/**
|
|
38
37
|
* immudb — an immutable, cryptographically-verifiable database used as a
|
|
@@ -40,11 +39,6 @@ export enum BackingServiceKind {
|
|
|
40
39
|
* A stateful DB: a data volume in dev, self-hosted or immudb Vault in prod.
|
|
41
40
|
*/
|
|
42
41
|
IMMUDB = 'immudb',
|
|
43
|
-
/**
|
|
44
|
-
* Metrics / telemetry sink (Prometheus, DataDog, OpenTelemetry, …).
|
|
45
|
-
* Stateless base for now.
|
|
46
|
-
*/
|
|
47
|
-
METRICS = 'metrics-telemetry',
|
|
48
42
|
/**
|
|
49
43
|
* Backup orchestration target. Stateless base for now.
|
|
50
44
|
*/
|
|
@@ -190,10 +184,6 @@ export const S3BackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
|
190
184
|
}).strict();
|
|
191
185
|
export type S3BackingService = z.infer<typeof S3BackingServiceSchema>;
|
|
192
186
|
|
|
193
|
-
/** Gotenberg PDF service. Stateless, no database/vhost/bucket. */
|
|
194
|
-
export const GotenbergBackingServiceSchema = BackingServiceBaseSchema;
|
|
195
|
-
export type GotenbergBackingService = z.infer<typeof GotenbergBackingServiceSchema>;
|
|
196
|
-
|
|
197
187
|
/** ClamAV anti-virus daemon. Stateless, no database/vhost/bucket. */
|
|
198
188
|
export const ClamAvBackingServiceSchema = BackingServiceBaseSchema;
|
|
199
189
|
export type ClamAvBackingService = z.infer<typeof ClamAvBackingServiceSchema>;
|
|
@@ -225,13 +215,6 @@ export const ImmudbBackingServiceSchema = BackingServiceBaseSchema.extend({
|
|
|
225
215
|
}).strict();
|
|
226
216
|
export type ImmudbBackingService = z.infer<typeof ImmudbBackingServiceSchema>;
|
|
227
217
|
|
|
228
|
-
/**
|
|
229
|
-
* Metrics / telemetry sink (Prometheus / DataDog / OpenTelemetry / …).
|
|
230
|
-
* Stateless base for now.
|
|
231
|
-
*/
|
|
232
|
-
export const MetricsBackingServiceSchema = BackingServiceBaseSchema;
|
|
233
|
-
export type MetricsBackingService = z.infer<typeof MetricsBackingServiceSchema>;
|
|
234
|
-
|
|
235
218
|
/**
|
|
236
219
|
* Backup orchestration target. Stateless base for now.
|
|
237
220
|
*/
|
|
@@ -251,10 +234,8 @@ export type BackingServiceEnvConfig =
|
|
|
251
234
|
| PostgresBackingService
|
|
252
235
|
| RabbitBackingService
|
|
253
236
|
| S3BackingService
|
|
254
|
-
| GotenbergBackingService
|
|
255
237
|
| ClamAvBackingService
|
|
256
238
|
| ImmudbBackingService
|
|
257
|
-
| MetricsBackingService
|
|
258
239
|
| BackupBackingService;
|
|
259
240
|
|
|
260
241
|
/**
|
|
@@ -272,11 +253,183 @@ export const BackingServicesEnvConfigSchema = z.object({
|
|
|
272
253
|
[BackingServiceKind.RABBITMQ]: RabbitBackingServiceSchema.optional(),
|
|
273
254
|
[BackingServiceKind.S3]: S3BackingServiceSchema.optional(),
|
|
274
255
|
[BackingServiceKind.POSTGRESQL]: PostgresBackingServiceSchema.optional(),
|
|
275
|
-
[BackingServiceKind.GOTENBERG]: GotenbergBackingServiceSchema.optional(),
|
|
276
256
|
[BackingServiceKind.CLAMAV]: ClamAvBackingServiceSchema.optional(),
|
|
277
257
|
[BackingServiceKind.IMMUDB]: ImmudbBackingServiceSchema.optional(),
|
|
278
|
-
[BackingServiceKind.METRICS]: MetricsBackingServiceSchema.optional(),
|
|
279
258
|
[BackingServiceKind.BACKUP]: BackupBackingServiceSchema.optional(),
|
|
280
259
|
}).strict();
|
|
281
260
|
export type BackingServicesEnvConfig = z.infer<typeof BackingServicesEnvConfigSchema>;
|
|
282
261
|
```
|
|
262
|
+
|
|
263
|
+
## Which `(kind, source, provider)` combinations actually resolve
|
|
264
|
+
|
|
265
|
+
The dispatch table the note above calls the canonical brand vocabulary, plus what happens to a
|
|
266
|
+
combination it does not cover.
|
|
267
|
+
|
|
268
|
+
## Import Origins
|
|
269
|
+
|
|
270
|
+
- `@wildo-ai/platform-config-lib`
|
|
271
|
+
|
|
272
|
+
## Source Excerpts
|
|
273
|
+
|
|
274
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
275
|
+
|
|
276
|
+
```typescript
|
|
277
|
+
/**
|
|
278
|
+
* `BackingServiceKind` → `InfraCapability`. Every extension to `BackingServiceKind` MUST extend this
|
|
279
|
+
* map in the same commit, otherwise the planner cannot project the new kind to its capability slot.
|
|
280
|
+
*
|
|
281
|
+
* INJECTIVE, not bijective — and the difference is a real property of the model rather than a gap.
|
|
282
|
+
* A capability may be granted to a runtime without any environment declaring a backing service for
|
|
283
|
+
* it; see {@link RUNTIME_GRANTED_INFRA_CAPABILITIES} for the ones that are, and why.
|
|
284
|
+
*/
|
|
285
|
+
export const BackingServiceKindToInfraCapability: Record<BackingServiceKind, InfraCapability> = {
|
|
286
|
+
[BackingServiceKind.MONGODB]: InfraCapability.DOCUMENT_DATABASE,
|
|
287
|
+
[BackingServiceKind.POSTGRESQL]: InfraCapability.RELATIONAL_DATABASE,
|
|
288
|
+
[BackingServiceKind.RABBITMQ]: InfraCapability.QUEUING_SYSTEM,
|
|
289
|
+
[BackingServiceKind.REDIS]: InfraCapability.CACHE_MANAGER,
|
|
290
|
+
[BackingServiceKind.S3]: InfraCapability.OBJECT_STORAGE,
|
|
291
|
+
[BackingServiceKind.CLAMAV]: InfraCapability.ANTIVIRUS_SCANNING,
|
|
292
|
+
[BackingServiceKind.IMMUDB]: InfraCapability.AUDIT_LOG_STORAGE,
|
|
293
|
+
[BackingServiceKind.BACKUP]: InfraCapability.BACKUP_MANAGER,
|
|
294
|
+
};
|
|
295
|
+
|
|
296
|
+
/**
|
|
297
|
+
* Project `(BackingServiceKind, source, provider?)` → `InfraProvider`.
|
|
298
|
+
*
|
|
299
|
+
* The three-axis dispatch (kind × hosting-model × brand) generalizes
|
|
300
|
+
* the source/brand split across all kinds (Slice 4.B.0, 2026-05-07
|
|
301
|
+
* — was source-only with Atlas as a special source value before).
|
|
302
|
+
*
|
|
303
|
+
* **Brand vocabulary** per kind (`provider` field on the authored
|
|
304
|
+
* `BackingService<X>Schema`):
|
|
305
|
+
*
|
|
306
|
+
* | Kind | source | provider | InfraProvider |
|
|
307
|
+
* |---|---|---|---|
|
|
308
|
+
* | `MONGODB` | `SELF` | (any) | `MONGODB_SELF` |
|
|
309
|
+
* | `MONGODB` | `MANAGED` | `'atlas'` | `MONGODB_ATLAS` |
|
|
310
|
+
* | `POSTGRESQL` | `SELF` | (any) | `POSTGRES_SELF` |
|
|
311
|
+
* | `POSTGRESQL` | `MANAGED` | `'aws-rds'` | `POSTGRES_AWS_RDS` |
|
|
312
|
+
* | `POSTGRESQL` | `MANAGED` | `'gcp-cloud-sql'` | `POSTGRES_GCP_CLOUD_SQL` |
|
|
313
|
+
* | `POSTGRESQL` | `MANAGED` | `'azure-database'` | `POSTGRES_AZURE_DATABASE` |
|
|
314
|
+
* | `POSTGRESQL` | `MANAGED` | `'supabase'` | `POSTGRES_SUPABASE` |
|
|
315
|
+
* | `POSTGRESQL` | `MANAGED` | `'neon'` | `POSTGRES_NEON` |
|
|
316
|
+
* | `POSTGRESQL` | `MANAGED` | `'render'` | `POSTGRES_RENDER` |
|
|
317
|
+
* | `POSTGRESQL` | `MANAGED` | unset or unrecognized | `POSTGRES_MANAGED` (generic fallback) |
|
|
318
|
+
* | `REDIS` | `SELF` | (any) | `REDIS_SELF` |
|
|
319
|
+
* | `RABBITMQ` | `SELF` | (any) | `RABBITMQ_SELF` |
|
|
320
|
+
* | `S3` | (either) | `'minio'` | `MINIO_SELF` |
|
|
321
|
+
* | `S3` | (either) | `'aws'` | `AWS_S3` |
|
|
322
|
+
* | `S3` | `SELF` | unset or unrecognized | `MINIO_SELF` |
|
|
323
|
+
* | `S3` | `MANAGED` | unset or unrecognized | `AWS_S3` |
|
|
324
|
+
* | `CLAMAV` | `SELF` | (any) | `CLAMAV_SELF` |
|
|
325
|
+
* | `IMMUDB` | `SELF` | (any) | `IMMUDB_SELF` |
|
|
326
|
+
*
|
|
327
|
+
* Returns `undefined` for combinations not in the table — for kinds
|
|
328
|
+
* whose `InfraProvider` catalog has no concrete entry yet (BACKUP)
|
|
329
|
+
* and for unrecognized managed Mongo brands. PostgreSQL has a generic
|
|
330
|
+
* managed fallback; S3 uses brand-first resolution, then source-based defaults. Callers decide whether `undefined` is fail-closed
|
|
331
|
+
* (planner running with unknown infra catalog) or accepted (lockfile
|
|
332
|
+
* pre-declaration).
|
|
333
|
+
*
|
|
334
|
+
* ## What this means when you author an environment
|
|
335
|
+
*
|
|
336
|
+
* **`MANAGED` does not reach every kind.** The table above is the whole of it: a managed vendor
|
|
337
|
+
* resolves for the relational database (six named brands plus a generic fallback), the document
|
|
338
|
+
* database (`'atlas'` only) and object storage. Declaring `{ source: MANAGED }` on the cache, the
|
|
339
|
+
* broker, the antivirus scanner, the audit store or the backup target resolves to NOTHING — those
|
|
340
|
+
* kinds are self-hosted only until their vendor catalogue is built.
|
|
341
|
+
*
|
|
342
|
+
* **And nothing tells you.** A kind that resolves to no provider is SKIPPED when the lockfile's infra
|
|
343
|
+
* section is materialised, silently, because recording an entry with no provider would lie. So a
|
|
344
|
+
* managed declaration the catalogue cannot serve looks exactly like a correct one: `wildo config
|
|
345
|
+
* sync` succeeds, the file says `MANAGED`, and the environment has no managed anything. Read the
|
|
346
|
+
* lockfile's infra section to see which of your declarations were actually resolved.
|
|
347
|
+
*
|
|
348
|
+
* **An unrecognised brand is not the same failure on every kind.** On the relational database it
|
|
349
|
+
* falls back to the generic managed entry, so a typo still resolves. On the document database,
|
|
350
|
+
* an unknown managed brand resolves to nothing. Object storage recognizes minio/aws first, then
|
|
351
|
+
* falls back by source: SELF to MinIO, MANAGED to AWS S3, including unrecognized brands.
|
|
352
|
+
*
|
|
353
|
+
* **Provider resolution and workload inclusion answer different questions.** Compose and Kubernetes
|
|
354
|
+
* both use the same per-kind inclusion policy, separately from catalogue resolution. Cache, broker
|
|
355
|
+
* and S3 default to self-hosted unless explicitly MANAGED; ClamAV and immudb require explicit SELF.
|
|
356
|
+
* MongoDB and PostgreSQL also include the platform database requirement: an application-level
|
|
357
|
+
* managed choice does not remove a self-hosted database still needed by the platform. Backup has
|
|
358
|
+
* no rendered workload. Do not infer workload inclusion from this provider resolver.
|
|
359
|
+
*/
|
|
360
|
+
export function resolveInfraProvider(
|
|
361
|
+
kind: BackingServiceKind,
|
|
362
|
+
source: BackingServiceSource,
|
|
363
|
+
provider?: string,
|
|
364
|
+
): InfraProvider | undefined {
|
|
365
|
+
switch (kind) {
|
|
366
|
+
case BackingServiceKind.MONGODB:
|
|
367
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.MONGODB_SELF;
|
|
368
|
+
if (source === BackingServiceSource.MANAGED && provider === 'atlas') return InfraProvider.MONGODB_ATLAS;
|
|
369
|
+
// Other Mongo managed brands (e.g., AWS DocumentDB) — extend
|
|
370
|
+
// the `InfraProvider` enum + this branch in the same slice
|
|
371
|
+
// that adds the first concrete consumer.
|
|
372
|
+
return undefined;
|
|
373
|
+
case BackingServiceKind.POSTGRESQL:
|
|
374
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.POSTGRES_SELF;
|
|
375
|
+
if (source === BackingServiceSource.MANAGED) {
|
|
376
|
+
switch (provider) {
|
|
377
|
+
case 'aws-rds': return InfraProvider.POSTGRES_AWS_RDS;
|
|
378
|
+
case 'gcp-cloud-sql': return InfraProvider.POSTGRES_GCP_CLOUD_SQL;
|
|
379
|
+
case 'azure-database': return InfraProvider.POSTGRES_AZURE_DATABASE;
|
|
380
|
+
case 'supabase': return InfraProvider.POSTGRES_SUPABASE;
|
|
381
|
+
case 'neon': return InfraProvider.POSTGRES_NEON;
|
|
382
|
+
case 'render': return InfraProvider.POSTGRES_RENDER;
|
|
383
|
+
// Generic fallback when the operator has authored
|
|
384
|
+
// `source: MANAGED` without naming a brand (or with an
|
|
385
|
+
// unrecognized brand). Acceptable while the brand catalog
|
|
386
|
+
// is incomplete — the lockfile records `POSTGRES_MANAGED`
|
|
387
|
+
// and the planner can still emit env vars + compose
|
|
388
|
+
// contributions; brand-specific runtime behavior is what
|
|
389
|
+
// the named-brand modules (Slice 4.B+) layer on top.
|
|
390
|
+
default: return InfraProvider.POSTGRES_MANAGED;
|
|
391
|
+
}
|
|
392
|
+
}
|
|
393
|
+
return undefined;
|
|
394
|
+
case BackingServiceKind.REDIS:
|
|
395
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.REDIS_SELF;
|
|
396
|
+
// Managed Redis brands (ElastiCache, Upstash, Redis Cloud, …)
|
|
397
|
+
// — not catalogued yet; future expansion.
|
|
398
|
+
return undefined;
|
|
399
|
+
case BackingServiceKind.RABBITMQ:
|
|
400
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.RABBITMQ_SELF;
|
|
401
|
+
// Managed RabbitMQ brands (CloudAMQP, AWS MQ, …) —
|
|
402
|
+
// not catalogued yet; future expansion.
|
|
403
|
+
return undefined;
|
|
404
|
+
case BackingServiceKind.S3:
|
|
405
|
+
// S3 dispatch is brand-first because the protocol is
|
|
406
|
+
// standardized (S3-compatible) and the same `source` can host
|
|
407
|
+
// multiple software stacks — `source: SELF` could be MinIO or
|
|
408
|
+
// a self-managed AWS S3 cluster (theoretically). The brand is
|
|
409
|
+
// the canonical disambiguator.
|
|
410
|
+
if (provider === 'minio') return InfraProvider.MINIO_SELF;
|
|
411
|
+
if (provider === 'aws') return InfraProvider.AWS_S3;
|
|
412
|
+
// Default source-based mapping for unbranded S3 — MinIO is
|
|
413
|
+
// the canonical self-hosted; AWS is the canonical managed.
|
|
414
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.MINIO_SELF;
|
|
415
|
+
if (source === BackingServiceSource.MANAGED) return InfraProvider.AWS_S3;
|
|
416
|
+
return undefined;
|
|
417
|
+
case BackingServiceKind.CLAMAV:
|
|
418
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.CLAMAV_SELF;
|
|
419
|
+
return undefined;
|
|
420
|
+
case BackingServiceKind.IMMUDB:
|
|
421
|
+
if (source === BackingServiceSource.SELF) return InfraProvider.IMMUDB_SELF;
|
|
422
|
+
// Managed immudb (immudb Vault) — not catalogued yet; future expansion.
|
|
423
|
+
return undefined;
|
|
424
|
+
case BackingServiceKind.BACKUP:
|
|
425
|
+
// No concrete `InfraProvider` declared yet for this kind. Extend the `InfraProvider` enum +
|
|
426
|
+
// this branch in the same slice that introduces the first concrete provider for it.
|
|
427
|
+
//
|
|
428
|
+
// `METRICS` was the other kind here and was WITHDRAWN 2026-09-09: telemetry is authored at
|
|
429
|
+
// `observability.telemetry` and its auth header derived from the selected
|
|
430
|
+
// `OBSERVABILITY_TELEMETRY` provider, so a backing-service kind was a third declaration
|
|
431
|
+
// surface that nothing read. See `RUNTIME_GRANTED_INFRA_CAPABILITIES`.
|
|
432
|
+
return undefined;
|
|
433
|
+
}
|
|
434
|
+
}
|
|
435
|
+
```
|
|
@@ -53,10 +53,85 @@ export function isLocalEnvironmentId(environmentId: string): boolean {
|
|
|
53
53
|
return environmentId === WildoEnvironment.LOCAL;
|
|
54
54
|
}
|
|
55
55
|
|
|
56
|
+
/**
|
|
57
|
+
* Where a docker-compose backing service keeps its DATA.
|
|
58
|
+
*
|
|
59
|
+
* The two members are not a performance knob with a fast and a slow setting — they answer a
|
|
60
|
+
* question about ownership, and the cost follows from the answer:
|
|
61
|
+
*
|
|
62
|
+
* - `HOST_PATH` — the data lives at an explicit path on the host
|
|
63
|
+
* (`<saas-root>/.wildo-saas/local_data/<service>/`), bind-mounted into the container. The
|
|
64
|
+
* operator chooses the disk, backups target a known directory, and the tree is the same one the
|
|
65
|
+
* Kind k8s lane hostPath-mounts at `/mnt/local-data/<service>/`. That control is why it is the
|
|
66
|
+
* REMOTE default: a production operator who has provisioned a dedicated data volume must be able
|
|
67
|
+
* to put the database on it, and a named volume would silently land it under
|
|
68
|
+
* `/var/lib/docker/volumes/` on the root disk.
|
|
69
|
+
* - `DOCKER_VOLUME` — the data lives in a Docker named volume, inside the container runtime's own
|
|
70
|
+
* storage. Nobody outside Docker addresses it, which is exactly what makes it right for a
|
|
71
|
+
* disposable development stack.
|
|
72
|
+
*
|
|
73
|
+
* ## Why LOCAL defaults to `DOCKER_VOLUME`
|
|
74
|
+
*
|
|
75
|
+
* On Linux a bind mount is a native path and costs nothing. On macOS and Windows the container
|
|
76
|
+
* runtime is a VM, and a host bind mount crosses a filesystem bridge — VirtioFS on macOS, 9p/
|
|
77
|
+
* VirtioFS through WSL2 on Windows. Databases do small fsync'd random writes, so every one of them
|
|
78
|
+
* becomes a round trip out of the VM.
|
|
79
|
+
*
|
|
80
|
+
* Measured on macOS (Apple Virtualization, 6 vCPU) on 2026-09-22 with the eight self-hosted backing
|
|
81
|
+
* services bind-mounted: the VM process held **13,786 host file descriptors** open across 14,168
|
|
82
|
+
* files and burned **383% CPU** in Docker Desktop's file-sharing process — sustained, a 321%
|
|
83
|
+
* average over 2 days 5 hours — while the containers themselves used 0.7 of a core and container
|
|
84
|
+
* block-IO accounting stayed flat, because none of that traffic reaches the VM's own block device.
|
|
85
|
+
* Roughly four cores of pure filesystem translation for 0.7 of a core of database work.
|
|
86
|
+
*
|
|
87
|
+
* The default is uniform across all three development operating systems rather than "volumes on
|
|
88
|
+
* macOS and Windows, host paths on Linux", so every developer and CI run exercise the same stack
|
|
89
|
+
* and a bug reproduces the same way everywhere. It costs a Linux developer nothing: a named volume
|
|
90
|
+
* is a native directory there too.
|
|
91
|
+
*
|
|
92
|
+
* Both members are authorable per environment (`localDataStorage`), so a remote operator who wants
|
|
93
|
+
* volumes and a local developer who wants to read the files from their file manager each say so.
|
|
94
|
+
*
|
|
95
|
+
* NOTE this governs DATA directories only. The two small secret FILES compose mounts read-only —
|
|
96
|
+
* immudb's state-signing key and mongot's sync-source password — are materialized from
|
|
97
|
+
* `secrets.json` onto the host and stay host mounts under every mode. They are read once at
|
|
98
|
+
* startup, so they carry none of the cost above, and they have nowhere else to come from.
|
|
99
|
+
*/
|
|
100
|
+
export enum WildoLocalDataStorage {
|
|
101
|
+
DOCKER_VOLUME = 'docker-volume',
|
|
102
|
+
HOST_PATH = 'host-path',
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* The `localDataStorage` an environment gets when it authors none.
|
|
107
|
+
*
|
|
108
|
+
* Total over {@link WildoLocationType} rather than a conditional on one member, so a location type
|
|
109
|
+
* added to the vocabulary tomorrow is a compile error here instead of silently inheriting whichever
|
|
110
|
+
* branch happened to be the `else`.
|
|
111
|
+
*/
|
|
112
|
+
export function resolveDefaultLocalDataStorage(locationType: WildoLocationType): WildoLocalDataStorage {
|
|
113
|
+
switch (locationType) {
|
|
114
|
+
case WildoLocationType.LOCAL:
|
|
115
|
+
return WildoLocalDataStorage.DOCKER_VOLUME;
|
|
116
|
+
case WildoLocationType.REMOTE:
|
|
117
|
+
return WildoLocalDataStorage.HOST_PATH;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Ingress controller installed by Wildo's local and remote Kubernetes workflows.
|
|
123
|
+
* Import from `@wildo-ai/platform-config-lib`. Traefik owns both application
|
|
124
|
+
* routing and HTTP-01 challenge routing; selecting another controller is not
|
|
125
|
+
* supported by the generated installation contract.
|
|
126
|
+
*/
|
|
127
|
+
export enum WildoKubernetesIngressClass {
|
|
128
|
+
TRAEFIK = 'traefik',
|
|
129
|
+
}
|
|
130
|
+
|
|
56
131
|
/**
|
|
57
132
|
* K8s-internal cluster topology. Holds ONLY values that are genuinely
|
|
58
|
-
* specific to a Kubernetes deployment
|
|
59
|
-
*
|
|
133
|
+
* specific to a Kubernetes deployment: namespace, ingress class and
|
|
134
|
+
* per-service workload replica counts.
|
|
60
135
|
*
|
|
61
136
|
* The external/public hostname (where browsers and reverse proxies hit
|
|
62
137
|
* us) is NOT here — it lives at the top level of `WildoInfraEnvConfig`
|
|
@@ -67,7 +142,19 @@ export function isLocalEnvironmentId(environmentId: string): boolean {
|
|
|
67
142
|
*/
|
|
68
143
|
export const WildoKubernetesConfigSchema = z.object({
|
|
69
144
|
namespace: z.string().min(1),
|
|
70
|
-
|
|
145
|
+
/**
|
|
146
|
+
* Workload replica overrides keyed by authored SaaS service key (for example
|
|
147
|
+
* backendApi, app or website), never by generated image/deployment name.
|
|
148
|
+
* Platform service keys have their own renderer. Worker replicas remain in
|
|
149
|
+
* the worker declaration; a key without a generated application target is
|
|
150
|
+
* reported by application deployment generation rather than guessed.
|
|
151
|
+
*/
|
|
152
|
+
services: z.record(z.string(), InfraServiceK8sSchema).optional(),
|
|
153
|
+
// Derive the literal from the named runtime vocabulary while accepting the
|
|
154
|
+
// natural authored spelling `ingressClass: 'traefik'` without an enum import.
|
|
155
|
+
ingressClass: z.literal(`${WildoKubernetesIngressClass.TRAEFIK}`, {
|
|
156
|
+
error: 'Wildo Kubernetes deployments support ingressClass traefik only; omit the field or select traefik.',
|
|
157
|
+
}).optional(),
|
|
71
158
|
});
|
|
72
159
|
export type WildoKubernetesConfig = z.infer<typeof WildoKubernetesConfigSchema>;
|
|
73
160
|
|
|
@@ -184,16 +271,18 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
|
|
|
184
271
|
/**
|
|
185
272
|
* Per-environment external-provider SELECTION override (2026-07-10).
|
|
186
273
|
*
|
|
187
|
-
* The app-wide primary/
|
|
274
|
+
* The app-wide primary/substitute selection for an `EngineCapability` lives in
|
|
188
275
|
* `wildo.saas.config.ts` (`providers.scopes.backend.selection[capability]`) —
|
|
189
276
|
* a single value shared by every environment. This block lets an environment
|
|
190
|
-
* OVERRIDE that primary (and
|
|
277
|
+
* OVERRIDE that primary (and its substitutes) without touching the shared SaaS
|
|
191
278
|
* config, so e.g. LOCAL can select the non-sending `email-preview` provider
|
|
192
279
|
* for `EMAIL_TRANSACTIONAL` while staging/production keep `resend`.
|
|
193
280
|
*
|
|
194
281
|
* Semantics (mirrors the SaaS-side selection policy):
|
|
195
282
|
* - `primary` — the ref that wins for this capability in this environment.
|
|
196
|
-
* - `
|
|
283
|
+
* - `whenUnavailable` — ordered substitutes, used when a preceding ref is not AVAILABLE at
|
|
284
|
+
* resolution time (undeclared, disabled, unconfigured). NOT failover: nothing retries a
|
|
285
|
+
* second provider when a call to the first one fails.
|
|
197
286
|
*
|
|
198
287
|
* The referenced provider must still be DECLARED in
|
|
199
288
|
* `providers.scopes.backend.providers` and available for the capability — the
|
|
@@ -201,7 +290,7 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
|
|
|
201
290
|
* names an undeclared or capability-disabled provider resolves to nothing
|
|
202
291
|
* (same fail-closed behaviour as an equivalent SaaS-side selection). FAN_OUT
|
|
203
292
|
* capabilities ignore the override (every declared provider is active — a
|
|
204
|
-
* primary/
|
|
293
|
+
* primary/substitute is meaningless), matching the SaaS-side rule.
|
|
205
294
|
*
|
|
206
295
|
* `env-vars-builder` serializes this block to the `WILDO_PROVIDER_SELECTION_OVERRIDES`
|
|
207
296
|
* backend env var (JSON); `ExternalProvidersRegistryBackendService` reads it and
|
|
@@ -211,7 +300,7 @@ export type WildoObservabilityConfig = z.infer<typeof WildoObservabilityConfigSc
|
|
|
211
300
|
*/
|
|
212
301
|
export const WildoProviderSelectionOverrideEntrySchema = z.strictObject({
|
|
213
302
|
primary: z.string().min(1),
|
|
214
|
-
|
|
303
|
+
whenUnavailable: z.array(z.string().min(1)).optional(),
|
|
215
304
|
});
|
|
216
305
|
export type WildoProviderSelectionOverrideEntry = z.infer<typeof WildoProviderSelectionOverrideEntrySchema>;
|
|
217
306
|
|
|
@@ -221,11 +310,110 @@ export const WildoProviderSelectionOverridesSchema = z.partialRecord(
|
|
|
221
310
|
);
|
|
222
311
|
export type WildoProviderSelectionOverrides = z.infer<typeof WildoProviderSelectionOverridesSchema>;
|
|
223
312
|
|
|
313
|
+
/**
|
|
314
|
+
* Per-environment provider CONFIGURATION values — the half of `providerConfigurations` that exists once per
|
|
315
|
+
* DEPLOYMENT rather than once per application.
|
|
316
|
+
*
|
|
317
|
+
* `wildo.saas.config.ts > providerConfigurations` is authored once and reaches every environment. That is right for
|
|
318
|
+
* application POLICY a provider reads (an agent execution profile, which environments it may run in). It is wrong
|
|
319
|
+
* for an IDENTITY the vendor issued against one deployment: an OAuth client ID registered with the authorized
|
|
320
|
+
* redirect URIs of one environment, a frontend SDK DSN or site key, a picker `appId`. Authored in the SaaS config, the
|
|
321
|
+
* local development Google client — whose only redirect URI is `localhost` — would be the client staging and
|
|
322
|
+
* production send users to.
|
|
323
|
+
*
|
|
324
|
+
* This block carries those values for ONE environment, in exactly the SaaS block's
|
|
325
|
+
* `providerRef → protocolKind → key` shape, and {@link overlayEnvironmentProviderConfigurations} lays it over the
|
|
326
|
+
* SaaS block KEY BY KEY. An environment therefore states only what differs and inherits the rest, so the policy half
|
|
327
|
+
* is never restated per environment.
|
|
328
|
+
*
|
|
329
|
+
* It reaches both places a provider configuration is read, because the CLI applies the overlay where it knows the
|
|
330
|
+
* environment: the managed declaration each environment's apps-manager stores (backend readers — the OAuth2
|
|
331
|
+
* connection resolver, email/SMS senders, the provider registry) and the provider runtime artifacts a build bakes in
|
|
332
|
+
* (frontend `publicConfig`, the backend's generated provider module).
|
|
333
|
+
*
|
|
334
|
+
* NOT for secrets. This file is committed; a client secret, API key or signing secret stays in
|
|
335
|
+
* `secrets.json → providerEnv`. The CLI refuses a key named like one of the provider's declared secrets.
|
|
336
|
+
*/
|
|
337
|
+
export const WildoEnvironmentProviderConfigurationsSchema = z.record(
|
|
338
|
+
z.string().min(1),
|
|
339
|
+
z.record(z.string().min(1), z.record(z.string().min(1), z.unknown())),
|
|
340
|
+
);
|
|
341
|
+
export type WildoEnvironmentProviderConfigurations = z.infer<typeof WildoEnvironmentProviderConfigurationsSchema>;
|
|
342
|
+
|
|
343
|
+
/**
|
|
344
|
+
* The provider configuration ONE environment runs with: the application-level `providerConfigurations`, with the
|
|
345
|
+
* environment's {@link WildoEnvironmentProviderConfigurationsSchema} values laid over it key by key.
|
|
346
|
+
*
|
|
347
|
+
* Precedence is per key inside one `providerRef → protocolKind` bag, and the environment wins — the more specific
|
|
348
|
+
* layer, as `secrets.json → providerEnv` wins over `observability.llmObservability.providerEnv`. A bag the
|
|
349
|
+
* environment does not mention is carried unchanged; a bag only the environment declares is added. Neither input is
|
|
350
|
+
* mutated.
|
|
351
|
+
*
|
|
352
|
+
* Rejected: replacing a whole provider or protocol bag. That would force an environment to restate every
|
|
353
|
+
* environment-invariant key it shares with the application (an agent execution profile beside a client ID), and a
|
|
354
|
+
* restated copy is one that drifts from the original.
|
|
355
|
+
*
|
|
356
|
+
* Throws when the application layer holds a non-object at a protocol key the environment overlays: there is no key
|
|
357
|
+
* to lay a value over, and silently replacing it would discard the application's value without saying so.
|
|
358
|
+
*/
|
|
359
|
+
export function overlayEnvironmentProviderConfigurations(
|
|
360
|
+
applicationProviderConfigurations: Readonly<Record<string, Readonly<Record<string, unknown>> | undefined>> | undefined,
|
|
361
|
+
environmentProviderConfigurations: WildoEnvironmentProviderConfigurations | undefined,
|
|
362
|
+
): Record<string, Record<string, unknown> | undefined> {
|
|
363
|
+
const resolved: Record<string, Record<string, unknown> | undefined> = {};
|
|
364
|
+
for (const [providerRef, protocols] of Object.entries(applicationProviderConfigurations ?? {})) {
|
|
365
|
+
resolved[providerRef] = protocols === undefined ? undefined : { ...protocols };
|
|
366
|
+
}
|
|
367
|
+
for (const [providerRef, environmentProtocols] of Object.entries(environmentProviderConfigurations ?? {})) {
|
|
368
|
+
const merged: Record<string, unknown> = { ...(resolved[providerRef] ?? {}) };
|
|
369
|
+
for (const [protocolKind, environmentValues] of Object.entries(environmentProtocols)) {
|
|
370
|
+
const applicationValues = merged[protocolKind];
|
|
371
|
+
if (applicationValues !== undefined && (applicationValues === null || typeof applicationValues !== 'object' || Array.isArray(applicationValues))) {
|
|
372
|
+
throw new Error(
|
|
373
|
+
`providerConfigurations.${providerRef}.${protocolKind} is not an object in wildo.saas.config.ts, so the `
|
|
374
|
+
+ 'environment\'s values for it cannot be laid over it key by key.',
|
|
375
|
+
);
|
|
376
|
+
}
|
|
377
|
+
merged[protocolKind] = { ...(applicationValues as Record<string, unknown> | undefined), ...environmentValues };
|
|
378
|
+
}
|
|
379
|
+
resolved[providerRef] = merged;
|
|
380
|
+
}
|
|
381
|
+
return resolved;
|
|
382
|
+
}
|
|
383
|
+
|
|
224
384
|
export enum DatabaseEngine {
|
|
225
385
|
MONGODB = 'mongodb',
|
|
226
386
|
POSTGRESQL = 'postgresql',
|
|
227
387
|
}
|
|
228
388
|
|
|
389
|
+
/**
|
|
390
|
+
* The store an APPLICATION persists to when its environment authors no `applicationDatabase`.
|
|
391
|
+
*
|
|
392
|
+
* PostgreSQL — decided by Paul on 2026-09-24 (#1571), reversing 75cd1934f ("absence means MongoDB")
|
|
393
|
+
* and restoring the rule of 2e0194c41. This is the ONLY place the answer is written. Every reader of
|
|
394
|
+
* an application's engine goes through {@link resolveApplicationDatabaseEngine}, because the
|
|
395
|
+
* 2026-09-15 incident was two readers answering silence differently: provisioning chose PostgreSQL,
|
|
396
|
+
* the runtime chose MongoDB, Mongo provisioning was skipped, registration reported success, and the
|
|
397
|
+
* application died at boot with `Command update requires authentication`.
|
|
398
|
+
*
|
|
399
|
+
* Distinct from the PLATFORM's own store (`database` in the infra config) and from the engine's
|
|
400
|
+
* `DEFAULT_PERSISTENCE_ADAPTER` / `DATABASE_DEFAULT_ADAPTER` env default, which also governs
|
|
401
|
+
* platform services and is not what this decides. The application never falls through to that env
|
|
402
|
+
* default: the CLI writes the resolved adapter explicitly.
|
|
403
|
+
*/
|
|
404
|
+
export const DEFAULT_APPLICATION_DATABASE_ENGINE: DatabaseEngine = DatabaseEngine.POSTGRESQL;
|
|
405
|
+
|
|
406
|
+
/**
|
|
407
|
+
* The engine an application persists to: its authored `applicationDatabase.engine`, or
|
|
408
|
+
* {@link DEFAULT_APPLICATION_DATABASE_ENGINE} when the environment authors none.
|
|
409
|
+
*
|
|
410
|
+
* Takes the declaration rather than a whole config so every carrier of it — the parsed infra config,
|
|
411
|
+
* `config.json`, a bootstrap request — answers through the same function.
|
|
412
|
+
*/
|
|
413
|
+
export function resolveApplicationDatabaseEngine(applicationDatabase: { readonly engine?: DatabaseEngine } | undefined): DatabaseEngine {
|
|
414
|
+
return applicationDatabase?.engine ?? DEFAULT_APPLICATION_DATABASE_ENGINE;
|
|
415
|
+
}
|
|
416
|
+
|
|
229
417
|
export enum WildoImageTagStrategy {
|
|
230
418
|
COMMIT_SHA = 'commit-sha',
|
|
231
419
|
BRANCH_NAME = 'branch-name',
|
|
@@ -235,27 +423,31 @@ export enum WildoImageTagStrategy {
|
|
|
235
423
|
/**
|
|
236
424
|
* Docker Compose deployment — no scaling, no K8s-specific fields.
|
|
237
425
|
*/
|
|
238
|
-
export const DockerComposeDeploymentSchema = z.
|
|
426
|
+
export const DockerComposeDeploymentSchema = z.strictObject({
|
|
239
427
|
branch: z.string().min(1),
|
|
240
428
|
runtime: z.literal(WildoDeploymentRuntime.DOCKER_COMPOSE),
|
|
241
429
|
imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
|
|
242
430
|
});
|
|
243
431
|
|
|
244
432
|
/**
|
|
245
|
-
* Kubernetes deployment —
|
|
433
|
+
* Kubernetes deployment — branch, namespace and tagging.
|
|
434
|
+
*
|
|
435
|
+
* No `registry`: an environment's images live at `remoteProvider.registryEndpoint`, the registry every deploy
|
|
436
|
+
* manifest pulls from and the deploy workflow pushes to. A separate field here could only repeat that value or
|
|
437
|
+
* contradict it — and it did contradict it, sending CI pushes to GHCR while the cluster pulled from the endpoint
|
|
438
|
+
* (#1165). Both deployment shapes are strict, so a leftover `registry` is refused rather than silently ignored.
|
|
246
439
|
*/
|
|
247
|
-
export const KubernetesDeploymentSchema = z.
|
|
440
|
+
export const KubernetesDeploymentSchema = z.strictObject({
|
|
248
441
|
branch: z.string().min(1),
|
|
249
442
|
runtime: z.literal(WildoDeploymentRuntime.KUBERNETES),
|
|
250
|
-
registry: z.string().min(1).optional(),
|
|
251
443
|
namespace: z.string().min(1).optional(),
|
|
252
444
|
imageTagStrategy: z.enum(WildoImageTagStrategy).default(WildoImageTagStrategy.COMMIT_SHA),
|
|
253
445
|
});
|
|
254
446
|
|
|
255
447
|
/**
|
|
256
448
|
* Deployment configuration for CI/CD pipeline integration.
|
|
257
|
-
* Discriminated on `runtime`: K8s-specific
|
|
258
|
-
*
|
|
449
|
+
* Discriminated on `runtime`: the K8s-specific field (`namespace`)
|
|
450
|
+
* is only available when `runtime` is `KUBERNETES`.
|
|
259
451
|
*/
|
|
260
452
|
export const WildoDeploymentConfigSchema = z.discriminatedUnion('runtime', [
|
|
261
453
|
DockerComposeDeploymentSchema,
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# `infrastructureHost` — running on another application's infrastructure
|
|
2
|
+
|
|
3
|
+
Read this when an environment of this application should share the platform and backing services of
|
|
4
|
+
another application instead of running its own, or when a descriptor authored with
|
|
5
|
+
`defineHostedInfraEnvConfig` is refused.
|
|
6
|
+
|
|
7
|
+
- which members a hosted descriptor may author, and which come from the host;
|
|
8
|
+
- why every store the application lists must be declared by the host;
|
|
9
|
+
- why a database, vhost or bucket name must differ from the host's.
|
|
10
|
+
|
|
11
|
+
## Import Origins
|
|
12
|
+
|
|
13
|
+
- `@wildo-ai/platform-config-lib`
|
|
14
|
+
|
|
15
|
+
## Source Excerpts
|
|
16
|
+
|
|
17
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
/**
|
|
21
|
+
* An environment descriptor for an application that runs on ANOTHER application's infrastructure.
|
|
22
|
+
*
|
|
23
|
+
* One application per environment owns the infrastructure — its platform services (apps-manager,
|
|
24
|
+
* module-registry, crontabs) and every backing service. Other applications declare that owner as their
|
|
25
|
+
* `infrastructureHost` and author only what is theirs: domain, CSP, provider choices, companion address,
|
|
26
|
+
* and their own database/vhost/bucket names on the host's servers. Everything else comes from the host's
|
|
27
|
+
* descriptor for the SAME environment when the descriptor is loaded, so the two cannot diverge — not in
|
|
28
|
+
* which stores exist, not in how they are reached, not between Docker Compose and Kubernetes.
|
|
29
|
+
*
|
|
30
|
+
* The link is per environment: author it in `wildo.infra.local.config.ts` to share a local platform while
|
|
31
|
+
* `staging` stays standalone, or in both.
|
|
32
|
+
*
|
|
33
|
+
* Refusals, all at load time, all naming both descriptors:
|
|
34
|
+
* - the host root holds no `wildo.saas.config.ts` — a hosted application needs its host's SOURCE checked
|
|
35
|
+
* out at that path;
|
|
36
|
+
* - the host has no descriptor for this environment, or is itself hosted;
|
|
37
|
+
* - a store this application lists is not declared by the host;
|
|
38
|
+
* - a database, vhost or bucket name equals the host's.
|
|
39
|
+
*
|
|
40
|
+
* @example Wonder CRM on Your Application' local platform.
|
|
41
|
+
* ```ts
|
|
42
|
+
* export default defineHostedInfraEnvConfig({
|
|
43
|
+
* environment: WildoEnvironment.LOCAL,
|
|
44
|
+
* infrastructureHost: { applicationRoot: '../your-app' },
|
|
45
|
+
* publicDomain: 'localhost',
|
|
46
|
+
* applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
|
|
47
|
+
* backingServices: {
|
|
48
|
+
* postgresql: { database: 'wonder-crm-db' },
|
|
49
|
+
* redis: { database: 0 },
|
|
50
|
+
* rabbitmq: { vhost: 'wonder-crm' },
|
|
51
|
+
* s3: { bucket: 'wonder-crm-local' },
|
|
52
|
+
* },
|
|
53
|
+
* devCompanion: { host: 'localhost', port: 4351 },
|
|
54
|
+
* });
|
|
55
|
+
* ```
|
|
56
|
+
*/
|
|
57
|
+
export const WildoHostedInfraEnvConfigSchema = z.strictObject({
|
|
58
|
+
infrastructureHost: z.strictObject({
|
|
59
|
+
/**
|
|
60
|
+
* The host application's root — the directory holding its `wildo.saas.config.ts` — RELATIVE to this
|
|
61
|
+
* application's root. Relative because the descriptor is committed: an absolute path is one machine's
|
|
62
|
+
* checkout layout, and would break on every other.
|
|
63
|
+
*/
|
|
64
|
+
applicationRoot: z.string().min(1).refine(
|
|
65
|
+
(value) => !ABSOLUTE_PATH_PATTERN.test(value),
|
|
66
|
+
'infrastructureHost.applicationRoot must be relative to this application root (e.g. "../your-app"): the descriptor is committed, and an absolute path only exists on one machine.',
|
|
67
|
+
),
|
|
68
|
+
}, refuseHostOwnedKeys('infrastructureHost')),
|
|
69
|
+
version: WILDO_INFRA_ENV_CONFIG_SHAPE.version,
|
|
70
|
+
environment: WILDO_INFRA_ENV_CONFIG_SHAPE.environment,
|
|
71
|
+
applicationDatabase: WILDO_INFRA_ENV_CONFIG_SHAPE.applicationDatabase,
|
|
72
|
+
publicDomain: WILDO_INFRA_ENV_CONFIG_SHAPE.publicDomain,
|
|
73
|
+
serviceHosts: WILDO_INFRA_ENV_CONFIG_SHAPE.serviceHosts,
|
|
74
|
+
kubernetes: z.strictObject({
|
|
75
|
+
services: WildoKubernetesConfigSchema.shape.services,
|
|
76
|
+
}, refuseHostOwnedKeys('kubernetes')).optional(),
|
|
77
|
+
deployment: z.strictObject({
|
|
78
|
+
branch: z.string().min(1),
|
|
79
|
+
imageTagStrategy: z.enum(WildoImageTagStrategy).optional(),
|
|
80
|
+
// No `registry`: images live at the host's `remoteProvider.registryEndpoint`, which its manifests pull from (#1165).
|
|
81
|
+
}, refuseHostOwnedKeys('deployment')).optional(),
|
|
82
|
+
backingServices: HostedBackingServicesEnvConfigSchema.optional(),
|
|
83
|
+
logging: WILDO_INFRA_ENV_CONFIG_SHAPE.logging,
|
|
84
|
+
observability: WILDO_INFRA_ENV_CONFIG_SHAPE.observability,
|
|
85
|
+
providerSelection: WILDO_INFRA_ENV_CONFIG_SHAPE.providerSelection,
|
|
86
|
+
providerConfigurations: WILDO_INFRA_ENV_CONFIG_SHAPE.providerConfigurations,
|
|
87
|
+
systemsOfRecord: WILDO_INFRA_ENV_CONFIG_SHAPE.systemsOfRecord,
|
|
88
|
+
documentationSite: WILDO_INFRA_ENV_CONFIG_SHAPE.documentationSite,
|
|
89
|
+
applicationCreationVerification: WILDO_INFRA_ENV_CONFIG_SHAPE.applicationCreationVerification,
|
|
90
|
+
serviceAuth: WILDO_INFRA_ENV_CONFIG_SHAPE.serviceAuth,
|
|
91
|
+
csp: WILDO_INFRA_ENV_CONFIG_SHAPE.csp,
|
|
92
|
+
cdn: WILDO_INFRA_ENV_CONFIG_SHAPE.cdn,
|
|
93
|
+
devCompanion: WILDO_INFRA_ENV_CONFIG_SHAPE.devCompanion,
|
|
94
|
+
}, refuseHostOwnedKeys('a hosted environment descriptor'));
|
|
95
|
+
```
|