@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +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 +170 -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 +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.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 +51 -7
- 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 +10 -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/playbook.json +10 -6
- 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 +27 -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.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 +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- 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.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -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 +363 -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 +130 -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.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-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-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 +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- 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 +79 -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 +197 -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 +61 -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 +1 -1
- 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 +18 -7
- 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 +44 -4
- 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 +375 -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 +1 -1
- 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 +1 -1
- 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/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -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 +125 -77
- 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 +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- 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 +255 -12
- 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 +33 -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 +7 -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 +244 -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 +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md
ADDED
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
# `ChartDashboard` — charts from several resources on one page
|
|
2
|
+
|
|
3
|
+
A dashboard declared as data: tiles, each naming a resource and one of the chart views it
|
|
4
|
+
declares. Read this when you need to:
|
|
5
|
+
|
|
6
|
+
- build a home or overview page of charts that DIFFERENT resources own (cases by status beside
|
|
7
|
+
revenue by month beside SLA breaches by team);
|
|
8
|
+
- put KPI tiles (open cases, revenue this month, a completion rate) beside them;
|
|
9
|
+
- make a whole composite view that is only such a dashboard;
|
|
10
|
+
- decide what a viewer who may not read one of the resources sees.
|
|
11
|
+
|
|
12
|
+
## What it does
|
|
13
|
+
|
|
14
|
+
- Each tile renders through `EmbedChart`: the chart's feature gate, the host composite's
|
|
15
|
+
organization scope, and a failure kept inside its own tile. The tile is headed by the chart
|
|
16
|
+
view's own title (the words its route and launcher use), so it needs no label of its own.
|
|
17
|
+
- A tile the viewer may not read is not drawn, and the grid closes up. "May read" is the role set
|
|
18
|
+
the backend's chart gate asks about: one of the default LIST roles of the chart's main resource
|
|
19
|
+
and of every resource it joins, narrowed by the chart's `accessControl.roles`. A dashboard the
|
|
20
|
+
viewer can read nothing of renders nothing.
|
|
21
|
+
- A role that reaches only SOME rows of a resource does not count: one the application confines to
|
|
22
|
+
its holder's own rows (`organizationOwnRows`) or to the rows they are assigned to
|
|
23
|
+
(`organizationAssignedRows`, every role but the declared organization-wide ones). A chart reads
|
|
24
|
+
every row in scope, so the backend refuses it to such a viewer rather than charting their rows,
|
|
25
|
+
and the dashboard hides the tile. To show a confined member their own figures, link them to the
|
|
26
|
+
resource's list, which the backend narrows to their rows.
|
|
27
|
+
- The grid follows its container: one column in a narrow pane, two from a medium one, four from a
|
|
28
|
+
wide one. `span: ChartDashboardTileSpan.TWO` gives a trend two columns; `FULL` a whole row.
|
|
29
|
+
- `columns` caps the grid. `ChartDashboardColumns.THREE` gives three narrow columns from a small
|
|
30
|
+
container, for a dashboard that shares its row with something else (a block of counters, a list);
|
|
31
|
+
`TWO` stops at two. A span applies only where the grid has that many columns, so a narrow pane
|
|
32
|
+
still stacks every tile.
|
|
33
|
+
- `rows: ChartDashboardTileRows.TWO` makes a tile two rows tall: a large chart beside two small ones
|
|
34
|
+
stacked. Order the tiles `[small, large, small]` so the second small one flows into the row under
|
|
35
|
+
the first. Give each tile the canvas `height` that fills its cell (a two-row tile is roughly two
|
|
36
|
+
small heights plus the gap).
|
|
37
|
+
- The charts themselves are unchanged: each is still a resource's `chartViews` entry, with its
|
|
38
|
+
`ChartDefinition` registered backend-side through the module's `chartDefinitions`. A tile naming
|
|
39
|
+
a chart view the resource does not declare is refused when it renders.
|
|
40
|
+
|
|
41
|
+
## KPI tiles: a figure is a chart
|
|
42
|
+
|
|
43
|
+
A KPI tile (a count, a sum, a rate) is not a second mechanism. It is a chart of the resource whose
|
|
44
|
+
`chartType` is `ChartType.KPI`, placed on the dashboard like any other tile:
|
|
45
|
+
|
|
46
|
+
- its `dataQuery` declares NO dimension (`dimensions: []`), so the backend answers one row for the whole
|
|
47
|
+
scope, and an empty scope still answers one row (a count of 0, every other aggregate `null`);
|
|
48
|
+
- it declares exactly ONE series, whose `measureRef` names the figure (a measure, or a computed measure
|
|
49
|
+
such as `completed / total * 100`);
|
|
50
|
+
- `chartTypeConfig: { valueFormat: ChartKpiValueFormat.NUMBER | PERCENT, maximumFractionDigits?, showProgress? }`
|
|
51
|
+
says how the figure is written. `PERCENT` reads the value as already in percent units, and
|
|
52
|
+
`showProgress` draws a bar under it. Round where the figure is written (`maximumFractionDigits`),
|
|
53
|
+
not in the expression.
|
|
54
|
+
|
|
55
|
+
A filtered count is a measure with a `filter` (`{ status: { $in: [...] } }`). The tile is headed by its
|
|
56
|
+
chart view's title, hidden by the same gate as every chart, and takes the height of its figure (`height`
|
|
57
|
+
sizes only its loading placeholder). A rate over an organization with nothing in it shows no value, never
|
|
58
|
+
0 %: the division by zero answers `null`.
|
|
59
|
+
|
|
60
|
+
The chart definition refuses the mixed shapes: a KPI with a dimension or two series, and any other chart
|
|
61
|
+
type with no dimension. The backend also refuses, at startup, a computed measure whose expression does not
|
|
62
|
+
parse, calls a function the engine does not provide, or reads a name that is not a measure, a dimension or an
|
|
63
|
+
earlier computed measure listed in its `dependsOn`.
|
|
64
|
+
|
|
65
|
+
## Two ways to place it
|
|
66
|
+
|
|
67
|
+
- Inside a composite you write: `<ChartDashboard tiles={[…]} />` in a `<Section>` of your
|
|
68
|
+
`CompositeLayout`, beside the composite's other content.
|
|
69
|
+
- As the whole view: `defineChartDashboardView({ tiles: […], …composite config })` in the frontend
|
|
70
|
+
module's `compositeViews` map. The rest of the config (`icon`, `sectionRefs`,
|
|
71
|
+
`requiredFeatures`) is the composite view's own.
|
|
72
|
+
|
|
73
|
+
## Source
|
|
74
|
+
|
|
75
|
+
## Import Origins
|
|
76
|
+
|
|
77
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
78
|
+
|
|
79
|
+
## Source Excerpts
|
|
80
|
+
|
|
81
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
82
|
+
|
|
83
|
+
```tsx
|
|
84
|
+
/** How many grid columns a dashboard tile spans, where the dashboard is wide enough to have them. */
|
|
85
|
+
export enum ChartDashboardTileSpan {
|
|
86
|
+
/** One column (the default): a donut, a bar of a few categories. */
|
|
87
|
+
ONE = 'one',
|
|
88
|
+
/** Two columns: a trend over time, a bar of many categories. One column where the dashboard has one. */
|
|
89
|
+
TWO = 'two',
|
|
90
|
+
/** The whole row: a long timeline, a wide table-like chart. */
|
|
91
|
+
FULL = 'full',
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/** How many grid rows a dashboard tile spans, where the dashboard has more than one column. */
|
|
95
|
+
export enum ChartDashboardTileRows {
|
|
96
|
+
/** One row (the default). */
|
|
97
|
+
ONE = 'one',
|
|
98
|
+
/**
|
|
99
|
+
* Two rows: a large chart beside two smaller ones stacked in the next column. Place it right after the first
|
|
100
|
+
* small tile, so the second small tile flows into the row beneath the first: `[small, large (TWO rows), small]`.
|
|
101
|
+
*/
|
|
102
|
+
TWO = 'two',
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* The most columns a dashboard's grid reaches, as its container widens. Every dashboard is one column in a narrow pane.
|
|
107
|
+
*/
|
|
108
|
+
export enum ChartDashboardColumns {
|
|
109
|
+
/** Two columns from a medium container (42rem). */
|
|
110
|
+
TWO = 'two',
|
|
111
|
+
/**
|
|
112
|
+
* Three narrow columns from a small container (28rem): small charts beside a large one, in a dashboard that shares
|
|
113
|
+
* its row with something else (a block of counters, a list).
|
|
114
|
+
*/
|
|
115
|
+
THREE = 'three',
|
|
116
|
+
/** Two columns from a medium container (42rem), four from a wide one (64rem). The default. */
|
|
117
|
+
FOUR = 'four',
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* One tile of a {@link ChartDashboard}: a chart a resource declares in its `chartViews`. A chart whose `chartType` is
|
|
122
|
+
* `ChartType.KPI` is a KPI tile: one figure under its title instead of a drawing.
|
|
123
|
+
*/
|
|
124
|
+
export interface ChartDashboardTile {
|
|
125
|
+
/** The resource whose `chartViews` declares the chart. */
|
|
126
|
+
resourceType: string;
|
|
127
|
+
/** The chart view's `ref` on that resource (`InsertedChartDeclaration.ref`, usually `<chartDefinition>.ref`). */
|
|
128
|
+
chartViewRef: string;
|
|
129
|
+
/** Grid columns the tile spans. Default: {@link ChartDashboardTileSpan.ONE}. */
|
|
130
|
+
span?: ChartDashboardTileSpan;
|
|
131
|
+
/** Grid rows the tile spans. Default: {@link ChartDashboardTileRows.ONE}. */
|
|
132
|
+
rows?: ChartDashboardTileRows;
|
|
133
|
+
/**
|
|
134
|
+
* Chart canvas height in px (the canvas is sized by this, not by the tile). Default: 280 for a chart; a KPI tile takes
|
|
135
|
+
* the height of its figure, and this only sizes its loading placeholder (default 64).
|
|
136
|
+
*/
|
|
137
|
+
height?: number;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
export interface ChartDashboardProps {
|
|
141
|
+
/** The tiles, in reading order. Tiles may name charts of any number of resources. */
|
|
142
|
+
tiles: readonly ChartDashboardTile[];
|
|
143
|
+
/** The most columns the grid reaches. Default: {@link ChartDashboardColumns.FOUR}. */
|
|
144
|
+
columns?: ChartDashboardColumns;
|
|
145
|
+
className?: string;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* Lays charts from several resources on one responsive grid: one column in a narrow pane, then up to `columns`
|
|
150
|
+
* ({@link ChartDashboardColumns}, four by default) as the container widens (container queries, so a dashboard in a
|
|
151
|
+
* split pane is laid out for the pane). A tile may span two columns or the whole row, and two rows.
|
|
152
|
+
*
|
|
153
|
+
* Each tile is headed by the chart view's own title (`views.chart.resources.<resourceType>.<ref>.title`, the words
|
|
154
|
+
* its route and launcher use) and drawn through `EmbedChart`: the chart's feature gate, the host composite's scope and
|
|
155
|
+
* a failure kept inside the tile. A tile whose chart the viewer may not read — the backend's aggregation gate would
|
|
156
|
+
* refuse it: no LIST role on its resource or on a resource it joins, or outside the chart's own `accessControl.roles`,
|
|
157
|
+
* or only a role confined there to its holder's own or assigned rows (a chart reads every row in scope) — is not drawn,
|
|
158
|
+
* and the grid closes up. A dashboard with nothing the viewer may read renders nothing.
|
|
159
|
+
*
|
|
160
|
+
* A KPI tile (a chart view whose chart is `ChartType.KPI`) shows one figure under that title, hidden by the same rule.
|
|
161
|
+
*
|
|
162
|
+
* Place it inside a composite view (`CompositeLayout`), or declare a whole view as one with
|
|
163
|
+
* {@link defineChartDashboardView}.
|
|
164
|
+
*
|
|
165
|
+
* @example
|
|
166
|
+
* ```tsx
|
|
167
|
+
* <ChartDashboard
|
|
168
|
+
* tiles={[
|
|
169
|
+
* { resourceType: R.TODOS, chartViewRef: todosByStatusChartDefinition.ref },
|
|
170
|
+
* { resourceType: R.TASKS, chartViewRef: todoTaskPriorityChartDefinition.ref },
|
|
171
|
+
* { resourceType: R.TODOS, chartViewRef: todosCreatedTimelineChartDefinition.ref, span: ChartDashboardTileSpan.TWO },
|
|
172
|
+
* ]}
|
|
173
|
+
* />
|
|
174
|
+
* ```
|
|
175
|
+
*/
|
|
176
|
+
export function ChartDashboard({ tiles, columns = ChartDashboardColumns.FOUR, className }: ChartDashboardProps): React.JSX.Element | null {
|
|
177
|
+
const { registry } = useResourceRegistry();
|
|
178
|
+
const viewer = useViewerEffectiveRoles();
|
|
179
|
+
const visibleTiles = useMemo(
|
|
180
|
+
() => tiles.flatMap((tile) => {
|
|
181
|
+
const chartView = registry.resourceConfigurations[tile.resourceType]?.frontendConfiguration?.chartViews
|
|
182
|
+
?.find((candidate) => candidate.ref === tile.chartViewRef);
|
|
183
|
+
// An unknown chart is an authoring error, and `EmbedChart` throws it with the resource and ref named.
|
|
184
|
+
if (chartView !== undefined && !viewerMayReadChart(chartView.chartDefinition, registry, viewer)) return [];
|
|
185
|
+
return [{ tile, isFigure: chartView?.chartDefinition.chartType === ChartType.KPI }];
|
|
186
|
+
}),
|
|
187
|
+
[tiles, registry, viewer],
|
|
188
|
+
);
|
|
189
|
+
|
|
190
|
+
if (visibleTiles.length === 0) return null;
|
|
191
|
+
const grid = GRID_CLASSES[columns];
|
|
192
|
+
return (
|
|
193
|
+
<div className={cn('@container w-full', className)} data-chart-dashboard>
|
|
194
|
+
<div className={cn('grid grid-cols-1 gap-group', grid.columns)}>
|
|
195
|
+
{visibleTiles.map(({ tile, isFigure }) => (
|
|
196
|
+
<ChartDashboardTileCell key={`${tile.resourceType}:${tile.chartViewRef}`} tile={tile} isFigure={isFigure} grid={grid} />
|
|
197
|
+
))}
|
|
198
|
+
</div>
|
|
199
|
+
</div>
|
|
200
|
+
);
|
|
201
|
+
}
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## Import Origins
|
|
205
|
+
|
|
206
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
207
|
+
|
|
208
|
+
## Source Excerpts
|
|
209
|
+
|
|
210
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
211
|
+
|
|
212
|
+
```tsx
|
|
213
|
+
/**
|
|
214
|
+
* A whole composite view that is a chart dashboard, declared as data — register it under the frontend domain module's
|
|
215
|
+
* `compositeViews` like any app-level composite. The rest of the config is the composite view's
|
|
216
|
+
* own (`sectionRefs`, `icon`, `requiredFeatures`, …).
|
|
217
|
+
*
|
|
218
|
+
* @example
|
|
219
|
+
* ```ts
|
|
220
|
+
* compositeViews: {
|
|
221
|
+
* 'operations-dashboard': defineChartDashboardView({
|
|
222
|
+
* tiles: [
|
|
223
|
+
* { resourceType: R.CASES, chartViewRef: casesByStatusChart.ref },
|
|
224
|
+
* { resourceType: R.INVOICES, chartViewRef: revenueByMonthChart.ref, span: ChartDashboardTileSpan.TWO },
|
|
225
|
+
* { resourceType: R.SLA_BREACHES, chartViewRef: breachesByTeamChart.ref },
|
|
226
|
+
* ],
|
|
227
|
+
* }),
|
|
228
|
+
* }
|
|
229
|
+
* ```
|
|
230
|
+
*/
|
|
231
|
+
export function defineChartDashboardView(
|
|
232
|
+
config: { tiles: readonly ChartDashboardTile[] } & Omit<CompositeViewAuthoringConfig, 'viewComponent'>,
|
|
233
|
+
): CompositeViewAuthoringConfig {
|
|
234
|
+
const { tiles, ...compositeConfig } = config;
|
|
235
|
+
function ChartDashboardView(): React.JSX.Element {
|
|
236
|
+
return (
|
|
237
|
+
<CompositeLayout>
|
|
238
|
+
<ChartDashboard tiles={tiles} />
|
|
239
|
+
</CompositeLayout>
|
|
240
|
+
);
|
|
241
|
+
}
|
|
242
|
+
return defineCompositeView(ChartDashboardView, compositeConfig);
|
|
243
|
+
}
|
|
244
|
+
```
|
|
@@ -305,6 +305,14 @@ export const ExecutionViewDefinitionSchema = z.object({
|
|
|
305
305
|
* stripped wherever the definition is Zod-parsed.
|
|
306
306
|
*/
|
|
307
307
|
icon: z.custom<IconLike>().optional(),
|
|
308
|
+
|
|
309
|
+
/**
|
|
310
|
+
* Zone geometry this view asks for when it is the PRIMARY destination — see
|
|
311
|
+
* {@link ResourceExecutionViewAuthoringConfig.zoneContentFillsHeight}. Declared on the schema as
|
|
312
|
+
* well as the interface so a parse of the compiled definition cannot strip the authored value.
|
|
313
|
+
*/
|
|
314
|
+
zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),
|
|
315
|
+
zoneContentFillsHeight: z.boolean().optional(),
|
|
308
316
|
});
|
|
309
317
|
|
|
310
318
|
/**
|
|
@@ -344,6 +352,10 @@ export interface ExecutionViewDefinition {
|
|
|
344
352
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
345
353
|
/** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
|
|
346
354
|
icon?: IconLike;
|
|
355
|
+
/** See {@link ResourceExecutionViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */
|
|
356
|
+
zoneContentMaxWidth?: ResponsiveMaxWidth;
|
|
357
|
+
/** See {@link ResourceExecutionViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */
|
|
358
|
+
zoneContentFillsHeight?: boolean;
|
|
347
359
|
}
|
|
348
360
|
|
|
349
361
|
export const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';
|
|
@@ -379,6 +391,34 @@ export interface ResourceExecutionViewAuthoringConfig {
|
|
|
379
391
|
* resourceExecutionView(MyFlowView, { icon: ListChecks, surfaceInOperations: [Op.READ] });
|
|
380
392
|
*/
|
|
381
393
|
icon: IconLike;
|
|
394
|
+
/**
|
|
395
|
+
* How wide this view's content may grow when it occupies the PRIMARY zone, in the framework's
|
|
396
|
+
* shared width vocabulary — the same `ResponsiveMaxWidth` a composite view declares.
|
|
397
|
+
*
|
|
398
|
+
* Omitted is `'content'`: capped and centred at the page-content width. A canvas whose value is the
|
|
399
|
+
* space it occupies declares `'none'`.
|
|
400
|
+
*/
|
|
401
|
+
zoneContentMaxWidth?: ResponsiveMaxWidth;
|
|
402
|
+
/**
|
|
403
|
+
* Whether this view's content fills the PRIMARY zone's height as well.
|
|
404
|
+
*
|
|
405
|
+
* `true` makes the zone's content boundary a definite-height flex column, so the view's root can
|
|
406
|
+
* use `flex-1 min-h-0` and size a canvas against the zone instead of naming a pixel height. Ignored
|
|
407
|
+
* in an adjacent zone, which scrolls.
|
|
408
|
+
*
|
|
409
|
+
* It belongs HERE and not on the host operation: an execution view is its own destination, reached
|
|
410
|
+
* from a launcher on the record (and by deep link), so the host READ page never contains it and a
|
|
411
|
+
* declaration there cannot reach it (#1259).
|
|
412
|
+
*
|
|
413
|
+
* @example
|
|
414
|
+
* resourceExecutionView(MyFlowView, {
|
|
415
|
+
* icon: ListChecks,
|
|
416
|
+
* surfaceInOperations: [Op.READ],
|
|
417
|
+
* zoneContentMaxWidth: 'none',
|
|
418
|
+
* zoneContentFillsHeight: true,
|
|
419
|
+
* });
|
|
420
|
+
*/
|
|
421
|
+
zoneContentFillsHeight?: boolean;
|
|
382
422
|
}
|
|
383
423
|
|
|
384
424
|
export type ResourceExecutionViewsConfig = Record<string, ResourceExecutionViewAuthoringConfig>;
|
|
@@ -106,20 +106,22 @@ the consumer's website module at these paths:
|
|
|
106
106
|
|
|
107
107
|
### Step 1: Wire the MDX integration once per site
|
|
108
108
|
|
|
109
|
-
|
|
109
|
+
Declare `@astrojs/mdx` and `@astrojs/markdown-remark` in `website/package.json` (Astro 7 no longer installs the
|
|
110
|
+
second; it carries the MDX compiler the posts are compiled with, and `websiteBlogReactMdx()` refuses with this remedy
|
|
111
|
+
when it is missing). Then, in `website/astro.config.ts`, register `mdx()`, then `websiteBlogReactMdx()` (from
|
|
110
112
|
`@wildo-ai/saas-website/astro`), then `react()`:
|
|
111
113
|
|
|
112
114
|
```ts
|
|
113
115
|
integrations: [mdx(), websiteBlogReactMdx(), react()],
|
|
114
116
|
```
|
|
115
117
|
|
|
116
|
-
A post's body renders INSIDE the page's React island, and `@astrojs/mdx` compiles an `.mdx` file
|
|
118
|
+
A post's body renders INSIDE the page's React island, and `@astrojs/mdx` compiles an `.mdx` file for Astro, which
|
|
117
119
|
React cannot render: without the second integration every post page shows its header and no body. The integration
|
|
118
120
|
compiles for React only the imports the bridges make with the query `?website-react-mdx` (Step 5); the content
|
|
119
121
|
collection keeps using the plain `.mdx` id. It also tells Vite to optimize `@mdx-js/react` at startup, which the
|
|
120
122
|
dependency scan cannot see.
|
|
121
123
|
|
|
122
|
-
It compiles them with the MDX compiler `@astrojs/
|
|
124
|
+
It compiles them with the MDX compiler `@astrojs/markdown-remark` ships and exactly two remark plugins, `remark-gfm`
|
|
123
125
|
(tables, task lists, autolinks) and `remark-smartypants` (typographic quotes). Nothing else of the site's Markdown
|
|
124
126
|
setup reaches a post body: the site's own remark and rehype plugins do not apply, and neither do Astro's defaults —
|
|
125
127
|
no Shiki code highlighting, no heading ids. Style code blocks, and give headings an anchor if a post needs one, in
|
|
@@ -127,7 +129,7 @@ the components `BLOG_POST_MDX_COMPONENTS` maps (Step 4).
|
|
|
127
129
|
|
|
128
130
|
In `website/src/content.config.ts`, define the `blog` collection by
|
|
129
131
|
spreading `buildBlogPostCollectionConfig({ astroZ: z, glob })` — `z` from
|
|
130
|
-
`astro:content
|
|
132
|
+
`astro/zod` (the `astro:content` re-export is deprecated), `glob` from `astro/loaders`. The engine supplies the
|
|
131
133
|
content-layer LOADER (every `src/content/blog/<locale>/*.mdx`, each id'd by
|
|
132
134
|
its path) and the schema (a passthrough record; the strict Zod-4
|
|
133
135
|
validation runs at render time inside `<BlogPost>`). Never write
|
|
@@ -190,7 +192,7 @@ exports a single `BlogPostXxBridgeIsland` built from
|
|
|
190
192
|
(the pattern AND the options MUST be literals — Vite parses them AST-side at build time, so the query is written
|
|
191
193
|
out rather than imported; `WEBSITE_REACT_MDX_QUERY`, exported from `@wildo-ai/saas-website/mdx`, names the same
|
|
192
194
|
string for code that inspects a module id, and cannot stand in for the literal here). Without the query the glob
|
|
193
|
-
imports `@astrojs/mdx`'s Astro
|
|
195
|
+
imports `@astrojs/mdx`'s Astro module, which the React island cannot render;
|
|
194
196
|
- `frontendProviderModules` — the site's generated provider modules, as every page bridge passes them;
|
|
195
197
|
- `navigation: { headerComponent: HeaderComponent, footerComponent: FooterComponent }`, imported directly (the root config's graph would pull every page into this island);
|
|
196
198
|
- `mdxComponents: BLOG_POST_MDX_COMPONENTS`.
|
|
@@ -706,7 +708,7 @@ rg -n "resolveWebsiteBlogPostCover\(frontmatter\)|cover=\{cover\}" website/src/p
|
|
|
706
708
|
|
|
707
709
|
| Rationalization | Reality |
|
|
708
710
|
|---|---|
|
|
709
|
-
| "I'll author the frontmatter Zod schema directly in `src/content.config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change
|
|
711
|
+
| "I'll author the frontmatter Zod schema directly in `src/content.config.ts` instead of using `buildBlogPostCollectionConfig`" | Two sources of truth that silently drift on every field change, and the collection sees an unquoted YAML timestamp as a `Date` where the engine's schema takes the ISO string — passthrough at the collection layer + strict Zod 4 at render time is the deliberate single-source-of-truth posture. |
|
|
710
712
|
| "I'll style the post page from scratch in the site stylesheet: the article width, the title, the table" | The engine already draws all of it from the theme, so a full restyle only creates a second copy that drifts from the tokens. Write only what this site reads differently, against the post's hooks (Step 7b). |
|
|
711
713
|
| "I'll use one bridge module that globs ALL locales together" | Conflates the per-route island bundle (an FR visitor downloads the EN MDX bodies for no reason) AND removes the locale-clean separation `getStaticPaths` already enforces. Per-locale bridges keep the route bundle tight + match the per-locale `[slug].astro` shell shape. |
|
|
712
714
|
| "I'll pass `mdxComponents` as an island prop instead of closing it over in the bridge factory" | The map values are `ComponentType` references — Astro's hydration boundary serializes props to JSON, and a `ComponentType` cannot survive serialization. Closing over them at module load time inside the factory is the only valid shape. |
|
|
@@ -61,8 +61,8 @@ export const WEBSITE_BLOG_CONTENT_PATTERN = '*/*.mdx';
|
|
|
61
61
|
* - `locale` — REQUIRED. The post's locale. Drives the URL prefix
|
|
62
62
|
* (`/<locale>/blog/<slug>`) and `<html lang>`. Cross-locale
|
|
63
63
|
* correspondence is established by sharing the `slug` across
|
|
64
|
-
* per-locale MDX files (e.g. `en/why-context.
|
|
65
|
-
* `fr/why-context.
|
|
64
|
+
* per-locale MDX files (e.g. `en/why-context.mdx` and
|
|
65
|
+
* `fr/why-context.mdx` are the same post in two locales).
|
|
66
66
|
* - `publishedAt` — REQUIRED. ISO-8601 date-time string. Renders into
|
|
67
67
|
* `og:article:published_time` and the listing-card date label.
|
|
68
68
|
* Stored as string (not `z.coerce.date`) because YAML frontmatter
|
|
@@ -355,7 +355,7 @@ export async function resolveWebsiteBlogPostCover(
|
|
|
355
355
|
// The measurement is shared by every post naming this file, so its error names the file and each post adds itself.
|
|
356
356
|
throw new Error(
|
|
357
357
|
`[blog-post-cover] The cover "${src}" of post "${frontmatter.slug}" (${frontmatter.locale}): ` +
|
|
358
|
-
`${
|
|
358
|
+
`${describeCaughtError(error)}`,
|
|
359
359
|
);
|
|
360
360
|
}
|
|
361
361
|
return { src, width: size.width, height: size.height };
|
|
@@ -431,8 +431,8 @@ every other section uses.
|
|
|
431
431
|
*
|
|
432
432
|
* The `createWebsitePageBridgeIsland` factory takes a `PageComponent`
|
|
433
433
|
* — a React component the page author writes. A blog post has NO React
|
|
434
|
-
* component; the MDX file IS the component (compiled
|
|
435
|
-
*
|
|
434
|
+
* component; the MDX file IS the component (compiled to a default-export
|
|
435
|
+
* React tree by `websiteBlogReactMdx()`). Reusing the page-bridge factory
|
|
436
436
|
* would force the consumer to write a ten-line wrapper per post that
|
|
437
437
|
* imports the MDX module, calls `<MdxBody />`, and re-passes the
|
|
438
438
|
* frontmatter — a cold violation of the "every blog post is one MDX
|
|
@@ -797,8 +797,8 @@ WebsiteMdxProvider.displayName = 'WebsiteMdxProvider';
|
|
|
797
797
|
|
|
798
798
|
## `buildBlogPostCollectionConfig` + `parseBlogPostFrontmatter`
|
|
799
799
|
|
|
800
|
-
The bridge between Astro's
|
|
801
|
-
|
|
800
|
+
The bridge between Astro's content collection and the engine's
|
|
801
|
+
canonical Zod 4 schema. The collection layer
|
|
802
802
|
accepts any frontmatter (passthrough); the strict validation runs
|
|
803
803
|
synchronously at render time inside `<BlogPost>` (and at build time
|
|
804
804
|
inside `getStaticPaths` for typed locale/slug filtering — same
|
|
@@ -816,25 +816,28 @@ schema, no double source of truth).
|
|
|
816
816
|
*
|
|
817
817
|
* Astro content-collection bridge for blog posts.
|
|
818
818
|
*
|
|
819
|
-
* #
|
|
820
|
-
*
|
|
821
|
-
* Astro's `astro:content`
|
|
822
|
-
*
|
|
823
|
-
*
|
|
824
|
-
* a
|
|
825
|
-
*
|
|
826
|
-
*
|
|
827
|
-
*
|
|
828
|
-
*
|
|
829
|
-
*
|
|
830
|
-
*
|
|
831
|
-
*
|
|
832
|
-
*
|
|
833
|
-
*
|
|
834
|
-
*
|
|
835
|
-
* that
|
|
836
|
-
*
|
|
837
|
-
*
|
|
819
|
+
* # Why the collection accepts any frontmatter
|
|
820
|
+
*
|
|
821
|
+
* This design was born when Astro's `astro:content` bundled Zod 3 and
|
|
822
|
+
* our `BlogPostFrontmatterSchema` was already Zod 4, so the two could
|
|
823
|
+
* not share a schema. That boundary is gone: since Astro 6 the `z`
|
|
824
|
+
* Astro hands a collection is Zod 4 (`import { z } from 'astro/zod'`;
|
|
825
|
+
* the `astro:content` re-export is deprecated and leaves in Astro 8).
|
|
826
|
+
* The passthrough stays for two reasons that still hold on Astro 7:
|
|
827
|
+
*
|
|
828
|
+
* - the collection layer sees frontmatter as Astro's YAML 1.1 parser
|
|
829
|
+
* delivers it, so an unquoted `publishedAt` arrives as a `Date`
|
|
830
|
+
* where the canonical schema takes the ISO string the author wrote
|
|
831
|
+
* (`withYamlTimestampsAsIsoStrings` below reconciles the two before
|
|
832
|
+
* the strict parse);
|
|
833
|
+
* - one validation site, with one error format (`[blog-post]` plus
|
|
834
|
+
* the file), rather than a second copy of the rules in
|
|
835
|
+
* `src/content.config.ts` that drifts each time a field changes.
|
|
836
|
+
*
|
|
837
|
+
* So the consumer's `src/content.config.ts` declares a `passthrough`
|
|
838
|
+
* collection schema that lets Astro accept any frontmatter shape; the
|
|
839
|
+
* engine then validates with the canonical Zod 4 schema at render time
|
|
840
|
+
* inside `<BlogPost>`. Astro's static site generator runs the page render
|
|
838
841
|
* during the build, so a malformed frontmatter still surfaces as a
|
|
839
842
|
* BUILD-TIME error (the `.parse()` call throws synchronously and Astro
|
|
840
843
|
* reports it with the page URL) — the only practical difference from a
|
|
@@ -843,9 +846,10 @@ schema, no double source of truth).
|
|
|
843
846
|
* # Why the engine ships an opaque shape (rather than the consumer
|
|
844
847
|
* importing the Astro `z` directly)
|
|
845
848
|
*
|
|
846
|
-
* Astro's content-collection API has churned across Astro 4 → 5
|
|
849
|
+
* Astro's content-collection API has churned across Astro 4 → 5 → 6
|
|
847
850
|
* (loaders moved from string-keyed `type` to a callable `loader`
|
|
848
|
-
* factory; the `glob()` loader's signature changed
|
|
851
|
+
* factory; the `glob()` loader's signature changed; `z` moved to
|
|
852
|
+
* `astro/zod`). Every consumer
|
|
849
853
|
* touching `defineCollection` directly inherits that churn; centralizing
|
|
850
854
|
* the wiring in the engine means the framework absorbs the upgrade
|
|
851
855
|
* cost in ONE place when Astro bumps a major.
|
|
@@ -856,8 +860,9 @@ schema, no double source of truth).
|
|
|
856
860
|
*
|
|
857
861
|
* ```ts
|
|
858
862
|
* // website/src/content.config.ts
|
|
859
|
-
* import { defineCollection
|
|
863
|
+
* import { defineCollection } from 'astro:content';
|
|
860
864
|
* import { glob } from 'astro/loaders';
|
|
865
|
+
* import { z } from 'astro/zod';
|
|
861
866
|
* import { buildBlogPostCollectionConfig } from '@wildo-ai/saas-website/mdx';
|
|
862
867
|
*
|
|
863
868
|
* export const collections = {
|
|
@@ -866,9 +871,9 @@ schema, no double source of truth).
|
|
|
866
871
|
* ```
|
|
867
872
|
*
|
|
868
873
|
* The consumer passes Astro's own `z` and `glob` in, because the engine
|
|
869
|
-
* cannot import `astro
|
|
870
|
-
*
|
|
871
|
-
*
|
|
874
|
+
* cannot import `astro/zod` nor `astro/loaders` (either would pull
|
|
875
|
+
* `astro` into the engine's walked closure, which the bundle-isolation
|
|
876
|
+
* test forbids, and `astro` is an optional peer the engine never loads). The
|
|
872
877
|
* engine builds the passthrough schema and the loader from them.
|
|
873
878
|
*
|
|
874
879
|
* **The upgrade this exists for happened (#2570).** The recipe used to be a
|
|
@@ -904,9 +909,9 @@ schema, no double source of truth).
|
|
|
904
909
|
|
|
905
910
|
/**
|
|
906
911
|
* Minimal contract for the Astro-side Zod factory we accept. Typed
|
|
907
|
-
* structurally (rather than imported from `astro
|
|
912
|
+
* structurally (rather than imported from `astro/zod`) so the
|
|
908
913
|
* engine package can compile/test without an Astro install. Astro's
|
|
909
|
-
* actual `z.object` returns a
|
|
914
|
+
* actual `z.object` returns a full Zod 4 object schema; we narrow to
|
|
910
915
|
* just the `.passthrough()` call we make below.
|
|
911
916
|
*/
|
|
912
917
|
export interface AstroZodFactoryShape {
|
|
@@ -936,11 +941,10 @@ export function blogPostEntryId(entry: string): string {
|
|
|
936
941
|
|
|
937
942
|
export interface BuildBlogPostCollectionConfigOptions {
|
|
938
943
|
/**
|
|
939
|
-
* Astro's
|
|
940
|
-
*
|
|
941
|
-
*
|
|
942
|
-
*
|
|
943
|
-
* walked closure with the `astro` runtime).
|
|
944
|
+
* Astro's `z` object — pass `import { z } from 'astro/zod'` from the
|
|
945
|
+
* consumer-side `src/content.config.ts`. The engine cannot import it
|
|
946
|
+
* itself (it would bring the `astro` runtime into the bundle-isolation
|
|
947
|
+
* walked closure, and `astro` is an optional peer).
|
|
944
948
|
*/
|
|
945
949
|
astroZ: AstroZodFactoryShape;
|
|
946
950
|
/** Astro's `glob` loader factory — pass `import { glob } from 'astro/loaders'`. */
|
|
@@ -1876,16 +1880,21 @@ export function createWebsiteBlogPostBridgeIsland(
|
|
|
1876
1880
|
* query-suffixed id does not match), so the content collection, its frontmatter and `render()` are
|
|
1877
1881
|
* untouched.
|
|
1878
1882
|
*
|
|
1879
|
-
* The compiler is
|
|
1880
|
-
*
|
|
1881
|
-
* `@astrojs/mdx`
|
|
1882
|
-
*
|
|
1883
|
-
*
|
|
1884
|
-
*
|
|
1883
|
+
* The compiler is MDX's own (`@mdx-js/mdx`), resolved through the site's `@astrojs/markdown-remark`, Astro's
|
|
1884
|
+
* unified Markdown package, so the site takes no second MDX dependency to keep in step. Since Astro 7,
|
|
1885
|
+
* `@astrojs/mdx` renders with Sätteri, Astro's native pipeline, and no longer carries `@mdx-js/mdx`; the unified
|
|
1886
|
+
* compiler and its plugins live in `@astrojs/markdown-remark`, which Astro 7 no longer installs by default. So a
|
|
1887
|
+
* site with a blog declares `@astrojs/markdown-remark` beside `@astrojs/mdx` (a version on the range Astro's own
|
|
1888
|
+
* peer declaration names). The two remark plugins applied are the ones `@astrojs/markdown-remark` ships:
|
|
1889
|
+
* `remark-gfm` (tables, task lists, autolinks) and `remark-smartypants` (typographic quotes). Nothing else from
|
|
1890
|
+
* the site's Markdown setup reaches a post's island body: the site's own remark and rehype plugins, and Astro's
|
|
1891
|
+
* rehype defaults (Shiki code highlighting, heading ids), do not apply. Style code blocks and link headings in
|
|
1892
|
+
* the post's components rather than relying on them.
|
|
1885
1893
|
*
|
|
1886
|
-
* Add it beside `mdx()` and `react()`:
|
|
1894
|
+
* Add it beside `mdx()` and `react()`, and declare both Markdown packages in the website's `package.json`:
|
|
1887
1895
|
*
|
|
1888
1896
|
* @example
|
|
1897
|
+
* // package.json: "@astrojs/mdx", "@astrojs/markdown-remark" (and "@astrojs/react")
|
|
1889
1898
|
* // astro.config.ts
|
|
1890
1899
|
* integrations: [mdx(), websiteBlogReactMdx(), react()],
|
|
1891
1900
|
*
|
|
@@ -1940,27 +1949,29 @@ function defaultExport(module: unknown): unknown {
|
|
|
1940
1949
|
}
|
|
1941
1950
|
|
|
1942
1951
|
/**
|
|
1943
|
-
* The MDX compiler and the two
|
|
1944
|
-
* `@astrojs/
|
|
1945
|
-
*
|
|
1952
|
+
* The MDX compiler and the two remark plugins Astro's unified Markdown pipeline applies, resolved through the
|
|
1953
|
+
* site's `@astrojs/markdown-remark` (Astro 7 moved them there from `@astrojs/mdx`, #3500). Refuses with the remedy
|
|
1954
|
+
* when the site has none: Astro 7 stopped installing it by default, so a site upgraded from Astro 6 meets this
|
|
1955
|
+
* first.
|
|
1946
1956
|
*/
|
|
1947
1957
|
async function loadCompiler(siteRoot: URL): Promise<{ compiler: MdxCompilerModule; remarkPlugins: unknown[] }> {
|
|
1948
1958
|
const fromSite = createRequire(new URL('package.json', siteRoot));
|
|
1949
|
-
let
|
|
1959
|
+
let markdownRemarkEntry: string;
|
|
1950
1960
|
try {
|
|
1951
|
-
|
|
1961
|
+
markdownRemarkEntry = fromSite.resolve('@astrojs/markdown-remark');
|
|
1952
1962
|
} catch {
|
|
1953
1963
|
throw new Error(
|
|
1954
|
-
`[saas-website] websiteBlogReactMdx() needs @astrojs/
|
|
1955
|
-
+ '
|
|
1964
|
+
`[saas-website] websiteBlogReactMdx() needs @astrojs/markdown-remark, resolved from ${fileURLToPath(siteRoot)}. `
|
|
1965
|
+
+ 'Astro 7 no longer installs it, and it carries the MDX compiler a post is compiled with: add it to the website '
|
|
1966
|
+
+ 'package beside @astrojs/mdx, and add mdx() to its integrations: the blog content collection needs it too.',
|
|
1956
1967
|
);
|
|
1957
1968
|
}
|
|
1958
|
-
const
|
|
1959
|
-
const
|
|
1969
|
+
const fromMarkdownRemark = createRequire(markdownRemarkEntry);
|
|
1970
|
+
const importFromMarkdownRemark = (specifier: string): Promise<unknown> => import(fromMarkdownRemark.resolve(specifier));
|
|
1960
1971
|
const [compiler, remarkGfm, remarkSmartypants] = await Promise.all([
|
|
1961
|
-
|
|
1962
|
-
|
|
1963
|
-
|
|
1972
|
+
importFromMarkdownRemark('@mdx-js/mdx'),
|
|
1973
|
+
importFromMarkdownRemark('remark-gfm'),
|
|
1974
|
+
importFromMarkdownRemark('remark-smartypants'),
|
|
1964
1975
|
]);
|
|
1965
1976
|
return {
|
|
1966
1977
|
compiler: compiler as MdxCompilerModule,
|
|
@@ -2051,7 +2062,7 @@ The query the bridges write as a literal (`WEBSITE_REACT_MDX_QUERY`, exported fr
|
|
|
2051
2062
|
* @example
|
|
2052
2063
|
* const rawModules = import.meta.glob('../content/blog/en/*.mdx', { eager: true, query: '?website-react-mdx' });
|
|
2053
2064
|
*
|
|
2054
|
-
* A bridge that omits it imports `@astrojs/mdx`'s module instead, compiled
|
|
2065
|
+
* A bridge that omits it imports `@astrojs/mdx`'s module instead, compiled for Astro rather than React, which a React island cannot
|
|
2055
2066
|
* render (React refuses the object it returns as a child; see `websiteBlogReactMdx`). The constant names the literal
|
|
2056
2067
|
* for code that checks a module id; it cannot stand in for the literal in the glob itself.
|
|
2057
2068
|
*/
|
|
@@ -37,7 +37,7 @@ following the theme, the motion vocabulary and every later fix.
|
|
|
37
37
|
|---|---|
|
|
38
38
|
| A page's sections (one file per page) | `website/src/sections/<page>.sections.tsx` |
|
|
39
39
|
| The site's choices for the blocks (config builders: motif, icons, actions) | `website/src/sections/kit/**` |
|
|
40
|
-
| The words each slot reads, per locale | `website/src/i18n/<locale>.json
|
|
40
|
+
| The words each slot reads, per locale | `website/src/i18n/<locale>/<page>.<section>.json`, the section's own file (`website.<page>.<section>.<slot>`) |
|
|
41
41
|
| The site's adjustments to a block | `website/src/styles/**` (rules on `data-website-*` hooks) |
|
|
42
42
|
| The theme every block reads | `website/src/website-root.config.ts` (`designTokens`) |
|
|
43
43
|
|
package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md
CHANGED
|
@@ -156,9 +156,9 @@ The week's plan: rows are completed one by one, a new todo is TYPED into the fie
|
|
|
156
156
|
```tsx
|
|
157
157
|
/**
|
|
158
158
|
* The week, as the application keeps it: the week IS a list (`todoLists`), and its rows are the commitments created in
|
|
159
|
-
* it (`todos`, each with an owner, a due day and a priority). A todo captured with quick add goes to the Inbox list and
|
|
160
|
-
*
|
|
161
|
-
*
|
|
159
|
+
* it (`todos`, each with an owner, a due day and a priority). A todo captured with quick add goes to the Inbox list, and
|
|
160
|
+
* joins a week only when someone moves it there (`move_to_list`), so the drawing shows the capture in its own list,
|
|
161
|
+
* not appearing in the week by itself. Rank belongs to TASKS, not todos, so the rows carry no order
|
|
162
162
|
* of their own; nothing here is drag-and-drop, and the drawing shows no list-level progress count, which lists do not
|
|
163
163
|
* have.
|
|
164
164
|
*
|