@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: website-consent-gate-overrides
|
|
3
|
-
description: Customize
|
|
3
|
+
description: Customize the website's visitor consent panel, gate consent-based content, and keep optional tracking off until a visitor agrees. Use when the user says "customize the consent banner", "override the consent panel", "gate this embed behind consent", "add a privacy choices link", or "wire a brand-specific cookie consent UI".
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Website Consent Gate Overrides
|
|
@@ -19,65 +19,67 @@ Read and apply these patterns from the application-developer point of view:
|
|
|
19
19
|
|
|
20
20
|
## Overview
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
22
|
+
The marketing website already asks visitors for consent and enforces the answer.
|
|
23
|
+
`WebsitePageLayout` provides the visitor's consent state, starts a provider SDK or
|
|
24
|
+
script only once the purpose it rests on is granted, stops the SDK when consent is
|
|
25
|
+
withdrawn, and shows a panel when the site runs a consent-based provider and the
|
|
26
|
+
visitor has not decided. This skill is for changing how that panel LOOKS, gating your
|
|
27
|
+
own consent-based content, and adding a way back to the choice — never for deciding
|
|
28
|
+
what runs without consent.
|
|
29
|
+
|
|
30
|
+
Consent is a SET of purposes (`ConsentPurpose.ANALYTICS`, `ConsentPurpose.MARKETING`),
|
|
31
|
+
each granted on its own. There is no ladder: agreeing to marketing does not imply
|
|
32
|
+
analytics.
|
|
26
33
|
|
|
27
34
|
## App Paths
|
|
28
35
|
|
|
29
36
|
| Surface | Application-relative location |
|
|
30
37
|
|---|---|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
| Consent
|
|
34
|
-
|
|
|
38
|
+
| Page bridges (where an override is plugged in) | `website/src/pages-impl/*.bridge.tsx` |
|
|
39
|
+
| A replacement consent panel | `website/src/components/**` |
|
|
40
|
+
| Consent-panel labels, every locale | `website/src/i18n/*.json` (`website.chrome.consent.*`) |
|
|
41
|
+
| Content that rests on consent (embeds, widgets) | `website/src/sections/**` |
|
|
35
42
|
|
|
36
|
-
##
|
|
43
|
+
## When to Use / When NOT to Use
|
|
37
44
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
45
|
+
- Use to restyle the panel, add a "Privacy choices" link to the footer, or hide an
|
|
46
|
+
embed until its purpose is granted.
|
|
47
|
+
- Do NOT use to make an analytics provider start without consent. Whether a provider
|
|
48
|
+
rests on consent follows from its capability (product analytics does; error
|
|
49
|
+
monitoring and captcha do not), and that classification is the framework's.
|
|
50
|
+
- Do NOT use for the signed-in application's consent, which is stored on the person's
|
|
51
|
+
preferences and asked by the application's own consent gate.
|
|
52
|
+
|
|
53
|
+
## Decision
|
|
41
54
|
|
|
42
|
-
|
|
|
55
|
+
| You need | Use |
|
|
43
56
|
|---|---|
|
|
44
|
-
|
|
|
45
|
-
|
|
|
46
|
-
|
|
|
47
|
-
|
|
|
57
|
+
| A different look for the panel | a component passed as `consentBannerComponent` to each page bridge |
|
|
58
|
+
| Content that must not render until a purpose is granted | `<WebsiteConsentGate purpose={ConsentPurpose.MARKETING} fallback={…}>` |
|
|
59
|
+
| A form, CTA or page the visitor asked for | nothing, or `<WebsiteConsentGate>` with no purpose — essential content always renders |
|
|
60
|
+
| A link that reopens the choice | `useWebsiteConsent().openSettings()` |
|
|
61
|
+
| To know what was granted | `useWebsiteConsent()` — never storage or a cookie |
|
|
48
62
|
|
|
49
63
|
## Workflow
|
|
50
64
|
|
|
51
|
-
1. Read the
|
|
52
|
-
|
|
53
|
-
2.
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
65
|
+
1. **Read the contract.** The consent state and the gate are exported from
|
|
66
|
+
`@wildo-ai/saas-website`; see the references below.
|
|
67
|
+
2. **Replace the panel, if the look must change.** Author a component with no props
|
|
68
|
+
that reads `useWebsiteConsent()`, and pass it to every bridge:
|
|
69
|
+
`createWebsitePageBridgeIsland({ …, consentBannerComponent: BrandConsentPanel })` and
|
|
70
|
+
`createWebsiteBlogPostBridgeIsland({ …, consentBannerComponent: BrandConsentPanel })`.
|
|
71
|
+
Keep the three properties of the default: nothing pre-ticked; declining as easy as
|
|
72
|
+
accepting and recorded with `decide([])`; only `purposesInUse` offered.
|
|
73
|
+
3. **Gate consent-based content** with `<WebsiteConsentGate purpose={…}>`, and give it a
|
|
74
|
+
`fallback` that says what is withheld and calls `openSettings()`.
|
|
75
|
+
4. **Label every consent key in every locale.** The build refuses a locale pack missing
|
|
76
|
+
any `website.chrome.consent.*` key, including one purpose name per `ConsentPurpose`.
|
|
77
|
+
5. **Test the paths** in a clean browser profile: no choice (nothing optional starts),
|
|
78
|
+
decline, accept, change of mind through the reopen link.
|
|
63
79
|
|
|
64
80
|
## Worked Example
|
|
65
81
|
|
|
66
|
-
|
|
67
|
-
illustrates the required purpose separation without inventing an API. -->
|
|
68
|
-
```ts
|
|
69
|
-
type ResolvedConsent = {
|
|
70
|
-
essential: true;
|
|
71
|
-
analytics: boolean;
|
|
72
|
-
marketing: boolean;
|
|
73
|
-
};
|
|
74
|
-
|
|
75
|
-
export function canStartOptionalAnalytics(consent: ResolvedConsent): boolean {
|
|
76
|
-
return consent.analytics;
|
|
77
|
-
}
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
## References
|
|
82
|
+
The state a replacement panel reads and the actions it calls:
|
|
81
83
|
|
|
82
84
|
## Import Origins
|
|
83
85
|
|
|
@@ -89,169 +91,417 @@ export function canStartOptionalAnalytics(consent: ResolvedConsent): boolean {
|
|
|
89
91
|
|
|
90
92
|
```tsx
|
|
91
93
|
*
|
|
92
|
-
* `
|
|
93
|
-
*
|
|
94
|
-
* (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the
|
|
95
|
-
* resolved label pack from disk and calls
|
|
96
|
-
* `<WebsiteRuntimeContextProvider value={…}>` around the page tree).
|
|
94
|
+
* `WebsiteConsentContext` — a website visitor's consent state (#534), provided once per page by
|
|
95
|
+
* `WebsitePageLayout`.
|
|
97
96
|
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
101
|
-
* live in their own per-locale static builds). A `*Config` name would
|
|
102
|
-
* suggest the full multi-locale surface is in scope.
|
|
97
|
+
* Consent is a SET of `ConsentPurpose`s, each granted or not on its own. Nothing optional runs until its
|
|
98
|
+
* purpose is granted: the layout's provider SDKs and scripts read `grantedPurposes`, and so does
|
|
99
|
+
* `<WebsiteConsentGate purpose={…}>`.
|
|
103
100
|
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
* locale-aware formatting (number/date in marketing copy is rare
|
|
108
|
-
* but legitimate) read it via `useWebsiteRuntime()`.
|
|
109
|
-
* - `labelPack` — the locale-resolved flat key→string map, validated
|
|
110
|
-
* against the manifest by `validateLabelPackAgainstManifest` at
|
|
111
|
-
* build start. Consumed by `useWebsiteLabel` and
|
|
112
|
-
* `useWebsiteLabelByKey`.
|
|
113
|
-
* - `designTokens` — the `WebsiteDesignTokens` from
|
|
114
|
-
* `WebsiteRootConfig.designTokens`. Consumed by
|
|
115
|
-
* `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that
|
|
116
|
-
* materializes them as `--website-*` custom properties on the
|
|
117
|
-
* `<WebsitePageLayout>` root.
|
|
118
|
-
* - `navigation` — the `WebsiteNavigationConfig` from
|
|
119
|
-
* `WebsiteRootConfig.navigation`. Carried in the runtime context
|
|
120
|
-
* (rather than as a separate `WebsiteNavigationContext`) because
|
|
121
|
-
* `<WebsitePageLayout>` already reads runtime state and
|
|
122
|
-
* header/footer slots are inseparable from "the site is rendering
|
|
123
|
-
* right now". A second context for two component refs would split
|
|
124
|
-
* the host-adapter's wiring surface without buying isolation.
|
|
125
|
-
* - `frontendProviderRegistry` — optional website-facing public provider
|
|
126
|
-
* registry hydrated from the materialized provider artifact for the
|
|
127
|
-
* concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /
|
|
128
|
-
* browser-monitoring integrations on the same frontend-provider
|
|
129
|
-
* contract the SaaS app now uses, instead of inventing a website-only
|
|
130
|
-
* metadata seam.
|
|
131
|
-
*
|
|
132
|
-
* **Why a separate file from the hook + provider**: split for React
|
|
133
|
-
* Fast Refresh — when a `.tsx` exports both a React component and a
|
|
134
|
-
* React Context object, edits to either one invalidate the entire
|
|
135
|
-
* module's HMR boundary. Keeping the bare context here, the hook in
|
|
136
|
-
* `useWebsiteRuntime.ts`, and the provider component in
|
|
137
|
-
* `WebsiteRuntimeContextProvider.tsx` makes section authors edit
|
|
138
|
-
* components without retriggering the runtime context's identity.
|
|
101
|
+
* `purposesInUse` is DERIVED from the live providers (`consentPurposesInUseByProviders`), so the panel asks
|
|
102
|
+
* about exactly the purposes this site processes and nothing else. A site running no consent-based
|
|
103
|
+
* provider shows no panel at all.
|
|
139
104
|
*/
|
|
140
|
-
export
|
|
141
|
-
/**
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
* Carried in the runtime context so client-tier components — namely
|
|
150
|
-
* `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct
|
|
151
|
-
* locale-prefixed pathname (`/pricing` on the EN site,
|
|
152
|
-
* `/fr/pricing` on the FR site) without re-importing the root
|
|
153
|
-
* config. Plumbing it through the runtime keeps the routing rule
|
|
154
|
-
* a framework-internal concern: section authors NEVER hand-prefix
|
|
155
|
-
* paths.
|
|
156
|
-
*/
|
|
157
|
-
defaultLocale: AvailableLanguage;
|
|
158
|
-
/**
|
|
159
|
-
* Flat `Record<string, string>` label pack for the active locale.
|
|
160
|
-
* Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
|
|
161
|
-
* strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`
|
|
162
|
-
* which composes the full key against the page+section context.
|
|
163
|
-
*/
|
|
164
|
-
labelPack: LabelPack;
|
|
165
|
-
/**
|
|
166
|
-
* Design-token bundle for the active site. Same object referenced
|
|
167
|
-
* by `WebsiteRootConfig.designTokens`; passed by reference (not
|
|
168
|
-
* cloned) so token-aware components can rely on referential
|
|
169
|
-
* stability across renders.
|
|
170
|
-
*/
|
|
171
|
-
designTokens: WebsiteDesignTokens;
|
|
172
|
-
/**
|
|
173
|
-
* Site-wide navigation slot bindings (header / footer components).
|
|
174
|
-
* Same object referenced by `WebsiteRootConfig.navigation`. Read
|
|
175
|
-
* by `<WebsitePageLayout>` to render the chrome around each page's
|
|
176
|
-
* `<main>` content; per-page `header` / `footer` props on
|
|
177
|
-
* `<WebsitePageLayout>` override these defaults.
|
|
178
|
-
*/
|
|
179
|
-
navigation: WebsiteNavigationConfig;
|
|
105
|
+
export enum WebsiteConsentStatus {
|
|
106
|
+
/** The visitor has not decided — or their decision cannot be read. Nothing optional runs. */
|
|
107
|
+
UNDECIDED = 'undecided',
|
|
108
|
+
/** The visitor decided; `grantedPurposes` is their answer, possibly empty. */
|
|
109
|
+
DECIDED = 'decided',
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
export interface WebsiteConsentContextValue {
|
|
113
|
+
status: WebsiteConsentStatus;
|
|
180
114
|
/**
|
|
181
|
-
*
|
|
182
|
-
*
|
|
183
|
-
*
|
|
184
|
-
* `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the
|
|
185
|
-
* runtime context (NOT re-derived from the root config inside
|
|
186
|
-
* `WebsitePageLayout`) for two reasons:
|
|
187
|
-
* - The layout is a client-tier React component; it cannot import
|
|
188
|
-
* the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging
|
|
189
|
-
* server-only code (manifest registry, page components) into
|
|
190
|
-
* the client bundle.
|
|
191
|
-
* - Threading the key through the runtime keeps the layout's
|
|
192
|
-
* contract symmetric with how every other localized text on the
|
|
193
|
-
* page is sourced (label pack + key), so the skip link is
|
|
194
|
-
* translated automatically without any per-locale branching.
|
|
115
|
+
* `false` during the server render and the first client render, before storage has been read. A
|
|
116
|
+
* consent panel must not render while this is false: it would flash for a visitor who already decided,
|
|
117
|
+
* and differ from the static HTML. Optional behaviour stays off either way.
|
|
195
118
|
*/
|
|
196
|
-
|
|
119
|
+
isResolved: boolean;
|
|
120
|
+
/** What the visitor granted. Empty while UNDECIDED. */
|
|
121
|
+
grantedPurposes: readonly ConsentPurpose[];
|
|
122
|
+
/** When the visitor decided, ISO-8601; absent while UNDECIDED. */
|
|
123
|
+
decidedAt?: string;
|
|
124
|
+
/** The purposes this site's live providers rest on — what a consent panel offers. */
|
|
125
|
+
purposesInUse: readonly ConsentPurpose[];
|
|
126
|
+
/** Whether the visitor re-opened the panel to change a decision already made. */
|
|
127
|
+
isSettingsOpen: boolean;
|
|
128
|
+
/** Whether `purpose` is granted. */
|
|
129
|
+
hasGranted: (purpose: ConsentPurpose) => boolean;
|
|
130
|
+
/** Record the WHOLE set the visitor grants — a purpose left out is not granted. Closes the panel. */
|
|
131
|
+
decide: (grantedPurposes: readonly ConsentPurpose[]) => void;
|
|
132
|
+
/** Re-open the panel so the visitor can change their decision. */
|
|
133
|
+
openSettings: () => void;
|
|
134
|
+
/** Close a re-opened panel without changing anything. */
|
|
135
|
+
closeSettings: () => void;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
export const WebsiteConsentContext: React.Context<WebsiteConsentContextValue | null> = createContext<WebsiteConsentContextValue | null>(null);
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* The narrow slice of `WebsiteAnonymousSessionClient` this provider needs, declared structurally
|
|
142
|
+
* rather than imported (#1258).
|
|
143
|
+
*
|
|
144
|
+
* Structural because the provider does not want the client's construction concerns — an `apiOrigin`
|
|
145
|
+
* and the application's own `frontendServiceName`, which only the application knows — and because it
|
|
146
|
+
* makes the durable write trivially substitutable in a test.
|
|
147
|
+
*/
|
|
148
|
+
export interface WebsiteConsentRecorder {
|
|
197
149
|
/**
|
|
198
|
-
*
|
|
199
|
-
*
|
|
200
|
-
*
|
|
201
|
-
*
|
|
150
|
+
* NOT generic, deliberately, though `WebsiteAnonymousSessionClient.requestAnonymous` is: this
|
|
151
|
+
* provider ignores the response entirely, so a type parameter here would be a promise to the caller
|
|
152
|
+
* that nothing keeps. The client's generic method satisfies this shape structurally.
|
|
153
|
+
*
|
|
154
|
+
* It takes the METHOD rather than being named after one. The consent door is a PUT — its operation
|
|
155
|
+
* borrows `UPDATE_MANY` — and this interface previously named `postAnonymous`, so every decision a
|
|
156
|
+
* visitor made 404'd, silently, by this provider's own (correct) design of never telling a visitor
|
|
157
|
+
* their privacy choice failed. A door's method is part of its address, so it is passed like one.
|
|
202
158
|
*/
|
|
203
|
-
|
|
159
|
+
requestAnonymous(method: string, path: string, body: unknown): Promise<unknown>;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
export interface WebsiteConsentProviderProps {
|
|
163
|
+
purposesInUse: readonly ConsentPurpose[];
|
|
204
164
|
/**
|
|
205
|
-
*
|
|
206
|
-
*
|
|
207
|
-
* (lead / draft-note forms). Sourced from
|
|
208
|
-
* `WildoMarketingWebsiteConfig.apiOrigin` and passed as a
|
|
209
|
-
* JSON-serializable island prop (the `.astro` page resolves the
|
|
210
|
-
* per-environment value and forwards it).
|
|
165
|
+
* OPTIONAL. When present, a decision is ALSO recorded server-side against the visitor's anonymous
|
|
166
|
+
* session, which is what lets it follow them into the account they go on to create (#1258).
|
|
211
167
|
*
|
|
212
|
-
*
|
|
213
|
-
*
|
|
214
|
-
*
|
|
215
|
-
* silently failing to submit.
|
|
168
|
+
* Absent is a first-class answer and is exactly today's behaviour: the decision lives in this
|
|
169
|
+
* browser and nowhere else. A site with no anonymous-session wiring keeps working, gates the same
|
|
170
|
+
* way, and simply carries nothing forward.
|
|
216
171
|
*/
|
|
217
|
-
|
|
172
|
+
recorder?: WebsiteConsentRecorder;
|
|
173
|
+
children: ReactNode;
|
|
218
174
|
}
|
|
219
175
|
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
* over a silent default value so a missing provider is detected at
|
|
225
|
-
* the first hook call rather than at render time when a missing
|
|
226
|
-
* label silently renders as the key string.
|
|
227
|
-
*/
|
|
228
|
-
export const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =
|
|
229
|
-
createContext<WebsiteRuntimeContextValue | null>(null);
|
|
176
|
+
export function WebsiteConsentProvider({ purposesInUse, recorder, children }: WebsiteConsentProviderProps): ReactNode {
|
|
177
|
+
const [record, setRecord] = useState<WebsiteVisitorConsentRecord | null>(null);
|
|
178
|
+
const [isResolved, setIsResolved] = useState(false);
|
|
179
|
+
const [isSettingsOpen, setIsSettingsOpen] = useState(false);
|
|
230
180
|
|
|
231
|
-
|
|
232
|
-
|
|
181
|
+
// Read after mount, never during render: the static HTML was produced with no storage at all.
|
|
182
|
+
useEffect(() => {
|
|
183
|
+
setRecord(readWebsiteVisitorConsent());
|
|
184
|
+
setIsResolved(true);
|
|
185
|
+
return subscribeWebsiteVisitorConsent(() => setRecord(readWebsiteVisitorConsent()));
|
|
186
|
+
}, []);
|
|
187
|
+
|
|
188
|
+
const decide = useCallback((grantedPurposes: readonly ConsentPurpose[]): void => {
|
|
189
|
+
/*
|
|
190
|
+
* Local storage FIRST, and it is what gates this page (D6). The site is statically built, so a
|
|
191
|
+
* refusal that only held while an API answered would not hold at all — and the visitor's panel
|
|
192
|
+
* must close on their click, not on a round trip.
|
|
193
|
+
*/
|
|
194
|
+
setRecord(writeWebsiteVisitorConsent(grantedPurposes));
|
|
195
|
+
setIsSettingsOpen(false);
|
|
196
|
+
|
|
197
|
+
/*
|
|
198
|
+
* Then the DURABLE copy, best-effort. This is the one that survives the browser and is carried
|
|
199
|
+
* onto the account at signup; its failure changes nothing the visitor can see, so it is never
|
|
200
|
+
* awaited and never surfaced.
|
|
201
|
+
*
|
|
202
|
+
* `purposesInUse` is sent as the OFFERED set — what this panel actually put in front of them.
|
|
203
|
+
* Without it the application could not tell a declined purpose from one this site never asked
|
|
204
|
+
* about, and would record a decision the visitor never made
|
|
205
|
+
* (`AnonymousUserPrivacySchema.offeredPurposes`).
|
|
206
|
+
*/
|
|
207
|
+
if (recorder !== undefined && purposesInUse.length > 0) {
|
|
208
|
+
void recorder
|
|
209
|
+
.requestAnonymous(ANONYMOUS_CONSENT_RECORD_METHOD, ANONYMOUS_CONSENT_RECORD_PATH, {
|
|
210
|
+
grantedPurposes: [...grantedPurposes],
|
|
211
|
+
offeredPurposes: [...purposesInUse],
|
|
212
|
+
})
|
|
213
|
+
.catch(() => {
|
|
214
|
+
/*
|
|
215
|
+
* Deliberately silent. The decision HELD — it is in this browser and gating this page. All
|
|
216
|
+
* that is lost is the carry, and telling a visitor their privacy choice failed when it did
|
|
217
|
+
* not would be worse than losing it.
|
|
218
|
+
*/
|
|
219
|
+
});
|
|
220
|
+
}
|
|
221
|
+
}, [recorder, purposesInUse]);
|
|
222
|
+
const openSettings = useCallback((): void => setIsSettingsOpen(true), []);
|
|
223
|
+
const closeSettings = useCallback((): void => setIsSettingsOpen(false), []);
|
|
224
|
+
|
|
225
|
+
const value = useMemo<WebsiteConsentContextValue>(() => {
|
|
226
|
+
const grantedPurposes = record?.grantedPurposes ?? [];
|
|
227
|
+
return {
|
|
228
|
+
status: record === null ? WebsiteConsentStatus.UNDECIDED : WebsiteConsentStatus.DECIDED,
|
|
229
|
+
isResolved,
|
|
230
|
+
grantedPurposes,
|
|
231
|
+
...(record !== null ? { decidedAt: record.decidedAt } : {}),
|
|
232
|
+
purposesInUse,
|
|
233
|
+
isSettingsOpen,
|
|
234
|
+
hasGranted: (purpose) => grantedPurposes.includes(purpose),
|
|
235
|
+
decide,
|
|
236
|
+
openSettings,
|
|
237
|
+
closeSettings,
|
|
238
|
+
};
|
|
239
|
+
}, [record, isResolved, purposesInUse, isSettingsOpen, decide, openSettings, closeSettings]);
|
|
240
|
+
|
|
241
|
+
return <WebsiteConsentContext.Provider value={value}>{children}</WebsiteConsentContext.Provider>;
|
|
242
|
+
}
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
Gating content that rests on a purpose:
|
|
246
|
+
|
|
247
|
+
## Import Origins
|
|
248
|
+
|
|
249
|
+
- `@wildo-ai/saas-website`
|
|
250
|
+
|
|
251
|
+
## Source Excerpts
|
|
252
|
+
|
|
253
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
254
|
+
|
|
255
|
+
```tsx
|
|
256
|
+
*
|
|
257
|
+
* `<WebsiteConsentGate>` — renders its children only when the visitor's consent allows it (#534).
|
|
258
|
+
*
|
|
259
|
+
* - **No `purpose`** — the content is ESSENTIAL and always renders. This is the right wrapper for a
|
|
260
|
+
* contact form: submitting a form the visitor chose to fill in never depends on optional consent, and the
|
|
261
|
+
* form's own opt-ins (marketing) are recorded with the submission, not here.
|
|
262
|
+
* - **`purpose`** — the content rests on that purpose (an embedded video that tracks, a chat widget, a
|
|
263
|
+
* marketing pixel). It renders only once the visitor granted it; until then `fallback` renders — a
|
|
264
|
+
* placeholder that says what is withheld and offers `useWebsiteConsent().openSettings()`.
|
|
265
|
+
*
|
|
266
|
+
* It renders `fallback` during the server render and before the stored decision is read, so a static page
|
|
267
|
+
* never ships consent-based content in its HTML.
|
|
268
|
+
*/
|
|
269
|
+
export interface WebsiteConsentGateProps {
|
|
270
|
+
/** The purpose the children rest on. Omit for essential content. */
|
|
271
|
+
purpose?: ConsentPurpose;
|
|
272
|
+
/** Rendered in place of consent-based children until the purpose is granted. Defaults to nothing. */
|
|
273
|
+
fallback?: ReactNode;
|
|
233
274
|
children: ReactNode;
|
|
234
275
|
}
|
|
235
276
|
|
|
277
|
+
export function WebsiteConsentGate({ purpose, fallback = null, children }: WebsiteConsentGateProps): ReactNode {
|
|
278
|
+
const consent = useWebsiteConsent();
|
|
279
|
+
if (purpose === undefined) return <>{children}</>;
|
|
280
|
+
return <>{consent.isResolved && consent.hasGranted(purpose) ? children : fallback}</>;
|
|
281
|
+
}
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
The default panel, whose three properties a replacement keeps:
|
|
285
|
+
|
|
286
|
+
## Import Origins
|
|
287
|
+
|
|
288
|
+
- `@wildo-ai/saas-website`
|
|
289
|
+
|
|
290
|
+
## Source Excerpts
|
|
291
|
+
|
|
292
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
293
|
+
|
|
294
|
+
```tsx
|
|
295
|
+
*
|
|
296
|
+
* `WebsiteConsentBanner` — the framework's default visitor consent panel (#534).
|
|
297
|
+
*
|
|
298
|
+
* Rendered by `WebsitePageLayout` when the site runs a consent-based provider and the visitor has not
|
|
299
|
+
* decided, or re-opened the panel. A site replaces it by passing `consentBannerComponent` to its bridge
|
|
300
|
+
* island; a replacement reads `useWebsiteConsent()` exactly as this one does and must keep its three
|
|
301
|
+
* properties:
|
|
302
|
+
*
|
|
303
|
+
* 1. **No box is pre-ticked.** A pre-ticked box is not a choice.
|
|
304
|
+
* 2. **Declining is as easy as accepting**, and is RECORDED — so the panel does not return on every page.
|
|
305
|
+
* 3. **Only purposes in use are offered** (`purposesInUse`), each named by its label.
|
|
306
|
+
*
|
|
307
|
+
* Styled only through the site's `--website-*` design tokens, like the skip link, so it needs no
|
|
308
|
+
* stylesheet and cannot be shadowed by a utility class.
|
|
309
|
+
*/
|
|
310
|
+
function useWebsiteConsentSlotLabel(slot: WebsiteConsentLabelSlot): string {
|
|
311
|
+
return useWebsiteLabelByKey(websiteConsentLabelKey(slot));
|
|
312
|
+
}
|
|
313
|
+
|
|
236
314
|
/**
|
|
237
|
-
*
|
|
238
|
-
*
|
|
239
|
-
*
|
|
240
|
-
*
|
|
315
|
+
* Every row has the SAME shape: the control, then the name on its line, then the explanation beneath
|
|
316
|
+
* the NAME rather than beneath the control — a two-column grid, so the second line starts where the
|
|
317
|
+
* first line's words do and the row stays scannable.
|
|
318
|
+
*
|
|
319
|
+
* That includes the row that cannot be changed, which carries a real checkbox, CHECKED and DISABLED,
|
|
320
|
+
* rather than a text status. A person scanning the panel reads DOWN the column of controls, and a row
|
|
321
|
+
* whose control is missing does not read as "cannot be changed" — it reads as a row that was
|
|
322
|
+
* forgotten. A checked, disabled box says it in the vocabulary the rest of the list already uses, and
|
|
323
|
+
* a screen reader announces "checked, unavailable" without any extra words.
|
|
241
324
|
*/
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
325
|
+
const ROW_STYLE: React.CSSProperties = {
|
|
326
|
+
display: 'grid',
|
|
327
|
+
gridTemplateColumns: 'auto 1fr',
|
|
328
|
+
columnGap: '0.625rem',
|
|
329
|
+
alignItems: 'center',
|
|
330
|
+
padding: '0.5rem 0.75rem',
|
|
331
|
+
borderBottom: '1px solid var(--website-colors-border, #ccc)',
|
|
332
|
+
};
|
|
333
|
+
|
|
334
|
+
const ROW_DESCRIPTION_STYLE: React.CSSProperties = { margin: 0, gridColumn: 2, fontSize: '0.75rem', opacity: 0.8 };
|
|
335
|
+
|
|
336
|
+
/** Slightly larger than a default box: this is the one control the whole panel exists to offer. */
|
|
337
|
+
const ROW_CONTROL_STYLE: React.CSSProperties = { width: '1.15rem', height: '1.15rem' };
|
|
338
|
+
|
|
339
|
+
/**
|
|
340
|
+
* One purpose: its NAME, what agreeing to it MEANS for this visitor, and the control.
|
|
341
|
+
*
|
|
342
|
+
* The explanation is the half that was missing. A tick box labelled "Analytics" is a category, not
|
|
343
|
+
* something a visitor can weigh, and consent is only valid if it is informed — which is why every
|
|
344
|
+
* specialized consent platform pairs the two and why the label key is derived from the vocabulary,
|
|
345
|
+
* so a purpose can never arrive with a name and no explanation.
|
|
346
|
+
*/
|
|
347
|
+
function PurposeChoice({ purpose, checked, onChange }: { purpose: ConsentPurpose; checked: boolean; onChange: (checked: boolean) => void }): ReactNode {
|
|
348
|
+
const label = useWebsiteLabelByKey(websiteConsentPurposeLabelKey(purpose));
|
|
349
|
+
const description = useWebsiteLabelByKey(websiteConsentPurposeDescriptionLabelKey(purpose));
|
|
246
350
|
return (
|
|
247
|
-
<
|
|
248
|
-
{
|
|
249
|
-
|
|
351
|
+
<label data-website-consent-purpose={purpose} style={{ ...ROW_STYLE, cursor: 'pointer' }}>
|
|
352
|
+
<input type="checkbox" checked={checked} style={ROW_CONTROL_STYLE} onChange={(event) => onChange(event.target.checked)} />
|
|
353
|
+
<span style={{ fontWeight: 600 }}>{label}</span>
|
|
354
|
+
<span style={ROW_DESCRIPTION_STYLE}>{description}</span>
|
|
355
|
+
</label>
|
|
356
|
+
);
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
const BUTTON_STYLE: React.CSSProperties = {
|
|
360
|
+
padding: '0.5rem 1rem',
|
|
361
|
+
borderRadius: 'var(--website-radii-md, 0.375rem)',
|
|
362
|
+
border: '1px solid var(--website-colors-border, #ccc)',
|
|
363
|
+
background: 'var(--website-colors-background, #fff)',
|
|
364
|
+
color: 'var(--website-colors-foreground, #000)',
|
|
365
|
+
cursor: 'pointer',
|
|
366
|
+
};
|
|
367
|
+
|
|
368
|
+
export function WebsiteConsentBanner(): ReactNode {
|
|
369
|
+
const consent = useWebsiteConsent();
|
|
370
|
+
const headingId = useId();
|
|
371
|
+
const [selected, setSelected] = useState<readonly ConsentPurpose[]>(consent.grantedPurposes);
|
|
372
|
+
// Re-seed from the stored decision each time the panel is re-opened, so it shows what is in force.
|
|
373
|
+
useEffect(() => setSelected(consent.grantedPurposes), [consent.grantedPurposes, consent.isSettingsOpen]);
|
|
374
|
+
|
|
375
|
+
const title = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.TITLE);
|
|
376
|
+
const description = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.DESCRIPTION);
|
|
377
|
+
const acceptAll = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ACCEPT_ALL);
|
|
378
|
+
const declineAll = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.DECLINE_ALL);
|
|
379
|
+
const save = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.SAVE);
|
|
380
|
+
const essentialTitle = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ESSENTIAL_TITLE);
|
|
381
|
+
const essentialDescription = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ESSENTIAL_DESCRIPTION);
|
|
382
|
+
|
|
383
|
+
const offered = consent.purposesInUse;
|
|
384
|
+
// Purposes the panel does not offer keep their stored grant; offered ones are granted exactly when ticked.
|
|
385
|
+
const choose = (chosen: readonly ConsentPurpose[]): void =>
|
|
386
|
+
consent.decide([...consent.grantedPurposes.filter((purpose) => !offered.includes(purpose)), ...chosen]);
|
|
387
|
+
|
|
388
|
+
return (
|
|
389
|
+
<section
|
|
390
|
+
role="region"
|
|
391
|
+
aria-labelledby={headingId}
|
|
392
|
+
data-website-consent-banner={consent.status === WebsiteConsentStatus.UNDECIDED ? 'undecided' : 'settings'}
|
|
393
|
+
style={{
|
|
394
|
+
/*
|
|
395
|
+
* BOTTOM-RIGHT CORNER, and the three properties together are what make that work on a phone
|
|
396
|
+
* too. `left` and `right` both bound the box to the viewport with a gutter; `maxWidth` caps it
|
|
397
|
+
* on a wide screen; `marginLeft: auto` pushes the remaining slack to the left so the box hugs
|
|
398
|
+
* the right edge. On a narrow screen the gutters bind before the cap does and it simply spans
|
|
399
|
+
* the width — a corner popup that overflowed a phone would be worse than a bar.
|
|
400
|
+
*
|
|
401
|
+
* Inline styles, not a media query: this ships into a static marketing page with no stylesheet
|
|
402
|
+
* of its own, which is the same constraint that keeps the rest of this file inline.
|
|
403
|
+
*/
|
|
404
|
+
position: 'fixed',
|
|
405
|
+
left: '1rem',
|
|
406
|
+
right: '1rem',
|
|
407
|
+
bottom: '1rem',
|
|
408
|
+
zIndex: 9000,
|
|
409
|
+
maxWidth: '30rem',
|
|
410
|
+
marginLeft: 'auto',
|
|
411
|
+
/*
|
|
412
|
+
* The panel never exceeds the viewport, and its ACTIONS are never what gets cut off: the rows
|
|
413
|
+
* scroll inside `maxHeight`, the buttons sit outside that box. A panel that grows with its
|
|
414
|
+
* content pushes accept and reject off the bottom of a short screen — and a refusal that
|
|
415
|
+
* cannot be reached is a refusal that was not offered, whatever the markup says. `dvh` rather
|
|
416
|
+
* than `vh` because a mobile browser's toolbars make `vh` taller than the visible page.
|
|
417
|
+
*/
|
|
418
|
+
maxHeight: '85dvh',
|
|
419
|
+
padding: '0.875rem 1rem',
|
|
420
|
+
display: 'flex',
|
|
421
|
+
flexDirection: 'column',
|
|
422
|
+
gap: '0.625rem',
|
|
423
|
+
background: 'var(--website-colors-surface, #fff)',
|
|
424
|
+
color: 'var(--website-colors-surface-foreground, #000)',
|
|
425
|
+
border: '1px solid var(--website-colors-border, #ccc)',
|
|
426
|
+
borderRadius: 'var(--website-radii-lg, 0.5rem)',
|
|
427
|
+
}}
|
|
428
|
+
>
|
|
429
|
+
<h2 id={headingId} style={{ margin: 0, fontSize: '1.125rem' }}>{title}</h2>
|
|
430
|
+
<p style={{ margin: 0 }}>{description}</p>
|
|
431
|
+
{/* `data-website-consent-rows` is the scroll box's own hook. A test anchoring on a style
|
|
432
|
+
substring instead matched the ROW (whose grid template also contains "auto") and asserted
|
|
433
|
+
nothing — the same vacuous pin the app tier already had to repair. */}
|
|
434
|
+
<div
|
|
435
|
+
data-website-consent-rows=""
|
|
436
|
+
style={{ minHeight: 0, flex: 1, overflowY: 'auto', border: '1px solid var(--website-colors-border, #ccc)', borderRadius: 'var(--website-radii-md, 0.375rem)' }}
|
|
437
|
+
>
|
|
438
|
+
{/*
|
|
439
|
+
* The always-active row, first, carrying a CHECKED and DISABLED box. It is not a purpose the
|
|
440
|
+
* visitor decides — which is exactly why it is stated: a panel listing only the optional
|
|
441
|
+
* purposes leaves them unable to see what is happening on the site at all, which is the
|
|
442
|
+
* question they opened it to answer.
|
|
443
|
+
*
|
|
444
|
+
* It carried a text status instead until 2026-09-20, on the argument that a disabled control
|
|
445
|
+
* invites a click that cannot work. The reversal: a visitor scans DOWN the column of boxes,
|
|
446
|
+
* and a gap there does not read as "cannot be changed", it reads as a row that was
|
|
447
|
+
* forgotten. A disabled box says it in the vocabulary the rest of the list already uses.
|
|
448
|
+
*/}
|
|
449
|
+
<div data-website-consent-essential="" style={ROW_STYLE}>
|
|
450
|
+
{/*
|
|
451
|
+
* `aria-label`, because this row is a `div` rather than a `<label>` — nothing else names
|
|
452
|
+
* the control, and a checkbox with no accessible name is announced as an unlabelled
|
|
453
|
+
* checkbox. Its own note claimed AT would announce "checked, unavailable"; it announced
|
|
454
|
+
* no words at all.
|
|
455
|
+
*
|
|
456
|
+
* `readOnly` is gone: it is inert on a checkbox per HTML, and leaving it invites a later
|
|
457
|
+
* reader to delete `disabled` believing the lock survives.
|
|
458
|
+
*/}
|
|
459
|
+
<input type="checkbox" checked disabled aria-label={essentialTitle} style={ROW_CONTROL_STYLE} />
|
|
460
|
+
<span style={{ fontWeight: 600 }}>{essentialTitle}</span>
|
|
461
|
+
<span style={ROW_DESCRIPTION_STYLE}>{essentialDescription}</span>
|
|
462
|
+
</div>
|
|
463
|
+
{offered.map((purpose) => (
|
|
464
|
+
<PurposeChoice
|
|
465
|
+
key={purpose}
|
|
466
|
+
purpose={purpose}
|
|
467
|
+
checked={selected.includes(purpose)}
|
|
468
|
+
onChange={(checked) => setSelected((current) => (checked ? [...current.filter((entry) => entry !== purpose), purpose] : current.filter((entry) => entry !== purpose)))}
|
|
469
|
+
/>
|
|
470
|
+
))}
|
|
471
|
+
</div>
|
|
472
|
+
<div style={{ display: 'flex', flexWrap: 'wrap', gap: '0.5rem', justifyContent: 'flex-end' }}>
|
|
473
|
+
<button type="button" style={BUTTON_STYLE} onClick={() => choose([])}>{declineAll}</button>
|
|
474
|
+
{/*
|
|
475
|
+
* SAVE appears only when a MIXED choice exists to save — two or more purposes in use.
|
|
476
|
+
*
|
|
477
|
+
* With one purpose the button is unanswerable: "decline all" and "accept all" already cover
|
|
478
|
+
* the whole space, so a third action beside them describes nothing a visitor can picture and
|
|
479
|
+
* reads as a question rather than an answer. Derived from the offered set, so a site that
|
|
480
|
+
* adds a second purpose gets the control with no edit here.
|
|
481
|
+
*/}
|
|
482
|
+
{offered.length > 1 && (
|
|
483
|
+
<button type="button" style={BUTTON_STYLE} onClick={() => choose(selected.filter((purpose) => offered.includes(purpose)))}>{save}</button>
|
|
484
|
+
)}
|
|
485
|
+
<button type="button" style={BUTTON_STYLE} onClick={() => choose(offered)}>{acceptAll}</button>
|
|
486
|
+
</div>
|
|
487
|
+
</section>
|
|
488
|
+
);
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
/** The reopen affordance: always reachable once a visitor decided, so every choice can be changed. */
|
|
492
|
+
export function WebsiteConsentSettingsButton(): ReactNode {
|
|
493
|
+
const consent = useWebsiteConsent();
|
|
494
|
+
const manage = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.MANAGE);
|
|
495
|
+
return (
|
|
496
|
+
<button type="button" data-website-consent-manage="" style={BUTTON_STYLE} onClick={consent.openSettings}>
|
|
497
|
+
{manage}
|
|
498
|
+
</button>
|
|
250
499
|
);
|
|
251
500
|
}
|
|
252
|
-
WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
253
501
|
```
|
|
254
502
|
|
|
503
|
+
## References
|
|
504
|
+
|
|
255
505
|
## Import Origins
|
|
256
506
|
|
|
257
507
|
- `@wildo-ai/saas-website`
|
|
@@ -287,6 +537,14 @@ WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
|
287
537
|
* captcha so non-React tooling can detect the configured vendor
|
|
288
538
|
* without reverse-engineering app code.
|
|
289
539
|
*
|
|
540
|
+
* 4. **Provides the visitor's consent state and enforces it** (#534) —
|
|
541
|
+
* mounts `WebsiteConsentProvider`, starts a provider SDK or script only
|
|
542
|
+
* once the purpose it rests on is granted (and stops the SDK when it is
|
|
543
|
+
* withdrawn), and renders the consent panel when the site runs a
|
|
544
|
+
* consent-based provider and the visitor has not decided. Here rather
|
|
545
|
+
* than in each bridge because every page — including every blog post —
|
|
546
|
+
* renders through this layout, so no page can be mounted without it.
|
|
547
|
+
*
|
|
290
548
|
* **Why semantic `<header>` / `<main>` / `<footer>` elements**:
|
|
291
549
|
* marketing-site SEO scoring penalizes pages that ship a single
|
|
292
550
|
* unstructured `<div>` tree. Using semantic landmarks costs nothing
|
|
@@ -332,6 +590,17 @@ export interface WebsitePageLayoutProps {
|
|
|
332
590
|
* vertical-rhythm overrides on long-scroll landing pages.
|
|
333
591
|
*/
|
|
334
592
|
mainClassName?: string;
|
|
593
|
+
/**
|
|
594
|
+
* OPTIONAL anonymous-session client. When supplied, a visitor's consent decision is ALSO recorded
|
|
595
|
+
* server-side against their session, which is what lets it follow them into the account they go on
|
|
596
|
+
* to create (#1258). Pass the SAME instance the page's capture sections use, so one `uuidRef`
|
|
597
|
+
* carries the decision, the lead and the draft note together.
|
|
598
|
+
*
|
|
599
|
+
* Absent keeps today's behaviour exactly: the decision lives in this browser and nowhere else.
|
|
600
|
+
* The engine cannot construct the client here — it needs the application's own
|
|
601
|
+
* `frontendServiceName` — which is why it arrives as a prop rather than off the runtime context.
|
|
602
|
+
*/
|
|
603
|
+
consentRecorder?: WebsiteConsentRecorder;
|
|
335
604
|
/**
|
|
336
605
|
* The page's section composition. Typically a sequence of
|
|
337
606
|
* `<WebsiteSection>` wrappers around concrete section components.
|
|
@@ -339,7 +608,21 @@ export interface WebsitePageLayoutProps {
|
|
|
339
608
|
children: ReactNode;
|
|
340
609
|
}
|
|
341
610
|
|
|
342
|
-
export function WebsitePageLayout({
|
|
611
|
+
export function WebsitePageLayout(props: WebsitePageLayoutProps): ReactNode {
|
|
612
|
+
const runtime = useWebsiteRuntime();
|
|
613
|
+
// Derived from the LIVE providers, so the panel asks about exactly what this site processes.
|
|
614
|
+
const purposesInUse = useMemo(
|
|
615
|
+
() => consentPurposesInUseByProviders(runtime.frontendProviderRegistry?.modules.values()),
|
|
616
|
+
[runtime.frontendProviderRegistry],
|
|
617
|
+
);
|
|
618
|
+
return (
|
|
619
|
+
<WebsiteConsentProvider purposesInUse={purposesInUse} recorder={props.consentRecorder}>
|
|
620
|
+
<WebsitePageLayoutContent {...props} />
|
|
621
|
+
</WebsiteConsentProvider>
|
|
622
|
+
);
|
|
623
|
+
}
|
|
624
|
+
|
|
625
|
+
function WebsitePageLayoutContent({
|
|
343
626
|
pageRef,
|
|
344
627
|
header,
|
|
345
628
|
footer,
|
|
@@ -348,6 +631,7 @@ export function WebsitePageLayout({
|
|
|
348
631
|
children,
|
|
349
632
|
}: WebsitePageLayoutProps): ReactNode {
|
|
350
633
|
const runtime = useWebsiteRuntime();
|
|
634
|
+
const consent = useWebsiteConsent();
|
|
351
635
|
|
|
352
636
|
/**
|
|
353
637
|
* Defensive parse: callers should pass a `WebsitePageManifest.ref`
|
|
@@ -390,6 +674,16 @@ export function WebsitePageLayout({
|
|
|
390
674
|
return <FooterComponent />;
|
|
391
675
|
}, [footer, runtime.navigation.footerComponent]);
|
|
392
676
|
|
|
677
|
+
// Load whatever the live providers declared. Until this landed, the surface
|
|
678
|
+
// resolved provider refs and stamped them into the attributes below and
|
|
679
|
+
// stopped there — a provider could be declared, enabled and hydrated without
|
|
680
|
+
// anything of it ever running.
|
|
681
|
+
//
|
|
682
|
+
// Consent-based providers start only once their purpose is granted (#534). Before the stored decision is
|
|
683
|
+
// read, nothing is granted — the static HTML and the first render start nothing optional.
|
|
684
|
+
useWebsiteProviderScripts(runtime.frontendProviderRegistry, consent.grantedPurposes);
|
|
685
|
+
useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
|
|
686
|
+
|
|
393
687
|
const providerRootAttributes = useMemo<Record<string, string>>(() => {
|
|
394
688
|
const attrs: Record<string, string> = {};
|
|
395
689
|
const productAnalyticsProviderRef = runtime.frontendProviderRegistry
|
|
@@ -461,51 +755,281 @@ export function WebsitePageLayout({
|
|
|
461
755
|
{children}
|
|
462
756
|
</main>
|
|
463
757
|
{resolvedFooter !== null ? <footer>{resolvedFooter}</footer> : null}
|
|
758
|
+
{renderConsentSurface(consent, runtime.consentBannerComponent)}
|
|
464
759
|
</div>
|
|
465
760
|
</WebsitePageContextProvider>
|
|
466
761
|
);
|
|
467
762
|
}
|
|
468
763
|
WebsitePageLayout.displayName = 'WebsitePageLayout';
|
|
764
|
+
|
|
765
|
+
/**
|
|
766
|
+
* The panel while a decision is owed (or re-opened), the reopen button once one is made, and nothing at
|
|
767
|
+
* all on a site whose live providers rest on no consent. Nothing renders before the stored decision is
|
|
768
|
+
* read, so a visitor who already decided never sees the panel flash.
|
|
769
|
+
*/
|
|
770
|
+
function renderConsentSurface(
|
|
771
|
+
consent: ReturnType<typeof useWebsiteConsent>,
|
|
772
|
+
BannerOverride: React.ComponentType | undefined,
|
|
773
|
+
): ReactNode {
|
|
774
|
+
if (!consent.isResolved || consent.purposesInUse.length === 0) return null;
|
|
775
|
+
if (consent.status === WebsiteConsentStatus.UNDECIDED || consent.isSettingsOpen) {
|
|
776
|
+
const Banner = BannerOverride ?? WebsiteConsentBanner;
|
|
777
|
+
return <Banner />;
|
|
778
|
+
}
|
|
779
|
+
return (
|
|
780
|
+
<div data-website-consent-settings="">
|
|
781
|
+
<WebsiteConsentSettingsButton />
|
|
782
|
+
</div>
|
|
783
|
+
);
|
|
784
|
+
}
|
|
469
785
|
```
|
|
470
786
|
|
|
471
|
-
|
|
472
|
-
the override must respect; the selected application policy still owns purposes.
|
|
787
|
+
## Import Origins
|
|
473
788
|
|
|
474
|
-
|
|
789
|
+
- `@wildo-ai/saas-website`
|
|
475
790
|
|
|
476
|
-
|
|
477
|
-
session enhancements off.
|
|
478
|
-
- Changing a choice updates all consumers through the shared state, not a
|
|
479
|
-
page-local boolean.
|
|
480
|
-
- The gate states which choices are optional and where the visitor can revise
|
|
481
|
-
them.
|
|
791
|
+
## Source Excerpts
|
|
482
792
|
|
|
483
|
-
|
|
484
|
-
|---|---|
|
|
485
|
-
| Optional scripts are consent-gated | `rg -n "analytics|marketing" website/src/ | rg -v "consent"` (review every result) |
|
|
486
|
-
| No raw cookie reads in page components | `rg -n "document\.cookie" website/src/` (must be empty outside the approved adapter) |
|
|
793
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
487
794
|
|
|
488
|
-
|
|
795
|
+
```tsx
|
|
796
|
+
*
|
|
797
|
+
* `WebsiteRuntimeContext` — site-wide runtime state for the marketing
|
|
798
|
+
* surface. Created **once per page render** by the host adapter
|
|
799
|
+
* (Phase 5 `WebsitePageBridge.astro` reads `WebsiteRootConfig` and the
|
|
800
|
+
* resolved label pack from disk and calls
|
|
801
|
+
* `<WebsiteRuntimeContextProvider value={…}>` around the page tree).
|
|
802
|
+
*
|
|
803
|
+
* **Why "runtime" and not "config"**: the values here are the
|
|
804
|
+
* locale-resolved subset of `WebsiteRootConfig` — only the active
|
|
805
|
+
* locale's label pack travels with the React tree (the other locales
|
|
806
|
+
* live in their own per-locale static builds). A `*Config` name would
|
|
807
|
+
* suggest the full multi-locale surface is in scope.
|
|
808
|
+
*
|
|
809
|
+
* **Three pieces of state**:
|
|
810
|
+
*
|
|
811
|
+
* - `locale` — the currently-rendering locale. Sections that need
|
|
812
|
+
* locale-aware formatting (number/date in marketing copy is rare
|
|
813
|
+
* but legitimate) read it via `useWebsiteRuntime()`.
|
|
814
|
+
* - `labelPack` — the locale-resolved flat key→string map, validated
|
|
815
|
+
* against the manifest by `validateLabelPackAgainstManifest` at
|
|
816
|
+
* build start. Consumed by `useWebsiteLabel` and
|
|
817
|
+
* `useWebsiteLabelByKey`.
|
|
818
|
+
* - `designTokens` — the `WebsiteDesignTokens` from
|
|
819
|
+
* `WebsiteRootConfig.designTokens`. Consumed by
|
|
820
|
+
* `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that
|
|
821
|
+
* materializes them as `--website-*` custom properties on the
|
|
822
|
+
* `<WebsitePageLayout>` root.
|
|
823
|
+
* - `navigation` — the `WebsiteNavigationConfig` from
|
|
824
|
+
* `WebsiteRootConfig.navigation`. Carried in the runtime context
|
|
825
|
+
* (rather than as a separate `WebsiteNavigationContext`) because
|
|
826
|
+
* `<WebsitePageLayout>` already reads runtime state and
|
|
827
|
+
* header/footer slots are inseparable from "the site is rendering
|
|
828
|
+
* right now". A second context for two component refs would split
|
|
829
|
+
* the host-adapter's wiring surface without buying isolation.
|
|
830
|
+
* - `frontendProviderRegistry` — optional website-facing public provider
|
|
831
|
+
* registry hydrated from the materialized provider artifact for the
|
|
832
|
+
* concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /
|
|
833
|
+
* browser-monitoring integrations on the same frontend-provider
|
|
834
|
+
* contract the SaaS app now uses, instead of inventing a website-only
|
|
835
|
+
* metadata seam.
|
|
836
|
+
*
|
|
837
|
+
* **Why the hook lives in a separate file**: React Fast Refresh only
|
|
838
|
+
* preserves state for a module whose every export is a component, so
|
|
839
|
+
* a module mixing components with plain functions loses its HMR
|
|
840
|
+
* boundary. This file holds the two things that must be identical
|
|
841
|
+
* objects at runtime — the context and the provider component that
|
|
842
|
+
* writes it — while `useWebsiteRuntime` sits alone in
|
|
843
|
+
* `useWebsiteRuntime.ts`. A section author editing a component that
|
|
844
|
+
* merely READS the runtime therefore never remounts the provider.
|
|
845
|
+
*
|
|
846
|
+
* Until 2026-09-09 this paragraph described a different arrangement:
|
|
847
|
+
* that only the bare context was kept here and the provider lived in
|
|
848
|
+
* a file of its own. No such file has ever existed — the provider is
|
|
849
|
+
* exported below — and splitting it out would be the wrong shape
|
|
850
|
+
* anyway, since `useContext` matches on object identity.
|
|
851
|
+
* prose-referent-waiver: the retired file name is quoted only to retire it.
|
|
852
|
+
* The claim named `WebsiteRuntimeContextProvider.tsx`.
|
|
853
|
+
*/
|
|
854
|
+
export interface WebsiteRuntimeContextValue {
|
|
855
|
+
/**
|
|
856
|
+
* The currently-rendering locale. Marketing-site routing emits one
|
|
857
|
+
* static build per locale (D8), so this value is constant per build
|
|
858
|
+
* — never re-renders mid-session.
|
|
859
|
+
*/
|
|
860
|
+
locale: AvailableLanguage;
|
|
861
|
+
/**
|
|
862
|
+
* The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).
|
|
863
|
+
* Carried in the runtime context so client-tier components — namely
|
|
864
|
+
* `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct
|
|
865
|
+
* locale-prefixed pathname (`/pricing` on the EN site,
|
|
866
|
+
* `/fr/pricing` on the FR site) without re-importing the root
|
|
867
|
+
* config. Plumbing it through the runtime keeps the routing rule
|
|
868
|
+
* a framework-internal concern: section authors NEVER hand-prefix
|
|
869
|
+
* paths.
|
|
870
|
+
*/
|
|
871
|
+
defaultLocale: AvailableLanguage;
|
|
872
|
+
/**
|
|
873
|
+
* Origin of the application this marketing site sends visitors INTO — the
|
|
874
|
+
* marketing → product handoff target, authored once as
|
|
875
|
+
* `WildoMarketingWebsiteConfig.appOrigin` (#493).
|
|
876
|
+
*
|
|
877
|
+
* Carried here for exactly the reason `defaultLocale` above is: a
|
|
878
|
+
* `wildo.website.config.ts` is Node-loaded and therefore invisible to a
|
|
879
|
+
* client island, so before this a site resolved the app origin a SECOND
|
|
880
|
+
* time from a public build-time environment variable it could read in the
|
|
881
|
+
* browser — one host authored twice, in two files, with no mechanical link
|
|
882
|
+
* between the copies. That is how a marketing site comes to point at the
|
|
883
|
+
* wrong environment: a defect nobody notices until a customer follows the
|
|
884
|
+
* link.
|
|
885
|
+
*
|
|
886
|
+
* Threading it through the runtime keeps the handoff a framework-internal
|
|
887
|
+
* concern, the same way threading `defaultLocale` kept locale-prefixing one:
|
|
888
|
+
* section authors never hand-assemble the product URL, and there is one
|
|
889
|
+
* place to change it.
|
|
890
|
+
*/
|
|
891
|
+
appOrigin?: string;
|
|
892
|
+
/**
|
|
893
|
+
* Flat `Record<string, string>` label pack for the active locale.
|
|
894
|
+
* Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
|
|
895
|
+
* strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`
|
|
896
|
+
* which composes the full key against the page+section context.
|
|
897
|
+
*/
|
|
898
|
+
labelPack: LabelPack;
|
|
899
|
+
/**
|
|
900
|
+
* Design-token bundle for the active site. Same object referenced
|
|
901
|
+
* by `WebsiteRootConfig.designTokens`; passed by reference (not
|
|
902
|
+
* cloned) so token-aware components can rely on referential
|
|
903
|
+
* stability across renders.
|
|
904
|
+
*/
|
|
905
|
+
designTokens: WebsiteDesignTokens;
|
|
906
|
+
/**
|
|
907
|
+
* Site-wide navigation slot bindings (header / footer components).
|
|
908
|
+
* Same object referenced by `WebsiteRootConfig.navigation`. Read
|
|
909
|
+
* by `<WebsitePageLayout>` to render the chrome around each page's
|
|
910
|
+
* `<main>` content; per-page `header` / `footer` props on
|
|
911
|
+
* `<WebsitePageLayout>` override these defaults.
|
|
912
|
+
*/
|
|
913
|
+
navigation: WebsiteNavigationConfig;
|
|
914
|
+
/**
|
|
915
|
+
* Fully-composed label key the framework reads to render the
|
|
916
|
+
* "Skip to main content" affordance as the FIRST focusable element
|
|
917
|
+
* on every page (Phase 6 third audit fix M-α). Mirrors
|
|
918
|
+
* `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the
|
|
919
|
+
* runtime context (NOT re-derived from the root config inside
|
|
920
|
+
* `WebsitePageLayout`) for two reasons:
|
|
921
|
+
* - The layout is a client-tier React component; it cannot import
|
|
922
|
+
* the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging
|
|
923
|
+
* server-only code (manifest registry, page components) into
|
|
924
|
+
* the client bundle.
|
|
925
|
+
* - Threading the key through the runtime keeps the layout's
|
|
926
|
+
* contract symmetric with how every other localized text on the
|
|
927
|
+
* page is sourced (label pack + key), so the skip link is
|
|
928
|
+
* translated automatically without any per-locale branching.
|
|
929
|
+
*/
|
|
930
|
+
skipToMainContentLabelKey: WebsiteLabelKey;
|
|
931
|
+
/**
|
|
932
|
+
* Website-facing public providers for the active static website
|
|
933
|
+
* service. Optional so older tests and provider-free sites can omit
|
|
934
|
+
* it, but when present it is the canonical frontend-safe provider
|
|
935
|
+
* catalog for analytics / captcha / browser-monitoring slices.
|
|
936
|
+
*/
|
|
937
|
+
frontendProviderRegistry?: FrontendWebsiteProviderRegistry;
|
|
938
|
+
/**
|
|
939
|
+
* Replaces the framework's visitor consent panel (#534). Reads `useWebsiteConsent()`; see
|
|
940
|
+
* `WebsiteConsentBanner` for the three properties a replacement must keep. Absent uses the default.
|
|
941
|
+
* Closed over by the bridge rather than passed as an island prop, like `navigation`, because a
|
|
942
|
+
* component cannot cross Astro's serialization boundary.
|
|
943
|
+
*/
|
|
944
|
+
consentBannerComponent?: ComponentType;
|
|
945
|
+
/**
|
|
946
|
+
* Backend API origin (WITHOUT a trailing slash) that anonymous-capture
|
|
947
|
+
* sections POST to when constructing a `WebsiteAnonymousSessionClient`
|
|
948
|
+
* (lead / draft-note forms). Sourced from
|
|
949
|
+
* `WildoMarketingWebsiteConfig.apiOrigin` and passed as a
|
|
950
|
+
* JSON-serializable island prop (the `.astro` page resolves the
|
|
951
|
+
* per-environment value and forwards it).
|
|
952
|
+
*
|
|
953
|
+
* Optional because only pages that host an anonymous-capture section
|
|
954
|
+
* need it — brochure pages omit it. A capture section that reads
|
|
955
|
+
* `undefined` here surfaces a loud misconfiguration rather than
|
|
956
|
+
* silently failing to submit.
|
|
957
|
+
*/
|
|
958
|
+
apiOrigin?: string;
|
|
959
|
+
}
|
|
960
|
+
|
|
961
|
+
/**
|
|
962
|
+
* Bare React context. Default `null` — `useWebsiteRuntime()` throws
|
|
963
|
+
* with a clear error message when invoked outside of
|
|
964
|
+
* `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred
|
|
965
|
+
* over a silent default value so a missing provider is detected at
|
|
966
|
+
* the first hook call rather than at render time when a missing
|
|
967
|
+
* label silently renders as the key string.
|
|
968
|
+
*/
|
|
969
|
+
export const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =
|
|
970
|
+
createContext<WebsiteRuntimeContextValue | null>(null);
|
|
971
|
+
|
|
972
|
+
export interface WebsiteRuntimeContextProviderProps {
|
|
973
|
+
value: WebsiteRuntimeContextValue;
|
|
974
|
+
children: ReactNode;
|
|
975
|
+
}
|
|
976
|
+
|
|
977
|
+
/**
|
|
978
|
+
* Provider component. Authored as a thin wrapper so consumers do NOT
|
|
979
|
+
* have to import `WebsiteRuntimeContext.Provider` directly — the
|
|
980
|
+
* provider component carries the documented authoring API and is the
|
|
981
|
+
* Fast-Refresh-stable surface section authors compose against.
|
|
982
|
+
*/
|
|
983
|
+
export function WebsiteRuntimeContextProvider({
|
|
984
|
+
value,
|
|
985
|
+
children,
|
|
986
|
+
}: WebsiteRuntimeContextProviderProps): ReactNode {
|
|
987
|
+
return (
|
|
988
|
+
<WebsiteRuntimeContext.Provider value={value}>
|
|
989
|
+
{children}
|
|
990
|
+
</WebsiteRuntimeContext.Provider>
|
|
991
|
+
);
|
|
992
|
+
}
|
|
993
|
+
WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
994
|
+
```
|
|
995
|
+
|
|
996
|
+
## Verification
|
|
997
|
+
|
|
998
|
+
- Before any choice, the product-analytics SDK has not loaded (network panel), and the
|
|
999
|
+
panel offers only purposes the site uses, unticked.
|
|
1000
|
+
- "Decline all" leaves the site usable, the panel does not return on the next page, and
|
|
1001
|
+
the reopen link shows the stored choice.
|
|
1002
|
+
- Withdrawing a granted purpose stops the analytics client without a reload.
|
|
489
1003
|
|
|
490
1004
|
| Invariant | Command |
|
|
491
1005
|
|---|---|
|
|
492
|
-
|
|
|
493
|
-
| No raw cookie reads
|
|
1006
|
+
| No component reads consent from storage | `rg -n "__wildo_website_consent\|localStorage" website/src/` (must return nothing) |
|
|
1007
|
+
| No raw cookie reads | `rg -n "document\.cookie" website/src/` (must return nothing) |
|
|
1008
|
+
| Every locale labels the panel | `rg -c "website.chrome.consent." website/src/i18n/` (same count in every file) |
|
|
1009
|
+
| A replacement panel reaches every bridge | `rg -n "consentBannerComponent" website/src/pages-impl/` (one per bridge, or none) |
|
|
494
1010
|
|
|
495
1011
|
## Common Rationalizations
|
|
496
1012
|
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
1013
|
+
| Rationalization | Reality |
|
|
1014
|
+
|---|---|
|
|
1015
|
+
| "The banner looks compliant, so tracking is compliant." | Tracking is stopped by the layout, not the banner. A panel that calls `decide` wrongly records a consent the visitor did not give. |
|
|
1016
|
+
| "Pre-tick analytics — most visitors accept anyway." | A pre-ticked box is not a choice. The default leaves every box empty for that reason. |
|
|
1017
|
+
| "Hide Decline behind a settings screen." | Declining must be as easy as accepting; the default puts both side by side. |
|
|
1018
|
+
| "Read the stored choice directly, it is faster." | `useWebsiteConsent()` is the one reader. A second reader drifts from the record's format and misses changes from another tab. |
|
|
501
1019
|
|
|
502
1020
|
## Red Flags
|
|
503
1021
|
|
|
504
|
-
- A
|
|
505
|
-
|
|
506
|
-
-
|
|
1022
|
+
- A component reads `localStorage` or `document.cookie` for consent (catch with the
|
|
1023
|
+
storage grep above).
|
|
1024
|
+
- A replacement panel starts with boxes ticked, or has no decline action.
|
|
1025
|
+
- A locale pack lacks a `website.chrome.consent.*` key (the build refuses it; the count
|
|
1026
|
+
grep above shows it first).
|
|
1027
|
+
- An embed that tracks is rendered outside `<WebsiteConsentGate purpose={…}>`.
|
|
507
1028
|
|
|
508
1029
|
## Related Skills
|
|
509
1030
|
|
|
510
|
-
- `website-
|
|
511
|
-
|
|
1031
|
+
- `website-inbound-contact-forms` — a contact form is essential; its marketing opt-in is
|
|
1032
|
+
recorded with the submission.
|
|
1033
|
+
- `website-anonymous-session` — anonymous sessions and the marketing→app handoff.
|
|
1034
|
+
- `website-navigation-authoring` — placing a "Privacy choices" link in the footer.
|
|
1035
|
+
- `website-label-pack` — authoring the `website.chrome.*` keys.
|