@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/references/saas.models.flows-actors.operation-approval-requirement.md
CHANGED
|
@@ -57,6 +57,37 @@ export const ResourceOperationApprovalRequirementSchema = z.object({
|
|
|
57
57
|
assignee: z.string().min(1).optional(),
|
|
58
58
|
escalateTo: z.string().min(1).optional(),
|
|
59
59
|
deadlines: ReviewDeadlinesDeclarationSchema.optional(),
|
|
60
|
+
/**
|
|
61
|
+
* The approver must step up FOR THIS DECISION when they answer it (#2923): re-authenticate (password, an enrolled
|
|
62
|
+
* second factor or a passkey with user verification) with a proof bound to the request and to the presentation they
|
|
63
|
+
* were shown, minted by `POST /auth/reauth` naming both, single-use and short-lived, and carried in `X-Reauth-Token` on
|
|
64
|
+
* the answer. A proof for another decision, a changed presentation, a used or an expired one is refused, and a chat
|
|
65
|
+
* card cannot carry one, so a chat answer is refused too. The name is the operation flag's, reused: it asks the same
|
|
66
|
+
* of the approver that the flag asks of a person running the operation.
|
|
67
|
+
*/
|
|
68
|
+
requiresStepUpAuthentication: z.boolean().optional(),
|
|
69
|
+
/**
|
|
70
|
+
* What the step-up must ALSO be, when `requiresStepUpAuthentication` is `true` (#2923); startup refuses it otherwise.
|
|
71
|
+
*
|
|
72
|
+
* - `maximumAgeSeconds` — the factor was proven at most this many seconds before the answer (at most 300, the
|
|
73
|
+
* proof's own lifetime): "re-authenticate just before you approve", not "at some point in the last five minutes".
|
|
74
|
+
* - `minimumAssurance` — the weakest factor that may answer, weakest first: `reproven` (any step-up factor, a
|
|
75
|
+
* password included), `possession` (an enrolled TOTP or a passkey: a physical authenticator, never a password
|
|
76
|
+
* alone), `phishing_resistant` (a passkey only), as NIST SP 800-63B-4 classifies the authenticators. The approvers'
|
|
77
|
+
* user types must allow that factor as a step-up method (`stepUpAuth.methods`), or nobody can answer.
|
|
78
|
+
*
|
|
79
|
+
* A proof that is too old or too weak is refused like any unusable proof (`decision_step_up_required`); the person
|
|
80
|
+
* steps up again with one that meets it. The factor and the instant it was proven are recorded on the decision and on
|
|
81
|
+
* its approval seal (`decider.stepUpMethod`, `decider.stepUpAt`), so a verifier sees which factor answered and when.
|
|
82
|
+
*/
|
|
83
|
+
stepUp: HumanDecision_StepUpRequirementSchema.optional(),
|
|
84
|
+
/**
|
|
85
|
+
* The channels that may answer the approval (#2923): `web_session` (the application), `chat` (a chat card),
|
|
86
|
+
* `api_client` (a client the approver delegated to; never admitted for an approval, which is decided in person).
|
|
87
|
+
* Absent: every channel the other requirements allow. `chat` is refused beside a step-up, which a chat answer cannot
|
|
88
|
+
* carry; a chat card for an approval it may not answer links to the approval in the application.
|
|
89
|
+
*/
|
|
90
|
+
answerChannels: HumanDecision_AnswerChannelsSchema.optional(),
|
|
60
91
|
});
|
|
61
92
|
export type ResourceOperationApprovalRequirement = z.infer<typeof ResourceOperationApprovalRequirementSchema>;
|
|
62
93
|
```
|
|
@@ -28,7 +28,7 @@ export type ReviewDeadlineAt = z.infer<typeof ReviewDeadlineAtSchema>;
|
|
|
28
28
|
export const ReviewDeadlineTargetSchema = z.object({
|
|
29
29
|
at: ReviewDeadlineAtSchema,
|
|
30
30
|
/** Elapsed time (the default) or the application's business calendar. */
|
|
31
|
-
basis: z.enum(ReviewClockBasis).optional(),
|
|
31
|
+
basis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').optional(),
|
|
32
32
|
/** Arms a WARNING stage this long before the deadline, on the same basis. Absent: no warning stage. */
|
|
33
33
|
warnBefore: ReviewDurationSchema.optional(),
|
|
34
34
|
});
|
|
@@ -39,8 +39,8 @@ export type ReviewDeadlineTarget = z.infer<typeof ReviewDeadlineTargetSchema>;
|
|
|
39
39
|
* target resolver, declared on the backend gate beside it.
|
|
40
40
|
*/
|
|
41
41
|
export const ReviewEscalationRuleSchema = z.object({
|
|
42
|
-
stage: z.enum(ReviewDeadlineStage),
|
|
43
|
-
action: z.enum(ReviewEscalationActionKind),
|
|
42
|
+
stage: z.enum(ReviewDeadlineStage).systemEnum('ReviewDeadlineStage'),
|
|
43
|
+
action: z.enum(ReviewEscalationActionKind).systemEnum('ReviewEscalationActionKind'),
|
|
44
44
|
});
|
|
45
45
|
export type ReviewEscalationRuleDescriptor = z.infer<typeof ReviewEscalationRuleSchema>;
|
|
46
46
|
|
|
@@ -69,11 +69,11 @@ export type Flow_Condition = z.infer<typeof Flow_ConditionSchema>;
|
|
|
69
69
|
*/
|
|
70
70
|
export const Flow_EdgeSchema = z.object({
|
|
71
71
|
from: z.object({
|
|
72
|
-
type: z.enum(Flow_Node_Type),
|
|
72
|
+
type: z.enum(Flow_Node_Type).systemEnum('Flow_Node_Type'),
|
|
73
73
|
ref: z.string(),
|
|
74
74
|
}),
|
|
75
75
|
to: z.object({
|
|
76
|
-
type: z.enum(Flow_Node_Type),
|
|
76
|
+
type: z.enum(Flow_Node_Type).systemEnum('Flow_Node_Type'),
|
|
77
77
|
ref: z.string(),
|
|
78
78
|
}),
|
|
79
79
|
/** The condition under which the run takes this edge; absent, the node's default edge. */
|
|
@@ -164,6 +164,25 @@ export type Flow_HumanInTheLoop = {
|
|
|
164
164
|
context?: Flow_HumanContextEntry[];
|
|
165
165
|
/** The questions, as an agent asks its person (`AskPerson_Question`). */
|
|
166
166
|
questions: AskPerson_Question[];
|
|
167
|
+
/**
|
|
168
|
+
* Whether the answer must carry a fresh step-up proof bound to this question (#2923): the person re-proves a factor
|
|
169
|
+
* (`POST /auth/reauth` with a `decisionBinding` naming the question and the presentation answered) and answers from the
|
|
170
|
+
* decision inbox with it. A chat answer carries none, so it is refused. Use it for a step whose answer commits the
|
|
171
|
+
* person: a sign-off, a payment release.
|
|
172
|
+
*/
|
|
173
|
+
requiresStepUpAuthentication?: boolean;
|
|
174
|
+
/**
|
|
175
|
+
* What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true` (refused without it):
|
|
176
|
+
* `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven`, `possession`
|
|
177
|
+
* or `phishing_resistant`. Recorded on the decision and its approval seal as `decider.stepUpMethod` / `stepUpAt`.
|
|
178
|
+
*/
|
|
179
|
+
stepUp?: HumanDecision_StepUpRequirement;
|
|
180
|
+
/**
|
|
181
|
+
* The channels that may answer this step (#2923): `web_session`, `chat`, `api_client`. Absent: every channel the other
|
|
182
|
+
* requirements allow. `chat` is refused beside a step-up; a chat card for a step it may not answer links to it in the
|
|
183
|
+
* application.
|
|
184
|
+
*/
|
|
185
|
+
answerChannels?: HumanDecision_AnswerChannels;
|
|
167
186
|
};
|
|
168
187
|
|
|
169
188
|
/** One run value a person step shows, and the words that name it to the person (`"Proposed resolution"`). */
|
|
@@ -120,7 +120,7 @@ export const GuidanceAudienceSchema = z.object({
|
|
|
120
120
|
equals: z.union([z.string(), z.number(), z.boolean()]),
|
|
121
121
|
})).optional(),
|
|
122
122
|
/** Only show to users created after this date (for new-user flows) */
|
|
123
|
-
createdAfter: z.
|
|
123
|
+
createdAfter: z.date().nullish(),
|
|
124
124
|
});
|
|
125
125
|
export type GuidanceAudience = z.infer<typeof GuidanceAudienceSchema>;
|
|
126
126
|
|
|
@@ -135,7 +135,7 @@ export enum HttpApiWriteVerb {
|
|
|
135
135
|
|
|
136
136
|
/**
|
|
137
137
|
* What protects an UPDATE against overwriting a change made since its author read the row (#1724, #1726, #1728) —
|
|
138
|
-
* declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODATA, REST_JSON).
|
|
138
|
+
* declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODOO_JSON2, ODATA, REST_JSON).
|
|
139
139
|
*
|
|
140
140
|
* ## Why a binding must say this at all
|
|
141
141
|
*
|
|
@@ -685,7 +685,7 @@ const httpApiResourceBindingBaseShape = {
|
|
|
685
685
|
* How an opened UPDATE is protected against overwriting a change made since its author read the row (#1724). See
|
|
686
686
|
* {@link HttpApiWriteConcurrencyMode} for the two answers and the limit of the first.
|
|
687
687
|
*
|
|
688
|
-
* REQUIRED when the binding opens UPDATE — on
|
|
688
|
+
* REQUIRED when the binding opens UPDATE — on both Odoo dialects (#1724, #3391), ODATA (#1726) and REST_JSON (#1728) alike — and
|
|
689
689
|
* refused when the binding opens no UPDATE — a concurrency stance on a door that is shut decides nothing. `versionField` names the LOCAL field that
|
|
690
690
|
* carries the version: it must map onto the vendor facet's `rowVersionField` (checked at boot, where the facet is
|
|
691
691
|
* visible) — Odoo `write_date`, an OData service's `@odata.etag` — and the resource's schema must let an UPDATE carry
|
|
@@ -768,6 +768,16 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
|
|
|
768
768
|
// (called by the resource-configuration factory) — a refine here would wrap the union member
|
|
769
769
|
// in effects, which discriminated unions do not admit.
|
|
770
770
|
}),
|
|
771
|
+
z.strictObject({
|
|
772
|
+
/*
|
|
773
|
+
* Odoo's External JSON-2 API (#3391). The same declaration as ODOO_JSONRPC — `entityRef` is the model, read/list/
|
|
774
|
+
* count map mechanically, one INTEGER key — because what a binding states is what the rows ARE, and that does not
|
|
775
|
+
* change with the wire. Its own arm rather than a two-value literal on the arm above, so a reader narrowing a binding
|
|
776
|
+
* to one Odoo wire (the read client does) gets exactly one.
|
|
777
|
+
*/
|
|
778
|
+
dialect: z.literal(HttpApiTransportDialect.ODOO_JSON2),
|
|
779
|
+
...httpApiResourceBindingBaseShape,
|
|
780
|
+
}),
|
|
771
781
|
]);
|
|
772
782
|
|
|
773
783
|
/**
|
|
@@ -862,15 +872,15 @@ function assertRestJsonKeysetCoherence(keyFields: readonly HttpApiKeyField[], op
|
|
|
862
872
|
* path named.
|
|
863
873
|
*/
|
|
864
874
|
export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBinding): void {
|
|
865
|
-
if (binding.dialect
|
|
866
|
-
// Odoo row ids are INTEGERS, always — one key field, INTEGER codec,
|
|
867
|
-
// could never address a row.
|
|
875
|
+
if (isOdooTransportDialect(binding.dialect)) {
|
|
876
|
+
// Odoo row ids are INTEGERS, always, whichever wire reads them — one key field, INTEGER codec,
|
|
877
|
+
// or the synthesized id could never address a row.
|
|
868
878
|
if (
|
|
869
879
|
binding.keyFields.length !== 1
|
|
870
880
|
|| binding.keyFields[0].codec !== HttpApiKeyComponentCodec.INTEGER
|
|
871
881
|
) {
|
|
872
882
|
throw new Error(
|
|
873
|
-
|
|
883
|
+
`keyFields: an ${binding.dialect} binding must declare exactly one key field with the INTEGER codec — Odoo row ids are integers ('id').`,
|
|
874
884
|
);
|
|
875
885
|
}
|
|
876
886
|
}
|
|
@@ -954,7 +964,7 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
|
|
|
954
964
|
'writeConcurrency: declared on a binding that opens no UPDATE — it governs updates only. Remove it, or open the update.',
|
|
955
965
|
);
|
|
956
966
|
}
|
|
957
|
-
if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect
|
|
967
|
+
if (opensUpdate && binding.writeConcurrency === undefined && isOdooTransportDialect(binding.dialect)) {
|
|
958
968
|
throw new Error(
|
|
959
969
|
`writeConcurrency: this binding opens UPDATE toward '${binding.system}', and Odoo's external API has no conditional write — `
|
|
960
970
|
+ '`write(ids, vals)` applies the values whatever changed since they were read. State the stance: '
|
|
@@ -1022,7 +1032,8 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
|
|
|
1022
1032
|
// admits both forms; only the pairing below is executable, so an incoherent pairing must refuse
|
|
1023
1033
|
// at authoring rather than on the first subject-erasure request:
|
|
1024
1034
|
// - ODATA → `useCanonicalDelete` only (the canonical `DELETE /EntitySet(key)`);
|
|
1025
|
-
// - ODOO_JSONRPC → `useCanonicalDelete` only (compiles to `
|
|
1035
|
+
// - ODOO_JSONRPC / ODOO_JSON2 → `useCanonicalDelete` only (compiles to Odoo's `unlink` on the ids — `execute_kw`
|
|
1036
|
+
// on JSON-RPC, `POST /json/2/<model>/unlink { ids }` on JSON-2 —
|
|
1026
1037
|
// Odoo's own canonical delete);
|
|
1027
1038
|
// - REST_JSON → an explicit operation spec only (there IS no canonical delete to rely on —
|
|
1028
1039
|
// the binding declares the exact call, like every other REST_JSON operation).
|
|
@@ -12,12 +12,17 @@
|
|
|
12
12
|
/**
|
|
13
13
|
* What a message arrived on.
|
|
14
14
|
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
15
|
+
* Chat and Slack join this vocabulary when a provider can fill them — a channel nothing can receive on is a
|
|
16
|
+
* slot no configuration can satisfy.
|
|
17
17
|
*/
|
|
18
18
|
export enum InboundChannelKind {
|
|
19
19
|
/** Email received through the application's `EMAIL_INBOUND` provider and routed to an organization. */
|
|
20
20
|
EMAIL = 'email',
|
|
21
|
+
/**
|
|
22
|
+
* A text message received by the application's SMS provider on a number the application assigned to an
|
|
23
|
+
* organization (#3394), routed to that organization by the number it was sent TO, never by its sender.
|
|
24
|
+
*/
|
|
25
|
+
SMS = 'sms',
|
|
21
26
|
/**
|
|
22
27
|
* A signed HTTP delivery from another system (#1596). Derived for provider and application endpoint
|
|
23
28
|
* deliveries; a handler never declares it.
|
|
@@ -58,6 +63,13 @@ export enum InboundSenderAssurance {
|
|
|
58
63
|
* and `From` is the address that token was issued to.
|
|
59
64
|
*/
|
|
60
65
|
THREAD_TOKEN_BOUND = 'thread_token_bound',
|
|
66
|
+
/**
|
|
67
|
+
* SMS: the sending number is the verified phone number (`UserCredentials.phoneNumberVerified`) of exactly one
|
|
68
|
+
* active member of the routed organization. Verified when the member confirmed a code sent to it; the sender of
|
|
69
|
+
* THIS text is still not authenticated (caller ID can be spoofed onto SMS), so it identifies the member and
|
|
70
|
+
* grants nothing. Two members holding one number identify nobody.
|
|
71
|
+
*/
|
|
72
|
+
VERIFIED_MEMBER_NUMBER = 'verified_member_number',
|
|
61
73
|
}
|
|
62
74
|
|
|
63
75
|
/** The assurance levels meaningful on each channel — the type a channel's ladder and minimum are drawn from. */
|
|
@@ -67,6 +79,10 @@ export interface InboundSenderAssuranceByChannel {
|
|
|
67
79
|
| InboundSenderAssurance.DOMAIN_ALIGNED
|
|
68
80
|
| InboundSenderAssurance.KNOWN_CONTACT
|
|
69
81
|
| InboundSenderAssurance.THREAD_TOKEN_BOUND;
|
|
82
|
+
[InboundChannelKind.SMS]:
|
|
83
|
+
| InboundSenderAssurance.UNVERIFIED
|
|
84
|
+
| InboundSenderAssurance.KNOWN_CONTACT
|
|
85
|
+
| InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
|
|
70
86
|
[InboundChannelKind.WEBHOOK]: InboundSenderAssurance.UNVERIFIED | InboundSenderAssurance.SOURCE_SIGNED;
|
|
71
87
|
}
|
|
72
88
|
|
|
@@ -84,6 +100,16 @@ export const INBOUND_SENDER_ASSURANCE_LADDERS: { readonly [C in InboundChannelKi
|
|
|
84
100
|
InboundSenderAssurance.KNOWN_CONTACT,
|
|
85
101
|
InboundSenderAssurance.THREAD_TOKEN_BOUND,
|
|
86
102
|
],
|
|
103
|
+
/*
|
|
104
|
+
* A member's verified number outranks a contact the application recognises: the member proved the number by a code
|
|
105
|
+
* the engine sent to it, while a contact's number is whatever the application recorded. Neither authenticates the
|
|
106
|
+
* sender of this text (SMS has no counterpart of DMARC), which is why the ladder only ever IDENTIFIES.
|
|
107
|
+
*/
|
|
108
|
+
[InboundChannelKind.SMS]: [
|
|
109
|
+
InboundSenderAssurance.UNVERIFIED,
|
|
110
|
+
InboundSenderAssurance.KNOWN_CONTACT,
|
|
111
|
+
InboundSenderAssurance.VERIFIED_MEMBER_NUMBER,
|
|
112
|
+
],
|
|
87
113
|
[InboundChannelKind.WEBHOOK]: [InboundSenderAssurance.UNVERIFIED, InboundSenderAssurance.SOURCE_SIGNED],
|
|
88
114
|
};
|
|
89
115
|
|
|
@@ -271,6 +297,49 @@ export function isEmailMessageId(value: unknown): value is string {
|
|
|
271
297
|
return typeof value === 'string' && EMAIL_MESSAGE_ID_PATTERN.test(value);
|
|
272
298
|
}
|
|
273
299
|
|
|
300
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
301
|
+
// SMS: deriving sender assurance and a text's route tag
|
|
302
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
303
|
+
|
|
304
|
+
/** What the routed organization knows about the number a text came from (#3394). */
|
|
305
|
+
export enum SmsSenderNumberMatch {
|
|
306
|
+
/** Not one member's verified number, and not a contact the application recognises. */
|
|
307
|
+
NONE = 'none',
|
|
308
|
+
/** The verified phone number of exactly one active member of the routed organization (sets `memberUserId`). */
|
|
309
|
+
VERIFIED_MEMBER = 'verified_member',
|
|
310
|
+
/** The handler's contact resolver recognised the number. The engine keeps no contacts of its own. */
|
|
311
|
+
APPLICATION_CONTACT = 'application_contact',
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
/**
|
|
315
|
+
* A text's sender assurance (#3394). PURE: the input is a lookup the engine made, never what the text says.
|
|
316
|
+
*
|
|
317
|
+
* SMS carries no sender authentication — no counterpart of DMARC, and caller ID can be spoofed onto a text — so every
|
|
318
|
+
* level above the floor IDENTIFIES the sender by a number someone verified or recorded, and none of them
|
|
319
|
+
* authenticates it. A handler's roles never depend on it (I8); a handler only states the minimum it acts on.
|
|
320
|
+
*/
|
|
321
|
+
export function deriveSmsSenderAssurance(match: SmsSenderNumberMatch): SenderAssuranceOf<InboundChannelKind.SMS> {
|
|
322
|
+
switch (match) {
|
|
323
|
+
case SmsSenderNumberMatch.VERIFIED_MEMBER: return InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
|
|
324
|
+
case SmsSenderNumberMatch.APPLICATION_CONTACT: return InboundSenderAssurance.KNOWN_CONTACT;
|
|
325
|
+
case SmsSenderNumberMatch.NONE: return InboundSenderAssurance.UNVERIFIED;
|
|
326
|
+
default: {
|
|
327
|
+
const unhandled: never = match;
|
|
328
|
+
return unhandled;
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* What an SMS `routeTag` looks like: the first word of a text, lower-cased, when it is a tag a handler declares
|
|
335
|
+
* (`INBOUND_ROUTE_TAG_PATTERN`'s shape). A text has no sub-address, so its first word is the only place a tag can be.
|
|
336
|
+
*/
|
|
337
|
+
export function smsRouteTagCandidate(text: string): string | undefined {
|
|
338
|
+
const first = text.normalize('NFKC').trim().split(/\s+/u)[0] ?? '';
|
|
339
|
+
const word = first.replace(/[^\p{L}\p{N}-]+$/gu, '').toLowerCase();
|
|
340
|
+
return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(word) ? word : undefined;
|
|
341
|
+
}
|
|
342
|
+
|
|
274
343
|
/**
|
|
275
344
|
* What an inbound handler's `ref` looks like: lower-case, dot-separated segments of `[a-z0-9-]`
|
|
276
345
|
* (`todos.intake`, `matters.mail-intake`). One definition for the backend's `inboundHandlerRef()`, which
|
|
@@ -20,7 +20,7 @@ export const ModelCostAccountingConfigSchema = z.object({
|
|
|
20
20
|
try {
|
|
21
21
|
assertUniqueProviderUsagePricingAuthorities(config.providerUsagePricingAuthorities);
|
|
22
22
|
} catch (error) {
|
|
23
|
-
context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message:
|
|
23
|
+
context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: describeCaughtError(error) });
|
|
24
24
|
}
|
|
25
25
|
});
|
|
26
26
|
export type ModelCostAccountingConfig = z.infer<typeof ModelCostAccountingConfigSchema>;
|
|
@@ -138,7 +138,9 @@ export function userNotificationTargetIsSuppressibleByRecipientPreference(target
|
|
|
138
138
|
*/
|
|
139
139
|
export function userNotificationTargetReadsUserRoles(target: string, channel: string): boolean {
|
|
140
140
|
if (target === CoreUserNotificationTarget.INBOUND_CONTACT) {
|
|
141
|
-
|
|
141
|
+
// Only the in-app alert reads roles. EMAIL reaches the contact by address, and SMS cannot reach the contact at all
|
|
142
|
+
// (an SMS goes only to a user's verified phone with their consent), so it is refused there (#1875).
|
|
143
|
+
return channel === CoreUserNotificationChannel.WEBSOCKET || channel === CoreUserNotificationChannel.FRONT_END_SUCCESS;
|
|
142
144
|
}
|
|
143
145
|
return target === CoreUserNotificationTarget.ORGANIZATION_BILLING
|
|
144
146
|
|| target === CoreUserNotificationTarget.ORGANIZATION_USER_MANAGEMENT
|
|
@@ -23,10 +23,17 @@
|
|
|
23
23
|
*
|
|
24
24
|
* ## What actually sends
|
|
25
25
|
*
|
|
26
|
-
* `EMAIL`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
26
|
+
* `EMAIL`, `SMS`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all four deliver. There is no
|
|
27
|
+
* push channel.
|
|
28
|
+
*
|
|
29
|
+
* An `SMS` notification sends a short plain text through the application's SMS provider (the one that sends
|
|
30
|
+
* its one-time codes), and only to a recipient who switched SMS ON (`UserPreferences.notifications.sms`,
|
|
31
|
+
* off by default) and has a phone number verified on their account. Nothing overrides that consent: not a
|
|
32
|
+
* role-addressed target, not `alwaysDeliver`. Its words are a label, `notifications_custom.<identifier>.sms`,
|
|
33
|
+
* generated from the `text.purpose` you declare, in each recipient's language; write `text.params` for the
|
|
34
|
+
* values it interpolates. The words should fit ONE SMS segment (160 GSM-7 characters, 70 when any character
|
|
35
|
+
* needs UCS-2); a longer text still goes out, as a concatenated message, with a warning. A recipient whose
|
|
36
|
+
* label is missing gets no text at all, rather than a raw key on their phone.
|
|
30
37
|
*
|
|
31
38
|
* For an EMAIL, create the template the derived reference names: one per operation variant that declares a
|
|
32
39
|
* `variantKey`, since the reference carries it. The startup validator resolves every declared reference through
|
|
@@ -58,10 +65,11 @@
|
|
|
58
65
|
*
|
|
59
66
|
* ## Emailing somebody who is not a user
|
|
60
67
|
*
|
|
61
|
-
* `recipientEmailField` names a TOP-LEVEL field on the record holding the address.
|
|
62
|
-
*
|
|
63
|
-
*
|
|
64
|
-
*
|
|
68
|
+
* `recipientEmailField` names a TOP-LEVEL field on the record holding the address. The message is
|
|
69
|
+
* written in the language of the user the record names in `userId` when that user's own address IS the
|
|
70
|
+
* recipient address (an invitation's membership row names the invited user), and in the application's
|
|
71
|
+
* primary language otherwise. Channel switches are not consulted on this path. A nested address cannot
|
|
72
|
+
* be named, nor a list — the path sends exactly one message per notification. Pair it with a `condition` when the same operation also
|
|
65
73
|
* serves rows whose address belongs to somebody who must not be written to.
|
|
66
74
|
*
|
|
67
75
|
* Base fields shared by all user notification channel variants.
|
|
@@ -166,13 +174,15 @@ export const UserNotificationDefinition_EmailSchema = UserNotificationDefinition
|
|
|
166
174
|
*
|
|
167
175
|
* When set, the recipient is `currentObject[recipientEmailField]` (a top-level
|
|
168
176
|
* string field — e.g. `'email'`). The dispatcher sends a single email directly to
|
|
169
|
-
* that address
|
|
170
|
-
* `
|
|
177
|
+
* that address, BYPASSING the `userId`-based `target` resolution entirely. It is
|
|
178
|
+
* written in the language of the user the record names in `userId` when that user's
|
|
179
|
+
* own address IS the recipient address, and in the application's primary language
|
|
180
|
+
* otherwise (#3110).
|
|
171
181
|
*
|
|
172
|
-
* This is the framework's mechanism for notifying a party
|
|
173
|
-
*
|
|
174
|
-
*
|
|
175
|
-
*
|
|
182
|
+
* This is the framework's mechanism for notifying a party known by an ADDRESS — an
|
|
183
|
+
* organization-invitation invitee (who may or may not hold an account), an inbound
|
|
184
|
+
* lead. Without it, the only email recipients the dispatcher can resolve are
|
|
185
|
+
* members/initiators by id (`fetchUserContext(userId).email`).
|
|
176
186
|
*
|
|
177
187
|
* When this is set, `target` no longer selects the recipient; it is retained only
|
|
178
188
|
* to (a) classify the notification, (b) drive the email `templateRef` derivation,
|
|
@@ -222,6 +232,168 @@ export const UserNotificationDefinition_WebSocketSchema = UserNotificationDefini
|
|
|
222
232
|
channel: z.literal(CoreUserNotificationChannel.WEBSOCKET),
|
|
223
233
|
});
|
|
224
234
|
|
|
235
|
+
/** The operation context an SMS text parameter's `value` is computed from: the same shape `condition` receives. */
|
|
236
|
+
export interface UserNotificationSmsTextParamContext {
|
|
237
|
+
currentObject: any;
|
|
238
|
+
previousObject?: any;
|
|
239
|
+
inputDto: any;
|
|
240
|
+
objectContext: { parents: Record<string, any>; children: Record<string, any> };
|
|
241
|
+
initiatorIds: { userId?: string; organizationId?: string; applicationId?: string };
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/**
|
|
245
|
+
* The name of an SMS text parameter: the `{name}` placeholder the generated words carry. Letters and digits only, so it
|
|
246
|
+
* is a valid placeholder in every label and a valid key in the generation request.
|
|
247
|
+
*/
|
|
248
|
+
export const USER_NOTIFICATION_SMS_TEXT_PARAM_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9]*$/;
|
|
249
|
+
|
|
250
|
+
/** One value an SMS notification's text interpolates (#1875). */
|
|
251
|
+
export const UserNotificationSmsTextParamSchema = z.object({
|
|
252
|
+
/** What the value is, for the writer of the words ("the title of the to-do"). Keep the value SHORT: it counts against the segment. */
|
|
253
|
+
meaning: z.string().trim().min(1),
|
|
254
|
+
/** The value, computed when the notification is sent. `null`/`undefined` interpolates as an empty string. */
|
|
255
|
+
value: z.custom<(params: UserNotificationSmsTextParamContext) => string | number | null | undefined>((val) => typeof val === 'function'),
|
|
256
|
+
});
|
|
257
|
+
export type UserNotificationSmsTextParam = z.infer<typeof UserNotificationSmsTextParamSchema>;
|
|
258
|
+
|
|
259
|
+
/**
|
|
260
|
+
* The short-text contract of an SMS notification (#1875): what the text must say, and the values it interpolates.
|
|
261
|
+
*
|
|
262
|
+
* The WORDS are not declared here. They are a label, {@link userNotificationSmsTextLabelKey}, which the labelling
|
|
263
|
+
* pipeline generates from `purpose` and the parameters' meanings and translates into every language the application
|
|
264
|
+
* offers, so a recipient reads the text in their own language (`display-text-comes-from-i18n.md`). An inline string
|
|
265
|
+
* was rejected for that reason, and an email-style template directory was rejected because an SMS is one plain
|
|
266
|
+
* sentence: a template file per notification would carry nothing a label does not.
|
|
267
|
+
*
|
|
268
|
+
* Plain text only: no markup, no link the recipient cannot see in full. The length rule is
|
|
269
|
+
* {@link USER_NOTIFICATION_SMS_TEXT_SEGMENT_BUDGET}.
|
|
270
|
+
*/
|
|
271
|
+
export const UserNotificationSmsTextSchema = z.object({
|
|
272
|
+
/** What the text tells the recipient, in one or two sentences. The writer's only context besides the parameters. */
|
|
273
|
+
purpose: z.string().trim().min(1),
|
|
274
|
+
/** The values the text interpolates, by placeholder name. */
|
|
275
|
+
params: z.record(
|
|
276
|
+
z.string().regex(USER_NOTIFICATION_SMS_TEXT_PARAM_NAME_PATTERN, 'An SMS text parameter name is letters and digits, starting with a letter.'),
|
|
277
|
+
UserNotificationSmsTextParamSchema,
|
|
278
|
+
).optional(),
|
|
279
|
+
});
|
|
280
|
+
export type UserNotificationSmsText = z.infer<typeof UserNotificationSmsTextSchema>;
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* SMS channel — a short plain text to each recipient's verified phone, with their consent (#1875).
|
|
284
|
+
*
|
|
285
|
+
* @example
|
|
286
|
+
* ```ts
|
|
287
|
+
* {
|
|
288
|
+
* target: CoreUserNotificationTarget.USERS_CUSTOM,
|
|
289
|
+
* channel: CoreUserNotificationChannel.SMS,
|
|
290
|
+
* customNotificationRef: 'notify-assignee',
|
|
291
|
+
* userIdsSelector: ({ currentObject }) => [currentObject.assigneeId],
|
|
292
|
+
* text: {
|
|
293
|
+
* purpose: 'Tells the person a to-do was just assigned to them, naming it.',
|
|
294
|
+
* params: { title: { meaning: 'the title of the to-do', value: ({ currentObject }) => currentObject.title } },
|
|
295
|
+
* },
|
|
296
|
+
* }
|
|
297
|
+
* ```
|
|
298
|
+
*/
|
|
299
|
+
export const UserNotificationDefinition_SmsSchema = UserNotificationDefinition_BaseSchema.extend({
|
|
300
|
+
channel: z.literal(CoreUserNotificationChannel.SMS),
|
|
301
|
+
text: UserNotificationSmsTextSchema,
|
|
302
|
+
});
|
|
303
|
+
|
|
304
|
+
/** The label key an SMS notification's words live under: `notifications_custom.<identifier>.sms` (#1875). */
|
|
305
|
+
export function userNotificationSmsTextLabelKey(identifier: string): string {
|
|
306
|
+
return `${LabellingTypes.NOTIFICATIONS_CUSTOM}.${identifier}.sms`;
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
// =====================================================
|
|
310
|
+
// SMS segment measurement (#1875)
|
|
311
|
+
// =====================================================
|
|
312
|
+
|
|
313
|
+
/**
|
|
314
|
+
* The two encodings an SMS body is sent in. A body is GSM-7 when every character is in the GSM 03.38 default
|
|
315
|
+
* alphabet or its extension table, and UCS-2 otherwise: ONE character outside that alphabet switches the whole
|
|
316
|
+
* message, which is what makes an accented letter or an emoji cost more than half the length budget.
|
|
317
|
+
*
|
|
318
|
+
* spec-cite: 3GPP TS 23.038 (GSM 03.38) — default alphabet and extension table, as tabulated at
|
|
319
|
+
* https://en.wikipedia.org/wiki/GSM_03.38 and https://www.twilio.com/docs/glossary/what-is-gsm-7-character-encoding
|
|
320
|
+
*/
|
|
321
|
+
export enum SmsTextEncoding {
|
|
322
|
+
GSM_7 = 'gsm_7',
|
|
323
|
+
UCS_2 = 'ucs_2',
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
/**
|
|
327
|
+
* Length units one segment holds, by encoding: 160 septets in GSM-7, 70 UTF-16 code units in UCS-2.
|
|
328
|
+
*
|
|
329
|
+
* spec-cite: https://www.twilio.com/docs/glossary/what-sms-character-limit — the single-segment row of its table.
|
|
330
|
+
*/
|
|
331
|
+
export const SMS_SINGLE_SEGMENT_UNITS: Readonly<Record<SmsTextEncoding, number>> = Object.freeze({
|
|
332
|
+
[SmsTextEncoding.GSM_7]: 160,
|
|
333
|
+
[SmsTextEncoding.UCS_2]: 70,
|
|
334
|
+
});
|
|
335
|
+
|
|
336
|
+
/**
|
|
337
|
+
* Length units each segment of a CONCATENATED message holds (the rest carries the reassembly header): 153 and 67.
|
|
338
|
+
*
|
|
339
|
+
* spec-cite: https://www.twilio.com/docs/glossary/what-sms-character-limit — the multi-segment row of its table.
|
|
340
|
+
*/
|
|
341
|
+
export const SMS_CONCATENATED_SEGMENT_UNITS: Readonly<Record<SmsTextEncoding, number>> = Object.freeze({
|
|
342
|
+
[SmsTextEncoding.GSM_7]: 153,
|
|
343
|
+
[SmsTextEncoding.UCS_2]: 67,
|
|
344
|
+
});
|
|
345
|
+
|
|
346
|
+
/**
|
|
347
|
+
* The length rule of an SMS notification text: it should fit ONE segment, so 160 GSM-7 units or 70 UCS-2 units.
|
|
348
|
+
*
|
|
349
|
+
* Decided by practice (#1875). A notification is an alert, not a conversation, and one segment is what every carrier
|
|
350
|
+
* delivers whole and bills once; Twilio's own guidance keeps messages under two segments for deliverability. The
|
|
351
|
+
* budget is given to the writer of the words (the labelling pipeline), and the dispatcher MEASURES each rendered text
|
|
352
|
+
* against it. A text over budget, usually because an interpolated value is long, is still sent, as a concatenated
|
|
353
|
+
* message, with a warning naming the notification: losing the notification would cost the recipient more than the
|
|
354
|
+
* second segment does. Rejected: refusing it (a long to-do title would silently cost someone their alert) and
|
|
355
|
+
* truncating it (it can cut the one word that mattered).
|
|
356
|
+
*/
|
|
357
|
+
export const USER_NOTIFICATION_SMS_TEXT_SEGMENT_BUDGET = 1;
|
|
358
|
+
|
|
359
|
+
/**
|
|
360
|
+
* The GSM 03.38 default alphabet, one septet each. `Ç` is listed as the standard tabulates it (0x09); a `ç` therefore
|
|
361
|
+
* measures as UCS-2, which over-counts on a handset that maps 0x09 to `ç` — the safe direction for a length budget.
|
|
362
|
+
*/
|
|
363
|
+
const GSM_7_DEFAULT_ALPHABET: ReadonlySet<string> = new Set(
|
|
364
|
+
'@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&\'()*+,-./0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà',
|
|
365
|
+
);
|
|
366
|
+
|
|
367
|
+
/** The GSM 03.38 extension table reachable through ESC: two septets each. */
|
|
368
|
+
const GSM_7_EXTENSION_TABLE: ReadonlySet<string> = new Set('\f^{}\\[~]|€');
|
|
369
|
+
|
|
370
|
+
/** What one SMS body costs: its encoding, its length in that encoding's units, and the segments it is sent as. */
|
|
371
|
+
export interface SmsTextMeasurement {
|
|
372
|
+
readonly encoding: SmsTextEncoding;
|
|
373
|
+
/** GSM-7 septets (an extension character counts two), or UCS-2 UTF-16 code units (a character outside the BMP counts two). */
|
|
374
|
+
readonly units: number;
|
|
375
|
+
readonly segments: number;
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
/** Measure an SMS body against the GSM-7 / UCS-2 segmenting rules. Pure. */
|
|
379
|
+
export function measureSmsText(text: string): SmsTextMeasurement {
|
|
380
|
+
let septets = 0;
|
|
381
|
+
let gsm7 = true;
|
|
382
|
+
for (const character of text) {
|
|
383
|
+
if (GSM_7_DEFAULT_ALPHABET.has(character)) septets += 1;
|
|
384
|
+
else if (GSM_7_EXTENSION_TABLE.has(character)) septets += 2;
|
|
385
|
+
else { gsm7 = false; break; }
|
|
386
|
+
}
|
|
387
|
+
const encoding = gsm7 ? SmsTextEncoding.GSM_7 : SmsTextEncoding.UCS_2;
|
|
388
|
+
const units = gsm7 ? septets : text.length;
|
|
389
|
+
const segments = units === 0
|
|
390
|
+
? 0
|
|
391
|
+
: units <= SMS_SINGLE_SEGMENT_UNITS[encoding]
|
|
392
|
+
? 1
|
|
393
|
+
: Math.ceil(units / SMS_CONCATENATED_SEGMENT_UNITS[encoding]);
|
|
394
|
+
return { encoding, units, segments };
|
|
395
|
+
}
|
|
396
|
+
|
|
225
397
|
/**
|
|
226
398
|
* FRONT_END_SUCCESS channel — frontend display with optional celebration + nextStep.
|
|
227
399
|
*
|
|
@@ -257,9 +429,14 @@ export const UserNotificationDefinition_FrontEndSuccessSchema = UserNotification
|
|
|
257
429
|
* of `CoreUserNotificationChannel`, and the resource factory parses every declared notification against this schema
|
|
258
430
|
* (`processUserNotifications`), so an unknown one is refused when the configuration is built. A new channel is
|
|
259
431
|
* added by giving it a member here AND a delivery arm in the dispatcher, never by naming it.
|
|
432
|
+
*
|
|
433
|
+
* DISCRIMINATED on `channel` (#1875), so a declaration that names a known channel is checked against that channel's
|
|
434
|
+
* variant alone and its refusal names the field at fault ("text.params…: An SMS text parameter name is…"). A plain
|
|
435
|
+
* union reported every variant's failure at once as one path-less "Invalid input".
|
|
260
436
|
*/
|
|
261
|
-
export const UserNotificationDefinitionSchema = z.
|
|
437
|
+
export const UserNotificationDefinitionSchema = z.discriminatedUnion('channel', [
|
|
262
438
|
UserNotificationDefinition_EmailSchema,
|
|
439
|
+
UserNotificationDefinition_SmsSchema,
|
|
263
440
|
UserNotificationDefinition_WebSocketSchema,
|
|
264
441
|
UserNotificationDefinition_FrontEndSuccessSchema,
|
|
265
442
|
])
|
|
@@ -275,6 +452,7 @@ export const UserNotificationDefinitionSchema = z.union([
|
|
|
275
452
|
* - `USERS_CUSTOM` without a `userIdsSelector` resolves nobody.
|
|
276
453
|
* - `INBOUND_CONTACT` on EMAIL resolves nobody by target: the contact is not a user, and is reached only
|
|
277
454
|
* through `recipientEmailField`.
|
|
455
|
+
* - `INBOUND_CONTACT` on SMS resolves nobody at all: an SMS needs a user's verified phone and consent (#1875).
|
|
278
456
|
*
|
|
279
457
|
* The resource factory parses every declaration against this schema, so each is refused when the
|
|
280
458
|
* configuration is built rather than discovered as an email nobody received.
|
|
@@ -332,6 +510,14 @@ export const UserNotificationDefinitionSchema = z.union([
|
|
|
332
510
|
+ 'not a user of the application. Name the field holding their address in recipientEmailField.',
|
|
333
511
|
});
|
|
334
512
|
}
|
|
513
|
+
if (notification.target === CoreUserNotificationTarget.INBOUND_CONTACT && notification.channel === CoreUserNotificationChannel.SMS) {
|
|
514
|
+
context.addIssue({
|
|
515
|
+
code: 'custom',
|
|
516
|
+
path: ['target'],
|
|
517
|
+
message: `An SMS to the "${CoreUserNotificationTarget.INBOUND_CONTACT}" target reaches nobody: an SMS goes only to a user's `
|
|
518
|
+
+ 'verified phone with their consent, and the contact is not a user of the application (#1875).',
|
|
519
|
+
});
|
|
520
|
+
}
|
|
335
521
|
});
|
|
336
522
|
export type UserNotificationDefinition = z.infer<typeof UserNotificationDefinitionSchema>;
|
|
337
523
|
```
|
|
@@ -49,7 +49,8 @@
|
|
|
49
49
|
* write never moves a row to a client the caller does not serve. A principal with no user (an API key, an OAuth client)
|
|
50
50
|
* is assigned nothing, so a declared role reaches no row for it.
|
|
51
51
|
*
|
|
52
|
-
* A resource declares assigned rows
|
|
52
|
+
* A resource that declares assigned rows declares no other confinement. (Own rows and unit narrowing compose with each
|
|
53
|
+
* other: a department head reaches their department's rows and their own.)
|
|
53
54
|
*/
|
|
54
55
|
export type OrganizationAssignedRowsDeclaration = {
|
|
55
56
|
/** The resource whose rows assign a user to a row of this resource. */
|