@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
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/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- 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 +547 -17
- 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 +2 -2
- 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 -4
- 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 +135 -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 +208 -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 +218 -9
- 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 +374 -11
- 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 +6 -4
- 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 +22 -20
- 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 +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 +1 -6
- 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 +62 -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 +188 -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 +74 -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 +80 -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 +18 -8
- 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 +81 -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 +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- 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 +68 -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 +84 -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 +69 -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 +2 -2
- 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 -2
- 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 +78 -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 +93 -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 +104 -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 +184 -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/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/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 +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- 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 +158 -5
- 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 +173 -5
- 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 +6 -5
- 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 +9 -8
- 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 +23 -4
- 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 +6 -4
- 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 +22 -13
- 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 +193 -28
- 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 +173 -34
- 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 +3 -2
- 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 +7 -3
- 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 +183 -6
- 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 +192 -6
- 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 +3 -2
- 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 +4 -3
- 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 +173 -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 +264 -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.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/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 +3 -2
- 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 +7 -3
- 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 +3 -2
- 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 -4
- 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 +33 -5
- 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 +28 -4
- 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 +3 -3
- 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 +5 -3
- 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 +6 -4
- 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 +19 -5
- 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 +156 -5
- 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 -5
- 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 +7 -6
- 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 +28 -19
- 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 +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -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 +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- 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 +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -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 +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -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 +964 -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 +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- 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 +349 -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 +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -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 +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -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 +40 -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 +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -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 +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -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 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- 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 +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- 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 +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- 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/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- 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 +649 -10
- 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 +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- 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 +28 -22
- 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-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -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.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- 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 +46 -16
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -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 +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- 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.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -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.functional-requirement.config.md +8 -0
- 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.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- 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 +87 -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.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -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 +19 -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.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -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.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- 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.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -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-data.admin-endpoints.md +56 -2
- 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 +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -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.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -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-field-address.lookup-slot.md +74 -0
- 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.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -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 +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
- 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.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- 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 +884 -135
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- 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.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -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 +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -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 +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -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 +244 -32
- 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-submission-challenge.md +54 -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 +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -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.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
- 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 +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- 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.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
- 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/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -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 +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- 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 +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- 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 +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- 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 +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -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 +11 -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 +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- 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 +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -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 +162 -8
- 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 +518 -132
- 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 +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- 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-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +44 -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 +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- 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 +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -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 +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -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 +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -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 +66 -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 +397 -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 +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -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 +192 -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 +259 -0
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -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 +100 -91
- 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 +123 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -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 +60 -27
- 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-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- 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-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -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 +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -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 +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
- 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 +198 -36
- 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/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -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/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -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 +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -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 +144 -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/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -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-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -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-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
- 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-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -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 +141 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -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 +13 -5
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -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 +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -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 +953 -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 +125 -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 +595 -45
- 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 +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -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 +1242 -31
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -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 +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -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-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -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/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -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 +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- 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 +78 -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 +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -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/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -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 +188 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -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 +3 -1
- 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 +44 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- 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 +4 -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 +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -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 +12659 -4142
- 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/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -1,6 +1,7 @@
|
|
|
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
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Website Consent Gate Overrides
|
|
@@ -19,65 +20,84 @@ Read and apply these patterns from the application-developer point of view:
|
|
|
19
20
|
|
|
20
21
|
## Overview
|
|
21
22
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
23
|
+
The marketing website already asks visitors for consent and enforces the answer.
|
|
24
|
+
`WebsitePageLayout` provides the visitor's consent state, starts a consent-based
|
|
25
|
+
provider's SDK only once the purpose it rests on is granted, stops it when consent is
|
|
26
|
+
withdrawn, and shows a panel when the site runs a consent-based provider and the
|
|
27
|
+
visitor has not decided. Because a withdrawal must stop what the grant started, a
|
|
28
|
+
consent-based provider is an SDK that declares `stoppable: true` and never a
|
|
29
|
+
`<script>` tag: the framework refuses a consent-based module that injects scripts,
|
|
30
|
+
since nothing can stop a script once it ran. This skill is for changing how that panel LOOKS, gating your
|
|
31
|
+
own consent-based content, and adding a way back to the choice — never for deciding
|
|
32
|
+
what runs without consent.
|
|
33
|
+
|
|
34
|
+
Consent is a SET of purposes (`ConsentPurpose.ANALYTICS`, `ConsentPurpose.MARKETING`),
|
|
35
|
+
each granted on its own. There is no ladder: agreeing to marketing does not imply
|
|
36
|
+
analytics.
|
|
26
37
|
|
|
27
38
|
## App Paths
|
|
28
39
|
|
|
29
40
|
| Surface | Application-relative location |
|
|
30
41
|
|---|---|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
| Consent
|
|
34
|
-
|
|
|
42
|
+
| Page bridges (where an override is plugged in) | `website/src/pages-impl/*.bridge.tsx` |
|
|
43
|
+
| A replacement consent panel | `website/src/components/**` |
|
|
44
|
+
| Consent-panel labels, every locale | `website/src/i18n/*.json` (`website.chrome.consent.*`) |
|
|
45
|
+
| Content that rests on consent (embeds, widgets) | `website/src/sections/**` |
|
|
35
46
|
|
|
36
|
-
##
|
|
47
|
+
## When to Use / When NOT to Use
|
|
37
48
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
49
|
+
- Use to restyle the panel, add a "Privacy choices" link to the footer, or hide an
|
|
50
|
+
embed until its purpose is granted.
|
|
51
|
+
- Do NOT use to make an analytics provider start without consent. Whether a provider
|
|
52
|
+
rests on consent follows from its capability (product analytics does; error
|
|
53
|
+
monitoring and captcha do not), and that classification is the framework's.
|
|
54
|
+
- A VENDOR may rest on more than its capability: a provider module declares its own
|
|
55
|
+
`consentPurposes`, which are added to the capability's purposes and can never remove
|
|
56
|
+
one (Google reCAPTCHA, which also analyses visitors for Google, rests on ANALYTICS;
|
|
57
|
+
a visitor who declines it still submits the contact form, through the engine's
|
|
58
|
+
proof of work — see the `website-inbound-contact-forms` skill).
|
|
59
|
+
The layout then starts that provider's SDK only once those purposes are granted and
|
|
60
|
+
stops it on withdrawal, and asks for them in the panel, with no change here. Such a
|
|
61
|
+
provider ships as a stoppable SDK, never as `scripts`: a consent-based module that
|
|
62
|
+
declares scripts is refused. See the
|
|
63
|
+
`provider-frontend-file-picker` skill's consent reference for the declaration.
|
|
64
|
+
- Do NOT use for the signed-in application's consent, which is stored on the person's
|
|
65
|
+
preferences and asked by the application's own consent gate.
|
|
66
|
+
|
|
67
|
+
## Decision
|
|
41
68
|
|
|
42
|
-
|
|
|
69
|
+
| You need | Use |
|
|
43
70
|
|---|---|
|
|
44
|
-
|
|
|
45
|
-
|
|
|
46
|
-
|
|
|
47
|
-
|
|
|
71
|
+
| A different look for the panel | a component passed as `consentBannerComponent` to each page bridge |
|
|
72
|
+
| Content that must not render until a purpose is granted | `<WebsiteConsentGate purpose={ConsentPurpose.MARKETING} fallback={…}>` |
|
|
73
|
+
| A provider's component on a page (an address lookup, a vendor widget) | `<WebsiteProviderComponent capability={…} providerRef={…} componentProps={…} reservedMinHeight={…}>` — it asks the provider's own consent purposes, never a `WebsiteConsentGate` around it |
|
|
74
|
+
| A form, CTA or page the visitor asked for | nothing, or `<WebsiteConsentGate>` with no purpose — essential content always renders |
|
|
75
|
+
| A link that reopens the choice | `useWebsiteConsent().openSettings()` |
|
|
76
|
+
| To know what was granted | `useWebsiteConsent()` — never storage or a cookie |
|
|
48
77
|
|
|
49
78
|
## Workflow
|
|
50
79
|
|
|
51
|
-
1. Read the
|
|
52
|
-
|
|
53
|
-
2.
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
80
|
+
1. **Read the contract.** The consent state and the gate are exported from
|
|
81
|
+
`@wildo-ai/saas-website`; see the references below.
|
|
82
|
+
2. **Replace the panel, if the look must change.** Author a component with no props
|
|
83
|
+
that reads `useWebsiteConsent()`, and pass it to every bridge:
|
|
84
|
+
`createWebsitePageBridgeIsland({ …, consentBannerComponent: BrandConsentPanel })` and
|
|
85
|
+
`createWebsiteBlogPostBridgeIsland({ …, consentBannerComponent: BrandConsentPanel })`.
|
|
86
|
+
Keep the three properties of the default: nothing pre-ticked; declining as easy as
|
|
87
|
+
accepting and recorded with `decide([])`; only `purposesInUse` offered.
|
|
88
|
+
3. **Gate consent-based content** with `<WebsiteConsentGate purpose={…}>`, and give it a
|
|
89
|
+
`fallback` that says what is withheld and calls `openSettings()`.
|
|
90
|
+
4. **Label every consent key in every locale.** The build refuses a locale pack missing
|
|
91
|
+
any `website.chrome.consent.*` key, including one purpose name per `ConsentPurpose`,
|
|
92
|
+
and any `website.chrome.provider-component.*` key (`consent-required`, `unavailable`):
|
|
93
|
+
the words a provider component's box shows when the visitor has not agreed, or when it
|
|
94
|
+
could not load.
|
|
95
|
+
5. **Test the paths** in a clean browser profile: no choice (nothing optional starts),
|
|
96
|
+
decline, accept, change of mind through the reopen link.
|
|
63
97
|
|
|
64
98
|
## Worked Example
|
|
65
99
|
|
|
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
|
|
100
|
+
The state a replacement panel reads and the actions it calls:
|
|
81
101
|
|
|
82
102
|
## Import Origins
|
|
83
103
|
|
|
@@ -89,169 +109,519 @@ export function canStartOptionalAnalytics(consent: ResolvedConsent): boolean {
|
|
|
89
109
|
|
|
90
110
|
```tsx
|
|
91
111
|
*
|
|
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).
|
|
97
|
-
*
|
|
98
|
-
* **Why "runtime" and not "config"**: the values here are the
|
|
99
|
-
* locale-resolved subset of `WebsiteRootConfig` — only the active
|
|
100
|
-
* locale's label pack travels with the React tree (the other locales
|
|
101
|
-
* live in their own per-locale static builds). A `*Config` name would
|
|
102
|
-
* suggest the full multi-locale surface is in scope.
|
|
112
|
+
* `WebsiteConsentContext` — a website visitor's consent state (#534), provided once per page by
|
|
113
|
+
* `WebsitePageLayout`.
|
|
103
114
|
*
|
|
104
|
-
*
|
|
115
|
+
* Consent is a SET of `ConsentPurpose`s, each granted or not on its own. Nothing optional runs until its
|
|
116
|
+
* purpose is granted: the layout's provider SDKs and scripts read `grantedPurposes`, and so does
|
|
117
|
+
* `<WebsiteConsentGate purpose={…}>`.
|
|
105
118
|
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
108
|
-
*
|
|
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.
|
|
119
|
+
* `purposesInUse` is DERIVED from the live providers (`consentPurposesInUseByProviders`), so the panel asks
|
|
120
|
+
* about exactly the purposes this site processes and nothing else. A site running no consent-based
|
|
121
|
+
* provider shows no panel at all.
|
|
139
122
|
*/
|
|
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;
|
|
123
|
+
export enum WebsiteConsentStatus {
|
|
124
|
+
/** The visitor has not decided — or their decision cannot be read. Nothing optional runs. */
|
|
125
|
+
UNDECIDED = 'undecided',
|
|
126
|
+
/** The visitor decided; `grantedPurposes` is their answer, possibly empty. */
|
|
127
|
+
DECIDED = 'decided',
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
export interface WebsiteConsentContextValue {
|
|
131
|
+
status: WebsiteConsentStatus;
|
|
180
132
|
/**
|
|
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.
|
|
133
|
+
* `false` during the server render and the first client render, before storage has been read. A
|
|
134
|
+
* consent panel must not render while this is false: it would flash for a visitor who already decided,
|
|
135
|
+
* and differ from the static HTML. Optional behaviour stays off either way.
|
|
195
136
|
*/
|
|
196
|
-
|
|
137
|
+
isResolved: boolean;
|
|
138
|
+
/** What the visitor granted. Empty while UNDECIDED. */
|
|
139
|
+
grantedPurposes: readonly ConsentPurpose[];
|
|
140
|
+
/** When the visitor decided, ISO-8601; absent while UNDECIDED. */
|
|
141
|
+
decidedAt?: string;
|
|
142
|
+
/** The purposes this site's live providers rest on — what a consent panel offers. */
|
|
143
|
+
purposesInUse: readonly ConsentPurpose[];
|
|
144
|
+
/** Whether the visitor re-opened the panel to change a decision already made. */
|
|
145
|
+
isSettingsOpen: boolean;
|
|
146
|
+
/** Whether `purpose` is granted. */
|
|
147
|
+
hasGranted: (purpose: ConsentPurpose) => boolean;
|
|
148
|
+
/** Record the WHOLE set the visitor grants — a purpose left out is not granted. Closes the panel. */
|
|
149
|
+
decide: (grantedPurposes: readonly ConsentPurpose[]) => void;
|
|
150
|
+
/** Re-open the panel so the visitor can change their decision. */
|
|
151
|
+
openSettings: () => void;
|
|
152
|
+
/** Close a re-opened panel without changing anything. */
|
|
153
|
+
closeSettings: () => void;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
export const WebsiteConsentContext: React.Context<WebsiteConsentContextValue | null> = createContext<WebsiteConsentContextValue | null>(null);
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* The narrow slice of `WebsiteAnonymousSessionClient` this provider needs, declared structurally
|
|
160
|
+
* rather than imported (#1258).
|
|
161
|
+
*
|
|
162
|
+
* Structural because the provider does not want the client's construction concerns — an `apiOrigin`
|
|
163
|
+
* and the application's own `frontendServiceName`, which only the application knows — and because it
|
|
164
|
+
* makes the durable write trivially substitutable in a test.
|
|
165
|
+
*/
|
|
166
|
+
export interface WebsiteConsentRecorder {
|
|
197
167
|
/**
|
|
198
|
-
*
|
|
199
|
-
*
|
|
200
|
-
*
|
|
201
|
-
*
|
|
168
|
+
* NOT generic, deliberately, though `WebsiteAnonymousSessionClient.requestAnonymous` is: this
|
|
169
|
+
* provider ignores the response entirely, so a type parameter here would be a promise to the caller
|
|
170
|
+
* that nothing keeps. The client's generic method satisfies this shape structurally.
|
|
171
|
+
*
|
|
172
|
+
* It takes the METHOD rather than being named after one. The consent door is a PUT — its operation
|
|
173
|
+
* borrows `UPDATE_MANY` — and this interface previously named `postAnonymous`, so every decision a
|
|
174
|
+
* visitor made 404'd, silently, by this provider's own (correct) design of never telling a visitor
|
|
175
|
+
* their privacy choice failed. A door's method is part of its address, so it is passed like one.
|
|
202
176
|
*/
|
|
203
|
-
|
|
177
|
+
requestAnonymous(method: string, path: string, body: unknown): Promise<unknown>;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
export interface WebsiteConsentProviderProps {
|
|
181
|
+
purposesInUse: readonly ConsentPurpose[];
|
|
204
182
|
/**
|
|
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).
|
|
183
|
+
* OPTIONAL. When present, a decision is ALSO recorded server-side against the visitor's anonymous
|
|
184
|
+
* session, which is what lets it follow them into the account they go on to create (#1258).
|
|
211
185
|
*
|
|
212
|
-
*
|
|
213
|
-
*
|
|
214
|
-
*
|
|
215
|
-
* silently failing to submit.
|
|
186
|
+
* Absent is a first-class answer and is exactly today's behaviour: the decision lives in this
|
|
187
|
+
* browser and nowhere else. A site with no anonymous-session wiring keeps working, gates the same
|
|
188
|
+
* way, and simply carries nothing forward.
|
|
216
189
|
*/
|
|
217
|
-
|
|
190
|
+
recorder?: WebsiteConsentRecorder;
|
|
191
|
+
children: ReactNode;
|
|
218
192
|
}
|
|
219
193
|
|
|
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);
|
|
194
|
+
export function WebsiteConsentProvider({ purposesInUse, recorder, children }: WebsiteConsentProviderProps): ReactNode {
|
|
195
|
+
const [record, setRecord] = useState<WebsiteVisitorConsentRecord | null>(null);
|
|
196
|
+
const [isResolved, setIsResolved] = useState(false);
|
|
197
|
+
const [isSettingsOpen, setIsSettingsOpen] = useState(false);
|
|
230
198
|
|
|
231
|
-
|
|
232
|
-
|
|
199
|
+
// Read after mount, never during render: the static HTML was produced with no storage at all.
|
|
200
|
+
useEffect(() => {
|
|
201
|
+
setRecord(readWebsiteVisitorConsent());
|
|
202
|
+
setIsResolved(true);
|
|
203
|
+
return subscribeWebsiteVisitorConsent(() => setRecord(readWebsiteVisitorConsent()));
|
|
204
|
+
}, []);
|
|
205
|
+
|
|
206
|
+
const decide = useCallback((grantedPurposes: readonly ConsentPurpose[]): void => {
|
|
207
|
+
/*
|
|
208
|
+
* Local storage FIRST, and it is what gates this page (D6). The site is statically built, so a
|
|
209
|
+
* refusal that only held while an API answered would not hold at all — and the visitor's panel
|
|
210
|
+
* must close on their click, not on a round trip.
|
|
211
|
+
*/
|
|
212
|
+
setRecord(writeWebsiteVisitorConsent(grantedPurposes));
|
|
213
|
+
setIsSettingsOpen(false);
|
|
214
|
+
|
|
215
|
+
/*
|
|
216
|
+
* Then the DURABLE copy, best-effort. This is the one that survives the browser and is carried
|
|
217
|
+
* onto the account at signup; its failure changes nothing the visitor can see, so it is never
|
|
218
|
+
* awaited and never surfaced.
|
|
219
|
+
*
|
|
220
|
+
* `purposesInUse` is sent as the OFFERED set — what this panel actually put in front of them.
|
|
221
|
+
* Without it the application could not tell a declined purpose from one this site never asked
|
|
222
|
+
* about, and would record a decision the visitor never made
|
|
223
|
+
* (`AnonymousUserPrivacySchema.offeredPurposes`).
|
|
224
|
+
*/
|
|
225
|
+
if (recorder !== undefined && purposesInUse.length > 0) {
|
|
226
|
+
void recorder
|
|
227
|
+
.requestAnonymous(ANONYMOUS_CONSENT_RECORD_METHOD, ANONYMOUS_CONSENT_RECORD_PATH, {
|
|
228
|
+
grantedPurposes: [...grantedPurposes],
|
|
229
|
+
offeredPurposes: [...purposesInUse],
|
|
230
|
+
})
|
|
231
|
+
.catch(() => {
|
|
232
|
+
/*
|
|
233
|
+
* Deliberately silent. The decision HELD — it is in this browser and gating this page. All
|
|
234
|
+
* that is lost is the carry, and telling a visitor their privacy choice failed when it did
|
|
235
|
+
* not would be worse than losing it.
|
|
236
|
+
*/
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
}, [recorder, purposesInUse]);
|
|
240
|
+
const openSettings = useCallback((): void => setIsSettingsOpen(true), []);
|
|
241
|
+
const closeSettings = useCallback((): void => setIsSettingsOpen(false), []);
|
|
242
|
+
|
|
243
|
+
const value = useMemo<WebsiteConsentContextValue>(() => {
|
|
244
|
+
const grantedPurposes = record?.grantedPurposes ?? [];
|
|
245
|
+
return {
|
|
246
|
+
status: record === null ? WebsiteConsentStatus.UNDECIDED : WebsiteConsentStatus.DECIDED,
|
|
247
|
+
isResolved,
|
|
248
|
+
grantedPurposes,
|
|
249
|
+
...(record !== null ? { decidedAt: record.decidedAt } : {}),
|
|
250
|
+
purposesInUse,
|
|
251
|
+
isSettingsOpen,
|
|
252
|
+
hasGranted: (purpose) => grantedPurposes.includes(purpose),
|
|
253
|
+
decide,
|
|
254
|
+
openSettings,
|
|
255
|
+
closeSettings,
|
|
256
|
+
};
|
|
257
|
+
}, [record, isResolved, purposesInUse, isSettingsOpen, decide, openSettings, closeSettings]);
|
|
258
|
+
|
|
259
|
+
return <WebsiteConsentContext.Provider value={value}>{children}</WebsiteConsentContext.Provider>;
|
|
260
|
+
}
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
Gating content that rests on a purpose:
|
|
264
|
+
|
|
265
|
+
## Import Origins
|
|
266
|
+
|
|
267
|
+
- `@wildo-ai/saas-website`
|
|
268
|
+
|
|
269
|
+
## Source Excerpts
|
|
270
|
+
|
|
271
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
272
|
+
|
|
273
|
+
```tsx
|
|
274
|
+
*
|
|
275
|
+
* `<WebsiteConsentGate>` — renders its children only when the visitor's consent allows it (#534).
|
|
276
|
+
*
|
|
277
|
+
* - **No `purpose`** — the content is ESSENTIAL and always renders. This is the right wrapper for a
|
|
278
|
+
* contact form: submitting a form the visitor chose to fill in never depends on optional consent, and the
|
|
279
|
+
* form's own opt-ins (marketing) are recorded with the submission, not here.
|
|
280
|
+
* - **`purpose`** — the content rests on that purpose (an embedded video that tracks, a chat widget, a
|
|
281
|
+
* marketing pixel). It renders only once the visitor granted it; until then `fallback` renders — a
|
|
282
|
+
* placeholder that says what is withheld and offers `useWebsiteConsent().openSettings()`.
|
|
283
|
+
*
|
|
284
|
+
* It renders `fallback` during the server render and before the stored decision is read, so a static page
|
|
285
|
+
* never ships consent-based content in its HTML.
|
|
286
|
+
*/
|
|
287
|
+
export interface WebsiteConsentGateProps {
|
|
288
|
+
/** The purpose the children rest on. Omit for essential content. */
|
|
289
|
+
purpose?: ConsentPurpose;
|
|
290
|
+
/** Rendered in place of consent-based children until the purpose is granted. Defaults to nothing. */
|
|
291
|
+
fallback?: ReactNode;
|
|
233
292
|
children: ReactNode;
|
|
234
293
|
}
|
|
235
294
|
|
|
295
|
+
export function WebsiteConsentGate({ purpose, fallback = null, children }: WebsiteConsentGateProps): ReactNode {
|
|
296
|
+
const consent = useWebsiteConsent();
|
|
297
|
+
if (purpose === undefined) return <>{children}</>;
|
|
298
|
+
return <>{consent.isResolved && consent.hasGranted(purpose) ? children : fallback}</>;
|
|
299
|
+
}
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
The default panel, whose three properties a replacement keeps:
|
|
303
|
+
|
|
304
|
+
## Import Origins
|
|
305
|
+
|
|
306
|
+
- `@wildo-ai/saas-website`
|
|
307
|
+
|
|
308
|
+
## Source Excerpts
|
|
309
|
+
|
|
310
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
311
|
+
|
|
312
|
+
```tsx
|
|
313
|
+
*
|
|
314
|
+
* `WebsiteConsentBanner` — the framework's default visitor consent panel (#534).
|
|
315
|
+
*
|
|
316
|
+
* Rendered by `WebsitePageLayout` when the site runs a consent-based provider and the visitor has not
|
|
317
|
+
* decided, or re-opened the panel. A site replaces it by passing `consentBannerComponent` to its bridge
|
|
318
|
+
* island; a replacement reads `useWebsiteConsent()` exactly as this one does and must keep its three
|
|
319
|
+
* properties:
|
|
320
|
+
*
|
|
321
|
+
* 1. **No box is pre-ticked.** A pre-ticked box is not a choice.
|
|
322
|
+
* 2. **Declining is as easy as accepting**, and is RECORDED — so the panel does not return on every page.
|
|
323
|
+
* 3. **Only purposes in use are offered** (`purposesInUse`), each named by its label.
|
|
324
|
+
*
|
|
325
|
+
* Styled only through the site's `--website-*` design tokens, like the skip link, so it needs no
|
|
326
|
+
* stylesheet and cannot be shadowed by a utility class.
|
|
327
|
+
*/
|
|
328
|
+
function useWebsiteConsentSlotLabel(slot: WebsiteConsentLabelSlot): string {
|
|
329
|
+
return useWebsiteLabelByKey(websiteConsentLabelKey(slot));
|
|
330
|
+
}
|
|
331
|
+
|
|
236
332
|
/**
|
|
237
|
-
*
|
|
238
|
-
*
|
|
239
|
-
*
|
|
240
|
-
*
|
|
333
|
+
* Every row has the SAME shape: the control, then the name on its line, then the explanation beneath
|
|
334
|
+
* the NAME rather than beneath the control — a two-column grid, so the second line starts where the
|
|
335
|
+
* first line's words do and the row stays scannable.
|
|
336
|
+
*
|
|
337
|
+
* That includes the row that cannot be changed, which carries a real checkbox, CHECKED and DISABLED,
|
|
338
|
+
* rather than a text status. A person scanning the panel reads DOWN the column of controls, and a row
|
|
339
|
+
* whose control is missing does not read as "cannot be changed" — it reads as a row that was
|
|
340
|
+
* forgotten. A checked, disabled box says it in the vocabulary the rest of the list already uses, and
|
|
341
|
+
* a screen reader announces "checked, unavailable" without any extra words.
|
|
241
342
|
*/
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
343
|
+
const ROW_STYLE: React.CSSProperties = {
|
|
344
|
+
display: 'grid',
|
|
345
|
+
gridTemplateColumns: 'auto 1fr',
|
|
346
|
+
columnGap: '0.625rem',
|
|
347
|
+
alignItems: 'center',
|
|
348
|
+
padding: '0.5rem 0.75rem',
|
|
349
|
+
borderBottom: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`,
|
|
350
|
+
};
|
|
351
|
+
|
|
352
|
+
const ROW_DESCRIPTION_STYLE: React.CSSProperties = { margin: 0, gridColumn: 2, fontSize: '0.75rem', opacity: 0.8 };
|
|
353
|
+
|
|
354
|
+
/** Slightly larger than a default box: this is the one control the whole panel exists to offer. */
|
|
355
|
+
const ROW_CONTROL_STYLE: React.CSSProperties = { width: '1.15rem', height: '1.15rem' };
|
|
356
|
+
|
|
357
|
+
/**
|
|
358
|
+
* One purpose: its NAME, what agreeing to it MEANS for this visitor, and the control.
|
|
359
|
+
*
|
|
360
|
+
* The explanation is the half that was missing. A tick box labelled "Analytics" is a category, not
|
|
361
|
+
* something a visitor can weigh, and consent is only valid if it is informed — which is why every
|
|
362
|
+
* specialized consent platform pairs the two and why the label key is derived from the vocabulary,
|
|
363
|
+
* so a purpose can never arrive with a name and no explanation.
|
|
364
|
+
*/
|
|
365
|
+
function PurposeChoice({ purpose, checked, onChange }: { purpose: ConsentPurpose; checked: boolean; onChange: (checked: boolean) => void }): ReactNode {
|
|
366
|
+
const label = useWebsiteLabelByKey(websiteConsentPurposeLabelKey(purpose));
|
|
367
|
+
const description = useWebsiteLabelByKey(websiteConsentPurposeDescriptionLabelKey(purpose));
|
|
246
368
|
return (
|
|
247
|
-
<
|
|
248
|
-
{
|
|
249
|
-
|
|
369
|
+
<label data-website-consent-purpose={purpose} style={{ ...ROW_STYLE, cursor: 'pointer' }}>
|
|
370
|
+
<input type="checkbox" checked={checked} style={ROW_CONTROL_STYLE} onChange={(event) => onChange(event.target.checked)} />
|
|
371
|
+
<span style={{ fontWeight: 600 }}>{label}</span>
|
|
372
|
+
<span style={ROW_DESCRIPTION_STYLE}>{description}</span>
|
|
373
|
+
</label>
|
|
374
|
+
);
|
|
375
|
+
}
|
|
376
|
+
|
|
377
|
+
const BUTTON_STYLE: React.CSSProperties = {
|
|
378
|
+
padding: '0.5rem 1rem',
|
|
379
|
+
borderRadius: websiteDesignTokenCssVar('radii', 'md', '0.375rem'),
|
|
380
|
+
border: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`,
|
|
381
|
+
background: websiteDesignTokenCssVar('colors', 'background', '#fff'),
|
|
382
|
+
color: websiteDesignTokenCssVar('colors', 'foreground', '#000'),
|
|
383
|
+
cursor: 'pointer',
|
|
384
|
+
};
|
|
385
|
+
|
|
386
|
+
export function WebsiteConsentBanner(): ReactNode {
|
|
387
|
+
const consent = useWebsiteConsent();
|
|
388
|
+
const headingId = useId();
|
|
389
|
+
const [selected, setSelected] = useState<readonly ConsentPurpose[]>(consent.grantedPurposes);
|
|
390
|
+
// Re-seed from the stored decision each time the panel is re-opened, so it shows what is in force.
|
|
391
|
+
useEffect(() => setSelected(consent.grantedPurposes), [consent.grantedPurposes, consent.isSettingsOpen]);
|
|
392
|
+
|
|
393
|
+
const title = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.TITLE);
|
|
394
|
+
const description = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.DESCRIPTION);
|
|
395
|
+
const acceptAll = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ACCEPT_ALL);
|
|
396
|
+
const declineAll = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.DECLINE_ALL);
|
|
397
|
+
const save = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.SAVE);
|
|
398
|
+
const essentialTitle = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ESSENTIAL_TITLE);
|
|
399
|
+
const essentialDescription = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.ESSENTIAL_DESCRIPTION);
|
|
400
|
+
|
|
401
|
+
const offered = consent.purposesInUse;
|
|
402
|
+
// Purposes the panel does not offer keep their stored grant; offered ones are granted exactly when ticked.
|
|
403
|
+
const choose = (chosen: readonly ConsentPurpose[]): void =>
|
|
404
|
+
consent.decide([...consent.grantedPurposes.filter((purpose) => !offered.includes(purpose)), ...chosen]);
|
|
405
|
+
|
|
406
|
+
return (
|
|
407
|
+
<section
|
|
408
|
+
role="region"
|
|
409
|
+
aria-labelledby={headingId}
|
|
410
|
+
data-website-consent-banner={consent.status === WebsiteConsentStatus.UNDECIDED ? 'undecided' : 'settings'}
|
|
411
|
+
style={{
|
|
412
|
+
/*
|
|
413
|
+
* BOTTOM-RIGHT CORNER, and the three properties together are what make that work on a phone
|
|
414
|
+
* too. `left` and `right` both bound the box to the viewport with a gutter; `maxWidth` caps it
|
|
415
|
+
* on a wide screen; `marginLeft: auto` pushes the remaining slack to the left so the box hugs
|
|
416
|
+
* the right edge. On a narrow screen the gutters bind before the cap does and it simply spans
|
|
417
|
+
* the width — a corner popup that overflowed a phone would be worse than a bar.
|
|
418
|
+
*
|
|
419
|
+
* Inline styles, not a media query: this ships into a static marketing page with no stylesheet
|
|
420
|
+
* of its own, which is the same constraint that keeps the rest of this file inline.
|
|
421
|
+
*/
|
|
422
|
+
position: 'fixed',
|
|
423
|
+
left: '1rem',
|
|
424
|
+
right: '1rem',
|
|
425
|
+
bottom: '1rem',
|
|
426
|
+
zIndex: 9000,
|
|
427
|
+
maxWidth: '30rem',
|
|
428
|
+
marginLeft: 'auto',
|
|
429
|
+
/*
|
|
430
|
+
* The panel never exceeds the viewport, and its ACTIONS are never what gets cut off: the rows
|
|
431
|
+
* scroll inside `maxHeight`, the buttons sit outside that box. A panel that grows with its
|
|
432
|
+
* content pushes accept and reject off the bottom of a short screen — and a refusal that
|
|
433
|
+
* cannot be reached is a refusal that was not offered, whatever the markup says. `dvh` rather
|
|
434
|
+
* than `vh` because a mobile browser's toolbars make `vh` taller than the visible page.
|
|
435
|
+
*/
|
|
436
|
+
maxHeight: '85dvh',
|
|
437
|
+
padding: '0.875rem 1rem',
|
|
438
|
+
display: 'flex',
|
|
439
|
+
flexDirection: 'column',
|
|
440
|
+
gap: '0.625rem',
|
|
441
|
+
background: websiteDesignTokenCssVar('colors', 'surface', '#fff'),
|
|
442
|
+
color: websiteDesignTokenCssVar('colors', 'surfaceForeground', '#000'),
|
|
443
|
+
border: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`,
|
|
444
|
+
borderRadius: websiteDesignTokenCssVar('radii', 'lg', '0.5rem'),
|
|
445
|
+
}}
|
|
446
|
+
>
|
|
447
|
+
<h2 id={headingId} style={{ margin: 0, fontSize: '1.125rem' }}>{title}</h2>
|
|
448
|
+
<p style={{ margin: 0 }}>{description}</p>
|
|
449
|
+
{/* `data-website-consent-rows` is the scroll box's own hook. A test anchoring on a style
|
|
450
|
+
substring instead matched the ROW (whose grid template also contains "auto") and asserted
|
|
451
|
+
nothing — the same vacuous pin the app tier already had to repair. */}
|
|
452
|
+
<div
|
|
453
|
+
data-website-consent-rows=""
|
|
454
|
+
style={{ minHeight: 0, flex: 1, overflowY: 'auto', border: `1px solid ${websiteDesignTokenCssVar('colors', 'border', '#ccc')}`, borderRadius: websiteDesignTokenCssVar('radii', 'md', '0.375rem') }}
|
|
455
|
+
>
|
|
456
|
+
{/*
|
|
457
|
+
* The always-active row, first, carrying a CHECKED and DISABLED box. It is not a purpose the
|
|
458
|
+
* visitor decides — which is exactly why it is stated: a panel listing only the optional
|
|
459
|
+
* purposes leaves them unable to see what is happening on the site at all, which is the
|
|
460
|
+
* question they opened it to answer.
|
|
461
|
+
*
|
|
462
|
+
* It carried a text status instead until 2026-09-20, on the argument that a disabled control
|
|
463
|
+
* invites a click that cannot work. The reversal: a visitor scans DOWN the column of boxes,
|
|
464
|
+
* and a gap there does not read as "cannot be changed", it reads as a row that was
|
|
465
|
+
* forgotten. A disabled box says it in the vocabulary the rest of the list already uses.
|
|
466
|
+
*/}
|
|
467
|
+
<div data-website-consent-essential="" style={ROW_STYLE}>
|
|
468
|
+
{/*
|
|
469
|
+
* `aria-label`, because this row is a `div` rather than a `<label>` — nothing else names
|
|
470
|
+
* the control, and a checkbox with no accessible name is announced as an unlabelled
|
|
471
|
+
* checkbox. Its own note claimed AT would announce "checked, unavailable"; it announced
|
|
472
|
+
* no words at all.
|
|
473
|
+
*
|
|
474
|
+
* `readOnly` is gone: it is inert on a checkbox per HTML, and leaving it invites a later
|
|
475
|
+
* reader to delete `disabled` believing the lock survives.
|
|
476
|
+
*/}
|
|
477
|
+
<input type="checkbox" checked disabled aria-label={essentialTitle} style={ROW_CONTROL_STYLE} />
|
|
478
|
+
<span style={{ fontWeight: 600 }}>{essentialTitle}</span>
|
|
479
|
+
<span style={ROW_DESCRIPTION_STYLE}>{essentialDescription}</span>
|
|
480
|
+
</div>
|
|
481
|
+
{offered.map((purpose) => (
|
|
482
|
+
<PurposeChoice
|
|
483
|
+
key={purpose}
|
|
484
|
+
purpose={purpose}
|
|
485
|
+
checked={selected.includes(purpose)}
|
|
486
|
+
onChange={(checked) => setSelected((current) => (checked ? [...current.filter((entry) => entry !== purpose), purpose] : current.filter((entry) => entry !== purpose)))}
|
|
487
|
+
/>
|
|
488
|
+
))}
|
|
489
|
+
</div>
|
|
490
|
+
<div style={{ display: 'flex', flexWrap: 'wrap', gap: '0.5rem', justifyContent: 'flex-end' }}>
|
|
491
|
+
<button type="button" style={BUTTON_STYLE} onClick={() => choose([])}>{declineAll}</button>
|
|
492
|
+
{/*
|
|
493
|
+
* SAVE appears only when a MIXED choice exists to save — two or more purposes in use.
|
|
494
|
+
*
|
|
495
|
+
* With one purpose the button is unanswerable: "decline all" and "accept all" already cover
|
|
496
|
+
* the whole space, so a third action beside them describes nothing a visitor can picture and
|
|
497
|
+
* reads as a question rather than an answer. Derived from the offered set, so a site that
|
|
498
|
+
* adds a second purpose gets the control with no edit here.
|
|
499
|
+
*/}
|
|
500
|
+
{offered.length > 1 && (
|
|
501
|
+
<button type="button" style={BUTTON_STYLE} onClick={() => choose(selected.filter((purpose) => offered.includes(purpose)))}>{save}</button>
|
|
502
|
+
)}
|
|
503
|
+
<button type="button" style={BUTTON_STYLE} onClick={() => choose(offered)}>{acceptAll}</button>
|
|
504
|
+
</div>
|
|
505
|
+
</section>
|
|
506
|
+
);
|
|
507
|
+
}
|
|
508
|
+
|
|
509
|
+
/** The reopen affordance: always reachable once a visitor decided, so every choice can be changed. */
|
|
510
|
+
export function WebsiteConsentSettingsButton(): ReactNode {
|
|
511
|
+
const consent = useWebsiteConsent();
|
|
512
|
+
const manage = useWebsiteConsentSlotLabel(WebsiteConsentLabelSlot.MANAGE);
|
|
513
|
+
return (
|
|
514
|
+
<button type="button" data-website-consent-manage="" style={BUTTON_STYLE} onClick={consent.openSettings}>
|
|
515
|
+
{manage}
|
|
516
|
+
</button>
|
|
250
517
|
);
|
|
251
518
|
}
|
|
252
|
-
WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
253
519
|
```
|
|
254
520
|
|
|
521
|
+
A provider's component, placed on a page. Its box renders on the server with nothing of the
|
|
522
|
+
vendor in it, asks the provider's consent purposes before downloading anything, names the
|
|
523
|
+
missing purposes and offers the panel, and loads in place once the visitor agrees:
|
|
524
|
+
|
|
525
|
+
## Import Origins
|
|
526
|
+
|
|
527
|
+
- `@wildo-ai/saas-website`
|
|
528
|
+
|
|
529
|
+
## Source Excerpts
|
|
530
|
+
|
|
531
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
532
|
+
|
|
533
|
+
```tsx
|
|
534
|
+
*
|
|
535
|
+
* `<WebsiteProviderComponent>` — places ONE provider's component on a website page (#1703): an
|
|
536
|
+
* address lookup on a contact form, a vendor widget on a marketing page. The component comes from the
|
|
537
|
+
* provider's own `components[capability]` declaration, the same one the application reads, through
|
|
538
|
+
* the website's provider-component registry.
|
|
539
|
+
*
|
|
540
|
+
* What it guarantees, so a page does not have to:
|
|
541
|
+
*
|
|
542
|
+
* - **Nothing of the vendor reaches the static HTML.** The component loads from an effect, which never
|
|
543
|
+
* runs during the Astro server render, and the registry itself refuses to load where there is no
|
|
544
|
+
* browser document. The server renders only the reserved box.
|
|
545
|
+
* - **No layout shift.** `reservedMinHeight` applies to the box in EVERY state — the server
|
|
546
|
+
* placeholder, loading, the refusals and the loaded component — so the page does not jump when the
|
|
547
|
+
* component arrives. Set it to the component's rendered height.
|
|
548
|
+
* - **The vendor's scripts load with the component**, not on every page: the layout injects at startup
|
|
549
|
+
* only the scripts of providers that contribute no component.
|
|
550
|
+
* - **Consent before download.** A provider resting on a purpose the visitor has not granted downloads
|
|
551
|
+
* nothing; the box states that the feature is off, names the purposes it rests on, and offers the
|
|
552
|
+
* consent panel (`openSettings`). Granting there loads the component in place.
|
|
553
|
+
* - **Announced, and operable by keyboard.** The box holds a `role="status"` live region from the first
|
|
554
|
+
* render, so a refusal is announced when it appears; the consent button sits outside it, so it is not
|
|
555
|
+
* read out as part of the message, and is a real button.
|
|
556
|
+
* - **A failure says so.** A component that could not load renders the site's `unavailable` wording,
|
|
557
|
+
* never a blank. A provider that offers no component here (left off in this environment) renders the
|
|
558
|
+
* empty box, since there is nothing to retry.
|
|
559
|
+
*
|
|
560
|
+
* The words come from the site's label pack: `website.chrome.provider-component.consent-required` and
|
|
561
|
+
* `.unavailable` are framework-owned keys every pack must carry, and the purpose names and the button
|
|
562
|
+
* reuse the consent panel's keys. Pass `renderConsentRequired` to word the refusal in the page's own
|
|
563
|
+
* chrome instead; it receives the missing purposes and the action that opens the panel, and then owns
|
|
564
|
+
* its own announcement.
|
|
565
|
+
*
|
|
566
|
+
* It does not choose a provider. Pass the ref the page chose — `useWebsiteProviderComponentChoices`
|
|
567
|
+
* lists the candidates — or `undefined` while nothing is chosen.
|
|
568
|
+
*/
|
|
569
|
+
export interface WebsiteProviderComponentProps<TProps extends object> {
|
|
570
|
+
/** The capability the component fills, e.g. `FRONTEND_ADDRESS_LOOKUP`. */
|
|
571
|
+
capability: ProviderCapability;
|
|
572
|
+
/** The provider the page chose, or `undefined` while nothing is chosen. */
|
|
573
|
+
providerRef: string | undefined;
|
|
574
|
+
/** The props the loaded component receives — the capability's slot contract. */
|
|
575
|
+
componentProps: TProps;
|
|
576
|
+
/** CSS length reserved for the box in every state, so the page does not shift when the component loads. */
|
|
577
|
+
reservedMinHeight?: string;
|
|
578
|
+
/** Replaces the default consent-required state. */
|
|
579
|
+
renderConsentRequired?: (input: { missingPurposes: readonly ConsentPurpose[]; openConsentSettings: () => void }) => ReactNode;
|
|
580
|
+
}
|
|
581
|
+
|
|
582
|
+
export function WebsiteProviderComponent<TProps extends object>({
|
|
583
|
+
capability,
|
|
584
|
+
providerRef,
|
|
585
|
+
componentProps,
|
|
586
|
+
reservedMinHeight,
|
|
587
|
+
renderConsentRequired,
|
|
588
|
+
}: WebsiteProviderComponentProps<TProps>): ReactNode {
|
|
589
|
+
const consent = useWebsiteConsent();
|
|
590
|
+
const { status, Component, missingConsentPurposes } = useWebsiteProviderComponent(capability, providerRef);
|
|
591
|
+
|
|
592
|
+
const isReady = status === ProviderComponentStatus.READY && Component !== null;
|
|
593
|
+
const isConsentRequired = status === ProviderComponentStatus.CONSENT_REQUIRED;
|
|
594
|
+
const isUnavailable = status === ProviderComponentStatus.UNAVAILABLE;
|
|
595
|
+
const useDefaultRefusal = isUnavailable || (isConsentRequired && renderConsentRequired === undefined);
|
|
596
|
+
// The registry cannot know a capability's props; the page states them through `componentProps`.
|
|
597
|
+
const Loaded = isReady ? (Component as unknown as React.ComponentType<TProps>) : null;
|
|
598
|
+
|
|
599
|
+
return (
|
|
600
|
+
<div
|
|
601
|
+
data-website-provider-component={capability}
|
|
602
|
+
data-website-provider-component-state={status}
|
|
603
|
+
aria-busy={status === ProviderComponentStatus.LOADING ? true : undefined}
|
|
604
|
+
style={reservedMinHeight !== undefined ? { minHeight: reservedMinHeight } : undefined}
|
|
605
|
+
>
|
|
606
|
+
{Loaded !== null ? <Loaded {...componentProps} /> : null}
|
|
607
|
+
{isConsentRequired && renderConsentRequired !== undefined
|
|
608
|
+
? renderConsentRequired({ missingPurposes: missingConsentPurposes, openConsentSettings: consent.openSettings })
|
|
609
|
+
: null}
|
|
610
|
+
{Loaded === null ? (
|
|
611
|
+
<div style={useDefaultRefusal ? STATE_STYLE : undefined}>
|
|
612
|
+
<div role="status">
|
|
613
|
+
{useDefaultRefusal ? <RefusalStatement status={status} missingPurposes={missingConsentPurposes} /> : null}
|
|
614
|
+
</div>
|
|
615
|
+
{isConsentRequired && renderConsentRequired === undefined ? <ManageConsentButton onClick={consent.openSettings} /> : null}
|
|
616
|
+
</div>
|
|
617
|
+
) : null}
|
|
618
|
+
</div>
|
|
619
|
+
);
|
|
620
|
+
}
|
|
621
|
+
```
|
|
622
|
+
|
|
623
|
+
## References
|
|
624
|
+
|
|
255
625
|
## Import Origins
|
|
256
626
|
|
|
257
627
|
- `@wildo-ai/saas-website`
|
|
@@ -287,6 +657,14 @@ WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
|
287
657
|
* captcha so non-React tooling can detect the configured vendor
|
|
288
658
|
* without reverse-engineering app code.
|
|
289
659
|
*
|
|
660
|
+
* 4. **Provides the visitor's consent state and enforces it** (#534) —
|
|
661
|
+
* mounts `WebsiteConsentProvider`, starts a provider SDK or script only
|
|
662
|
+
* once the purpose it rests on is granted (and stops the SDK when it is
|
|
663
|
+
* withdrawn), and renders the consent panel when the site runs a
|
|
664
|
+
* consent-based provider and the visitor has not decided. Here rather
|
|
665
|
+
* than in each bridge because every page — including every blog post —
|
|
666
|
+
* renders through this layout, so no page can be mounted without it.
|
|
667
|
+
*
|
|
290
668
|
* **Why semantic `<header>` / `<main>` / `<footer>` elements**:
|
|
291
669
|
* marketing-site SEO scoring penalizes pages that ship a single
|
|
292
670
|
* unstructured `<div>` tree. Using semantic landmarks costs nothing
|
|
@@ -332,6 +710,17 @@ export interface WebsitePageLayoutProps {
|
|
|
332
710
|
* vertical-rhythm overrides on long-scroll landing pages.
|
|
333
711
|
*/
|
|
334
712
|
mainClassName?: string;
|
|
713
|
+
/**
|
|
714
|
+
* OPTIONAL anonymous-session client. When supplied, a visitor's consent decision is ALSO recorded
|
|
715
|
+
* server-side against their session, which is what lets it follow them into the account they go on
|
|
716
|
+
* to create (#1258). Pass the SAME instance the page's capture sections use, so one `uuidRef`
|
|
717
|
+
* carries the decision, the lead and the draft note together.
|
|
718
|
+
*
|
|
719
|
+
* Absent keeps today's behaviour exactly: the decision lives in this browser and nowhere else.
|
|
720
|
+
* The engine cannot construct the client here — it needs the application's own
|
|
721
|
+
* `frontendServiceName` — which is why it arrives as a prop rather than off the runtime context.
|
|
722
|
+
*/
|
|
723
|
+
consentRecorder?: WebsiteConsentRecorder;
|
|
335
724
|
/**
|
|
336
725
|
* The page's section composition. Typically a sequence of
|
|
337
726
|
* `<WebsiteSection>` wrappers around concrete section components.
|
|
@@ -339,7 +728,21 @@ export interface WebsitePageLayoutProps {
|
|
|
339
728
|
children: ReactNode;
|
|
340
729
|
}
|
|
341
730
|
|
|
342
|
-
export function WebsitePageLayout({
|
|
731
|
+
export function WebsitePageLayout(props: WebsitePageLayoutProps): ReactNode {
|
|
732
|
+
const runtime = useWebsiteRuntime();
|
|
733
|
+
// Derived from the LIVE providers, so the panel asks about exactly what this site processes.
|
|
734
|
+
const purposesInUse = useMemo(
|
|
735
|
+
() => consentPurposesInUseByProviders(runtime.frontendProviderRegistry?.modules.values()),
|
|
736
|
+
[runtime.frontendProviderRegistry],
|
|
737
|
+
);
|
|
738
|
+
return (
|
|
739
|
+
<WebsiteConsentProvider purposesInUse={purposesInUse} recorder={props.consentRecorder}>
|
|
740
|
+
<WebsitePageLayoutContent {...props} />
|
|
741
|
+
</WebsiteConsentProvider>
|
|
742
|
+
);
|
|
743
|
+
}
|
|
744
|
+
|
|
745
|
+
function WebsitePageLayoutContent({
|
|
343
746
|
pageRef,
|
|
344
747
|
header,
|
|
345
748
|
footer,
|
|
@@ -348,6 +751,7 @@ export function WebsitePageLayout({
|
|
|
348
751
|
children,
|
|
349
752
|
}: WebsitePageLayoutProps): ReactNode {
|
|
350
753
|
const runtime = useWebsiteRuntime();
|
|
754
|
+
const consent = useWebsiteConsent();
|
|
351
755
|
|
|
352
756
|
/**
|
|
353
757
|
* Defensive parse: callers should pass a `WebsitePageManifest.ref`
|
|
@@ -390,6 +794,17 @@ export function WebsitePageLayout({
|
|
|
390
794
|
return <FooterComponent />;
|
|
391
795
|
}, [footer, runtime.navigation.footerComponent]);
|
|
392
796
|
|
|
797
|
+
// Load whatever the live providers declared. Until this landed, the surface
|
|
798
|
+
// resolved provider refs and stamped them into the attributes below and
|
|
799
|
+
// stopped there — a provider could be declared, enabled and hydrated without
|
|
800
|
+
// anything of it ever running.
|
|
801
|
+
//
|
|
802
|
+
// Consent-based providers start only once their purpose is granted (#534). Before the stored decision is
|
|
803
|
+
// read, nothing is granted — the static HTML and the first render start nothing optional.
|
|
804
|
+
useWebsiteProviderScripts(runtime.frontendProviderRegistry, runtime.providerComponentRegistry);
|
|
805
|
+
// The running SDKs are published to the page (#1735): the contact form asks the consented captcha vendor for a token.
|
|
806
|
+
const runningProviderSdks = useWebsiteProviderSdks(runtime.frontendProviderRegistry, consent.grantedPurposes);
|
|
807
|
+
|
|
393
808
|
const providerRootAttributes = useMemo<Record<string, string>>(() => {
|
|
394
809
|
const attrs: Record<string, string> = {};
|
|
395
810
|
const productAnalyticsProviderRef = runtime.frontendProviderRegistry
|
|
@@ -436,6 +851,7 @@ export function WebsitePageLayout({
|
|
|
436
851
|
|
|
437
852
|
return (
|
|
438
853
|
<WebsitePageContextProvider value={pageContextValue}>
|
|
854
|
+
<WebsiteProviderSdkActivationsContext.Provider value={runningProviderSdks}>
|
|
439
855
|
<div
|
|
440
856
|
data-website-page-ref={safePageRef as unknown as string}
|
|
441
857
|
className={className}
|
|
@@ -461,51 +877,306 @@ export function WebsitePageLayout({
|
|
|
461
877
|
{children}
|
|
462
878
|
</main>
|
|
463
879
|
{resolvedFooter !== null ? <footer>{resolvedFooter}</footer> : null}
|
|
880
|
+
{renderConsentSurface(consent, runtime.consentBannerComponent)}
|
|
464
881
|
</div>
|
|
882
|
+
</WebsiteProviderSdkActivationsContext.Provider>
|
|
465
883
|
</WebsitePageContextProvider>
|
|
466
884
|
);
|
|
467
885
|
}
|
|
468
886
|
WebsitePageLayout.displayName = 'WebsitePageLayout';
|
|
887
|
+
|
|
888
|
+
/**
|
|
889
|
+
* The panel while a decision is owed (or re-opened), the reopen button once one is made, and nothing at
|
|
890
|
+
* all on a site whose live providers rest on no consent. Nothing renders before the stored decision is
|
|
891
|
+
* read, so a visitor who already decided never sees the panel flash.
|
|
892
|
+
*/
|
|
893
|
+
function renderConsentSurface(
|
|
894
|
+
consent: ReturnType<typeof useWebsiteConsent>,
|
|
895
|
+
BannerOverride: React.ComponentType | undefined,
|
|
896
|
+
): ReactNode {
|
|
897
|
+
if (!consent.isResolved || consent.purposesInUse.length === 0) return null;
|
|
898
|
+
if (consent.status === WebsiteConsentStatus.UNDECIDED || consent.isSettingsOpen) {
|
|
899
|
+
const Banner = BannerOverride ?? WebsiteConsentBanner;
|
|
900
|
+
return <Banner />;
|
|
901
|
+
}
|
|
902
|
+
return (
|
|
903
|
+
<div data-website-consent-settings="">
|
|
904
|
+
<WebsiteConsentSettingsButton />
|
|
905
|
+
</div>
|
|
906
|
+
);
|
|
907
|
+
}
|
|
469
908
|
```
|
|
470
909
|
|
|
471
|
-
|
|
472
|
-
the override must respect; the selected application policy still owns purposes.
|
|
910
|
+
## Import Origins
|
|
473
911
|
|
|
474
|
-
|
|
912
|
+
- `@wildo-ai/saas-website`
|
|
475
913
|
|
|
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.
|
|
914
|
+
## Source Excerpts
|
|
482
915
|
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
916
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
917
|
+
|
|
918
|
+
```tsx
|
|
919
|
+
*
|
|
920
|
+
* `WebsiteRuntimeContext` — site-wide runtime state for the marketing
|
|
921
|
+
* surface. Created **once per page render** by the host adapter: the
|
|
922
|
+
* page's `.astro` frontmatter loads the site context and the resolved label
|
|
923
|
+
* pack, and its bridge island (`createWebsitePageBridgeIsland`) calls
|
|
924
|
+
* `<WebsiteRuntimeContextProvider value={…}>` around the page tree.
|
|
925
|
+
*
|
|
926
|
+
* **Why "runtime" and not "config"**: the values here are the
|
|
927
|
+
* locale-resolved subset of `WebsiteRootConfig` — only the active
|
|
928
|
+
* locale's label pack travels with the React tree (the other locales
|
|
929
|
+
* live in their own per-locale static builds). A `*Config` name would
|
|
930
|
+
* suggest the full multi-locale surface is in scope.
|
|
931
|
+
*
|
|
932
|
+
* **Three pieces of state**:
|
|
933
|
+
*
|
|
934
|
+
* - `locale` — the currently-rendering locale. Sections that need
|
|
935
|
+
* locale-aware formatting (number/date in marketing copy is rare
|
|
936
|
+
* but legitimate) read it via `useWebsiteRuntime()`.
|
|
937
|
+
* - `labelPack` — the locale-resolved flat key→string map, validated
|
|
938
|
+
* against the manifest by `validateLabelPackAgainstManifest` at
|
|
939
|
+
* build start. Consumed by `useWebsiteLabel` and
|
|
940
|
+
* `useWebsiteLabelByKey`.
|
|
941
|
+
* - `designTokens` — the `WebsiteDesignTokens` from
|
|
942
|
+
* `WebsiteRootConfig.designTokens`. Consumed by
|
|
943
|
+
* `useWebsiteDesignTokens` and by the Phase 5 CSS emitter that
|
|
944
|
+
* materializes them as `--website-*` custom properties on the
|
|
945
|
+
* `<WebsitePageLayout>` root.
|
|
946
|
+
* - `navigation` — the `WebsiteNavigationConfig` from
|
|
947
|
+
* `WebsiteRootConfig.navigation`. Carried in the runtime context
|
|
948
|
+
* (rather than as a separate `WebsiteNavigationContext`) because
|
|
949
|
+
* `<WebsitePageLayout>` already reads runtime state and
|
|
950
|
+
* header/footer slots are inseparable from "the site is rendering
|
|
951
|
+
* right now". A second context for two component refs would split
|
|
952
|
+
* the host-adapter's wiring surface without buying isolation.
|
|
953
|
+
* - `frontendProviderRegistry` — optional website-facing public provider
|
|
954
|
+
* registry hydrated from the materialized provider artifact for the
|
|
955
|
+
* concrete `STATIC_WEBSITE` service. This keeps analytics / captcha /
|
|
956
|
+
* browser-monitoring integrations on the same frontend-provider
|
|
957
|
+
* contract the SaaS app now uses, instead of inventing a website-only
|
|
958
|
+
* metadata seam.
|
|
959
|
+
*
|
|
960
|
+
* **Why the hook lives in a separate file**: React Fast Refresh only
|
|
961
|
+
* preserves state for a module whose every export is a component, so
|
|
962
|
+
* a module mixing components with plain functions loses its HMR
|
|
963
|
+
* boundary. This file holds the two things that must be identical
|
|
964
|
+
* objects at runtime — the context and the provider component that
|
|
965
|
+
* writes it — while `useWebsiteRuntime` sits alone in
|
|
966
|
+
* `useWebsiteRuntime.ts`. A section author editing a component that
|
|
967
|
+
* merely READS the runtime therefore never remounts the provider.
|
|
968
|
+
*
|
|
969
|
+
* Until 2026-09-09 this paragraph described a different arrangement:
|
|
970
|
+
* that only the bare context was kept here and the provider lived in
|
|
971
|
+
* a file of its own. No such file has ever existed — the provider is
|
|
972
|
+
* exported below — and splitting it out would be the wrong shape
|
|
973
|
+
* anyway, since `useContext` matches on object identity.
|
|
974
|
+
* prose-referent-waiver: the retired file name is quoted only to retire it.
|
|
975
|
+
* The claim named `WebsiteRuntimeContextProvider.tsx`.
|
|
976
|
+
*/
|
|
977
|
+
export interface WebsiteRuntimeContextValue {
|
|
978
|
+
/**
|
|
979
|
+
* The currently-rendering locale. Marketing-site routing emits one
|
|
980
|
+
* static build per locale (D8), so this value is constant per build
|
|
981
|
+
* — never re-renders mid-session.
|
|
982
|
+
*/
|
|
983
|
+
locale: AvailableLanguage;
|
|
984
|
+
/**
|
|
985
|
+
* The site's default locale (mirrors `WebsiteRootConfig.defaultLocale`).
|
|
986
|
+
* Carried in the runtime context so client-tier components — namely
|
|
987
|
+
* `WebsiteInternalLink` (Phase 6 fix H-β) — can compute the correct
|
|
988
|
+
* locale-prefixed pathname (`/pricing` on the EN site,
|
|
989
|
+
* `/fr/pricing` on the FR site) without re-importing the root
|
|
990
|
+
* config. Plumbing it through the runtime keeps the routing rule
|
|
991
|
+
* a framework-internal concern: section authors NEVER hand-prefix
|
|
992
|
+
* paths.
|
|
993
|
+
*/
|
|
994
|
+
defaultLocale: AvailableLanguage;
|
|
995
|
+
/**
|
|
996
|
+
* Origin of the application this marketing site sends visitors INTO — the
|
|
997
|
+
* marketing → product handoff target, authored once as
|
|
998
|
+
* `WildoMarketingWebsiteConfig.appOrigin` (#493).
|
|
999
|
+
*
|
|
1000
|
+
* Carried here for exactly the reason `defaultLocale` above is: a
|
|
1001
|
+
* `wildo.website.config.ts` is Node-loaded and therefore invisible to a
|
|
1002
|
+
* client island, so before this a site resolved the app origin a SECOND
|
|
1003
|
+
* time from a public build-time environment variable it could read in the
|
|
1004
|
+
* browser — one host authored twice, in two files, with no mechanical link
|
|
1005
|
+
* between the copies. That is how a marketing site comes to point at the
|
|
1006
|
+
* wrong environment: a defect nobody notices until a customer follows the
|
|
1007
|
+
* link.
|
|
1008
|
+
*
|
|
1009
|
+
* Threading it through the runtime keeps the handoff a framework-internal
|
|
1010
|
+
* concern, the same way threading `defaultLocale` kept locale-prefixing one:
|
|
1011
|
+
* section authors never hand-assemble the product URL, and there is one
|
|
1012
|
+
* place to change it.
|
|
1013
|
+
*/
|
|
1014
|
+
appOrigin?: string;
|
|
1015
|
+
/**
|
|
1016
|
+
* Flat `Record<string, string>` label pack for the active locale.
|
|
1017
|
+
* Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
|
|
1018
|
+
* strings; consumers that hold leaf paths use `useWebsiteLabel(leaf)`
|
|
1019
|
+
* which composes the full key against the page+section context.
|
|
1020
|
+
*/
|
|
1021
|
+
labelPack: LabelPack;
|
|
1022
|
+
/**
|
|
1023
|
+
* Design-token bundle for the active site. Same object referenced
|
|
1024
|
+
* by `WebsiteRootConfig.designTokens`; passed by reference (not
|
|
1025
|
+
* cloned) so token-aware components can rely on referential
|
|
1026
|
+
* stability across renders.
|
|
1027
|
+
*/
|
|
1028
|
+
designTokens: WebsiteDesignTokens;
|
|
1029
|
+
/**
|
|
1030
|
+
* Site-wide navigation slot bindings (header / footer components).
|
|
1031
|
+
* Same object referenced by `WebsiteRootConfig.navigation`. Read
|
|
1032
|
+
* by `<WebsitePageLayout>` to render the chrome around each page's
|
|
1033
|
+
* `<main>` content; per-page `header` / `footer` props on
|
|
1034
|
+
* `<WebsitePageLayout>` override these defaults.
|
|
1035
|
+
*/
|
|
1036
|
+
navigation: WebsiteNavigationConfig;
|
|
1037
|
+
/**
|
|
1038
|
+
* Fully-composed label key the framework reads to render the
|
|
1039
|
+
* "Skip to main content" affordance as the FIRST focusable element
|
|
1040
|
+
* on every page (Phase 6 third audit fix M-α). Mirrors
|
|
1041
|
+
* `WebsiteRootConfig.skipToMainContentLabelKey`. Carried in the
|
|
1042
|
+
* runtime context (NOT re-derived from the root config inside
|
|
1043
|
+
* `WebsitePageLayout`) for two reasons:
|
|
1044
|
+
* - The layout is a client-tier React component; it cannot import
|
|
1045
|
+
* the consumer's `WEBSITE_ROOT_CONFIG` symbol without dragging
|
|
1046
|
+
* server-only code (manifest registry, page components) into
|
|
1047
|
+
* the client bundle.
|
|
1048
|
+
* - Threading the key through the runtime keeps the layout's
|
|
1049
|
+
* contract symmetric with how every other localized text on the
|
|
1050
|
+
* page is sourced (label pack + key), so the skip link is
|
|
1051
|
+
* translated automatically without any per-locale branching.
|
|
1052
|
+
*/
|
|
1053
|
+
skipToMainContentLabelKey: WebsiteLabelKey;
|
|
1054
|
+
/**
|
|
1055
|
+
* Website-facing public providers for the active static website
|
|
1056
|
+
* service. Optional so older tests and provider-free sites can omit
|
|
1057
|
+
* it, but when present it is the canonical frontend-safe provider
|
|
1058
|
+
* catalog for analytics / captcha / browser-monitoring slices.
|
|
1059
|
+
*/
|
|
1060
|
+
frontendProviderRegistry?: FrontendWebsiteProviderRegistry;
|
|
1061
|
+
/**
|
|
1062
|
+
* Components the live providers contribute, keyed `capability:providerRef` (#1703) — the same
|
|
1063
|
+
* registry the application builds, from the same `components` declaration. Built by the page bridge
|
|
1064
|
+
* once per island from `frontendProviderRegistry`; read through `useWebsiteProviderComponent` and
|
|
1065
|
+
* rendered by `WebsiteProviderComponent`. Optional for the same reason as the registry above: a
|
|
1066
|
+
* provider-free site, or a test runtime, has none, and every slot then renders nothing.
|
|
1067
|
+
*/
|
|
1068
|
+
providerComponentRegistry?: WebsiteProviderComponentRegistry;
|
|
1069
|
+
/**
|
|
1070
|
+
* Replaces the framework's visitor consent panel (#534). Reads `useWebsiteConsent()`; see
|
|
1071
|
+
* `WebsiteConsentBanner` for the three properties a replacement must keep. Absent uses the default.
|
|
1072
|
+
* Closed over by the bridge rather than passed as an island prop, like `navigation`, because a
|
|
1073
|
+
* component cannot cross Astro's serialization boundary.
|
|
1074
|
+
*/
|
|
1075
|
+
consentBannerComponent?: ComponentType;
|
|
1076
|
+
/**
|
|
1077
|
+
* Backend API origin (WITHOUT a trailing slash) that anonymous-capture
|
|
1078
|
+
* sections POST to when constructing a `WebsiteAnonymousSessionClient`
|
|
1079
|
+
* (lead / draft-note forms). Sourced from
|
|
1080
|
+
* `WildoMarketingWebsiteConfig.apiOrigin` and passed as a
|
|
1081
|
+
* JSON-serializable island prop (the `.astro` page resolves the
|
|
1082
|
+
* per-environment value and forwards it).
|
|
1083
|
+
*
|
|
1084
|
+
* Optional because only pages that host an anonymous-capture section
|
|
1085
|
+
* need it — brochure pages omit it. A capture section that reads
|
|
1086
|
+
* `undefined` here surfaces a loud misconfiguration rather than
|
|
1087
|
+
* silently failing to submit.
|
|
1088
|
+
*/
|
|
1089
|
+
apiOrigin?: string;
|
|
1090
|
+
/**
|
|
1091
|
+
* The application's public pricing catalogue (#1835), derived at build time from the billing
|
|
1092
|
+
* catalogue the backend sells from — so a pricing section states the prices the application
|
|
1093
|
+
* actually charges instead of a hand copy of them. Node-loaded
|
|
1094
|
+
* (`loadWebsitePricingCatalog` on `/config-loader`) and carried as an island prop for the
|
|
1095
|
+
* reason `appOrigin` above is. Read it with `useWebsitePricingCatalog()`.
|
|
1096
|
+
*
|
|
1097
|
+
* Optional because only pricing pages need it; a section that reads it on a page that did not
|
|
1098
|
+
* pass it fails loudly rather than rendering no plans.
|
|
1099
|
+
*/
|
|
1100
|
+
pricingCatalog?: PublicPricingCatalog;
|
|
1101
|
+
}
|
|
487
1102
|
|
|
488
|
-
|
|
1103
|
+
/**
|
|
1104
|
+
* Bare React context. Default `null` — `useWebsiteRuntime()` throws
|
|
1105
|
+
* with a clear error message when invoked outside of
|
|
1106
|
+
* `<WebsiteRuntimeContextProvider>`. The defensive throw is preferred
|
|
1107
|
+
* over a silent default value so a missing provider is detected at
|
|
1108
|
+
* the first hook call rather than at render time when a missing
|
|
1109
|
+
* label silently renders as the key string.
|
|
1110
|
+
*/
|
|
1111
|
+
export const WebsiteRuntimeContext: React.Context<WebsiteRuntimeContextValue | null> =
|
|
1112
|
+
createContext<WebsiteRuntimeContextValue | null>(null);
|
|
1113
|
+
|
|
1114
|
+
export interface WebsiteRuntimeContextProviderProps {
|
|
1115
|
+
value: WebsiteRuntimeContextValue;
|
|
1116
|
+
children: ReactNode;
|
|
1117
|
+
}
|
|
1118
|
+
|
|
1119
|
+
/**
|
|
1120
|
+
* Provider component. Authored as a thin wrapper so consumers do NOT
|
|
1121
|
+
* have to import `WebsiteRuntimeContext.Provider` directly — the
|
|
1122
|
+
* provider component carries the documented authoring API and is the
|
|
1123
|
+
* Fast-Refresh-stable surface section authors compose against.
|
|
1124
|
+
*/
|
|
1125
|
+
export function WebsiteRuntimeContextProvider({
|
|
1126
|
+
value,
|
|
1127
|
+
children,
|
|
1128
|
+
}: WebsiteRuntimeContextProviderProps): ReactNode {
|
|
1129
|
+
return (
|
|
1130
|
+
<WebsiteRuntimeContext.Provider value={value}>
|
|
1131
|
+
{children}
|
|
1132
|
+
</WebsiteRuntimeContext.Provider>
|
|
1133
|
+
);
|
|
1134
|
+
}
|
|
1135
|
+
WebsiteRuntimeContextProvider.displayName = 'WebsiteRuntimeContextProvider';
|
|
1136
|
+
```
|
|
1137
|
+
|
|
1138
|
+
## Verification
|
|
1139
|
+
|
|
1140
|
+
- Before any choice, the product-analytics SDK has not loaded (network panel), and the
|
|
1141
|
+
panel offers only purposes the site uses, unticked.
|
|
1142
|
+
- "Decline all" leaves the site usable, the panel does not return on the next page, and
|
|
1143
|
+
the reopen link shows the stored choice.
|
|
1144
|
+
- Withdrawing a granted purpose stops the analytics client without a reload.
|
|
489
1145
|
|
|
490
1146
|
| Invariant | Command |
|
|
491
1147
|
|---|---|
|
|
492
|
-
|
|
|
493
|
-
| No raw cookie reads
|
|
1148
|
+
| No component reads consent from storage | `rg -n "__wildo_website_consent\|localStorage" website/src/` (must return nothing) |
|
|
1149
|
+
| No raw cookie reads | `rg -n "document\.cookie" website/src/` (must return nothing) |
|
|
1150
|
+
| Every locale labels the panel | `rg -c "website.chrome.consent." website/src/i18n/` (same count in every file) |
|
|
1151
|
+
| Every locale labels the provider-component states | `rg -c "website.chrome.provider-component." website/src/i18n/` (2 in every file) |
|
|
1152
|
+
| No page calls a provider's loader itself | `rg -n "components\??\.\[?.*\]?\.load\(" website/src/` (must return nothing — mount it through `WebsiteProviderComponent`) |
|
|
1153
|
+
| A replacement panel reaches every bridge | `rg -n "consentBannerComponent" website/src/pages-impl/` (one per bridge, or none) |
|
|
494
1154
|
|
|
495
1155
|
## Common Rationalizations
|
|
496
1156
|
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
1157
|
+
| Rationalization | Reality |
|
|
1158
|
+
|---|---|
|
|
1159
|
+
| "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. |
|
|
1160
|
+
| "Pre-tick analytics — most visitors accept anyway." | A pre-ticked box is not a choice. The default leaves every box empty for that reason. |
|
|
1161
|
+
| "Hide Decline behind a settings screen." | Declining must be as easy as accepting; the default puts both side by side. |
|
|
1162
|
+
| "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
1163
|
|
|
502
1164
|
## Red Flags
|
|
503
1165
|
|
|
504
|
-
- A
|
|
505
|
-
|
|
506
|
-
-
|
|
1166
|
+
- A component reads `localStorage` or `document.cookie` for consent (catch with the
|
|
1167
|
+
storage grep above).
|
|
1168
|
+
- A replacement panel starts with boxes ticked, or has no decline action.
|
|
1169
|
+
- A locale pack lacks a `website.chrome.consent.*` key (the build refuses it; the count
|
|
1170
|
+
grep above shows it first).
|
|
1171
|
+
- An embed that tracks is rendered outside `<WebsiteConsentGate purpose={…}>`.
|
|
1172
|
+
- A page calls a provider's component loader itself instead of mounting
|
|
1173
|
+
`<WebsiteProviderComponent>`, so the vendor's code can run during the server render and
|
|
1174
|
+
its scripts load outside the consent gate (catch with the provider-loader grep above).
|
|
507
1175
|
|
|
508
1176
|
## Related Skills
|
|
509
1177
|
|
|
510
|
-
- `website-
|
|
511
|
-
|
|
1178
|
+
- `website-inbound-contact-forms` — a contact form is essential; its marketing opt-in is
|
|
1179
|
+
recorded with the submission.
|
|
1180
|
+
- `website-anonymous-session` — anonymous sessions and the marketing→app handoff.
|
|
1181
|
+
- `website-navigation-authoring` — placing a "Privacy choices" link in the footer.
|
|
1182
|
+
- `website-label-pack` — authoring the `website.chrome.*` keys.
|