@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -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 |
|
|
@@ -33,9 +34,10 @@ schema plan, owe no migration, and are never checked at boot:
|
|
|
33
34
|
|
|
34
35
|
- `persistenceAdapter: HTTP_API` — read through from another system, which keeps the rows;
|
|
35
36
|
- `persistenceAdapter: INTROSPECTION` — computed from the application itself;
|
|
36
|
-
- `persistenceAdapter: MONGODB` — stored in MongoDB
|
|
37
|
+
- `persistenceAdapter: MONGODB` — stored in MongoDB, which only a MongoDB application
|
|
38
|
+
can declare (an application uses one transactional store).
|
|
37
39
|
|
|
38
|
-
Moving an existing resource to
|
|
40
|
+
Moving an existing resource to a read-through or introspected adapter removes it from the plan, so
|
|
39
41
|
the next migration drops its table. That is DESTRUCTIVE: the runner refuses it until
|
|
40
42
|
you acknowledge it, and any rows the table held are gone. Check the table is empty,
|
|
41
43
|
or copy what you need, before you generate it.
|
|
@@ -43,16 +45,14 @@ or copy what you need, before you generate it.
|
|
|
43
45
|
A resource that declares no adapter takes your application's default, and the plan
|
|
44
46
|
reads that default from every environment you author: it is PostgreSQL when any
|
|
45
47
|
environment persists to PostgreSQL (`applicationDatabase`, which defaults to
|
|
46
|
-
PostgreSQL), and MongoDB only when every environment persists to MongoDB.
|
|
47
|
-
application
|
|
48
|
-
|
|
49
|
-
|
|
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.
|
|
50
52
|
|
|
51
53
|
One lockfile serves all your environments. If they disagree (one on PostgreSQL, one
|
|
52
|
-
on MongoDB), the plan covers what the PostgreSQL environment needs
|
|
53
|
-
environment
|
|
54
|
-
its PostgreSQL database, empty and never read; one with no PostgreSQL resource never
|
|
55
|
-
touches PostgreSQL at all. A table planned and unused costs nothing; a table needed
|
|
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
56
|
and not planned stops that environment's backend from starting.
|
|
57
57
|
|
|
58
58
|
If your MongoDB application already generated a plan that included every undeclared
|
|
@@ -65,4 +65,6 @@ they are empty and acknowledge it.
|
|
|
65
65
|
Resource schemas, decorators, factories, operations, relationships, UI
|
|
66
66
|
behavior and specifications are all adapter-neutral. You author them exactly
|
|
67
67
|
the same way. The only thing PostgreSQL adds is the obligation to ship the
|
|
68
|
-
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
|
|
|
@@ -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]: {
|
|
@@ -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.
|
|
@@ -201,6 +201,15 @@ whose type does not declare `scimProvisioning`: the SCIM API refuses every reque
|
|
|
201
201
|
for such an organization, so no directory can push to it, and no SCIM token can be
|
|
202
202
|
generated for it.
|
|
203
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`.
|
|
212
|
+
|
|
204
213
|
### Step 6 — Update the resource specification
|
|
205
214
|
|
|
206
215
|
Say plainly, in the resource's specification, that the resource is confined by
|
|
@@ -266,7 +275,11 @@ startup:
|
|
|
266
275
|
someone else. Another user foreign key (a requester, an assignee) is allowed;
|
|
267
276
|
it must be a top-level foreign key of the main schema.
|
|
268
277
|
- `roles` — the roles whose ORGANIZATION-WIDE grant reaches only the rows the
|
|
269
|
-
holder owns, typically the default member role.
|
|
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).
|
|
270
283
|
|
|
271
284
|
It is a privilege DEPTH, not an admission. A declared role still has to satisfy
|
|
272
285
|
the operation's own `roles`, so give the read operations the member role when
|
|
@@ -278,6 +291,7 @@ What changes is how far the satisfying role reaches:
|
|
|
278
291
|
| an organization-wide role NOT in `roles` that satisfies the operation (a manager, finance) | every row |
|
|
279
292
|
| a unit role that satisfies it, and a declared role organization-wide | their units' rows **and** their own rows anywhere |
|
|
280
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 |
|
|
281
295
|
| no user (an API key, an OAuth client) with only a declared role | nothing |
|
|
282
296
|
|
|
283
297
|
Depth is a property of the role HELD: a manager whose role inherits the member
|
|
@@ -304,6 +318,28 @@ perform whatever their role (only the requester may submit their request, even
|
|
|
304
318
|
though the procurement office reads it) is still a check in that operation's
|
|
305
319
|
hook: reading a row is not the right to act on it.
|
|
306
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
|
+
|
|
307
343
|
## Assigned rows: when the row does not name its person
|
|
308
344
|
|
|
309
345
|
Some rows belong to whoever is ASSIGNED to them, and the assignment is a row of
|
|
@@ -335,7 +371,8 @@ member cannot create a row matched on its own id (no assignment can name a row
|
|
|
335
371
|
before it exists). With `confinedRowField`, a create or an update that sets the
|
|
336
372
|
field must name a value one of their live assignments names, and emptying it is
|
|
337
373
|
refused, so no write moves a row to a client they do not serve. A
|
|
338
|
-
resource declares
|
|
374
|
+
resource that declares assigned rows declares nothing else: unit narrowing and
|
|
375
|
+
own rows compose (above), assigned rows stand alone.
|
|
339
376
|
The engine declares two itself: a representing organization's member reads only
|
|
340
377
|
the client relationships they hold an active assignment for, and those clients'
|
|
341
378
|
mailboxes, so do not redeclare `organizationRepresentations` or
|
|
@@ -458,6 +495,9 @@ Three consequences worth knowing before you see them:
|
|
|
458
495
|
- [ ] With own rows declared: a member holding only the declared role lists only
|
|
459
496
|
the rows they own, and the read operations' `roles` include that role (a
|
|
460
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
|
|
461
501
|
|
|
462
502
|
### Grep invariants
|
|
463
503
|
|
|
@@ -471,6 +511,7 @@ Run from the app root, substituting `<resource>` and `<field>`:
|
|
|
471
511
|
| The specification mentions the confinement | `rg -n -i "organization unit" specifications/src/modules/*/resources/<resource>.resource.specification.ts` |
|
|
472
512
|
| An own-rows declaration exists, beside the unit one | `rg -n "organizationOwnRows" backend-api/src` |
|
|
473
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` |
|
|
474
515
|
|
|
475
516
|
```bash
|
|
476
517
|
# No authorization-plane resource is declared (must be empty)
|
|
@@ -529,6 +570,9 @@ loudly, while a misspelled field name is the one mistake that fails quietly.
|
|
|
529
570
|
contract (source-backed).
|
|
530
571
|
- `references/framework-assigned-rows-declaration-api.md` — the assigned-rows
|
|
531
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).
|
|
532
576
|
|
|
533
577
|
## Related Skills
|
|
534
578
|
|
|
@@ -14,8 +14,9 @@ lawyer works), or when startup refuses an assigned-rows declaration.
|
|
|
14
14
|
passed to application startup, beside `organizationOwnRows`.
|
|
15
15
|
- **What it never does** — admit anyone. The operation's own roles still decide
|
|
16
16
|
who may call it; the declaration decides how far a declared role reaches.
|
|
17
|
-
- **
|
|
18
|
-
|
|
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.)
|
|
19
20
|
|
|
20
21
|
## Import Origins
|
|
21
22
|
|
|
@@ -66,7 +67,8 @@ lawyer works), or when startup refuses an assigned-rows declaration.
|
|
|
66
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)
|
|
67
68
|
* is assigned nothing, so a declared role reaches no row for it.
|
|
68
69
|
*
|
|
69
|
-
* A resource declares assigned rows
|
|
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.)
|
|
70
72
|
*/
|
|
71
73
|
export type OrganizationAssignedRowsDeclaration = {
|
|
72
74
|
/** The resource whose rows assign a user to a row of this resource. */
|
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
# Organization identity declaration — contract (source)
|
|
2
|
+
|
|
3
|
+
Read this when the application's OWN organization (an internal tool's company) should get its name, its units, its
|
|
4
|
+
directory's department → unit mapping, or its single-sign-on-only posture from committed code rather than from an administrator
|
|
5
|
+
clicking through the settings after every new environment.
|
|
6
|
+
|
|
7
|
+
- **Where it is declared** — `organizationIdentity` in the configuration passed to application startup
|
|
8
|
+
(`backend-api/src/bootstrap-config.ts`), beside `organizationUnitNarrowing`. Keep the object in its own file
|
|
9
|
+
(`backend-api/src/organization-identity.ts`) so scripts and tests can import the same chart.
|
|
10
|
+
- **Which organization** — `OrganizationIdentityDeclarationTarget.APPLICATION_OWNER`: the organization of the type
|
|
11
|
+
that declares `ownsApplication`. There is no "every organization of type X" form.
|
|
12
|
+
- **The name** (`name`) is what every member reads in the breadcrumb and the organization switcher. The platform seeds
|
|
13
|
+
the owner organization as `PLATFORM_SEEDED_ORGANIZATION_PLACEHOLDER_NAME` ("Default Organization"); the backend
|
|
14
|
+
replaces that placeholder with the declared name, through the organization's own audited UPDATE. It writes the name
|
|
15
|
+
only over the placeholder: once the organization is named, a CHANGED `name` is reported as drift and the stored name
|
|
16
|
+
is kept, because an administrator's rename and an earlier declaration's write leave the same row. To adopt the new
|
|
17
|
+
name, rename the organization to it in its settings. Declare it: an internal tool whose company is called "Default
|
|
18
|
+
Organization" tells every employee the set-up was never finished.
|
|
19
|
+
- **Partitions of a system of record** (`systemOfRecordPartitions`) — one `{ system, remoteKey, unitKey }` per remote
|
|
20
|
+
partition of a partitioned instance (an Odoo company). A partition no unit holds loads no rows, so declare each one
|
|
21
|
+
you know; the backend assigns a missing one at boot through `systemOfRecordPartitionAssignments`' own create, keeps
|
|
22
|
+
one an administrator moved (reported as drift), and startup refuses a binding to an instance not declared
|
|
23
|
+
`partition: true`. The keys are the system's own: per environment, like a directory's department names.
|
|
24
|
+
- **Units** are addressed by `key`, which becomes the unit's `code`. A directory binding names a unit by that key; the
|
|
25
|
+
engine resolves it to the unit's id. Never write unit ids into the declaration.
|
|
26
|
+
- **What applying means** — at every boot the backend creates what is missing and reports, without overwriting, what an
|
|
27
|
+
administrator changed: a renamed or moved unit, a department bound to another unit, a role or a posture field set to
|
|
28
|
+
something else. A posture field is applied only while the stored value is still the engine default, so a field an
|
|
29
|
+
administrator sets BACK to its default is applied again at the next boot: relax the posture by changing the
|
|
30
|
+
declaration. What is missing is created again, whoever removed it: to drop a unit or a binding for good, remove it
|
|
31
|
+
from the declaration. An owner that resolves to no single row (several organizations of the owner type) is reported
|
|
32
|
+
at ERROR and nothing is applied; an application that declares no owner type refuses to start.
|
|
33
|
+
- **Stored is not in effect** — the step writes with system authority, so it does not meet the entitlement gate an
|
|
34
|
+
administrator's form meets. It therefore checks afterwards: a `requireSSO` on an organization without the
|
|
35
|
+
`SINGLE_SIGN_ON` entitlement (ignored at sign-in), or a department mapping on one without `DIRECTORY_PROVISIONING`
|
|
36
|
+
(the directory provisions nobody), is reported at ERROR as "stored, but not in effect". A `directory` declared on an
|
|
37
|
+
owner type that does not declare `scimProvisioning: { enabled: true }` refuses startup.
|
|
38
|
+
- **What it never carries** — the SSO connection and its client secret, the SCIM token, a domain's DNS proof and its
|
|
39
|
+
sign-in routing. Those stay runtime records the organization's administrator (or a set-up script) writes.
|
|
40
|
+
- **When it applies** — after the data-seeding passes, in the application backend only, and again whenever the owner
|
|
41
|
+
organization appears while the backend runs. On a fresh installation the owner organization does not exist at the
|
|
42
|
+
first boot: the step logs that it is pending, keeps looking for the owner (for an hour after boot), and applies the
|
|
43
|
+
declaration as soon as the platform seeds it, with no restart. A promotion (`organizations.promoteToOwnerOrganization`)
|
|
44
|
+
that makes a new owner applies it at once. Each owner gets it once per backend process; the next boot is the backstop
|
|
45
|
+
for a write that failed. Its log line names the trigger (`boot` or `owner_appeared`).
|
|
46
|
+
- **Refused at startup** — a duplicate key, an unknown parent, a cycle, a binding to an undeclared unit, a department
|
|
47
|
+
bound twice, a break-glass address listed twice. Its log line is `organization identity declaration`.
|
|
48
|
+
|
|
49
|
+
## Import Origins
|
|
50
|
+
|
|
51
|
+
- `@wildo-ai/saas-models`
|
|
52
|
+
|
|
53
|
+
## Source Excerpts
|
|
54
|
+
|
|
55
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
56
|
+
|
|
57
|
+
```typescript
|
|
58
|
+
/**
|
|
59
|
+
* Which organization an identity declaration describes.
|
|
60
|
+
*
|
|
61
|
+
* Imported from `@wildo-ai/saas-models`. One member today, and the vocabulary is closed on purpose: a declaration
|
|
62
|
+
* describes ONE organization whose chart the application knows when it is written.
|
|
63
|
+
*
|
|
64
|
+
* - `APPLICATION_OWNER` — the organization recorded as the application's owner, the single organization of the type
|
|
65
|
+
* that declares `ownsApplication`. An internal tool's company is this organization.
|
|
66
|
+
*
|
|
67
|
+
* A template applied to every organization of a type ("every customer gets a Sales and a Support unit") is a different
|
|
68
|
+
* contract — a per-tenant default rather than a chart — and is deliberately not expressible here.
|
|
69
|
+
*/
|
|
70
|
+
export enum OrganizationIdentityDeclarationTarget {
|
|
71
|
+
APPLICATION_OWNER = 'application_owner',
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* The name the platform gives the organization it seeds for an application's first administrator, before anybody has
|
|
76
|
+
* named it.
|
|
77
|
+
*
|
|
78
|
+
* Imported from `@wildo-ai/saas-models`. One named value read by both sides: the platform seeds the organization with it,
|
|
79
|
+
* and the identity declaration's `name` replaces it — and only it. A stored name equal to this placeholder means
|
|
80
|
+
* "nobody has named this organization yet", so the current declaration replaces it, the first one or a changed one. Any
|
|
81
|
+
* other stored name is kept, whether a person chose it or an earlier declaration wrote it: the row cannot tell them
|
|
82
|
+
* apart, and the drift report says how to adopt the declared name.
|
|
83
|
+
*/
|
|
84
|
+
export const PLATFORM_SEEDED_ORGANIZATION_PLACEHOLDER_NAME = 'Default Organization';
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* One unit of the declared chart.
|
|
88
|
+
*
|
|
89
|
+
* - `key` becomes the unit's `code` and is how the declaration recognises the unit on every later boot. Unique within
|
|
90
|
+
* the declaration; at most 20 characters, the unit `code` limit.
|
|
91
|
+
* - `kind` is the unit's `type`.
|
|
92
|
+
* - `parentKey` names another declared unit; absent for a unit directly under the organization.
|
|
93
|
+
* - `displayName` is the unit's `name` when the declaration creates it. An administrator may rename it afterwards; the
|
|
94
|
+
* declaration reports the difference and keeps the administrator's name.
|
|
95
|
+
*/
|
|
96
|
+
export const OrganizationIdentityUnitDeclarationSchema = z.object({
|
|
97
|
+
key: z.string().trim().min(1).max(20),
|
|
98
|
+
kind: z.enum(OrganizationUnitType),
|
|
99
|
+
parentKey: z.string().trim().min(1).max(20).optional(),
|
|
100
|
+
displayName: z.string().trim().min(1).max(100),
|
|
101
|
+
}).strict();
|
|
102
|
+
export type OrganizationIdentityUnitDeclaration = z.infer<typeof OrganizationIdentityUnitDeclarationSchema>;
|
|
103
|
+
|
|
104
|
+
/** One binding of a directory `department` value to a declared unit, by the unit's `key`. */
|
|
105
|
+
export const OrganizationIdentityDepartmentBindingSchema = z.object({
|
|
106
|
+
/** The value the directory pushes, e.g. `"Sales"` — matched exactly by the SCIM `/Users` path. */
|
|
107
|
+
directoryValue: z.string().trim().min(1).max(200),
|
|
108
|
+
/** The `key` of the declared unit members with this department are assigned to. */
|
|
109
|
+
unitKey: z.string().trim().min(1).max(20),
|
|
110
|
+
}).strict();
|
|
111
|
+
export type OrganizationIdentityDepartmentBinding = z.infer<typeof OrganizationIdentityDepartmentBindingSchema>;
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* How the organization's directory (SCIM) places the people it provisions.
|
|
115
|
+
*
|
|
116
|
+
* - `departmentUnitMapping` binds each directory department to a declared unit. Declaring it makes the directory
|
|
117
|
+
* AUTHORITATIVE over each member's unit assignments: every push replaces them with what the directory says.
|
|
118
|
+
* - `unitRole` is the role every directory-made unit assignment carries (the provisioning config's `defaultUnitRole`).
|
|
119
|
+
* Required: the department mapping does nothing without it.
|
|
120
|
+
* - `organizationRole` is the organization-wide role a provisioned member receives (`defaultRole`). Never an
|
|
121
|
+
* administrative role: the engine refuses a directory that could mint tenant administrators.
|
|
122
|
+
*/
|
|
123
|
+
export const OrganizationIdentityDirectoryDeclarationSchema = z.object({
|
|
124
|
+
departmentUnitMapping: z.array(OrganizationIdentityDepartmentBindingSchema).min(1),
|
|
125
|
+
unitRole: z.string().trim().min(1),
|
|
126
|
+
organizationRole: z.string().trim().min(1).optional(),
|
|
127
|
+
}).strict();
|
|
128
|
+
export type OrganizationIdentityDirectoryDeclaration = z.infer<typeof OrganizationIdentityDirectoryDeclarationSchema>;
|
|
129
|
+
|
|
130
|
+
/**
|
|
131
|
+
* One remote partition of a system of record, bound to a declared unit (#3066).
|
|
132
|
+
*
|
|
133
|
+
* A partitioned system of record (`systemsOfRecord.<name>.partition: true`) splits its records by a remote partition —
|
|
134
|
+
* Odoo's companies, SAP company codes — and a record reaches a member only through the organization unit its partition
|
|
135
|
+
* is assigned to (`systemOfRecordPartitionAssignments`). Until an assignment exists, the rows of that partition are not
|
|
136
|
+
* loaded at all. Declaring the binding here is what makes a new environment of the application read its system of record
|
|
137
|
+
* on its first boot, instead of waiting for an operator to assign each partition by hand.
|
|
138
|
+
*
|
|
139
|
+
* - `system` is the `systemsOfRecord` instance name, which must be declared and partitioned (startup refuses otherwise).
|
|
140
|
+
* - `remoteKey` is the partition's key AS THE REMOTE SPELLS IT, in canonical text (an Odoo company id `'1'`).
|
|
141
|
+
* - `unitKey` names a declared unit, normally the subsidiary that owns the partition.
|
|
142
|
+
*
|
|
143
|
+
* The binding is per environment by nature, like the directory's department values: it names the remote's own keys. An
|
|
144
|
+
* application whose environments' systems number their partitions differently declares the binding where it builds
|
|
145
|
+
* the declaration for each.
|
|
146
|
+
*/
|
|
147
|
+
export const OrganizationIdentityPartitionBindingSchema = z.object({
|
|
148
|
+
system: z.string().regex(SYSTEM_OF_RECORD_NAME_PATTERN).max(SYSTEM_OF_RECORD_NAME_MAX_LENGTH),
|
|
149
|
+
remoteKey: z.string().trim().min(1).max(SYSTEM_OF_RECORD_REMOTE_KEY_MAX_LENGTH),
|
|
150
|
+
unitKey: z.string().trim().min(1).max(20),
|
|
151
|
+
}).strict();
|
|
152
|
+
export type OrganizationIdentityPartitionBinding = z.infer<typeof OrganizationIdentityPartitionBindingSchema>;
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* The organization's single sign-on posture — the enforcement half only. The connection to the identity provider (with
|
|
156
|
+
* its client secret) and the domain routing (proved by DNS) stay runtime records.
|
|
157
|
+
*
|
|
158
|
+
* - `requireSSO` — members at an SSO-enabled domain must sign in through single sign-on.
|
|
159
|
+
* - `allowPasswordFallback` — `false` refuses every password sign-in except a break-glass account's.
|
|
160
|
+
* - `requireEnterpriseSSOOnly` — every social sign-in provider is refused.
|
|
161
|
+
* - `breakGlassAccounts` — the named accounts that keep a password for the day the identity provider is unreachable.
|
|
162
|
+
* Keep it short: each one is a standing way in with a password alone.
|
|
163
|
+
*/
|
|
164
|
+
export const OrganizationIdentitySingleSignOnDeclarationSchema = z.object({
|
|
165
|
+
requireSSO: z.boolean(),
|
|
166
|
+
allowPasswordFallback: z.boolean(),
|
|
167
|
+
requireEnterpriseSSOOnly: z.boolean(),
|
|
168
|
+
breakGlassAccounts: z.array(z.email()),
|
|
169
|
+
}).strict();
|
|
170
|
+
export type OrganizationIdentitySingleSignOnDeclaration = z.infer<typeof OrganizationIdentitySingleSignOnDeclarationSchema>;
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* Why an identity declaration is refused at startup. Each is a contradiction inside the declaration, so its remedy is
|
|
174
|
+
* an edit to the declaration and the application refuses to start rather than apply half of it.
|
|
175
|
+
*/
|
|
176
|
+
export enum OrganizationIdentityDeclarationViolation {
|
|
177
|
+
/** Two units declare the same `key`. */
|
|
178
|
+
DUPLICATE_UNIT_KEY = 'duplicate_unit_key',
|
|
179
|
+
/** A unit's `parentKey` names no declared unit. */
|
|
180
|
+
UNKNOWN_PARENT_UNIT = 'unknown_parent_unit',
|
|
181
|
+
/** Following `parentKey` from a unit comes back to it. */
|
|
182
|
+
UNIT_PARENT_CYCLE = 'unit_parent_cycle',
|
|
183
|
+
/** A department binding names a `unitKey` no unit declares. */
|
|
184
|
+
MAPPING_TO_UNDECLARED_UNIT = 'mapping_to_undeclared_unit',
|
|
185
|
+
/** Two bindings for the same directory value: the directory could place a member in either. */
|
|
186
|
+
DUPLICATE_DIRECTORY_VALUE = 'duplicate_directory_value',
|
|
187
|
+
/** The same break-glass address twice. */
|
|
188
|
+
DUPLICATE_BREAK_GLASS_ACCOUNT = 'duplicate_break_glass_account',
|
|
189
|
+
/** A partition binding names a `unitKey` no unit declares. */
|
|
190
|
+
PARTITION_TO_UNDECLARED_UNIT = 'partition_to_undeclared_unit',
|
|
191
|
+
/** Two bindings for the same `system` and `remoteKey`: a partition belongs to one unit. */
|
|
192
|
+
DUPLICATE_PARTITION = 'duplicate_partition',
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* The organization identity declaration.
|
|
197
|
+
*
|
|
198
|
+
* Imported from `@wildo-ai/saas-models`. Pass it to application startup as `organizationIdentity`, beside
|
|
199
|
+
* `organizationUnitNarrowing`, in `backend-api/src/bootstrap-config.ts`:
|
|
200
|
+
*
|
|
201
|
+
* ```ts
|
|
202
|
+
* organizationIdentity: {
|
|
203
|
+
* organization: OrganizationIdentityDeclarationTarget.APPLICATION_OWNER,
|
|
204
|
+
* name: 'Wonder Group',
|
|
205
|
+
* units: [
|
|
206
|
+
* { key: 'FR', kind: OrganizationUnitType.COMPANY, displayName: 'Wonder France' },
|
|
207
|
+
* { key: 'FR-SALES', kind: OrganizationUnitType.DEPARTMENT, parentKey: 'FR', displayName: 'Sales' },
|
|
208
|
+
* ],
|
|
209
|
+
* directory: { departmentUnitMapping: [{ directoryValue: 'Sales', unitKey: 'FR-SALES' }], unitRole: CORE_ORG_ROLES.ORG_MEMBER },
|
|
210
|
+
* singleSignOn: { requireSSO: true, allowPasswordFallback: false, requireEnterpriseSSOOnly: true, breakGlassAccounts: ['it-emergency@example.com'] },
|
|
211
|
+
* systemOfRecordPartitions: [{ system: 'odoo', remoteKey: '1', unitKey: 'FR' }],
|
|
212
|
+
* }
|
|
213
|
+
* ```
|
|
214
|
+
*
|
|
215
|
+
* Every part is optional except the target and the unit list (which may be empty). At every boot the application backend
|
|
216
|
+
* creates what is missing — the organization's name while it is still the platform's placeholder, a unit, a department
|
|
217
|
+
* binding, a partition assignment, an absent role, a posture field still at the engine's default — and reports, without overwriting, what an administrator changed. Something missing is created again whoever removed
|
|
218
|
+
* it: to drop a unit or a binding for good, remove it from the declaration. A posture field an administrator set back to
|
|
219
|
+
* its default is applied again; relax the posture by changing the declaration.
|
|
220
|
+
*/
|
|
221
|
+
export const OrganizationIdentityDeclarationSchema = z.object({
|
|
222
|
+
organization: z.enum(OrganizationIdentityDeclarationTarget),
|
|
223
|
+
/**
|
|
224
|
+
* The organization's name — what every member reads in the breadcrumb, the organization switcher and the e-mails.
|
|
225
|
+
* Written only while the stored name is still the platform's placeholder
|
|
226
|
+
* ({@link PLATFORM_SEEDED_ORGANIZATION_PLACEHOLDER_NAME}). Any other stored name — an administrator's, or one an earlier
|
|
227
|
+
* version of this declaration wrote — is kept and reported as drift with its remedy: rename the organization to the
|
|
228
|
+
* declared name, or set this field to the stored one. So changing this field renames the organization only while it
|
|
229
|
+
* still carries the placeholder.
|
|
230
|
+
* At most 100 characters, the organization `name` limit.
|
|
231
|
+
*/
|
|
232
|
+
name: z.string().trim().min(1).max(100).optional(),
|
|
233
|
+
units: z.array(OrganizationIdentityUnitDeclarationSchema),
|
|
234
|
+
directory: OrganizationIdentityDirectoryDeclarationSchema.optional(),
|
|
235
|
+
singleSignOn: OrganizationIdentitySingleSignOnDeclarationSchema.optional(),
|
|
236
|
+
/**
|
|
237
|
+
* The remote partitions of the application's partitioned systems of record, each bound to a declared unit (#3066).
|
|
238
|
+
* A missing assignment is created; a partition an administrator assigned to another unit is kept and reported.
|
|
239
|
+
*/
|
|
240
|
+
systemOfRecordPartitions: z.array(OrganizationIdentityPartitionBindingSchema).optional(),
|
|
241
|
+
}).strict().superRefine((declaration, ctx) => {
|
|
242
|
+
for (const violation of collectOrganizationIdentityDeclarationViolations(declaration)) {
|
|
243
|
+
ctx.addIssue({ code: 'custom', path: violation.path, message: `${violation.violation}: ${violation.detail}` });
|
|
244
|
+
}
|
|
245
|
+
});
|
|
246
|
+
export type OrganizationIdentityDeclaration = z.infer<typeof OrganizationIdentityDeclarationSchema>;
|
|
247
|
+
```
|
|
@@ -5,9 +5,13 @@ startup refuses an own-rows declaration.
|
|
|
5
5
|
|
|
6
6
|
- **`OrganizationOwnRowsDeclaration`** — the per-resource shape: the field naming
|
|
7
7
|
each row's owner, and the roles whose organization-wide grant reaches only the
|
|
8
|
-
holder's own rows. Declared as an `organizationOwnRows` map
|
|
9
|
-
type in the configuration passed to application startup,
|
|
10
|
-
`organizationUnitNarrowing
|
|
8
|
+
holder's own rows (held on a unit, such a role supplies no unit). Declared as an `organizationOwnRows` map
|
|
9
|
+
keyed by resource type in the configuration passed to application startup,
|
|
10
|
+
beside `organizationUnitNarrowing`, with which it composes.
|
|
11
|
+
- **The owner field may be a copy** — a row written ABOUT someone's record (a
|
|
12
|
+
decision on a request) names that person in a field of its own, copied when it
|
|
13
|
+
is written, and is confined on it. Nothing confines a row through the row it
|
|
14
|
+
references.
|
|
11
15
|
- **What it never does** — admit anyone. The operation's own roles still decide
|
|
12
16
|
who may call it; the declaration decides how far a declared role reaches.
|
|
13
17
|
|
|
@@ -37,7 +41,10 @@ startup refuses an own-rows declaration.
|
|
|
37
41
|
* field of the resource's main schema, declared as a foreign key: it becomes a query predicate on every read and a
|
|
38
42
|
* write-time check on every create and update.
|
|
39
43
|
* - `roles` are the roles whose ORGANIZATION-WIDE grant reaches only the holder's own rows on this resource, typically
|
|
40
|
-
* the default member role.
|
|
44
|
+
* the default member role. Held on a UNIT, a declared role supplies no unit and no own rows of its own (#3068): a
|
|
45
|
+
* directory that places every employee in their department with the member role therefore does not open the
|
|
46
|
+
* department's rows to them, and the department is reached through a role that is not listed (the department head's
|
|
47
|
+
* manager role on the unit). A role not listed keeps the depth of its grant: an organization-wide manager or finance
|
|
41
48
|
* role still reaches every row. A role is judged as HELD: a manager whose role inherits the member role is not
|
|
42
49
|
* confined, because what they hold is the manager role.
|
|
43
50
|
*
|
|
@@ -53,7 +60,7 @@ startup refuses an own-rows declaration.
|
|
|
53
60
|
export type OrganizationOwnRowsDeclaration = {
|
|
54
61
|
/** The field on the resource holding the owning user's id. */
|
|
55
62
|
readonly ownerUserIdField: string;
|
|
56
|
-
/** The roles whose organization-wide grant reaches only the holder's own rows on this resource. */
|
|
63
|
+
/** The roles whose organization-wide grant reaches only the holder's own rows on this resource, and which supply no unit. */
|
|
57
64
|
readonly roles: readonly string[];
|
|
58
65
|
};
|
|
59
66
|
```
|