@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
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 +3 -3
- 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 +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/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 +7 -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 +76 -14
- 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 +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- 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.map +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.map +1 -1
- 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 +35 -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 +19 -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 +30 -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 +87 -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.map +1 -1
- 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 +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- 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.d.ts.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 +3 -5
- 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.d.ts.map +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 +8 -6
- 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 +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.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 +4 -1
- 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 +11 -3
- 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.d.ts.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 +5 -2
- 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 +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.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.d.ts.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 +16 -7
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +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.d.ts.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.d.ts.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.d.ts.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.d.ts.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 +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- 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 +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -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 +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- 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 +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- 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 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- 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 +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- 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/playbook.json +15 -3
- 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 +43 -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 +3 -3
- 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 +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- 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/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- 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 +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- 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 +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- 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 +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- 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 +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -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 +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- 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.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.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- 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.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- 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.website.demo.complete-items.md +3 -3
- 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.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- 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 +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- 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.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- 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.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 +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- 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.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- 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.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.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- 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 +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -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.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- 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-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -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 +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -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 +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- 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 +10 -11
- 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 +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- 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 +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- 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 +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- 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-audit-log-event-api.md +2 -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 +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- 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 +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- 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 +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -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 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- 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-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- 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 +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- 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 +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- 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 +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- 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 +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- 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 +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- 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/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 +3 -3
- 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-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- 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 +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -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 +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- 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 +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- 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 +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- 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 +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- 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/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- 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 +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- 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 +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- 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 +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -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 +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- 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 +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- 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 +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- 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/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- 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 +21 -2
- 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 +121 -75
- 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 +100 -71
- 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-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 +36 -5
- 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 +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -752,9 +752,9 @@ website.
|
|
|
752
752
|
| The billing catalogue (the prices, the grants) | `shared-lib/src/engine/product.ts` — or wherever the shared modules declare `productDefinitions` |
|
|
753
753
|
| The site's words per catalogue plan, shared by every page that shows the plans | `website/src/sections/kit/**` |
|
|
754
754
|
| Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` |
|
|
755
|
-
| The route: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` (and every route whose page shows plans) |
|
|
756
|
-
| The offers of one page (called by the route), and the per-locale
|
|
757
|
-
|
|
|
755
|
+
| The route, or the page helper every route calls: loads the catalogue, passes it to the island, renders the offers | `website/src/pages/pricing.astro` (and every route whose page shows plans), or the helper it calls (`website/src/*.ts`) |
|
|
756
|
+
| The offers of one page (called by the route), and the per-locale payloads the audit reads | `website/src/structured-data/**` (e.g. `page-payloads.ts`) |
|
|
757
|
+
| This section's words, per locale | `website/src/i18n/<locale>/<page>.<sectionRef>.json`: the section's own file, merged into the locale's pack |
|
|
758
758
|
| The site's adjustments to the block | `website/src/styles/**` (rules on `data-website-*` hooks) |
|
|
759
759
|
|
|
760
760
|
## When to Use
|
|
@@ -792,9 +792,9 @@ of exceptions in the website.
|
|
|
792
792
|
|
|
793
793
|
### Step 2: Load the catalogue in the route
|
|
794
794
|
|
|
795
|
-
In the route's frontmatter, `await loadWebsitePricingCatalog()` (from
|
|
796
|
-
`targetScope` when the catalogue sells to more than one audience) and pass
|
|
797
|
-
`pricingCatalog
|
|
795
|
+
In the route's frontmatter, or in the page helper every route calls, `await loadWebsitePricingCatalog()` (from
|
|
796
|
+
`@wildo-ai/saas-website/config-loader`; pass `targetScope` when the catalogue sells to more than one audience) and pass
|
|
797
|
+
the result to the bridge island as `pricingCatalog`. Load it once per build and share it: it costs seconds. The loader reads the catalogue from source, so it is current on every build.
|
|
798
798
|
Every route whose page shows a pricing block does this, the home page's included; the block throws on a page that
|
|
799
799
|
passed none, rather than stating that the application sells nothing.
|
|
800
800
|
|
|
@@ -861,18 +861,19 @@ phrase, and required when one is published), and a range never mixes flat and pe
|
|
|
861
861
|
yearly ones. The unit is ONE per page: the catalogue does not record what a per-unit price is per, so a page whose
|
|
862
862
|
per-unit plans charge for different things (seats and gigabytes) cannot be published truthfully by this builder.
|
|
863
863
|
|
|
864
|
-
The offers belong to ONE page in ONE locale: its URL and its words. Build them in a single function
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
864
|
+
The offers belong to ONE page in ONE locale: its URL and its words. Build them in a single function under
|
|
865
|
+
`website/src/structured-data/`, from that page's locale, its `labelPack` and the site's origin, and call it from both
|
|
866
|
+
readers: the route (or its page helper) renders it through `renderPageStructuredData({ sections, context:
|
|
867
|
+
runtime.structuredData, pagePayloads })`, and `resolveStructuredDataPagePayloadsForManifest` returns it once per
|
|
868
|
+
locale, each at that locale's route, for the audit. The origin is the site's ONE declared origin, the page context's
|
|
869
|
+
`siteOrigin` or the constant the website config declares as `publicOrigin`, never a literal in the offers function;
|
|
870
|
+
and every URL goes through the localized route (`buildLocalizedRoutePath`). With one URL written for every locale, the
|
|
871
|
+
French page publishes the default-locale page's URL.
|
|
871
872
|
|
|
872
|
-
The
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
|
|
873
|
+
The `SoftwareApplication` the offers name as `itemOffered`, at `${siteOrigin}/#software-application`, carries no
|
|
874
|
+
price, and where it is emitted is the site's choice: from the PLANS section's own `getStructuredData()` (which reads
|
|
875
|
+
`siteOrigin` from the page context it receives, and a word such as a `description` through `label('<slot>')`, in the
|
|
876
|
+
page's locale), or page-wide beside the offers. A teaser section emits nothing of its own.
|
|
876
877
|
|
|
877
878
|
### Step 8: Make it this site's own without forking the block
|
|
878
879
|
|
|
@@ -893,118 +894,159 @@ temporary promotions, coupon copy, or locale-specific price tables.
|
|
|
893
894
|
|
|
894
895
|
## Worked Example
|
|
895
896
|
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
897
|
+
The worked example is a site that renders its pricing from its billing catalogue. Its kit holds
|
|
898
|
+
the site's words per catalogue plan (`PLANS`, by each plan's catalogue key), and each feature line names the GRANT it
|
|
899
|
+
describes, so the block refuses a line its plan does not grant. It also holds the statements its prices need words for
|
|
900
|
+
(here a trial) and the two blocks built from the same constants, the home page's teaser and the pricing page's plans.
|
|
901
|
+
Each options set goes to the block AND to `websitePricingSlots(...)`, so the label pack asks for exactly the words the
|
|
902
|
+
block reads:
|
|
900
903
|
|
|
901
|
-
/**
|
|
902
|
-
* The site's words per catalogue plan, by the plan's catalogue key: never a price, and never which plans are sold.
|
|
903
|
-
* Each feature line names the GRANT it describes (a feature or limit id of the plan's product), and the block refuses
|
|
904
|
-
* a line its plan does not grant. A plan's `link` replaces sign-up as its call to action. Shared by every page that
|
|
905
|
-
* shows the plans, so their words cannot disagree.
|
|
906
|
-
*/
|
|
907
|
-
export const PRICING_PLAN_WORDS: readonly WebsitePricingPlanWords[] = [
|
|
908
|
-
{ key: 'starter', features: [{ ref: 'projects', grant: 'MAX_PROJECTS' }] },
|
|
909
|
-
{
|
|
910
|
-
key: 'team',
|
|
911
|
-
features: [
|
|
912
|
-
{ ref: 'projects', grant: 'MAX_PROJECTS' },
|
|
913
|
-
{ ref: 'sso', grant: 'SINGLE_SIGN_ON' },
|
|
914
|
-
],
|
|
915
|
-
},
|
|
916
|
-
// Priced on request: its call to action goes to the contact page, not to sign-up.
|
|
917
|
-
{ key: 'enterprise', features: [{ ref: 'audit-export', grant: 'AUDIT_EXPORT' }], link: { kind: WebsiteMenuLinkKind.PAGE, routePath: '/contact' } },
|
|
918
|
-
];
|
|
919
904
|
|
|
920
|
-
|
|
921
|
-
```
|
|
905
|
+
## Usage Example
|
|
922
906
|
|
|
923
907
|
```tsx
|
|
924
|
-
// website/src/sections/pricing.sections.tsx
|
|
925
908
|
import type { ReactNode } from 'react';
|
|
909
|
+
|
|
926
910
|
import {
|
|
927
|
-
|
|
928
|
-
WebsiteBand,
|
|
911
|
+
WebsiteMenuLinkKind,
|
|
929
912
|
WebsitePricing,
|
|
930
913
|
WebsitePricingLayout,
|
|
931
|
-
websitePricingSlots,
|
|
932
914
|
WebsitePricingStatement,
|
|
933
|
-
WebsiteSectionCategory,
|
|
934
915
|
WebsiteSectionIntro,
|
|
916
|
+
websitePricingSlots,
|
|
935
917
|
websiteSectionIntroSlots,
|
|
918
|
+
type WebsitePricingPlanWords,
|
|
936
919
|
} from '@wildo-ai/saas-website';
|
|
937
920
|
|
|
938
|
-
import { PRICING_PLAN_WORDS } from './kit/pricing-words';
|
|
939
|
-
|
|
940
921
|
/**
|
|
941
|
-
*
|
|
942
|
-
*
|
|
943
|
-
*
|
|
922
|
+
* Pricing, from the billing catalogue the backend sells from (`shared-lib/src/engine/product.ts`, delivered by the
|
|
923
|
+
* route as `pricingCatalog`), on the engine's `WebsitePricing` block. A price is never a label: amounts, currency,
|
|
924
|
+
* cadence, trial length and the recommended plan all come from the catalogue.
|
|
925
|
+
*
|
|
926
|
+
* `PLANS` is the site's words per catalogue plan: which plans it has words for, and what each feature line describes.
|
|
927
|
+
* A line names the GRANT it describes, and the block refuses a line its plan does not grant, so the page cannot promise
|
|
928
|
+
* what checkout does not sell. The grant ids are `ApplicationFeature` members of `shared-lib/src/engine/features.ts`,
|
|
929
|
+
* written as their wire values because the website does not depend on the shared library.
|
|
930
|
+
*
|
|
931
|
+
* The catalogue's `BULK_EXPORT`, `ADVANCED_REPORTS` and `CUSTOM_WORKFLOWS` grants gate no product behaviour yet, so no
|
|
932
|
+
* line names them; the add-ons are stated in the plans note.
|
|
933
|
+
*/
|
|
934
|
+
const PLANS: readonly WebsitePricingPlanWords[] = [
|
|
935
|
+
{ key: 'org-free', features: [{ ref: 'feature1', grant: 'MAX_TODO_LISTS' }] },
|
|
936
|
+
{ key: 'org-professional', features: [{ ref: 'feature1', grant: 'MAX_TODO_LISTS' }] },
|
|
937
|
+
{
|
|
938
|
+
key: 'org-enterprise',
|
|
939
|
+
features: [
|
|
940
|
+
{ ref: 'feature1', grant: 'MAX_TODO_LISTS' },
|
|
941
|
+
{ ref: 'feature2', grant: 'AI_ASSISTANT' },
|
|
942
|
+
],
|
|
943
|
+
},
|
|
944
|
+
];
|
|
945
|
+
|
|
946
|
+
/** Every plan is a flat price, monthly or yearly; the Professional plan offers a trial, which the cards state. */
|
|
947
|
+
const PLANS_STATEMENTS = [WebsitePricingStatement.TRIAL];
|
|
948
|
+
|
|
949
|
+
const PRICING_PAGE = { kind: WebsiteMenuLinkKind.PAGE, routePath: '/pricing' } as const;
|
|
950
|
+
|
|
951
|
+
/*
|
|
952
|
+
* One options constant per layout, passed whole to the block AND to `websitePricingSlots(...)`, so the words a section
|
|
953
|
+
* declares are exactly the words its block reads.
|
|
944
954
|
*/
|
|
945
|
-
const
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
note: true,
|
|
956
|
-
} as const;
|
|
957
|
-
|
|
958
|
-
function PricingPlans(): ReactNode {
|
|
955
|
+
const TEASER = { layout: WebsitePricingLayout.TEASER, plans: PLANS, pricingPage: PRICING_PAGE } as const;
|
|
956
|
+
const PLANS_PAGE = { layout: WebsitePricingLayout.PLANS, plans: PLANS, note: true, statements: PLANS_STATEMENTS } as const;
|
|
957
|
+
|
|
958
|
+
// ── TEASER (home page) ───────────────────────────────────────────────────────────────────────────────────────────────
|
|
959
|
+
|
|
960
|
+
export function pricingTeaserSlots(): string[] {
|
|
961
|
+
return [...websiteSectionIntroSlots(), ...websitePricingSlots(TEASER)];
|
|
962
|
+
}
|
|
963
|
+
|
|
964
|
+
export function PricingTeaserBlock(): ReactNode {
|
|
959
965
|
return (
|
|
960
|
-
|
|
966
|
+
<>
|
|
961
967
|
<WebsiteSectionIntro />
|
|
962
|
-
<WebsitePricing {...
|
|
963
|
-
|
|
968
|
+
<WebsitePricing {...TEASER} />
|
|
969
|
+
</>
|
|
970
|
+
);
|
|
971
|
+
}
|
|
972
|
+
PricingTeaserBlock.displayName = 'WonderTodosPricingTeaserBlock';
|
|
973
|
+
|
|
974
|
+
// ── PLANS (pricing page) ─────────────────────────────────────────────────────────────────────────────────────────────
|
|
975
|
+
|
|
976
|
+
export function pricingPlansSlots(): string[] {
|
|
977
|
+
return [...websiteSectionIntroSlots(), ...websitePricingSlots(PLANS_PAGE)];
|
|
978
|
+
}
|
|
979
|
+
|
|
980
|
+
export function PricingPlansBlock(): ReactNode {
|
|
981
|
+
return (
|
|
982
|
+
<>
|
|
983
|
+
<WebsiteSectionIntro />
|
|
984
|
+
<WebsitePricing {...PLANS_PAGE} />
|
|
985
|
+
</>
|
|
964
986
|
);
|
|
965
987
|
}
|
|
988
|
+
PricingPlansBlock.displayName = 'WonderTodosPricingPlansBlock';
|
|
989
|
+
```
|
|
990
|
+
|
|
991
|
+
The pricing page's PLANS section is the block in a band, with its intro composed by hand, because pricing is the one
|
|
992
|
+
section not configured as a block:
|
|
993
|
+
|
|
994
|
+
|
|
995
|
+
## Usage Example
|
|
966
996
|
|
|
997
|
+
```tsx
|
|
998
|
+
// The pricing page's PLANS section: the block, in a tinted band. Its JSON-LD (the application and its offers) is
|
|
999
|
+
// page-wide, built in `structured-data/page-structured-data.ts`, so the section itself publishes none.
|
|
967
1000
|
export const PRICING_PLANS_SECTION = defineWebsiteBlockSection({
|
|
968
|
-
pageRef:
|
|
1001
|
+
pageRef: PAGE_REF,
|
|
969
1002
|
sectionRef: 'pricing-plans',
|
|
970
1003
|
category: WebsiteSectionCategory.PRICING,
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
'@type': 'SoftwareApplication',
|
|
978
|
-
'@id': `${siteOrigin}/#software-application`,
|
|
979
|
-
name: 'Example Application',
|
|
980
|
-
applicationCategory: 'BusinessApplication',
|
|
981
|
-
operatingSystem: 'Web',
|
|
982
|
-
}),
|
|
1004
|
+
slots: pricingPlansSlots(),
|
|
1005
|
+
Component: () => (
|
|
1006
|
+
<WebsiteBand tone={WebsiteSurfaceTone.TINTED}>
|
|
1007
|
+
<PricingPlansBlock />
|
|
1008
|
+
</WebsiteBand>
|
|
1009
|
+
),
|
|
983
1010
|
});
|
|
984
1011
|
```
|
|
985
1012
|
|
|
1013
|
+
Two shapes the worked example does not need, and how to write them:
|
|
1014
|
+
|
|
1015
|
+
- **A plan sold on request.** Give its `PLANS` entry a `link` (`{ kind: WebsiteMenuLinkKind.PAGE, routePath:
|
|
1016
|
+
'/contact' }`); the link replaces sign-up as its call to action, and the catalogue's on-request plan then needs
|
|
1017
|
+
`WebsitePricingStatement.ON_REQUEST` in the statements.
|
|
1018
|
+
- **A price per member, a floor, an announced plan.** Add `PER_UNIT`, `STARTING_AT` or `UPCOMING` to the statements.
|
|
1019
|
+
For a per-unit price, add the `offer.unit` slot to the section (the noun the offers publish as the unit, "member")
|
|
1020
|
+
and pass `perUnitName` to the offers builder. If the catalogue changes, the block names the statement or period it
|
|
1021
|
+
now needs.
|
|
1022
|
+
|
|
1023
|
+
Where the JSON-LD lives is the site's choice. The worked example publishes the application and its offers page-wide (next
|
|
1024
|
+
step), so its section returns no `getStructuredData`. A site that keeps the application on the section returns it from
|
|
1025
|
+
the PLANS section's `getStructuredData({ siteOrigin })`, at `${siteOrigin}/#software-application`, with no price.
|
|
1026
|
+
|
|
986
1027
|
The offers come from one function of the page they are published on, called by the route and, once per locale,
|
|
987
|
-
by the audit: follow `examples/pricing-offers.example.md
|
|
988
|
-
pricing route's frontmatter.
|
|
1028
|
+
by the audit: follow `examples/pricing-offers.example.md`.
|
|
989
1029
|
|
|
990
|
-
A home page's teaser is the same shape with its own options
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
1030
|
+
A home page's teaser is the same shape with its own options (`layout: WebsitePricingLayout.TEASER`, the same plan
|
|
1031
|
+
words and a `pricingPage` link), the same statements minus `TRIAL`, which a teaser does not show, and no
|
|
1032
|
+
`getStructuredData`. None of these files holds a price, a plan list, a currency or a sign-up URL: the block reads them
|
|
1033
|
+
from the catalogue.
|
|
994
1034
|
|
|
995
1035
|
## Structured-data contract
|
|
996
1036
|
|
|
997
1037
|
What a pricing page emits:
|
|
998
1038
|
|
|
999
1039
|
- `SoftwareApplication` — the application itself, the usual case for a Wildo site — from the PLANS section's
|
|
1000
|
-
`getStructuredData()
|
|
1040
|
+
`getStructuredData()`, or page-wide beside the offers (as the worked example does).
|
|
1001
1041
|
- `Product` instead, only when the plans sell a discrete good rather than the application.
|
|
1002
1042
|
- One `AggregateOffer` per currency, amount basis and recurrence (plans that differ in any of them are separate
|
|
1003
1043
|
groups), with an `Offer` per plan whose price may be published, from `buildWebsitePricingOfferStructuredData` as a
|
|
1004
1044
|
page-level payload — top-level, so the audit checks it, linked to the application by `itemOffered.@id`.
|
|
1005
1045
|
|
|
1006
|
-
Keep `FAQPage` in a sibling FAQ section (`website-section-faq`)
|
|
1007
|
-
hero (`website-section-hero`)
|
|
1046
|
+
Keep `FAQPage` in a sibling FAQ section (`website-section-faq`). `Organization` / `WebSite` belong to the landing
|
|
1047
|
+
page's hero (`website-section-hero`) or to page-wide payloads; a pricing page that publishes the application beside its
|
|
1048
|
+
offers also publishes the `Organization` the application names as publisher, so every `@id` it references is defined
|
|
1049
|
+
on the page. Nothing rejects them here — the audit checks each payload against the Schema.org
|
|
1008
1050
|
catalog, never against the section's category — so the split is yours to keep.
|
|
1009
1051
|
|
|
1010
1052
|
## Catalog integration (AEO)
|
|
@@ -1027,8 +1069,8 @@ renderer emits one `<script type="application/ld+json">` block per payload (not
|
|
|
1027
1069
|
- `references/framework-pricing-catalog-api.md` — source-backed catalogue loader, `useWebsitePricingCatalog()` and
|
|
1028
1070
|
offer builder.
|
|
1029
1071
|
- `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
|
|
1030
|
-
- `examples/pricing-offers.example.md` — the
|
|
1031
|
-
|
|
1072
|
+
- `examples/pricing-offers.example.md` — the worked example's page offers built from the catalogue, the route's catalogue
|
|
1073
|
+
load, and the per-locale payloads the audit reads from the same function.
|
|
1032
1074
|
- `../website-building-blocks/references/framework-website-blocks-api.md` — every block and the stylesheet's hooks.
|
|
1033
1075
|
|
|
1034
1076
|
## Verification
|
|
@@ -1039,7 +1081,8 @@ renderer emits one `<script type="application/ld+json">` block per payload (not
|
|
|
1039
1081
|
`websiteSectionIntroSlots(...)` with the options the intro renders.
|
|
1040
1082
|
- [ ] The website holds no price: every amount, currency and cadence comes from the catalogue, through the block
|
|
1041
1083
|
(render) and `buildWebsitePricingOfferStructuredData` (JSON-LD).
|
|
1042
|
-
- [ ] Every route whose page shows plans loads the catalogue and passes it to the
|
|
1084
|
+
- [ ] Every route whose page shows plans (itself or through its page helper) loads the catalogue and passes it to the
|
|
1085
|
+
island as `pricingCatalog`.
|
|
1043
1086
|
- [ ] The site's words per plan are one kit constant keyed by catalogue plan key, and every feature line names a
|
|
1044
1087
|
grant its plan grants.
|
|
1045
1088
|
- [ ] The block's options are one constant passed to `WebsitePricing` and `websitePricingSlots(...)`, declaring the
|
|
@@ -1048,8 +1091,9 @@ renderer emits one `<script type="application/ld+json">` block per payload (not
|
|
|
1048
1091
|
- [ ] A recommended plan is worded as a recommendation, never as popularity.
|
|
1049
1092
|
- [ ] No sign-up URL is typed: the call to action is `signUp` (the application's sign-up by default) or a plan's own
|
|
1050
1093
|
`link`, and a plan priced on request carries a `link` to where a quote is asked for.
|
|
1051
|
-
- [ ] The offers are built by one function
|
|
1052
|
-
|
|
1094
|
+
- [ ] The offers are built by one function from the page's locale, its pack and the site's one declared origin: the
|
|
1095
|
+
route (or its page helper) calls it, the audit once per locale, every URL is localized, and no origin literal
|
|
1096
|
+
is typed in `website/src/structured-data/`.
|
|
1053
1097
|
|
|
1054
1098
|
### Grep invariants
|
|
1055
1099
|
|
|
@@ -1083,11 +1127,11 @@ rg -n "https?://[^'\"]*(sign-?up|register)" website/src/sections
|
|
|
1083
1127
|
# No popularity claim in the packs (must return empty)
|
|
1084
1128
|
rg -n -i "most popular|best seller" website/src/i18n/
|
|
1085
1129
|
|
|
1086
|
-
# Catalogue passed to the island (must return >= 1
|
|
1087
|
-
rg -n "pricingCatalog" website/src
|
|
1130
|
+
# Catalogue passed to the island (must return >= 1, in the routes or in the page helper they call)
|
|
1131
|
+
rg -n "pricingCatalog" website/src --glob '!**/sections/**' --glob '!**/structured-data/**'
|
|
1088
1132
|
|
|
1089
1133
|
# Route passes the page context (must print nothing; a call wrapped over several lines prints its first line too, so open it and check)
|
|
1090
|
-
rg -n "renderPageStructuredData\(\{" website/src
|
|
1134
|
+
rg -n "renderPageStructuredData\(\{" website/src --glob '*.{astro,ts}' | rg -v "context:"
|
|
1091
1135
|
|
|
1092
1136
|
# Offers derived, never typed, and no origin typed into them (the first >= 1, the second empty)
|
|
1093
1137
|
rg -n "buildWebsitePricingOfferStructuredData" website/src/structured-data/
|
|
@@ -1,77 +1,189 @@
|
|
|
1
1
|
# Publishing a pricing page's offers — worked example
|
|
2
2
|
|
|
3
|
-
The offers half of the `website-section-pricing` workflow (Step 7)
|
|
4
|
-
`AggregateOffer` from the catalogue, at that page's URL and in its
|
|
5
|
-
|
|
6
|
-
origin, price, currency or plan list is typed anywhere.
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
3
|
+
The offers half of the `website-section-pricing` workflow (Step 7), as a site rendering from its catalogue writes it. One
|
|
4
|
+
function of the site builds the page's `AggregateOffer` from the billing catalogue, at that page's URL and in its
|
|
5
|
+
words, and both readers call it: the route, which renders it in the page's head, and `wildo website audit`, which reads
|
|
6
|
+
it once per locale at that locale's route. No origin, price, currency or plan list is typed anywhere.
|
|
7
|
+
|
|
8
|
+
## The offers, built from the catalogue
|
|
9
|
+
|
|
10
|
+
The plan name is the same word the pricing block shows, read from the page's label pack. The `AggregateOffer`'s `url`
|
|
11
|
+
and ids are the localized PRICING route, on every page that publishes the offers (the home page too), and the builder
|
|
12
|
+
gives each nested `Offer` the url of its own plan card (`…/pricing#plan-<key>`), so the French page publishes the
|
|
13
|
+
French URLs. The origin is the site's one declared origin, never a literal in this function:
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
## Usage Example
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
// The site's ONE declared origin (`MARKETING_SITE_URL`, which `wildo.website.config.ts` also declares as `publicOrigin`),
|
|
20
|
+
// never a literal here; every URL below goes through the localized route, so each locale publishes its own page's URL.
|
|
21
|
+
export const SCHEMA_ORG_IDS = {
|
|
22
|
+
organization: `${MARKETING_SITE_URL}/#organization`,
|
|
23
|
+
website: `${MARKETING_SITE_URL}/#website`,
|
|
24
|
+
softwareApplication: `${MARKETING_SITE_URL}/#software-application`,
|
|
25
|
+
} as const;
|
|
26
|
+
|
|
27
|
+
export interface BuildPageStructuredDataInput {
|
|
28
|
+
readonly pageRef: string;
|
|
29
|
+
readonly locale: string;
|
|
30
|
+
readonly defaultLocale: string;
|
|
31
|
+
readonly labelPack: Readonly<Record<string, string>>;
|
|
32
|
+
readonly pricingCatalog?: PublicPricingCatalog;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// The engine's localized-route rule, so a page's JSON-LD names the URL the site serves it at (#2810).
|
|
36
|
+
function localizedUrl(routePath: string, locale: string, defaultLocale: string): string {
|
|
37
|
+
return `${MARKETING_SITE_URL}${buildLocalizedRoutePath({ locale: locale as AvailableLanguage, defaultLocale: defaultLocale as AvailableLanguage, routePath })}`;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* The billing catalogue's offers, in this locale's words, at this locale's PRICING page: every page that publishes them
|
|
42
|
+
* (home and pricing) names the pricing page as where they are offered, as each offer's own `url#plan-<key>` does.
|
|
43
|
+
*/
|
|
44
|
+
function offers(input: BuildPageStructuredDataInput): readonly WebsiteStructuredDataPayload[] {
|
|
45
|
+
if (input.pricingCatalog === undefined) return [];
|
|
46
|
+
const pricingUrl = localizedUrl('/pricing', input.locale, input.defaultLocale);
|
|
31
47
|
return buildWebsitePricingOfferStructuredData({
|
|
32
|
-
catalog,
|
|
33
|
-
itemOfferedId:
|
|
34
|
-
aggregateOfferIdPrefix: `${
|
|
35
|
-
url:
|
|
36
|
-
planName: (planKey) =>
|
|
37
|
-
perUnitName: word('offer.unit'), // required when a published plan is priced per unit
|
|
48
|
+
catalog: input.pricingCatalog,
|
|
49
|
+
itemOfferedId: SCHEMA_ORG_IDS.softwareApplication,
|
|
50
|
+
aggregateOfferIdPrefix: `${pricingUrl}#plans`,
|
|
51
|
+
url: pricingUrl,
|
|
52
|
+
planName: (planKey) => input.labelPack[`website.pricing.pricing-plans.plans.${planKey}.name`],
|
|
38
53
|
});
|
|
39
54
|
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
A catalogue with a per-unit price (a price per member) also passes `perUnitName` (the `offer.unit` word the PLANS
|
|
58
|
+
section declares as a slot). The builder publishes only plans on sale at a listed price, so an on-request or announced
|
|
59
|
+
plan publishes no offer.
|
|
60
|
+
|
|
61
|
+
## The catalogue, loaded once and handed to the page
|
|
62
|
+
|
|
63
|
+
Every route calls one page helper. It loads the catalogue for the scope the site sells to (here, organizations), once
|
|
64
|
+
per build, and when the page shows prices passes it both to the offers above (through `buildPageStructuredData`,
|
|
65
|
+
rendered by `renderPageStructuredData` with the page's context) and to the pricing block's island (`pricingCatalog`
|
|
66
|
+
in the island props):
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## Usage Example
|
|
70
|
+
|
|
71
|
+
```typescript
|
|
72
|
+
/** The catalogue is loaded once per build (it costs seconds), then shared by every page that shows prices. */
|
|
73
|
+
let pricingCatalogPromise: Promise<PublicPricingCatalog> | undefined;
|
|
40
74
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
return
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
75
|
+
function loadPricingCatalog(): Promise<PublicPricingCatalog> {
|
|
76
|
+
pricingCatalogPromise ??= loadWebsitePricingCatalog({ targetScope: 'organizations' });
|
|
77
|
+
return pricingCatalogPromise;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
async function loadBlogIndex(locale: string, limit: number | undefined): Promise<WebsiteBlogIndex> {
|
|
81
|
+
return buildWebsiteBlogIndex(await getCollection('blog'), { locale, ...(limit === undefined ? {} : { limit }) });
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export async function preparePage(input: {
|
|
85
|
+
readonly manifest: WebsitePageManifest;
|
|
86
|
+
readonly astroLocale: string | undefined;
|
|
87
|
+
readonly pricing?: boolean;
|
|
88
|
+
readonly blog?: { readonly limit?: number };
|
|
89
|
+
}): Promise<PreparedPage> {
|
|
90
|
+
const runtime = loadWebsitePageRuntime({
|
|
91
|
+
manifest: input.manifest,
|
|
92
|
+
siteContext: WEBSITE_SITE_CONTEXT,
|
|
93
|
+
labelPacksDir: './src/i18n',
|
|
94
|
+
astroLocale: input.astroLocale,
|
|
55
95
|
});
|
|
96
|
+
const pageRef = String(input.manifest.ref);
|
|
97
|
+
const pricingCatalog = input.pricing === true ? await loadPricingCatalog() : undefined;
|
|
98
|
+
const blogIndex = input.blog === undefined ? undefined : await loadBlogIndex(runtime.locale, input.blog.limit);
|
|
99
|
+
const pagePayloads = buildPageStructuredData({
|
|
100
|
+
pageRef,
|
|
101
|
+
locale: runtime.locale,
|
|
102
|
+
defaultLocale: runtime.defaultLocale,
|
|
103
|
+
labelPack: runtime.labelPack as Readonly<Record<string, string>>,
|
|
104
|
+
...(pricingCatalog === undefined ? {} : { pricingCatalog }),
|
|
105
|
+
});
|
|
106
|
+
const headHtml = [
|
|
107
|
+
renderWebsitePageHeadHtml({
|
|
108
|
+
manifest: input.manifest,
|
|
109
|
+
siteContext: WEBSITE_SITE_CONTEXT,
|
|
110
|
+
locale: runtime.locale,
|
|
111
|
+
labelPack: runtime.labelPack,
|
|
112
|
+
}),
|
|
113
|
+
WEBSITE_META_CSP_HEAD_HTML,
|
|
114
|
+
WEBSITE_ICON_HEAD_HTML,
|
|
115
|
+
'<link rel="preload" href="/fonts/InterVariable.woff2" as="font" type="font/woff2" crossorigin />',
|
|
116
|
+
// The sections' own JSON-LD (an FAQ's questions, in this locale) and the page-wide payloads.
|
|
117
|
+
renderPageStructuredData({ sections: resolveSectionsForManifest(input.manifest), context: runtime.structuredData, pagePayloads }),
|
|
118
|
+
].join('\n');
|
|
119
|
+
return {
|
|
120
|
+
locale: runtime.locale,
|
|
121
|
+
headHtml,
|
|
122
|
+
designTokensCss: renderWebsiteDesignTokensCss(WEBSITE_SITE_CONTEXT.rootConfig.designTokens),
|
|
123
|
+
islandProps: {
|
|
124
|
+
locale: runtime.locale,
|
|
125
|
+
defaultLocale: runtime.defaultLocale,
|
|
126
|
+
locales: WEBSITE_SITE_CONTEXT.websiteConfig.locales.map((entry) => entry.locale),
|
|
127
|
+
appOrigin: WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin,
|
|
128
|
+
// Whether the operator owes a legal notice (#2588): the footer links it, and refuses to render without the answer.
|
|
129
|
+
...(WEBSITE_SITE_CONTEXT.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: WEBSITE_SITE_CONTEXT.legalNoticeOwed }),
|
|
130
|
+
// Which public documents the application serves (#2987): the footer links only those. Absent: it links every one.
|
|
131
|
+
...(WEBSITE_SITE_CONTEXT.servedPublicDocumentRefs === undefined ? {} : { servedPublicDocumentRefs: WEBSITE_SITE_CONTEXT.servedPublicDocumentRefs }),
|
|
132
|
+
apiOrigin: WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin,
|
|
133
|
+
labelPack: runtime.labelPack,
|
|
134
|
+
designTokens: WEBSITE_SITE_CONTEXT.rootConfig.designTokens,
|
|
135
|
+
skipToMainContentLabelKey: WEBSITE_SITE_CONTEXT.rootConfig.skipToMainContentLabelKey,
|
|
136
|
+
frontendProviders: WEBSITE_SITE_CONTEXT.frontendProviders,
|
|
137
|
+
...(pricingCatalog === undefined ? {} : { pricingCatalog }),
|
|
138
|
+
...(blogIndex === undefined ? {} : { blogIndex }),
|
|
139
|
+
},
|
|
140
|
+
};
|
|
56
141
|
}
|
|
57
142
|
```
|
|
58
143
|
|
|
59
|
-
The
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
144
|
+
## The audit reads the same function, once per locale
|
|
145
|
+
|
|
146
|
+
`wildo website audit` reaches the payloads through `resolveStructuredDataPagePayloadsForManifest`. It calls the SAME
|
|
147
|
+
function the route calls, once per locale, with the same label packs and the same catalogue, so the audit checks exactly
|
|
148
|
+
what the site serves:
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
## Usage Example
|
|
152
|
+
|
|
153
|
+
```typescript
|
|
154
|
+
// The engine's own rules for a locale's pack and route, so this audit reads and addresses what the site serves (#2810).
|
|
155
|
+
function labelPack(locale: AvailableLanguage): Readonly<Record<string, string>> {
|
|
156
|
+
return loadLabelPack(LABEL_PACKS_DIR, locale);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
function localizedRoutePath(routePath: string, locale: AvailableLanguage): string {
|
|
160
|
+
return buildLocalizedRoutePath({ locale, defaultLocale: websiteConfig.defaultLocale, routePath });
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
export function resolveStructuredDataPagePayloadsForManifest(
|
|
164
|
+
manifest: Pick<StructuredDataPageManifestLike, 'ref'> & { readonly routePath: string },
|
|
165
|
+
pricingCatalog: PublicPricingCatalog,
|
|
166
|
+
): readonly StructuredDataPagePayloadLike[] {
|
|
167
|
+
const pageRef = String(manifest.ref);
|
|
168
|
+
if (pageRef === BLOG_POST_PAGE_REF) {
|
|
169
|
+
return resolveBlogPostStructuredDataPagePayloads(pageRef);
|
|
170
|
+
}
|
|
171
|
+
return websiteConfig.locales.flatMap((entry) => {
|
|
172
|
+
const locale = String(entry.locale);
|
|
173
|
+
const payloads = buildPageStructuredData({
|
|
174
|
+
pageRef,
|
|
175
|
+
locale,
|
|
176
|
+
defaultLocale: String(websiteConfig.defaultLocale),
|
|
177
|
+
labelPack: labelPack(entry.locale),
|
|
178
|
+
pricingCatalog,
|
|
179
|
+
});
|
|
180
|
+
return payloads.length === 0
|
|
181
|
+
? []
|
|
182
|
+
: [{ pageRef, routePath: localizedRoutePath(manifest.routePath, entry.locale), sourceRef: `page:${pageRef}:${locale}`, payloads }];
|
|
183
|
+
});
|
|
184
|
+
}
|
|
77
185
|
```
|
|
186
|
+
|
|
187
|
+
The site's reconciliation adapter (`website/src/structured-data/reconcile-structured-data.ts` in the worked example),
|
|
188
|
+
which the audit calls, loads the catalogue with the same `loadWebsitePricingCatalog({ targetScope: 'organizations' })`
|
|
189
|
+
the page helper uses, and passes it in.
|
package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md
CHANGED
|
@@ -36,6 +36,7 @@ of it. Read this when:
|
|
|
36
36
|
* **Node-only.** Lives on the `/config-loader` subpath; it must never reach a React-island bundle.
|
|
37
37
|
*/
|
|
38
38
|
import {
|
|
39
|
+
ConfigModuleResolution,
|
|
39
40
|
loadApplicationPublicPricingCatalog,
|
|
40
41
|
loadConfig,
|
|
41
42
|
resolveWorkspaceScope,
|
|
@@ -61,7 +62,8 @@ export async function loadWebsitePricingCatalog(input: LoadWebsitePricingCatalog
|
|
|
61
62
|
+ 'Run astro from inside the application workspace.',
|
|
62
63
|
);
|
|
63
64
|
}
|
|
64
|
-
|
|
65
|
+
// Against the built framework packages, as `loadWebsiteSiteContext` reads it (#3440).
|
|
66
|
+
const saasConfig = await loadConfig<WildoSaasConfig>(workspaceScope.saasConfigPath, { moduleResolution: ConfigModuleResolution.LOADER_INSTANCES });
|
|
65
67
|
return loadApplicationPublicPricingCatalog({
|
|
66
68
|
saasRoot: workspaceScope.saasRoot,
|
|
67
69
|
saasConfig,
|