@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
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 +170 -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 +29 -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 +80 -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 +51 -7
- 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 +10 -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/playbook.json +10 -6
- 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 +27 -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.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 +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- 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.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -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 +363 -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 +130 -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.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-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-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 +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- 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 +79 -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 +197 -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 +61 -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 +1 -1
- 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 +18 -7
- 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 +44 -4
- 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 +375 -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 +1 -1
- 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 +1 -1
- 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/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -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 +125 -77
- 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 +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- 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 +255 -12
- 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 +33 -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 +7 -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 +244 -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 +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -190,26 +190,28 @@ export enum ResourceSystemAccessMode {
|
|
|
190
190
|
/**
|
|
191
191
|
* Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
|
|
192
192
|
*
|
|
193
|
-
* ##
|
|
193
|
+
* ## Who declares it, and why it is still a declaration
|
|
194
194
|
*
|
|
195
|
-
*
|
|
196
|
-
*
|
|
197
|
-
*
|
|
198
|
-
*
|
|
199
|
-
*
|
|
200
|
-
* that is one application's modelling choice"*.
|
|
195
|
+
* Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
|
|
196
|
+
* has, carries this declaration, and the evidence door refuses an application where a second resource
|
|
197
|
+
* declares one. An application does not declare its own. (Before #2296 the lane was an application's to
|
|
198
|
+
* build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
|
|
199
|
+
* first declarer and was harvested into the engine.)
|
|
201
200
|
*
|
|
202
|
-
*
|
|
203
|
-
*
|
|
204
|
-
*
|
|
205
|
-
* to
|
|
201
|
+
* It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
|
|
202
|
+
* and the collector read the lane through it and never through the engine's vocabulary: they count the
|
|
203
|
+
* field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
|
|
204
|
+
* them to), so their reading follows the resource and cannot drift from it. Before this existed, three
|
|
205
|
+
* clauses of that demand had a durable row holding every fact they wanted and no way to find it
|
|
206
|
+
* (#1209): not a missing control, a control nobody could point at.
|
|
206
207
|
*
|
|
207
208
|
* ## It binds FIELDS, never values the framework invents
|
|
208
209
|
*
|
|
209
|
-
* Every member below names something the
|
|
210
|
-
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is
|
|
211
|
-
*
|
|
212
|
-
*
|
|
210
|
+
* Every member below names something the declaring resource already has. The one value the
|
|
211
|
+
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
|
|
212
|
+
* resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
|
|
213
|
+
* reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
|
|
214
|
+
* never grow one.
|
|
213
215
|
*
|
|
214
216
|
* ## What is deliberately NOT declared
|
|
215
217
|
*
|
|
@@ -280,6 +282,21 @@ export type ResourceSubjectErasureLane = {
|
|
|
280
282
|
},
|
|
281
283
|
/** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
|
|
282
284
|
executionOperationIdentifier: string,
|
|
285
|
+
/**
|
|
286
|
+
* How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
|
|
287
|
+
* (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
|
|
288
|
+
* as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
|
|
289
|
+
*
|
|
290
|
+
* A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
|
|
291
|
+
* `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
|
|
292
|
+
* exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
|
|
293
|
+
*/
|
|
294
|
+
erasureMarker?: {
|
|
295
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
296
|
+
fieldName: string,
|
|
297
|
+
/** The value of that field meaning the row is an erasure request. */
|
|
298
|
+
erasureValue: string,
|
|
299
|
+
},
|
|
283
300
|
};
|
|
284
301
|
|
|
285
302
|
export type ResourceSystemAccessPolicy = {
|
|
@@ -485,6 +502,15 @@ export interface ResourceRetentionPolicy {
|
|
|
485
502
|
* reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
|
|
486
503
|
* personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
|
|
487
504
|
* be the primary key or a retention marker: the build refuses each of those.
|
|
505
|
+
*
|
|
506
|
+
* ## Closing a retained record (#1841)
|
|
507
|
+
*
|
|
508
|
+
* A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
|
|
509
|
+
* field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
|
|
510
|
+
* subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
|
|
511
|
+
* `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
|
|
512
|
+
* The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
|
|
513
|
+
* period counted from the end of a contract or a matter; without it the build refuses that combination.
|
|
488
514
|
*/
|
|
489
515
|
retainedRowCompletion?: ResourceRetainedRowCompletion;
|
|
490
516
|
}
|
|
@@ -511,6 +537,18 @@ export interface ResourceStatutoryRetention {
|
|
|
511
537
|
* claim nobody can check.
|
|
512
538
|
*/
|
|
513
539
|
rationale: string;
|
|
540
|
+
/**
|
|
541
|
+
* WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
|
|
542
|
+
*
|
|
543
|
+
* The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
|
|
544
|
+
* `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
|
|
545
|
+
* arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
|
|
546
|
+
* after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
|
|
547
|
+
* Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
|
|
548
|
+
* are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
|
|
549
|
+
* with it (#1841).
|
|
550
|
+
*/
|
|
551
|
+
staysInUseBecause?: string;
|
|
514
552
|
}
|
|
515
553
|
|
|
516
554
|
/**
|
|
@@ -575,30 +613,15 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
575
613
|
* If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
|
|
576
614
|
* should stay the normal case.
|
|
577
615
|
*
|
|
578
|
-
* **
|
|
579
|
-
*
|
|
580
|
-
*
|
|
581
|
-
*
|
|
582
|
-
*
|
|
583
|
-
*
|
|
616
|
+
* **An application uses exactly ONE transactional store** (#3328, decided 2026-11-06), so a
|
|
617
|
+
* `mongodb` or `postgresql` value that DISAGREES with the application default is refused at
|
|
618
|
+
* registration, with no declaration that admits it. Declaring an adapter that AGREES with the
|
|
619
|
+
* default is always fine and needs nothing. The non-default values a resource may declare are
|
|
620
|
+
* the ones that hold no transaction: `http-api` (read through from another system) and
|
|
621
|
+
* `introspection` (computed from the application itself).
|
|
584
622
|
*/
|
|
585
623
|
persistenceAdapter?: PersistenceAdapterType,
|
|
586
624
|
|
|
587
|
-
/**
|
|
588
|
-
* This resource's declared relationship to cross-adapter atomic write boundaries.
|
|
589
|
-
*
|
|
590
|
-
* Required — and only meaningful — when {@link
|
|
591
|
-
* ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
|
|
592
|
-
* `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
|
|
593
|
-
* application at startup; with it, the registry admits the resource and LOGS the admitted
|
|
594
|
-
* set, so a mixed configuration is always named and never ambient.
|
|
595
|
-
*
|
|
596
|
-
* Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
|
|
597
|
-
* assertion about the resource's design that the persistence unit of work will still enforce
|
|
598
|
-
* at every real boundary.
|
|
599
|
-
*/
|
|
600
|
-
persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
|
|
601
|
-
|
|
602
625
|
/**
|
|
603
626
|
* REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
|
|
604
627
|
*
|
|
@@ -674,9 +697,9 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
674
697
|
|
|
675
698
|
/**
|
|
676
699
|
* Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
|
|
677
|
-
* evidence collector reads. Omitted ⇒ this resource is not that lane,
|
|
678
|
-
*
|
|
679
|
-
*
|
|
700
|
+
* evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
|
|
701
|
+
* but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
|
|
702
|
+
* evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
|
|
680
703
|
*/
|
|
681
704
|
subjectErasureLane?: ResourceSubjectErasureLane,
|
|
682
705
|
coreOperations: TCoreOperationEnum[],
|
|
@@ -790,14 +813,22 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
790
813
|
* scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
|
|
791
814
|
* deleted when its class period ends.
|
|
792
815
|
*
|
|
793
|
-
* Optional
|
|
794
|
-
*
|
|
795
|
-
*
|
|
816
|
+
* Optional, with no default class: an unbound row has no clock. That is normal when something else ends the
|
|
817
|
+
* row, and `deriveResourceRowLifetimes` says what does for every resource. A resource that binds a class may not
|
|
818
|
+
* also declare a `.ttl()` field — one row, one retention authority.
|
|
796
819
|
*
|
|
797
820
|
* {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
|
|
798
821
|
*/
|
|
799
822
|
retentionBinding?: ResourceRetentionBinding,
|
|
800
823
|
|
|
824
|
+
/**
|
|
825
|
+
* What ends this resource's rows, for the case its configuration cannot show: a dedicated cleanup, the audit
|
|
826
|
+
* archive, the files cleanup, or operator configuration. Everything else is derived, so declare this only when
|
|
827
|
+
* `deriveResourceRowLifetimes` would otherwise answer `UNDECIDED` and a real mechanism exists. It may not sit beside
|
|
828
|
+
* a {@link retentionBinding}: one row, one retention authority.
|
|
829
|
+
*/
|
|
830
|
+
rowLifetime?: ResourceRowLifetimeDeclaration,
|
|
831
|
+
|
|
801
832
|
/**
|
|
802
833
|
* Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
|
|
803
834
|
* are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
|
|
@@ -814,6 +845,40 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
814
845
|
*/
|
|
815
846
|
subjectExportOthersDataFields?: readonly string[],
|
|
816
847
|
|
|
848
|
+
/**
|
|
849
|
+
* The same withholding, for rows reached through ONE edge (#2958 follow-up): keyed by the foreign-key field of a
|
|
850
|
+
* relationship edge to this resource, the fields a subject export withholds and lists as other people's data when it
|
|
851
|
+
* reaches a row THROUGH THAT EDGE, for both rights, on top of {@link subjectExportOthersDataFields}.
|
|
852
|
+
*
|
|
853
|
+
* For a resource two people reach by two edges with different standing. A data-subject request is the SUBJECT's
|
|
854
|
+
* (`userId`, whole) and names the operator who recorded it (`requestedByUserId`): the operator's own act (that they
|
|
855
|
+
* recorded a request, of which kind, when) is personal data concerning them (Art. 15(1)), the subject's identity and
|
|
856
|
+
* the request's content are another person's (Art. 15(4)). A resource-wide declaration cannot say that, since it
|
|
857
|
+
* would withhold the subject's own request from the subject.
|
|
858
|
+
*
|
|
859
|
+
* Not read by the retained-row scrub (`resolveRetainedRowScrubSurface`), unlike the resource-wide list: these fields
|
|
860
|
+
* are the row's OWN subject's data, removed by that subject's erasure, not a third person's.
|
|
861
|
+
*
|
|
862
|
+
* Each key and each listed name must be a top-level field of the main schema; the factory refuses one that is not.
|
|
863
|
+
*/
|
|
864
|
+
subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
|
|
865
|
+
|
|
866
|
+
/**
|
|
867
|
+
* #2958: columns of this resource that hold a USER's id on no edge of that user's export graph, and that their ACCESS
|
|
868
|
+
* export reads (Art. 15 only): who acted on the row (`ACTED`: proposed, granted, verified, ended, triaged, kept as
|
|
869
|
+
* accountability evidence and never severed) or who owns it (`OWNS`: a user-private file). Keyed by the column; each
|
|
870
|
+
* declares its relation and the fields of a row found through it that are about that person (`shownFields`, an
|
|
871
|
+
* allow-list: every other field is withheld and listed as other people's data). A person-naming column a SEVERER
|
|
872
|
+
* reaches is declared beside the severer instead (`SubjectReferenceSeverer.subjectReferenceColumns`).
|
|
873
|
+
*
|
|
874
|
+
* Not an edge, on purpose: `exportSubject` is per resource, so an `invitedByUserId` edge on `organizationMembers` would
|
|
875
|
+
* put every member the person invited, whole, into their export.
|
|
876
|
+
*
|
|
877
|
+
* Each key and each shown name must be a top-level field of the main schema (a variant's included); the factory refuses
|
|
878
|
+
* one that is not. The resource must declare `systemAccessPolicy.exportSubject`.
|
|
879
|
+
*/
|
|
880
|
+
subjectExportPersonColumns?: SubjectExportPersonColumns,
|
|
881
|
+
|
|
817
882
|
/**
|
|
818
883
|
* Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
|
|
819
884
|
* matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
|
|
@@ -42,7 +42,8 @@ declaration a chat could not run.
|
|
|
42
42
|
|
|
43
43
|
## When to Use
|
|
44
44
|
|
|
45
|
-
- A member should create one record from a chat line (`/acme add Buy milk`)
|
|
45
|
+
- A member should create one record from a chat line (`/acme add Buy milk`), a Teams form, or the Slack form `/acme add`
|
|
46
|
+
opens on its own (the same fields as the Teams form, #2770).
|
|
46
47
|
- A member should find records from a chat (`/acme find milk`, a Teams search) or list their first ones.
|
|
47
48
|
|
|
48
49
|
## When NOT to Use
|
|
@@ -273,12 +273,24 @@ record's own page and breadcrumb use the same name its list row shows.
|
|
|
273
273
|
|
|
274
274
|
### Naming a PERSON a viewer may not read (`forwardedUserName`)
|
|
275
275
|
|
|
276
|
+
A foreign key to `users` already shows the PERSON when the viewer may read them: the
|
|
277
|
+
`users` row carries `personName`, the name their profile gives (the chosen display
|
|
278
|
+
name, else first and last name), and the engine labels a user by it, else by the
|
|
279
|
+
email. Every reference surface (a record's "Created by", a picker, the command
|
|
280
|
+
palette) reads that one label, so declare nothing for it. `personName` is resolved
|
|
281
|
+
only for a person the viewer may be told the name of: one whose profile the viewer may
|
|
282
|
+
read (their own; everyone's for an administrator), or a colleague, an active member of
|
|
283
|
+
an operational organization the signed-in viewer belongs to and whose member directory
|
|
284
|
+
the viewer may search (the organization members' SEARCH roles). Anyone
|
|
285
|
+
else (a person of another organization, every person for a viewer in no organization)
|
|
286
|
+
shows by the email the viewer could already read.
|
|
287
|
+
|
|
276
288
|
A field holding a user id (`approvedByUserId`, `assignedByUserId`, a reference to
|
|
277
289
|
`users`) prints 24 hexadecimal characters wherever the viewer may not read that
|
|
278
290
|
user, which is most of the time. Add a sibling built with
|
|
279
291
|
`forwardedUserName({ localField: '<the id field>' })` (from `@wildo-ai/saas-models`):
|
|
280
|
-
a virtual field holding the person's profile name
|
|
281
|
-
stored. A person with no profile name reads as absent; their account email is shown
|
|
292
|
+
a virtual field holding the person's profile name (by the same rule: display name,
|
|
293
|
+
else first and last name), resolved at read time and never stored. A person with no profile name reads as absent; their account email is shown
|
|
282
294
|
only where the field opts in (`fallBackToEmail: true`), because a login address is a
|
|
283
295
|
disclosure, not a name. Then:
|
|
284
296
|
|
|
@@ -310,6 +322,25 @@ names, hand the field display the value with the ids replaced:
|
|
|
310
322
|
leaves an id no profile names as it is, so the gap stays visible. Keep the paths in
|
|
311
323
|
one exported constant read by both, so the lookup and the display cannot drift.
|
|
312
324
|
|
|
325
|
+
### Naming any other recorded id (`forwardedName`)
|
|
326
|
+
|
|
327
|
+
For an id that is not a person (an organization, a credential, a client), add a
|
|
328
|
+
sibling built with `forwardedName({ localField, sourcesOf })` (from
|
|
329
|
+
`@wildo-ai/saas-models`). `sourcesOf(row)` returns where THIS row's id is named:
|
|
330
|
+
`[{ relatedResource, fields: ['name'] }]`, optionally with `relatedJoinField`
|
|
331
|
+
and a `nameOf(relatedRow, row)` that refuses a row it must not name. The field is
|
|
332
|
+
virtual, never stored, read once per page, and ABSENT where nothing names the id
|
|
333
|
+
(never `''`), so you show the id with
|
|
334
|
+
`.showWhen({ conditions: { field: '<sibling>', operator: ShowWhenOperator.NOT_EXISTS } })`.
|
|
335
|
+
A READ computes it; declare `.isSummaryField()` only if a list card shows it.
|
|
336
|
+
|
|
337
|
+
When one id can point at several resources, record WHICH beside it when the row
|
|
338
|
+
is written and dispatch on that record (`alsoReads: ['<kind field>']`). Never
|
|
339
|
+
look the id up everywhere it might be: two resources can hold equal ids, and a
|
|
340
|
+
name read from the wrong one is a false statement. List several sources only to
|
|
341
|
+
mirror a resolver that itself looks in a fixed order; the first source holding the
|
|
342
|
+
id decides.
|
|
343
|
+
|
|
313
344
|
### A virtual field of your own that reads another resource
|
|
314
345
|
|
|
315
346
|
`isVirtual({ calculate })` computes a field per row. When the field reads another
|
|
@@ -343,6 +374,17 @@ which no frontend row ever carries. In development, a list names in the console
|
|
|
343
374
|
condition reads on a SUMMARY row that the row does not carry. The full contract is on
|
|
344
375
|
`enabledConditionFields` in `references/framework-saas-models-resource-config-api.md`.
|
|
345
376
|
|
|
377
|
+
## A condition says everything its operation refuses
|
|
378
|
+
|
|
379
|
+
`enabledCondition` is not a display hint: the frontend calls it to decide whether to OFFER the action,
|
|
380
|
+
and the backend calls it before the operation runs and refuses with 403
|
|
381
|
+
`service_resource_operation_disabled` when it is false. So an operation whose handler refuses on the
|
|
382
|
+
row's state ("not while it is a draft") or on who is asking ("not your own request", "only the person
|
|
383
|
+
who raised it") must say the same in its condition, or the action is offered and then fails. Compare an
|
|
384
|
+
owner field with `initiatorIds.userId` for the person half, list that field in `enabledConditionFields`,
|
|
385
|
+
and give the operation an `unavailableWhen` in its specification so the disabled action and the refusal
|
|
386
|
+
say why. For a resource with states, read the lifecycle recipe in `resource-status-lifecycle`.
|
|
387
|
+
|
|
346
388
|
## What a request field offers (`requestFieldOffers`)
|
|
347
389
|
|
|
348
390
|
When an operation refuses some values of a request field for THIS row (a capability the
|
|
@@ -353,6 +395,28 @@ the row, the fields it `readsFields`, a row a field `readsReferences`, and the a
|
|
|
353
395
|
configuration. Call the SAME predicate the operation refuses with. Read
|
|
354
396
|
`references/framework-request-field-offers-api.md` before declaring one.
|
|
355
397
|
|
|
398
|
+
## A request field named apart from the row field it sets (`requestFieldRowFields`)
|
|
399
|
+
|
|
400
|
+
A move names its target apart from the parent key: a route under the SOURCE parent carries that key,
|
|
401
|
+
and the request layer refuses a body that disagrees with a route parameter. So a "move to list" verb
|
|
402
|
+
takes `targetListId` and its `basicPrefixOperation` writes `listId`. Say which row field the target
|
|
403
|
+
sets, or the action bar's one-field pick (a DROPDOWN) cannot read what the row holds now: the current
|
|
404
|
+
value carries no mark, and picking it again writes the row for nothing.
|
|
405
|
+
|
|
406
|
+
```ts
|
|
407
|
+
requestDto: z.object({ targetListId: z.string().isForeignKey({ referencedResourceType: 'lists' }) }),
|
|
408
|
+
basicPrefixOperation: ({ inputDto }) => ({ listId: inputDto.targetListId }),
|
|
409
|
+
authoritativeFields: ['listId'],
|
|
410
|
+
requestFieldRowFields: { targetListId: 'listId' },
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
It describes the correspondence and writes nothing: the prefix still sets the field. A request field
|
|
414
|
+
named like its row field (`assignedToUserId`) needs no entry. The factory refuses a key that is not a
|
|
415
|
+
top-level request field, a value that is not a top-level row field or is `.isBackendOnly()`, a
|
|
416
|
+
value that holds another kind of value (a reference to another resource, or an enum missing a value
|
|
417
|
+
the request can carry), and a field mapped to its own name. The full contract is on `requestFieldRowFields` in
|
|
418
|
+
`references/framework-saas-models-resource-config-api.md`.
|
|
419
|
+
|
|
356
420
|
## System-context access (`systemAccessPolicy`)
|
|
357
421
|
|
|
358
422
|
`SystemAccessBackendService` (from `@wildo-ai/saas-backend-lib`) accesses a resource
|
|
@@ -393,8 +457,8 @@ place through `updateManyAsSystem` even when it scrubs nothing. `systemAccessPol
|
|
|
393
457
|
operation in the core-operation TYPE (the error names
|
|
394
458
|
`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations`); the `coreOperations` array and the
|
|
395
459
|
variant types are checked only when the backend STARTS. Ask that half before the backend does with
|
|
396
|
-
`wildo config check-resources`, which builds
|
|
397
|
-
(the build lane runs it as `check:resources-registry-init`). See
|
|
460
|
+
`wildo config check-resources`, which builds the registry offline and runs the startup checks that read it
|
|
461
|
+
alone, the statutory teardown edge among them (the build lane runs it as `check:resources-registry-init`). See
|
|
398
462
|
`references/framework-retention-policy-operations.md` for the rule and a worked example.
|
|
399
463
|
|
|
400
464
|
## References
|
|
@@ -414,7 +478,7 @@ variant types are checked only when the backend STARTS. Ask that half before the
|
|
|
414
478
|
- `references/framework-collection-operation-declarations.md` — what a LIST/SEARCH variant declares (`filterFields`, `sortFields`, `isSearchable`, `maxPaginatedResultPerPageLimit`, `collectionExport`) and what each ABSENCE means — including why omitting `sortFields` is not "no sorting"
|
|
415
479
|
- `references/framework-operation-step-up-api.md` — source-backed `requiresStepUpAuthentication`: gating an irreversible operation behind a fresh proof of identity, why it is per-variant, and the read-shaped operations where it silently enforces nothing
|
|
416
480
|
- `references/framework-operation-approval-api.md` — source-backed `requiresApproval`: making a person's create or change wait until another person approves it (maker-checker): anyone holding a named role, or the one person a registered resolver names, with claim, reassignment and escalation; what the caller is answered, how a request ends, who may ask it, and what startup refuses
|
|
417
|
-
- `references/framework-operation-idempotency-key-api.md` — source-backed `idempotencyKey`: making a provider-backed mutation safe to retry, `ACCEPTED` vs `REQUIRED`,
|
|
481
|
+
- `references/framework-operation-idempotency-key-api.md` — source-backed `idempotencyKey`: making a provider-backed mutation safe to retry, `ACCEPTED` vs `REQUIRED`, how the framework replays a retried request from its first outcome, and the effect outside your database your implementation still owns
|
|
418
482
|
- `references/framework-webhook-events-api.md` — source-backed `m2mNotifications[].events`: which outcomes an operation announces to webhook endpoints (`operation.completed`, `operation.failed` for a failed background run), what each delivery carries, and the refusal on an operation that never runs in the background
|
|
419
483
|
- `references/framework-operation-bulk-api.md` — source-backed `haveBulkOperation` / `bulkOperationMaxSelection` / `bulkServiceRuntimeMode`: acting on many rows, `_ids` vs "all N matching", and when the bulk form should run in the background while the single-row action stays immediate
|
|
420
484
|
- `references/framework-retention-policy-operations.md` — **read before adding any `retentionPolicy`**: the three operations it requires, their variant types, and a worked `RETAIN_ONLY` example
|
|
@@ -436,6 +500,7 @@ variant types are checked only when the backend STARTS. Ask that half before the
|
|
|
436
500
|
- [ ] A junction/row whose identity is a related party is labeled via `forwardedLabel(...)` (a virtual field referenced by `getFrontendResourceLabel`), not a denormalized mutable copy; its `localField` exists on this schema
|
|
437
501
|
- [ ] Every token-bearing notification has a matching token-generation condition and an explicit product recovery path when a lost email matters
|
|
438
502
|
- [ ] Every field an `enabledCondition` reads is a summary field or listed in that variant's `enabledConditionFields` (catch with the condition-fields grep below)
|
|
503
|
+
- [ ] Every refusal an operation's handler makes on the row's state or on who is asking is also in that operation's `enabledCondition` (read the operation file beside the condition), and the specification states `unavailableWhen`
|
|
439
504
|
|
|
440
505
|
### Grep invariants
|
|
441
506
|
|
|
@@ -506,6 +571,7 @@ branch, and the template must consume the generated token context.
|
|
|
506
571
|
- Relational `searchableFields` entry whose `localField` is not a field on this resource's schema (catch with the **relational search** `rg -n "localField:"` invariant above).
|
|
507
572
|
- A junction/row labeled by a denormalized copy of a related resource's MUTABLE name instead of `forwardedLabel` (manual review — staleness trap), or a `forwardedLabel` whose `localField` is not a field on this schema (catch with the `forwardedLabel` `localField` grep below).
|
|
508
573
|
- Token generation and its notification use different conditions, leaving a live token without an email or an email without a usable token.
|
|
574
|
+
- An operation whose handler refuses on the row's status or on the caller while it declares no `enabledCondition`, or one that says less: the action is offered and then refused (measured in a purchasing tool: "Department-head decision" offered on a draft, refused with 409). Catch by reading each `*.operation.ts` that refuses beside its variant in `*.resources-config.ts`.
|
|
509
575
|
- An `enabledCondition` reading `currentObject.<field>` where the field is neither `.isSummaryField()` nor in the variant's `enabledConditionFields` (catch with the **row-action conditions** greps above), or a development console warning naming one.
|
|
510
576
|
- A `retentionPolicy` (even `RETAIN_ONLY`) on a resource whose `coreOperations` lack `UPDATE_MANY`, or whose `UPDATE_MANY` is `REPOSITORY_ONLY` (catch with the **retentionPolicy declares UPDATE_MANY** `comm` invariant above). When the core-operation type still lists it, it typechecks, and the backend then refuses to start.
|
|
511
577
|
|
|
@@ -7,7 +7,7 @@ Read this when authoring a collection operation, or when a list "works" but retu
|
|
|
7
7
|
|
|
8
8
|
| declaration | what it does | absent ⇒ |
|
|
9
9
|
|---|---|---|
|
|
10
|
-
| `filterFields` | field name → schema; the fields a caller may filter on. A date-typed field automatically becomes a RANGE filter | no filtering offered |
|
|
10
|
+
| `filterFields` | field name → schema; the fields a caller may filter on. A date-typed field automatically becomes a RANGE filter; a number becomes a threshold range when you declare `Resources_Filter_NumberRangeSchema` (`{ min, max }`), and a `z_yearMonth()` field a range of months when you declare `Resources_Filter_YearMonthRangeSchema` (`{ startMonth, endMonth }`, both included; one month `YYYY-MM` is still accepted) | no filtering offered |
|
|
11
11
|
| `sortFields` | the sortable allow-list | **no allow-list you chose** — see below |
|
|
12
12
|
| `isSearchable` + `searchableFields` + `searchableOptions` | free-text search over declared fields, own or relational | **refused at registration** unless `isSearchable: false` — see below |
|
|
13
13
|
| `maxPaginatedResultPerPageLimit` | the per-page ceiling a caller cannot exceed | 100 on a LIST, 50 on a SEARCH — see below |
|
|
@@ -38,7 +38,7 @@ serves that ordering in both directions. On PostgreSQL the single-column index s
|
|
|
38
38
|
|
|
39
39
|
## What a filter is, and is not
|
|
40
40
|
|
|
41
|
-
A filter is an equality, a list of values, or a declared
|
|
41
|
+
A filter is an equality, a list of values, or a declared range (of dates, numbers or months). There is no operator syntax on
|
|
42
42
|
the wire — anything richer is a custom operation with its own request shape.
|
|
43
43
|
|
|
44
44
|
**Filtering never widens visibility.** Whatever a caller asks for is intersected with the tenancy and
|
package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md
CHANGED
|
@@ -146,6 +146,23 @@ resource that is not held is reported at startup: check that its roles are not t
|
|
|
146
146
|
**It is per variant**, like `requiresStepUpAuthentication`. A variant for administrators can stay immediate while the
|
|
147
147
|
members' variant is held.
|
|
148
148
|
|
|
149
|
+
**The approver can be asked to re-authenticate for THIS approval.** `requiresApproval.requiresStepUpAuthentication: true`
|
|
150
|
+
makes the answer carry a step-up proof minted for that request and the version of it the approver was shown
|
|
151
|
+
(`POST /auth/reauth` with `decisionBinding`, sent as `X-Reauth-Token`). `requiresApproval.stepUp` says what that proof
|
|
152
|
+
must also be: `maximumAgeSeconds` (proven at most that long before the answer, up to 300) and `minimumAssurance`
|
|
153
|
+
(`reproven` accepts a password, `possession` needs an enrolled TOTP or a passkey, `phishing_resistant` a passkey only).
|
|
154
|
+
A proof that is too old or too weak is refused like a missing one (`decision_step_up_required`). A chat answer cannot
|
|
155
|
+
carry one: it is refused, and the handler is given the request's address in the application's inbox
|
|
156
|
+
(`openInApplicationUrl`) to post instead. Check that the approvers' user types allow the factor as a step-up method (`stepUpAuth.methods`), or nobody
|
|
157
|
+
can answer. The seal records which factor answered and when it was proven (`decider.stepUpMethod`, `decider.stepUpAt`).
|
|
158
|
+
Startup refuses `stepUp` without `requiresStepUpAuthentication: true`.
|
|
159
|
+
|
|
160
|
+
**The channels that may answer can be named.** `requiresApproval.answerChannels` lists them (`web_session`, `chat`,
|
|
161
|
+
`api_client`); an answer through any other is refused (`answer_channel_not_admitted`) and recorded, and a chat answer
|
|
162
|
+
gets `openInApplicationUrl` as above. Absent, every channel the other requirements allow may answer. Startup refuses
|
|
163
|
+
`chat` beside `requiresStepUpAuthentication: true`, since a chat answer cannot carry the proof. The list is stored on
|
|
164
|
+
the request when it is opened, so changing it later does not change how an open request is answered.
|
|
165
|
+
|
|
149
166
|
## What the trail records
|
|
150
167
|
|
|
151
168
|
Two audit rows per request, joined by `decisionRef`: `HUMAN_DECISION_REQUESTED` names the requester and the operation,
|
|
@@ -211,6 +228,37 @@ export const ResourceOperationApprovalRequirementSchema = z.object({
|
|
|
211
228
|
assignee: z.string().min(1).optional(),
|
|
212
229
|
escalateTo: z.string().min(1).optional(),
|
|
213
230
|
deadlines: ReviewDeadlinesDeclarationSchema.optional(),
|
|
231
|
+
/**
|
|
232
|
+
* The approver must step up FOR THIS DECISION when they answer it (#2923): re-authenticate (password, an enrolled
|
|
233
|
+
* second factor or a passkey with user verification) with a proof bound to the request and to the presentation they
|
|
234
|
+
* were shown, minted by `POST /auth/reauth` naming both, single-use and short-lived, and carried in `X-Reauth-Token` on
|
|
235
|
+
* the answer. A proof for another decision, a changed presentation, a used or an expired one is refused, and a chat
|
|
236
|
+
* card cannot carry one, so a chat answer is refused too. The name is the operation flag's, reused: it asks the same
|
|
237
|
+
* of the approver that the flag asks of a person running the operation.
|
|
238
|
+
*/
|
|
239
|
+
requiresStepUpAuthentication: z.boolean().optional(),
|
|
240
|
+
/**
|
|
241
|
+
* What the step-up must ALSO be, when `requiresStepUpAuthentication` is `true` (#2923); startup refuses it otherwise.
|
|
242
|
+
*
|
|
243
|
+
* - `maximumAgeSeconds` — the factor was proven at most this many seconds before the answer (at most 300, the
|
|
244
|
+
* proof's own lifetime): "re-authenticate just before you approve", not "at some point in the last five minutes".
|
|
245
|
+
* - `minimumAssurance` — the weakest factor that may answer, weakest first: `reproven` (any step-up factor, a
|
|
246
|
+
* password included), `possession` (an enrolled TOTP or a passkey: a physical authenticator, never a password
|
|
247
|
+
* alone), `phishing_resistant` (a passkey only), as NIST SP 800-63B-4 classifies the authenticators. The approvers'
|
|
248
|
+
* user types must allow that factor as a step-up method (`stepUpAuth.methods`), or nobody can answer.
|
|
249
|
+
*
|
|
250
|
+
* A proof that is too old or too weak is refused like any unusable proof (`decision_step_up_required`); the person
|
|
251
|
+
* steps up again with one that meets it. The factor and the instant it was proven are recorded on the decision and on
|
|
252
|
+
* its approval seal (`decider.stepUpMethod`, `decider.stepUpAt`), so a verifier sees which factor answered and when.
|
|
253
|
+
*/
|
|
254
|
+
stepUp: HumanDecision_StepUpRequirementSchema.optional(),
|
|
255
|
+
/**
|
|
256
|
+
* The channels that may answer the approval (#2923): `web_session` (the application), `chat` (a chat card),
|
|
257
|
+
* `api_client` (a client the approver delegated to; never admitted for an approval, which is decided in person).
|
|
258
|
+
* Absent: every channel the other requirements allow. `chat` is refused beside a step-up, which a chat answer cannot
|
|
259
|
+
* carry; a chat card for an approval it may not answer links to the approval in the application.
|
|
260
|
+
*/
|
|
261
|
+
answerChannels: HumanDecision_AnswerChannelsSchema.optional(),
|
|
214
262
|
});
|
|
215
263
|
export type ResourceOperationApprovalRequirement = z.infer<typeof ResourceOperationApprovalRequirementSchema>;
|
|
216
264
|
```
|
package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md
CHANGED
|
@@ -30,17 +30,41 @@ reason. Bound the request text and ask for an operational explanation; do not se
|
|
|
30
30
|
data. No other request values are copied by this declaration. It does not raise the risk floor: a `MEDIUM` or
|
|
31
31
|
`LOW` write still needs `auditBelowRiskFloor` if it must be recorded.
|
|
32
32
|
|
|
33
|
-
`OVERRIDE_ALL` implementations own persistence and bypass the framework-managed post-commit lane
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
`
|
|
33
|
+
`OVERRIDE_ALL` implementations own persistence and bypass the framework-managed post-commit lane, but not this
|
|
34
|
+
row: the framework records it when the `overrideAll` handler returns, by the same risk floor, with the pre-image it
|
|
35
|
+
read, the request input, the handler's response as the post-state and the `reasonField` text. Inside a caller's
|
|
36
|
+
transaction it is written only once that transaction commits; a handler that throws records nothing. A handler that
|
|
37
|
+
records its own `RESOURCE_OPERATION_PERFORMED` row (the engine's feature commands do, to carry the overrides before
|
|
38
|
+
and after) declares `ownsOperationAuditRecord: true` on its custom implementation so the operation has one row. Any
|
|
39
|
+
other fact the operation should leave is a business event of your own: see `backend-custom-operation`,
|
|
40
|
+
`references/framework-audit-log-event-api.md`.
|
|
38
41
|
|
|
39
42
|
The same lane sends the operation's declared `userNotifications` and `m2mNotifications`, so an `OVERRIDE_ALL`
|
|
40
43
|
implementation would leave them unsent. The application refuses to start when an `OVERRIDE_ALL` implementation
|
|
41
44
|
is registered for an operation that declares notifications: use a prefix/postfix implementation (with
|
|
42
45
|
`transactionalCore` when its writes must commit together) so the framework writes, records and notifies.
|
|
43
46
|
|
|
47
|
+
## When the row is written, and what survives a crash
|
|
48
|
+
|
|
49
|
+
The row is written only after the operation's write has committed, so it never asserts a change that was rolled back.
|
|
50
|
+
What happens between the commit and the row depends on the operation's class, and you should describe your own
|
|
51
|
+
operations to a reviewer in these terms rather than as "always audited":
|
|
52
|
+
|
|
53
|
+
| Operation | Guarantee |
|
|
54
|
+
|---|---|
|
|
55
|
+
| A **transactional** operation of your application, called at the top level: one with a `transactionalCore` implementation, a bulk write (`updateMany`, `deleteMany`, …), a token-issuing, token-consuming or token-revoking operation, a create that numbers a document, or a write to an outbound pipeline's destination | **Durable.** The prepared row is kept in the framework's post-commit effect outbox inside the operation's own transaction (with the notifications that go with it) and written right after the commit from there. If the process ends between the commit and the write, the framework's outbox relay writes it later (once at the next startup, then every five minutes), under the id it was prepared with, once. A write that rolls back keeps nothing. Every audited write nested inside that transaction is covered too. One exception: when an effect of that transaction cannot be kept (retiring a SIEM destination, a generated secret), the whole operation is best effort, as the last row describes. |
|
|
56
|
+
| A verb a framework sweep dispatches (the expiry of organization relationships, professional qualifications and access grants, the lifting of a suspension, an invitation's revocation, a tenant's purge) | **Durable**, the same way, settled by that sweep's next run rather than by the relay, also when someone calls the verb directly. For the purge and the invitation sweep that run is daily, so after a crash such a row can take up to a day to appear. |
|
|
57
|
+
| A **plain audited create, update or delete with no custom implementation, or whose every custom implementation declares `hookTransactionPosture: RUNS_INSIDE_TRANSACTION`**, reached through the framework (`API_CALL`, `INTERNAL_CALL`), audited by its declaration (its `riskLevel` is HIGH or CRITICAL, or it sets `auditableEvent.auditBelowRiskFloor`): a single-row `create`, `update` or `delete`, or a custom operation that behaves as one, including one gated by an `enabledCondition` | **Durable**, the same way as a transactional operation: the framework opens a transaction around the write for the sake of its audit row, so the row is kept in the outbox and the relay writes it after a crash. Nothing else changes, because nothing but the framework's own core runs inside that transaction: a delete's cascade already ran in a transaction of its own, removes its children through their repositories, and leaves a file's stored object to the files cleanup batch. A declared implementation's hooks run inside it too, which is why they must do nothing outside the database before the commit (`backend-custom-operation`, `references/framework-hook-transaction-posture-api.md`). A lost race on an `enabledCondition` still answers `409 version_conflict`: the row is re-read in the transaction, and a row that moved since the request was admitted is refused. |
|
|
58
|
+
| An engine writer that owns its outbox (`IMPLEMENTATION_OUTBOX`, billing's subscription mutations) | **Durable**, through that writer's own outbox and relay. Reserved for engine writers: an application cannot declare it. |
|
|
59
|
+
| Any other audited write called at the top level: a plain create, update or delete with a custom implementation that does not declare `RUNS_INSIDE_TRANSACTION` (undeclared, or `STAYS_OUTSIDE_TRANSACTION` because a hook's answer depends on a provider call or an audit row that must exist first), a multi-row write that is not a bounded bulk operation, a scheduled (`CRON_JOB`, `BATCH_JOB`) variant, a write audited only because of who performed it (a decided agent proposal, a representative), a write inside a transaction your code opened itself rather than an operation's, and an `OVERRIDE_ALL` implementation | **Best effort.** The row is written right after the commit. A store that refuses the write is logged and counted (`audit_store_failure_total`). A process that ends between the commit and the write loses the row, and nothing counts that loss. When its row must survive a crash, keep the hooks inside the database and declare `RUNS_INSIDE_TRANSACTION`, or give the operation a `transactionalCore` implementation (its hooks then run inside the transaction either way, so keep provider calls out of them). |
|
|
60
|
+
|
|
61
|
+
The durable rows need the outbox in the same database as the operation, which is always the case in an application (it
|
|
62
|
+
uses one transactional store). A process where it is not says so at startup, per resource.
|
|
63
|
+
|
|
64
|
+
So the trail can still miss a committed change of a best-effort operation after a crash. Keep that in mind when a control
|
|
65
|
+
rests on the row being present: reconcile against the resource itself (its `updatedAt`, its status history) rather than
|
|
66
|
+
treating an absent row as proof that nothing happened.
|
|
67
|
+
|
|
44
68
|
## Three things the trail will not tell you
|
|
45
69
|
|
|
46
70
|
- **A high-risk READ leaves no operation-level row.** The event asserts an effect, and a read had
|
|
@@ -116,7 +140,7 @@ export type ResourceOperation_AuditableEvent = {
|
|
|
116
140
|
* or an unrestricted business-data field. Bound the text in the request DTO and tell callers
|
|
117
141
|
* to supply an operational justification. Other request values are never copied by this option.
|
|
118
142
|
* This does not change the risk floor: below-floor writes still need `auditBelowRiskFloor`.
|
|
119
|
-
* OVERRIDE_ALL
|
|
143
|
+
* An OVERRIDE_ALL implementation's operation is recorded the same way, once its handler returns (#3151).
|
|
120
144
|
*/
|
|
121
145
|
reasonField?: string;
|
|
122
146
|
};
|
|
@@ -134,7 +158,9 @@ export type ResourceOperation_AuditableEvent = {
|
|
|
134
158
|
* - **A bulk write records submitted field NAMES without prior values.** The before-image is fetched
|
|
135
159
|
* only when exactly one row is selected, so a bulk update cannot tell a reviewer what a field
|
|
136
160
|
* used to hold.
|
|
137
|
-
* - **There is no suppression, and the second row is not a duplicate.**
|
|
161
|
+
* - **There is no suppression, and the second row is not a duplicate.** (The one narrow exception: an
|
|
162
|
+
* `overrideAll` handler that writes the operation-performed row ITSELF declares `ownsOperationAuditRecord`,
|
|
163
|
+
* so the framework does not write a second copy of the same row, #3151.) An operation with its own
|
|
138
164
|
* purpose-built event emits BOTH. The generic row carries the operation identity, the cascade
|
|
139
165
|
* correlation, the actor's roles as they stood and the execution type — and no purpose-built
|
|
140
166
|
* event carries any of those, so the two state different facts about one action.
|
package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md
CHANGED
|
@@ -12,14 +12,18 @@ rows of a collection at once.
|
|
|
12
12
|
many rows. The collection bar offers it once rows are selected. Its request names the rows one of two ways:
|
|
13
13
|
|
|
14
14
|
- `_ids` — the rows ticked on the page.
|
|
15
|
-
- `_match` — "all N matching": the listing's filters and search, and the listing itself (`listing: { operation
|
|
16
|
-
|
|
17
|
-
scope and authorization and acts on what it returns, so
|
|
18
|
-
list, nor a row of another listing (an administrators'
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
15
|
+
- `_match` — "all N matching": the listing's filters and search, and the listing itself (`listing: { operation,
|
|
16
|
+
variantKey? }`, where `operation` is `list`, `search`, or a custom operation that acts as one). The server re-runs
|
|
17
|
+
exactly that operation and variant under the caller's own scope and authorization and acts on what it returns, so
|
|
18
|
+
a selection can never reach a row the caller could not list, nor a row of another listing (an administrators'
|
|
19
|
+
`directory` is not the member's default list, and an approver's queue is not the full list). A variant the
|
|
20
|
+
resource does not declare is refused, and so is a list-like listing carrying a search term (a list has no
|
|
21
|
+
search). Without `listing`, the default list is re-run, or the default search when a search is given.
|
|
22
|
+
- A custom operation can be that listing only if it PAGES: `resourceOperationLike: LIST` or `SEARCH`, a
|
|
23
|
+
`{ data, pagination }` response (the default for such an operation; do not replace it with a custom response),
|
|
24
|
+
and an implementation that honours the `page` and `limit` it receives and answers `pagination.total`. A view run by
|
|
25
|
+
one that does not offers no "all N matching", and a request naming it is refused. An `overrideAll` implementation
|
|
26
|
+
that ignores the page is refused when the server notices a later page repeating rows.
|
|
23
27
|
|
|
24
28
|
Each row still passes the variant's own `enabledCondition` and roles, and is audited as its own row.
|
|
25
29
|
|
|
@@ -61,11 +65,11 @@ that row re-reads before saving. Each
|
|
|
61
65
|
runs as one transaction on the store of the resource it writes, so every row changes or none does: a failure part-way
|
|
62
66
|
through (a unique value written twice, a refused row) leaves nothing changed. On MongoDB that needs a replica set,
|
|
63
67
|
which every Wildo deployment runs. A resource kept in an external system of record holds no transaction, and there the
|
|
64
|
-
action applies its selection one target at a time, and its rows are judged once and not held.
|
|
65
|
-
|
|
68
|
+
action applies its selection one target at a time, and its rows are judged once and not held. That is the only other
|
|
69
|
+
store a selection can sit on: an application uses exactly one transactional store.
|
|
66
70
|
|
|
67
71
|
Because the action is one transaction, the operations it runs (the child's create, the junction's create and delete,
|
|
68
|
-
and the reads of rows on the same store) run INSIDE it; a read of a resource kept
|
|
72
|
+
and the reads of rows on the same store) run INSIDE it; a read of a resource kept in an external system of record runs outside it. A
|
|
69
73
|
custom implementation on one of those operations whose phase must run outside a transaction (`afterUserNotifications`,
|
|
70
74
|
`atTheEnd`, `beforeTransactionalCore`) is refused there, and a conflict resolver on one of them does not retry a
|
|
71
75
|
conflict: either way the whole action is rolled back. Put that work on the operations' ordinary single-row use, or
|