@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
package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md
CHANGED
|
@@ -37,8 +37,13 @@ Pick the start point that names that moment for this resource; the class decides
|
|
|
37
37
|
- **Every owned edge into a statutory resource authors `IMPERSONALIZE_AND_RETAIN`.** A silent edge is DELETE on
|
|
38
38
|
a parent delete (a hard user delete, the tenant purge) and would destroy the records; a disabled or
|
|
39
39
|
`REFUSE_WHILE_CHILDREN_EXIST` edge leaves them unrestricted after an erasure. Startup refuses all three.
|
|
40
|
-
- **A statutory ground refuses `
|
|
41
|
-
|
|
40
|
+
- **A statutory ground refuses `LAST_UPDATED`.** The restriction write itself would restart an `updatedAt` clock.
|
|
41
|
+
- **A statutory ground refuses `CLOSURE_EVENT` unless a restricted record can still be closed.** An erasure
|
|
42
|
+
freezes a restricted row, so a record still open when its subject is erased would never close and would be
|
|
43
|
+
kept forever. Either name the closure field in `retentionPolicy.retainedRowCompletion.fields` (with a
|
|
44
|
+
rationale: the closure date names nobody) and let the close operation record a retained record's closure
|
|
45
|
+
(see below), or declare `statutoryRetention.staysInUseBecause` when these records are never restricted.
|
|
46
|
+
This is how a period counted from the end of a contract, a matter or a case is declared.
|
|
42
47
|
- **No `.ttl()` beside a binding.** One row, one retention authority; `.ttl()` is for framework plumbing.
|
|
43
48
|
- **A service-resolvable `DELETE_MANY` or `DELETE`.** The sweep deletes through the service layer so
|
|
44
49
|
cascades, file release and RAG chunk removal run. An `INTERNAL_CALL` variant is route-less and enough.
|
|
@@ -53,3 +58,10 @@ Pick the start point that names that moment for this resource; the class decides
|
|
|
53
58
|
must drop any closure date the caller sent: a caller reaching the service tier through a loose parse
|
|
54
59
|
(an MCP tool call) can still carry one, and an authoritative field preserves whatever the handler
|
|
55
60
|
passes through.
|
|
61
|
+
- For a statutory `CLOSURE_EVENT` record declared through `retainedRowCompletion`, an erasure may have
|
|
62
|
+
restricted the record while it was open, and a restricted record reads as absent to the close operation.
|
|
63
|
+
In that case the close operation calls `closeRetainedRecordAsSystem(resourceType, id, closedAt)` on the
|
|
64
|
+
system-access service (`utils.systemAccessService` in a custom implementation, passing the organization as
|
|
65
|
+
`scopeContext` when the resource is organization-scoped). It writes only the closure date, only where it
|
|
66
|
+
is still null, on a retained row, and answers whether it closed one; the row stays restricted and the
|
|
67
|
+
sweep deletes it at closure + period.
|
|
@@ -282,7 +282,7 @@ shared schema declares the **truth**, the UI behavior file declares the
|
|
|
282
282
|
- `references/decorator-layer-map.md` — decide which file/layer owns the next change
|
|
283
283
|
- `references/shared-layer-decorator-checklist.md` — common structural decorator patterns
|
|
284
284
|
- `references/field-type-selection.md` — choose between primitive, enum, FK, and factory shapes
|
|
285
|
-
- `references/special-factories.md` — dedicated `z_*` factory choices
|
|
285
|
+
- `references/special-factories.md` — dedicated `z_*` factory choices, and dates: always `z.date()`, `jsonParsingSchemaOf` for JSON your own code parses
|
|
286
286
|
- `references/document-numbers.md` — server-allocated, gapless document numbers (`.documentSequence`), allocated at create or by an issuing operation (source-backed)
|
|
287
287
|
- `references/computed-totals.md` — totals and other values the server computes: stored and server-owned (prefix + `authoritativeFields`) versus `.isVirtual()`, with a worked quote total, and a parent total kept right when its lines are their own resource (source-backed)
|
|
288
288
|
- `references/schema-variants-and-discriminators.md` — schema-family guidance
|
|
@@ -534,7 +534,10 @@ What to know before choosing it:
|
|
|
534
534
|
*
|
|
535
535
|
* A prefix that authors a server-owned field (one marked `.excludeFromCreate()` /
|
|
536
536
|
* `.excludeFromUpdate()`) relies on `preserveServerInjectedFields` to carry that value past the
|
|
537
|
-
* repository's strict `requestDto` re-parse.
|
|
537
|
+
* repository's strict `requestDto` re-parse. So does a prefix that sets a value BELOW a field: the
|
|
538
|
+
* request contract strips an `.isBackendOnly()` field at every depth, so the re-parse of the
|
|
539
|
+
* containing field drops what the prefix put there. Declare the TOP-LEVEL field that contains it
|
|
540
|
+
* (an SSO connection's prefix parses `saml.x509Certificates` from a PEM, and declares `saml`). That allow-list is normally derived by diffing the
|
|
538
541
|
* prefix output against a snapshot of the payload keys taken BEFORE the prefix ran, so only keys
|
|
539
542
|
* the hook *introduced* are preserved — which is what stops a client smuggling a value into a
|
|
540
543
|
* field it may not write.
|
|
@@ -104,7 +104,8 @@ For an EXPLICIT sequence, the issuing operation's custom implementation numbers
|
|
|
104
104
|
`issueDocumentSequenceNumberInOperation`, which reserves the number and writes it in one transaction. Register the
|
|
105
105
|
implementation with `transactionalCore: true`, and name the counters in its `transactionParticipants` with the exported
|
|
106
106
|
constant `DOCUMENT_SEQUENCE_COUNTERS_RESOURCE_TYPE` (never the string). Issuing an already-numbered row throws a
|
|
107
|
-
CONFLICT and consumes no number
|
|
107
|
+
CONFLICT and consumes no number (`error.code` `DocumentSequenceRefusalCode.ROW_ALREADY_NUMBERED`, worded by its own
|
|
108
|
+
`customMessageReference`, so the person reads that the document already has its number):
|
|
108
109
|
|
|
109
110
|
## Import Origins
|
|
110
111
|
|
|
@@ -152,7 +153,7 @@ export async function issueDocumentSequenceNumberInOperation(
|
|
|
152
153
|
},
|
|
153
154
|
): Promise<string> {
|
|
154
155
|
return issueDocumentSequenceNumber({
|
|
155
|
-
registry: utils
|
|
156
|
+
registry: engineRepositoriesRegistry(utils),
|
|
156
157
|
errorBuilder: utils.errorBuilder,
|
|
157
158
|
resourceType: input.resourceType,
|
|
158
159
|
mainSchema: utils.resourcesRegistry.getResourceConfiguration(input.resourceType).mainSchema,
|
|
@@ -175,6 +176,12 @@ Two cases, both handled by raising a sequence's counter, never by writing number
|
|
|
175
176
|
| A field that already held numbers gains `.documentSequence(...)` | `raiseDocumentSequenceFloorsToExistingRows({ …, rows })`, once, from a migration script | each organization and period continues after the highest number its rows hold, so no new number collides with an old one |
|
|
176
177
|
|
|
177
178
|
- It only raises. A floor below the counter is refused, because lowering it would hand out numbers already issued.
|
|
179
|
+
- Every refusal a person can act on carries a `DocumentSequenceRefusalCode` in `error.code` and words of its own
|
|
180
|
+
(`customMessageReference`): `FLOOR_BELOW_COUNTER` and `COUNTER_MOVED` are 409s, `FLOOR_INVALID` and
|
|
181
|
+
`FLOOR_PERIOD_INVALID` are 400s. Declare the ones your operation can raise in its specification's `errorScenarios`
|
|
182
|
+
(`customMessageReference: ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_BELOW_COUNTER`, …) so the published
|
|
183
|
+
reference names them; a client branches on `error.code`. None names a form field: the counter is not a field of your operation's form, and the counter's value
|
|
184
|
+
is not in the response, so ask the person for a higher number rather than showing one.
|
|
178
185
|
- The engine has no endpoint for it. Your operation decides who may do it and what the trail keeps:
|
|
179
186
|
- **Who**: mount the operation under `/organizations/{organizationId}/…` with your organization administrator role
|
|
180
187
|
for an ORGANIZATION sequence. `raiseDocumentSequenceFloorInOperation` takes the organization from that route and
|
|
@@ -183,8 +190,13 @@ Two cases, both handled by raising a sequence's counter, never by writing number
|
|
|
183
190
|
- **Why**: a required, bounded `justification` string in the request DTO, declared with
|
|
184
191
|
`auditableEvent: { reasonField: 'justification' }`, and a `HIGH` or `CRITICAL` risk level. The trail records who ran
|
|
185
192
|
it, when, and the justification.
|
|
186
|
-
- **
|
|
187
|
-
|
|
193
|
+
- **What**: the engine records the move itself. Once your operation's transaction commits, a raise that moved the
|
|
194
|
+
counter writes a `DOCUMENT_SEQUENCE_FLOOR_RAISED` row with the resource, the field, the scope and organization, the
|
|
195
|
+
period and `previousValue` → `value`, attributed to your operation's caller. A refused raise, a raise that kept the
|
|
196
|
+
counter (`raised: false`) and a raise whose transaction rolled back record nothing. You do not ask for the floor in
|
|
197
|
+
the justification. `raiseDocumentSequenceFloorInOperation` reads the audit service from `utils`; a direct call to
|
|
198
|
+
`raiseDocumentSequenceFloor` or `raiseDocumentSequenceFloorsToExistingRows` passes it as the required `auditLogs`
|
|
199
|
+
(`servicesRegistry.getAuditLogsService()`), and a raise with none is refused rather than run unrecorded.
|
|
188
200
|
- Register it with `transactionalCore: true` and the counters as a participant, like the "issue" operation.
|
|
189
201
|
- **Which rows to pass** to `raiseDocumentSequenceFloorsToExistingRows`: every row of the resource, in every
|
|
190
202
|
organization, read without the caller's organization filter. A row left out keeps its number, so the counter can
|
|
@@ -210,14 +222,14 @@ Two cases, both handled by raising a sequence's counter, never by writing number
|
|
|
210
222
|
* pass `floor: 417` and the next is INV-2026-00418), or when a field that already held numbers gains
|
|
211
223
|
* `.documentSequence(...)` (see `raiseDocumentSequenceFloorsToExistingRows`).
|
|
212
224
|
*
|
|
213
|
-
* It only RAISES. A floor below the counter is refused (`
|
|
225
|
+
* It only RAISES. A floor below the counter is refused (409, `DocumentSequenceRefusalCode.FLOOR_BELOW_COUNTER`), because lowering it
|
|
214
226
|
* would hand out numbers already issued; pass `whenBelowCounter: KEEP_COUNTER` to keep the counter instead. Raising
|
|
215
227
|
* skips numbers on purpose: the numbers between the old counter and the floor must exist in the other system or in the
|
|
216
228
|
* existing rows.
|
|
217
229
|
*
|
|
218
230
|
* It runs in the caller's transaction and refuses without one. It serializes with documents numbered at the same
|
|
219
231
|
* moment: on PostgreSQL it waits on the counter's row lock, and on MongoDB the transaction is retried. A
|
|
220
|
-
* compare-and-set on the counter's value backs that up (`
|
|
232
|
+
* compare-and-set on the counter's value backs that up (409, `DocumentSequenceRefusalCode.COUNTER_MOVED`), so a stale read can never
|
|
221
233
|
* overwrite a number already handed out.
|
|
222
234
|
*
|
|
223
235
|
* From an operation, call {@link raiseDocumentSequenceFloorInOperation}. The engine exposes no endpoint for it, so your
|
|
@@ -229,9 +241,12 @@ Two cases, both handled by raising a sequence's counter, never by writing number
|
|
|
229
241
|
* - **Why**: put a required, bounded `justification` string in the request DTO and declare
|
|
230
242
|
* `auditableEvent: { reasonField: 'justification' }`, with a `HIGH` or `CRITICAL` risk level. The trail then records
|
|
231
243
|
* who ran it, when, and the justification.
|
|
232
|
-
* - **What
|
|
233
|
-
*
|
|
234
|
-
*
|
|
244
|
+
* - **What**: the engine records the move itself. Once the transaction commits, a raise that moved the counter writes
|
|
245
|
+
* a `DOCUMENT_SEQUENCE_FLOOR_RAISED` row naming the resource, the field, the scope (and organization), the period and
|
|
246
|
+
* `previousValue` → `value`, attributed to the operation's caller. A refused raise, a raise to the counter's own value
|
|
247
|
+
* and a kept counter (`raised: false`) record nothing, and a raise whose transaction rolls back records nothing.
|
|
248
|
+
* `raiseDocumentSequenceFloorInOperation` takes the audit service from `utils`; called directly, the raise takes it as
|
|
249
|
+
* the required `auditLogs`, and refuses to run where none is bound.
|
|
235
250
|
*
|
|
236
251
|
* Import from `@wildo-ai/saas-backend-lib`.
|
|
237
252
|
*
|
|
@@ -263,31 +278,48 @@ export async function raiseDocumentSequenceFloor(input: {
|
|
|
263
278
|
readonly whenBelowCounter?: DocumentSequenceFloorBelowCounter;
|
|
264
279
|
readonly executionContext: ExecutionContext<any>;
|
|
265
280
|
readonly options: RepositoryOptions | undefined;
|
|
281
|
+
/** Records the move once the transaction commits. Required: see {@link DocumentSequenceFloorRaiseAuditLogs}. */
|
|
282
|
+
readonly auditLogs: DocumentSequenceFloorRaiseAuditLogs;
|
|
266
283
|
/** Only used to default `periodKey`. */
|
|
267
284
|
readonly now?: Date;
|
|
268
285
|
}): Promise<DocumentSequenceFloorRaise> {
|
|
269
286
|
const { registry, errorBuilder, executionContext, resourceType } = input;
|
|
287
|
+
// A wiring or internal fault, for the logs: its context never reaches the client.
|
|
270
288
|
const refuse = (type: ErrorType, reason: string, extra: Record<string, unknown> = {}) =>
|
|
271
|
-
errorBuilder.buildError(type, executionContext, { context: { reason, resourceType,
|
|
289
|
+
errorBuilder.buildError(type, executionContext, { context: { reason, resourceType, sequenceFieldName: input.fieldName, ...extra } });
|
|
290
|
+
// A refusal of the REQUEST (#3081): its code reaches the client, and its reference words it. It names no field: the
|
|
291
|
+
// sequence's field is not a field of the operation's form, so it travels as `sequenceFieldName`, a diagnostic.
|
|
292
|
+
const refuseRequest = (
|
|
293
|
+
type: ErrorType.CONFLICT | ErrorType.VALIDATION,
|
|
294
|
+
code: DocumentSequenceRefusalCode,
|
|
295
|
+
customMessageReference: ErrorCustomMessageReference,
|
|
296
|
+
extra: Record<string, unknown> = {},
|
|
297
|
+
) => errorBuilder.buildError(type, executionContext, {
|
|
298
|
+
customMessageReference,
|
|
299
|
+
context: { code, resourceType, sequenceFieldName: input.fieldName, ...extra },
|
|
300
|
+
});
|
|
272
301
|
const field = documentSequenceFieldsOf(input.mainSchema).find((candidate) => candidate.fieldName === input.fieldName);
|
|
273
302
|
if (field === undefined) throw refuse(ErrorType.CONFIGURATION, 'document_sequence_field_not_declared');
|
|
274
|
-
if (!Number.isSafeInteger(input.floor) || input.floor < 0) throw
|
|
303
|
+
if (!Number.isSafeInteger(input.floor) || input.floor < 0) throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_INVALID, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_INVALID, { floor: input.floor });
|
|
275
304
|
const transaction = input.options?.transaction;
|
|
276
305
|
if (transaction === undefined) throw refuse(ErrorType.CONFIGURATION, 'document_sequence_requires_transaction');
|
|
306
|
+
// The type requires it; a JavaScript caller or a cast could still pass nothing, and the raise must not move a counter
|
|
307
|
+
// it cannot record.
|
|
308
|
+
if (typeof input.auditLogs?.logDocumentSequenceFloorRaised !== 'function') throw refuse(ErrorType.CONFIGURATION, 'document_sequence_floor_raise_without_audit');
|
|
277
309
|
|
|
278
310
|
const isOrganizationSequence = field.params.scope === DocumentSequenceScope.ORGANIZATION;
|
|
279
311
|
const organizationId = input.organizationId;
|
|
280
312
|
if (isOrganizationSequence && (typeof organizationId !== 'string' || organizationId.length === 0)) {
|
|
281
|
-
throw
|
|
313
|
+
throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_WITHOUT_ORGANIZATION, ErrorCustomMessageReference.VALIDATION);
|
|
282
314
|
}
|
|
283
315
|
// An organization named for an APPLICATION sequence would be silently ignored, and the floor applied to everyone.
|
|
284
|
-
if (!isOrganizationSequence && organizationId !== undefined) throw
|
|
316
|
+
if (!isOrganizationSequence && organizationId !== undefined) throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_ORGANIZATION_FOR_APPLICATION_SEQUENCE, ErrorCustomMessageReference.VALIDATION);
|
|
285
317
|
const scopeKey = isOrganizationSequence ? organizationId! : DOCUMENT_SEQUENCE_APPLICATION_SCOPE_KEY;
|
|
286
318
|
|
|
287
319
|
const parsed = parseDocumentSequenceFormat(field.params.format);
|
|
288
320
|
const periodKey = input.periodKey
|
|
289
321
|
?? documentSequencePeriodKey(parsed, input.now ?? new Date(), await organizationTimeZone(input, field, scopeKey, new Map()));
|
|
290
|
-
if (!PERIOD_KEY_SHAPE[parsed.period].test(periodKey)) throw
|
|
322
|
+
if (!PERIOD_KEY_SHAPE[parsed.period].test(periodKey)) throw refuseRequest(ErrorType.VALIDATION, DocumentSequenceRefusalCode.FLOOR_PERIOD_INVALID, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_PERIOD_INVALID, { periodKey, period: parsed.period });
|
|
291
323
|
|
|
292
324
|
const _id = await ensureDocumentSequenceCounter(registry, executionContext, transaction, { resourceType, fieldName: field.fieldName, scopeKey, periodKey });
|
|
293
325
|
const current = await registry.readUnscopedByKey<DocumentSequenceCounter>(COUNTERS, { _id }, { transaction });
|
|
@@ -298,11 +330,30 @@ export async function raiseDocumentSequenceFloor(input: {
|
|
|
298
330
|
if ((input.whenBelowCounter ?? DocumentSequenceFloorBelowCounter.REFUSE) === DocumentSequenceFloorBelowCounter.KEEP_COUNTER) {
|
|
299
331
|
return { previousValue, value: previousValue, raised: false };
|
|
300
332
|
}
|
|
301
|
-
throw
|
|
333
|
+
throw refuseRequest(ErrorType.CONFLICT, DocumentSequenceRefusalCode.FLOOR_BELOW_COUNTER, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_FLOOR_BELOW_COUNTER, { floor: input.floor, counter: previousValue, periodKey });
|
|
302
334
|
}
|
|
303
335
|
// Compare-and-set: a number allocated since the read moves the value, and this write then matches nothing.
|
|
304
336
|
const written = await registry.atomicGuardedMutation<DocumentSequenceCounter>(COUNTERS, { _id, value: previousValue }, { set: { value: input.floor } }, undefined, { transaction });
|
|
305
|
-
if (written === null) throw
|
|
337
|
+
if (written === null) throw refuseRequest(ErrorType.CONFLICT, DocumentSequenceRefusalCode.COUNTER_MOVED, ErrorCustomMessageReference.DOCUMENT_SEQUENCE_COUNTER_MOVED, { periodKey });
|
|
338
|
+
// #2657: the move is recorded once the transaction commits, never before. The audit store is not part of this
|
|
339
|
+
// transaction, so a row written now would survive a rollback and describe a raise that never happened; a retried
|
|
340
|
+
// MongoDB attempt gets a fresh context, so only the attempt that commits records. Keyed per counter, so one transaction
|
|
341
|
+
// raising several sequences records each. The post-commit lane never throws into the committed caller, and
|
|
342
|
+
// `_createAuditLog` reports a failed write rather than failing the request (the raise has landed by then).
|
|
343
|
+
const auditLogs = input.auditLogs;
|
|
344
|
+
const event = {
|
|
345
|
+
resourceType,
|
|
346
|
+
fieldName: field.fieldName,
|
|
347
|
+
scope: field.params.scope,
|
|
348
|
+
...(isOrganizationSequence ? { organizationId: scopeKey } : {}),
|
|
349
|
+
periodKey,
|
|
350
|
+
previousValue,
|
|
351
|
+
value: input.floor,
|
|
352
|
+
};
|
|
353
|
+
registerTransactionPostCommitEffect(transaction, {
|
|
354
|
+
key: ['document-sequence-floor-raised', _id, transaction.id].join(':'),
|
|
355
|
+
execute: () => auditLogs.logDocumentSequenceFloorRaised(event, executionContext),
|
|
356
|
+
});
|
|
306
357
|
return { previousValue, value: input.floor, raised: true };
|
|
307
358
|
}
|
|
308
359
|
|
|
@@ -318,6 +369,8 @@ export async function raiseDocumentSequenceFloorInOperation(
|
|
|
318
369
|
readonly repositoriesRegistry: RepositoriesRegistryHandlerBackendService;
|
|
319
370
|
readonly errorBuilder: ErrorBuilderBackendService;
|
|
320
371
|
readonly resourcesRegistry: { getResourceConfiguration(resourceType: string): { mainSchema: z.ZodTypeAny } };
|
|
372
|
+
/** Where the audit service is read from (#2657): an operation's `utils.servicesRegistry`. */
|
|
373
|
+
readonly servicesRegistry: { getAuditLogsService(): DocumentSequenceFloorRaiseAuditLogs | undefined };
|
|
321
374
|
readonly serviceOptions?: { readonly transaction?: RepositoryOptions['transaction'] };
|
|
322
375
|
},
|
|
323
376
|
input: {
|
|
@@ -333,8 +386,15 @@ export async function raiseDocumentSequenceFloorInOperation(
|
|
|
333
386
|
const field = documentSequenceFieldsOf(mainSchema).find((candidate) => candidate.fieldName === input.fieldName);
|
|
334
387
|
const routeOrganizationId = input.executionContext.getContextResourceId(coreResourceShared_FieldIdentifier[CoreResourceType.ORGANIZATIONS]);
|
|
335
388
|
const isOrganizationSequence = field?.params.scope === DocumentSequenceScope.ORGANIZATION;
|
|
389
|
+
const auditLogs = utils.servicesRegistry.getAuditLogsService();
|
|
390
|
+
// Fail closed: a container that binds no audit service cannot record the move, so it may not make it.
|
|
391
|
+
if (auditLogs === undefined) {
|
|
392
|
+
throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, input.executionContext, {
|
|
393
|
+
context: { reason: 'document_sequence_floor_raise_without_audit', resourceType: input.resourceType, sequenceFieldName: input.fieldName },
|
|
394
|
+
});
|
|
395
|
+
}
|
|
336
396
|
return raiseDocumentSequenceFloor({
|
|
337
|
-
registry: utils
|
|
397
|
+
registry: engineRepositoriesRegistry(utils),
|
|
338
398
|
errorBuilder: utils.errorBuilder,
|
|
339
399
|
resourceType: input.resourceType,
|
|
340
400
|
mainSchema,
|
|
@@ -346,6 +406,7 @@ export async function raiseDocumentSequenceFloorInOperation(
|
|
|
346
406
|
...(input.whenBelowCounter === undefined ? {} : { whenBelowCounter: input.whenBelowCounter }),
|
|
347
407
|
executionContext: input.executionContext,
|
|
348
408
|
options: utils.serviceOptions?.transaction === undefined ? undefined : { transaction: utils.serviceOptions.transaction },
|
|
409
|
+
auditLogs,
|
|
349
410
|
});
|
|
350
411
|
}
|
|
351
412
|
```
|
|
@@ -16,6 +16,7 @@ follow later.
|
|
|
16
16
|
| Money, file, range, duration, phone, postal address, code, big decimal | dedicated `z_*` factory | The framework already has richer semantics for these shapes. |
|
|
17
17
|
| Postal address | `z_address(options?)` — never a `z.string()` | Parts are validated and normalised, the country is an ISO code, two spellings of one place compare equal (`isSameAddress`), and the form and display fields are the framework's. |
|
|
18
18
|
| A calendar day (a due date, a birthday, an invoice or expense date, a start or end date) | `z.date().isCalendarDate()` | A plain `Date` is an INSTANT, and an instant falls on a different day in another time zone: a due date picked as 3 Oct in Paris read 2 Oct in New York. Declared, it is held as UTC midnight of the day, picked and shown as that day for every reader, and "tomorrow" is measured from the reader's own today. |
|
|
19
|
+
| A month (a monthly budget's period, a billing month, a reporting month) | `z_yearMonth()` — never a `z.date()` pinned to the 1st, never a bare `z.string()` | Stored `YYYY-MM`, validated on every write, so it sorts as text, joins a compound unique key (one budget per department per month) and no reader's zone moves it into the neighbouring month. Read as "October 2026" in the reader's language, picked as a month and a year, and a list filter over it is a month picker whose chip names the month — or two, for a range of months, when the filter declares `Resources_Filter_YearMonthRangeSchema`. |
|
|
19
20
|
| A moment in time (`createdAt`, `expiresAt`, `completedAt`, `occurredAt`) | `z.date()` — no declaration | An instant, shown in the reader's time zone and locale: their own preferences (member, then organization) when signed in, their browser's when they have no account. Add `.dateTimeUI()` when the time of day is part of the fact; without it the instant is shown as its day. |
|
|
20
21
|
|
|
21
22
|
## Enum Rule
|
|
@@ -58,6 +59,7 @@ Open `special-factories.md` when the field is not "just a primitive":
|
|
|
58
59
|
- monetary value with currency/precision semantics
|
|
59
60
|
- file upload reference
|
|
60
61
|
- range (`from`/`to`)
|
|
62
|
+
- a calendar month with no day (`YYYY-MM`) — `z_yearMonth()`
|
|
61
63
|
- duration value + unit
|
|
62
64
|
- phone number normalization
|
|
63
65
|
- postal address (street, city, postal code, country, optional geocode)
|
|
@@ -156,6 +156,19 @@ export enum ZodDecorator {
|
|
|
156
156
|
* not marked. No check runs over an application's resources yet: there the marker documents the field.
|
|
157
157
|
*/
|
|
158
158
|
IS_DECIDER = "isDecider",
|
|
159
|
+
/**
|
|
160
|
+
* Role grant: this field's values are roles the WRITER grants (a membership's `roles`, a machine credential's
|
|
161
|
+
* `roles`, a unit assignment's `role`, an account's `appRoles`). A pure marker, read back with
|
|
162
|
+
* `isRoleGrantField(schema)`.
|
|
163
|
+
*
|
|
164
|
+
* What it changes: a form offers only the roles the person filling it may grant (#3248), decided by the rule the
|
|
165
|
+
* server's role-ceiling gate applies (`resolveRoleGrantCeiling` in `@wildo-ai/saas-models`), plus any role the
|
|
166
|
+
* record already holds, so a stored role is never dropped from view. It grants nothing and refuses nothing: the
|
|
167
|
+
* server gate on the write is the control, and the marker only keeps the form from offering what that gate refuses.
|
|
168
|
+
* Mark a field that a form offers roles in, where a write of it is checked against the writer's ceiling. A role
|
|
169
|
+
* grant typed as free text (an SSO connection's `roleMapping`) offers no roles, so marking it would narrow nothing.
|
|
170
|
+
*/
|
|
171
|
+
IS_ROLE_GRANT = "isRoleGrant",
|
|
159
172
|
/**
|
|
160
173
|
* RAG source: this field's TEXT is a retrieval-corpus source. The framework chunks the value
|
|
161
174
|
* (extracting text first for file fields), stores the chunks in the application's OWN datastore
|
|
@@ -227,6 +240,11 @@ export enum ZodDecorator {
|
|
|
227
240
|
* (single field vs composite). Mixing is rejected at decoration time.
|
|
228
241
|
*/
|
|
229
242
|
OBJECT_BUSINESS_KEY_SET = "businessKeySet",
|
|
243
|
+
/**
|
|
244
|
+
* Object-level: one NON-unique index over several fields, for reads that filter on the leading fields and sort on
|
|
245
|
+
* the last (#3142). Accumulates: each call declares one more index. See {@link CompoundIndexParams}.
|
|
246
|
+
*/
|
|
247
|
+
OBJECT_COMPOUND_INDEX = "compoundIndex",
|
|
230
248
|
/**
|
|
231
249
|
* Object-level: the object (`{ resourceType, resourceId }`) names one row of a resource whose type is chosen at
|
|
232
250
|
* run time from a published target set. See {@link ResourceReferenceParams}.
|
|
@@ -345,6 +363,7 @@ export type ZodDecorator_ParamsType = {
|
|
|
345
363
|
// Last-action-record marker — parameterless: a field either records the last action or is state.
|
|
346
364
|
[ZodDecorator.IS_LAST_ACTION_RECORD]: undefined;
|
|
347
365
|
[ZodDecorator.IS_DECIDER]: undefined;
|
|
366
|
+
[ZodDecorator.IS_ROLE_GRANT]: undefined;
|
|
348
367
|
/**
|
|
349
368
|
* RAG-source declaration. The config object is optional — `.ragSource()` with no argument is a
|
|
350
369
|
* complete declaration — and the chokepoint normalizes an omitted config to `{}` so every reader
|
|
@@ -363,6 +382,8 @@ export type ZodDecorator_ParamsType = {
|
|
|
363
382
|
[ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
|
|
364
383
|
// Composite business key (object-level decorator carrying the ordered list of field names)
|
|
365
384
|
[ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams | DecoratorUpdater<BusinessKeySetParams>;
|
|
385
|
+
// One more compound index per call (the stored metadata is the accumulated list)
|
|
386
|
+
[ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams;
|
|
366
387
|
[ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
|
|
367
388
|
[ZodDecorator.TTL]: TtlFieldParams | DecoratorUpdater<TtlFieldParams>;
|
|
368
389
|
// String edit mode convenience decorators
|
|
@@ -447,6 +468,7 @@ export type ZodDecorator_Types = {
|
|
|
447
468
|
/** Last-action-record marker — stored as the bare `true` sentinel (parameterless, like IS_AUDIT_EVIDENCE). */
|
|
448
469
|
[ZodDecorator.IS_LAST_ACTION_RECORD]: true;
|
|
449
470
|
[ZodDecorator.IS_DECIDER]: true;
|
|
471
|
+
[ZodDecorator.IS_ROLE_GRANT]: true;
|
|
450
472
|
/** RAG-source config — ALWAYS the normalized object ( `{}` when authored with no argument): the
|
|
451
473
|
* chokepoint validates and normalizes on the way in, so every reader sees one shape and
|
|
452
474
|
* `getRagSourceConfig` can answer "is this field a source?" by presence alone. */
|
|
@@ -463,6 +485,8 @@ export type ZodDecorator_Types = {
|
|
|
463
485
|
[ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
|
|
464
486
|
// Composite business key (object-level — stored params shape after resolver unwraps DecoratorUpdater)
|
|
465
487
|
[ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams;
|
|
488
|
+
// Every compound index the object declares, in declaration order
|
|
489
|
+
[ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams[];
|
|
466
490
|
[ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
|
|
467
491
|
[ZodDecorator.TTL]: TtlFieldParams;
|
|
468
492
|
// String edit mode convenience decorators
|
|
@@ -557,6 +581,7 @@ export interface CustomFieldMetadata {
|
|
|
557
581
|
[ZodDecorator.IS_AUDIT_EVIDENCE]?: ZodDecorator_Types[ZodDecorator.IS_AUDIT_EVIDENCE];
|
|
558
582
|
[ZodDecorator.IS_LAST_ACTION_RECORD]?: ZodDecorator_Types[ZodDecorator.IS_LAST_ACTION_RECORD];
|
|
559
583
|
[ZodDecorator.IS_DECIDER]?: ZodDecorator_Types[ZodDecorator.IS_DECIDER];
|
|
584
|
+
[ZodDecorator.IS_ROLE_GRANT]?: ZodDecorator_Types[ZodDecorator.IS_ROLE_GRANT];
|
|
560
585
|
[ZodDecorator.RAG_SOURCE]?: ZodDecorator_Types[ZodDecorator.RAG_SOURCE];
|
|
561
586
|
[ZodDecorator.IS_VIRTUAL]?: ZodDecorator_Types[ZodDecorator.IS_VIRTUAL];
|
|
562
587
|
[ZodDecorator.IS_DISCRIMINATOR]?: ZodDecorator_Types[ZodDecorator.IS_DISCRIMINATOR];
|
|
@@ -568,6 +593,7 @@ export interface CustomFieldMetadata {
|
|
|
568
593
|
[ZodDecorator.IS_BUSINESS_KEY]?: ZodDecorator_Types[ZodDecorator.IS_BUSINESS_KEY];
|
|
569
594
|
[ZodDecorator.DOCUMENT_SEQUENCE]?: ZodDecorator_Types[ZodDecorator.DOCUMENT_SEQUENCE];
|
|
570
595
|
[ZodDecorator.OBJECT_BUSINESS_KEY_SET]?: ZodDecorator_Types[ZodDecorator.OBJECT_BUSINESS_KEY_SET];
|
|
596
|
+
[ZodDecorator.OBJECT_COMPOUND_INDEX]?: ZodDecorator_Types[ZodDecorator.OBJECT_COMPOUND_INDEX];
|
|
571
597
|
[ZodDecorator.RESOURCE_REFERENCE]?: ZodDecorator_Types[ZodDecorator.RESOURCE_REFERENCE];
|
|
572
598
|
[ZodDecorator.TTL]?: ZodDecorator_Types[ZodDecorator.TTL];
|
|
573
599
|
// String edit mode convenience decorators
|
|
@@ -299,52 +299,6 @@ export function isPersonalDataAboutAnotherParty(schema: z.ZodTypeAny): boolean {
|
|
|
299
299
|
|
|
300
300
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
301
301
|
|
|
302
|
-
```typescript
|
|
303
|
-
*
|
|
304
|
-
* Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
|
|
305
|
-
* enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
|
|
306
|
-
*
|
|
307
|
-
* Accepts a single category (the common case) or an array when a field genuinely spans two. At
|
|
308
|
-
* least one is required: a field that holds NO personal data carries no declaration at all, and
|
|
309
|
-
* that absence is exactly what the compliance gap report reads.
|
|
310
|
-
*
|
|
311
|
-
* Declare it on the field that holds the value. Never on a field merely because its NAME suggests
|
|
312
|
-
* a category — `credentials` is the one category the framework derives for you, and it derives it
|
|
313
|
-
* from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
|
|
314
|
-
*
|
|
315
|
-
* `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
|
|
316
|
-
* for a field that is personal data only on some rows. The case it exists for is a field naming
|
|
317
|
-
* the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
|
|
318
|
-
* party is a sole trader, and a company's when it is not. The field still counts as personal data
|
|
319
|
-
* for erasure, export and every guard; the privacy notice lists it as held "where the customer is
|
|
320
|
-
* an individual" instead of claiming it about every customer. Do not use it for a field naming a
|
|
321
|
-
* person AT a company (a contact's email): that is personal on every row.
|
|
322
|
-
*
|
|
323
|
-
* `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
|
|
324
|
-
* copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
|
|
325
|
-
* a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
|
|
326
|
-
* such a copy. Leave it off the row's own party's name (a customer account's own name), which that
|
|
327
|
-
* resource may not keep.
|
|
328
|
-
*
|
|
329
|
-
* @example
|
|
330
|
-
* fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
|
|
331
|
-
* @example
|
|
332
|
-
* email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
|
|
333
|
-
* @example
|
|
334
|
-
* // A field that genuinely spans two — an array never forces you to pick a lie.
|
|
335
|
-
* dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
|
|
336
|
-
* @example
|
|
337
|
-
* // A customer account's name: a person's data only when the customer is a sole trader.
|
|
338
|
-
* accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
|
|
339
|
-
* @example
|
|
340
|
-
* // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
|
|
341
|
-
* customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
|
|
342
|
-
*/
|
|
343
|
-
[ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<T>;
|
|
344
|
-
```
|
|
345
|
-
|
|
346
|
-
### Origin Package: `@wildo-ai/zod-decorators`
|
|
347
|
-
|
|
348
302
|
```typescript
|
|
349
303
|
*/
|
|
350
304
|
export function addDataCategories<T extends z.ZodTypeAny>(
|
|
@@ -358,3 +312,49 @@ export function addDataCategories<T extends z.ZodTypeAny>(
|
|
|
358
312
|
]);
|
|
359
313
|
}
|
|
360
314
|
```
|
|
315
|
+
|
|
316
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
317
|
+
|
|
318
|
+
```typescript
|
|
319
|
+
*
|
|
320
|
+
* Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
|
|
321
|
+
* enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
|
|
322
|
+
*
|
|
323
|
+
* Accepts a single category (the common case) or an array when a field genuinely spans two. At
|
|
324
|
+
* least one is required: a field that holds NO personal data carries no declaration at all, and
|
|
325
|
+
* that absence is exactly what the compliance gap report reads.
|
|
326
|
+
*
|
|
327
|
+
* Declare it on the field that holds the value. Never on a field merely because its NAME suggests
|
|
328
|
+
* a category — `credentials` is the one category the framework derives for you, and it derives it
|
|
329
|
+
* from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
|
|
330
|
+
*
|
|
331
|
+
* `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
|
|
332
|
+
* for a field that is personal data only on some rows. The case it exists for is a field naming
|
|
333
|
+
* the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
|
|
334
|
+
* party is a sole trader, and a company's when it is not. The field still counts as personal data
|
|
335
|
+
* for erasure, export and every guard; the privacy notice lists it as held "where the customer is
|
|
336
|
+
* an individual" instead of claiming it about every customer. Do not use it for a field naming a
|
|
337
|
+
* person AT a company (a contact's email): that is personal on every row.
|
|
338
|
+
*
|
|
339
|
+
* `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
|
|
340
|
+
* copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
|
|
341
|
+
* a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
|
|
342
|
+
* such a copy. Leave it off the row's own party's name (a customer account's own name), which that
|
|
343
|
+
* resource may not keep.
|
|
344
|
+
*
|
|
345
|
+
* @example
|
|
346
|
+
* fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
|
|
347
|
+
* @example
|
|
348
|
+
* email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
|
|
349
|
+
* @example
|
|
350
|
+
* // A field that genuinely spans two — an array never forces you to pick a lie.
|
|
351
|
+
* dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
|
|
352
|
+
* @example
|
|
353
|
+
* // A customer account's name: a person's data only when the customer is a sole trader.
|
|
354
|
+
* accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
|
|
355
|
+
* @example
|
|
356
|
+
* // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
|
|
357
|
+
* customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
|
|
358
|
+
*/
|
|
359
|
+
[ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<this>;
|
|
360
|
+
```
|
package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md
CHANGED
|
@@ -45,6 +45,11 @@ export interface SchemaFamilyConfig<
|
|
|
45
45
|
* built. The client tells the variants apart by this field, and a response that withheld it from every variant
|
|
46
46
|
* could not be parsed by anyone. Remove the declaration; if the value really is sensitive, it cannot be the
|
|
47
47
|
* discriminator.
|
|
48
|
+
*
|
|
49
|
+
* A `.default(value)` on the base field means a record that leaves the discriminator out IS a `value` record: the
|
|
50
|
+
* family's union, and every create request derived from it, fill it in, so a client may omit the field exactly as
|
|
51
|
+
* the published schema says. An update never fills it: a partial update that leaves the discriminator out keeps the
|
|
52
|
+
* record's own variant.
|
|
48
53
|
*/
|
|
49
54
|
field: TDiscriminatorField;
|
|
50
55
|
/**
|
|
@@ -211,12 +216,22 @@ export function createSchemaFamily<
|
|
|
211
216
|
// Build discriminated union - use any to avoid Zod 4 type complexity
|
|
212
217
|
const allVariantSchemas: z.ZodObject<z.ZodRawShape>[] = [];
|
|
213
218
|
|
|
219
|
+
// The default the base field declares is what a record that omits the discriminator IS (#2076). Each union member's
|
|
220
|
+
// literal replaces the base field, so the member holding that value must carry the default itself, in the one shape a
|
|
221
|
+
// Zod 4 discriminated union can route an absent key by: see `withDeclaredFamilyDiscriminatorDefault`. Only the UNION
|
|
222
|
+
// members carry it; `variants` and `inheritenceSchemaDefinition` describe one variant each, where the literal names it.
|
|
223
|
+
const declaredDiscriminatorDefault = declaredFamilyDiscriminatorDefault(baseShape[discriminator.field]);
|
|
224
|
+
const unionMemberDiscriminator = (value: string) => withDeclaredFamilyDiscriminatorDefault(
|
|
225
|
+
discriminatorLiteralFor(discriminator.field, value, baseShape[discriminator.field], resolvedBaseValues),
|
|
226
|
+
declaredDiscriminatorDefault,
|
|
227
|
+
);
|
|
228
|
+
|
|
214
229
|
// Add base schemas for baseValues
|
|
215
230
|
// Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals
|
|
216
231
|
for (const value of resolvedBaseValues || []) {
|
|
217
232
|
allVariantSchemas.push(
|
|
218
233
|
base.extend({
|
|
219
|
-
[discriminator.field]:
|
|
234
|
+
[discriminator.field]: unionMemberDiscriminator(value)
|
|
220
235
|
}) as z.ZodObject<z.ZodRawShape>
|
|
221
236
|
);
|
|
222
237
|
}
|
|
@@ -226,7 +241,7 @@ export function createSchemaFamily<
|
|
|
226
241
|
for (const [value, schema] of Object.entries(extendedVariants)) {
|
|
227
242
|
allVariantSchemas.push(
|
|
228
243
|
schema.extend({
|
|
229
|
-
[discriminator.field]:
|
|
244
|
+
[discriminator.field]: unionMemberDiscriminator(value)
|
|
230
245
|
}) as z.ZodObject<z.ZodRawShape>
|
|
231
246
|
);
|
|
232
247
|
}
|
|
@@ -10,6 +10,12 @@ Use it when you need to confirm:
|
|
|
10
10
|
- that the same methods remain available after common wrappers like `.default()` and `.optional()`
|
|
11
11
|
- which methods are the right shared-layer primitives before any UI/spec follow-up
|
|
12
12
|
|
|
13
|
+
Which of these a field offers depends on its schema type, and only on that. A decorator returns the
|
|
14
|
+
schema's own type, so `z.enum(...).isDBIndexed()` offers what an enum offers: `.isUnique()` and
|
|
15
|
+
`.isPrimaryKey()` are not on an enum, and the chain does not compile. If the compiler says a decorator
|
|
16
|
+
does not exist on a type, it does not exist there at run time either; put the constraint on a field
|
|
17
|
+
whose type carries it (for a compound unique key, `organizationId.isUnique({ compoundWith: 'unit' })`).
|
|
18
|
+
|
|
13
19
|
## Shared Structural Methods
|
|
14
20
|
|
|
15
21
|
## Import Origins
|
|
@@ -170,6 +176,27 @@ Use it when you need to confirm:
|
|
|
170
176
|
},
|
|
171
177
|
]);
|
|
172
178
|
},
|
|
179
|
+
// compoundIndex (#3142): one more NON-unique index over several fields of this object. Validated at decoration time,
|
|
180
|
+
// like businessKeySet, so an index cannot name a field the row does not carry; storage would otherwise build an index
|
|
181
|
+
// over a path that is always empty, or the SQL plan would refuse at migration time, far from the declaration.
|
|
182
|
+
compoundIndex: function(this: z.ZodTypeAny, fields: string[]): DecoratedPrimitiveZodType<z.ZodTypeAny> {
|
|
183
|
+
if (!Array.isArray(fields) || fields.length < 2) {
|
|
184
|
+
throw new Error(
|
|
185
|
+
`compoundIndex([...]) needs at least two field names (received ${JSON.stringify(fields)}); a one-field index is .isDBIndexed() on the field.`,
|
|
186
|
+
);
|
|
187
|
+
}
|
|
188
|
+
const repeated = fields.filter((field, index) => fields.indexOf(field) !== index);
|
|
189
|
+
if (repeated.length > 0) {
|
|
190
|
+
throw new Error(`compoundIndex([...]) names a field more than once: ${[...new Set(repeated)].join(', ')}.`);
|
|
191
|
+
}
|
|
192
|
+
const node = this as unknown as { shape?: Record<string, unknown>; _zod?: { def?: { shape?: Record<string, unknown> } } };
|
|
193
|
+
const shape = node.shape ?? node._zod?.def?.shape;
|
|
194
|
+
const missing = fields.filter((field) => !shape || !(field in shape));
|
|
195
|
+
if (missing.length > 0) {
|
|
196
|
+
throw new Error(`compoundIndex([...]) references field(s) not present in the schema shape: ${missing.join(', ')}.`);
|
|
197
|
+
}
|
|
198
|
+
return addDecorators(this, [{ ref: ZodDecorator.OBJECT_COMPOUND_INDEX, params: { fields: [...fields] } }]);
|
|
199
|
+
},
|
|
173
200
|
// isResourceReference (#2471): the object names one row of a resource chosen at run time. Validated at decoration
|
|
174
201
|
// time, like businessKeySet: the object must HAVE the two members the reference is read through, or a form would
|
|
175
202
|
// offer a picker that writes into fields the schema does not carry.
|
|
@@ -192,30 +219,15 @@ Use it when you need to confirm:
|
|
|
192
219
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
193
220
|
|
|
194
221
|
```typescript
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
[ZodDecorator.IS_PRIMARY_KEY](): DecoratedPrimitiveZodType<T>;
|
|
205
|
-
[ZodDecorator.IS_BUSINESS_KEY](): DecoratedPrimitiveZodType<T>;
|
|
206
|
-
[ZodDecorator.DOCUMENT_SEQUENCE](params: DocumentSequenceParams): DecoratedPrimitiveZodType<T>;
|
|
207
|
-
[ZodDecorator.OBJECT_BUSINESS_KEY_SET](fields: string[], params?: Omit<BusinessKeySetParams, 'fields'>): DecoratedPrimitiveZodType<T>;
|
|
208
|
-
[ZodDecorator.RESOURCE_REFERENCE](params: ResourceReferenceParams): DecoratedPrimitiveZodType<T>;
|
|
209
|
-
[ZodDecorator.TTL](params: ZodDecorator_ParamsType[ZodDecorator.TTL]): DecoratedPrimitiveZodType<T>;
|
|
210
|
-
/**
|
|
211
|
-
* `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
|
|
212
|
-
* instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
|
|
213
|
-
* their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
|
|
214
|
-
* (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
|
|
215
|
-
* A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
|
|
216
|
-
* loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
|
|
217
|
-
*/
|
|
218
|
-
[ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<T>;
|
|
222
|
+
/**
|
|
223
|
+
* `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
|
|
224
|
+
* instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
|
|
225
|
+
* their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
|
|
226
|
+
* (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
|
|
227
|
+
* A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
|
|
228
|
+
* loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
|
|
229
|
+
*/
|
|
230
|
+
[ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<this>;
|
|
219
231
|
```
|
|
220
232
|
|
|
221
233
|
### Origin Package: `@wildo-ai/zod-decorators`
|