@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md
CHANGED
|
@@ -148,7 +148,9 @@ export function userNotificationTargetIsSuppressibleByRecipientPreference(target
|
|
|
148
148
|
*/
|
|
149
149
|
export function userNotificationTargetReadsUserRoles(target: string, channel: string): boolean {
|
|
150
150
|
if (target === CoreUserNotificationTarget.INBOUND_CONTACT) {
|
|
151
|
-
|
|
151
|
+
// Only the in-app alert reads roles. EMAIL reaches the contact by address, and SMS cannot reach the contact at all
|
|
152
|
+
// (an SMS goes only to a user's verified phone with their consent), so it is refused there (#1875).
|
|
153
|
+
return channel === CoreUserNotificationChannel.WEBSOCKET || channel === CoreUserNotificationChannel.FRONT_END_SUCCESS;
|
|
152
154
|
}
|
|
153
155
|
return target === CoreUserNotificationTarget.ORGANIZATION_BILLING
|
|
154
156
|
|| target === CoreUserNotificationTarget.ORGANIZATION_USER_MANAGEMENT
|
|
@@ -182,14 +184,52 @@ For organization billing, security, user-management and administrative targets,
|
|
|
182
184
|
|
|
183
185
|
## Which channels actually send
|
|
184
186
|
|
|
185
|
-
`EMAIL`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all
|
|
187
|
+
`EMAIL`, `SMS`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all four deliver. There is no
|
|
188
|
+
push channel.
|
|
186
189
|
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
190
|
+
Users have two channel switches they can turn off, `email` and `inApp`, and under them they can turn a
|
|
191
|
+
channel off for one KIND of notification (`notifications.byResourceType`, keyed by the resource the
|
|
192
|
+
notification is about). `sms` is different: it is the user's CONSENT to receive texts, and it is OFF until
|
|
193
|
+
they turn it on.
|
|
194
|
+
|
|
195
|
+
### An SMS notification
|
|
196
|
+
|
|
197
|
+
A short plain text through the application's SMS provider (the one that sends its one-time codes):
|
|
198
|
+
|
|
199
|
+
```ts
|
|
200
|
+
{
|
|
201
|
+
target: CoreUserNotificationTarget.USERS_CUSTOM,
|
|
202
|
+
channel: CoreUserNotificationChannel.SMS,
|
|
203
|
+
customNotificationRef: 'notify-assignee',
|
|
204
|
+
userIdsSelector: ({ currentObject }) => [currentObject.assigneeId],
|
|
205
|
+
text: {
|
|
206
|
+
purpose: 'Tells the person a to-do was just assigned to them, naming it.',
|
|
207
|
+
params: { title: { meaning: 'the title of the to-do', value: ({ currentObject }) => currentObject.title } },
|
|
208
|
+
},
|
|
209
|
+
}
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
- **Who receives it.** Only a recipient who switched `sms` ON and has a phone number verified on their
|
|
213
|
+
account (the one their SMS second factor uses). Nothing overrides that consent: not a role-addressed
|
|
214
|
+
target, not `alwaysDeliver`, not a missing preferences row. The switch appears on the person's own
|
|
215
|
+
preferences pane only when your application declares an SMS notification and they have a verified phone.
|
|
216
|
+
- **Its words** are a label, `notifications_custom.<identifier>.sms`, generated from `text.purpose` and the
|
|
217
|
+
parameters' meanings when you run the label generation, then translated: each recipient reads it in their
|
|
218
|
+
own language. A recipient whose label is missing gets NO text (a raw key on a phone is worse), and the
|
|
219
|
+
backend logs an error naming the key. Run label generation after declaring one.
|
|
220
|
+
- **Its length.** Aim for ONE SMS segment: 160 characters when every character is in the GSM-7 alphabet, 70
|
|
221
|
+
when any character is not. GSM-7 holds only a few accented letters (é è ù ì ò à and a handful more), so
|
|
222
|
+
ç, á, ó, ê, â, ã, curly quotes, guillemets and emoji each switch the whole text to 70, which is the usual
|
|
223
|
+
case in French, Spanish and Portuguese. A longer text is still sent, as several parts, with a warning.
|
|
224
|
+
- **It needs a verified phone,** and the only way a person verifies one is the SMS sign-in code: an
|
|
225
|
+
application that sends SMS notifications must enable the `SMS_OTP` authentication method. The consent
|
|
226
|
+
follows the account's verified phone, so verifying a new number moves it. Keep interpolated values short: a title is fine, a
|
|
227
|
+
description is not. `measureSmsText(text)` from `@wildo-ai/saas-models` gives the encoding and segment count.
|
|
228
|
+
- **Refused when the configuration is built:** an SMS with no `text`, `text` on another channel, a parameter
|
|
229
|
+
name that is not letters and digits, and the `INBOUND_CONTACT` target (the contact is not a user, so has no
|
|
230
|
+
verified phone).
|
|
231
|
+
- Each text sent is recorded in the audit trail as a provider capability call (the provider and the outcome;
|
|
232
|
+
never the number or the words).
|
|
193
233
|
|
|
194
234
|
For an `EMAIL`, create the template the derived ref names:
|
|
195
235
|
`email.<resource>.<operation>[.<variantKey>].<target>[_<customNotificationRef>]`, the target lowercased with `_` as
|
|
@@ -292,8 +332,10 @@ operation declaring both forms. Each scope's resource has its own template folde
|
|
|
292
332
|
|
|
293
333
|
`recipientEmailField` names a **top-level** field on the record holding the address. Consequences:
|
|
294
334
|
|
|
295
|
-
-
|
|
296
|
-
|
|
335
|
+
- the language is the reader's own only when the record names them: the message is written in the language
|
|
336
|
+
of the user the record's `userId` names when that user's own address IS the recipient address (an
|
|
337
|
+
invitation's membership row names the invited user), and in the application's PRIMARY language otherwise;
|
|
338
|
+
- channel switches are not consulted: the message is sent whatever the recipient switched off;
|
|
297
339
|
- a nested address cannot be named, and neither can a list: the path sends exactly one message.
|
|
298
340
|
|
|
299
341
|
Pair it with a `condition` when the same operation also serves rows whose address belongs to somebody
|
|
@@ -357,10 +399,17 @@ record the receiving organization cannot open.
|
|
|
357
399
|
*
|
|
358
400
|
* ## What actually sends
|
|
359
401
|
*
|
|
360
|
-
* `EMAIL`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all
|
|
361
|
-
*
|
|
362
|
-
*
|
|
363
|
-
*
|
|
402
|
+
* `EMAIL`, `SMS`, `WEBSOCKET` and `FRONT_END_SUCCESS` are the channels, and all four deliver. There is no
|
|
403
|
+
* push channel.
|
|
404
|
+
*
|
|
405
|
+
* An `SMS` notification sends a short plain text through the application's SMS provider (the one that sends
|
|
406
|
+
* its one-time codes), and only to a recipient who switched SMS ON (`UserPreferences.notifications.sms`,
|
|
407
|
+
* off by default) and has a phone number verified on their account. Nothing overrides that consent: not a
|
|
408
|
+
* role-addressed target, not `alwaysDeliver`. Its words are a label, `notifications_custom.<identifier>.sms`,
|
|
409
|
+
* generated from the `text.purpose` you declare, in each recipient's language; write `text.params` for the
|
|
410
|
+
* values it interpolates. The words should fit ONE SMS segment (160 GSM-7 characters, 70 when any character
|
|
411
|
+
* needs UCS-2); a longer text still goes out, as a concatenated message, with a warning. A recipient whose
|
|
412
|
+
* label is missing gets no text at all, rather than a raw key on their phone.
|
|
364
413
|
*
|
|
365
414
|
* For an EMAIL, create the template the derived reference names: one per operation variant that declares a
|
|
366
415
|
* `variantKey`, since the reference carries it. The startup validator resolves every declared reference through
|
|
@@ -392,10 +441,11 @@ record the receiving organization cannot open.
|
|
|
392
441
|
*
|
|
393
442
|
* ## Emailing somebody who is not a user
|
|
394
443
|
*
|
|
395
|
-
* `recipientEmailField` names a TOP-LEVEL field on the record holding the address.
|
|
396
|
-
*
|
|
397
|
-
*
|
|
398
|
-
*
|
|
444
|
+
* `recipientEmailField` names a TOP-LEVEL field on the record holding the address. The message is
|
|
445
|
+
* written in the language of the user the record names in `userId` when that user's own address IS the
|
|
446
|
+
* recipient address (an invitation's membership row names the invited user), and in the application's
|
|
447
|
+
* primary language otherwise. Channel switches are not consulted on this path. A nested address cannot
|
|
448
|
+
* be named, nor a list — the path sends exactly one message per notification. Pair it with a `condition` when the same operation also
|
|
399
449
|
* serves rows whose address belongs to somebody who must not be written to.
|
|
400
450
|
*
|
|
401
451
|
* Base fields shared by all user notification channel variants.
|
|
@@ -500,13 +550,15 @@ export const UserNotificationDefinition_EmailSchema = UserNotificationDefinition
|
|
|
500
550
|
*
|
|
501
551
|
* When set, the recipient is `currentObject[recipientEmailField]` (a top-level
|
|
502
552
|
* string field — e.g. `'email'`). The dispatcher sends a single email directly to
|
|
503
|
-
* that address
|
|
504
|
-
* `
|
|
553
|
+
* that address, BYPASSING the `userId`-based `target` resolution entirely. It is
|
|
554
|
+
* written in the language of the user the record names in `userId` when that user's
|
|
555
|
+
* own address IS the recipient address, and in the application's primary language
|
|
556
|
+
* otherwise (#3110).
|
|
505
557
|
*
|
|
506
|
-
* This is the framework's mechanism for notifying a party
|
|
507
|
-
*
|
|
508
|
-
*
|
|
509
|
-
*
|
|
558
|
+
* This is the framework's mechanism for notifying a party known by an ADDRESS — an
|
|
559
|
+
* organization-invitation invitee (who may or may not hold an account), an inbound
|
|
560
|
+
* lead. Without it, the only email recipients the dispatcher can resolve are
|
|
561
|
+
* members/initiators by id (`fetchUserContext(userId).email`).
|
|
510
562
|
*
|
|
511
563
|
* When this is set, `target` no longer selects the recipient; it is retained only
|
|
512
564
|
* to (a) classify the notification, (b) drive the email `templateRef` derivation,
|
|
@@ -556,6 +608,168 @@ export const UserNotificationDefinition_WebSocketSchema = UserNotificationDefini
|
|
|
556
608
|
channel: z.literal(CoreUserNotificationChannel.WEBSOCKET),
|
|
557
609
|
});
|
|
558
610
|
|
|
611
|
+
/** The operation context an SMS text parameter's `value` is computed from: the same shape `condition` receives. */
|
|
612
|
+
export interface UserNotificationSmsTextParamContext {
|
|
613
|
+
currentObject: any;
|
|
614
|
+
previousObject?: any;
|
|
615
|
+
inputDto: any;
|
|
616
|
+
objectContext: { parents: Record<string, any>; children: Record<string, any> };
|
|
617
|
+
initiatorIds: { userId?: string; organizationId?: string; applicationId?: string };
|
|
618
|
+
}
|
|
619
|
+
|
|
620
|
+
/**
|
|
621
|
+
* The name of an SMS text parameter: the `{name}` placeholder the generated words carry. Letters and digits only, so it
|
|
622
|
+
* is a valid placeholder in every label and a valid key in the generation request.
|
|
623
|
+
*/
|
|
624
|
+
export const USER_NOTIFICATION_SMS_TEXT_PARAM_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9]*$/;
|
|
625
|
+
|
|
626
|
+
/** One value an SMS notification's text interpolates (#1875). */
|
|
627
|
+
export const UserNotificationSmsTextParamSchema = z.object({
|
|
628
|
+
/** 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. */
|
|
629
|
+
meaning: z.string().trim().min(1),
|
|
630
|
+
/** The value, computed when the notification is sent. `null`/`undefined` interpolates as an empty string. */
|
|
631
|
+
value: z.custom<(params: UserNotificationSmsTextParamContext) => string | number | null | undefined>((val) => typeof val === 'function'),
|
|
632
|
+
});
|
|
633
|
+
export type UserNotificationSmsTextParam = z.infer<typeof UserNotificationSmsTextParamSchema>;
|
|
634
|
+
|
|
635
|
+
/**
|
|
636
|
+
* The short-text contract of an SMS notification (#1875): what the text must say, and the values it interpolates.
|
|
637
|
+
*
|
|
638
|
+
* The WORDS are not declared here. They are a label, {@link userNotificationSmsTextLabelKey}, which the labelling
|
|
639
|
+
* pipeline generates from `purpose` and the parameters' meanings and translates into every language the application
|
|
640
|
+
* offers, so a recipient reads the text in their own language (`display-text-comes-from-i18n.md`). An inline string
|
|
641
|
+
* was rejected for that reason, and an email-style template directory was rejected because an SMS is one plain
|
|
642
|
+
* sentence: a template file per notification would carry nothing a label does not.
|
|
643
|
+
*
|
|
644
|
+
* Plain text only: no markup, no link the recipient cannot see in full. The length rule is
|
|
645
|
+
* {@link USER_NOTIFICATION_SMS_TEXT_SEGMENT_BUDGET}.
|
|
646
|
+
*/
|
|
647
|
+
export const UserNotificationSmsTextSchema = z.object({
|
|
648
|
+
/** What the text tells the recipient, in one or two sentences. The writer's only context besides the parameters. */
|
|
649
|
+
purpose: z.string().trim().min(1),
|
|
650
|
+
/** The values the text interpolates, by placeholder name. */
|
|
651
|
+
params: z.record(
|
|
652
|
+
z.string().regex(USER_NOTIFICATION_SMS_TEXT_PARAM_NAME_PATTERN, 'An SMS text parameter name is letters and digits, starting with a letter.'),
|
|
653
|
+
UserNotificationSmsTextParamSchema,
|
|
654
|
+
).optional(),
|
|
655
|
+
});
|
|
656
|
+
export type UserNotificationSmsText = z.infer<typeof UserNotificationSmsTextSchema>;
|
|
657
|
+
|
|
658
|
+
/**
|
|
659
|
+
* SMS channel — a short plain text to each recipient's verified phone, with their consent (#1875).
|
|
660
|
+
*
|
|
661
|
+
* @example
|
|
662
|
+
* ```ts
|
|
663
|
+
* {
|
|
664
|
+
* target: CoreUserNotificationTarget.USERS_CUSTOM,
|
|
665
|
+
* channel: CoreUserNotificationChannel.SMS,
|
|
666
|
+
* customNotificationRef: 'notify-assignee',
|
|
667
|
+
* userIdsSelector: ({ currentObject }) => [currentObject.assigneeId],
|
|
668
|
+
* text: {
|
|
669
|
+
* purpose: 'Tells the person a to-do was just assigned to them, naming it.',
|
|
670
|
+
* params: { title: { meaning: 'the title of the to-do', value: ({ currentObject }) => currentObject.title } },
|
|
671
|
+
* },
|
|
672
|
+
* }
|
|
673
|
+
* ```
|
|
674
|
+
*/
|
|
675
|
+
export const UserNotificationDefinition_SmsSchema = UserNotificationDefinition_BaseSchema.extend({
|
|
676
|
+
channel: z.literal(CoreUserNotificationChannel.SMS),
|
|
677
|
+
text: UserNotificationSmsTextSchema,
|
|
678
|
+
});
|
|
679
|
+
|
|
680
|
+
/** The label key an SMS notification's words live under: `notifications_custom.<identifier>.sms` (#1875). */
|
|
681
|
+
export function userNotificationSmsTextLabelKey(identifier: string): string {
|
|
682
|
+
return `${LabellingTypes.NOTIFICATIONS_CUSTOM}.${identifier}.sms`;
|
|
683
|
+
}
|
|
684
|
+
|
|
685
|
+
// =====================================================
|
|
686
|
+
// SMS segment measurement (#1875)
|
|
687
|
+
// =====================================================
|
|
688
|
+
|
|
689
|
+
/**
|
|
690
|
+
* The two encodings an SMS body is sent in. A body is GSM-7 when every character is in the GSM 03.38 default
|
|
691
|
+
* alphabet or its extension table, and UCS-2 otherwise: ONE character outside that alphabet switches the whole
|
|
692
|
+
* message, which is what makes an accented letter or an emoji cost more than half the length budget.
|
|
693
|
+
*
|
|
694
|
+
* spec-cite: 3GPP TS 23.038 (GSM 03.38) — default alphabet and extension table, as tabulated at
|
|
695
|
+
* https://en.wikipedia.org/wiki/GSM_03.38 and https://www.twilio.com/docs/glossary/what-is-gsm-7-character-encoding
|
|
696
|
+
*/
|
|
697
|
+
export enum SmsTextEncoding {
|
|
698
|
+
GSM_7 = 'gsm_7',
|
|
699
|
+
UCS_2 = 'ucs_2',
|
|
700
|
+
}
|
|
701
|
+
|
|
702
|
+
/**
|
|
703
|
+
* Length units one segment holds, by encoding: 160 septets in GSM-7, 70 UTF-16 code units in UCS-2.
|
|
704
|
+
*
|
|
705
|
+
* spec-cite: https://www.twilio.com/docs/glossary/what-sms-character-limit — the single-segment row of its table.
|
|
706
|
+
*/
|
|
707
|
+
export const SMS_SINGLE_SEGMENT_UNITS: Readonly<Record<SmsTextEncoding, number>> = Object.freeze({
|
|
708
|
+
[SmsTextEncoding.GSM_7]: 160,
|
|
709
|
+
[SmsTextEncoding.UCS_2]: 70,
|
|
710
|
+
});
|
|
711
|
+
|
|
712
|
+
/**
|
|
713
|
+
* Length units each segment of a CONCATENATED message holds (the rest carries the reassembly header): 153 and 67.
|
|
714
|
+
*
|
|
715
|
+
* spec-cite: https://www.twilio.com/docs/glossary/what-sms-character-limit — the multi-segment row of its table.
|
|
716
|
+
*/
|
|
717
|
+
export const SMS_CONCATENATED_SEGMENT_UNITS: Readonly<Record<SmsTextEncoding, number>> = Object.freeze({
|
|
718
|
+
[SmsTextEncoding.GSM_7]: 153,
|
|
719
|
+
[SmsTextEncoding.UCS_2]: 67,
|
|
720
|
+
});
|
|
721
|
+
|
|
722
|
+
/**
|
|
723
|
+
* The length rule of an SMS notification text: it should fit ONE segment, so 160 GSM-7 units or 70 UCS-2 units.
|
|
724
|
+
*
|
|
725
|
+
* Decided by practice (#1875). A notification is an alert, not a conversation, and one segment is what every carrier
|
|
726
|
+
* delivers whole and bills once; Twilio's own guidance keeps messages under two segments for deliverability. The
|
|
727
|
+
* budget is given to the writer of the words (the labelling pipeline), and the dispatcher MEASURES each rendered text
|
|
728
|
+
* against it. A text over budget, usually because an interpolated value is long, is still sent, as a concatenated
|
|
729
|
+
* message, with a warning naming the notification: losing the notification would cost the recipient more than the
|
|
730
|
+
* second segment does. Rejected: refusing it (a long to-do title would silently cost someone their alert) and
|
|
731
|
+
* truncating it (it can cut the one word that mattered).
|
|
732
|
+
*/
|
|
733
|
+
export const USER_NOTIFICATION_SMS_TEXT_SEGMENT_BUDGET = 1;
|
|
734
|
+
|
|
735
|
+
/**
|
|
736
|
+
* The GSM 03.38 default alphabet, one septet each. `Ç` is listed as the standard tabulates it (0x09); a `ç` therefore
|
|
737
|
+
* measures as UCS-2, which over-counts on a handset that maps 0x09 to `ç` — the safe direction for a length budget.
|
|
738
|
+
*/
|
|
739
|
+
const GSM_7_DEFAULT_ALPHABET: ReadonlySet<string> = new Set(
|
|
740
|
+
'@£$¥èéùìòÇ\nØø\rÅåΔ_ΦΓΛΩΠΨΣΘΞÆæßÉ !"#¤%&\'()*+,-./0123456789:;<=>?¡ABCDEFGHIJKLMNOPQRSTUVWXYZÄÖÑܧ¿abcdefghijklmnopqrstuvwxyzäöñüà',
|
|
741
|
+
);
|
|
742
|
+
|
|
743
|
+
/** The GSM 03.38 extension table reachable through ESC: two septets each. */
|
|
744
|
+
const GSM_7_EXTENSION_TABLE: ReadonlySet<string> = new Set('\f^{}\\[~]|€');
|
|
745
|
+
|
|
746
|
+
/** What one SMS body costs: its encoding, its length in that encoding's units, and the segments it is sent as. */
|
|
747
|
+
export interface SmsTextMeasurement {
|
|
748
|
+
readonly encoding: SmsTextEncoding;
|
|
749
|
+
/** GSM-7 septets (an extension character counts two), or UCS-2 UTF-16 code units (a character outside the BMP counts two). */
|
|
750
|
+
readonly units: number;
|
|
751
|
+
readonly segments: number;
|
|
752
|
+
}
|
|
753
|
+
|
|
754
|
+
/** Measure an SMS body against the GSM-7 / UCS-2 segmenting rules. Pure. */
|
|
755
|
+
export function measureSmsText(text: string): SmsTextMeasurement {
|
|
756
|
+
let septets = 0;
|
|
757
|
+
let gsm7 = true;
|
|
758
|
+
for (const character of text) {
|
|
759
|
+
if (GSM_7_DEFAULT_ALPHABET.has(character)) septets += 1;
|
|
760
|
+
else if (GSM_7_EXTENSION_TABLE.has(character)) septets += 2;
|
|
761
|
+
else { gsm7 = false; break; }
|
|
762
|
+
}
|
|
763
|
+
const encoding = gsm7 ? SmsTextEncoding.GSM_7 : SmsTextEncoding.UCS_2;
|
|
764
|
+
const units = gsm7 ? septets : text.length;
|
|
765
|
+
const segments = units === 0
|
|
766
|
+
? 0
|
|
767
|
+
: units <= SMS_SINGLE_SEGMENT_UNITS[encoding]
|
|
768
|
+
? 1
|
|
769
|
+
: Math.ceil(units / SMS_CONCATENATED_SEGMENT_UNITS[encoding]);
|
|
770
|
+
return { encoding, units, segments };
|
|
771
|
+
}
|
|
772
|
+
|
|
559
773
|
/**
|
|
560
774
|
* FRONT_END_SUCCESS channel — frontend display with optional celebration + nextStep.
|
|
561
775
|
*
|
|
@@ -591,9 +805,14 @@ export const UserNotificationDefinition_FrontEndSuccessSchema = UserNotification
|
|
|
591
805
|
* of `CoreUserNotificationChannel`, and the resource factory parses every declared notification against this schema
|
|
592
806
|
* (`processUserNotifications`), so an unknown one is refused when the configuration is built. A new channel is
|
|
593
807
|
* added by giving it a member here AND a delivery arm in the dispatcher, never by naming it.
|
|
808
|
+
*
|
|
809
|
+
* DISCRIMINATED on `channel` (#1875), so a declaration that names a known channel is checked against that channel's
|
|
810
|
+
* variant alone and its refusal names the field at fault ("text.params…: An SMS text parameter name is…"). A plain
|
|
811
|
+
* union reported every variant's failure at once as one path-less "Invalid input".
|
|
594
812
|
*/
|
|
595
|
-
export const UserNotificationDefinitionSchema = z.
|
|
813
|
+
export const UserNotificationDefinitionSchema = z.discriminatedUnion('channel', [
|
|
596
814
|
UserNotificationDefinition_EmailSchema,
|
|
815
|
+
UserNotificationDefinition_SmsSchema,
|
|
597
816
|
UserNotificationDefinition_WebSocketSchema,
|
|
598
817
|
UserNotificationDefinition_FrontEndSuccessSchema,
|
|
599
818
|
])
|
|
@@ -609,6 +828,7 @@ export const UserNotificationDefinitionSchema = z.union([
|
|
|
609
828
|
* - `USERS_CUSTOM` without a `userIdsSelector` resolves nobody.
|
|
610
829
|
* - `INBOUND_CONTACT` on EMAIL resolves nobody by target: the contact is not a user, and is reached only
|
|
611
830
|
* through `recipientEmailField`.
|
|
831
|
+
* - `INBOUND_CONTACT` on SMS resolves nobody at all: an SMS needs a user's verified phone and consent (#1875).
|
|
612
832
|
*
|
|
613
833
|
* The resource factory parses every declaration against this schema, so each is refused when the
|
|
614
834
|
* configuration is built rather than discovered as an email nobody received.
|
|
@@ -666,6 +886,14 @@ export const UserNotificationDefinitionSchema = z.union([
|
|
|
666
886
|
+ 'not a user of the application. Name the field holding their address in recipientEmailField.',
|
|
667
887
|
});
|
|
668
888
|
}
|
|
889
|
+
if (notification.target === CoreUserNotificationTarget.INBOUND_CONTACT && notification.channel === CoreUserNotificationChannel.SMS) {
|
|
890
|
+
context.addIssue({
|
|
891
|
+
code: 'custom',
|
|
892
|
+
path: ['target'],
|
|
893
|
+
message: `An SMS to the "${CoreUserNotificationTarget.INBOUND_CONTACT}" target reaches nobody: an SMS goes only to a user's `
|
|
894
|
+
+ 'verified phone with their consent, and the contact is not a user of the application (#1875).',
|
|
895
|
+
});
|
|
896
|
+
}
|
|
669
897
|
});
|
|
670
898
|
export type UserNotificationDefinition = z.infer<typeof UserNotificationDefinitionSchema>;
|
|
671
899
|
```
|
|
@@ -94,7 +94,26 @@ Wrap your custom content in `ResourceLayoutPreset_<Operation>_Default`
|
|
|
94
94
|
empty states while letting you inject content as `children`. Pass
|
|
95
95
|
through any standard props (`{...props}`).
|
|
96
96
|
|
|
97
|
-
### Step 5:
|
|
97
|
+
### Step 5: Handle a refused action
|
|
98
|
+
|
|
99
|
+
When the view runs an action of its own (a button that archives,
|
|
100
|
+
approves, sends), its `catch` decides two things with the frontend's
|
|
101
|
+
refusal predicates from `@wildo-ai/saas-frontend-lib`
|
|
102
|
+
(`references/framework-backend-refusal-api.md`):
|
|
103
|
+
|
|
104
|
+
- **Say it once.** Ask `isBackendRefusalShownToUser(error)` before
|
|
105
|
+
showing anything. When it is true the global error handler already
|
|
106
|
+
showed the refusal as a toast: restore your state and add nothing.
|
|
107
|
+
Otherwise show `toUserFacingErrorMessage(error, <your words>)`, the
|
|
108
|
+
function `useUserFacingErrorMessage()` returns when called at the
|
|
109
|
+
component's top level (never inside the `catch`).
|
|
110
|
+
- **Offer a retry only when it could help.** `isFinalBackendRefusal(error)`
|
|
111
|
+
is a 4xx that sending again cannot change: no "Try again" then.
|
|
112
|
+
|
|
113
|
+
Never use `isWildoBackendError` in a view: it is the backend's guard,
|
|
114
|
+
false for every refusal that arrives over HTTP.
|
|
115
|
+
|
|
116
|
+
### Step 6: Hand off
|
|
98
117
|
|
|
99
118
|
After the component works, ensure `ui-behavior.tsx` references the
|
|
100
119
|
correct view function in the `views: [...]` array, and any spec
|
|
@@ -176,10 +195,103 @@ What is **not** in this block (and shouldn't be):
|
|
|
176
195
|
- No deep package-internal imports — only `@wildo-ai/saas-frontend-lib`
|
|
177
196
|
and local module modules.
|
|
178
197
|
|
|
198
|
+
### Handling a refused action
|
|
199
|
+
|
|
200
|
+
The catch of an action the view runs itself, with the view's own words
|
|
201
|
+
passed in:
|
|
202
|
+
|
|
203
|
+
|
|
204
|
+
## Usage Example
|
|
205
|
+
|
|
206
|
+
```tsx
|
|
207
|
+
// In an application every name comes from the package root:
|
|
208
|
+
//
|
|
209
|
+
// import {
|
|
210
|
+
// Alert, AlertDescription, Button, ButtonVariants_Variant,
|
|
211
|
+
// isBackendRefusalShownToUser, isFinalBackendRefusal, useUserFacingErrorMessage,
|
|
212
|
+
// } from '@wildo-ai/saas-frontend-lib';
|
|
213
|
+
//
|
|
214
|
+
// The words come from the view's own labels (`t(MyViewLabel.ARCHIVE_FAILED)`, …), never from the error.
|
|
215
|
+
|
|
216
|
+
/** The view's own words for the action, already translated. */
|
|
217
|
+
export interface ArchiveActionWords {
|
|
218
|
+
readonly archive: string;
|
|
219
|
+
/** Shown when the failure carries nothing displayable, and in place of a generic category. */
|
|
220
|
+
readonly archiveFailed: string;
|
|
221
|
+
readonly tryAgain: string;
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/** What the view shows after a failed attempt. */
|
|
225
|
+
interface ArchiveFailure {
|
|
226
|
+
/** The view's own sentence, or `null` when the global error handler already told the person. */
|
|
227
|
+
readonly message: string | null;
|
|
228
|
+
/** Whether sending the same request again could change the answer. */
|
|
229
|
+
readonly canRetry: boolean;
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
export function ArchiveRecordAction({ archive, words }: { archive: () => Promise<void>; words: ArchiveActionWords }) {
|
|
233
|
+
const toUserFacingErrorMessage = useUserFacingErrorMessage();
|
|
234
|
+
const [isPending, setPending] = useState(false);
|
|
235
|
+
const [failure, setFailure] = useState<ArchiveFailure | null>(null);
|
|
236
|
+
|
|
237
|
+
const run = useCallback(async () => {
|
|
238
|
+
setPending(true);
|
|
239
|
+
setFailure(null);
|
|
240
|
+
try {
|
|
241
|
+
await archive();
|
|
242
|
+
} catch (error) {
|
|
243
|
+
setFailure({
|
|
244
|
+
// 1. A refusal the global error handler already showed as a toast: say nothing more, or the person reads it
|
|
245
|
+
// twice. Never rethrow it either: a rethrow reaches the global handler a second time as an uncaught error.
|
|
246
|
+
message: isBackendRefusalShownToUser(error) ? null : toUserFacingErrorMessage(error, words.archiveFailed),
|
|
247
|
+
// 2. A final refusal (a 4xx other than 408 / 425 / 429) gets the same answer however often it is sent, so it
|
|
248
|
+
// offers no retry. A network failure, a timeout or a 5xx may clear, so those do.
|
|
249
|
+
canRetry: !isFinalBackendRefusal(error),
|
|
250
|
+
});
|
|
251
|
+
} finally {
|
|
252
|
+
// Restored on every path, the shown-to-user one included.
|
|
253
|
+
setPending(false);
|
|
254
|
+
}
|
|
255
|
+
}, [archive, toUserFacingErrorMessage, words.archiveFailed]);
|
|
256
|
+
|
|
257
|
+
return (
|
|
258
|
+
<div className="space-y-item-sm">
|
|
259
|
+
<Button type="button" disabled={isPending} onClick={() => { void run(); }}>
|
|
260
|
+
{words.archive}
|
|
261
|
+
</Button>
|
|
262
|
+
{failure?.message && (
|
|
263
|
+
<Alert variant="destructive">
|
|
264
|
+
<AlertDescription>{failure.message}</AlertDescription>
|
|
265
|
+
</Alert>
|
|
266
|
+
)}
|
|
267
|
+
{failure?.canRetry && (
|
|
268
|
+
<Button type="button" variant={ButtonVariants_Variant.OUTLINE} disabled={isPending} onClick={() => { void run(); }}>
|
|
269
|
+
{words.tryAgain}
|
|
270
|
+
</Button>
|
|
271
|
+
)}
|
|
272
|
+
</div>
|
|
273
|
+
);
|
|
274
|
+
}
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
What earns its place:
|
|
278
|
+
|
|
279
|
+
- `isBackendRefusalShownToUser(error)` is asked before the view words
|
|
280
|
+
anything. A refusal the global error handler showed is already in
|
|
281
|
+
front of the person; a second banner repeats it, and a rethrow makes
|
|
282
|
+
the handler report it again as an uncaught error.
|
|
283
|
+
- `toUserFacingErrorMessage(error, words.archiveFailed)` is the only
|
|
284
|
+
source of displayed text: never `error.message`.
|
|
285
|
+
- `canRetry: !isFinalBackendRefusal(error)` keeps the retry for failures
|
|
286
|
+
that can clear (network, timeout, 408 / 425 / 429, 5xx).
|
|
287
|
+
- `finally` restores the pending flag on every path, the silent one
|
|
288
|
+
included.
|
|
289
|
+
|
|
179
290
|
## References
|
|
180
291
|
|
|
181
292
|
- `references/custom-view-contracts.md` — contract reminders
|
|
182
293
|
- `references/framework-user-facing-error-message-api.md` — source-backed hook for showing a caught error
|
|
294
|
+
- `references/framework-backend-refusal-api.md` — source-backed refusal predicates: shown already, final, authored by the backend
|
|
183
295
|
|
|
184
296
|
## Verification
|
|
185
297
|
|
|
@@ -191,6 +303,8 @@ What is **not** in this block (and shouldn't be):
|
|
|
191
303
|
- [ ] No deep package-internal imports — only app and published packages
|
|
192
304
|
- [ ] All `viewRef` references use typed constants
|
|
193
305
|
- [ ] A caught error is shown through `useUserFacingErrorMessage()`, never as `error.message`
|
|
306
|
+
- [ ] An action's catch asks `isBackendRefusalShownToUser` before showing words of its own, and offers a retry only when the failure is not `isFinalBackendRefusal`
|
|
307
|
+
- [ ] No `isWildoBackendError` anywhere in `frontend/src`
|
|
194
308
|
|
|
195
309
|
### Grep invariants
|
|
196
310
|
|
|
@@ -204,6 +318,8 @@ Run from the app root, substituting `<resource>` and `<Operation>`:
|
|
|
204
318
|
| Embed `viewRef` references constants, not literals | `rg -n "viewRef=\"[a-z]" frontend/src/modules/<slug>/resources/<resource>/<Resource><Operation>CustomView.tsx` (must return empty) |
|
|
205
319
|
| `ui-behavior.tsx` references the component | `rg -n "<Component name>" frontend/src/modules/<slug>/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
206
320
|
| **No raw error text rendered** (every hit must be a log call) | see the commands below the table |
|
|
321
|
+
| **No backend error guard in the frontend** (must return empty) | `rg -n "isWildoBackendError" frontend/src` |
|
|
322
|
+
| **Every catch asks the refusal predicates** (each block names them) | see the commands below the table |
|
|
207
323
|
|
|
208
324
|
```bash
|
|
209
325
|
# No deep package-internal imports (must return empty)
|
|
@@ -211,6 +327,11 @@ rg -P -n "from\s+'@wildo-ai/(?!saas-frontend-lib\b|saas-models\b|presets-compone
|
|
|
211
327
|
|
|
212
328
|
# No raw error text rendered (every hit must be a log call)
|
|
213
329
|
rg -n "\.message\b|String\((e|err|error)\)" <CustomView>.tsx
|
|
330
|
+
|
|
331
|
+
# Every catch asks the refusal predicates: each block printed must name
|
|
332
|
+
# isBackendRefusalShownToUser before any words, and gate a retry on isFinalBackendRefusal
|
|
333
|
+
# (covers `catch (error)`, `catch {` and a promise's `.catch(`)
|
|
334
|
+
rg -n -A8 "catch\s*[({]|\.catch\(" <CustomView>.tsx
|
|
214
335
|
```
|
|
215
336
|
|
|
216
337
|
The third invariant (no deep imports) is the high-signal one —
|
|
@@ -224,6 +345,8 @@ silently couple the app to engine internals.
|
|
|
224
345
|
| "I'll pass `resourceContext` from props directly" | The surface hook may enrich the context with operation metadata. Using props.resourceContext skips that enrichment and produces "context undefined" symptoms downstream. |
|
|
225
346
|
| "Skip the preset — I want full control" | The preset handles chrome (loading / empty / error) the framework expects. Skipping it bypasses the framework's accessibility and consistency contracts. |
|
|
226
347
|
| "Inline the view ref string" | Typed constants are the contract every consumer depends on; inline literals break when refactors rename the ref. |
|
|
348
|
+
| "The catch should always show something, to be safe" | A refusal the global error handler showed is already on screen. Ask `isBackendRefusalShownToUser`; showing it again makes the person read it twice. |
|
|
349
|
+
| "`isWildoBackendError` is the documented guard" | It is the backend's. Over HTTP the catch receives the client's rejection, for which it is always false, so the branch never runs. Use `isBackendRefusal` and its siblings. |
|
|
227
350
|
| "Operation hosts only need props" | Operation hosts usually need full operation context from the framework — surface hooks resolve that context. |
|
|
228
351
|
|
|
229
352
|
## Red Flags
|
|
@@ -233,6 +356,8 @@ silently couple the app to engine internals.
|
|
|
233
356
|
- Deep import that reaches past a package's public entrypoint (`@wildo-ai/<pkg>/<internal>/<path>`) (catch with the **No deep package-internal imports** grep — must return empty).
|
|
234
357
|
- Inline view ref string (catch with the **Embed `viewRef` references constants** grep — must return empty).
|
|
235
358
|
- A failure banner, state or toast carries `error.message` or `String(error)` (catch with the **No raw error text rendered** grep — every hit must be a log call).
|
|
359
|
+
- `isWildoBackendError` anywhere in the frontend (catch with the **No backend error guard in the frontend** grep — must return empty).
|
|
360
|
+
- A catch that sets its own failure text, or offers "Try again", without asking `isBackendRefusalShownToUser` / `isFinalBackendRefusal` (catch with the **Every catch asks the refusal predicates** grep).
|
|
236
361
|
|
|
237
362
|
## Related Skills
|
|
238
363
|
|