@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -0,0 +1,340 @@
|
|
|
1
|
+
# Processing region reach
|
|
2
|
+
|
|
3
|
+
How each region your provider's `complianceProfile.processingRegions` lists is REACHED, and what an
|
|
4
|
+
application's region choice therefore does at runtime.
|
|
5
|
+
|
|
6
|
+
Read this when:
|
|
7
|
+
|
|
8
|
+
- your vendor offers regions (EU, US, a named data centre) and you are declaring them;
|
|
9
|
+
- an application chose a region and you need its calls to go there;
|
|
10
|
+
- `wildo config sync` refused a region, or startup refused your module with "incoherent processing-region reach";
|
|
11
|
+
- a compliance document has to say whether a region is enforced or the operator's claim.
|
|
12
|
+
|
|
13
|
+
## Three kinds, and they are different claims
|
|
14
|
+
|
|
15
|
+
| kind | how the vendor offers the region | what the application's choice does |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| `ProviderProcessingRegionReachKind.ENDPOINT` | each region has its own API host | SELECTS the host every arm calls: the region is enforced by the product |
|
|
18
|
+
| `ProviderProcessingRegionReachKind.REQUEST_PARAMETER` | one host for every region; each request names the region (a model vendor's per-request geography) | SETS that parameter on every request an AI-SDK arm sends: enforced by the product |
|
|
19
|
+
| `ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY` | the region was fixed when the operator created its account, domain or project at the vendor; every call goes to one host | nothing at runtime: the region is the operator's attested statement about its account |
|
|
20
|
+
|
|
21
|
+
Declare `processingRegionReach` keyed by EVERY region in `processingRegions`, no more and no fewer. Leave it
|
|
22
|
+
out when you do not know: a reader then says the region is neither enforced nor attested. Cite where you read
|
|
23
|
+
it with `ProviderComplianceFact.PROCESSING_REGION_REACH` in the profile's `evidence`, from the vendor's own
|
|
24
|
+
documentation.
|
|
25
|
+
|
|
26
|
+
A vendor whose account lives in one region AND whose API host differs per region (the host must match where the
|
|
27
|
+
workspace lives) is an ENDPOINT vendor: the region picks the host. Declare it as below, through the application
|
|
28
|
+
account's answer when the host is a placeholder.
|
|
29
|
+
|
|
30
|
+
## Declaring an endpoint-reached region
|
|
31
|
+
|
|
32
|
+
For an `ENDPOINT` region, `baseUrls` maps each protocol arm's key (`protocols[].protocol`, such as
|
|
33
|
+
`LLM_PROVIDER` or `EMAIL_PROVIDER`) to the base URL that arm calls in that region:
|
|
34
|
+
|
|
35
|
+
- Name EVERY arm that declares a fixed `baseUrl`. Composition refuses a region that leaves one out, because
|
|
36
|
+
that arm would keep calling its default host and the region would hold for one operation family only.
|
|
37
|
+
- Name only arms the module declares, and never an arm that reads its host from a deployment slot
|
|
38
|
+
(`baseUrlHostEnvVarName`): that host is the operator's own resource.
|
|
39
|
+
- Keep each arm's own `baseUrl` as the default host. It is what a call uses when no region is chosen.
|
|
40
|
+
- An AI arm's `sdkFactory` MUST pass the context's `baseUrl` to its client
|
|
41
|
+
(`createX({ apiKey, baseURL: baseUrl })`), and each region's URL must be in the form that client expects.
|
|
42
|
+
A factory that ignores the context keeps calling the SDK's default host whichever region is chosen.
|
|
43
|
+
- For an arm whose host is a per-account placeholder (`baseUrl: 'https://{apiHost}'` with `baseUrlHostAllowances`),
|
|
44
|
+
name `applicationConnectionAnswers: { <arm>: { <answer name>: <value> } }` instead of a base URL. Each answer name
|
|
45
|
+
must be one the arm's own `applicationConnectionAnswers` declares (the question the application's own account
|
|
46
|
+
answers); the value is admitted through the arm's host allowance on every call, like a connected account's answer.
|
|
47
|
+
It answers for the APPLICATION's account only: a connected person's or organization's account keeps the region it
|
|
48
|
+
connected from. A deployment slot that names another value for the same question refuses startup.
|
|
49
|
+
- Say what the region asks of the operator beside it (a region-specific API key, a domain created in that
|
|
50
|
+
region): the vendor usually needs one, and the operator has to know.
|
|
51
|
+
|
|
52
|
+
## Declaring a request-parameter region
|
|
53
|
+
|
|
54
|
+
For a `REQUEST_PARAMETER` region, `sdkProviderOptions` maps each AI-SDK arm's key to the `providerOptions` every
|
|
55
|
+
request it sends carries, keyed by the SDK provider id: `{ LLM_PROVIDER: { anthropic: { inferenceGeo: 'us' } } }`.
|
|
56
|
+
Name EVERY arm that declares an `sdkFactory`, and only those. The engine wraps the arm's client so every model it
|
|
57
|
+
hands out sends those options, over whatever a single call passes: a call cannot run the request elsewhere.
|
|
58
|
+
|
|
59
|
+
## What happens to a choice
|
|
60
|
+
|
|
61
|
+
`providerComplianceChoices.<ref>.processingRegion` in `wildo.saas.config.ts` is read by
|
|
62
|
+
`wildo config sync`, which records the region of every provider that enforces its regions (by endpoint or by request parameter) in
|
|
63
|
+
the provider runtime artifacts. Each runtime's provider loader then binds your module to that region: every named
|
|
64
|
+
arm's `baseUrl` becomes the region's URL, the application account's host answers become the region's, and every
|
|
65
|
+
named AI-SDK arm sends the region's options, so email, SMS, the AI SDK context, document extraction and REST calls
|
|
66
|
+
all go to, or name, the region without knowing a region exists.
|
|
67
|
+
|
|
68
|
+
A region a provider that enforces its regions cannot be reached in is REFUSED: by `wildo config sync`, before any
|
|
69
|
+
artifact is written, and by startup if an artifact still names it. The message names the regions the
|
|
70
|
+
provider serves. It never falls back to the default host, which would state a region the application does
|
|
71
|
+
not use.
|
|
72
|
+
|
|
73
|
+
## Import Origins
|
|
74
|
+
|
|
75
|
+
- `@wildo-ai/saas-models`
|
|
76
|
+
|
|
77
|
+
## Source Excerpts
|
|
78
|
+
|
|
79
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
80
|
+
|
|
81
|
+
```typescript
|
|
82
|
+
/**
|
|
83
|
+
* HOW a provider's processing region is reached — which decides whether an application's region choice is something the
|
|
84
|
+
* product DOES or something the operator ATTESTS (#3513).
|
|
85
|
+
*
|
|
86
|
+
* A region in `processingRegions` used to be a label and nothing more: Your Application chose Mistral `EU` while every call
|
|
87
|
+
* went to Mistral's global host, so the processor register stated a location the product did not use. A vendor offers a
|
|
88
|
+
* region in one of two ways, and they are different claims:
|
|
89
|
+
*
|
|
90
|
+
* - by ENDPOINT: each region has its own host, and the host a call goes to IS the region. The application's choice
|
|
91
|
+
* selects that host, so the region is enforced by the product, and a choice the vendor cannot be reached in is a
|
|
92
|
+
* configuration error, refused when the configuration is loaded rather than dialled at the global host.
|
|
93
|
+
* - by ACCOUNT RESIDENCY: the region was fixed when the operator created its account (or domain, workspace, project) at
|
|
94
|
+
* the vendor, and every call goes to the same host. No call selects it, so the application's choice is the operator's
|
|
95
|
+
* statement about that account, and a reader must say so rather than present it as enforced.
|
|
96
|
+
*
|
|
97
|
+
* - by REQUEST PARAMETER: every region shares one host, and each request names the region it must run in (Anthropic's
|
|
98
|
+
* `inference_geo`). The application's choice sets that parameter on every request, so the region is enforced per call
|
|
99
|
+
* exactly as an endpoint is, but by the body rather than the host. A choice the vendor cannot serve is refused the same
|
|
100
|
+
* way.
|
|
101
|
+
*
|
|
102
|
+
* An ENDPOINT region may name its host in two ways, per protocol arm: a fixed base URL (Mistral's `api.eu.mistral.ai`),
|
|
103
|
+
* or, for an arm whose host is a per-account placeholder admitted through `baseUrlHostAllowances`, the ANSWER the
|
|
104
|
+
* application's own account gives to that placeholder's question (Intercom's EU login host, from which its EU API host
|
|
105
|
+
* is derived). The second is still the endpoint: the answer passes the same host allowance a connected account's
|
|
106
|
+
* answer passes, on every call.
|
|
107
|
+
*/
|
|
108
|
+
export enum ProviderProcessingRegionReachKind {
|
|
109
|
+
/** The region has its own endpoint, and the application's choice selects it: enforced by what the product calls. */
|
|
110
|
+
ENDPOINT = 'endpoint',
|
|
111
|
+
/**
|
|
112
|
+
* The region is named by a parameter of every request (one host for all regions), and the application's choice sets
|
|
113
|
+
* it: enforced by what the product sends.
|
|
114
|
+
*/
|
|
115
|
+
REQUEST_PARAMETER = 'request-parameter',
|
|
116
|
+
/** The region is where the operator's account at the vendor lives; no call selects it: attested by the operator. */
|
|
117
|
+
ACCOUNT_RESIDENCY = 'account-residency',
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* True for a reach the PRODUCT enforces (every call goes to the region's endpoint, or names the region), false for one the
|
|
122
|
+
* operator attests. The one reading the companion brief, the evidence collector and the sync share, so an enforced kind
|
|
123
|
+
* added to {@link ProviderProcessingRegionReachKind} is enforced everywhere at once.
|
|
124
|
+
*/
|
|
125
|
+
export function processingRegionReachIsEnforced(kind: ProviderProcessingRegionReachKind): boolean {
|
|
126
|
+
switch (kind) {
|
|
127
|
+
case ProviderProcessingRegionReachKind.ENDPOINT:
|
|
128
|
+
case ProviderProcessingRegionReachKind.REQUEST_PARAMETER:
|
|
129
|
+
return true;
|
|
130
|
+
case ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY:
|
|
131
|
+
return false;
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* How a region an application chose for a provider HOLDS, in the words a document states it (#3513). Three answers, and a
|
|
137
|
+
* reader must not round one into another: a region the product enforces is a property of the product, a region the
|
|
138
|
+
* operator attests is a statement about its account, and a region nothing says how it is reached is the operator's claim
|
|
139
|
+
* only.
|
|
140
|
+
*/
|
|
141
|
+
export enum ProcessingRegionHolding {
|
|
142
|
+
/** Every call goes to the region's endpoint, or names the region ({@link processingRegionReachIsEnforced}). */
|
|
143
|
+
ENFORCED = 'enforced',
|
|
144
|
+
/** The region is where the operator's account at the vendor lives, as the operator states it; no call selects it. */
|
|
145
|
+
ATTESTED = 'attested',
|
|
146
|
+
/** The provider does not say how the region is reached (no reach declared, or a region it does not list). */
|
|
147
|
+
NEITHER = 'neither',
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* The {@link ProcessingRegionHolding} of a chosen region, from its reach kind (`null` when none is declared). The one
|
|
152
|
+
* reading the companion brief and the computed document facts share, so the two cannot state a region differently.
|
|
153
|
+
*/
|
|
154
|
+
export function processingRegionHoldingOf(reach: ProviderProcessingRegionReachKind | null): ProcessingRegionHolding {
|
|
155
|
+
if (reach === null) return ProcessingRegionHolding.NEITHER;
|
|
156
|
+
return processingRegionReachIsEnforced(reach) ? ProcessingRegionHolding.ENFORCED : ProcessingRegionHolding.ATTESTED;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** One value an AI-SDK `providerOptions` entry may carry (the shape the vendor's SDK reads). */
|
|
160
|
+
const ProcessingRegionSdkOptionValueSchema = z.union([z.string(), z.number(), z.boolean()]);
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* How ONE region is reached. Every map is keyed by the provider's protocol arms (its `protocols[].protocol`, e.g.
|
|
164
|
+
* `LLM_PROVIDER`, `DOCUMENT_EXTRACTION_PROVIDER`), because a vendor's operation families can live on different hosts.
|
|
165
|
+
*
|
|
166
|
+
* - {@link ProviderProcessingRegionReachKind.ENDPOINT}: `baseUrls` gives each arm with a fixed host the base URL it calls
|
|
167
|
+
* in this region; `applicationConnectionAnswers` gives an arm whose host is a per-account placeholder the answer the
|
|
168
|
+
* APPLICATION's own account gives in this region (each name one the arm's `applicationConnectionAnswers` declares), and
|
|
169
|
+
* that answer passes the arm's `baseUrlHostAllowances` on every call. A connected person's or organization's account
|
|
170
|
+
* keeps its own answers: the region is the operator's processing, not theirs. Every arm with a fixed base URL must be
|
|
171
|
+
* covered one way or the other; the backend provider composition refuses a module that leaves one out.
|
|
172
|
+
* An arm whose host is the operator's own deployment slot (`baseUrlHostEnvVarName`) may be named in `baseUrls` too, when
|
|
173
|
+
* the vendor derives the host from the region alone (AWS: `bedrock-runtime.<region>.amazonaws.com`): the region then
|
|
174
|
+
* SELECTS the slot's value instead of the deployment authoring it, and a deployment value naming another host is
|
|
175
|
+
* refused. Such an arm that SIGNS with the region (AWS SigV4) names it in `requestSigningRegions`, so the signature is
|
|
176
|
+
* scoped to the host it is sent to. A host slot that names a resource rather than a region (Azure's
|
|
177
|
+
* `<resource>.openai.azure.com`) cannot be derived from a region, so a region there is ACCOUNT_RESIDENCY.
|
|
178
|
+
* - {@link ProviderProcessingRegionReachKind.REQUEST_PARAMETER}: `sdkProviderOptions` gives each AI-SDK arm the
|
|
179
|
+
* `providerOptions` every model it builds sends (`{ anthropic: { inferenceGeo: 'us' } }`), set by the engine on every
|
|
180
|
+
* request and never overridden by a call. Every arm with an `sdkFactory` must be covered.
|
|
181
|
+
* - {@link ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY}: nothing to name.
|
|
182
|
+
*/
|
|
183
|
+
export const ProviderProcessingRegionReachSchema = z.discriminatedUnion('kind', [
|
|
184
|
+
z.strictObject({
|
|
185
|
+
kind: z.literal(ProviderProcessingRegionReachKind.ENDPOINT),
|
|
186
|
+
baseUrls: z.record(z.string().trim().min(1), z.url({ protocol: /^https$/ })).optional(),
|
|
187
|
+
applicationConnectionAnswers: z.record(z.string().trim().min(1), z.record(z.string().trim().min(1), z.string().trim().min(1))).optional(),
|
|
188
|
+
/** Per arm that signs its requests with the region (AWS SigV4), the region its signature is scoped to here. */
|
|
189
|
+
requestSigningRegions: z.record(z.string().trim().min(1), z.string().trim().min(1)).optional(),
|
|
190
|
+
}).refine(
|
|
191
|
+
(entry) => Object.keys(entry.baseUrls ?? {}).length + Object.keys(entry.applicationConnectionAnswers ?? {}).length > 0,
|
|
192
|
+
{ message: 'an endpoint-reached region names, for at least one protocol arm, its base URL or its application account\'s host answer' },
|
|
193
|
+
),
|
|
194
|
+
z.strictObject({
|
|
195
|
+
kind: z.literal(ProviderProcessingRegionReachKind.REQUEST_PARAMETER),
|
|
196
|
+
sdkProviderOptions: z.record(z.string().trim().min(1), z.record(z.string().trim().min(1), z.record(z.string().trim().min(1), ProcessingRegionSdkOptionValueSchema)))
|
|
197
|
+
.refine((options) => Object.keys(options).length > 0, { message: 'a request-parameter region names the provider options of at least one protocol arm' }),
|
|
198
|
+
}),
|
|
199
|
+
z.strictObject({ kind: z.literal(ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY) }),
|
|
200
|
+
]);
|
|
201
|
+
export type ProviderProcessingRegionReach = z.infer<typeof ProviderProcessingRegionReachSchema>;
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## Import Origins
|
|
205
|
+
|
|
206
|
+
- `@wildo-ai/saas-models`
|
|
207
|
+
|
|
208
|
+
## Source Excerpts
|
|
209
|
+
|
|
210
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
211
|
+
|
|
212
|
+
```typescript
|
|
213
|
+
/**
|
|
214
|
+
* What an application's `processingRegion` choice does to the endpoint a provider's runtime calls (#3513). One answer per
|
|
215
|
+
* case, because each is a different statement a reader makes and a different thing the runtime does.
|
|
216
|
+
*/
|
|
217
|
+
export enum ProviderProcessingRegionSelectionStatus {
|
|
218
|
+
/**
|
|
219
|
+
* The chosen region has its own endpoint, and every arm calls it (its base URL, or the host the application account's
|
|
220
|
+
* region answer resolves to): the region is ENFORCED.
|
|
221
|
+
*/
|
|
222
|
+
ENDPOINT_SELECTED = 'endpoint-selected',
|
|
223
|
+
/** The chosen region is named by a request parameter, and every request of every AI-SDK arm sends it: ENFORCED. */
|
|
224
|
+
REQUEST_PARAMETER_SELECTED = 'request-parameter-selected',
|
|
225
|
+
/** The chosen region is where the operator's vendor account lives. Nothing is selected; the region is ATTESTED. */
|
|
226
|
+
ACCOUNT_ATTESTED = 'account-attested',
|
|
227
|
+
/** The provider states no reach for its regions (or no established profile): the region is neither selected nor attested. */
|
|
228
|
+
REACH_UNDECLARED = 'reach-undeclared',
|
|
229
|
+
/** No region is chosen (a self-hosted choice, or no choice): every arm calls its own declared base URL. */
|
|
230
|
+
NO_REGION_CHOSEN = 'no-region-chosen',
|
|
231
|
+
/**
|
|
232
|
+
* The chosen region is not one the provider lists, and the provider is reached by account residency only. Reported as an
|
|
233
|
+
* app-asserted region (the choice schema's warn-do-not-block posture), never refused: no endpoint would have reached it
|
|
234
|
+
* any differently.
|
|
235
|
+
*/
|
|
236
|
+
REGION_NOT_LISTED = 'region-not-listed',
|
|
237
|
+
/**
|
|
238
|
+
* The chosen region is not one the provider can be reached in, and the provider ENFORCES its regions (by endpoint or by
|
|
239
|
+
* request parameter). REFUSED at configuration load: calling the default host, or sending no region, would state a
|
|
240
|
+
* region the product does not use, which is the defect this exists to remove.
|
|
241
|
+
*/
|
|
242
|
+
REFUSED = 'refused',
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
/** The outcome of {@link resolveProviderProcessingRegionSelection}, keyed by its status. */
|
|
246
|
+
export type ProviderProcessingRegionSelection =
|
|
247
|
+
| {
|
|
248
|
+
readonly status: ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED;
|
|
249
|
+
readonly region: string;
|
|
250
|
+
/** Per arm, the base URL it calls in the region (empty when the region names only host answers). */
|
|
251
|
+
readonly baseUrls: Readonly<Record<string, string>>;
|
|
252
|
+
/** Per arm, the answers the application's own account gives in the region (empty when it names only base URLs). */
|
|
253
|
+
readonly applicationConnectionAnswers: Readonly<Record<string, Readonly<Record<string, string>>>>;
|
|
254
|
+
/** Per signing arm, the region its signature is scoped to (empty for a region no arm signs with). */
|
|
255
|
+
readonly requestSigningRegions: Readonly<Record<string, string>>;
|
|
256
|
+
}
|
|
257
|
+
| {
|
|
258
|
+
readonly status: ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED;
|
|
259
|
+
readonly region: string;
|
|
260
|
+
/** Per AI-SDK arm, the `providerOptions` every request it sends carries. */
|
|
261
|
+
readonly sdkProviderOptions: Readonly<Record<string, Readonly<Record<string, Readonly<Record<string, string | number | boolean>>>>>>;
|
|
262
|
+
}
|
|
263
|
+
| { readonly status: ProviderProcessingRegionSelectionStatus.ACCOUNT_ATTESTED; readonly region: string }
|
|
264
|
+
| { readonly status: ProviderProcessingRegionSelectionStatus.REACH_UNDECLARED; readonly region: string }
|
|
265
|
+
| { readonly status: ProviderProcessingRegionSelectionStatus.NO_REGION_CHOSEN }
|
|
266
|
+
| { readonly status: ProviderProcessingRegionSelectionStatus.REGION_NOT_LISTED; readonly region: string }
|
|
267
|
+
| { readonly status: ProviderProcessingRegionSelectionStatus.REFUSED; readonly region: string; readonly message: string };
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* True when the profile ENFORCES at least one of its regions (by endpoint or by request parameter,
|
|
271
|
+
* {@link processingRegionReachIsEnforced}), so a region choice SELECTS what the runtime calls or sends, and a region it
|
|
272
|
+
* does not list is refused rather than reported.
|
|
273
|
+
*/
|
|
274
|
+
export function providerEnforcesProcessingRegion(profile: ProviderComplianceProfile | null | undefined): boolean {
|
|
275
|
+
const reach = establishedProviderComplianceProfile(profile)?.processingRegionReach;
|
|
276
|
+
return reach !== undefined && Object.values(reach).some((entry) => processingRegionReachIsEnforced(entry.kind));
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* The ONE decision about what a chosen region does to a provider's endpoints (#3513), read by `wildo config sync` (which
|
|
281
|
+
* refuses a {@link ProviderProcessingRegionSelectionStatus.REFUSED} choice before writing a runtime artifact) and by the
|
|
282
|
+
* backend provider loader (which binds the module for an ENDPOINT_SELECTED or REQUEST_PARAMETER_SELECTED one, and refuses to
|
|
283
|
+
* start on a REFUSED one). Never re-derived beside it: the configuration check and the runtime must not disagree about which host a
|
|
284
|
+
* region means.
|
|
285
|
+
*
|
|
286
|
+
* assurance-control: WILDO.PRIVACY.THIRD_PARTY_PROCESSING — a processing region an application declares for an
|
|
287
|
+
* endpoint-reached processor selects the endpoint the product calls, and a region it cannot be reached in is refused.
|
|
288
|
+
*/
|
|
289
|
+
export function resolveProviderProcessingRegionSelection(params: {
|
|
290
|
+
readonly providerRef: string;
|
|
291
|
+
readonly profile: ProviderComplianceProfile | null | undefined;
|
|
292
|
+
readonly region: string | undefined;
|
|
293
|
+
}): ProviderProcessingRegionSelection {
|
|
294
|
+
const { providerRef, region } = params;
|
|
295
|
+
if (region === undefined) return { status: ProviderProcessingRegionSelectionStatus.NO_REGION_CHOSEN };
|
|
296
|
+
const established = establishedProviderComplianceProfile(params.profile);
|
|
297
|
+
const reach = established?.processingRegionReach;
|
|
298
|
+
if (established === null || reach === undefined) return { status: ProviderProcessingRegionSelectionStatus.REACH_UNDECLARED, region };
|
|
299
|
+
const entry = Object.hasOwn(reach, region) ? reach[region] : undefined;
|
|
300
|
+
if (entry === undefined) {
|
|
301
|
+
if (!providerEnforcesProcessingRegion(established)) return { status: ProviderProcessingRegionSelectionStatus.REGION_NOT_LISTED, region };
|
|
302
|
+
return {
|
|
303
|
+
status: ProviderProcessingRegionSelectionStatus.REFUSED,
|
|
304
|
+
region,
|
|
305
|
+
message: `providerComplianceChoices.${providerRef}.processingRegion is "${region}", which provider "${providerRef}" cannot be reached in. `
|
|
306
|
+
+ `It selects its region on every call (the endpoint each call goes to, or a parameter each request carries), and serves: ${established.processingRegions.join(', ')}. `
|
|
307
|
+
+ 'Choose one of those; calling its default endpoint instead would state a region the application does not use.',
|
|
308
|
+
};
|
|
309
|
+
}
|
|
310
|
+
switch (entry.kind) {
|
|
311
|
+
case ProviderProcessingRegionReachKind.ACCOUNT_RESIDENCY:
|
|
312
|
+
return { status: ProviderProcessingRegionSelectionStatus.ACCOUNT_ATTESTED, region };
|
|
313
|
+
case ProviderProcessingRegionReachKind.REQUEST_PARAMETER:
|
|
314
|
+
return { status: ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED, region, sdkProviderOptions: entry.sdkProviderOptions };
|
|
315
|
+
case ProviderProcessingRegionReachKind.ENDPOINT:
|
|
316
|
+
return {
|
|
317
|
+
status: ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED,
|
|
318
|
+
region,
|
|
319
|
+
baseUrls: entry.baseUrls ?? {},
|
|
320
|
+
applicationConnectionAnswers: entry.applicationConnectionAnswers ?? {},
|
|
321
|
+
requestSigningRegions: entry.requestSigningRegions ?? {},
|
|
322
|
+
};
|
|
323
|
+
}
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
/**
|
|
327
|
+
* True when a selection changes what the runtime calls or sends, so `wildo config sync` records the region in the provider
|
|
328
|
+
* runtime artifacts and the backend loader binds the module to it. Every other status leaves the module unchanged. A type
|
|
329
|
+
* guard, so a caller reads `selection.region` only on the arms that carry the region it binds.
|
|
330
|
+
*/
|
|
331
|
+
export function processingRegionSelectionBindsRuntime(
|
|
332
|
+
selection: ProviderProcessingRegionSelection,
|
|
333
|
+
): selection is Extract<
|
|
334
|
+
ProviderProcessingRegionSelection,
|
|
335
|
+
{ status: ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED | ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED }
|
|
336
|
+
> {
|
|
337
|
+
return selection.status === ProviderProcessingRegionSelectionStatus.ENDPOINT_SELECTED
|
|
338
|
+
|| selection.status === ProviderProcessingRegionSelectionStatus.REQUEST_PARAMETER_SELECTED;
|
|
339
|
+
}
|
|
340
|
+
```
|
|
@@ -191,6 +191,12 @@ export interface ProviderRestOAuth2Audience {
|
|
|
191
191
|
readonly hosts: {
|
|
192
192
|
readonly values: readonly string[];
|
|
193
193
|
readonly hostSuffixes?: readonly string[];
|
|
194
|
+
/**
|
|
195
|
+
* The most DNS labels a host may carry before one of `hostSuffixes`; absent, any number (#3640). The same bound,
|
|
196
|
+
* with the same meaning, as a host allowance's `hostSuffixMaxLabels`: declare it where the vendor documents its
|
|
197
|
+
* hosts as one shape (`<store>.myshopify.com`), so a token is never sent to a deeper name under the suffix.
|
|
198
|
+
*/
|
|
199
|
+
readonly hostSuffixMaxLabels?: number;
|
|
194
200
|
};
|
|
195
201
|
/**
|
|
196
202
|
* The scopes that mint a token for this audience, all of ONE resource. An entry may begin with
|
|
@@ -212,15 +218,14 @@ export interface ProviderOAuth2AudienceSelection {
|
|
|
212
218
|
readonly primary: boolean;
|
|
213
219
|
}
|
|
214
220
|
|
|
215
|
-
/**
|
|
221
|
+
/**
|
|
222
|
+
* Whether `host` is admitted by one audience's hosts: an exact value, or `<labels><suffix>` for a declared suffix, with
|
|
223
|
+
* no more labels than `hostSuffixMaxLabels` allows (#3640).
|
|
224
|
+
*/
|
|
216
225
|
export function providerOAuth2AudienceAdmitsHost(audience: ProviderRestOAuth2Audience, host: string): boolean {
|
|
217
226
|
const candidate = host.toLowerCase();
|
|
218
227
|
if (audience.hosts.values.some((value) => value.toLowerCase() === candidate)) return true;
|
|
219
|
-
return (audience.hosts.hostSuffixes ?? []).some((suffix) =>
|
|
220
|
-
const lowered = suffix.toLowerCase();
|
|
221
|
-
if (!candidate.endsWith(lowered) || candidate.length === lowered.length) return false;
|
|
222
|
-
return PROVIDER_OAUTH2_DNS_NAME_PATTERN.test(candidate.slice(0, candidate.length - lowered.length));
|
|
223
|
-
});
|
|
228
|
+
return (audience.hosts.hostSuffixes ?? []).some((suffix) => providerHostIsUnderSuffix(candidate, suffix, audience.hosts.hostSuffixMaxLabels));
|
|
224
229
|
}
|
|
225
230
|
|
|
226
231
|
/**
|
|
@@ -67,6 +67,8 @@ export const PROVIDER_CAPABILITY_FRONTEND_CONSENT_CLASSIFICATION = Object.freeze
|
|
|
67
67
|
EMAIL_MARKETING: SERVER_ONLY,
|
|
68
68
|
EMAIL_INBOUND: SERVER_ONLY,
|
|
69
69
|
SMS: SERVER_ONLY,
|
|
70
|
+
// #2293: a deliverable is sent for signature from the backend; the vendor's signing page is its own, not a browser SDK.
|
|
71
|
+
ELECTRONIC_SIGNATURE: SERVER_ONLY,
|
|
70
72
|
SSO_SAML: SERVER_ONLY,
|
|
71
73
|
LLM_CHAT: SERVER_ONLY,
|
|
72
74
|
LLM_EMBEDDINGS: SERVER_ONLY,
|
|
@@ -102,7 +102,10 @@ key): a declared provider missing one is then reported as not configured by
|
|
|
102
102
|
inside the vendor SDK. And a provider resting on consent (analytics, a
|
|
103
103
|
captcha that profiles visitors) declares `sdk.stoppable: true` and returns a
|
|
104
104
|
`deactivate` from `activate`, so a withdrawal stops it; it may add
|
|
105
|
-
`consentPurposes` beyond its capability's, never remove one.
|
|
105
|
+
`consentPurposes` beyond its capability's, never remove one. Declare such a
|
|
106
|
+
provider for the website or the application, never for the technical
|
|
107
|
+
documentation: the documentation asks no one for consent, so it would never
|
|
108
|
+
start there, and projecting it for that surface is refused.
|
|
106
109
|
|
|
107
110
|
### Step 4: Register and scope it
|
|
108
111
|
|
|
@@ -119,7 +122,7 @@ keys under `providerConfigurations.<ref>.frontend_sdk`.
|
|
|
119
122
|
|
|
120
123
|
The service must be able to LOAD the vendor SDK. An installed facet package
|
|
121
124
|
declares it as its own dependency (`"*"`; the module's `wildo.module.json`
|
|
122
|
-
records the version, which the install writes into your application's `pnpm.
|
|
125
|
+
records the version, which the install writes into your application's overrides in `pnpm-workspace.yaml`). A module you wrote yourself
|
|
123
126
|
does the same: put the SDK in its OWN package's dependencies, never in the service's, so it has one version and leaves
|
|
124
127
|
with the module. No engine browser provider loads an npm SDK: one that needs it is a registry module. A captcha needs its verifier: declare the SAME ref under the
|
|
125
128
|
backend scope with `FRONTEND_CAPTCHA`, or the backend checks nothing.
|
package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md
CHANGED
|
@@ -49,7 +49,7 @@ layout is for: the browser SDK never reaches a backend install, and a Node SDK n
|
|
|
49
49
|
|
|
50
50
|
The facet declares the SDK as `"*"`, and its exact version lives once, in the module's `wildo.module.json`
|
|
51
51
|
(`dependsOn.npm.dependencies`): the version the module was proven with. Installing the module writes that version
|
|
52
|
-
into your application's `pnpm.
|
|
52
|
+
into your application's overrides in `pnpm-workspace.yaml`; an update moves it, and a remove takes out what the install wrote (a pin you
|
|
53
53
|
had already set, one you changed since, and one another installed module also pins are left). Two modules pinning one
|
|
54
54
|
package at different versions are refused, at install or update, naming both. A library the framework itself pins (`zod`, `react`) is not a vendor SDK: declare it `"*"` and
|
|
55
55
|
never pin it in the module. Publishing refuses a module whose record and facets disagree.
|
|
@@ -108,7 +108,9 @@ such input's choices come from (`inputOptions` on the operation, see
|
|
|
108
108
|
`providers.browserOperations` too, with the same connections, then call
|
|
109
109
|
`getManualCallsHttpClient().loadProviderOperationInputOptions(ref, operationId, inputField, { connection, input })`,
|
|
110
110
|
which returns `{ optionsOperationId, options: [{ value, label }] }`. Pass a choice the list depends on
|
|
111
|
-
(Asana's projects depend on the workspace) in `input`; without it the answer is a 400 naming it.
|
|
111
|
+
(Asana's projects depend on the workspace) in `input`; without it the answer is a 400 naming it. `inputField` is a dot
|
|
112
|
+
PATH into the input when the vendor nests the value in a reference object (`project.key`, `CustomerRef.value`): put
|
|
113
|
+
the chosen value at that path, and pass a choice the list depends on at its own path (`{ project: { key: 'OPS' } }`).
|
|
112
114
|
|
|
113
115
|
### Step 4c — A missing permission: grow the connection, do not reconnect it
|
|
114
116
|
|
|
@@ -146,8 +148,20 @@ the vendor's and unscanned: do not relay them to a person or write them as a fil
|
|
|
146
148
|
`SAAS_SERVICE_TYPES.ProviderDocumentFileWriter`, from `@wildo-ai/saas-backend-lib`): it stores the bytes
|
|
147
149
|
as a file of the target resource's scope and always has them scanned, and with no scanner the file ends
|
|
148
150
|
FAILED. It returns the file while the scan runs; reference it from the record once it is CLEAN (a write
|
|
149
|
-
naming a file that is still scanning is refused, and may be retried).
|
|
150
|
-
|
|
151
|
+
naming a file that is still scanning is refused, and may be retried). The context you pass decides who may name it: a
|
|
152
|
+
person's or machine's own request can, and so can the same inbound delivery, on any retry of it. A later delivery, a
|
|
153
|
+
webhook or a public request cannot. From those, name the file through a system write (the resource's
|
|
154
|
+
`systemAccessPolicy` must allow it), and take the id from your own record or from what this writer returned, never from
|
|
155
|
+
the request: a system write links any file it is given. A browser
|
|
156
|
+
cannot call a download operation (`PROVIDER_OPERATION_DOCUMENT_NOT_SERVED`).
|
|
157
|
+
|
|
158
|
+
A GRAPHQL operation (one declaring `graphql`, such as GitHub's `github_issues_list_discussions`) is called like any
|
|
159
|
+
other: its input is the query's variables, and an input field the query declares no variable for is refused, never
|
|
160
|
+
dropped. Its output is read from the answer's `data`. A GraphQL vendor reports most failures inside a 200, so a 200
|
|
161
|
+
carrying `errors` FAILS the call: `REMOTE_ERROR`, or `UNKNOWN_OUTCOME` for a mutation that had begun executing (an
|
|
162
|
+
earlier part of it may have applied). Partial data is never returned. The vendor's messages are on
|
|
163
|
+
`error.detail.remoteErrorMessages` for your code to read; they are vendor prose that may quote what you sent, so the
|
|
164
|
+
engine keeps them out of its logs and the browser door does not relay them. Read
|
|
151
165
|
`references/framework-rest-operation-contract-api.md`. Then stop — or hand back to the task that needed
|
|
152
166
|
the call.
|
|
153
167
|
|