@wildo-ai/framework-knowledge 1.1.10 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +7 -5
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +628 -107
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +10 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +82 -15
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -5
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +4 -16
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +38 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +20 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +6 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +7 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +9 -7
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +9 -2
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +15 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +24 -9
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +98 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +39 -20
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +788 -49
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +115 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -5
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +153 -28
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +49 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +15 -5
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +216 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +21 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +28 -2
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
- package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +342 -76
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +47 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +127 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +28 -8
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +94 -13
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
- package/dist/knowledge/references/platform.config.saas.md +126 -32
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +105 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
- package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
- package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +280 -40
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +123 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +22 -4
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
- package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +303 -0
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +5250 -2565
- package/dist/knowledge/registries/playbooks.json +88 -55
- package/dist/knowledge/registries/source-tags.json +9347 -4807
- package/dist/knowledge/rules/database-migration-obligation.md +10 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +62 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +26 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +37 -1
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +168 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +66 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +166 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +21 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -10
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +10 -2
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +93 -13
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +140 -7
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +7 -5
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +13 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +72 -8
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +165 -44
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +200 -61
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +8 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +21 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +46 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +4 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +219 -77
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +223 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +138 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +30 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +186 -83
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +113 -70
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +41 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +15 -4
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17998 -8568
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: resource-external-data
|
|
3
|
-
description: Bring data that lives in another system — an enterprise Odoo, an SAP OData service, a REST API — into the application, either as a read-through virtual resource or as a synced pipeline into an ordinary local resource. Use when the user says "read our customers from Odoo", "sync suppliers from SAP", "connect to our ERP", "pull data from an external API", "mirror the CRM contacts", "our products live in another system", "show data we do not own", "keep a local copy of the supplier list", or asks whether an integration should copy data or read it live. Also when a row must be created, updated or deleted in that system from the application ("create the partner in Odoo", "write back to our ERP"), or when records the application creates must be sent to it ("send our new leads to Odoo", "push the requests we capture into the ERP").
|
|
3
|
+
description: Bring data that lives in another system — an enterprise Odoo, an SAP OData service, a REST API — into the application, either as a read-through virtual resource or as a synced pipeline into an ordinary local resource. Use when the user says "read our customers from Odoo", "sync suppliers from SAP", "connect to our ERP", "pull data from an external API", "mirror the CRM contacts", "our products live in another system", "show data we do not own", "keep a local copy of the supplier list", or asks whether an integration should copy data or read it live. Also when a row must be created, updated or deleted in that system from the application ("create the partner in Odoo", "write back to our ERP"), or when records the application creates must be sent to it ("send our new leads to Odoo", "push the requests we capture into the ERP"), or edited on both sides ("sync both ways", "two-way sync with Odoo").
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -56,10 +56,10 @@ run.
|
|
|
56
56
|
|
|
57
57
|
- **The application owns the data** — that is an ordinary resource; use `resource-add-resource`.
|
|
58
58
|
- **You are adding a provider or credential**, not consuming data — that is provider configuration.
|
|
59
|
-
- **
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
59
|
+
- **Two pipelines over one resource.** Never declare an INBOUND and an OUTBOUND pipeline on the same
|
|
60
|
+
destination to get a two-way sync: each would overwrite the other's changes unseen. When the same rows
|
|
61
|
+
are edited on both sides, that is ONE `direction: BIDIRECTIONAL` pipeline (see "When both sides edit
|
|
62
|
+
the records" below).
|
|
63
63
|
|
|
64
64
|
## Workflow
|
|
65
65
|
|
|
@@ -102,6 +102,12 @@ does. The facet decides four things you therefore do not:
|
|
|
102
102
|
unfinished: nothing about a vendor can be guessed from its name, so an engine that accepted one would
|
|
103
103
|
be inventing a dialect and an auth scheme.
|
|
104
104
|
|
|
105
|
+
**On a developer machine the instance is the simulator fleet.** Once the instance is declared, run
|
|
106
|
+
`wildo local sor-addresses --write`, then `wildo local sor-secrets`, then `wildo local sor-simulators`. Ports, addresses and
|
|
107
|
+
test secrets are derived, never written by hand, and the records served come from
|
|
108
|
+
`system-of-record-simulators/fleet.dataset.ts` (`--scaffold-dataset` starts one). Read
|
|
109
|
+
`references/local-test-doubles.md`.
|
|
110
|
+
|
|
105
111
|
#### Choosing: a named vendor, or the generic `odata`
|
|
106
112
|
|
|
107
113
|
The library describes **seven** vendors — `odoo`, `microsoft-dataverse`,
|
|
@@ -111,12 +117,25 @@ The library describes **seven** vendors — `odoo`, `microsoft-dataverse`,
|
|
|
111
117
|
- **Your vendor is named** → use it. You get its real paging behaviour, its real credential kinds and
|
|
112
118
|
its partition field, all with the vendor's own documentation cited.
|
|
113
119
|
- **Your system speaks OData v4 and is not named** → use `odata`. A vendor-neutral facet: OData v4,
|
|
114
|
-
|
|
115
|
-
block carries the service root.
|
|
120
|
+
five credential kinds (a bearer key, HTTP Basic, the two OAuth client-credentials kinds, a client
|
|
121
|
+
certificate), conformant paging, no partition. The instance's address block carries the service root.
|
|
116
122
|
- **Neither** → the vendor has no facet, and that is the answer. Do not reach for `odata` because it
|
|
117
123
|
is the only one that parses: if the system is not OData v4, `odata` will fail at the first read,
|
|
118
124
|
further from the cause.
|
|
119
125
|
|
|
126
|
+
**A number an OData service serves that no number field can hold is never rounded.** OData v4 JSON
|
|
127
|
+
serves NaN and the infinities as the STRINGS `"INF"`, `"-INF"` and `"NaN"`. In a field your resource
|
|
128
|
+
declares as a number, a read-through refuses the read and names the property, because it cannot refuse
|
|
129
|
+
one record of a page. A pipeline rejects just that record and loads the rest. The same word in a text
|
|
130
|
+
field is only a word. A 64-bit integer or an exact decimal is asked for as a string
|
|
131
|
+
(`IEEE754Compatible=true`), so it arrives whole: in a number field, a value a number holds exactly
|
|
132
|
+
becomes that number, and one no number can hold (an integer past 2^53 − 1, a decimal of more than 15
|
|
133
|
+
significant digits) is refused in a read-through and rejected as one record in a pipeline. It is never
|
|
134
|
+
rounded. A pipeline applies the same rule to a number served as TEXT by any source, REST and Odoo
|
|
135
|
+
included: map the field to a string to keep such values. A declared action's answer is read the same
|
|
136
|
+
way against its `output` schema. A service that ignores the request and still sends JSON numbers cannot
|
|
137
|
+
be detected after parsing. For v2, which has more such values, see `references/odata-v2-sources.md`.
|
|
138
|
+
|
|
120
139
|
Two naming traps, both real: the Microsoft Web API is known under three provider
|
|
121
140
|
ids, and only **`microsoft-dataverse`** has a facet — `microsoft-dynamics-365` and
|
|
122
141
|
`microsoft-dynamics-crm` do not, and naming one is refused. And the SAP facet is **`sap-s4hana`**,
|
|
@@ -124,10 +143,15 @@ not `sap-s4hana-cloud`.
|
|
|
124
143
|
|
|
125
144
|
#### What each facet admits it cannot do
|
|
126
145
|
|
|
127
|
-
Read this BEFORE you meet it as a refusal, or you will file a bug against a limit that is declared
|
|
146
|
+
Read this BEFORE you meet it as a refusal, or you will file a bug against a limit that is declared. When your
|
|
147
|
+
application must DECIDE something from one of these limits (open onboarding writes or not, advertise sort keys or
|
|
148
|
+
not, pick an incremental mode), ask the engine rather than restating the list: see
|
|
149
|
+
`references/framework-system-of-record-capabilities-api.md`.
|
|
128
150
|
|
|
129
|
-
- **`sap-s4hana` — HTTP Basic
|
|
130
|
-
|
|
151
|
+
- **`sap-s4hana` — HTTP Basic or a client certificate.** Its communication user takes either, so the
|
|
152
|
+
instance must name the one it uses (`credential: { kind: SystemOfRecordCredentialKind.BASIC }` or
|
|
153
|
+
`MTLS_CLIENT_CERTIFICATE`); naming neither is refused at boot. A client certificate is presented in
|
|
154
|
+
the TLS handshake and needs an `https:` base URL.
|
|
131
155
|
- **`sap-s4hana` — OData v4 AND v2, one instance per service root.** SAP's most-used API
|
|
132
156
|
(`API_BUSINESS_PARTNER`, `/sap/opu/odata/sap/…`) is **v2**; declare `dialect: ODATA_V2` on the instance
|
|
133
157
|
AND the binding for it, and `ODATA` for a v4 root (`/sap/opu/odata4/…`). A system reached over both is
|
|
@@ -157,6 +181,10 @@ them:
|
|
|
157
181
|
|
|
158
182
|
- **`keyFields` order is the encoding order.** It is committed. Changing it later re-keys every row
|
|
159
183
|
identity, so decide it once and deliberately.
|
|
184
|
+
Declare each key field as the codec projects it — a number for an INTEGER key, a string or a date for a
|
|
185
|
+
DATETIME_ISO key, a string otherwise —
|
|
186
|
+
and `_id` as a plain string (it holds the synthesized id). A schema that rejects that form is refused
|
|
187
|
+
when the resource is defined, not left to fail every read.
|
|
160
188
|
- **`system`** — the declared instance the rows live in, by name. Not a provider: the instance is
|
|
161
189
|
declared under `systemsOfRecord` in `wildo.saas.config.ts`, and its address and credential come from
|
|
162
190
|
the environment under names derived from that name. A name the application does not declare is
|
|
@@ -164,18 +192,50 @@ them:
|
|
|
164
192
|
- **You do not declare tenancy.** Rows read out of a system of record are stamped with the
|
|
165
193
|
organization that owns the application, so the engine's per-row gate decides — nothing about your
|
|
166
194
|
tenants is pushed to a remote that has never heard of them.
|
|
167
|
-
- **`
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
195
|
+
- **`subjectRights`** — who answers data-subject requests about these rows. **Leave it out**, and the
|
|
196
|
+
system of record does: it decides what happens to its records' personal data and answers the people
|
|
197
|
+
they concern, under its own rules, and the application follows it (`HANDLED_AT_SOURCE`). An erasure
|
|
198
|
+
in the application then reports the resource as handled at the source, names the system, and never
|
|
199
|
+
stops for want of anything. That is the default because a system of record backs internal tools and
|
|
200
|
+
carries its own GDPR obligations; the application owns only what it keeps beyond or apart from the
|
|
201
|
+
source. Two other answers exist:
|
|
202
|
+
- `NO_SUBJECT_DATA` — the rows hold nothing about a person. CHECKED at startup: it is refused when
|
|
203
|
+
any field the system holds declares `.dataCategories()` (every field of a read-through resource;
|
|
204
|
+
the mapped fields of a pipeline, whichever way they travel). Settle it by fact: GDPR Recital 14's
|
|
205
|
+
exclusion covers only LEGAL persons, a record's "company" flag does not establish one (a sole trader
|
|
206
|
+
may be recorded as a company), and a named person's address on a company record is personal data.
|
|
207
|
+
A company's own name and number are personal data only where the company is a sole trader:
|
|
208
|
+
declare them with `{ personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON }`,
|
|
209
|
+
and the notice words them conditionally. They still count here, because some rows are a person's;
|
|
210
|
+
- `FORWARDED_TO_SOURCE` (read-through only) — besides the source's own handling, each erasure is
|
|
211
|
+
forwarded to the system through a declared operation, best effort: it never blocks the local
|
|
212
|
+
erasure, and a forward that fails still reports the resource as handled at the source, with the
|
|
213
|
+
failed steps listed (re-running the erasure retries them). Refused on a pipeline, which sends no delete.
|
|
214
|
+
- `OWNED_COPY` (inbound pipelines only) — the application keeps this copy BEYOND its source, so its
|
|
215
|
+
own erasure applies to it: the local rows are scrubbed or deleted as the resource's retention says,
|
|
216
|
+
and a suppression keeps the next pass from loading the person back. REQUIRED when the copy holds
|
|
217
|
+
something the source does not: a field about a person that callers write and no mapping fills (an
|
|
218
|
+
internal note on a client). The startup check refuses such a copy under any other posture.
|
|
219
|
+
|
|
220
|
+
Every other pipeline copy FOLLOWS its system of record: an erasure leaves its rows to the source
|
|
221
|
+
(nothing scrubbed, nothing suppressed; the receipt says the system answers for them), and the copy
|
|
222
|
+
removes what the source removes through its orphan policy, which must then be `DELETE` or
|
|
223
|
+
`IMPERSONALIZE` if it copies personal data. An outbound or two-way pipeline may send personal data:
|
|
224
|
+
the system receiving it answers requests about what it holds. Outbound rows are the application's
|
|
225
|
+
own and are erased as their resource declares; a two-way copy follows its source, and may not let
|
|
226
|
+
callers write personal data on rows born locally (`population: OPEN`).
|
|
227
|
+
|
|
228
|
+
One declaration is optional and belongs beside `subjectRights` whenever the rows hold personal data:
|
|
176
229
|
**`purposeRefs`**, the `purposeRef`s of `operatorComplianceIdentity.lawfulBases` this data is read for.
|
|
177
230
|
See "Which purpose the data serves" below.
|
|
178
231
|
|
|
232
|
+
**An unset remote field reads as unset.** A vendor spells "no value" its own way — OData and the REST
|
|
233
|
+
vendors send `null`, Odoo sends `false` for every unset field that is not a boolean — and the read-through
|
|
234
|
+
projects it as what YOUR field accepts: `null` for a `.nullable()` field, left out for an `.optional()` one,
|
|
235
|
+
and a real `false` kept for a field that accepts booleans. So declare every field some rows leave empty as
|
|
236
|
+
`.optional()` (or `.nullable()`), exactly as you would for a pipeline. A REQUIRED field the vendor serves
|
|
237
|
+
empty still fails the read, naming the field: that is the declaration and the ERP disagreeing, not noise.
|
|
238
|
+
|
|
179
239
|
**Writing rows back** — creating, updating or deleting ONE row of the remote system — is opened by
|
|
180
240
|
`writableVerbs` on the binding and performed by ordinary `CREATE` / `UPDATE` / `DELETE` operations.
|
|
181
241
|
Read `references/read-through-writes.md` before you open one: it owns the whole contract, and four
|
|
@@ -186,7 +246,7 @@ parts of it are not guessable —
|
|
|
186
246
|
`SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`, which a client must not answer by resending;
|
|
187
247
|
- no bulk write, no nested child writes, no queued write, no write inside a transaction;
|
|
188
248
|
- whether your dialect can write at all is the engine's — a binding opening a verb its dialect cannot
|
|
189
|
-
send is refused at startup, naming the dialect. Odoo (`ODOO_JSONRPC`), OData v4 (`ODATA`) and
|
|
249
|
+
send is refused at startup, naming the dialect. Odoo (`ODOO_JSONRPC` and `ODOO_JSON2`), OData v4 (`ODATA`) and
|
|
190
250
|
REST_JSON write; OData v2 (`ODATA_V2`) reads only, and SAP S/4HANA does not write (its CSRF-token
|
|
191
251
|
handshake is not performed). A REST_JSON
|
|
192
252
|
binding DECLARES each write it opens — `operations.create` / `update` / `delete`, a method and a
|
|
@@ -215,16 +275,30 @@ The four decisions that matter:
|
|
|
215
275
|
|
|
216
276
|
1. **`remoteKeyLocalField`** — a `.isBusinessKey()` STRING field holding the remote row's identity.
|
|
217
277
|
The sync merges on it, which is what makes re-running safe. (An OUTBOUND pipeline reverses this and
|
|
218
|
-
the next rule — see "When the application is the source".)
|
|
278
|
+
the next rule — see "When the application is the source".) Keep it a plain string: it stores the id
|
|
279
|
+
the key codec synthesizes (`"42"` for an INTEGER key), so a `z.uuid()` or a `.regex()` on it is refused
|
|
280
|
+
at startup when it would reject that form.
|
|
219
281
|
2. **`mapping`** — remote field → local field, plus constants for local fields with no remote source,
|
|
220
282
|
and DECLARED EXPRESSIONS for a value derived from remote fields (see "When a local value is derived"
|
|
221
283
|
below). It must NOT name your tenant field; see the next section.
|
|
222
284
|
3. **`population`** — `CLOSED` (every row comes from the pipeline; caller CREATE is refused) or
|
|
223
285
|
`OPEN` (users may also mint their own rows beside the synced ones).
|
|
224
286
|
4. **`orphanPolicy`** — what happens to a local row whose remote original disappeared: `DELETE`,
|
|
225
|
-
`DEPRECATE` or `
|
|
226
|
-
the whole pass. An unreadable identity skips reconciliation for every policy. `OPEN`
|
|
227
|
-
|
|
287
|
+
`DEPRECATE`, `REPORT` (the default) or `IMPERSONALIZE`. The final execution compares against all accepted source
|
|
288
|
+
keys from the whole pass. An unreadable identity skips reconciliation for every policy. An `OPEN` population runs
|
|
289
|
+
its declared policy too: only rows the pipeline loaded (or adopted) are ever orphan candidates, never a row a caller
|
|
290
|
+
created. A copy that FOLLOWS its system of record and copies personal data MUST declare `DELETE` or `IMPERSONALIZE`
|
|
291
|
+
— startup refuses `REPORT`, `DEPRECATE` or the default there, because the copy would keep a record the source
|
|
292
|
+
deleted. `DELETE` removes the row through its parent-delete lifecycle: rows on its `onParentDelete` edges are
|
|
293
|
+
deleted or scrubbed as each edge declares, and a `REFUSE_WHILE_CHILDREN_EXIST` edge keeps the orphan (the pass
|
|
294
|
+
reports it and retries).
|
|
295
|
+
`IMPERSONALIZE` is the one to choose when the copy holds personal data and other rows reference it: the
|
|
296
|
+
orphan's `.impersonalizeWith()` fields are scrubbed and the row is kept, hidden and immutable, so a record
|
|
297
|
+
erased at the source leaves your copy nothing about the person while the work that points at it survives.
|
|
298
|
+
It needs the destination to declare `retentionPolicy: { mode: RETAIN_AND_IMPERSONALIZE }` (refused at startup
|
|
299
|
+
otherwise), and on a following copy `.impersonalizeWith()` on every copied personal field, or that field would
|
|
300
|
+
survive the scrub. No erasure suppression is written, so a record the source restores under the same key loads
|
|
301
|
+
again as a new row. A legal hold suspends the scrub. An archived Odoo record is never an orphan.
|
|
228
302
|
|
|
229
303
|
### The destination's tenant is ENGINE-SUPPLIED, and the shape is not negotiable
|
|
230
304
|
|
|
@@ -268,6 +342,17 @@ last batch. Failed loads retain the previous checkpoint for retry. Identifiable
|
|
|
268
342
|
remain protected; an unreadable source identity skips orphan reconciliation for the pass,
|
|
269
343
|
including `REPORT`. Check `reconciliationStatus` as well as `loadStatus`.
|
|
270
344
|
|
|
345
|
+
A record whose value its local field cannot be stored as is a **rejected row**, not a failed run.
|
|
346
|
+
Examples: a non-numeric string mapped onto a `z.number()` field; onto a `z.date()`, anything but an
|
|
347
|
+
ISO date the calendar has (`2026-02-30` is refused, never stored as 2 March); onto a `z.boolean()`,
|
|
348
|
+
anything but a boolean, the numbers `1`/`0` or the words `true`/`false`/`1`/`0`/`yes`/`no`; onto a
|
|
349
|
+
`z.string()`, an array or an object (an Odoo many2one mapped as a plain field). The rejection names
|
|
350
|
+
the field, never the value, and the rest of the pass loads. Each kind accepts a defined set, the same
|
|
351
|
+
on MongoDB and PostgreSQL, so spellings both stores happen to read but no source serves (a hex
|
|
352
|
+
number, a lower-case ISO date) are refused too. A date or time served without an offset is stored as
|
|
353
|
+
UTC, and a fraction of a second is kept to milliseconds. Fix a rejection with a
|
|
354
|
+
coercion in the mapping, or map the field as a string, or leave it out.
|
|
355
|
+
|
|
271
356
|
Manual and scheduled runs share exclusive ownership per application and pipeline, including
|
|
272
357
|
across backend instances. A competing trigger reports `already-running` before reading the
|
|
273
358
|
pipeline checkpoint. Ownership covers destination writes, run state, membership history and
|
|
@@ -317,9 +402,21 @@ A package discovery does not walk by name (another scope's, or yours not named `
|
|
|
317
402
|
listed in `providers.packages`, and your backend package
|
|
318
403
|
must depend on it. Only a FIELD partition can be confined. Read `references/facet-augmentations.md`.
|
|
319
404
|
|
|
320
|
-
**
|
|
321
|
-
|
|
322
|
-
|
|
405
|
+
**Assign every partition to a unit, or its rows never load.** A partition no unit holds is
|
|
406
|
+
refused by the copy-in pipeline ("remote partition is assigned to no organization unit") and
|
|
407
|
+
read by nobody through a read-through. Declare the assignment of each partition you know in the
|
|
408
|
+
organization identity declaration (`systemOfRecordPartitions`, one `{ system, remoteKey, unitKey }`
|
|
409
|
+
per partition), so every environment assigns them at its first boot; startup refuses a binding to an
|
|
410
|
+
instance that is not partitioned. An operator assigns a partition the declaration does not name, and
|
|
411
|
+
moves one, through `systemOfRecordPartitionAssignments`. Read `references/partition-from-the-domain-plan.md`,
|
|
412
|
+
and the `authorization-unit-narrowing` skill for the declaration and for what an assignment means to a caller.
|
|
413
|
+
|
|
414
|
+
**When the domain plan decided it.** A record location in the domain plan carries `partition`
|
|
415
|
+
(`NOT_SPLIT`, `BY_LEGAL_ENTITY`, `CANNOT_BE_SPLIT`, `UNCONFIRMED`), and the binding task names
|
|
416
|
+
`partitioned`. The plan decides only whether the records are split; the field they split on comes from
|
|
417
|
+
the vendor's effective facet (a facet augmentation an instance opts into included), never from the plan's author. The task partitions the instance exactly as
|
|
418
|
+
`partitioned` says, and its landing check holds it to the instance's flag, a copy's partition stamp,
|
|
419
|
+
and the vendor's ability to split. Read `references/partition-from-the-domain-plan.md`.
|
|
323
420
|
|
|
324
421
|
### What each lane owes
|
|
325
422
|
|
|
@@ -339,18 +436,27 @@ partitionKeyLocalField: 'odooCompanyRef',
|
|
|
339
436
|
```
|
|
340
437
|
|
|
341
438
|
Both must exist on the destination schema, be STRINGS, be optional or nullable,
|
|
342
|
-
and be `.excludeFromCreate().excludeFromUpdate()`.
|
|
439
|
+
and be `.excludeFromCreate().excludeFromUpdate()`. Keep the key column a plain
|
|
440
|
+
string: it holds the partition key as text (`"1"` for an Odoo company id, a
|
|
441
|
+
lowercased GUID), and a format, pattern or length rule that rejects that form is
|
|
442
|
+
refused at startup (not checked for a STRING partition codec, whose values vary). Nothing may map onto either —
|
|
343
443
|
the engine stamps them after your mapping, so a mapping entry would be inert.
|
|
344
444
|
Declaring one without the other is refused, and so is declaring them against an
|
|
345
445
|
unpartitioned source.
|
|
346
446
|
|
|
347
447
|
**Why two columns and not one.** The unit is what confines a caller. The remote
|
|
348
|
-
key
|
|
349
|
-
|
|
350
|
-
nothing about it says
|
|
351
|
-
stored
|
|
352
|
-
|
|
353
|
-
|
|
448
|
+
key is the partition that unit was derived from, and the derivation changes: when
|
|
449
|
+
an operator reassigns or un-assigns a partition, a previously-loaded row still
|
|
450
|
+
carries a valid unit id, and nothing about it says which partition it belongs to.
|
|
451
|
+
The stored key does, and the engine reads it on every query: a caller sees only
|
|
452
|
+
rows whose key is assigned to a unit, or unset (shared). So the rows loaded before
|
|
453
|
+
a partition was un-assigned, which keep their old unit because nothing re-stamps a
|
|
454
|
+
row that is no longer loaded, are read by nobody — organization-wide callers
|
|
455
|
+
included — until the partition is assigned again, when they reappear unchanged.
|
|
456
|
+
|
|
457
|
+
The key column is not what protects those rows from your `orphanPolicy`. A run
|
|
458
|
+
still extracts them and counts them as present, as the next section says, so an
|
|
459
|
+
un-assignment never deletes or scrubs them.
|
|
354
460
|
|
|
355
461
|
### What a run does with an unmapped partition
|
|
356
462
|
|
|
@@ -384,6 +490,21 @@ DELETIONS); OData v2 and REST sources run full passes.
|
|
|
384
490
|
Read `references/incremental-extraction.md` before declaring it: the lookback, what re-reads the
|
|
385
491
|
source, and how to read a run.
|
|
386
492
|
|
|
493
|
+
## When the source announces what changed: requested keys
|
|
494
|
+
|
|
495
|
+
If the system of record can NOTIFY — an Odoo automated action posting on write, a Dataverse webhook — receive
|
|
496
|
+
the notification with an inbound handler (skill `inbound-channels`) and have it call
|
|
497
|
+
`ctx.pipelines.requestPipelineKeys(resourceType, remoteKeys)`. The pipeline then re-reads exactly those records
|
|
498
|
+
from the source and loads them through itself, within seconds. The handler never writes the pipeline's rows,
|
|
499
|
+
and nothing in the notification becomes a value: the source is asked, and its answer loads.
|
|
500
|
+
|
|
501
|
+
Nothing requested is dropped: the keys are recorded first, and every run of the pipeline — the scheduled one
|
|
502
|
+
included — re-reads waiting keys before its own pass; a run that ends with a request that arrived while it held the
|
|
503
|
+
pipeline asks for a keyed run itself. A keyed read the source refuses never stops the pass that follows it. A requested record the source no longer serves is reported `missing` and never deleted locally.
|
|
504
|
+
It supplements the schedule, never replaces it. An INBOUND or a BIDIRECTIONAL pipeline on Odoo (one key field) or
|
|
505
|
+
OData v4 takes requested keys; startup refuses a handler naming any other. On a BIDIRECTIONAL pipeline a re-read record
|
|
506
|
+
is decided exactly as a pass decides it, conflicts included. Read `references/requested-keys.md`.
|
|
507
|
+
|
|
387
508
|
## Rate budgets: two per call, and only a pipeline waits
|
|
388
509
|
|
|
389
510
|
Every remote call spends TWO local budgets and is sent only if both have room. The instance budget and a
|
|
@@ -434,9 +555,11 @@ Odoo's own list views — while a subject erasure searches archived records too.
|
|
|
434
555
|
|
|
435
556
|
## When a copied person is erased: the suppression list
|
|
436
557
|
|
|
437
|
-
|
|
438
|
-
remote record — a keyed hash, never the key — and every later pass, full or incremental,
|
|
439
|
-
under it and counts the skip as `suppressedRows`.
|
|
558
|
+
Only an `OWNED_COPY` is suppressed. An erasure that scrubs or deletes a row of an owned copy records a
|
|
559
|
+
SUPPRESSION of its remote record — a keyed hash, never the key — and every later pass, full or incremental,
|
|
560
|
+
loads nothing under it and counts the skip as `suppressedRows`. A copy that follows its system of record is
|
|
561
|
+
left to the source by an erasure, so nothing is suppressed: when the source erases the record, the copy's
|
|
562
|
+
orphan policy removes it. It is released only by a completed full pass over the
|
|
440
563
|
whole remote entity (no `sourceFilter`) that no longer sees the record. Read
|
|
441
564
|
`references/erasure-suppression.md`, including the one refusal: a changed `encryptionKey` stops runs.
|
|
442
565
|
|
|
@@ -499,9 +622,22 @@ now: a CREATE the first time (its answered key is written to `remoteKeyLocalFiel
|
|
|
499
622
|
The ownership rules reverse: the mapped fields are the application's and stay writable, the remote key is
|
|
500
623
|
an optional engine-written string. Only the owner organization's rows are ever sent, a local delete never
|
|
501
624
|
is, and an unknown-outcome CREATE waits for an operator rather than risk a duplicate. It needs
|
|
502
|
-
`writableVerbs` including `CREATE`, `LAST_WRITER_WINS`, `REMOTE_FIELD`/`REMOTE_REFERENCE` entries only
|
|
503
|
-
|
|
504
|
-
`references/outbound-pipelines.md`.
|
|
625
|
+
`writableVerbs` including `CREATE`, `LAST_WRITER_WINS`, and `REMOTE_FIELD`/`REMOTE_REFERENCE` entries only. It may
|
|
626
|
+
send personal data: the system of record answers requests about what it receives (leave `subjectRights` out), and
|
|
627
|
+
your local rows are erased as their resource declares. Read `references/outbound-pipelines.md`.
|
|
628
|
+
|
|
629
|
+
## When both sides edit the records: `direction: BIDIRECTIONAL`
|
|
630
|
+
|
|
631
|
+
When a record is edited in the application AND in the system of record, declare ONE pipeline with
|
|
632
|
+
`direction: ExternalDataPipelineDirection.BIDIRECTIONAL`.
|
|
633
|
+
- Each mapped field says who owns it (`owner`): `REMOTE` is loaded, `LOCAL` is sent, `BOTH` is loaded and sent.
|
|
634
|
+
- A run loads, then sends. Only a `BOTH` field changed on both sides since they last agreed is a conflict, and
|
|
635
|
+
`conflictPolicy` decides it: `REMOTE_WINS`, `LOCAL_WINS`, or `REFUSE_AND_REPORT` (the default). A refused row
|
|
636
|
+
waits, listed on every run, until an operator chooses a side through the admin door.
|
|
637
|
+
- The vendor must version its rows (Odoo `write_date`, an OData v4 entity tag). Startup refuses one that does
|
|
638
|
+
not, and `population` must be `OPEN`.
|
|
639
|
+
|
|
640
|
+
Read `references/bidirectional-pipelines.md`.
|
|
505
641
|
|
|
506
642
|
## Worked Example
|
|
507
643
|
|
|
@@ -596,12 +732,40 @@ export enum ExternalDataDestinationPopulation {
|
|
|
596
732
|
* seam's mapping is exhaustive and compile-forced, so a new member on either side reddens P-2).
|
|
597
733
|
*/
|
|
598
734
|
export enum ExternalDataOrphanPolicy {
|
|
599
|
-
/**
|
|
735
|
+
/**
|
|
736
|
+
* Hard-delete the orphan row through the row's declared parent-delete lifecycle (#2575): a legal hold on the row keeps
|
|
737
|
+
* it; a `REFUSE_WHILE_CHILDREN_EXIST` edge still naming it, or a held descendant, refuses the delete (reported, retried
|
|
738
|
+
* next pass); otherwise its file fields are released, every enabled `onParentDelete` edge runs as it declares (children
|
|
739
|
+
* deleted, scrubbed or deferred), and its RAG chunks and case corrections go with it. Not run: the resource's operation
|
|
740
|
+
* hooks. Opt-in, and one of the two answers a copy that follows its system of record and copies personal data must
|
|
741
|
+
* declare (#2560).
|
|
742
|
+
*/
|
|
600
743
|
DELETE = 'delete',
|
|
601
744
|
/** Mark the row deprecated and keep it; a re-appearing remote key REVIVES it (v3.1 §4). Opt-in. */
|
|
602
745
|
DEPRECATE = 'deprecate',
|
|
603
746
|
/** Touch nothing; surface the diff in the run ledger. The DEFAULT — least surprise. */
|
|
604
747
|
REPORT = 'report',
|
|
748
|
+
/**
|
|
749
|
+
* Erase the orphan's personal data in place and keep the row (#2117). A record ABSENT FROM A COMPLETE PASS leaves the
|
|
750
|
+
* copy nothing of what the system held about a person, while rows that reference the copy (the work done for a client)
|
|
751
|
+
* keep pointing at it.
|
|
752
|
+
*
|
|
753
|
+
* "Absent from a complete pass" is wider than "deleted at the source": a record that leaves the pipeline's filtered or
|
|
754
|
+
* permitted view (a source filter it no longer matches, a service account that lost the right to read it) is scrubbed
|
|
755
|
+
* the same way, and the scrub cannot be undone.
|
|
756
|
+
*
|
|
757
|
+
* The row goes through the same scrub chokepoint the erasure door uses (`impersonalizeRowsInPlace`): its
|
|
758
|
+
* `.impersonalizeWith()` fields are scrubbed, and it is marked RETAINED (hidden from ordinary reads, immutable). Unlike
|
|
759
|
+
* an erasure, NO erasure suppression is written: nobody asked for this record to be forgotten, it only stopped being
|
|
760
|
+
* listed. So a record the source lists again loads as a NEW row (the destination's remote-key unique index is
|
|
761
|
+
* retention-scoped, so the retained row does not block it), and rows that referenced the scrubbed copy keep pointing at
|
|
762
|
+
* the scrubbed copy, not at the new one. A legal hold suspends the scrub, as it suspends the DELETE.
|
|
763
|
+
*
|
|
764
|
+
* Requires the destination to opt into the scrub door (`retentionPolicy: RETAIN_AND_IMPERSONALIZE`) and a CLOSED
|
|
765
|
+
* population; the factory refuses it otherwise. An archived Odoo record is never an orphan (see
|
|
766
|
+
* `ExternalDataArchivedRecordTreatment`), so archiving a record does not scrub its copy. Opt-in.
|
|
767
|
+
*/
|
|
768
|
+
IMPERSONALIZE = 'impersonalize',
|
|
605
769
|
}
|
|
606
770
|
|
|
607
771
|
/**
|
|
@@ -768,11 +932,15 @@ export enum ExternalDataFieldCoercion {
|
|
|
768
932
|
NONE = 'none',
|
|
769
933
|
/**
|
|
770
934
|
* Odoo spells an ABSENT value as boolean `false` — a mapped string field would otherwise store
|
|
771
|
-
* literal `false`. Applied by DEFAULT for
|
|
935
|
+
* literal `false`. Applied by DEFAULT for Odoo sources (either dialect, #3391); declaring it on another dialect
|
|
772
936
|
* is refused (the name is Odoo's semantics, not a generic null-coalesce).
|
|
773
937
|
*/
|
|
774
938
|
ODOO_FALSE_AS_NULL = 'odoo-false-as-null',
|
|
775
|
-
/**
|
|
939
|
+
/**
|
|
940
|
+
* Parse a datetime string into a Date for a date-typed local field. RFC 3339 only: a full-date, or a date-time with
|
|
941
|
+
* seconds and its offset (`Z` or `±hh:mm`); a value with no offset names no instant and rejects the row. On an Odoo
|
|
942
|
+
* source, Odoo's own `'YYYY-MM-DD HH:MM:SS'` is read too, as the UTC instant Odoo means by it (#3485).
|
|
943
|
+
*/
|
|
776
944
|
ISO_STRING_TO_DATE = 'iso-string-to-date',
|
|
777
945
|
}
|
|
778
946
|
|
|
@@ -1025,6 +1193,21 @@ export const ExternalDataFieldMappingEntrySchema = z.discriminatedUnion('kind',
|
|
|
1025
1193
|
required: z.boolean().default(false),
|
|
1026
1194
|
/** Which side owns the field — BIDIRECTIONAL pipelines only (#1723). Absent = REMOTE. */
|
|
1027
1195
|
owner: z.enum(ExternalDataFieldOwner).optional(),
|
|
1196
|
+
/**
|
|
1197
|
+
* #2566 — the field's name in a WRITE member that spells it differently from the list the pipeline extracts through
|
|
1198
|
+
* (REST_JSON only). NetSuite's SuiteQL answers `companyname`, while its record service — which a create or an update
|
|
1199
|
+
* is sent to — names the same field `companyName`; sent under the list's name, the field is unknown there. Each key
|
|
1200
|
+
* names the field in that member; a member not named here uses `remoteField`. The same answer a read-through binding
|
|
1201
|
+
* gives in `fieldMappings[].remoteFieldByMember` (#2553).
|
|
1202
|
+
*
|
|
1203
|
+
* OUTBOUND pipelines only: nothing else sends a body (an INBOUND pipeline writes nothing, and a BIDIRECTIONAL one needs
|
|
1204
|
+
* a row-version read that only Odoo and OData serve). Refused on Odoo and OData, whose members share one wire shape,
|
|
1205
|
+
* and for a member the binding does not declare.
|
|
1206
|
+
*/
|
|
1207
|
+
remoteFieldByMember: z.strictObject({
|
|
1208
|
+
create: z.string().trim().min(1).optional(),
|
|
1209
|
+
update: z.string().trim().min(1).optional(),
|
|
1210
|
+
}).optional(),
|
|
1028
1211
|
}),
|
|
1029
1212
|
z.strictObject({
|
|
1030
1213
|
kind: z.literal(ExternalDataMappingEntryKind.CONSTANT),
|
|
@@ -1120,7 +1303,7 @@ export enum ExternalDataIncrementalExtractionMode {
|
|
|
1120
1303
|
* and the next incremental pass reads the whole source again. The run summary says it did.
|
|
1121
1304
|
*/
|
|
1122
1305
|
export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminatedUnion('mode', [
|
|
1123
|
-
z.
|
|
1306
|
+
z.strictObject({
|
|
1124
1307
|
mode: z.literal(ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE),
|
|
1125
1308
|
/**
|
|
1126
1309
|
* When FULL passes run (cron). The only deletion detector, so required. A full pass that takes
|
|
@@ -1145,7 +1328,7 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
|
|
|
1145
1328
|
* re-read by the next pass. Changing `modifiedAtRemoteField` starts the track over (the stored watermark
|
|
1146
1329
|
* names the property it was read on).
|
|
1147
1330
|
*/
|
|
1148
|
-
z.
|
|
1331
|
+
z.strictObject({
|
|
1149
1332
|
mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT),
|
|
1150
1333
|
fullPassCron: z.string().trim().min(1),
|
|
1151
1334
|
/** The entity's modified-at property (`Edm.DateTimeOffset`), by its REMOTE name. */
|
|
@@ -1162,18 +1345,26 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
|
|
|
1162
1345
|
*
|
|
1163
1346
|
* Refused at declaration: a `sourceFilter` (Dataverse refuses `$filter`, `$orderby`, `$expand` and `$top`
|
|
1164
1347
|
* with change tracking) and a composite key (a deleted entity names one id). A delta link the service no
|
|
1165
|
-
* longer honours
|
|
1166
|
-
*
|
|
1348
|
+
* longer honours resets the track and the same run falls back to a FULL pass; the run summary says so. "No longer
|
|
1349
|
+
* honours" is `410 Gone` or `404 Not Found` — the two answers the protocol lets a service give for an expired URL —
|
|
1350
|
+
* or one of the vendor's own error codes for an expired change position, declared by its system-of-record facet as
|
|
1351
|
+
* `odataExpiredChangePositionErrorCodes` (#2104 review F6). That pass finds most of what the expired link would have reported, not all of it: when it completes it
|
|
1352
|
+
* orphans every row it did not see, so a row deleted before the pass read its key is found, but one deleted after
|
|
1353
|
+
* both the pass read it and the old link's last read, and before the next incremental run opens a new link, is
|
|
1354
|
+
* found only by the next full pass.
|
|
1167
1355
|
* spec-cite: Microsoft Learn, "Use change tracking to synchronize data with external systems"
|
|
1168
1356
|
* (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/use-change-tracking-synchronize-data-external-systems),
|
|
1169
1357
|
* "Query options not supported in Change Tracking Web API request" — "System query options $filter,
|
|
1170
1358
|
* $orderby, $expand, and $top aren't supported when you use the Prefer: odata.track-changes header".
|
|
1171
1359
|
* spec-cite: OData Version 4.01 Part 1: Protocol §9.2.4 — "410 Gone indicates that the requested resource is
|
|
1172
1360
|
* no longer available. This can happen if a client has waited too long to follow a delta link".
|
|
1361
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §11.2 — "If a client subsequently requests the advertised resource and
|
|
1362
|
+
* the URL has expired, then the service SHOULD respond with 410 Gone. If this is not feasible, the service MUST respond
|
|
1363
|
+
* with 404 Not Found."
|
|
1173
1364
|
*
|
|
1174
1365
|
* No lookback: a delta link is the service's own position, not a clock.
|
|
1175
1366
|
*/
|
|
1176
|
-
z.
|
|
1367
|
+
z.strictObject({
|
|
1177
1368
|
mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK),
|
|
1178
1369
|
fullPassCron: z.string().trim().min(1),
|
|
1179
1370
|
}),
|
|
@@ -1182,20 +1373,23 @@ export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminate
|
|
|
1182
1373
|
export type ExternalDataIncrementalExtractionDeclaration = z.infer<typeof ExternalDataIncrementalExtractionDeclarationSchema>;
|
|
1183
1374
|
|
|
1184
1375
|
/**
|
|
1185
|
-
* The
|
|
1186
|
-
* its
|
|
1376
|
+
* The dialects each incremental mode is spoken over. A `Record` over the enum so a mode added without
|
|
1377
|
+
* its dialects is a compile error rather than a declaration the coherence check silently waves through.
|
|
1378
|
+
*
|
|
1379
|
+
* A LIST per mode since #3391: `write_date` is a column of Odoo's ORM, not of a wire, so it is read the same way
|
|
1380
|
+
* through `/jsonrpc` and through JSON-2 — one mode, two dialects. Kept in the order the dialects were added.
|
|
1187
1381
|
*/
|
|
1188
|
-
export const
|
|
1189
|
-
[ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: HttpApiTransportDialect.ODOO_JSONRPC,
|
|
1190
|
-
[ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: HttpApiTransportDialect.ODATA,
|
|
1191
|
-
[ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: HttpApiTransportDialect.ODATA,
|
|
1382
|
+
export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECTS: Readonly<Record<ExternalDataIncrementalExtractionMode, readonly HttpApiTransportDialect[]>> = {
|
|
1383
|
+
[ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: [HttpApiTransportDialect.ODOO_JSONRPC, HttpApiTransportDialect.ODOO_JSON2],
|
|
1384
|
+
[ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: [HttpApiTransportDialect.ODATA],
|
|
1385
|
+
[ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: [HttpApiTransportDialect.ODATA],
|
|
1192
1386
|
};
|
|
1193
1387
|
```
|
|
1194
1388
|
|
|
1195
1389
|
### Origin Package: `@wildo-ai/saas-models`
|
|
1196
1390
|
|
|
1197
1391
|
```typescript
|
|
1198
|
-
export const ExternalDataPipelineDeclarationSchema = z.
|
|
1392
|
+
export const ExternalDataPipelineDeclarationSchema = z.strictObject({
|
|
1199
1393
|
/**
|
|
1200
1394
|
* Which way rows travel — see {@link ExternalDataPipelineDirection}. `INBOUND` when omitted.
|
|
1201
1395
|
*
|
|
@@ -1210,7 +1404,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1210
1404
|
|
|
1211
1405
|
/**
|
|
1212
1406
|
* The source half — the SAME binding declaration the VIRTUAL mode uses (the system of record it
|
|
1213
|
-
* reads, entity, dialect, key fields + codecs, remote-call semantics,
|
|
1407
|
+
* reads, entity, dialect, key fields + codecs, remote-call semantics, subject-rights posture).
|
|
1214
1408
|
*
|
|
1215
1409
|
* Every source is a SYSTEM OF RECORD: a deployment the OPERATOR runs, read with the application's
|
|
1216
1410
|
* own service identity, with ONE owner organization. There is no per-tenant variant to confine
|
|
@@ -1245,9 +1439,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1245
1439
|
* On an OUTBOUND pipeline (#1690) it is empty until the row is first sent: the engine writes the key the system of
|
|
1246
1440
|
* record answers the create with, exactly once, and then updates the remote row it names. It must therefore accept
|
|
1247
1441
|
* absence, and it is still excluded from create and update — a caller that could write it could point a local row at
|
|
1248
|
-
* any remote record. It must be `.isUnique()` (global, sparse — the default)
|
|
1249
|
-
*
|
|
1250
|
-
*
|
|
1442
|
+
* any remote record. It must be `.isUnique()` (global, sparse — the default): one remote record, one local row,
|
|
1443
|
+
* enforced by the store on every path that writes the key, while the rows not yet sent stay outside the index on both
|
|
1444
|
+
* stores, whether their key is absent or null (#2582). Declare it `.optional()`, so "no key yet" has one
|
|
1445
|
+
* representation. No business key is required there: nothing upserts on it.
|
|
1251
1446
|
*/
|
|
1252
1447
|
remoteKeyLocalField: z.string().trim().min(1),
|
|
1253
1448
|
|
|
@@ -1268,13 +1463,20 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1268
1463
|
* subsidiary to their own company's rows. Declare the destination narrowable on this field.
|
|
1269
1464
|
*
|
|
1270
1465
|
* `partitionKeyLocalField` carries the REMOTE key verbatim — Odoo's `company_id`, NetSuite's
|
|
1271
|
-
* `subsidiary`. It
|
|
1272
|
-
*
|
|
1273
|
-
*
|
|
1274
|
-
*
|
|
1275
|
-
*
|
|
1276
|
-
*
|
|
1277
|
-
*
|
|
1466
|
+
* `subsidiary`. It is the FACT the unit was derived from: the unit is a function of this key and
|
|
1467
|
+
* the assignment map at load time, and the map changes. Keep only the unit and, once a partition
|
|
1468
|
+
* is reassigned or unassigned, nothing on the row says which partition it belongs to — the unit
|
|
1469
|
+
* id still resolves, and says nothing about the edge that produced it. With the key stored, a
|
|
1470
|
+
* row's partition is answered locally: shown to people, queryable, and READ ON EVERY CALLER'S QUERY
|
|
1471
|
+
* (#2479): a non-exempt caller — organization-wide included — sees only rows whose stored key is
|
|
1472
|
+
* assigned to a unit, or unset (shared). That is what keeps the rows loaded before a partition was
|
|
1473
|
+
* unassigned from being read through the unit they still carry: nothing re-stamps a row that is no
|
|
1474
|
+
* longer loaded, so the unit alone would keep confining them to the unit the operator withdrew.
|
|
1475
|
+
*
|
|
1476
|
+
* It is NOT what keeps an unassignment from becoming a mass delete, and no orphan walk reads it
|
|
1477
|
+
* (#2478). That guard is in the transform: a pipeline extracts every row, unassigned partitions
|
|
1478
|
+
* included, and a row whose partition has no unit is left out of the load while its business key
|
|
1479
|
+
* is counted as OBSERVED, so a complete pass never sees it as gone.
|
|
1278
1480
|
*
|
|
1279
1481
|
* Both are ENGINE-WRITTEN: the transform stamps them from the assignment map, so a mapping entry
|
|
1280
1482
|
* targeting either is refused, as is a caller write (the factory requires both
|
|
@@ -1358,6 +1560,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1358
1560
|
* It bounds extraction and load together: each page is loaded before the next is read (#1689), so a
|
|
1359
1561
|
* run finishes after the page it was working on, by at most one page's extraction and load.
|
|
1360
1562
|
*
|
|
1563
|
+
* A BIDIRECTIONAL run's two halves share it (#2107): the loading half starts no page after two thirds, and the sending
|
|
1564
|
+
* half runs until the whole deadline, so a long inbound pass never leaves the sending half no time (it keeps about the
|
|
1565
|
+
* last third). A keyed run, which sends nothing, reads to the whole deadline.
|
|
1566
|
+
*
|
|
1361
1567
|
* Fifteen minutes by default: well inside an hourly `scheduleCron`, and long enough that a pass of the
|
|
1362
1568
|
* default `maxRowsPerRun` completes at even a small binding ceiling. Six hours at most — a run that
|
|
1363
1569
|
* needs longer is a backfill, and resuming across runs is what the cursor is for.
|
|
@@ -1368,6 +1574,9 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1368
1574
|
|
|
1369
1575
|
## References
|
|
1370
1576
|
|
|
1577
|
+
- `references/local-test-doubles.md` — running the declared instances on a developer machine: the simulator fleet,
|
|
1578
|
+
the three `wildo local sor-*` commands, the application's port block, the dataset the faces serve, and where the
|
|
1579
|
+
fleet comes from (the `@wildo-ai/provider-simulators` devDependency, or a framework checkout).
|
|
1371
1580
|
- `references/framework-external-data-pipeline-api.md` — the pipeline declaration contract, its
|
|
1372
1581
|
authored vocabulary, and the coercions.
|
|
1373
1582
|
- `references/framework-http-api-binding-api.md` — the virtual-resource binding contract and its
|
|
@@ -1379,8 +1588,13 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1379
1588
|
- `references/odata-v2-sources.md` — reading an OData v2 service (`ODATA_V2`): declaring it, why the
|
|
1380
1589
|
engine reads the service's `$metadata`, the values it decodes and refuses, how a pipeline walks it by
|
|
1381
1590
|
key rather than by `__next`, and what it cannot do.
|
|
1591
|
+
- `references/framework-system-of-record-capabilities-api.md` — what the engine can do over a binding (sort, writes,
|
|
1592
|
+
partitions, incremental modes, actions), asked instead of restated per vendor.
|
|
1382
1593
|
- `references/system-of-record-actions.md` — running a declared ERP action (Odoo `action_post`, an
|
|
1383
1594
|
OData action): the declaration, who may run it on which record, its one HTTP door, and its codes.
|
|
1595
|
+
- `references/presenting-a-copy-and-a-read-through.md` — when one concept lives in BOTH lanes: one navigation
|
|
1596
|
+
entry, the copy as the list people choose from, the read-through below it for who may read the source system, and
|
|
1597
|
+
no card that shows the source system's key alone.
|
|
1384
1598
|
- `references/lane-selection.md` — the choice in Step 1 at more depth, including what each lane
|
|
1385
1599
|
gives up and the industry precedent.
|
|
1386
1600
|
- `references/pipeline-destination-schema.md` — the destination schema rules, and what each refusal
|
|
@@ -1389,20 +1603,26 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1389
1603
|
its mapping, read what each one last did (`cursor`, `loadStatus`) and its health, list its run
|
|
1390
1604
|
history with the rows each run refused (`GET …/runs`), and reset a pipeline whose run keeps
|
|
1391
1605
|
refusing its stored state (`POST …/reset`).
|
|
1606
|
+
- `references/requested-keys.md` — a system of record announcing which records changed: the inbound handler's
|
|
1607
|
+
`ctx.pipelines.requestPipelineKeys`, the keyed run, why a busy pipeline drops nothing, what it never deletes,
|
|
1608
|
+
and which pipelines can take it.
|
|
1392
1609
|
- `references/incremental-extraction.md` — reading only what changed: the two tracks, the Odoo
|
|
1393
1610
|
`write_date` watermark and its lookback, the fingerprint that re-reads the source, and why a
|
|
1394
1611
|
full-pass cadence is required.
|
|
1395
1612
|
- `references/rate-budgets-and-pacing.md` — the instance budget and the binding ceiling, how a
|
|
1396
1613
|
pipeline paces against them, `maxRunDurationMs`, how to size the numbers, and the measured load
|
|
1397
1614
|
throughput a pass costs the store.
|
|
1398
|
-
- `references/erasure-suppression.md` — why an erased
|
|
1399
|
-
when a suppression is released, and the key-rotation refusal.
|
|
1615
|
+
- `references/erasure-suppression.md` — why an erased row of an `OWNED_COPY` is not re-imported (a following copy
|
|
1616
|
+
writes no suppression), what a run counts, when a suppression is released, and the key-rotation refusal.
|
|
1400
1617
|
- `references/declared-expressions.md` — `ENUM_MAP`, `CONCATENATION`, `ARITHMETIC`, `CONDITIONAL`: a
|
|
1401
1618
|
local value derived from remote fields, what startup checks, why there is no transform function, and
|
|
1402
1619
|
how an expression edit reaches rows an incremental pass would not re-read.
|
|
1403
1620
|
- `references/remote-references.md` — `REMOTE_REFERENCE`: turning an Odoo many2one or an OData
|
|
1404
1621
|
navigation key into a real local foreign key, the pending set, `REJECT_ROW`, and the orphan-cascade
|
|
1405
1622
|
refusal.
|
|
1623
|
+
- `references/partition-from-the-domain-plan.md` — a system's split by legal entity as the domain plan
|
|
1624
|
+
records it: the four `partition` outcomes, why the field comes only from the facet, what a binding task
|
|
1625
|
+
with `partitioned: true` writes, and the three reasons its landing check holds it back.
|
|
1406
1626
|
- `references/facet-augmentations.md` — adding a partition or a credential kind to a vendor facet a
|
|
1407
1627
|
package does not own: the augmentation record, the per-instance `facetAugmentations` opt-in, and what
|
|
1408
1628
|
is refused at boot.
|
|
@@ -1412,6 +1632,9 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1412
1632
|
- `references/outbound-pipelines.md` — `direction: OUTBOUND`: sending the application's own rows to a
|
|
1413
1633
|
system of record — the declaration, the reversed field ownership, what each pass sends and never sends,
|
|
1414
1634
|
partition placement, the unknown-outcome create that waits for an operator, and what a pass reports.
|
|
1635
|
+
- `references/bidirectional-pipelines.md` — `direction: BIDIRECTIONAL`: one resource edited on both sides —
|
|
1636
|
+
field ownership, the vendor's row version, what a run loads and sends, the three conflict policies, the
|
|
1637
|
+
operator's door for a refused conflict, what is audited and reported, and the stated limits.
|
|
1415
1638
|
- `references/provenance-cue.md` — the "synced from ⟨instance⟩ · as of ⟨pass⟩" note on pipeline-written
|
|
1416
1639
|
fields: which fields carry it, what "as of" means, the read surface and instance label it needs, and
|
|
1417
1640
|
who may read it.
|
|
@@ -1419,7 +1642,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1419
1642
|
## Verification
|
|
1420
1643
|
|
|
1421
1644
|
- [ ] The resource declares exactly one lane, not both.
|
|
1422
|
-
- [ ] Virtual: `keyFields` order is deliberate; `system` names a declared instance; `
|
|
1645
|
+
- [ ] Virtual: `keyFields` order is deliberate; `system` names a declared instance; `subjectRights` is left out unless the rows hold no subject data or each erasure is forwarded.
|
|
1423
1646
|
- [ ] A binding whose rows hold personal data names `purposeRefs` that exist in
|
|
1424
1647
|
`operatorComplianceIdentity.lawfulBases`.
|
|
1425
1648
|
- [ ] An instance whose resources hold personal data declares `personalDataOrigin`.
|
|
@@ -1431,7 +1654,7 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1431
1654
|
custom operation named in `actions.<name>.operation`, borrowing `UPDATE`, with
|
|
1432
1655
|
`idempotencyKey: REQUIRED`, whose implementation calls `utils.systemOfRecordActions.run(...)`; no
|
|
1433
1656
|
code reaches the ERP any other way.
|
|
1434
|
-
- [ ] Either lane: a binding declaring `
|
|
1657
|
+
- [ ] Either lane: a binding declaring `subjectRights: NO_SUBJECT_DATA` brings no field that declares
|
|
1435
1658
|
`.dataCategories()` (read-through: any field; pipeline: any mapped field).
|
|
1436
1659
|
- [ ] Virtual writes: a field landing on the partition field is excluded from create and update.
|
|
1437
1660
|
- [ ] Virtual writes: the client handles `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` by reading the row,
|
|
@@ -1447,8 +1670,10 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1447
1670
|
`remoteCallSemantics.maxRequestsPerMinute` strictly below it, and `maxRunDurationMs` fits the
|
|
1448
1671
|
pipeline's `scheduleCron` interval.
|
|
1449
1672
|
- [ ] Pipeline: verify first and last batch keys remain present across a resumed pass; then remove a source row and verify the configured orphan policy. Check reconciliationStatus for skipped reconciliation and loadStatus for failed writes.
|
|
1450
|
-
- [ ]
|
|
1451
|
-
back as a live row and the run reports `suppressedRows: 1`.
|
|
1673
|
+
- [ ] `OWNED_COPY` pipeline holding personal data: erase one copied row, run a full pass, and confirm the
|
|
1674
|
+
row is not back as a live row and the run reports `suppressedRows: 1`.
|
|
1675
|
+
- [ ] Following copy holding personal data: remove its record at the source, run a full pass, and confirm the
|
|
1676
|
+
copy keeps none of the person's data (gone under `DELETE`, scrubbed under `IMPERSONALIZE`).
|
|
1452
1677
|
- [ ] REST_JSON pipeline source: the binding's `list` statement declares `keyset` on its single key
|
|
1453
1678
|
field; a SOQL one declares `cursorPath`, a SuiteQL one `pagingParams` with
|
|
1454
1679
|
`placement: 'query-string'`.
|
|
@@ -1461,11 +1686,19 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
1461
1686
|
code); each `CONCATENATION` targets a string field, each `ARITHMETIC` a number field, and a
|
|
1462
1687
|
currency conversion uses a declared `factor`.
|
|
1463
1688
|
- [ ] OUTBOUND pipeline: `writableVerbs` includes `CREATE`; the mapped fields are caller-writable;
|
|
1464
|
-
`remoteKeyLocalField` is an optional
|
|
1689
|
+
`remoteKeyLocalField` is an optional `.isUnique()` string excluded from create and update; no sent field declares
|
|
1465
1690
|
`.dataCategories()`; on a partitioned instance `partitionUnitLocalField` names the row's unit.
|
|
1466
1691
|
- [ ] OUTBOUND pipeline: create a row, run a pass, and confirm the row gained its remote key and the
|
|
1467
1692
|
record exists remotely; edit it, run again, and confirm exactly one update; a row of another
|
|
1468
1693
|
organization is never sent (`droppedOtherOrganization`).
|
|
1694
|
+
- [ ] BIDIRECTIONAL pipeline: every mapped entry that is not Odoo's-only declares `owner`; `population` is
|
|
1695
|
+
`OPEN`; the vendor facet declares `rowVersionField` (Odoo or OData v4); `conflictPolicy` is chosen on purpose.
|
|
1696
|
+
- [ ] BIDIRECTIONAL pipeline: edit a `BOTH` field on each side, run, and confirm the declared policy's outcome
|
|
1697
|
+
in the run's `conflicts` — and for `REFUSE_AND_REPORT`, that neither side's value moved.
|
|
1698
|
+
- [ ] A handler asking a pipeline to re-read (`requestPipelineKeys`) lists that resource in its
|
|
1699
|
+
`pipelineKeyRequests`, and the pipeline is INBOUND on Odoo or OData v4; the pipeline keeps its
|
|
1700
|
+
`scheduleCron`. Send a notification naming one changed record and confirm the run history shows a
|
|
1701
|
+
`keyed` run with `drainedRequestedKeys: 1` and only that row changed.
|
|
1469
1702
|
- [ ] The application starts. Every rule above is checked at startup, by name.
|
|
1470
1703
|
|
|
1471
1704
|
### Grep invariants
|
|
@@ -1495,6 +1728,12 @@ rg -n 'maxRequestsPerMinute' wildo.saas.config.ts shared-lib/src
|
|
|
1495
1728
|
# OUTBOUND pipelines — each mapped field must be caller-writable and its remote key an optional string.
|
|
1496
1729
|
rg -B2 -A12 'ExternalDataPipelineDirection.OUTBOUND' shared-lib/src --glob '*.resources-config.ts'
|
|
1497
1730
|
|
|
1731
|
+
# BIDIRECTIONAL pipelines — each owner declared, OPEN population, a conflict policy chosen on purpose.
|
|
1732
|
+
rg -B2 -A16 'ExternalDataPipelineDirection.BIDIRECTIONAL' shared-lib/src --glob '*.resources-config.ts'
|
|
1733
|
+
|
|
1734
|
+
# Requested keys — every handler calling requestPipelineKeys declares the resource in pipelineKeyRequests.
|
|
1735
|
+
rg -l 'requestPipelineKeys' backend-api/src/modules | xargs rg --files-without-match 'pipelineKeyRequests'
|
|
1736
|
+
|
|
1498
1737
|
# Bulk write operations on a virtual resource — refused; a remote bulk write has no atomicity.
|
|
1499
1738
|
rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOperation'
|
|
1500
1739
|
```
|
|
@@ -1503,6 +1742,8 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1503
1742
|
|
|
1504
1743
|
| Rationalization | Reality |
|
|
1505
1744
|
|---|---|
|
|
1745
|
+
| "The webhook body has the new values, so the handler can write them straight into the synced resource." | The synced fields are the pipeline's to write, and a notification body is not the system of record — it can be stale, partial, forged or replayed. Name the records with `ctx.pipelines.requestPipelineKeys`; the pipeline re-reads them from the source. |
|
|
1746
|
+
| "Notifications keep it fresh, so the schedule can go." | A vendor drops notifications, and a keyed read never finds a deletion. Keep `scheduleCron`: requested keys make a pipeline fresher, not complete. |
|
|
1506
1747
|
| "Virtual is cleaner — no copy to keep in sync." | Cleaner until the first requirement it cannot meet. A virtual resource can hold no files, feed no retrieval corpus, and carry no local column. Those are not edge cases; they are the second and third things most applications ask for. |
|
|
1507
1748
|
| "I'll mark the synced fields writable and let users fix bad data." | Then the next sync overwrites their edit and nobody knows why. Remote-authoritative fields are read-only *because* the remote system wins; if users must edit, that field belongs in the local half, not the mapping. |
|
|
1508
1749
|
| "I'll sync everything from the remote entity, just in case." | Every mapped field is personal data you now store, retain and must erase. Map what the application uses. |
|
|
@@ -1527,7 +1768,9 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1527
1768
|
- `population: CLOSED` alongside a create-shaped custom operation — refused at startup, and the
|
|
1528
1769
|
message names the operation.
|
|
1529
1770
|
- A run reporting rejected rows after the source added a selection value — an `ENUM_MAP` that does not
|
|
1530
|
-
map it
|
|
1771
|
+
map it, or a plain mapping onto an enum field that now receives a value outside the field's members
|
|
1772
|
+
(such a row is rejected, never loaded with a value the field refuses); catch it with the
|
|
1773
|
+
declared-expressions grep above and map the code.
|
|
1531
1774
|
- Concurrent pipeline execution across application instances — single-instance execution is required until destination mutations have exclusive ownership. Checkpoint conflicts alone do not fence deletion.
|
|
1532
1775
|
- A binding whose `system` was copied from another resource without checking the instance is the one
|
|
1533
1776
|
you meant — two instances of one vendor differ only by that name.
|
|
@@ -1548,8 +1791,13 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1548
1791
|
(`suppressedRows` above zero is expected; never delete a suppression to "fix" it — that re-imports.)
|
|
1549
1792
|
- An OUTBOUND pipeline whose runs show `waiting.awaitingOperator` above zero — creates of unknown outcome that
|
|
1550
1793
|
nobody has answered and that are never sent again on their own; look each up in the system of record and answer
|
|
1551
|
-
it through `POST /internal/admin/external-data/outbound-changes/resolve`.
|
|
1552
|
-
|
|
1794
|
+
it through `POST /internal/admin/external-data/outbound-changes/resolve`. One whose `lastOutcomeCode` is
|
|
1795
|
+
`remote-key-held-by-another-row` first needs the wrong holder unlinked (`…/outbound-changes/unlink`; see
|
|
1796
|
+
`references/outbound-pipelines.md`). Catch the declarations with the OUTBOUND grep above.
|
|
1797
|
+
- A BIDIRECTIONAL pipeline whose runs keep reporting `conflicts.refused` above zero — rows edited on both
|
|
1798
|
+
sides that nobody has chosen a side for; they are neither loaded over nor sent until someone does, through
|
|
1799
|
+
`POST /internal/admin/external-data/outbound-changes/conflicts/resolve`. Catch the declarations with the
|
|
1800
|
+
BIDIRECTIONAL grep above.
|
|
1553
1801
|
- A `STANDALONE` primary-scope anchor on a virtual resource. It answers 403 `parent_scope_denied` to
|
|
1554
1802
|
an organization owner, because the execution context's organization id comes from the URL and a
|
|
1555
1803
|
standalone resource is not routed under its scope parent — measured, not inferred.
|
|
@@ -1560,3 +1808,5 @@ rg -l 'persistenceAdapter.*HTTP_API' shared-lib/src | xargs rg '_MANY|haveBulkOp
|
|
|
1560
1808
|
- `resource-schema-authoring` — the field declarations a destination schema needs.
|
|
1561
1809
|
- `resource-rag-source-fields` — indexing pipeline-fed text for retrieval (a pipeline lane only).
|
|
1562
1810
|
- `application-database-migrations` — a new destination resource on PostgreSQL owes a migration.
|
|
1811
|
+
- `inbound-channels` — receiving a system of record's change notification, and asking the pipeline to
|
|
1812
|
+
re-read the records it names (`ctx.pipelines`).
|