@wildo-ai/framework-knowledge 1.1.10 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +7 -5
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +628 -107
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +10 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +82 -15
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -5
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +4 -16
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +38 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +20 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +6 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +26 -7
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +7 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +9 -7
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +9 -2
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +15 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +24 -9
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +98 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +39 -20
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +788 -49
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +115 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -5
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +153 -28
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +49 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +15 -5
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +216 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +21 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +28 -2
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
- package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +342 -76
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +47 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +127 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +28 -8
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +94 -13
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
- package/dist/knowledge/references/platform.config.saas.md +126 -32
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +105 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
- package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
- package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +280 -40
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +123 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +22 -4
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
- package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +303 -0
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +5250 -2565
- package/dist/knowledge/registries/playbooks.json +88 -55
- package/dist/knowledge/registries/source-tags.json +9347 -4807
- package/dist/knowledge/rules/database-migration-obligation.md +10 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +62 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +26 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +37 -1
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +168 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +66 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +166 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +21 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -10
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +10 -2
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +93 -13
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +140 -7
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +7 -5
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +13 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +72 -8
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +165 -44
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +200 -61
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +8 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +21 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +46 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +4 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +219 -77
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +223 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +138 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +30 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +186 -83
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +113 -70
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +41 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +15 -4
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17998 -8568
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# What works on PostgreSQL
|
|
2
|
+
|
|
3
|
+
Read this when you are choosing `applicationDatabase`, or when you need to know
|
|
4
|
+
whether a framework feature behaves the same once your application persists to
|
|
5
|
+
PostgreSQL. `postgresql-vs-mongodb-obligations.md` covers what PostgreSQL asks of
|
|
6
|
+
you (migrations); this file covers what you get.
|
|
7
|
+
|
|
8
|
+
The short answer: **every framework surface runs on PostgreSQL.** No engine
|
|
9
|
+
resource is pinned to MongoDB, so a PostgreSQL application keeps all of its
|
|
10
|
+
framework data (users, organizations, files, audit rows, deliveries, billing
|
|
11
|
+
records, agent conversations) in its own PostgreSQL database. The differences
|
|
12
|
+
below are the whole list, and each is a property of the store, not a missing
|
|
13
|
+
feature.
|
|
14
|
+
|
|
15
|
+
## Supported surfaces
|
|
16
|
+
|
|
17
|
+
| Surface | On PostgreSQL | What to know |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| Resources: create, read, update, delete, list, search, count, bulk writes | Supported | Same operations, same authorization and tenancy scoping as on MongoDB. Scope-anchored list, search and count resolve through the membership junction on both stores. |
|
|
20
|
+
| Field aggregation (sum, max, … used by charts and computed totals) | Supported | A dotted path into a nested object, or a field only one variant carries, is aggregated too. A present value that is not a number FAILS the aggregation instead of counting as 0. |
|
|
21
|
+
| Uniqueness and document numbers | Supported | A unique index is created by your migration; concurrent document-number allocation is serialized by the database. |
|
|
22
|
+
| Files | Supported | File metadata is a row in your database and commits in the same transaction as the row that links it. |
|
|
23
|
+
| Retrieval-augmented generation (`.ragSource()` fields) | Supported, through pgvector | The database must expose the `vector` extension. Startup EXECUTES a vector expression on the live connection and refuses to start without it. The chunk tables are created and kept current by the framework itself, not by your migrations. See the `resource-rag-source-fields` skill. |
|
|
24
|
+
| Audit trail (the database audit rows) | Supported | Audit rows are a resource in your database. One row per event id is enforced by the store, and organization routing is the same as on MongoDB. An optional tamper-evident audit provider (immudb) is a separate backing service and does not depend on which database you chose. |
|
|
25
|
+
| Durable delivery records (inbound deliveries, the billing effect outbox, webhook and SIEM delivery rows and their dead-letter drains) | Supported | The message broker (RabbitMQ) carries the work; the record the framework reads back to deduplicate, retry and drain is a resource in your database. |
|
|
26
|
+
| Transactions | Supported | See below. |
|
|
27
|
+
|
|
28
|
+
## The differences you can observe
|
|
29
|
+
|
|
30
|
+
**Filter operators.** The portable operators are `$eq`, `$ne`, `$gt`, `$gte`,
|
|
31
|
+
`$lt`, `$lte`, `$in`, `$nin`, `$and`, `$or`, `$not`, `$regex`, `$startsWith`,
|
|
32
|
+
`$endsWith`, `$contains` and `$exists`. MongoDB-specific operators (`$where`,
|
|
33
|
+
`$expr`, `$jsonSchema`, `$elemMatch`, `$all`, `$size`, `$type`, `$mod`, `$text`
|
|
34
|
+
and the geospatial ones) are REFUSED on PostgreSQL with an error; nothing
|
|
35
|
+
silently ignores them. A filter written with the portable set runs on both.
|
|
36
|
+
|
|
37
|
+
**A cleared field reads back as absent.** Clearing a `.nullish()` field returns
|
|
38
|
+
it ABSENT on both stores. What is not portable is telling "explicitly set to
|
|
39
|
+
null" apart from "never set": PostgreSQL stores both as NULL. If your logic
|
|
40
|
+
needs that distinction, give it a field of its own.
|
|
41
|
+
|
|
42
|
+
**Transaction options.** `isolationLevel` and `maxWaitMs` (the lock wait) apply
|
|
43
|
+
on PostgreSQL only. `timeoutMs` bounds each statement on PostgreSQL and the
|
|
44
|
+
commit on MongoDB. A transaction that PostgreSQL aborts for a serialization
|
|
45
|
+
failure or a deadlock is run again from the start, up to three runs in total,
|
|
46
|
+
before the error reaches you.
|
|
47
|
+
|
|
48
|
+
**Nesting.** A nested `executeTransaction` either refuses
|
|
49
|
+
(`TransactionNestedBehavior.ERROR`, the default) or joins the active transaction
|
|
50
|
+
(`TransactionNestedBehavior.REUSE`). There is no nested rollback (savepoint) on
|
|
51
|
+
either store: a failure inside a joined call aborts the whole transaction.
|
|
52
|
+
|
|
53
|
+
## One store per application
|
|
54
|
+
|
|
55
|
+
An application uses exactly one transactional store. Every resource it declares
|
|
56
|
+
lives there; startup refuses a resource pinned to the other store. Resources read
|
|
57
|
+
through from another system (`HTTP_API`) or computed from the application
|
|
58
|
+
(`INTROSPECTION`) have no table and behave the same whichever store you chose.
|
|
59
|
+
|
|
60
|
+
## What has not been measured
|
|
61
|
+
|
|
62
|
+
Throughput and latency at production volume have not been benchmarked against a
|
|
63
|
+
representative workload on PostgreSQL. Everything above is verified for
|
|
64
|
+
correctness, not for performance. Size your database from your own load tests.
|
|
@@ -8,6 +8,7 @@ write; PostgreSQL does not.**
|
|
|
8
8
|
| Add a resource | Collection appears on first write | Table must be CREATED by a migration |
|
|
9
9
|
| Add a field | Document simply carries it | Column must be ADDED by a migration |
|
|
10
10
|
| Add `.isDBIndexed()` | Index built at boot maintenance | Index created by a migration |
|
|
11
|
+
| Add `.compoundIndex([...])` on the schema | Index built at boot maintenance | Index created by a migration |
|
|
11
12
|
| Add `.isUnique()` | Index built at boot maintenance | Unique index by migration; FAILS loudly on existing duplicates |
|
|
12
13
|
| Add a Zod `.default()` | Convertor forwards it to the model | Column `DEFAULT` by migration, and it applies to NEW rows only |
|
|
13
14
|
| Remove a field | Document key stops being written | `drop column` — DESTRUCTIVE, and acknowledged in writing |
|
|
@@ -26,9 +27,44 @@ are meaningful.
|
|
|
26
27
|
loses nothing) and will still refuse to apply over duplicates. That refusal is
|
|
27
28
|
the feature: it is the first time anyone has asked the question.
|
|
28
29
|
|
|
30
|
+
## Resources with no table
|
|
31
|
+
|
|
32
|
+
Only a resource stored in PostgreSQL has a table. Three kinds are left out of the
|
|
33
|
+
schema plan, owe no migration, and are never checked at boot:
|
|
34
|
+
|
|
35
|
+
- `persistenceAdapter: HTTP_API` — read through from another system, which keeps the rows;
|
|
36
|
+
- `persistenceAdapter: INTROSPECTION` — computed from the application itself;
|
|
37
|
+
- `persistenceAdapter: MONGODB` — stored in MongoDB, which only a MongoDB application
|
|
38
|
+
can declare (an application uses one transactional store).
|
|
39
|
+
|
|
40
|
+
Moving an existing resource to a read-through or introspected adapter removes it from the plan, so
|
|
41
|
+
the next migration drops its table. That is DESTRUCTIVE: the runner refuses it until
|
|
42
|
+
you acknowledge it, and any rows the table held are gone. Check the table is empty,
|
|
43
|
+
or copy what you need, before you generate it.
|
|
44
|
+
|
|
45
|
+
A resource that declares no adapter takes your application's default, and the plan
|
|
46
|
+
reads that default from every environment you author: it is PostgreSQL when any
|
|
47
|
+
environment persists to PostgreSQL (`applicationDatabase`, which defaults to
|
|
48
|
+
PostgreSQL), and MongoDB only when every environment persists to MongoDB. An
|
|
49
|
+
application uses exactly one transactional store, so no resource can be kept on the
|
|
50
|
+
other one: startup refuses a resource whose `persistenceAdapter` is MongoDB in a
|
|
51
|
+
PostgreSQL application, or PostgreSQL in a MongoDB one.
|
|
52
|
+
|
|
53
|
+
One lockfile serves all your environments. If they disagree (one on PostgreSQL, one
|
|
54
|
+
on MongoDB), the plan covers what the PostgreSQL environment needs, and the MongoDB
|
|
55
|
+
environment never touches PostgreSQL at all. A table planned and unused costs nothing; a table needed
|
|
56
|
+
and not planned stops that environment's backend from starting.
|
|
57
|
+
|
|
58
|
+
If your MongoDB application already generated a plan that included every undeclared
|
|
59
|
+
resource, the next `wildo db diff` reports those tables as removed, and the migration
|
|
60
|
+
that drops them is DESTRUCTIVE like any other. They were never written to, so check
|
|
61
|
+
they are empty and acknowledge it.
|
|
62
|
+
|
|
29
63
|
## What does NOT change
|
|
30
64
|
|
|
31
65
|
Resource schemas, decorators, factories, operations, relationships, UI
|
|
32
66
|
behavior and specifications are all adapter-neutral. You author them exactly
|
|
33
67
|
the same way. The only thing PostgreSQL adds is the obligation to ship the
|
|
34
|
-
physical change alongside the semantic one.
|
|
68
|
+
physical change alongside the semantic one. Which framework features run on
|
|
69
|
+
PostgreSQL, and the few differences you can observe, are in
|
|
70
|
+
`postgresql-supported-surfaces.md`.
|
|
@@ -69,6 +69,15 @@ Read `references/framework-application-roles-api.md` for the chain. A custom rol
|
|
|
69
69
|
role whose access it should start from — `ORG_GUEST` for "almost nothing", `ORG_MEMBER` for
|
|
70
70
|
"everything a member has, plus".
|
|
71
71
|
|
|
72
|
+
"Almost nothing" includes the organization's people. The member directory, the people picker
|
|
73
|
+
(`/organizations/:org/users/search`) and colleagues' names on records all ask the directory's own
|
|
74
|
+
SEARCH roles (`ORG_MEMBER` and up). A role that does not inherit `ORG_MEMBER` lists nobody: its
|
|
75
|
+
holders cannot pick a colleague, and see a person reference on a record as unavailable. When such a
|
|
76
|
+
group does need to see its colleagues (technicians picking who a job is handed to), declare
|
|
77
|
+
`seesOrganizationPeople: true` on its role in Step 2: the directory's SEARCH then counts it, so its
|
|
78
|
+
holders (and holders of any role inheriting it) list, pick and name the organization's people, and
|
|
79
|
+
nothing else widens. Without the declaration the role sees nobody.
|
|
80
|
+
|
|
72
81
|
### Step 2 — Declare each custom role in `shared-lib/src/engine/roles.ts`
|
|
73
82
|
|
|
74
83
|
One entry per role, keyed by its name, with `relatedPrimaryScope` `ORGANIZATIONS` (a role inside one
|
|
@@ -97,8 +106,19 @@ UPDATE.
|
|
|
97
106
|
Author a role specification (`spec-family-update`) so the purpose grounds the role's labels, and make
|
|
98
107
|
sure `roleSpecifications` in `specifications/src/companion-exports.ts` spreads the application's role
|
|
99
108
|
specifications beside `engineRoleSpecifications`. Then regenerate labels (`i18n-label-generation`).
|
|
100
|
-
|
|
101
|
-
|
|
109
|
+
|
|
110
|
+
### Step 6 — Check who can give it to people
|
|
111
|
+
|
|
112
|
+
People receive the role on the engine's members screen and through invitations; there is no
|
|
113
|
+
assignment screen to build. Who may give it is decided by the role-ceiling gate: an owner or
|
|
114
|
+
administrator may grant a custom role when everything it confers is within their own role — its
|
|
115
|
+
`inheritFrom` chain is on theirs, and every operation that names it (Step 4) also admits them, at the
|
|
116
|
+
same row reach. So a supervisor inheriting `ORG_MANAGER` and named beside `ORG_ADMIN` on the escalation
|
|
117
|
+
rota is grantable by owners and administrators, and refused to managers. A custom role named ALONE on
|
|
118
|
+
an operation administrators cannot call, or inheriting `ORG_OWNER`, exceeds them: only the platform
|
|
119
|
+
super-administrator can grant it. If tenant administrators must be able to give the role, name them
|
|
120
|
+
beside it on every operation it unlocks. The organization type still has to offer it (Step 3) in the
|
|
121
|
+
organization the membership belongs to.
|
|
102
122
|
|
|
103
123
|
## Worked Example
|
|
104
124
|
|
|
@@ -108,13 +128,14 @@ The complete office/field wiring — role table, organization type, operation ro
|
|
|
108
128
|
## References
|
|
109
129
|
|
|
110
130
|
- `references/framework-application-roles-api.md` — source-backed role definition and the engine's organization roles with their inheritance chain.
|
|
111
|
-
- `references/office-and-field-worked-example.md` — the three places a role must appear, for office staff and field technicians.
|
|
131
|
+
- `references/office-and-field-worked-example.md` — the three places a role must appear, for office staff and field technicians, and who may then grant it.
|
|
112
132
|
|
|
113
133
|
## Verification
|
|
114
134
|
|
|
115
135
|
- [ ] Every custom role in `roles.ts` has `relatedPrimaryScope` `ORGANIZATIONS` or `APPLICATION`.
|
|
116
136
|
- [ ] Every custom organization role is in `availableOrgRoles` of each organization type that should offer it.
|
|
117
137
|
- [ ] Every custom role is named in at least one operation's `roles`.
|
|
138
|
+
- [ ] Every operation naming a custom role that tenant administrators must be able to grant also names `ORG_ADMIN` (or a role on its chain), or the role is grantable by the platform super-administrator only.
|
|
118
139
|
- [ ] No resource stores roles, permissions or role assignments.
|
|
119
140
|
- [ ] Each role has a specification and labels.
|
|
120
141
|
|
|
@@ -127,6 +148,8 @@ rg -n "role: '" shared-lib/src/engine/roles.ts
|
|
|
127
148
|
rg -n "'FIELD_TECHNICIAN'" wildo.saas.config.ts
|
|
128
149
|
# each declared role is named on an operation (repeat per role name)
|
|
129
150
|
rg -l "'FIELD_TECHNICIAN'" shared-lib/src/modules
|
|
151
|
+
# grantable by administrators: every role list naming the custom role should also name ORG_MEMBER/ORG_ADMIN (or a role on their chain)
|
|
152
|
+
rg -n "'FIELD_TECHNICIAN'" shared-lib/src/modules --glob '*.resources-config.ts'
|
|
130
153
|
# a resource modelling roles or permissions as data (must return empty)
|
|
131
154
|
rg -li "permission|roleassignment|accessrole" shared-lib/src/modules --glob '*.schemas.ts'
|
|
132
155
|
```
|
|
@@ -139,12 +162,14 @@ rg -li "permission|roleassignment|accessrole" shared-lib/src/modules --glob '*.s
|
|
|
139
162
|
| "I'll add a permissions enum and check it later" | Nothing checks it later. The engine gates operations on `roles` alone, so the enum ships as a control that enforces nothing. |
|
|
140
163
|
| "The field role should inherit ORG_MEMBER so technicians can work" | Then technicians hold everything office staff hold. Inherit `ORG_GUEST` and name the field role on the operations it needs. |
|
|
141
164
|
| "ORG_ADMIN inherits everything, so admins pass my custom role's operations" | The chain is linear and a custom role is not on it. Name `ORG_MEMBER` (or `ORG_ADMIN`) beside the custom role where administrators must qualify. |
|
|
165
|
+
| "Only a super-administrator can give a custom role, so I need an assignment screen" | An owner or administrator grants it on the members screen whenever every operation, approval or decision route, action and agent or flow launch gate (`accessControl[].roles`) naming it also admits them. Name them beside the role instead of building a screen; a role that is the only one a decision route admits stays a super-administrator's to give. |
|
|
142
166
|
| "Hiding the menu entry is enough" | Hiding is not refusing. The operation's `roles` is what the engine enforces; navigation only follows it. |
|
|
143
167
|
|
|
144
168
|
## Red Flags
|
|
145
169
|
|
|
146
170
|
- A custom role in `roles.ts` that no operation names (catch with the **named on an operation** grep).
|
|
147
171
|
- A custom organization role missing from `availableOrgRoles` (catch with the **offered** grep).
|
|
172
|
+
- A custom role tenant administrators must give, named alone on an operation they cannot call (catch with the **grantable by administrators** grep).
|
|
148
173
|
- A resource whose schema stores roles, permissions or assignments (catch with the **modelling roles as data** grep — must return empty).
|
|
149
174
|
- A custom role inheriting `ORG_MEMBER` or higher when the requirement narrows access (catch by reading `roles.ts` against Step 1).
|
|
150
175
|
- Every operation of a resource on the same single role while the requirements name several groups (catch by reading each `*.resources-config.ts` touched in Step 4).
|
|
@@ -39,17 +39,28 @@ ships. Read this before declaring a role, choosing what it inherits, or naming r
|
|
|
39
39
|
* - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
|
|
40
40
|
* organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
|
|
41
41
|
* ignored at startup with a warning, and the role grants nothing.
|
|
42
|
+
* - `seesOrganizationPeople` — `true` admits the role's holders to the organization's people: the member directory's
|
|
43
|
+
* SEARCH, the people picker behind every user reference (`/organizations/:organizationId/users/search`) and
|
|
44
|
+
* colleagues' names on records. Those three ask ONE question, the directory's SEARCH roles (`ORG_MEMBER` and up),
|
|
45
|
+
* and a role declaring this is counted among them, as is every role inheriting from it. Read only on a role whose
|
|
46
|
+
* `relatedPrimaryScope` is `ORGANIZATIONS`. Absent means refused: a role that does not inherit `ORG_MEMBER` (a field
|
|
47
|
+
* technician inheriting `ORG_GUEST`) sees nobody unless it declares this.
|
|
42
48
|
*
|
|
43
49
|
* Declaring a role is one of three steps. An organization role must also be listed in
|
|
44
50
|
* `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
|
|
45
51
|
* it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
|
|
46
|
-
* nothing). People receive it through the engine's members screen and invitations
|
|
52
|
+
* nothing). People receive it through the engine's members screen and invitations, from an owner or
|
|
53
|
+
* administrator whose role covers everything it confers: its `inheritFrom` chain, and every operation,
|
|
54
|
+
* approval or decision route, reference constraint, system-of-record action and agent or flow launch gate naming it
|
|
55
|
+
* (`resolveCustomRolesWithinAuthority`). Named alone where administrators are not admitted (an operation
|
|
56
|
+
* they cannot call, a decision route only it answers), it is grantable by the platform super-administrator only.
|
|
47
57
|
*/
|
|
48
58
|
export const RoleDefinitionSchema = z.object({
|
|
49
59
|
role: RolesSchema,
|
|
50
60
|
inheritFrom: RolesSchema.optional(),
|
|
51
61
|
isSystemRole: z.boolean().default(false),
|
|
52
62
|
relatedPrimaryScope : z.enum(ResourcePrimaryScope),
|
|
63
|
+
seesOrganizationPeople: z.boolean().optional(),
|
|
53
64
|
});
|
|
54
65
|
|
|
55
66
|
|
|
@@ -86,8 +97,8 @@ export const RolesConfigurationSchema = z.record(z.string(), RoleDefinitionSchem
|
|
|
86
97
|
* should `inheritFrom` and which roles an operation must name.
|
|
87
98
|
*
|
|
88
99
|
* The person-holdable chain is linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`
|
|
89
|
-
* (each holds everything to its right). `
|
|
90
|
-
*
|
|
100
|
+
* (each holds everything to its right). `ORG_REPRESENTATIVE` hangs off `ORG_MEMBER` for representatives of a
|
|
101
|
+
* representing organization. The entries after `ORG_OWNER` are handler-only or delegated-capability roles: the
|
|
91
102
|
* engine confers them (an inbound handler, a live capability grant), they are never stored on a
|
|
92
103
|
* membership, and a membership naming one is refused. Never inherit from them or assign them.
|
|
93
104
|
*/
|
|
@@ -103,8 +114,8 @@ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
|
|
|
103
114
|
isSystemRole: true,
|
|
104
115
|
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
105
116
|
},
|
|
106
|
-
[CORE_ORG_ROLES.
|
|
107
|
-
role: CORE_ORG_ROLES.
|
|
117
|
+
[CORE_ORG_ROLES.ORG_REPRESENTATIVE]: {
|
|
118
|
+
role: CORE_ORG_ROLES.ORG_REPRESENTATIVE,
|
|
108
119
|
inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
|
|
109
120
|
isSystemRole: true,
|
|
110
121
|
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
@@ -133,6 +144,12 @@ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
|
|
|
133
144
|
isSystemRole: true,
|
|
134
145
|
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
135
146
|
},
|
|
147
|
+
// No `inheritFrom`: handler-only, confers no operation; the signature notification handler only triggers a re-read (#2293).
|
|
148
|
+
[CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS]: {
|
|
149
|
+
role: CORE_ORG_ROLES.ORG_SIGNATURE_PROVIDER_EVENTS,
|
|
150
|
+
isSystemRole: true,
|
|
151
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
152
|
+
},
|
|
136
153
|
// No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
|
|
137
154
|
// inheriting anything would make a lent capability's reach a function of what that role grows into later.
|
|
138
155
|
[CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
|
|
@@ -140,8 +157,8 @@ export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
|
|
|
140
157
|
isSystemRole: true,
|
|
141
158
|
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
142
159
|
},
|
|
143
|
-
[CORE_ORG_ROLES.
|
|
144
|
-
role: CORE_ORG_ROLES.
|
|
160
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_REPRESENTATIVES]: {
|
|
161
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_REPRESENTATIVES,
|
|
145
162
|
isSystemRole: true,
|
|
146
163
|
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
147
164
|
},
|
|
@@ -47,6 +47,16 @@ export const workspaceAvailableOrgRoles: Roles[] = [
|
|
|
47
47
|
export const jobReadAndProgressRoles: Roles[] = ['FIELD_TECHNICIAN', CORE_ORG_ROLES.ORG_MEMBER];
|
|
48
48
|
/** Quotes and invoices: office only. A technician holding only the field role is refused. */
|
|
49
49
|
export const quoteAndInvoiceRoles: Roles[] = [CORE_ORG_ROLES.ORG_MEMBER];
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* 4. Who may GIVE the role needs no fourth place. An owner or administrator may grant a custom role whenever everything
|
|
53
|
+
* it confers is within their own role: its `inheritFrom` chain is on theirs, and every operation naming it admits
|
|
54
|
+
* them too, at the same row reach. Here the field role inherits `ORG_GUEST` and the one operation naming it also
|
|
55
|
+
* names `ORG_MEMBER`, so owners and administrators give it on the members screen and in invitations. Name the
|
|
56
|
+
* custom role ALONE on an operation administrators cannot call, or make it inherit `ORG_OWNER`, and only a role
|
|
57
|
+
* covering it may grant it, which for an organization role is the platform super-administrator. Who may write a
|
|
58
|
+
* membership at all is still that operation's own `roles` (`ORG_ADMIN` in the engine).
|
|
59
|
+
*/
|
|
50
60
|
```
|
|
51
61
|
|
|
52
62
|
What each part earns:
|
|
@@ -56,8 +66,19 @@ What each part earns:
|
|
|
56
66
|
operation to name it AND the core roles.
|
|
57
67
|
- **The field role inherits `ORG_GUEST`.** It starts from the bottom, so a technician reaches only the
|
|
58
68
|
operations that name the field role explicitly. Inheriting `ORG_MEMBER` instead would give
|
|
59
|
-
technicians everything office staff have, which is the opposite of the requirement.
|
|
69
|
+
technicians everything office staff have, which is the opposite of the requirement. It also means a
|
|
70
|
+
technician does not list the organization's people: the people picker and colleagues' names ask the
|
|
71
|
+
member directory's roles (`ORG_MEMBER`), so jobs are assigned by the office, and a technician sees
|
|
72
|
+
an assignee on a job as unavailable rather than by name. If technicians must see their colleagues,
|
|
73
|
+
add `seesOrganizationPeople: true` to the field role: the directory's SEARCH then counts it, and
|
|
74
|
+
the people picker and colleagues' names follow, while every other operation still admits only the
|
|
75
|
+
roles it names.
|
|
60
76
|
- **`availableOrgRoles` lists it.** Without the entry, the members screen cannot give the role to
|
|
61
77
|
anyone: the default list is owner, admin and member.
|
|
62
78
|
- **Operations name it where technicians are admitted, and only there.** Invoices name `ORG_MEMBER`
|
|
63
79
|
alone, so a technician is refused by the engine, not merely hidden from in the UI.
|
|
80
|
+
- **Owners and administrators can give it, with nothing more to build.** The role-ceiling gate admits
|
|
81
|
+
a custom role when everything it confers is within the granter's role: the field role inherits
|
|
82
|
+
`ORG_GUEST`, on every administrator's chain, and the jobs operation that names it also names
|
|
83
|
+
`ORG_MEMBER`. Had the field role been named ALONE on some operation, it would exceed every tenant
|
|
84
|
+
role, and only the platform super-administrator could grant it.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: authorization-unit-narrowing
|
|
3
|
-
description: Confine a resource's rows to the organization unit a member holds a role in, by declaring it unit-narrowable at application startup — and optionally let a SCIM directory keep unit membership in sync, either from each member's `department` attribute or from the directory's own groups. Use when the user says "scope this resource to a department", "each team should only see their own records", "regional managers should only manage their region's data", "restrict projects to the user's business unit", "add unit-level permissions", "why can a unit manager see every record", "map SCIM departments to units", "sync our Okta groups", "our Entra groups should become teams", "why did a group from our directory create a unit", or asks how organization-unit roles affect what a member can read and write.
|
|
3
|
+
description: Confine a resource's rows to the organization unit a member holds a role in, by declaring it unit-narrowable at application startup, or to the rows a member OWNS (own rows, the tier below the unit) — and optionally let a SCIM directory keep unit membership in sync, either from each member's `department` attribute or from the directory's own groups. Use when the user says "scope this resource to a department", "each team should only see their own records", "regional managers should only manage their region's data", "restrict projects to the user's business unit", "each employee should only see their own requests", "members see only what they created", "add unit-level permissions", "why can a unit manager see every record", "map SCIM departments to units", "sync our Okta groups", "our Entra groups should become teams", "why did a group from our directory create a unit", or asks how organization-unit roles affect what a member can read and write.
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -196,7 +196,19 @@ the directory owns on such a unit — its name, and adding or removing its membe
|
|
|
196
196
|
Unit roles, code, type, status and position stay editable. Do not build a screen
|
|
197
197
|
or a flow that renames a directory group or edits its membership in the
|
|
198
198
|
application; route that change to the directory. The refusal lifts once the
|
|
199
|
-
organization has no usable SCIM token
|
|
199
|
+
organization has no usable SCIM token, and it never applies to an organization
|
|
200
|
+
whose type does not declare `scimProvisioning`: the SCIM API refuses every request
|
|
201
|
+
for such an organization, so no directory can push to it, and no SCIM token can be
|
|
202
|
+
generated for it.
|
|
203
|
+
|
|
204
|
+
**c) Declared in code, for the application's own organization.** An internal
|
|
205
|
+
tool's name, chart, department → unit mapping, the unit each partition of a
|
|
206
|
+
partitioned system of record belongs to, and SSO-only posture can be a
|
|
207
|
+
committed `organizationIdentity` declaration applied at boot instead of settings
|
|
208
|
+
clicked in per environment. Units are named by `key` (their `code`), bindings
|
|
209
|
+
name units by key, and the boot step creates what is missing while keeping and
|
|
210
|
+
reporting what an administrator changed. See
|
|
211
|
+
`references/framework-organization-identity-declaration-api.md`.
|
|
200
212
|
|
|
201
213
|
### Step 6 — Update the resource specification
|
|
202
214
|
|
|
@@ -249,6 +261,139 @@ parent: upward propagation is privilege escalation along the org chart and the
|
|
|
249
261
|
vocabulary cannot express it. If you need "a division head sees rolled-up team
|
|
250
262
|
data", that is a reporting concern, not a role-propagation one.
|
|
251
263
|
|
|
264
|
+
## Own rows: the tier below the unit
|
|
265
|
+
|
|
266
|
+
The commonest rule of an internal tool has three tiers: an employee sees what
|
|
267
|
+
they raised, the head of a department sees the department's, finance sees
|
|
268
|
+
everything. Unit narrowing is the middle tier. **Own rows** is the first, and it
|
|
269
|
+
is declared beside it, as an `organizationOwnRows` map passed to application
|
|
270
|
+
startup:
|
|
271
|
+
|
|
272
|
+
- `ownerUserIdField` — the field naming the row's owner. `createdByUserId` is
|
|
273
|
+
the usual answer: the engine stamps it with the signed-in member on every
|
|
274
|
+
create and strips it from every client payload, so a member cannot name
|
|
275
|
+
someone else. Another user foreign key (a requester, an assignee) is allowed;
|
|
276
|
+
it must be a top-level foreign key of the main schema.
|
|
277
|
+
- `roles` — the roles whose ORGANIZATION-WIDE grant reaches only the rows the
|
|
278
|
+
holder owns, typically the default member role. Held on a UNIT, a declared
|
|
279
|
+
role supplies no unit (and no own rows of its own): a directory that places
|
|
280
|
+
every employee in their department with the member role therefore does not
|
|
281
|
+
open the department's rows to them. The department is reached through a role
|
|
282
|
+
you do not list (the department head's manager role on the unit).
|
|
283
|
+
|
|
284
|
+
It is a privilege DEPTH, not an admission. A declared role still has to satisfy
|
|
285
|
+
the operation's own `roles`, so give the read operations the member role when
|
|
286
|
+
members should read their own rows, and leave a manager-only verb manager-only.
|
|
287
|
+
What changes is how far the satisfying role reaches:
|
|
288
|
+
|
|
289
|
+
| The caller holds… | Result |
|
|
290
|
+
|---|---|
|
|
291
|
+
| an organization-wide role NOT in `roles` that satisfies the operation (a manager, finance) | every row |
|
|
292
|
+
| a unit role that satisfies it, and a declared role organization-wide | their units' rows **and** their own rows anywhere |
|
|
293
|
+
| only a declared role that satisfies it | the rows they own |
|
|
294
|
+
| a declared role held only on a unit (no organization-wide grant that satisfies it) | nothing |
|
|
295
|
+
| no user (an API key, an OAuth client) with only a declared role | nothing |
|
|
296
|
+
|
|
297
|
+
Depth is a property of the role HELD: a manager whose role inherits the member
|
|
298
|
+
role is not confined, because what they hold is the manager role. So a role you
|
|
299
|
+
add later that inherits a declared role reaches EVERY row until you list it in
|
|
300
|
+
`roles`: the opposite default from assigned rows, below, which confine any role
|
|
301
|
+
they do not name.
|
|
302
|
+
|
|
303
|
+
The confinement holds on every path that reads through the repositories (REST,
|
|
304
|
+
MCP and A2A tools, context population, notifications about a record). A summary
|
|
305
|
+
of a confined parent shown on another resource's row is decided for the caller,
|
|
306
|
+
so it shows what they could read directly; a read the authorization gate never
|
|
307
|
+
decided (a nested read) reads nothing. A chart
|
|
308
|
+
aggregates every row in scope, so a declared role does not admit a chart; a scope
|
|
309
|
+
room broadcasts every row, so a member confined to own rows does not join it and
|
|
310
|
+
keeps their confined reads over HTTP. Startup refuses a field that is not a
|
|
311
|
+
top-level foreign key, a resource that is not organization-scoped or is read
|
|
312
|
+
through from another system, an entry with no role, and a resource also declared
|
|
313
|
+
in `relationshipOrganizationWideAccess`. The contract is in
|
|
314
|
+
`references/framework-own-rows-declaration-api.md`.
|
|
315
|
+
|
|
316
|
+
Own rows confine READING and the write's reach. An act that only the owner may
|
|
317
|
+
perform whatever their role (only the requester may submit their request, even
|
|
318
|
+
though the procurement office reads it) is still a check in that operation's
|
|
319
|
+
hook: reading a row is not the right to act on it.
|
|
320
|
+
|
|
321
|
+
### The rows ABOUT an owner's record: name the owner on them
|
|
322
|
+
|
|
323
|
+
A workflow item collects rows other people write about it: the decisions on a
|
|
324
|
+
request, the assessments of a claim. The person the item belongs to must often
|
|
325
|
+
read them (a refusal's reason is written for the requester) and must never read
|
|
326
|
+
the ones about a colleague's item. Confine them with own rows too, on a field
|
|
327
|
+
of THEIR OWN that names the person they are addressed to:
|
|
328
|
+
|
|
329
|
+
- Add a user foreign key (`requesterUserId`) to the decision, and copy it from
|
|
330
|
+
the item when the decision is recorded, beside the item's unit. The item's
|
|
331
|
+
owner never changes, so the copy cannot drift.
|
|
332
|
+
- Declare own rows on it for the member role, and give the decision's READ and
|
|
333
|
+
LIST that role. Keep the unit narrowing the decision already has: the
|
|
334
|
+
approvers keep their department, and finance keeps everything.
|
|
335
|
+
- Do not reach the decisions "through" the item instead. Own rows match a field
|
|
336
|
+
on the row itself, and nothing confines a row by whether its caller may read
|
|
337
|
+
the row it references. A nested route under the item filters by the item id
|
|
338
|
+
the caller NAMES, which any member can name, so it confines nothing.
|
|
339
|
+
|
|
340
|
+
A decision that names nobody (an item raised by a machine principal) is read by
|
|
341
|
+
no requester, never by every one. See `references/framework-own-rows-declaration-api.md`.
|
|
342
|
+
|
|
343
|
+
## Assigned rows: when the row does not name its person
|
|
344
|
+
|
|
345
|
+
Some rows belong to whoever is ASSIGNED to them, and the assignment is a row of
|
|
346
|
+
another resource: the engagements a staff member is put on, the matters a lawyer
|
|
347
|
+
works. Declare **assigned rows** for that, as an `organizationAssignedRows` map
|
|
348
|
+
beside `organizationOwnRows`:
|
|
349
|
+
|
|
350
|
+
- `assignmentResourceType` — the resource whose rows assign a user to a row of
|
|
351
|
+
this one, organization-scoped and stored by the engine.
|
|
352
|
+
- `assignedRowIdField` and `assigneeUserIdField` — on an assignment, the
|
|
353
|
+
top-level foreign keys naming the assigned row and the assigned user.
|
|
354
|
+
- `assignmentStatusField` and `liveAssignmentStatuses` — which assignments
|
|
355
|
+
count. An ended assignment kept as evidence then confers nothing.
|
|
356
|
+
- `confinedRowField` (optional) — for rows that hang off the assigned thing
|
|
357
|
+
rather than being it (the documents of an engagement): the field of the row
|
|
358
|
+
that the assignment's `assignedRowIdField` value is matched against, instead
|
|
359
|
+
of the row's id. Both fields must then be top-level, not foreign keys.
|
|
360
|
+
- `organizationWideRoles` — the roles whose organization-wide grant reaches
|
|
361
|
+
EVERY row, typically the administrator role. A held role keeps every row when
|
|
362
|
+
it is, or inherits, one of them; every other role is confined to its holder's
|
|
363
|
+
assigned rows — a member, a manager, any role you add. This is the reverse of
|
|
364
|
+
own rows' `roles`, on purpose: a role you add later is confined until you name
|
|
365
|
+
it here, rather than seeing every row until someone remembers to list it.
|
|
366
|
+
|
|
367
|
+
The same depth rules as own rows otherwise: never an admission, a principal with
|
|
368
|
+
no user reaches nothing, a chart and a scope room refuse a confined role. The assigned rows are read on
|
|
369
|
+
every request, so ending an assignment takes the row away on the next one. A
|
|
370
|
+
member cannot create a row matched on its own id (no assignment can name a row
|
|
371
|
+
before it exists). With `confinedRowField`, a create or an update that sets the
|
|
372
|
+
field must name a value one of their live assignments names, and emptying it is
|
|
373
|
+
refused, so no write moves a row to a client they do not serve. A
|
|
374
|
+
resource that declares assigned rows declares nothing else: unit narrowing and
|
|
375
|
+
own rows compose (above), assigned rows stand alone.
|
|
376
|
+
The engine declares two itself: a representing organization's member reads only
|
|
377
|
+
the client relationships they hold an active assignment for, and those clients'
|
|
378
|
+
mailboxes, so do not redeclare `organizationRepresentations` or
|
|
379
|
+
`relationshipMailboxes`. The contract is in
|
|
380
|
+
`references/framework-assigned-rows-declaration-api.md`.
|
|
381
|
+
|
|
382
|
+
### What confinement does not hide
|
|
383
|
+
|
|
384
|
+
Units, own rows and assigned rows confine which rows a member READS and WRITES.
|
|
385
|
+
Two engine behaviours still tell a confined member that a row exists, the same
|
|
386
|
+
for all three:
|
|
387
|
+
|
|
388
|
+
- linking a new row to a parent checks that the parent exists without the
|
|
389
|
+
member's confinement, so naming a colleague's request or an unassigned client
|
|
390
|
+
as a parent succeeds, and the link reveals the id is real;
|
|
391
|
+
- retrieval (RAG) ranks over every row before dropping the ones the member may
|
|
392
|
+
not read, and reports how many it dropped.
|
|
393
|
+
|
|
394
|
+
If either matters for a resource, gate the linking operation or the retrieval
|
|
395
|
+
source above the confined role.
|
|
396
|
+
|
|
252
397
|
## The Containment Rule (this one is enforced, not advisory)
|
|
253
398
|
|
|
254
399
|
**A resource that issues authority may never be governed by the authority it
|
|
@@ -347,6 +492,12 @@ Three consequences worth knowing before you see them:
|
|
|
347
492
|
- [ ] A member with a sufficient organization-wide role still sees **every** row
|
|
348
493
|
(opting in must not shrink anything)
|
|
349
494
|
- [ ] The resource specification documents the confinement
|
|
495
|
+
- [ ] With own rows declared: a member holding only the declared role lists only
|
|
496
|
+
the rows they own, and the read operations' `roles` include that role (a
|
|
497
|
+
declaration on a resource members cannot read confines nobody)
|
|
498
|
+
- [ ] With own rows declared beside unit narrowing: a member who also holds the
|
|
499
|
+
declared role ON A UNIT (a directory placement) still lists only their
|
|
500
|
+
own rows, never the unit's
|
|
350
501
|
|
|
351
502
|
### Grep invariants
|
|
352
503
|
|
|
@@ -358,6 +509,9 @@ Run from the app root, substituting `<resource>` and `<field>`:
|
|
|
358
509
|
| The declared field exists on the schema | `rg -n "<field>" shared-lib/src/modules/*/**/<resource>*.schemas.ts` |
|
|
359
510
|
| **No authorization-plane resource is declared** (must be empty) | see the commands below the table |
|
|
360
511
|
| The specification mentions the confinement | `rg -n -i "organization unit" specifications/src/modules/*/resources/<resource>.resource.specification.ts` |
|
|
512
|
+
| An own-rows declaration exists, beside the unit one | `rg -n "organizationOwnRows" backend-api/src` |
|
|
513
|
+
| An assigned-rows declaration exists where rows belong to whoever is assigned | `rg -n "organizationAssignedRows" backend-api/src` |
|
|
514
|
+
| The owner organization's chart is declared, not clicked in | `rg -n "organizationIdentity" backend-api/src` |
|
|
361
515
|
|
|
362
516
|
```bash
|
|
363
517
|
# No authorization-plane resource is declared (must be empty)
|
|
@@ -380,6 +534,7 @@ loudly, while a misspelled field name is the one mistake that fails quietly.
|
|
|
380
534
|
| "Turning on the SCIM department mapping is additive, so it's safe to try." | It makes the directory AUTHORITATIVE: every push replaces the member's unit assignments, including ones an admin created by hand. Enable it only where the directory is genuinely the source of truth for org structure. |
|
|
381
535
|
| "I'll set `defaultUnitRole` now and declare the department mapping later." | `defaultUnitRole` on its own enables GROUP provisioning, so the directory can start creating units and granting that role in them before you have declared anything. Set it when you mean it, not in advance. |
|
|
382
536
|
| "The directory's group is called Sales and we already have a Sales unit, so it will use ours." | It will not, deliberately. Group provisioning only ever touches units it created; a name match adopts nothing. Matching on a name would let anyone who can create a directory group take over an existing unit's membership, and unit membership is an access grant. |
|
|
537
|
+
| "Members should see their own rows, so I'll add a custom 'my items' list that filters on the creator." | That list holds only on the route you wrote. MCP and A2A tools, context population and every other read reach the resource through the core reads, unfiltered. Declare `organizationOwnRows` and let members use the core LIST and READ. |
|
|
383
538
|
| "A unit role is basically an organization role limited to a subset, so I can use it anywhere." | It only has effect on resources that opted in. On every other resource a unit role confers nothing at all, by design — that containment is what keeps a single unit's role from becoming tenant-wide authority. |
|
|
384
539
|
|
|
385
540
|
## Red Flags
|
|
@@ -400,7 +555,10 @@ loudly, while a misspelled field name is the one mistake that fails quietly.
|
|
|
400
555
|
its whole branch (catch with the **declaration exists** grep plus a look at the
|
|
401
556
|
unit's position, and confirm against the inherited-units field in the access
|
|
402
557
|
record).
|
|
403
|
-
-
|
|
558
|
+
- A hand-written "my items" operation filters on the creator while the core LIST
|
|
559
|
+
is closed to members — the own-rows tier hand-rolled, leaking through every
|
|
560
|
+
other read path (catch with the **own-rows declaration exists** grep).
|
|
561
|
+
- The resource specification says nothing about the confinement while the startup file
|
|
404
562
|
enforces it — the product's access rules exist only in code (catch with the
|
|
405
563
|
**specification mentions** grep).
|
|
406
564
|
|
|
@@ -408,6 +566,13 @@ loudly, while a misspelled field name is the one mistake that fails quietly.
|
|
|
408
566
|
|
|
409
567
|
- `references/framework-unit-narrowing-declaration-api.md` — the declaration
|
|
410
568
|
contract and the resources that may never be declared (source-backed).
|
|
569
|
+
- `references/framework-own-rows-declaration-api.md` — the own-rows declaration
|
|
570
|
+
contract (source-backed).
|
|
571
|
+
- `references/framework-assigned-rows-declaration-api.md` — the assigned-rows
|
|
572
|
+
declaration contract (source-backed).
|
|
573
|
+
- `references/framework-organization-identity-declaration-api.md` — the owner
|
|
574
|
+
organization's units, directory mapping and SSO posture, declared and applied
|
|
575
|
+
at boot (source-backed).
|
|
411
576
|
|
|
412
577
|
## Related Skills
|
|
413
578
|
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# Assigned rows — declaration contract (source)
|
|
2
|
+
|
|
3
|
+
Read this when declaring that members reach only the rows they are ASSIGNED to
|
|
4
|
+
through another resource (the engagements a person is staffed on, the matters a
|
|
5
|
+
lawyer works), or when startup refuses an assigned-rows declaration.
|
|
6
|
+
|
|
7
|
+
- **`OrganizationAssignedRowsDeclaration`** — the per-resource shape: the
|
|
8
|
+
assignment resource, the two fields on an assignment naming the assigned row
|
|
9
|
+
and the assigned user, which assignment statuses count, and the roles whose
|
|
10
|
+
organization-wide grant reaches every row (every other role is confined).
|
|
11
|
+
Optionally the field of the confined row to match against instead of its id
|
|
12
|
+
(`confinedRowField`). Declared as an
|
|
13
|
+
`organizationAssignedRows` map keyed by resource type in the configuration
|
|
14
|
+
passed to application startup, beside `organizationOwnRows`.
|
|
15
|
+
- **What it never does** — admit anyone. The operation's own roles still decide
|
|
16
|
+
who may call it; the declaration decides how far a declared role reaches.
|
|
17
|
+
- **Assigned rows stand alone** — a resource that declares assigned rows declares
|
|
18
|
+
neither own rows nor unit narrowing. (Own rows and unit narrowing compose with
|
|
19
|
+
each other.)
|
|
20
|
+
|
|
21
|
+
## Import Origins
|
|
22
|
+
|
|
23
|
+
- `@wildo-ai/saas-models`
|
|
24
|
+
|
|
25
|
+
## Source Excerpts
|
|
26
|
+
|
|
27
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
28
|
+
|
|
29
|
+
```typescript
|
|
30
|
+
*
|
|
31
|
+
* How one organization-scoped resource confines a principal to the rows they are assigned to, through another resource.
|
|
32
|
+
*
|
|
33
|
+
* Import from `@wildo-ai/saas-models`. Declare it by passing an `organizationAssignedRows` map to application startup,
|
|
34
|
+
* keyed by resource type, beside `organizationOwnRows`:
|
|
35
|
+
*
|
|
36
|
+
* ```ts
|
|
37
|
+
* organizationAssignedRows: {
|
|
38
|
+
* [MyResourceType.ENGAGEMENTS]: {
|
|
39
|
+
* assignmentResourceType: MyResourceType.ENGAGEMENT_STAFFING,
|
|
40
|
+
* assignedRowIdField: 'engagementId',
|
|
41
|
+
* assigneeUserIdField: 'userId',
|
|
42
|
+
* assignmentStatusField: 'status',
|
|
43
|
+
* liveAssignmentStatuses: [StaffingStatus.ACTIVE],
|
|
44
|
+
* organizationWideRoles: [CORE_ORG_ROLES.ORG_ADMIN],
|
|
45
|
+
* },
|
|
46
|
+
* }
|
|
47
|
+
* ```
|
|
48
|
+
*
|
|
49
|
+
* - `assignmentResourceType` is the resource whose rows assign a user to a row of this one. It must be organization-scoped
|
|
50
|
+
* and stored by the engine, in the same organization as the rows it assigns.
|
|
51
|
+
* - `assignedRowIdField` names the field on an assignment holding the assigned row's id; `assigneeUserIdField` the field
|
|
52
|
+
* holding the assigned user's id. Both are top-level foreign keys of the assignment resource.
|
|
53
|
+
* - `confinedRowField` (optional) matches the assignment's value against a field of the confined row instead of its id:
|
|
54
|
+
* for a resource whose rows hang off the assigned thing rather than being it (the mailboxes of a client relationship,
|
|
55
|
+
* matched on the relationship id the assignment also carries). Both fields are then top-level, and need not be foreign
|
|
56
|
+
* keys.
|
|
57
|
+
* - `assignmentStatusField` and `liveAssignmentStatuses` say which assignments count: only those whose status is one of the
|
|
58
|
+
* listed values. An ended assignment kept as evidence then confers nothing.
|
|
59
|
+
* - `organizationWideRoles` are the roles whose ORGANIZATION-WIDE grant reaches every row, typically the administrator
|
|
60
|
+
* role. A held role reaches every row when it is, or inherits, one of them (so an owner, who inherits the administrator
|
|
61
|
+
* role, does too). EVERY other role is confined to its holder's assigned rows: a member, a manager, a role the
|
|
62
|
+
* application adds.
|
|
63
|
+
*
|
|
64
|
+
* Declaring this changes nothing about WHO may call an operation. A caller confined to assigned rows cannot create a row
|
|
65
|
+
* matched on its own id (no assignment can name a row before it exists). With `confinedRowField`, a create or an update
|
|
66
|
+
* that sets the field must name a value one of the caller's live assignments names, and emptying it is refused, so a
|
|
67
|
+
* write never moves a row to a client the caller does not serve. A principal with no user (an API key, an OAuth client)
|
|
68
|
+
* is assigned nothing, so a declared role reaches no row for it.
|
|
69
|
+
*
|
|
70
|
+
* A resource that declares assigned rows declares no other confinement. (Own rows and unit narrowing compose with each
|
|
71
|
+
* other: a department head reaches their department's rows and their own.)
|
|
72
|
+
*/
|
|
73
|
+
export type OrganizationAssignedRowsDeclaration = {
|
|
74
|
+
/** The resource whose rows assign a user to a row of this resource. */
|
|
75
|
+
readonly assignmentResourceType: string;
|
|
76
|
+
/** On an assignment: the field holding the assigned row's id, or the value `confinedRowField` is matched against. */
|
|
77
|
+
readonly assignedRowIdField: string;
|
|
78
|
+
/**
|
|
79
|
+
* On the confined row: the field the assignment's `assignedRowIdField` value is matched against. Absent: the row's own
|
|
80
|
+
* id. See {@link resolveAssignedRowsConfinedField}.
|
|
81
|
+
*/
|
|
82
|
+
readonly confinedRowField?: string;
|
|
83
|
+
/** On an assignment: the field holding the assigned user's id. */
|
|
84
|
+
readonly assigneeUserIdField: string;
|
|
85
|
+
/** On an assignment: the field holding its status. */
|
|
86
|
+
readonly assignmentStatusField: string;
|
|
87
|
+
/** The statuses of an assignment that confers reach. */
|
|
88
|
+
readonly liveAssignmentStatuses: readonly string[];
|
|
89
|
+
/** The roles whose organization-wide grant reaches every row; every other role reaches only its holder's assigned rows. */
|
|
90
|
+
readonly organizationWideRoles: readonly string[];
|
|
91
|
+
};
|
|
92
|
+
```
|