@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -39,22 +39,11 @@ export type ResourceConfiguration<
|
|
|
39
39
|
* 1. This field (if specified)
|
|
40
40
|
* 2. `appConfig.database.defaultAdapter` (fallback)
|
|
41
41
|
*
|
|
42
|
-
* A value disagreeing with the application default is
|
|
43
|
-
*
|
|
42
|
+
* A transactional value disagreeing with the application default is refused at registration:
|
|
43
|
+
* an application uses one transactional store (#3328).
|
|
44
44
|
*/
|
|
45
45
|
persistenceAdapter?: PersistenceAdapterType,
|
|
46
46
|
|
|
47
|
-
/**
|
|
48
|
-
* This resource's declared relationship to cross-adapter atomic write boundaries; see the
|
|
49
|
-
* authoring-side declaration and {@link ResourcePersistenceAdapterIsolation} for the full
|
|
50
|
-
* rationale.
|
|
51
|
-
*
|
|
52
|
-
* Carried through to the resolved config UNMATERIALISED (no default is substituted) because
|
|
53
|
-
* absence is semantically load-bearing here: the registry's admission asks whether the author
|
|
54
|
-
* MADE the claim, and a materialised default would answer that question for them.
|
|
55
|
-
*/
|
|
56
|
-
persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
|
|
57
|
-
|
|
58
47
|
/**
|
|
59
48
|
* The external HTTP-API binding — present exactly when `persistenceAdapter` is `HTTP_API`
|
|
60
49
|
* (factory-enforced both ways). See the authoring-side declaration for the full contract.
|
|
@@ -93,9 +82,9 @@ export type ResourceConfiguration<
|
|
|
93
82
|
|
|
94
83
|
/**
|
|
95
84
|
* Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
|
|
96
|
-
* evidence collector reads. Omitted ⇒ this resource is not that lane,
|
|
97
|
-
*
|
|
98
|
-
*
|
|
85
|
+
* evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
|
|
86
|
+
* but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
|
|
87
|
+
* evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
|
|
99
88
|
*/
|
|
100
89
|
subjectErasureLane?: ResourceSubjectErasureLane,
|
|
101
90
|
|
|
@@ -131,6 +120,9 @@ export type ResourceConfiguration<
|
|
|
131
120
|
/** Resolved retention-class binding, exactly as declared (undefined when the resource binds no class). */
|
|
132
121
|
retentionBinding?: ResourceRetentionBinding,
|
|
133
122
|
|
|
123
|
+
/** Resolved row-lifetime declaration, exactly as declared (undefined when the lifetime is derived). */
|
|
124
|
+
rowLifetime?: ResourceRowLifetimeDeclaration,
|
|
125
|
+
|
|
134
126
|
/** Resolved portability default (undefined when the resource declared no `portabilityPolicy` — an
|
|
135
127
|
* Art. 15 export is unaffected, an Art. 20 export refuses on any field that also lacks its own
|
|
136
128
|
* `.portabilityProvenance()`). */
|
|
@@ -139,6 +131,12 @@ export type ResourceConfiguration<
|
|
|
139
131
|
/** Resolved others'-data fields a subject export withholds (#2903); undefined when none are declared. */
|
|
140
132
|
subjectExportOthersDataFields?: readonly string[],
|
|
141
133
|
|
|
134
|
+
/** Resolved per-edge others'-data fields, keyed by the edge's foreign key; undefined when none are declared. */
|
|
135
|
+
subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
|
|
136
|
+
|
|
137
|
+
/** Resolved person columns a USER's access export reads (#2958); undefined when none are declared. */
|
|
138
|
+
subjectExportPersonColumns?: SubjectExportPersonColumns,
|
|
139
|
+
|
|
142
140
|
/** Resolved `workUnit` declaration (#1598): `true` when every row of this resource is a case. */
|
|
143
141
|
workUnit?: boolean,
|
|
144
142
|
|
|
@@ -67,8 +67,8 @@ export type ResourcesRegistry = {
|
|
|
67
67
|
organizationUnitNarrowing: Readonly<Partial<Record<ResourceType, OrganizationUnitNarrowingDeclaration>>>;
|
|
68
68
|
/**
|
|
69
69
|
* Resources confining the roles they declare to the rows their holder owns (#2547), keyed by resource type, validated at
|
|
70
|
-
* boot. A declared role's organization-wide grant reaches only the rows whose owner field names its holder
|
|
71
|
-
* role keeps its reach. Never an admission: the operation's roles still decide who may call it. Empty by default. See
|
|
70
|
+
* boot. A declared role's organization-wide grant reaches only the rows whose owner field names its holder, and the same
|
|
71
|
+
* role held on a unit supplies no unit (#3068); every other role keeps its reach. Never an admission: the operation's roles still decide who may call it. Empty by default. See
|
|
72
72
|
* `OrganizationOwnRowsDeclaration`.
|
|
73
73
|
*/
|
|
74
74
|
organizationOwnRows: Readonly<Partial<Record<ResourceType, OrganizationOwnRowsDeclaration>>>;
|
|
@@ -77,6 +77,15 @@ export interface ResourceRetentionPolicy {
|
|
|
77
77
|
* reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
|
|
78
78
|
* personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
|
|
79
79
|
* be the primary key or a retention marker: the build refuses each of those.
|
|
80
|
+
*
|
|
81
|
+
* ## Closing a retained record (#1841)
|
|
82
|
+
*
|
|
83
|
+
* A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
|
|
84
|
+
* field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
|
|
85
|
+
* subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
|
|
86
|
+
* `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
|
|
87
|
+
* The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
|
|
88
|
+
* period counted from the end of a contract or a matter; without it the build refuses that combination.
|
|
80
89
|
*/
|
|
81
90
|
retainedRowCompletion?: ResourceRetainedRowCompletion;
|
|
82
91
|
}
|
|
@@ -103,5 +112,17 @@ export interface ResourceStatutoryRetention {
|
|
|
103
112
|
* claim nobody can check.
|
|
104
113
|
*/
|
|
105
114
|
rationale: string;
|
|
115
|
+
/**
|
|
116
|
+
* WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
|
|
117
|
+
*
|
|
118
|
+
* The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
|
|
119
|
+
* `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
|
|
120
|
+
* arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
|
|
121
|
+
* after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
|
|
122
|
+
* Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
|
|
123
|
+
* are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
|
|
124
|
+
* with it (#1841).
|
|
125
|
+
*/
|
|
126
|
+
staysInUseBecause?: string;
|
|
106
127
|
}
|
|
107
128
|
```
|
|
@@ -70,26 +70,28 @@ export enum ResourceSystemAccessMode {
|
|
|
70
70
|
/**
|
|
71
71
|
* Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
|
|
72
72
|
*
|
|
73
|
-
* ##
|
|
73
|
+
* ## Who declares it, and why it is still a declaration
|
|
74
74
|
*
|
|
75
|
-
*
|
|
76
|
-
*
|
|
77
|
-
*
|
|
78
|
-
*
|
|
79
|
-
*
|
|
80
|
-
* that is one application's modelling choice"*.
|
|
75
|
+
* Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
|
|
76
|
+
* has, carries this declaration, and the evidence door refuses an application where a second resource
|
|
77
|
+
* declares one. An application does not declare its own. (Before #2296 the lane was an application's to
|
|
78
|
+
* build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
|
|
79
|
+
* first declarer and was harvested into the engine.)
|
|
81
80
|
*
|
|
82
|
-
*
|
|
83
|
-
*
|
|
84
|
-
*
|
|
85
|
-
* to
|
|
81
|
+
* It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
|
|
82
|
+
* and the collector read the lane through it and never through the engine's vocabulary: they count the
|
|
83
|
+
* field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
|
|
84
|
+
* them to), so their reading follows the resource and cannot drift from it. Before this existed, three
|
|
85
|
+
* clauses of that demand had a durable row holding every fact they wanted and no way to find it
|
|
86
|
+
* (#1209): not a missing control, a control nobody could point at.
|
|
86
87
|
*
|
|
87
88
|
* ## It binds FIELDS, never values the framework invents
|
|
88
89
|
*
|
|
89
|
-
* Every member below names something the
|
|
90
|
-
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is
|
|
91
|
-
*
|
|
92
|
-
*
|
|
90
|
+
* Every member below names something the declaring resource already has. The one value the
|
|
91
|
+
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
|
|
92
|
+
* resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
|
|
93
|
+
* reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
|
|
94
|
+
* never grow one.
|
|
93
95
|
*
|
|
94
96
|
* ## What is deliberately NOT declared
|
|
95
97
|
*
|
|
@@ -160,6 +162,21 @@ export type ResourceSubjectErasureLane = {
|
|
|
160
162
|
},
|
|
161
163
|
/** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
|
|
162
164
|
executionOperationIdentifier: string,
|
|
165
|
+
/**
|
|
166
|
+
* How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
|
|
167
|
+
* (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
|
|
168
|
+
* as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
|
|
169
|
+
*
|
|
170
|
+
* A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
|
|
171
|
+
* `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
|
|
172
|
+
* exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
|
|
173
|
+
*/
|
|
174
|
+
erasureMarker?: {
|
|
175
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
176
|
+
fieldName: string,
|
|
177
|
+
/** The value of that field meaning the row is an erasure request. */
|
|
178
|
+
erasureValue: string,
|
|
179
|
+
},
|
|
163
180
|
};
|
|
164
181
|
|
|
165
182
|
export type ResourceSystemAccessPolicy = {
|
|
@@ -110,16 +110,17 @@ export enum ResourceOperationFrontendSurface {
|
|
|
110
110
|
}
|
|
111
111
|
|
|
112
112
|
/**
|
|
113
|
-
* Display mode for resource operation action bars —
|
|
114
|
-
*
|
|
113
|
+
* Display mode for resource operation action bars — which surface the actions are drawn on, and so how many stay in
|
|
114
|
+
* view. Every direct action shows its words by default (`DEFAULT_ACTION_LABEL_DISPLAY_MODE`, #3066); the rest wait in
|
|
115
|
+
* the `…` menu, which shows words too.
|
|
115
116
|
*
|
|
116
117
|
* Note: "summary" here is about *UI density*, not API data shape (see DataMode.SUMMARY)
|
|
117
118
|
* or FK rendering (see ForeignKeyDisplayMode.SUMMARY).
|
|
118
119
|
*/
|
|
119
120
|
export enum ResourceOperationDisplayMode {
|
|
120
|
-
/** In a list/table row —
|
|
121
|
+
/** In a list/table row — one direct action beside the record's name (none on a phone), the rest in `…`. The row itself opens the record, so it offers no "View Details". */
|
|
121
122
|
SUMMARY = 'summary',
|
|
122
|
-
/** In a full read/detail view —
|
|
123
|
+
/** In a full read/detail view (the record header) — three direct actions (one on a phone), the rest in `…`. */
|
|
123
124
|
DETAIL = 'detail',
|
|
124
125
|
}
|
|
125
126
|
```
|
|
@@ -29,17 +29,28 @@
|
|
|
29
29
|
* - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
|
|
30
30
|
* organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
|
|
31
31
|
* ignored at startup with a warning, and the role grants nothing.
|
|
32
|
+
* - `seesOrganizationPeople` — `true` admits the role's holders to the organization's people: the member directory's
|
|
33
|
+
* SEARCH, the people picker behind every user reference (`/organizations/:organizationId/users/search`) and
|
|
34
|
+
* colleagues' names on records. Those three ask ONE question, the directory's SEARCH roles (`ORG_MEMBER` and up),
|
|
35
|
+
* and a role declaring this is counted among them, as is every role inheriting from it. Read only on a role whose
|
|
36
|
+
* `relatedPrimaryScope` is `ORGANIZATIONS`. Absent means refused: a role that does not inherit `ORG_MEMBER` (a field
|
|
37
|
+
* technician inheriting `ORG_GUEST`) sees nobody unless it declares this.
|
|
32
38
|
*
|
|
33
39
|
* Declaring a role is one of three steps. An organization role must also be listed in
|
|
34
40
|
* `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
|
|
35
41
|
* it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
|
|
36
|
-
* nothing). People receive it through the engine's members screen and invitations
|
|
42
|
+
* nothing). People receive it through the engine's members screen and invitations, from an owner or
|
|
43
|
+
* administrator whose role covers everything it confers: its `inheritFrom` chain, and every operation,
|
|
44
|
+
* approval or decision route, reference constraint, system-of-record action and agent or flow launch gate naming it
|
|
45
|
+
* (`resolveCustomRolesWithinAuthority`). Named alone where administrators are not admitted (an operation
|
|
46
|
+
* they cannot call, a decision route only it answers), it is grantable by the platform super-administrator only.
|
|
37
47
|
*/
|
|
38
48
|
export const RoleDefinitionSchema = z.object({
|
|
39
49
|
role: RolesSchema,
|
|
40
50
|
inheritFrom: RolesSchema.optional(),
|
|
41
51
|
isSystemRole: z.boolean().default(false),
|
|
42
52
|
relatedPrimaryScope : z.enum(ResourcePrimaryScope),
|
|
53
|
+
seesOrganizationPeople: z.boolean().optional(),
|
|
43
54
|
});
|
|
44
55
|
|
|
45
56
|
|
|
@@ -61,6 +61,12 @@ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
|
|
|
61
61
|
isSystemRole: true,
|
|
62
62
|
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
63
63
|
},
|
|
64
|
+
// No `inheritFrom`: handler-only, confers no operation; the signature notification handler only triggers a re-read (#2293).
|
|
65
|
+
[CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS]: {
|
|
66
|
+
role: CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS,
|
|
67
|
+
isSystemRole: true,
|
|
68
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
69
|
+
},
|
|
64
70
|
// No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
|
|
65
71
|
// inheriting anything would make a lent capability's reach a function of what that role grows into later.
|
|
66
72
|
[CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
|
|
@@ -40,6 +40,11 @@ export interface SchemaFamilyConfig<
|
|
|
40
40
|
* built. The client tells the variants apart by this field, and a response that withheld it from every variant
|
|
41
41
|
* could not be parsed by anyone. Remove the declaration; if the value really is sensitive, it cannot be the
|
|
42
42
|
* discriminator.
|
|
43
|
+
*
|
|
44
|
+
* A `.default(value)` on the base field means a record that leaves the discriminator out IS a `value` record: the
|
|
45
|
+
* family's union, and every create request derived from it, fill it in, so a client may omit the field exactly as
|
|
46
|
+
* the published schema says. An update never fills it: a partial update that leaves the discriminator out keeps the
|
|
47
|
+
* record's own variant.
|
|
43
48
|
*/
|
|
44
49
|
field: TDiscriminatorField;
|
|
45
50
|
/**
|
|
@@ -206,12 +211,22 @@ export function createSchemaFamily<
|
|
|
206
211
|
// Build discriminated union - use any to avoid Zod 4 type complexity
|
|
207
212
|
const allVariantSchemas: z.ZodObject<z.ZodRawShape>[] = [];
|
|
208
213
|
|
|
214
|
+
// The default the base field declares is what a record that omits the discriminator IS (#2076). Each union member's
|
|
215
|
+
// literal replaces the base field, so the member holding that value must carry the default itself, in the one shape a
|
|
216
|
+
// Zod 4 discriminated union can route an absent key by: see `withDeclaredFamilyDiscriminatorDefault`. Only the UNION
|
|
217
|
+
// members carry it; `variants` and `inheritenceSchemaDefinition` describe one variant each, where the literal names it.
|
|
218
|
+
const declaredDiscriminatorDefault = declaredFamilyDiscriminatorDefault(baseShape[discriminator.field]);
|
|
219
|
+
const unionMemberDiscriminator = (value: string) => withDeclaredFamilyDiscriminatorDefault(
|
|
220
|
+
discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues),
|
|
221
|
+
declaredDiscriminatorDefault,
|
|
222
|
+
);
|
|
223
|
+
|
|
209
224
|
// Add base schemas for baseValues
|
|
210
225
|
// Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals
|
|
211
226
|
for (const value of resolvedBaseValues || []) {
|
|
212
227
|
allVariantSchemas.push(
|
|
213
228
|
base.extend({
|
|
214
|
-
[discriminator.field]:
|
|
229
|
+
[discriminator.field]: unionMemberDiscriminator(value)
|
|
215
230
|
}) as z.ZodObject<z.ZodRawShape>
|
|
216
231
|
);
|
|
217
232
|
}
|
|
@@ -221,7 +236,7 @@ export function createSchemaFamily<
|
|
|
221
236
|
for (const [value, schema] of Object.entries(extendedVariants)) {
|
|
222
237
|
allVariantSchemas.push(
|
|
223
238
|
schema.extend({
|
|
224
|
-
[discriminator.field]:
|
|
239
|
+
[discriminator.field]: unionMemberDiscriminator(value)
|
|
225
240
|
}) as z.ZodObject<z.ZodRawShape>
|
|
226
241
|
);
|
|
227
242
|
}
|
|
@@ -25,8 +25,27 @@ export enum SystemOfRecordActionCallShape {
|
|
|
25
25
|
* argument, which is how Odoo addresses a recordset method such as `action_post`.
|
|
26
26
|
*
|
|
27
27
|
* spec-cite: Odoo 18.0 developer documentation, External API — "Calling methods" (the execute_kw argument layout).
|
|
28
|
+
*
|
|
29
|
+
* Spoken over `ODOO_JSONRPC` only: `execute_kw` is a function of the `object` service at `/jsonrpc`, which Odoo removes
|
|
30
|
+
* at Online 21.1 and Odoo 22. An instance on JSON-2 declares {@link ODOO_JSON2_METHOD} instead (#3391).
|
|
28
31
|
*/
|
|
29
32
|
ODOO_EXECUTE_KW = 'odoo-execute-kw',
|
|
33
|
+
/**
|
|
34
|
+
* Odoo's External JSON-2 API (#3391): `POST /json/2/<model>/<method>` with a body of NAMED parameters — any public
|
|
35
|
+
* model method, the same as `execute_kw`, with the credential in an `Authorization: bearer` header. A record-targeted
|
|
36
|
+
* call names the record ids in the body's `ids` member, which is how JSON-2 addresses a recordset method such as
|
|
37
|
+
* `action_post`.
|
|
38
|
+
*
|
|
39
|
+
* A shape of its own rather than `ODOO_EXECUTE_KW` reused, because the two place an input differently and only one of
|
|
40
|
+
* them can say where: JSON-2 has no positional arguments, so an input that `execute_kw` passed by POSITION (`create`'s
|
|
41
|
+
* `vals`) must be given the parameter's NAME (`vals_list`), and `execute_kw` has no such field to carry it.
|
|
42
|
+
*
|
|
43
|
+
* spec-cite: Odoo 19.0 developer documentation, External JSON-2 API
|
|
44
|
+
* (https://www.odoo.com/documentation/19.0/developer/reference/external_api.html), "Request" — the body members `ids`
|
|
45
|
+
* ("An array of record ids on which to execute the method. Empty or omitted when calling an @api.model-decorated
|
|
46
|
+
* method."), `context`, and `param` ("As many time as needed, the method's parameters.").
|
|
47
|
+
*/
|
|
48
|
+
ODOO_JSON2_METHOD = 'odoo-json2-method',
|
|
30
49
|
/**
|
|
31
50
|
* An OData v4 BOUND action: `POST <EntitySet>(<key>)/<Namespace>.<Action>`, parameters in the JSON body.
|
|
32
51
|
*
|
|
@@ -47,6 +66,7 @@ export enum SystemOfRecordActionCallShape {
|
|
|
47
66
|
*/
|
|
48
67
|
export const SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT: Readonly<Record<SystemOfRecordActionCallShape, HttpApiTransportDialect>> = Object.freeze({
|
|
49
68
|
[SystemOfRecordActionCallShape.ODOO_EXECUTE_KW]: HttpApiTransportDialect.ODOO_JSONRPC,
|
|
69
|
+
[SystemOfRecordActionCallShape.ODOO_JSON2_METHOD]: HttpApiTransportDialect.ODOO_JSON2,
|
|
50
70
|
[SystemOfRecordActionCallShape.ODATA_BOUND_ACTION]: HttpApiTransportDialect.ODATA,
|
|
51
71
|
[SystemOfRecordActionCallShape.ODATA_UNBOUND_ACTION]: HttpApiTransportDialect.ODATA,
|
|
52
72
|
});
|
|
@@ -76,6 +96,36 @@ export enum SystemOfRecordOdooActionInputPlacement {
|
|
|
76
96
|
NONE = 'none',
|
|
77
97
|
}
|
|
78
98
|
|
|
99
|
+
/**
|
|
100
|
+
* Where an Odoo JSON-2 action's validated input goes in the request body (#3391). The counterpart of
|
|
101
|
+
* {@link SystemOfRecordOdooActionInputPlacement}, with POSITIONAL replaced by a NAMED parameter: JSON-2 binds every body
|
|
102
|
+
* member to the method's signature by name and has no positional form.
|
|
103
|
+
*
|
|
104
|
+
* spec-cite: Odoo 19.0 developer documentation, External JSON-2 API, "Migrating from XML-RPC / JSON-RPC" — "All the
|
|
105
|
+
* arguments are named; there is no way in JSON-2 to call a function with positional arguments."
|
|
106
|
+
*/
|
|
107
|
+
export enum SystemOfRecordOdooJson2ActionInputPlacement {
|
|
108
|
+
/**
|
|
109
|
+
* Each member of the input object is one of the method's named parameters. The default, and the counterpart of
|
|
110
|
+
* `KEYWORD_ARGUMENTS`: a recordset method's options are its parameters.
|
|
111
|
+
*/
|
|
112
|
+
NAMED_PARAMETERS = 'named-parameters',
|
|
113
|
+
/**
|
|
114
|
+
* The whole input object is the value of ONE named parameter, `inputParameter`: the body is
|
|
115
|
+
* `{ "<inputParameter>": <input> }`. The counterpart of `POSITIONAL`, and `create` is the canonical case: its signature
|
|
116
|
+
* is `create(self, vals_list)`, and Odoo's `model_create_multi` accepts one mapping there and treats it as a list of
|
|
117
|
+
* one, so `{ "vals_list": { …values… } }` creates one record. JSON-2 answers a created recordset as its ids, so that
|
|
118
|
+
* call answers `[<id>]`, a list, where `execute_kw('create', [vals])` answered the bare id.
|
|
119
|
+
*
|
|
120
|
+
* spec-cite: Odoo 19.0 source, `odoo/orm/decorators.py` `model_create_multi` ("if isinstance(vals_list, Mapping):
|
|
121
|
+
* vals_list = [vals_list]") and `addons/rpc/controllers/json2.py` `web_json_2_rpc` ("if isinstance(result, BaseModel):
|
|
122
|
+
* result = result.ids") — https://github.com/odoo/odoo/tree/19.0.
|
|
123
|
+
*/
|
|
124
|
+
SINGLE_PARAMETER = 'single-parameter',
|
|
125
|
+
/** The method takes nothing beyond its records (`action_post`, `button_confirm`). The declared input must then be empty. */
|
|
126
|
+
NONE = 'none',
|
|
127
|
+
}
|
|
128
|
+
|
|
79
129
|
/**
|
|
80
130
|
* How a RECORD-FREE action relates to the instance's partitions (#1058), required at boot when the instance is
|
|
81
131
|
* partitioned. A record-targeted action needs none: the record it reads first carries its partition.
|
|
@@ -104,7 +154,8 @@ export const SystemOfRecordActionPartitionStanceSchema = z.discriminatedUnion('k
|
|
|
104
154
|
kind: z.literal(SystemOfRecordActionPartitionStanceKind.MEMBER_UNIT_PARTITION),
|
|
105
155
|
/**
|
|
106
156
|
* The REMOTE parameter the placed partition value is written into (`company_id`): a key of the Odoo keyword
|
|
107
|
-
* arguments or of the positional input object, or a member of the
|
|
157
|
+
* arguments or of the positional input object (`execute_kw`), a named parameter or a member of the single-parameter
|
|
158
|
+
* object (JSON-2), or a member of the OData body. The caller's input may not carry it.
|
|
108
159
|
*/
|
|
109
160
|
parameter: z.string().min(1).max(120),
|
|
110
161
|
}),
|
|
@@ -124,6 +175,19 @@ export const SystemOfRecordActionCallSchema = z.discriminatedUnion('shape', [
|
|
|
124
175
|
model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
|
|
125
176
|
inputPlacement: z.enum(SystemOfRecordOdooActionInputPlacement).default(SystemOfRecordOdooActionInputPlacement.KEYWORD_ARGUMENTS),
|
|
126
177
|
}),
|
|
178
|
+
z.strictObject({
|
|
179
|
+
shape: z.literal(SystemOfRecordActionCallShape.ODOO_JSON2_METHOD),
|
|
180
|
+
/** The model method, in Odoo's own spelling (`action_post`, `create`) — the last segment of `/json/2/<model>/<method>`. */
|
|
181
|
+
method: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo method name is snake_case.').max(120),
|
|
182
|
+
/** As for `ODOO_EXECUTE_KW`: for a RECORD-FREE action only; absent means the binding's `entityRef`. */
|
|
183
|
+
model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
|
|
184
|
+
inputPlacement: z.enum(SystemOfRecordOdooJson2ActionInputPlacement).default(SystemOfRecordOdooJson2ActionInputPlacement.NAMED_PARAMETERS),
|
|
185
|
+
/**
|
|
186
|
+
* The method parameter the whole input becomes, for `SINGLE_PARAMETER` only (`vals_list` for `create`). Required with
|
|
187
|
+
* that placement and refused with any other, so a declaration cannot name a parameter nothing is sent in.
|
|
188
|
+
*/
|
|
189
|
+
inputParameter: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo parameter name is snake_case.').max(120).optional(),
|
|
190
|
+
}),
|
|
127
191
|
z.strictObject({
|
|
128
192
|
shape: z.literal(SystemOfRecordActionCallShape.ODATA_BOUND_ACTION),
|
|
129
193
|
/** The namespace-qualified action name (`Microsoft.Dynamics.CRM.WinOpportunity`). */
|
|
@@ -32,6 +32,8 @@ export const HTTP_API_DIALECT_CAPABILITIES: { readonly [dialect in HttpApiTransp
|
|
|
32
32
|
[HttpApiTransportDialect.ODATA_V2]: { translatesSort: true, sendsRowWrites: false },
|
|
33
33
|
// `search_read`'s `order`; `execute_kw` create / write / unlink (#1724).
|
|
34
34
|
[HttpApiTransportDialect.ODOO_JSONRPC]: { translatesSort: true, sendsRowWrites: true },
|
|
35
|
+
// The same `order` and the same create / write / unlink, sent as `POST /json/2/<model>/<method>` (#3391).
|
|
36
|
+
[HttpApiTransportDialect.ODOO_JSON2]: { translatesSort: true, sendsRowWrites: true },
|
|
35
37
|
// No sort translation (the compiler refuses every sort); the binding's declared method and path per verb (#1728).
|
|
36
38
|
[HttpApiTransportDialect.REST_JSON]: { translatesSort: false, sendsRowWrites: true },
|
|
37
39
|
});
|
|
@@ -114,7 +116,7 @@ export function systemOfRecordBindingCapabilities(facet: SystemOfRecordVendorFac
|
|
|
114
116
|
writesRows: writeRefusal === undefined,
|
|
115
117
|
...(writeRefusal === undefined ? {} : { writeRefusal }),
|
|
116
118
|
partitions: systemOfRecordPartitionIsConfinable(facet.partition),
|
|
117
|
-
incrementalExtractionModes: (facet.incrementalExtractionModes ?? []).filter((mode) =>
|
|
119
|
+
incrementalExtractionModes: (facet.incrementalExtractionModes ?? []).filter((mode) => EXTERNAL_DATA_INCREMENTAL_MODE_DIALECTS[mode].includes(dialect)),
|
|
118
120
|
actionCallShapes: (facet.actionCallShapes ?? []).filter((shape) => SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT[shape] === dialect),
|
|
119
121
|
};
|
|
120
122
|
}
|
|
@@ -165,6 +165,22 @@ export enum SystemOfRecordErrorCode {
|
|
|
165
165
|
*/
|
|
166
166
|
CREDENTIAL_MATERIAL_UNUSABLE = 'SYSTEM_OF_RECORD_CREDENTIAL_MATERIAL_UNUSABLE',
|
|
167
167
|
|
|
168
|
+
/**
|
|
169
|
+
* REQUEST — the system of record REFUSED the instance's static credential (#3456): an API key, a key in the query,
|
|
170
|
+
* a BASIC password, or Odoo's in-args key. Odoo's JSON-RPC answers `common.authenticate` with `false`; Odoo's
|
|
171
|
+
* JSON-2 and any vendor reading a header key answer `401`.
|
|
172
|
+
*
|
|
173
|
+
* Told apart from an unreachable or failing system of record because the remedy is a different person's work: the
|
|
174
|
+
* operator ROTATES the credential (the context's `rotate` names the environment variables to replace) and restarts;
|
|
175
|
+
* nothing in the application or the vendor is broken. A static key cannot be re-minted, so no retry can fix it. An Odoo
|
|
176
|
+
* 19+ key expires within three months, so on Odoo this is also what an EXPIRED key looks like.
|
|
177
|
+
*
|
|
178
|
+
* Answered as `CONFIGURATION`, whose context reaches the server log and not the client: the instance's slot names are
|
|
179
|
+
* the operator's business. A token-minting credential refused AFTER a fresh mint is {@link TOKEN_UNAVAILABLE}'s family,
|
|
180
|
+
* not this one.
|
|
181
|
+
*/
|
|
182
|
+
CREDENTIAL_REFUSED = 'SYSTEM_OF_RECORD_CREDENTIAL_REFUSED',
|
|
183
|
+
|
|
168
184
|
/**
|
|
169
185
|
* BOOT — the instance opts into partitioning and its vendor declares none (#1058).
|
|
170
186
|
*
|
|
@@ -98,6 +98,14 @@ export const SystemOfRecordDeclarationSchema = z.strictObject({
|
|
|
98
98
|
* splitting it between the instances' `maxRequestsPerMinute`. Both were rejected on that ground.
|
|
99
99
|
* The cost, stated: two instances against one vendor account are paced separately, so their sum —
|
|
100
100
|
* not either one — is what must stay under the vendor's allowance.
|
|
101
|
+
*
|
|
102
|
+
* ## Odoo: the VERSION decides (#3391)
|
|
103
|
+
*
|
|
104
|
+
* Odoo speaks two dialects to the same ORM. Declare `ODOO_JSON2` for Odoo 19.0 or later (Odoo Online included) and
|
|
105
|
+
* `ODOO_JSONRPC` for Odoo 18.0, which has no JSON-2. `/jsonrpc` is deprecated from 19.0 and removed at Online 21.1
|
|
106
|
+
* (winter 2027) and Odoo 22 (fall 2028), so an instance moves to `ODOO_JSON2` by changing this one field; its
|
|
107
|
+
* bindings name the same dialect and change with it. The credential kind follows from the dialect, and the same
|
|
108
|
+
* Odoo API key serves both.
|
|
101
109
|
*/
|
|
102
110
|
dialect: z.enum(HttpApiTransportDialect),
|
|
103
111
|
|
|
@@ -105,7 +113,8 @@ export const SystemOfRecordDeclarationSchema = z.strictObject({
|
|
|
105
113
|
* How the engine proves who it is.
|
|
106
114
|
*
|
|
107
115
|
* OPTIONAL, and the absence is DERIVED rather than defaulted: when the instance's facet offers
|
|
108
|
-
* exactly one credential kind there is nothing for an author to decide, so the
|
|
116
|
+
* exactly one credential kind OVER THE INSTANCE'S DIALECT (#3391) there is nothing for an author to decide, so the
|
|
117
|
+
* registry takes it;
|
|
109
118
|
* when a facet offers more than one and the instance names none, boot refuses and lists them.
|
|
110
119
|
* The framework derives before it asks: a declaration with one legal value is a question whose
|
|
111
120
|
* answer the mechanism already holds.
|
|
@@ -269,9 +278,14 @@ const systemOfRecordSlotListSchema = (label: string) =>
|
|
|
269
278
|
*
|
|
270
279
|
* The kind owns its secrets and any address slot that exists only because the kind was chosen — a
|
|
271
280
|
* future `OAUTH2_CLIENT_CREDENTIALS` owns `tokenUrl`, which no vendor would declare if it were
|
|
272
|
-
* reached with a static key. `ODOO_API_KEY_IN_ARGS`
|
|
273
|
-
*
|
|
274
|
-
*
|
|
281
|
+
* reached with a static key. `ODOO_API_KEY_IN_ARGS` owns `login`, for the same reason: the login exists only to be
|
|
282
|
+
* resolved to a uid by its `common.authenticate` handshake.
|
|
283
|
+
*
|
|
284
|
+
* ⚠ This used to say the kind needed no address slot of its own, because `database` and `login` "identify WHICH Odoo
|
|
285
|
+
* and WHICH user, so they belong to the vendor and would survive a second Odoo credential kind". Odoo's JSON-2 API
|
|
286
|
+
* (#3391) was that second kind, and it disproved the claim for `login`: a JSON-2 key IS the user, so nothing asks for a
|
|
287
|
+
* login at all. `database` did survive, as an optional `X-Odoo-Database` header, and stays the vendor's — required by
|
|
288
|
+
* this kind's offer, since every `execute_kw` call names it.
|
|
275
289
|
*/
|
|
276
290
|
export const SystemOfRecordCredentialKindContractSchema = z.strictObject({
|
|
277
291
|
addressSlots: systemOfRecordSlotListSchema('credential address'),
|
|
@@ -300,14 +314,23 @@ export type SystemOfRecordCredentialKindContract = z.infer<typeof SystemOfRecord
|
|
|
300
314
|
* Three slots are declared `required: false` here and are made required by the FACET's offer, which
|
|
301
315
|
* is the only place that knows: `certificateKeyId` when the vendor's assertion header policy is
|
|
302
316
|
* {@link SystemOfRecordAssertionHeaderPolicy.KEY_ID_SUPPLIED}, `certificatePem` when it is
|
|
303
|
-
* `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`.
|
|
317
|
+
* `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`. An offer reaches a VENDOR slot the same
|
|
318
|
+
* way since #3391: Odoo's `database` is optional, and the in-args kind makes it required. The join is performed
|
|
304
319
|
* ONCE, in {@link resolveSystemOfRecordInstanceSlots}, rather than by each of the five readers of
|
|
305
320
|
* "what does this instance need" — which is the enumeration failure
|
|
306
321
|
* `invariant-call-site-enumeration.md` exists to stop.
|
|
307
322
|
*/
|
|
308
323
|
export const SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS: Readonly<Record<SystemOfRecordCredentialKind, SystemOfRecordCredentialKindContract>> = {
|
|
309
324
|
[SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS]: {
|
|
310
|
-
addressSlots: [
|
|
325
|
+
addressSlots: [
|
|
326
|
+
{
|
|
327
|
+
slug: 'login',
|
|
328
|
+
required: true,
|
|
329
|
+
description:
|
|
330
|
+
'The Odoo user login the API key belongs to. `common.authenticate` resolves it to the uid every `execute_kw` call '
|
|
331
|
+
+ 'then acts as, so it decides what the application can read. JSON-RPC only: a JSON-2 key names its user itself.',
|
|
332
|
+
},
|
|
333
|
+
],
|
|
311
334
|
secretSlots: [
|
|
312
335
|
{
|
|
313
336
|
slug: 'apiKey',
|
|
@@ -527,11 +550,29 @@ const tokenLifetimeFallbackSecondsSchema = z.number().int().min(30).max(86_400);
|
|
|
527
550
|
* no header name is unrepresentable here; under a parallel map it would parse and fail at the first
|
|
528
551
|
* read.
|
|
529
552
|
*/
|
|
553
|
+
/**
|
|
554
|
+
* The dialects ONE offer is good for (#3391), spread into every offer arm. ABSENT means every dialect the vendor speaks,
|
|
555
|
+
* which is what every single-dialect vendor means and so writes nothing.
|
|
556
|
+
*
|
|
557
|
+
* Needed the day one vendor spoke two wires that authenticate differently: Odoo's `/jsonrpc` reads the key from the RPC
|
|
558
|
+
* arguments and ignores headers, and its JSON-2 API reads it from `Authorization: bearer` and has no arguments to carry
|
|
559
|
+
* it. An offer that did not say which wire it serves would make a JSON-2 instance with the in-args kind bootable and
|
|
560
|
+
* unable to authenticate — and would make every existing Odoo declaration, which names no credential kind, ambiguous.
|
|
561
|
+
* Scoping the offer keeps the credential kind DERIVED from the dialect the instance already declares
|
|
562
|
+
* ({@link chooseSystemOfRecordCredentialKind}), which is `derive-before-you-ask.md` applied.
|
|
563
|
+
*
|
|
564
|
+
* Rejected: a separate dialect → kinds map on the facet. Two lists that must agree about one offer is the
|
|
565
|
+
* parallel-map shape the union below exists to avoid.
|
|
566
|
+
*/
|
|
567
|
+
const credentialOfferDialectScopeShape = {
|
|
568
|
+
dialects: z.array(z.enum(HttpApiTransportDialect)).min(1).optional(),
|
|
569
|
+
};
|
|
570
|
+
|
|
530
571
|
export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind', [
|
|
531
|
-
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind') }),
|
|
572
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape }),
|
|
532
573
|
|
|
533
574
|
z.strictObject({
|
|
534
|
-
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'),
|
|
575
|
+
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
|
|
535
576
|
/** The header the key travels in — `Authorization`, `X-API-Key`, `apikey`, whatever the vendor reads. */
|
|
536
577
|
headerName: z.string().regex(/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/, 'A header name is an RFC 9110 token.').max(64),
|
|
537
578
|
/** What precedes the key in the header value, INCLUDING its trailing space (`"Bearer "`). Omitted when the key stands alone. */
|
|
@@ -539,21 +580,21 @@ export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind',
|
|
|
539
580
|
}),
|
|
540
581
|
|
|
541
582
|
z.strictObject({
|
|
542
|
-
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'),
|
|
583
|
+
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
|
|
543
584
|
/** The query parameter the key is appended as. */
|
|
544
585
|
parameterName: z.string().regex(/^[A-Za-z0-9_.-]+$/, 'A query parameter name is alphanumeric with -._').max(64),
|
|
545
586
|
}),
|
|
546
587
|
|
|
547
|
-
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind') }),
|
|
588
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape }),
|
|
548
589
|
|
|
549
590
|
z.strictObject({
|
|
550
|
-
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'),
|
|
591
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
|
|
551
592
|
clientAuthentication: z.enum(SystemOfRecordClientAuthenticationPlacement),
|
|
552
593
|
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
553
594
|
}),
|
|
554
595
|
|
|
555
596
|
z.strictObject({
|
|
556
|
-
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'),
|
|
597
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
|
|
557
598
|
assertionHeaderPolicy: z.enum(SystemOfRecordAssertionHeaderPolicy),
|
|
558
599
|
assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
|
|
559
600
|
/** How long the ASSERTION is valid — minutes, not hours; it is consumed once at the token endpoint. */
|
|
@@ -562,13 +603,13 @@ export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind',
|
|
|
562
603
|
}),
|
|
563
604
|
|
|
564
605
|
z.strictObject({
|
|
565
|
-
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'),
|
|
606
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape,
|
|
566
607
|
assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
|
|
567
608
|
assertionLifetimeSeconds: z.number().int().min(30).max(600),
|
|
568
609
|
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
569
610
|
}),
|
|
570
611
|
// Nothing about mTLS varies by vendor: the certificate, the key and the CA are the deployment's (#1263).
|
|
571
|
-
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.MTLS_CLIENT_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind') }),
|
|
612
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.MTLS_CLIENT_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'), ...credentialOfferDialectScopeShape }),
|
|
572
613
|
]);
|
|
573
614
|
export type SystemOfRecordCredentialOffer = z.infer<typeof SystemOfRecordCredentialOfferSchema>;
|
|
574
615
|
|
|
@@ -875,6 +916,26 @@ export const SystemOfRecordVendorFacetSchema = z.strictObject({
|
|
|
875
916
|
seenKinds.add(offer.kind);
|
|
876
917
|
}
|
|
877
918
|
|
|
919
|
+
// #3391 — an offer scoped to dialects names only dialects the vendor speaks, and every dialect the vendor speaks has at
|
|
920
|
+
// least one offer. Either failure is a facet that cannot be honoured: an offer for a dialect no instance may declare, or
|
|
921
|
+
// a dialect an instance may declare and then cannot authenticate over.
|
|
922
|
+
for (const [index, offer] of facet.credentialOffers.entries()) {
|
|
923
|
+
for (const dialect of offer.dialects ?? []) {
|
|
924
|
+
if (!facet.dialects.includes(dialect)) {
|
|
925
|
+
context.addIssue({
|
|
926
|
+
code: 'custom',
|
|
927
|
+
path: ['credentialOffers', index, 'dialects'],
|
|
928
|
+
message: `Credential offer "${offer.kind}" is scoped to ${dialect}, which this vendor's dialects do not list.`,
|
|
929
|
+
});
|
|
930
|
+
}
|
|
931
|
+
}
|
|
932
|
+
}
|
|
933
|
+
for (const [index, dialect] of facet.dialects.entries()) {
|
|
934
|
+
if (!facet.credentialOffers.some((offer) => systemOfRecordCredentialOfferServesDialect(offer, dialect))) {
|
|
935
|
+
context.addIssue({ code: 'custom', path: ['dialects', index], message: `No credential offer serves dialect "${dialect}".` });
|
|
936
|
+
}
|
|
937
|
+
}
|
|
938
|
+
|
|
878
939
|
// A vendor address slug that a kind also declares would make the derived environment variable
|
|
879
940
|
// ambiguous about who owns the value, so the two namespaces are checked against each other here
|
|
880
941
|
// rather than at the instance, where the failure would read as an authoring mistake.
|