@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
|
@@ -27,8 +27,10 @@ in `call`:
|
|
|
27
27
|
|
|
28
28
|
| you want | `target` | `call` |
|
|
29
29
|
|---|---|---|
|
|
30
|
-
| an Odoo recordset method (`action_post`, `action_confirm`) | `record` | `{ shape: 'odoo-execute-kw', method, inputPlacement }` |
|
|
31
|
-
| an Odoo model method (`create`) | `none` | `{ shape: 'odoo-execute-kw', method, model?, inputPlacement }` |
|
|
30
|
+
| an Odoo recordset method (`action_post`, `action_confirm`), JSON-RPC instance | `record` | `{ shape: 'odoo-execute-kw', method, inputPlacement }` |
|
|
31
|
+
| an Odoo model method (`create`), JSON-RPC instance | `none` | `{ shape: 'odoo-execute-kw', method, model?, inputPlacement }` |
|
|
32
|
+
| an Odoo recordset method, JSON-2 instance | `record` | `{ shape: 'odoo-json2-method', method, inputPlacement }` |
|
|
33
|
+
| an Odoo model method, JSON-2 instance | `none` | `{ shape: 'odoo-json2-method', method, model?, inputPlacement, inputParameter? }` |
|
|
32
34
|
| an OData bound action | `record` | `{ shape: 'odata-bound-action', qualifiedName: 'Namespace.Action' }` |
|
|
33
35
|
| an OData unbound action import | `none` | `{ shape: 'odata-unbound-action', actionImport }` |
|
|
34
36
|
|
|
@@ -39,9 +41,13 @@ the binding of the model it is called on.
|
|
|
39
41
|
Each declaration also carries:
|
|
40
42
|
|
|
41
43
|
- `input` — a Zod OBJECT schema. It is parsed STRICTLY: a key it does not name is refused, never
|
|
42
|
-
forwarded to the vendor. For Odoo, `inputPlacement` says where it goes
|
|
43
|
-
default), `positional` (`create(vals)`), or `none` (the method takes only its
|
|
44
|
-
then be `z.object({})`).
|
|
44
|
+
forwarded to the vendor. For Odoo, `inputPlacement` says where it goes. On `odoo-execute-kw`:
|
|
45
|
+
`keyword-arguments` (the default), `positional` (`create(vals)`), or `none` (the method takes only its
|
|
46
|
+
records; the input must then be `z.object({})`). On `odoo-json2-method`, where every argument is NAMED:
|
|
47
|
+
`named-parameters` (the default; each input member is one of the method's parameters),
|
|
48
|
+
`single-parameter` with `inputParameter` (the whole input is one parameter — for `create`,
|
|
49
|
+
`inputParameter: 'vals_list'`), or `none`. A JSON-2 input may not name `ids` or `context`: those are the
|
|
50
|
+
request's own members, and the engine fills `ids` from the target record.
|
|
45
51
|
- `output` (optional) — a Zod schema the vendor's answer is parsed through before you receive it.
|
|
46
52
|
- `writes` — whether it changes remote state. A writing action REQUIRES an Idempotency-Key from every
|
|
47
53
|
caller, and an interrupted attempt is an unknown outcome rather than a failure.
|
|
@@ -87,8 +93,27 @@ export enum SystemOfRecordActionCallShape {
|
|
|
87
93
|
* argument, which is how Odoo addresses a recordset method such as `action_post`.
|
|
88
94
|
*
|
|
89
95
|
* spec-cite: Odoo 18.0 developer documentation, External API — "Calling methods" (the execute_kw argument layout).
|
|
96
|
+
*
|
|
97
|
+
* Spoken over `ODOO_JSONRPC` only: `execute_kw` is a function of the `object` service at `/jsonrpc`, which Odoo removes
|
|
98
|
+
* at Online 21.1 and Odoo 22. An instance on JSON-2 declares {@link ODOO_JSON2_METHOD} instead (#3391).
|
|
90
99
|
*/
|
|
91
100
|
ODOO_EXECUTE_KW = 'odoo-execute-kw',
|
|
101
|
+
/**
|
|
102
|
+
* Odoo's External JSON-2 API (#3391): `POST /json/2/<model>/<method>` with a body of NAMED parameters — any public
|
|
103
|
+
* model method, the same as `execute_kw`, with the credential in an `Authorization: bearer` header. A record-targeted
|
|
104
|
+
* call names the record ids in the body's `ids` member, which is how JSON-2 addresses a recordset method such as
|
|
105
|
+
* `action_post`.
|
|
106
|
+
*
|
|
107
|
+
* A shape of its own rather than `ODOO_EXECUTE_KW` reused, because the two place an input differently and only one of
|
|
108
|
+
* them can say where: JSON-2 has no positional arguments, so an input that `execute_kw` passed by POSITION (`create`'s
|
|
109
|
+
* `vals`) must be given the parameter's NAME (`vals_list`), and `execute_kw` has no such field to carry it.
|
|
110
|
+
*
|
|
111
|
+
* spec-cite: Odoo 19.0 developer documentation, External JSON-2 API
|
|
112
|
+
* (https://www.odoo.com/documentation/19.0/developer/reference/external_api.html), "Request" — the body members `ids`
|
|
113
|
+
* ("An array of record ids on which to execute the method. Empty or omitted when calling an @api.model-decorated
|
|
114
|
+
* method."), `context`, and `param` ("As many time as needed, the method's parameters.").
|
|
115
|
+
*/
|
|
116
|
+
ODOO_JSON2_METHOD = 'odoo-json2-method',
|
|
92
117
|
/**
|
|
93
118
|
* An OData v4 BOUND action: `POST <EntitySet>(<key>)/<Namespace>.<Action>`, parameters in the JSON body.
|
|
94
119
|
*
|
|
@@ -109,6 +134,7 @@ export enum SystemOfRecordActionCallShape {
|
|
|
109
134
|
*/
|
|
110
135
|
export const SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT: Readonly<Record<SystemOfRecordActionCallShape, HttpApiTransportDialect>> = Object.freeze({
|
|
111
136
|
[SystemOfRecordActionCallShape.ODOO_EXECUTE_KW]: HttpApiTransportDialect.ODOO_JSONRPC,
|
|
137
|
+
[SystemOfRecordActionCallShape.ODOO_JSON2_METHOD]: HttpApiTransportDialect.ODOO_JSON2,
|
|
112
138
|
[SystemOfRecordActionCallShape.ODATA_BOUND_ACTION]: HttpApiTransportDialect.ODATA,
|
|
113
139
|
[SystemOfRecordActionCallShape.ODATA_UNBOUND_ACTION]: HttpApiTransportDialect.ODATA,
|
|
114
140
|
});
|
|
@@ -138,6 +164,36 @@ export enum SystemOfRecordOdooActionInputPlacement {
|
|
|
138
164
|
NONE = 'none',
|
|
139
165
|
}
|
|
140
166
|
|
|
167
|
+
/**
|
|
168
|
+
* Where an Odoo JSON-2 action's validated input goes in the request body (#3391). The counterpart of
|
|
169
|
+
* {@link SystemOfRecordOdooActionInputPlacement}, with POSITIONAL replaced by a NAMED parameter: JSON-2 binds every body
|
|
170
|
+
* member to the method's signature by name and has no positional form.
|
|
171
|
+
*
|
|
172
|
+
* spec-cite: Odoo 19.0 developer documentation, External JSON-2 API, "Migrating from XML-RPC / JSON-RPC" — "All the
|
|
173
|
+
* arguments are named; there is no way in JSON-2 to call a function with positional arguments."
|
|
174
|
+
*/
|
|
175
|
+
export enum SystemOfRecordOdooJson2ActionInputPlacement {
|
|
176
|
+
/**
|
|
177
|
+
* Each member of the input object is one of the method's named parameters. The default, and the counterpart of
|
|
178
|
+
* `KEYWORD_ARGUMENTS`: a recordset method's options are its parameters.
|
|
179
|
+
*/
|
|
180
|
+
NAMED_PARAMETERS = 'named-parameters',
|
|
181
|
+
/**
|
|
182
|
+
* The whole input object is the value of ONE named parameter, `inputParameter`: the body is
|
|
183
|
+
* `{ "<inputParameter>": <input> }`. The counterpart of `POSITIONAL`, and `create` is the canonical case: its signature
|
|
184
|
+
* is `create(self, vals_list)`, and Odoo's `model_create_multi` accepts one mapping there and treats it as a list of
|
|
185
|
+
* one, so `{ "vals_list": { …values… } }` creates one record. JSON-2 answers a created recordset as its ids, so that
|
|
186
|
+
* call answers `[<id>]`, a list, where `execute_kw('create', [vals])` answered the bare id.
|
|
187
|
+
*
|
|
188
|
+
* spec-cite: Odoo 19.0 source, `odoo/orm/decorators.py` `model_create_multi` ("if isinstance(vals_list, Mapping):
|
|
189
|
+
* vals_list = [vals_list]") and `addons/rpc/controllers/json2.py` `web_json_2_rpc` ("if isinstance(result, BaseModel):
|
|
190
|
+
* result = result.ids") — https://github.com/odoo/odoo/tree/19.0.
|
|
191
|
+
*/
|
|
192
|
+
SINGLE_PARAMETER = 'single-parameter',
|
|
193
|
+
/** The method takes nothing beyond its records (`action_post`, `button_confirm`). The declared input must then be empty. */
|
|
194
|
+
NONE = 'none',
|
|
195
|
+
}
|
|
196
|
+
|
|
141
197
|
/**
|
|
142
198
|
* How a RECORD-FREE action relates to the instance's partitions (#1058), required at boot when the instance is
|
|
143
199
|
* partitioned. A record-targeted action needs none: the record it reads first carries its partition.
|
|
@@ -166,7 +222,8 @@ export const SystemOfRecordActionPartitionStanceSchema = z.discriminatedUnion('k
|
|
|
166
222
|
kind: z.literal(SystemOfRecordActionPartitionStanceKind.MEMBER_UNIT_PARTITION),
|
|
167
223
|
/**
|
|
168
224
|
* The REMOTE parameter the placed partition value is written into (`company_id`): a key of the Odoo keyword
|
|
169
|
-
* arguments or of the positional input object, or a member of the
|
|
225
|
+
* arguments or of the positional input object (`execute_kw`), a named parameter or a member of the single-parameter
|
|
226
|
+
* object (JSON-2), or a member of the OData body. The caller's input may not carry it.
|
|
170
227
|
*/
|
|
171
228
|
parameter: z.string().min(1).max(120),
|
|
172
229
|
}),
|
|
@@ -186,6 +243,19 @@ export const SystemOfRecordActionCallSchema = z.discriminatedUnion('shape', [
|
|
|
186
243
|
model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
|
|
187
244
|
inputPlacement: z.enum(SystemOfRecordOdooActionInputPlacement).default(SystemOfRecordOdooActionInputPlacement.KEYWORD_ARGUMENTS),
|
|
188
245
|
}),
|
|
246
|
+
z.strictObject({
|
|
247
|
+
shape: z.literal(SystemOfRecordActionCallShape.ODOO_JSON2_METHOD),
|
|
248
|
+
/** The model method, in Odoo's own spelling (`action_post`, `create`) — the last segment of `/json/2/<model>/<method>`. */
|
|
249
|
+
method: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo method name is snake_case.').max(120),
|
|
250
|
+
/** As for `ODOO_EXECUTE_KW`: for a RECORD-FREE action only; absent means the binding's `entityRef`. */
|
|
251
|
+
model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
|
|
252
|
+
inputPlacement: z.enum(SystemOfRecordOdooJson2ActionInputPlacement).default(SystemOfRecordOdooJson2ActionInputPlacement.NAMED_PARAMETERS),
|
|
253
|
+
/**
|
|
254
|
+
* The method parameter the whole input becomes, for `SINGLE_PARAMETER` only (`vals_list` for `create`). Required with
|
|
255
|
+
* that placement and refused with any other, so a declaration cannot name a parameter nothing is sent in.
|
|
256
|
+
*/
|
|
257
|
+
inputParameter: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo parameter name is snake_case.').max(120).optional(),
|
|
258
|
+
}),
|
|
189
259
|
z.strictObject({
|
|
190
260
|
shape: z.literal(SystemOfRecordActionCallShape.ODATA_BOUND_ACTION),
|
|
191
261
|
/** The namespace-qualified action name (`Microsoft.Dynamics.CRM.WinOpportunity`). */
|
|
@@ -119,6 +119,14 @@ redeemed by a command when the agent's host can run one, and otherwise by the pe
|
|
|
119
119
|
grant's `uploadPageUrl` (a public drop page the engine ships — the fallback, not the design). See
|
|
120
120
|
`references/framework-file-upload-grant-contract.md`.
|
|
121
121
|
|
|
122
|
+
**Retries need nothing extra either, on an operation that declares `idempotencyKey`.** An agent calls a
|
|
123
|
+
tool again when a call fails, and a create that committed before the error then creates a second row.
|
|
124
|
+
On a variant declaring `idempotencyKey` (see `resource-config-wiring`, its idempotency-key reference) the
|
|
125
|
+
engine advertises an `idempotencyKey` argument — required for `REQUIRED`, optional for `ACCEPTED` — and
|
|
126
|
+
tells the agent to send a new value per change and the same value when it retries one; the repeat is
|
|
127
|
+
answered with the first result. Do not add such a field to the request DTO yourself: the application
|
|
128
|
+
refuses to start when a field of that name would collide with the argument.
|
|
129
|
+
|
|
122
130
|
### Step 3b (OPTIONAL): Split the catalog across NAMED servers
|
|
123
131
|
One `/mcp` serves ONE flat tool list, so when different consumers need different capability
|
|
124
132
|
postures — a read-only support surface vs a destructive operations one — declare **named servers**
|
|
@@ -84,13 +84,14 @@ with unknown arm outcomes when reliable reports were not returned. This is not a
|
|
|
84
84
|
interpreting missing context as missing source data. The framework owns these indexes; do not
|
|
85
85
|
create a separate application chunk store or re-indexing job.
|
|
86
86
|
|
|
87
|
-
**A
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
87
|
+
**A corpus lives on the application's one database.** An application uses exactly one
|
|
88
|
+
transactional store, MongoDB or PostgreSQL, and both serve retrieval (MongoDB through `mongot`,
|
|
89
|
+
PostgreSQL through pgvector). So never move a corpus resource to the other store: startup refuses a
|
|
90
|
+
resource whose `persistenceAdapter` is a transactional store other than the application default,
|
|
91
|
+
and no declaration admits it. If the deployment you have cannot search (a MongoDB without
|
|
92
|
+
`mongot`), fix the deployment, or move the whole application's `applicationDatabase`, not one
|
|
93
|
+
resource. A corpus built from uploaded documents keeps its file records on that same store, so a
|
|
94
|
+
row and its files commit and roll back together.
|
|
94
95
|
|
|
95
96
|
### Step 2: Decide which fields belong in the corpus
|
|
96
97
|
|
|
@@ -357,7 +358,7 @@ Run from the app root.
|
|
|
357
358
|
| Enumerate every corpus declaration in the application | `rg -n -e "\.ragSource\(" -e "ragSource:" shared-lib/src` |
|
|
358
359
|
| No corpus source shares a field with a refused companion | `rg -n -e "ragSource" -e "isPassword" -e "isOtp" -e "isWriteOnlySecret" -e "isEphemeral" -e "ttl" shared-lib/src` — inspect the declarations together, including multiline schemas; a corpus resource with a TTL policy is also refused even on another field |
|
|
359
360
|
| Every corpus resource uses a supported stored adapter | `rg -l -e "\.ragSource\(" -e "ragSource:" shared-lib/src` then `rg -n "persistenceAdapter" shared-lib/src/modules/*/resources/*/*.resources-config.ts` — resolve each named resource against its override or application database default; PostgreSQL and MongoDB are supported |
|
|
360
|
-
|
|
|
361
|
+
| No corpus resource sits on a second store | `rg -n -e "PersistenceAdapter.MONGODB" -e "PersistenceAdapter.POSTGRESQL" shared-lib/src` — each hit must name the application's own database; startup refuses any other, and no declaration admits it |
|
|
361
362
|
| Every authored overlap is smaller than its size | `rg -n -A1 "chunkSize:" shared-lib/src` — read each pair |
|
|
362
363
|
| Embeddings are configured or deliberately omitted | `rg -n "AI_EMBEDDINGS" wildo.saas.config.ts` — when semantic retrieval is required, expect the capability block, provider and selection; otherwise record lexical-only operation |
|
|
363
364
|
| No field opts into OCR without the capability behind it | `rg -n "ocr:\s*true" shared-lib/src` then `rg -n "AI_DOCUMENT_EXTRACTION" wildo.saas.config.ts` — a hit in the first with none in the second is a field paying nothing and getting nothing |
|
|
@@ -383,7 +384,7 @@ Run from the app root.
|
|
|
383
384
|
| "Nothing is retrievable until I configure an embeddings provider" | Once ingestion and search-index readiness complete, text is searchable lexically. A missing provider defers the semantic half of retrieval and nothing else — the corpus is still built, still erased with its rows, and still drains into vectors after a provider appears and processing/index readiness complete. |
|
|
384
385
|
| "I edited the field, so I should trigger a re-index" | The write already did. Old chunks are removed immediately — edited-away text must not keep answering questions — and the new text is re-derived after the write commits. |
|
|
385
386
|
| "The framework refuses secrets, so it will catch whatever I miss" | The five refusals are a floor, not a review. The framework cannot know that a free-text field happens to collect card numbers. The field-by-field question is still yours to ask. |
|
|
386
|
-
| "MongoDB needs a PostgreSQL exception for RAG" | Both stored adapters are supported
|
|
387
|
+
| "MongoDB needs a PostgreSQL exception for RAG" | Both stored adapters are supported, and an application uses one of them: there is no per-resource exception to the other. Check mongot and search-index readiness for MongoDB. HTTP_API and INTROSPECTION cannot host a corpus. |
|
|
387
388
|
| "I should filter the results so users only see their own rows" | Already done, three times over — before the search (the caller's roles), inside the query (the caller's tenancy, as a pre-filter), and after matching (each row re-read on the caller's authority). A filter you add on top can only remove rows the framework already admitted, which hides a defect instead of reporting one. |
|
|
388
389
|
| "Retrieval returned too little, so I will pass a system or elevated context" | That is a privilege escalation wearing a workaround's clothes: it makes one caller's query read another tenant's corpus. A short result is either the caller's roles, the resource's scope declaration, or a reported drop count — all three are visible, and all three are the thing to fix. |
|
|
389
390
|
| "I will only use results scoring above 0.5" | The fused score orders passages *within one query*. It is not a probability and not comparable across queries, so a fixed cutoff keeps everything on one query and nothing on the next. Rank and take the top N. |
|
|
@@ -395,6 +396,8 @@ Run from the app root.
|
|
|
395
396
|
|
|
396
397
|
- A declaration was authored before the resource's persistence adapter was checked — catch with the
|
|
397
398
|
**Every corpus resource uses a supported stored adapter** grep
|
|
399
|
+
- A corpus resource was moved to the other database instead of fixing the deployment — catch with the
|
|
400
|
+
**No corpus resource sits on a second store** grep
|
|
398
401
|
- A field holding ids, enum values, statuses or timestamps carries a declaration — catch with the
|
|
399
402
|
**Enumerate every corpus declaration** grep and read each hit
|
|
400
403
|
- A declaration sits on a field that also declares a secret, one-time code, ephemeral value or TTL
|
|
@@ -88,6 +88,16 @@ export enum EngineCapability {
|
|
|
88
88
|
*/
|
|
89
89
|
EMAIL_INBOUND = 'EMAIL_INBOUND',
|
|
90
90
|
SMS = 'SMS',
|
|
91
|
+
/**
|
|
92
|
+
* A deliverable signed by its signers' own electronic signatures, applied by a trust-service vendor (#2293): level 2 of
|
|
93
|
+
* epic #2916, opt-in per deliverable. Level 1 (the operator's seal over a decision, `KEY_MANAGEMENT`) needs no vendor.
|
|
94
|
+
*
|
|
95
|
+
* Its own slot: which vendor applies a client's signature is a legal and procurement decision (its levels, its
|
|
96
|
+
* environments, where it keeps the signed documents) that no other provider choice should make. Enabling it declares
|
|
97
|
+
* that deliverables are sent for signature, so an enabled slot with no provider refuses to start
|
|
98
|
+
* (`ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED`).
|
|
99
|
+
*/
|
|
100
|
+
ELECTRONIC_SIGNATURE = 'ELECTRONIC_SIGNATURE',
|
|
91
101
|
|
|
92
102
|
AI_LLM = 'AI_LLM',
|
|
93
103
|
AI_IMAGE_GENERATION = 'AI_IMAGE_GENERATION',
|
|
@@ -205,8 +215,7 @@ export enum EngineCapability {
|
|
|
205
215
|
* `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
|
|
206
216
|
* applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
|
|
207
217
|
* through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
|
|
208
|
-
* was
|
|
209
|
-
* model settled the other way. So the withdrawal removes a name, not a capability.
|
|
218
|
+
* was an early plan that the shipped model settled the other way. So the withdrawal removes a name, not a capability.
|
|
210
219
|
*
|
|
211
220
|
* The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
|
|
212
221
|
* member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
|
package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md
CHANGED
|
@@ -174,6 +174,32 @@ Do not require vectors before using a healthy lexical corpus. Equally, do not pr
|
|
|
174
174
|
ingestion or an unavailable search index as an empty knowledge base. Keep deployment readiness,
|
|
175
175
|
source derivation and optional vector enrichment distinct when reporting availability.
|
|
176
176
|
|
|
177
|
+
## Lexical matching follows the application's primary language
|
|
178
|
+
|
|
179
|
+
The lexical arm analyses chunk text and the question in the language the application declares as
|
|
180
|
+
primary (`appPreferences.languages.defaultLanguage` in `./backend-api/src/saas-config.backend.ts`;
|
|
181
|
+
English when none is declared). That language's stopwords are dropped and its words are stemmed, so
|
|
182
|
+
a question matches by its content words ("stalls" meets "stalled"), and a passage that shares only
|
|
183
|
+
common words with the question loses its advantage over the one that answers it. Ranking also favours
|
|
184
|
+
a short passage about the terms over a long one that mentions them in passing.
|
|
185
|
+
|
|
186
|
+
PostgreSQL and MongoDB analyse the same language but do not rank identically, so do not assert one
|
|
187
|
+
order for both. Each engine ships its own stopword list and PostgreSQL's is wider: for English, "what"
|
|
188
|
+
and "who" are dropped on PostgreSQL and kept on MongoDB, where a passage sharing only those can still
|
|
189
|
+
be returned, and can lead when nothing in the corpus answers better. A question made only of words on
|
|
190
|
+
the engine's list matches nothing.
|
|
191
|
+
|
|
192
|
+
- Nothing to configure: the language is derived, and there is no separate retrieval-language setting.
|
|
193
|
+
- Changing the primary language makes the store build a lexical index for the new language. On
|
|
194
|
+
MongoDB the lexical arm reports itself unavailable until that index is built.
|
|
195
|
+
- All text is analysed in that one language. Content or a question in another enabled language is
|
|
196
|
+
still matched, but with the primary language's rules, so its stopwords stay in and its words are
|
|
197
|
+
not stemmed properly.
|
|
198
|
+
- Some languages have no analyzer both databases share (for example Chinese, Japanese, Korean,
|
|
199
|
+
Polish, Czech). For those, text is tokenised and lowercased but no stopwords are dropped and
|
|
200
|
+
nothing is stemmed, so plan queries and evaluation accordingly.
|
|
201
|
+
- Vector search is unaffected by any of this: it is the arm that answers across languages.
|
|
202
|
+
|
|
177
203
|
## What comes back
|
|
178
204
|
|
|
179
205
|
## Import Origins
|
|
@@ -574,8 +600,9 @@ export enum RagRetrievalRefusalReason {
|
|
|
574
600
|
OPERATION_ROLES_DENIED = 'operation-roles-denied',
|
|
575
601
|
/**
|
|
576
602
|
* The READ authorization context for this resource could not be BUILT, so its role gate could not
|
|
577
|
-
* be evaluated at all: the resource exposes no resolvable READ operation,
|
|
578
|
-
* (depth / cycle detection) refused the context
|
|
603
|
+
* be evaluated at all: the resource exposes no resolvable READ operation, the sub-call budget
|
|
604
|
+
* (depth / cycle detection) refused the context, or the store could not answer the reads that
|
|
605
|
+
* decide the resource's row confinement for the caller (#3066).
|
|
579
606
|
*
|
|
580
607
|
* Deliberately NOT folded into {@link OPERATION_ROLES_DENIED}. That one is an answer; this one is
|
|
581
608
|
* the absence of a question, and reporting an unbuildable context as a role refusal would send an
|
|
@@ -129,26 +129,6 @@ export function getRagSourceConfig(schema: z.ZodTypeAny): RagSourceConfiguration
|
|
|
129
129
|
|
|
130
130
|
### Origin Package: `@wildo-ai/zod-decorators`
|
|
131
131
|
|
|
132
|
-
```typescript
|
|
133
|
-
*
|
|
134
|
-
* `.ragSource(config?)` — declare this field's text a source of the application's retrieval
|
|
135
|
-
* corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
|
|
136
|
-
* `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
|
|
137
|
-
* wrappers, so it composes anywhere in a decorator chain.
|
|
138
|
-
*
|
|
139
|
-
* The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
|
|
140
|
-
* declaration that accepts the framework chunking defaults. Presence IS enablement.
|
|
141
|
-
*
|
|
142
|
-
* @example
|
|
143
|
-
* z.string().ragSource()
|
|
144
|
-
* @example
|
|
145
|
-
* z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
|
|
146
|
-
*/
|
|
147
|
-
[ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<T>;
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
### Origin Package: `@wildo-ai/zod-decorators`
|
|
151
|
-
|
|
152
132
|
```typescript
|
|
153
133
|
*
|
|
154
134
|
* Standalone form of `.ragSource(config?)` — declare a field's text a RAG retrieval-corpus source.
|
|
@@ -183,3 +163,23 @@ export function addRagSource<T extends z.ZodTypeAny>(
|
|
|
183
163
|
]);
|
|
184
164
|
}
|
|
185
165
|
```
|
|
166
|
+
|
|
167
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
168
|
+
|
|
169
|
+
```typescript
|
|
170
|
+
*
|
|
171
|
+
* `.ragSource(config?)` — declare this field's text a source of the application's retrieval
|
|
172
|
+
* corpus. Live on every string-backed schema (`z.string()` and every string FORMAT such as
|
|
173
|
+
* `z.email()` / `z.url()`) and carried across the `.optional()` / `.nullable()` / `.default()`
|
|
174
|
+
* wrappers, so it composes anywhere in a decorator chain.
|
|
175
|
+
*
|
|
176
|
+
* The config is OPTIONAL and there is no `enabled` flag: a bare `.ragSource()` is a complete
|
|
177
|
+
* declaration that accepts the framework chunking defaults. Presence IS enablement.
|
|
178
|
+
*
|
|
179
|
+
* @example
|
|
180
|
+
* z.string().ragSource()
|
|
181
|
+
* @example
|
|
182
|
+
* z.string().ragSource({ chunkingStrategy: RAGChunkingStrategy.MARKDOWN, chunkSize: 1200, chunkOverlap: 150 }).optional()
|
|
183
|
+
*/
|
|
184
|
+
[ZodDecorator.RAG_SOURCE](config?: RagSourceConfiguration): DecoratedPrimitiveZodType<this>;
|
|
185
|
+
```
|
|
@@ -32,7 +32,9 @@ says how long a row lives at all. A row an erasure retained is still deleted whe
|
|
|
32
32
|
A statutory class RESTRICTS, it does not refuse. A resource bound to `BUSINESS_RECORDS` also declares
|
|
33
33
|
`retentionPolicy.statutoryRetention` — the legal ground. A subject erasure then completes every other part
|
|
34
34
|
of the request, keeps each of these rows RESTRICTED (retained, hidden from ordinary reads, frozen) until its
|
|
35
|
-
statutory period ends, and lists each one in its report with the ground and the date it may go.
|
|
35
|
+
statutory period ends, and lists each one in its report with the ground and the date it may go. A record that cannot
|
|
36
|
+
be frozen because work still arrives for it after its owner goes declares `staysInUseBecause` with the reason, keeps
|
|
37
|
+
its edges disabled or refusing, and is left as it is. That is rare: billing is the case.
|
|
36
38
|
|
|
37
39
|
## App Paths
|
|
38
40
|
|
|
@@ -95,6 +97,20 @@ statutory period ends, and lists each one in its report with the ground and the
|
|
|
95
97
|
migration (`wildo db generate`) when a field was added or `SCOPE_DELETED` injected `retentionStartedAt`.
|
|
96
98
|
8. **Stop** when startup logs the resource as bound with no warning and `wildo db diff --check` is clean.
|
|
97
99
|
|
|
100
|
+
## When a resource has no period
|
|
101
|
+
|
|
102
|
+
There is no default class, and a resource with no binding has no clock. That is normal when something else ends the row,
|
|
103
|
+
so do not bind a resource just to fill a gap. The framework works out what ends each resource's rows
|
|
104
|
+
(`ResourceRowLifetime`), and at startup it warns only about an application resource reading `UNDECIDED`: one that may
|
|
105
|
+
hold personal data and that nothing ever deletes.
|
|
106
|
+
|
|
107
|
+
- A resource under an owner whose deletion deletes it already has its answer: it ends with the tenant or the account.
|
|
108
|
+
- For a warned resource, bind a class, or give it a mandatory parent with a delete `onParentDelete`.
|
|
109
|
+
- `SCOPE_DELETED` counts from the row's owner going: the tenant purge for a row with `organizationId`, the person's erasure for a row with `userId` and no organization.
|
|
110
|
+
- Declare `rowLifetime: { lifetime, rationale }` only for a real mechanism no configuration can show, such as a batch you
|
|
111
|
+
wrote that deletes the rows. The declaration is a claim nothing checks, so never use it to quiet the warning. It may
|
|
112
|
+
not sit beside a binding, a `.ttl()` or a read-through resource.
|
|
113
|
+
|
|
98
114
|
## When the schedule must stop: legal holds
|
|
99
115
|
|
|
100
116
|
A litigation, a claim, an investigation or a legal obligation can require data to be kept PAST its period.
|
|
@@ -182,7 +198,7 @@ Grep invariants: `rg -n "retentionBinding" shared-lib/src` lists every bound res
|
|
|
182
198
|
- A closure field a client-routed create or update can write (the resource factory refuses it: a caller could backdate it into a delete).
|
|
183
199
|
- A handler that spreads the caller's input straight through with the closure field in it (catch it with a unit test that a forged value never reaches the write).
|
|
184
200
|
- A statutory record bound `SCOPE_DELETED` whose teardown edge deletes it (startup refuses it).
|
|
185
|
-
- An owned edge into a statutory resource that is silent, disabled, `DELETE` or `REFUSE_WHILE_CHILDREN_EXIST` (startup refuses it; catch it with `rg -n "onParentDelete" shared-lib/src` on the edges naming the resource).
|
|
201
|
+
- An owned edge into a statutory resource that is silent, disabled, `DELETE` or `REFUSE_WHILE_CHILDREN_EXIST`, with no `staysInUseBecause` (startup refuses it, and refuses a silent or `DELETE` edge either way; catch it with `rg -n "onParentDelete" shared-lib/src` on the edges naming the resource).
|
|
186
202
|
- A `BUSINESS_RECORDS` binding without `retentionPolicy.statutoryRetention` (the resource factory refuses it; catch it with the `rg -n "BUSINESS_RECORDS" shared-lib/src` grep beside `rg -n "statutoryRetention" shared-lib/src`).
|
|
187
203
|
|
|
188
204
|
## Related Skills
|
package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md
CHANGED
|
@@ -249,14 +249,58 @@ async function readTenantsMarkedForDeletion(utils: any, holds: readonly unknown[
|
|
|
249
249
|
});
|
|
250
250
|
}
|
|
251
251
|
|
|
252
|
+
/**
|
|
253
|
+
* How many ACTIVE holds each organization carries, in order (#1846): one read of the active holds of every distinct
|
|
254
|
+
* organization, so an operator's directory page of N tenants costs one query, not N.
|
|
255
|
+
*
|
|
256
|
+
* Every scope kind counts, because the question it answers is the organization purge's: a tenant is held while ANY of
|
|
257
|
+
* its holds is active, whether it holds the tenant, some of its rows or one of its people. Only the count leaves this
|
|
258
|
+
* function: never a hold's scope, ground, subject or matter text.
|
|
259
|
+
*
|
|
260
|
+
* `undefined` for an organization whose id is missing, and for EVERY organization when the holds cannot be read:
|
|
261
|
+
* unknown, never zero. A zero would tell an operator in an incident that a tenant is free to purge.
|
|
262
|
+
*
|
|
263
|
+
* Reads raw, below the operation tier, as every cross-resource virtual field does: the caller has already been
|
|
264
|
+
* admitted to the organization rows it hands in. Active holds are never retained rows (a hold's retention clock starts
|
|
265
|
+
* at `releasedAt`), so the status filter alone keeps the retention hide's population out.
|
|
266
|
+
*/
|
|
267
|
+
export async function readActiveLegalHoldCountsOfOrganizations(utils: any, organizations: readonly unknown[]): Promise<Array<number | undefined>> {
|
|
268
|
+
const idOf = (organization: unknown): string | undefined => {
|
|
269
|
+
const id = (organization as Record<string, unknown> | undefined)?.['_id'];
|
|
270
|
+
return id === undefined || id === null || String(id).length === 0 ? undefined : String(id);
|
|
271
|
+
};
|
|
272
|
+
const organizationIds = [...new Set(organizations.map(idOf).filter((id): id is string => id !== undefined))];
|
|
273
|
+
if (organizationIds.length === 0) return organizations.map(() => undefined);
|
|
274
|
+
const holdsRepository = utils?.repositories?.getRepository?.(CoreResourceType.LEGAL_HOLDS);
|
|
275
|
+
if (!holdsRepository || typeof holdsRepository.findManyByRawFilter !== 'function') return organizations.map(() => undefined);
|
|
276
|
+
const counts = new Map<string, number>(organizationIds.map((id) => [id, 0]));
|
|
277
|
+
try {
|
|
278
|
+
const holds: Array<Record<string, unknown>> = await holdsRepository.findManyByRawFilter({
|
|
279
|
+
status: LegalHoldStatus.ACTIVE,
|
|
280
|
+
organizationId: { $in: organizationIds },
|
|
281
|
+
});
|
|
282
|
+
for (const hold of holds) {
|
|
283
|
+
const organizationId = hold['organizationId'] === undefined || hold['organizationId'] === null ? undefined : String(hold['organizationId']);
|
|
284
|
+
if (organizationId !== undefined && counts.has(organizationId)) counts.set(organizationId, counts.get(organizationId)! + 1);
|
|
285
|
+
}
|
|
286
|
+
} catch (error) {
|
|
287
|
+
utils?.logger?.warn?.(`[organizations.activeLegalHoldCount] the active holds of ${organizationIds.length} organization(s) could not be read; reporting unknown`, error);
|
|
288
|
+
return organizations.map(() => undefined);
|
|
289
|
+
}
|
|
290
|
+
return organizations.map((organization) => {
|
|
291
|
+
const id = idOf(organization);
|
|
292
|
+
return id === undefined ? undefined : counts.get(id);
|
|
293
|
+
});
|
|
294
|
+
}
|
|
295
|
+
|
|
252
296
|
/** The `place` request. Coherence between `scopeKind` and the three optional selectors is checked server-side. */
|
|
253
297
|
export const LegalHoldPlaceRequestSchema = z.object({
|
|
254
|
-
scopeKind: z.enum(LegalHoldScopeKind).describe('What the hold covers: the whole organization, rows of one resource, or one person\'s data.'),
|
|
298
|
+
scopeKind: z.enum(LegalHoldScopeKind).systemEnum('LegalHoldScopeKind').describe('What the hold covers: the whole organization, rows of one resource, or one person\'s data.'),
|
|
255
299
|
resourceType: z.string().min(1).max(200).optional().describe('For a resource-rows hold: the resource type whose rows are held.'),
|
|
256
300
|
rowIds: z.array(z.string().min(1)).min(1).max(LEGAL_HOLD_MAXIMUM_ROW_IDS).optional()
|
|
257
301
|
.describe('For a resource-rows hold: the rows held. Omit to hold every row of the resource type in the organization.'),
|
|
258
302
|
subjectUserId: z.string().min(1).optional().describe('For a data-subject hold: the user whose data is held.'),
|
|
259
|
-
legalGround: z.enum(LegalHoldGround).describe('Why the data must be preserved.'),
|
|
303
|
+
legalGround: z.enum(LegalHoldGround).systemEnum('LegalHoldGround').describe('Why the data must be preserved.'),
|
|
260
304
|
justification: z.string().min(1).max(2000).describe('The matter or case the hold preserves data for.'),
|
|
261
305
|
});
|
|
262
306
|
export type LegalHoldPlaceRequest = z.infer<typeof LegalHoldPlaceRequestSchema>;
|
|
@@ -37,7 +37,7 @@ Read this when:
|
|
|
37
37
|
* | {@link LAST_UPDATED} | the most recent update | `updatedAt` — infrastructure-owned on both adapters |
|
|
38
38
|
* | {@link CLOSURE_EVENT} | the moment the declared closure date field is set | that field; null never expires |
|
|
39
39
|
* | {@link END_OF_CALENDAR_YEAR} | 31 December 23:59:59.999 UTC of the creation year | `createdAt` |
|
|
40
|
-
* | {@link SCOPE_DELETED} | the row's organization was marked for deletion | `retentionStartedAt`, stamped by the tenant purge |
|
|
40
|
+
* | {@link SCOPE_DELETED} | the row's owner went: its organization was marked for deletion, or its person was erased or deleted | `retentionStartedAt`, stamped by the tenant purge, the erasure or the sweep |
|
|
41
41
|
*
|
|
42
42
|
* Rejected: persisting a `retentionStartedAt` on EVERY bound row. `createdAt` and `updatedAt` are
|
|
43
43
|
* already maintained by the persistence adapter on every write path (the Mongoose timestamps plugin;
|
|
@@ -75,6 +75,11 @@ export enum RetentionStartPoint {
|
|
|
75
75
|
* - the row OUTLIVES its tenant (the edge is disabled, retains-and-impersonalizes, or is absent):
|
|
76
76
|
* the purge stamps `retentionStartedAt` with the organization's `deletionRequestedAt`, and the
|
|
77
77
|
* retention sweep deletes the row after its own class period.
|
|
78
|
+
*
|
|
79
|
+
* A row owned by a PERSON (it has `userId` and no `organizationId`) counts from that person going instead. Their
|
|
80
|
+
* erasure, which scrubs the user row and keeps it, stamps the clock in its transaction. The sweep stamps what is left:
|
|
81
|
+
* rows of a user an administrator deleted, and rows a late webhook created after they went. It then applies the class
|
|
82
|
+
* period the same way.
|
|
78
83
|
*/
|
|
79
84
|
SCOPE_DELETED = "SCOPE_DELETED",
|
|
80
85
|
}
|
|
@@ -108,4 +113,82 @@ export const ResourceRetentionBindingSchema = z.strictObject({
|
|
|
108
113
|
closureFieldName: z.string().trim().min(1).optional(),
|
|
109
114
|
});
|
|
110
115
|
export type ResourceRetentionBinding = z.infer<typeof ResourceRetentionBindingSchema>;
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* **What ends a resource's rows.** One answer per resource, derived by `deriveResourceRowLifetimes` and total over
|
|
119
|
+
* the registry, so a resource added tomorrow is answered with no list to update.
|
|
120
|
+
*
|
|
121
|
+
* ## Why this replaced "kept until erased"
|
|
122
|
+
*
|
|
123
|
+
* Most resources have neither a class nor a `.ttl()`, and they used to be reported under one sentence, "kept until
|
|
124
|
+
* erased". Most of them were not: they end with their tenant's purge, with their account, or through a dedicated
|
|
125
|
+
* cleanup, or they are other doors onto rows another resource owns, or they hold no personal data. A line true of
|
|
126
|
+
* nearly everything tells a reader nothing, so the handful that really had no end could not be seen.
|
|
127
|
+
*
|
|
128
|
+
* ## Why a row with no period can be compliant
|
|
129
|
+
*
|
|
130
|
+
* The storage-limitation duty applies to personal data, and what a notice owes is the period OR, where a fixed period
|
|
131
|
+
* is not possible, the criteria that determine it. "For as long as the account exists, then deleted" is such a
|
|
132
|
+
* criterion. So {@link ENDS_WITH_TENANT} and {@link ENDS_WITH_ACCOUNT} are answers and not gaps, and only
|
|
133
|
+
* {@link UNDECIDED} is a gap.
|
|
134
|
+
*
|
|
135
|
+
* spec-cite: GDPR Art. 13(2)(a) (period or criteria), https://gdpr-info.eu/art-13-gdpr/ — and Art. 5(1)(e) (storage
|
|
136
|
+
* limitation), https://gdpr-info.eu/art-5-gdpr/. Read 2026-11-04.
|
|
137
|
+
*/
|
|
138
|
+
export enum ResourceRowLifetime {
|
|
139
|
+
/** Bound to a retention class: the sweep deletes the row once the class period has passed since its start point. */
|
|
140
|
+
CLASS_PERIOD = "class_period",
|
|
141
|
+
/** A `.ttl()` expires the row after a fixed number of seconds. Framework plumbing that holds no business data. */
|
|
142
|
+
ROW_EXPIRY = "row_expiry",
|
|
143
|
+
/** A dedicated engine process removes the row once it has served its purpose: a token cleanup, a delivery buffer. Declared. */
|
|
144
|
+
DEDICATED_MECHANISM = "dedicated_mechanism",
|
|
145
|
+
/**
|
|
146
|
+
* A copy that follows its system of record: the pipeline re-reads the population, and a row that leaves the source is
|
|
147
|
+
* scrubbed. How long it is kept is the source's to answer. Only as long as the pipeline runs. Declared.
|
|
148
|
+
*/
|
|
149
|
+
FOLLOWS_SYSTEM_OF_RECORD = "follows_system_of_record",
|
|
150
|
+
/** The immutable audit trail. Never deleted: it moves to the archive at the `AUDIT_LOGS` horizon. Declared. */
|
|
151
|
+
AUDIT_TRAIL = "audit_trail",
|
|
152
|
+
/** Uploaded files: bytes released from their row are destroyed by the files cleanup after the `FILES` period. Declared. */
|
|
153
|
+
FILE_CLEANUP = "file_cleanup",
|
|
154
|
+
/** The operator's own configuration of the application. No person is its subject, and it lives until replaced. Declared. */
|
|
155
|
+
OPERATOR_CONFIGURATION = "operator_configuration",
|
|
156
|
+
/** Another door onto rows a different resource owns; the owner's answer is the answer. */
|
|
157
|
+
ROWS_OWNED_BY_ANOTHER_RESOURCE = "rows_owned_by_another_resource",
|
|
158
|
+
/** Read through from a system of record on each request: nothing is stored locally to keep. */
|
|
159
|
+
NOT_STORED_LOCALLY = "not_stored_locally",
|
|
160
|
+
/** Deleted by the tenant purge, directly or through a delete cascade from `organizations`. */
|
|
161
|
+
ENDS_WITH_TENANT = "ends_with_tenant",
|
|
162
|
+
/**
|
|
163
|
+
* Ends with the person's account, through a delete cascade from `users`. A resource that declares a retention treatment
|
|
164
|
+
* is scrubbed rather than deleted when the person is erased: that treatment says which, and this says when.
|
|
165
|
+
*/
|
|
166
|
+
ENDS_WITH_ACCOUNT = "ends_with_account",
|
|
167
|
+
/** Deleted in a delete cascade from a parent that has its own end: a class period, a `.ttl()`, a dedicated mechanism. */
|
|
168
|
+
ENDS_WITH_PARENT = "ends_with_parent",
|
|
169
|
+
/** Nothing deletes the row, and no field holds personal data, so storage limitation has nothing to limit. */
|
|
170
|
+
NO_PERSONAL_DATA = "no_personal_data",
|
|
171
|
+
/** The one real gap: the row holds personal data, or an application never said whether it does, and nothing ever ends it. */
|
|
172
|
+
UNDECIDED = "undecided",
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
/** The lifetimes a resource may DECLARE, because no configuration can show them: every other member is derived. */
|
|
176
|
+
export const DECLARABLE_RESOURCE_ROW_LIFETIMES = [
|
|
177
|
+
ResourceRowLifetime.DEDICATED_MECHANISM,
|
|
178
|
+
ResourceRowLifetime.FOLLOWS_SYSTEM_OF_RECORD,
|
|
179
|
+
ResourceRowLifetime.AUDIT_TRAIL,
|
|
180
|
+
ResourceRowLifetime.FILE_CLEANUP,
|
|
181
|
+
ResourceRowLifetime.OPERATOR_CONFIGURATION,
|
|
182
|
+
] as const;
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* A resource's statement of what ends its rows, for the case nothing in its configuration can show.
|
|
186
|
+
*
|
|
187
|
+
* `rationale` names the mechanism, so a reader can check it. Strict for the reason a binding is.
|
|
188
|
+
*/
|
|
189
|
+
export const ResourceRowLifetimeDeclarationSchema = z.strictObject({
|
|
190
|
+
lifetime: z.enum(DECLARABLE_RESOURCE_ROW_LIFETIMES),
|
|
191
|
+
rationale: z.string().trim().min(1),
|
|
192
|
+
});
|
|
193
|
+
export type ResourceRowLifetimeDeclaration = z.infer<typeof ResourceRowLifetimeDeclarationSchema>;
|
|
111
194
|
```
|
|
@@ -125,6 +125,16 @@ export const RetentionEnforcementRecordSchema = z.object({
|
|
|
125
125
|
* no hold check ran for this resource this run — "not measured", which is not the same as zero.
|
|
126
126
|
*/
|
|
127
127
|
heldSkippedCount: z.number().int().min(0).optional(),
|
|
128
|
+
/**
|
|
129
|
+
* Rows past their period the sweep did NOT delete because their tenant still exists (#3323): a purge that has not finished,
|
|
130
|
+
* or a clock left on a restored tenant. ABSENT means the resource's clock is not a tenant's, or no expired row was listed.
|
|
131
|
+
*/
|
|
132
|
+
liveTenantSkippedCount: z.number().int().min(0).optional(),
|
|
133
|
+
/**
|
|
134
|
+
* Rows past their period kept because records that depend on them have not reached theirs yet: a billing account while
|
|
135
|
+
* its last invoices run out. The next run tries again. ABSENT means no delete was refused this way.
|
|
136
|
+
*/
|
|
137
|
+
dependentsSkippedCount: z.number().int().min(0).optional(),
|
|
128
138
|
/**
|
|
129
139
|
* Rows retained under a statutory restriction (#1635) that are still inside their period — a count only.
|
|
130
140
|
* ABSENT means nothing measured it this run.
|
|
@@ -56,9 +56,11 @@ Read this when:
|
|
|
56
56
|
*
|
|
57
57
|
* A resource declares `retentionBinding: { retentionClass, startPoint }` in its resource
|
|
58
58
|
* configuration ({@link ResourceRetentionBindingSchema}). An engine sweep then deletes a bound row
|
|
59
|
-
* once `retentionDays` of its class have passed since the row's {@link RetentionStartPoint}.
|
|
60
|
-
* resource with no binding
|
|
61
|
-
*
|
|
59
|
+
* once `retentionDays` of its class have passed since the row's {@link RetentionStartPoint}. There is
|
|
60
|
+
* NO default class: a resource with no binding has no clock. That is normal for most resources, because
|
|
61
|
+
* a row usually ends with something else (its tenant, its account, its own process), and
|
|
62
|
+
* `deriveResourceRowLifetimes` answers for every resource which of those it is. Only a resource holding
|
|
63
|
+
* personal data that nothing ever ends reads {@link ResourceRowLifetime.UNDECIDED}.
|
|
62
64
|
*/
|
|
63
65
|
export enum DataRetentionClass {
|
|
64
66
|
/**
|
|
@@ -85,6 +85,15 @@ export interface ResourceRetentionPolicy {
|
|
|
85
85
|
* reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
|
|
86
86
|
* personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
|
|
87
87
|
* be the primary key or a retention marker: the build refuses each of those.
|
|
88
|
+
*
|
|
89
|
+
* ## Closing a retained record (#1841)
|
|
90
|
+
*
|
|
91
|
+
* A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
|
|
92
|
+
* field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
|
|
93
|
+
* subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
|
|
94
|
+
* `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
|
|
95
|
+
* The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
|
|
96
|
+
* period counted from the end of a contract or a matter; without it the build refuses that combination.
|
|
88
97
|
*/
|
|
89
98
|
retainedRowCompletion?: ResourceRetainedRowCompletion;
|
|
90
99
|
}
|
|
@@ -111,6 +120,18 @@ export interface ResourceStatutoryRetention {
|
|
|
111
120
|
* claim nobody can check.
|
|
112
121
|
*/
|
|
113
122
|
rationale: string;
|
|
123
|
+
/**
|
|
124
|
+
* WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
|
|
125
|
+
*
|
|
126
|
+
* The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
|
|
127
|
+
* `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
|
|
128
|
+
* arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
|
|
129
|
+
* after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
|
|
130
|
+
* Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
|
|
131
|
+
* are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
|
|
132
|
+
* with it (#1841).
|
|
133
|
+
*/
|
|
134
|
+
staysInUseBecause?: string;
|
|
114
135
|
}
|
|
115
136
|
```
|
|
116
137
|
|