@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
|
@@ -126,6 +126,50 @@ function assertCalendarDateNotDateTime(decorator: ZodDecorator, currentMetadata:
|
|
|
126
126
|
}
|
|
127
127
|
}
|
|
128
128
|
|
|
129
|
+
/**
|
|
130
|
+
* The decorators that mark a value as a SECRET, each with the reason a subject-disclosed backend-only field
|
|
131
|
+
* (`isBackendOnly({ disclosedToSubject: true })`, #2958) may never carry it. One table, consulted in both application
|
|
132
|
+
* orders by {@link assertSubjectDisclosureAdmissible}, at the same chokepoint as the RAG-source pairs, so no door into the
|
|
133
|
+
* metadata bypasses it.
|
|
134
|
+
*/
|
|
135
|
+
const SUBJECT_DISCLOSURE_REFUSED_COMPANIONS: ReadonlyMap<ZodDecorator, string> = new Map([
|
|
136
|
+
[ZodDecorator.IS_PASSWORD, 'a password never leaves the backend, not even to the person it belongs to.'],
|
|
137
|
+
[ZodDecorator.IS_OTP, 'a one-time code never leaves the backend once it was sent.'],
|
|
138
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET, 'a write-only secret is masked on every response, so it is not disclosed to anyone.'],
|
|
139
|
+
[ZodDecorator.IS_EPHEMERAL, 'an ephemeral value is shown once, when it is minted, and never again.'],
|
|
140
|
+
]);
|
|
141
|
+
|
|
142
|
+
/** Whether a stored `IS_BACKEND_ONLY` value declares the subject-disclosure opt-in. */
|
|
143
|
+
function declaresDisclosedToSubject(value: unknown): boolean {
|
|
144
|
+
return typeof value === 'object' && value !== null && (value as BackendOnlyFieldParams).disclosedToSubject === true;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Refuse `isBackendOnly({ disclosedToSubject: true })` on a field that holds a secret, in either order (#2958): applied to
|
|
149
|
+
* a field already marked a secret, applied with `isReturnedAtCreation` (a server-minted secret shown once), or a secret
|
|
150
|
+
* marker applied to a field already opted in. Run after an updater is resolved, so an updater that adds the opt-in is
|
|
151
|
+
* checked too, and before anything is written.
|
|
152
|
+
*/
|
|
153
|
+
function assertSubjectDisclosureAdmissible(decorator: ZodDecorator, params: unknown, currentMetadata: CustomFieldMetadata): void {
|
|
154
|
+
if (decorator === ZodDecorator.IS_BACKEND_ONLY) {
|
|
155
|
+
if (!declaresDisclosedToSubject(params)) return;
|
|
156
|
+
if ((params as BackendOnlyFieldParams).isReturnedAtCreation) {
|
|
157
|
+
throw new Error('isBackendOnly() cannot declare both disclosedToSubject and isReturnedAtCreation: a value returned once at creation is a '
|
|
158
|
+
+ 'server-minted secret, and a subject export never discloses a secret.');
|
|
159
|
+
}
|
|
160
|
+
for (const [companion, reason] of SUBJECT_DISCLOSURE_REFUSED_COMPANIONS) {
|
|
161
|
+
if (currentMetadata[companion] !== undefined) {
|
|
162
|
+
throw new Error(`isBackendOnly({ disclosedToSubject: true }) cannot be combined with ${companion}(): ${reason}`);
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
return;
|
|
166
|
+
}
|
|
167
|
+
const reason = SUBJECT_DISCLOSURE_REFUSED_COMPANIONS.get(decorator);
|
|
168
|
+
if (reason !== undefined && declaresDisclosedToSubject(currentMetadata[ZodDecorator.IS_BACKEND_ONLY])) {
|
|
169
|
+
throw new Error(`${decorator}() cannot be combined with isBackendOnly({ disclosedToSubject: true }): ${reason}`);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
|
|
129
173
|
function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
130
174
|
schema: T,
|
|
131
175
|
decorator: ZodDecorator,
|
|
@@ -155,6 +199,8 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
155
199
|
params = (params as (current: unknown) => unknown)(currentValue) as typeof params;
|
|
156
200
|
resolvedFromUpdater = true;
|
|
157
201
|
}
|
|
202
|
+
// A subject-disclosed backend-only field never holds a secret (#2958). Checked on the RESOLVED params, before any write.
|
|
203
|
+
assertSubjectDisclosureAdmissible(decorator, params, currentMetadata);
|
|
158
204
|
// After function resolution, params is a concrete value (never a function).
|
|
159
205
|
// TypeScript can't narrow this from control flow. Use `rp<D>()` for typed
|
|
160
206
|
// access in cases that read properties; use `p` for simple assignments.
|
|
@@ -314,6 +360,9 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
314
360
|
case ZodDecorator.IS_DECIDER:
|
|
315
361
|
currentMetadata[ZodDecorator.IS_DECIDER] = true;
|
|
316
362
|
break;
|
|
363
|
+
case ZodDecorator.IS_ROLE_GRANT:
|
|
364
|
+
currentMetadata[ZodDecorator.IS_ROLE_GRANT] = true;
|
|
365
|
+
break;
|
|
317
366
|
case ZodDecorator.RAG_SOURCE: {
|
|
318
367
|
// NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A bare `.ragSource()`
|
|
319
368
|
// (the common case) stores `{}` rather than `true`/`undefined`, so every reader sees ONE
|
|
@@ -391,6 +440,17 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
391
440
|
case ZodDecorator.OBJECT_BUSINESS_KEY_SET:
|
|
392
441
|
currentMetadata[ZodDecorator.OBJECT_BUSINESS_KEY_SET] = p;
|
|
393
442
|
break;
|
|
443
|
+
case ZodDecorator.OBJECT_COMPOUND_INDEX: {
|
|
444
|
+
// ACCUMULATES: each call declares one more index. A fresh array, never a push, so the schema this one was
|
|
445
|
+
// derived from keeps its own list (decorators are builders, #1308). The same field list twice is one index.
|
|
446
|
+
const existing = (currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] ?? []) as CompoundIndexParams[];
|
|
447
|
+
const declared = p as CompoundIndexParams;
|
|
448
|
+
const key = declared.fields.join('\u0000');
|
|
449
|
+
currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] = existing.some((index) => index.fields.join('\u0000') === key)
|
|
450
|
+
? existing
|
|
451
|
+
: [...existing, { fields: [...declared.fields] }];
|
|
452
|
+
break;
|
|
453
|
+
}
|
|
394
454
|
case ZodDecorator.RESOURCE_REFERENCE:
|
|
395
455
|
currentMetadata[ZodDecorator.RESOURCE_REFERENCE] = p;
|
|
396
456
|
break;
|
|
@@ -226,52 +226,6 @@ export function isPersonalDataAboutAnotherParty(schema: z.ZodTypeAny): boolean {
|
|
|
226
226
|
|
|
227
227
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
228
228
|
|
|
229
|
-
```typescript
|
|
230
|
-
*
|
|
231
|
-
* Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
|
|
232
|
-
* enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
|
|
233
|
-
*
|
|
234
|
-
* Accepts a single category (the common case) or an array when a field genuinely spans two. At
|
|
235
|
-
* least one is required: a field that holds NO personal data carries no declaration at all, and
|
|
236
|
-
* that absence is exactly what the compliance gap report reads.
|
|
237
|
-
*
|
|
238
|
-
* Declare it on the field that holds the value. Never on a field merely because its NAME suggests
|
|
239
|
-
* a category — `credentials` is the one category the framework derives for you, and it derives it
|
|
240
|
-
* from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
|
|
241
|
-
*
|
|
242
|
-
* `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
|
|
243
|
-
* for a field that is personal data only on some rows. The case it exists for is a field naming
|
|
244
|
-
* the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
|
|
245
|
-
* party is a sole trader, and a company's when it is not. The field still counts as personal data
|
|
246
|
-
* for erasure, export and every guard; the privacy notice lists it as held "where the customer is
|
|
247
|
-
* an individual" instead of claiming it about every customer. Do not use it for a field naming a
|
|
248
|
-
* person AT a company (a contact's email): that is personal on every row.
|
|
249
|
-
*
|
|
250
|
-
* `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
|
|
251
|
-
* copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
|
|
252
|
-
* a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
|
|
253
|
-
* such a copy. Leave it off the row's own party's name (a customer account's own name), which that
|
|
254
|
-
* resource may not keep.
|
|
255
|
-
*
|
|
256
|
-
* @example
|
|
257
|
-
* fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
|
|
258
|
-
* @example
|
|
259
|
-
* email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
|
|
260
|
-
* @example
|
|
261
|
-
* // A field that genuinely spans two — an array never forces you to pick a lie.
|
|
262
|
-
* dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
|
|
263
|
-
* @example
|
|
264
|
-
* // A customer account's name: a person's data only when the customer is a sole trader.
|
|
265
|
-
* accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
|
|
266
|
-
* @example
|
|
267
|
-
* // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
|
|
268
|
-
* customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
|
|
269
|
-
*/
|
|
270
|
-
[ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<T>;
|
|
271
|
-
```
|
|
272
|
-
|
|
273
|
-
### Origin Package: `@wildo-ai/zod-decorators`
|
|
274
|
-
|
|
275
229
|
```typescript
|
|
276
230
|
*/
|
|
277
231
|
export function addDataCategories<T extends z.ZodTypeAny>(
|
|
@@ -285,3 +239,49 @@ export function addDataCategories<T extends z.ZodTypeAny>(
|
|
|
285
239
|
]);
|
|
286
240
|
}
|
|
287
241
|
```
|
|
242
|
+
|
|
243
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
244
|
+
|
|
245
|
+
```typescript
|
|
246
|
+
*
|
|
247
|
+
* Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
|
|
248
|
+
* enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
|
|
249
|
+
*
|
|
250
|
+
* Accepts a single category (the common case) or an array when a field genuinely spans two. At
|
|
251
|
+
* least one is required: a field that holds NO personal data carries no declaration at all, and
|
|
252
|
+
* that absence is exactly what the compliance gap report reads.
|
|
253
|
+
*
|
|
254
|
+
* Declare it on the field that holds the value. Never on a field merely because its NAME suggests
|
|
255
|
+
* a category — `credentials` is the one category the framework derives for you, and it derives it
|
|
256
|
+
* from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
|
|
257
|
+
*
|
|
258
|
+
* `options.personalOnlyWhen` takes a `PersonalDataCondition` (also from `@wildo-ai/saas-models`)
|
|
259
|
+
* for a field that is personal data only on some rows. The case it exists for is a field naming
|
|
260
|
+
* the PARTY a row describes — a customer account, a supplier: it is an individual's data when that
|
|
261
|
+
* party is a sole trader, and a company's when it is not. The field still counts as personal data
|
|
262
|
+
* for erasure, export and every guard; the privacy notice lists it as held "where the customer is
|
|
263
|
+
* an individual" instead of claiming it about every customer. Do not use it for a field naming a
|
|
264
|
+
* person AT a company (a contact's email): that is personal on every row.
|
|
265
|
+
*
|
|
266
|
+
* `options.aboutAnotherParty: true` says the field names a party OTHER than the one the row is about: a
|
|
267
|
+
* copy of another organization's name kept on a cost record or a relationship. It decides only one thing:
|
|
268
|
+
* a resource declaring `retentionPolicy: RETAIN_ONLY` ("no personal data about its own subject") may keep
|
|
269
|
+
* such a copy. Leave it off the row's own party's name (a customer account's own name), which that
|
|
270
|
+
* resource may not keep.
|
|
271
|
+
*
|
|
272
|
+
* @example
|
|
273
|
+
* fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
|
|
274
|
+
* @example
|
|
275
|
+
* email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
|
|
276
|
+
* @example
|
|
277
|
+
* // A field that genuinely spans two — an array never forces you to pick a lie.
|
|
278
|
+
* dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
|
|
279
|
+
* @example
|
|
280
|
+
* // A customer account's name: a person's data only when the customer is a sole trader.
|
|
281
|
+
* accountName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON })
|
|
282
|
+
* @example
|
|
283
|
+
* // The billed customer's name copied onto an invoice line: another party's name, not the line's subject.
|
|
284
|
+
* customerName: z.string().dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true })
|
|
285
|
+
*/
|
|
286
|
+
[ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[], options?: DataCategoriesOptions): DecoratedPrimitiveZodType<this>;
|
|
287
|
+
```
|
|
@@ -153,6 +153,19 @@ export enum ZodDecorator {
|
|
|
153
153
|
* not marked. No check runs over an application's resources yet: there the marker documents the field.
|
|
154
154
|
*/
|
|
155
155
|
IS_DECIDER = "isDecider",
|
|
156
|
+
/**
|
|
157
|
+
* Role grant: this field's values are roles the WRITER grants (a membership's `roles`, a machine credential's
|
|
158
|
+
* `roles`, a unit assignment's `role`, an account's `appRoles`). A pure marker, read back with
|
|
159
|
+
* `isRoleGrantField(schema)`.
|
|
160
|
+
*
|
|
161
|
+
* What it changes: a form offers only the roles the person filling it may grant (#3248), decided by the rule the
|
|
162
|
+
* server's role-ceiling gate applies (`resolveRoleGrantCeiling` in `@wildo-ai/saas-models`), plus any role the
|
|
163
|
+
* record already holds, so a stored role is never dropped from view. It grants nothing and refuses nothing: the
|
|
164
|
+
* server gate on the write is the control, and the marker only keeps the form from offering what that gate refuses.
|
|
165
|
+
* Mark a field that a form offers roles in, where a write of it is checked against the writer's ceiling. A role
|
|
166
|
+
* grant typed as free text (an SSO connection's `roleMapping`) offers no roles, so marking it would narrow nothing.
|
|
167
|
+
*/
|
|
168
|
+
IS_ROLE_GRANT = "isRoleGrant",
|
|
156
169
|
/**
|
|
157
170
|
* RAG source: this field's TEXT is a retrieval-corpus source. The framework chunks the value
|
|
158
171
|
* (extracting text first for file fields), stores the chunks in the application's OWN datastore
|
|
@@ -224,6 +237,11 @@ export enum ZodDecorator {
|
|
|
224
237
|
* (single field vs composite). Mixing is rejected at decoration time.
|
|
225
238
|
*/
|
|
226
239
|
OBJECT_BUSINESS_KEY_SET = "businessKeySet",
|
|
240
|
+
/**
|
|
241
|
+
* Object-level: one NON-unique index over several fields, for reads that filter on the leading fields and sort on
|
|
242
|
+
* the last (#3142). Accumulates: each call declares one more index. See {@link CompoundIndexParams}.
|
|
243
|
+
*/
|
|
244
|
+
OBJECT_COMPOUND_INDEX = "compoundIndex",
|
|
227
245
|
/**
|
|
228
246
|
* Object-level: the object (`{ resourceType, resourceId }`) names one row of a resource whose type is chosen at
|
|
229
247
|
* run time from a published target set. See {@link ResourceReferenceParams}.
|
|
@@ -342,6 +360,7 @@ export type ZodDecorator_ParamsType = {
|
|
|
342
360
|
// Last-action-record marker — parameterless: a field either records the last action or is state.
|
|
343
361
|
[ZodDecorator.IS_LAST_ACTION_RECORD]: undefined;
|
|
344
362
|
[ZodDecorator.IS_DECIDER]: undefined;
|
|
363
|
+
[ZodDecorator.IS_ROLE_GRANT]: undefined;
|
|
345
364
|
/**
|
|
346
365
|
* RAG-source declaration. The config object is optional — `.ragSource()` with no argument is a
|
|
347
366
|
* complete declaration — and the chokepoint normalizes an omitted config to `{}` so every reader
|
|
@@ -360,6 +379,8 @@ export type ZodDecorator_ParamsType = {
|
|
|
360
379
|
[ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
|
|
361
380
|
// Composite business key (object-level decorator carrying the ordered list of field names)
|
|
362
381
|
[ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams | DecoratorUpdater<BusinessKeySetParams>;
|
|
382
|
+
// One more compound index per call (the stored metadata is the accumulated list)
|
|
383
|
+
[ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams;
|
|
363
384
|
[ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
|
|
364
385
|
[ZodDecorator.TTL]: TtlFieldParams | DecoratorUpdater<TtlFieldParams>;
|
|
365
386
|
// String edit mode convenience decorators
|
|
@@ -444,6 +465,7 @@ export type ZodDecorator_Types = {
|
|
|
444
465
|
/** Last-action-record marker — stored as the bare `true` sentinel (parameterless, like IS_AUDIT_EVIDENCE). */
|
|
445
466
|
[ZodDecorator.IS_LAST_ACTION_RECORD]: true;
|
|
446
467
|
[ZodDecorator.IS_DECIDER]: true;
|
|
468
|
+
[ZodDecorator.IS_ROLE_GRANT]: true;
|
|
447
469
|
/** RAG-source config — ALWAYS the normalized object ( `{}` when authored with no argument): the
|
|
448
470
|
* chokepoint validates and normalizes on the way in, so every reader sees one shape and
|
|
449
471
|
* `getRagSourceConfig` can answer "is this field a source?" by presence alone. */
|
|
@@ -460,6 +482,8 @@ export type ZodDecorator_Types = {
|
|
|
460
482
|
[ZodDecorator.DOCUMENT_SEQUENCE]: DocumentSequenceParams;
|
|
461
483
|
// Composite business key (object-level — stored params shape after resolver unwraps DecoratorUpdater)
|
|
462
484
|
[ZodDecorator.OBJECT_BUSINESS_KEY_SET]: BusinessKeySetParams;
|
|
485
|
+
// Every compound index the object declares, in declaration order
|
|
486
|
+
[ZodDecorator.OBJECT_COMPOUND_INDEX]: CompoundIndexParams[];
|
|
463
487
|
[ZodDecorator.RESOURCE_REFERENCE]: ResourceReferenceParams;
|
|
464
488
|
[ZodDecorator.TTL]: TtlFieldParams;
|
|
465
489
|
// String edit mode convenience decorators
|
|
@@ -151,6 +151,12 @@ export const StringDisplayMode = {
|
|
|
151
151
|
* `edit.editMode: StringEditMode.ORGANIZATION_ROLE` so the field is picked the way it is read.
|
|
152
152
|
*/
|
|
153
153
|
ORGANIZATION_ROLE: 'organization_role',
|
|
154
|
+
/**
|
|
155
|
+
* The value is a calendar month, `YYYY-MM` — render it as the month and the year in the reader's locale
|
|
156
|
+
* ("October 2026", "octobre 2026"), never the raw string. A value that is not a year-month shows as typed. Declared
|
|
157
|
+
* by `z_yearMonth()`, which pairs it with `edit.editMode: StringEditMode.YEAR_MONTH`.
|
|
158
|
+
*/
|
|
159
|
+
YEAR_MONTH: 'year_month',
|
|
154
160
|
} as const;
|
|
155
161
|
export type StringDisplayMode = typeof StringDisplayMode[keyof typeof StringDisplayMode];
|
|
156
162
|
|
|
@@ -182,6 +188,11 @@ export const StringEditMode = {
|
|
|
182
188
|
* the operation's offer alone. The server remains the control: it decides what holding the role grants.
|
|
183
189
|
*/
|
|
184
190
|
ORGANIZATION_ROLE: 'organization_role',
|
|
191
|
+
/**
|
|
192
|
+
* A MONTH-AND-YEAR picker: a list of the twelve months, named in the reader's locale, and a year. It writes the value
|
|
193
|
+
* as `YYYY-MM` and nothing else, so the user never types the format. Declared by `z_yearMonth()`.
|
|
194
|
+
*/
|
|
195
|
+
YEAR_MONTH: 'year_month',
|
|
185
196
|
} as const;
|
|
186
197
|
export type StringEditMode = typeof StringEditMode[keyof typeof StringEditMode];
|
|
187
198
|
|
|
@@ -295,9 +295,10 @@ export function createFileSchema(
|
|
|
295
295
|
* re-declaring them made both interfaces below fail TS2320: an interface may not extend two types
|
|
296
296
|
* whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.
|
|
297
297
|
*
|
|
298
|
-
* Removing the mixin costs nothing
|
|
299
|
-
*
|
|
300
|
-
*
|
|
298
|
+
* Removing the mixin costs nothing: every `ZodObject` decorator returns `DecoratedPrimitiveZodType<this>`,
|
|
299
|
+
* which is `this` itself (#3031), and `this` is `DecoratedFileSchema` here. So `z_file().isHidden()`
|
|
300
|
+
* stays a `DecoratedFileSchema`, keeps `fileUI`/`fileSpec`, and offers every decorator the `ZodObject`
|
|
301
|
+
* augmentation declares rather than the four this mixin listed.
|
|
301
302
|
*/
|
|
302
303
|
|
|
303
304
|
/**
|
|
@@ -112,26 +112,6 @@ export function getRagSourceConfig(schema: z.ZodTypeAny): RagSourceConfiguration
|
|
|
112
112
|
|
|
113
113
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
114
114
|
|
|
115
|
-
```typescript
|
|
116
|
-
*
|
|
117
|
-
* `.ragSource(config?)` — declare this field's text a source of the application's retrieval
|
|
118
|
-
* corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
|
|
119
|
-
* `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
|
|
120
|
-
* wrappers, so it composes anywhere in a decorator chain.
|
|
121
|
-
*
|
|
122
|
-
* The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
|
|
123
|
-
* declaration that accepts the framework chunking defaults. Presence IS enablement.
|
|
124
|
-
*
|
|
125
|
-
* @example
|
|
126
|
-
* z.string().ragSource()
|
|
127
|
-
* @example
|
|
128
|
-
* z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
|
|
129
|
-
*/
|
|
130
|
-
[ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<T>;
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
### Origin Package: `@wildo-ai/zod-decorators`
|
|
134
|
-
|
|
135
115
|
```typescript
|
|
136
116
|
*
|
|
137
117
|
* Standalone form of `.ragSource(config?)` — declare a field's text a RAG retrieval-corpus source.
|
|
@@ -166,3 +146,23 @@ export function addRagSource<T extends z.ZodTypeAny>(
|
|
|
166
146
|
]);
|
|
167
147
|
}
|
|
168
148
|
```
|
|
149
|
+
|
|
150
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
151
|
+
|
|
152
|
+
```typescript
|
|
153
|
+
*
|
|
154
|
+
* `.ragSource(config?)` — declare this field's text a source of the application's retrieval
|
|
155
|
+
* corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
|
|
156
|
+
* `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
|
|
157
|
+
* wrappers, so it composes anywhere in a decorator chain.
|
|
158
|
+
*
|
|
159
|
+
* The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
|
|
160
|
+
* declaration that accepts the framework chunking defaults. Presence IS enablement.
|
|
161
|
+
*
|
|
162
|
+
* @example
|
|
163
|
+
* z.string().ragSource()
|
|
164
|
+
* @example
|
|
165
|
+
* z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
|
|
166
|
+
*/
|
|
167
|
+
[ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<this>;
|
|
168
|
+
```
|
|
@@ -41,6 +41,7 @@ export interface CustomFieldMetadata {
|
|
|
41
41
|
[ZodDecorator.IS_AUDIT_EVIDENCE]?: ZodDecorator_Types[ZodDecorator.IS_AUDIT_EVIDENCE];
|
|
42
42
|
[ZodDecorator.IS_LAST_ACTION_RECORD]?: ZodDecorator_Types[ZodDecorator.IS_LAST_ACTION_RECORD];
|
|
43
43
|
[ZodDecorator.IS_DECIDER]?: ZodDecorator_Types[ZodDecorator.IS_DECIDER];
|
|
44
|
+
[ZodDecorator.IS_ROLE_GRANT]?: ZodDecorator_Types[ZodDecorator.IS_ROLE_GRANT];
|
|
44
45
|
[ZodDecorator.RAG_SOURCE]?: ZodDecorator_Types[ZodDecorator.RAG_SOURCE];
|
|
45
46
|
[ZodDecorator.IS_VIRTUAL]?: ZodDecorator_Types[ZodDecorator.IS_VIRTUAL];
|
|
46
47
|
[ZodDecorator.IS_DISCRIMINATOR]?: ZodDecorator_Types[ZodDecorator.IS_DISCRIMINATOR];
|
|
@@ -52,6 +53,7 @@ export interface CustomFieldMetadata {
|
|
|
52
53
|
[ZodDecorator.IS_BUSINESS_KEY]?: ZodDecorator_Types[ZodDecorator.IS_BUSINESS_KEY];
|
|
53
54
|
[ZodDecorator.DOCUMENT_SEQUENCE]?: ZodDecorator_Types[ZodDecorator.DOCUMENT_SEQUENCE];
|
|
54
55
|
[ZodDecorator.OBJECT_BUSINESS_KEY_SET]?: ZodDecorator_Types[ZodDecorator.OBJECT_BUSINESS_KEY_SET];
|
|
56
|
+
[ZodDecorator.OBJECT_COMPOUND_INDEX]?: ZodDecorator_Types[ZodDecorator.OBJECT_COMPOUND_INDEX];
|
|
55
57
|
[ZodDecorator.RESOURCE_REFERENCE]?: ZodDecorator_Types[ZodDecorator.RESOURCE_REFERENCE];
|
|
56
58
|
[ZodDecorator.TTL]?: ZodDecorator_Types[ZodDecorator.TTL];
|
|
57
59
|
// String edit mode convenience decorators
|
|
@@ -158,6 +158,27 @@
|
|
|
158
158
|
},
|
|
159
159
|
]);
|
|
160
160
|
},
|
|
161
|
+
// compoundIndex (#3142): one more NON-unique index over several fields of this object. Validated at decoration time,
|
|
162
|
+
// like businessKeySet, so an index cannot name a field the row does not carry; storage would otherwise build an index
|
|
163
|
+
// over a path that is always empty, or the SQL plan would refuse at migration time, far from the declaration.
|
|
164
|
+
compoundIndex: function(this: z.ZodTypeAny, fields: string[]): DecoratedPrimitiveZodType<z.ZodTypeAny> {
|
|
165
|
+
if (!Array.isArray(fields) || fields.length < 2) {
|
|
166
|
+
throw new Error(
|
|
167
|
+
`compoundIndex([...]) needs at least two field names (received ${JSON.stringify(fields)}); a one-field index is .isDBIndexed() on the field.`,
|
|
168
|
+
);
|
|
169
|
+
}
|
|
170
|
+
const repeated = fields.filter((field, index) => fields.indexOf(field) !== index);
|
|
171
|
+
if (repeated.length > 0) {
|
|
172
|
+
throw new Error(`compoundIndex([...]) names a field more than once: ${[...new Set(repeated)].join(', ')}.`);
|
|
173
|
+
}
|
|
174
|
+
const node = this as unknown as { shape?: Record<string, unknown>; _zod?: { def?: { shape?: Record<string, unknown> } } };
|
|
175
|
+
const shape = node.shape ?? node._zod?.def?.shape;
|
|
176
|
+
const missing = fields.filter((field) => !shape || !(field in shape));
|
|
177
|
+
if (missing.length > 0) {
|
|
178
|
+
throw new Error(`compoundIndex([...]) references field(s) not present in the schema shape: ${missing.join(', ')}.`);
|
|
179
|
+
}
|
|
180
|
+
return addDecorators(this, [{ ref: ZodDecorator.OBJECT_COMPOUND_INDEX, params: { fields: [...fields] } }]);
|
|
181
|
+
},
|
|
161
182
|
// isResourceReference (#2471): the object names one row of a resource chosen at run time. Validated at decoration
|
|
162
183
|
// time, like businessKeySet: the object must HAVE the two members the reference is read through, or a form would
|
|
163
184
|
// offer a picker that writes into fields the schema does not carry.
|
|
@@ -180,30 +201,15 @@
|
|
|
180
201
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
181
202
|
|
|
182
203
|
```typescript
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
[ZodDecorator.IS_PRIMARY_KEY](): DecoratedPrimitiveZodType<T>;
|
|
193
|
-
[ZodDecorator.IS_BUSINESS_KEY](): DecoratedPrimitiveZodType<T>;
|
|
194
|
-
[ZodDecorator.DOCUMENT_SEQUENCE](params: DocumentSequenceParams): DecoratedPrimitiveZodType<T>;
|
|
195
|
-
[ZodDecorator.OBJECT_BUSINESS_KEY_SET](fields: string[], params?: Omit<BusinessKeySetParams, 'fields'>): DecoratedPrimitiveZodType<T>;
|
|
196
|
-
[ZodDecorator.RESOURCE_REFERENCE](params: ResourceReferenceParams): DecoratedPrimitiveZodType<T>;
|
|
197
|
-
[ZodDecorator.TTL](params: ZodDecorator_ParamsType[ZodDecorator.TTL]): DecoratedPrimitiveZodType<T>;
|
|
198
|
-
/**
|
|
199
|
-
* `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
|
|
200
|
-
* instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
|
|
201
|
-
* their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
|
|
202
|
-
* (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
|
|
203
|
-
* A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
|
|
204
|
-
* loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
|
|
205
|
-
*/
|
|
206
|
-
[ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<T>;
|
|
204
|
+
/**
|
|
205
|
+
* `z.date().isCalendarDate()` — the date is a CALENDAR DAY (a due date, a birthday, an invoice date), not an
|
|
206
|
+
* instant. It is held as UTC midnight of the day and shown and picked as that day for every reader, whatever
|
|
207
|
+
* their time zone; "tomorrow" is still measured from the reader's today. Leave it off a moment in time
|
|
208
|
+
* (`createdAt`, `expiresAt`, `completedAt`): an undeclared date is an instant, shown in the reader's zone.
|
|
209
|
+
* A day has no time of day, so it cannot also declare `dateTimeUI()`: combining the two throws when the schema
|
|
210
|
+
* loads. Use `dateUI()` to style a calendar date's display, and `dateTimeUI()` alone for a moment.
|
|
211
|
+
*/
|
|
212
|
+
[ZodDecorator.IS_CALENDAR_DATE](): DecoratedPrimitiveZodType<this>;
|
|
207
213
|
```
|
|
208
214
|
|
|
209
215
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
@@ -89,6 +89,35 @@ export interface BackendOnlyFieldParams {
|
|
|
89
89
|
* material is attributable.
|
|
90
90
|
*/
|
|
91
91
|
isReturnedAtCreation?: boolean;
|
|
92
|
+
/**
|
|
93
|
+
* `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
|
|
94
|
+
* carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
|
|
95
|
+
* every request and response DTO, every listing and every model or tool output.
|
|
96
|
+
*
|
|
97
|
+
* Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
|
|
98
|
+
* as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
|
|
99
|
+
* not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
|
|
100
|
+
* routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
|
|
101
|
+
* personal data. Without this declaration such a row reached its subject with that substance withheld.
|
|
102
|
+
*
|
|
103
|
+
* Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
|
|
104
|
+
* token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
|
|
105
|
+
* reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
|
|
106
|
+
* withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
|
|
107
|
+
*
|
|
108
|
+
* A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
|
|
109
|
+
* by the subject through any request, so it is outside what Art. 20 covers.
|
|
110
|
+
*
|
|
111
|
+
* Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
|
|
112
|
+
* `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
|
|
113
|
+
* `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
|
|
114
|
+
*
|
|
115
|
+
* spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
|
|
116
|
+
*
|
|
117
|
+
* assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
|
|
118
|
+
* export only by this declaration, never by loosening the floor.
|
|
119
|
+
*/
|
|
120
|
+
disclosedToSubject?: true;
|
|
92
121
|
}
|
|
93
122
|
|
|
94
123
|
/**
|
|
@@ -266,6 +295,40 @@ export interface BusinessKeySetParams {
|
|
|
266
295
|
conflictMessageReference?: string;
|
|
267
296
|
}
|
|
268
297
|
|
|
298
|
+
/**
|
|
299
|
+
* One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
|
|
300
|
+
*
|
|
301
|
+
* Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
|
|
302
|
+
* organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
|
|
303
|
+
* the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
|
|
304
|
+
* filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
|
|
305
|
+
* organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
|
|
306
|
+
*
|
|
307
|
+
* Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
|
|
308
|
+
* an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
|
|
309
|
+
* filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
|
|
310
|
+
* PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
|
|
311
|
+
*
|
|
312
|
+
* Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
|
|
313
|
+
* on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
|
|
314
|
+
* `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
|
|
315
|
+
* object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
|
|
316
|
+
* honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
|
|
317
|
+
* served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
|
|
318
|
+
* supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
|
|
319
|
+
* variants: declare it on a resource whose main schema is a plain object.
|
|
320
|
+
*
|
|
321
|
+
* @example
|
|
322
|
+
* // one tenant's trail, optionally of one event type, newest first
|
|
323
|
+
* z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
|
|
324
|
+
* .compoundIndex(['organizationId', 'eventType', 'createdAt'])
|
|
325
|
+
* .compoundIndex(['organizationId', 'createdAt'])
|
|
326
|
+
*/
|
|
327
|
+
export interface CompoundIndexParams {
|
|
328
|
+
/** The indexed fields, in index order: equality filters first, the sort field last. */
|
|
329
|
+
fields: string[];
|
|
330
|
+
}
|
|
331
|
+
|
|
269
332
|
/**
|
|
270
333
|
* Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
|
|
271
334
|
*
|
|
@@ -99,6 +99,35 @@ export interface BackendOnlyFieldParams {
|
|
|
99
99
|
* material is attributable.
|
|
100
100
|
*/
|
|
101
101
|
isReturnedAtCreation?: boolean;
|
|
102
|
+
/**
|
|
103
|
+
* `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
|
|
104
|
+
* carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
|
|
105
|
+
* every request and response DTO, every listing and every model or tool output.
|
|
106
|
+
*
|
|
107
|
+
* Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
|
|
108
|
+
* as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
|
|
109
|
+
* not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
|
|
110
|
+
* routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
|
|
111
|
+
* personal data. Without this declaration such a row reached its subject with that substance withheld.
|
|
112
|
+
*
|
|
113
|
+
* Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
|
|
114
|
+
* token or a lease, never on a field holding other people's data (a list of everyone a row names). When the row can also
|
|
115
|
+
* reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
|
|
116
|
+
* withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
|
|
117
|
+
*
|
|
118
|
+
* A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
|
|
119
|
+
* by the subject through any request, so it is outside what Art. 20 covers.
|
|
120
|
+
*
|
|
121
|
+
* Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
|
|
122
|
+
* `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
|
|
123
|
+
* `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
|
|
124
|
+
*
|
|
125
|
+
* spec-cite: GDPR Art. 15(1), 15(3) (https://gdpr-info.eu/art-15-gdpr/); Art. 20(1) (https://gdpr-info.eu/art-20-gdpr/)
|
|
126
|
+
*
|
|
127
|
+
* assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
|
|
128
|
+
* export only by this declaration, never by loosening the floor.
|
|
129
|
+
*/
|
|
130
|
+
disclosedToSubject?: true;
|
|
102
131
|
}
|
|
103
132
|
|
|
104
133
|
/**
|
|
@@ -466,6 +495,40 @@ export interface BusinessKeySetParams {
|
|
|
466
495
|
conflictMessageReference?: string;
|
|
467
496
|
}
|
|
468
497
|
|
|
498
|
+
/**
|
|
499
|
+
* One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
|
|
500
|
+
*
|
|
501
|
+
* Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
|
|
502
|
+
* organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
|
|
503
|
+
* the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
|
|
504
|
+
* filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
|
|
505
|
+
* organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
|
|
506
|
+
*
|
|
507
|
+
* Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
|
|
508
|
+
* an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
|
|
509
|
+
* filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
|
|
510
|
+
* PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
|
|
511
|
+
*
|
|
512
|
+
* Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
|
|
513
|
+
* on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
|
|
514
|
+
* `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
|
|
515
|
+
* object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
|
|
516
|
+
* honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
|
|
517
|
+
* served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
|
|
518
|
+
* supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
|
|
519
|
+
* variants: declare it on a resource whose main schema is a plain object.
|
|
520
|
+
*
|
|
521
|
+
* @example
|
|
522
|
+
* // one tenant's trail, optionally of one event type, newest first
|
|
523
|
+
* z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
|
|
524
|
+
* .compoundIndex(['organizationId', 'eventType', 'createdAt'])
|
|
525
|
+
* .compoundIndex(['organizationId', 'createdAt'])
|
|
526
|
+
*/
|
|
527
|
+
export interface CompoundIndexParams {
|
|
528
|
+
/** The indexed fields, in index order: equality filters first, the sort field last. */
|
|
529
|
+
fields: string[];
|
|
530
|
+
}
|
|
531
|
+
|
|
469
532
|
/**
|
|
470
533
|
* Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
|
|
471
534
|
*
|
|
@@ -104,10 +104,10 @@ export function createBigDecimalSchema(
|
|
|
104
104
|
|
|
105
105
|
/**
|
|
106
106
|
* The chainable methods of `DecoratedBigDecimalSchema`, returning `this` so a chain of several decorations keeps
|
|
107
|
-
* the type it reached
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
*
|
|
107
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
108
|
+
* A method returning the bare `DecoratedBigDecimalSchema` once won the overload inside the intersection, so that
|
|
109
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
110
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedBigDecimalSchema`.
|
|
111
111
|
*/
|
|
112
112
|
export interface DecoratedBigDecimalSchemaMethods {
|
|
113
113
|
[ZodDecorator.IS_DB_INDEXED](): this;
|
|
@@ -85,10 +85,10 @@ export function createCodeSchema(
|
|
|
85
85
|
|
|
86
86
|
/**
|
|
87
87
|
* The chainable methods of `DecoratedCodeSchema`, returning `this` so a chain of several decorations keeps
|
|
88
|
-
* the type it reached
|
|
89
|
-
*
|
|
90
|
-
*
|
|
91
|
-
*
|
|
88
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
89
|
+
* A method returning the bare `DecoratedCodeSchema` once won the overload inside the intersection, so that
|
|
90
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
91
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedCodeSchema`.
|
|
92
92
|
*/
|
|
93
93
|
export interface DecoratedCodeSchemaMethods {
|
|
94
94
|
[ZodDecorator.IS_DB_INDEXED](): this;
|