@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md
CHANGED
|
@@ -221,7 +221,7 @@ export const ModelCostAccountingConfigSchema = z.object({
|
|
|
221
221
|
try {
|
|
222
222
|
assertUniqueProviderUsagePricingAuthorities(config.providerUsagePricingAuthorities);
|
|
223
223
|
} catch (error) {
|
|
224
|
-
context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message:
|
|
224
|
+
context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: describeCaughtError(error) });
|
|
225
225
|
}
|
|
226
226
|
});
|
|
227
227
|
export type ModelCostAccountingConfig = z.infer<typeof ModelCostAccountingConfigSchema>;
|
|
@@ -133,26 +133,28 @@ export enum ResourceSystemAccessMode {
|
|
|
133
133
|
/**
|
|
134
134
|
* Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
|
|
135
135
|
*
|
|
136
|
-
* ##
|
|
136
|
+
* ## Who declares it, and why it is still a declaration
|
|
137
137
|
*
|
|
138
|
-
*
|
|
139
|
-
*
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
*
|
|
143
|
-
* that is one application's modelling choice"*.
|
|
138
|
+
* Since #2296 the lane is the ENGINE's: the core resource `dataSubjectRequests`, which every application
|
|
139
|
+
* has, carries this declaration, and the evidence door refuses an application where a second resource
|
|
140
|
+
* declares one. An application does not declare its own. (Before #2296 the lane was an application's to
|
|
141
|
+
* build, which is why this declaration exists at all: Your Application' `accountErasureRequests` was the
|
|
142
|
+
* first declarer and was harvested into the engine.)
|
|
144
143
|
*
|
|
145
|
-
*
|
|
146
|
-
*
|
|
147
|
-
*
|
|
148
|
-
* to
|
|
144
|
+
* It stays a DECLARATION rather than the door reading the engine's fields by name, because the door
|
|
145
|
+
* and the collector read the lane through it and never through the engine's vocabulary: they count the
|
|
146
|
+
* field and value the declaration names (`evidence-requirement:subject-erasure-execution-record` asks
|
|
147
|
+
* them to), so their reading follows the resource and cannot drift from it. Before this existed, three
|
|
148
|
+
* clauses of that demand had a durable row holding every fact they wanted and no way to find it
|
|
149
|
+
* (#1209): not a missing control, a control nobody could point at.
|
|
149
150
|
*
|
|
150
151
|
* ## It binds FIELDS, never values the framework invents
|
|
151
152
|
*
|
|
152
|
-
* Every member below names something the
|
|
153
|
-
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is
|
|
154
|
-
*
|
|
155
|
-
*
|
|
153
|
+
* Every member below names something the declaring resource already has. The one value the
|
|
154
|
+
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is that
|
|
155
|
+
* resource's OWN enum member (`DataSubjectRequestChannel.SELF` on the engine's lane), quoted back so a
|
|
156
|
+
* reader can tell the two populations apart. The declaration supplies no vocabulary of its own and must
|
|
157
|
+
* never grow one.
|
|
156
158
|
*
|
|
157
159
|
* ## What is deliberately NOT declared
|
|
158
160
|
*
|
|
@@ -223,6 +225,21 @@ export type ResourceSubjectErasureLane = {
|
|
|
223
225
|
},
|
|
224
226
|
/** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
|
|
225
227
|
executionOperationIdentifier: string,
|
|
228
|
+
/**
|
|
229
|
+
* How a row says it is an ERASURE request at all, when the declaring resource also records requests for other rights
|
|
230
|
+
* (#2296: the engine's `dataSubjectRequests` carries access and portability requests beside erasure). The same shape
|
|
231
|
+
* as {@link withdrawnMarker}, and for the same reason: the vocabulary is the resource's.
|
|
232
|
+
*
|
|
233
|
+
* A collector counts only the rows carrying it. Without it, an export request — answered at intake, with a
|
|
234
|
+
* `completedAt` and no erasure — would be counted as an erasure executed, which is the false evidence this lane
|
|
235
|
+
* exists to prevent. Omitting it is a positive claim that every row of the resource is an erasure request.
|
|
236
|
+
*/
|
|
237
|
+
erasureMarker?: {
|
|
238
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
239
|
+
fieldName: string,
|
|
240
|
+
/** The value of that field meaning the row is an erasure request. */
|
|
241
|
+
erasureValue: string,
|
|
242
|
+
},
|
|
226
243
|
};
|
|
227
244
|
|
|
228
245
|
export type ResourceSystemAccessPolicy = {
|
|
@@ -428,6 +445,15 @@ export interface ResourceRetentionPolicy {
|
|
|
428
445
|
* reach RETAINED rows only, and the write refuses any field this list does not name. A field named here may not be
|
|
429
446
|
* personal data (no `.dataCategories()`, no `.impersonalizeWith()`), may not be `.excludeFromUpdate()`, and may not
|
|
430
447
|
* be the primary key or a retention marker: the build refuses each of those.
|
|
448
|
+
*
|
|
449
|
+
* ## Closing a retained record (#1841)
|
|
450
|
+
*
|
|
451
|
+
* A resource bound `RetentionStartPoint.CLOSURE_EVENT` may name its closure field here, the one `.excludeFromUpdate()`
|
|
452
|
+
* field allowed (on a closure clock that decorator means server-owned, not immutable). A record still OPEN when its
|
|
453
|
+
* subject is erased can then be closed: its own close operation, finding the row RETAINED, calls
|
|
454
|
+
* `SystemAccessBackendService.closeRetainedRecordAsSystem`, which writes the closure date only where it is still null.
|
|
455
|
+
* The retention-class sweep then deletes the row at closure + period. This is what lets a statutory record declare a
|
|
456
|
+
* period counted from the end of a contract or a matter; without it the build refuses that combination.
|
|
431
457
|
*/
|
|
432
458
|
retainedRowCompletion?: ResourceRetainedRowCompletion;
|
|
433
459
|
}
|
|
@@ -454,6 +480,18 @@ export interface ResourceStatutoryRetention {
|
|
|
454
480
|
* claim nobody can check.
|
|
455
481
|
*/
|
|
456
482
|
rationale: string;
|
|
483
|
+
/**
|
|
484
|
+
* WHY these rows stay in use after their owner goes, for a resource whose teardown edges do not restrict them.
|
|
485
|
+
*
|
|
486
|
+
* The default, and the right answer for almost every statutory record, is restriction: every owning edge authors
|
|
487
|
+
* `IMPERSONALIZE_AND_RETAIN`, and startup refuses anything else. A few records cannot be frozen, because work still
|
|
488
|
+
* arrives for them after the owner has gone: a billing provider's webhooks and reconciliation reach an invoice long
|
|
489
|
+
* after its customer left. Declaring this keeps the edges as they are and states why, in words a reader can dispute.
|
|
490
|
+
* Required non-empty when present. It changes nothing about the period, which still ends the rows. Because such rows
|
|
491
|
+
* are never restricted, their handlers close them through ordinary writes, so a `CLOSURE_EVENT` binding is accepted
|
|
492
|
+
* with it (#1841).
|
|
493
|
+
*/
|
|
494
|
+
staysInUseBecause?: string;
|
|
457
495
|
}
|
|
458
496
|
|
|
459
497
|
/**
|
|
@@ -518,30 +556,15 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
518
556
|
* If not specified, uses `appConfig.database.defaultAdapter` — which is the normal case and
|
|
519
557
|
* should stay the normal case.
|
|
520
558
|
*
|
|
521
|
-
* **
|
|
522
|
-
*
|
|
523
|
-
*
|
|
524
|
-
*
|
|
525
|
-
*
|
|
526
|
-
*
|
|
559
|
+
* **An application uses exactly ONE transactional store** (#3328, decided 2026-11-06), so a
|
|
560
|
+
* `mongodb` or `postgresql` value that DISAGREES with the application default is refused at
|
|
561
|
+
* registration, with no declaration that admits it. Declaring an adapter that AGREES with the
|
|
562
|
+
* default is always fine and needs nothing. The non-default values a resource may declare are
|
|
563
|
+
* the ones that hold no transaction: `http-api` (read through from another system) and
|
|
564
|
+
* `introspection` (computed from the application itself).
|
|
527
565
|
*/
|
|
528
566
|
persistenceAdapter?: PersistenceAdapterType,
|
|
529
567
|
|
|
530
|
-
/**
|
|
531
|
-
* This resource's declared relationship to cross-adapter atomic write boundaries.
|
|
532
|
-
*
|
|
533
|
-
* Required — and only meaningful — when {@link
|
|
534
|
-
* ResourceConfiguration_BuilderParameters.persistenceAdapter} disagrees with
|
|
535
|
-
* `appConfig.database.defaultAdapter`. Without it, the resources registry refuses the
|
|
536
|
-
* application at startup; with it, the registry admits the resource and LOGS the admitted
|
|
537
|
-
* set, so a mixed configuration is always named and never ambient.
|
|
538
|
-
*
|
|
539
|
-
* Read {@link ResourcePersistenceAdapterIsolation} before declaring one: the member is an
|
|
540
|
-
* assertion about the resource's design that the persistence unit of work will still enforce
|
|
541
|
-
* at every real boundary.
|
|
542
|
-
*/
|
|
543
|
-
persistenceAdapterIsolation?: ResourcePersistenceAdapterIsolationType,
|
|
544
|
-
|
|
545
568
|
/**
|
|
546
569
|
* REQUIRED companion declaration when `persistenceAdapter` is `HTTP_API`; forbidden otherwise.
|
|
547
570
|
*
|
|
@@ -617,9 +640,9 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
617
640
|
|
|
618
641
|
/**
|
|
619
642
|
* Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
|
|
620
|
-
* evidence collector reads. Omitted ⇒ this resource is not that lane,
|
|
621
|
-
*
|
|
622
|
-
*
|
|
643
|
+
* evidence collector reads. Omitted ⇒ this resource is not that lane, the default for every resource
|
|
644
|
+
* but one: since #2296 the engine's `dataSubjectRequests` declares it in every application, and the
|
|
645
|
+
* evidence door refuses an application where a second resource does. See {@link ResourceSubjectErasureLane}.
|
|
623
646
|
*/
|
|
624
647
|
subjectErasureLane?: ResourceSubjectErasureLane,
|
|
625
648
|
coreOperations: TCoreOperationEnum[],
|
|
@@ -733,14 +756,22 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
733
756
|
* scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
|
|
734
757
|
* deleted when its class period ends.
|
|
735
758
|
*
|
|
736
|
-
* Optional
|
|
737
|
-
*
|
|
738
|
-
*
|
|
759
|
+
* Optional, with no default class: an unbound row has no clock. That is normal when something else ends the
|
|
760
|
+
* row, and `deriveResourceRowLifetimes` says what does for every resource. A resource that binds a class may not
|
|
761
|
+
* also declare a `.ttl()` field — one row, one retention authority.
|
|
739
762
|
*
|
|
740
763
|
* {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
|
|
741
764
|
*/
|
|
742
765
|
retentionBinding?: ResourceRetentionBinding,
|
|
743
766
|
|
|
767
|
+
/**
|
|
768
|
+
* What ends this resource's rows, for the case its configuration cannot show: a dedicated cleanup, the audit
|
|
769
|
+
* archive, the files cleanup, or operator configuration. Everything else is derived, so declare this only when
|
|
770
|
+
* `deriveResourceRowLifetimes` would otherwise answer `UNDECIDED` and a real mechanism exists. It may not sit beside
|
|
771
|
+
* a {@link retentionBinding}: one row, one retention authority.
|
|
772
|
+
*/
|
|
773
|
+
rowLifetime?: ResourceRowLifetimeDeclaration,
|
|
774
|
+
|
|
744
775
|
/**
|
|
745
776
|
* Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
|
|
746
777
|
* are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
|
|
@@ -757,6 +788,40 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
757
788
|
*/
|
|
758
789
|
subjectExportOthersDataFields?: readonly string[],
|
|
759
790
|
|
|
791
|
+
/**
|
|
792
|
+
* The same withholding, for rows reached through ONE edge (#2958 follow-up): keyed by the foreign-key field of a
|
|
793
|
+
* relationship edge to this resource, the fields a subject export withholds and lists as other people's data when it
|
|
794
|
+
* reaches a row THROUGH THAT EDGE, for both rights, on top of {@link subjectExportOthersDataFields}.
|
|
795
|
+
*
|
|
796
|
+
* For a resource two people reach by two edges with different standing. A data-subject request is the SUBJECT's
|
|
797
|
+
* (`userId`, whole) and names the operator who recorded it (`requestedByUserId`): the operator's own act (that they
|
|
798
|
+
* recorded a request, of which kind, when) is personal data concerning them (Art. 15(1)), the subject's identity and
|
|
799
|
+
* the request's content are another person's (Art. 15(4)). A resource-wide declaration cannot say that, since it
|
|
800
|
+
* would withhold the subject's own request from the subject.
|
|
801
|
+
*
|
|
802
|
+
* Not read by the retained-row scrub (`resolveRetainedRowScrubSurface`), unlike the resource-wide list: these fields
|
|
803
|
+
* are the row's OWN subject's data, removed by that subject's erasure, not a third person's.
|
|
804
|
+
*
|
|
805
|
+
* Each key and each listed name must be a top-level field of the main schema; the factory refuses one that is not.
|
|
806
|
+
*/
|
|
807
|
+
subjectExportOthersDataFieldsByForeignKey?: Readonly<Record<string, readonly string[]>>,
|
|
808
|
+
|
|
809
|
+
/**
|
|
810
|
+
* #2958: columns of this resource that hold a USER's id on no edge of that user's export graph, and that their ACCESS
|
|
811
|
+
* export reads (Art. 15 only): who acted on the row (`ACTED`: proposed, granted, verified, ended, triaged, kept as
|
|
812
|
+
* accountability evidence and never severed) or who owns it (`OWNS`: a user-private file). Keyed by the column; each
|
|
813
|
+
* declares its relation and the fields of a row found through it that are about that person (`shownFields`, an
|
|
814
|
+
* allow-list: every other field is withheld and listed as other people's data). A person-naming column a SEVERER
|
|
815
|
+
* reaches is declared beside the severer instead (`SubjectReferenceSeverer.subjectReferenceColumns`).
|
|
816
|
+
*
|
|
817
|
+
* Not an edge, on purpose: `exportSubject` is per resource, so an `invitedByUserId` edge on `organizationMembers` would
|
|
818
|
+
* put every member the person invited, whole, into their export.
|
|
819
|
+
*
|
|
820
|
+
* Each key and each shown name must be a top-level field of the main schema (a variant's included); the factory refuses
|
|
821
|
+
* one that is not. The resource must declare `systemAccessPolicy.exportSubject`.
|
|
822
|
+
*/
|
|
823
|
+
subjectExportPersonColumns?: SubjectExportPersonColumns,
|
|
824
|
+
|
|
760
825
|
/**
|
|
761
826
|
* Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
|
|
762
827
|
* matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
|
|
@@ -252,6 +252,7 @@ export const specificationsCompanionExports: SpecificationsCompanionExports<
|
|
|
252
252
|
* reports a vendor-hosted provider a runtime selects that is not named here.
|
|
253
253
|
*/
|
|
254
254
|
processorRegister: applicationProcessorRegister,
|
|
255
|
+
translationGlossary,
|
|
255
256
|
};
|
|
256
257
|
```
|
|
257
258
|
|
package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md
CHANGED
|
@@ -136,6 +136,8 @@ export interface SpecificationsCompanionExports<
|
|
|
136
136
|
TBrandNameScreening = BrandNameScreening,
|
|
137
137
|
// Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
|
|
138
138
|
TServiceMethod = ServiceMethod,
|
|
139
|
+
// Appended STRICTLY LAST: the regimes research established for the product (#3362).
|
|
140
|
+
TCompliancePosture = CompliancePosture,
|
|
139
141
|
> {
|
|
140
142
|
resourceSpecifications: TResourceSpecifications;
|
|
141
143
|
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
@@ -640,8 +642,10 @@ export interface SpecificationsCompanionExports<
|
|
|
640
642
|
*/
|
|
641
643
|
documentationPlan?: TApplicationDocumentationPlan;
|
|
642
644
|
/**
|
|
643
|
-
* THE AUTHORED
|
|
644
|
-
*
|
|
645
|
+
* THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
|
|
646
|
+
* by being committed. Optional: a chapter is normally written in its own file,
|
|
647
|
+
* `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
|
|
648
|
+
* publication reads those files beside this set and merges them, refusing a chapter declared in both.
|
|
645
649
|
*
|
|
646
650
|
* Read by the documentation publication, which joins each body to its planned chapter and publishes
|
|
647
651
|
* it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
|
|
@@ -652,6 +656,15 @@ export interface SpecificationsCompanionExports<
|
|
|
652
656
|
* positional parameter would only add a slot for every consumer to skip.
|
|
653
657
|
*/
|
|
654
658
|
documentationChapters?: ApplicationDocumentationChapterSet;
|
|
659
|
+
/**
|
|
660
|
+
* THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
|
|
661
|
+
* honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
|
|
662
|
+
* `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
|
|
663
|
+
* ignored. Optional: absent means every word is the model's.
|
|
664
|
+
*
|
|
665
|
+
* Typed directly, like `documentationChapters`: no application narrows it.
|
|
666
|
+
*/
|
|
667
|
+
translationGlossary?: ApplicationTranslationGlossaryDeclaration;
|
|
655
668
|
/**
|
|
656
669
|
* WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
|
|
657
670
|
* minion's tick may touch, and the providers this application binds (#1495). Read by
|
|
@@ -681,6 +694,12 @@ export interface SpecificationsCompanionExports<
|
|
|
681
694
|
* playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
|
|
682
695
|
*/
|
|
683
696
|
serviceMethod?: TServiceMethod;
|
|
697
|
+
/**
|
|
698
|
+
* WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
|
|
699
|
+
* compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
|
|
700
|
+
* creator's own compliance constraints; this carries the researched ones.
|
|
701
|
+
*/
|
|
702
|
+
compliancePosture?: TCompliancePosture;
|
|
684
703
|
/**
|
|
685
704
|
* Accepted application-declared semantic causality between whole
|
|
686
705
|
* specification-family states. This is not the registry's physical
|
package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md
CHANGED
|
@@ -302,6 +302,15 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
302
302
|
* the people who already may approve. Startup refuses a name a variant uses and no module registers.
|
|
303
303
|
*/
|
|
304
304
|
operationApprovalResolvers?: OperationApprovalResolvers;
|
|
305
|
+
/**
|
|
306
|
+
* How each of the application's OWN external effects is undone (#3446), keyed by its compensation kind. A custom
|
|
307
|
+
* implementation that creates an object at a vendor before its operation's write reserves it first with
|
|
308
|
+
* `reserveExternalEffect(utils, { applicationCompensationKind, … })`; when no row names the object once the operation
|
|
309
|
+
* ended, the engine's settlement calls the compensator declared here. Key it by an enum the application owns
|
|
310
|
+
* (`satisfies Record<MyKind, ApplicationExternalEffectCompensator>`). One module declares a kind: two modules declaring
|
|
311
|
+
* the same kind are refused, naming both. A reservation naming a kind no module declares is refused before the vendor call.
|
|
312
|
+
*/
|
|
313
|
+
externalEffectCompensators?: ApplicationExternalEffectCompensators;
|
|
305
314
|
}
|
|
306
315
|
|
|
307
316
|
/**
|
|
@@ -316,7 +325,7 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
316
325
|
* |---|---|
|
|
317
326
|
* | `resourceConfigurations` | **last module wins, silently** |
|
|
318
327
|
* | `resourceFieldIdentifiers` | **last module wins, silently** |
|
|
319
|
-
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` | rejected, naming both modules |
|
|
328
|
+
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` · `externalEffectCompensators` | rejected, naming both modules |
|
|
320
329
|
* | `resourceRelationships` · `operations` · `controllers` · `seeds` | concatenated — both are kept |
|
|
321
330
|
* | `inboundHandlers` | concatenated; a duplicate `ref` is rejected, naming both modules |
|
|
322
331
|
* | `humanDecisionNoticeHandler` | at most one across every module; a second is rejected, naming both modules |
|
|
@@ -356,9 +365,29 @@ export function mergeBackendDomainModules(
|
|
|
356
365
|
...mergeHumanDecisionNoticeHandler(modules),
|
|
357
366
|
chatReplyHandlers: modules.flatMap(m => m.chatReplyHandlers ?? []),
|
|
358
367
|
operationApprovalResolvers: mergeOperationApprovalResolvers(modules),
|
|
368
|
+
externalEffectCompensators: mergeExternalEffectCompensators(modules),
|
|
359
369
|
};
|
|
360
370
|
}
|
|
361
371
|
|
|
372
|
+
/** Every module's external effect compensators in one record, refusing a kind two modules declare (naming both). */
|
|
373
|
+
function mergeExternalEffectCompensators(modules: BackendDomainModule[]): ApplicationExternalEffectCompensators | undefined {
|
|
374
|
+
const merged: Record<string, ApplicationExternalEffectCompensators[string]> = {};
|
|
375
|
+
const sourceIndexByKind = new Map<string, number>();
|
|
376
|
+
for (let moduleIndex = 0; moduleIndex < modules.length; moduleIndex++) {
|
|
377
|
+
for (const [kind, compensator] of Object.entries(modules[moduleIndex]!.externalEffectCompensators ?? {})) {
|
|
378
|
+
const firstSource = sourceIndexByKind.get(kind);
|
|
379
|
+
if (firstSource !== undefined) {
|
|
380
|
+
throw new Error(
|
|
381
|
+
`mergeBackendDomainModules: duplicate externalEffectCompensators kind '${kind}' — declared by module index ${firstSource} AND module index ${moduleIndex}. A kind is undone one way; pick a unique one.`,
|
|
382
|
+
);
|
|
383
|
+
}
|
|
384
|
+
sourceIndexByKind.set(kind, moduleIndex);
|
|
385
|
+
merged[kind] = compensator;
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
return Object.keys(merged).length > 0 ? merged : undefined;
|
|
389
|
+
}
|
|
390
|
+
|
|
362
391
|
/** Every module's operation-approval resolvers in one record, refusing a name two modules register (naming both). */
|
|
363
392
|
function mergeOperationApprovalResolvers(modules: BackendDomainModule[]): OperationApprovalResolvers | undefined {
|
|
364
393
|
const merged: Record<string, OperationApprovalResolvers[string]> = {};
|
|
@@ -269,108 +269,106 @@ or share records with it, declare a relationship kind
|
|
|
269
269
|
sees and per-record sharing come with it. A junction only confines
|
|
270
270
|
which id a row may name.
|
|
271
271
|
|
|
272
|
-
## A second FK
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
**When this is a modelling mistake — fix the model, not the flag:**
|
|
291
|
-
|
|
292
|
-
- The two edges mean the same thing and were written twice. Delete one.
|
|
293
|
-
- You declared a lateral reference child-first when it belongs in the
|
|
294
|
-
parent direction (previous section). Turn it around.
|
|
295
|
-
- You are modelling a peer M:N directly. Use an explicit junction
|
|
296
|
-
resource instead — the framework fail-closes peer expansion.
|
|
297
|
-
|
|
298
|
-
**When it is genuine — and no direction avoids it:** a resource whose
|
|
299
|
-
SCOPE is a type it also references. The canonical shape is an actor
|
|
300
|
-
column: an erasure request lives under `/users/:userId/…` (the subject)
|
|
301
|
-
and separately records the operator who filed it. Scope and actor are
|
|
302
|
-
different facts about different people, and collapsing them destroys the
|
|
303
|
-
accountability the actor column exists for. Both edges are required —
|
|
304
|
-
an FK field with no relationship naming it is unresolvable, and the
|
|
305
|
-
frontend registry throws `frontend_fk_resolution_failed` rather than
|
|
306
|
-
render a reference it cannot type.
|
|
272
|
+
## A second FK to the type that owns your scope
|
|
273
|
+
|
|
274
|
+
The canonical shape is an actor column: an erasure request lives under
|
|
275
|
+
`/users/:userId/…` (the subject) and separately records the operator who
|
|
276
|
+
filed it (`requestedByUserId`). Scope and actor are different facts about
|
|
277
|
+
different people, and collapsing them destroys the accountability the
|
|
278
|
+
actor column exists for. Both edges are required — an FK field with no
|
|
279
|
+
relationship naming it is unresolvable, and the frontend registry throws
|
|
280
|
+
`frontend_fk_resolution_failed` rather than render a reference it cannot
|
|
281
|
+
type.
|
|
282
|
+
|
|
283
|
+
**Declare BOTH edges in the PARENT direction** — the referenced type
|
|
284
|
+
first, your resource second, twice. The foreign-key holder is resolved
|
|
285
|
+
from CARDINALITY, so your resource holds both columns either way, and the
|
|
286
|
+
two edges are told apart by their `foreignKeyField`. Two parallel edges
|
|
287
|
+
between one pair of types are **not** a cycle: the startup detector walks
|
|
288
|
+
each edge from its first type to its second, so only an edge pointing BACK
|
|
289
|
+
closes one. No `allowCycle` is needed.
|
|
307
290
|
|
|
308
291
|
|
|
309
292
|
## Usage Example
|
|
310
293
|
|
|
311
294
|
```typescript
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
),
|
|
295
|
+
// The SUBJECT edge: scope, routing and lifecycle.
|
|
296
|
+
createResourcesRelationship(
|
|
297
|
+
CoreResourceType.USERS, CoreResourceType.DATA_SUBJECT_REQUESTS,
|
|
298
|
+
ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
|
|
299
|
+
{
|
|
300
|
+
nature: RelationshipNature.COMPOSITION,
|
|
301
|
+
isPrimaryScope: true,
|
|
302
|
+
foreignKeyField: 'userId',
|
|
303
|
+
parentResourceRequirement: ResourceParentResourceRequirement.MANDATORY,
|
|
304
|
+
accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT,
|
|
305
|
+
childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
|
|
306
|
+
contextPolicy: {},
|
|
307
|
+
}
|
|
308
|
+
),
|
|
327
309
|
```
|
|
328
310
|
|
|
329
311
|
## Usage Example
|
|
330
312
|
|
|
331
313
|
```typescript
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
314
|
+
// The OPERATOR edge: a second FK to the resource type that already owns this resource's scope, declared in the
|
|
315
|
+
// same PARENT direction. Evidence only — never a scope path, never a nested route, never a teardown.
|
|
316
|
+
createResourcesRelationship(
|
|
317
|
+
CoreResourceType.USERS, CoreResourceType.DATA_SUBJECT_REQUESTS,
|
|
318
|
+
ResourceRelationshipCardinality.ONE, ResourceRelationshipCardinality.MANY,
|
|
319
|
+
{
|
|
320
|
+
nature: RelationshipNature.REFERENCE,
|
|
321
|
+
foreignKeyField: 'requestedByUserId',
|
|
322
|
+
parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
|
|
323
|
+
accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.STANDALONE,
|
|
324
|
+
// Erasing the operator leaves the request exactly as it is: it is the controller's evidence of who acted.
|
|
325
|
+
childOperations: { lifecycle: { onParentDelete: { enabled: false } } },
|
|
326
|
+
contextPolicy: {
|
|
327
|
+
objectMode: ContextPolicy_ObjectMode.SUMMARY,
|
|
328
|
+
operationOverrides: {
|
|
329
|
+
[CoreResourceOperation.LIST]: { enabled: false },
|
|
330
|
+
[CoreResourceOperation.SEARCH]: { enabled: false },
|
|
331
|
+
},
|
|
332
|
+
},
|
|
333
|
+
}
|
|
334
|
+
),
|
|
352
335
|
```
|
|
353
336
|
|
|
354
337
|
Rules that make the second edge safe:
|
|
355
338
|
|
|
356
339
|
| Rule | Why |
|
|
357
340
|
|---|---|
|
|
358
|
-
|
|
|
341
|
+
| Parent direction, like the scope edge | A child-first actor edge makes the referenced type a CHILD of your resource in every relationship bucket (`users` gains a parent), and closes a cycle that fails startup (below). |
|
|
359
342
|
| The actor edge is `REFERENCE`, never `COMPOSITION` | `COMPOSITION` is what makes a parent's teardown reach the child. Evidence about who acted must outlive the actor. |
|
|
343
|
+
| `childOperations.lifecycle.onParentDelete: { enabled: false }` | States that survival explicitly: erasing the operator leaves the row as it is. |
|
|
360
344
|
| `accessScopeStrategy: STANDALONE` | Scope belongs to the composition. A second scope-bearing edge to the same parent type makes the resource's primary scope ambiguous. |
|
|
361
345
|
| `parentResourceRequirement: OPTIONAL` if the column is `.optional()` | A self-service row has no operator; `MANDATORY` would reject every such row. |
|
|
362
346
|
| `LIST`/`SEARCH` context disabled | An actor is a summary field on one row, not a collection-level join. |
|
|
363
347
|
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
348
|
+
### The cycle error means an edge points the wrong way
|
|
349
|
+
|
|
350
|
+
Declare the actor edge child-first and startup refuses the registry with:
|
|
351
|
+
|
|
352
|
+
```
|
|
353
|
+
Cycle detected: users → dataSubjectRequests → users.
|
|
354
|
+
Edges missing allowCycle: [users → dataSubjectRequests, dataSubjectRequests → users].
|
|
355
|
+
Set allowCycle: true on all edges in the cycle to allow it.
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
The fix is to turn the child-first edge around, not to set the flag.
|
|
359
|
+
Setting `allowCycle` on both edges silences the error and keeps the wrong
|
|
360
|
+
model: the referenced type still has your resource as its parent.
|
|
361
|
+
|
|
362
|
+
**When `allowCycle` is genuine:** a type that is really its own parent —
|
|
363
|
+
a self-referential tree (`parentUnitId` on organization units), where
|
|
364
|
+
the edge points from the type to itself — or a true loop in which each
|
|
365
|
+
type owns rows of the other. It is a registration-time escape hatch and
|
|
366
|
+
nothing more — no traversal reads it. It does not make the cascade
|
|
367
|
+
follow the edge, it does not create a nested route (`accessScopeStrategy`
|
|
368
368
|
decides that), and it does not disable any recursion guard: context
|
|
369
369
|
expansion is bounded by a per-row visited set and a depth cap, and the
|
|
370
|
-
descendant map by its own visited set.
|
|
371
|
-
|
|
372
|
-
everything under it — worth a look if you rely on descendant-scoped
|
|
373
|
-
navigation.
|
|
370
|
+
descendant map by its own visited set. Every edge of the loop needs the
|
|
371
|
+
flag; the error names each one still missing it.
|
|
374
372
|
|
|
375
373
|
| Rationalization | Reality |
|
|
376
374
|
|---|---|
|
|
@@ -436,6 +434,14 @@ Key choices to internalize:
|
|
|
436
434
|
— the parent doesn't need to be in scope for the child query. The
|
|
437
435
|
alternative (`STANDALONE`) decouples scope entirely; the default
|
|
438
436
|
scopes the child by the parent.
|
|
437
|
+
A `STANDALONE` edge (or one whose context policy is disabled) puts no
|
|
438
|
+
requirement for the parent in the child's context. If a page of the parent
|
|
439
|
+
will show those children (`RelatedResourceSections`, `EmbedRelatedResourceList`),
|
|
440
|
+
the embed takes the child's route under the parent when one exists; when
|
|
441
|
+
none does, declare the edge's foreign key in the child LIST's `filterFields`
|
|
442
|
+
and the embed pins it to the parent record. Without either the section is
|
|
443
|
+
left out, with a warning naming the cause, rather than listing every row the
|
|
444
|
+
reader may see.
|
|
439
445
|
- `contextPolicy.objectMode: ContextPolicy_ObjectMode.SUMMARY` — when
|
|
440
446
|
resolving the parent in the child's response, surface a summary
|
|
441
447
|
payload by default. The `operationOverrides[READ]` upgrades to
|
|
@@ -559,19 +565,14 @@ read it back after the build settles, not mid-edit.
|
|
|
559
565
|
- [ ] A lateral reference to a NON tenant-scoped target (`users`, `organizations`) declares `scopeMembership` — otherwise a cross-tenant id is accepted and stored
|
|
560
566
|
- [ ] Per-variant tightening (status / roles / typed junction rows) is declared as `referenceConstraints` on the OPERATION, not on the relationship
|
|
561
567
|
- [ ] A reference to another organization names its junction and is declared in the PARENT direction (a child-first edge closes a graph cycle and fails startup)
|
|
562
|
-
- [ ]
|
|
568
|
+
- [ ] A second FK to the type that owns your scope is a PARENT-direction edge, `REFERENCE` + `STANDALONE` with an explicit `foreignKeyField` — no `allowCycle`, which only a self-referential tree or a true two-way ownership loop needs
|
|
563
569
|
|
|
564
570
|
### Grep invariants
|
|
565
571
|
|
|
566
572
|
```bash
|
|
567
|
-
# every allowCycle edge —
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
# an allowCycle edge with no explicit foreignKeyField — two edges between one pair of types are
|
|
571
|
-
# told apart ONLY by their columns, so an implicit one is ambiguous (must return empty). One
|
|
572
|
-
# match is one createResourcesRelationship(...) call holding allowCycle and no foreignKeyField,
|
|
573
|
-
# wherever in the call either appears.
|
|
574
|
-
rg -U -P -l 'createResourcesRelationship\((?:(?!createResourcesRelationship\(|foreignKeyField)[\s\S])*?allowCycle: true(?:(?!createResourcesRelationship\(|foreignKeyField)[\s\S])*(?=createResourcesRelationship\(|\z)' ./shared-lib/src/modules --glob '*.relationships.ts'
|
|
573
|
+
# every allowCycle edge — each must be a self-referential tree or a true two-way ownership loop,
|
|
574
|
+
# never an actor reference declared child-first (turn that edge around instead)
|
|
575
|
+
rg -n -B 3 "allowCycle: true" ./shared-lib/src/modules --glob '*.relationships.ts'
|
|
575
576
|
|
|
576
577
|
# a lateral reference to a non-tenant-scoped target that does NOT confine itself (must return empty)
|
|
577
578
|
rg -U -P -l "createResourcesRelationship\((?:(?!createResourcesRelationship\(|scopeMembership)[\s\S])*?foreignKeyField: '(?:assignedTo|sharedWith|reviewer|owner)\w*'(?:(?!createResourcesRelationship\(|scopeMembership)[\s\S])*(?=createResourcesRelationship\(|\z)" ./shared-lib/src/modules --glob '*.relationships.ts'
|
|
@@ -613,8 +614,8 @@ are renamed.
|
|
|
613
614
|
| "A COMPOSITION edge cascades by default" | It does not: `onParentDelete.enabled` defaults to `false`. Declaring COMPOSITION says who owns the rows; only `onParentDelete` says what happens to them, and a tenant purge relies on it for every owned resource. |
|
|
614
615
|
| "The UI task already did the ui-behavior" | It ran before this relationship existed, so the foreign key was not there to show. Adding it to the read page is this task's work (Step 3). |
|
|
615
616
|
| "Cascade is fine without `maxDepth`" | `maxDepth` bounds the cascade. Without it, a deep tree can produce expensive deletes (or wedge the framework on cyclic graphs). |
|
|
616
|
-
| "The cycle report is wrong — my two columns are different, no row can loop" |
|
|
617
|
-
| "I'll set `allowCycle` on the
|
|
617
|
+
| "The cycle report is wrong — my two columns are different, no row can loop" | Two parallel edges are not a cycle. A report means one edge points BACK at a type that is already its parent — usually an actor reference declared child-first. Turn it around; `allowCycle` would keep the wrong parent in every relationship bucket. |
|
|
618
|
+
| "I'll set `allowCycle` and move on" | That silences the error and keeps the inverted model. The flag is for a self-referential tree or a true two-way ownership loop, and then it must be on every edge of the loop. |
|
|
618
619
|
| "I'll reuse the scope edge instead of adding a second one" | Then the actor and the subject become one field, which is the exact fact the actor column exists to keep separate. A scope edge answers "whose row is this"; an actor edge answers "who did this". |
|
|
619
620
|
| "`allowCycle` might make something recurse forever" | It changes registration only — no traversal reads it. Context expansion is bounded by a per-row visited set and a depth cap, and the descendant map by its own visited set. |
|
|
620
621
|
|
|
@@ -626,7 +627,7 @@ are renamed.
|
|
|
626
627
|
- `nature` missing from a relationship entry (catch with the **`nature` is declared on every relationship** grep — count must equal the number of `createResourcesRelationship(` calls).
|
|
627
628
|
- `onParentDelete: { enabled: true }` without `maxDepth` (catch with the **Composition relationships with `onParentDelete` declare `maxDepth`** grep).
|
|
628
629
|
- A `COMPOSITION` edge with no `onParentDelete` at all (catch with the **Every `COMPOSITION` edge declares its parent-delete lifecycle** counts, and with the boot line `[dependent-lifecycle-unclassified]`).
|
|
629
|
-
- An
|
|
630
|
+
- An `allowCycle: true` edge on an actor reference, or an actor edge declared child-first (catch with the **allowCycle** grep above — turn the edge around instead), or two edges to one type without explicit `foreignKeyField`s (catch with the **`foreignKeyField` literal always paired** grep — the edges are told apart only by their columns).
|
|
630
631
|
- A foreign key that appears in the holder's `edit()` and not in its `display()`: the read page never says which record it belongs to (catch with the **holder shows the reference on its read page** grep).
|
|
631
632
|
- A second edge to a parent type declared `COMPOSITION` or `REQUIRES_CONTEXT` when it is only an actor reference (catch by reading both edges together — the resource's scope must come from exactly one of them).
|
|
632
633
|
|