@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
|
@@ -102,6 +102,35 @@ export interface BackendOnlyFieldParams {
|
|
|
102
102
|
* material is attributable.
|
|
103
103
|
*/
|
|
104
104
|
isReturnedAtCreation?: boolean;
|
|
105
|
+
/**
|
|
106
|
+
* `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
|
|
107
|
+
* carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
|
|
108
|
+
* every request and response DTO, every listing and every model or tool output.
|
|
109
|
+
*
|
|
110
|
+
* Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
|
|
111
|
+
* as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
|
|
112
|
+
* not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
|
|
113
|
+
* routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
|
|
114
|
+
* personal data. Without this declaration such a row reached its subject with that substance withheld.
|
|
115
|
+
*
|
|
116
|
+
* Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
|
|
117
|
+
* 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
|
|
118
|
+
* reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
|
|
119
|
+
* withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
|
|
120
|
+
*
|
|
121
|
+
* A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
|
|
122
|
+
* by the subject through any request, so it is outside what Art. 20 covers.
|
|
123
|
+
*
|
|
124
|
+
* Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
|
|
125
|
+
* `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
|
|
126
|
+
* `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
|
|
127
|
+
*
|
|
128
|
+
* 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/)
|
|
129
|
+
*
|
|
130
|
+
* assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
|
|
131
|
+
* export only by this declaration, never by loosening the floor.
|
|
132
|
+
*/
|
|
133
|
+
disclosedToSubject?: true;
|
|
105
134
|
}
|
|
106
135
|
|
|
107
136
|
/**
|
|
@@ -279,6 +308,40 @@ export interface BusinessKeySetParams {
|
|
|
279
308
|
conflictMessageReference?: string;
|
|
280
309
|
}
|
|
281
310
|
|
|
311
|
+
/**
|
|
312
|
+
* One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
|
|
313
|
+
*
|
|
314
|
+
* Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
|
|
315
|
+
* organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
|
|
316
|
+
* the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
|
|
317
|
+
* filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
|
|
318
|
+
* organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
|
|
319
|
+
*
|
|
320
|
+
* Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
|
|
321
|
+
* an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
|
|
322
|
+
* filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
|
|
323
|
+
* PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
|
|
324
|
+
*
|
|
325
|
+
* Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
|
|
326
|
+
* on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
|
|
327
|
+
* `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
|
|
328
|
+
* object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
|
|
329
|
+
* honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
|
|
330
|
+
* served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
|
|
331
|
+
* supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
|
|
332
|
+
* variants: declare it on a resource whose main schema is a plain object.
|
|
333
|
+
*
|
|
334
|
+
* @example
|
|
335
|
+
* // one tenant's trail, optionally of one event type, newest first
|
|
336
|
+
* z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
|
|
337
|
+
* .compoundIndex(['organizationId', 'eventType', 'createdAt'])
|
|
338
|
+
* .compoundIndex(['organizationId', 'createdAt'])
|
|
339
|
+
*/
|
|
340
|
+
export interface CompoundIndexParams {
|
|
341
|
+
/** The indexed fields, in index order: equality filters first, the sort field last. */
|
|
342
|
+
fields: string[];
|
|
343
|
+
}
|
|
344
|
+
|
|
282
345
|
/**
|
|
283
346
|
* Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
|
|
284
347
|
*
|
|
@@ -110,10 +110,10 @@ export function createMoneySchema(
|
|
|
110
110
|
|
|
111
111
|
/**
|
|
112
112
|
* The chainable methods of `DecoratedMoneySchema`, returning `this` so a chain of several decorations keeps
|
|
113
|
-
* the type it reached
|
|
114
|
-
*
|
|
115
|
-
*
|
|
116
|
-
*
|
|
113
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
114
|
+
* A method returning the bare `DecoratedMoneySchema` once won the overload inside the intersection, so that
|
|
115
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
116
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedMoneySchema`.
|
|
117
117
|
*/
|
|
118
118
|
export interface DecoratedMoneySchemaMethods {
|
|
119
119
|
[ZodDecorator.IS_DB_INDEXED](): this;
|
|
@@ -572,10 +572,10 @@ export function createDurationSchema(
|
|
|
572
572
|
|
|
573
573
|
/**
|
|
574
574
|
* The chainable methods of `DecoratedDurationSchema`, returning `this` so a chain of several decorations keeps
|
|
575
|
-
* the type it reached
|
|
576
|
-
*
|
|
577
|
-
*
|
|
578
|
-
*
|
|
575
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
576
|
+
* A method returning the bare `DecoratedDurationSchema` once won the overload inside the intersection, so that
|
|
577
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
578
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedDurationSchema`.
|
|
579
579
|
*/
|
|
580
580
|
export interface DecoratedDurationSchemaMethods {
|
|
581
581
|
[ZodDecorator.IS_DB_INDEXED](): this;
|
|
@@ -685,10 +685,10 @@ export function createPhoneSchema(options: PhoneSchemaOptions = {}): DecoratedPh
|
|
|
685
685
|
|
|
686
686
|
/**
|
|
687
687
|
* The chainable methods of `DecoratedPhoneSchema`, returning `this` so a chain of several decorations keeps
|
|
688
|
-
* the type it reached
|
|
689
|
-
*
|
|
690
|
-
*
|
|
691
|
-
*
|
|
688
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
689
|
+
* A method returning the bare `DecoratedPhoneSchema` once won the overload inside the intersection, so that
|
|
690
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
691
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedPhoneSchema`.
|
|
692
692
|
*/
|
|
693
693
|
export interface DecoratedPhoneSchemaMethods {
|
|
694
694
|
[ZodDecorator.IS_DB_INDEXED](): this;
|
|
@@ -937,10 +937,10 @@ export function createCodeSchema(
|
|
|
937
937
|
|
|
938
938
|
/**
|
|
939
939
|
* The chainable methods of `DecoratedCodeSchema`, returning `this` so a chain of several decorations keeps
|
|
940
|
-
* the type it reached
|
|
941
|
-
*
|
|
942
|
-
*
|
|
943
|
-
*
|
|
940
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
941
|
+
* A method returning the bare `DecoratedCodeSchema` once won the overload inside the intersection, so that
|
|
942
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
943
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedCodeSchema`.
|
|
944
944
|
*/
|
|
945
945
|
export interface DecoratedCodeSchemaMethods {
|
|
946
946
|
[ZodDecorator.IS_DB_INDEXED](): this;
|
|
@@ -1096,10 +1096,10 @@ export function createBigDecimalSchema(
|
|
|
1096
1096
|
|
|
1097
1097
|
/**
|
|
1098
1098
|
* The chainable methods of `DecoratedBigDecimalSchema`, returning `this` so a chain of several decorations keeps
|
|
1099
|
-
* the type it reached
|
|
1100
|
-
*
|
|
1101
|
-
*
|
|
1102
|
-
*
|
|
1099
|
+
* the type it reached, whatever the receiver is (`typeof field` in a resource specification's field map).
|
|
1100
|
+
* A method returning the bare `DecoratedBigDecimalSchema` once won the overload inside the intersection, so that
|
|
1101
|
+
* field map rejected `schemaShape.x.<factory>Spec(...)` on a field decorated first. Every other decorator
|
|
1102
|
+
* returns the receiver's own type too (#3031), so `.isSummaryField()` leaves the field a `DecoratedBigDecimalSchema`.
|
|
1103
1103
|
*/
|
|
1104
1104
|
export interface DecoratedBigDecimalSchemaMethods {
|
|
1105
1105
|
[ZodDecorator.IS_DB_INDEXED](): this;
|
|
@@ -1156,6 +1156,86 @@ export function z_bigdecimal(
|
|
|
1156
1156
|
}
|
|
1157
1157
|
```
|
|
1158
1158
|
|
|
1159
|
+
## Year-Month
|
|
1160
|
+
|
|
1161
|
+
## Import Origins
|
|
1162
|
+
|
|
1163
|
+
- `@wildo-ai/zod-decorators`
|
|
1164
|
+
|
|
1165
|
+
## Source Excerpts
|
|
1166
|
+
|
|
1167
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1168
|
+
|
|
1169
|
+
```typescript
|
|
1170
|
+
/**
|
|
1171
|
+
* The shape of a YEAR-MONTH value: a calendar month written `YYYY-MM` (`2026-10`), month `01`–`12`.
|
|
1172
|
+
*
|
|
1173
|
+
* A year-month carries no day, no time and no time zone. It is stored as this string because the string is what every
|
|
1174
|
+
* party agrees on: it sorts chronologically as text, it makes a natural part of a unique key (one budget per department
|
|
1175
|
+
* per month), and no reader's zone can move it into the neighbouring month the way a `Date` at midnight can.
|
|
1176
|
+
*/
|
|
1177
|
+
export const YEAR_MONTH_PATTERN: RegExp = /^\d{4}-(0[1-9]|1[0-2])$/;
|
|
1178
|
+
|
|
1179
|
+
/**
|
|
1180
|
+
* A YEAR-MONTH field: one calendar month, stored `YYYY-MM`. Use it for a period whose grain is the month — a monthly
|
|
1181
|
+
* budget, a billing month, a reporting period — instead of a `z.date()` pinned to the first of the month (whose day and
|
|
1182
|
+
* zone mean nothing) or a bare `z.string()` the user has to type.
|
|
1183
|
+
*
|
|
1184
|
+
* What the field gets from the framework:
|
|
1185
|
+
* - the stored value is validated against {@link YEAR_MONTH_PATTERN} on every write, server side included;
|
|
1186
|
+
* - it is READ as a month and a year in the reader's locale ("October 2026", "octobre 2026"), everywhere the value is
|
|
1187
|
+
* shown (`StringDisplayMode.YEAR_MONTH`);
|
|
1188
|
+
* - it is EDITED with a month-and-year picker that writes `YYYY-MM` (`StringEditMode.YEAR_MONTH`).
|
|
1189
|
+
*
|
|
1190
|
+
* Chain the structural decorators as on any string (`.isDBIndexed()`, `.isUnique({ compoundWith })`, `.optional()`).
|
|
1191
|
+
*
|
|
1192
|
+
* @example
|
|
1193
|
+
* ```typescript
|
|
1194
|
+
* import { z_yearMonth } from '@wildo-ai/zod-decorators';
|
|
1195
|
+
*
|
|
1196
|
+
* period: z_yearMonth().isDBIndexed().isUnique({ compoundWith: 'organizationUnitId' }),
|
|
1197
|
+
* ```
|
|
1198
|
+
*/
|
|
1199
|
+
export function z_yearMonth(): z.ZodString {
|
|
1200
|
+
return z.string().regex(YEAR_MONTH_PATTERN).stringUI({
|
|
1201
|
+
display: { displayMode: StringDisplayMode.YEAR_MONTH },
|
|
1202
|
+
edit: { editMode: StringEditMode.YEAR_MONTH },
|
|
1203
|
+
});
|
|
1204
|
+
}
|
|
1205
|
+
```
|
|
1206
|
+
|
|
1207
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1208
|
+
|
|
1209
|
+
```typescript
|
|
1210
|
+
/**
|
|
1211
|
+
* Does this schema hold a YEAR-MONTH (`YYYY-MM`)? The one question a filter panel, a chip, the companion or a
|
|
1212
|
+
* specification asks of a field before treating it as a month, so none of them re-derives the answer from a UI mode.
|
|
1213
|
+
*
|
|
1214
|
+
* Answered from what the schema ENFORCES first: a string validated against {@link YEAR_MONTH_PATTERN} holds a
|
|
1215
|
+
* year-month whatever its UI says, which is the guarantee `z_yearMonth()` makes. That is the structural marker, and it
|
|
1216
|
+
* survives an author re-declaring the field's display or edit mode (`.stringUI({ display: … })` replaces the display
|
|
1217
|
+
* mode and nothing else). A field that declares the year-month display or edit mode without the pattern counts too:
|
|
1218
|
+
* its author said its values are months, and the picker writes nothing else. Wrappers (`.optional()`, `.default()`,
|
|
1219
|
+
* `.nullable()`, a pipe's input) are looked through; a year-month on the OUTPUT side of a pipe is not seen.
|
|
1220
|
+
*
|
|
1221
|
+
* Because the pattern wins, a `z_yearMonth()` whose author re-declares the edit mode as a text input still answers
|
|
1222
|
+
* `true`: the form then shows the text input the author chose, and a list filter over it still offers the month picker.
|
|
1223
|
+
*
|
|
1224
|
+
* @example
|
|
1225
|
+
* ```typescript
|
|
1226
|
+
* isYearMonthField(z_yearMonth().optional()); // true
|
|
1227
|
+
* isYearMonthField(z.string()); // false
|
|
1228
|
+
* ```
|
|
1229
|
+
*/
|
|
1230
|
+
export function isYearMonthField(schema: z.ZodTypeAny | undefined): boolean {
|
|
1231
|
+
if (!schema) return false;
|
|
1232
|
+
if (getZodType(unwrapSchema(schema)) !== 'string') return false;
|
|
1233
|
+
if (enforcesYearMonthPattern(schema)) return true;
|
|
1234
|
+
const ui = getStringUI(schema);
|
|
1235
|
+
return ui?.edit?.editMode === StringEditMode.YEAR_MONTH || ui?.display?.displayMode === StringDisplayMode.YEAR_MONTH;
|
|
1236
|
+
}
|
|
1237
|
+
```
|
|
1238
|
+
|
|
1159
1239
|
## File Schema
|
|
1160
1240
|
|
|
1161
1241
|
## Import Origins
|
|
@@ -1453,9 +1533,10 @@ export function createFileSchema(
|
|
|
1453
1533
|
* re-declaring them made both interfaces below fail TS2320: an interface may not extend two types
|
|
1454
1534
|
* whose same-named member differs, and `TSelf` is not `DecoratedPrimitiveZodType<this>`.
|
|
1455
1535
|
*
|
|
1456
|
-
* Removing the mixin costs nothing
|
|
1457
|
-
*
|
|
1458
|
-
*
|
|
1536
|
+
* Removing the mixin costs nothing: every `ZodObject` decorator returns `DecoratedPrimitiveZodType<this>`,
|
|
1537
|
+
* which is `this` itself (#3031), and `this` is `DecoratedFileSchema` here. So `z_file().isHidden()`
|
|
1538
|
+
* stays a `DecoratedFileSchema`, keeps `fileUI`/`fileSpec`, and offers every decorator the `ZodObject`
|
|
1539
|
+
* augmentation declares rather than the four this mixin listed.
|
|
1459
1540
|
*/
|
|
1460
1541
|
|
|
1461
1542
|
/**
|
|
@@ -102,6 +102,35 @@ export interface BackendOnlyFieldParams {
|
|
|
102
102
|
* material is attributable.
|
|
103
103
|
*/
|
|
104
104
|
isReturnedAtCreation?: boolean;
|
|
105
|
+
/**
|
|
106
|
+
* `true` declares that this backend-only value is the SUBJECT'S OWN DATA, so a person's ACCESS export (GDPR Art. 15)
|
|
107
|
+
* carries it: `isBackendOnly({ disclosedToSubject: true })`. It changes nothing else: the field is still stripped from
|
|
108
|
+
* every request and response DTO, every listing and every model or tool output.
|
|
109
|
+
*
|
|
110
|
+
* Why it exists (#2958). A subject export reads rows below the DTO projection, so it withholds every backend-only field
|
|
111
|
+
* as a security floor: that is what keeps a password hash or a token hash out of a bundle. Many backend-only fields are
|
|
112
|
+
* not secrets, though. They are kept off the API because a generic reader must not see them (who a pending decision is
|
|
113
|
+
* routed to, when it was decided, which chat card a person was sent), and to the person they are about they are plain
|
|
114
|
+
* personal data. Without this declaration such a row reached its subject with that substance withheld.
|
|
115
|
+
*
|
|
116
|
+
* Declare it only where the value is about the person who receives the export: never on a credential, a secret, a
|
|
117
|
+
* 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
|
|
118
|
+
* reach someone it is NOT about (a conversation's owner, for the id of the person who decided on it), the resource
|
|
119
|
+
* withholds the field from that path as other people's data (`subjectExportOthersDataFields`).
|
|
120
|
+
*
|
|
121
|
+
* A portability export (Art. 20) still withholds it: a backend-only value is written by the system and never provided
|
|
122
|
+
* by the subject through any request, so it is outside what Art. 20 covers.
|
|
123
|
+
*
|
|
124
|
+
* Refused, at the decorator chokepoint and in either order, beside `isPassword()`, `isOtp()`, `isWriteOnlySecret()`,
|
|
125
|
+
* `isEphemeral()` and `isReturnedAtCreation`: each marks a secret. A field the application declares
|
|
126
|
+
* `.dataCategories(CREDENTIALS)` is refused when its resource configuration is built.
|
|
127
|
+
*
|
|
128
|
+
* 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/)
|
|
129
|
+
*
|
|
130
|
+
* assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT — a backend-only value about the subject reaches their access
|
|
131
|
+
* export only by this declaration, never by loosening the floor.
|
|
132
|
+
*/
|
|
133
|
+
disclosedToSubject?: true;
|
|
105
134
|
}
|
|
106
135
|
|
|
107
136
|
/**
|
|
@@ -469,6 +498,40 @@ export interface BusinessKeySetParams {
|
|
|
469
498
|
conflictMessageReference?: string;
|
|
470
499
|
}
|
|
471
500
|
|
|
501
|
+
/**
|
|
502
|
+
* One NON-UNIQUE index over several fields, declared with the object-level `compoundIndex([...])` decorator (#3142).
|
|
503
|
+
*
|
|
504
|
+
* Declare one for a read that filters on some fields and sorts on another, when the table grows without bound: "one
|
|
505
|
+
* organization's audit rows of one event type, newest first" is `['organizationId', 'eventType', 'createdAt']`. Order is
|
|
506
|
+
* the index's identity and decides which reads it serves: the equality filters come first, the sort field last. A read
|
|
507
|
+
* filtering on a leading PREFIX of the list is served as well, so `['organizationId', 'createdAt']` also serves "one
|
|
508
|
+
* organization's rows". The index is walked in either direction, so newest-first needs no descending declaration.
|
|
509
|
+
*
|
|
510
|
+
* Why separate per-field `.isDBIndexed()` declarations are not the same thing: the database may combine two of them for
|
|
511
|
+
* an equality filter, but it cannot use them to return a filtered set already in sort order, so it either sorts the whole
|
|
512
|
+
* filtered set or walks the sort field's index and discards every row of the other tenants. Measured on a 580,000-row
|
|
513
|
+
* PostgreSQL audit trail: 534 ms and 2.2 s through per-field indexes, 1 to 9 ms through the compound one.
|
|
514
|
+
*
|
|
515
|
+
* Uniqueness is NOT what this declares; a composite IDENTITY is `.businessKeySet([...])`. Every field must be declared
|
|
516
|
+
* on the object (checked at decoration time) and STORED (not `.isVirtual()`), there must be at least two (one field is
|
|
517
|
+
* `.isDBIndexed()`), and none may repeat. Several indexes are declared by calling the decorator once per index. An
|
|
518
|
+
* object derived with `.omit()` / `.pick()` keeps only the indexes whose fields it still has. Both storage adapters
|
|
519
|
+
* honour it: MongoDB builds the index (ended on `_id`, as every plain index is, so a paged read's total order is
|
|
520
|
+
* served), and the PostgreSQL plan records it so `wildo db generate` writes the migration that creates it. Not yet
|
|
521
|
+
* supported on the BASE schema of a polymorphic resource, which refuses outer-level metadata it cannot carry to its
|
|
522
|
+
* variants: declare it on a resource whose main schema is a plain object.
|
|
523
|
+
*
|
|
524
|
+
* @example
|
|
525
|
+
* // one tenant's trail, optionally of one event type, newest first
|
|
526
|
+
* z.object({ organizationId: z.string().optional(), eventType: z.string(), createdAt: z.date() })
|
|
527
|
+
* .compoundIndex(['organizationId', 'eventType', 'createdAt'])
|
|
528
|
+
* .compoundIndex(['organizationId', 'createdAt'])
|
|
529
|
+
*/
|
|
530
|
+
export interface CompoundIndexParams {
|
|
531
|
+
/** The indexed fields, in index order: equality filters first, the sort field last. */
|
|
532
|
+
fields: string[];
|
|
533
|
+
}
|
|
534
|
+
|
|
472
535
|
/**
|
|
473
536
|
* Parameters for the object-level `isResourceReference({ targetSet })` decorator (#2471).
|
|
474
537
|
*
|
|
@@ -800,6 +863,50 @@ function assertCalendarDateNotDateTime(decorator: ZodDecorator, currentMetadata:
|
|
|
800
863
|
}
|
|
801
864
|
}
|
|
802
865
|
|
|
866
|
+
/**
|
|
867
|
+
* The decorators that mark a value as a SECRET, each with the reason a subject-disclosed backend-only field
|
|
868
|
+
* (`isBackendOnly({ disclosedToSubject: true })`, #2958) may never carry it. One table, consulted in both application
|
|
869
|
+
* orders by {@link assertSubjectDisclosureAdmissible}, at the same chokepoint as the RAG-source pairs, so no door into the
|
|
870
|
+
* metadata bypasses it.
|
|
871
|
+
*/
|
|
872
|
+
const SUBJECT_DISCLOSURE_REFUSED_COMPANIONS: ReadonlyMap<ZodDecorator, string> = new Map([
|
|
873
|
+
[ZodDecorator.IS_PASSWORD, 'a password never leaves the backend, not even to the person it belongs to.'],
|
|
874
|
+
[ZodDecorator.IS_OTP, 'a one-time code never leaves the backend once it was sent.'],
|
|
875
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET, 'a write-only secret is masked on every response, so it is not disclosed to anyone.'],
|
|
876
|
+
[ZodDecorator.IS_EPHEMERAL, 'an ephemeral value is shown once, when it is minted, and never again.'],
|
|
877
|
+
]);
|
|
878
|
+
|
|
879
|
+
/** Whether a stored `IS_BACKEND_ONLY` value declares the subject-disclosure opt-in. */
|
|
880
|
+
function declaresDisclosedToSubject(value: unknown): boolean {
|
|
881
|
+
return typeof value === 'object' && value !== null && (value as BackendOnlyFieldParams).disclosedToSubject === true;
|
|
882
|
+
}
|
|
883
|
+
|
|
884
|
+
/**
|
|
885
|
+
* Refuse `isBackendOnly({ disclosedToSubject: true })` on a field that holds a secret, in either order (#2958): applied to
|
|
886
|
+
* a field already marked a secret, applied with `isReturnedAtCreation` (a server-minted secret shown once), or a secret
|
|
887
|
+
* marker applied to a field already opted in. Run after an updater is resolved, so an updater that adds the opt-in is
|
|
888
|
+
* checked too, and before anything is written.
|
|
889
|
+
*/
|
|
890
|
+
function assertSubjectDisclosureAdmissible(decorator: ZodDecorator, params: unknown, currentMetadata: CustomFieldMetadata): void {
|
|
891
|
+
if (decorator === ZodDecorator.IS_BACKEND_ONLY) {
|
|
892
|
+
if (!declaresDisclosedToSubject(params)) return;
|
|
893
|
+
if ((params as BackendOnlyFieldParams).isReturnedAtCreation) {
|
|
894
|
+
throw new Error('isBackendOnly() cannot declare both disclosedToSubject and isReturnedAtCreation: a value returned once at creation is a '
|
|
895
|
+
+ 'server-minted secret, and a subject export never discloses a secret.');
|
|
896
|
+
}
|
|
897
|
+
for (const [companion, reason] of SUBJECT_DISCLOSURE_REFUSED_COMPANIONS) {
|
|
898
|
+
if (currentMetadata[companion] !== undefined) {
|
|
899
|
+
throw new Error(`isBackendOnly({ disclosedToSubject: true }) cannot be combined with ${companion}(): ${reason}`);
|
|
900
|
+
}
|
|
901
|
+
}
|
|
902
|
+
return;
|
|
903
|
+
}
|
|
904
|
+
const reason = SUBJECT_DISCLOSURE_REFUSED_COMPANIONS.get(decorator);
|
|
905
|
+
if (reason !== undefined && declaresDisclosedToSubject(currentMetadata[ZodDecorator.IS_BACKEND_ONLY])) {
|
|
906
|
+
throw new Error(`${decorator}() cannot be combined with isBackendOnly({ disclosedToSubject: true }): ${reason}`);
|
|
907
|
+
}
|
|
908
|
+
}
|
|
909
|
+
|
|
803
910
|
function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
804
911
|
schema: T,
|
|
805
912
|
decorator: ZodDecorator,
|
|
@@ -829,6 +936,8 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
829
936
|
params = (params as (current: unknown) => unknown)(currentValue) as typeof params;
|
|
830
937
|
resolvedFromUpdater = true;
|
|
831
938
|
}
|
|
939
|
+
// A subject-disclosed backend-only field never holds a secret (#2958). Checked on the RESOLVED params, before any write.
|
|
940
|
+
assertSubjectDisclosureAdmissible(decorator, params, currentMetadata);
|
|
832
941
|
// After function resolution, params is a concrete value (never a function).
|
|
833
942
|
// TypeScript can't narrow this from control flow. Use `rp<D>()` for typed
|
|
834
943
|
// access in cases that read properties; use `p` for simple assignments.
|
|
@@ -988,6 +1097,9 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
988
1097
|
case ZodDecorator.IS_DECIDER:
|
|
989
1098
|
currentMetadata[ZodDecorator.IS_DECIDER] = true;
|
|
990
1099
|
break;
|
|
1100
|
+
case ZodDecorator.IS_ROLE_GRANT:
|
|
1101
|
+
currentMetadata[ZodDecorator.IS_ROLE_GRANT] = true;
|
|
1102
|
+
break;
|
|
991
1103
|
case ZodDecorator.RAG_SOURCE: {
|
|
992
1104
|
// NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A bare `.ragSource()`
|
|
993
1105
|
// (the common case) stores `{}` rather than `true`/`undefined`, so every reader sees ONE
|
|
@@ -1065,6 +1177,17 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
1065
1177
|
case ZodDecorator.OBJECT_BUSINESS_KEY_SET:
|
|
1066
1178
|
currentMetadata[ZodDecorator.OBJECT_BUSINESS_KEY_SET] = p;
|
|
1067
1179
|
break;
|
|
1180
|
+
case ZodDecorator.OBJECT_COMPOUND_INDEX: {
|
|
1181
|
+
// ACCUMULATES: each call declares one more index. A fresh array, never a push, so the schema this one was
|
|
1182
|
+
// derived from keeps its own list (decorators are builders, #1308). The same field list twice is one index.
|
|
1183
|
+
const existing = (currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] ?? []) as CompoundIndexParams[];
|
|
1184
|
+
const declared = p as CompoundIndexParams;
|
|
1185
|
+
const key = declared.fields.join('\u0000');
|
|
1186
|
+
currentMetadata[ZodDecorator.OBJECT_COMPOUND_INDEX] = existing.some((index) => index.fields.join('\u0000') === key)
|
|
1187
|
+
? existing
|
|
1188
|
+
: [...existing, { fields: [...declared.fields] }];
|
|
1189
|
+
break;
|
|
1190
|
+
}
|
|
1068
1191
|
case ZodDecorator.RESOURCE_REFERENCE:
|
|
1069
1192
|
currentMetadata[ZodDecorator.RESOURCE_REFERENCE] = p;
|
|
1070
1193
|
break;
|
|
@@ -15,6 +15,7 @@ Use this file when you already know the field belongs in
|
|
|
15
15
|
| Sensitive backend-only field | `.isBackendOnly()` | This is the security boundary. |
|
|
16
16
|
| Discriminator field | `.isDiscriminator()` | Required when schema-family behavior depends on the field. |
|
|
17
17
|
| Frequently queried field | `.isDBIndexed()` | Use for real query/filter/join needs, not by habit. |
|
|
18
|
+
| A read that filters on some fields and sorts on another, on a table that keeps growing | `.compoundIndex(['organizationId', 'status', 'createdAt'])` on the OBJECT schema, once per index | Not unique (a composite identity is `.businessKeySet([...])`). Order is the index: equality filters first, the sort field last; a read filtering on a leading prefix is served too, and either sort direction is. Per-field `.isDBIndexed()` cannot return a filtered set in sort order, so on a large table the database sorts or scans instead. At least two fields, all declared on the object and stored (not virtual). Not yet on a polymorphic resource's base schema. |
|
|
18
19
|
| A reference to a row of a resource chosen at run time | `.isResourceReference({ targetSet })` on the `{ resourceType, resourceId }` object | For a reference whose resource TYPE is not fixed, such as a case of any work-unit resource. Reuse `WorkUnitRefSchema` (cases) or `AgentWorkSubjectRefSchema` (case subjects) from `@wildo-ai/saas-models` rather than declaring a new object. The form then offers the published types, then the rows of the chosen one. Not `.isForeignKey()`: a foreign key names one fixed target through a relationship, and inside a nested object it changes how the id is stored. |
|
|
19
20
|
| What the last action said about itself | `.isLastActionRecord()` | For a row field an action REPLACES with its own words, such as the reason given for a decision or the justification for a reassignment. A verb's form starts from the row, so without it "Suspend" opens with the reason the previous acceptance was given. Never on a setting an action edits from its current value (a disclosure level, a list of admitted agents): starting from the current value is what makes that form safe to submit. |
|
|
20
21
|
| Which person decided something on the row | `.isDecider()` | For a field recording WHO took a decision on the row (`approvedByUserId`, `decidedByUserId`, `placedByUserId`). Declare on the operation that writes it whether the decision is sealed, naming the field (`approvalSeal: { capture: ApprovalPresentationCapture.NONE, reason, decides: ['approvedByUserId'] }`: an application's operations do not seal; a decision on something proposed is taken on a decision plane, which seals it, see `config-saas`'s key-management reference). The engine checks this over its own resources; nothing checks an application's yet, so the marker and the declaration are yours to keep together. Not on a field naming who CREATED or INVITED something, which decides nothing. |
|
|
@@ -15,6 +15,7 @@ flattened into a plain primitive.
|
|
|
15
15
|
| `z_address(options?)` | `{ line1, line2?, city, state?, postalCode?, country, coordinates? }` | Postal addresses that must be validated, normalized, compared (`isSameAddress`) or carry a geocode |
|
|
16
16
|
| `z_code(options?)` | `{ content, language }` | Code snippets or editable code payloads |
|
|
17
17
|
| `z_bigdecimal(options?)` | decimal string | Arbitrary precision numeric values |
|
|
18
|
+
| `z_yearMonth()` | `YYYY-MM` string | A period whose grain is the month (a monthly budget, a billing month): read as "October 2026" in the reader's language, picked as a month and a year, and filtered by a month picker (or a range of months, with `Resources_Filter_YearMonthRangeSchema` in `filterFields`). `isYearMonthField(schema)` answers whether a schema holds one. Never a `z.date()` pinned to the 1st, never a bare string the user types |
|
|
18
19
|
|
|
19
20
|
## Not a factory: `versioned` / `z_foreignKeyVersioned`
|
|
20
21
|
|
|
@@ -27,6 +28,47 @@ for document versions or an audit history: you would get an ordinary field whose
|
|
|
27
28
|
mechanism that does not exist. Model the requirement explicitly instead — a child resource carrying
|
|
28
29
|
the revisions, or a retained row (see `framework-erasure-scrub-treatments-api.md`).
|
|
29
30
|
|
|
31
|
+
## Dates: always `z.date()`
|
|
32
|
+
|
|
33
|
+
Every date you declare is `z.date()`: on a resource, in a custom operation's request or response, in a batch's input
|
|
34
|
+
or output, in an inbound handler's payload, in an agent tool's arguments or an agent's structured output. JSON carries a
|
|
35
|
+
date as an RFC 3339 string (`"2026-11-07T10:00:00Z"`, or a calendar day `"2026-11-07"`), and the framework reads that
|
|
36
|
+
form for you wherever it parses JSON: requests and responses, WebSocket and queue messages, inbound deliveries, agent
|
|
37
|
+
tool calls and structured output, batch input. It reads RFC 3339 only: `"May 2"` or `"2026-02-30"` is refused, never
|
|
38
|
+
guessed into a date.
|
|
39
|
+
|
|
40
|
+
When your own code parses JSON the framework did not parse for you (a response your code fetched, a file it read), parse
|
|
41
|
+
it with `jsonParsingSchemaOf` from `@wildo-ai/saas-models` rather than with the schema you declared, which would refuse
|
|
42
|
+
the string:
|
|
43
|
+
|
|
44
|
+
```ts
|
|
45
|
+
import { jsonParsingSchemaOf } from '@wildo-ai/saas-models';
|
|
46
|
+
|
|
47
|
+
const invoice = jsonParsingSchemaOf(InvoiceSchema).parse(await response.json()); // invoice.issuedAt is a Date
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
That is for JSON from somewhere else. A response from your OWN backend comes through the framework client
|
|
51
|
+
(`doOperation` and the resource hooks), which already reads its dates; do not re-parse it with a shared schema, which may
|
|
52
|
+
declare fields the server strips before sending (a backend-only field) and would then refuse every real response.
|
|
53
|
+
|
|
54
|
+
Never write `z.coerce.date()`: it turns `null` into `1970-01-01T00:00:00.000Z` and accepts it as a date.
|
|
55
|
+
|
|
56
|
+
A date another system writes in its own form is not RFC 3339. A timestamp in SECONDS (Stripe's `created`, a Unix time)
|
|
57
|
+
is `z.number()`: a number is read as milliseconds, so seconds would land in January 1970. A `"YYYY-MM-DD HH:MM:SS"`
|
|
58
|
+
string, which names no zone, is `z.string()`. Convert either yourself.
|
|
59
|
+
|
|
60
|
+
Two providers are read for you, so their dates are `z.date()`: an OData v2 service's `/Date(<ms>)/`, and Odoo's
|
|
61
|
+
`"YYYY-MM-DD HH:MM:SS"`, which Odoo always writes in UTC. Odoo's form is read as UTC on an Odoo read-through field whose
|
|
62
|
+
schema is `z.date()` (a field declared `z.string()` keeps the text), and by a pipeline mapping declaring
|
|
63
|
+
`ISO_STRING_TO_DATE` on an Odoo source. A `Date` you filter on or write is sent to Odoo in that same form.
|
|
64
|
+
|
|
65
|
+
A rule about time (an expiry that must be in the future) belongs on the REQUEST of the operation that sets the value
|
|
66
|
+
(its `customRequestDto` field), never on the stored field: a date's checks also run when a record is read back, so a
|
|
67
|
+
"must be in the future" rule on the resource's own field would refuse every record whose date has since passed. Write
|
|
68
|
+
it as a refinement, checked against the clock at each parse, with some allowance for a client clock that runs behind:
|
|
69
|
+
`z.date().refine((at) => at.getTime() > Date.now() - 5 * 60_000, 'Must be in the future')`. Never `.min(new Date())`:
|
|
70
|
+
its bound is the moment the module loaded.
|
|
71
|
+
|
|
30
72
|
## Shared-Layer Rule
|
|
31
73
|
|
|
32
74
|
These helpers still belong to the shared schema layer because they define
|
|
@@ -61,6 +103,36 @@ Two startup refusals to expect:
|
|
|
61
103
|
|
|
62
104
|
A PDF-generated `z_file` cannot carry `scanPolicy`; it is an upload option.
|
|
63
105
|
|
|
106
|
+
## Attaching an uploaded file is a second write
|
|
107
|
+
|
|
108
|
+
An uploadable `z_file` field gets an upload route on its resource wherever the resource exposes the
|
|
109
|
+
operation it belongs to: `POST …/<resource>/files/<field>` beside the API CREATE (before the record
|
|
110
|
+
exists) and `POST …/<resource>/<id>/files/<field>` beside the API UPDATE (`<field>` is the field name in kebab-case: `proofDocument` → `proof-document`). Either one only STAGES a
|
|
111
|
+
file: it checks the caller may write the record, validates the bytes against the field, stores and
|
|
112
|
+
scans them, and answers the new `fileId` with its `readiness`. **It never writes the record.** The
|
|
113
|
+
record carries the file once a CREATE or UPDATE sets the field, and that write is also where the
|
|
114
|
+
resource's own rules run (a field frozen in some status, a role that may not edit it). The generated
|
|
115
|
+
form does both steps for you.
|
|
116
|
+
|
|
117
|
+
Code that calls the API directly (a script, an integration, a test) must make the second write too:
|
|
118
|
+
|
|
119
|
+
1. upload, and keep `file.fileId` from the answer;
|
|
120
|
+
2. poll `GET /files/<fileId>/metadata` until `readiness` is `ready` (`processing` means the scanner
|
|
121
|
+
still holds it; `unavailable` means it can never be attached);
|
|
122
|
+
3. `PUT …/<resource>/<id>` setting the field:
|
|
123
|
+
- a single-file field takes `{ "<field>": { "fileId": "…" } }`;
|
|
124
|
+
- a multi-file field takes `{ "<field>": { "fileIds": [ … ] } }`, and the list
|
|
125
|
+
REPLACES the field's files: send the files already attached plus the new one, or the ones you
|
|
126
|
+
leave out are detached.
|
|
127
|
+
|
|
128
|
+
`updatedAt` is optional on a write: the server sets it. Send back the value you read to leave it unchanged.
|
|
129
|
+
|
|
130
|
+
The same principal must upload and attach: a staged file can be attached only by its uploader, and
|
|
131
|
+
anyone else is answered as if the file did not exist. Once attached, the file is linked to the record
|
|
132
|
+
and its metadata reads `attached`. An upload nobody attaches is reaped by the cleanup batch, and
|
|
133
|
+
anything that reads the field (text extraction, retrieval, a verification that requires a proof)
|
|
134
|
+
sees no file.
|
|
135
|
+
|
|
64
136
|
## Do Not Flatten Them
|
|
65
137
|
|
|
66
138
|
Avoid replacing a domain factory with a plain primitive just because it is
|
|
@@ -77,7 +77,25 @@ naming them. Give transitions a customer relies on `riskLevel: HIGH`, which audi
|
|
|
77
77
|
|
|
78
78
|
Every variant of a transition needs its own `enabledCondition`: a second variant (an administrator's,
|
|
79
79
|
say) without one is not checked against the starting state at all. Two transitions arriving at the
|
|
80
|
-
same moment
|
|
80
|
+
same moment cannot both land: the engine makes the write conditional on the fields the condition read,
|
|
81
|
+
so the second is refused with 409 `version_conflict` (re-read the record and decide again). A transition
|
|
82
|
+
that runs in a transaction, as the engine's own status verbs do, is judged again on the committed row
|
|
83
|
+
instead, so its loser gets the same refusal a later call gets. That is why the condition should read
|
|
84
|
+
the row's scalar fields directly (`currentObject.status === …`): a condition that copies or enumerates
|
|
85
|
+
the row (`{ ...currentObject }`, `Object.keys`), or reads a date, an array or an object, also pins the
|
|
86
|
+
row's version, so any concurrent ordinary edit refuses the transition.
|
|
87
|
+
|
|
88
|
+
**The condition must say everything the transition refuses**, because the same function decides whether
|
|
89
|
+
the action is OFFERED. A handler that refuses on its own ("not while the request is a draft", "you cannot
|
|
90
|
+
approve your own request") while the condition says nothing offers an action that then fails: the person
|
|
91
|
+
clicks "Approve" on a draft and reads an error. So:
|
|
92
|
+
|
|
93
|
+
- **Write the lifecycle once, as data**: a table of the states each transition leaves from
|
|
94
|
+
(`Record<Operations, ReadonlySet<Status>>`) beside the operations enum, read by every condition and by
|
|
95
|
+
any check a handler keeps. Six inline comparisons drift apart; one table cannot.
|
|
96
|
+
- **Say who in the condition too.** A transition only the record's author may take, or that its author
|
|
97
|
+
may never take, compares the owner field with `initiatorIds.userId`, and lists that field in
|
|
98
|
+
`enabledConditionFields` so list rows carry it. See `references/framework-operation-condition-parameters-api.md`.
|
|
81
99
|
|
|
82
100
|
### Step 4 — Freeze what is locked or final
|
|
83
101
|
|
|
@@ -96,6 +114,16 @@ a `postfixCoreOperations` hook that creates the target through `utils.servicesRe
|
|
|
96
114
|
The UI offers each operation as an action and hides it while its `enabledCondition` is false; show the
|
|
97
115
|
status read-only (`resource-ui-behavior`), never as an editable select.
|
|
98
116
|
|
|
117
|
+
What the person sees when a transition is unavailable:
|
|
118
|
+
|
|
119
|
+
- a list row hides the action; a record page shows it disabled, with the reason generated from the
|
|
120
|
+
operation's `unavailableWhen` in its specification (`spec-resource-update`). Write that sentence for
|
|
121
|
+
every transition. Give the view `actionVisibility: WHEN_AVAILABLE` in the ui-behavior to hide it
|
|
122
|
+
there too;
|
|
123
|
+
- a call made anyway (an old tab, an API client) is refused by the engine before any hook, as 403
|
|
124
|
+
`service_resource_operation_disabled`, and the toast speaks the same `unavailableWhen` sentence.
|
|
125
|
+
A refusal the handler raises for any other reason carries a declared code (`backend-custom-operation`).
|
|
126
|
+
|
|
99
127
|
## Worked Example
|
|
100
128
|
|
|
101
129
|
A quote's DRAFT → SENT → ACCEPTED / DECLINED lifecycle, frozen once sent, with what each line earns:
|
|
@@ -105,6 +133,7 @@ A quote's DRAFT → SENT → ACCEPTED / DECLINED lifecycle, frozen once sent, wi
|
|
|
105
133
|
|
|
106
134
|
- `references/quote-lifecycle-worked-example.md` — the source-backed schema, relationship and configuration of a complete lifecycle.
|
|
107
135
|
- `references/commercial-documents.md` — what makes a quote, order or invoice trustworthy (number, money, lines, server total, freeze, PDF), routed to the skill that owns each part.
|
|
136
|
+
- `references/framework-operation-condition-parameters-api.md` — what a condition receives (the row, the person asking), and why it must say everything the transition refuses.
|
|
108
137
|
|
|
109
138
|
## Verification
|
|
110
139
|
|
|
@@ -112,6 +141,8 @@ A quote's DRAFT → SENT → ACCEPTED / DECLINED lifecycle, frozen once sent, wi
|
|
|
112
141
|
- [ ] Every transition has `resourceOperationLike: UPDATE`, an empty `requestDto`, an `enabledCondition` and `authoritativeFields`.
|
|
113
142
|
- [ ] UPDATE has an `enabledCondition` when the resource has a locked or final state.
|
|
114
143
|
- [ ] A transition that creates another resource has a `transactionalCore` implementation.
|
|
144
|
+
- [ ] Every state or person check a transition's handler makes is also in its `enabledCondition`, read from one table of source states.
|
|
145
|
+
- [ ] Every transition's specification states `unavailableWhen`.
|
|
115
146
|
|
|
116
147
|
### Grep invariants
|
|
117
148
|
|
|
@@ -125,7 +156,12 @@ rg -c "resourceOperationLike: CoreResourceOperation.UPDATE" shared-lib/src/modul
|
|
|
125
156
|
# every transition declares an EMPTY body: this count equals T (an absent requestDto inherits UPDATE's whole body)
|
|
126
157
|
rg -c "requestDto: z.object\(\{\}\)" shared-lib/src/modules --glob '*.resources-config.ts'
|
|
127
158
|
# every transition names its starting state: this count is T, plus 1 when UPDATE is frozen (the worked example: 3 + 1 = 4)
|
|
128
|
-
rg -c "enabledCondition" shared-lib/src/modules --glob '*.resources-config.ts'
|
|
159
|
+
rg -c "enabledCondition:" shared-lib/src/modules --glob '*.resources-config.ts'
|
|
160
|
+
# a handler refusing on state or person: each hit must be mirrored by its operation's enabledCondition
|
|
161
|
+
# (a lexical sweep: it finds comparisons and table look-ups, not a refusal written any other way, so read each handler too)
|
|
162
|
+
rg -n "status !==|status ===|initiatorIds|SOURCE_STATUSES|LeavesFrom" backend-api/src/modules
|
|
163
|
+
# every transition says why it can be unavailable: this count equals the enabledCondition count above
|
|
164
|
+
rg -c "unavailableWhen" specifications/src/modules --glob '*.resource.specification.ts'
|
|
129
165
|
```
|
|
130
166
|
|
|
131
167
|
## Common Rationalizations
|
|
@@ -134,6 +170,8 @@ rg -c "enabledCondition" shared-lib/src/modules --glob '*.resources-config.ts'
|
|
|
134
170
|
|---|---|
|
|
135
171
|
| "A status select on the edit form is simpler" | It lets any state jump to any other and stamps nothing. The engine can only refuse a move it sees as an operation. |
|
|
136
172
|
| "`enabledCondition` just hides the button" | The engine evaluates it on the backend before the operation runs and refuses the call. It is the guard. |
|
|
173
|
+
| "The handler already refuses a draft, so the condition can stay simple" | The condition is also what OFFERS the action. A check only the handler makes shows the person an action that fails when they press it (measured: "Department-head decision" offered on a draft, then refused with 409). |
|
|
174
|
+
| "Who may act is the `roles` gate's job" | Roles say which people may ever act. "Not on your own request" and "only the requester" are about this row and this person, which a role cannot express: compare the owner field with `initiatorIds.userId` in the condition. |
|
|
137
175
|
| "The prefix sets `status`, so I don't need `authoritativeFields`" | It works over HTTP, and silently writes nothing when an MCP tool or another service calls the transition with `status` already in its payload: the strict re-parse strips the excluded field. |
|
|
138
176
|
| "Store the next action so the list can show it" | It drifts from the records the moment either changes. Derive it in a view. |
|
|
139
177
|
|
|
@@ -143,6 +181,8 @@ rg -c "enabledCondition" shared-lib/src/modules --glob '*.resources-config.ts'
|
|
|
143
181
|
- A transition variant with no `authoritativeFields` (catch with the **declares what it writes** count).
|
|
144
182
|
- A transition that accepts a body, or declares none and so inherits UPDATE's (catch with the **EMPTY body** counts).
|
|
145
183
|
- A transition variant with no `enabledCondition`, such as an administrator's second variant (catch with the **starting state** count).
|
|
184
|
+
- A handler that refuses on the record's status or on who is asking while the condition does not (catch with the **handler refusing on state or person** grep).
|
|
185
|
+
- A transition with an `enabledCondition` and no `unavailableWhen` in its specification (catch with the **why it can be unavailable** count): the disabled action and the refusal explain nothing.
|
|
146
186
|
- A conversion written straight to another resource's repository instead of `servicesRegistry.create` (catch by reading the operation file against `backend-custom-operation` Worked Example 2).
|
|
147
187
|
|
|
148
188
|
## Related Skills
|