@wildo-ai/framework-knowledge 1.1.10 → 1.1.12
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 +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +7 -5
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +628 -107
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- 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 +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- 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 +4 -12
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +10 -4
- 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 +82 -15
- 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 +1 -5
- 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 +4 -16
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- 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 +38 -14
- 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 +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +20 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- 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 +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +6 -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 +4 -3
- 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 +26 -7
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +7 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- 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.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +9 -7
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +9 -2
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +5 -2
- 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 +15 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- 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 +36 -13
- 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 +8 -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 +7 -1
- 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 +4 -1
- 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 +34 -6
- 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 +7 -3
- 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 +6 -4
- 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.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- 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 +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- 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 +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +24 -9
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- 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 -7
- 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 +12 -14
- 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 +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- 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 +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +98 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- 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 +4 -2
- 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 +34 -1
- 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 +39 -20
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- 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 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +788 -49
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +115 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -5
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +153 -28
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +49 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +15 -5
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- 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/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +216 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +21 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +28 -2
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
- package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +342 -76
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +47 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +127 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +28 -8
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +94 -13
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
- package/dist/knowledge/references/platform.config.saas.md +126 -32
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +105 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
- package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
- package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +280 -40
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +123 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +22 -4
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
- package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +303 -0
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +5250 -2565
- package/dist/knowledge/registries/playbooks.json +88 -55
- package/dist/knowledge/registries/source-tags.json +9347 -4807
- package/dist/knowledge/rules/database-migration-obligation.md +10 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +62 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +26 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +37 -1
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +168 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +66 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +166 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +21 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -10
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +10 -2
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +93 -13
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +140 -7
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +7 -5
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +13 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +72 -8
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +165 -44
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +200 -61
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +8 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +21 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +46 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +4 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +219 -77
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +223 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +138 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +30 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +186 -83
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +113 -70
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +41 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +15 -4
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17998 -8568
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -0,0 +1,1150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: website-section-problem
|
|
3
|
+
description: Author a Problem section — the pain the audience lives with, told in their words before any product appears, each pain led by what it costs when the market snapshot says — by configuring the engine's `websiteCardGridBlock` with `figure` cards under the section intro (`websiteCardGridBlock.section({ category: WebsiteSectionCategory.PROBLEM, band, intro, config })`). Use when the user says "add a problem section", "open the solution page on the pain", "show what it costs them today", or when a website plan section has kind PROBLEM.
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Website Section: Problem
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
# Website Section — Authoring API (source-backed)
|
|
22
|
+
|
|
23
|
+
Shared API excerpts for every `website-section-<category>` skill. The
|
|
24
|
+
contract is identical across categories; the per-category guidance lives
|
|
25
|
+
in each skill's own `SKILL.md`.
|
|
26
|
+
|
|
27
|
+
## Category vocabulary (closed enum)
|
|
28
|
+
|
|
29
|
+
The `category` of a section (`category` in `block.section(...)`) is a closed enum, not a
|
|
30
|
+
free string. Adding a new value requires a matching
|
|
31
|
+
`website-section-<value>` skill (`RAW` is covered by
|
|
32
|
+
`website-factory-advanced`).
|
|
33
|
+
|
|
34
|
+
## Import Origins
|
|
35
|
+
|
|
36
|
+
- `@wildo-ai/saas-website`
|
|
37
|
+
|
|
38
|
+
## Source Excerpts
|
|
39
|
+
|
|
40
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
41
|
+
|
|
42
|
+
```typescript
|
|
43
|
+
*
|
|
44
|
+
* `WebsiteSectionCategory` — closed vocabulary tagging the **structural
|
|
45
|
+
* intent** of a section.
|
|
46
|
+
*
|
|
47
|
+
* The category is NOT a layout-shape constraint and NOT a CSS class; the
|
|
48
|
+
* framework ships zero concrete sections and never inspects
|
|
49
|
+
* the category at render time. The category exists for two orthogonal
|
|
50
|
+
* non-render concerns:
|
|
51
|
+
*
|
|
52
|
+
* 1. **Authoring guidance**: each value has matching application-builder
|
|
53
|
+
* guidance. When introducing a new category, provide its public authoring
|
|
54
|
+
* method before asking an application to use it.
|
|
55
|
+
* 2. **Analytics labelling**: the runtime emits
|
|
56
|
+
* `data-section-category="…"` on the `<WebsiteSection>` wrapper so
|
|
57
|
+
* analytics tooling can group section impressions
|
|
58
|
+
* without parsing className conventions.
|
|
59
|
+
*
|
|
60
|
+
* **It does NOT gate structured data.** Nothing dispatches JSON-LD by category: the structured-data
|
|
61
|
+
* renderer receives only `sectionRef` and `getStructuredData`, the reconciliation contract carries
|
|
62
|
+
* no category at all, and no build-time warning compares the two. A section may return any
|
|
63
|
+
* vocabulary from `getStructuredData()` whatever its category says, so choose the category for what
|
|
64
|
+
* it does do (guidance and analytics grouping) and validate your JSON-LD yourself.
|
|
65
|
+
*
|
|
66
|
+
* **Closed vocabulary on purpose**: a free-string `category` would
|
|
67
|
+
* defeat the skill mapping and would make the analytics attribute unaggregatable.
|
|
68
|
+
* Consumers who need a wholly-novel section shape use the `RAW` advanced path
|
|
69
|
+
* (`website-factory-advanced` skill) which bypasses the category
|
|
70
|
+
* vocabulary entirely.
|
|
71
|
+
*
|
|
72
|
+
* **Adding a value**: requires (a) a new entry here, (b) the matching member of
|
|
73
|
+
* the website plan's `WebsiteSectionKind`, and (c) its `website-section-<value>`
|
|
74
|
+
* skill, which `WEBSITE_SECTION_SKILL_REF` must name or the plan does not compile. Removing a value
|
|
75
|
+
* is a labelled rename — every consumer's
|
|
76
|
+
* `defineWebsiteSection({ category: … })` declaration breaks at compile
|
|
77
|
+
* time, which is the desired loud failure.
|
|
78
|
+
*/
|
|
79
|
+
export enum WebsiteSectionCategory {
|
|
80
|
+
HERO = 'hero',
|
|
81
|
+
CTA = 'cta',
|
|
82
|
+
FEATURE_BENEFIT_SUMMARY = 'feature-benefit-summary',
|
|
83
|
+
FEATURE_DETAIL = 'feature-detail',
|
|
84
|
+
PRICING = 'pricing',
|
|
85
|
+
CONTACT = 'contact',
|
|
86
|
+
SOCIAL_PROOF = 'social-proof',
|
|
87
|
+
FAQ = 'faq',
|
|
88
|
+
FOOTER_CTA = 'footer-cta',
|
|
89
|
+
/** The problem the audience lives with, before any product appears (a solution page's opening argument). */
|
|
90
|
+
PROBLEM = 'problem',
|
|
91
|
+
/** How it works, in three or four steps. */
|
|
92
|
+
HOW_IT_WORKS = 'how-it-works',
|
|
93
|
+
/** The product itself, shown: its real interface framed, a bento of key screens, or tabs across its views. */
|
|
94
|
+
PRODUCT_SHOWCASE = 'product-showcase',
|
|
95
|
+
/** One card per audience, each linking to the solution page written for it. */
|
|
96
|
+
SOLUTION_PATHS = 'solution-paths',
|
|
97
|
+
/** The product against the alternatives, honestly. */
|
|
98
|
+
COMPARISON = 'comparison',
|
|
99
|
+
/** Facts about the product as figures, each one a value the application declares. */
|
|
100
|
+
STATS = 'stats',
|
|
101
|
+
/** The systems the product connects to, by name, each one a provider or protocol the application declares. */
|
|
102
|
+
INTEGRATIONS = 'integrations',
|
|
103
|
+
/** The newest posts of the site's blog, read from the posts' own frontmatter. */
|
|
104
|
+
LATEST_POSTS = 'latest-posts',
|
|
105
|
+
/** What has shipped and what is next, as the application's roadmap declares it. */
|
|
106
|
+
ROADMAP = 'roadmap',
|
|
107
|
+
/**
|
|
108
|
+
* Escape hatch for sections that don't fit any standard category
|
|
109
|
+
* (third-party widgets, custom one-off marketing pieces). Authors should
|
|
110
|
+
* prefer a concrete category whenever possible, so the section receives the
|
|
111
|
+
* matching authoring guidance and groups with its peers in analytics.
|
|
112
|
+
*
|
|
113
|
+
* It makes no difference to structured data: no category validates
|
|
114
|
+
* `getStructuredData()`, so `RAW` opts out of nothing there.
|
|
115
|
+
*/
|
|
116
|
+
RAW = 'raw',
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCategory> =
|
|
120
|
+
z.enum(WebsiteSectionCategory);
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
## Section definition (the contract `defineWebsiteSection` produces)
|
|
124
|
+
|
|
125
|
+
The schema declares the **observable contract** the page-manifest
|
|
126
|
+
registration, the label-pack validator, `renderPageStructuredData` and
|
|
127
|
+
the structured-data audit depend on. The
|
|
128
|
+
factory adds what the schema cannot express: `Component` takes no props
|
|
129
|
+
(the page mounts it as `<Component />`), so a component that requires
|
|
130
|
+
one is refused at compile time.
|
|
131
|
+
|
|
132
|
+
## Import Origins
|
|
133
|
+
|
|
134
|
+
- `@wildo-ai/saas-website`
|
|
135
|
+
|
|
136
|
+
## Source Excerpts
|
|
137
|
+
|
|
138
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
139
|
+
|
|
140
|
+
```typescript
|
|
141
|
+
*
|
|
142
|
+
* `WebsiteSectionDefinition` — the runtime contract returned by the
|
|
143
|
+
* `defineWebsiteSection({ … })` factory (which lives apart from this
|
|
144
|
+
* schema because its input carries React types). The shape is declared
|
|
145
|
+
* with the schemas because it is the **observable contract** the page-manifest
|
|
146
|
+
* registration, the label-pack validator, `renderPageStructuredData` and the
|
|
147
|
+
* structured-data audit depend on.
|
|
148
|
+
*
|
|
149
|
+
* **Shape rationale** (each field carries semantic weight):
|
|
150
|
+
*
|
|
151
|
+
* - `sectionRef` — the section's identity across the SITE. The build
|
|
152
|
+
* collects every section by its ref (`collectExpectedLabelKeysFromSections`)
|
|
153
|
+
* and refuses two sections that share one with different label keys,
|
|
154
|
+
* which two pages' sections always have (each key is rooted at its own
|
|
155
|
+
* page). So a ref names its page when two pages would share one
|
|
156
|
+
* (`landing-hero`, `pricing-hero`); the manifest registry additionally
|
|
157
|
+
* refuses a ref listed twice on one page.
|
|
158
|
+
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
159
|
+
* for skill-mapping and analytics labelling. It does NOT select the
|
|
160
|
+
* section's structured data.
|
|
161
|
+
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
162
|
+
* commits to consuming. Leaf-relative keys (`'headline'`) resolved at
|
|
163
|
+
* runtime against the page+section context would also work, but
|
|
164
|
+
* storing the fully-composed key on the definition has three concrete
|
|
165
|
+
* benefits:
|
|
166
|
+
* 1. The label-pack validator (`validateLabelPackAgainstManifest`)
|
|
167
|
+
* runs as a pure function with no need to walk the JSX tree at
|
|
168
|
+
* build time to discover the leaf-to-key resolution.
|
|
169
|
+
* 2. The contract is auditable from outside the React render
|
|
170
|
+
* graph — `wildo website audit` can list a page's required keys
|
|
171
|
+
* without booting React.
|
|
172
|
+
* 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
|
|
173
|
+
* survive — the hook composes the leaf with the page+section
|
|
174
|
+
* context and looks the result up in the active pack. It does
|
|
175
|
+
* NOT check the key against `expectedLabelKeys`: a leaf the
|
|
176
|
+
* section never declared renders its key (with a console warning)
|
|
177
|
+
* and is caught by nothing until a reviewer reads the page. The
|
|
178
|
+
* build and `wildo website audit` check the pack against the
|
|
179
|
+
* DECLARED keys, so declare every slot the component reads.
|
|
180
|
+
* - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
|
|
181
|
+
* can target it. Belongs to the DEFINITION because a page renders its
|
|
182
|
+
* sections list through `WebsitePageSections`, which places every
|
|
183
|
+
* section itself: an anchor a page author would otherwise write on a
|
|
184
|
+
* hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
|
|
185
|
+
* valid HTML id that is also URL-fragment-safe: a letter, then
|
|
186
|
+
* letters, digits, `-` or `_`. Uniqueness on a page is the author's
|
|
187
|
+
* to keep, like the id attribute it becomes.
|
|
188
|
+
* - `Component` — the React component that renders the section. The
|
|
189
|
+
* page mounts it with NO props (`<WebsitePageSections>`), which the
|
|
190
|
+
* factory (`defineWebsiteSection`, `WebsiteSectionComponentProps`) enforces at
|
|
191
|
+
* compile time; this schema only guards the runtime shape of "is
|
|
192
|
+
* callable as a React component".
|
|
193
|
+
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
194
|
+
* builder library invokes on the server to materialize JSON-LD for the
|
|
195
|
+
* section, handing it the page it renders on (`WebsiteStructuredDataContext`).
|
|
196
|
+
* The return type is intentionally `unknown` here;
|
|
197
|
+
* nothing narrows it by `category` — the section returns whatever
|
|
198
|
+
* vocabulary it emits, and `wildo website audit` reconciles that
|
|
199
|
+
* against the application's Schema.org catalog.
|
|
200
|
+
*
|
|
201
|
+
* **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
|
|
202
|
+
* cannot meaningfully validate "is a React component" beyond
|
|
203
|
+
* `typeof === 'function'`, and the false-positive cost (any function
|
|
204
|
+
* passes) is too high for the value (none — the consumer either
|
|
205
|
+
* imports a real component or fails at JSX render time with a clearer
|
|
206
|
+
* error). Using `z.unknown()` + a TS-side type cast keeps the runtime
|
|
207
|
+
* cost zero and the type-safety contract entirely on the TS side
|
|
208
|
+
* (where it actually has teeth via the factory's generic).
|
|
209
|
+
*/
|
|
210
|
+
const _WebsiteSectionDefinitionSchema = z.object({
|
|
211
|
+
sectionRef: WebsiteSectionRefSchema,
|
|
212
|
+
category: WebsiteSectionCategorySchema,
|
|
213
|
+
expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
|
|
214
|
+
anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
|
|
215
|
+
error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
|
|
216
|
+
}).optional(),
|
|
217
|
+
Component: z.unknown(),
|
|
218
|
+
getStructuredData: z.unknown().optional(),
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
export const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSchema =
|
|
222
|
+
_WebsiteSectionDefinitionSchema;
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and
|
|
226
|
+
* `getStructuredData` are typed precisely on the factory return type
|
|
227
|
+
* (`defineWebsiteSection`); the schema-inferred
|
|
228
|
+
* type is the lowest common denominator used at the persistence /
|
|
229
|
+
* validation boundary only.
|
|
230
|
+
*
|
|
231
|
+
* **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:
|
|
232
|
+
* React component props are CONTRAVARIANT in `ComponentType<T>` —
|
|
233
|
+
* the factory's `ComponentType<WebsiteSectionComponentProps>` is NOT
|
|
234
|
+
* assignable to `ComponentType<unknown>` (because a caller could pass
|
|
235
|
+
* an `unknown` the narrower component cannot accept). That would stop
|
|
236
|
+
* every `TypedWebsiteSectionDefinition` from reaching the helpers typed
|
|
237
|
+
* against the bare `WebsiteSectionDefinition` — collectors, validators,
|
|
238
|
+
* and registries. `any` is the escape hatch the React typings
|
|
239
|
+
* themselves use for heterogeneous component containers
|
|
240
|
+
* (`React.forwardRef`, `React.lazy`'s internal component slot, etc.).
|
|
241
|
+
* It widens nothing at runtime: the page mounts every section
|
|
242
|
+
* component as `<Component />`, with no props, and
|
|
243
|
+
* `defineWebsiteSection` refuses a component that requires one.
|
|
244
|
+
*/
|
|
245
|
+
export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {
|
|
246
|
+
Component: ComponentType<any>;
|
|
247
|
+
/**
|
|
248
|
+
* Optional pure function the SEO/AEO/GEO renderer invokes at
|
|
249
|
+
* static-build time to materialize JSON-LD for the section.
|
|
250
|
+
*
|
|
251
|
+
* **Why typed as `WebsiteStructuredDataReturn` (not `unknown`)** —
|
|
252
|
+
* a typed return shape gives section authors autocomplete on
|
|
253
|
+
* `@type` / `@id` / `@context` (the framework-owned fields) while
|
|
254
|
+
* keeping all other fields free-form (Schema.org has hundreds of
|
|
255
|
+
* optional fields per entity; locking them in TS would be both
|
|
256
|
+
* impractical and brittle as Schema.org evolves). The companion
|
|
257
|
+
* catalog reconciliation surface catches missing-required and
|
|
258
|
+
* deprecated-field-used at the SEMANTIC layer (warnings; failures
|
|
259
|
+
* under `wildo website audit --strict`), so the runtime type stays loose.
|
|
260
|
+
*
|
|
261
|
+
* Returns `null`, `undefined`, or `[]` when the section has no
|
|
262
|
+
* structured-data contribution for the current state — the
|
|
263
|
+
* renderer short-circuits all three.
|
|
264
|
+
*
|
|
265
|
+
* **The context** (`WebsiteStructuredDataContext`): the page's locale,
|
|
266
|
+
* refs, route and origin, and `label(slot)` — the section's own words
|
|
267
|
+
* in that locale. Structured data restates what the section shows, so a
|
|
268
|
+
* section with words (an FAQ, a product description) reads them here,
|
|
269
|
+
* once per locale and on the server only, rather than hard-coding one
|
|
270
|
+
* language or importing every locale's pack into the browser bundle. A
|
|
271
|
+
* function that declares no parameter is still accepted: a payload with
|
|
272
|
+
* no words (a site-wide `Organization` id) needs no context.
|
|
273
|
+
*/
|
|
274
|
+
getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
275
|
+
}
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
## Structured data reads the section's words through its context
|
|
279
|
+
|
|
280
|
+
`getStructuredData` receives the page the section is published on, a
|
|
281
|
+
`WebsiteStructuredDataContext` (from `@wildo-ai/saas-website`), and runs
|
|
282
|
+
on the server only:
|
|
283
|
+
|
|
284
|
+
- `label(slot)` — the section's word for `slot` in the page's locale,
|
|
285
|
+
the key `useWebsiteLabel(slot)` reads in the component. It throws when
|
|
286
|
+
the locale's pack has no word, so a raw key is never published.
|
|
287
|
+
- `pageUrl` — the page's URL in this locale, for `url` and `@id`;
|
|
288
|
+
`siteOrigin` — the site's public origin, for site-wide `@id`s;
|
|
289
|
+
`locale` — for `inLanguage`.
|
|
290
|
+
|
|
291
|
+
A word the section shows reaches its JSON-LD only through `label(slot)`:
|
|
292
|
+
never typed into the payload (one language on every locale's page) and
|
|
293
|
+
never read from a label pack imported into the sections file (every
|
|
294
|
+
visitor downloads the pack). A payload with no words may keep
|
|
295
|
+
`() => …`. The route passes the context
|
|
296
|
+
(`renderPageStructuredData({ sections, context: runtime.structuredData })`),
|
|
297
|
+
and `wildo website audit` checks every route a page is published at, in
|
|
298
|
+
that route's locale, as the page renders it. The full contract is in the `website-seo-aeo-geo` skill.
|
|
299
|
+
|
|
300
|
+
## How a section is defined: a configured block
|
|
301
|
+
|
|
302
|
+
When the section comes from the website plan, its `design` already names the block, its layout, its surface and what
|
|
303
|
+
its demo shows, and says whether it is the page's signature section. Build what it names; the guidance below is for
|
|
304
|
+
the fields the plan left open. When the section is built, look at it: `wildo website look <route> --all-locales`
|
|
305
|
+
photographs the page in every locale the site serves, at a desktop and a phone width, and runs an accessibility pass; judge the pictures against the
|
|
306
|
+
`website-building-blocks` skill's `references/website-visual-quality-rubric.md` and fix every violation it lists.
|
|
307
|
+
|
|
308
|
+
A section is almost always one of the engine's blocks, CONFIGURED:
|
|
309
|
+
`websiteHeroBlock.section({ pageRef, sectionRef, category, config })`,
|
|
310
|
+
`websiteCardGridBlock.section({ …, band, intro, config })`. The block
|
|
311
|
+
renders `config` (its props), and the section's words are derived from
|
|
312
|
+
the same `config`, so a section cannot declare a word it does not render.
|
|
313
|
+
`band` and `intro` are accepted only by the blocks that take them, and
|
|
314
|
+
`nodeSlots` declares the words a node inside the config reads (a drawing,
|
|
315
|
+
a form). A section no engine block covers is a block of the site's own,
|
|
316
|
+
`defineWebsiteBlock({ surface, heading, slots, Component })`, with the
|
|
317
|
+
same `.section(...)`. Pricing is the one exception: its words follow the
|
|
318
|
+
plans the catalogue publishes, so it is declared with
|
|
319
|
+
`defineWebsiteBlockSection` and `websitePricingSlots`. The
|
|
320
|
+
`website-building-blocks` skill lists every block and what each takes.
|
|
321
|
+
|
|
322
|
+
Underneath, every one of these calls the `defineWebsiteSection` factory
|
|
323
|
+
below. Never build a `WebsiteSectionDefinition` literal by hand: the
|
|
324
|
+
factory parses inputs through the schema (single audited validation
|
|
325
|
+
chokepoint) and types `Component` as taking NO props
|
|
326
|
+
(`WebsiteSectionComponentProps`), since the page mounts each section as
|
|
327
|
+
`<Component />`. A configured block binds its config for you.
|
|
328
|
+
|
|
329
|
+
## Import Origins
|
|
330
|
+
|
|
331
|
+
- `@wildo-ai/saas-website`
|
|
332
|
+
|
|
333
|
+
## Source Excerpts
|
|
334
|
+
|
|
335
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
336
|
+
|
|
337
|
+
```typescript
|
|
338
|
+
*
|
|
339
|
+
* The props a section component receives: NONE. A page renders its sections through
|
|
340
|
+
* `<WebsitePageSections>`, which mounts each one as `<Component />` — nothing composes a section with props. A
|
|
341
|
+
* component that requires one is therefore refused by `defineWebsiteSection` at compile time; before this type, it
|
|
342
|
+
* compiled and then read `undefined` on the live page. A section reads what it
|
|
343
|
+
* shows from its labels (`useWebsiteLabel`), the page runtime (`useWebsiteRuntime`) and module constants; a variant of
|
|
344
|
+
* a shared body or block is BOUND in the definition (`Component: () => <WebsiteHero layout={WebsiteHeroLayout.STAGE} visual={<ProductShot />} />`).
|
|
345
|
+
*/
|
|
346
|
+
export type WebsiteSectionComponentProps = Record<string, never>;
|
|
347
|
+
|
|
348
|
+
/**
|
|
349
|
+
* Input shape consumed by `defineWebsiteSection`. Mirrors `WebsiteSectionDefinition`, with `Component` a component
|
|
350
|
+
* that takes no props (`WebsiteSectionComponentProps`): one that requires a prop is refused at compile time.
|
|
351
|
+
*
|
|
352
|
+
* **String inputs vs. branded inputs**: `sectionRef` and
|
|
353
|
+
* `expectedLabelKeys` accept raw strings as well as already-branded
|
|
354
|
+
* values. The factory parses them through the underlying schemas, so
|
|
355
|
+
* either path is safe — accepting strings directly removes the
|
|
356
|
+
* ergonomic drag of forcing every section author to remember to call
|
|
357
|
+
* `WebsiteSectionRefSchema.parse(...)` in their definition.
|
|
358
|
+
*/
|
|
359
|
+
export interface DefineWebsiteSectionInput<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps> {
|
|
360
|
+
sectionRef: WebsiteSectionRef | string;
|
|
361
|
+
category: WebsiteSectionCategory;
|
|
362
|
+
expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
|
|
363
|
+
/** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
|
|
364
|
+
anchorId?: string;
|
|
365
|
+
Component: ComponentType<TProps>;
|
|
366
|
+
/**
|
|
367
|
+
* See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
|
|
368
|
+
* full authoring contract. The factory passes the function through
|
|
369
|
+
* unchanged; `renderPageStructuredData()` invokes it on the server with
|
|
370
|
+
* the page's `WebsiteStructuredDataContext`.
|
|
371
|
+
*/
|
|
372
|
+
getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
/**
|
|
376
|
+
* Return shape of `defineWebsiteSection`. Identical to `WebsiteSectionDefinition` except `Component` is typed as the
|
|
377
|
+
* prop-less component it is, rather than the schema's lowest-common-denominator `ComponentType<any>`.
|
|
378
|
+
*/
|
|
379
|
+
export interface TypedWebsiteSectionDefinition<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>
|
|
380
|
+
extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
|
|
381
|
+
Component: ComponentType<TProps>;
|
|
382
|
+
getStructuredData?: (context: WebsiteStructuredDataContext) => WebsiteStructuredDataReturn;
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
/**
|
|
386
|
+
* `defineWebsiteSection` — factory that materializes a
|
|
387
|
+
* `WebsiteSectionDefinition` from authored input.
|
|
388
|
+
*
|
|
389
|
+
* **Two responsibilities**, one entry point:
|
|
390
|
+
* 1. Runtime validation — parses the input through
|
|
391
|
+
* `WebsiteSectionDefinitionSchema` so brand checks, regex
|
|
392
|
+
* validations, and array refinements run at module load time
|
|
393
|
+
* (not at render time, not at build-output time).
|
|
394
|
+
* 2. The props contract — `Component` takes no props, because the
|
|
395
|
+
* page mounts it as `<Component />`. A component that requires a
|
|
396
|
+
* prop fails to compile here rather than reading `undefined` live.
|
|
397
|
+
* The type parameter exists so an explicit type argument equal to
|
|
398
|
+
* `WebsiteSectionComponentProps` stays valid; it cannot be widened.
|
|
399
|
+
*
|
|
400
|
+
* **Why a factory instead of constructing the literal directly**:
|
|
401
|
+
* - Consumers don't have to remember to parse refs / keys
|
|
402
|
+
* themselves before assembling the literal.
|
|
403
|
+
* - The schema parse provides a single audited validation chokepoint,
|
|
404
|
+
* and the parsed `expectedLabelKeys` are what `wildo website audit`
|
|
405
|
+
* checks every locale pack against, without re-entering the React graph.
|
|
406
|
+
* - The factory is the documented authoring API every
|
|
407
|
+
* `website-section-*` skill teaches — keeping the
|
|
408
|
+
* authoring surface narrow lets the framework evolve the
|
|
409
|
+
* internal schema (add fields, refinements) without churning
|
|
410
|
+
* every section definition in every consumer app.
|
|
411
|
+
*
|
|
412
|
+
* @param input section authoring input (see `DefineWebsiteSectionInput`).
|
|
413
|
+
* @returns a `TypedWebsiteSectionDefinition` whose `Component` takes no props.
|
|
414
|
+
*
|
|
415
|
+
* @example
|
|
416
|
+
* function HeroSection() {
|
|
417
|
+
* const headline = useWebsiteLabel('headline');
|
|
418
|
+
* const subheadline = useWebsiteLabel('subheadline');
|
|
419
|
+
* // …
|
|
420
|
+
* }
|
|
421
|
+
* export const HERO_SECTION = defineWebsiteSection({
|
|
422
|
+
* sectionRef: 'hero',
|
|
423
|
+
* category: WebsiteSectionCategory.HERO,
|
|
424
|
+
* expectedLabelKeys: [
|
|
425
|
+
* 'website.landing.hero.headline',
|
|
426
|
+
* 'website.landing.hero.subheadline',
|
|
427
|
+
* ],
|
|
428
|
+
* Component: HeroSection,
|
|
429
|
+
* });
|
|
430
|
+
*/
|
|
431
|
+
export function defineWebsiteSection<TProps extends WebsiteSectionComponentProps = WebsiteSectionComponentProps>(
|
|
432
|
+
input: DefineWebsiteSectionInput<TProps>,
|
|
433
|
+
): TypedWebsiteSectionDefinition<TProps> {
|
|
434
|
+
const parsed = WebsiteSectionDefinitionSchema.parse({
|
|
435
|
+
sectionRef: input.sectionRef,
|
|
436
|
+
category: input.category,
|
|
437
|
+
expectedLabelKeys: input.expectedLabelKeys,
|
|
438
|
+
anchorId: input.anchorId,
|
|
439
|
+
Component: input.Component,
|
|
440
|
+
getStructuredData: input.getStructuredData,
|
|
441
|
+
});
|
|
442
|
+
/**
|
|
443
|
+
* Re-attach `Component` and `getStructuredData` from the original
|
|
444
|
+
* input so they keep their declared types — `parsed.Component` is
|
|
445
|
+
* `unknown` per the schema's `z.unknown()` contract.
|
|
446
|
+
*/
|
|
447
|
+
return {
|
|
448
|
+
sectionRef: parsed.sectionRef,
|
|
449
|
+
category: parsed.category,
|
|
450
|
+
expectedLabelKeys: parsed.expectedLabelKeys,
|
|
451
|
+
...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
|
|
452
|
+
Component: input.Component,
|
|
453
|
+
...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
|
|
454
|
+
};
|
|
455
|
+
}
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
## Runtime label hook (leaf-relative; resolved against page+section context)
|
|
459
|
+
|
|
460
|
+
Inside the section's React component, always read labels via
|
|
461
|
+
`useWebsiteLabel('<leaf>')`. The hook composes the leaf with the
|
|
462
|
+
ambient page+section context into the fully-qualified `WebsiteLabelKey`
|
|
463
|
+
and looks it up in the page's label pack; a missing word logs a warning
|
|
464
|
+
and renders the raw key. It does not consult `expectedLabelKeys`: the
|
|
465
|
+
build checks every locale pack against the keys the section DECLARES
|
|
466
|
+
there, so a key the component reads without declaring it is never
|
|
467
|
+
checked — declare every slot it reads.
|
|
468
|
+
|
|
469
|
+
## Import Origins
|
|
470
|
+
|
|
471
|
+
- `@wildo-ai/saas-website`
|
|
472
|
+
|
|
473
|
+
## Source Excerpts
|
|
474
|
+
|
|
475
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
476
|
+
|
|
477
|
+
```typescript
|
|
478
|
+
*
|
|
479
|
+
* `useWebsiteLabel(slotPath)` — leaf-relative label resolution.
|
|
480
|
+
*
|
|
481
|
+
* Composes the slot leaf with the active page+section context to
|
|
482
|
+
* derive the full `WebsiteLabelKey` (`website.{pageRef}.{sectionRef}.{slotPath}`),
|
|
483
|
+
* looks it up in the active locale's label pack, and returns the
|
|
484
|
+
* resolved string.
|
|
485
|
+
*
|
|
486
|
+
* **Author ergonomics**: section authors call
|
|
487
|
+
* `useWebsiteLabel('headline')` from inside their section component
|
|
488
|
+
* without ever typing the page or section ref — the hook reads them
|
|
489
|
+
* from the context the page layout and the surrounding `<WebsiteSection>`
|
|
490
|
+
* provide. The keys therefore follow the page a section renders on, while
|
|
491
|
+
* the section's declared `expectedLabelKeys` name one page: a section
|
|
492
|
+
* belongs to one page, and the website plan refuses a section ref
|
|
493
|
+
* declared on two. Share the BLOCK (a component reading slots) between
|
|
494
|
+
* pages, and give each page its own section around it.
|
|
495
|
+
*
|
|
496
|
+
* **Fail-loud diagnostics** for missing keys: returns the composed key
|
|
497
|
+
* itself (visible in the rendered DOM as e.g. `website.landing.hero.headline`)
|
|
498
|
+
* AND emits a `console.warn`. The visible-key fallback is preferred
|
|
499
|
+
* over an empty string or a thrown error because:
|
|
500
|
+
* - empty string silently breaks layout (zero-height heading) and
|
|
501
|
+
* leaks past visual review,
|
|
502
|
+
* - throwing would crash the entire page on a single missing label
|
|
503
|
+
* while the SEO crawler indexes a 500 page,
|
|
504
|
+
* - the rendered key is a clear authoring signal ("ship the missing
|
|
505
|
+
* pack entry") that designers and copywriters can spot without
|
|
506
|
+
* opening DevTools.
|
|
507
|
+
*
|
|
508
|
+
* **Hard guards** (each enforced by the underlying context hooks):
|
|
509
|
+
* - MUST be called inside `<WebsiteRuntimeContextProvider>`,
|
|
510
|
+
* - MUST be called inside `<WebsitePageLayout>`,
|
|
511
|
+
* - MUST be called inside `<WebsiteSection>`.
|
|
512
|
+
*
|
|
513
|
+
* @param slotPath leaf identifier (eg. `'headline'`, `'cta.primary'`,
|
|
514
|
+
* `'tiers[0].name'`). Anything that survives the slot
|
|
515
|
+
* portion of `WebsiteLabelKeySchema`'s regex.
|
|
516
|
+
* @returns the resolved label string, or the composed key itself when
|
|
517
|
+
* the pack lacks an entry (with a `console.warn`).
|
|
518
|
+
*/
|
|
519
|
+
export function useWebsiteLabel(slotPath: string): string {
|
|
520
|
+
const { labelPack } = useWebsiteRuntime();
|
|
521
|
+
const { pageRef } = useWebsitePage();
|
|
522
|
+
const { sectionRef } = useWebsiteSection();
|
|
523
|
+
|
|
524
|
+
/**
|
|
525
|
+
* Compose + parse memoized on the three identity inputs. The parse
|
|
526
|
+
* itself is cheap (regex + brand) but executing it on every render
|
|
527
|
+
* of every label-bound primitive in a section adds up across a
|
|
528
|
+
* 12-section landing page.
|
|
529
|
+
*/
|
|
530
|
+
const fullKey = useMemo<WebsiteLabelKey>(
|
|
531
|
+
() =>
|
|
532
|
+
composeWebsiteLabelKey({
|
|
533
|
+
pageRef: pageRef as unknown as string,
|
|
534
|
+
sectionRef: sectionRef as unknown as string,
|
|
535
|
+
slotPath,
|
|
536
|
+
}),
|
|
537
|
+
[pageRef, sectionRef, slotPath],
|
|
538
|
+
);
|
|
539
|
+
|
|
540
|
+
const resolved = labelPack[fullKey as unknown as string];
|
|
541
|
+
if (resolved === undefined) {
|
|
542
|
+
console.warn(
|
|
543
|
+
`[useWebsiteLabel] Missing label for key "${fullKey as unknown as string}". ` +
|
|
544
|
+
`Add it to the active locale's pack (or remove the section's claim on this slot).`,
|
|
545
|
+
);
|
|
546
|
+
return fullKey as unknown as string;
|
|
547
|
+
}
|
|
548
|
+
return resolved;
|
|
549
|
+
}
|
|
550
|
+
```
|
|
551
|
+
|
|
552
|
+
## Section wrapper (provides section context, emits semantic landmark + analytics attrs)
|
|
553
|
+
|
|
554
|
+
The framework's `<WebsiteSection>` wrapper is what the page composition
|
|
555
|
+
mounts to host a section's component. It provides
|
|
556
|
+
`WebsiteSectionContext`, renders a semantic `<section>` with
|
|
557
|
+
`data-section-ref` and `data-section-category`, and forwards the a11y
|
|
558
|
+
pass-throughs it declares (`ariaLabel`, `ariaLabelledBy`).
|
|
559
|
+
|
|
560
|
+
## Import Origins
|
|
561
|
+
|
|
562
|
+
- `@wildo-ai/saas-website`
|
|
563
|
+
|
|
564
|
+
## Source Excerpts
|
|
565
|
+
|
|
566
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
567
|
+
|
|
568
|
+
```tsx
|
|
569
|
+
*
|
|
570
|
+
* `WebsiteSection` — the per-section structural primitive.
|
|
571
|
+
*
|
|
572
|
+
* **Three responsibilities** (semantic-weight discipline):
|
|
573
|
+
*
|
|
574
|
+
* 1. **Provides `WebsiteSectionContext`** — registers the active
|
|
575
|
+
* sectionRef + category so leaf primitives (`useWebsiteLabel`,
|
|
576
|
+
* analytics overlays, structured-data emitters) can derive
|
|
577
|
+
* keys / metadata without re-typing the section's identity.
|
|
578
|
+
* 2. **Renders a semantic `<section>` landmark** — emits
|
|
579
|
+
* `data-section-ref` and `data-section-category` attributes so
|
|
580
|
+
* analytics tooling and SEO crawlers can identify and group
|
|
581
|
+
* sections without parsing className conventions. Optional
|
|
582
|
+
* `id` prop wires up anchor-link navigation
|
|
583
|
+
* (`<a href="#pricing">`).
|
|
584
|
+
* 3. **Provides a styling seam** — the data attributes above are
|
|
585
|
+
* what a site's CSS styles a section by. `className` is forwarded
|
|
586
|
+
* to the `<section>` element only when a site renders
|
|
587
|
+
* `WebsiteSection` itself; `WebsitePageSections`, which wraps every
|
|
588
|
+
* section of a page, passes none.
|
|
589
|
+
*
|
|
590
|
+
* **Why NOT render a `<div>` instead of `<section>`**: marketing
|
|
591
|
+
* pages benefit from semantic landmarks for SEO scoring and
|
|
592
|
+
* accessibility (screen-reader section navigation). A `<section>`
|
|
593
|
+
* with `data-section-category="hero"` is structurally meaningful;
|
|
594
|
+
* a `<div>` with the same data-attribute carries the same metadata
|
|
595
|
+
* but loses the landmark benefit.
|
|
596
|
+
*
|
|
597
|
+
* **Why `as` is NOT a prop**: switching the rendered tag
|
|
598
|
+
* (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
|
|
599
|
+
* is legitimate but rare; a section that needs one renders that
|
|
600
|
+
* element inside its body. Keeping `WebsiteSection` rendered as a
|
|
601
|
+
* literal `<section>` removes a rarely-used prop from the
|
|
602
|
+
* section-author API and keeps the SEO landmark contract guaranteed
|
|
603
|
+
* at the type level.
|
|
604
|
+
*/
|
|
605
|
+
export interface WebsiteSectionProps {
|
|
606
|
+
/**
|
|
607
|
+
* The section's ref. Accepts an already-branded `WebsiteSectionRef`
|
|
608
|
+
* or a raw string — the layout parses through
|
|
609
|
+
* `WebsiteSectionRefSchema` so a malformed ref fails loud at
|
|
610
|
+
* render. Typically sourced from the page manifest's
|
|
611
|
+
* `sectionRefs[]` (eg. `<WebsiteSection sectionRef="hero" …>`).
|
|
612
|
+
*/
|
|
613
|
+
sectionRef: WebsiteSectionRef | string;
|
|
614
|
+
/**
|
|
615
|
+
* The section's structural intent (see `WebsiteSectionCategory`).
|
|
616
|
+
* Required at the wrapper level (rather than only on the section
|
|
617
|
+
* definition) because the wrapper emits `data-section-category`
|
|
618
|
+
* for analytics, and asking the wrapper to look up the category
|
|
619
|
+
* on a separate manifest registry would re-introduce the runtime
|
|
620
|
+
* coupling the per-section context exists to avoid.
|
|
621
|
+
*/
|
|
622
|
+
category: WebsiteSectionCategory;
|
|
623
|
+
/**
|
|
624
|
+
* Optional DOM id. Wires anchor-link navigation
|
|
625
|
+
* (`<a href="#pricing">`). When omitted, the section has no DOM
|
|
626
|
+
* id — by design; not every section is an anchor target.
|
|
627
|
+
*/
|
|
628
|
+
id?: string;
|
|
629
|
+
/**
|
|
630
|
+
* Optional className applied to the `<section>` element, for a site
|
|
631
|
+
* that renders `WebsiteSection` itself. `WebsitePageSections` passes
|
|
632
|
+
* none: a page's sections are styled through `[data-section-ref]` /
|
|
633
|
+
* `[data-section-category]`.
|
|
634
|
+
*/
|
|
635
|
+
className?: string;
|
|
636
|
+
/**
|
|
637
|
+
* The section's body: the section's own component, which takes no
|
|
638
|
+
* props (`<HeroSection />`; see `WebsiteSectionComponentProps`). May be
|
|
639
|
+
* plain JSX for one-off sections that don't justify a
|
|
640
|
+
* `defineWebsiteSection` factory call.
|
|
641
|
+
*/
|
|
642
|
+
children: ReactNode;
|
|
643
|
+
/**
|
|
644
|
+
* Pass-through `aria-label` / `aria-labelledby` (the only two it
|
|
645
|
+
* forwards) for sections that need to refine their landmark semantics (eg. `aria-label="Featured
|
|
646
|
+
* customer logos"` on a logo wall).
|
|
647
|
+
*/
|
|
648
|
+
ariaLabel?: string;
|
|
649
|
+
ariaLabelledBy?: string;
|
|
650
|
+
}
|
|
651
|
+
|
|
652
|
+
export function WebsiteSection({
|
|
653
|
+
sectionRef,
|
|
654
|
+
category,
|
|
655
|
+
id,
|
|
656
|
+
className,
|
|
657
|
+
children,
|
|
658
|
+
ariaLabel,
|
|
659
|
+
ariaLabelledBy,
|
|
660
|
+
}: WebsiteSectionProps): ReactNode {
|
|
661
|
+
const safeSectionRef = useMemo<WebsiteSectionRef>(
|
|
662
|
+
() => WebsiteSectionRefSchema.parse(sectionRef),
|
|
663
|
+
[sectionRef],
|
|
664
|
+
);
|
|
665
|
+
|
|
666
|
+
const sectionContextValue = useMemo<WebsiteSectionContextValue>(
|
|
667
|
+
() => ({ sectionRef: safeSectionRef, category }),
|
|
668
|
+
[safeSectionRef, category],
|
|
669
|
+
);
|
|
670
|
+
|
|
671
|
+
/**
|
|
672
|
+
* Build the `<section>` attribute set imperatively to keep
|
|
673
|
+
* `aria-*` props off the element when omitted (rendering
|
|
674
|
+
* `aria-label={undefined}` still emits the attribute in some
|
|
675
|
+
* React versions — explicit absence is cleaner).
|
|
676
|
+
*/
|
|
677
|
+
const sectionAttrs: HTMLAttributes<HTMLElement> = {
|
|
678
|
+
className,
|
|
679
|
+
};
|
|
680
|
+
if (id !== undefined) sectionAttrs.id = id;
|
|
681
|
+
if (ariaLabel !== undefined) sectionAttrs['aria-label'] = ariaLabel;
|
|
682
|
+
if (ariaLabelledBy !== undefined) sectionAttrs['aria-labelledby'] = ariaLabelledBy;
|
|
683
|
+
|
|
684
|
+
return (
|
|
685
|
+
<WebsiteSectionContextProvider value={sectionContextValue}>
|
|
686
|
+
<section
|
|
687
|
+
data-section-ref={safeSectionRef as unknown as string}
|
|
688
|
+
data-section-category={category}
|
|
689
|
+
{...sectionAttrs}
|
|
690
|
+
>
|
|
691
|
+
{children}
|
|
692
|
+
</section>
|
|
693
|
+
</WebsiteSectionContextProvider>
|
|
694
|
+
);
|
|
695
|
+
}
|
|
696
|
+
WebsiteSection.displayName = 'WebsiteSection';
|
|
697
|
+
```
|
|
698
|
+
|
|
699
|
+
|
|
700
|
+
> **Framework rule**: the installed `@wildo-ai/saas-website` package ships the section as a
|
|
701
|
+
> configurable building block, `websiteCardGridBlock`, whose `figure` cards lead each pain
|
|
702
|
+
> with a number (what it costs: hours, days, a count) above its title and body. The section IS
|
|
703
|
+
> the block, configured — `websiteCardGridBlock.section({ pageRef, sectionRef, category, band,
|
|
704
|
+
> intro, config })` — on a band the section draws, under the section intro (eyebrow, heading,
|
|
705
|
+
> lede), and its words are derived from that same `config` and `intro`. This skill covers what
|
|
706
|
+
> a Problem section must SAY — the snapshot's pains, in the visitor's words, with no product in
|
|
707
|
+
> sight. How blocks are configured in general is `website-building-blocks`.
|
|
708
|
+
|
|
709
|
+
## Overview
|
|
710
|
+
|
|
711
|
+
A Problem section names what the visitor is struggling with **before the product says a word**. It is the
|
|
712
|
+
opening argument of every SOLUTION page (the website plan reports a solution page without one, as an authoring
|
|
713
|
+
warning the plan's review weighs; it does not refuse it)
|
|
714
|
+
and, on a home page, the bridge between the hero's promise and the product for visitors who do not yet know
|
|
715
|
+
they have the problem.
|
|
716
|
+
|
|
717
|
+
It works because a visitor recognises their own situation faster than they evaluate a feature. Its copy comes
|
|
718
|
+
from the market snapshot's **pains**, **jobs** and **triggers** for the page's audience — never from the
|
|
719
|
+
product's feature list, and never invented. If the plan's `drawsOnRefs` names no pain, say so in your report;
|
|
720
|
+
do not write one. A figure on a pain is the reader's own arithmetic as the snapshot states it ("three days
|
|
721
|
+
lost every month-end"), never a measurement the product made.
|
|
722
|
+
|
|
723
|
+
## App Paths
|
|
724
|
+
|
|
725
|
+
| Surface | Glob (relative to app root) |
|
|
726
|
+
|---|---|
|
|
727
|
+
| The configured section, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
|
|
728
|
+
| The site's config builder for the pains and its section factory | `website/src/sections/kit/**` |
|
|
729
|
+
| This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
|
|
730
|
+
| The site's adjustments to the blocks | `website/src/styles/**` (rules on `data-website-*` hooks) |
|
|
731
|
+
|
|
732
|
+
## When to Use
|
|
733
|
+
|
|
734
|
+
- A SOLUTION page, right after its hero: "Closing the books takes a week of spreadsheets".
|
|
735
|
+
- A home page whose market is problem-unaware: the pain first, then the product.
|
|
736
|
+
- A product page whose capability only makes sense once the problem is named.
|
|
737
|
+
|
|
738
|
+
## When NOT to Use
|
|
739
|
+
|
|
740
|
+
- To list features → `website-section-feature-benefit-summary`.
|
|
741
|
+
- To argue one benefit in depth → `website-section-feature-detail`.
|
|
742
|
+
- To compare with an alternative tool → `website-section-comparison` (the alternative is not the problem).
|
|
743
|
+
- To answer objections → `website-section-faq`.
|
|
744
|
+
- To quote what others publish about the problem → evidence, `website-section-social-proof`.
|
|
745
|
+
|
|
746
|
+
## Workflow
|
|
747
|
+
|
|
748
|
+
### Step 1: Read what the plan says the section draws on
|
|
749
|
+
|
|
750
|
+
The section task's brief lists the resolved `drawsOn` elements: pains, jobs, triggers, sometimes a proof. Those
|
|
751
|
+
are the only claims you may make. Quote the audience's own words when the snapshot authored them. Write the
|
|
752
|
+
snapshot element each card draws on as a `// draws-on:` comment beside it.
|
|
753
|
+
|
|
754
|
+
### Step 2: Choose the shape — two to four pains, never a wall
|
|
755
|
+
|
|
756
|
+
| Shape | Built from |
|
|
757
|
+
|---|---|
|
|
758
|
+
| **Pain cards** (default) | `websiteCardGridBlock`, one card per pain; `figure: true` on a card whose pain the snapshot costs |
|
|
759
|
+
| **Before / after** | `websiteCardGridBlock` with two cards (`before`, `after`) and `columns: 2` in its config — only when the snapshot names both |
|
|
760
|
+
| **Single statement** | no grid: a section of the site's own (`defineWebsiteBlock`, see `website-building-blocks`) rendering the section intro alone — its heading states the problem, its lede the consequence |
|
|
761
|
+
|
|
762
|
+
### Step 3: Hold the pains in one constant
|
|
763
|
+
|
|
764
|
+
The cards are a module constant of `WebsiteCardItem`s (or a config builder in the site's kit that returns them), in the order the snapshot ranks the pains for this
|
|
765
|
+
audience. A card reads `<ref>.title` and `<ref>.body`, and `<ref>.figure` when `figure` is true; name each ref for
|
|
766
|
+
its pain (`month-end`), never its position. A pain with no cost in the snapshot gets no figure — an invented
|
|
767
|
+
number is the most remembered claim on the page. No icon, no link, and so no `cta` (the card type refuses one without a `link`): a pain is not a destination.
|
|
768
|
+
|
|
769
|
+
### Step 4: Configure the grid as the section
|
|
770
|
+
|
|
771
|
+
The card grid stands on a band the section draws and takes the section intro above it (`WebsiteBlockSurface.BAND`,
|
|
772
|
+
`WebsiteBlockHeading.SECTION_INTRO`), so `websiteCardGridBlock.section(...)` takes all three:
|
|
773
|
+
|
|
774
|
+
| Choice | Where | Values |
|
|
775
|
+
|---|---|---|
|
|
776
|
+
| The pains | `config.items` | the constant of Step 3 |
|
|
777
|
+
| How the cards lay out | `config.fit` / `config.columns` | `WebsiteGridFit.AUTO` (as many as fit) · `FIXED` with `columns` `2`, `3` |
|
|
778
|
+
| The intro's words | `intro` | `{}` for eyebrow, heading and lede; `{ eyebrow: false }` or `{ lede: false }` drops one |
|
|
779
|
+
| The surface | `band` | `{ tone: WebsiteSurfaceTone.TINTED }` sets the problem apart from the hero and the product |
|
|
780
|
+
|
|
781
|
+
No product name anywhere in this section: the next section introduces the product.
|
|
782
|
+
|
|
783
|
+
### Step 5: Let the words follow the config
|
|
784
|
+
|
|
785
|
+
The section derives its words from the `intro` and the `config`: the intro's (`eyebrow` when shown, `heading`,
|
|
786
|
+
`lede` when shown) and each card's `<ref>.title` and `<ref>.body`, plus `<ref>.figure` only for the cards that
|
|
787
|
+
carry one, as `website.<page>.<section>.<slot>` keys. Nothing is listed by hand: drop a pain's figure and its word
|
|
788
|
+
goes. Author the words per locale in the label pack (`website-label-pack`).
|
|
789
|
+
|
|
790
|
+
### Step 6: Motion and the site's look — restrained
|
|
791
|
+
|
|
792
|
+
The cards already stagger in as a sequence (`WebsiteCardGridMotionPoint.ITEMS`). Nothing else moves here: set the
|
|
793
|
+
grid's `config.motion` only to slow or still it (`null`), never to add an effect. Adjust the look through the theme,
|
|
794
|
+
then a rule on a hook (`[data-website-block='card-grid'] [data-website-part='figure']`), never by forking the grid.
|
|
795
|
+
|
|
796
|
+
**Stop** when every pain traces to a `drawsOn` element, every figure to a cost the snapshot states, and no sentence
|
|
797
|
+
names the product; if any fails, **return to Step 1**.
|
|
798
|
+
|
|
799
|
+
## Worked Example
|
|
800
|
+
|
|
801
|
+
The framework's reference application builds its problem sections through a section factory in its kit: the card
|
|
802
|
+
grid on a TINTED band under the full section intro, its config from a builder (look for `problemSection` among the
|
|
803
|
+
site's section factories):
|
|
804
|
+
|
|
805
|
+
|
|
806
|
+
## Usage Example
|
|
807
|
+
|
|
808
|
+
```tsx
|
|
809
|
+
export function gridSection(
|
|
810
|
+
input: Base & {
|
|
811
|
+
readonly icons: readonly WtIcon[];
|
|
812
|
+
readonly columns?: 2 | 3 | 4;
|
|
813
|
+
readonly intro?: WebsiteSectionIntroOptions;
|
|
814
|
+
readonly links?: ReadonlyArray<string | undefined>;
|
|
815
|
+
readonly tone?: WebsiteSurfaceTone;
|
|
816
|
+
readonly category?: WebsiteSectionCategory;
|
|
817
|
+
},
|
|
818
|
+
) {
|
|
819
|
+
return websiteCardGridBlock.section({
|
|
820
|
+
pageRef: input.pageRef,
|
|
821
|
+
sectionRef: input.sectionRef,
|
|
822
|
+
category: input.category ?? WebsiteSectionCategory.FEATURE_BENEFIT_SUMMARY,
|
|
823
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
824
|
+
intro: input.intro ?? {},
|
|
825
|
+
config: featureGridConfig({ icons: input.icons, columns: input.columns ?? 3, ...(input.links === undefined ? {} : { links: input.links }) }),
|
|
826
|
+
});
|
|
827
|
+
}
|
|
828
|
+
|
|
829
|
+
export function stepsSection(input: Base & { readonly count: number; readonly intro?: WebsiteSectionIntroOptions; readonly tone?: WebsiteSurfaceTone }) {
|
|
830
|
+
return websiteStepsBlock.section({
|
|
831
|
+
pageRef: input.pageRef,
|
|
832
|
+
sectionRef: input.sectionRef,
|
|
833
|
+
category: WebsiteSectionCategory.HOW_IT_WORKS,
|
|
834
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
835
|
+
intro: input.intro ?? {},
|
|
836
|
+
config: stepsConfig({ count: input.count }),
|
|
837
|
+
});
|
|
838
|
+
}
|
|
839
|
+
|
|
840
|
+
export function problemSection(input: Base & { readonly count: number; readonly tone?: WebsiteSurfaceTone }) {
|
|
841
|
+
return websiteCardGridBlock.section({
|
|
842
|
+
pageRef: input.pageRef,
|
|
843
|
+
sectionRef: input.sectionRef,
|
|
844
|
+
category: WebsiteSectionCategory.PROBLEM,
|
|
845
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.TINTED },
|
|
846
|
+
intro: {},
|
|
847
|
+
config: problemConfig(input.count),
|
|
848
|
+
});
|
|
849
|
+
}
|
|
850
|
+
|
|
851
|
+
/** Published observations about the problem, each with its source — `sources` are the URLs, by position. */
|
|
852
|
+
export function evidenceSection(input: Base & { readonly sources: readonly string[]; readonly tone?: WebsiteSurfaceTone }) {
|
|
853
|
+
return websiteQuoteCardsBlock.section({
|
|
854
|
+
pageRef: input.pageRef,
|
|
855
|
+
sectionRef: input.sectionRef,
|
|
856
|
+
category: WebsiteSectionCategory.SOCIAL_PROOF,
|
|
857
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
858
|
+
intro: {},
|
|
859
|
+
config: evidenceConfig(input.sources),
|
|
860
|
+
});
|
|
861
|
+
}
|
|
862
|
+
|
|
863
|
+
export function comparisonSection(input: Base & { readonly rows: number; readonly columns: number; readonly tone?: WebsiteSurfaceTone }) {
|
|
864
|
+
return websiteComparisonTableBlock.section({
|
|
865
|
+
pageRef: input.pageRef,
|
|
866
|
+
sectionRef: input.sectionRef,
|
|
867
|
+
category: WebsiteSectionCategory.COMPARISON,
|
|
868
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
869
|
+
intro: {},
|
|
870
|
+
config: comparisonConfig(input.rows, input.columns),
|
|
871
|
+
});
|
|
872
|
+
}
|
|
873
|
+
|
|
874
|
+
export function tableSection(input: Base & { readonly rows: number; readonly columns: number; readonly tone?: WebsiteSurfaceTone }) {
|
|
875
|
+
return websiteFactTableBlock.section({
|
|
876
|
+
pageRef: input.pageRef,
|
|
877
|
+
sectionRef: input.sectionRef,
|
|
878
|
+
category: WebsiteSectionCategory.FEATURE_DETAIL,
|
|
879
|
+
band: { tone: input.tone ?? WebsiteSurfaceTone.DEFAULT },
|
|
880
|
+
intro: {},
|
|
881
|
+
config: tableConfig(input.rows, input.columns),
|
|
882
|
+
});
|
|
883
|
+
}
|
|
884
|
+
```
|
|
885
|
+
|
|
886
|
+
Its builder, `problemConfig`, lays the cards out with `fit: AUTO` and leads every pain with a figure, because every
|
|
887
|
+
pain that site shows has a cost its snapshot states (look for the PROBLEM block among the site's config builders):
|
|
888
|
+
|
|
889
|
+
|
|
890
|
+
## Usage Example
|
|
891
|
+
|
|
892
|
+
```tsx
|
|
893
|
+
// ── FEATURE GRID: capabilities as icon cards ─────────────────────────────────────────────────────────────────────────
|
|
894
|
+
|
|
895
|
+
/** Capabilities as cards, each with its glyph. `links` (by position) makes a card a link to the page that argues it. */
|
|
896
|
+
export function featureGridConfig({
|
|
897
|
+
icons,
|
|
898
|
+
columns = 3,
|
|
899
|
+
links,
|
|
900
|
+
}: {
|
|
901
|
+
icons: readonly WtIcon[];
|
|
902
|
+
columns?: 2 | 3 | 4;
|
|
903
|
+
links?: ReadonlyArray<string | undefined>;
|
|
904
|
+
}): WebsiteCardGridProps {
|
|
905
|
+
return {
|
|
906
|
+
columns,
|
|
907
|
+
items: icons.map((icon, position) => {
|
|
908
|
+
const routePath = links?.[position];
|
|
909
|
+
return {
|
|
910
|
+
ref: `item${position + 1}`,
|
|
911
|
+
icon: <Icon name={icon} />,
|
|
912
|
+
...(routePath === undefined ? {} : { link: { kind: WebsiteMenuLinkKind.PAGE, routePath } as const }),
|
|
913
|
+
};
|
|
914
|
+
}),
|
|
915
|
+
};
|
|
916
|
+
}
|
|
917
|
+
|
|
918
|
+
// ── STEPS ────────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
919
|
+
|
|
920
|
+
/** How it works, as an ordered list. `visuals` (by position) draws each step; without them, each step is numbered. */
|
|
921
|
+
export function stepsConfig({ count, visuals }: { count: number; visuals?: readonly ReactNode[] }): WebsiteStepsProps {
|
|
922
|
+
return {
|
|
923
|
+
steps: indexes(count).map((index) => ({ ref: `step${index}`, ...(visuals?.[index - 1] === undefined ? {} : { visual: visuals[index - 1] }) })),
|
|
924
|
+
};
|
|
925
|
+
}
|
|
926
|
+
|
|
927
|
+
// ── STATS: facts as numbers, counted up once ─────────────────────────────────────────────────────────────────────────
|
|
928
|
+
|
|
929
|
+
export function statsConfig(count: number): WebsiteStatsProps {
|
|
930
|
+
return { stats: indexes(count).map((index) => `stat${index}`) };
|
|
931
|
+
}
|
|
932
|
+
|
|
933
|
+
// ── COMPARISON and TABLE ─────────────────────────────────────────────────────────────────────────────────────────────
|
|
934
|
+
|
|
935
|
+
const rowRefs = (rows: number): string[] => indexes(rows).map((index) => `row${index}`);
|
|
936
|
+
const columnRefs = (columns: number): string[] => indexes(columns).map((index) => `column${index}`);
|
|
937
|
+
|
|
938
|
+
/** The product against the alternatives, honestly: a real table, the product's column first and marked. */
|
|
939
|
+
export function comparisonConfig(rows: number, columns: number): WebsiteComparisonTableProps {
|
|
940
|
+
return { rows: rowRefs(rows), columns: columnRefs(columns), highlight: 'column1' };
|
|
941
|
+
}
|
|
942
|
+
|
|
943
|
+
/** A plain data table: a caption, scoped column headers, the first cell of each row as its header. */
|
|
944
|
+
export function tableConfig(rows: number, columns: number): WebsiteFactTableProps {
|
|
945
|
+
return { rows: rowRefs(rows), columns: columnRefs(columns) };
|
|
946
|
+
}
|
|
947
|
+
|
|
948
|
+
// ── FAQ ──────────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
949
|
+
|
|
950
|
+
const questionRefs = (count: number): string[] => indexes(count).map((index) => `q${index}`);
|
|
951
|
+
|
|
952
|
+
/** Questions as `<details>`: answerable without JavaScript. The intro has no eyebrow. */
|
|
953
|
+
export function faqConfig(count: number): WebsiteFaqProps {
|
|
954
|
+
return { questions: questionRefs(count), intro: { eyebrow: false } };
|
|
955
|
+
}
|
|
956
|
+
|
|
957
|
+
/** The page's FAQPage JSON-LD, from the words the section shows. */
|
|
958
|
+
export function faqStructuredData(count: number): ReturnType<typeof websiteFaqStructuredData> {
|
|
959
|
+
return websiteFaqStructuredData(questionRefs(count));
|
|
960
|
+
}
|
|
961
|
+
|
|
962
|
+
// ── SOLUTION PATHS ───────────────────────────────────────────────────────────────────────────────────────────────────
|
|
963
|
+
|
|
964
|
+
/** One card per audience, each the whole-card link to the solution page written for it. */
|
|
965
|
+
export function solutionPathsConfig(slugs: readonly string[], icons: readonly WtIcon[]): WebsiteSolutionPathsProps {
|
|
966
|
+
return {
|
|
967
|
+
paths: slugs.map((slug, position) => ({
|
|
968
|
+
ref: slug,
|
|
969
|
+
link: { kind: WebsiteMenuLinkKind.PAGE, routePath: `/solutions/${slug}` } as const,
|
|
970
|
+
icon: <Icon name={icons[position] ?? WtIcon.USERS} />,
|
|
971
|
+
})),
|
|
972
|
+
};
|
|
973
|
+
}
|
|
974
|
+
|
|
975
|
+
// ── EVIDENCE: what people say about the problem, with the source ─────────────────────────────────────────────────────
|
|
976
|
+
|
|
977
|
+
/**
|
|
978
|
+
* Published observations about the PROBLEM, each linked to where it was published. Never a testimonial: these people
|
|
979
|
+
* have not used the product, and the block says whose words they are and where to read them. `sources` are the URLs,
|
|
980
|
+
* by position — addresses, not words, so they live in code.
|
|
981
|
+
*/
|
|
982
|
+
export function evidenceConfig(sources: readonly string[]): WebsiteQuoteCardsProps {
|
|
983
|
+
return { quotes: sources.map((href, position) => ({ ref: `quote${position + 1}`, source: { kind: WebsiteMenuLinkKind.EXTERNAL, href } as const })) };
|
|
984
|
+
}
|
|
985
|
+
|
|
986
|
+
// ── ROADMAP ──────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
987
|
+
|
|
988
|
+
/** A roadmap phase as a page shows it: its horizon (the application's own vocabulary) and how many items it lists. */
|
|
989
|
+
export interface RoadmapPhaseShown {
|
|
990
|
+
readonly horizon: RoadmapPhaseHorizon;
|
|
991
|
+
readonly items: number;
|
|
992
|
+
/** Every item of the phase works in the application today (verified there), so each is shown with a check. */
|
|
993
|
+
readonly available?: boolean;
|
|
994
|
+
}
|
|
995
|
+
|
|
996
|
+
/** The plan, in the open: what we build now, next and later — the product's own roadmap phases. */
|
|
997
|
+
export function roadmapConfig(phases: readonly RoadmapPhaseShown[]): WebsiteRoadmapProps {
|
|
998
|
+
return {
|
|
999
|
+
phases: phases.map((phase, position) => ({
|
|
1000
|
+
ref: `phase${position + 1}`,
|
|
1001
|
+
horizon: phase.horizon,
|
|
1002
|
+
items: indexes(phase.items).map((index) => ({ ref: `item${index}`, available: phase.available === true })),
|
|
1003
|
+
})),
|
|
1004
|
+
};
|
|
1005
|
+
}
|
|
1006
|
+
|
|
1007
|
+
// ── LINK CARDS: one card per page of an area, each with its drawing ──────────────────────────────────────────────────
|
|
1008
|
+
|
|
1009
|
+
export function linkCardsConfig(
|
|
1010
|
+
cards: ReadonlyArray<{ readonly ref: string; readonly routePath: string; readonly icon: WtIcon; readonly visual?: ReactNode }>,
|
|
1011
|
+
): WebsiteCardGridProps {
|
|
1012
|
+
return {
|
|
1013
|
+
fit: WebsiteGridFit.AUTO,
|
|
1014
|
+
motion: { [WebsiteCardGridMotionPoint.ITEMS]: { stagger: WebsiteMotionReveal.SCALE }, [WebsiteCardGridMotionPoint.LINK_CARD]: { hover: WebsiteMotionHover.GLOW } },
|
|
1015
|
+
items: cards.map((card) => ({
|
|
1016
|
+
ref: card.ref,
|
|
1017
|
+
icon: <Icon name={card.icon} />,
|
|
1018
|
+
link: { kind: WebsiteMenuLinkKind.PAGE, routePath: card.routePath } as const,
|
|
1019
|
+
cta: true as const,
|
|
1020
|
+
...(card.visual === undefined ? {} : { media: card.visual }),
|
|
1021
|
+
})),
|
|
1022
|
+
};
|
|
1023
|
+
}
|
|
1024
|
+
|
|
1025
|
+
// ── FINAL CTA ────────────────────────────────────────────────────────────────────────────────────────────────────────
|
|
1026
|
+
|
|
1027
|
+
/** The page's close, on the inverse band, with the brand's three forward-leaning stripes behind it. */
|
|
1028
|
+
export function finalCtaConfig(secondaryRoutePath: string): WebsiteCtaBandProps {
|
|
1029
|
+
return { decoration: <Stripes className="brand-stripes-close" />, ...heroActions(secondaryRoutePath) };
|
|
1030
|
+
}
|
|
1031
|
+
|
|
1032
|
+
// ── PROBLEM: the reader's situation, before any product ─────────────────────────────────────────────────────────────
|
|
1033
|
+
|
|
1034
|
+
/**
|
|
1035
|
+
* The problem in the reader's own terms, before the product appears: one card per pain, each led by its figure (a cost
|
|
1036
|
+
* in minutes or hours, a count) so the pain is concrete. The figures are the reader's arithmetic, not our measurement.
|
|
1037
|
+
*/
|
|
1038
|
+
export function problemConfig(count: number): WebsiteCardGridProps {
|
|
1039
|
+
return { fit: WebsiteGridFit.AUTO, items: indexes(count).map((index) => ({ ref: `pain${index}`, figure: true })) };
|
|
1040
|
+
}
|
|
1041
|
+
```
|
|
1042
|
+
|
|
1043
|
+
When only some pains have a stated cost, give the section its own items, named for their pains:
|
|
1044
|
+
|
|
1045
|
+
<!-- TIER C WAIVER: the anchored builder above numbers its pains and figures every one. This block shows what Steps 2–5 and the Verification below reference where they differ: pains named for what they are, a `draws-on:` comment per pain, `figure` only where the snapshot gives a cost, and `websiteCardGridBlock.section(...)` with `category: WebsiteSectionCategory.PROBLEM`, a band and an intro. Keep it inline until such a section is deliberately anchored. -->
|
|
1046
|
+
```tsx
|
|
1047
|
+
// website/src/sections/<page>.sections.tsx
|
|
1048
|
+
/** The pains, in the order the snapshot ranks them for this audience. A figure only where the snapshot gives a cost. */
|
|
1049
|
+
const PAINS: readonly WebsiteCardItem[] = [
|
|
1050
|
+
{ ref: 'month-end', figure: true }, // draws-on: pain `month-end-slips` (its consequence names the days lost)
|
|
1051
|
+
{ ref: 'reconciling', figure: true }, // draws-on: pain `manual-reconciliation` (its consequence names the hours)
|
|
1052
|
+
{ ref: 'audit-trail' }, // draws-on: pain `no-audit-trail` (no cost in the snapshot, so no figure)
|
|
1053
|
+
];
|
|
1054
|
+
|
|
1055
|
+
export const FINANCE_PROBLEM_SECTION = websiteCardGridBlock.section({
|
|
1056
|
+
pageRef: 'finance-teams',
|
|
1057
|
+
sectionRef: 'finance-teams-problem',
|
|
1058
|
+
category: WebsiteSectionCategory.PROBLEM,
|
|
1059
|
+
band: { tone: WebsiteSurfaceTone.TINTED },
|
|
1060
|
+
// Words: heading, lede, month-end.figure, month-end.title, month-end.body, … audit-trail.body (no figure for it).
|
|
1061
|
+
intro: { eyebrow: false },
|
|
1062
|
+
config: { items: PAINS, fit: WebsiteGridFit.AUTO },
|
|
1063
|
+
});
|
|
1064
|
+
```
|
|
1065
|
+
|
|
1066
|
+
Add the section to the page's `<PAGE>_SECTIONS` list at its reading-order position: on a SOLUTION page, right after
|
|
1067
|
+
the hero. It holds no list markup, no grid CSS and no list of its words: the cards, their figures, their stagger and their
|
|
1068
|
+
words come from the block and its config.
|
|
1069
|
+
|
|
1070
|
+
## Structured-data contract
|
|
1071
|
+
|
|
1072
|
+
None. A problem statement is not an entity search engines index; leave `getStructuredData` undefined.
|
|
1073
|
+
|
|
1074
|
+
## References
|
|
1075
|
+
|
|
1076
|
+
- `references/framework-website-card-grid-api.md` — source-backed `websiteCardGridBlock` (and `defineWebsiteBlock`,
|
|
1077
|
+
which decides what its `section(...)` takes), `WebsiteCardGrid`, `WebsiteCard`, the intro and how words are keyed.
|
|
1078
|
+
- `references/define-website-section-api.md` — source-backed factory, schema and label-hook contracts.
|
|
1079
|
+
- `../website-building-blocks/references/framework-website-blocks-api.md` — every block and the stylesheet's hooks.
|
|
1080
|
+
|
|
1081
|
+
## Verification
|
|
1082
|
+
|
|
1083
|
+
- [ ] `category: WebsiteSectionCategory.PROBLEM` (typed enum).
|
|
1084
|
+
- [ ] The section is `websiteCardGridBlock.section(...)` (or a site factory calling it; a site block for a single
|
|
1085
|
+
statement) — no hand-built list of pains, no `<WebsiteCardGrid>` in a hand-written component.
|
|
1086
|
+
- [ ] Every pain traces to a pain / job / trigger in the brief's `drawsOn` (a `draws-on:` comment each).
|
|
1087
|
+
- [ ] A card carries `figure: true` only where the snapshot states a cost, and its figure is that cost.
|
|
1088
|
+
- [ ] The product's name does not appear in this section's copy.
|
|
1089
|
+
- [ ] Two to four pains; each one a visitor could say out loud.
|
|
1090
|
+
- [ ] No word is listed by hand: the section derives them from its `intro` and `config`.
|
|
1091
|
+
|
|
1092
|
+
### Grep invariants
|
|
1093
|
+
|
|
1094
|
+
`npx astro check` in `website/` must pass. Then, from the app root:
|
|
1095
|
+
|
|
1096
|
+
```bash
|
|
1097
|
+
# The problem is a configured section (must return >= 1, in the page file or a kit factory)
|
|
1098
|
+
rg -n "category: WebsiteSectionCategory\.PROBLEM" website/src/sections
|
|
1099
|
+
|
|
1100
|
+
# The grid is configured, never composed by hand (must return >= 1)
|
|
1101
|
+
rg -n "websiteCardGridBlock\.section\(" website/src/sections
|
|
1102
|
+
|
|
1103
|
+
# No hand composition and no hand-listed words (review each hit: only a site block's own `defineWebsiteBlock` may use them)
|
|
1104
|
+
rg -n "<WebsiteCardGrid\b|websiteCardGridSlots\(|websiteSectionIntroSlots\(" website/src/sections
|
|
1105
|
+
|
|
1106
|
+
# Category enum, not a string (must return empty)
|
|
1107
|
+
rg -n "category: 'problem'" website/src/sections/
|
|
1108
|
+
|
|
1109
|
+
# Every pain names what it draws on (the count must equal the number of pains)
|
|
1110
|
+
rg -c "draws-on:" website/src/sections/<page>.sections.tsx
|
|
1111
|
+
|
|
1112
|
+
# The figures shown, to read against the snapshot's costs (each must be a cost the snapshot states)
|
|
1113
|
+
rg -n '\.figure"' website/src/i18n/en.json website/src/i18n/en/
|
|
1114
|
+
|
|
1115
|
+
# No product name in the section's words (substitute the product's name; must return empty for this section's keys)
|
|
1116
|
+
rg -n -i "<product name>" website/src/i18n/en.json website/src/i18n/en/
|
|
1117
|
+
|
|
1118
|
+
# No hand-spelled motion attributes (must return empty)
|
|
1119
|
+
rg -n "data-website-(reveal|stagger)=" website/src/sections/
|
|
1120
|
+
```
|
|
1121
|
+
|
|
1122
|
+
## Common Rationalizations
|
|
1123
|
+
|
|
1124
|
+
| Rationalization | Reality |
|
|
1125
|
+
|---|---|
|
|
1126
|
+
| "I'll lead with the product, it's what we sell" | A solution page is the product seen from a problem. Lead with the product and it is a features page in disguise. |
|
|
1127
|
+
| "The snapshot has no pain for this audience, I'll write a plausible one" | An invented pain is a claim nothing backs. Report the gap; the plan is what is wrong. |
|
|
1128
|
+
| "A figure on every card looks more consistent" | A figure the snapshot does not state is an invented number. Leave `figure` off that card. |
|
|
1129
|
+
| "Six pains show we understand them" | Past four, a reader skims. Pick the ones the snapshot ranks highest for this ICP. |
|
|
1130
|
+
| "A dramatic animation sells the pain" | Motion on a problem statement reads as theatre. The grid's stagger is the ceiling. |
|
|
1131
|
+
| "I'll wrap the grid and the intro in a component and list their words" | Then the words are listed apart from what renders, and a dropped figure leaves a word nobody shows. Configure `websiteCardGridBlock.section(...)`: the intro and the cards declare their own words. |
|
|
1132
|
+
| "I'll write the pain list myself, it's a `<ul>`" | The grid lays the cards out at the theme's breakpoints, draws the figures on every tone and staggers them in. A hand-built list stops following every fix. |
|
|
1133
|
+
|
|
1134
|
+
## Red Flags
|
|
1135
|
+
|
|
1136
|
+
- A hand-built pain list, or a `<WebsiteCardGrid>` in a hand-written section — catch with the "No hand composition"
|
|
1137
|
+
grep above, and the configured-grid grep (must return >= 1).
|
|
1138
|
+
- A pain with no `drawsOn` element behind it — catch with the `draws-on:` grep above, compared with the brief.
|
|
1139
|
+
- A figure that is not a cost the snapshot states — catch with the figure grep above.
|
|
1140
|
+
- The product name inside the Problem section — catch with the product-name grep above.
|
|
1141
|
+
- Hand-written `data-website-reveal` attributes — catch with the motion grep above.
|
|
1142
|
+
|
|
1143
|
+
## Related Skills
|
|
1144
|
+
|
|
1145
|
+
- `website-building-blocks` — how the engine's blocks are configured as sections, derive their words and are adjusted without forking.
|
|
1146
|
+
- `website-page-authoring` — page kinds; a SOLUTION page opens Hero → Problem.
|
|
1147
|
+
- `website-section-feature-detail` — what the product does about each pain, next.
|
|
1148
|
+
- `website-section-social-proof` — published evidence about the problem, sourced.
|
|
1149
|
+
- `website-motion-design` — the motion vocabulary.
|
|
1150
|
+
- `website-label-pack` — the pains' words, per locale.
|